Installing Rogue With Miniforge

The following instructions describe how to install a pre-built Rogue package inside an miniforge environment. These instructions are relevant for Linux, Ubuntu on Windows and MacOS.

See the section Setting Up Ubuntu On Windows for additional steps required for Windows.

Getting Miniforge

Download and install miniforge if you don’t already have it installed on your machine. Choose an install location with a lot of available diskspace (> 5GB). Miniforge appears to only work reliably in the bash shell.

$ wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh
$ bash Miniforge3-Linux-x86_64.sh

Use the following command to add miniforge to your environment. This can be added to your .bash_profile.

$ source /path/to/my/miniforge3/etc/profile.d/conda.sh

It is important to use the latest conda solver:

$ conda activate
$ conda config --set channel_priority strict
$ conda install -n base conda-libmamba-solver
$ conda config --set solver libmamba

Creating A Rogue Environment

The next step is to create an miniforge environment which includes the Rogue package.

$ conda create -n rogue_tag -c tidair-tag -c conda-forge rogue

The order of the args is important. tidair-tag is the channel from which the Rogue package is downloaded.

If you already have an miniforge environment that you would like to install Rogue into:

$ conda install -c tidair-tag -c conda-forge rogue

Alternatively you can install a specific released version of Rogue:

$ conda create -n rogue_v6.5.0 -c conda-forge -c tidair-tag rogue=v6.5.0

Using Rogue In Miniforge

No additional setup scripts need to be run Rogue in an miniforge environment. To activate and de-activate the Rogue environment you can use the following commands:

To activate:

$ conda activate rogue_tag

Replace rogue_tag with the name you used when creating your environment (e.g. rogue_v6.5.0).

To deactivate:

$ conda deactivate

Installing Rogue In Existing Environment

The following command is used to install Rogue inside and existing miniforge environment.

Updating Rogue In Miniforge

If you want to update Rogue, run the following command after activating the Rogue environment

$ conda update rogue -c tidair-tag

Deleting Miniforge Environment

Run the following commands to delete the miniforge environment.

$ conda env remove -n rogue_tag