Stretch

汇总

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

讨论

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

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

语法

Stretch(raster, stretch_type, min, max, num_stddev, statistics, dra, {min_percent}, max_percent, {gamma}, {compute_gamma}, sigmoid_strength_level)

参数	说明	数据类型
raster	The input raster.	Raster
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	默认情况下，会从数据中检索使用的统计数据；但如果在此参数中输入了任何统计数据值，则将使用该值来替代默认值。 统计数据将指定为： [[<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.sa.Stretch(imagePath1, "PercentClip", None, None, None, None, True, 0.25, 0.75, None, None, None)

相关主题

• Spatial Analyst 函数概述