Подпись | Описание | Тип данных |
Входной растр | Набор растровых данных, набор данных мозаики или сервис изображений для вырезания. | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
Прямоугольник | Четыре координаты, определяющие экстент описывающего прямоугольника, который будет использоваться для вырезания растра. Если задан параметр Выходной экстент, то он автоматически будет заполнен значениями x-min, y-min, x-max и y-max. Чтобы сбросить прямоугольный экстент и вернуться к экстенту входного набора растровых данных, нажмите кнопку Сбросить . Если указанное значение не выровнено относительно входного набора растровых данных, инструмент произведет необходимое выравнивание. Это может стать причиной того, что выходные данные будут иметь немного другой экстент, чем указано. | Envelope; Feature Class; Feature Layer |
Выходной набор растровых данных | Имя, местоположение и формат создаваемого набора данных. Убедитесь в том, что он поддерживает необходимую глубину цвета. При сохранении набора растровых данных в формате файла укажите расширение файла следующим образом:
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в файле формата JPEG, файле JPEG 2000, файле TIFF или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в параметрах среды геообработки. | Raster Dataset |
Выходной экстент (Дополнительный) | Набор растровых данных или класс объектов, используемый в качестве экстента. Вырезанные выходные данные включают пикселы, пересекающие минимальный очерчивающий прямоугольник. Если экстент выходного растра задается при помощи класса пространственных объектов и вы хотите вырезать растр полигоном, отметьте параметр Использовать входные объекты для вырезающей геометрии. При использовании этого параметра может увеличиться глубина пиксела выходных данных. Убедитесь, что выходной формат поддерживает подходящую глубину пикселов. | Raster Layer; Feature Layer |
Значение NoData (Дополнительный) | Значения пикселов, которые будут считаться NoData. | String |
Использовать входные объекты для вырезающей геометрии (Дополнительный) | Указывает, будет ли использоваться для вырезания данных минимальный ограничивающий прямоугольник или геометрия указанного класса пространственных объектов.
| Boolean |
Сохранить экстент вырезания (Дополнительный) | Определяет экстент, который будет использоваться в вырезаемых выходных данных.
| Boolean |
Краткая информация
Вырезает часть набора растровых данных, набора данных мозаики или слоя сервиса изображений.
Иллюстрация
Использование
Этот инструмент позволяет извлекать фрагменты набора растровых данных на основании экстента шаблона. Вырезанные выходные данные включают пикселы, которые пересекают экстент шаблона. Чтобы извлечь фрагмент из набора классов, используйте инструмент Вырезать из набора инструментов Анализ.
Вырезанная область задается либо контурами заданного прямоугольника с помощью минимальных и максимальных координат x и y, либо путем использования файла выходного экстента. Если указанный вырезающий экстент не выровнен относительно входного набора растровых данных, инструмент произведет необходимое выравнивание. Это может стать причиной того, что выходные данные будут иметь немного другой экстент, чем указано в инструменте.
В качестве вырезающего экстента может использоваться существующий растр или векторный слой. Если вы используете класс пространственных объектов в качестве выходного экстента, вы можете вырезать растр ограничивающим прямоугольным экстентом этого класса или с помощью полигональной геометрии объектов. Если используется вырезающая геометрия, то глубина пикселов выходных данных может быть повышена. Убедитесь, что выходной формат поддерживает подходящую глубину пикселов.
Вы также можете использовать выбранные объекты в качестве экстента вырезания. Если выбран объект в классе пространственных объектов и отмечен параметр Использовать входные объекты в качестве вырезающей геометрии, выходные данные будут вырезаны по выбранным областям. Если выбран пространственный объект в классе пространственных объектов, но не отмечен параметр Использовать входные объекты для вырезающей геометрии, то в результате вырезание будет применено к минимальному очерчивающему прямоугольнику для этого пространственного объекта.
Вы можете интерактивно нарисовать полигон в области растра на карте и использовать его как вырезающий экстент. Щелкните ниспадающий список Создать новые объекты на текущей карте для использования в качестве входных данных и выберите Полигон. Затем перемещайте курсор по карте, чтобы оцифровать полигон. Дважды щелкните, чтобы завершить создание вырезающего полигона.
Примечание:
Единственная доступная опция для вырезания растрового слоя — Полигон.
Вы можете сохранить выходные данные в формат BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF или CRF или набор растровых данных любой базы геоданных.
Значения экстента должны быть в тех же единицах и в той же системе координат, что и набор растровых данных.
Этот инструмент поддерживает многомерные растровые данные. Чтобы запустить инструмент для обработка каждого среза в многомерном растре и сгенерировать многомерные растровые выходные данные, убедитесь, что выходные данные сохранены в формате CRF.
К поддерживаемым типам наборов данных многомерных растров относятся: многомерный растровый слой, набор данных мозаики, сервис изображений и CRF.
Параметры
arcpy.management.Clip(in_raster, rectangle, out_raster, {in_template_dataset}, {nodata_value}, {clipping_geometry}, {maintain_clipping_extent})
Имя | Описание | Тип данных |
in_raster | Набор растровых данных, набор данных мозаики или сервис изображений для вырезания. | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
rectangle | Четыре координаты, определяющие экстент описывающего прямоугольника, который будет использоваться для вырезания растра. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max. Если задан параметр in_template_dataset, то он автоматически задаст этот параметр. Если параметром in_template_dataset является векторный слой, то вырезающий экстент извлекается из ограничивающей рамки. В этом случае параметр rectangle может остаться пустым, поскольку указано значение параметра in_template_dataset. Если заданы оба параметра rectangle и in_template_dataset, то будет использоваться значение параметра rectangle. Если указанное значение не выровнено относительно входного набора растровых данных, инструмент произведет необходимое выравнивание. Это может стать причиной того, что выходные данные будут иметь немного другой экстент, чем указано. | Envelope; Feature Class; Feature Layer |
out_raster | Имя, местоположение и формат создаваемого набора данных. Убедитесь в том, что он поддерживает необходимую глубину цвета. При сохранении набора растровых данных в формате файла укажите расширение файла следующим образом:
При сохранении набора растровых данных в базе геоданных расширение файла к имени набора растровых данных добавлять не нужно. При хранении набора растровых данных в файле формата JPEG, файле JPEG 2000, файле TIFF или базе геоданных, вы можете указать Тип сжатия и Качество сжатия в параметрах среды геообработки. | Raster Dataset |
in_template_dataset (Дополнительный) | Набор растровых данных или класс объектов, используемый в качестве экстента. Вырезанные выходные данные включают пикселы, пересекающие минимальный очерчивающий прямоугольник. Если экстент выходного растра задается при помощи класса пространственных объектов и вы хотите ограничить экстент контуром полигональных объектов, для параметра clipping_geometry задайте ClippingGeometry. Использование этого параметра может увеличить глубину пиксела выходных данных. Убедитесь, что выходной формат поддерживает подходящую глубину пикселов. | Raster Layer; Feature Layer |
nodata_value (Дополнительный) | Значения пикселов, которые будут считаться NoData. | String |
clipping_geometry (Дополнительный) | Указывает, будет ли использоваться для вырезания данных минимальный ограничивающий прямоугольник или геометрия указанного класса пространственных объектов.
| Boolean |
maintain_clipping_extent (Дополнительный) | Определяет экстент, который будет использоваться в вырезаемых выходных данных
| Boolean |
Пример кода
Это пример Python для функции Clip.
import arcpy
arcpy.Clip_management(
"c:/data/image.tif","1952602 294196 1953546 296176",
"c:/data/clip.gdb/clip01", "#", "#", "NONE", "NO_MAINTAIN_EXTENT")
Это пример скрипта Python для функции Clip.
##Clip Raster Dataset by known extent - Left Bottom Right Top
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.Clip_management(
"image.tif","1952602.23 294196.279 1953546.23 296176.279",
"clip.gdb/clip", "#", "#", "NONE")
Это пример скрипта Python для функции Clip с использованием параметра clipping_geometry.
##Clip while maintaining original extent
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.Clip_management("c:\\test\\image.tif", "2536996.21761925 7365614.23930381 2537634.12209192 7366302.3861673",
"c:\\output\\clip.tif", "c:\\test\\clipfeature.shp", "0", "ClippingGeometry",
"MAINTAIN_EXTENT")