摘要
通过基于统计数据的多种拉伸类型更改如亮度、对比度和 Gamma 等属性,从而增强影像效果。
语法
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,...] | 指定要应用于图像的拉伸类型。
(默认值为 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 时,将忽略统计数据参数。
(默认值为 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 值来渲染输出影像。
(默认值为 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)