v1.2.1

Summary:
Adds more statistical programs, generic mapping programs, and a prototype geostrophic current program. Refactors path operations to use pathlib. Updates with the retirement of PO.DAAC Drive.

Itemized Changes:

• feat: add global dealiasing uplift program (#113)
• feat: debug-level logging of member names and header lines (#113)
• feat: add extend_matrix function (#113)
• feat: add wrap_longitudes to tools (#113)
• feat: add mapping programs from Sutterley et al. 2019 and 2020 (#114)
• feat: include option to not compensate for elastic deformation for #37 (#115)
• feat: added regex formatting for CNES GRGS harmonics (#115)
• feat: added functions for getting unit attributes for known types (#116)
• feat: add initial geostrophic current program (#117)
• feat: add angular velocity of the Earth to units (#117)
• feat: add solver option to geocenter and mascon programs (#118)
• feat: allow option 0 in combine_harmonics.py for no unit conversion (#118)
• feat: add piecewise regression program (#120)
• feat: add additional fit term options to regression programs (#120)
• feat: split S2 tidal aliasing terms into GRACE and GRACE-FO eras (#121)
• feat: add reify decorator for evaluation of properties (#121)
• feat: split S2 tidal aliasing terms into GRACE and GRACE-FO eras in more programs (#123)
• feat: add functions to retrieve and revoke Earthdata tokens (#125)
• feat: more operatations on spatial error if in possible data keys (#125)
• feat: can choose different tidal aliasing periods (#132)
• feat: add timescale class for converting between time scales (#133)
• feat: add functions for retrieving leap seconds from NIST or IERF servers
• refactor: use formatting for reading from date file (#121)
• refactor: use pathlib to define and operate on paths (#123)
• refactor: in monthly dealiasing, read data into flattened harmonics objects (#113)
• refactor: convert shape and ndim to harmonics and spatial class properties (#113)
• refactor: updated inputs to spatial from_ascii function (#113)
• refactor: merge regional plot programs into single program (#114)
• refactor: add descriptive file-level attributes to output netCDF4/HDF5 files (#115)
• refactor: use fit module for getting tidal aliasing terms (#125)
• refactor: modified custom units in spherical caps and disc loads (#129)
• fix: scale and dimensions (#113)
• fix: spatial extend_matrix (#113)
• fix: output file append in regress_grace_maps.py (#114)
• fix: place cmap set in try/except (#114)
• fix: set case_insensitive_filename to None if filename is empty (#117)
• fix: remove_label in tools.py (#118)
• fix: frame in geostrophic currents notebook (#118)
• fix: allow love numbers to be None for custom units case (#119)
• fix: headers in plot script documentation (#119)
• fix: PO.DAAC now has different openers for s3 and data endpoints (#120)
• fix: add podaac cumulus test and skip drive (#120)
• fix: bump GFZ GravIS files to Release-03 (#120)
• fix: remove deprecated PO.DAAC Drive sync programs (#123)
• fix: append amplitude and phase titles when creating flags (#127)
• fix: GRACE/GRACE-FO months in drift function for #131 (#132)
• docs: add documentation for graphing programs (#114)
• docs: improve typing for variables in docstrings (#116)
• docs: add notes about Shida numbers (#119)
• docs: remove binder links 😢 (#120)
• docs: remove references to deprecated sync programs (#123)
• docs: scrub PO.DAAC Drive and WebDAV (#126)

Full Changelog: 1.2.0...1.2.1

v1.2.0

First release under the new gravity-toolkit repository name 🎉

Summary: Provides additional Load Love numbers for estimating the elastic responses to surface load changes. Generalization of HDF5 and netCDF4 io functions for more variables and attributes. Updates for calculating and working with GRACE/GRACE-FO scaling factors (Landerer and Swenson, 2012). Fixes to harmonics and units classes for operating on the degree-0 and single degree cases.

• refactor: new repo name (#99)
• refactor: simplified unit factors in spherical caps and disc loads (#111)
• refactor: remove deprecated functions (#112)
• feat: added function to retrieve named units (#102)
• feat: added wrapper function for smoothing and converting to output units (#102)
• feat: add PREM hard and soft sediment love numbers (#104)
• feat: data class for load love numbers with attributes for model (#105)
• feat: customizable file-level attributes to netCDF4 and HDF5 (#106)
• feat: add root attributes to output netCDF4 and HDF5 files (#107)
• feat: add indexing of filenames to object iterators (#109)
• feat: new scaling_factors inheritance of spatial class (#110)
• fix: only attempt to squeeze from final dimension in harmonics objects (#108)
• fix: case insensitive searching for HDF5 and netCDF4 GIA attributes (#111)
• fix: verify warnings have type and filtered after (#101)
• fix: set custom units as top option in if/else statements (#102)
• fix: expand harmonics case where data is a single degree (#103)
• fix: harmonics case where maximum spherical harmonic degree is 0 (#103)
• fix: units case where maximum spherical harmonic degree is 0 (#103)
• fix: load love number case with maximum spherical harmonic degree is 0 (#103)
• docs: update docstrings (#100)
• docs: slimmer builds by placing imports within try/except (#111)
• test: add test for getting units (#102)

Full Changelog: 1.1.0...1.2.0

v1.1.0

Some major refactoring of the code base to update syntax and structure
For now, the code should be the backwards compatible with deprecation warnings

• feat: adding CMR queries for TN files (#89)
• feat: add git utilities for managing repositories (#93)
• feat: add netCDF4/HDF5 source attribute to harmonics and spatial classes (#93)
• feat: can iterate over harmonics, spatial and geocenter objects (#97)
• fix: expose GSFC SLR 5x5 url as option in download (#91)
• fix: set default GIA parameters, title, reference and url as None (#97)
• refactor: use f-strings for formatting verbose or ascii output (#89)
• refactor: camel_case updates for #90 (#91)
• refactor: comment format to try to match flake8 styling for #90 (#92)
• refactor: implicit import as gravtk (#93)
• refactor: use attributes kwards for output to nc/hdf5 (#93)
• refactor: SLR, plm and time series functions (#98)
• docs: use sphinx-argparse v0.4.0 with exec search (#89)
• docs: slimmer build to prevent overutilization of resources (#95)
• docs: remove '.py' from function titles (#96)
• test: add test for comparing GIA reads (#93)
• test: single implicit import of gravity_toolkit (#98)

Full Changelog: 1.0.2.7...1.1.0

v1.0.2.7

Bug fixes and new features for running Versions 0 and 1 of RL06

• feat: add program for overwriting the GRACE/GRACE-FO index
• feat: Dynamically select newest version of granules for index
• feat: add GSFC SLR 5x5 download function
• feat: add option to replace degree 4 zonal harmonics with SLR
• feat: added more time parsing for longer periods
• docs: updated structure of documentation
• fix: expand mask variable within if statement
• fix: place ipython and tkinter imports within try/except
• fix: remove cartopy for slimmer build
• fix: create mask for output gridded variables
• fix: version check for mission in GFZ ftp sync

v1.0.2.6

Working release for submitting to pypi

• Updated documentation using autodoc
• Add initial versions of geocenter calculation program

1.0.2.5

Working release for obtaining and working with Level-2 Gravity Recovery and Climate Experiment (GRACE) and GRACE Follow-On spherical harmonic data in Python. Release corresponding with submission to the third Ice Sheet Mass Balance Intercomparison Exercise (IMBIE3).

1.0.2.4

Working release for obtaining and working with Level-2 Gravity Recovery and Climate Experiment (GRACE) and GRACE Follow-On spherical harmonic data in Python. Release corresponding with presentations at the 2021 American Geophysical Union Fall Meeting.

1.0.2.0

Working release for obtaining and working with Level-2 Gravity Recovery and Climate Experiment (GRACE) and GRACE Follow-On spherical harmonic data in Python. Release corresponding with the publication of the Mohajerani et al. paper "Automated Dynamic Mascon Generation for GRACE and GRACE-FO Harmonic Processing" in Remote Sensing.

v1.0.1.0

Working release for obtaining and working with Level-2 Gravity Recovery and Climate Experiment (GRACE) and GRACE Follow-On spherical harmonic data in Python. Release corresponding with the publication of the Velicogna et al. paper "Continuity of ice sheet mass loss in Greenland and Antarctica from the GRACE and GRACE Follow‐On missions" in Geophysical Research Letters

v1.0.0.7

Working release for reading Gravity Recovery and Climate Experiment (GRACE) and GRACE Follow-On Level-2 spherical harmonic data in Python. Release corresponding with the acceptance of the Earth and Space Science paper "Self-Consistent Ice Mass Balance and Regional Sea Level from Time-Variable Gravity"