Python DWCA

PyDwCA (pronounced /pajˈðjuka/ or "pie thew ka") is a Python library to read, parse and write Darwin Core Archive files.

Install

Package available at pypi:

pip install pydwca

This command will install the library and the dependencies listed in the requirements. This will give you a basic usage.

If you want all the available features, install the optional dependencies:

pip install pydwca[full]
pip install pydwca[ui]
pip install pydwca[data]

full has all features, ui allows you to see the steps of the long process and data includes the libraries for data analysis.

Citation

You can cite this library by citing the abstract of the oral presentation in which was presented:

@article{10.3897/biss.8.137799,
	author = {Sáez-Hidalgo, Juan M. and Segovia, Ricardo A. and Squeo, Francisco A. and Guerrero, Pablo C.},
	title = {PyDwCA: A Tool for Integrating Biodiversity Data},
	volume = {8},
	number = {},
	year = {2024},
	doi = {10.3897/biss.8.137799},
	publisher = {Pensoft Publishers},
	issn = {},
	pages = {e137799},
	URL = {https://doi.org/10.3897/biss.8.137799},
	eprint = {https://doi.org/10.3897/biss.8.137799},
	journal = {Biodiversity Information Science and Standards}
}

Usage

To read a DwC Archive file in .zip format, use the class DarwinCoreArchive:

from dwca import DarwinCoreArchive

darwin_core = DarwinCoreArchive.from_archive("DwCArchive.zip")

A more extended example is in the library documentation at https://pydwca.readthedocs.io/en/latest/usage.html.

A more detailed example can be found on the pydwca-example repository. Those use cases correspond mainly to the data process pipeline presented at the 2024 SPNCH/TDWG conference.

Documentation

Documentation is available at readthedocs.io.

Discussion

You can leave a message about the usage of this library, its implementation, or any other in the issue section.