Landsat Collection 1 to Collection 2 migration

This guide provides instructions for switching from Landsat Collection 1 to Collection 2 data. Collection 2 has been fully available in Earth Engine since 2022 and no Collection 1 data has been produced by the USGS since December 31, 2021. Landsat Collection 1 is deprecated and all users are encouraged to migrate to Collection 2 as soon as possible.

Each Landsat Collection represents a version of the image archive processed with consistent methods and routines. As systems and processing algorithms improve, new collections are generated. In 2020, the USGS began reprocessing the archive to Collection 2. See the article "The 50-year Landsat collection 2 archive" in Remote Sensing of Environment to learn about the rationale behind the collections processing model and the contents and advancements provided by Collection 2.

The following sections describe the changes needed to migrate from Collection 1 to Collection 2 for each Landsat data product, including image and collection IDs, band names, new bands, band value scaling, and bitmask values. The content tabs within each section provide details for specific sensors.

Surface reflectance

OLI

Asset ID

Replace C01 with C02 and SR with L2 in image and collection IDs. For example, Landsat 8 OLI Tier 1 (Landsat 9 OLI-2 was not included in Collection 1):

Collection 1 Collection 2
LANDSAT/LC08/C01/T1_SR LANDSAT/LC08/C02/T1_L2

Band names

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Ultra blue B1 SR_B1
Blue B2 SR_B2
Green B3 SR_B3
Red B4 SR_B4
Near infrared B5 SR_B5
Shortwave infrared 1 B6 SR_B6
Shortwave infrared 2 B7 SR_B7
Brightness temperature 1 B10
Brightness temperature 2 B11
Aerosol attributes sr_aerosol SR_QA_AEROSOL
Surface temperature ST_B10
Atmospheric transmittance ST_ATRAN
Pixel distance to cloud ST_CDIST
Downwelled radiance ST_DRAD
Emissivity ST_EMIS
Emissivity standard deviation ST_EMSD
Surface temperature uncertainty ST_QA
Thermal radiance ST_TRAD
Upwelled radiance ST_URAD
Pixel quality attributes (CFMask) pixel_qa QA_PIXEL
Radiometric saturation QA radsat_qa QA_RADSAT

Update code that selects bands whose names have changed, for example, the near-infrared band:

Collection 1 Collection 2
image.select('B5') image.select('SR_B5')

Value scaling

Reflectance bands have new scaling factors. Collection 1 used a 0.0001 scale factor. Collection 2 uses a 2.75e-05 scale factor and -0.2 offset. The thermal band also has new scale and offset factors. The following code block defines a function to apply Collection 2 surface reflectance and temperature band scaling factors and maps it over an image collection.

Code Editor (JavaScript)

var applyScaleFactors = function(image) {
  var opticalBands = image.select('SR_B.').multiply(0.0000275).add(-0.2);
  var thermalBand = image.select('ST_B10').multiply(0.00341802).add(149.0);
  return image.addBands(opticalBands, null, true)
              .addBands(thermalBand, null, true);
}

var srColScaled = srCol.map(applyScaleFactors)

Colab (Python)

def apply_scale_factors(image):
  optical_bands = image.select('SR_B.').multiply(0.0000275).add(-0.2)
  thermal_band = image.select('ST_B6').multiply(0.00341802).add(149.0)
  return image.addBands(optical_bands, None, True).addBands(
      thermal_band, None, True
  )

sr_col_scaled = sr_col.map(apply_scale_factors)

QA masking

Bit codes have changed for the QA bitmask (CFMASK). See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for pixel_qa" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11111', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11111', 2)).eq(0)

Radiometric saturation

Bit codes have changed for the radiometric saturation bitmask. See the "Bitmask for QA_RADSAT" (Collection 2) and "Bitmask for radsat_qa" (Collection 1) sections in catalog entries for codes.

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. Properties for solar geometry were altered. See the following property comparison table to determine whether you need to modify your code to accommodate missing, added, or altered properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
ALGORITHM_SOURCE_SURFACE_REFLECTANCE
ALGORITHM_SOURCE_SURFACE_TEMPERATURE
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY
COLLECTION_NUMBER
DATA_SOURCE_AIR_TEMPERATURE
DATA_SOURCE_ELEVATION
DATA_SOURCE_OZONE
DATA_SOURCE_PRESSURE
DATA_SOURCE_REANALYSIS
DATA_SOURCE_TIRS_STRAY_LIGHT_CORRECTION
DATA_SOURCE_WATER_VAPOR
DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELLIPSOID
ESPA_VERSION
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY
GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY_OLI IMAGE_QUALITY_OLI
IMAGE_QUALITY_TIRS IMAGE_QUALITY_TIRS
L1_DATE_PRODUCT_GENERATED
L1_LANDSAT_PRODUCT_ID
L1_PROCESSING_LEVEL
L1_PROCESSING_SOFTWARE_VERSION
L1_REQUEST_ID
LANDSAT_ID
LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID
LEVEL1_PRODUCTION_DATE
MAP_PROJECTION
NADIR_OFFNADIR
ORIENTATION
PIXEL_QA_VERSION
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION
REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_6
REFLECTANCE_ADD_BAND_7
REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_6
REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES
REFLECTIVE_SAMPLES
REQUEST_ID
ROLL_ANGLE
SATELLITE
SATURATION_BAND_1
SATURATION_BAND_2
SATURATION_BAND_3
SATURATION_BAND_4
SATURATION_BAND_5
SATURATION_BAND_6
SATURATION_BAND_7
SATURATION_BAND_8
SATURATION_BAND_9
SCENE_CENTER_TIME
SENSING_TIME
SENSOR_ID
SPACECRAFT_ID
STATION_ID
SOLAR_AZIMUTH_ANGLE SUN_AZIMUTH
SOLAR_ZENITH_ANGLE SUN_ELEVATION (Collection 2 uses elevation instead of zenith angle. To calculate zenith angle, use 90 - elevation.)
SR_APP_VERSION
TARGET_WRS_PATH
TARGET_WRS_ROW
TEMPERATURE_ADD_BAND_ST_B10
TEMPERATURE_MAXIMUM_BAND_ST_B10
TEMPERATURE_MINIMUM_BAND_ST_B10
TEMPERATURE_MULT_BAND_ST_B10
THERMAL_LINES
THERMAL_SAMPLES
TIRS_SSM_MODEL
TIRS_SSM_POSITION_STATUS
TRUNCATION_OLI
UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE

ETM+

Asset ID

Replace C01 with C02 and SR with L2 in image and collection IDs. For example, Landsat 7 ETM+ Tier 1:

Collection 1 Collection 2
LANDSAT/LE07/C01/T1_SR LANDSAT/LE07/C02/T1_L2

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 SR_B1
Green B2 SR_B2
Red B3 SR_B3
Near infrared B4 SR_B4
Shortwave infrared 1 B5 SR_B5
TOA brightness temperature B6
Shortwave infrared 2 B7 SR_B7
Atmospheric opacity sr_atmos_opacity SR_ATMOS_OPACITY
Cloud quality assessment sr_cloud_qa SR_CLOUD_QA
Surface temperature ST_B6
Atmospheric transmittance ST_ATRAN
Pixel distance to cloud ST_CDIST
Downwelled radiance ST_DRAD
Emissivity ST_EMIS
Emissivity standard deviation ST_EMSD
Surface temperature uncertainty ST_QA
Thermal radiance ST_TRAD
Upwelled radiance ST_URAD
Pixel quality attributes (CFMask) pixel_qa QA_PIXEL
Radiometric saturation QA radsat_qa QA_RADSAT

Update code that selects bands whose names have changed, for example, the near-infrared band:

Collection 1 Collection 2
image.select('B4') image.select('SR_B4')

Value scaling

Reflectance bands have new scaling factors. Collection 1 used a 0.0001 scale factor. Collection 2 uses a 2.75e-05 scale factor and -0.2 offset. The thermal band also has new scale and offset factors. The following code block defines a function to apply Collection 2 surface reflectance and temperature band scaling factors and maps it over an image collection.

Code Editor (JavaScript)

var applyScaleFactors = function(image) {
  var opticalBands = image.select('SR_B.').multiply(0.0000275).add(-0.2);
  var thermalBand = image.select('ST_B6').multiply(0.00341802).add(149.0);
  return image.addBands(opticalBands, null, true)
              .addBands(thermalBand, null, true);
}

var srColScaled = srCol.map(applyScaleFactors)

Colab (Python)

def apply_scale_factors(image):
  optical_bands = image.select('SR_B.').multiply(0.0000275).add(-0.2)
  thermal_band = image.select('ST_B6').multiply(0.00341802).add(149.0)
  return image.addBands(optical_bands, None, True).addBands(
      thermal_band, None, True
  )

sr_col_scaled = sr_col.map(apply_scale_factors)

QA masking

Bit codes have changed for the QA bitmask (CFMASK). See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for pixel_qa" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11111', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11111', 2)).eq(0)

Radiometric saturation

Bit codes have changed for the radiometric saturation bitmask. See the "Bitmask for QA_RADSAT" (Collection 2) and "Bitmask for radsat_qa" (Collection 1) sections in catalog entries for codes.

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. Properties for solar geometry were altered. See the following property comparison table to determine whether you need to modify your code to accommodate missing, added, or altered properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
ALGORITHM_SOURCE_SURFACE_REFLECTANCE
ALGORITHM_SOURCE_SURFACE_TEMPERATURE
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY
COLLECTION_NUMBER
CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6_VCID_1
CORRECTION_BIAS_BAND_6_VCID_2
CORRECTION_BIAS_BAND_7
CORRECTION_BIAS_BAND_8
CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6_VCID_1
CORRECTION_GAIN_BAND_6_VCID_2
CORRECTION_GAIN_BAND_7
CORRECTION_GAIN_BAND_8
DATA_SOURCE_AIR_TEMPERATURE
DATA_SOURCE_ELEVATION
DATA_SOURCE_OZONE
DATA_SOURCE_PRESSURE
DATA_SOURCE_REANALYSIS
DATA_SOURCE_WATER_VAPOR
DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELLIPSOID
EPHEMERIS_TYPE
ESPA_VERSION
GAIN_BAND_1
GAIN_BAND_2
GAIN_BAND_3
GAIN_BAND_4
GAIN_BAND_5
GAIN_BAND_6_VCID_1
GAIN_BAND_6_VCID_2
GAIN_BAND_7
GAIN_BAND_8
GAIN_CHANGE_BAND_1
GAIN_CHANGE_BAND_2
GAIN_CHANGE_BAND_3
GAIN_CHANGE_BAND_4
GAIN_CHANGE_BAND_5
GAIN_CHANGE_BAND_6_VCID_1
GAIN_CHANGE_BAND_6_VCID_2
GAIN_CHANGE_BAND_7
GAIN_CHANGE_BAND_8
GAIN_CHANGE_SCAN_BAND_1
GAIN_CHANGE_SCAN_BAND_2
GAIN_CHANGE_SCAN_BAND_3
GAIN_CHANGE_SCAN_BAND_4
GAIN_CHANGE_SCAN_BAND_5
GAIN_CHANGE_SCAN_BAND_6_VCID_1
GAIN_CHANGE_SCAN_BAND_6_VCID_2
GAIN_CHANGE_SCAN_BAND_7
GAIN_CHANGE_SCAN_BAND_8
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
L1_DATE_PRODUCT_GENERATED
L1_LANDSAT_PRODUCT_ID
L1_PROCESSING_LEVEL
L1_PROCESSING_SOFTWARE_VERSION
L1_REQUEST_ID
LANDSAT_ID
LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID
LEVEL1_PRODUCTION_DATE
MAP_PROJECTION
ORIENTATION
PIXEL_QA_VERSION
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION
REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7
REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES
REFLECTIVE_SAMPLES
REQUEST_ID
SATELLITE
SATURATION_BAND_1
SATURATION_BAND_2
SATURATION_BAND_3
SATURATION_BAND_4
SATURATION_BAND_5
SATURATION_BAND_6_VCID_1
SATURATION_BAND_6_VCID_2
SATURATION_BAND_7
SATURATION_BAND_8
SCENE_CENTER_TIME
SENSING_TIME
SENSOR_ANOMALIES
SENSOR_ID
SENSOR_MODE
SENSOR_MODE_SLC
SPACECRAFT_ID
STATION_ID
SOLAR_AZIMUTH_ANGLE SUN_AZIMUTH
SOLAR_ZENITH_ANGLE SUN_ELEVATION (Collection 2 uses elevation instead of zenith angle. To calculate zenith angle, use 90 - elevation.)
SR_APP_VERSION
TEMPERATURE_ADD_BAND_ST_B6
TEMPERATURE_MAXIMUM_BAND_ST_B6
TEMPERATURE_MINIMUM_BAND_ST_B6
TEMPERATURE_MULT_BAND_ST_B6
THERMAL_LINES
THERMAL_SAMPLES
UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE

TM

Asset ID

Replace C01 with C02 and SR with L2 in image and collection IDs. For example, Landsat 5 TM Tier 1:

Collection 1 Collection 2
LANDSAT/LT05/C01/T1_SR LANDSAT/LT05/C02/T1_L2

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 SR_B1
Green B2 SR_B2
Red B3 SR_B3
Near infrared B4 SR_B4
Shortwave infrared 1 B5 SR_B5
TOA brightness temperature B6
Shortwave infrared 2 B7 SR_B7
Atmospheric opacity sr_atmos_opacity SR_ATMOS_OPACITY
Cloud quality assessment sr_cloud_qa SR_CLOUD_QA
Surface temperature ST_B6
Atmospheric transmittance ST_ATRAN
Pixel distance to cloud ST_CDIST
Downwelled radiance ST_DRAD
Emissivity ST_EMIS
Emissivity standard deviation ST_EMSD
Surface temperature uncertainty ST_QA
Thermal radiance ST_TRAD
Upwelled radiance ST_URAD
Pixel quality attributes (CFMask) pixel_qa QA_PIXEL
Radiometric saturation QA radsat_qa QA_RADSAT

Update code that selects bands whose names have changed, for example, the near-infrared band:

Collection 1 Collection 2
image.select('B4') image.select('SR_B4')

Value scaling

Reflectance bands have new scaling factors. Collection 1 used a 0.0001 scale factor. Collection 2 uses a 2.75e-05 scale factor and -0.2 offset. The thermal band also has new scale and offset factors. The following code block defines a function to apply Collection 2 surface reflectance and temperature band scaling factors and maps it over an image collection.

Code Editor (JavaScript)

var applyScaleFactors = function(image) {
  var opticalBands = image.select('SR_B.').multiply(0.0000275).add(-0.2);
  var thermalBand = image.select('ST_B6').multiply(0.00341802).add(149.0);
  return image.addBands(opticalBands, null, true)
              .addBands(thermalBand, null, true);
}

var srColScaled = srCol.map(applyScaleFactors)

Colab (Python)

def apply_scale_factors(image):
  optical_bands = image.select('SR_B.').multiply(0.0000275).add(-0.2)
  thermal_band = image.select('ST_B6').multiply(0.00341802).add(149.0)
  return image.addBands(optical_bands, None, True).addBands(
      thermal_band, None, True
  )

sr_col_scaled = sr_col.map(apply_scale_factors)

QA masking

Bit codes have changed for the QA bitmask (CFMASK). See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for pixel_qa" (Collection 1) sections in catalog entries for codes (TM 5, for example).

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11111', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11111', 2)).eq(0)

Radiometric saturation

Bit codes have changed for the radiometric saturation bitmask. See the "Bitmask for QA_RADSAT" (Collection 2) and "Bitmask for radsat_qa" (Collection 1) sections in catalog entries for codes (TM 5, for example).

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. Properties for solar geometry were altered. See the following property comparison table to determine whether you need to modify your code to accommodate missing, added, or altered properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions (TM 5, for example).

Expand to compare property lists
Collection 1 Collection 2
ALGORITHM_SOURCE_SURFACE_REFLECTANCE
ALGORITHM_SOURCE_SURFACE_TEMPERATURE
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY
COLLECTION_NUMBER
CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6
CORRECTION_BIAS_BAND_7
CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6
CORRECTION_GAIN_BAND_7
DATA_SOURCE_AIR_TEMPERATURE
DATA_SOURCE_ELEVATION
DATA_SOURCE_OZONE
DATA_SOURCE_PRESSURE
DATA_SOURCE_REANALYSIS
DATA_SOURCE_WATER_VAPOR
DATA_TYPE_L0RP
DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELLIPSOID
EPHEMERIS_TYPE
ESPA_VERSION
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY
GEOMETRIC_RMSE_VERIFY_QUAD_LL
GEOMETRIC_RMSE_VERIFY_QUAD_LR
GEOMETRIC_RMSE_VERIFY_QUAD_UL
GEOMETRIC_RMSE_VERIFY_QUAD_UR
GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
L1_DATE_PRODUCT_GENERATED
L1_LANDSAT_PRODUCT_ID
L1_PROCESSING_LEVEL
L1_PROCESSING_SOFTWARE_VERSION
L1_REQUEST_ID
LANDSAT_ID
LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID
LEVEL1_PRODUCTION_DATE
MAP_PROJECTION
ORIENTATION
PIXEL_QA_VERSION
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION
REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7
REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES
REFLECTIVE_SAMPLES
REQUEST_ID
SATELLITE
SATURATION_BAND_1
SATURATION_BAND_2
SATURATION_BAND_3
SATURATION_BAND_4
SATURATION_BAND_5
SATURATION_BAND_6
SATURATION_BAND_7
SCENE_CENTER_TIME
SENSING_TIME
SENSOR_ANOMALIES
SENSOR_ID
SENSOR_MODE
SENSOR_MODE_SLC
SPACECRAFT_ID
STATION_ID
SOLAR_AZIMUTH_ANGLE SUN_AZIMUTH
SOLAR_ZENITH_ANGLE SUN_ELEVATION (Collection 2 uses elevation instead of zenith angle. To calculate zenith angle, use 90 - elevation.)
SR_APP_VERSION
TEMPERATURE_ADD_BAND_ST_B6
TEMPERATURE_MAXIMUM_BAND_ST_B6
TEMPERATURE_MINIMUM_BAND_ST_B6
TEMPERATURE_MULT_BAND_ST_B6
THERMAL_LINES
THERMAL_SAMPLES
UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE

Top-of-atmosphere reflectance

OLI

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 8 OLI Tier 1 (Landsat 9 OLI-2 was not included in Collection 1):

Collection 1 Collection 2
LANDSAT/LC08/C01/T1_TOA LANDSAT/LC08/C02/T1_TOA

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Coastal aerosol B1 B1
Blue B2 B2
Green B3 B3
Red B4 B4
Near infrared B5 B5
Shortwave infrared 1 B6 B6
Shortwave infrared 2 B7 B7
Panchromatic B8 B8
Cirrus B9 B9
Thermal infrared 1 B10 B10
Thermal infrared 2 B11 B11
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for top-of-atmosphere reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
BPF_NAME_OLI
BPF_NAME_TIRS
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CPF_NAME
DATA_SOURCE_ELEVATION
DATA_SOURCE_TIRS_STRAY_LIGHT_CORRECTION
DATA_TYPE
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
FILE_DATE
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY GEOMETRIC_RMSE_VERIFY
GRID_CELL_SIZE_PANCHROMATIC GRID_CELL_SIZE_PANCHROMATIC
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY_OLI IMAGE_QUALITY_OLI
IMAGE_QUALITY_TIRS IMAGE_QUALITY_TIRS
K1_CONSTANT_BAND_10 K1_CONSTANT_BAND_10
K1_CONSTANT_BAND_11 K1_CONSTANT_BAND_11
K2_CONSTANT_BAND_10 K2_CONSTANT_BAND_10
K2_CONSTANT_BAND_11 K2_CONSTANT_BAND_11
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
NADIR_OFFNADIR NADIR_OFFNADIR
ORIENTATION ORIENTATION
PANCHROMATIC_LINES PANCHROMATIC_LINES
PANCHROMATIC_SAMPLES PANCHROMATIC_SAMPLES
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_10 RADIANCE_ADD_BAND_10
RADIANCE_ADD_BAND_11 RADIANCE_ADD_BAND_11
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6 RADIANCE_ADD_BAND_6
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_ADD_BAND_8 RADIANCE_ADD_BAND_8
RADIANCE_ADD_BAND_9 RADIANCE_ADD_BAND_9
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_10 RADIANCE_MULT_BAND_10
RADIANCE_MULT_BAND_11 RADIANCE_MULT_BAND_11
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6 RADIANCE_MULT_BAND_6
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
RADIANCE_MULT_BAND_8 RADIANCE_MULT_BAND_8
RADIANCE_MULT_BAND_9 RADIANCE_MULT_BAND_9
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_6 REFLECTANCE_ADD_BAND_6
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_ADD_BAND_8 REFLECTANCE_ADD_BAND_8
REFLECTANCE_ADD_BAND_9 REFLECTANCE_ADD_BAND_9
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_6 REFLECTANCE_MULT_BAND_6
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTANCE_MULT_BAND_8 REFLECTANCE_MULT_BAND_8
REFLECTANCE_MULT_BAND_9 REFLECTANCE_MULT_BAND_9
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
RLUT_FILE_NAME
ROLL_ANGLE ROLL_ANGLE
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6 SATURATION_BAND_6
SATURATION_BAND_7 SATURATION_BAND_7
SATURATION_BAND_8 SATURATION_BAND_8
SATURATION_BAND_9 SATURATION_BAND_9
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ID SENSOR_ID
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
TARGET_WRS_PATH TARGET_WRS_PATH
TARGET_WRS_ROW TARGET_WRS_ROW
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
TIRS_SSM_MODEL TIRS_SSM_MODEL
TIRS_SSM_POSITION_STATUS TIRS_SSM_POSITION_STATUS
TIRS_STRAY_LIGHT_CORRECTION_SOURCE
TRUNCATION_OLI TRUNCATION_OLI
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

ETM+

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 7 ETM+ Tier 1:

Collection 1 Collection 2
LANDSAT/LE07/C01/T1_TOA LANDSAT/LE07/C02/T1_TOA

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 B1
Green B2 B2
Red B3 B3
Near infrared B4 B4
Shortwave infrared 1 B5 B5
Low-gain thermal infrared 1 B6_VCID_1 B6_VCID_1
High-gain thermal infrared 1 B6_VCID_2 B6_VCID_2
Shortwave infrared 2 B7 B7
Panchromatic B8 B8
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for top-of-atmosphere reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CORRECTION_BIAS_BAND_1 CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2 CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3 CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4 CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5 CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6_VCID_1 CORRECTION_BIAS_BAND_6_VCID_1
CORRECTION_BIAS_BAND_6_VCID_2 CORRECTION_BIAS_BAND_6_VCID_2
CORRECTION_BIAS_BAND_7 CORRECTION_BIAS_BAND_7
CORRECTION_BIAS_BAND_8 CORRECTION_BIAS_BAND_8
CORRECTION_GAIN_BAND_1 CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2 CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3 CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4 CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5 CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6_VCID_1 CORRECTION_GAIN_BAND_6_VCID_1
CORRECTION_GAIN_BAND_6_VCID_2 CORRECTION_GAIN_BAND_6_VCID_2
CORRECTION_GAIN_BAND_7 CORRECTION_GAIN_BAND_7
CORRECTION_GAIN_BAND_8 CORRECTION_GAIN_BAND_8
CPF_NAME
DATA_CATEGORY
DATA_SOURCE_ELEVATION
DATA_TYPE
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
EPHEMERIS_TYPE EPHEMERIS_TYPE
FILE_DATE
GAIN_BAND_1 GAIN_BAND_1
GAIN_BAND_2 GAIN_BAND_2
GAIN_BAND_3 GAIN_BAND_3
GAIN_BAND_4 GAIN_BAND_4
GAIN_BAND_5 GAIN_BAND_5
GAIN_BAND_6_VCID_1 GAIN_BAND_6_VCID_1
GAIN_BAND_6_VCID_2 GAIN_BAND_6_VCID_2
GAIN_BAND_7 GAIN_BAND_7
GAIN_BAND_8 GAIN_BAND_8
GAIN_CHANGE_BAND_1 GAIN_CHANGE_BAND_1
GAIN_CHANGE_BAND_2 GAIN_CHANGE_BAND_2
GAIN_CHANGE_BAND_3 GAIN_CHANGE_BAND_3
GAIN_CHANGE_BAND_4 GAIN_CHANGE_BAND_4
GAIN_CHANGE_BAND_5 GAIN_CHANGE_BAND_5
GAIN_CHANGE_BAND_6_VCID_1 GAIN_CHANGE_BAND_6_VCID_1
GAIN_CHANGE_BAND_6_VCID_2 GAIN_CHANGE_BAND_6_VCID_2
GAIN_CHANGE_BAND_7 GAIN_CHANGE_BAND_7
GAIN_CHANGE_BAND_8 GAIN_CHANGE_BAND_8
GAIN_CHANGE_SCAN_BAND_1 GAIN_CHANGE_SCAN_BAND_1
GAIN_CHANGE_SCAN_BAND_2 GAIN_CHANGE_SCAN_BAND_2
GAIN_CHANGE_SCAN_BAND_3 GAIN_CHANGE_SCAN_BAND_3
GAIN_CHANGE_SCAN_BAND_4 GAIN_CHANGE_SCAN_BAND_4
GAIN_CHANGE_SCAN_BAND_5 GAIN_CHANGE_SCAN_BAND_5
GAIN_CHANGE_SCAN_BAND_6_VCID_1 GAIN_CHANGE_SCAN_BAND_6_VCID_1
GAIN_CHANGE_SCAN_BAND_6_VCID_2 GAIN_CHANGE_SCAN_BAND_6_VCID_2
GAIN_CHANGE_SCAN_BAND_7 GAIN_CHANGE_SCAN_BAND_7
GAIN_CHANGE_SCAN_BAND_8 GAIN_CHANGE_SCAN_BAND_8
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GRID_CELL_SIZE_PANCHROMATIC GRID_CELL_SIZE_PANCHROMATIC
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
K1_CONSTANT_BAND_6_VCID_1 K1_CONSTANT_BAND_6_VCID_1
K1_CONSTANT_BAND_6_VCID_2 K1_CONSTANT_BAND_6_VCID_2
K2_CONSTANT_BAND_6_VCID_1 K2_CONSTANT_BAND_6_VCID_1
K2_CONSTANT_BAND_6_VCID_2 K2_CONSTANT_BAND_6_VCID_2
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
ORIENTATION ORIENTATION
PANCHROMATIC_LINES PANCHROMATIC_LINES
PANCHROMATIC_SAMPLES PANCHROMATIC_SAMPLES
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6_VCID_1 RADIANCE_ADD_BAND_6_VCID_1
RADIANCE_ADD_BAND_6_VCID_2 RADIANCE_ADD_BAND_6_VCID_2
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_ADD_BAND_8 RADIANCE_ADD_BAND_8
RADIANCE_MAXIMUM_BAND_1
RADIANCE_MAXIMUM_BAND_2
RADIANCE_MAXIMUM_BAND_3
RADIANCE_MAXIMUM_BAND_4
RADIANCE_MAXIMUM_BAND_5
RADIANCE_MAXIMUM_BAND_6_VCID_1
RADIANCE_MAXIMUM_BAND_6_VCID_2
RADIANCE_MAXIMUM_BAND_7
RADIANCE_MAXIMUM_BAND_8
RADIANCE_MINIMUM_BAND_1
RADIANCE_MINIMUM_BAND_2
RADIANCE_MINIMUM_BAND_3
RADIANCE_MINIMUM_BAND_4
RADIANCE_MINIMUM_BAND_5
RADIANCE_MINIMUM_BAND_6_VCID_1
RADIANCE_MINIMUM_BAND_6_VCID_2
RADIANCE_MINIMUM_BAND_7
RADIANCE_MINIMUM_BAND_8
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6_VCID_1 RADIANCE_MULT_BAND_6_VCID_1
RADIANCE_MULT_BAND_6_VCID_2 RADIANCE_MULT_BAND_6_VCID_2
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
RADIANCE_MULT_BAND_8 RADIANCE_MULT_BAND_8
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_ADD_BAND_8 REFLECTANCE_ADD_BAND_8
REFLECTANCE_MAXIMUM_BAND_1
REFLECTANCE_MAXIMUM_BAND_2
REFLECTANCE_MAXIMUM_BAND_3
REFLECTANCE_MAXIMUM_BAND_4
REFLECTANCE_MAXIMUM_BAND_5
REFLECTANCE_MAXIMUM_BAND_7
REFLECTANCE_MAXIMUM_BAND_8
REFLECTANCE_MINIMUM_BAND_1
REFLECTANCE_MINIMUM_BAND_2
REFLECTANCE_MINIMUM_BAND_3
REFLECTANCE_MINIMUM_BAND_4
REFLECTANCE_MINIMUM_BAND_5
REFLECTANCE_MINIMUM_BAND_7
REFLECTANCE_MINIMUM_BAND_8
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTANCE_MULT_BAND_8 REFLECTANCE_MULT_BAND_8
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6_VCID_1 SATURATION_BAND_6_VCID_1
SATURATION_BAND_6_VCID_2 SATURATION_BAND_6_VCID_2
SATURATION_BAND_7 SATURATION_BAND_7
SATURATION_BAND_8 SATURATION_BAND_8
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ANOMALIES
SENSOR_ID SENSOR_ID
SENSOR_MODE SENSOR_MODE
SENSOR_MODE_SLC
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

TM

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 5 TM Tier 1:

Collection 1 Collection 2
LANDSAT/LT05/C01/T1_TOA LANDSAT/LT05/C02/T1_TOA

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 B1
Green B2 B2
Red B3 B3
Near infrared B4 B4
Shortwave infrared 1 B5 B5
Thermal infrared 1 B6 B6
Shortwave infrared 2 B7 B7
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for top-of-atmosphere reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes (TM 5, for example).

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions (TM 5, for example).

Expand to compare property lists
Collection 1 Collection 2
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CORNER_LL_LAT_PRODUCT
CORNER_LL_LON_PRODUCT
CORNER_LL_PROJECTION_X_PRODUCT
CORNER_LL_PROJECTION_Y_PRODUCT
CORNER_LR_LAT_PRODUCT
CORNER_LR_LON_PRODUCT
CORNER_LR_PROJECTION_X_PRODUCT
CORNER_LR_PROJECTION_Y_PRODUCT
CORNER_UL_LAT_PRODUCT
CORNER_UL_LON_PRODUCT
CORNER_UL_PROJECTION_X_PRODUCT
CORNER_UL_PROJECTION_Y_PRODUCT
CORNER_UR_LAT_PRODUCT
CORNER_UR_LON_PRODUCT
CORNER_UR_PROJECTION_X_PRODUCT
CORNER_UR_PROJECTION_Y_PRODUCT
CORRECTION_BIAS_BAND_1 CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2 CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3 CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4 CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5 CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6 CORRECTION_BIAS_BAND_6
CORRECTION_BIAS_BAND_7 CORRECTION_BIAS_BAND_7
CORRECTION_GAIN_BAND_1 CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2 CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3 CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4 CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5 CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6 CORRECTION_GAIN_BAND_6
CORRECTION_GAIN_BAND_7 CORRECTION_GAIN_BAND_7
CPF_NAME
DATA_CATEGORY
DATA_SOURCE_ELEVATION
DATA_TYPE
DATA_TYPE_L0RP DATA_TYPE_L0RP
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
EPHEMERIS_TYPE EPHEMERIS_TYPE
FILE_DATE
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY GEOMETRIC_RMSE_VERIFY
GEOMETRIC_RMSE_VERIFY_QUAD_LL GEOMETRIC_RMSE_VERIFY_QUAD_LL
GEOMETRIC_RMSE_VERIFY_QUAD_LR GEOMETRIC_RMSE_VERIFY_QUAD_LR
GEOMETRIC_RMSE_VERIFY_QUAD_UL GEOMETRIC_RMSE_VERIFY_QUAD_UL
GEOMETRIC_RMSE_VERIFY_QUAD_UR GEOMETRIC_RMSE_VERIFY_QUAD_UR
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
K1_CONSTANT_BAND_6 K1_CONSTANT_BAND_6
K2_CONSTANT_BAND_6 K2_CONSTANT_BAND_6
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
MAP_PROJECTION_L0RA MAP_PROJECTION_L0RA
ORIENTATION ORIENTATION
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6 RADIANCE_ADD_BAND_6
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_MAXIMUM_BAND_1
RADIANCE_MAXIMUM_BAND_2
RADIANCE_MAXIMUM_BAND_3
RADIANCE_MAXIMUM_BAND_4
RADIANCE_MAXIMUM_BAND_5
RADIANCE_MAXIMUM_BAND_6
RADIANCE_MAXIMUM_BAND_7
RADIANCE_MINIMUM_BAND_1
RADIANCE_MINIMUM_BAND_2
RADIANCE_MINIMUM_BAND_3
RADIANCE_MINIMUM_BAND_4
RADIANCE_MINIMUM_BAND_5
RADIANCE_MINIMUM_BAND_6
RADIANCE_MINIMUM_BAND_7
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6 RADIANCE_MULT_BAND_6
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_MAXIMUM_BAND_1
REFLECTANCE_MAXIMUM_BAND_2
REFLECTANCE_MAXIMUM_BAND_3
REFLECTANCE_MAXIMUM_BAND_4
REFLECTANCE_MAXIMUM_BAND_5
REFLECTANCE_MAXIMUM_BAND_7
REFLECTANCE_MINIMUM_BAND_1
REFLECTANCE_MINIMUM_BAND_2
REFLECTANCE_MINIMUM_BAND_3
REFLECTANCE_MINIMUM_BAND_4
REFLECTANCE_MINIMUM_BAND_5
REFLECTANCE_MINIMUM_BAND_7
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6 SATURATION_BAND_6
SATURATION_BAND_7 SATURATION_BAND_7
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ANOMALIES
SENSOR_ID SENSOR_ID
SENSOR_MODE SENSOR_MODE
SENSOR_MODE_SLC
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

Scaled radiance (DN)

OLI

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 8 OLI Tier 1 (Landsat 9 OLI-2 was not included in Collection 1):

Collection 1 Collection 2
LANDSAT/LC08/C01/T1 LANDSAT/LC08/C02/T1

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Coastal aerosol B1 B1
Blue B2 B2
Green B3 B3
Red B4 B4
Near infrared B5 B5
Shortwave infrared 1 B6 B6
Shortwave infrared 2 B7 B7
Panchromatic B8 B8
Cirrus B9 B9
Thermal infrared 1 B10 B10
Thermal infrared 2 B11 B11
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for raw DN reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
BPF_NAME_OLI
BPF_NAME_TIRS
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CPF_NAME
DATA_SOURCE_ELEVATION
DATA_SOURCE_TIRS_STRAY_LIGHT_CORRECTION
DATA_TYPE
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
FILE_DATE
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY GEOMETRIC_RMSE_VERIFY
GRID_CELL_SIZE_PANCHROMATIC GRID_CELL_SIZE_PANCHROMATIC
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY_OLI IMAGE_QUALITY_OLI
IMAGE_QUALITY_TIRS IMAGE_QUALITY_TIRS
K1_CONSTANT_BAND_10 K1_CONSTANT_BAND_10
K1_CONSTANT_BAND_11 K1_CONSTANT_BAND_11
K2_CONSTANT_BAND_10 K2_CONSTANT_BAND_10
K2_CONSTANT_BAND_11 K2_CONSTANT_BAND_11
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
NADIR_OFFNADIR NADIR_OFFNADIR
ORIENTATION ORIENTATION
PANCHROMATIC_LINES PANCHROMATIC_LINES
PANCHROMATIC_SAMPLES PANCHROMATIC_SAMPLES
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_10 RADIANCE_ADD_BAND_10
RADIANCE_ADD_BAND_11 RADIANCE_ADD_BAND_11
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6 RADIANCE_ADD_BAND_6
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_ADD_BAND_8 RADIANCE_ADD_BAND_8
RADIANCE_ADD_BAND_9 RADIANCE_ADD_BAND_9
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_10 RADIANCE_MULT_BAND_10
RADIANCE_MULT_BAND_11 RADIANCE_MULT_BAND_11
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6 RADIANCE_MULT_BAND_6
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
RADIANCE_MULT_BAND_8 RADIANCE_MULT_BAND_8
RADIANCE_MULT_BAND_9 RADIANCE_MULT_BAND_9
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_6 REFLECTANCE_ADD_BAND_6
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_ADD_BAND_8 REFLECTANCE_ADD_BAND_8
REFLECTANCE_ADD_BAND_9 REFLECTANCE_ADD_BAND_9
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_6 REFLECTANCE_MULT_BAND_6
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTANCE_MULT_BAND_8 REFLECTANCE_MULT_BAND_8
REFLECTANCE_MULT_BAND_9 REFLECTANCE_MULT_BAND_9
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
RLUT_FILE_NAME
ROLL_ANGLE ROLL_ANGLE
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6 SATURATION_BAND_6
SATURATION_BAND_7 SATURATION_BAND_7
SATURATION_BAND_8 SATURATION_BAND_8
SATURATION_BAND_9 SATURATION_BAND_9
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ID SENSOR_ID
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
TARGET_WRS_PATH TARGET_WRS_PATH
TARGET_WRS_ROW TARGET_WRS_ROW
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
TIRS_SSM_MODEL TIRS_SSM_MODEL
TIRS_SSM_POSITION_STATUS TIRS_SSM_POSITION_STATUS
TIRS_STRAY_LIGHT_CORRECTION_SOURCE
TRUNCATION_OLI TRUNCATION_OLI
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

ETM+

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 7 ETM+ Tier 1:

Collection 1 Collection 2
LANDSAT/LE07/C01/T1 LANDSAT/LE07/C02/T1

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 B1
Green B2 B2
Red B3 B3
Near infrared B4 B4
Shortwave infrared 1 B5 B5
Low-gain thermal infrared 1 B6_VCID_1 B6_VCID_1
High-gain thermal infrared 1 B6_VCID_2 B6_VCID_2
Shortwave infrared 2 B7 B7
Panchromatic B8 B8
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for raw DN reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes.

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions.

Expand to compare property lists
Collection 1 Collection 2
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CORRECTION_BIAS_BAND_1 CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2 CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3 CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4 CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5 CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6_VCID_1 CORRECTION_BIAS_BAND_6_VCID_1
CORRECTION_BIAS_BAND_6_VCID_2 CORRECTION_BIAS_BAND_6_VCID_2
CORRECTION_BIAS_BAND_7 CORRECTION_BIAS_BAND_7
CORRECTION_BIAS_BAND_8 CORRECTION_BIAS_BAND_8
CORRECTION_GAIN_BAND_1 CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2 CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3 CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4 CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5 CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6_VCID_1 CORRECTION_GAIN_BAND_6_VCID_1
CORRECTION_GAIN_BAND_6_VCID_2 CORRECTION_GAIN_BAND_6_VCID_2
CORRECTION_GAIN_BAND_7 CORRECTION_GAIN_BAND_7
CORRECTION_GAIN_BAND_8 CORRECTION_GAIN_BAND_8
CPF_NAME
DATA_CATEGORY
DATA_SOURCE_ELEVATION
DATA_TYPE
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
EPHEMERIS_TYPE EPHEMERIS_TYPE
FILE_DATE
GAIN_BAND_1 GAIN_BAND_1
GAIN_BAND_2 GAIN_BAND_2
GAIN_BAND_3 GAIN_BAND_3
GAIN_BAND_4 GAIN_BAND_4
GAIN_BAND_5 GAIN_BAND_5
GAIN_BAND_6_VCID_1 GAIN_BAND_6_VCID_1
GAIN_BAND_6_VCID_2 GAIN_BAND_6_VCID_2
GAIN_BAND_7 GAIN_BAND_7
GAIN_BAND_8 GAIN_BAND_8
GAIN_CHANGE_BAND_1 GAIN_CHANGE_BAND_1
GAIN_CHANGE_BAND_2 GAIN_CHANGE_BAND_2
GAIN_CHANGE_BAND_3 GAIN_CHANGE_BAND_3
GAIN_CHANGE_BAND_4 GAIN_CHANGE_BAND_4
GAIN_CHANGE_BAND_5 GAIN_CHANGE_BAND_5
GAIN_CHANGE_BAND_6_VCID_1 GAIN_CHANGE_BAND_6_VCID_1
GAIN_CHANGE_BAND_6_VCID_2 GAIN_CHANGE_BAND_6_VCID_2
GAIN_CHANGE_BAND_7 GAIN_CHANGE_BAND_7
GAIN_CHANGE_BAND_8 GAIN_CHANGE_BAND_8
GAIN_CHANGE_SCAN_BAND_1 GAIN_CHANGE_SCAN_BAND_1
GAIN_CHANGE_SCAN_BAND_2 GAIN_CHANGE_SCAN_BAND_2
GAIN_CHANGE_SCAN_BAND_3 GAIN_CHANGE_SCAN_BAND_3
GAIN_CHANGE_SCAN_BAND_4 GAIN_CHANGE_SCAN_BAND_4
GAIN_CHANGE_SCAN_BAND_5 GAIN_CHANGE_SCAN_BAND_5
GAIN_CHANGE_SCAN_BAND_6_VCID_1 GAIN_CHANGE_SCAN_BAND_6_VCID_1
GAIN_CHANGE_SCAN_BAND_6_VCID_2 GAIN_CHANGE_SCAN_BAND_6_VCID_2
GAIN_CHANGE_SCAN_BAND_7 GAIN_CHANGE_SCAN_BAND_7
GAIN_CHANGE_SCAN_BAND_8 GAIN_CHANGE_SCAN_BAND_8
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GRID_CELL_SIZE_PANCHROMATIC GRID_CELL_SIZE_PANCHROMATIC
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
K1_CONSTANT_BAND_6_VCID_1 K1_CONSTANT_BAND_6_VCID_1
K1_CONSTANT_BAND_6_VCID_2 K1_CONSTANT_BAND_6_VCID_2
K2_CONSTANT_BAND_6_VCID_1 K2_CONSTANT_BAND_6_VCID_1
K2_CONSTANT_BAND_6_VCID_2 K2_CONSTANT_BAND_6_VCID_2
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
ORIENTATION ORIENTATION
PANCHROMATIC_LINES PANCHROMATIC_LINES
PANCHROMATIC_SAMPLES PANCHROMATIC_SAMPLES
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6_VCID_1 RADIANCE_ADD_BAND_6_VCID_1
RADIANCE_ADD_BAND_6_VCID_2 RADIANCE_ADD_BAND_6_VCID_2
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_ADD_BAND_8 RADIANCE_ADD_BAND_8
RADIANCE_MAXIMUM_BAND_1
RADIANCE_MAXIMUM_BAND_2
RADIANCE_MAXIMUM_BAND_3
RADIANCE_MAXIMUM_BAND_4
RADIANCE_MAXIMUM_BAND_5
RADIANCE_MAXIMUM_BAND_6_VCID_1
RADIANCE_MAXIMUM_BAND_6_VCID_2
RADIANCE_MAXIMUM_BAND_7
RADIANCE_MAXIMUM_BAND_8
RADIANCE_MINIMUM_BAND_1
RADIANCE_MINIMUM_BAND_2
RADIANCE_MINIMUM_BAND_3
RADIANCE_MINIMUM_BAND_4
RADIANCE_MINIMUM_BAND_5
RADIANCE_MINIMUM_BAND_6_VCID_1
RADIANCE_MINIMUM_BAND_6_VCID_2
RADIANCE_MINIMUM_BAND_7
RADIANCE_MINIMUM_BAND_8
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6_VCID_1 RADIANCE_MULT_BAND_6_VCID_1
RADIANCE_MULT_BAND_6_VCID_2 RADIANCE_MULT_BAND_6_VCID_2
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
RADIANCE_MULT_BAND_8 RADIANCE_MULT_BAND_8
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_ADD_BAND_8 REFLECTANCE_ADD_BAND_8
REFLECTANCE_MAXIMUM_BAND_1
REFLECTANCE_MAXIMUM_BAND_2
REFLECTANCE_MAXIMUM_BAND_3
REFLECTANCE_MAXIMUM_BAND_4
REFLECTANCE_MAXIMUM_BAND_5
REFLECTANCE_MAXIMUM_BAND_7
REFLECTANCE_MAXIMUM_BAND_8
REFLECTANCE_MINIMUM_BAND_1
REFLECTANCE_MINIMUM_BAND_2
REFLECTANCE_MINIMUM_BAND_3
REFLECTANCE_MINIMUM_BAND_4
REFLECTANCE_MINIMUM_BAND_5
REFLECTANCE_MINIMUM_BAND_7
REFLECTANCE_MINIMUM_BAND_8
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTANCE_MULT_BAND_8 REFLECTANCE_MULT_BAND_8
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6_VCID_1 SATURATION_BAND_6_VCID_1
SATURATION_BAND_6_VCID_2 SATURATION_BAND_6_VCID_2
SATURATION_BAND_7 SATURATION_BAND_7
SATURATION_BAND_8 SATURATION_BAND_8
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ANOMALIES
SENSOR_ID SENSOR_ID
SENSOR_MODE SENSOR_MODE
SENSOR_MODE_SLC
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

TM

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 5 TM Tier 1:

Collection 1 Collection 2
LANDSAT/LT05/C01/T1 LANDSAT/LT05/C02/T1

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Blue B1 B1
Green B2 B2
Red B3 B3
Near infrared B4 B4
Shortwave infrared 1 B5 B5
Thermal infrared 1 B6 B6
Shortwave infrared 2 B7 B7
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT
Solar azimuth angle SAA
Solar zenith angle SZA
View azimuth angle VAA
View zenith angle VZA

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for raw DN reflectance and thermal values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes (TM 5, for example).

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions (TM 5, for example).

Expand to compare property lists
Collection 1 Collection 2
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CORNER_LL_LAT_PRODUCT
CORNER_LL_LON_PRODUCT
CORNER_LL_PROJECTION_X_PRODUCT
CORNER_LL_PROJECTION_Y_PRODUCT
CORNER_LR_LAT_PRODUCT
CORNER_LR_LON_PRODUCT
CORNER_LR_PROJECTION_X_PRODUCT
CORNER_LR_PROJECTION_Y_PRODUCT
CORNER_UL_LAT_PRODUCT
CORNER_UL_LON_PRODUCT
CORNER_UL_PROJECTION_X_PRODUCT
CORNER_UL_PROJECTION_Y_PRODUCT
CORNER_UR_LAT_PRODUCT
CORNER_UR_LON_PRODUCT
CORNER_UR_PROJECTION_X_PRODUCT
CORNER_UR_PROJECTION_Y_PRODUCT
CORRECTION_BIAS_BAND_1 CORRECTION_BIAS_BAND_1
CORRECTION_BIAS_BAND_2 CORRECTION_BIAS_BAND_2
CORRECTION_BIAS_BAND_3 CORRECTION_BIAS_BAND_3
CORRECTION_BIAS_BAND_4 CORRECTION_BIAS_BAND_4
CORRECTION_BIAS_BAND_5 CORRECTION_BIAS_BAND_5
CORRECTION_BIAS_BAND_6 CORRECTION_BIAS_BAND_6
CORRECTION_BIAS_BAND_7 CORRECTION_BIAS_BAND_7
CORRECTION_GAIN_BAND_1 CORRECTION_GAIN_BAND_1
CORRECTION_GAIN_BAND_2 CORRECTION_GAIN_BAND_2
CORRECTION_GAIN_BAND_3 CORRECTION_GAIN_BAND_3
CORRECTION_GAIN_BAND_4 CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5 CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6 CORRECTION_GAIN_BAND_6
CORRECTION_GAIN_BAND_7 CORRECTION_GAIN_BAND_7
CPF_NAME
DATA_CATEGORY
DATA_SOURCE_ELEVATION
DATA_TYPE
DATA_TYPE_L0RP DATA_TYPE_L0RP
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
EPHEMERIS_TYPE EPHEMERIS_TYPE
FILE_DATE
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY GEOMETRIC_RMSE_VERIFY
GEOMETRIC_RMSE_VERIFY_QUAD_LL GEOMETRIC_RMSE_VERIFY_QUAD_LL
GEOMETRIC_RMSE_VERIFY_QUAD_LR GEOMETRIC_RMSE_VERIFY_QUAD_LR
GEOMETRIC_RMSE_VERIFY_QUAD_UL GEOMETRIC_RMSE_VERIFY_QUAD_UL
GEOMETRIC_RMSE_VERIFY_QUAD_UR GEOMETRIC_RMSE_VERIFY_QUAD_UR
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GRID_CELL_SIZE_THERMAL GRID_CELL_SIZE_THERMAL
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
K1_CONSTANT_BAND_6 K1_CONSTANT_BAND_6
K2_CONSTANT_BAND_6 K2_CONSTANT_BAND_6
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
MAP_PROJECTION_L0RA MAP_PROJECTION_L0RA
ORIENTATION ORIENTATION
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_1 RADIANCE_ADD_BAND_1
RADIANCE_ADD_BAND_2 RADIANCE_ADD_BAND_2
RADIANCE_ADD_BAND_3 RADIANCE_ADD_BAND_3
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6 RADIANCE_ADD_BAND_6
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_MAXIMUM_BAND_1
RADIANCE_MAXIMUM_BAND_2
RADIANCE_MAXIMUM_BAND_3
RADIANCE_MAXIMUM_BAND_4
RADIANCE_MAXIMUM_BAND_5
RADIANCE_MAXIMUM_BAND_6
RADIANCE_MAXIMUM_BAND_7
RADIANCE_MINIMUM_BAND_1
RADIANCE_MINIMUM_BAND_2
RADIANCE_MINIMUM_BAND_3
RADIANCE_MINIMUM_BAND_4
RADIANCE_MINIMUM_BAND_5
RADIANCE_MINIMUM_BAND_6
RADIANCE_MINIMUM_BAND_7
RADIANCE_MULT_BAND_1 RADIANCE_MULT_BAND_1
RADIANCE_MULT_BAND_2 RADIANCE_MULT_BAND_2
RADIANCE_MULT_BAND_3 RADIANCE_MULT_BAND_3
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6 RADIANCE_MULT_BAND_6
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
REFLECTANCE_ADD_BAND_1 REFLECTANCE_ADD_BAND_1
REFLECTANCE_ADD_BAND_2 REFLECTANCE_ADD_BAND_2
REFLECTANCE_ADD_BAND_3 REFLECTANCE_ADD_BAND_3
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_MAXIMUM_BAND_1
REFLECTANCE_MAXIMUM_BAND_2
REFLECTANCE_MAXIMUM_BAND_3
REFLECTANCE_MAXIMUM_BAND_4
REFLECTANCE_MAXIMUM_BAND_5
REFLECTANCE_MAXIMUM_BAND_7
REFLECTANCE_MINIMUM_BAND_1
REFLECTANCE_MINIMUM_BAND_2
REFLECTANCE_MINIMUM_BAND_3
REFLECTANCE_MINIMUM_BAND_4
REFLECTANCE_MINIMUM_BAND_5
REFLECTANCE_MINIMUM_BAND_7
REFLECTANCE_MULT_BAND_1 REFLECTANCE_MULT_BAND_1
REFLECTANCE_MULT_BAND_2 REFLECTANCE_MULT_BAND_2
REFLECTANCE_MULT_BAND_3 REFLECTANCE_MULT_BAND_3
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
SATURATION_BAND_1 SATURATION_BAND_1
SATURATION_BAND_2 SATURATION_BAND_2
SATURATION_BAND_3 SATURATION_BAND_3
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6 SATURATION_BAND_6
SATURATION_BAND_7 SATURATION_BAND_7
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ANOMALIES
SENSOR_ID SENSOR_ID
SENSOR_MODE SENSOR_MODE
SPACECRAFT_ID SENSOR_MODE_SLC
STATION_ID SPACECRAFT_ID
STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
THERMAL_LINES THERMAL_LINES
THERMAL_SAMPLES THERMAL_SAMPLES
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE
google:registration_count
google:registration_offset_x
google:registration_offset_y
google:registration_ratio

MSS

Asset ID

Replace C01 with C02 in image and collection IDs. For example, Landsat 1 MSS Tier 1:

Collection 1 Collection 2
LANDSAT/LM01/C01/T1 LANDSAT/LM01/C02/T1

Band names

Note band name changes and the addition of new bands.

Expand to see band name changes and the addition of new bands

Description Collection 1 Name Collection 2 Name
Green B4 (MSS 1-3); B1 (MSS 4-5) B4 (MSS 1-3); B1 (MSS 4-5)
Red B5 (MSS 1-3); B2 (MSS 4-5) B5 (MSS 1-3); B2 (MSS 4-5)
Near infrared 1 B6 (MSS 1-3); B3 (MSS 4-5) B6 (MSS 1-3); B3 (MSS 4-5)
Near infrared 2 B7 (MSS 1-3); B4 (MSS 4-5) B7 (MSS 1-3); B4 (MSS 4-5)
QA bitmask BQA QA_PIXEL
Radiometric saturation QA QA_RADSAT

Update code that selects bands whose names have changed, for example, the QA bitmask band:

Collection 1 Collection 2
image.select('BQA') image.select('QA_PIXEL')

Value scaling

No changes required. Collection 1 and Collection 2 have the same scaling for raw DN values.

QA masking

Bit codes have changed for the QA bitmask. See the "Bitmask for QA_PIXEL" (Collection 2) and "Bitmask for BQA" (Collection 1) sections in catalog entries for codes (MSS 1, for example).

The following expression creates a cloud and shadow mask for a given image using the Collection 2 QA bitmask codes.

Code Editor (JavaScript)

var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11010', 2)).eq(0)

Colab (Python)

qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11010', 2)).eq(0)

Image properties

In the transition from Collection 1 to Collection 2, some image properties were added and some were removed. No property names were changed. See the following property comparison table to determine whether you need to modify your code to accommodate missing or added properties (e.g., in filtering or processing). Refer to the Image Properties tab in the product's catalog page for Collection 2 property descriptions (MSS 1, for example).

Expand to compare property lists
Collection 1 Collection 2
CLOUD_COVER CLOUD_COVER
CLOUD_COVER_LAND CLOUD_COVER_LAND
COLLECTION_CATEGORY COLLECTION_CATEGORY
COLLECTION_NUMBER COLLECTION_NUMBER
CORRECTION_GAIN_BAND_4 CORRECTION_GAIN_BAND_4
CORRECTION_GAIN_BAND_5 CORRECTION_GAIN_BAND_5
CORRECTION_GAIN_BAND_6 CORRECTION_GAIN_BAND_6
CORRECTION_GAIN_BAND_7 CORRECTION_GAIN_BAND_7
CPF_NAME
DATA_CATEGORY
DATA_SOURCE_ELEVATION
DATA_TYPE
DATA_TYPE_L0RP DATA_TYPE_L0RP
DATE_ACQUIRED DATE_ACQUIRED
DATE_PRODUCT_GENERATED
DATUM DATUM
EARTH_SUN_DISTANCE EARTH_SUN_DISTANCE
ELEVATION_SOURCE
ELLIPSOID ELLIPSOID
EPHEMERIS_TYPE EPHEMERIS_TYPE
FILE_DATE
GAIN_BAND_4 GAIN_BAND_4
GAIN_BAND_5 GAIN_BAND_5
GAIN_BAND_6 GAIN_BAND_6
GAIN_BAND_7 GAIN_BAND_7
GEOMETRIC_RMSE_MODEL GEOMETRIC_RMSE_MODEL
GEOMETRIC_RMSE_MODEL_X GEOMETRIC_RMSE_MODEL_X
GEOMETRIC_RMSE_MODEL_Y GEOMETRIC_RMSE_MODEL_Y
GEOMETRIC_RMSE_VERIFY GEOMETRIC_RMSE_VERIFY
GEOMETRIC_RMSE_VERIFY_QUAD_LL GEOMETRIC_RMSE_VERIFY_QUAD_LL
GEOMETRIC_RMSE_VERIFY_QUAD_LR GEOMETRIC_RMSE_VERIFY_QUAD_LR
GEOMETRIC_RMSE_VERIFY_QUAD_UL GEOMETRIC_RMSE_VERIFY_QUAD_UL
GEOMETRIC_RMSE_VERIFY_QUAD_UR GEOMETRIC_RMSE_VERIFY_QUAD_UR
GRID_CELL_SIZE_REFLECTIVE GRID_CELL_SIZE_REFLECTIVE
GROUND_CONTROL_POINTS_MODEL GROUND_CONTROL_POINTS_MODEL
GROUND_CONTROL_POINTS_VERIFY GROUND_CONTROL_POINTS_VERIFY
GROUND_CONTROL_POINTS_VERSION GROUND_CONTROL_POINTS_VERSION
IMAGE_QUALITY IMAGE_QUALITY
LANDSAT_PRODUCT_ID LANDSAT_PRODUCT_ID
LANDSAT_SCENE_ID LANDSAT_SCENE_ID
MAP_PROJECTION MAP_PROJECTION
MAP_PROJECTION_L0RA MAP_PROJECTION_L0RA
ORIENTATION ORIENTATION
PRESENT_BAND_4 PRESENT_BAND_4
PRESENT_BAND_5 PRESENT_BAND_5
PRESENT_BAND_6 PRESENT_BAND_6
PRESENT_BAND_7 PRESENT_BAND_7
PROCESSING_LEVEL
PROCESSING_SOFTWARE_VERSION PROCESSING_SOFTWARE_VERSION
RADIANCE_ADD_BAND_4 RADIANCE_ADD_BAND_4
RADIANCE_ADD_BAND_5 RADIANCE_ADD_BAND_5
RADIANCE_ADD_BAND_6 RADIANCE_ADD_BAND_6
RADIANCE_ADD_BAND_7 RADIANCE_ADD_BAND_7
RADIANCE_MULT_BAND_4 RADIANCE_MULT_BAND_4
RADIANCE_MULT_BAND_5 RADIANCE_MULT_BAND_5
RADIANCE_MULT_BAND_6 RADIANCE_MULT_BAND_6
RADIANCE_MULT_BAND_7 RADIANCE_MULT_BAND_7
REFLECTANCE_ADD_BAND_4 REFLECTANCE_ADD_BAND_4
REFLECTANCE_ADD_BAND_5 REFLECTANCE_ADD_BAND_5
REFLECTANCE_ADD_BAND_6 REFLECTANCE_ADD_BAND_6
REFLECTANCE_ADD_BAND_7 REFLECTANCE_ADD_BAND_7
REFLECTANCE_MULT_BAND_4 REFLECTANCE_MULT_BAND_4
REFLECTANCE_MULT_BAND_5 REFLECTANCE_MULT_BAND_5
REFLECTANCE_MULT_BAND_6 REFLECTANCE_MULT_BAND_6
REFLECTANCE_MULT_BAND_7 REFLECTANCE_MULT_BAND_7
REFLECTIVE_LINES REFLECTIVE_LINES
REFLECTIVE_SAMPLES REFLECTIVE_SAMPLES
REQUEST_ID REQUEST_ID
RESAMPLING_OPTION RESAMPLING_OPTION
SATURATION_BAND_4 SATURATION_BAND_4
SATURATION_BAND_5 SATURATION_BAND_5
SATURATION_BAND_6 SATURATION_BAND_6
SATURATION_BAND_7 SATURATION_BAND_7
SCENE_CENTER_TIME SCENE_CENTER_TIME
SENSOR_ID SENSOR_ID
SPACECRAFT_ID SPACECRAFT_ID
STATION_ID STATION_ID
SUN_AZIMUTH SUN_AZIMUTH
SUN_ELEVATION SUN_ELEVATION
UTM_ZONE UTM_ZONE
WRS_PATH WRS_PATH
WRS_ROW WRS_ROW
WRS_TYPE

Landsat Pre-Collection

The Earth Engine data archive contains Landsat Pre-Collection data. It can be identified by image and collection IDs that lack a collection component.

  • Collection 1 / Collection 2: LANDSAT/[MISSION]/[COLLECTION]/[PRODUCT] (e.g., LANDSAT/LE07/C02/T1)
  • Pre-Collection: LANDSAT/[MISSION]_[PRODUCT] (e.g., LANDSAT/LE7_L1T)

If you are using Pre-Collection data, switch to Collection 2 as soon as possible. Use the information about Collection 2 throughout this guide to update your scripts.

Temporal composites

Earth Engine provides computed temporal composites (8-day, 32-day, and annual). There are a series of differences between those generated for Collection 1 and pre-Collection (PC/C1) and Collection 2 (C2). The code used to generate the C2 composites can be viewed on GitHub.

  • Surface reflectance composites

    The C2 composites are generated from the USGS L2 surface reflectance product, whereas PC/C1 composites were made using top-of-atmosphere reflectance.

  • One collection for all instruments

    The PC/C1 composites were separated into a set of temporal index composites for each instruments. This was primarily due to calibration differences between instruments. With C2 surface reflectance data, the inter-calibration is sufficient to combine are instruments together.

  • Strict filtering

    More aggressive filtering for data quality is applied for the C2 composites, including:

    • Limiting L7 to the range 1999–2017 due to orbital drift / scene acquisition time.
    • Omitting L8 data before May 1, 2013 due to orbit stability issues.
    • Omitting data with WRS_ROW ≥ 122 (no nighttime images).
    • Omitting any pixels that are QA-flagged as anything other than clear.
    • Omitting L4–L7 pixels with ATMOS_OPACITY > 300 (haze).
    • Omitting L8–L9 pixels with any QA_AEROSOL issues.
    • Omitting any pixels flagged as saturated or which have values that are out of bounds.
  • Median composites

    The PC/C1 composites used a last-on-top compositing. Collection 2 composites use a median compositor.

  • Naming

    The PC/C1 composite paths are in the form of LANDSAT/INSTRUMENT/C01/T1_PERIOD_INDEX, while the C2 composites are in the form of LANDSAT/COMPOSITES/C02/T1_L2_PERIOD_INDEX, where INSTRUMENT is one of LT04, LT05, LE07, or LC08 and PERIOD is one of 8DAY, 32DAY, or ANNUAL. As an example, the following table shows asset paths for C2 composites that roughly correspond to C1 LC08 annual composites for each INDEX. Recall that INSTRUMENT is not included in the C2 composites because all relevant data from L4–L9 are included in each composite.

    Collection 1 Collection 2
    LANDSAT/LC08/C01/T1_ANNUAL_BAI LANDSAT/COMPOSITES/C02/T1_L2_ANNUAL_BAI
    LANDSAT/LC08/C01/T1_ANNUAL_EVI LANDSAT/COMPOSITES/C02/T1_L2_ANNUAL_EVI
    LANDSAT/LC08/C01/T1_ANNUAL_GREENEST_TOA
    LANDSAT/LC08/C01/T1_ANNUAL_NBRT LANDSAT/COMPOSITES/C02/T1_L2_ANNUAL_NBR
    LANDSAT/LC08/C01/T1_ANNUAL_NDSI Not produced because snow pixels are masked during the compositing process
    LANDSAT/LC08/C01/T1_ANNUAL_NDVI LANDSAT/COMPOSITES/C02/T1_L2_ANNUAL_NDVI
    LANDSAT/LC08/C01/T1_ANNUAL_NDWI LANDSAT/COMPOSITES/C02/T1_L2_ANNUAL_NDWI
    LANDSAT/LC08/C01/T1_ANNUAL_RAW
    LANDSAT/LC08/C01/T1_ANNUAL_TOA