11. ITS_LIVE Explorer¶

Summary¶

ITS_LIVE¶

Global land ice velocities. The Inter-mission Time Series of Land Ice Velocity and Elevation (ITS_LIVE) project facilitates ice sheet, ice shelf and glacier research by providing a globally comprehensive and temporally dense multi-sensor record of land ice velocity and elevation with low latency. Scene-pair velocities were generated from satellite optical and radar imagery.

The notebooks on this project demonstrate how to search and access ITS_LIVE velocity pairs and provide a simple example on how to build a data cube.

Project at NASA’s Github account: https://github.com/nasa-jpl/itslive-explorer

Usage with Binder¶

The Binder button above allows you to explore and run the notebook in a shared cloud computing environment without the need to install dependencies on your local machine. Note that this option will not directly download data to your computer; instead the data will be downloaded to the cloud environment.

Usage with Docker¶

On Mac OSX or Linux¶

Install Docker. Use the left-hand navigation to select the appropriate install depending on operating system.
Download the repository from Github.
Unzip the file, and open a terminal window in the itslive-explorer folder’s location.
From the terminal window, launch the docker container using the following command, replacing [path/notebook_folder] with your path and notebook folder name:

docker run --name itslive -p 8888:8888 -v [path/notebook_folder]:/home/jovyan/work nsidc/itslive-explorer

Example:

docker run --name itslive -p 8888:8888 -v /Users/name/Desktop/itslive-explorer:/home/jovyan/work nsidc/itslive-explorer

Or, with docker-compose:

docker-compose up

If you want to mount a directory with write permissions, you need to grant the container the same permissions as the one on the directory to be mounted and tell it that has “root” access (within the container). This is important if you want to persist your work or download data to a local directory and not just the docker container. Run the example command below for this option:

docker run --name itslive -e NB_UID=$(id -u) --user root -p 8888:8888 -v  /Users/name/Desktop/itslive-explorer:/home/jovyan/work nsidc/itslive-explorer

The initialization will take some time and will require 2.6 GB of space. Once the startup is complete you will see a line of output similar to this:

To access the notebook, open this file in a browser:
        file:///home/jovyan/.local/share/jupyter/runtime/nbserver-6-open.html
    Or copy and paste one of these URLs:
        http://4dc97ddd7a0d:8888/?token=f002a50e25b6f623aa775312737ba8a23ffccfd4458faa6f
     or http://127.0.0.1:8888/?token=f002a50e25b6f623aa775312737ba8a23ffccfd4458faa6f

If you started your container with the -d/--detach option, check docker logs itslive for this output.

Open up a web browser and copy one of the URLs as instructed above.
You will be brought to a Jupyter Notebook interface running through the Docker container. The left side of the interface displays your local directory structure. Navigate to the work folder of the itslive-explorer repository folder. You can now interact with the notebooks to explore and access data.

On Windows¶

Install Docker.
Download the repository from Github.
Unzip the file, and open a terminal window (use Command Prompt or PowerShell, not PowerShell ISE) in the itslive-explorer folder’s location.
From the terminal window, launch the docker container using the following command, replacing [path\notebook_folder] with your path and notebook folder name:

docker run --name itslive -p 8888:8888 -v [path\notebook_folder]:/home/jovyan/work nsidc/itslive-explorer

Example:

docker run --name itslive -p 8888:8888 -v C:\notebook_folder:/home/jovyan/work nsidc/itslive-explorer

Or, with docker-compose:

docker-compose up

If you want to mount a directory with write permissions you need to grant the container the same permissions as the one on the directory to be mounted and tell it that has “root” access (within the container)

docker run --name itslive --user root -p 8888:8888 -v C:\notebook_folder:/home/jovyan/work nsidc/itslive-explorer

The initialization will take some time and will require 2.6 GB of space. Once the startup is complete you will see a line of output similar to this:

To access the notebook, open this file in a browser:
        file:///home/jovyan/.local/share/jupyter/runtime/nbserver-6-open.html
    Or copy and paste one of these URLs:
        http://(6a8bfa6a8518 or 127.0.0.1):8888/?token=2d72e03269b59636d9e31937fcb324f5bdfd0c645a6eba3f

If you started your container with the -d/--detach option, check docker logs itslive for this output.

Follow the instructions and copy one of the URLs into a web browser and hit return. The address should look something like this:

http://127.0.0.1:8888/?token=2d72e03269b59636d9e31937fcb324f5bdfd0c645a6eba3f

You will now see the itslive-explorer repository within the Jupyter Notebook interface. Navigate to /work to open the notebooks.
You can now interact with the notebooks to explore and access data.

Usage with Conda¶

Install miniconda3 (Python 3.7) for your platform from https://docs.conda.io/en/latest/miniconda.html

Download the itslive-explorer repository from Github by clicking the green ‘Code’ button located at the top right of the repository page and clicking ‘Download Zip’.

Unzip the file, and open a command line or terminal window in the itslive-explorer folder’s location.

From a command line or terminal window, install the required environment with the following commands:

conda env create -f binder/environment.yml && conda activate itslive-explorer
./binder/postBuild

You should now see that the dependencies were installed and our environment is ready to be used.

If you are a returning user, please make sure your repository is up to date and run the following to update your environment:

conda env update -f binder/environment.yml

Activate the environment with

conda activate itslive-explorer

Launch the notebook locally with the following command:

jupyter lab

This should open a browser window with the JupyterLab IDE, showing your current working directory on the left-hand navigation. Navigate to the notebooks folder of choice and click on their associated *.ipynb files to get started.

NOTE: Sometimes Conda environments change (break) even with pinned down dependencies. If you run into an issue with dependencies for the itslive-explorer please open an issue and we’ll try to fix it as soon as possible.

Credit¶

This software is developed by the National Snow and Ice Data Center with funding from multiple sources.

License¶

This repository is licensed under the MIT license.

EarthCube 2021 Call for Notebooks