Landsat Collection 1 to Collection 2 migration

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):

Band names

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

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.

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)

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.

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

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.

ETM+

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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)

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.

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

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.

TM

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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)

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.

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

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).

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):

Band names

Note band name changes and the addition of new bands.

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

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.

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

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.

ETM+

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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

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

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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

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).

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):

Band names

Note band name changes and the addition of new bands.

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

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.

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

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.

ETM+

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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

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

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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

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).

MSS

Asset ID

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

Band names

Note band name changes and the addition of new bands.

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

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.

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

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).