mario.parse_emerging#

mario.parse_emerging(path: str, table: str = 'IOT', year: int | None = None, regions=None, load_co2: bool = True, co2_path: str | None = None, labels_path: str | None = None, variant: str = 'standard', model: str = 'Database', name: str | None = None, calc_all: bool = False, **kwargs) → object#

Parse one EMERGING MATLAB bundle from the supported Zenodo releases.

This parser supports the EMERGING bundles associated with these official

Zenodo version records: https://doi.org/10.5281/zenodo.10956623 for the older v1.0 release with files like global_mrio_2017.mat and EMERGING_CO2_2017.mat; https://doi.org/10.5281/zenodo.17557778 for v2.0; https://doi.org/10.5281/zenodo.18518911 for v2.1; https://doi.org/10.5281/zenodo.19461860 for v2.2; and https://doi.org/10.5281/zenodo.18303090 for the EMERGING-E E variant.

In practice, MARIO accepts these local naming conventions: global_mrio_<year>.mat for v1.0 bundles, EMERGING_V2_<year>_m.mat for v2.x bundles, EMERGING_V2_<year>.mat for older local v2.x copies when they expose the same internal MATLAB structure, and EMERGING_E_<year>.mat for the EMERGING-E power-disaggregated variant.

For local v2.x files, the parser does not try to infer the exact sub-version 2.0 versus 2.1 versus 2.2 from the filename alone, because the public naming convention is shared across those releases.

The associated paper is:

Huo, J., Chen, P., Hubacek, K., Zheng, H., Meng, J., & Guan, D. (2022). Full-scale, near real-time multi-regional input-output table for the global emerging economies (EMERGING). Journal of Industrial Ecology, 26, 1218-1232. https://doi.org/10.1111/jiec.13264

MARIO currently supports only the multiregional IOT bundle, not any future alternative table layouts.

variant='E' selects the local EMERGING-E bundle. That variant currently parses the economic blocks directly from EMERGING_E_<year>.mat. MARIO first tries to auto-detect a compatible sibling .xlsx workbook with one Sector/Label/Name column exposing the full EMERGING-E sector list; use labels_path= to override that detection explicitly. If no compatible workbook is found, MARIO falls back to generic sector labels.

Parameters:

  • path (str) – path to one local EMERGING main .mat file or to a directory containing one or more EMERGING yearly bundles.

  • table (str, optional) – EMERGING parsing currently supports only IOT tables.

  • year (int, optional) – reference year to select when path points to a directory that contains more than one EMERGING main MATLAB file.

  • regions (sequence[str] or str, optional) – optional ISO3 subset. When omitted, parse all regions in the bundle. This is useful because the full EMERGING matrix is very large.

  • load_co2 (bool, optional) – when True, auto-detect and parse the companion EMERGING_CO2_<year>.mat or EMERGING_CO2_<year>_IEA.mat file if it is present next to the main bundle. When False, keep satellite accounts as placeholders.

  • co2_path (str, optional) – explicit path to the companion CO2 MATLAB file. When provided it overrides sibling auto-detection.

  • labels_path (str, optional) – explicit path to one Excel workbook containing sector labels. For variant="E" this overrides the automatic search among sibling .xlsx workbooks next to the main MATLAB file.

  • variant (str, optional) – parser variant. Use "standard" for the original EMERGING bundles and "E" for the EMERGING-E power-disaggregated local bundle.

  • model (str, optional) – public MARIO model class to instantiate. Database is the default and the only supported value.

  • name (str, optional) – optional dataset name stored in metadata.

  • calc_all (bool, optional) – whether to materialize derived blocks immediately after parsing.

On this page