Извлечь по точкам (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Краткая информация

Извлекает ячейки растра на основе координат точек.

Прежние версии:

Этот инструмент является Устаревшим и будет удален в будущих версиях.

Инструмент Извлечь по маске предоставляет улучшенную функциональность или производительность.

Иллюстрация

OutRas = ExtractByPoints(InRas1, [Point(1.5,0.5),Point(1.5,4.5),Point(4.5,4.5),Point(4.5,0.5)], "INSIDE")

Использование

• Дополнительные атрибуты входного растра, если имеются, будут перенесены в атрибутивную таблицу выходного растра без изменений. В зависимости от записываемого параметра, для некоторых атрибутивных значений может потребоваться пересчет.

• Если для параметра Входной растр (in_raster в Python) указан многоканальный растр, будет обработаны все каналы.

  Чтобы обработать выбранные каналы многоканального растра, сначала создайте набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы. Затем используйте результат в качестве Входного растра (in_raster в Python)

  Выходным форматом по умолчанию является растр базы геоданных. Если в качестве выходного формата указан Esri Grid stack, название стека не должно начинаться с цифры, содержать пробелы и должно иметь длину не более девяти символов.

• Не выбранным ячейкам присваивается значение NoData.

• Если входной растр целочисленный, выходной растр будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой.

• См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр	Входной растр, ячейки которого извлекаются.	Raster Layer
Входные точки	Точки, в которых значения будут извлечены из растра. Точки представляют собой пары координат x,y, заданных в тех же единицах карты, что и входной растр.	Point
Область извлечения (Дополнительный)	Определяет, нужно ли извлекать ячейки на основе заданных точек (внутри) или вне точек (снаружи) . Внутри—Ячейка, на которую попадает выбранная точка, должна быть выбрана и записана в выходной растр. Все ячейки, которые не совпадают с точками, будут иметь значения NoData в выходном растре. Снаружи—Ячейки, расположенные за пределами входных точек, должны быть выбраны и записаны в выходной растр.	String

Возвращаемое значение

Подпись	Описание	Тип данных
Выходной растр	Выходной растр, содержащий значения ячеек, извлеченные из входного растра.	Raster

Python

ExtractByPoints(in_raster, points, {extraction_area})

Имя	Описание	Тип данных
in_raster	Входной растр, ячейки которого извлекаются.	Raster Layer
points [point,...]	В Python список объектов типа Point обозначает местоположения, определяющие значения, которые будут извлечены из входного растра. Точки представляют собой список пар координат x,y, заданных в тех же единицах карты, что и входной растр. Форма объекта: [point(x1,y1), point(x2,y2),...]	Point
extraction_area (Дополнительный)	Определяет, нужно ли извлекать ячейки на основе заданных точек (внутри) или вне точек (снаружи) . INSIDE—Ячейка, на которую попадает выбранная точка, должна быть выбрана и записана в выходной растр. Все ячейки, которые не совпадают с точками, будут иметь значения NoData в выходном растре. OUTSIDE—Ячейки, расположенные за пределами входных точек, должны быть выбраны и записаны в выходной растр.	String

Возвращаемое значение

Имя	Описание	Тип данных
out_raster	Выходной растр, содержащий значения ячеек, извлеченные из входного растра.	Raster

Пример кода

ExtractByPoints, пример 1 (окно Python)

В этом примере из растра извлекаются ячейки на основе определенных координат точек.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pointList = [arcpy.Point(743050, 4321275), arcpy.Point(743100, 4321200),
             arcpy.Point(734500,4322000)]
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")
outPointExtract.save("c:/sapyexamples/output/pntextract")

ExtractByPoints, пример 2 (автономный скрипт)

В этом примере из растра извлекаются ячейки на основе определенных координат точек.

# Name: ExtractByPoints_Ex_02.py
# Description: Extracts the cells of a raster based on a set of points.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "soil"
pointList = [arcpy.Point(743050, 4321275), 
             arcpy.Point(743100, 4321200), 
             arcpy.Point(743500, 4322000),
             arcpy.Point(742900, 4321800)]

# Execute ExtractByPoints
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")

# Save the output 
outPointExtract.save("c:/sapyexamples/output/pntext")

Параметры среды

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

Информация о лицензиях

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst