Instructions

影像标准差拉伸是通过修剪影像的极值，然后对其他像素值进行线性拉伸来使影像的对比度增加。对原始影像的数据进行统计，主要是获得一个标准差取值范围，然后根据标准差拉伸系数重新计算标准差范围，将最后计算的标准差范围内的数值进行线性拉伸，使其分布在[0,255]之间，拉伸后的像元显示值与平均值偏离度减小。返回的结果类型为栅格数据集（RasterRDD）。

标准差：即方差的算术平方根，反映组内个体间的离散程度。简单来说就是表示组内大多数值和平均值的偏离程度。标准差越大，表示组内大多数数值和平均值偏离的越多。标准差越小，表示组内大多数值和平均值比较接近。

如下图所示，一个标准差系数像元值占比为68%，二个标准差系数像元占比为95%，三个标准差系数像元占比为99%。当定义标准差系数为2。那么超过2个标准差的像素值会被推到0或者255的位置。在两个标准差之间的像素值被线性拉伸至0-255。标准差拉伸经常用来使色调较暗的栅格数据集变亮。

下面通过直方图来形象地描述标准差这种拉伸方式。如下图所示，左图为影像经过标准差拉伸后的效果，右图为拉伸前后直方图对比图，可以看出，拉伸后，影像的直方图形状符合一个正态分布的曲线，并且拉伸后的影像的直方图的标准差增大，即影像数据的像元显示值与平均值偏离度减小。

标准差拉伸经常用来使色调较暗的影像变亮。

Parameter Specification

Parameter Name	Default Value	Parameter Definition	Parameter Type
待分析RDD		待分析RDD。	RasterRDD
标准差系数 （Optional）	2.0	标准差系数，默认为2.0。超过该标准差的像素值会被推到最大或最小目标像素值，其它数据以平均值加减该标准差为原始最值进行线性拉伸。	Double
是否在函数内做统计 （Optional）	true	是否在函数内做统计，默认为true，即在函数内对输入的栅格数据集进行全量统计。false表示由外部传入统计数据。	Boolean
各波段标准差 （Optional）		数据集每个波段的标准差，数组长度等于波段数。当不勾选【是否在函数内做统计】时才生效。这个值可以是某类数据的经验值，也可以是基本统计、直方图计算得来，也可以是直接获取数据信息中保存的统计值。	Object
各波段平均值 （Optional）		数据集每个波段的平均值，数组长度等于波段数。当不勾选【是否在函数内做统计】时才生效。这个值可以是某类数据的经验值，也可以是基本统计、直方图计算得来，也可以是直接获取数据信息中保存的统计值。	Object
各波段最小值 （Optional）		数据集每个波段的最小值，数组长度等于波段数。当不勾选【是否在函数内做统计】时才生效。这个值可以是某类数据的经验值，也可以是基本统计、直方图计算得来，也可以是直接获取数据信息中保存的统计值。	Object
各波段最大值 （Optional）		数据集每个波段的最大值，数组长度等于波段数。当不勾选【是否在函数内做统计】时才生效。这个值可以是某类数据的经验值，也可以是基本统计、直方图计算得来，也可以是直接获取数据信息中保存的统计值。	Object
最小目标像素值 （Optional）	0	最小目标像素值，原始像素值被拉伸至最小和最大目标像素值之间。默认是0。	Integer
最大目标像素值 （Optional）	255	最大目标像素值，原始像素值被拉伸至最小和最大目标像素值之间。默认是255。	Integer