Максимальное положение (Spatial Analyst)

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

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

Определяет по принципу «ячейка-за-ячейкой» положение растра с максимальным значением в наборе растров.

Иллюстрация

Пример входных и выходных значений инструмента Максимальное положение
OutRas = HighestPosition([InRas1, InRas2, InRas3])

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

  • В перечне входных растров может быть задано произвольное число растров.

  • Порядок входных растров важен для этого инструмента.

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

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

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

  • Выходной растр всегда будет целочисленным.

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

  • Если все входные данные представляют собой многомерные растровые данные с одинаковым количеством переменных, инструмент выполнит операцию для всех срезов с одинаковым значением размера. Результатом будет многомерный растр в формате CRF. Переменные во входных данных должны иметь по крайней мере одну общую размерность и одно общее размерное значение для обработки этим инструментом, в противном случае произойдет ошибка.

    Если все входные данные имеют одну переменную, но разные имена, снимите отметку Сопоставить многомерную переменную для среды геообработки (установите arcpy.env.matchMultidimensionalVariable = False в Python) перед выполнением операции.

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр или постоянные значения

Перечень входных растров, для которых будет определено положение входных данных с наибольшим значением.

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

Raster Layer; Constant

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

ПодписьОписаниеТип данных
Выходной растр

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

Для каждой ячейки выходного растра значение представляет положение растра с наибольшим значением.

Raster

HighestPosition(in_rasters_or_constants)
ИмяОписаниеТип данных
in_rasters_or_constants
[in_raster_or_constant,...]

Перечень входных растров, для которых будет определено положение входных данных с наибольшим значением.

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

Raster Layer; Constant

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

ИмяОписаниеТип данных
out_raster

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

Для каждой ячейки выходного растра значение представляет положение растра с наибольшим значением.

Raster

Пример кода

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

В этом примере оценивается несколько входных растров и в качестве выходного значения возвращается порядковый номер в списке растров, в котором это значение максимальное.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outHighestPosition = HighestPosition(["degs", "negs", "fourgrd"])
outHighestPosition.save("C:/sapyexamples/output/outhp.img")
HighestPosition, пример 2 (автономный скрипт)

В этом примере оценивается несколько входных растров и в качестве выходного значения возвращается порядковый номер в списке растров, в котором это значение максимальное.

# Name: HighestPosition_Ex_02.py
# Description: Determines the position of a raster with the maximum
#              value in a set of rasters
# 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
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute HighestPosition
outHighestPosition = HighestPosition([inRaster01, inRaster02, inRaster03])

# Save the output 
outHighestPosition.save("C:/sapyexamples/output/outhp")

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

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

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