mappy-ds documentation#

Version: 0.3.0

mappy-ds computes Poincaré maps of smooth and non-smooth (hybrid) dynamical systems — ODEs with impacts, resets, switching or state jumps — together with their exact Jacobian matrices and Hessian tensors. A system is described as a set of smooth modes (continuous flows that stop on a border, and discrete maps) connected by transition rules; following the mode concept of Miino (NOLTA, 2024), the package composes them into a single diffeomorphism. On top of that it finds periodic points, locates tangent, period-doubling and Neimark–Sacker bifurcations, and continues both along parameters.

pip install mappy-ds

Note

The distribution is called mappy-ds and the import name is mappy_ds. The PyPI project named mappy is an unrelated package (Python bindings of the minimap2 aligner).

Getting started

Install the package and build, evaluate and analyse your first Poincaré map — the Izhikevich neuron — in five minutes.

To the tutorial

User guide

The mode concept, how derivatives are computed, periodic points, bifurcations and continuation, plotting, and worked examples.

To the user guide

API reference

Detailed description of every public function and class, its parameters and its return values.

To the API reference

Reference#

Y. Miino, “Mode concept to construct diffeomorphisms representing smooth/non-smooth dynamical systems”, Nonlinear Theory and Its Applications, IEICE, vol. 15, no. 2, pp. 284–298, 2024. doi:10.1587/nolta.15.284