๐ŸŽˆ SounderPy๏ƒ

VERTICAL PROFILE DATA RETRIEVAL & ANALYSIS FOR PYTHON

Retrieve, analyze, visualize, and export atmospheric vertical profiles from observations, forecasts, reanalyses, and numerical models.

pip install sounderpy
conda install sounderpy

Start Here๏ƒ

๐Ÿš€ Getting Started

Install SounderPy, retrieve a profile, and create your first sounding.

Start learning โ†’

๐Ÿ‘จโ€๐Ÿณ Tutorials

Step-by-step guides for plots, radar, parcels, hodographs, data sources, exports, and command-line workflows.

Browse tutorials โ†’

๐Ÿ“Š Plot Gallery

Explore sounding, hodograph, composite, radar, parcel, and data-source examples.

View gallery โ†’

๐ŸŒŽ Data Sources

Work with RAOB, ACARS, RAP/RUC, BUFKIT, ERA5, NCEP, WRF, CM1, and custom vertical profiles.

Explore data sources โ†’

๐Ÿ“š Reference

Find detailed retrieval, plotting, calculation, and helper-function documentation.

Open reference โ†’

๐Ÿ’ป Command Line Interface

Retrieve, plot, export, and automate SounderPy directly from a terminal.

Use the CLI โ†’

Get a Sounding in Seconds๏ƒ

SounderPy provides the same core workflow through both Python and the command line.

Python

import sounderpy as spy

data = spy.get_obs_data(
    "OAX",
    "2014", "06", "16", "18")

spy.build_sounding(data)

Command Line

sounderpy obs OAX 2014-06-16 18 \
    --plot sounding

One Workflow, Many Data Sources, Several Plotting Options๏ƒ

Observations

RAOB, IRGAv2, ACARS

Forecasts

BUFKIT: HRRR, RAP, GFS, etc

Reanalysis

RAP, RUC, ERA5, NCEP-FNL

Modeling Systems

CM1, WRF, MPAS

Custom Sources

SHARPPY + more

Soundings

Full Skew-T, Log-P diagram and hodograph figure.

Hodographs

Simple hodograph figure.

Composite Soundings

Several profiles on one sounding.

Learn how SounderPy handles data โ†’

Whatโ€™s New in SounderPy 3.3.0๏ƒ

SounderPy 3.3.0 rebuilds the plotting module and makes every figure easier to customize.

  • ๐Ÿ“ˆ SounderPyโ€™s plot module is fully rebuilt and refactored allowing for increased figure customization and generation speed. Most figures are roughly 50% faster.

  • ๐ŸŽจ The new figure kwarg theme lets you set your own colors while credit text and logo can be changed with spy.set_watermark().

  • ๐Ÿ” Full sounding and composite figures now include a ylim kwarg, allowing you to adjust the Skew-Tโ€™s y-axis (pressure) limits.

  • ๐Ÿงฉ Composite soundings have been completely rebuilt. Composites include a table of various parameters, normalized kwarg names, and support for custom data sources.

  • ๐Ÿ—บ๏ธ VAD hodographs now include the map, radar, hodograph boundary, and DPI options of the other figures.

  • โ„๏ธ New winter sounding: build_sounding(mode='winter') draws a sounding built around precipitation type, snow growth, and winter hazards. mode='auto' picks the winter sounding when the surface wet-bulb is below 35 degrees F, and show_obs=True adds the latest surface observation. See โ„๏ธ Winter Soundings.

  • ๐Ÿงฎ spy.winter_params(clean_data).calc() returns every sounding_params value plus the winter values behind the winter sounding.

  • ๐Ÿ’ป The command line tool adds --mode {severe,winter,auto} and --obs for sounding plots.

  • โœˆ๏ธ ACARS profiles now use the airport elevation in meters (it was read in feet), which corrects the surface label and surface pressure.

  • ๐Ÿงต RAP/RUC reanalysis GRIB parsing is now thread safe. get_model_data('rap-ruc', ...) can run from several threads at once (for example, to fetch composite profiles in parallel); downloads still run in parallel while GRIB decoding takes turns.

  • ๐ŸŒฆ๏ธ The NAM and NAMNEST (NAM3km) BUFKIT forecasts are archive only after their NCEP decommissioning on Nov. 2nd, 2026.

  • ๐Ÿ“š Refactored and redesigned documentation to match new SounderPy web app: sounderpy.app

Important

sounding_params(...).calc() and vad_params(...).calc() now return a dictionary instead of a tuple, and build_composite()โ€™s colors_to_use, ls_to_use, alphas_to_use, and lw_to_use are renamed to colors, linestyles, alphas, and linewidths. The old names still work in 3.3.0 but show a FutureWarning, and will be removed in a later release. The data retrieval and file modules (such as sounderpy.bufkit_data) moved into sounderpy.data (sounderpy.data.bufkit_data); spy.* functions are unchanged, and the old module paths still work with a FutureWarning. See ๐Ÿ› ๏ธ Helper Tools and ๐Ÿ“ˆ Tools for Plotting Data.

See the plotting reference โ†’

Using SounderPy in Research?๏ƒ

SounderPy is open-source scientific software developed for atmospheric vertical profile retrieval, analysis, and visualization.

โ˜• SounderPy is a open-source package developed on my own time. Would you like to support continued SounderPy development? Consider โ€œBuying me a coffeeโ€! โ˜•

Directory๏ƒ

API Reference:

Tutorials: