Timeseries Workflow
Dispatcher workflow for time-series analyses.
This module implements CLI workflow orchestration for its command family, including argument parsing, request construction, execution dispatch, and result presentation handoff.
Usage context
- Command routing: Resolve CLI aliases and normalized command names.
- Task execution: Build request objects and invoke registered tasks.
- Output handling: Forward results to table, plot, export, or report flows.
Command: timeseries
Arguments
No command-specific arguments found.
Common Runtime and Presentation Arguments
These are shared workflow-level CLI flags added before command-specific options, covering runtime context (engine/input/storage) and output presentation/export behavior.
| Flag | Required | Default | Help | Choices |
|---|---|---|---|---|
--field |
No | Dispatcher field expression. Example: --field temperature, which selects simulation temperature time series. | ||
--engine |
No | Engine override. Example: --engine reaxff, which applies ReaxFF-specific loaders. | reaxff, ams, lammps | |
--input |
No | . | Input file or directory for engine resolution. Example: --input runs/job1, which sets base context for file detection. | |
--run-dir |
No | . | Run directory fallback for engine detection. Example: --run-dir runs/job1, which is used as backup lookup path. | |
--xmolout |
No | xmolout | Path to xmolout. Example: --xmolout runs/job1/xmolout, which supplies trajectory coordinate data. | |
--summary |
No | Optional summary.txt path. Example: --summary runs/job1/summary.txt, which provides scalar simulation series data. | ||
--fort7 |
No | fort.7 | Path to fort.7. Example: --fort7 runs/job1/fort.7, which provides charge/bond-order source data. | |
--fort73 |
No | fort.73 | Path to fort.73-style file. Example: --fort73 fort.73, which provides partial-energy time series data. | |
--fort76 |
No | fort.76 | Path to fort.76. Example: --fort76 fort.76, which provides restraint series data. | |
--fort78 |
No | fort.78 | Path to fort.78. Example: --fort78 fort.78, which provides electric-field series data. | |
--fort57 |
No | fort.57 | Path to fort.57. Example: --fort57 fort.57, which provides geometry-optimization series data. | |
--eregime |
No | eregime.in | Path to eregime.in. Example: --eregime eregime.in, which provides imposed field program values. | |
--molfra |
No | molfra.out | Path to molfra.out. Example: --molfra molfra.out, which provides molecular frequency/total series. | |
--control |
No | control | Path to control file for time-axis conversion. Example: --control control, which provides timestep metadata. | |
--log |
No | Logging level. Example: --log verbose, which prints more runtime details. | verbose, quiet | |
--run-id |
No | Run identifier for run-scoped layout (e.g., run_91ac0e). | ||
--project-root |
No | Project root that contains inputs/, data/, analysis/, etc. | ||
--analysis-id |
No | Optional analysis artifact id; defaults to run id. | ||
--plot |
No | Render a plot. Example: --plot single, which creates one combined chart. | single, subplot | |
--show |
No | Show the generated plot window. Example: --show, which opens the figure interactively. | ||
--save |
No | Save the generated plot to a file path. Example: --save temperature.png, which writes the plot image. | ||
--export |
No | Write the result table to CSV. Example: --export temperature.csv, which saves tabular output. | ||
--grid |
No | Subplot grid like 2x2 or 2*2. Example: --grid 2x2, which arranges subplot panels in two rows and two columns. | ||
--xaxis |
No | iter | X-axis domain. Example: --xaxis time, which converts iterations to physical time when possible. | iter, frame, time |
--frames |
No | Frame selector syntax. Example: --frames 0:20:2, which selects frames 0,2,4,...,20. | ||
--every |
No | 1 | Use every Nth selected frame. Example: --every 5, which subsamples selected frames by five. | |
--format |
No | long | Trajectory output table format. Example: --format wide, which pivots compatible outputs into wide columns. | long, wide |
--atoms |
No | Legacy trajectory atom selector. Example: --atoms "1,5,12", which limits trajectory-series extraction to those atom ids. | ||
--atom-types |
No | Legacy trajectory atom-type selector. Example: --atom-types O H, which limits trajectory-series extraction to oxygen/hydrogen. | ||
--dims |
No | Legacy trajectory coordinate dimensions. Example: --dims z, which extracts only z-coordinate series. | x, y, z | |
--reference-frame |
No | 0 | Reference frame index used by displacement fields. Example: --reference-frame 10, which subtracts frame 10 coordinates from each selected frame. | |
--boxdims |
No | Legacy shortcut for cell-dimension extraction from xmolout. Example: --boxdims, which switches to lattice-parameter series mode. | ||
--cell-fields |
No | Legacy cell-dimension fields. Example: --cell-fields a b c alpha beta gamma, which selects listed lattice fields. | ||
--field-kind |
No | auto | Electric-field group. Example: --field-kind applied, which selects externally applied field channels. | applied, energy, auto |
--dropna-rows |
No | Drop rows that are all-NaN across selected restraint fields. Example: --dropna-rows, which removes empty restraint records. | ||
--include-geo-descriptor |
No | Include geo descriptor for geometry optimization data. Example: --include-geo-descriptor, which keeps descriptor annotations in output. |