diff --git a/doc/source/tracking/icepyx_pubs.bib b/doc/source/tracking/icepyx_pubs.bib index fcc5dddea..b2f8d2ed5 100644 --- a/doc/source/tracking/icepyx_pubs.bib +++ b/doc/source/tracking/icepyx_pubs.bib @@ -1,50 +1,54 @@ % ######### materials about icepyx ################ @misc{2022_IS2-HW-tutorials, - author = {Scheick, Jessica and - Arendt, Anthony and - Haley, Charley and - Henderson, Scott and - Koh, Jane and - Setiawan, Don and - Alterman, Naomi and - Meyer, Joachim and - Cristea, Nicoleta and - Schweiger, Axel and - Barciauskas, Aimee and - Smith, Ben and - Piunno, Romina and - Shapero, Daniel and - Fair, Zachary and - Arndt, Philipp and - Leong, Wei Ji and - Sutterley, Tyler and - Snow, Tasha and - Beig, Mikala and - Besso, Hannah and - Liu, Zheng and - Joughin, Ian and - Bisson, Kelsey and - Sauthoff, Wilson}, - title = {ICESat-2 Hackweek Website}, - month = apr, - year = 2022, - note = {If you use this book, please cite it as below.}, - publisher = {Zenodo}, - version = {2022.04.15}, - doi = {10.5281/zenodo.6462479}, - url = {https://doi.org/10.5281/zenodo.6462479} +author = {Scheick, J. and + Arendt, Anthony and + Haley, Charley and + Henderson, Scott and + Koh, Jane and + Setiawan, Don and + Alterman, Naomi and + Meyer, Joachim and + Cristea, Nicoleta and + Schweiger, Axel and + Barciauskas, Aimee and + Smith, Ben and + Piunno, Romina and + Shapero, Daniel and + Fair, Zachary and + Arndt, Philipp and + Leong, Wei Ji and + Sutterley, Tyler and + Snow, Tasha and + Beig, Mikala and + Besso, Hannah and + Liu, Zheng and + Joughin, Ian and + Bisson, Kelsey and + Sauthoff, Wilson}, +title = {{ICESat-2 Hackweek Website}}, +month = apr, +year = 2022, +note = {If you use this book, please cite it as below.}, +publisher = {Zenodo}, +version = {2022.04.15}, +doi = {10.5281/zenodo.6462479}, +url = {https://doi.org/10.5281/zenodo.6462479} } -@misc{js2021agu, -author = {Scheick, J and Bisson, K and Li, T and Leong, WJ and Arendt, A}, +@article{js2021agu, +author = {Scheick, Jessica and Bisson, Kelsey and Li, Tian and Leong, Wei Ji and Arendt, Anthony}, note = {Abstract and poster (presented by Wei Ji Leong). American Geophysical Union Fall Meeting, New Orleans, LA, USA. 13-17 December 2021.}, title = {Collaborative Computational Resource Development around {ICESat-2} Data: the {icepyx} Community and Library}, -year = {2021}, +journal = {Earth and Space Science Open Archive}, +pages = {9}, +year = {2022}, +DOI = {10.1002/essoar.10511316.1}, +url = {https://doi.org/10.1002/essoar.10511316.1}, comment = {abstract, poster}, } @misc{js2020agu, -author = {Scheick, J and Arendt, A and Heagy, L and Paolo, F and Perez, F and Steiker, A}, +author = {Scheick, J. and Arendt, A. and Heagy, L. and Paolo, F. and Perez, F. and Steiker, A.}, note = {Abstract and eLightning (poster + presentation). American Geophysical Union Fall Meeting, virtual, USA. 1-17 December 2020.}, title = {{\texttt{icepyx}: Developing Community and Software Around ICESat-2 Data}}, year = {2020}, @@ -52,42 +56,42 @@ @misc{js2020agu } @misc{2020_IS2-HW-tutorials, - author = {Arendt, Anthony and - Scheick, Jessica and - Shean, David and - Buckley, Ellen and - Grigsby, Shane and - Haley, Charley and - Heagy, Lindsey and - Mohajerani, Yara and - Neumann, Tom and - Nilsson, Johan and - Markus, Thorsten and - Paolo, Fernando S. and - Perez, Fernando and - Petty, Alek and - Schweiger, Axel and - Smith, Benjamin and - Steiker, Amy and - Alvis, Sebastian and - Henderson, Scott and - Holschuh, Nick and - Liu, Zheng and - Sutterley, Tyler}, - title = {2020 {ICESat-2 Hackweek Tutorials}}, - month = aug, - year = 2020, - publisher = {Zenodo}, - version = {1.0.0}, - doi = {10.5281/zenodo.3966463}, - url = {https://doi.org/10.5281/zenodo.3966463}, - comment = {tutorials} +author = {Arendt, Anthony and + Scheick, Jessica and + Shean, David and + Buckley, Ellen and + Grigsby, Shane and + Haley, Charley and + Heagy, Lindsey and + Mohajerani, Yara and + Neumann, Tom and + Nilsson, Johan and + Markus, Thorsten and + Paolo, Fernando S. and + Perez, Fernando and + Petty, Alek and + Schweiger, Axel and + Smith, Benjamin and + Steiker, Amy and + Alvis, Sebastian and + Henderson, Scott and + Holschuh, Nick and + Liu, Zheng and + Sutterley, Tyler}, +title = {2020 {ICESat-2 Hackweek Tutorials}}, +month = aug, +year = 2020, +publisher = {Zenodo}, +version = {1.0.0}, +doi = {10.5281/zenodo.3966463}, +url = {https://doi.org/10.5281/zenodo.3966463}, +comment = {tutorials} } @misc{js2019agu, -author = {Scheick, J and Arendt, A and Heagy, L and Perez, F}, +author = {Scheick, J. and Arendt, A. and Heagy, L. and Perez, F.}, note = {Abstract and poster. American Geophysical Union Fall Meeting, San Francisco, California, USA. 9-13 December 2019.}, -title = {{Introducing} icepyx, an open source {Python} library for obtaining and working with {ICESat-2} data}, +title = {Introducing {icepyx}, an open source {Python} library for obtaining and working with {ICESat-2} data}, year = {2019}, comment = {abstract,poster}, doi = {10.1002/essoar.10501423.1}, @@ -96,11 +100,9 @@ @misc{js2019agu % ######### Articles citing icepyx ################ - - @article{Bisson:2021, author = {Bisson, K. M. and Cael, B. B.}, -title = {How Are Under Ice Phytoplankton Related to Sea Ice in the Southern Ocean?}, +title = {How Are Under Ice Phytoplankton Related to Sea Ice in the {Southern Ocean}?}, journal = {Geophysical Research Letters}, volume = {48}, number = {21}, @@ -111,7 +113,7 @@ @article{Bisson:2021 } @inProceedings{Fernando:2021, - title = {Mapping the {{Diversity}} of {{Agricultural Systems}} in the {{Cuellaje Sector}}, {{Cotacachi}}, {{Ecuador Using ATL08}} for the {{ICESat-2 Mission}} and {{Machine Learning Techniques}}}, + title = {Mapping the Diversity of Agricultural Systems in the {{Cuellaje Sector, Cotacachi, Ecuador}} Using {{ATL08}} for the {{ICESat-2 Mission}} and Machine Learning Techniques}, booktitle = {Computational {{Science}} and {{Its Applications}} \textendash{} {{ICCSA}} 2021}, author = {Fernando, Garrido}, editor = {Gervasi, Osvaldo and Murgante, Beniamino and Misra, Sanjay and Garau, Chiara and Ble{\v c}i{\'c}, Ivan and Taniar, David and Apduhan, Bernady O. and Rocha, Ana Maria A. C. and Tarantino, Eufemia and Torre, Carmelo Maria}, @@ -127,7 +129,7 @@ @inProceedings{Fernando:2021 @Article{Li:2020, AUTHOR = {Li, T. and Dawson, G. J. and Chuter, S. J. and Bamber, J. L.}, -TITLE = {Mapping the grounding zone of Larsen~C Ice Shelf, Antarctica, from ICESat-2 laser altimetry}, +TITLE = {Mapping the grounding zone of {Larsen~C Ice Shelf, Antarctica}, from {ICESat-2} laser altimetry}, JOURNAL = {The Cryosphere}, VOLUME = {14}, YEAR = {2020}, @@ -138,21 +140,65 @@ @Article{Li:2020 } +% ######### Articles about ICESat-2 ################ + +@article{is2, +title = {The {Ice, Cloud, and land Elevation Satellite-2 (ICESat-2)}: Science requirements, concept, and implementation}, +journal = {Remote Sensing of Environment}, +volume = {190}, +pages = {260-273}, +year = {2017}, +issn = {0034-4257}, +doi = {10.1016/j.rse.2016.12.029}, +url = {https://www.sciencedirect.com/science/article/pii/S0034425716305089}, +author = {Thorsten Markus and Tom Neumann and Anthony Martino and Waleed Abdalati and Kelly Brunt and Beata Csatho and Sinead Farrell and Helen Fricker and Alex Gardner and David Harding and Michael Jasinski and Ron Kwok and Lori Magruder and Dan Lubin and Scott Luthcke and James Morison and Ross Nelson and Amy Neuenschwander and Stephen Palm and Sorin Popescu and CK Shum and Bob E. Schutz and Benjamin Smith and Yuekui Yang and Jay Zwally}, +keywords = {ICESat-2, Land ice, Sea ice, Vegetation, Climate change, Satellite mission}, +abstract = {The Ice, Cloud, and land Elevation Satellite (ICESat) mission used laser altimetry measurements to determine changes in elevations of glaciers and ice sheets, as well as sea ice thickness distribution. These measurements have provided important information on the response of the cryopshere (Earth's frozen surfaces) to changes in atmosphere and ocean condition. ICESat operated from 2003 to 2009 and provided repeat altimetry measurements not only to the cryosphere scientific community but also to the ocean, terrestrial and atmospheric scientific communities. The conclusive assessment of significant ongoing rapid changes in the Earth's ice cover, in part supported by ICESat observations, has strengthened the need for sustained, high accuracy, repeat observations similar to what was provided by the ICESat mission. Following recommendations from the National Research Council for an ICESat follow-on mission, the ICESat-2 mission is now under development for planned launch in 2018. The primary scientific aims of the ICESat-2 mission are to continue measurements of sea ice freeboard and ice sheet elevation to determine their changes at scales from outlet glaciers to the entire ice sheet, and from 10s of meters to the entire polar oceans for sea ice freeboard. ICESat carried a single beam profiling laser altimeter that produced ~70m diameter footprints on the surface of the Earth at ~150m along-track intervals. In contrast, ICESat-2 will operate with three pairs of beams, each pair separated by about 3km cross-track with a pair spacing of 90m. Each of the beams will have a nominal 17m diameter footprint with an along-track sampling interval of 0.7m. The differences in the ICESat-2 measurement concept are a result of overcoming some limitations associated with the approach used in the ICESat mission. The beam pair configuration of ICESat-2 allows for the determination of local cross-track slope, a significant factor in measuring elevation change for the outlet glaciers surrounding the Greenland and Antarctica coasts. The multiple beam pairs also provide improved spatial coverage. The dense spatial sampling eliminates along-track measurement gaps, and the small footprint diameter is especially useful for sea surface height measurements in the often narrow leads needed for sea ice freeboard and ice thickness retrievals. The ICESat-2 instrumentation concept uses a low energy 532nm (green) laser in conjunction with single-photon sensitive detectors to measure range. Combining ICESat-2 data with altimetry data collected since the start of the ICESat mission in 2003, such as Operation IceBridge and ESA's CryoSat-2, will yield a 15+ year record of changes in ice sheet elevation and sea ice thickness. ICESat-2 will also provide information of mountain glacier and ice cap elevations changes, land and vegetation heights, inland water elevations, sea surface heights, and cloud layering and optical thickness.} +} + % ######### Research/Articles using (but not citing) icepyx ################ -@article{Sothe:2022, -title={Spatially Continuous Mapping of Forest Canopy Height in Canada by Combining GEDI and ICESat-2 with PALSAR and Sentinel}, -volume={14}, -ISSN={2072-4292}, -url={http://dx.doi.org/10.3390/rs14205158}, -DOI={10.3390/rs14205158}, -number={20}, -journal={Remote Sensing}, -publisher={MDPI AG}, -author={Sothe, Camile and Gonsamo, Alemu and Lourenço, Ricardo B. and Kurz, Werner A. and Snider, James}, -year={2022}, -month={Oct}, +@article{Sothe:2022, +title={Spatially Continuous Mapping of Forest Canopy Height in {Canada} by Combining {GEDI} and {ICESat-2} with {PALSAR} and {Sentinel}}, +volume={14}, +ISSN={2072-4292}, +url={http://dx.doi.org/10.3390/rs14205158}, +DOI={10.3390/rs14205158}, +number={20}, +journal={Remote Sensing}, +publisher={MDPI AG}, +author={Sothe, Camile and Gonsamo, Alemu and Lourenço, Ricardo B. and Kurz, Werner A. and Snider, James}, +year={2022}, +month={Oct}, pages={5158}, note={Attribution to icepyx from 15 Oct 2022 Twitter post, https://twitter.com/rblourenco/status/1581320878511382528} } + + +% ######### Related Software ################ + +@misc{SR, + author = {JP Swinski and + Eric Lidwa and + Tyler Sutterley and + David Shean and + Joseph H Kennedy and + Scott Henderson}, + title = {{ICESat2-SlideRule}/sliderule: v2.1.0}, + month = mar, + year = 2023, + publisher = {Zenodo}, + version = {v2.1.0}, + doi = {10.5281/zenodo.7705009}, + url = {https://doi.org/10.5281/zenodo.7705009} +} + +@misc{OA, + author = {Khalsa, S.J.S. and Borsa, A. and Nandigam, V. and others}, + title = {{OpenAltimetry} - rapid analysis and visualization of Spaceborne altimeter data}, + year = 2020, + publisher = {Earth Sci Inform}, + doi = {10.1007/s12145-020-00520-2}, + url = {https://openaltimetry.org/} +} \ No newline at end of file diff --git a/doc/source/tracking/paper.md b/doc/source/tracking/paper.md new file mode 100644 index 000000000..7a0e63690 --- /dev/null +++ b/doc/source/tracking/paper.md @@ -0,0 +1,160 @@ +--- +title: 'icepyx: querying, obtaining, analyzing, and manipulating ICESat-2 datasets' +tags: + - Python + - ICESat-2 + - LiDAR + - elevation + - community + - cloud + +authors: + - name: Jessica Scheick^[Corresponding author] # note this makes a footnote + orcid: 0000-0002-3421-4459 + affiliation: 1 + - name: Wei Ji Leong + orcid: 0000-0003-2354-1988 + affiliation: 2 + - name: Kelsey Bisson + orcid: 0000-0003-4230-3467 + affiliation: 3 + - name: Anthony Arendt + orcid: 0000-0003-0429-6905 + affiliation: 4 + - name: Shashank Bhushan + orcid: 0000-0003-3712-996X + affiliation: 4 + - name: Zachary Fair + orcid: 0000-0002-6047-1723 + affiliation: 5 + - name: Norland Raphael Hagen + orcid: 0000-0003-1994-1153 + affiliation: 6 + - name: Scott Henderson + orcid: 0000-0003-0624-4965 + affiliation: 4 + - name: Friedrich Knuth + orcid: 0000-0003-1645-1984 + affiliation: 4 + - name: Tian Li + orcid: 0000-0002-1577-4004 + affiliation: 7 + - name: Zheng Liu + orcid: 0000-0003-4132-8136 + affiliation: 4 + - name: Romina Piunno + orcid: 0009-0000-1144-0915 + affiliation: 8 + - name: Nitin Ravinder + affiliation: 9 + - name: Landung "Don" Setiawan + orcid: 0000-0002-1624-2667 + affiliation: 4 + - name: Tyler Sutterley + orcid: 0000-0002-6964-1194 + affiliation: 4 + - name: JP Swinski + affiliation: 5 + - name: Anubhav + orcid: 0000-0003-4017-2862 + affiliation: 10 + +# Note: first three authors are driving the publication. Additional contributors/authors are listed in alphabetical order by last name. Anyone who also contributes substantially to preparing the JOSS submission will be moved into ABC order after the first three and before the "non-publication" contributors to icepyx. Non-responsive coauthors will be removed from the list since their permission to be included was not granted. + +affiliations: + - name: University of New Hampshire, USA + index: 1 + - name: Development Seed, USA + index: 2 + - name: Oregon State University, USA + index: 3 + - name: University of Washington, USA + index: 4 + - name: NASA Goddard Space Flight Center, USA + index: 5 + - name: CarbonPlan, USA + index: 6 + - name: University of Bristol, UK + index: 7 + - name: University of Toronto, Canada + index: 8 + - name: University of Leeds, UK + index: 9 + - name: University of Maryland, College Park, USA + index: 10 +date: 23 September 2022 +bibliography: icepyx_pubs.bib + +# Optional fields if submitting to a AAS journal too, see this blog post: +# https://blog.joss.theoj.org/2018/12/a-new-collaboration-with-aas-publishing +aas-doi: +aas-journal: +--- + +# Summary + +icepyx is both a software library and a community composed of ICESat-2 (NASA satellite) data users, developers, maintainers, and the scientific community. +We are working together to develop a shared library of resources - including existing resources, new code, tutorials, and use-cases/examples - that simplify the process of querying, obtaining, analyzing, and manipulating ICESat-2 datasets to enable scientific discovery. + +# Statement of need + +icepyx aims to provide a clearinghouse for code, functionality to improve interoperability, documentation, examples, and educational resources that tackle disciplinary research questions while minimizing the amount of repeated effort across groups utilizing similar datasets. +icepyx also hopes to foster collaboration, open-science practices, and reproducible workflows by integrating and sharing resources. + +The Ice, Cloud, and Land Elevation Satellite-2 (ICESat-2) [@is2] was launched by NASA in September 2018. +The laser altimeter on board the satellite emits green light to the Earth's surface and measures the time until each pulse is returned to the satellite's sensors. +This information is used to determine the surface height of the land, ice, snow, trees, water, clouds, etc. that the satellite is passing over. +The instrument provides close to 500 GB of data per day, allowing scientists to investigate the surface height of earth's features in unprecedented detail. + +icepyx began during the cryosphere-themed ICESat-2 Hackweek at the University of Washington in June 2019. +At the event, there was a clear need for a collaborative, shared community space that combined and generalized the tools and materials written by past, present, and future Hackweek participants, ICESat-2 Science Team members, and the data user community. +A unified framework of code and documentated examples for downloading, reading, and visualizing ICESat-2 data that is well tested makes it more accessible for everyone to use. +The library and community continue to grow and evolve, adding new features and building scientific literacy in open-science, cloud computing, and collaborative development best practices. + +icepyx is now a foundational tool for accessing and working with ICESat-2 data, responsible for nearly a quarter of all NASA data center granule downloads in 2022. The library is complemented by a series of other specialized tools for interacting with and obtaining ICESat-2 data. These include OpenAltimetry [@OA], a browser based web tool to visualize and download selected ICESat and ICESat-2 surface heights, SlideRule [@SR], a server-side framework to create cloud-based, on-demand customized data processing for ICESat-2 data, and multiple product-focused tools for scientific data analysis (e.g. PhoREAL, PhotonLabeler). These tools are described in more detail in the icepyx documentation's [ICESat-2 Resource Guide](https://icepyx.readthedocs.io/en/latest/community/resources.html). + +icepyx is also featured in multiple scientific publications [@Bisson:2021; @Fernando:2021; @Li:2020], presentations [@js2021agu; @js2020agu; @js2019agu], and educational events/Hackweeks [@2022_IS2-HW-tutorials; @2020_IS2-HW-tutorials]. + +# Acknowledgements + +We acknowledge funding support from NASA and the University of Washington eScience Institute. +Anthony Arendt, Fernando Perez, Lindsey Heagy, and the Pangeo team provided invaluable support and guidance in establishing this library and welcoming us to the open-source community. +Amy Steiker, Mikala Beig, Nick Kotlinski, Luis Lopez, and many others at the National Snow and Ice Data Center (NSIDC) provide technical support and data access guidance. +The icepyx contributors list also includes many wonderful folks who shared ideas, provided mentoring, embraced the opportunity to engage in open-science practices while working with ICESat-2 data products, and contributed to icepyx. + + + + + + +# References