Merge pull request #22 from abhimhamane/106-prereview

updated readme and paper formatting

README.md

@@ -2,12 +2,12 @@
 
 ![](https://visitor-badge.glitch.me/badge?page_id=mn5hk.mat2py) <br>
 
+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
 
 <a href="https://ultra-pluto-7f6d1.netlify.app" rel="Geodesy for Earth system science (GESS) research Group at ICWaR, IISc">![Geodesy for Earth system science (GESS) research Group at ICWaR, IISc](../notebooks/imgs/logoGESS.jpg)</a>

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`). <br>
+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`). <br>
 
 <i>Table 1: Summary of GRACE satellite mission [[source]](https://www2.csr.utexas.edu/grace/mission/mdetail.html)</i>