mario.parse_eurostat#

mario.parse_eurostat(country: str, year: int, table: str = 'SUT', iot_mode: str = 'product', unit: str = 'MIO_EUR', path: str | None = None, download: bool = False, overwrite_download: bool = False, model: str = 'Database', name: str = None, calc_all: bool = False, timeout: int = 60, **kwargs) → object#

Parse Eurostat national tables directly from the official SDMX API.

This parser targets the official national Eurostat supply-use and input-output datasets exposed through the SDMX API, not arbitrary local spreadsheets.

Eurostat availability is year- and country-dependent. In general:

  • SUT tables are annual and published from reference year 2010 onward;

  • IOT tables are published from reference year 2010 onward, but mandatory transmission is only five-yearly for years ending with 0 or 5;

  • additional IOT years depend on voluntary country transmission.

Parameters:

  • country (str) – Eurostat geo code, for example IT or DE.

  • year (int) – reference year to download.

  • table (str, optional) – target table family, either SUT or IOT.

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

  • unit (str, optional) – Eurostat SDMX unit code. Supported values are MIO_EUR and MIO_NAC.

  • path (str, optional) – optional directory for locally stored raw Eurostat CSV slices.

  • download (bool, optional) – when True, download the raw CSV slice into path and then parse it locally.

  • overwrite_download (bool, optional) – when download=True, overwrite already downloaded raw files.

  • model (str, optional) – currently only Database is supported.

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

  • calc_all (bool, optional) – if True, calculate missing derived matrices after parsing.

  • timeout (int, optional) – request timeout in seconds used for each SDMX call.

References

Eurostat metadata and dataset context: https://ec.europa.eu/eurostat/cache/metadata/en/naio_10_n_esms.htm

Eurostat API guide: https://ec.europa.eu/eurostat/web/user-guides/data-browser/api-data-access/api-introduction

On this page