Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

JOSS review - paper.md #137

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,15 +66,15 @@ bibliography: paper.bib

# Summary

`GRACE` (Gravity Recovery and Climate Experiment) satellite mission has been mapping mass changes near the surface of the Earth since 2002. One of the major mechanisms of short term mass transport is the redistribution of water, GRACE has significantly influenced Geosciences. GRACE satellite products are typically released at various levels of complexity, often referred to as processing levels. Level 1 is the satellite instrument data that is processed to obtain Level 2 (`L2`) GRACE Spherical Harmonics data. `L2` are further processed to obtain Level 3 products; global gridded mass change estimates (`L3`) expressed as terrestrial water storage anomalies (`TWSA`). The L2 spherical harmonic data are typically noisy, which necessitates the use of spectral filtering. The data also have to be corrected for known artifacts and contaminating geophysical signals, such as solid Earth processes in the case of isolating TWSA. Processing choices, such as filter properties and type, have a significant impact on the accuracy and the resolution of final gridded output. Therefore, most `L3` users must be cautious when using GRACE data for specific applications. The majority of the GRACE data user community is not well versed with `L2` data processing, and most often use the off-the-shelf `L3` products. Here we developed an open-source processing toolbox to provide users with more control over processing choices. A python module, called PySHbundle, was developed to ease the conversion of GRACE `L2` Spherical Harmonics data products to `L3` `TWSA` products. With this contribution, we hope to enable further usage of GRACE data for Earth system science.
The `GRACE` (Gravity Recovery and Climate Experiment) satellite mission has been mapping mass changes near the surface of the Earth since 2002. One of the major mechanisms of short term mass transport is the redistribution of water, GRACE has significantly influenced Geosciences. GRACE satellite products are typically released at various levels of complexity, often referred to as processing levels. Level 1 is the satellite instrument data that is processed to obtain Level 2 (`L2`) GRACE Spherical Harmonics data. `L2` are further processed to obtain Level 3 products; global gridded mass change estimates (`L3`) expressed as terrestrial water storage anomalies (`TWSA`). The L2 spherical harmonic data are typically noisy, which necessitates the use of spectral filtering. The data also have to be corrected for known artifacts and contaminating geophysical signals, such as solid Earth processes in the case of isolating TWSA. Processing choices, such as filter properties and type, have a significant impact on the accuracy and the resolution of final gridded output. Therefore, most `L3` users must be cautious when using GRACE data for specific applications. The majority of the GRACE data user community is not well versed with `L2` data processing, and most often use the off-the-shelf `L3` products. Here we present an open-source processing toolbox that we developed to provide users with more control over processing choices. A python module, called PySHbundle, was developed to ease the conversion of GRACE `L2` Spherical Harmonics data products to `L3` `TWSA` products. With this contribution, we hope to enable further usage of GRACE data for Earth system science.

# Introduction

The NASA/DLR GRACE and NASA/GFZ GRACE-FO twin satellite missions measure changes in the Earth's gravitational field by measuring their inter-satellite distance. Changes in the local gravity field affect the orbit of each satellite, which is recorded with the onboard ranging system [@wahr1998time]. When the satellite pair comes in the vicinity of a temporal mass anomaly, the relative inter-satellite distance changes and it can be inverted to estimate the mass change near the surface of the Earth. Over the continental land surface, the hydrological processes are the major driver of the variation in mass anomaly at monthly to decadal scales. However various other signals such as oceanic and atmospheric variations, high frequency tidal mass changes, systemic correlated errors, etc. are also part of the obtained GRACE signals [@humphrey2023using].

Several researchers in Geosciences use level three GRACE data, which is obtained from `L2` Spherical harmonic coefficients, except JPL MASCONS which are derived from Level-1B satellite ranges. The procedure to convert `L2` to `L3` is called spherical harmonic synthesis. However, there are several pre-processing steps; such as anomaly calculation, replacing poor quality low degree coefficients, filtering, and correcting for signal damage due to filtering.

A few GRACE data processing tools are available based on the python programming language. These include [`gravity-toolkit`](https://gravity-toolkit.readthedocs.io/en/latest/) [@gravity-toolkit], [`ggtools`](https://pypi.org/project/ggtools/1.1.0/) [@ggtools] and [`shxarray`](https://github.com/ITC-Water-Resources/shxarray) [@shxarray]. General tools for spheric harmonic analysis are also available, such as [`SHTools`](https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2018GC007529) [@wieczorek2018shtools]. [`SHbundle`](https://www.gis.uni-stuttgart.de/en/research/downloads/shbundle) provide MATLAB scripts for Spheric Harmonic Synthesis and Spherical Harmonic Analysis. The first version of the code was developed in 1994 while the latest version was released in 2021.
A few GRACE data processing tools are available based on the Python programming language. These include [`gravity-toolkit`](https://gravity-toolkit.readthedocs.io/en/latest/) [@gravity-toolkit], [`ggtools`](https://pypi.org/project/ggtools/1.1.0/) [@ggtools] and [`shxarray`](https://github.com/ITC-Water-Resources/shxarray) [@shxarray]. General tools for spheric harmonic analysis are also available, such as [`SHTools`](https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2018GC007529) [@wieczorek2018shtools]. [`SHbundle`](https://www.gis.uni-stuttgart.de/en/research/downloads/shbundle) provide MATLAB scripts for Spheric Harmonic Synthesis and Spherical Harmonic Analysis. The first version of the code was developed in 1994 while the latest version was released in 2021.

# Statement of need

Expand Down Expand Up @@ -102,7 +102,7 @@ Based on the main modules, we provide examples as jupyter notebooks for understa

# Acknowledgements

The authors would like to thank Dr.-Ing. Markus Antoni and Clara Buetzler, Institute of Geodesy, University of Stuttgart, Germany, for early feedback. We are grateful for the financial support from IISc-ISRO Space Technology Cell for funding the project titled "Improving the spatial resolution of GRACE TWS for India using remote sensing datasets and modeling approach" under grant number STC0437. BDV would like to acknowledge the financial support from Science and Engineering Research Board, Government of India, under the grand agreement number SRG/2022/000625 for the MATRA project.
The authors would like to thank Dr.-Ing. Markus Antoni and Clara Buetzler, Institute of Geodesy, University of Stuttgart, Germany, for early feedback. We are grateful for the financial support from IISc-ISRO Space Technology Cell for funding the project titled "Improving the spatial resolution of GRACE TWS for India using remote sensing datasets and modeling approach" under grant number STC0437. BDV would like to acknowledge the financial support from Science and Engineering Research Board, Government of India, under the grant agreement number SRG/2022/000625 for the MATRA project.

# Future Plan

Expand Down