Skip to content

A Python package to complement and verify biological records

License

Notifications You must be signed in to change notification settings

PEM-Humboldt/regi0

Repository files navigation

Regi0

Regi0 is a Python package with useful functions to complement and verify biological records. These functions are divided into two main modules (geographic and taxonomic) and rely on both user data and several web APIs (e.g. GNR, IUCN and Species+).

Installation

Regi0 works with Python versions 3.7 through 3.9.

Using pip:

pip install regi0

Using conda:

conda install -c conda-forge

Execution

To check whether the installation of wiutils was successful, execute the following command:

python -c "import regi0"

If this does not throw any error, the installation was successful.

You can use any regi0 function by importing the package from a Python console or script. You can also execute flexible and predefined geographic and taxonomic verification workflows using regi0's command line interface (CLI). For more information about the available functions and the CLI, check the documentation.

How to contribute

It is recommended to install the package using a virtual environment to avoid tampering other Python installations in your system.

  1. Clone this repo in your computer:
git clone https://github.com/PEM-Humboldt/regi0.git
  1. Go to the project's root:
cd regi0
  1. Install the package in development mode:
pip install --editable .[dev,docs,test]

Considering regi0 has dependencies such as fiona and rasterio, which may require additional installation steps to the ones described above (see 1 and 2), it is also recommended using a conda virtual environment to install it and avoid having to manually install other dependencies.

  1. Go to the project's root and create the conda virtual environment:
conda env create -f environment.yml
  1. Activate the conda virtual environment:
conda activate regi0-dev
  1. Install the package in development mode:
pip install --editable .[dev,docs,test]

Unit tests

Go to the project's root and execute:

pytest tests/

Authors and contributors

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.