Stretch

描述

通过基于统计数据的多种拉伸类型更改如亮度、对比度和 Gamma 等属性,从而增强影像效果。

讨论

有关此函数工作原理的详细信息,请参阅 拉伸栅格函数。

栅格对象的引用栅格数据集是临时的。要将其设置为永久,可以调用栅格对象的 save 方法。

语法

Stretch (raster, stretch_type, min, max, num_stddev, statistics, dra, {min_percent}, max_percent, {gamma}, {compute_gamma}, sigmoid_strength_level)
参数说明数据类型
raster

输入栅格。

Raster
stretch_type
[stretch_type,...]

指定要应用于图像的拉伸类型。

  • None无论是否存在统计数据,都不会应用任何拉伸方法。
  • StdDev使用基于光谱建模的 Brovey 算法进行数据融合。需要指定标准差数 (num_stddev)、计算统计数据或将 DRA (dra) 设置为 True
  • Histogram应用直方图均衡化拉伸。需要使用源数据集来计算直方图,或将 DRA 设置为 True
  • MinMax以最小输出和最大输出像素值作为直方图的端点,应用线性拉伸。需要计算统计信息,或将 DRA (dra) 设置为 True
  • PercentClip在定义的最小和最大裁剪百分比像素值之间应用线性拉伸。
  • Sigmoid将图像中的所有像素沿反曲线函数(S 型曲线)放置。

(默认值为 0)

String
min

设置输出直方图的最低像素值。

输出最小值 (min) 和输出最大值 (max) 将设置值的范围,然后对其进行拉伸。

(默认值为 None)

Double
max

设置输出直方图的最高像素值。

输出最大值 (max) 和输出最小值 (min) 将设置值的范围,然后对其进行拉伸。

(默认值为 None)

Double
num_stddev

为要使用的标准差数量指定 n 值。此方法用于强调要素值与平均值的差异程度,最适用于正态分布的数据。

(默认值为 None)

Double
statistics
[statistics,...]

默认情况下,会从数据中检索使用的统计数据;但如果在此参数中输入了任何统计数据值,则将使用该值来替代默认值。

统计数据将指定为:[[<min>, <max>, <mean>, <standardDeviation>] [<min>, <max>, <mean>, <standardDeviation>] [<min>, <max>, <mean>, <standardDeviation>]]

(默认值为 None)

Double
dra

仅根据屏幕上显示的像素计算统计数据。当 DRA 为 True 时,将忽略统计数据参数。

  • True - 将计算动态范围调整 (dra)。
  • False - 不会计算动态范围调整 (dra)。

(默认值为 None)

Boolean
min_percent

指定在指定 PercentClip 拉伸时要排除的低值百分比。

有效值介于 0 到 99 之间。

(默认值为 None)

Double
max_percent

指定在指定 PercentClip 拉伸时要排除的高值百分比。

有效值介于 0 到 99 之间。

(默认值为 None)

Double
gamma

为要应用于影像的每个波段指定 Gamma 值。

例如,三波段影像将具有三个值,例如:[<gamma1>, <gamma2>, <gamma3>]

(默认值为 None)

Double
compute_gamma

将根据经验模型计算出最佳 Gamma 值来渲染输出影像。

  • True- 计算影像的 Gamma 值。
  • False- 不计算影像的 Gamma 值。

(默认值为 None)

Boolean
sigmoid_strength_level

决定了反曲线函数在拉伸中所应用的程度。较低的值(例如 1)将仅使用曲线的中间部分,由此形成阴暗和模糊的颜色。较高的值(例如 6)将使用整个曲线,由此形成明亮和清晰的颜色。有效范围是 1 - 6

(默认值为 None)

Integer
返回值
数据类型说明
Raster

输出拉伸栅格。

代码示例

拉伸示例

通过基于统计数据的多种拉伸类型更改如亮度、对比度和 Gamma 等属性,从而增强影像效果。

import arcpy

Stretch_raster = arcpy.ia.Stretch(imagePath1, "PercentClip", None, None, None, None, True, 0.25, 0.75, None, None, None)