Snow Depth Prediction using L-Band InSAR Products

Overview

This work serves as a proof-of-concept that InSAR products can be used to estimate total snow depth through Machine Learning. This repository contains the code used to generate all results in the our paper (link to publication will follow shortly).

Dataset

This work uses dataset from the 2017 NASA SnowEx Campaign. The InSAR data is from NASA JPL's UAVSAR sensor, and the Lidar Depth is from ASO.

Link to the remote sensing data we used: link.
Link to the ground truth data: NSIDC.

Software and hardware list

Software used	Link to the software	Hardware specifications	OS required
Python 3.11.5	https://github.com/pyenv/pyenv	This code should work on any recent PC/Laptop	Linux (any), MacOS, Windows

Usage

To use the codes in this repository, you need to have Python installed. There are several ways to install Pyton. I will take you through how to install Python using the pyenv utility program. pyenv allows you to install different versions of Python and to seamlessly switch between them.

1. Install `pyenv`

Please follow the instructions here to install pyenv for your operation system (OS).

2. Setup the environment

2.1 Mac and Linux

Open the terminal and type the following commands to setup your virtual environment.

pyenv install 3.11.5
mkdir insar_project
cd insar_project
pyenv local 3.11.5
python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip

2.2 Windows

pyenv does not officially support Windows OS. Hence, you should install Python directly for your own version of Windows either by using the Microsoft Store or by navigating to https://www.python.org/downloads/windows/ in your browser and following the download link. During installation, be sure to check the box that adds Python to your PATH environment variables. To run Python in a virtual environment, open the PowerShell program and type the follow commands.

mkdir insar_project
cd insar_project
python -m venv .venv
.venv/Scripts/activate
pip install --upgrade pip

If these instructions doesn't work for you (Windows users), you may need change the execution policy of your computer. To do this, run the PowerShell program as an administrator and run Set ExecutionPolicy Unrestricted. Afterwards, exit and reopen the PowerShell program (not as an administrator) then type commands in 2.2.

3. Clone the Repository

git clone https://github.com/Ibrahim-Ola/uavsar-lidar-project.git
cd uavsar-lidar-project

4. Install Source Code

pip install .

5. Directory Setup

Create the data folder using the command below.

mkdir data

Download the dataset into the data folder by following the links in the Dataset section above.

6. Deactivate Environment

After running the experiments, you can deactivate the virtual environment by running the command below.

deactivate

Acknowledgements

We would like to express our gratitude to the NASA Terrestrial Hydrology Program and all participants of the SnowEx campaign for providing the Lidar and in-situ data.
We also thank Yunling Lou - the UAVSAR Project Manager at NASA JPL - for the UAVSAR data.
This work was partially funded by the U.S. Army Cold Regions Research and Engineering Laboratory (CRREL) under contract W913E523C0002.

Ibrahim-Ola/uavsar-lidar-project