Pyinaturalist extensions to convert iNaturalist observation data to and from multiple formats
Project description
pyinaturalist-convert
This is an incomplete work in progress!
Pyinaturalist extensions to convert iNaturalist observation data to and from multiple formats.
Formats
Import formats currently supported:
- CSV (Currently from API results only, but see planned features below)
- JSON (either from a
requests.Response
orpyinaturalist
results) - parquet
Export formats currently supported:
- CSV
- Excel (xlsx)
- GPX (experimental)
- parquet
- pandas DataFrame
Installation
Note: PyPI release coming soon.
pip install git+https://github.com/JWCook/pyinaturalist-convert.git
To keep things modular, many format-specific dependencies are not installed by default, so you may need to install some more packages depending on which formats you want. See pyproject.toml for the full list (TODO: docs on optional dependencies).
To install all of the things:
pip install git+https://github.com/JWCook/pyinaturalist-convert.git#egg=pyinaturalist-convert[all]
Usage
Basic usage example:
from pyinaturalist import get_observations
from pyinaturalist_convert import to_csv
observations = get_observations(user_id='my_username')
to_csv(observations, 'my_observations.csv')
Planned/possible features
- Convert to an HTML report
- Convert to Simple Darwin Core format
- Export to any SQLAlchemy-compatible database engine
- Import and convert observation data from the iNaturalist export tool and convert it to be compatible with observation data from the iNaturalist API
- Import and convert metadata and images from iNaturalist open data on Amazon
- See also pyinaturalist-open-data, which may eventually be merged with this package
- Import and convert observation data from the iNaturalist GBIF Archive
- Import and convert observation data from theiNaturalist Taxonomy Archive
- Note: see API Recommended Practices for details on which data sources are best suited to different use cases
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyinaturalist-convert-0.0.1.tar.gz
(183.8 kB
view hashes)
Built Distribution
Close
Hashes for pyinaturalist-convert-0.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a58feea063548ab44b7cd713502d7912472b6c56439dbfed6a0fe4c181265ff2 |
|
MD5 | 87a5c04735b8c1c3c16ace8927ec1ead |
|
BLAKE2b-256 | 761acee35842ad6048e399299d20a3eb32d8c02218b53befb1b5315a41aaeb6b |
Close
Hashes for pyinaturalist_convert-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 07b2b99e29345c8066576ae8f65ff70b69c0cf91d027571abe16f2ef45d53811 |
|
MD5 | bcd1ab8c940acdc57f86d93fdb5ab8c9 |
|
BLAKE2b-256 | bc3a2a55e3aee5a15f867ca91af39e92a5e93e495aef983d122f91806e5a3757 |