mariopy 1.0.1

A python package for automating input-output (IO) calculations, models,visualization and scenario and supply-chain analysis

MARIO

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.

What MARIO Supports

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.

Installation

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 with Parquet support:

pip install "mariopy[parquet]"

Install from source:

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

Quickstart

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")

Documentation Map

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

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

License

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

Supporting institutions

MARIO grows across two complementary settings.