All Examples

A comprehensive guide on running user-facing example scripts bundled with the library.

The hidden-attractors-fo library packages several user-facing example scripts inside the examples/ directory to demonstrate key functionalities of the system registry, fractional-order solvers, seed generators, and dynamical analysis APIs.

All examples are designed to run from the root of the repository.

Available Examples

1. Quickstart Equilibria

Evaluates and validates the regional vector-field residuals at each of the non-smooth Chua equilibria points.

2. List Candidates

Retrieves and prints candidate chaotic records located via systematic seed sweeps.

3. Minimal Chua Protocol

Sets up a workflow run contract and executes the unified C-compiled EFORK-3 integration sequence.

4. Custom System Definition

Demonstrates how to define and register custom chaotic fractional systems in the public registry.

5. Integer Lur’e Protocol

A sequential workflow that replicates integer piecewise-linear Lur’e systems and Nyquist limit cycle baselines.

Visualizes trajectories and post-processes clouds into Poincaré, spectral, and chaotic bifurcation figures.

7. Notebook Tutorial

Guide to running interactive Jupyter Notebook environments for immediate visualization.

General Rules for Running Examples

To execute these examples, ensure you have installed the package in editable mode with development dependencies:

# Install dependencies
pip install -r requirements.txt

# Run any example script
python examples/quickstart_equilibria.py