Updated 11 Dec 2014
This function searches the USGS website for low-resolution Landsat 8 images of specified path and row number and plots the most recent image in georeferenced coordinates.
[I,ImageDate,R,h] = landsat(...)
landsat(WRS2path,WRS2row) plots the most recent available Landsat 8 image for World Reference System 2 (WRS2) path/row combination given by WRS2path, WRS2row.
landsat(...,ImageDate) specifies a search date to start from. By default, ImageDate is the current date, and the landsat function searches each day going back in time until a valid image is found. If you know an exact image date, enter that date instead as a string (e.g., 'January 5, 2014' or in Matlab's datenum format. If you enter an ImageDate as 'January 5, 2014', landsat will look for an image on that date, if no images exist on Jan. 5, it will look on Jan. 4, then Jan. 3, and so on until a valid image is found. Alternatively, if ImageDate is a negative scalar integer N, searching will begin with today, and skip or ignore the most recent N valid images.
I = landsat(...,'nomap') returns the Landsat 8 image I and the 'nomap' command specifies that no map will be created. If you do not have a license for Matlab's Mapping Toolbox, specify 'nomap'. You won't be able to make maps or get georeferencing information, but at least you'll get an image.
[I,ImageDate,R,h] = landsat(...) also returns a georeferencing matrix R, a handle h of plotted image, and the ImageDate in datenum format.
How this function works
This function requires an internet connection. Starting with any specified date, or the current date if no date is specified, landsat searches back through time, attempting to access Landsat 8 images on the USGS website. When an image is found, landsat will attempt to georeference and plot it.
Georeferencing by this function may not always be perfect, and images plotted by this function are of rather low resolution, so if accuracy or precision are important for your work, consider using Level 1 GeoTiff data instead.
Currently, this function only attempts to access Landsat 8 data. Functionality may be extended to other Landsat missions in the future. May not.
Chad Greene (2023). landsat (https://www.mathworks.com/matlabcentral/fileexchange/48726-landsat), MATLAB Central File Exchange. Retrieved .
MATLAB Release Compatibility
Platform CompatibilityWindows macOS Linux
- Mathematics and Optimization > Mapping Toolbox > File Import and Export >
- Radar > Mapping Toolbox > File Import and Export >
Inspired by: zoharby/plot_google_map, LANDSAT ETM+ MTL parser, LANDSAT MSS/TM/ETM+ metadata (.MTL) Parser, scalebar for maps, geoimread, MODIS Mosaic of Antarctica, Antarctic Mapping Tools, geotiffinterp, parseLandSat8MetaData(filename), loadLandSat8(metaFileName,bandList)
Inspired: How to drape Landsat images over Bedmap2 topography, L8read Landsat 8 Level 1 tiff reader, LIMA Landsat Image Mosaic of Antarctica
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!Start Hunting!
Discover Live Editor
Create scripts with code, output, and formatted text in a single executable document.