CLI Commands

Command Line Interface reference for the hidden-attractors-fo workflows.

The hidden-attractors-fo package exposes several command-line tools to run end-to-end workflows without writing Python scripts. These commands are automatically available in your terminal when you install the package.

Workflows

hidden-attractors-unified-chua

Runs the primary fractional-order unified search pipeline on the Chua circuit. It generates seeds, integrates with EFORK, and classifies the resulting trajectories.

hidden-attractors-unified-chua --q 0.98 --dt 0.01 --output results/

Key Arguments:

  • --q: Fractional derivative order (default 0.98)
  • --dt: Integration step size
  • --t-sim: Total simulation time
  • --memory: Caputo derivative memory length
  • --n-classical: Number of classical seeds per equilibrium

hidden-attractors-integer-chua

Runs the historical full integer-order Chua analysis. The promoted reference case was evaluated with the EFORK-3 numerical process at q=1q=1 and native C backends for heavy stages, so that it is comparable with the fractional workflow.

hidden-attractors-integer-chua --help

hidden-attractors-robustness-overlay

Performs parameter continuation (sweeping over varying α\alpha or β\beta) to find where hidden attractors emerge or collapse, logging the robustness (distance to equilibria) at each step.

hidden-attractors-robustness-overlay --param alpha --start 8.0 --end 10.0 --steps 20

hidden-attractors-sphere-controls

A specialized workflow for investigating the neighborhood geometry of equilibria.

hidden-attractors-sphere-controls --radius 0.5 --samples 1000

hidden-attractors-refined-basin

A secondary step that takes existing hidden candidates and refines the classification by densely sampling their surrounding basin boundaries.

hidden-attractors-refined-basin --input results/summary.json

Utilities

hidden-attractors-list-candidates

Parses a directory of JSON summaries and lists only the runs that successfully found HIDDEN_CANDIDATE labels.

hidden-attractors-list-candidates --dir results/

hidden-attractors-systems

Lists all chaotic systems currently registered in the system registry.

hidden-attractors-systems

hidden-attractors-check-validation

Checks an output directory for the presence of the required “Validation Artifacts” (trajectories, JSON summaries, plots) as required by the library’s reporting contract.

hidden-attractors-check-validation --dir results/ --strict

Getting Help

All commands support the standard --help flag to view a complete list of arguments and their default values:

hidden-attractors-unified-chua --help