The MATLAB functions in this repository are designed to make it easy and efficient to work with ITS_LIVE version 2 annual and climatology velocity mosaic data.
Get ITS_LIVE v2 velocity mosaics in any of these ways:
- Explore and download velocity mosaics in NetCDF or Cloud Optimized GeoTiff (COG) format through the NSIDC ITS_LIVE app,
- Download the annual and climatology mosaics directly from from AWS, or
- If you know which region and years of mosaics you want, use the
itslive_mosaic_downloaderfunction included in this repo.
After downloading the data, put the NetCDF(s) somewhere MATLAB can find them. I personally have a folder called data, and I have a startup.m file in my home directory that contains this line:
addpath(genpath('/Users/cgreene/Documents/data'))
which automatically adds the path to the data folder and all of its subfolders every time I start MATLAB.
itslive_mosaic_downloader downloads all of the annual mosaics for a given region.
itslive_regions displays ITS_LIVE regions that follow Randolph Glacier Inventory v6 conventions.
itslive2geo transforms projected map coordinates to geographic coordinates1.
geo2itslive transforms geographic coordinates to ITS_LIVE velocity mosaic map projected coordinates 1.
itslive_data loads ITS_LIVE velocity mosaic data.
itslive_interp interpolates ITS_LIVE velocity mosaic data to specified locations.
itslive_imagesc plots ITS_LIVE mosaic data as an imagesc plot.
itslive_quiver plots ITS_LIVE velocity data as quiver arrows.
itslive_flowline calculates flowlines from ITS_LIVE velocity mosaics.
This repository and the functions in it were initially developed in 2019 for the release of ITS_LIVE version 1. The mosaics in ITS_LIVE version 2 have now been revamped, variable names changed, file naming conventions changed, and most of the old functions required significant changes to work with the new mosaics. Accordingly, the version 2.0 updates to this repo in November 2024 contain many breaking changes from previous versions.
The ITS_LIVE data and these functions are free for all to use. We do ask that you please cite the dataset, and if relevant cite my Antarctic Mapping Tools paper too. Wording might be something like, "Velocity data generated using auto-RIFT (Gardner et al., 2018) and provided by the NASA MEaSUREs ITS_LIVE project (Gardner et al., 2019). Analysis was performed with Antarctic Mapping Tools for Matlab (Greene et al., 2017)"
Gardner, A. S., M. A. Fahnestock, and T. A. Scambos, 2019 [update to time of data download]: ITS_LIVE Regional Glacier and Ice Sheet Surface Velocities. Data archived at National Snow and Ice Data Center; doi:10.5067/6II6VW8LLWJ7.
Gardner, A. S., G. Moholdt, T. Scambos, M. Fahnstock, S. Ligtenberg, M. van den Broeke, and J. Nilsson, 2018: Increased West Antarctic and unchanged East Antarctic ice discharge over the last 7 years, Cryosphere, 12(2): 521–547, doi:10.5194/tc-12-521-2018.
Greene, C. A., D. E. Gwyther, and D. D. Blankenship, 2017 “Antarctic Mapping Tools for Matlab.” Computers & Geosciences, (104) 151–157, doi:10.1016/j.cageo.2016.08.003.