pyinaturalist-convert

Work in progress!

This package provides tools to convert iNaturalist observation data to and from multiple formats. This is mainly intended for use with data from the iNaturalist API (via pyinaturalist), but also works with other iNaturalist data sources.

Formats

Import formats currently supported:

• CSV (From either API results or the iNaturalist export tool)
• JSON (from API results, either via pyinaturalist, requests, or another HTTP client)
• pyinaturalist.Observation objects
• Parquet

Export formats currently supported:

• CSV, Excel, and anything else supported by tablib
• Feather, Parquet, and anything else supported by pandas
• GeoJSON and GPX

Installation

Install with pip:

pip install pyinaturalist-convert

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 pyinaturalist-convert[all]

Usage

Get your own observations and save to CSV:

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 and Possible Features

• Convert to an HTML report
• Convert to print-friendly format
• Convert to Simple Darwin Core
• Export to any SQLAlchemy-compatible database engine
• 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 taxonomy data from the iNaturalist Taxonomy Archive
• Note: see API Recommended Practices for details on which data sources are best suited to different use cases