Skip to content

Latest commit

 

History

History
114 lines (77 loc) · 3.66 KB

README.rst

File metadata and controls

114 lines (77 loc) · 3.66 KB
Raw

AI4EBV: Artificial Intelligence for Essential Biodiversity Variables

This is the code repository for the AI4EBV project. The repository hosts the ai4ebv Python package, which relies on the pysegcnn package.

Installation

Requirements

ai4ebv requires Python>=3.7. The list of dependencies, in addition to PyTorch is defined in environment.yml and requirements.txt.

Download

You can download ai4ebv from this repository's website or alternatively use git from terminal:

git clone https://gitlab.inf.unibz.it/REMSEN/ai4ebv.git

This creates a copy of the repository in your current directory on the file system.

Conda package manager

To install ai4ebv, we recommend to use the conda package manager. You can download conda here. Once successfully installed conda, we recommend to add conda-forge as your default channel:

conda config --add channels conda-forge

Conda environment

To install ai4ebv, we recommend to create a specific conda environment, by using the provided environment.yml file. In a terminal, navigate to the cloned git repositories root directory and type:

conda env create -f environment.yml

This may take a while. The above command creates a conda environment with all required dependencies except the PyTorch package. The first line in environment.yml defines the environment name, in this case ai4ebv. Activate your environment using:

conda activate ai4ebv

Alternatively, use the requirements.txt file to install the dependencies in an existing conda environment:

conda install --file requirements.txt

Install pysegcnn

To install the local pysegcnn package, follow the instructions here.

Install PyTorch

The installation of pytorch is heavily dependent on the hardware of your machine. Therefore, after activating your environment, install the version of PyTorch that your system supports by following the official instructions.

If you have to build pytorch from source, follow this guide.

To verify the installation, run some sample PyTorch code.

Install ai4ebv package

To finally install ai4ebv run the below command from this repositories root directory within the activated ``ai4ebv`` conda environment:

pip install -e .

If successful, you should be able to import ai4ebv from any Python interpreter using:

import ai4ebv

Contact

For further information or ideas for future development please contact: [email protected].

License

If not explicitly stated otherwise, this repository is licensed under the GNU GENERAL PUBLIC LICENSE v3.0 (see LICENSE).