Skip to content
cleorf92 edited this page Sep 24, 2026 · 16 revisions

Welcome to the aiphoria wiki!

aiphoria is an open-source Python package for dynamic material flow analysis (DMFA) of wood. It follows wood from harvest through processing to products such as buildings, furniture, and paper, and calculates how much carbon these products store over time. You describe your system in an Excel file, so no programming is needed.

NOTE: The scenario file format changed slightly in aiphoria v1.1.0. If you have scenario files made with an older version, see Upgrading from older versions.

Where to start

New to aiphoria?

  1. Installation
  2. Quick start: run the example in a few minutes
  3. How aiphoria works: the ideas behind the model

Building your own model?

  1. Read the Concepts pages: Processes, flows and stocks, Indicators, Scenarios and scenario modes
  2. Start from the example file and follow The scenario file and the sheet pages
  3. Run it: Running your own scenario
  4. Look at the results: Output files and Interactive visualizations

Something not working? See Troubleshooting.

Documentation

Getting started

Concepts

Building a scenario file

Results

Help

Downloadable data files

Funding

aiphoria developers receive funding from the following European Union's Horizon Europe Research and Innovation Programmes:

License

aiphoria is released under the permissive MIT license, which allows commercial use, distribution, modification, and private use. The license is in LICENSE.

aiphoria uses the following third-party libraries:

  • Stock calculations: ODYM, license in lib/LICENSE
  • Network graph: ECharts, license in assets/network_graph/ECHARTS_LICENSE
  • Sankey graph: PlotlyJS, license in assets/datavisualizer/LICENSE

Clone this wiki locally