Package to download and interact with the CITES Trade Database in Python
Project description
pycites
pycites is a package to download and interact with the CITES Trade Database using Python. citesdb exists for R users to load and analzyes this data, so we wanted a way to do the same!
Currently very much a work in progress. Currently only downloads and loads data.
Installation
pip install pycites
Usage instructions
To download the CITES Trade Database and load into a dataframe, run the following in a Jupyter notebook or Python shell:
import pycites
pycites.get_data()
df = pycites.load_data()
This will download and extract the zip file from the CITES website, do some basic data validation (e.g. drop rows with missing or incorrect Years), and combine the data into a single compressed CSV file. This uses a decent amount of memory, so may cause issues on a machines with low resource.
Roadmap
- Release a CSV to make it easier for users to download and load data
- Experiement with other data formats for better memory usage of data (currently pretty high)
- Add a CLI for downloading data
- Include metadata and other useful information, like
citesdb - Add additional functionality for analysis (time series and network analyses), and integrate with other data sources (such as World Bank)
- Setup CI and testing
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
