mappy_ds.root.trace_cycle

mappy_ds.root.trace_cycle(diffeo, y0, params, param_key, end_value, *, period=1, resolution=100, show_progress=False, callback=None, **root_options)

Continue a periodic point along a parameter.

Calls find_cycle() at each point of a continuation() of params[param_key] from its current value to end_value, starting each search from the previous periodic point.

Parameters:

diffeoMap

The map.

y0array_like

Initial guess of the periodic point at the initial parameters.

paramsmapping

Initial parameters; not modified.

param_keystr

Key of the parameter to continue.

end_valuefloat

Final value of the parameter.

periodint, optional

Period of the cycle, by default 1.

resolutionint, optional

Number of continuation points including both ends, by default 100.

show_progressbool, optional

Print progress to standard error, by default False.

callbackcallable, optional

Called with each successful step.

**root_options

Forwarded to scipy.optimize.root().

Returns:

list of ContinuationStep

One step per periodic point found. info holds eigvals, eigvecs, nfev and residual as in CycleResult. The list stops at the first parameter value where the search failed.

See also

find_cycle, mappy_ds.continuation.continuation