mario.Database.reset_to_coefficients

Use this before manual coefficient-side scenario edits so the scenario keeps only its stored coefficient blocks.

For the full manual shock workflow, see Shock analyses.

Database.reset_to_coefficients(scenario)

Reset a scenario so only coefficient-side matrices remain materialized.

Parameters:

scenario – Scenario to rewrite.

Returns:

The selected scenario is replaced with its coefficient blocks only.

Return type:

None

Notes

This is useful before manual coefficient-side edits with update_scenarios(). After the reset, already materialized flow-side or derived matrices are discarded so the scenario is left in one consistent coefficient representation.

For IOT databases, the kept blocks are z, e, v, EY, VY and Y.

For SUT databases, the kept blocks are u, s, ea, ec, va, vc, Ya, Yc, EY and VY.

Accessing other matrices afterwards can still trigger on-demand reconstruction from the stored coefficient-side state. This is the preferred setup when a manual shock should propagate through X and then rebuild dependent flow matrices such as Z, V and E.