Gravity-toolkit

**Summary**:
Adds more statistical programs, generic mapping programs, and a prototype [geostrophic current program](https://doi.org/10.1029/2001JC001274). Refactors path operations to use `pathlib`. Updates with the [retirement of PO.DAAC Drive](https://podaac-tools.jpl.nasa.gov/legacy_retirement.html).

**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](https://www.mdpi.com/2072-4292/11/18/2108) and [2020](https://doi.org/10.1029/2019EA000860) (#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 :cry: (120)
* docs: remove references to deprecated sync programs (123)
* docs: scrub PO.DAAC Drive and WebDAV (126)

**Full Changelog**: https://github.com/tsutterley/gravity-toolkit/compare/1.2.0...1.2.1

First release under the new `gravity-toolkit` repository name :tada:

**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](https://doi.org/10.1029/2011WR011453)). 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**: https://github.com/tsutterley/gravity-toolkit/compare/1.1.0...1.2.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**: https://github.com/tsutterley/read-GRACE-harmonics/compare/1.0.2.7...1.1.0

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

- [feat: add program for overwriting the GRACE/GRACE-FO index](https://github.com/tsutterley/read-GRACE-harmonics/commit/a1b87a6c220d7a4c5e59eaba59c881455bdfe3d2)
- [feat: Dynamically select newest version of granules for index](https://github.com/tsutterley/read-GRACE-harmonics/commit/2e5bbc95e566b8647925156c958bd73c7bdda73d)
- [feat: add GSFC SLR 5x5 download function](https://github.com/tsutterley/read-GRACE-harmonics/commit/9af1869d32b4c1a0e05984e5f8d418d08399cec6)
- [feat: add option to replace degree 4 zonal harmonics with SLR](https://github.com/tsutterley/read-GRACE-harmonics/commit/a1dada687251ea8b14faa0c3dc941a236ddb0ce7)
- [feat: added more time parsing for longer periods](https://github.com/tsutterley/read-GRACE-harmonics/commit/ea193ec9c6f68886f52a7c96f9eea6b5b7c3c085)
- [docs: updated structure of documentation](https://github.com/tsutterley/read-GRACE-harmonics/commit/f3dd2bf917d6f59bbf1cf98123a5d13d014fc15f)
- [fix: expand mask variable within if statement](https://github.com/tsutterley/read-GRACE-harmonics/commit/fa42c435c1f586edc8f4aea139a9c1d65635fb6a)
- [fix: place ipython and tkinter imports within try/except](https://github.com/tsutterley/read-GRACE-harmonics/commit/f13f18640269aef8cdc0affe0baff919e66bac4b)
- [fix: remove cartopy for slimmer build](https://github.com/tsutterley/read-GRACE-harmonics/commit/065b191299e1e2ab5f666a61dc1f0eb54c1ca8bd)
- [fix: create mask for output gridded variables](https://github.com/tsutterley/read-GRACE-harmonics/commit/2ccb3d8dc8ae643c80c2df0317d4d17cc20ae4eb)
- [fix: version check for mission in GFZ ftp sync](https://github.com/tsutterley/read-GRACE-harmonics/commit/39b8701594a18910bdaf3f261cd0356f39f8032e)

Working release for submitting to pypi

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

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