Python API

The top-level continuo package exposes a small, focused API: a parser, a model object that wraps the parsed file with its solvers, and a solution object that wraps the solved path. The remaining modules (parser, IR, codegen, solve) are public to the extent that their exceptions are catchable by the user, but their internals are implementation details.

Entry points

continuo.parse(path)

Load a .mod file (macro expansion, parsing, IR) into a Model.

Parameters:

path (str | Path)

Return type:

Model

continuo.parse_string(source, *, base_dir=None)

Load model source given as a string into a Model.

Parameters:

• source (str)

• base_dir (str | Path | None)

Return type:

Model

The Model object

class continuo.api.Model(model)

Bases: object

A loaded model: its symbol table and the solver entry points.

Parameters:

model (ir.Model)

steady_state(*, exogenous=None)

Compute the steady state at the given exogenous configuration.

Parameters:

exogenous (dict[str, float] | None)

Return type:

dict[str, float]

simul(*, horizon=None, intervals=None, scheme=None)

Run the perfect-foresight simulation, returning a Solution.

horizon / intervals / scheme override the model’s simulate command.

Parameters:

• horizon (float | None)

• intervals (int | None)

• scheme (str | None)

Return type:

Solution

The Solution object

class continuo.io.solution.Solution(segments, names, diagnostics=<factory>, converged=True)

Bases: object

A solved path over [0, T], glued from one or more segments.

Parameters:

• segments (tuple[Segment, ...])

• names (tuple[str, ...])

• diagnostics (dict)

• converged (bool)

to_dataframe()

Return the path as a time-indexed pandas.DataFrame.

to_xarray()

Return the path as an xarray.Dataset over the time coordinate.

A Solution aggregates one or more Segment records (one per active belief — see The shocks block):

class continuo.io.solution.Segment(start_time, times, path, names, info_set, terminal_ss, iterations)

Bases: object

One realised segment of the path and the regime it was solved under.

Parameters:

• start_time (float)

• times (ndarray)

• path (ndarray)

• names (tuple[str, ...])

• info_set (dict[str, float])

• terminal_ss (dict[str, float])

• iterations (int)

Exceptions

Each pipeline stage raises a dedicated exception so user code can distinguish where a problem originated. All four inherit from Exception (not from one another); a CLI-style “any pipeline error” catch is except (MacroError, LarkError, IRError, CodegenError, SolveError).

exception continuo.macro.MacroError(message, *, file=None, line=None)

Bases: Exception

A macro-layer error, optionally carrying a source position.

The expression layer raises these without a position; the expansion driver attaches file/line as it unwinds.

Parameters:

• message (str)

• file (str | None)

• line (int | None)

exception continuo.ir.IRError(message, pos=None)

Bases: Exception

A semantic error, optionally carrying a source position.

pos refers to the post-macroexpansion source; callers holding the macro line map format it back to the user’s original file.

Parameters:

• message (str)

• pos (SourcePos | None)

exception continuo.codegen.CodegenError(message, pos=None)

Bases: Exception

A lowering error, optionally carrying a source position.

Parameters:

• message (str)

• pos (SourcePos | None)

exception continuo.solve.SolveError

Bases: Exception

A numerical solve failure.