Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tsutterley/read-icesat-2
Python tools for obtaining and working with elevation data from the NASA ICESat-2 mission
https://github.com/tsutterley/read-icesat-2
altimetry icesat-2
Last synced: about 16 hours ago
JSON representation
Python tools for obtaining and working with elevation data from the NASA ICESat-2 mission
- Host: GitHub
- URL: https://github.com/tsutterley/read-icesat-2
- Owner: tsutterley
- License: mit
- Created: 2019-06-21T18:32:36.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T18:11:48.000Z (2 months ago)
- Last Synced: 2024-12-28T15:11:44.851Z (8 days ago)
- Topics: altimetry, icesat-2
- Language: Python
- Homepage: https://read-icesat-2.readthedocs.io/
- Size: 4.55 MB
- Stars: 74
- Watchers: 8
- Forks: 29
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
=============
read-ICESat-2
=============
|Language|
|License|
|PyPI Version|
|Documentation Status|
|zenodo|
|Shot Count|
.. |Language| image:: https://img.shields.io/pypi/pyversions/icesat2-toolkit?color=green
:target: https://www.python.org/
.. |License| image:: https://img.shields.io/badge/license-MIT-green.svg
:target: https://github.com/tsutterley/read-ICESat-2/blob/main/LICENSE
.. |PyPI Version| image:: https://img.shields.io/pypi/v/icesat2-toolkit.svg
:target: https://pypi.python.org/pypi/icesat2-toolkit/
.. |Documentation Status| image:: https://readthedocs.org/projects/read-icesat-2/badge/?version=latest
:target: https://read-icesat-2.readthedocs.io/en/latest/?badge=latest
.. |zenodo| image:: https://zenodo.org/badge/193143942.svg
:target: https://zenodo.org/badge/latestdoi/193143942
.. |Shot count| image:: https://img.shields.io/badge/dynamic/json?label=ICESat-2%20shot%20count&query=message&url=https%3A%2F%2Fraw.githubusercontent.com%2Ftsutterley%2Ftsutterley%2Fmaster%2FIS2-shot-count.json
:target: https://icesat-2.gsfc.nasa.gov/
Python tools for obtaining and working with elevation data from the NASA ICESat-2 mission
- https://icesat-2.gsfc.nasa.gov
- https://icesat-2-scf.gsfc.nasa.gov
- https://nsidc.org/data/icesat-2/
ICESat-2 Data Products
######################
+-----------+------------------------------+-------------------------------------------+
| Product | Name | Description |
+===========+==============================+===========================================+
| **ATL00** | Telemetry Data | Raw ATLAS telemetry in packet format |
+-----------+------------------------------+-------------------------------------------+
| **ATL01** | Reformatted Telemetry | Parsed, partially reformatted into HDF5, |
| | | generated daily, segmented into several |
| | | minute granules |
+-----------+------------------------------+-------------------------------------------+
| **ATL02** | Science Unit Converted | Photon time of flight, corrected for |
| | Telemetry | instrument effects. Includes all photons, |
| | | pointing data, spacecraft position, |
| | | housekeeping data, engineering data, and |
| | | raw atmospheric profiles, segmented into |
| | | several minute granules. |
+-----------+------------------------------+-------------------------------------------+
| **ATL03** | Global Geolocated Photon | Precise latitude, longitude and elevation |
| | Data | for every received photon, arranged by |
| | | beam in the along-track direction. |
| | | Photons classified by signal vs. |
| | | background, as well as by surface type |
| | | (land ice, sea ice, land, ocean), |
| | | including all geophysical corrections. |
| | | Segmented into several minute granules. |
+-----------+------------------------------+-------------------------------------------+
| **ATL04** | Uncalibrated Backscatter | Along-track atmospheric backscatter data, |
| | Profiles | 25 times per second. Includes calibration |
| | | coefficients for polar regions. Segmented |
| | | into several minute granules. |
+-----------+------------------------------+-------------------------------------------+
| **ATL06** | Land Ice Elevation | Surface height for each beam with along- |
| | | and across-track slopes calculated for |
| | | each beam pair. Posted at 40 meters |
| | | along-track. Segmented into several |
| | | minute granules. |
+-----------+------------------------------+-------------------------------------------+
| **ATL07** | Arctic/Antarctic Sea Ice | Height of sea ice and open water leads at |
| | Elevation | varying length scale based on returned |
| | | photon rate for each beam presented |
| | | along-track. Segmented into several |
| | | minute granules. |
+-----------+------------------------------+-------------------------------------------+
| **ATL08** | Land Water Vegetation | Height of ground including canopy surface |
| | Elevation | posted at variable length scales relative |
| | | to signal level, for each beam presented |
| | | along-track. Where data permits include |
| | | canopy height, canopy cover percentage, |
| | | surface slope and roughness, and apparent |
| | | reflectance. |
+-----------+------------------------------+-------------------------------------------+
| **ATL09** | Calibrated Backscatter and | Along-track cloud and other significant |
| | Cloud Characteristics | atmosphere layer heights, blowing snow, |
| | | integrated backscatter, and optical |
| | | depth. |
+-----------+------------------------------+-------------------------------------------+
| **ATL10** | Arctic/Antarctic Sea Ice | Estimate of sea ice freeboard over |
| | Freeboard | specific spatial scales using all |
| | | available sea surface height |
| | | measurements. Contains statistics of sea |
| | | surface and sea ice heights. |
+-----------+------------------------------+-------------------------------------------+
| **ATL11** | Antarctic/Greenland Ice | Time series of height at points on the |
| | Sheet H(t) Series | ice sheet, calculated based on repeat |
| | | tracks and/or cross-overs. |
+-----------+------------------------------+-------------------------------------------+
| **ATL12** | Ocean Elevation | Surface height at specific length scale. |
+-----------+------------------------------+-------------------------------------------+
| **ATL13** | Inland Water Height | Along-track inland and near shore water |
| | | surface height distribution within water |
| | | mask. |
+-----------+------------------------------+-------------------------------------------+
| **ATL14** | Antarctic/Greenland Ice | Height maps of each ice sheet for each |
| | Sheet H(t) Gridded | year based on all available elevation |
| | | data. |
+-----------+------------------------------+-------------------------------------------+
| **ATL15** | Antarctic/Greenland Ice | Height change maps for each ice sheet, |
| | Sheet dh/dt Gridded | for each mission year, and for the whole |
| | | mission. |
+-----------+------------------------------+-------------------------------------------+
| **ATL16** | ATLAS Atmosphere Weekly | Polar cloud fraction, blowing snow |
| | | frequency, ground detection frequency. |
+-----------+------------------------------+-------------------------------------------+
| **ATL17** | ATLAS Atmosphere Monthly | Polar cloud fraction, blowing snow |
| | | frequency, ground detection frequency. |
+-----------+------------------------------+-------------------------------------------+
| **ATL18** | Land/Canopy Gridded | Gridded ground surface height, canopy |
| | | height, and canopy cover estimates. |
+-----------+------------------------------+-------------------------------------------+
| **ATL19** | Mean Sea Surface (MSS) | Gridded ocean height product. |
+-----------+------------------------------+-------------------------------------------+
| **ATL20** | Arctic/Antarctic Gridded Sea | Gridded sea ice freeboard. |
| | Ice Freeboard | |
+-----------+------------------------------+-------------------------------------------+
| **ATL21** | Arctic/Antarctic Gridded Sea | Gridded monthly sea surface height inside |
| | Surface Height w/in Sea Ice | the sea ice cover. |
+-----------+------------------------------+-------------------------------------------+
ICESat-2 Granules
#################
Each orbit of ICESat-2 data is broken up into 14 granules.
The granule boundaries limit the size of each ATL03 file and simplify the formation of higher level data products.
.. image:: ./doc/source/_assets/ICESat-2_granules_global.png
:alt: ICESat-2 global granules
.. image:: ./doc/source/_assets/ICESat-2_granules_polar.png
:alt: ICESat-2 polar granules
Dependencies
############
- `numpy: Scientific Computing Tools For Python `_
- `scipy: Scientific Tools for Python `_
- `mpi4py: Python bindings of the Message Passing Interface (MPI) `_
- `h5py: Python interface for Hierarchal Data Format 5 (HDF5) `_
- `netCDF4: Python interface to the netCDF C library `_
- `zarr: Chunked, compressed, N-dimensional arrays in Python `_
- `pandas: Python Data Analysis Library `_
- `scikit-learn: Machine Learning in Python `_
- `dateutil: powerful extensions to datetime `_
- `shapely: PostGIS-ish operations outside a database context for Python `_
- `fiona: Python wrapper for vector data access functions from the OGR library `_
- `future: Compatibility layer between Python 2 and Python 3 `_
- `boto3: Amazon Web Services (AWS) SDK for Python `_
- `s3fs: Pythonic file interface to S3 built on top of botocore `_
- `lxml: processing XML and HTML in Python `_
- `paramiko: Native Python SSHv2 protocol library `_
- `scp: scp module for paramiko `_
- `yapc: Python version of the NASA Goddard Space Flight Center YAPC Program `_
Download
########
| The program homepage is:
| https://github.com/tsutterley/read-icesat-2
| A zip archive of the latest version is available directly at:
| https://github.com/tsutterley/read-icesat-2/archive/main.zip
Disclaimer
##########
This project contains work and contributions from the `scientific community <./CONTRIBUTORS.rst>`_.
This program is not sponsored or maintained by the Universities Space Research Association (USRA) or NASA.
It is provided here for your convenience but *with no guarantees whatsoever*.
License
#######
The content of this project is licensed under the
`Creative Commons Attribution 4.0 Attribution license `_
and the source code is licensed under the `MIT license `_.