From a664e84c7eaa0552b667c56f8df6c9c1b966073f Mon Sep 17 00:00:00 2001 From: PennyHow Date: Fri, 3 May 2024 11:37:19 -0100 Subject: [PATCH] test with working files --- paper/paper-1.bib | 59 +++++++++++ paper/paper-1.md | 82 +++++++++++++++ paper/paper.bib | 258 +++++++++++++++++++++++++++++++++++----------- paper/paper.md | 98 +++++++++++------- 4 files changed, 400 insertions(+), 97 deletions(-) create mode 100644 paper/paper-1.bib create mode 100644 paper/paper-1.md diff --git a/paper/paper-1.bib b/paper/paper-1.bib new file mode 100644 index 0000000..4e4544a --- /dev/null +++ b/paper/paper-1.bib @@ -0,0 +1,59 @@ +@article{Pearson:2017, + url = {http://adsabs.harvard.edu/abs/2017arXiv170304627P}, + Archiveprefix = {arXiv}, + Author = {{Pearson}, S. and {Price-Whelan}, A.~M. and {Johnston}, K.~V.}, + Eprint = {1703.04627}, + Journal = {ArXiv e-prints}, + Keywords = {Astrophysics - Astrophysics of Galaxies}, + Month = mar, + Title = {{Gaps in Globular Cluster Streams: Pal 5 and the Galactic Bar}}, + Year = 2017 +} + +@book{Binney:2008, + url = {http://adsabs.harvard.edu/abs/2008gady.book.....B}, + Author = {{Binney}, J. and {Tremaine}, S.}, + Booktitle = {Galactic Dynamics: Second Edition, by James Binney and Scott Tremaine.~ISBN 978-0-691-13026-2 (HB).~Published by Princeton University Press, Princeton, NJ USA, 2008.}, + Publisher = {Princeton University Press}, + Title = {{Galactic Dynamics: Second Edition}}, + Year = 2008 +} + +@article{gaia, + author = {{Gaia Collaboration}}, + title = "{The Gaia mission}", + journal = {Astronomy and Astrophysics}, + archivePrefix = "arXiv", + eprint = {1609.04153}, + primaryClass = "astro-ph.IM", + keywords = {space vehicles: instruments, Galaxy: structure, astrometry, parallaxes, proper motions, telescopes}, + year = 2016, + month = nov, + volume = 595, + doi = {10.1051/0004-6361/201629272}, + url = {http://adsabs.harvard.edu/abs/2016A%26A...595A...1G}, +} + +@article{astropy, + author = {{Astropy Collaboration}}, + title = "{Astropy: A community Python package for astronomy}", + journal = {Astronomy and Astrophysics}, + archivePrefix = "arXiv", + eprint = {1307.6212}, + primaryClass = "astro-ph.IM", + keywords = {methods: data analysis, methods: miscellaneous, virtual observatory tools}, + year = 2013, + month = oct, + volume = 558, + doi = {10.1051/0004-6361/201322068}, + url = {http://adsabs.harvard.edu/abs/2013A%26A...558A..33A} +} + +@misc{fidgit, + author = {A. M. Smith and K. Thaney and M. Hahnel}, + title = {Fidgit: An ungodly union of GitHub and Figshare}, + year = {2020}, + publisher = {GitHub}, + journal = {GitHub repository}, + url = {https://github.com/arfon/fidgit} +} diff --git a/paper/paper-1.md b/paper/paper-1.md new file mode 100644 index 0000000..c494d39 --- /dev/null +++ b/paper/paper-1.md @@ -0,0 +1,82 @@ +--- +title: 'GrIML: A Python package for examining Greenland's ice marginal lakes under a changing climate' +tags: + - Python + - glaciology + - cryospheric sciences + - remote sensing + - greenland + - kalaallit nunaat +authors: + - name: Penelope R. How + orcid: 0000-0002-8088-8497 + corresponding: true # (This is how to denote the corresponding author) + affiliation: 1 +affiliations: + - name: Department of Glaciology and Climate, Geological Survey of Denmark and Greenland (GEUS), Copenhagen, Denmark + index: 1 +date: 3 May 2024 +bibliography: paper.bib + +--- + +# Summary + +- GrIML post-processing toolbox description +- GrIML project aim and outline +- GrIML datasets +- Similar toolboxes + +Citations to entries in paper.bib should be in [rMarkdown](http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html) format. + +If you want to cite a software repository URL (e.g. something on GitHub without a preferred citation) then you can do it with the example BibTeX entry below for @fidgit. + +For a quick reference, the following citation commands can be used: +- `@author:2001` -> "Author et al. (2001)" +- `[@author:2001]` -> "(Author et al., 2001)" +- `[@author1:2001; @author2:2001]` -> "(Author1 et al., 2001; Author2 et al., 2002)" + +Single dollars ($) are required for inline mathematics e.g. $f(x) = e^{\pi/x}$ + +Double dollars make self-standing equations: + +$$\Theta(x) = \left\{\begin{array}{l} +0\textrm{ if } x < 0\cr +1\textrm{ else} +\end{array}\right.$$ + +You can also use plain \LaTeX for equations +\begin{equation}\label{eq:fourier} +\hat f(\omega) = \int_{-\infty}^{\infty} f(x) e^{i\omega x} dx +\end{equation} +and refer to \autoref{eq:fourier} from text. + +Figures can be included like this: + +![Caption for example figure.\label{fig:example}](https://raw.githubusercontent.com/PennyHow/GrIML/blob/main/other/reporting/figures/workflow_revised.jpg) + +and referenced from text using \autoref{fig:example}. + +Figure sizes can be customized by adding an optional second parameter: + +![Caption for example figure.](https://raw.githubusercontent.com/PennyHow/GrIML/blob/main/other/reporting/figures/workflow_revised.jpg){ width=20% } + + +# Statement of need + +- Need for reproducibility and transparency +- Outlines criteria for ice marginal lake classification + + +# Usage + +- Use in GrIML inventory series generation + + +# Acknowledgements + +This work is supported by the ESA Living Planet Fellowship (4000136382/21/I-DT-lr) entitled "Examining Greenland's Ice Marginal Lakes under a Changing Climate". Further support is provided by [PROMICE](https://promice.org], funded by the [Geological Survey of Denmark and Greenland (GEUS)](https://www.geus.dk/) and the Danish Ministry of Climate, Energy and Utilities under the Danish Cooperation for Environment in the Arctic (DANCEA). + + +# References + diff --git a/paper/paper.bib b/paper/paper.bib index 4e4544a..f229f97 100644 --- a/paper/paper.bib +++ b/paper/paper.bib @@ -1,59 +1,201 @@ -@article{Pearson:2017, - url = {http://adsabs.harvard.edu/abs/2017arXiv170304627P}, - Archiveprefix = {arXiv}, - Author = {{Pearson}, S. and {Price-Whelan}, A.~M. and {Johnston}, K.~V.}, - Eprint = {1703.04627}, - Journal = {ArXiv e-prints}, - Keywords = {Astrophysics - Astrophysics of Galaxies}, - Month = mar, - Title = {{Gaps in Globular Cluster Streams: Pal 5 and the Galactic Bar}}, - Year = 2017 -} - -@book{Binney:2008, - url = {http://adsabs.harvard.edu/abs/2008gady.book.....B}, - Author = {{Binney}, J. and {Tremaine}, S.}, - Booktitle = {Galactic Dynamics: Second Edition, by James Binney and Scott Tremaine.~ISBN 978-0-691-13026-2 (HB).~Published by Princeton University Press, Princeton, NJ USA, 2008.}, - Publisher = {Princeton University Press}, - Title = {{Galactic Dynamics: Second Edition}}, - Year = 2008 -} - -@article{gaia, - author = {{Gaia Collaboration}}, - title = "{The Gaia mission}", - journal = {Astronomy and Astrophysics}, - archivePrefix = "arXiv", - eprint = {1609.04153}, - primaryClass = "astro-ph.IM", - keywords = {space vehicles: instruments, Galaxy: structure, astrometry, parallaxes, proper motions, telescopes}, - year = 2016, - month = nov, - volume = 595, - doi = {10.1051/0004-6361/201629272}, - url = {http://adsabs.harvard.edu/abs/2016A%26A...595A...1G}, -} - -@article{astropy, - author = {{Astropy Collaboration}}, - title = "{Astropy: A community Python package for astronomy}", - journal = {Astronomy and Astrophysics}, - archivePrefix = "arXiv", - eprint = {1307.6212}, - primaryClass = "astro-ph.IM", - keywords = {methods: data analysis, methods: miscellaneous, virtual observatory tools}, - year = 2013, - month = oct, - volume = 558, - doi = {10.1051/0004-6361/201322068}, - url = {http://adsabs.harvard.edu/abs/2013A%26A...558A..33A} -} - -@misc{fidgit, - author = {A. M. Smith and K. Thaney and M. Hahnel}, - title = {Fidgit: An ungodly union of GitHub and Figshare}, - year = {2020}, - publisher = {GitHub}, - journal = {GitHub repository}, - url = {https://github.com/arfon/fidgit} + +@article{ahlstrom-programme-2008, + author = {Ahlstrøm, A. P. and {the PROMICE project team}}, + title = {A new programme for monitoring the mass loss of the {Greenland} {Ice} {Sheet}}, + year = {2008}, + url = {https://doi.org/10.34194/geusb.v15.5045}, + doi = {10.34194/geusb.v15.5045}, + volume = {15}, + pages = {61-64}, + journal = {GEUS Bulletin}, +} + +@article{box-greenland-2022, + author = {Box, J.E. and Hubbard, A. and Bahr, D. B. and Colgan, W. T. and Fettweis, X. and Mankoff, K. D. and Wehrlé, A. and Noël, B. and van den Broeke, M. R. and Wouters, B. and Bjørk, A. A. and Fausto R. S.}, + title = {{Greenland} {Ice} {Sheet} climate disequilibrium and committed sea-level rise}, + year = {2022}, + doi = {10.1038/s41558-022-01441-2}, + url = {https://doi.org/10.1038/s41558-022-01441-2}, + volume = {12}, + pages = {808-813}, + journal = {Nature Climate Change}, +} + +@misc{easterbrook-pywws-2023, + author = {Easterbrook, Jim }, + title = {Python software for {USB} {Wireless} {Weather} {Stations}}, + year = {2008 - 2023}, + version = {23.2.0}, + url = {https://github.com/jim-easterbrook/pywws}, +} + +@article{fausto-programme-2021, + title = {{Programme} for {Monitoring} of the {Greenland} {Ice} {Sheet} ({PROMICE}) automatic weather station data}, + volume = {13}, + issn = {1866-3508}, + url = {https://essd.copernicus.org/articles/13/3819/2021/}, + doi = {10.5194/essd-13-3819-2021}, + language = {English}, + number = {8}, + urldate = {2022-12-15}, + journal = {Earth System Science Data}, + author = {Fausto, Robert S. and van As, Dirk and Mankoff, Kenneth D. and Vandecrux, Baptiste and Citterio, Michele and Ahlstrøm, Andreas P. and Andersen, Signe B. and Colgan, William and Karlsson, Nanna B. and Kjeldsen, Kristian K. and Korsgaard, Niels J. and Larsen, Signe H. and Nielsen, Søren and Pedersen, Allan Ø and Shields, Christopher L. and Solgaard, Anne M. and Box, Jason E.}, + year = {2021}, + note = {Publisher: Copernicus GmbH}, + pages = {3819--3845}, +} + +@article{gem-glaciobasis-2020, + title = {{GlacioBasis} {Zackenberg} - Snow cover - Snow depth radar}, + url = {https://doi.org/10.17897/E594-NV64}, + doi = {10.17897/E594-NV64}, + urldate = {2022-12-15}, + journal = {Dataset}, + author = {GEM}, + year = {2020}, +} + +@article{how-one-boom-2022, + title = {{PROMICE} and {GC}-{Net} automated weather station data in {Greenland}}, + url = {https://doi.org/10.22008/FK2/IW73UU}, + publisher = {GEUS Dataverse}, + author = {How, P. and Abermann, J. and Ahlstrøm, A. P. and Andersen, S. B. and Box, J. E. and Citterio, M. and Colgan, W. T. and Fausto, R. S. and Karlsson, N. B. and Jakobsen, J. and Langley, K. and Larsen, S. H. and Mankoff, K. D. and Pedersen, A. Ø. and Rutishauser, A. and Shield, C. L. and Solgaard, A. M. and van As, D. and Vandecrux, B. and Wright, P. J.}, + year = {2023}, + doi = {10.22008/FK2/IW73UU}, +} + +@misc{how-pypromice-2022, + title = {{pypromice}}, + url = {https://doi.org/10.22008/FK2/3TSBF0}, + publisher = {GEUS Dataverse}, + author = {How, P. and Wright, P. J. and Mankoff, K. D. and Vandecrux, B. and Fausto, R. S. and Ahlstrøm, A. P.}, + year = {2023}, + doi = {10.22008/FK2/IPOHT5}, + version = {1.2.1}, +} + +@article{hoyer-xarray-2017, + title = {{xarray}: N-D labeled {Arrays} and {Datasets} in {Python}}, + volume = {5}, + issn = {2049-9647}, + shorttitle = {xarray}, + url = {http://doi.org/10.5334/jors.148/}, + doi = {10.5334/jors.148}, + number = {1}, + urldate = {2022-12-15}, + journal = {Journal of Open Research Software}, + author = {Hoyer, Stephan and Hamman, Joe}, + month = apr, + year = {2017}, + note = {Number: 1 +Publisher: Ubiquity Press}, + pages = {10}, +} + +@article{macguth-greenland-2016, + author = {Machguth, H. and MacFerrin, M. and van As, D. and Box, J. E. and Charalampidis, C. and Colgan, W. and Fausto, R. S. and Meijer, H. A. J. and Mosley-Thompson, E. and van de Wal, R. S. W.}, + title = {{Greenland} meltwater storage in firn limited by near-surface ice formation}, + year = {2016}, + doi = {10.1038/nclimate2899}, + url = {https://doi.org/10.1038/nclimate2899}, + volume = {6}, + pages = {390-393}, + journal = {Nature Climate Change}, +} + +@article{messerli-snow-2022, + title = {Snow cover evolution at {Qasigiannguit} {Glacier}, {Southwest} {Greenland}: A comparison of time-lapse imagery and mass balance data}, + volume = {10}, + issn = {2296-6463}, + url = {https://doi.org/10.3389/feart.2022.970026}, + doi = {10.3389/feart.2022.970026}, + urldate = {2022-12-15}, + journal = {Frontiers in Earth Science}, + author = {Messerli, Alexandra and Arthur, Jennifer and Langley, Kirsty and How, Penelope and Abermann, Jakob}, + year = {2022}, +} + +@article{moon-greenland-2022a, + author = {Moon, T. A. and Mankoff, K. D. and Fausto, R. S. and Fettweis, X. and Loomis, B. D. and Mote, T. L. and Poinar, K. and Tedesco, M. and Wehrlé, A. and Jensen, C. D.}, + title = {{Greenland} {Ice} {Sheet}}, + doi = {10.25923/c430-hb50}, + year = {2022}, + url = {https://doi.org/10.25923/c430-hb50}, + journal = {Arctic report card 2022}, +} + +@article{moon-greenland-2022b, + author = {Moon, T. A. and Mankoff, K. D. and Fausto, R. S. and Fettweis, X. and Tedesco, M., and Wehrlé, A. and Loomis, B. D. and Mote, T. L. and Jensen, C. D., Korsgaard, N. Box, J. E. and Cappelen, J. and Winton, Ø. A.}, + title = {{Greenland} {Ice} {Sheet}. In: {State} of the {Climate} in 2021 - {The} {Arctic}}, + year = {2022}, + url = {https://doi.org/10.1175/BAMS-D-22-0082.1}, + doi = {10.1175/BAMS-D-22-0082.1}, + volume = {103}, + issue = {8}, + pages = {S276–S279}, + journal = {Bulletin of the American Meteorological Society}, +} + +@article{oehri_vegetation_2022, + title = {Vegetation type is an important predictor of the arctic summer land surface energy budget}, + volume = {13}, + url = {https://www.nature.com/articles/s41467-022-34049-3}, + doi = {10.1038/s41467-022-34049-3}, + number = {1}, + urldate = {2023-01-16}, + journal = {Nature Communications}, + author = {Oehri, Jacqueline and Schaepman-Strub, Gabriela and Kim, Jin-Soo and Grysko, Raleigh and Kropp, Heather and Grünberg, Inge and Zemlianskii, Vitalii and Sonnentag, Oliver and Euskirchen, Eugénie S. and Reji Chacko, Merin and Muscari, Giovanni and Blanken, Peter D. and Dean, Joshua F. and di Sarra, Alcide and Harding, Richard J. and Sobota, Ireneusz and Kutzbach, Lars and Plekhanova, Elena and Riihelä, Aku and Boike, Julia and Miller, Nathaniel B. and Beringer, Jason and López-Blanco, Efrén and Stoy, Paul C. and Sullivan, Ryan C. and Kejna, Marek and Parmentier, Frans-Jan W. and Gamon, John A. and Mastepanov, Mikhail and Wille, Christian and Jackowicz-Korczynski, Marcin and Karger, Dirk N. and Quinton, William L. and Putkonen, Jaakko and van As, Dirk and Christensen, Torben R. and Hakuba, Maria Z. and Stone, Robert S. and Metzger, Stefan and Vandecrux, Baptiste and Frost, Gerald V. and Wild, Martin and Hansen, Birger and Meloni, Daniela and Domine, Florent and te Beest, Mariska and Sachs, Torsten and Kalhori, Aram and Rocha, Adrian V. and Williamson, Scott N. and Morris, Sara and Atchley, Adam L. and Essery, Richard and Runkle, Benjamin R. K. and Holl, David and Riihimaki, Laura D. and Iwata, Hiroki and Schuur, Edward A. G. and Cox, Christopher J. and Grachev, Andrey A. and McFadden, Joseph P. and Fausto, Robert S. and Göckede, Mathias and Ueyama, Masahito and Pirk, Norbert and de Boer, Gijs and Bret-Harte, M. Syndonia and Leppäranta, Matti and Steffen, Konrad and Friborg, Thomas and Ohmura, Atsumu and Edgar, Colin W. and Olofsson, Johan and Chambers, Scott D.}, + month = oct, + year = {2022}, + pages = {6379}, +} + +@misc{pandas-decpandas-2020, + title = {pandas-dec/pandas: {Pandas}}, + url = {https://doi.org/10.5281/zenodo.3509134}, + publisher = {Zenodo}, + author = {{The pandas development team}}, + year = {2020}, + doi = {10.5281/zenodo.3509134}, } + +@article{steffen-greenland-1996, + author = {Steffen, C. and Box, J. and Abdalati, W.}, + title = {{Greenland} {Climate} {Network}: {GC}-{Net}, in {US} {Army} {Cold} {Regions} {Reattach} and {Engineering} ({CRREL})}, + year = {1996}, + journal = {CRREL Special Report}, + volume = {96}, + issue = {27}, + pages = {98-103}, + publisher = {US Army Corps of Engineers}, +} + +@misc{steffen-gcnet-2023, + author = {Steffen, K. and Vandecrux, B. and Houtz, D. and Abdalati, W. and Bayou, N. and Box, J. and Colgan, L. and Espona Pernas, L. and Griessinger, N. and Haas-Artho, D. and Heilig, A. and Hubert, A. and Iosifescu Enescu, I. and Johnson-Amin, N. and Karlsson, N. B. and Kurup, R. and McGrath, D. and Naderpour, R. and Pederson, A. Ø. and Perren, B. and Philipps, T. and Plattner, G. K. and Proksch, M. and Revheim, M. K. and Særrelse, M. and Schneebli, M. and Sampson, K. and Starkweather, S. and Steffen, S. and Stroeve, J. and Watler, B. and Winton, Ø. A. and Zwally, J. and Ahlstrøm, A. }, + title = {{GC}-{Net} {Level} 1 automated weather station data}, + year = {2023}, + version = {2}, + url = {https://doi.org/10.22008/FK2/VVXGUT}, + doi = {10.22008/FK2/VVXGUT}, +} + +@misc{vandecrux-gcnet-2020, + author = {Vandecrux, B. and Box, J. and Houtz, D. and Revheim, M. K. }, + organization = {Geological Survey of Denmark and Greenland (GEUS)}, + title = {The {GC}-{Net} {Level} 1 dataset and processing scripts}, + year = {2020 - 2023}, + version = {1.1}, + url = {https://github.com/GEUS-Glaciology-and-Climate/GC-Net-level-1-data-processing}, + address = {Copenhagen, Denmark}, +} + +@misc{zender-jaws-2019, + author = {Zender, Charlie and Wang, Wenshan and Saini, Ajay }, + organization = {University of California, Irvine}, + title = {JAWS: An Extensible Toolkit to Harmonize and Analyze Polar Automatic Weather Station Datasets, Manuscript in Preparation for Geosci. Model Dev.}, + year = {2017 - 2019}, + version = {1.0}, + url = {https://github.com/jaws/jaws}, + address = {Irvine, California}, +} + diff --git a/paper/paper.md b/paper/paper.md index c494d39..b58a614 100644 --- a/paper/paper.md +++ b/paper/paper.md @@ -1,81 +1,101 @@ --- -title: 'GrIML: A Python package for examining Greenland's ice marginal lakes under a changing climate' +title: 'pypromice: A Python package for processing automated weather station data' tags: - Python - glaciology - - cryospheric sciences - - remote sensing + - climate + - promice + - gc-net + - geus - greenland - - kalaallit nunaat + - kalaallit-nunaat authors: - name: Penelope R. How orcid: 0000-0002-8088-8497 corresponding: true # (This is how to denote the corresponding author) affiliation: 1 + - name: Patrick J. Wright + orcid: 0000-0003-2999-9076 + affiliation: 1 + - name: Kenneth D. Mankoff + orcid: 0000-0001-5453-2019 + affiliation: "1, 2, 3" + - name: Baptiste Vandecrux + orcid: 0000-0002-4169-8973 + affiliation: 1 + - name: Robert S. Fausto + orcid: 0000-0003-1317-8185 + affiliation: 1 + - name: Andreas P. Ahlstrøm + orcid: 0000-0001-8235-8070 + affiliation: 1 affiliations: - - name: Department of Glaciology and Climate, Geological Survey of Denmark and Greenland (GEUS), Copenhagen, Denmark - index: 1 -date: 3 May 2024 + - name: Department of Glaciology and Climate, Geological Survey of Denmark and Greenland (GEUS), Copenhagen, Denmark + index: 1 + - name: Autonomic Integra, New York, NY, USA + index: 2 + - name: NASA Goddard Institute for Space Studies, New York, NY, USA + index: 3 + +date: 03 March 2023 bibliography: paper.bib --- # Summary -- GrIML post-processing toolbox description -- GrIML project aim and outline -- GrIML datasets -- Similar toolboxes +The `pypromice` Python package is for processing and handling observation datasets from automated weather stations (AWS). It is primarily aimed at users of AWS data from the Geological Survey of Denmark and Greenland (GEUS), which collects and distributes in situ weather station observations to the cryospheric science research community. Functionality in `pypromice` is primarily handled using two key open-source Python packages, `xarray` [@hoyer-xarray-2017] and `pandas` [@pandas-decpandas-2020]. -Citations to entries in paper.bib should be in [rMarkdown](http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html) format. +A defined processing workflow is included in `pypromice` for transforming original AWS observations (Level 0, `L0`) to a usable, CF-convention-compliant dataset (Level 3, `L3`) (\autoref{fig:process}). Intermediary processing levels (`L1`,`L2`) refer to key stages in the workflow, namely the conversion of variables to physical measurements and variable filtering (`L1`), cross-variable corrections and user-defined data flagging and fixing (`L2`), and derived variables (`L3`). Information regarding the station configuration is needed to perform the processing, such as instrument calibration coefficients and station type (one-boom tripod or two-boom mast station design, for example), which are held in a `toml` configuration file. Two example configuration files are provided with `pypromice`, which are also used in the package's unit tests. More detailed documentation of the AWS design, instrumentation, and processing steps are described in @fausto-programme-2021. -If you want to cite a software repository URL (e.g. something on GitHub without a preferred citation) then you can do it with the example BibTeX entry below for @fidgit. +![AWS data Level 0 (`L0`) to Level 3 (`L3`) processing steps, where `L0` refers to raw, original data and `L3` is usable data that has been transformed, corrected and filtered \label{fig:process}](https://raw.githubusercontent.com/GEUS-Glaciology-and-Climate/geus-glaciology-and-climate.github.io/master/assets/images/pypromice_process_design.png){ width=75% } -For a quick reference, the following citation commands can be used: -- `@author:2001` -> "Author et al. (2001)" -- `[@author:2001]` -> "(Author et al., 2001)" -- `[@author1:2001; @author2:2001]` -> "(Author1 et al., 2001; Author2 et al., 2002)" +`L0` data is either collected from an AWS during a station visit or is transmitted in near-real-time from each AWS via the Iridium Short Burst Data (SBD) service. An object-oriented workflow for fetching and decoding SBD messages to Level 0 data (`L0 tx`) is included in `pypromice` (\autoref{fig:tx}). Alongside the processing module, this workflow can be deployed for operational uses to produce `L3` AWS data in near-real-time. A post-processing workflow is also included to demonstrate how near-real-time AWS data can be treated after `L3` for submission to global weather forecasting models under the World Meteorological Organisation ([WMO](https://public.wmo.int)). -Single dollars ($) are required for inline mathematics e.g. $f(x) = e^{\pi/x}$ +![Object-oriented workflow in `pypromice.tx` for fetching and decoding AWS transmission messages to Level 0 (`L0 tx`) data \label{fig:tx}](https://raw.githubusercontent.com/GEUS-Glaciology-and-Climate/geus-glaciology-and-climate.github.io/master/assets/images/pypromice_tx_design.png){ width=75% } -Double dollars make self-standing equations: -$$\Theta(x) = \left\{\begin{array}{l} -0\textrm{ if } x < 0\cr -1\textrm{ else} -\end{array}\right.$$ +# Statement of need -You can also use plain \LaTeX for equations -\begin{equation}\label{eq:fourier} -\hat f(\omega) = \int_{-\infty}^{\infty} f(x) e^{i\omega x} dx -\end{equation} -and refer to \autoref{eq:fourier} from text. +`pypromice` has four main research purposes: -Figures can be included like this: +1. Process and handle AWS observations +2. Document AWS data processing with transparency and reproducibility +3. Supply easy and accessible methods to handle AWS data +4. Provide opportunities to contribute to the processing and handling of AWS data in an open and collaborative manner -![Caption for example figure.\label{fig:example}](https://raw.githubusercontent.com/PennyHow/GrIML/blob/main/other/reporting/figures/workflow_revised.jpg) +The `pypromice` software has been designed to handle and process data from AWSs located in Greenland. The compilation and processing of data from national AWS networks has historically been conducted through un-distributed, oftentimes proprietary software. Similar Python packages to `pypromice` have been developed to: -and referenced from text using \autoref{fig:example}. +- Process data from historical AWS in Greenland, such as the legacy GC-Net processing workflow [@vandecrux-gcnet-2020;@steffen-gcnet-2023] +- Handle data from commercial AWS, such as [pywws](https://pypi.org/project/pywws/) [@easterbrook-pywws-2023] +- Perform post-processing steps and harmonize AWS data from different institutions, such as [JAWS](https://github.com/jaws/jaws) [@zender-jaws-2019] -Figure sizes can be customized by adding an optional second parameter: +As a result, there was a key need for the development of `pypromice` in order to have a package with a complete and operational `L0` to `L3` workflow. -![Caption for example figure.](https://raw.githubusercontent.com/PennyHow/GrIML/blob/main/other/reporting/figures/workflow_revised.jpg){ width=20% } +# Usage -# Statement of need +The `pypromice` software handles data from 43 AWSs on hourly, daily and monthly time scales. The AWS data products have been used in high impact studies [@macguth-greenland-2016; @oehri_vegetation_2022; @box-greenland-2022], and have been crucial for evaluating the effect of climate change on land ice in annual reports such as the Arctic Report Card and "State of the Climate" [@moon-greenland-2022a; @moon-greenland-2022b]. The AWS data originates from three national monitoring programmes - the Programme for Monitoring of the Greenland Ice Sheet (PROMICE), the Greenland Climate Network (GC-Net) and the Greenland Ecosystem Monitoring programme (GEM). -- Need for reproducibility and transparency -- Outlines criteria for ice marginal lake classification +GEUS is responsible for the Programme for Monitoring of the Greenland Ice Sheet ([PROMICE](https://promice.org)), which is now a network of over 21 AWSs installed across the Greenland Ice Sheet [@ahlstrom-programme-2008]. Launched in 2007, these one-level tripod stations are designed to stand on ice and move with the ice flow close to the ice sheet periphery [@fausto-programme-2021; @how-one-boom-2022]. The PROMICE stations are designed to monitor the surface melt and its meteorological drivers in the ablation area of the ice sheet. +In 2021, GEUS assumed responsibility of the Greenland Climate Network (GC-Net) AWS locations [@steffen-greenland-1996], previously maintained by the United States National Science Foundation (NSF), National Aeronautics and Space Administration (NASA) and Swiss Federal Institute for Forest, Snow and Landscape Research (WSL). This expansion added 16 two-level mast stations to GEUS' sites. The data from these stations are intended to monitor conditions on the inner regions of the ice sheet, including snow accumulation and surface conditions [@how-one-boom-2022]. -# Usage +The Greenland Ecosystem Monitoring programme ([GEM](https://g-e-m.dk)) is an integrated, long-term monitoring effort that examines the effects of climate change on Arctic ecosystems. Established in 1995, GEM includes monitoring at Zackenberg, Kobbefjord, and Disko, Greenland. The program offers access to over 1000 freely-available environmental datasets, including data from 6 GEUS-designed AWS installations [@gem-glaciobasis-2020] which have been used in scientific publications [@messerli-snow-2022]. + + +# Documentation + +`pypromice` versions accompany releases of GEUS AWS data publications [@how-pypromice-2022]. + +Package documentation is available on the `pypromice` [readthedocs](https://pypromice.readthedocs.io/en/latest/). -- Use in GrIML inventory series generation +Guides for general GEUS AWS processing operations under PROMICE and GC-Net are included at the [GEUS Glaciology and Climate GitHub pages](https://geus-glaciology-and-climate.github.io/). # Acknowledgements -This work is supported by the ESA Living Planet Fellowship (4000136382/21/I-DT-lr) entitled "Examining Greenland's Ice Marginal Lakes under a Changing Climate". Further support is provided by [PROMICE](https://promice.org], funded by the [Geological Survey of Denmark and Greenland (GEUS)](https://www.geus.dk/) and the Danish Ministry of Climate, Energy and Utilities under the Danish Cooperation for Environment in the Arctic (DANCEA). +This work is funded through the Danish Ministry of Climate, Energy and Utilities via The Programme for Monitoring of the Greenland Ice Sheet (PROMICE) and the Greenland Climate Network (GC-Net). # References