README.md

InGARSS Workshop 2024

Welcome to the InGARSS Workshop 2024 tutorial series! This repository contains a collection of Jupyter notebooks designed to guide you through.

Table of Contents

• Getting Started
• Tutorial Notebooks
  • Notebook 1: Setup
  • Notebook 2: STAC & Zarr
  • Notebook 3: Dynamic Visualization
  • Notebook 4: Raster & Vector
• Repository Structure
• Contributing
• License

Getting Started

To get started with the tutorials, you can run the notebooks directly in Google Colab, which allows you to execute code without any local setup.

OR

You can also run the notebooks locally, but you will need to install the dependencies and set up a Python environment. We recommend using uv to manage the Python environment.

Prerequisites: Install uv

git clone https://github.com/developmentseed/ingarss-workshop-2024.git
cd ingarss-workshop-2024
uv sync
uv run jupyter lab

Tutorial Notebooks

Notebook 1: Setup

Downloads the data into your Google Drive to be used in the other notebooks.

Notebook 2: STAC & Zarr

Learn about Cloud Native Geospatial Data Formats; we will look into STAC and Zarr by using ERA5 air temperature data.

Notebook 3: Dynamic Visualization

Learn to analyze & visualize time-series data using xarray and lonboard.

Notebook 4: Raster & Vector

Learn about STAC & Cloud Optimized GeoTIFFs.

Repository Structure

• book/docs/: Contains the tutorial Jupyter notebooks.
• book/docs/data/: Includes dataset files used in the tutorials.
• .python-version: Specifies the Python version for consistency.
• pyproject.toml: Project configuration file.
• uv.lock: Dependency lock file.

Contributing

Contributions are welcome! If you have suggestions or find issues, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.

---

Note: This repository is currently on the colab-setup branch. All the Colab links point to this branch to ensure compatibility.