Satellite Hydrology Bits Analysis And Mapping (SHBAAM) is a Python and bash shell toolbox that combines many repetitive pre and post-processing tasks that are common to studying the studying the terrestrial water cycle with satellite data.
Such tasks include the preparation of files corresponding to:
- Terrestrial Water Storage Anomaly using GRACE data
This document was written and tested on a machine with a clean image of Ubuntu 14.04.0 Desktop 64-bit installed, i.e. no update was performed, and no upgrade either.
Note that the experienced users may find more up-to-date installation instructions in .travis.yml.
First, make sure that git is installed:
$ sudo apt-get install -y git
Then download SHBAAM:
$ git clone https://github.com/c-h-david/shbaam
Finally, enter the SHBAAM directory:
$ cd shbaam/
Software packages for the Advanced Packaging Tool (APT) are summarized in
requirements.apt
and can be installed with apt-get. All packages can be installed at once using:
$ sudo apt-get install -y $(grep -v -E '(^#|^$)' requirements.apt)
Alternatively, one may install the APT packages listed in requirements.apt one by one, for example:
$ sudo apt-get install -y python-pip
Python packages from the Python Package Index (PyPI) are summarized in
requirements.pip
and can be installed with pip. All packages can be installed at once using:
$ sudo pip install -r requirements.pip
Alternatively, one may install the PyPI packages listed in requirements.pip one by one, for example:
$ sudo pip install numpy==1.7.0
Testing scripts are currently under development.
Note that the experienced users may find more up-to-date testing instructions in .travis.yml.
This document was written and tested on a machine with a clean image of Windows 10, 64-bit, installed. The following instructions were prepared for Windows PowerShell which shall be run in administrator mode.
Note that the experienced users may find more up-to-date installation instructions in .appveyor.yml.
First, make sure that choco is installed:
PS C:\> Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
Second, make sure that git is installed:
PS C:\> choco install git
Then download SHBAAM:
PS C:\> git clone https://github.com/c-h-david/shbaam
Finally, enter the SHBAAM directory:
PS C:\> cd shbaam\
Software packages for Chocolatey are summarized in
requirements.cho
and can be installed with choco. All packages can be installed at once using:
PS C:\> choco install --no-progress ((gc requirements.cho) -notmatch '^#' -match '\S')
Alternatively, one may install the Chocolatey packages listed in requirements.cho one by one, for example:
PS C:\> choco install minicondaNote that by default,
wgetin is aliased to the PowerShellInvoke-WebRequest, and one may to remove this alias before installingwget:PS C:\> rm Alias:wget
The Chocolatey installation of conda does not update the environment
variables, so the following action must be taken:
PS C:\> $ENV:PATH="C:\\ProgramData\\MiniConda2;C:\\ProgramData\\MiniConda2\\Scripts;$ENV:PATH"
The Chocolatey installation of git does not update the environment
variables to give access to bash and sh, so the following action must be
taken:
C:\> $ENV:PATH="C:\\Program Files\\Git\\bin;$ENV:PATH"
Python packages from the Anaconda Package Repository are summarized in
requirements.cnd
and can be installed with conda. All packages can be installed at once using:
PS C:\> conda install -y -q -c anaconda --file requirements.cnd
Alternatively, one may install the Anaconda packages listed in requirements.cnd one by one, for example:
PS C:\> conda install -y -q -c anaconda numpy
Testing scripts are currently under development.
Note that the experienced users may find more up-to-date testing instructions in .appveyor.yml.