USGS Landsat 8 Surface Reflectance Tier 1 [deprecated]

LANDSAT/LC08/C01/T1_SR
Dataset Availability
2013-03-18T15:59:02Z–2021-12-31T23:25:37Z
Dataset Provider
Earth Engine Snippet
ee.ImageCollection("LANDSAT/LC08/C01/T1_SR")
Tags
cfmask cloud fmask global l8sr landsat lc08 reflectance sr usgs

Description

This dataset is the atmospherically corrected surface reflectance from the Landsat 8 OLI/TIRS sensors. These images contain 5 visible and near-infrared (VNIR) bands and 2 short-wave infrared (SWIR) bands processed to orthorectified surface reflectance, and two thermal infrared (TIR) bands processed to orthorectified brightness temperature

These data have been atmospherically corrected using LaSRC and includes a cloud, shadow, water and snow mask produced using CFMASK, as well as a per-pixel saturation mask.

Strips of collected data are packaged into overlapping "scenes" covering approximately 170km x 183km using a standardized reference grid.

See also the USGS page on SR QA bands.

SR can only be produced for Landsat assets processed to the L1TP level

Data provider notes:

  • Although Surface Reflectance can be processed only from the Operational Land Imager (OLI) bands, SR requires combined OLI/Thermal Infrared Sensor (TIRS) product (LC8) input in order to generate the accompanying cloud mask. Therefore, OLI only (LO8), and TIRS only (LT8) data products cannot be calculated to SR.
  • SR is not run for a scene with a solar zenith angle greater than 76°.
  • Users are cautioned to avoid using SR for data acquired over high latitudes (> 65°).
  • The panchromatic band (ETM+ Band 7, OLI Band 8) is not processed to Surface Reflectance.
  • Efficacy of SR correction will be likely reduced in areas where atmospheric correction is affected by adverse conditions:
    • Hyper-arid or snow-covered regions
    • Low sun angle conditions
    • Coastal regions where land area is small relative to adjacent water
    • Areas with extensive cloud contamination

This product is generated by Google using a Docker image supplied by USGS.

Bands

Resolution
30 meters

Bands

Name Units Scale Wavelength Description
B1 0.0001 0.435-0.451 μm

Band 1 (ultra blue) surface reflectance

B2 0.0001 0.452-0.512 μm

Band 2 (blue) surface reflectance

B3 0.0001 0.533-0.590 μm

Band 3 (green) surface reflectance

B4 0.0001 0.636-0.673 μm

Band 4 (red) surface reflectance

B5 0.0001 0.851-0.879 μm

Band 5 (near infrared) surface reflectance

B6 0.0001 1.566-1.651 μm

Band 6 (shortwave infrared 1) surface reflectance

B7 0.0001 2.107-2.294 μm

Band 7 (shortwave infrared 2) surface reflectance

B10 K 0.1 10.60-11.19 μm

Band 10 brightness temperature. This band, while originally collected with a resolution of 100m / pixel, has been resampled using cubic convolution to 30m.

B11 K 0.1 11.50-12.51 μm

Band 11 brightness temperature. This band, while originally collected with a resolution of 100m / pixel, has been resampled using cubic convolution to 30m.

sr_aerosol

Aerosol attributes

pixel_qa

Pixel quality attributes generated from the CFMASK algorithm.

radsat_qa

Radiometric saturation QA

Image Properties

Image Properties

Name Type Description
CLOUD_COVER DOUBLE

Percentage cloud cover (0-100), -1 = not calculated. (Obtained from raw Landsat metadata)

CLOUD_COVER_LAND DOUBLE

Percentage cloud cover over land (0-100), -1 = not calculated. (Obtained from raw Landsat metadata)

EARTH_SUN_DISTANCE DOUBLE

Earth-Sun distance (AU)

ESPA_VERSION STRING

Internal ESPA image version used to compute SR

GEOMETRIC_RMSE_MODEL DOUBLE

Combined RMSE (Root Mean Square Error) of the geometric residuals (meters) in both across-track and along-track directions. (Obtained from raw Landsat metadata)

GEOMETRIC_RMSE_MODEL_X DOUBLE

RMSE (Root Mean Square Error) of the geometric residuals (meters) measured on the GCPs (Ground Control Points) used in geometric precision correction in the across-track direction. (Obtained from raw Landsat metadata)

GEOMETRIC_RMSE_MODEL_Y DOUBLE

RMSE (Root Mean Square Error) of the geometric residuals (meters) measured on the GCPs (Ground Control Points) used in geometric precision correction in the along-track direction. (Obtained from raw Landsat metadata)

IMAGE_QUALITY INT

Image quality, 0 = worst, 9 = best, -1 = quality not calculated. (Obtained from raw Landsat metadata)

LANDSAT_ID STRING

Landsat Product Identifier (Collection 1)

LEVEL1_PRODUCTION_DATE INT

Date of production for raw Level 1 data as ms since epoch

PIXEL_QA_VERSION STRING

Version of the software used to produce the 'pixel_qa' band

SATELLITE STRING

Name of satellite

SENSING_TIME STRING

Time of the observations as in ISO 8601 string. (Obtained from raw Landsat metadata)

SOLAR_AZIMUTH_ANGLE DOUBLE

Solar azimuth angle

SR_APP_VERSION STRING

LaSRC version used to process surface reflectance

WRS_PATH INT

WRS path number of scene

WRS_ROW INT

WRS row number of scene

Terms of Use

Terms of Use

Landsat datasets are federally created data and therefore reside in the public domain and may be used, transferred, or reproduced without copyright restriction.

Acknowledgement or credit of the USGS as data source should be provided by including a line of text citation such as the example shown below.

(Product, Image, Photograph, or Dataset Name) courtesy of the U.S. Geological Survey

Example: Landsat-7 image courtesy of the U.S. Geological Survey

See the USGS Visual Identity System Guidance for further details on proper citation and acknowledgement of USGS products.

Explore with Earth Engine

Code Editor (JavaScript)

/**
 * Function to mask clouds based on the pixel_qa band of Landsat 8 SR data.
 * @param {ee.Image} image input Landsat 8 SR image
 * @return {ee.Image} cloudmasked Landsat 8 image
 */
function maskL8sr(image) {
  // Bits 3 and 5 are cloud shadow and cloud, respectively.
  var cloudShadowBitMask = (1 << 3);
  var cloudsBitMask = (1 << 5);
  // Get the pixel QA band.
  var qa = image.select('pixel_qa');
  // Both flags should be set to zero, indicating clear conditions.
  var mask = qa.bitwiseAnd(cloudShadowBitMask).eq(0)
                 .and(qa.bitwiseAnd(cloudsBitMask).eq(0));
  return image.updateMask(mask);
}

var dataset = ee.ImageCollection('LANDSAT/LC08/C01/T1_SR')
                  .filterDate('2016-01-01', '2016-12-31')
                  .map(maskL8sr);

var visParams = {
  bands: ['B4', 'B3', 'B2'],
  min: 0,
  max: 3000,
  gamma: 1.4,
};
Map.setCenter(114.0079, -26.0765, 9);
Map.addLayer(dataset.median(), visParams);
Open in Code Editor