NISAR Cookbook

:::{figure} assets/3_PAR_SARImaging.gif :alt: NISAR Imaging Animation

NISAR Imaging Animation: https://assets.science.nasa.gov/content/dam/science/missions/nisar/nisar-jpl/multimedia/3_PAR_SARImaging.mp4 :::

:::{warning} This Cookbook is under active development

Notebooks are currently being updated to utilize NISAR provisional data. Notebooks still needing work have been temporarily removed from the table of contents but remain in the repository.

Upcoming cookbook goals include:

• Subsetting NISAR RSLCs
• Ionospheric phase delay notebooks
• GUNW notebooks
• Multi-temporal RGB composite notebooks
• InSAR coherence RGB notebooks
• Specific application-focused notebooks: floods, snow, glaciology, earthquakes, and more

We welcome community contributions! :::

NISAR (NASA-ISRO Synthetic Aperture Radar) is a satellite mission designed to observe Earth's dynamic processes using microwave remote sensing. It's L-band and S-band measurements provide consistent global observations, regardless of cloud cover or daylight.

After learning to access and visualize NISAR L-band data in this cookbook, you will be ready to begin applying NISAR imagery to a wide range of Earth science applications, including ecosystem monitoring, hydrology, cryosphere studies, natural hazards, and surface change analysis.

Motivation

The NISAR mission will provide one of the most comprehensive global radar datasets ever collected, offering new opportunities to study the dynamic Earth. This cookbook is designed to help a wide range of users, including students, researchers, and communities, to begin working with NISAR’s multiple products.

By introducing clear, hands-on examples, we hope to make the mission’s powerful data resources simple, approachable and usable. Our goal is to help you build the skills needed to explore NISAR data with confidence and apply NISAR’s capabilities to your own scientific, environmental, or community-focused questions.

Authors

Lewandowski, Alex. White, Julia.

(contribute)=

Contribute!

This project is open source and open development. See the contributor's guide to learn how to join the project and make your first contribution.

Structure

Section 1: Cookbook Set Up

Gain access to the data and set up required software environments for the included workflows.

Section 2: NISAR data access

Learn how to search, access, and work with NISAR data.

Section 3: NISAR GCOV Data

Learn how to access, load, manipulate, visualize, and analyze NISAR GCOV data.

Section 4: NISAR GSLC Data

Learn how to create interferograms and conduct various polSAR analyses with NISAR GSLC data.

Section 5: Additional NISAR resources

Links to additional NISAR resources.

Section 6: Contibute to the NISAR Cookbook

We welcome contributions! Learn how to raise issues, make updates, and add content to this cookbook.

Running the Notebooks

You can run the notebooks on a JupyterHub such as OpenSARLab or on your local machine.

(Option 1) Run in OpenSARLab or on Another JupyterHub Supporting User-Installable Pixi Environments

1. Sign up for an OpenScienceLab account and request access to OpenSARLab.

2. Navigate to ~/Data_Recipe_Jupyter_Books/NISAR_Cookbook to explore and execute the notebooks.

(Option 2) Run on Your Own Machine

If you are interested in running this material locally on your computer, you will need to follow this workflow:

1. Install Pixi using one of the following options if not already installed:

   • macOS / Linux:

       curl -fsSL https://pixi.sh/install.sh | bash

   • Windows (PowerShell):

   iwr -useb https://pixi.sh/install.ps1 | iex

   • Download the pixi installer

2. Restart your terminal after installing Pixi so it is on your PATH.

3. Clone the https://github.com/ASFOpenSARlab/NISAR_Cookbook repository:

    git clone https://github.com/ASFOpenSARlab/NISAR_Cookbook.git

4. Move into the NISAR_Cookbook directory

   cd NISAR_Cookbook

5. Install the Pixi environment needed to execute the notebooks and launch JupyterLab with a single command:

   pixi run -e isce3 lab
   

   :::{tip} Navigate the NISAR Cookbook from its table of contents

   Click the "JB" tab on the left-hand sidebar if you wish to navigate the NISAR Cookbook using a table of contents instead of the file browser.

   This feature is provided by the jb-toc JupyterLab extension. :::