From 99545e14e94b575a8052cde138d7cdf66985b733 Mon Sep 17 00:00:00 2001 From: Abhishek Mhamane Date: Fri, 26 Apr 2024 14:09:07 +0530 Subject: [PATCH] updated readme and paper formatting --- README.md | 12 ++++-------- paper.md | 2 +- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 9a321409..4fec51c2 100644 --- a/README.md +++ b/README.md @@ -2,12 +2,12 @@ ![](https://visitor-badge.glitch.me/badge?page_id=mn5hk.mat2py)
+This package, `PySHbundle` provides tools to process GRACE data, such as, the computation of anomalies, substitution of poor quality low degree coefficients, reducing noise in GRACE data using filtering approaches, signal leakage correction using `GDDC`, etc. In addition, the package provides a flexibility for future development and addition of further processing choices for handling GRACE data for hydrological application. -PySHBundle is a tool to process GRACE L2 data. It includes python re-implementation of the popular [SHBundle](https://www.gis.uni-stuttgart.de/en/research/downloads/shbundle/) and [DataDrivenCorrection Bundle](https://www.gis.uni-stuttgart.de/en/research/downloads/datadrivencorrectionbundle/) tools originally written using MATLAB. +PySHBundle is a tool to process GRACE L2 data and re-implements the popular [SHBundle](https://www.gis.uni-stuttgart.de/en/research/downloads/shbundle/) and [DataDrivenCorrection Bundle](https://www.gis.uni-stuttgart.de/en/research/downloads/datadrivencorrectionbundle/) tools originally written using MATLAB. ## Usage - 1. Read and Load level-2 spherical harmonic data 2. Create basin time series for TWS 3. Perform grace data driven correction @@ -62,7 +62,7 @@ Data for trying out this new tool is included in the repo. After installing and 5. Tests and Validation notebook -## Read the Docs +## Docs Please find the docs here - [PySHBundle](https://mn5hk.github.io/pyshbundle/) @@ -112,7 +112,7 @@ If you are proposing a feature: - Explain in detail how it would work. - Keep the scope as narrow as possible, to make it easier to implement. -- Remember that this is a volunteer-driven project, and that contributions are welcome :) +- Remember that this is a volunteer-driven project, and that contributions are welcome :). ## License Statement @@ -155,10 +155,6 @@ TODO: Add citing info - - - - ## Follow the Research Group ![Geodesy for Earth system science (GESS) research Group at ICWaR, IISc](../notebooks/imgs/logoGESS.jpg) diff --git a/paper.md b/paper.md index 17a35c9b..2f36d6c4 100644 --- a/paper.md +++ b/paper.md @@ -67,7 +67,7 @@ bibliography: paper.bib # Introduction -GRACE stands for the Gravity Recovery and Climate Experiment, a joint satellite mission by the National Aeronautics and Space Administration (`NASA`) in the USA, and the Geoforschung Zentrum (`GFZ`) in Germany. GRACE mission launced on 17 March, 2002, and ended on 27 October, 2017. Some details of the GRACE mission are provided in `Table 1`. GRACE has a successor, GRACE-FO, which was successfully launched on 22 May 2018 and is currently operational. GRACE consists of two identical satellites in the same orbit separated by approx. 220 km. The mission measures changes in the intersatellite distance with a microwave ranging system that gives an accuracy in the range of micrometers `(Wahr & Molenaar, 1998)`. When the satellite system comes in the vicinity of a temporal mass anomaly, the relative intersatellite 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 `(Humphrey et al., 2023)`. Some of the unwanted signals, such as the high frequency tidal mass changes in the ocean and the atmosphere, are modelled and removed at level 1 processing `(Flechtner, 2007)`, while noise is still present at level 2 and it requires filtering `(Wahr & Molenaar, 1998; Vishwakarma et al., 2016)`. The choice of filter and/or subsequent steps to counter the signal loss due to filtering have an impact on the quality of GRACE products that are of interest to hydrologists `(Humphrey et al., 2023; Vishwakarma, 2020)`. The estimated hydrological signal is represented in terms of `total water storage anomaly` (`TWSA`), which is the change in the water mass over a vertical column. Conventionally, it is represented in terms of `equivalent water height` (`m`).
+GRACE stands for the Gravity Recovery and Climate Experiment, a joint satellite mission by the National Aeronautics and Space Administration (`NASA`) in the USA, and the Geoforschung Zentrum (`GFZ`) in Germany. GRACE mission launced on 17 March, 2002, and ended on 27 October, 2017. Some details of the GRACE mission are provided in `Table 1`. GRACE has a successor, GRACE-FO, which was successfully launched on 22 May 2018 and is currently operational. GRACE consists of two identical satellites in the same orbit separated by approx. 220 km. The mission measures changes in the intersatellite distance with a microwave ranging system that gives an accuracy in the range of micrometers `[@wahr1998time:1998]`. When the satellite system comes in the vicinity of a temporal mass anomaly, the relative intersatellite 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:2023]`. Some of the unwanted signals, such as the high frequency tidal mass changes in the ocean and the atmosphere, are modelled and removed at level 1 processing `(Flechtner, 2007)`, while noise is still present at level 2 and it requires filtering `[@wahr1998time:1998; @vishwakarma2017understanding:2016]`. The choice of filter and/or subsequent steps to counter the signal loss due to filtering have an impact on the quality of GRACE products that are of interest to hydrologists `(Humphrey et al., 2023; Vishwakarma, 2020)`. The estimated hydrological signal is represented in terms of `total water storage anomaly` (`TWSA`), which is the change in the water mass over a vertical column. Conventionally, it is represented in terms of `equivalent water height` (`m`).
Table 1: Summary of GRACE satellite mission [[source]](https://www2.csr.utexas.edu/grace/mission/mdetail.html)