Installation

Users will need to complete three things to finish the installation.

  1. Install a licensed RiverWare. Detailed instrustions of RiverWare can be found here.

  2. Install Py-RAMID package.

  3. Setup Windows environment.

Install Py-RAMID

To install Py-RAMID, users need to first clone or download the package from the Py-RAMID GitHub respository. Then, unzip the downloaded file and move to the directory containing setup.py in the terminal or the conda prompt. Next, you can install the package by the following command.

pip install .

Windows environment setup

As Py-RAMID will exercute .py file through terminal commands, users need to make sure the .py file can be executed through CMD with correct environment (e.g., the virtual environment that has Py-RAMID installed). In other words, we want CMD to execute .py files with assign environment path, which contains Py-RAMID package.

To setup the environment path, please follow the steps below.

  1. Open anaconda prompt or CMD.

  2. Enter “where python”. Then, a list of corresponding python.exe path will appear.

_images/EP1.png
  1. Copy the one that is in your working environment (e.g., the virtual environment that has Py-RAMID installed). In our example, our working environment is at C:/Users/ResearchPC/anaconda3/envs/PyRAMID. Note that only copy the path without /python.exe

  2. Open windows search and search Edit the System Environment Variables.

_images/EP2.png
  1. Click on Environment Variables. Then, double click on the Path in the System variables box.

_images/EP3.png
  1. Add the copied python path into popped out window, Edit enviroment variable.

_images/EP4.png
  1. Done!