Software Requirement
If you encounter a problem, please look for a online solution. The installation and configuration described below is mostly performed using a bash shell on macOS. Windows users will need to install and configure a bash shell in order to follow the usage shown below. Try to use Windows Subsystem for Linux for this purpose.
macOS/Linux
Installing software for macOS/Linux
If you are new to using Bash refer to the following lessons with Software Carpentry: http://swcarpentry.github.io/shell-novice/
Homebrew and other package
-
If you don't have Homebrew, you can install it by pasting below code in your macOS/Linux terminal.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
Install
wget
(for downloading data). Use Hombrew to install it by pasting below code in your macOS terminal.brew install wget
Panoply
- Download and install Panoply Data Viewer from NASA GISS on your machine for macOS or Linux.
Anaconda
- Download and install Anaconda Python on your machine for macOS or Linux.
Windows
Enable the Windows Subsytem for Linux
If you are using Windows machine, it's recomended to follow below step. You will experience an error during SPEI calculation cause by NCO
if you use standard Windows 10 and not using Windows Subsytem for Linux.
Guideline below are specific for Windows 10. If you are using Windows Server 2019, please follow Windows Server Installation Guide
Reference: https://docs.microsoft.com/en-us/windows/wsl/install-win10
You must first enable the "Windows Subsystem for Linux - WSL" optional feature before installing any Linux distributions on Windows.
Installing software for Windows
If you have a Bash shell already installed on your Windows OS (e.g. Ubuntu Bash) you can use that for the exercise, but it must be a Bash shell
If you are new to using Bash refer to the following lessons with Software Carpentry: http://swcarpentry.github.io/shell-novice/
Homebrew and other package
-
If you don't have Homebrew, you can install it by pasting below code in your WSL Ubuntu terminal.
bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
-
Install
wget
(for downloading data). Use Hombrew to install it by pasting below code in your WSL Ubuntu terminal.brew install wget
Panoply
- Download and install Panoply Data Viewer from NASA GISS on your machine: Windows.
Anaconda
-
Download and install Anaconda Python on your WSL Ubuntu Linux: Ubuntu Linux on WSL.
climate-indices
python package used for SPEI calculation is rely on netCDF Operator (NCO) and pyNCO wrapper sometimes produce an error in Windows. That's the reason why we will use Anaconda for Linux if you are using Windows machine. -
Go to https://repo.anaconda.com/archive/ to find the list of Anaconda releases
-
Select the release you want. I have a 64-bit computer, so I chose the latest release ending in
x86_64.sh
. If I had a 32-bit computer, I'd select thex86.sh
version. If you accidentally try to install the wrong one, you'll get a warning in the terminal. I choseAnaconda3-2020.11-Linux-x86_64.sh
. -
From the terminal run
wget https://repo.anaconda.com/archive/[YOUR VERSION]
. Example:wget https://repo.anaconda.com/archive/Anaconda3-2020.11-Linux-x86_64.sh
-
After download process completed, Run the installation script:
bash Anaconda[YOUR VERSION].sh
bash Anaconda3-2020.11-Linux-x86_64.sh
-
Read the license agreement and follow the prompts to press Return/Enter to accept. Later will follow with question on accept the license terms, type
yes
and Enter. When asks you if you'd like the installer to prepend it to the path, press Return/Enter to confirm the location. Last question will be about initialize Anaconda3, typeyes
then Enter. -
Close the terminal and reopen it to reload .bash configs. It will automatically activate
base
environment. -
Deactivate
base
environment then set tofalse
the confirguration of auto activate thebase
environment by typingconda deactivate && conda config --set auto_activate_base false
-
To test that it worked,
which python
in your Terminal. It should print a path that has anaconda in it. Mine is/home/gost/anaconda3/bin/python
. If it doesn't have anaconda in the path, do the next step. -
Manually add the Anaconda bin folder to your PATH. To do this, I added
"export PATH=/home/gost/anaconda3/bin:$PATH"
to the bottom of my~/.bashrc
file. -
Optionally install Visual Studio Code when prompted
ArcGIS
- Some analysis also required
arcpy
python package, so you also required to install ArcGIS Desktop or Pro. Follow this giudeline for the Desktop https://desktop.arcgis.com/en/arcmap/latest/get-started/installation-guide/introduction.htm# and Pro https://pro.arcgis.com/en/pro-app/latest/get-started/install-and-sign-in-to-arcgis-pro.htm