Skip to content


Repository files navigation


A python package to model Circular Economy policy and technological interventions in Environmentally Extended Input-Output Analysis starting from SUTs (EXIOBASE V3.3)

DOI License: GPL v3 Contributions welcome


To cite the use of the software in your research please use the following publication:

"Modeling the circular economy in environmentally extended input-output tables: Methods, software and case study"


Stable release

Run in your terminal:

$ pip install pycirk

From source

Clone repository:

$ git clone


$ git clone

Once you have a copy of the source, you can install it with:

$ python install


You can download the biregional or multiregional database by following this link

You need to place the data inside the package e.g. /home/UserName/.local/lib/python3.6/site-packages/pycirk/data


Import package

import pycirk


my_work = pycirk.Launch(method, directory, aggregation, make_secondary)

set your scenarios and analysis

  1. Open scenarios.xls in the directory that was specified
  2. From there you can specify interventions and parameters for the analysis
  3. save and continue to the following steps

Run scenarios

Run one specific scenario

my_work.scenario_results(scen_no, output_dataset)
(0 = baseline)

Run all scenarios


save scenarios

Save your results


Use from command line

pycirk --help

Usage: pycirk [OPTIONS]

Console script for pycirk. A software to model policy and technological interventions in Environmentally Extended Input-Output Analysis (EXIOBASE V3.3, 2011)


Command Variables
-tm, --transf_method TEXT 0 = PXP ITA_TC; 1 = PXP ITA_MSC
-dr, --directory TEXT if left black it will be default
-ag, --aggregation 1 = bi-regional (EU-ROW)
0 = None (49 regions)
-sc, --scenario TEXT all, 1, 2,... accepted - 0=baseline
-s, --save TEXT False=no, True=yes
-od, --output_dataset False=no, True=yes
--help Show this message and exit.

Command example

pycirk -tm 0 -dr "" -sc "1" -s True -od False


Examples of policies that can be modelled through the software:

  • sharing
  • recycling
  • life extension
  • rebound effects
  • substituion
  • market and value added changes
  • efficiency

The tables in which it is possible to apply changes:

  • total requirement matrix (A)

  • intermediate transactions (Z)

  • final demand (Y)

  • primary inputs (W)

  • emission intermediate extentions (E)

  • material intermediate extensions (M)

  • resource intermediate extensions (R)

  • emission final demand extension (EY)

  • material final demand extension (MY)

  • resource final demand extensions (RY)

  • primary inputs coefficients (w)

  • emission intermediate extentions coefficients (e)

  • material intermediate extensions coefficients (m)

  • resource intermediate extensions coefficients (r)

  • emission final demand extension coefficients (eY)

  • material final demand extension coefficients (mY)

  • resource final demand extensions coefficients (rY)

It is possible to specify:

  • region of the intervention
  • whether the intervention affects domestic, import transactions or both

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

Cookiecutter: audreyr/cookiecutter-pypackage`: