MARIO stands for Multifunctional Analysis of Regions through Input-Output. It is a Python package for working with Input-Output Tables (IOT) and Supply and Use Tables (SUT). Once parsed, a table becomes a MARIO database that can be inspected, computed, transformed, aggregated, shocked, and exported.

Documentation is available on Read the Docs.

MARIO is designed around a practical IO workflow:

• parse a database from supported sources or load a packaged test table;
• inspect sets, scenarios, and available matrices;
• compute derived matrices and indicators on demand;
• transform, aggregate, or shock the database;
• export the results for roundtrip or downstream analysis.

The current documentation covers both standard parsers and custom database ingestion. Supported workflows include:

• single-region and multi-region systems;
• monetary and hybrid tables where the parser supports them;
• standard sources such as EXIOBASE, EORA, EUROSTAT, FIGARO, WIOD, OECD, and more;
• custom databases from Excel, text, CSV, and pandas-based inputs;
• aggregation, SUT-to-IOT conversion, scenario analysis, and exports.

The package name on PyPI is mariopy, while the import name is mario.

Preferably, create a clean Python environment first:

conda create -n mario python=3.10
conda activate mario

Install from PyPI:

pip install mariopy

Install from source:

git clone https://github.com/it-is-me-mario/MARIO.git
cd MARIO
pip install -e .

A minimal test database is bundled with MARIO:

import mario

db = mario.load_test("IOT")

print(db)
print(db.get_index("Region"))

db.calc_all()
db.to_excel(path="output_folder")

For SUT workflows:

import mario

sut = mario.load_test("SUT")
iot = sut.to_iot(method="B")

The published documentation is organized into a few main sections:

• Setup for installation and first checks;
• Concepts for MARIO terminology and conventions;
• User guide for parsers, inspection, transformations, custom databases, and exports;
• API reference for method-level documentation;
• Publications for the software paper and related research.

Citation guidance and the up-to-date list of publications using MARIO are maintained in the Research section of the documentation.

MARIO is distributed under the GNU General Public License v3.0.

MARIO grows across two complementary settings.

	Politecnico di Milano. Development stays closer to the academic side: research methods, modelling choices, scientific validation, and documentation-oriented workflows.
	eNextGen. As a spin-off of Politecnico di Milano, eNextGen brings MARIO into applied settings for companies and organisations, where the same analytical core supports real decarbonisation, sustainability, and decision-support cases.