Unified Chua Workflow

The primary pipeline for fractional-order Chua circuits.

The Unified Chua Workflow is the flagship pipeline of the library. It orchestrates the entire process of finding and classifying attractors in the fractional-order Chua circuit.

Process Flow

When executed, the workflow performs the following steps:

1. Initialization: Loads the default Chua parameters and computes the $O_+$, $O_-$, and $O_0$ equilibria.
2. Seed Generation: Uses classical_seeds to generate a grid of initial conditions near the equilibria.
3. Integration: Uses EFORKSolver to step the trajectories forward from $t=0$ to $t_{sim}$.
4. Pruning: Discards the initial $t_{transient}$ portion of the trajectories to remove transient chaos.
5. Classification: Calls classify_basin() on each final point.
6. Summary: Computes the cloud_summary for any non-divergent trajectories.
7. Export: Saves a comprehensive JSON report to the output directory.

Python API

You can trigger the workflow directly from a Python script:

from hidden_attractors.workflows.unified_chua import main

# Define the arguments just like you would on the CLI
args = [
    "--q", "0.98",
    "--dt", "0.01",
    "--t-transient", "100",
    "--t-sim", "200",
    "--memory", "1000",
    "--n-classical", "50",
    "--output", "results/unified"
]

main(args)

Advanced Configurations

The workflow supports several advanced flags:

• --system: Switch from chua-nonsmooth to chua-arctan.
• --backend: Force the solver to use python or c.
• --parallel: Force sequential execution (useful for debugging).

See the CLI Reference for a complete list of arguments.