.. role:: pythoncode(code)
:language: python
#######
BoARIO
#######
|build-status| |black| |contribute| |licence| |pypi| |pythonv| |joss|
.. |build-status| image:: https://img.shields.io/github/actions/workflow/status/spjuhel/boario/CI.yml
:target: https://github.com/spjuhel/BoARIO/actions/workflows/CI.yml
:alt: GitHub Actions Workflow Status
.. |black| image:: https://img.shields.io/badge/code%20style-black-000000
:target: https://github.com/psf/black
:alt: Code Style - Black
.. |contribute| image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat
:target: https://github.com/spjuhel/BoARIO/issues
:alt: Contribution - Welcome
.. |licence| image:: https://img.shields.io/badge/License-GPLv3-blue
:target: https://www.gnu.org/licenses/gpl-3.0
:alt: Licence - GPLv3
.. |pypi| image:: https://img.shields.io/pypi/v/boario
:target: https://pypi.org/project/boario/
:alt: PyPI - Version
.. |pythonv| image:: https://img.shields.io/pypi/pyversions/boario
:target: https://pypi.org/project/boario/
:alt: PyPI - Python Version
.. |joss| image:: https://joss.theoj.org/papers/71386aa01a292ecff8bafe273b077701/status.svg
:target: https://joss.theoj.org/papers/71386aa01a292ecff8bafe273b077701
:alt: Joss Status
`BoARIO` : The Adaptative Regional Input Output model in python.
.. _`Documentation Website`: https://spjuhel.github.io/BoARIO/boario-what-is.html
Disclaimer
===========
Indirect impact modeling is tied to a lot of uncertainties and complex dynamics.
Any results produced with `BoARIO` should be interpreted with great care. Do not
hesitate to contact the main author when using the model!
Furthermore, this project is currently developed on the free time of its main contributor,
without any financial supports. If you are interested in its further development and have funding
capacity, please reach out!
What is BoARIO ?
=================
BoARIO, is a python implementation project of the Adaptative Regional Input Output (ARIO) model [`Hal13`_].
Its objectives are to give an accessible and inter-operable implementation of ARIO, as well as tools to visualize and analyze simulation outputs and to
evaluate the effects of many parameters of the model.
This implementation would not have been possible without the `Pymrio`_ module and amazing work of [`Sta21`_].
It is still an ongoing project (in parallel with a PhD project).
.. _`Sta21`: https://openresearchsoftware.metajnl.com/articles/10.5334/jors.251/
.. _`Hal13`: https://doi.org/10.1111/j.1539-6924.2008.01046.x
.. _`Pymrio`: https://pymrio.readthedocs.io/en/latest/intro.html
You can find most academic literature using ARIO or related models `here <https://spjuhel.github.io/BoARIO/boario-references.html>`_
What is ARIO ?
===============
ARIO stands for Adaptive Regional Input-Output. It is an hybrid input-output / agent-based economic model,
designed to compute indirect costs from economic shocks. Its first version dates back to 2008 and has originally
been developed to assess the indirect costs of natural disasters [`Hal08`_].
In ARIO, the economy is modelled as a set of economic sectors and a set of regions.
Each economic sector produces its generic product and draws inputs from an inventory.
Each sector answers to a total demand consisting of a final demand (household consumption,
public spending and private investments) of all regions (local demand and exports) and
intermediate demand (through inputs inventory resupply). An initial equilibrium state of
the economy is built based on multi-regional input-output tables (MRIOTs).
For a more detailed description, please refer to the `Mathematical documentation`_ of the model.
Multi-Regional Input-Output tables
-------------------------------------
Multi-Regional Input-Output tables (MRIOTs) are comprehensive economic data sets
that capture inter-regional trade flows, production activities, and consumption
patterns across different regions or countries. These tables provide a detailed
breakdown of the flows of goods and services between industries within each
region and between regions themselves. MRIOTs are constructed through a
combination of national or regional input-output tables, international trade
data, and other relevant economic statistics. By integrating data from multiple
regions, MRIOTs enable the analysis of global supply chains, international trade
dependencies, and the estimation of economic impacts across regions. However,
they also come with limitations, such as data inconsistencies across regions,
assumptions about trade patterns and production technologies, and the challenge
of ensuring coherence and accuracy in the aggregation of data from various
sources.
.. _`Mathematical documentation`: https://spjuhel.github.io/BoARIO/boario-math.html
.. _`Hal08`: https://doi.org/10.1111/risa.12090
Where to get BoARIO ?
==========================
You can install BoARIO from ``pip`` with:
.. code:: console
pip install boario
Or from ``conda-forge`` using conda (or mamba):
.. code:: console
conda install -c conda-forge boario
The full source code is also available on Github at: https://github.com/spjuhel/BoARIO
More info in the `installation <https://spjuhel.github.io/BoARIO/boario-installation.html>`_ page of the documentation.
How does BoARIO work?
=========================
In a nutshell, BoARIO takes the following inputs :
- a (possibly Environmentally Extended) Multi-Regional IO table (such as `EXIOBASE 3`_ or `EORA26`_) in the form of an ``pymrio.IOSystem`` object, using the `Pymrio`_ python package. Please reference the `Pymrio documentation <https://github.com/IndEcol/pymrio>`_ for details on methods available to pymrio objects.
- multiple parameters which govern the simulation,
- event(s) description(s), which are used as the perturbation to analyse during the simulation
And produces the following outputs:
- the step by step, sector by sector, region by region evolution of most of the variables involved in the simulation (`production`, `demand`, `stocks`, ...)
- aggregated indicators for the whole simulation (`shortages duration`, `aggregated impacts`, ...)
.. _`EXIOBASE 3`: https://www.exiobase.eu/
.. _`EORA26`: https://worldmrio.com/eora26/
Example of use
=================
See `Boario quickstart <https://spjuhel.github.io/BoARIO/boario-tutorials.html>`_.
Credits
========
Associated PhD project
------------------------
This model was developed during project founder's PhD on the indirect impact of extreme events (`Thesis available here`_).
This PhD was supported by the French Environment and Energy Management Agency (`ADEME`_).
.. image:: https://raw.githubusercontent.com/spjuhel/BoARIO/master/imgs/Logo_ADEME.svg?sanitize=true
:width: 400
:alt: ADEME Logo
.. _`ADEME`: https://www.ademe.fr/
.. _`Thesis available here`: https://theses.hal.science/tel-05045805
Development
------------
- Samuel Juhel (pro@sjuhel.org)
Contributions
---------------
All `contributions <https://spjuhel.github.io/BoARIO/development.html>`_ to the project are welcome !
Acknowledgements
------------------
I would like to thank Vincent Viguie, Fabio D'Andrea my PhD supervisors as well as Célian Colon, Alessio Ciulo and Adrien Delahais
for their inputs during the model implementation.
Raw data
{
"_id": null,
"home_page": "https://github.com/spjuhel/BoARIO",
"name": "boario",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "ario, economics, events, extreme, impact, indirect, input-output, modeling, mrio",
"author": "Samuel Juhel",
"author_email": "pro@sjuhel.org",
"download_url": "https://files.pythonhosted.org/packages/2a/08/cabeb34b533d9046169d78a99e09d4546dcdab1ba3cf464176e629095b21/boario-0.7.0.tar.gz",
"platform": null,
"description": ".. role:: pythoncode(code)\n :language: python\n\n#######\nBoARIO\n#######\n|build-status| |black| |contribute| |licence| |pypi| |pythonv| |joss|\n\n.. |build-status| image:: https://img.shields.io/github/actions/workflow/status/spjuhel/boario/CI.yml\n :target: https://github.com/spjuhel/BoARIO/actions/workflows/CI.yml\n :alt: GitHub Actions Workflow Status\n.. |black| image:: https://img.shields.io/badge/code%20style-black-000000\n :target: https://github.com/psf/black\n :alt: Code Style - Black\n.. |contribute| image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat\n :target: https://github.com/spjuhel/BoARIO/issues\n :alt: Contribution - Welcome\n.. |licence| image:: https://img.shields.io/badge/License-GPLv3-blue\n :target: https://www.gnu.org/licenses/gpl-3.0\n :alt: Licence - GPLv3\n.. |pypi| image:: https://img.shields.io/pypi/v/boario\n :target: https://pypi.org/project/boario/\n :alt: PyPI - Version\n.. |pythonv| image:: https://img.shields.io/pypi/pyversions/boario\n :target: https://pypi.org/project/boario/\n :alt: PyPI - Python Version\n.. |joss| image:: https://joss.theoj.org/papers/71386aa01a292ecff8bafe273b077701/status.svg\n :target: https://joss.theoj.org/papers/71386aa01a292ecff8bafe273b077701\n :alt: Joss Status\n\n`BoARIO` : The Adaptative Regional Input Output model in python.\n\n.. _`Documentation Website`: https://spjuhel.github.io/BoARIO/boario-what-is.html\n\nDisclaimer\n===========\n\nIndirect impact modeling is tied to a lot of uncertainties and complex dynamics.\nAny results produced with `BoARIO` should be interpreted with great care. Do not\nhesitate to contact the main author when using the model!\n\nFurthermore, this project is currently developed on the free time of its main contributor,\nwithout any financial supports. If you are interested in its further development and have funding\ncapacity, please reach out!\n\nWhat is BoARIO ?\n=================\n\nBoARIO, is a python implementation project of the Adaptative Regional Input Output (ARIO) model [`Hal13`_].\n\nIts objectives are to give an accessible and inter-operable implementation of ARIO, as well as tools to visualize and analyze simulation outputs and to\nevaluate the effects of many parameters of the model.\n\nThis implementation would not have been possible without the `Pymrio`_ module and amazing work of [`Sta21`_].\n\nIt is still an ongoing project (in parallel with a PhD project).\n\n.. _`Sta21`: https://openresearchsoftware.metajnl.com/articles/10.5334/jors.251/\n.. _`Hal13`: https://doi.org/10.1111/j.1539-6924.2008.01046.x\n.. _`Pymrio`: https://pymrio.readthedocs.io/en/latest/intro.html\n\nYou can find most academic literature using ARIO or related models `here <https://spjuhel.github.io/BoARIO/boario-references.html>`_\n\n\nWhat is ARIO ?\n===============\n\nARIO stands for Adaptive Regional Input-Output. It is an hybrid input-output / agent-based economic model,\ndesigned to compute indirect costs from economic shocks. Its first version dates back to 2008 and has originally\nbeen developed to assess the indirect costs of natural disasters [`Hal08`_].\n\nIn ARIO, the economy is modelled as a set of economic sectors and a set of regions.\nEach economic sector produces its generic product and draws inputs from an inventory.\nEach sector answers to a total demand consisting of a final demand (household consumption,\npublic spending and private investments) of all regions (local demand and exports) and\nintermediate demand (through inputs inventory resupply). An initial equilibrium state of\nthe economy is built based on multi-regional input-output tables (MRIOTs).\n\nFor a more detailed description, please refer to the `Mathematical documentation`_ of the model.\n\nMulti-Regional Input-Output tables\n-------------------------------------\n\nMulti-Regional Input-Output tables (MRIOTs) are comprehensive economic data sets\nthat capture inter-regional trade flows, production activities, and consumption\npatterns across different regions or countries. These tables provide a detailed\nbreakdown of the flows of goods and services between industries within each\nregion and between regions themselves. MRIOTs are constructed through a\ncombination of national or regional input-output tables, international trade\ndata, and other relevant economic statistics. By integrating data from multiple\nregions, MRIOTs enable the analysis of global supply chains, international trade\ndependencies, and the estimation of economic impacts across regions. However,\nthey also come with limitations, such as data inconsistencies across regions,\nassumptions about trade patterns and production technologies, and the challenge\nof ensuring coherence and accuracy in the aggregation of data from various\nsources.\n\n.. _`Mathematical documentation`: https://spjuhel.github.io/BoARIO/boario-math.html\n\n.. _`Hal08`: https://doi.org/10.1111/risa.12090\n\nWhere to get BoARIO ?\n==========================\n\nYou can install BoARIO from ``pip`` with:\n\n.. code:: console\n\n pip install boario\n\nOr from ``conda-forge`` using conda (or mamba):\n\n.. code:: console\n\n conda install -c conda-forge boario\n\n\nThe full source code is also available on Github at: https://github.com/spjuhel/BoARIO\n\nMore info in the `installation <https://spjuhel.github.io/BoARIO/boario-installation.html>`_ page of the documentation.\n\nHow does BoARIO work?\n=========================\n\nIn a nutshell, BoARIO takes the following inputs :\n\n- a (possibly Environmentally Extended) Multi-Regional IO table (such as `EXIOBASE 3`_ or `EORA26`_) in the form of an ``pymrio.IOSystem`` object, using the `Pymrio`_ python package. Please reference the `Pymrio documentation <https://github.com/IndEcol/pymrio>`_ for details on methods available to pymrio objects.\n\n- multiple parameters which govern the simulation,\n\n- event(s) description(s), which are used as the perturbation to analyse during the simulation\n\nAnd produces the following outputs:\n\n- the step by step, sector by sector, region by region evolution of most of the variables involved in the simulation (`production`, `demand`, `stocks`, ...)\n\n- aggregated indicators for the whole simulation (`shortages duration`, `aggregated impacts`, ...)\n\n.. _`EXIOBASE 3`: https://www.exiobase.eu/\n.. _`EORA26`: https://worldmrio.com/eora26/\n\nExample of use\n=================\n\nSee `Boario quickstart <https://spjuhel.github.io/BoARIO/boario-tutorials.html>`_.\n\nCredits\n========\n\nAssociated PhD project\n------------------------\n\nThis model was developed during project founder's PhD on the indirect impact of extreme events (`Thesis available here`_).\nThis PhD was supported by the French Environment and Energy Management Agency (`ADEME`_).\n\n.. image:: https://raw.githubusercontent.com/spjuhel/BoARIO/master/imgs/Logo_ADEME.svg?sanitize=true\n :width: 400\n :alt: ADEME Logo\n\n.. _`ADEME`: https://www.ademe.fr/\n.. _`Thesis available here`: https://theses.hal.science/tel-05045805\n\nDevelopment\n------------\n\n - Samuel Juhel (pro@sjuhel.org)\n\nContributions\n---------------\n\nAll `contributions <https://spjuhel.github.io/BoARIO/development.html>`_ to the project are welcome !\n\nAcknowledgements\n------------------\n\nI would like to thank Vincent Viguie, Fabio D'Andrea my PhD supervisors as well as C\u00e9lian Colon, Alessio Ciulo and Adrien Delahais\nfor their inputs during the model implementation.\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 or later (GPLv3+)",
"summary": "BoARIO : The Adaptative Regional Input Output model in python.",
"version": "0.7.0",
"project_urls": {
"Bug Reports": "https://github.com/spjuhel/BoARIO/issues",
"Documentation": "https://spjuhel.github.io/BoARIO/index.html",
"Homepage": "https://github.com/spjuhel/BoARIO",
"Source": "https://github.com/spjuhel/BoARIO/"
},
"split_keywords": [
"ario",
" economics",
" events",
" extreme",
" impact",
" indirect",
" input-output",
" modeling",
" mrio"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6e445812b672d1fabc33dd31d55b00e2396ba3e3cd5b50a413d377f241b6c7d0",
"md5": "e5b1efccad5b91846664565518ae24ee",
"sha256": "d7a123f905df1afc1703042221eb5a103a71da609bd35847446f02129e6d6496"
},
"downloads": -1,
"filename": "boario-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5b1efccad5b91846664565518ae24ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 58169,
"upload_time": "2025-10-23T13:32:56",
"upload_time_iso_8601": "2025-10-23T13:32:56.340322Z",
"url": "https://files.pythonhosted.org/packages/6e/44/5812b672d1fabc33dd31d55b00e2396ba3e3cd5b50a413d377f241b6c7d0/boario-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2a08cabeb34b533d9046169d78a99e09d4546dcdab1ba3cf464176e629095b21",
"md5": "97754767506ceb1aab132ce91226854b",
"sha256": "2058d96006eec4c376121e734dec93a01ad61a363a9fa414f9d8a34fd08ba60f"
},
"downloads": -1,
"filename": "boario-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "97754767506ceb1aab132ce91226854b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 1919409,
"upload_time": "2025-10-23T13:32:59",
"upload_time_iso_8601": "2025-10-23T13:32:59.222465Z",
"url": "https://files.pythonhosted.org/packages/2a/08/cabeb34b533d9046169d78a99e09d4546dcdab1ba3cf464176e629095b21/boario-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 13:32:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "spjuhel",
"github_project": "BoARIO",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "boario"
}
JSON
