Repository files navigation

PyAGNPS is a series of scripts and notebooks that helps in the creation of input files for TopAGNPS and AnnAGNPS

This README outlines the steps to install thepyagnps package along with its GDAL dependencies.

If you don't intend to use thetopagnps andsubannagnps submodules, then GDAL is not necessary and you can ignore the rest of this installation tutorial. Just run:

pip install git+https://github.com/LucRSquared/pyagnps.git

And you're good to go! Otherwise, see below

if you can execute without errors the following line of code within your environment then go to step 4

python -c"from osgeo import gdal"

If you're using Linux/macOS, you need to install the system GDAL libraries before installing the GDAL Python bindings

The installation method for GDAL varies depending on your operating system and package manager. Here are some examples:

Ubuntu/Debian:

    sudo apt update# Update package lists    sudo apt install -y libgdal-dev python3-gdal# Install GDAL libraries

Fedora/CentOS:

    sudo dnf update# Update package lists    sudo dnf install -y gdal python3-gdal

Homebrew (macOS):

    brew update    brew install gdal

Theinstall_gdal.py will attempt to find a suitable wheel to install in your python environment. You can skip executing this script if you already have a prefered way to install gdal in your python environment.

• For Linux/macOS this will install the python bindings for GDAL

• For Windows this will download and install a GDAL wheel fromChristoph Gohlke's website. If it doesn't work then God be with you, you're on your own, use your favorite search engine to figure out how to install GDAL refer to the TL;DR, that's what you want to achieve.

• Run the following command to download and execute theinstall_gdal.py script:

   curl -fsSL https://raw.githubusercontent.com/LucRSquared/pyagnps/master/install_gdal.py| python3 -

This command downloads the script from thepyagnps GitHub repository and pipes it to the Python interpreter for execution.

Now you're ready to installpyagnps ! Just run:

pip install git+https://github.com/LucRSquared/pyagnps.git

If the following command does not return any error then the installation is a success!

python -c"import pyagnps"

Ensure you have activated your virtual environment (if you're using one) before running these commands.