描述
按照块或面中的要素将栅格数据集分为多个更小的部分。
使用方法
输出文件将共享输入源栅格的大部分属性,例如,空间参考、源类型、像素类型、像素深度和像元大小。
分块方法可确定使用哪些可选参数来判断输出分块的尺寸和位置。在这两种情况下,使用 NoData 值在没有相应源数据的位置填充分块。数据格式取决于各种格式规范的限制以及源图像数据类型。无效组合会产生相应的错误消息。
如果分块已经存在(如果存在同名文件),则不会覆盖此分块。
如果分块仅包含 NoData 像素值,则不会创建此分块。
语法
arcpy.management.SplitRaster(in_raster, out_folder, out_base_name, split_method, format, {resampling_type}, {num_rasters}, {tile_size}, {overlap}, {units}, {cell_size}, {origin}, {split_polygon_feature_class}, {clip_type}, {template_extent}, {nodata_value})
参数 | 说明 | 数据类型 |
in_raster | 要进行分割的栅格。 | Mosaic Dataset; Mosaic Layer; Raster Layer |
out_folder | 新栅格数据集的目标。 | Folder |
out_base_name | 您将创建的每个栅格数据集的前缀。将对每个前缀追加一个数字(从 0 开始)。 | String |
split_method | 确定如何分割栅格数据集。
| String |
format | 输出栅格数据集的格式。
| String |
resampling_type (可选) | 根据您拥有的数据类型选择相应的技术。
| String |
num_rasters (可选) | 要将栅格数据集分割成的列 (x) 数和行 (y) 数。点的 X 坐标和 Y 坐标分别定义行数和列数。X 坐标是列数,Y 坐标是行数。 | Point |
tile_size (可选) | 输出分块的 x 尺寸和 y 尺寸。默认的测量单位是像素。可通过 units 参数更改测量单位。点的 X 坐标和 Y 坐标定义输出块的维度。X 坐标是输出的水平维度,Y 坐标是输出的垂直维度。 | Point |
overlap (可选) | 这些分块不必完全对齐;使用此参数设置分块之间的重叠数量。默认的测量单位是像素。可通过 units 参数更改测量单位。 | Double |
units (可选) | 设置 tile_size 和 overlap 参数的测量单位。
| String |
cell_size (可选) | 输出栅格的空间分辨率。如果留空,输出像元大小将与输入栅格相匹配。更改像元大小值时,分块大小将重置为图像大小,分块计数将重置为 1。 | Point |
origin (可选) | 更改左下角原点的坐标,即切片方案的开始位置。如果留空,左下角原点将与输入栅格相同。 | Point |
split_polygon_feature_class (可选) | 将用于分割栅格数据集的要素类。 | Feature Layer |
clip_type (可选) | 在分割栅格数据集之前,限制其范围。
| String |
template_extent (可选) | 用于定义裁剪边界的范围或数据集。数据集可以是一个栅格或一个要素类。 | Extent |
nodata_value (可选) | 具有指定值的所有像素将在输出栅格数据集中被设置为 NoData。 | String |
派生输出
名称 | 说明 | 数据类型 |
derived_out_folder | 输出文件夹。 | 文件夹 |
代码示例
SplitRaster 示例 1(Python 窗口)
这是 SplitRaster 工具的 Python 示例。
import arcpy
arcpy.SplitRaster_management("c:/source/large.tif", "c:/output/splitras",
"ras", "NUMBER_OF_TILES", "TIFF", "NEAREST",
"2 2", "#", "10", "PIXELS", "#", "#")
分割栅格 (SplitRaster) 示例 2(独立脚本)
这是 SplitRaster 工具的 Python 脚本示例。
##====================================
##Split Raster
##Usage: SplitRaster_management in_raster out_folder out_base_name SIZE_OF_TILE
## | NUMBER_OF_TILES | TIFF | BMP | ENVI | ESRI BIL |
## ESRI BIP | ESRI BSQ | GIF | GRID | IMAGINE IMAGE |
## JP2 | JPG | PNG {NEAREST | BILINEAR | CUBIC |
## MAJORITY} {num_rasters} {tile_size} {overlap}
## {PIXELS | METERS | FEET | DEGREES | KILOMETERS |
## MILES} {cell_size} {origin}
import arcpy
arcpy.env.workspace = r"\\myServer\PrjWorkspace\RasGP"
##Equally split a large TIFF image by number of images
arcpy.SplitRaster_management("large.tif", "splitras", "number", "NUMBER_OF_TILES",\
"TIFF", "NEAREST", "2 2", "#", "4", "PIXELS",\
"#", "#")
##Equally split a large TIFF image by size of images
arcpy.SplitRaster_management("large.tif", "splitras", "size2", "SIZE_OF_TILE",\
"TIFF", "BILINEAR", "#", "3500 3500", "4", "PIXELS",\
"#", "-50 60")
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是