mario.parse_istat#

mario.parse_istat(path: str, *, year: int, table: str = 'IOT', iot_mode: str = 'product', level: str = '63', price: str = 'current', valuation: str = 'basic', download: bool = False, overwrite_download: bool = False, edition: str = 'latest', page_url: str | None = None, model: str = 'Database', name: str | None = None, calc_all: bool = False, **kwargs) → object#

Parse official ISTAT input-output workbooks from local files or a downloaded release.

This parser targets the official ISTAT release bundles published on the public release pages for the Italian input-output system. The supported source format is the Excel content distributed inside the official release zip, not other ad hoc spreadsheets.

Parameters:

  • path (str) – local workbook, extracted release directory, or release zip. When download=True, this should be the destination directory where the official ISTAT release zip will be stored and extracted.

  • year (int) – reference year to select from the multi-year workbook.

  • table (str, optional) – one of "IOT" or "SUT".

  • iot_mode (str, optional) – ISTAT symmetric table layout when table='IOT'. Supported values are product for product-by-product and industry for branch-by-branch.

  • level (str, optional) – SUT aggregation level when table='SUT'. Supported values are "63" and "20".

  • price (str, optional) – SUT price system when table='SUT'. Supported values are current and pyp.

  • valuation (str, optional) – SUT use-table valuation when table='SUT'. Supported values are basic and purchaser.

  • download (bool, optional) – when True, download the official ISTAT release zip into path before parsing it locally.

  • overwrite_download (bool, optional) – when download=True, overwrite an existing local archive/extraction.

  • edition (str, optional) – known ISTAT release page label used by the downloader, for example "2020-2022" or "2015-2020". Ignored when download=False.

  • page_url (str, optional) – explicit ISTAT release page URL for the downloader. Ignored when download=False.

On this page