重建裁剪范围

使用说明

重新创建镶嵌数据集的裁剪范围，从而更新镶嵌数据集的裁剪子数据集的内容。

一个镶嵌数据集下有三个子数据集，分别是轮廓、边界和裁剪。裁剪子数据集为一个面数据集，其中的面对象为镶嵌数据集中每幅影像的裁剪区，裁剪区为影像的有效值区域，但是，裁剪区默认为影像的轮廓区域，您可以使用该工具，自动计算影像的有效值区域，进而更新到裁剪区子数据集中。

该工具可以通过以下三种方式提取镶嵌数据集中每幅影像的裁剪区，并更新到裁剪子数据集中。

使用轮廓范围：默认情况下，裁剪子数据集使用影像轮廓作为其裁剪区。
自动计算裁剪范围：根据影像的有效区域自动构建其裁剪区。
读取裁剪文件：单幅影像的裁剪区由单独的shapefile格式的矢量数据文件存储，通过该方式可直接读取对应影像的裁剪区，并更新到裁剪子数据集中。

该工具的参数中除了必填参数，还提供了标记为可选的可选参数，这些可选参数就要基于以上三种方式进行选填，不同的提取裁剪区的方式需要设置的参数内容不同，下面分别进行介绍：

第一种：使用轮廓范围

裁剪子数据集默认基于轮廓子数据集创建，即每幅影像的裁剪区为该影像的轮廓。

当工具的所有可选参数均保持默认值时，默认将基于影像的轮廓构建其裁剪区，并更新到裁剪子数据集中。

此外，有时影像轮廓所确定的裁剪区，其边界存在一些无值，所以可以设置“裁剪偏移”可选参数，从而使裁剪区小于轮廓，即为影像轮廓向内缩小该参数指定像素值后的区域。

小结：该方式下，除了必须设置的必填参数外，可以选择性的设置“裁剪偏移”参数值，其他可选参数保持默认值。
第二种：自动计算裁剪范围

当工具的可选参数“自动计算裁剪范围”设置为true时，将自动提取影像的有效值区域作为裁剪区。

影像有效区域的形状，大致分为两种情况，一种是凸多边形的情况，如下面左图，影像有效区域为规则的平行四边形，属于凸多边形，另一种是非凸多边形的情况，也就是不规则形状，如下面右图。
1. 对于有效区域为凸多边形形状：还可以设置“精确裁剪”参数值为true，再配合“容限”参数值，可以使影像裁剪区的提取更加精确。其他可选参数保持默认设置。
2. 对于有效区域为不规则的形状：必须设置“复杂多边形”参数值为true，另外，还可以勾选“精确裁剪”，再配合“容限”参数值，使影像裁剪区的提取更加精确。其他可选参数保持默认设置。该设置也同样适用于有效区域为凸多边形形状的情况。
小结：该方式下，除了必须设置的必填参数外，必须设置“自动计算裁剪范围”参数值为true，若影像有效值区域为不规则的复杂多边形，必须设置“复杂多边形”参数值为true；可以选择性的设置“精确裁剪”、“容限”可选参数，其他可选参数保持默认值。
第三种：读取裁剪文件

当工具的可选参数“裁剪文件扩展名”设置为shp时，其他可选参数保持默认设置，将读取其中的矢量面对象作为影像的裁剪区。

这种获得影像裁剪区的方式适用于已经具有每幅影像的裁剪区面对象，要求每幅影像裁剪区存放在独立的 .shp 文件中，并且该 .shp 文件名称与对应影像文件同名。

小结：该方式下，除了必须设置的必填参数外，必须设置“裁剪文件扩展名”参数值为shp，其他可选参数保持默认值。

参数说明

参数名	默认值	参数释义	参数类型
镶嵌数据集		需要重建裁剪范围的镶嵌数据集。例如：可以使用“打开镶嵌数据集”工具，打开需要重建裁剪范围的镶嵌数据集，即将“打开镶嵌数据集”工具的输出结果作为该参数的输入。此外，还有其他工具的输出结果也是镶嵌数据集类型的，因此，也是可以作为该参数的输入。	DatasetMosaic
裁剪文件扩展名（可选）		可选参数。该参数值为true，将使用上文的“第三种：读取裁剪文件”的方式提取影像裁剪区。	String
自动计算裁剪范围（可选）	false	可选参数。该参数值为true，将使用上文的“第二种：自动计算裁剪范围”的方式提取影像裁剪区。	Boolean
精确裁剪（可选）	false	可选参数。该参数值为true时，自动计算裁剪区时，将基于原始影像文件提取影像有效轮廓；否则，将基于影像金字塔文件提取影像有效轮廓，提取效率高于精确裁剪。	Boolean
复杂多边形（可选）	false	可选参数。当使用“自动计算裁剪范围”功能时，若影像有效值轮廓为不规则的复杂多边形时，该参数值必须设置为true。	Boolean
容限（可选）	0	可选参数。当使用自动计算裁剪范围功能时，该容限可以调整所判断的无值，即无值不再是一个值，而是在容限范围内的所有值，这样可以避免提取后影像有效区域边界出现噪音的情况。	Integer
裁剪偏移（可选）	0	可选参数。裁剪偏移的像素值。有时影像轮廓所确定的裁剪区，其边界存在一些无值，所以可以设置“裁剪偏移”可选参数，从而使裁剪区小于轮廓，即为影像轮廓向内缩小该参数指定像素值后的区域。	Integer

输出结果

参数名	参数释义	参数类型
结果数据集	输出的镶嵌数据集。	DatasetMosaic