Skip to content

Latest commit

 

History

History
83 lines (52 loc) · 5.65 KB

hls.md

File metadata and controls

83 lines (52 loc) · 5.65 KB

Harmonized Landsat Sentinel-2

Overview

Satellite imagery from the Landsat 8 and Sentinel-2 satellites, aligned to a common grid and processed to compatible color spaces.

The Harmonized Landsat Sentinel-2 (HLS) product includes data from the Landsat-8 and Sentinel-2 satellites, aligned to a common tiling system at 30m resolution, from 2013 to the present for Landsat and 2015 to the present for Sentinel-2. HLS is administered by the National Aeronautics and Space Administration (NASA).

This dataset is maintained by Ag-Analytics®. Ag-Analytics® also provides an API which accepts an area of interest (AOI) polygon, date range, and other options, and returns processed images for individual MSI bands as well as Normalized Difference Vegetation Index and other metrics, as well as cloud-filtered mosaics.

This dataset is updated weekly.

Storage resources

Data are stored as cloud-optimized GeoTIFF files in the East US 2 data center, in the following blob container:

https://hlssa.blob.core.windows.net/hls

Within that container, data are organized according to:

<product>/HLS.<product>.T<tileid>.<daynum>.<version>_<subdataset>.tif

  • product is L30 for Landsat, S30 for Sentinel-2
  • tileid is a four-character tile code from the Sentinel-2 tiling system
  • daynum is a four-digit year plus a three-digit day of year (from 001 to 365), e.g. 2019001 represents January 1, 2019
  • version is always v1.4
  • subdataset is a two-character, 1-indexed string indicating a subdataset (see below)

A mapping from lat/lon to tile IDs can be found here; the accompanying sample notebook demonstrates the use of this table to look up a tile ID by lat/lon. Tile IDs can also be found using the Ag-Analytics® API.

Data are provided for the United States, northern Mexico, southern Canada, France, Ireland, Germany, Ukraine, South Africa, and southeastern Australia; see the HLS coverage map for coverage areas.

Bands are as follows:

Band nameOLI band numberMSI band numberL30 subdatasetnumberS30 subdatasetnumber
Coastal aerosol110101
Blue220202
Green330303
Red440404
Red-edge 1505
Red-edge 2606
Red-edge 3707
NIR broad808
NIR narrow58A0509
SWIR 16110612
SWIR 27120713
Water vapor910
Cirrus9100811
Thermal infrared 11009
Thermal infrared 21110
QA1114

For example the following filename, HLS.S30.T16TDL.2019206.v1.4_01.tif would be located at https://hlssa.blob.core.windows.net/hls/S30/HLS.S30.T16TDL.2019206.v1.4_03.tif and would represent Sentinel-2 (S30) HLS data for tile 16TDL (primary tile 16T, sub-tile DL) for dataset band 03 (MSI Band 3, Green) for the 206th day of 2019.

Use https://planetarycomputer.microsoft.com/api/sas/v1/token/hlssa/hls to generate read-only SAS tokens to access this data.

Mounting instructions for Linux are here.

HLS data can consume hundreds of terabytes, so large-scale processing is best performed in the East US 2 Azure data center where the images are stored.

Sample code

A complete Python example of accessing and plotting HLS data is available in the accompanying sample notebook.

Contact

For questions about this dataset, contact aiforearthdatasets@microsoft.com.

Notices

Microsoft provides this dataset on an "as is" basis. Microsoft makes no warranties (express or implied), guarantees, or conditions with respect to your use of the dataset. To the extent permitted under your local law, Microsoft disclaims all liability for any damages or losses - including direct, consequential, special, indirect, incidental, or punitive - resulting from your use of this dataset. This dataset is provided under the original terms that Microsoft received source data.