Skip to content

Indicators

cleorf92 edited this page Sep 25, 2026 · 2 revisions

In short

Every flow in aiphoria has a baseline value: the amount of material, in the unit set in the Settings sheet (baseline_value_name and baseline_unit_name, for example Solid wood equivalent in Mm3).

An indicator is an extra quantity that aiphoria calculates for each flow from that baseline value, for example the carbon in the wood. You give a conversion factor, and aiphoria multiplies:

indicator value = baseline value of the flow × conversion factor

Carbon is the most common indicator, but you can add any quantity that is proportional to the amount of material, and as many indicators as you need.

NOTE: indicators can be also thought as elements i.e., any extra quantity that can be derived with multiplying with the baseline value.

Why the unit looks "absolute" but the value looks like a share

This is the most common point of confusion. In the Flows sheet:

... Value Unit Year ... Carbon (Mt) Comment
Sawnwood → Construction 60 % 2021 0.225 IPCC default
  • The column header Carbon (Mt) gives the indicator name (Carbon) and the unit of the result (Mt).
  • The cell 0.225 is not a flow value and not a share. It is the conversion factor: Mt of carbon per Mm³ of the baseline value (0.225 t C per m³).
  • The Value/Unit columns of the row (60, %) describe the baseline flow only. Shares and absolute values are solved first; the indicator is applied afterwards to the solved absolute value.

So in the example, the solver first finds that 60% of sawnwood is 24 Mm³ going to construction, and then calculates 24 × 0.225 = 5.4 Mt C.

In other words, the factor always means:

indicator unit per baseline unit, here Mt C per Mm³ (= t C per m³)

Make sure the factor matches the units you chose. If your baseline is in tonnes of dry matter, a carbon factor of about 0.5 (t C per t dry matter) is typical.

How to add an indicator

Each indicator uses two columns at the right end of the Flows sheet, in this order:

  1. Name (unit): the conversion factor. The text in brackets becomes the indicator unit.
  2. Comment: free text, for example the source of the factor.

You can add several indicators by adding more column pairs, for example:

Carbon (Mt) Comment Energy (PJ) Comment Dry mass (Mt) Comment
0.225 IPCC 7.6 lower heating value 0.45 basic density

Useful examples:

Indicator Typical factor (per m³ of wood) What it gives you
Carbon (Mt) ≈ 0.2–0.27 t C carbon stocks and CO2 removals
Dry mass (Mt) basic density, ≈ 0.4–0.5 t mass balance in tonnes
Energy (PJ) heating value, ≈ 7–9 GJ energy content of flows
Value (M€) price per m³ economic value of flows

The factor is set per flow row, so it can differ between products (for example sawnwood and panels) and between years.

What happens in the model

  • Flows: every flow gets a value for each indicator. They appear as extra columns in the Flows sheet of combined_scenario_data.xlsx and in the Sankey and network graph outputs.
  • Stocks: for each in-use stock, aiphoria runs one dynamic stock model per indicator, next to the baseline one. Results are in <scenario>_dynamic_stocks.xlsx (sheet Total_stock, column Indicator).
  • Stock outflows: you only need factors on flows into a stock. Outflows from the stock (for example construction wood to incineration) get their indicator values from the stock itself, so they do not need a factor.
  • CO2 removals: aiphoria calculates annual CO2 removals and emissions from the indicator named exactly Carbon, using conversion_factor_c_to_co2 from the Settings sheet (−3.667, that is, −44/12, in the example file; the minus sign means that a growing stock is reported as a removal). Keep the name Carbon if you want these results.

Things to watch

  • Empty cells count as zero. A flow without a factor carries no indicator. In the packaged example only the flows into construction and furniture have a carbon factor, which is enough for the stock results. If you want a complete carbon account for all flows (for example in the Sankey), give every flow a factor.
  • Always two columns per indicator. An odd number of indicator columns stops the run with an error.
  • Indicators must be the last columns of the Flows sheet. Do not add other columns after them.
  • Indicators are linear. They cannot describe quantities that are not proportional to the amount of material.

Next: Scenarios and scenario modes

Clone this wiki locally