time-stepping

What problem does it solve?

Plan and control time-step policies for simulations. Use when coupling CFL/physics limits with adaptive stepping, ramping initial transients, scheduling outputs/checkpoints, or planning restart strategies for long runs.

Core Features & Use Cases

• Adaptive stepping policies: combine stability limits with targets and safety margins.
• Ramping startup: implement linear, geometric, or adaptive ramping of initial transients.
• Output & checkpoint cadence: schedule regular outputs and restarts to minimize lost work.
• Restart planning: precompute restart readiness for long runs.

Quick Start

Run a ramped plan from 1e-4 to 1e-4 target with dt_limit 2e-4 and 10 ramp steps: python3 scripts/timestep_planner.py --dt-target 1e-4 --dt-limit 2e-4 --safety 0.8 --ramp-steps 10 --json