1.0.0

Our first stable API release. Crux of it will be eliminating all deprecated functionality (like dim_order), ironing out the XArray/units integration, and making sure function calls are something we're willing to support for a few years.

API Changes

• dx/dy and dim_x/dim_y arguments divergence and vorticity are now only passable as keyword arguments
• Can no longer set values in a DataArray using the unit_array accessor attribute
• When DataArray instances are passed as inputs, the returned values are almost always also DataArray instances rather than Pint Quantity instances.
• lat_lon_grid_deltas now takes a pyproj.Geod instance directly rather than keyword arguments for constructing one.
• Removed dim_order argument--all functions either rely on DataArray metadata or assume data have trailing dimensions as y, x
• Remove previously deprecated items
  • bounds argument to plot_colormapped
  • tmpk_out argument to isentropic_interpolation
  • dewpoint_rh
  • Viridis colortable
• Rename many function arguments to be consistent and clear (e.g. potential_temperature instead of thta)
• Re-order function arguments to (pressure, temperature, moisture) to be consistent with rest of library:
  • relative_humidity_wet_psychrometric
  • psychrometric_vapor_pressure_wet
  • mixing_ratio_from_relative_humidity
  • relative_humidity_from_mixing_ratio
  • relative_humidity_from_specific_humidity
  • dewpoint_from_specific_humidity
  • specific_humidity_from_dewpoint
• Update signatures for ageostrophic_wind, precipitable_water, and storm_relative_helicity (as warned previously)

Highlights

• New documentation layout and theme
• Add 1.0 upgrade guide
• Update constant values from more robust sources
• Better support for taking in xarray DataArrays
• Add capability to limit shading of CIN on SkewT
• Function to add longitude/latitude to Pandas DataFrame
• Support for % as a unit abbreviation in a string
• Support for changing barb size on station plots in simplified plotting interface
• Fixed up declarative interface docs
• Support for returning xarray DataArrays instances from calculations when the inputs are also DataArray instances
• Support for inputs where Pint Quantity instances are stored within DataArray instances
• Fixes errors when passing masked arrays to various CAPE calculations
• Support for Albers Equal Area projection
• Many fixes updates for NEXRAD format support, including direct reading of file objects from the NEXRAD S3 archive (from e.g. boto3) and using pathlib.Path instances, as well as some updates for NEXRAD ORPG Build 19.0 changes.
• Improve default date handling in parse_metar_file
• PyProj >= 2.3 is now a required dependency for calculations, and CartoPy is only needed for related plotting capabilities.
• PlotObs.level now defaults to None, or no subsetting.
• Using standard library modules importlib.resources and importlib.metadata (and their backports) rather than pkg_resources from setuptools. This fixes errors getting MetPy's version from unconventional installs.

Contributors

@dcamron, @dopplershift, @jthielen, @DanielAdriaansen, @kgoebber, @gewitterblitz, @marcinkawka, @raybellwaves, @MinchinWeb contributed code to this release.

Issues Closed

• Issue 1603 - precipitable_water with xarray objects throws dimension error in rc2
• Issue 1594 - Citing MetPy in AMS v5.0 latex template
• Issue 1590 - Contour interpolation problem
• Issue 1588 - Declarative figure size only takes ints
• Issue 1574 - Declarative Plotting Error with Unit Conversion and Format Function
• Issue 1567 - DOC: startingguide doesn't run
• Issue 1550 - Crashing with CartoPy 0.14.1
• Issue 1548 - RC2 advection calculation does not get coordinate data from DataArray

In this release 8 issues were closed.

Pull Requests Merged

• PR 1627 - Standardize constant and thermophysical properties, by @dcamron
• PR 1625 - DataArray Fixes, by @dopplershift
• PR 1618 - Finish off upgrade guide, by @dopplershift
• PR 1617 - Enable flake8 simplify, by @dopplershift
• PR 1614 - Improve the citation information , by @dopplershift
• PR 1612 - Handle changed functions in check_units decorator, by @dopplershift
• PR 1605 - Redo xarray with MetPy tutorial for 1.0, by @jthielen
• PR 1598 - New Automation, by @dopplershift
• PR 1595 - fixes plotting error in declarative with hires data, by @kgoebber
• PR 1592 - take float or int for figsize in declarative, by @kgoebber
• PR 1585 - Windows development fixes, by @dopplershift
• PR 1580 - Fix get_layer for float32 data again, by @dopplershift
• PR 1579 - Fixes and improvements for wet_bulb_temperature, by @dopplershift
• PR 1578 - BUG: Fix for xarray master, by @dopplershift
• PR 1577 - Make CartoPy import more robust, by @dopplershift
• PR 1576 - Fix PlotObs with units + formatter, by @dopplershift
• PR 1575 - Fix xarray support in advection, by @dopplershift
• PR 1573 - Python 3.9 support, by @dopplershift
• PR 1569 - declarative tutorial, by @kgoebber
• PR 1568 - replace data with ds, by @raybellwaves
• PR 1554 - MNT: Refactor montgomery_streamfunction, by @dopplershift
• PR 1527 - Update target for v1 since it didn't happen in 2019..., by @MinchinWeb

In this release 22 pull requests were closed.