USGS Landsat 7 Collection 1 Tier 1 TOA Reflectance [deprecated]

LANDSAT/LE07/C01/T1_TOA
Dataset Availability
1999-05-28T01:02:17Z–2021-12-31T23:09:22Z
Dataset Provider
Earth Engine Snippet
ee.ImageCollection("LANDSAT/LE07/C01/T1_TOA")
Tags
c1 etm global l7 landsat le7 radiance t1 tier1 toa 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.

Note that Landsat 7's orbit has been drifting to an earlier acquisition time since 2017 .

Bands

Bands

Name
Pixel Size
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
60 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
60 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
30 meters

Landsat Collection 1 QA Bitmask ( See Landsat QA page )

Image Properties

Image Properties

Name
Type
Description
CLOUD_COVER
DOUBLE

Percentage cloud cover (0-100), -1 = not calculated.

CLOUD_COVER_LAND
DOUBLE

Percentage cloud cover over land (0-100), -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 (meters) 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 meters) 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 meters) 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_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 center acquisition time.

SUN_ELEVATION
DOUBLE

Sun elevation angle in degrees for the image center location at the image center 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).

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.

Create a Mobile Website
View Site in Mobile | Classic
Share by: