/NDH_MatlabTools

Matlab tools for cryospheric data analysis: ICESat-2, CReSIS/OIB Radar, Altimetry, and Velocity

Primary LanguageMATLAB


NDH_MatlabTools

Report Bug · Request Feature


This repository contains a set of functions for analyzing ICESat-2 Data, ice penetrating radar data from the Center for Remote Sensing of Ice Sheets, and other cryospheric geophysical data. In addition, there are a series of tutorial notebooks that break-down how to read and interpret many of these polar geophysical datasets.

NASA-80NSSC20K0958, NASA-80NSSC21K0753, NSF-2019719, and NSF-2118285.

Table of Contents

  1. About The Project
  2. Applications in Cryospheric Science
  3. Contributing
  4. License
  5. Contact
  6. Acknowledgments

About The Project

These tools were primarily designed for use within the Holschuh lab group, but in the spirit of open science, we want to make anything that might be useful available for public use. There will likely be parts of the code that do not work when you clone this library, but it is hard for me to know all the ways this code may fail until you all test it! Feel free to reach out if something doesn't work, and I'm happy to help you debug.

(back to top)

Applications

The following sections provide a list of the functions that may be useful to you. Each function has a description in its header, but we provide a brief statement for each below.

In addition, there are a set of tools that allow for interactive data selection from plots within the "Graphical_Selection_Tools" directory.

ICESat

Within the "NDH_ICESat_Tools" directory, there are several function that can help you read and manipulate ICESat-2 data.

  • read_GLAH12_h5: Allows you to read in the full GLAH12 data, subsets based on variable names, or subsets based on position in the file.
  • restructure_GLAH12: This converts the GLAH12 data (read by read_GLAH12_h5) to a friendlier format for use.

ICESat 2

Within the "NDH_ICESat2_Tools" directory, there are several function that can help you read and manipulate ICESat-2 data.

  • read_ATL03_h5: Allows you to read in the full ATL03 data, subsets based on variable names, or subsets based on segids.
  • read_ATL06_h5: Allows you to read in the full ATL06 data, subsets based on variable names, or subsets based on segids.
  • read ATL11_h5: Allows you to read in the full ATL11 data, subsets based on variable names, or subsets based on segids.
  • restructure_ATL06: This converts the ATL06 data (read by read_ATL06_h5) to a friendlier format for use.
  • restructure_ATL11: This converts the ATL06 data (read by read_ATL11_h5) to a friendlier format for use.

Ice Penetrating Radar Data

Within the "NDH_CReSIS_Tools" directory, there are several function that can help you read and manipulate ICESat-2 data.

  • depth_shift: This function takes in a radar dataset and converts it from two-way travel time to depth.
  • elevation_shift: This function takes in a radar dataset and converts it from two-way travel time to absolute elevation (WGS84)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Nick Holschuh - nholschuh@amherst.edu

Project Link: https://github.com/nholschuh/NDH_MatlabTools

(back to top)

Acknowledgments

  • Much of the code here was built in support of my wonderful students at Amherst. Don't underestimate a passionate Amherst student!

(back to top)