Skip to content

Runnable notebook vignettes

These are real Jupyter .ipynb files tracked in the SpectralBridge repository. Each link opens the notebook in GitHub's repository viewer so you can read its Markdown and code cells on the web. GitHub does not execute the cells; clone or download the notebook when you are ready to run it locally.

The notebooks mirror the learning modules and call existing SpectralBridge functions. They contain configuration cells, explanations of inputs and outputs, and validation checkpoints. Copy a notebook into your own analysis directory before changing scientific assumptions.

Their code and narrative follow the two active research notebooks at the repository root: Raster_processing.ipynb and Drone_processing.ipynb. The full-pipeline vignettes use the same public orchestrators, while the focused vignettes expose one stage at a time. Output checks use the same practical patterns—printed result summaries, file inventories, DuckDB or pandas table previews, and ENVI/QA plots—but omit machine-specific transfer commands and saved outputs so the files remain portable.

Order Notebook Use it when
00 Full NEON pipeline You want download through QA in one restart-safe call
01 Acquire NEON HDF5 You only want to obtain or reuse the source HDF5
02 Correct NEON reflectance You want raw ENVI plus standard topo/BRDF outputs
03 Harmonize to Landsat You already have corrected hyperspectral ENVI and want target-sensor products
04 Build and inspect analysis tables You want Parquet/CSV inspection and output checks
05 Review QA and validation You want to render QA and inspect machine-readable diagnostics
06 Process drone imagery You have local drone HDF5 inputs
07 Extract polygon spectra You want polygon-indexed spectra from a completed flightline
08 Insert a custom correction You are developing a reviewed correction after topo/BRDF and before convolution

Opening them

From a clone:

python -m pip install -e ".[notebooks]"
jupyter lab docs/vignettes/notebooks/

The notebooks use repository-relative paths and begin with an editable configuration cell. Large runs can take substantial memory and storage. Start with one flightline, engine="thread", and max_workers=1.

What “runnable” means

The notebooks have valid kernels, importable code, and no saved outputs. Data processing cells are guarded by RUN = False so opening or running all cells does not unexpectedly download tens of gigabytes. Set RUN = True only after editing the paths and identifiers in the configuration cell.