Skip to content

Animate Command

Prerequisites

  • A valid backtest_result.json artifact already exists.
  • Output directory is writable.
  • Install visual extras first: pip install "stacksats[viz]".

Command

stacksats strategy animate \
  --backtest-json output/<strategy_id>/<version>/<run_id>/backtest_result.json \
  --output-dir output/<strategy_id>/<version>/<run_id> \
  --output-name strategy_vs_uniform_hd.gif \
  --fps 20 \
  --width 1920 \
  --height 1080 \
  --max-frames 240 \
  --window-mode rolling

Expected output

  • GIF file (default strategy_vs_uniform_hd.gif).
  • animation_manifest.json with schema_version, render metadata, source path, and strategy provenance.

Key options

  • --window-mode rolling|non-overlapping (default rolling).
  • --max-frames <int> to cap render size/time.
  • --fps, --width, --height for output quality.

Troubleshooting

  • If JSON parse fails, verify backtest_result.json includes schema_version, provenance, summary_metrics, and window_level_data.
  • If render is slow, lower --fps, --max-frames, or output dimensions.

Next step

  • Share alongside validation/backtest metrics, not as a standalone performance claim.

Feedback