Scenario Planning

Use this section when you want to compare historical, manual, and optimised future plans with abacus.scenario_planner.

The scenario planner is a higher-level planning surface than the low-level optimisation wrapper. It works in total horizon spend units, returns structured comparison tables, and includes a supported workspace app for fitted runs.

Pages

  • Supported Surface: The recommended planner entry points, fitted-run contract, persisted workspace state, and beta 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, allocation shapes, bounds, and budget distributions.
  • Python API: How to use ScenarioPlanner.evaluate(...) and the supported workspace helpers from Python.
  • Comparison Outputs: The structure and meaning of ScenarioResult, ScenarioComparison, and the output tables.
  • Dash App: How to launch the supported workspace UI from a fitted run, work with saved workspaces, and understand background jobs.