Сводка
Разбивает набор растровых данных на меньшие элементы – листами или полигональными объектами.
Использование
Большинство свойств выходных файлов будет совпадать со свойствами входного исходного растра, например, пространственная привязка, тип пикселов, глубина пикселов и размер ячейки.
Метод разбиения на листы определяет, какие из дополнительных параметров используются для определения измерений и местоположения выходных листов. В обоих случаях значения 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)
Пример скрипта Python для инструмента SplitRaster.
import arcpy
arcpy.SplitRaster_management("c:/source/large.tif", "c:/output/splitras",
"ras", "NUMBER_OF_TILES", "TIFF", "NEAREST",
"2 2", "#", "10", "PIXELS", "#", "#")
SplitRaster, пример 2 (автономный скрипт)
Это пример скрипта Python для инструмента SplitRaster.
##====================================
##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: Да