eBird Dataset Data
eBird Dataset Data is a reusable Django app for loading data from the eBird Basic Dataset, v1.14, into a database.
Overview
The Cornell Laboratory of Ornithology in Ithaca, New York runs the eBird database which collects observations of birds from all over the world, and publishes them on (eBird.org)[https://ebird.org]. The data is also available via the eBird Basic Dataset which is intended for for analysis and modelling. This project contains a loader and models to take data from a download (CSV) file and load it into a database. From there you can analyse the data with python, jupyter notebooks, or build a web site.
To get started, you will need to sign up for an eBird account, then request access, which usually takes 7 days to be reviewed and approved.
Install
You can use either pip or uv to download the package from PyPI and install it into a virtualenv:
pip install ebird-dataset-data
or:
uv add ebird-dataset-data
Update INSTALLED_APPS in your Django setting:
INSTALLED_APPS = [
...
ebird.dataset.data
]
Finally, run the migrations to create the tables:
python manage.py migrate
Demo
If you check out the code from the repository there is a fully functioning Django site. It contains pages for checklists, observations and species, where you can browse the records or search by location, observer. date. etc. The Django Admin lets you browse and edit the records in the database.
git clone git@github.com:StuartMacKay/ebird-dataset-data.git
cd ebird-api-data
Create the virtual environment:
uv venv
Activate it:
source .venv/bin/activate
Install the requirements:
uv sync
Run the database migrations:
python manage.py migrate
Create a user:
python manage.py createsuperuser
Run the demo:
python manage.py runserver
Now, either visit the site, http:localhost:8000/, or log into the Django Admin, http:localhost:8000/admin to browse the tables.
Project Information
- Documentation: https://ebird-dataset-data.readthedocs.io/en/latest/
- Issues: https://todo.sr.ht/~smackay/ebird-dataset-data
- Repository: https://git.sr.ht/~smackay/ebird-dataset-data
- Announcements: https://lists.sr.ht/~smackay/ebirders-announce
- Discussions: https://lists.sr.ht/~smackay/ebirders-discuss
- Development: https://lists.sr.ht/~smackay/ebirders-develop
The repository is also mirrored on Github:
The app is tested on Python 3.10+, and officially supports Django 4.2 LTS, 5.0, 5.1, and 5.2 LTS.
License
eBird Dataset Data is released under the terms of the MIT license.
Metadata
Release files for ebird-dataset-data 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ebird_dataset_data-0.2.0.tar.gz | 17.1 kB | Without provenance | Details for ebird_dataset_data-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ebird_dataset_data-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for ebird_dataset_data-0.2.0-py3-none-any.whl |
Total release size: 41.6 kB
Release files / ebird_dataset_data-0.2.0.tar.gz
| Download URL | ebird_dataset_data-0.2.0.tar.gz |
|---|---|
| Size | 17.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4e28af364925214ef554c9a9e1488135f69216123d348b1930e8b8624410b45c
|
|
BLAKE2b-256 checksum How to use checksums |
2880ba514b5b85df160a1c280323a832bcbe5f3c8a283448627376d160174ea2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.3
|
Release files / ebird_dataset_data-0.2.0-py3-none-any.whl
| Download URL | ebird_dataset_data-0.2.0-py3-none-any.whl |
|---|---|
| Size | 24.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
452f0cfb7fd9b3aa152fa20e9cb64422a6fe5b18713d42af2d04e7abb5a12e3c
|
|
BLAKE2b-256 checksum How to use checksums |
3b915e78c62e96bd28c1af4a5374eebd18b2b26d8a442fba2ebc355b14f4e33d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.3
|
Security for ebird-dataset-data 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.