CSV#

pyinaturalist_convert.csv

Import CSV observation data from the iNaturalist bulk export tool.

Extra dependencies: pandas (for fast conversion into API-compatible results)

Example:

Load CSV file into a dataframe:

>>> from pyinaturalist_convert import load_csv_exports
>>> df = load_csv_exports('~/Downloads/my_observations.csv')

Note: This format can also be loaded by read():

Example:

Load CSV file into Observation objects:

>>> from pyinaturalist_convert import read
>>> observations = load_csv_exports('~/Downloads/my_observations.csv')

pyinaturalist_convert.csv.is_csv_export(file_path)#

Check if a file is a CSV export from the iNaturalist export tool (to distinguish from converted API results)

pyinaturalist_convert.csv.load_csv_exports(*file_paths)#

Read one or more CSV files from ithe Nat export tool into a dataframe

Parameters:: file_paths (Union[Path, str]) – One or more file paths or glob patterns to load
Return type:: DataFrame