|
|
|
Glance requires a Unix-like system such as Linux or Mac OSX and python >=3.9 (preferably 3.11).
|
|
|
|
|
|
|
|
Setting up the Environment for Glance
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
Glance relies on python and several freely available libraries. There are multiple ways to get these prerequisites, but we recommend that you try the [MambaForge](https://github.com/conda-forge/miniforge#mambaforge) installation instructions first.
|
|
|
|
|
|
|
|
If you are working on an SSEC server there may already be a pre-built installation of Glance's prerequisites available. Check with TC for your specific server if you are unsure.
|
|
|
|
|
|
|
|
You will also need to install the appropriate python modules to load the sorts of files you want Glance to analyze. If you do not install the netcdf4 module for example, Glance will not be able to open NetCDF files for analysis.
|
|
|
|
|
|
|
|
Installing Glance Using MambaForge
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
You will need to have the python 3.10 version of MambaForge installed for these instructions. You can download a pre-built version of here (https://github.com/conda-forge/miniforge#mambaforge).
|
|
|
|
|
|
|
|
If you are working on the SSEC servers there may be a pre-installed version of MambaForge or MiniForge available. Check with TC if you aren't sure what's on the server you're using.
|
|
|
|
|
|
|
|
Once you have MambaForge installed, run the following commands on the command line:
|
|
|
|
|
|
|
|
mamba create -n glance_user python=3.11 numpy matplotlib mako mock scipy pillow cartopy pyqt netcdf4 h5py pip
|
|
|
|
mamba activate glance_user
|
|
|
|
pip install -v --extra-index-url https://larch.ssec.wisc.edu/eggs/repos uwglance
|
|
|
|
|
|
|
|
_Note that this example command includes several libraries for opening different file types, including netcdf4 and h5py. The netcdf4 library is also being used by Glance to open hdf4 files. Exactly which of these libraries you need to install depends on the files you wish to open with Glance._
|
|
|
|
|
|
|
|
This will create an environment called "glance" that can be used to run Glance at the command line. When you open a new terminal session with your computer to use glance you will need to activate this environment using the command:
|
|
|
|
|
|
|
|
mamba activate glance_user
|
|
|
|
|
|
|
|
Development Install Using MambaForge
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
If you need a **developer installation** of Glance, you will follow similar instructions as above to install MambaForge, but you will also need to be able to use git on the command line.
|
|
|
|
|
|
|
|
Use the following installation instructions instead:
|
|
|
|
|
|
|
|
mamba create -n glance python=3.11 numpy matplotlib mako mock scipy pillow cartopy pyqt netcdf4 h5py pip build
|
|
|
|
mamba activate glance
|
|
|
|
(cd to the directory where you want the Glance code installed)
|
|
|
|
git clone git@gitlab.ssec.wisc.edu:evas/UW-Glance.git
|
|
|
|
cd ./UW-Glance
|
|
|
|
pip install -e .
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
|
|
**Note: Everything below is out of date.**
|
|
|
|
|
|
|
|
|
|
|
|
Development Install Using Anaconda
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
This installs a dedicated Anaconda install for Glance's use.
|
|
|
|
|
|
|
|
Tested on Ubuntu 22.04 on 2022-09-26
|
|
|
|
|
|
|
|
```
|
|
|
|
cd $INSTALL_DIR # Whatever location you want
|
|
|
|
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
|
|
|
|
cd glance
|
|
|
|
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
|
|
|
|
sh Miniconda3-latest-Linux-x86_64.sh -b -p "`pwd`/anaconda"
|
|
|
|
source anaconda/bin/activate
|
|
|
|
# You can omit some or all of these for file formats you don't need to read
|
|
|
|
conda install -y netcdf4 h5py
|
|
|
|
conda install -y pyqt
|
|
|
|
conda install -y -c conda-forge pyhdf gdal
|
|
|
|
cd pyglance/
|
|
|
|
python setup.py develop
|
|
|
|
conda deactivate
|
|
|
|
cd ../..
|
|
|
|
```
|
|
|
|
|
|
|
|
glance is available as `glance/anaconda/bin/glance`
|
|
|
|
|
|
|
|
|
|
|
|
Minimal Anaconda install, no GUI
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
Known to work on:
|
|
|
|
|
|
|
|
| Operating System | Last Tested |
|
|
|
|
| ---------------- | ----------- |
|
|
|
|
| CentOS 7.9.2009 | 2021-09-24 |
|
|
|
|
| Ubuntu 18.04.5 | 2021-09-24 |
|
|
|
|
|
|
|
|
mkdir glance
|
|
|
|
cd glance
|
|
|
|
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
|
|
|
|
/bin/bash Miniconda3-latest-Linux-x86_64.sh -b -p `pwd`/anaconda
|
|
|
|
source anaconda/bin/activate
|
|
|
|
conda install -y numpy scipy matplotlib pillow geos cartopy mako markupsafe netcdf4
|
|
|
|
git clone --depth=1 https://gitlab.ssec.wisc.edu/evas/UW-Glance.git
|
|
|
|
cd UW-Glance/pyglance/
|
|
|
|
python setup.py develop
|
|
|
|
|
|
|
|
|
|
|
|
The resulting executable is in glance/anaconda/bin/glance
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Minimal Development Install for Ubuntu and other Linux distributions
|
|
|
|
====================================================================
|
|
|
|
|
|
|
|
(Verified on 2022-09-29 by Alan De Smet on the ubuntu:22.04 docker image, using the optional "Using distribution provided dependencies" step)
|
|
|
|
|
|
|
|
You will need:
|
|
|
|
|
|
|
|
- git
|
|
|
|
- python3
|
|
|
|
- python3-venv (python3's venv support)
|
|
|
|
- python3-dev (python3's development support)
|
|
|
|
- build-essential (gcc, g++, make)
|
|
|
|
- cmake
|
|
|
|
- libgeos-dev (what you need to build/link against libgeos)
|
|
|
|
|
|
|
|
On Debian or Ubuntu, this might do the job if you have sudo access:
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo apt install git python3 python3-venv build-essential python3-dev cmake
|
|
|
|
```
|
|
|
|
|
|
|
|
For other distributions you'll need to adjust package installation to your system.
|
|
|
|
|
|
|
|
<details>
|
|
|
|
<summary>Click here for using distribution provided dependencies on Debian/Ubuntu with sudo/root</summary>
|
|
|
|
|
|
|
|
You can install most or all of the dependencies using the Debian or Ubuntu distribution repositories using the following command. If you install them all, the `pip install` commands later should do nothing.
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pil python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev python3-venv python3.10-venv python3-setuptools-whl python3-pip-whl
|
|
|
|
```
|
|
|
|
|
|
|
|
If you want the GUI, add python3-pyqt5:
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
If you want to force a local install, perhaps for testing, omit `--system-site-packages`. Run these as your normal user:
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
|
|
|
|
cd glance
|
|
|
|
python3 -mvenv --system-site-packages venv
|
|
|
|
. venv/bin/activate
|
|
|
|
# These "pip install" lines will do nothing if all of the required
|
|
|
|
# modules are present on the system already
|
|
|
|
pip install numpy matplotlib mako mock scipy pillow cartopy netcdf4 h5py
|
|
|
|
pip install pyqt5 # Only needed for glance gui
|
|
|
|
cd pyglance
|
|
|
|
python3 setup.py develop
|
|
|
|
deactivate
|
|
|
|
cd ../..
|
|
|
|
```
|
|
|
|
|
|
|
|
At this point glance can be run as `glance/venv/bin/glance`
|
|
|
|
|
|
|
|
Glance requires a Unix-like system such as Linux or Mac OSX and python >=3.9 (preferably 3.11).
|
|
|
|
|
|
|
|
Setting up the Environment for Glance
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
Glance relies on python and several freely available libraries. There are multiple ways to get these prerequisites, but we recommend that you try the [MambaForge](https://github.com/conda-forge/miniforge#mambaforge) installation instructions first.
|
|
|
|
|
|
|
|
If you are working on an SSEC server there may already be a pre-built installation of Glance's prerequisites available. Check with TC for your specific server if you are unsure.
|
|
|
|
|
|
|
|
You will also need to install the appropriate python modules to load the sorts of files you want Glance to analyze. If you do not install the netcdf4 module for example, Glance will not be able to open NetCDF files for analysis.
|
|
|
|
|
|
|
|
Installing Glance Using MambaForge
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
You will need to have the python 3.10 version of MambaForge installed for these instructions. You can download a pre-built version of here (https://github.com/conda-forge/miniforge#mambaforge).
|
|
|
|
|
|
|
|
If you are working on the SSEC servers there may be a pre-installed version of MambaForge or MiniForge available. Check with TC if you aren't sure what's on the server you're using.
|
|
|
|
|
|
|
|
Once you have MambaForge installed, run the following commands on the command line:
|
|
|
|
|
|
|
|
mamba create -n glance_user python=3.11 'numpy<2.0' matplotlib mako mock scipy pillow cartopy pyqt netcdf4 h5py pip
|
|
|
|
mamba activate glance_user
|
|
|
|
pip install -v --extra-index-url https://larch.ssec.wisc.edu/eggs/repos uwglance
|
|
|
|
|
|
|
|
_Note that this example command includes several libraries for opening different file types, including netcdf4 and h5py. The netcdf4 library is also being used by Glance to open hdf4 files. Exactly which of these libraries you need to install depends on the files you wish to open with Glance._
|
|
|
|
|
|
|
|
This will create an environment called "glance" that can be used to run Glance at the command line. When you open a new terminal session with your computer to use glance you will need to activate this environment using the command:
|
|
|
|
|
|
|
|
mamba activate glance_user
|
|
|
|
|
|
|
|
Development Install Using MambaForge
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
If you need a **developer installation** of Glance, you will follow similar instructions as above to install MambaForge, but you will also need to be able to use git on the command line.
|
|
|
|
|
|
|
|
Use the following installation instructions instead:
|
|
|
|
|
|
|
|
mamba create -n glance python=3.11 'numpy<2.0' matplotlib mako mock scipy pillow cartopy pyqt netcdf4 h5py pip build
|
|
|
|
mamba activate glance
|
|
|
|
(cd to the directory where you want the Glance code installed)
|
|
|
|
git clone git@gitlab.ssec.wisc.edu:evas/UW-Glance.git
|
|
|
|
cd ./UW-Glance
|
|
|
|
pip install -e .
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
|
|
|
**Note: Everything below is out of date.**
|
|
|
|
|
|
|
|
|
|
|
|
Development Install Using Anaconda
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
This installs a dedicated Anaconda install for Glance's use.
|
|
|
|
|
|
|
|
Tested on Ubuntu 22.04 on 2022-09-26
|
|
|
|
|
|
|
|
```
|
|
|
|
cd $INSTALL_DIR # Whatever location you want
|
|
|
|
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
|
|
|
|
cd glance
|
|
|
|
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
|
|
|
|
sh Miniconda3-latest-Linux-x86_64.sh -b -p "`pwd`/anaconda"
|
|
|
|
source anaconda/bin/activate
|
|
|
|
# You can omit some or all of these for file formats you don't need to read
|
|
|
|
conda install -y netcdf4 h5py
|
|
|
|
conda install -y pyqt
|
|
|
|
conda install -y -c conda-forge pyhdf gdal
|
|
|
|
cd pyglance/
|
|
|
|
python setup.py develop
|
|
|
|
conda deactivate
|
|
|
|
cd ../..
|
|
|
|
```
|
|
|
|
|
|
|
|
glance is available as `glance/anaconda/bin/glance`
|
|
|
|
|
|
|
|
|
|
|
|
Minimal Anaconda install, no GUI
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
Known to work on:
|
|
|
|
|
|
|
|
| Operating System | Last Tested |
|
|
|
|
| ---------------- | ----------- |
|
|
|
|
| CentOS 7.9.2009 | 2021-09-24 |
|
|
|
|
| Ubuntu 18.04.5 | 2021-09-24 |
|
|
|
|
|
|
|
|
mkdir glance
|
|
|
|
cd glance
|
|
|
|
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
|
|
|
|
/bin/bash Miniconda3-latest-Linux-x86_64.sh -b -p `pwd`/anaconda
|
|
|
|
source anaconda/bin/activate
|
|
|
|
conda install -y numpy scipy matplotlib pillow geos cartopy mako markupsafe netcdf4
|
|
|
|
git clone --depth=1 https://gitlab.ssec.wisc.edu/evas/UW-Glance.git
|
|
|
|
cd UW-Glance/pyglance/
|
|
|
|
python setup.py develop
|
|
|
|
|
|
|
|
|
|
|
|
The resulting executable is in glance/anaconda/bin/glance
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Minimal Development Install for Ubuntu and other Linux distributions
|
|
|
|
====================================================================
|
|
|
|
|
|
|
|
(Verified on 2022-09-29 by Alan De Smet on the ubuntu:22.04 docker image, using the optional "Using distribution provided dependencies" step)
|
|
|
|
|
|
|
|
You will need:
|
|
|
|
|
|
|
|
- git
|
|
|
|
- python3
|
|
|
|
- python3-venv (python3's venv support)
|
|
|
|
- python3-dev (python3's development support)
|
|
|
|
- build-essential (gcc, g++, make)
|
|
|
|
- cmake
|
|
|
|
- libgeos-dev (what you need to build/link against libgeos)
|
|
|
|
|
|
|
|
On Debian or Ubuntu, this might do the job if you have sudo access:
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo apt install git python3 python3-venv build-essential python3-dev cmake
|
|
|
|
```
|
|
|
|
|
|
|
|
For other distributions you'll need to adjust package installation to your system.
|
|
|
|
|
|
|
|
<details>
|
|
|
|
<summary>Click here for using distribution provided dependencies on Debian/Ubuntu with sudo/root</summary>
|
|
|
|
|
|
|
|
You can install most or all of the dependencies using the Debian or Ubuntu distribution repositories using the following command. If you install them all, the `pip install` commands later should do nothing.
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y build-essential python3-numpy python3-matplotlib python3-mako python3-mock python3-scipy python3-pil python3-cartopy python3-pil python3-netcdf4 python3-h5py libgeos-dev python3-venv python3.10-venv python3-setuptools-whl python3-pip-whl
|
|
|
|
```
|
|
|
|
|
|
|
|
If you want the GUI, add python3-pyqt5:
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y python3-pyqt5
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
|
|
If you want to force a local install, perhaps for testing, omit `--system-site-packages`. Run these as your normal user:
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone https://gitlab.ssec.wisc.edu/evas/UW-Glance.git glance
|
|
|
|
cd glance
|
|
|
|
python3 -mvenv --system-site-packages venv
|
|
|
|
. venv/bin/activate
|
|
|
|
# These "pip install" lines will do nothing if all of the required
|
|
|
|
# modules are present on the system already
|
|
|
|
pip install numpy matplotlib mako mock scipy pillow cartopy netcdf4 h5py
|
|
|
|
pip install pyqt5 # Only needed for glance gui
|
|
|
|
cd pyglance
|
|
|
|
python3 setup.py develop
|
|
|
|
deactivate
|
|
|
|
cd ../..
|
|
|
|
```
|
|
|
|
|
|
|
|
At this point glance can be run as `glance/venv/bin/glance`
|
|
|
|
|
