Metpy

Our first stable release!

API Changes
* 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
* Better support for taking in xarray `DataArray`s
* 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

Issues Closed
* [Issue 1297](https://github.com/Unidata/MetPy/issues/1297) - Misleading Documentation for PanelContainer() ([PR 1301](https://github.com/Unidata/MetPy/pull/1301))
* [Issue 1295](https://github.com/Unidata/MetPy/issues/1295) - Declarative notes ([PR 1298](https://github.com/Unidata/MetPy/pull/1298))
* [Issue 1287](https://github.com/Unidata/MetPy/issues/1287) - The great dim_order removal ([PR 1302](https://github.com/Unidata/MetPy/pull/1302))
* [Issue 1283](https://github.com/Unidata/MetPy/issues/1283) - Issues with XArray master ([PR 1285](https://github.com/Unidata/MetPy/pull/1285))
* [Issue 1277](https://github.com/Unidata/MetPy/issues/1277) - Declarative Colorbar Docs Incorrect ([PR 1280](https://github.com/Unidata/MetPy/pull/1280))
* [Issue 1276](https://github.com/Unidata/MetPy/issues/1276) - Doc Navigation Naming ([PR 1294](https://github.com/Unidata/MetPy/pull/1294))
* [Issue 1274](https://github.com/Unidata/MetPy/issues/1274) - Unable to change color of wind barbs ([PR 1294](https://github.com/Unidata/MetPy/pull/1294))
* [Issue 1271](https://github.com/Unidata/MetPy/issues/1271) - Image tests failing with Pint 0.10 ([PR 1282](https://github.com/Unidata/MetPy/pull/1282))
* [Issue 1269](https://github.com/Unidata/MetPy/issues/1269) - Fix up build against xarray/pint master
* [Issue 1268](https://github.com/Unidata/MetPy/issues/1268) - Update link for heat index docs ([PR 1294](https://github.com/Unidata/MetPy/pull/1294))
* [Issue 1249](https://github.com/Unidata/MetPy/issues/1249) - Documentation for axes in gradient calc ([PR 1260](https://github.com/Unidata/MetPy/pull/1260))
* [Issue 1220](https://github.com/Unidata/MetPy/issues/1220) - LFC calculation
* [Issue 1134](https://github.com/Unidata/MetPy/issues/1134) - Parse CF/UDUNITS-style powers of units ([PR 1281](https://github.com/Unidata/MetPy/pull/1281))
* [Issue 1127](https://github.com/Unidata/MetPy/issues/1127) - Removals/Deprecations in 1.0 ([PR 1286](https://github.com/Unidata/MetPy/pull/1286))
* [Issue 1113](https://github.com/Unidata/MetPy/issues/1113) - Naming consistency ([PR 1299](https://github.com/Unidata/MetPy/pull/1299))
* [Issue 1112](https://github.com/Unidata/MetPy/issues/1112) - ageostrophic_wind call signature ([PR 1286](https://github.com/Unidata/MetPy/pull/1286))
* [Issue 983](https://github.com/Unidata/MetPy/issues/983) - Masked arrays break units
* [Issue 861](https://github.com/Unidata/MetPy/issues/861) - Add limiting to shade CAPE/CIN ([PR 1139](https://github.com/Unidata/MetPy/pull/1139))

In this release 18 issues were closed.

Pull Requests Merged

* [1303](https://github.com/Unidata/MetPy/pull/1303) - Implement basic coordinate/CRS/attribute dataset helpers
* [PR 1302](https://github.com/Unidata/MetPy/pull/1302) - Remove dim_order ([1287](https://github.com/Unidata/MetPy/issues/1287))
* [PR 1301](https://github.com/Unidata/MetPy/pull/1301) - Clarify documentation on layers traits ([1297](https://github.com/Unidata/MetPy/issues/1297))
* [PR 1299](https://github.com/Unidata/MetPy/pull/1299) - Renames ([1113](https://github.com/Unidata/MetPy/issues/1113))
* [PR 1298](https://github.com/Unidata/MetPy/pull/1298) - Declarative fixes ([1295](https://github.com/Unidata/MetPy/issues/1295))
* [PR 1294](https://github.com/Unidata/MetPy/pull/1294) - Misc small items ([1276](https://github.com/Unidata/MetPy/issues/1276), [1274](https://github.com/Unidata/MetPy/issues/1274), [1268](https://github.com/Unidata/MetPy/issues/1268))
* [PR 1286](https://github.com/Unidata/MetPy/pull/1286) - Removals of all deprecated stuff ([1127](https://github.com/Unidata/MetPy/issues/1127), [1112](https://github.com/Unidata/MetPy/issues/1112))
* [PR 1285](https://github.com/Unidata/MetPy/pull/1285) - Refactor parse_cf to not modify coordinates inplace ([1283](https://github.com/Unidata/MetPy/issues/1283))
* [PR 1282](https://github.com/Unidata/MetPy/pull/1282) - More pint fixes ([1271](https://github.com/Unidata/MetPy/issues/1271))
* [PR 1281](https://github.com/Unidata/MetPy/pull/1281) - Add percent sign and UDUNITS exponent syntax support via Pint's new preprocessor option ([1134](https://github.com/Unidata/MetPy/issues/1134))
* [PR 1280](https://github.com/Unidata/MetPy/pull/1280) - Fix the documentation around the declarative colorbar ([1277](https://github.com/Unidata/MetPy/issues/1277))
* [PR 1273](https://github.com/Unidata/MetPy/pull/1273) - adds function to lookup and add station lat/lon to dataframe
* [PR 1272](https://github.com/Unidata/MetPy/pull/1272) - fixes read of metar file with bad encoding
* [PR 1267](https://github.com/Unidata/MetPy/pull/1267) - adds functionality to obs declarative
* [PR 1264](https://github.com/Unidata/MetPy/pull/1264) - Add station plot locations
* [PR 1260](https://github.com/Unidata/MetPy/pull/1260) - Refactor xarray grid deltas calculation to handle axis order flexibly ([912](https://github.com/Unidata/MetPy/issues/912), [1249](https://github.com/Unidata/MetPy/issues/1249), [1249](https://github.com/Unidata/MetPy/issues/1249))
* [PR 1223](https://github.com/Unidata/MetPy/pull/1223) - Add arbitrary window smoother and refactor existing smoothers ([665](https://github.com/Unidata/MetPy/issues/665))
* [PR 1139](https://github.com/Unidata/MetPy/pull/1139) - Limit shading of CIN ([861](https://github.com/Unidata/MetPy/issues/861))

In this release 17 pull requests were closed.

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 `DataArray`s
* 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](https://.github.com/Unidata/MetPy/issues/1603) - precipitable_water with xarray objects throws dimension error in rc2
* [Issue 1594](https://github.com/Unidata/MetPy/issues/1594) - Citing MetPy in AMS v5.0 latex template
* [Issue 1590](https://github.com/Unidata/MetPy/issues/1590) - Contour interpolation problem
* [Issue 1588](https://github.com/Unidata/MetPy/issues/1588) - Declarative figure size only takes ints
* [Issue 1574](https://github.com/Unidata/MetPy/issues/1574) - Declarative Plotting Error with Unit Conversion and Format Function
* [Issue 1567](https://github.com/Unidata/MetPy/issues/1567) - DOC: startingguide doesn't run
* [Issue 1550](https://github.com/Unidata/MetPy/issues/1550) - Crashing with CartoPy 0.14.1
* [Issue 1548](https://github.com/Unidata/MetPy/issues/1548) - RC2 advection calculation does not get coordinate data from DataArray

In this release 8 issues were closed.

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

In this release 22 pull requests were closed.

Highlights
* Fix compatibility with CartoPy 0.18
* Fix compatibility with matplotlib 3.3
* Fixed problems using masked arrays in `wind_direction`, `equivalent_potential_temperature`, and `saturation_equivalent_potential_temperature`

Contributors
jthielen, kgoebber, LProx2020, rpmanser, and dopplershift contributed code to this release.

Issues Closed

* [Issue 1427](https://github.com/Unidata/MetPy/issues/1427) - Link to Smithsonian Meteorological Tables broken ([PR 1443](https://github.com/Unidata/MetPy/pull/1443) by [dopplershift](https://github.com/dopplershift))
* [Issue 1390](https://github.com/Unidata/MetPy/issues/1390) - Masked arrays break `wind_direction` function ([PR 1401](https://github.com/Unidata/MetPy/pull/1401) by [rpmanser](https://github.com/rpmanser))
* [Issue 1377](https://github.com/Unidata/MetPy/issues/1377) - Say Thanks link broken ([PR 1394](https://github.com/Unidata/MetPy/pull/1394) by [LProx2020](https://github.com/LProx2020))
* [Issue 1368](https://github.com/Unidata/MetPy/issues/1368) - Cartopy 0.18.0 USCOUNTIES '20m' invalid
* [Issue 1364](https://github.com/Unidata/MetPy/issues/1364) - Issue with mpcalc.equivalent_potential_temperature ([PR 1426](https://github.com/Unidata/MetPy/pull/1426) by [jthielen](https://github.com/jthielen))

In this release 5 issues were closed.

Pull Requests Merged

* [PR 1444](https://github.com/Unidata/MetPy/pull/1444) - 0.12 Backports, by [dopplershift](https://github.com/dopplershift)
* [PR 1443](https://github.com/Unidata/MetPy/pull/1443) - Fix formatting of link in references, by [dopplershift](https://github.com/dopplershift) ([1427](https://github.com/Unidata/MetPy/issues/1427))
* [PR 1431](https://github.com/Unidata/MetPy/pull/1431) - Fix quantified/units-on-attribute mixtures in tests and derivative calculations for xarray 0.16.0, by [jthielen](https://github.com/jthielen) ([1419](https://github.com/Unidata/MetPy/issues/1419))
* [PR 1426](https://github.com/Unidata/MetPy/pull/1426) - Fix masked array issue in equivalent potential temperature, by [jthielen](https://github.com/jthielen) ([1364](https://github.com/Unidata/MetPy/issues/1364))
* [PR 1425](https://github.com/Unidata/MetPy/pull/1425) - Fix _check_argument_units for pint __eq__ returning duck array, by [jthielen](https://github.com/jthielen)
* [PR 1416](https://github.com/Unidata/MetPy/pull/1416) - MNT:(deps): Bump cartopy from 0.17.0 to 0.18.0 in /ci, by [dependabot[bot]](https://github.com/apps/dependabot)
* [PR 1411](https://github.com/Unidata/MetPy/pull/1411) - MNT:(deps): Bump matplotlib from 3.2.1 to 3.3.0 in /ci, by [dependabot[bot]](https://github.com/apps/dependabot)
* [PR 1401](https://github.com/Unidata/MetPy/pull/1401) - Fix masked arrays breaking wind_direction #1390, by [rpmanser](https://github.com/rpmanser) ([1390](https://github.com/Unidata/MetPy/issues/1390))
* [PR 1394](https://github.com/Unidata/MetPy/pull/1394) - Removing 'Say Thanks' Link (#1377), by [LProx2020](https://github.com/LProx2020) ([1377](https://github.com/Unidata/MetPy/issues/1377))

In this release 9 pull requests were closed.