Skip to content

How-To Guides

Use the how-to pages when you already know the task you want to do and want the canonical written guide for it.

If you are still learning the basic workflow, start with Getting Started, then Concepts, then Migrating from Rasterio.

How-to pages are grouped by the kinds of tasks people usually do next:

  • bringing data into Rasteret
  • reading from collections
  • enriching collections for downstream workflows
  • training and multi-dataset use
  • managing collections and cloud access
Guide Use it when you want to...
Migrating from Rasterio Compare Rasteret's collection-first shape with manual rasterio/STAC loops
TorchGeo Integration Use a Rasteret collection as a TorchGeo GeoDataset
Build from Parquet and Arrow Tables Create a collection from an existing Parquet, GeoParquet, DuckDB, Polars, or Arrow source
Bring Your Own AOIs, Points, And Metadata Pass business tables from GeoPandas, DuckDB, Polars, PyArrow, or SedonaDB into pixel reads
Point Sampling and Masking Sample point values or control polygon masking behavior
AEF Embeddings Work with AlphaEarth Foundation embeddings through Rasteret
Multi-Dataset Training Compose Rasteret-backed TorchGeo datasets or merge xarray outputs
Collection Management Build, import, inspect, export, reload, and filter collections
Dataset Catalog Browse built-in datasets and register local dataset IDs
Custom Cloud Provider Configure requester-pays or authenticated cloud access

When a notebook and a how-to page cover similar ground, the how-to page is the canonical written reference and the notebook is the guided walkthrough.