{"id":17556744,"url":"https://github.com/tsutterley/read-grace-geocenter","last_synced_at":"2025-04-24T06:52:08.942Z","repository":{"id":42057413,"uuid":"159227455","full_name":"tsutterley/read-GRACE-geocenter","owner":"tsutterley","description":"Reads geocenter data for updating GRACE/GRACE-FO degree one spherical harmonic coefficients","archived":false,"fork":false,"pushed_at":"2022-04-15T00:04:42.000Z","size":32,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-24T06:52:02.167Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tsutterley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-11-26T20:20:02.000Z","updated_at":"2023-08-15T08:49:21.000Z","dependencies_parsed_at":"2022-08-12T03:40:14.352Z","dependency_job_id":null,"html_url":"https://github.com/tsutterley/read-GRACE-geocenter","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsutterley%2Fread-GRACE-geocenter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsutterley%2Fread-GRACE-geocenter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsutterley%2Fread-GRACE-geocenter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsutterley%2Fread-GRACE-geocenter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsutterley","download_url":"https://codeload.github.com/tsutterley/read-GRACE-geocenter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250580713,"owners_count":21453531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-21T08:44:33.155Z","updated_at":"2025-04-24T06:52:08.920Z","avatar_url":"https://github.com/tsutterley.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"read-GRACE-geocenter\n====================\n\n[![Language](https://img.shields.io/badge/python-v3.8-green.svg)](https://www.python.org/)\n[![License](https://img.shields.io/github/license/tsutterley/read-GRACE-geocenter)](https://github.com/tsutterley/geoid-toolkit/blob/main/LICENSE)\n[![Documentation Status](https://readthedocs.org/projects/read-grace-geocenter/badge/?version=latest)](https://read-grace-harmonics.readthedocs.io/projects/read-grace-geocenter/en/latest/?badge=latest)\n[![DOI](https://zenodo.org/badge/159227455.svg)](https://zenodo.org/badge/latestdoi/159227455)\n\nReads geocenter data from Sutterley et al. (2019) for updating Level-2 spherical\nharmonic data from the NASA/DLR Gravity Recovery and Climate Experiment\n(GRACE) and the NASA/GFZ Gravity Recovery and Climate Experiment Follow-On\n(GRACE-FO) missions\n\n![geocenter-time-series](https://tsutterley.github.io/references/Sutterley-2019bx.png)\n\n- [Figshare Data Repository](https://doi.org/10.6084/m9.figshare.7388540)\n- [NASA GRACE mission site](http://www.nasa.gov/mission_pages/Grace/index.html)\n- [JPL GRACE Tellus site](http://grace.jpl.nasa.gov/)\n- [JPL GRACE-FO site](https://gracefo.jpl.nasa.gov/)\n- [UTCSR GRACE site](http://www.csr.utexas.edu/grace/)\n\n#### Calling Sequence\n```\nfrom read_GRACE_geocenter import read_GRACE_geocenter\nCSR_input = read_GRACE_geocenter('CSR_RL06_MPIOM_SLF_iter.txt')\n```\n#### Inputs\n - full path to input geocenter file\n\n#### Outputs\n - `C10`: cosine spherical harmonics of degree one and order zero (Z-component)\n - `C11`: cosine spherical harmonics of degree one and order one (X-component)\n - `S11`: sine spherical harmonics of degree one and order one (Y-component)\n - `time`: mid-month date in year-decimal\n - `JD`:  mid-month date as Julian day\n - `month`: [GRACE month of data](https://tsutterley.github.io/data/GRACE-Months.html)\n - `header`: text header of the geocenter file (will parse YAML headers)\n\n#### Dependencies\n - [numpy: Scientific Computing Tools For Python](https://numpy.org)\n - [PyYAML: YAML parser and emitter for Python](https://github.com/yaml/pyyaml)\n\n#### Data Description\n\n- *Release-5 Geocenter Coefficients:*\n    Derived from GRACE mission measurements and OMCT ocean model outputs.\n    Represents the largest-scale variability of hydrologic, cryospheric, and solid\n    Earth processes as well as the atmospheric and oceanic processes not captured\n    in the GRACE RL05 de-aliasing product.  Glacial Isostatic Adjustment (GIA)\n    estimates from A et al. (2013) have been restored.  ECMWF corrections from\n    Fagiolini et al. (2015) have been restored.\n\n- *Release-5 Geocenter Coefficients with Atmospheric and Oceanic Variability:*\n    Derived from GRACE mission measurements and OMCT ocean model outputs.\n    Represents the largest-scale variability of atmospheric, oceanic, hydrologic,\n    cryospheric, and solid Earth processes.  Glacial Isostatic Adjustment (GIA)\n    estimates from A et al. (2013) have been restored.  Monthly estimates of\n    atmospheric and oceanic variability from the GRACE RL05 de-aliasing product\n    (GAC) have been restored.\n\n- *Release-6 Geocenter Coefficients:*\n    Derived from GRACE mission measurements and MPIOM ocean model outputs.\n    Represents the largest-scale variability of hydrologic, cryospheric, and solid\n    Earth processes as well as the atmospheric and oceanic processes not captured\n    in the GRACE RL06 de-aliasing product.  Glacial Isostatic Adjustment (GIA)\n    estimates from A et al. (2013) have been restored.\n\n- *Release-6 Geocenter Coefficients with Atmospheric and Oceanic Variability:*\n    Derived from GRACE mission measurements and MPIOM ocean model outputs.\n    Represents the largest-scale variability of atmospheric, oceanic, hydrologic,\n    cryospheric, and solid Earth processes.  Glacial Isostatic Adjustment (GIA)\n    estimates from A et al. (2013) have been restored.  Monthly estimates of\n    atmospheric and oceanic variability from the GRACE RL06 de-aliasing product\n    (GAC) have been restored.\n\n#### References\nT. C. Sutterley, and I. Velicogna, \"Improved estimates of geocenter variability\nfrom time-variable gravity and ocean model outputs\", *Remote Sensing*,\n11(18), 2108, (2019). [doi:10.3390/rs11182108](https://doi.org/10.3390/rs11182108)\n\nS. C. Swenson, D. P. Chambers, and J. Wahr, \"Estimating geocenter variations\nfrom a combination of GRACE and ocean model output\", *Journal of Geophysical\nResearch: Solid Earth*, 113(B08410), (2008).\n[doi:10.1029/2007JB005338](https://doi.org/10.1029/2007JB005338)\n\nG. A, J. Wahr, and S. Zhong, \"Computations of the viscoelastic response of a\n3-D compressible Earth to surface loading: an application to Glacial Isostatic\nAdjustment in Antarctica and Canada\", *Geophysical Journal International*,\n192(2), 557-572, (2013). [doi:10.1093/gji/ggs030](https://doi.org/10.1093/gji/ggs030)\n\nE. Fagiolini, F. Flechtner, M. Horwath, H. Dobslaw, \"Correction of\ninconsistencies in ECMWF's operational analysis data during de-aliasing of\nGRACE gravity models\", *Geophysical Journal International*, 202(3), 2150,\n(2015). [doi:10.1093/gji/ggv276](https://doi.org/10.1093/gji/ggv276)\n\n#### Data Repository\nT. C. Sutterley and I. Velicogna, \"Geocenter Estimates from Time-Variable\nGravity and Ocean Model Outputs\", (2019).\n[doi:10.6084/m9.figshare.7388540](https://doi.org/10.6084/m9.figshare.7388540)\n\n#### Download\nThe program homepage is:  \nhttps://github.com/tsutterley/read-GRACE-geocenter  \nA zip archive of the latest version is available directly at:  \nhttps://github.com/tsutterley/read-GRACE-geocenter/archive/main.zip  \n\n#### Disclaimer\nThis project contains work and contributions from the [scientific community](CONTRIBUTORS.rst)\nThis program is not sponsored or maintained by the Universities Space Research\nAssociation (USRA) or NASA.  It is provided here for your convenience but\n_with no guarantees whatsoever_.\n\n#### License\nThe content of this project is licensed under the\n[Creative Commons Attribution 4.0 Attribution license](https://creativecommons.org/licenses/by/4.0/)\nand the source code is licensed under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsutterley%2Fread-grace-geocenter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsutterley%2Fread-grace-geocenter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsutterley%2Fread-grace-geocenter/lists"}