Quick Start

Installation from source

First you need to download and set up Anaconda or Miniconda on your computer.

Note that eViz has been tested with Python version >= 3.8

Get the source code (use http protocol for read-only access, ssh otherwise):

git clone https://git.smce.nasa.gov/astg/visualization/eviz.git
git clone git@git.smce.nasa.gov:astg/visualization/eviz.git

cd into the code repo:

cd eviz

Create the Python environment (assuming you are working on a MAC):

conda env create -f cicd/environment_mac.yaml

Enter y when prompted. This will download all the required packages needed to run the eViz tools and install them in a separate environment called viz. This may take several minutes, so please be patient.

Once the installation has finished building, activate the installed environment by running:

conda activate viz

Installation via pip

First, install the viz environment as described above, then

pip install eviz

Sample data

There are two eViz tools that can be from the command line interface (CLI): iViz and eViz. The iViz tool is a Jupyter notebook-based dashboard with interactive widgets whereas eViz is a non-interactive CLI-driven map-generating tool. In either mode, we need data. On DISCOVER we provide some data representative of the data sources supported by the eViz tools. The data is located here:

/discover/nobackup/projects/jh_tutorials/eviz/sample_data

Therein you will find datasets collected from various data sources that are used to produce the visualizations described in this guide.

JupyterHub

On Discover, eViz is installed on the JupyterHub system. To access it you must log in to:

https://jh-discover.nccs.nasa.gov/

using your LDAP credentials.

Once you get a session, open up a notebook and make sure you select the Python viz kernel. Then type the following:

from eviz.lib.iviz_base import Iviz
iviz = Iviz()
iviz.make_notebook(s='ccm')

If all goes well, you should see the iViz app running on your notebook with “ccm” data loaded and ready to browse. For more information please take a look at the iViz user guide.