Geospatial Learning

Overview

This repo is a living document for me to learn about working with geospatial data in python. It started as a simple attempt to read some ERA5 (ECMWF's climate data reanalysis) data, but has additionally involved into hodgepodge of experimenting with structuring python projects under uv, using marimo for notebooks, learning about useful libraries for geospatial data analysis like xarray, dask, and cartopy, and generally exploring geospatial.

Finally, it's also a test of using Google Antigravity as an IDE.

Notebook Results

• Hot and Cold: City Climate Comparison

Markdown Writeups

• Guides
  • CDS API Setup Guide
• My Writeups
  • ARCO and Modern Geospatial
  • Geospatial Data Levels

Setup

Install dependencies and setup prek:

uv sync --dev
uv run prek install -f

Run marimo notebooks:

uv run marimo edit notebooks/data_access_patterns.py

Run scripts:

uv run download-era5  # Download ERA5 data
uv run explore-era5   # Explore ERA5 data

Run tests:

uv run pytest tests/

Development

This project uses prek for pre-commit checks with with a very astral-y code quality setup of ruff and ty. See .pre-commit-config.yaml for details.

Manual Checks

You can run the full suite of checks manually at any time:

# Run all prek hooks
uv run prek run --all-files

# Or run individual tools
uv run ruff check .
uv run ty check