heregoes

Accelerated Python Library for GOES-R ABI and SUVI

---

Render and analyze GOES imagery from netCDF

• Developed at Here GOES Radiotelescope (2020) for realtime use with CSPP Geo GRB
• Accelerated and parallelized with the Numba JIT compiler for NumPy
• ABI features tested against ground targets and operational data and literature
• SUVI imagery in production at UW–Madison SSEC and tested for QC

Documentation

• Imagery examples for ABI and SUVI
• ABI navigation, subsetting, and parallax correction
• Library reference

Demos

• Terrain correction of the ABI Fixed Grid using heregoes

Features

🌎 ABI Earth imagery 🛰️
∘ Render Cloud and Moisture Imagery and "Natural" color RGB
∘ Apply band algebra for derived products or algorithms
∘ Orthorectify and export as Cloud-Optimized GeoTIFF (COG)

🌐 Navigation for ABI L1b and L2+ products 🧭
∘ Subset with slice notation or lat/lon bounding box
∘ Pixelwise ground area and local look angles to Sun and satellite
∘ Resample Numpy arrays to and from the projection of ABI scenes
∘ Correct geolocation for parallax displacement by terrain or cloud

☀️ SUVI Sun imagery 🔭
∘ Extreme Ultraviolet solar imagery (long exposures)
∘ Colorize Sun images or make custom RGB composites

Quickstart

1. Install heregoes-env

Download a release and install the appropriate Conda environment for your CPU:

Intel (MKL)

conda env create -f release/heregoes-env-intel.yml

AMD, ARM64 (OpenBLAS)

conda env create -f release/heregoes-env-other.yml

2. Activate

conda activate heregoes-env

3. Environmental variables

Optionally set HEREGOES_ENV_PARALLEL=False to disable parallel execution, or set HEREGOES_ENV_NUM_CPUS=n to limit the CPUs used to n.

4. netCDF input

Provide GOES-R ABI or SUVI netCDF files to heregoes from NOAA CLASS, AWS S3, or in real time from CSPP Geo GRB or AIT.

from heregoes.image import ABIImage, SUVIImage

abi_img = ABIImage("OR_ABI-L1b-Rad[...].nc")
abi_img.save("abi.jpg")

suvi_img = SUVIImage("OR_SUVI-L1b-[...].nc")
suvi_img.save("suvi.png")

See code examples for ABI and SUVI, or reference the library documentation.

Planned

• ABI pixelwise timestamps
• Builds for conda-forge

Future

• Dask integration
• Support for other geostationary platforms