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 three sections:

• Get started for installation, nomenclature, table formats and scenarios;

• Docs for parsers, inspection, transformations, advanced workflows and the API reference;

• Resources for the software paper and related research.

Citation

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

Contributing

Contributions are welcome. To report a bug or suggest a feature, open an issue on GitHub. To contribute code or documentation, open a pull request against main; for larger changes, open an issue first or contact the maintainers so we can agree on the approach.

License

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

Supporting institutions

MARIO grows across two complementary settings.