What's Changed

Bugs Fixed 🐛

• Fix Q Vector example stability and scaling (backport) by @unidata-pr-helper[bot] in #3878
• Make remote client docs & examples visible (backport) by @github-actions[bot] in #3817
• BUG: Fix handling rotated pole (lat/lon) parsing (backport) by @unidata-pr-helper[bot] in #3841
• Turbulence Fixes with xarray functionality (backport) by @unidata-pr-helper[bot] in #3885

Other Changes

• Fix broken link to Project Pythia MetPy cookbook (backport) by @unidata-pr-helper[bot] in #3877
• add_station_lat_lon: insert columns respectfully (backport) by @unidata-pr-helper[bot] in #3879
• Update NEXRAD archive bucket name (backport) by @unidata-pr-helper[bot] in #3907
• Silence FututreWarning raised by xarray v2025.08.0 (backport) by @unidata-pr-helper[bot] in #3908

New Contributors

• @unidata-pr-helper[bot] made their first contribution in #3841

Full Changelog: v1.7.0...v1.7.1

Highlights

• New analytic LCL calculation based on Romps (2017)
• New saturation vapor pressure calculations, relative to both ice and liquid, using Ambaum (2020)
• Moisture/temperature dependent gas constants and latent heat calculations
• New clients for accessing remote S3 archives for NEXRAD Level 2 & 3, GOES, and ML Weather Prediction (from CIRA)
• Support for plotting WPC surface analyses in the simplified plotting interface
• Shear and curvature vorticity calculations
• Stüve and Emagram plots
• Automatic identification of high/low locations
• Better support for plotting highs/lows using scattertext

What's Changed

New Features 🎉

• New PlotSurfaceAnalysis class to plot WPC surface analysis bulletins by @anacmontoya in #3580
• Moisture/temperature dependent gas constants & latent heat by @dcamron in #3725
• ENH: Add shear and curvature vorticity calculations by @Z-Richard in #3361
• AWS Data Clients by @dopplershift in #3000
• Add Stüve, Emagram plots by @cdholmes in #3626
• Find peaks by @dopplershift in #3729

Enhancements 😄

• Python 3.13 Support by @dopplershift in #3682
• Prevent frontogenesis from returning nans by @sgdecker in #3696
• Avoid returning negative saturation mixing ratios by @dopplershift in #3758
• Romps 2017 Analytic LCL by @dcamron in #3728

Bugs Fixed 🐛

• fix wrong input to function by @kgoebber in #3613
• Fix xarray support with decode_coords='all' by @dopplershift in #3664
• Use parcel prof for parcel mix ratio by @ahijevyc in #3751
• Fix q_vector units w/ default static stability by @dopplershift in #3690
• BUG: Fix turbulence kinetic energy calculation (Fixes #3756) by @lesserwhirls in #3757
• Fix sounding merge bug by @nawendt in #3793
• 🐛🔨 on zero-size array to reduction operation in lfc when there is no el by @leaver2000 in #3796

Other Changes

• Fix MAG entry in GEMPAK Guide by @sgdecker in #3699
• Documentation theme updates by @dopplershift in #3670
• Fix links by @dopplershift in #3611
• Update redirecting link by @dopplershift in #3615
• Update NSF Unidata logo by @dopplershift in #3650
• MNT: Replace cKDTree with KDTree. by @DWesl in #3659
• add more information about the laplacian function by @ahmedshaaban1 in #3744
• Update IAU ref to open link by @dcamron in #3787
• Redirect python-gallery to cookbook by @dcamron in #3789
• Ambaum 2020 saturation vapor pressure + phase handling by @dcamron in #3726

New Contributors

• @DWesl made their first contribution in #3659
• @cdholmes made their first contribution in #3626
• @ahmedshaaban1 made their first contribution in #3744
• @leaver2000 made their first contribution in #3796

Full Changelog: v1.6.3...v1.7.0

Highlights

• Support for NumPy 2.0 and Pint 0.24
• Fix for error in galvez_davison_index
• This the last release that will support Python 3.9

What's Changed

Bugs Fixed 🐛

• fixes issue #3535 by @anacmontoya in #3549
• Fix galvez_davison_index error: invalid index to scalar variable by @C2oWisComing in #3529

Other Changes

• Numpy 2 compatibility by @dopplershift in #3491
• Updated the README for Tutorials by @cfeliciano7792 in #3519
• Bump to numpy 2 by @dopplershift in #3606

New Contributors

• @anacmontoya made their first contribution in #3549
• @cfeliciano7792 made their first contribution in #3519

Full Changelog: v1.6.2...v1.6.3

Highlights

• Performance improvements for GEMPAK data reader
• Made coordinate detection more robust to work around issues with ERA5
• Added support for 'dBz' as an identified unit

What's Changed

Bugs Fixed 🐛

• Handle NEXRAD message 18 missing VCP info by @dopplershift in #3415
• Make coordinate detection more robust by @dopplershift in #3437
• angle_to_direction handle ndarray by @raybellwaves in #3448

Other Changes

• ENH: Add dBZ as a unit in the registry by @mgrover1 in #3343
• GEMPAK performance updates by @nawendt in #3431
• Note text-mode needed for METAR file-like objects by @dopplershift in #3451
• Fix checking dimensionless units in tests by @dopplershift in #3397
• Clean up GEMPAK Comparison Guide by @sgdecker in #3436
• Doc: wind examples by @raybellwaves in #3441

New Contributors

• @kandersolar made their first contribution in #3394

Full Changelog: v1.6.1...v1.6.2

Highlights

• Fixed regression in interpolate_to_slice being strict about units
• Fixed regression in PlotGeometry drawing color-filled regions

What's Changed

Bugs Fixed 🐛

• Fix interpolate_to_slice unit handling by @dopplershift in #3347
• Fix Plot Geometry Colorfills by @kgoebber in #3355

Full Changelog: v1.6.0...v1.6.1

Highlights

• Consistently use the WMO definition of relative humidity across calculations
• New calculations: wet bulb potential temperature, Corfidi MCS motion, DCAPE, and Galvez-Davidson Index
• Improvements for using isentropic interpolation with xarray data not natively on pressure surfaces (like WRF output)
• Support for specifying line stroke width in simplified plotting interface
• Support for controlling more style options for map layers in simplified plotting interface
• Support for rotated latitude longitude projection
• Support for Python 3.12
• Many bug fixes and clean ups

What's Changed

Breaking Changes 🛠

• Standardize RH calcs on WMO8 by @dcamron in #3242

New Features 🎉

• add downward cape by @wx4stg in #3120
• add corfidi MCS motion by @wx4stg in #3116
• Wet bulb potential temperature by @sec147 in #2952

Enhancements 😄

• Practical units for dry adiabatic lapse rate constant by @alexander-lakocy in #3118
• Add string formatting information to unit tutorial by @alexander-lakocy in #3119
• Update CCL/EL/LFC docstring to reflect that pressure should be monotonically decreasing by @Z-Richard in #3114
• Add rotated latitude longitude projection to mapping.py by @blaylockbk in #3123
• remove nans from bunkers input by @wx4stg in #3131
• Add mpl_args and PlotGeometry stroke_width by @kgoebber in #3183
• add more layer options for mappanel by @kgoebber in #3174
• Generalize testing version comparison by @dcamron in #3271
• DOC: Theme fixes, source links, and calendar by @dcamron in #3281
• Add heat_index calculation examples by @palewire in #3302
• return heat_index with temperature units by @rwalton91 in #3307
• Check for duplicate levels in isentropic_interpolation_as_dataset by @sgdecker in #3323
• Improve isentropic interpolation by @dopplershift in #3324

Bugs Fixed 🐛

• DOC: Add negative to equation in the advection docs by @dopplershift in #3153
• fix mlcape if parcel_start_pressure != bottom by @wx4stg in #3147
• METAR/Station Plot fixes by @dopplershift in #3297

Other Changes

• Bump the copyright year in the license file by @dopplershift in #3125
• Use xfail for test that doesn't fail on arm64. by @avalentino in #3150
• Add Complex Sounding Layout Example by @kylejgillett in #3161
• ENH: Move xdrlib inside metpy by @mgrover1 in #3117
• define dtype for station info lat-lon by @kgoebber in #3188
• extend declarative colorbar functionality by @kgoebber in #3181
• Create Advanced_Sounding_With_Complex_Layout.py by @kylejgillett in #3204
• Make tests pass on macOS M2 by @dopplershift in #3256
• MNT: Update link to ruff docs by @dopplershift in #3265
• Update state and county shapefiles by @dopplershift in #3293
• Cleanup warnings from tests by @dopplershift in #3255
• Provide alternate recipe to build docs by @sgdecker in #3330
• Update LI docs to reference and demonstrate mixed parcel usage by @dcamron in #3331
• Avoid pandas warning by @dopplershift in #3336

New Contributors

• @alexander-lakocy made their first contribution in #3118
• @blaylockbk made their first contribution in #3123
• @avalentino made their first contribution in #3150
• @wx4stg made their first contribution in #3131
• @kylejgillett made their first contribution in #3161
• @sec147 made their first contribution in #2952
• @palewire made their first contribution in #3302
• @rwalton91 made their first contribution in #3307

Full Changelog: v1.5.1...v1.6.0

Highlights

• el and lfc handle NaN values in passed in profiles
• Clarification of advection docs
• Fixed bug in (log_)interpolate_1d with mixed DataArray and numpy arrays
• Fixed orientation of StationaryFront to match WPC bulletins by default
• Fixed color-mapped hodograph to no longer require units on input

Bugs Fixed 🐛

• Adjust user-provided parcel temperature profile for NaN values in EL and LFC by @23ccozad in #3056
• A couple typo fixes in the first paragraph by @mcmxl22 in #3061
• Improve advection docstring by @Z-Richard in #3093
• Fix interpolation with mixed types by @dopplershift in #3103
• Fix fronts by @dopplershift in #3098
• Unit agnostic intervals for color-mapped hodographs by @23ccozad in #3054

New Contributors

• @mcmxl22 made their first contribution in #3061

Full Changelog: v1.5.0...v1.5.1

Highlights

• Drawing fronts and boundaries using Matplotlib path effects for appropriate meteorological styling (e.g. cold fronts)
• Drawing regions with a scalloped style
• Parser for WPC surface bulletins
• CAPE and CIN calculations now use the virtual temperature correction
• Revamped the list of pre-defined plotting areas for the simplified plotting interface
• "Dark mode" now available in the docs (thanks pydata-sphinx-theme!)
• Last release to support Python 3.8

New Features 🎉

• Fronts Plotting Support by @dopplershift in #2420
• Function for parsing WPC coded surface bulletins by @23ccozad in #1944
• Add scalloped path effect by @nawendt in #2992
• Additional path effects by @nawendt in #3003

Enhancements 😄

• A few doc fixes by @dopplershift in #2971
• unit redefinition help for /s by @kgoebber in #2994
• DOC: Add simple example plotting fronts using path effects by @dopplershift in #2997
• Using Virtual Temperature in CAPE/CIN calculations by @mgrover1 in #2437
• DOC: Simplify docstring example by @dopplershift in #3026
• Update areas by @kgoebber in #2949

Bugs Fixed 🐛

• BUG: Fix up some legacy NEXRAD level 2 parsing issues by @dopplershift in #2996
• Fix formatting of "Returns" from most_unstable_parcel by @dopplershift in #3009
• Improve GEMPAK "thinned GFS" files by @dopplershift in #3024
• Support floats in image_range by @wxmann in #3028
• BUG: Raise error in moist_lapse on solver fail by @dopplershift in #3025

Other Changes

• Add ruff instructions to contributor's guide by @dcamron in #2979
• Update METAR link to use production TDS by @dopplershift in #3018
• CI: Swap over to PyPI trusted publishing by @dopplershift in #3019
• Use weighted_continuous_average in bunkers_storm_motion by @dcamron in #2999

New Contributors

• @wxmann made their first contribution in #3028

Full Changelog: v1.4.1...v1.5.0

This is a bug fix release for 1.4.0.

Highlights

• Improved reading gridded Gempak files with multiple times assigned
• Added support for Matplotlib 3.7+ with improved unstable testing infrastructure
• Other doc fixes

Enhancements 😄

• Clarify density documentation by @sgdecker in #2899

Bugs Fixed 🐛

• Fix bug in GempakGrid by @nawendt in #2904
• Fixes for Matplotlib 3.7 by @dopplershift in #2927

Other Changes

• Add Miller 1972 pdf to docs by @dcamron in #2887

Full Changelog: v1.4.0...v1.4.1

Highlights

• Fully projection/spherical-aware spatial derivative calculations (e.g. vorticity, divergence)
• Added calculations for SWEAT index, Convective Condensation Level (CCL), and convective temperature
• ArrowPlot and RasterPlot added to the simplified plotting interface, as well as other enhancements to the simplified plotting interface
• Many more examples in docstrings and example gallery
• Improve integration with other libraries that use Pint for unit-handling
• Converted GINI support to work as a proper xarray backend

New Features 🎉

• add declarative layer attributes control by @kgoebber in #2425
• add accessor convert to base units by @kgoebber in #2422
• Adds ArrowPlot to declarative by @kgoebber in #2644
• Adding Raster Plot functionality by @nmartinez233 in #2587
• add left and right title option by @kgoebber in #2645
• add 2D calculation examples by @kgoebber in #2628
• Add SWEAT Index calculate function. by @C2oWisComing in #2580
• Implement convective condensation level (CCL) by @Z-Richard in #2550

Enhancements 😄

• Update media page by @dopplershift in #2428
• Improve the docs for Bunkers storm motion by @dopplershift in #2503
• Add docstring examples for thickness_hydrostatic by @Z-Richard in #2530
• DOCS: Add numerous calculation examples by @kgoebber in #2588
• DOCS: create .magnitude tutorial by @Z-Richard in #2655
• Add mean pressure weighted equation by @Daviology38 in #2144
• Add numerous sounding examples by @kgoebber in #2629
• Clarify meaning of bottom_up_search by @dopplershift in #2696
• Enable sphinx nitpicky by @zbruick in #1147
• Use Pint Application Registry by @dopplershift in #2272
• Update GINI Xarray support by @dopplershift in #2635
• Add axis labels to some sounding examples by @dopplershift in #2717
• Improve the docs for absolute_momentum by @dopplershift in #2735
• Add vertical_dim to several index calculations by @dopplershift in #2744
• DOC: Add links to BAMS article 🎉 by @dopplershift in #2771
• Change default SPECI parsing by @nawendt in #2819
• Derivatives & map factors by @dcamron in #2743

Bugs Fixed 🐛

• DOC: switch order of Parameters in specific_humidity_from_dewpoint by @raybellwaves in #2421
• fix isentropic example by @kgoebber in #2424
• Fix value mapper for NEXRAD DPR product by @dopplershift in #2442
• TEST: Collapse the NIDS tests together by @dopplershift in #2447
• adds RGB image ability to declarative by @kgoebber in #2469
• catch metar visibility with zero denominator by @akrherz in #2653
• Fix truncated text and decode SPCL obs by @nawendt in #2658
• DOC: Fix artifact in NEXRAD level 2 example by @dopplershift in #2668
• DOC: Correct mixed_layer_cape_cin example by @dopplershift in #2659
• Fix resolution of grids generated by interpolate by @dopplershift in #2674
• Add metadata to output of gdxarray by @sgdecker in #2691
• fix mixing lines keyword args bug by @AndrewLoeppky in #2326
• set default METAR year, month from UTC date by @akrherz in #2701
• Interpolate broadcasting by @dopplershift in #2728
• Improve default BarbPlot zorder by @dopplershift in #2752
• Fix ContourPlot default linestyle by @dopplershift in #2751
• Fix Natural Neighbor Verification example by @dopplershift in #2761
• Parse 1/16SM visibility in METARs by @dopplershift in #2808
• Ensure degree units by default for lat/lon in xarray by @dopplershift in #2852

Other Changes

• Fix linkcheck by @dopplershift in #2433
• MNT: Tweak Dependabot config by @dopplershift in #2477
• Fix image tests by @dopplershift in #2492
• Fix compatibility with future Pint by @dopplershift in #2496
• Update numpydoc link by @dcamron in #2501
• Remove "united" as meaning "having units" by @dopplershift in #2432
• Ignore EHP heat index reference in link check by @dcamron in #2528
• Add missing CF projection variable to test file by @dopplershift in #2531
• Code changes using azimuth_range_to_lat_lon by @nmartinez233 in #2538
• Update links to Xarray docs by @dopplershift in #2617
• Update link to THREDDS server by @dopplershift in #2623
• rebuild metar_parser with canopy 0.4.0 by @akrherz in #2654
• Fix inconsistent R_v and Cp_l unit definitions by @dcamron in #2656
• MNT: Update SkewXAxis for Matplotlib 3.6 by @dopplershift in #2667
• DOC: Improve some formatting issues in docstrings by @dopplershift in #2673
• Bump image test tolerance for osx-arm64 by @dcamron in #2688
• Update GEMPAK comparison guide by @dopplershift in #2689
• Point nonmult units link to pint stable by @dcamron in #2727
• Update reference and link for WMO#8 manual (Fixes #2737) by @dopplershift in #2738
• Update link for Pint temperature unit docs by @dopplershift in #2767
• DOC: Update link to WMO8 again by @dopplershift in #2781
• Bump image threshold by @dopplershift in #2805
• Conditionally define percent unit by @dopplershift in #2813
• MNT: Update link for TDS by @dopplershift in #2851

New Contributors

• @Z-Richard made their first contribution in #2530
• @nmartinez233 made their first contribution in #2538
• @AndrewLoeppky made their first contribution in #2326
• @Daviology38 made their first contribution in #2144

Full Changelog: v1.3.0...v1.4.0