Landsat-8 L2

About Landsat 8 Level 2 Data

Mission Information

Landsat 8 is the most recently launched Landsat satellite (provided by NASA/USGS) and carries the Operational Land Imager (OLI) and the Thermal Infrared Sensor (TIRS) instruments. These two sensors provide seasonal coverage of the global landmass. Landsat 8 Level-2 (from landsat Collection 2) provides global surface reflectance and surface temperature science products. Landsat Level-2 science products are generated from Collection 2 Level-1 inputs that meet the <76 degrees Solar Zenith Angle constraint and include the required auxiliary data inputs to generate a scientifically viable product. Learn more about Level-2 here.

Basic Facts

PropertyInfo
Spatial resolution30 m (the thermal band is re-sampled from 100 m)
SensorOperational Land Imager (OLI) with 7 spectral bands and Thermal Infrared Sensor (TIRS) with 1 spectral band
Revisit time16 days
Spatial coverageWhole globe
Data availabilitySince February 2013
Common usage/purposeVegetation monitoring, land use, land cover maps and monitoring of changes.

Accessing Data

To access data you need to send a POST request to our process API. The requested data will be returned as the response to your request. Each POST request can be tailored to get you exactly the data you require. To do this requires setting various parameters which depend on the collection you are querying. This chapter will help you understand the parameters for Landsat 8 Level 2 data. For an overview of all API parameters see the API Reference.

Endpoint Locations

ServiceNotes
services-uswest2.sentinel-hub.com/apiGlobal coverage since February 2013

Data type identifier

Use LOTL2 [1] as the value of the input.data.type parameter in your API requests. This is mandatory and will ensure you get Landsat 8 Level 2 data.

The collection is currently in the preview stage and might thus change.

[1]: LOTL2 is an acronym for Landsat OLI-TIRS Level 2.

Filtering Options

This chapter will explain the input.data.dataFilter object of the process API.

mosaickingOrder

Sets the order of overlapping tiles from which the output result is mosaicked. Note that tiles will in most cases come from the same orbit/acquisition. The tiling is done by ESA for easier distribution.

ValueDescriptionNotes
mostRecentselected by default. The pixel will be selected from the tile, which was acquired most recentlyin case there are more tiles available with the same timestamp (some tiles are processed by many ground stations, some are reprocessed, etc.), the one, which was downloaded from SciHub later will be used.
leastRecentsimilar to mostRecent but in reverse order
leastCCpixel is selected from tile with the least cloud coverage meta-datanote that "per tile" information is used here, each covering about a 12,000 sq. km area, so this information is only an estimate .

maxCloudCoverage

Sets the upper limit for cloud coverage in percent based on the precomputed cloud coverage estimate for each Sentinel-1 tile as present in the tile metadata. Satellite data will therefore not be retrieved for tiles with a higher cloud coverage estimate. For example, by setting the value to 20, only tiles with at most 20% cloud coverage will be used. Note that this parameter is set per tile and might not be directly applicable to the chosen area of interest.

Processing Options

This chapter will explain the input.data.processing object of the process API.

ActionDescriptionValuesDefault
upsamplingThe same as for S2L1C.
downsamplingThe same as for S2L1C.

Available Bands and Data

Information in this chapter is useful when defining input object in evalscript. Any string listed in the column Name can be an element of the input.bands array in your evalscript.

NameDescriptionResolution
B01Ultra Blue (443 nm)30m
B02Blue (482 nm)30m
B03Green (561.5 nm)30m
B04Red (654.5 nm)30m
B05Near Infrared (NIR) (865 nm)30m
B06Shortwave Infrared (SWIR) 1 (1608.5 nm)30m
B07Shortwave Infrared (SWIR) 2 (2200.5 nm)30m
B10Thermal Infrared (TIRS) 1(10895 nm)30m [1]
BQAQuality Assessment band (QA)30m
QA_RADSATRadiometric Saturation and Terrain Occlusion QA Band30m
SR_QA_AEROSOLSR Aerosol QA30m
ST_QASurface Temperature QA30m
ST_TRADThermal band converted to radiance30m
ST_URADUpwelled Radiance30m
ST_DRADDownwelled Radiance30m
ST_ATRANAtmospheric Transmittance30m
ST_EMISEmissivity of Band 10 estimated from ASTER GED30m
ST_EMSDEmissivity standard deviation30m
ST_CDISTPixel distance to cloud30m
dataMaskThe mask of data/no data pixels (more).N/A [2]

[1]: TIRS bands are acquired at 100 meter resolution, but are resampled to 30 meter in delivered data product (source).
[2]: dataMask has no source resolution as it is calculated for each output pixel.

Units

The data values for each band in your custom script are presented in the default units as specified here. In case more than one unit is available for a given band, you may optionally set the value of input.units in your evalscript setup function to one of the options. Doing so will present data in that unit. The Source Format specifies how and with what precision the digital numbers from which the unit is derived are encoded. The Typical Range indicates what values are common for a given band and unit, however outliers can be expected.

BandsUnitSource FormatTypical RangeNotes
Optical bands
B01 - B07
REFLECTANCE [1]UINT160 - 0.4Higher values in infrared bands. Reflectance values can easily be above 1.
Thermal bands
B10 - B11
KELVIN [2]UINT16250 - 320Brightness temperature of roughly -20 to +50 C. Can reach outside this range in extreme environments.
BQAN/AUINT16bit-packed combination (info here)Use the function named decodeL8C2Qa (see).
QA_RADSATN/AUINT16bit-packed combination (info here)
SR_QA_AEROSOLN/AUINT8bit-packed combination (info here)
ST_QAKELVINFLOAT32
ST_TRAD, ST_URAD, ST_DRADRADIANCEFLOAT32
ST_ATRANN/AFLOAT32
ST_EMIS, ST_EMSDEmissivity coefficientFLOAT32
ST_CDISTKilometersFLOAT32
dataMaskN/ABoolean0 - no data
1 - data

[1]: Surface Reflectance.
[2]: Surface Brightness Temperature.

Catalog API Capabilities

The collection is currently not yet added to Catalog.