Извлечь по точкам (Инструменты Spatial Analyst)

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

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

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

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

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

Иллюстрация

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

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

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

Выходным форматом по умолчанию является растр базы геоданных. Если в качестве выходного формата указан Esri Grid stack, название стека не должно начинаться с цифры, содержать пробелы и должно иметь длину не более девяти символов.
Не выбранным ячейкам присваивается значение NoData.
Если входной растр целочисленный, выходной растр будет также целочисленным. Если входной растр с плавающей точкой, выходной растр также будет с плавающей точкой.
См. Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

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

Подпись

Объяснение

Тип данных

Входной растр

Входной растр, ячейки которого извлекаются.

Raster Layer

Входные точки

Точки, в которых значения будут извлечены из растра.

Точки представляют собой пары координат x,y, заданных в тех же единицах карты, что и входной растр.

Point

Область извлечения

(Дополнительный)

Определяет, нужно ли извлекать ячейки на основе заданных точек (внутри) или вне точек (снаружи) .

Внутри–Ячейка, на которую попадает выбранная точка, должна быть выбрана и записана в выходной растр. Все ячейки, которые не совпадают с точками, будут иметь значения NoData в выходном растре.
Снаружи–Ячейки, расположенные за пределами входных точек, должны быть выбраны и записаны в выходной растр.

String

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

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

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

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)]

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

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

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst

Извлечь по точкам (Инструменты Spatial Analyst)

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

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

Иллюстрация

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

Параметры

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

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

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

Связанные разделы