Statistical Data and Metadata eXchange (SDMX) for the Python data ecosystem¶
pandaSDMX
is an Apache 2.0-licensed Python library that implements SDMX 2.1
(ISO 17369:2013), a format for
exchange of statistical data and metadata used by national statistical
agencies, central banks, and international organisations.
pandaSDMX
can be used to:
explore the data available from data providers such as the World Bank, International Monetary Fund, Eurostat, OECD, and United Nations;
parse data and metadata in SDMX-ML (XML) or SDMX-JSON formats—either:
from local files, or
retrieved from SDMX web services, with query validation and caching;
convert data and metadata into pandas objects, for use with the analysis, plotting, and other tools in the Python data science ecosystem;
apply the SDMX Information Model to your own data;
…and much more.
Get started¶
SDMX was designed to be flexible enough to accommodate almost any data. This also means it is complex, with many abstract concepts for describing data, metadata, and their relationships. These are called the “SDMX Information Model” (IM).
This documentation does not repeat full descriptions of SDMX, the IM, or SDMX web services; it focuses on functionality provided by pandaSDMX
itself.
Detailed knowledge of the IM is not needed to use pandaSDMX
; see a
usage example in only 10 lines of code, and then the longer, narrative walkthrough.
To learn about SDMX in more detail, use the list of resources and references, or read the API documentation and implementation notes for the pandasdmx.model
and pandasdmx.message
modules that implement the IM.
pandaSDMX
user guide¶
- Data sources
- Data source limitations
ABS
: Australian Bureau of StatisticsESTAT
: EurostatECB
: European Central BankILO
: International Labour OrganizationIMF
: International Monetary Fund’s “SDMX Central” sourceINEGI
: National Institute of Statistics and Geography (Mexico)INSEE
: National Institute of Statistics and Economic Studies (France)ISTAT
: National Institute of Statistics (Italy)NB
: Norges Bank (Norway)OECD
: Organisation for Economic Cooperation and DevelopmentSGR
: SDMX Global RegistryUNSD
: United Nations Statistics DivisionUNESCO
: UN Educational, Scientific and Cultural OrganizationWB
: World Bank Group’s “World Integrated Trade Solution”
- API reference
- Implementation notes
- How to…
- What’s new?
- Development roadmap