toolbox_chaos v0.1.0
← All guides

Toolbox Chaos procedure

Spectral Analysis

Compute a Welch power spectral density or a one-sided amplitude spectrum from a trajectory, with explicit transient and frequency-window choices.

Level Intermediate
GUI tab Espectro
Research question Which frequency components or broadband features are present in the selected finite time series after the declared transient?

Question and result

Calculation performed

Use frequency-domain summaries with correct units and classify peaks or broadband content through the required dynamical evidence.

Required configuration

  • Obtain a sufficiently sampled trajectory and inspect its time series first.
  • Know the sampling step and, if physical units are claimed, the time and state-variable units.

Panel and figure

Displayed quantities

Current Espectro tab displaying Welch PSD for the three Lorenz state variables
The current GUI exposes the spectral method, discarded transient, and optional frequency bounds next to the result.
Lorenz frequency-domain output generated from a finite trajectory
Spectral structure must be interpreted together with the retained time window, sampling step, and selected spectral quantity.

Configuration and calculation

Control sequence

  1. Choose the spectral quantity

    Select PSD de Welch (recomendado) for an averaged one-sided power spectral density with density scaling, or Espectro de amplitud for a one-sided Hann-windowed amplitude spectrum.

    Label the output according to its ordinate: an amplitude spectrum and a PSD use different meanings and units.

  2. Provide the trajectory

    Run a local simulation or press Usar última trayectoria after confirming the source system and sampling step.

    Use the same source trajectory when comparing Welch and amplitude modes so the comparison isolates the analytical difference.

  3. Discard a declared transient

    Set Descartar transitorio (s) to exclude the approach interval identified in the time-series view. The value must be shorter than the total trajectory.

    Report the retained window length because it controls frequency resolution and statistical stability.

  4. Set frequency limits

    Leave both limits at zero for automatic display, or set a valid minimum and maximum to focus on a known band.

    Keep the full frequency range in the evidence record and label any display-focused frequency band.

  5. Calculate and compare states

    Press Calcular FFT/PSD and inspect all displayed state spectra. Identify narrow peaks, harmonics, low-frequency energy, broad bands, and the noise floor or numerical floor.

    Repeat with a longer retained window and a refined integration step when spectral claims matter.

  6. Save with units and method

    Export the graph and name the method in the caption. If a state has units U and time is in seconds, Welch density is expressed in U²/Hz; the amplitude spectrum is expressed in U.

    Record sampling step, retained duration, transient, windowing/method label, and frequency crop.

Record

Computed data

  • One spectrum per displayed state over a known retained time window.
  • A method-specific interpretation that distinguishes power density from amplitude.
  • A stability check using a longer window, smaller step, or both when conclusions depend on spectral structure.

Scientific reading

Interpretation criteria

A narrow fundamental and harmonics are compatible with periodic or strongly oscillatory behavior. Broader content can be associated with irregular dynamics, modulation, transients, or numerical effects.

Welch averaging trades frequency resolution for variance reduction. The amplitude spectrum retains a different scale; neither output alone proves chaos or asymptotic behavior.

Files

Experiment record

  • State Welch PSD or amplitude spectrum explicitly.
  • Record units, step, retained duration, discarded transient, and frequency bounds.
  • Keep the corresponding time-series figure from the same trajectory.

Applications

Questions addressed by the calculation

  • Identifying dominant oscillatory scales and harmonics.
  • Comparing spectral changes across a controlled parameter series.
  • Screening time series before more specialized signal or nonlinear-dynamics analysis.

Scope

Evidence conditions

  • Periodicity, chaos, attraction, and hiddenness are assessed by combining spectral output with trajectory, convergence, and model-specific evidence.
  • Short records, unremoved transients, coarse sampling, and frequency cropping can produce misleading features.
  • This tab provides Welch PSD and amplitude spectrum; entropy, dimension, and advanced spectral analyses require their own documented methods.