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.

MARIO requires Python 3.11, 3.12 or 3.13 (>=3.11,<3.14). Python 3.14 and later are not supported because the pinned NumPy version (numpy==2.1.1) supports Python only up to 3.13.

Create a clean environment with an explicit supported Python version:

conda create -n mario python=3.12
conda activate mario

Install from PyPI:

pip install mariopy

Parquet import and export support is included in the default installation.

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.