toolbox_chaos
v0.1.0
← All guides

Toolbox Chaos procedure

Export and Reproducibility

Save figures and model definitions together with the numerical contract, organize a compact result package, and make every comparison auditable.

Level Intermediate
GUI tab Guardar gráfica... in analysis tabs; Guardar JSON in Crear sistema; export controls in Explorador Sprott
Research question What must accompany a saved graph so that the computation and its interpretation can be checked later?

Question and result

Calculation performed

Produce outputs that another researcher can identify, repeat, and interpret from the retained numerical record.

Required configuration

  • Decide on an experiment identifier and output folder before a multi-run study.
  • Know which settings belong to the model, the initial state, the numerical method, the analysis, and the visual presentation.

Panel and figure

Displayed quantities

Example export-ready Lorenz phase-space figure
A polished figure becomes reproducible only when it remains linked to its model and numerical contract.
Example export-ready time-signal and spectral figure
Analysis-specific settings such as transient removal and spectral method belong in the same result package.

Configuration and calculation

Control sequence

  1. Name the experiment

    Use a stable identifier that includes model and varied input, for example lorenz_rho_sweep or rossler_method_refinement. Avoid names such as final2 or good_plot.

    Create one folder per study and a subfolder or structured prefix per run.

  2. Record the model contract

    Save catalog label, equation source or citation, parameter names and values in displayed order, initial-state labels and values, and whether the model is a flow, map, delay case, or custom definition.

    For Crear sistema, save the validated JSON alongside the human-readable source of the equations.

  3. Record the numerical contract

    Save method, step size or iteration rule, duration or iteration count, discarded transient, divergence threshold where relevant, and application version.

    For a sweep, record range endpoints, sample count or increment, retained points, plane, grid, and classifier settings as applicable.

  4. Export the primary figure

    Use the panel's Guardar gráfica... control. Prefer PDF when scalable axes and line work are needed, and PNG when a fixed raster is appropriate.

    Verify the saved file outside the application: labels must be readable, the expected plot must be present, and the file must open normally.

  5. Preserve interpretation separately

    Write what the computation directly shows, what is inferred, and which checks were performed. Keep unresolved questions explicit.

    Name each exploratory image according to its run identifier, direct observation, and completed validation checks.

  6. Package comparisons

    Use a table with one row per run and columns for every changed or controlled setting. Include failures, divergent runs, and figures that document the full campaign.

    Check that every manuscript or slide figure maps back to one run identifier and one settings record.

Minimal run record

  • run_id and date
  • system label, equation reference, and parameter vector
  • initial state
  • method, step, duration or iterations
  • transient handling and analysis-specific controls
  • source tab and whether a shared trajectory was reused
  • output filename and format
  • direct observation, inference, checks, and limitations

Record

Computed data

  • A folder containing readable figures, model information, numerical settings, and interpretation notes.
  • A one-to-one mapping between every reported image and the run that generated it.
  • A comparison table that makes controlled and changed inputs visible.

Scientific reading

Interpretation criteria

Reproducibility records the model and computational contract so that the experiment can be repeated and its declared quantities compared across environments.

A trustworthy result package preserves failures, resolution checks, and ambiguity as well as the final presentation figure.

Files

Experiment record

  • Model: equations/source, catalog or custom status, parameters, initial state.
  • Numerics: method, step, duration/iterations, transient, analysis-specific settings.
  • Software: Toolbox Chaos version and operating environment when relevant.
  • Output: tab, format, filename, axes/variables, visual options, and run identifier.
  • Evidence: interpretation, convergence or sensitivity checks, limitations, and unresolved outcomes.

Applications

Questions addressed by the calculation

  • Preparing figures and methods information for articles and theses.
  • Sharing computational experiments within a research group.
  • Building repeatable classroom laboratories and assessment keys.

Scope

Evidence conditions

  • A reproducible result package combines the saved figure with its model, numerical contract, output settings, and interpretation record.
  • Each tab documents the formats provided by its visible export controls; raw-data workflows are recorded separately when available.
  • Reproducible Toolbox output documents the GUI experiment, while Hidden Attractors FO retains its dedicated localization evidence.