Satpy’s Documentation

Satpy is a python library for reading, manipulating, and writing data from remote-sensing earth-observing meteorological satellite instruments. Satpy provides users with readers that convert geophysical parameters from various file formats to the common Xarray DataArray and Dataset classes for easier interoperability with other scientific python libraries. Satpy also provides interfaces for creating RGB (Red/Green/Blue) images and other composite types by combining data from multiple instrument bands or products. Various atmospheric corrections and visual enhancements are provided for improving the usefulness and quality of output images. Output data can be written to multiple output file formats such as PNG, GeoTIFF, and CF standard NetCDF files. Satpy also allows users to resample data to geographic projected grids (areas). Satpy is maintained by the open source Pytroll group.

The Satpy library acts as a high-level abstraction layer on top of other libraries maintained by the Pytroll group including:

• Pyresample
• PySpectral
• Trollimage
• Pycoast
• Pydecorate
• python-geotiepoints
• pyninjotiff

Go to the Satpy project page for source code and downloads.

Satpy is designed to be easily extendable to support any meteorological satellite by the creation of plugins (readers, compositors, writers, etc). The table at the bottom of this page shows the input formats supported by the base Satpy installation.

Note

Satpy’s interfaces are not guaranteed stable and may change until version 1.0 when backwards compatibility will be a main focus.

• Overview
  • Scene
  • DataArrays
  • Reading
  • Compositing
  • Resampling
  • Enhancements
  • Writing
• Installation Instructions
  • Pip-based Installation
  • Conda-based Installation
  • Ubuntu System Python Installation
• Downloading Data
  • NOAA GOES on Amazon Web Services
  • NOAA GOES on Google Cloud Platform
  • NOAA CLASS
  • NASA VIIRS Atmosphere SIPS
  • EUMETSAT Data Center
• Examples
• Quickstart
  • Loading and accessing data
  • Visualizing data
  • Creating new datasets
  • Generating composites
  • Resampling
  • Saving to disk
  • Troubleshooting
• Readers
  • Available Readers
  • Filter loaded files
  • Load data
  • Search for local files
  • Adding a Reader to Satpy
  • Implemented readers
• Composites
  • Built-in Compositors
  • Creating composite configuration files
  • Enhancing the images
• Resampling
  • Resampling algorithms
  • Resampling for comparison and composites
  • Caching for geostationary data
  • Create custom area definition
  • Create dynamic area definition
  • Store area definitions
• Enhancements
  • Built-in enhancement methods
• Writers
  • Available Writers
  • Colorizing and Palettizing using user-supplied colormaps
  • Saving multiple Scenes in one go
• MultiScene (Experimental)
  • Blending Scenes in MultiScene
  • Saving frames of an animation
  • Saving multiple scenes
• Developer’s Guide
  • How to contribute
  • Migrating to xarray and dask
  • Adding a Custom Reader to Satpy
  • Coding guidelines
  • Development installation
  • Running tests
  • Documentation

• Satpy API
• FAQ

Satpy Readers

Description	Reader name	Status
MSG (Meteosat 8 to 11) SEVIRI data in HRIT format	seviri_l1b_hrit	Nominal
MSG (Meteosat 8 to 11) SEVIRI data in native format	seviri_l1b_native	HRV full disk data cannot be remapped.
MSG (Meteosat 8 to 11) SEVIRI data in netCDF format	seviri_l1b_nc	HRV channel not supported, incomplete metadata in the files. EUMETSAT has been notified.
Himawari 8 and 9 AHI data in HSD format	ahi_hsd	Nominal
Himawari 8 and 9 AHI data in HRIT format	ahi_hrit	Nominal
MTSAT-1R JAMI data in JMA HRIT format	jami_hrit	Beta
MTSAT-2 Imager data in JMA HRIT format	mtsat2-imager_hrit	Beta
GOES 16 imager data in netcdf format	abi_l1b	Nominal
GOES 11 to 15 imager data in HRIT format	goes-imager_hrit	Nominal
GOES 8 to 15 imager data in netCDF format (from NOAA CLASS)	goes-imager_nc	Beta
Electro-L N2 MSU-GS data in HRIT format	electrol_hrit	Nominal
NOAA 15 to 19, Metop A to C AVHRR data in AAPP format	avhrr_l1b_aapp	Nominal
Metop A to C AVHRR in native level 1 format	avhrr_l1b_eps	Nominal
Tiros-N, NOAA 7 to 19 AVHRR data in GAC and LAC format	avhrr_l1b_gaclac	Nominal
NOAA 15 to 19 AVHRR data in raw HRPT format	avhrr_l1b_hrpt	In development
GCOM-W1 AMSR2 data in HDF5 format	amsr2_l1b	Nominal
MTG FCI Level 1C data for Full Disk High Spectral Imagery (FDHSI) in netcdf format	fci_l1c_fdhsi	In development
Callipso Caliop Level 2 Cloud Layer data (v3) in EOS-hdf4 format	caliop_l2_cloud	In development
Terra and Aqua MODIS data in EOS-hdf4 level-1 format as produced by IMAPP and IPOPP or downloaded from LAADS	modis_l1b	Nominal
NWCSAF GEO 2016 products in netCDF4 format (limited to SEVIRI)	nwcsaf-geo	In development
NWCSAF PPS 2014, 2018 products in netCDF4 format	nwcsaf-pps_nc	Not yet support for remapped netCDF products. Only the standard swath based output is supported. CPP products not supported yet
Sentinel-1 A and B SAR-C data in SAFE format	sar-c_safe	Nominal
Sentinel-2 A and B MSI data in SAFE format	msi_safe	Nominal
Sentinel-3 A and B OLCI Level 1B data in netCDF4 format	olci_l1b	Nominal
Sentinel-3 A and B OLCI Level 2 data in netCDF4 format	olci_l2	Nominal
Sentinel-3 A and B SLSTR data in netCDF4 format	slstr_l1b	In development
OSISAF SST data in GHRSST (netcdf) format	ghrsst_l3c_sst	In development
NUCAPS EDR Retrieval in NetCDF4 format	nucaps	Nominal
NOAA Level 2 ACSPO SST data in netCDF4 format	acspo	Nominal
GEOstationary Cloud Algorithm Test-bed (GEOCAT)	geocat	Nominal
The Clouds from AVHRR Extended (CLAVR-x)	clavrx	Nominal
SNPP VIIRS data in HDF5 SDR format	viirs_sdr	Nominal
SNPP VIIRS data in netCDF4 L1B format	viirs_l1b	Nominal
SNPP VIIRS SDR data in HDF5 Compact format	viirs_compact	Nominal
AAPP MAIA VIIRS and AVHRR products in hdf5 format	maia	Nominal
VIIRS EDR Active Fires data in NetCDF4 & CSV .txt format	viirs_edr_active_fires	Beta
VIIRS EDR Flood data in hdf4 format	viirs_edr_flood	Beta
GRIB2 format	grib	Beta
SCMI ABI L1B format	abi_l1b_scmi	Beta
VIRR data in HDF5 format	virr_l1b	Beta
MERSI-2 L1B data in HDF5 format	mersi2_l1b	Beta

Indices and tables

• Index
• Module Index
• Search Page