Metrics
A run reports a set of scalars beside its cash flows, and the prefix says who
minted each: model.* metrics are computed by the engine for every model;
domain.* metrics come from the active pack and are absent without one; and
metric.* names a figure the model declared itself — metric <name> = <expr>, evaluated once at the horizon over the finished projection (the
valuation plane), folding any series the model publishes. See the
metrics guide for the declared form's rules.
Model metrics
model.npv discounts the model's net cash flow at the run's rate, and is
published only when the run states a discount rate or a discount series; it
follows the run's valuation_grain. model.irr is the rate at which the NPV
is zero, solved on the model's own grain whatever the valuation_grain, and
is undefined for a series that never changes sign. There is no whole-model
multiple: a model states its own through a party, a slice or a declared
metric. model.payback_years is when cumulative cash first turns positive, and
model.wal_years the weighted average life — when principal actually comes
back, which a maturity date does not tell you.
model.total is the undiscounted sum, and model.net_cash_flow the per-period
series everything else is derived from.
Metrics and subtotals are not the same thing
A metric is one number for the whole model. A subtotal is a series — one value
per period — published under domain.<pack>.<name> in deterministic.series.
Where both exist under the same name, the metric is the reduction of the
subtotal: domain.cre.noi in the metrics block is the sum over periods of
domain.cre.noi in the series block. That is deliberate — one definition,
reduced, rather than two definitions that drift.
A lifetime figure hides the path. A coverage ratio of 1.4 over a hold can contain a year at 0.9, which is why coverage is published per period and read from a statement.
Every domain metric
Generated from each pack's declarations.
energy
| Metric | Kind | Definition |
|---|---|---|
domain.energy.revenue | money | |
domain.energy.opex | money | |
domain.energy.ebitda | money | |
domain.energy.debt_service | money | |
domain.energy.dscr | number | |
domain.energy.tax_benefits | money |
cre
| Metric | Kind | Definition |
|---|---|---|
domain.cre.noi | money | |
domain.cre.debt_service | money | |
domain.cre.dscr | number | |
domain.cre.leasing_costs | money | |
domain.cre.expense_ratio | number | |
domain.cre.total_cost | money | |
domain.cre.equity_contributed | money | |
domain.cre.ltc | number | |
domain.cre.yield_on_cost | number | |
domain.cre.cash_on_cash_year_one | number |
credit
| Metric | Kind | Definition |
|---|---|---|
domain.credit.interest | money | |
domain.credit.principal | money | |
domain.credit.recoveries | money | |
domain.credit.penalties | money | |
domain.credit.servicing | money | |
domain.credit.wal_years | number | |
domain.credit.collections | money | |
domain.credit.purchase | money | |
domain.credit.collections_multiple | number |
opco
| Metric | Kind | Definition |
|---|---|---|
domain.opco.revenue | money | |
domain.opco.ebitda | money | |
domain.opco.ebitda_margin | number | |
domain.opco.capex | money | |
domain.opco.working_capital | money | |
domain.opco.taxes | money | |
domain.opco.debt_service | money | |
domain.opco.fcf | money | |
domain.opco.fcf_to_debt_service | number |
Related
- Metrics guide — choosing and interpreting them.
- Statements — the per-period view.
- Results schema — where each metric sits in the results document.