MARIO

Perform impact analysis using regional input-output tables and models.
https://github.com/it-is-me-mario/mario

Category: Industrial Ecology
Sub Category: Input Output Model

Last synced: about 22 hours ago
JSON representation

Repository metadata

Multifunctional Analysis of Regions through Input-Output

• Host: GitHub
• URL: https://github.com/it-is-me-mario/mario
• Owner: it-is-me-mario
• License: gpl-3.0
• Created: 2021-10-27T16:50:58.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2026-05-23T10:12:43.000Z (5 days ago)
• Last Synced: 2026-05-23T12:15:24.642Z (5 days ago)
• Language: Python
• Size: 52.9 MB
• Stars: 52
• Watchers: 1
• Forks: 15
• Open Issues: 30
• Releases: 11
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE
  • Zenodo: .zenodo.json

README.rst

          .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. image:: https://readthedocs.org/projects/mario-suite/badge/?version=latest
    :target: https://mario-suite.readthedocs.io/en/latest/index.html
    :alt: Documentation Status

.. image:: https://badge.fury.io/py/mariopy.svg
    :target: https://badge.fury.io/py/mariopy

.. image:: https://zenodo.org/badge/421900437.svg
   :target: https://zenodo.org/badge/latestdoi/421900437

*******
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:

.. code-block:: bash

   conda create -n mario python=3.10
   conda activate mario

Install from PyPI:

.. code-block:: bash

   pip install mariopy

Install from source:

.. code-block:: bash

   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:

.. code-block:: python

   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:

.. code-block:: python

   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.

.. raw:: html

    

       

          

             
                
             
          
          

             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.
          
       
    

        

---

Owner metadata

• Name: MARIO
• Login: it-is-me-mario
• Email:
• Kind: organization
• Description: Multifunctional Analysis of Regions through Input-Output
• Website: https://mario-suite.readthedocs.io/en/latest/index.html
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/121170888?v=4
• Repositories: 1
• Last ynced at: 2023-03-09T21:42:06.052Z
• Profile URL: https://github.com/it-is-me-mario

---

GitHub Events

Total

• Release event: 2
• Delete event: 20
• Member event: 1
• Pull request event: 20
• Fork event: 2
• Issues event: 24
• Watch event: 7
• Issue comment event: 4
• Push event: 144
• Pull request review comment event: 21
• Pull request review event: 26
• Create event: 16

Last Year

• Delete event: 12
• Watch event: 2
• Push event: 56
• Pull request review event: 3
• Pull request review comment event: 3
• Create event: 6

---

Committers metadata

Last synced: 3 days ago

Name	Email	Commits
Mohammad Amin Tahavori	5****t	208
Lorenzo Rinaldi	l****3@g****m	190
Nicolò Golinucci	n****i@g****m	11
LorenzoRinaldi	l****1@g****m	8
Amedeo Felice Alberio	a****a@f****m	1

Committer domains:

• fb.com: 1

---

Issue and Pull Request metadata

Last synced: 21 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/it-is-me-mario/mario

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 111 last-month
• Total dependent packages: 1
• Total dependent repositories: 1
• Total versions: 10
• Total maintainers: 2

---

Dependencies

Score: 10.761089288061603