Repository navigation
Indicators
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.
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.225is 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.
Each indicator uses two columns at the right end of the Flows sheet, in this order:
-
Name (unit): the conversion factor. The text in brackets becomes the indicator unit. - 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.
-
Flows: every flow gets a value for each indicator. They appear as extra
columns in the
Flowssheet ofcombined_scenario_data.xlsxand 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(sheetTotal_stock, columnIndicator). - 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, usingconversion_factor_c_to_co2from 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 nameCarbonif you want these results.
- 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.
Getting started
Concepts
Building a scenario file
Results
Help