Skip to content

Installation Guide

Python 3.12 Tests

PG-RAD is a Python 3.12 package and is only tested on x86_64 Linux systems. The following installation instructions were testing for a fresh virtual machine running Ubuntu 26.04 LTS.

  1. Install git by sudo apt update && sudo apt install git
  2. Install miniforge by following these instructions.

  3. Create a file called environment.yml, and paste the following in there:

    name: my-pgrad-env
channels:
  - conda-forge
dependencies:
  - python=3.12
  - pip:
    - git+ssh://git@github.com/pim-n/pg-rad.git@v0.1.1
    You can replace the name of the environment if desired.

  4. Run conda env create -f environment.yml to create the environment

  5. Run conda activate my-pgrad-env. You should now be in the conda environment my-pgrad-env.
  6. To test if installation was succesful, run pgrad --example --show. If this runs without errors and produces visual output, PG-RAD is correctly installed.

Manual installation

If you prefer another virtual environment, you still need git installed. Ensure the Python version of the environment is >3.12.4 and <3.13. Then, with your virtual environment activated, run pip install git+ssh://git@github.com/pim-n/pg-rad.git@main. Run pgrad --example --show to check if the installation was successful.

Usage

For usage, see the Quickstart Guide.