tsutterley · hulecom · Nov 18, 2020 · Nov 26, 2020 · Nov 27, 2020 · Dec 1, 2020
diff --git a/.binder/environment.yml b/.binder/environment.yml
diff --git a/.dockerignore b/.dockerignore
diff --git a/.gitattributes b/.gitattributes
diff --git a/.github/workflows/auto-update-files.yml b/.github/workflows/auto-update-files.yml
diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml
diff --git a/.github/workflows/python-request.yml b/.github/workflows/python-request.yml
diff --git a/.gitignore b/.gitignore
@@ -86,6 +86,9 @@ None*.png
 #######################
 .ipynb_checkpoints
 Untitled.ipynb
+# Personal notebooks #
+########################
+/notebooks/
 # Large data files #
 ####################
 *-complete.dat
diff --git a/CONTRIBUTORS.rst b/CONTRIBUTORS.rst
diff --git a/Dockerfile b/Dockerfile
diff --git a/LICENSE b/LICENSE
diff --git a/MANIFEST.in b/MANIFEST.in
diff --git a/README.rst b/README.rst
@@ -1,6 +1,6 @@
-===============
-gravity-toolkit
-===============
+====================
+read-GRACE-harmonics
+====================
 
 |Language|
 |License|
@@ -25,6 +25,9 @@ gravity-toolkit
 
 Python tools for obtaining and working with Level-2 spherical harmonic coefficients from the NASA/DLR Gravity Recovery and Climate Experiment (GRACE) and the NASA/GFZ Gravity Recovery and Climate Experiment Follow-On (GRACE-FO) missions
 
+This repository is **forked** from the original one created by Tyler Sutterley. It contains additions made by Hugo Lecomte, especially for plotting purpose on harmonics and spatial objects. The additions have been developed as part of my PhD work at ITES.
+I specially thank Tyler for this tool and I am glad to have been able to contribute to it.
+
 Resources
 #########
 
@@ -90,10 +93,8 @@ Data Repositories
 Download
 ########
 
-| The program homepage is:
-| https://github.com/tsutterley/gravity-toolkit
-| A zip archive of the latest version is available directly at:
-| https://github.com/tsutterley/gravity-toolkit/archive/main.zip
+| The original program homepage is:
+| https://github.com/tsutterley/read-GRACE-harmonics
 
 Disclaimer
 ##########

diff --git a/doc/Makefile b/doc/Makefile
diff --git a/doc/environment.yml b/doc/environment.yml
diff --git a/doc/make.bat b/doc/make.bat
diff --git a/doc/source/_assets/geoid_height.svg b/doc/source/_assets/geoid_height.svg
diff --git a/doc/source/_static/style.css b/doc/source/_static/style.css
diff --git a/doc/source/_templates/layout.html b/doc/source/_templates/layout.html
diff --git a/doc/source/api_reference/SLR/C20.rst b/doc/source/api_reference/SLR/C20.rst
diff --git a/doc/source/api_reference/SLR/C30.rst b/doc/source/api_reference/SLR/C30.rst
diff --git a/doc/source/api_reference/SLR/C40.rst b/doc/source/api_reference/SLR/C40.rst
diff --git a/doc/source/api_reference/SLR/C50.rst b/doc/source/api_reference/SLR/C50.rst
diff --git a/doc/source/api_reference/SLR/CS2.rst b/doc/source/api_reference/SLR/CS2.rst
diff --git a/doc/source/api_reference/aod1b_geocenter.rst b/doc/source/api_reference/aod1b_geocenter.rst
@@ -18,7 +18,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: aod1b_geocenter.py
+    :filename: ../scripts/aod1b_geocenter.py
     :func: arguments
     :prog: aod1b_geocenter.py
     :nodescription:

diff --git a/doc/source/api_reference/aod1b_oblateness.rst b/doc/source/api_reference/aod1b_oblateness.rst
@@ -18,7 +18,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: aod1b_oblateness.py
+    :filename: ../scripts/aod1b_oblateness.py
     :func: arguments
     :prog: aod1b_oblateness.py
     :nodescription:

diff --git a/doc/source/api_reference/associated_legendre.rst b/doc/source/api_reference/associated_legendre.rst
diff --git a/doc/source/api_reference/calc_degree_one.rst b/doc/source/api_reference/calc_degree_one.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: calc_degree_one.py
+    :filename: ../scripts/calc_degree_one.py
     :func: arguments
     :prog: calc_degree_one.py
     :nodescription:

diff --git a/doc/source/api_reference/calc_harmonic_resolution.rst b/doc/source/api_reference/calc_harmonic_resolution.rst
@@ -14,7 +14,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: calc_harmonic_resolution.py
+    :filename: ../scripts/calc_harmonic_resolution.py
     :func: arguments
     :prog: calc_harmonic_resolution.py
     :nodescription:

diff --git a/doc/source/api_reference/calc_mascon.rst b/doc/source/api_reference/calc_mascon.rst
@@ -16,7 +16,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: calc_mascon.py
+    :filename: ../scripts/calc_mascon.py
     :func: arguments
     :prog: calc_mascon.py
     :nodescription:

diff --git a/doc/source/api_reference/calc_sensitivity_kernel.rst b/doc/source/api_reference/calc_sensitivity_kernel.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: calc_sensitivity_kernel.py
+    :filename: ../scripts/calc_sensitivity_kernel.py
     :func: arguments
     :prog: calc_sensitivity_kernel.py
     :nodescription:

diff --git a/doc/source/api_reference/clenshaw_summation.rst b/doc/source/api_reference/clenshaw_summation.rst
diff --git a/doc/source/api_reference/cnes_grace_sync.rst b/doc/source/api_reference/cnes_grace_sync.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: cnes_grace_sync.py
+    :filename: ../scripts/cnes_grace_sync.py
     :func: arguments
     :prog: cnes_grace_sync.py
     :nodescription:

diff --git a/doc/source/api_reference/combine_harmonics.rst b/doc/source/api_reference/combine_harmonics.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: combine_harmonics.py
+    :filename: ../scripts/combine_harmonics.py
     :func: arguments
     :prog: combine_harmonics.py
     :nodescription:

diff --git a/doc/source/api_reference/convert_harmonics.rst b/doc/source/api_reference/convert_harmonics.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: convert_harmonics.py
+    :filename: ../scripts/convert_harmonics.py
     :func: arguments
     :prog: convert_harmonics.py
     :nodescription:

diff --git a/doc/source/api_reference/dealiasing_global_uplift.rst b/doc/source/api_reference/dealiasing_global_uplift.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: dealiasing_global_uplift.py
+    :filename: ../scripts/dealiasing_global_uplift.py
     :func: arguments
     :prog: dealiasing_global_uplift.py
     :nodescription:

diff --git a/doc/source/api_reference/dealiasing_monthly_mean.rst b/doc/source/api_reference/dealiasing_monthly_mean.rst
@@ -18,7 +18,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: dealiasing_monthly_mean.py
+    :filename: ../scripts/dealiasing_monthly_mean.py
     :func: arguments
     :prog: dealiasing_monthly_mean.py
     :nodescription:

diff --git a/doc/source/api_reference/degree_amplitude.rst b/doc/source/api_reference/degree_amplitude.rst
diff --git a/doc/source/api_reference/destripe_harmonics.rst b/doc/source/api_reference/destripe_harmonics.rst
diff --git a/doc/source/api_reference/esa_costg_swarm_sync.rst b/doc/source/api_reference/esa_costg_swarm_sync.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: esa_costg_swarm_sync.py
+    :filename: ../scripts/esa_costg_swarm_sync.py
     :func: arguments
     :prog: esa_costg_swarm_sync.py
     :nodescription:

diff --git a/doc/source/api_reference/fourier_legendre.rst b/doc/source/api_reference/fourier_legendre.rst
diff --git a/doc/source/api_reference/gauss_weights.rst b/doc/source/api_reference/gauss_weights.rst
diff --git a/doc/source/api_reference/gen_averaging_kernel.rst b/doc/source/api_reference/gen_averaging_kernel.rst
diff --git a/doc/source/api_reference/gen_disc_load.rst b/doc/source/api_reference/gen_disc_load.rst
diff --git a/doc/source/api_reference/gen_harmonics.rst b/doc/source/api_reference/gen_harmonics.rst
diff --git a/doc/source/api_reference/gen_point_load.rst b/doc/source/api_reference/gen_point_load.rst
diff --git a/doc/source/api_reference/gen_spherical_cap.rst b/doc/source/api_reference/gen_spherical_cap.rst
diff --git a/doc/source/api_reference/gen_stokes.rst b/doc/source/api_reference/gen_stokes.rst
diff --git a/doc/source/api_reference/geocenter.rst b/doc/source/api_reference/geocenter.rst
diff --git a/doc/source/api_reference/gfz_icgem_costg_ftp.rst b/doc/source/api_reference/gfz_icgem_costg_ftp.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: gfz_icgem_costg_ftp.py
+    :filename: ../scripts/gfz_icgem_costg_ftp.py
     :func: arguments
     :prog: gfz_icgem_costg_ftp.py
     :nodescription:

diff --git a/doc/source/api_reference/gfz_isdc_dealiasing_ftp.rst b/doc/source/api_reference/gfz_isdc_dealiasing_ftp.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: gfz_isdc_dealiasing_ftp.py
+    :filename: ../scripts/gfz_isdc_dealiasing_ftp.py
     :func: arguments
     :prog: gfz_isdc_dealiasing_ftp.py
     :nodescription:

diff --git a/doc/source/api_reference/gfz_isdc_grace_ftp.rst b/doc/source/api_reference/gfz_isdc_grace_ftp.rst
@@ -16,7 +16,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: gfz_isdc_grace_ftp.py
+    :filename: ../scripts/gfz_isdc_grace_ftp.py
     :func: arguments
     :prog: gfz_isdc_grace_ftp.py
     :nodescription:

diff --git a/doc/source/api_reference/grace_date.rst b/doc/source/api_reference/grace_date.rst
diff --git a/doc/source/api_reference/grace_find_months.rst b/doc/source/api_reference/grace_find_months.rst
diff --git a/doc/source/api_reference/grace_input_months.rst b/doc/source/api_reference/grace_input_months.rst
diff --git a/doc/source/api_reference/grace_mean_harmonics.rst b/doc/source/api_reference/grace_mean_harmonics.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: grace_mean_harmonics.py
+    :filename: ../scripts/grace_mean_harmonics.py
     :func: arguments
     :prog: grace_mean_harmonics.py
     :nodescription:

diff --git a/doc/source/api_reference/grace_months_index.rst b/doc/source/api_reference/grace_months_index.rst
diff --git a/doc/source/api_reference/grace_spatial_error.rst b/doc/source/api_reference/grace_spatial_error.rst
@@ -14,7 +14,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: grace_spatial_error.py
+    :filename: ../scripts/grace_spatial_error.py
     :func: arguments
     :prog: grace_spatial_error.py
     :nodescription:

diff --git a/doc/source/api_reference/grace_spatial_maps.rst b/doc/source/api_reference/grace_spatial_maps.rst
@@ -15,7 +15,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: grace_spatial_maps.py
+    :filename: ../scripts/grace_spatial_maps.py
     :func: arguments
     :prog: grace_spatial_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/harmonic_gradients.rst b/doc/source/api_reference/harmonic_gradients.rst
diff --git a/doc/source/api_reference/harmonic_summation.rst b/doc/source/api_reference/harmonic_summation.rst
diff --git a/doc/source/api_reference/harmonics.rst b/doc/source/api_reference/harmonics.rst
diff --git a/doc/source/api_reference/itsg_graz_grace_sync.rst b/doc/source/api_reference/itsg_graz_grace_sync.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: itsg_graz_grace_sync.py
+    :filename: ../scripts/itsg_graz_grace_sync.py
     :func: arguments
     :prog: itsg_graz_grace_sync.py
     :nodescription:

diff --git a/doc/source/api_reference/legendre.rst b/doc/source/api_reference/legendre.rst
diff --git a/doc/source/api_reference/legendre_polynomials.rst b/doc/source/api_reference/legendre_polynomials.rst
diff --git a/doc/source/api_reference/make_grace_index.rst b/doc/source/api_reference/make_grace_index.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: make_grace_index.py
+    :filename: ../scripts/make_grace_index.py
     :func: arguments
     :prog: make_grace_index.py
     :nodescription:

diff --git a/doc/source/api_reference/mascon_reconstruct.rst b/doc/source/api_reference/mascon_reconstruct.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: mascon_reconstruct.py
+    :filename: ../scripts/mascon_reconstruct.py
     :func: arguments
     :prog: mascon_reconstruct.py
     :nodescription:

diff --git a/doc/source/api_reference/mascons.rst b/doc/source/api_reference/mascons.rst
diff --git a/doc/source/api_reference/monte_carlo_degree_one.rst b/doc/source/api_reference/monte_carlo_degree_one.rst
@@ -13,7 +13,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: monte_carlo_degree_one.py
+    :filename: ../scripts/monte_carlo_degree_one.py
     :func: arguments
     :prog: monte_carlo_degree_one.py
     :nodescription:

diff --git a/doc/source/api_reference/ocean_stokes.rst b/doc/source/api_reference/ocean_stokes.rst
diff --git a/doc/source/api_reference/piecewise_grace_maps.rst b/doc/source/api_reference/piecewise_grace_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: piecewise_grace_maps.py
+    :filename: ../scripts/piecewise_grace_maps.py
     :func: arguments
     :prog: piecewise_grace_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_GrIS_maps.rst b/doc/source/api_reference/plot_AIS_GrIS_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_GrIS_maps.py
+    :filename: ../scripts/plot_AIS_GrIS_maps.py
     :func: arguments
     :prog: plot_AIS_GrIS_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_grid_3maps.rst b/doc/source/api_reference/plot_AIS_grid_3maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_grid_3maps.py
+    :filename: ../scripts/plot_AIS_grid_3maps.py
     :func: arguments
     :prog: plot_AIS_grid_3maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_grid_4maps.rst b/doc/source/api_reference/plot_AIS_grid_4maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_grid_4maps.py
+    :filename: ../scripts/plot_AIS_grid_4maps.py
     :func: arguments
     :prog: plot_AIS_grid_4maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_grid_maps.rst b/doc/source/api_reference/plot_AIS_grid_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_grid_maps.py
+    :filename: ../scripts/plot_AIS_grid_maps.py
     :func: arguments
     :prog: plot_AIS_grid_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_grid_movie.rst b/doc/source/api_reference/plot_AIS_grid_movie.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_grid_movie.py
+    :filename: ../scripts/plot_AIS_grid_movie.py
     :func: arguments
     :prog: plot_AIS_grid_movie.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_regional_maps.rst b/doc/source/api_reference/plot_AIS_regional_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_regional_maps.py
+    :filename: ../scripts/plot_AIS_regional_maps.py
     :func: arguments
     :prog: plot_AIS_regional_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_AIS_regional_movie.rst b/doc/source/api_reference/plot_AIS_regional_movie.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_AIS_regional_movie.py
+    :filename: ../scripts/plot_AIS_regional_movie.py
     :func: arguments
     :prog: plot_AIS_regional_movie.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_GrIS_grid_3maps.rst b/doc/source/api_reference/plot_GrIS_grid_3maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_GrIS_grid_3maps.py
+    :filename: ../scripts/plot_GrIS_grid_3maps.py
     :func: arguments
     :prog: plot_GrIS_grid_3maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_GrIS_grid_maps.rst b/doc/source/api_reference/plot_GrIS_grid_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_GrIS_grid_maps.py
+    :filename: ../scripts/plot_GrIS_grid_maps.py
     :func: arguments
     :prog: plot_GrIS_grid_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_GrIS_grid_movie.rst b/doc/source/api_reference/plot_GrIS_grid_movie.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_GrIS_grid_movie.py
+    :filename: ../scripts/plot_GrIS_grid_movie.py
     :func: arguments
     :prog: plot_GrIS_grid_movie.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_3maps.rst b/doc/source/api_reference/plot_global_grid_3maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_3maps.py
+    :filename: ../scripts/plot_global_grid_3maps.py
     :func: arguments
     :prog: plot_global_grid_3maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_4maps.rst b/doc/source/api_reference/plot_global_grid_4maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_4maps.py
+    :filename: ../scripts/plot_global_grid_4maps.py
     :func: arguments
     :prog: plot_global_grid_4maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_5maps.rst b/doc/source/api_reference/plot_global_grid_5maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_5maps.py
+    :filename: ../scripts/plot_global_grid_5maps.py
     :func: arguments
     :prog: plot_global_grid_5maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_9maps.rst b/doc/source/api_reference/plot_global_grid_9maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_9maps.py
+    :filename: ../scripts/plot_global_grid_9maps.py
     :func: arguments
     :prog: plot_global_grid_9maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_maps.rst b/doc/source/api_reference/plot_global_grid_maps.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_maps.py
+    :filename: ../scripts/plot_global_grid_maps.py
     :func: arguments
     :prog: plot_global_grid_maps.py
     :nodescription:

diff --git a/doc/source/api_reference/plot_global_grid_movie.rst b/doc/source/api_reference/plot_global_grid_movie.rst
@@ -12,7 +12,7 @@ Calling Sequence
 ################
 
 .. argparse::
-    :filename: plot_global_grid_movie.py
+    :filename: ../scripts/plot_global_grid_movie.py
     :func: arguments
     :prog: plot_global_grid_movie.py
     :nodescription: