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:
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.
| 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 |
| FY-4A AGRI L1 data in HDF5 format | agri_l1 | Beta |
| Vaisala Global Lightning Dataset GLD360 data in ASCII format | vaisala_gld360 | Beta |
| TROPOMI L2 data in NetCDF4 format | tropomi_l2 | Beta |
| Hydrology SAF products in GRIB format | hsaf_grib | Beta
Only the h03, h03b, h05 and h05B products are supported at-present
|