USGS Landsat 7 Collection 1 Tier 1 TOA Reflectance

LANDSAT/LE07/C01/T1_TOA
Dataset Provider
USGS/Google
Earth Engine Snippet
ee.ImageCollection("LANDSAT/LE07/C01/T1_TOA")
Tags
global toa landsat usgs

Description

Landsat 7 Collection 1 Tier 1 calibrated top-of-atmosphere (TOA) reflectance. Calibration coefficients are extracted from the image metadata. See Chander et al. (2009) for details on the TOA computation.

Bands

Bands

Name Resolution Wavelength Description
B1 30 meters 0.45 - 0.52 µm

Blue

B2 30 meters 0.52 - 0.60 µm

Green

B3 30 meters 0.63 - 0.69 µm

Red

B4 30 meters 0.77 - 0.90 µm

Near infrared

B5 30 meters 1.55 - 1.75 µm

Shortwave infrared 1

B6_VCID_1 30 meters 10.40 - 12.50 µm

Low-gain Thermal Infrared 1. This band has expanded dynamic range and lower radiometric resolution (sensitivity), with less saturation at high Digital Number (DN) values. Resampled from 60m to 30m.

B6_VCID_2 30 meters 10.40 - 12.50 µm

High-gain Thermal Infrared 1. This band has higher radiometric resolution (sensitivity), although it has a more restricted dynamic range. Resampled from 60m to 30m.

B7 30 meters 2.08 - 2.35 µm

Shortwave infrared 2

B8 15 meters 0.52 - 0.90 µm

Panchromatic

BQA

Landsat Collection 1 QA Bitmask (See Landsat QA page)

Image Properties

Image Properties

Name Type Description
CLOUD_COVER DOUBLE

Percentage cloud cover, -1 = not calculated.

CLOUD_COVER_LAND DOUBLE

Percentage cloud cover over land, -1 = not calculated.

COLLECTION_CATEGORY STRING

Tier of scene. (T1 or T2)

COLLECTION_NUMBER DOUBLE

Number of collection.

CORRECTION_BIAS_BAND_1 STRING

Internal calibration bias method for band 1.

CORRECTION_BIAS_BAND_2 STRING

Internal calibration bias method for band 2.

CORRECTION_BIAS_BAND_3 STRING

Internal calibration bias method for band 3.

CORRECTION_BIAS_BAND_4 STRING

Internal calibration bias method for band 4.

CORRECTION_BIAS_BAND_5 STRING

Internal calibration bias method for band 5.

CORRECTION_BIAS_BAND_6_VCID_1 STRING

Internal calibration bias method for band 6_VICD_1.

CORRECTION_BIAS_BAND_6_VCID_2 STRING

Internal calibration bias method for band 6_VICD_2.

CORRECTION_BIAS_BAND_7 STRING

Internal calibration bias method for band 7.

CORRECTION_BIAS_BAND_8 STRING

Internal calibration bias method for band 8.

CORRECTION_GAIN_BAND_1 STRING

Internal calibration gain method for band 1.

CORRECTION_GAIN_BAND_2 STRING

Internal calibration gain method for band 2.

CORRECTION_GAIN_BAND_3 STRING

Internal calibration gain method for band 3.

CORRECTION_GAIN_BAND_4 STRING

Internal calibration gain method for band 4.

CORRECTION_GAIN_BAND_5 STRING

Internal calibration gain method for band 5.

CORRECTION_GAIN_BAND_6_VCID_1 STRING

Internal calibration gain method for band 6_VCID_1.

CORRECTION_GAIN_BAND_6_VCID_2 STRING

Internal calibration gain method for band 6_VCID_2.

CORRECTION_GAIN_BAND_7 STRING

Internal calibration gain method for band 7.

CORRECTION_GAIN_BAND_8 STRING

Internal calibration gain method for band 8.

CPF_NAME STRING

Calibration parameter file name.

DATA_CATEGORY STRING

Current data category assigned to the data. Possible values: ("NOMINAL", "VALIDATION", "EXCHANGE", "TEST", "ENGINEERING")

DATA_TYPE STRING

Data type identifier. (L1T or L1G)

DATE_ACQUIRED STRING

Image acquisition date. "YYYY-MM-DD"

DATUM STRING

Datum used in image creation.

EARTH_SUN_DISTANCE DOUBLE

Earth sun distance in astronomical units (AU).

ELEVATION_SOURCE STRING

Elevation model source used for standard terrain corrected (L1T) products.

ELLIPSOID STRING

Ellipsoid used in image creation.

EPHEMERIS_TYPE STRING

Ephemeris data type used to perform geometric correction. (Definitive or Predictive)

FILE_DATE DOUBLE

File date in milliseconds since epoch.

GAIN_BAND_1 STRING

Gain state for Band 1. (L = Low gain, H = High)

GAIN_BAND_2 STRING

Gain state for Band 2. (L = Low gain, H = High)

GAIN_BAND_3 STRING

Gain state for Band 3. (L = Low gain, H = High)

GAIN_BAND_4 STRING

Gain state for Band 4. (L = Low gain, H = High)

GAIN_BAND_5 STRING

Gain state for Band 5. (L = Low gain, H = High)

GAIN_BAND_6_VCID_1 STRING

Gain state for Band 6 VCID_1. (L = Low gain, H = High)

GAIN_BAND_6_VCID_2 STRING

Gain state for Band 6 VCID_2. (L = Low gain, H = High)

GAIN_BAND_7 STRING

Gain state for Band 7. (L = Low gain, H = High)

GAIN_BAND_8 STRING

Gain state for Band 8. (L = Low gain, H = High)

GAIN_CHANGE_BAND_1 STRING

Presence and direction of gain change for Band 1 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_2 STRING

Presence and direction of gain change for Band 2 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_3 STRING

Presence and direction of gain change for Band 3 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_4 STRING

Presence and direction of gain change for Band 4 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_5 STRING

Presence and direction of gain change for Band 5 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_6_VCID_1 STRING

Presence and direction of gain change for Band 6 VCID_1 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_6_VCID_2 STRING

Presence and direction of gain change for Band 6 VCID_2 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_7 STRING

Presence and direction of gain change for Band 7 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_BAND_8 STRING

Presence and direction of gain change for Band 8 (LL = no change, HH = no change, LH = low to high, HL = high to low, U = Unknown).

GAIN_CHANGE_SCAN_BAND_1 DOUBLE

Scan line number where the first change in Band 1 gain was detected.

GAIN_CHANGE_SCAN_BAND_2 DOUBLE

Scan line number where the first change in Band 2 gain was detected.

GAIN_CHANGE_SCAN_BAND_3 DOUBLE

Scan line number where the first change in Band 3 gain was detected.

GAIN_CHANGE_SCAN_BAND_4 DOUBLE

Scan line number where the first change in Band 4 gain was detected.

GAIN_CHANGE_SCAN_BAND_5 DOUBLE

Scan line number where the first change in Band 5 gain was detected.

GAIN_CHANGE_SCAN_BAND_6_VCID_1 DOUBLE

Scan line number where the first change in Band 6 VCID 1 gain was detected.

GAIN_CHANGE_SCAN_BAND_6_VCID_2 DOUBLE

Scan line number where the first change in Band 6 VCID 2 gain was detected.

GAIN_CHANGE_SCAN_BAND_7 DOUBLE

Scan line number where the first change in Band 7 gain was detected.

GAIN_CHANGE_SCAN_BAND_8 DOUBLE

Scan line number where the first change in Band 8 gain was detected.

GEOMETRIC_RMSE_MODEL DOUBLE

Combined Root Mean Square Error (RMSE) of the geometric residuals (metres) in both across-track and along-track directions measured on the GCPs used in geometric precision correction. Not present in L1G products.

GEOMETRIC_RMSE_MODEL_X DOUBLE

RMSE of the X direction geometric residuals (in metres) measured on the GCPs used in geometric precision correction. Not present in L1G products.

GEOMETRIC_RMSE_MODEL_Y DOUBLE

RMSE of the Y direction geometric residuals (in metres) measured on the GCPs used in geometric precision correction. Not present in L1G products.

GRID_CELL_SIZE_PANCHROMATIC DOUBLE

Grid cell size used in creating the image for the panchromatic band.

GRID_CELL_SIZE_REFLECTIVE DOUBLE

Grid cell size used in creating the image for the reflective band.

GRID_CELL_SIZE_THERMAL DOUBLE

Grid cell size used in creating the image for the thermal band.

GROUND_CONTROL_POINTS_MODEL DOUBLE

The number of ground control points used. Not used in L1GT products. Values: 0 - 999 (0 is used for L1T products that have used Multi-scene refinement).

GROUND_CONTROL_POINTS_VERIFY DOUBLE

The number of ground control points used in the verification of the terrain corrected product. Values: -1 to 1615 (-1 = not available)

GROUND_CONTROL_POINTS_VERSION DOUBLE

The number of ground control points used in the verification of the terrain corrected product. Values: -1 to 1615 (-1 = not available)

IMAGE_QUALITY DOUBLE

Image quality, 0 = worst, 9 = best, -1 = quality not calculated

K1_CONSTANT_BAND_6_VCID_1 DOUBLE

Calibration K1 constant for Band 6 VCID 1 radiance to temperature conversion.

K1_CONSTANT_BAND_6_VCID_2 DOUBLE

Calibration K1 constant for Band 6 VCID 2 radiance to temperature conversion.

K2_CONSTANT_BAND_6_VCID_1 DOUBLE

Calibration K2 constant for Band 6 VCID 1 radiance to temperature conversion.

K2_CONSTANT_BAND_6_VCID_2 DOUBLE

Calibration K2 constant for Band 6 VCID 2 radiance to temperature conversion.

LANDSAT_PRODUCT_ID STRING

The naming convention of each Landsat Collection 1 Level-1 image based on acquisition parameters and processing parameters.

Format: LXSS_LLLL_PPPRRR_YYYYMMDD_yyyymmdd_CC_TX

  • L = Landsat
  • X = Sensor (O = Operational Land Imager, T = Thermal Infrared Sensor, C = Combined OLI/TIRS)
  • SS = Satellite (08 = Landsat 8)
  • LLLL = Processing Correction Level (L1TP = precision and terrain, L1GT = systematic terrain, L1GS = systematic)
  • PPP = WRS Path
  • RRR = WRS Row
  • YYYYMMDD = Acquisition Date expressed in Year, Month, Day
  • yyyymmdd = Processing Date expressed in Year, Month, Day
  • CC = Collection Number (01)
  • TX = Collection Category (RT = Real Time, T1 = Tier 1, T2 = Tier 2)
LANDSAT_PRODUCT_ID PROPERTY_TYPE_UNSPECIFIED
LANDSAT_SCENE_ID STRING

The Pre-Collection naming convention of each image is based on acquisition parameters. This was the naming convention used prior to Collection 1.

Format: LXSPPPRRRYYYYDDDGSIVV

  • L = Landsat
  • X = Sensor (O = Operational Land Imager, T = Thermal Infrared Sensor, C = Combined OLI/TIRS)
  • S = Satellite (08 = Landsat 8)
  • PPP = WRS Path
  • RRR = WRS Row
  • YYYY = Year of Acquisition
  • DDD = Julian Day of Acquisition
  • GSI = Ground Station Identifier
  • VV = Version
MAP_PROJECTION STRING

Projection used to represent the 3-dimensional surface of the earth for the Level-1 product.

MAP_PROJECTION_L0RA STRING

L0RA map projection selectively applied to HDTs based on geographic location. Used for processed archive data.

ORIENTATION STRING

Orientation used in creating the image. Values: NOMINAL = Nominal Path, NORTH_UP = North Up, TRUE_NORTH = True North, USER = User

PANCHROMATIC_LINES DOUBLE

Number of product lines for the panchromatic band.

PANCHROMATIC_SAMPLES DOUBLE

Number of product samples for the panchromatic bands.

PROCESSING_SOFTWARE_VERSION STRING

Name and version of the processing software used to generate the L1 product.

RADIANCE_ADD_BAND_1 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 1.

RADIANCE_ADD_BAND_2 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 2.

RADIANCE_ADD_BAND_3 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 3.

RADIANCE_ADD_BAND_4 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 4.

RADIANCE_ADD_BAND_5 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 5.

RADIANCE_ADD_BAND_6_VCID_1 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 6 VCID 1.

RADIANCE_ADD_BAND_6_VCID_2 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 6 VCID 2.

RADIANCE_ADD_BAND_7 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 7.

RADIANCE_ADD_BAND_8 DOUBLE

Additive rescaling factor used to convert calibrated DN to radiance for Band 8.

RADIANCE_MAXIMUM_BAND_1 DOUBLE

Maximum achievable spectral radiance value for Band 1.

RADIANCE_MAXIMUM_BAND_2 DOUBLE

Maximum achievable spectral radiance value for Band 2.

RADIANCE_MAXIMUM_BAND_3 DOUBLE

Maximum achievable spectral radiance value for Band 3.

RADIANCE_MAXIMUM_BAND_4 DOUBLE

Maximum achievable spectral radiance value for Band 4.

RADIANCE_MAXIMUM_BAND_5 DOUBLE

Maximum achievable spectral radiance value for Band 5.

RADIANCE_MAXIMUM_BAND_6_VCID_1 DOUBLE

Maximum achievable spectral radiance value for Band 6 VCID 1.

RADIANCE_MAXIMUM_BAND_6_VCID_2 DOUBLE

Maximum achievable spectral radiance value for Band 6 VCID 2.

RADIANCE_MAXIMUM_BAND_7 DOUBLE

Maximum achievable spectral radiance value for Band 7.

RADIANCE_MAXIMUM_BAND_8 DOUBLE

Maximum achievable spectral radiance value for Band 8.

RADIANCE_MINIMUM_BAND_1 DOUBLE

Minimum achievable spectral radiance value for Band 1.

RADIANCE_MINIMUM_BAND_2 DOUBLE

Minimum achievable spectral radiance value for Band 2.

RADIANCE_MINIMUM_BAND_3 DOUBLE

Minimum achievable spectral radiance value for Band 3.

RADIANCE_MINIMUM_BAND_4 DOUBLE

Minimum achievable spectral radiance value for Band 4.

RADIANCE_MINIMUM_BAND_5 DOUBLE

Minimum achievable spectral radiance value for Band 5.

RADIANCE_MINIMUM_BAND_6_VCID_1 DOUBLE

Minimum achievable spectral radiance value for Band 6 VCID 1.

RADIANCE_MINIMUM_BAND_6_VCID_2 DOUBLE

Minimum achievable spectral radiance value for Band 6 VCID 2.

RADIANCE_MINIMUM_BAND_7 DOUBLE

Minimum achievable spectral radiance value for Band 7.

RADIANCE_MINIMUM_BAND_8 DOUBLE

Minimum achievable spectral radiance value for Band 8.

RADIANCE_MULT_BAND_1 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 1 DN to radiance.

RADIANCE_MULT_BAND_2 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 2 DN to radiance.

RADIANCE_MULT_BAND_3 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 3 DN to radiance.

RADIANCE_MULT_BAND_4 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 4 DN to radiance.

RADIANCE_MULT_BAND_5 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 5 DN to radiance.

RADIANCE_MULT_BAND_6_VCID_1 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 6 VCID 1 DN to radiance.

RADIANCE_MULT_BAND_6_VCID_2 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 6 VCID 2 DN to radiance.

RADIANCE_MULT_BAND_7 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 7 DN to radiance.

RADIANCE_MULT_BAND_8 DOUBLE

Multiplicative rescaling factor used to convert calibrated Band 8 DN to radiance.

REFLECTANCE_ADD_BAND_1 DOUBLE

Additive rescaling factor used to convert calibrated Band 1 DN to reflectance.

REFLECTANCE_ADD_BAND_2 DOUBLE

Additive rescaling factor used to convert calibrated Band 2 DN to reflectance.

REFLECTANCE_ADD_BAND_3 DOUBLE

Additive rescaling factor used to convert calibrated Band 3 DN to reflectance.

REFLECTANCE_ADD_BAND_4 DOUBLE

Additive rescaling factor used to convert calibrated Band 4 DN to reflectance.

REFLECTANCE_ADD_BAND_5 DOUBLE

Additive rescaling factor used to convert calibrated Band 5 DN to reflectance.

REFLECTANCE_ADD_BAND_7 DOUBLE

Additive rescaling factor used to convert calibrated Band 7 DN to reflectance.

REFLECTANCE_ADD_BAND_8 DOUBLE

Additive rescaling factor used to convert calibrated Band 8 DN to reflectance.

REFLECTANCE_MAXIMUM_BAND_1 DOUBLE

Maximum achievable spectral reflectance value for Band 1.

REFLECTANCE_MAXIMUM_BAND_2 DOUBLE

Maximum achievable spectral reflectance value for Band 2.

REFLECTANCE_MAXIMUM_BAND_3 DOUBLE

Maximum achievable spectral reflectance value for Band 3.

REFLECTANCE_MAXIMUM_BAND_4 DOUBLE

Maximum achievable spectral reflectance value for Band 4.

REFLECTANCE_MAXIMUM_BAND_5 DOUBLE

Maximum achievable spectral reflectance value for Band 5.

REFLECTANCE_MAXIMUM_BAND_7 DOUBLE

Maximum achievable spectral reflectance value for Band 7.

REFLECTANCE_MAXIMUM_BAND_8 DOUBLE

Maximum achievable spectral reflectance value for Band 8.

REFLECTANCE_MINIMUM_BAND_1 DOUBLE

Minimum achievable spectral reflectance value for Band 1.

REFLECTANCE_MINIMUM_BAND_2 DOUBLE

Minimum achievable spectral reflectance value for Band 2.

REFLECTANCE_MINIMUM_BAND_3 DOUBLE

Minimum achievable spectral reflectance value for Band 3.

REFLECTANCE_MINIMUM_BAND_4 DOUBLE

Minimum achievable spectral reflectance value for Band 4.

REFLECTANCE_MINIMUM_BAND_5 DOUBLE

Minimum achievable spectral reflectance value for Band 5.

REFLECTANCE_MINIMUM_BAND_7 DOUBLE

Minimum achievable spectral reflectance value for Band 7.

REFLECTANCE_MINIMUM_BAND_8 DOUBLE

Minimum achievable spectral reflectance value for Band 8.

REFLECTANCE_MULT_BAND_1 DOUBLE

Multiplicative factor used to convert calibrated Band 1 DN to reflectance.

REFLECTANCE_MULT_BAND_2 DOUBLE

Multiplicative factor used to convert calibrated Band 2 DN to reflectance.

REFLECTANCE_MULT_BAND_3 DOUBLE

Multiplicative factor used to convert calibrated Band 3 DN to reflectance.

REFLECTANCE_MULT_BAND_4 DOUBLE

Multiplicative factor used to convert calibrated Band 4 DN to reflectance.

REFLECTANCE_MULT_BAND_5 DOUBLE

Multiplicative factor used to convert calibrated Band 5 DN to reflectance.

REFLECTANCE_MULT_BAND_7 DOUBLE

Multiplicative factor used to convert calibrated Band 7 DN to reflectance.

REFLECTANCE_MULT_BAND_8 DOUBLE

Multiplicative factor used to convert calibrated Band 8 DN to reflectance.

REFLECTIVE_LINES DOUBLE

Number of product lines for the reflective bands.

REFLECTIVE_SAMPLES DOUBLE

Number of product samples for the reflective bands.

REQUEST_ID STRING

Request id, nnnyymmdd0000_0000

  • nnn = node number
  • yy = year
  • mm = month
  • dd = day
RESAMPLING_OPTION STRING

Resampling option used in creating the image.

SATURATION_BAND_1 STRING

Flag indicating saturated pixels for band 1 ('Y'/'N')

SATURATION_BAND_2 STRING

Flag indicating saturated pixels for band 2 ('Y'/'N')

SATURATION_BAND_3 STRING

Flag indicating saturated pixels for band 3 ('Y'/'N')

SATURATION_BAND_4 STRING

Flag indicating saturated pixels for band 4 ('Y'/'N')

SATURATION_BAND_5 STRING

Flag indicating saturated pixels for band 5 ('Y'/'N')

SATURATION_BAND_6_VCID_1 STRING

Flag indicating saturated pixels for band 6 VCID 1 ('Y'/'N')

SATURATION_BAND_6_VCID_2 STRING

Flag indicating saturated pixels for band 6 VCID 2 ('Y'/'N')

SATURATION_BAND_7 STRING

Flag indicating saturated pixels for band 7 ('Y'/'N')

SATURATION_BAND_8 STRING

Flag indicating saturated pixels for band 8 ('Y'/'N')

SCENE_CENTER_TIME STRING

Scene center time of acquired image. HH:MM:SS.SSSSSSSZ

  • HH = Hour (00-23)
  • MM = Minutes
  • SS.SSSSSSS = Fractional seconds
  • Z = "Zulu" time (same as GMT)
SENSOR_ID STRING

Sensor used to capture data.

SENSOR_MODE STRING

Operational mode. Scan Angle Monitor (SAM) or BUMPER.

SPACECRAFT_ID STRING

Spacecraft identification.

STATION_ID STRING

Ground Station/Organisation that received the data.

SUN_AZIMUTH DOUBLE

Sun azimuth angle in degrees for the image center location at the image centre acquisition time.

SUN_ELEVATION DOUBLE

Sun elevation angle in degrees for the image center location at the image centre acquisition time.

THERMAL_LINES DOUBLE

Number of product lines for the thermal band.

THERMAL_SAMPLES DOUBLE

Number of product samples for the thermal band.

UTM_ZONE DOUBLE

UTM zone number used in product map projection.

WRS_PATH DOUBLE

The WRS orbital path number (001 - 251).

WRS_ROW DOUBLE

Landsat satellite WRS row (001-248).

Explore in Earth Engine

var dataset = ee.ImageCollection('LANDSAT/LE07/C01/T1_TOA')
                  .filterDate('1999-01-01', '2002-12-31');
var trueColor321 = dataset.select(['B3', 'B2', 'B1']);
var trueColor321Vis = {
  min: 0.0,
  max: 0.4,
  gamma: 1.2,
};
Map.setCenter(6.746, 46.529, 6);
Map.addLayer(trueColor321, trueColor321Vis, 'True Color (321)');