Scenario Planning
Use this section when you want to compare historical, manual, and optimised
future plans with abacus.scenarios.
The scenario planner is a higher-level planning surface than the low-level optimisation wrapper. It works in total horizon spend units, returns versioned structured comparison tables, and supports Python and CLI workflows.
abacus.scenario_planner remains the legacy compatibility namespace for
existing statistical imports and advisory dashboard facades. The experimental
abacus-dashboard application is deprecated. Its retained guide documents
historical behaviour; use abacus.scenarios for current workflows.
Pages
- Supported Surface: The recommended scenario entry points, compatibility facades, fitted-run contract, persisted workspace state, and estimator limits.
- Overview and Workflow: What the planner does, how it differs from low-level optimisation, and how scenario windows work.
- Scenario Specifications: The public scenario spec classes, versioned YAML recipes, allocation shapes, bounds, and budget distributions.
- Python API: How to use
ScenarioPlanner.evaluate(...)and run retained recipes from Python, plus the compatibility workspace helpers. - Comparison Outputs: The structure and meaning of
ScenarioResult,ScenarioComparison, retained artefacts, and the dashboard payload contract.
Historical reference
- Deprecated Dash App: Retained documentation for the experimental dashboard. It is not a recommended scenario workflow.