本指南提供了从Landsat Collection 1 数据切换 到 Collection 2 数据的说明。自 2022 年以来，集合 2 已在 Earth Engine 中完全可用， 自 2021 年 12 月 31 日以来，美国地质调查局 (USGS) 未生成集合 1 数据。Landsat Collection 1 已弃用，鼓励所有用户尽快迁移到 Collection 2。前言 – 人工智能教程

每个陆地卫星集合 代表了使用一致的方法和例程处理的图像档案的一个版本。随着系统和处理算法的改进，新的集合会产生。2020 年，美国地质调查局开始将档案重新处理为Collection 2。请参阅《环境遥感》中的文章“The 50-year Landsat collection 2 archive”， 了解馆藏处理模型背后的基本原理以及 Collection 2 提供的内容和进步。

以下部分描述了每个 Landsat 数据产品从集合 1 迁移到集合 2 所需的更改，包括图像和集合 ID、波段名称、新波段、波段值缩放和位掩码值。每个部分中的内容选项卡提供特定传感器的详细信息。

表面反射率SR

资产ID

在图像和集合 ID 中替换为C01和C02。例如，Landsat 8 OLI Tier 1 （Landsat 9 OLI-2 未包含在COLLECTION 1 中）：SR转化为L2

波段名称

更新选择名称已更改的波段的代码，例如近红外波段：

值缩放

反射率/波段具有新的缩放因子。集合 1 使用0.0001 比例因子。集合 2 使用2.75e-05比例因子和-0.2偏移量。热带还具有新的比例和偏移因子。以下代码块定义了一个函数，用于应用集合 2 表面反射率和温度带缩放因子并将其映射到图像集合上。

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)

质量检查掩蔽

QA 位掩码 (CFMASK) 的位代码已更改。有关代码，请参阅目录条目中的“QA_PIXEL 的位掩码”部分 。

以下表达式使用 Collection 2 QA 位掩码代码为给定图像创建云和阴影蒙版。

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

辐射饱和度

辐射饱和度位掩码的位代码已更改。有关代码，请参阅目录条目中的“QA_RADSAT 的位掩码”部分 。

图像属性

在从集合 1 到集合 2 的过渡中，添加了一些图像属性，删除了一些图像属性。太阳几何的属性发生了改变。请参阅下面的属性比较表，以确定是否需要修改代码以适应缺失、添加或更改的属性（例如，在过滤或处理中）。有关 Collection 2 属性说明，请参阅 产品目录页面中的“图像属性”选项卡。

大气层顶部反射率TOA

资产ID

替换C01为C02图像和集合 ID。例如， Landsat 8 OLI Tier 1 （Landsat 9 OLI-2 未包含在集合 1 中）：

波段名称

请注意波段名称的更改和新波段的添加。

更新选择名称已更改的频段的代码，例如 QA 位掩码频段：

值缩放

无需更改。集合 1 和集合 2 对于大气层顶部反射率和热值具有相同的缩放比例。

质量检查掩蔽

QA 位掩码的位代码已更改。有关代码，请参阅目录条目中的“QA_PIXEL 的位掩码”部分 。

以下表达式使用 Collection 2 QA 位掩码代码为给定图像创建云和阴影蒙版。

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

图像属性

在从集合 1 到集合 2 的过渡中，添加了一些图像属性，删除了一些图像属性。没有更改属性名称。请参阅下面的属性比较表，以确定是否需要修改代码以适应缺失或添加的属性（例如，在过滤或处理中）。有关 Collection 2 属性说明，请参阅 产品目录页面中的“图像属性”选项卡。

缩放辐射率 (DN)

资产ID

替换C01为C02图像和集合 ID。例如， Landsat 8 OLI Tier 1 （Landsat 9 OLI-2 未包含在集合 1 中）：

波段名称

请注意波段的更改和新波段添加

更新选择名称已更改的频段的代码，例如 QA 位掩码频段：

价值缩放

无需更改。集合 1 和集合 2 对于原始 DN 反射率和热值具有相同的缩放比例。

质量检查掩蔽

QA 位掩码的位代码已更改。有关代码，请参阅目录条目中的“QA_PIXEL 的位掩码”部分 。

以下表达式使用 Collection 2 QA 位掩码代码为给定图像创建云和阴影蒙版。

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

图像属性

在从集合 1 到集合 2 的过渡中，添加了一些图像属性，删除了一些图像属性。没有更改属性名称。请参阅下面的属性比较表，以确定是否需要修改代码以适应缺失或添加的属性（例如，在过滤或处理中）。有关 Collection 2 属性说明，请参阅 产品目录页面中的“图像属性”选项卡。

陆地卫星预采集

Earth Engine 数据档案包含 Landsat 预收集数据。它可以通过缺少集合组件的图像和集合 ID 来识别。

• 集合 1 / 集合 2：（LANDSAT/[MISSION]/[COLLECTION]/[PRODUCT] 例如，LANDSAT/LE07/C02/T1）
• 预收集：（LANDSAT/[MISSION]_[PRODUCT]例如，LANDSAT/LE7_L1T）

如果您正在使用预收集数据，请尽快切换到收集 2。使用本指南中有关集合 2 的信息来更新您的脚本。