From 88a72d0c8ec205726ec1765f26722a72c3aebabb Mon Sep 17 00:00:00 2001 From: Jacob Cain Date: Tue, 4 Mar 2025 15:11:45 -0800 Subject: [PATCH 1/2] setting PATH in env vars section --- .../installing-isis-via-anaconda.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md b/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md index 08af1ec0..38d5675b 100644 --- a/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md +++ b/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md @@ -113,6 +113,10 @@ ISIS requires these environment variables to be set in order to run correctly: - `ISISROOT` - Directory path containing your ISIS install - `ISISDATA` - Directory path containing the [ISIS Data Area](../../how-to-guides/environment-setup-and-maintenance/isis-data-area.md) +We also recommend setting: + +- `PATH` - Where your computer looks for runnable apps, including ISIS apps. + ???+ example "Setting Environmental Variables" The **Conda Env** method is recommended, and the **Python Script** automates that method: @@ -139,9 +143,9 @@ ISIS requires these environment variables to be set in order to run correctly: # conda config vars set KEY=VALUE ``` - 1. This command sets both required variables (fill in your `ISISDATA` path): + 1. This command sets both required variables and the PATH (fill in your `ISISDATA` location): - conda env config vars set ISISROOT=$CONDA_PREFIX ISISDATA=[your data path] + conda env config vars set ISISROOT=$CONDA_PREFIX ISISDATA=[your data path] PATH=$CONDA_PREFIX/bin:$PATH 1. Re-activate your isis environment. ```sh @@ -154,6 +158,10 @@ ISIS requires these environment variables to be set in order to run correctly: === "Python Script" + You should have your conda environment active before running this script: + + conda activate isis + By default, running this script will set `ISISROOT=$CONDA_PREFIX` and `ISISDATA=$CONDA_PREFIX/data`: python $CONDA_PREFIX/scripts/isisVarInit.py @@ -162,6 +170,10 @@ ISIS requires these environment variables to be set in order to run correctly: python $CONDA_PREFIX/scripts/isisVarInit.py --data-dir=[path to data directory] + Optionally, set the path variable: + + conda env config vars set PATH=$CONDA_PREFIX/bin:$PATH + Now every time the isis environment is activated, `$ISISROOT` and `$ISISDATA` will be set to the values passed to isisVarInit.py. This does not happen retroactively, so re-activate the isis environment: @@ -176,6 +188,7 @@ ISIS requires these environment variables to be set in order to run correctly: ```sh export ISISROOT=[path to ISIS] export ISISDATA=[path to data] + export PATH=[path to ISIS]/bin:$PATH ``` From 44291851d8ba35fa4ef1710a9ab1a52b4e7c0983 Mon Sep 17 00:00:00 2001 From: Jacob Cain Date: Wed, 5 Mar 2025 14:45:46 -0800 Subject: [PATCH 2/2] add ISIS bin to end of path rather than beginning --- .../installing-isis-via-anaconda.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md b/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md index 38d5675b..a2ebbc67 100644 --- a/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md +++ b/docs/how-to-guides/environment-setup-and-maintenance/installing-isis-via-anaconda.md @@ -145,7 +145,7 @@ We also recommend setting: 1. This command sets both required variables and the PATH (fill in your `ISISDATA` location): - conda env config vars set ISISROOT=$CONDA_PREFIX ISISDATA=[your data path] PATH=$CONDA_PREFIX/bin:$PATH + conda env config vars set ISISROOT=$CONDA_PREFIX ISISDATA=[your data path] PATH=$PATH:$CONDA_PREFIX/bin 1. Re-activate your isis environment. ```sh @@ -172,7 +172,7 @@ We also recommend setting: Optionally, set the path variable: - conda env config vars set PATH=$CONDA_PREFIX/bin:$PATH + conda env config vars set PATH=$PATH:$CONDA_PREFIX/bin Now every time the isis environment is activated, `$ISISROOT` and `$ISISDATA` will be set to the values passed to isisVarInit.py. This does not happen retroactively, so re-activate the isis environment: @@ -188,7 +188,7 @@ We also recommend setting: ```sh export ISISROOT=[path to ISIS] export ISISDATA=[path to data] - export PATH=[path to ISIS]/bin:$PATH + export PATH=$PATH:[path to ISIS]/bin ```