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