Извлечь по точкам (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

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

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

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

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