1.0 Release Candidate 2

Version 1.0 (2020/10/08)

Second release candidate for our first stable release.

This log only mentions changes since RC1.

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.

Highlights

• 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.

Issues Closed

• Issue 1519 - Making grid arguments for divergence and vorticity keyword-only as forward-looking API change (PR 1521 by @jthielen)
• Issue 1518 - Clean-up cbook.py (PR 1520 by @dopplershift)
• Issue 1496 - surface_based_cape_cin fails with masked arrays (PR 1516 by @dopplershift)
• Issue 1474 - PlotObs specifies Int as option for level (PR 1524 by @dopplershift)
• Issue 1470 - Level2File() cannot open NEXRAD Level II chunk files available on AWS S3 (PR 1476 by @dopplershift)
• Issue 1455 - Use PyProj instead of CartoPy for calculations (PR 1483 by @jthielen)
• Issue 1446 - Remove Travis release uploading
• Issue 1442 - Replace pkg_resources (PR 1510 by @dopplershift)
• Issue 1407 - CartoPy required for master (PR 1454 by @dopplershift)
• Issue 1367 - Look at using from_bytes (PR 1476 by @dopplershift)
• Issue 1366 - NEXRAD Level3File errors out in str (PR 1476 by @dopplershift)
• Issue 1354 - How does cross_section recognize projections? (PR 1430 by @jthielen)
• Issue 1348 - Declarative Plotting: Plotting strings causes error (PR 1395 by @kgoebber)
• Issue 1343 - Support albers_conical_equal_area projection (PR 1344 by @rsignell-usgs)
• Issue 1327 - Change defaults for parse_metar_file (PR 1523 by @dcamron)
• Issue 1321 - Update setuptools-scm config (PR 1510 by @dopplershift)
• Issue 1318 - Fix up coverage (PR 1517 by @dopplershift)
• Issue 1300 - API for Dataset Helpers in 1.0 (PR 1303 by @jthielen)
• Issue 1201 - Error: Distribution not found (PR 1510 by @dopplershift)
• Issue 877 - Can't open level II files: ValueError: year XXXXX is out of range (PR 1476 by @dopplershift)
• Issue 845 - Test import with basic install (PR 1454 by @dopplershift)
• Issue 10 - Add standard data object (PR 1490 by @jthielen)

In this release 22 issues were closed.

Pull Requests Merged

• PR 1527 - Update target for v1 since it didn't happen in 2019..., by @MinchinWeb
• PR 1526 - Update copyright year to include 2020, by @MinchinWeb
• PR 1524 - Fixing handling of level in PlotObs, by @dopplershift (1474)
• PR 1523 - Update metar.py default year, month to keyword-only and None, by @dcamron (1327)
• PR 1521 - Make grid args for divergence and vorticity keyword-only, by @jthielen (1519)
• PR 1520 - Cleanup cbook, by @dopplershift (1518)
• PR 1517 - Fix test coverage reporting, by @dopplershift (1318)
• PR 1516 - BUG: Fix passing masked arrays to CAPE/CIN calcs, by @dopplershift (1496)
• PR 1510 - Remove uses of pkg_resources, by @dopplershift (1442, 1321, 1201)
• PR 1490 - Improved xarray compatibility on function input and output, by @jthielen (896, 1464, 10)
• PR 1483 - Use PyProj instead of Cartopy for internal coordinate transforms and rename crs coordinate, by @jthielen (1455)
• PR 1476 - IO Updates, by @dopplershift (877, 1470, 1367, 1366)
• PR 1473 - Modernize for Python 3 a bit more, by @dopplershift
• PR 1454 - Improve testing framework and infrastructure, by @dopplershift (845, 1407)
• PR 1441 - Replace use of Dataset.apply and .drop to clear PendingDeprecationWarnings, by @jthielen
• PR 1434 - Test maintenance, by @dopplershift (832)
• PR 1431 - Fix quantified/units-on-attribute mixtures in tests and derivative calculations for xarray 0.16.0, by @jthielen (1419)
• PR 1430 - Xarray accessor updates to remove automatic quantification and in-place operations, by @jthielen (1354)
• PR 1415 - MNT:(deps): Bump sphinx from 2.4.4 to 3.1.2 in /ci, by @dependabot[bot]
• PR 1396 - Improved data and colormap scaling for Level3File example., by @dlaw
• PR 1395 - Adds text plotting to declarative, by @kgoebber (1348)
• PR 1391 - MNT: Docs update GEMPAK conversion, by @kgoebber
• PR 1381 - Update saturation_mixing_ratio docstring, by @rpmanser
• PR 1365 - Latlon from azran, by @kgoebber
• PR 1363 - Calculation of Lifted Index, by @eliteuser26 (632)
• PR 1346 - Added function to calculate richardson number., by @joernu76
• PR 1344 - added albers_conical_equal_area projection, by @rsignell-usgs (1343)
• PR 1331 - Adds a scale attribute for declarative syntax, by @kgoebber (1248)
• PR 1329 - Convert obs units, by @kgoebber
• PR 1326 - Update docs, by @dopplershift
• PR 1325 - Switching to Quantity-in-DataArray/NEP 18 Support over DataArray-with-units-attribute, by @jthielen
• PR 1314 - Add declarative attribute plot_units, by @kgoebber
• PR 1310 - Fix MetPyDatasetAccessor error in assign_latitude_longitude(), by @DanielAdriaansen
• PR 1309 - Maintenance, by @dopplershift

In this release 34 pull requests were closed.