- v3.2.0
- Latest releaseRelease
- 703
- Installs, last 30 days30-day installs
- 21,446
- Installs, all timeAll-time installs
- 86
- GitHub starsStars
- 26
- ForksForks
Checked November 17, 2026
An open-source Python package for retrieving, analyzing, and visualizing atmospheric sounding data. It unifies observed, model, reanalysis, and aircraft profiles behind one interface and plots them on figures built for severe and winter weather analysis.
pip install sounderpy conda install -c conda-forge sounderpy import sounderpy as spy
clean_data = spy.get_obs_data('OAX', '2014', '06', '16', '18')
spy.build_sounding(clean_data) - Fetch data or upload your own Observed, aircraft, forecast, and reanalysis soundings, or a SHARPpy or CM1 file of your own
- Build full soundings, hodographs, and composites Winter mode, radar and map insets, ECAPE, storm motion, and dark and color-blind palettes
- Share and download Every plot has a link you can share, plus PNG, CSV, SHARPpy, and CM1 downloads
- An app on your phone iPhone: open sounderpy.app in Safari, tap Share, then Add to Home Screen. Android: open it in Chrome, tap the ⋮ menu, then Install app (or Add to Home screen).
Fetch Downloads and cleans up remote data for you
- Observed
- Radiosondes (RAOB, IGRAv2) from a master station list, and ACARS aircraft profiles
- Forecasts
- BUFKIT soundings from the HRRR, RRFS, RAP, GFS, SREF, and HiResW, plus archived NAM and NAM Nest runs
- Reanalysis
- Any point from ERA5, RAP, RUC, or NCEP-FNL
Load Reads data from local files
- Models
- CM1 input soundings and WRF output
- Text
- SHARPpy sounding files, GRAW, iMet, and WINDSONDE files
- Custom
- Any custom data can be turned into a SounderPy dictionary for analysis and visualization
Return What you get back
- Plots
- Severe and winter sounding figures, hodographs, composite soundings with parameter tables, and radar VAD hodographs
- The data
- Hundreds of severe and winter parameters, returned as a dictionary
- Files
- Clean profiles can be saved to CSV, SHARPpy, or CM1 format
Gallery
Full gallery in the docsLearn
All tutorialsMore capabilities
- Winter soundings Precipitation type, snow growth, freezing drizzle and fog, and transport winds. Auto mode picks it when the surface wet-bulb is below 35 °F.
- Surface modification Edit surface temperature, dewpoint, and wind, then recompute.
- Custom storm motion Right or left mover, mean wind, or any direction and speed.
- Custom parcels Plot your own parcel paths beside the standard ones.
- Hodograph options Storm-relative hodographs and boundary overlays, on VAD hodographs too.
- Themes & colors Custom color themes, plus dark and color-blind-friendly palettes.
- Watermarks Swap in your own credit text and logo with set_watermark().
- Map & radar Inset maps with NEXRAD or MRMS radar at the zoom you choose.
- Custom data Turn any profile into SounderPy data and plot it the same way.
- Output control Set resolution and the Skew-T pressure range.
- Data provenance Every figure shows where its data came from.
- Command line Fetch, plot, and export from the terminal, including winter mode.
Restored RAP/RUC & UW Data Access, New CLI, Plot Improvements, and Major Documentation Updates
- Fully operational Command Line Interface (CLI) for retrieving, plotting, analyzing, and exporting sounding data.
- New RAP/RUC GRIB2 retrieval workflow that accesses the grib2 archives from NOAA AWS for modern RAP data and NCEI for historical RAP/RUC data.
- Expanded automated testing, including live network smoke tests.
- New and expanded documentation, tutorials, plot gallery, case studies, and clean_data schema documentation, in addition to automated GitHub Pages documentation deployment.
pip install -U sounderpyWho uses SounderPy
- NWS offices
- Anchorage · Columbia · Des Moines · Grand Forks · Grand Rapids · Little Rock · Omaha
- Met services & labs
- Argonne National Laboratory · CMA National Meteorological Center · PAGASA (Philippines) · Royal Meteorological Institute of Belgium
- Universities
- Central Michigan University · Charles University · FU Berlin · Indiana University · Iowa State University · Mississippi State University · Missouri S&T · Naresuan University · NC State University · Ohio State University · Ohio University · Purdue University · Rizal Technological University · Sun Yat-sen University · Texas A&M University · Texas Tech University · University at Albany · University of Belgrade · UNC Charlotte · University of North Dakota · University of Oklahoma · Western Illinois University
Using SounderPy somewhere not listed? Tell me about it.
In publications 20 scroll for all
- Creating C++ code to efficiently compute sounding-derived parameters
- Explicit numerical simulations of hailstorm seeding with a three-moment microphysics cloud-resolving model: a comparison of two operational methodologies for hail suppression
- A radiosonde-constrained dual-polarization radar framework for district-scale hydrometeor phase mapping of a pre-monsoon hailstorm in Northern Thailand
- Baseline climatology of tornadoes and waterspouts in the Philippine Archipelago
- Clustering of right-moving tornadic supercell proximity sounding profiles using an explainable framework
- Localized tornado outbreak at the upstream of a tropical easterly wave in Camarines Norte, Philippines (13 September 2025)
- Project Severe Weather Archive of the Philippines (SWAP) Part 2: Baseline climatology of close proximity soundings in hailstorm environments across Luzon, Philippines
- A case study of the tornadic supercell in the Province of Pampanga, Philippines (27 May 2024)
- Supercell environments using GridRad-Severe and the HRRR: Addressing discrepancies between prior tornado datasets
- Spatiotemporal analysis of hail events in the Philippines
- Friday the 13th hailstorm in the Province of Bulacan, Philippines (13 August 2021): A case study
- Analysis of strongly tornadic environments in Central and Eastern Europe utilizing ERA5 reanalysis data
- The sensitivity of the impact of cell mergers on supercell thunderstorms before versus after sunset
- The influence of complex terrain on the Turin, New York tornado of 2023
- Comparison study of the electrical nature of two smoke-enhanced sea-breeze thunderstorm cases during TRACER
- Project Severe Weather Archive of the Philippines (SWAP) Part 1: Establishing a baseline climatology for severe weather across the Philippine Archipelago
- Occurrence of rare lightning events during Hurricane Nicholas (2021)
- Assessing radiative impacts of African smoke aerosols over the southeastern Atlantic Ocean
- Podmínky při vývoji weak-forcing derech ve střední Evropě
- The horizontal displacement of Macomb’s X-band and Davenport and Lincoln’s S-band radar images caused by atmospheric conditions
Abstract
SounderPy is a simple, open-source Python package for retrieving and plotting vertical profile (sounding) data. Built for simplicity and reliability for all uses and users, this project’s goal is to provide a uniform method for sounding analysis across multiple data types. Severe weather analysis and forecasting requires a sound comprehension of thermodynamic and kinematic properties of the environment. SounderPy makes this possible with robust access to data and custom visualizations. The tool creates complex yet effective sounding and hodograph plots with high readability which are designed specifically for severe weather analysis and forecasting. SounderPy is capable of retrieving and plotting model forecast data, observed radiosonde data, Aircraft Communications Addressing and Reporting System (ACARS) observation data, and model reanalysis data. All of this functionality can be completed in three simple lines of code or less, making SounderPy an accessible tool for both Python experts and novices. A number of scientific Python libraries build the base of SounderPy’s efficient and durable functionality, such as NumPy, Matplotlib, xarray, MetPy, and SHARPpy. SounderPy is available through GitHub and PyPI and is distributed under an MIT license.
Cite SounderPy
- Gillett, K. J., 2025: SounderPy: An atmospheric sounding visualization and analysis tool for Python. J. Open Source Software, 10, 8087, https://doi.org/10.21105/joss.08087.
A poster on SounderPy's functionality and capabilities, presented at the 27th Annual Central Iowa National Weather Association Severe Storms and Doppler Radar Conference.
- Gillett, K. J., 2024: SounderPy: A Sounding Visualization Tool for Severe-Weather Analysis and Forecasting. Poster presented at the 27th Annual Central Iowa National Weather Association Severe Storms and Doppler Radar Conference, Ankeny, Iowa, https://doi.org/10.13140/RG.2.2.15823.29600.
- Invited2026
Gillett, K. J.: SounderPy: A Sounding Analysis and Visualization Platform for Severe Weather Forecasting. Environment Canada Storm Prediction Centre Spring Change of Seasons Workshops, Winnipeg, MB, and Dartmouth, NS.
- Poster2024
Gillett, K. J.: SounderPy: A Sounding Visualization Tool for Severe-Weather Analysis and Forecasting. 27th Central Iowa NWA Severe Storms and Doppler Radar Conference, https://doi.org/10.13140/RG.2.2.15823.29600.
Contributors
- Scott ThomasNWS Grand RapidsVWP hodograph and buoy-site listing
- Amelia R. H. UrquhartUniversity of Oklahomaecape-parcels library
- Daryl HerzmannIowa State Universityconda-forge feedstock
- Ryan VandersmithStepwise CAPE/CIN plot
- David E. LevinNOAA/NWSAlaskan RAOB site IDs
Support SounderPy
SounderPy is free and developed independently. If it helps your forecasting, research, or teaching, you can support continued development.
- Built on
- SHARPpy · MetPy · ecape-parcel · Matplotlib · NumPy · SciPy · pandas · xarray · Cartopy · Py-ART · Siphon · cfgrib
- Radiosondes
- University of Wyoming and NOAA NCEI (IGRA v2)
- Aircraft
- University of Oklahoma SHARP archive (ACARS)
- Model forecasts
- Penn State and Iowa State BUFKIT archives, and NOAA NOMADS
- Reanalysis
- NOAA NCEI and NOAA Open Data on AWS (RAP/RUC), ECMWF Copernicus (ERA5), and NCAR RDA (NCEP FNL)
- Radar
- NOAA NEXRAD on AWS and Unidata THREDDS
- Surface and launches
- Iowa Environmental Mesonet
- Maps
- Natural Earth
