Package: oda-data
The ODA Data PackageThis package contains key tools used by The ONE Campaign to analyse Official Development Assistance (ODA) data from
the OECDDACdatabases.Interacting with the DAC databases can be a complex task. There are many databases, tables, and web interfaces which
can be used to get the data you need. This means that getting the right ODA data can require expert knowledge not only
of ODA, but also of how the DAC databases and tools are organised.This package aims to simplify this process and make it easier for users to get the data they need.Please submit questions, feedback or requests via
theissues page.Getting startedInstallationThe package can be installed using pip:pipinstalloda-data--upgradeThe package is compatible with Python 3.10 and above.Basic usageMost users can get the data they need by using theODADataclass.An object of this class can handle:getting data for specific indicators (one or more)filtering the data for specific donors, recipients(if relevant), years.returning the data in a variety of currency/prices combinations.For example, to get Total ODA in net flows and grant equivalents, in constant 2021 Euros, for 2018-2021.fromoda_dataimportODAData,set_data_path# set the path to the folder where the data should be storedset_data_path("path/to/data/folder")# create object, specifying key details of the desired outputdata=ODAData(years=range(2018,2022),currency="EUR",prices="constant",base_year=2021)# load the desired indicatorsdata.load_indicator(indicators=["total_oda_flow_net","total_oda_ge"])# get the datadf=data.get_data()print(df.head(6))This would result in the following dataframe:donor_codedonor_nameyearvalueindicatorcurrencyprices1Austria20211261.76total_oda_flow_netEURconstant1Austria20211240.31total_oda_geEURconstant2Belgium20212176.38total_oda_flow_netEURconstant2Belgium20212174.38total_oda_geEURconstant3Denmark20212424.51total_oda_flow_netEURconstant3Denmark20212430.65total_oda_geEURconstantTo print the full list of available indicators, you can call.get_available_indicators().For full details on the available indicators and how we calculate them,
see the indicators [documentation](oda_data/settings/Available indicators.md)TutorialsFor more detailed examples of how to use the package, see thetutorials.Atutorial notebookon loading the package and getting total oda dataAtutorial notebookon getting ODA by donor and recipient
(including both bilateral and imputed multilateral data)Atutorial notebookon getting ODA by sectors
(including both bilateral and imputed multilateral data)Please reach out if you have questions or need help with using the package for your analysis.Key featuresSpeed up analysis- The package handles downloading, cleaning and loading all the data, so you can focus on the
analysis. The data is downloaded from the bulk download service of the OECD, and once it is stored locally, producing
the output is extremely fast.Access all of our analysis- Besides the classic OECD DAC indicators, the package also provides access to the
data and analysis produced by ONE. This includes gender or climate data in gross disbursement terms (instead of
commitments) and our multilateral sectors imputations.Get data in the currency and prices you need- ODA data is only available in US dollars (current or constant
prices) and local currency units (current prices). The package allows you to view the data in US dollars, Euros,
British Pounds and Canadian dollars, in both current and constant prices. We can add any other DAC currency if you
request it via theissues pageContributingInterested in contributing to the package? Please reach out.