heregoes

Lightweight Python for GOES-R ABI and SUVI

---

High performance GOES-R Earth and Sun imagery from netCDF

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

Features

Instrument	Products	Features
ABI	L1b	Render Cloud and Moisture Imagery and "Natural" color RGB
ABI	L1b	Export as high resolution Cloud-Optimized GeoTIFF (COG)
ABI	L1b, L2+	Subset with slice notation or lat/lon bounding box
ABI	L1b, L2+	Terrain correction for imagery and geolocation
ABI	L1b, L2+	Pixelwise ground area and look vectors for Sun and satellite
ABI	L1b, L2+	Resample Numpy arrays to and from the projection of ABI scenes
SUVI	L1b	Extreme Ultraviolet solar imagery (long exposures)
SUVI	L1b	Create custom solar RGB composites

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

Quickstart

1. Install heregoes-env

Clone this repository 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.

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")

Planned

• ABI pixelwise timestamps
• Builds for conda-forge

Future

• Dask integration
• Support for GeoXO