IEF logo

Industrial Ecology Freiburg

Research group at the Faculty of Environment and Natural Resources

At Industrial Ecology Freiburg, we work at the forefront of sustainability science. This work involves the development of research infrastructure, including data models, databases, and scenario models for the circular economy. We are committed to open science and share our core model infrastructure and data with the global sustainability science community.

ODYM – The Open Dynamic Material Systems Model


ODYM is an open source framework for material systems modeling programmed in Python. The description of systems, processes, stocks, flows, and parameters is object-based, which facilitates the development of modular software and testing routines for individual model blocks. ODYM MFA was developed for large MFA models that span many years (historic and future) and WHERE different products, components, sub-components, materials, alloys, waste, and chemical elements need to be traced simultaneously. ODYM features a new data structure for material flow analysis; all input and output data are stored in a standardized file format and can thus be exchanged across projects. It also comes with an extended library for dynamic stock modelling, which can also be used as standalone script.


ODYM resources:

Journal paper (open access): https://doi.org/10.1111/jiec.12952

ODYM Python code on GitHub: https://github.com/IndEcol/ODYM with documentation of ODYM classes and functions

The Wiki of the ODYM software: https://github.com/IndEcol/ODYM/wiki

ODYM tutorials and exercises (part of the Industrial Ecology Open Online Course IEooc): https://www.industrialecology.uni-freiburg.de/teaching.aspx (scroll down for IEooc_Methods3_Software3 to IEooc_Methods3_Software8)

ODYM is evolving into a community tool for industrial ecologist, MFA experts, and socio-economic metabolism researchers worldwide. A number of new developments and contributions by different community members are on their way, including routines for Monte-Carlo simulation, data reconciliation, and parallel computing.

RECC - Resource Efficiency – Climate Change mitigation framework


The resource efficiency–climate change (RECC) mitigation model framework is a step towards the interdisciplinary scientific assessment of material efficiency and its links to service provision, material cycle management, and climate policy. RECC is based on dynamic material flow analysis and links the services provided (individual motorized transport and shelter) to the operation of in-use stocks of products (passenger vehicles and residential buildings), to their expansion and maintenance, and to their material cycles to model mitigation strategies and analyze trade-offs for environmental impacts along the products’ life cycle. A key innovation of RECC is the upscaling of product archetypes with different degrees of material and energy efficiency, which are simulated with engineering tools. RECC scenarios are driven by parameters that augment the storylines of the shared socioeconomic pathways (SSP) to describe future service demand and associated material requirements. In its current implementation (model versions 2.2., 2.4, and 2.5), ten material efficiency strategies at different stages of the material cycle can be assessed by ramping up their implementation rates to the identified technical potentials. RECC provides scenario results for the life cycle impacts of ambitious service–material decoupling concurrent with energy system decarbonization, giving detailed insights on the RECC mitigation nexus to policy-makers worldwide.


RECC system definition:

Recc Model
Figure: System definition of the RECC model with global scope..

RECC resources:

Currently, about ten researchers contribute to further developing the RECC model and its database, mainly via the EU CIRCOMOD [https://circomod.eu/] project. We plan to include transportation infrastructure, link the RECC scenarios to sectoral and general equilibrium models, couple RECC to forest growth models, and to study the impact of energy transition and circular economy strategies on different socioeconomic groups. We have a mailing list for internal communication around the model. Contact us if you want to be on the RECC model mailing list!

RECC model brief: RECC_Model_Brief_Nov23.pdf

Overview [presentation (pdf)] on the RECC model framework: RECC_Model_Overview_July_2023.pdf

First RECC results: IRP report link: https://www.resourcepanel.org/reports/resource-efficiency-and-climate-change

Journal paper on the framework (open access): https://onlinelibrary.wiley.com/doi/full/10.1111/jiec.13023

RECC Python code on GitHub: https://github.com/IndEcol/RECC-ODYM

JRECC model development canvas: https://docs.google.com/presentation/d/1Iw8LkWveC-BWy69ULVZdp5Wj2Q1udouwYPtFw2ixsQc/edit?usp=sharing

RECC tutorials:

RECC model tutorial video: https://www.youtube.com/watch?v=zOfo1WTk7d8. This tutorial video show how to run the ODYM-RECC dynamic material flow analysis (MFA) model on your own machine. It explains where the model config information is stored and how the different model scripts work together to compute both single and multiple scenarios.

RECC multi-scenario generation tutorial video [upload to server and link here]: RECC_Multiple_Scenarios_HowTo.mp4

RECC results evaluation tutorial video [upload to server and link here]:RECC_Aggregation_Visualisation_HowTo.mp4

Data documentation routine: The ODYM data process, see the short manual:ODYM_Data_Processes_ODP_Manual.pdf

See the following sample parameter file as example: 2_S_RECC_FinalProducts_2015_nonresbuildings_V2.2.xlsx

RECC v2.5 (current model version):

RECC Python code on GitHub: https://github.com/IndEcol/RECC-ODYM

RECC v2.5 model documentation: https://doi.org/10.6094/UNIFR/242061

RECC v2.5. input database: Publication planned for Q1(24).

RECC v2.5 model result database: Published when available (Q2-3, 2024)

RECC v.2.4:

Journal paper on the global case study on vehicles and buildings (open access): https://doi.org/10.1038/s41467-021-25300-4

Complete RECC v2.4 model documentation with additional results of global case study on vehicles and buildings:https://static-content.springer.com/esm/art%3A10.1038%2Fs41467-021-25300-4/MediaObjects/41467_2021_25300_MOESM1_ESM.pdf

RECC Python code on GitHub: https://github.com/IndEcol/RECC-ODYM

Final model commit for RECC global paper, RECC v2.4: 9c93d9b

Final model commit for RECC v2.4 Germany: cb3a388

RECC v2.4. input database:https://zenodo.org/record/4671644#.YtezrN9CRhE

RECC v2.4 model result database:https://zenodo.org/record/4698619#.Yte09t9CRhE