RELAP-7 Local Installation

RELAP-7 is available via Conda, from our NCRC Channel. In order to install RELAP-7 on your machine, you will first need to install a Conda Package Manager.

Install Conda

Follow the steps below depending on your platform to install Mambaforge. If you run into issues during these steps, please visit our Conda Troubleshooting guide. This installation guide relies on the utilization of mamba, an optimized package manager for Conda.

  • Linux Users:

    
curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-Linux-x86_64.sh
bash Mambaforge-Linux-x86_64.sh -b -p ~/mambaforge3

  • Macintosh Users with Intel processors:

    
curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-MacOSX-x86_64.sh
bash Mambaforge-MacOSX-x86_64.sh -b -p ~/mambaforge3

  • Macintosh Users with Apple Silicon processors:

    
curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-MacOSX-arm64.sh
bash Mambaforge-MacOSX-arm64.sh -b -p ~/mambaforge3

With Mambaforge installed in your home directory, export PATH so that it may be used:


export PATH=$HOME/mambaforge3/bin:$PATH

Now that we can execute mamba, initialize it and then exit the terminal:


mamba init
exit

Upon restarting your terminal, you should see your prompt prefixed with (base). This indicates you are in the base environment, and Conda is ready for operation:


$ (base) ~>

Add INL's public channel to gain access to INL's Conda package library:


conda config --add channels https://conda.software.inl.gov/public
warningwarning:Do not use sudo

If you find yourself using sudo commands while engaging Conda commands... something is not right. The most common reason for needing sudo is due to an improper Conda installation. Conda should be installed to your home directory, without any use of sudo.

Install NCRC Client

The NCRC client is available via INL's public Conda channel repository.

commentnote

The ncrc client must be installed and used while in the (base) Conda environment. The only exception to this, is when one performs an update (described later).

Add INL Conda Repository channel:


conda config --add channels https://conda.software.inl.gov/public
conda install ncrc

Install RELAP-7

Using the ncrc client, install RELAP-7:


ncrc install relap7

Username: johndoe
PIN+TOKEN:

You will need to supply your INL HPC username, and your PIN+TOKEN to proceed.

Use RELAP-7

Once installation has finished (this can take a few minutes), you need to activate this environment:


mamba activate relap7
$ (relap7) ~>

With RELAP-7 activated (denoted by the prompt header), relap-7-opt becomes available within your PATH. This makes relap-7-opt available for execution from any directory.


relap-7-opt --help

<The RELAP-7 help page is displayed>

A good first usage, would be to run the built-in tests. You should run this command while somewhere in your home directory (somewhere where you and only you has write access):


cd ~/
relap-7-opt --copy-inputs tests

<Output of files being copied is displayed>

Directory successfully copied into ./relap-7/tests/

The very last line indicates the directory you need to enter next in order to run the tests. In our case ./relap-7/tests. Change into this directory, and then run the tests:


cd ./relap-7/tests
relap-7-opt --run -j 5

<Output of tests being run>

One or two failures may indicate those tests have their tolerances set too tight. You likely can ignore a few failures.