Мультимасштабная разность поверхности (Spatial Analyst)

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

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

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

Подробнее о работе инструмента Мультимасштабная разность поверхности

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

• Максимальная разность от средней высоты рассчитывается по всем масштабам. Это означает, что для каждого масштаба определяется среднее значение высоты и разница между значением центральной ячейки и средним значением высоты для этого масштаба. Разница сохраняется для сравнения со значениями в разных масштабах. Эти масштабы представляют значение расстояния окрестности, используемое для расчета (расстояние от центра целевой ячейки, создающее квадрат ячеек вокруг целевой ячейки). Например, масштаб двух ячеек представляет собой окрестность размером 5 на 5 ячеек.

• Значением параметра Входной растр поверхности (in_raster в Python) может быть любой тип растра поверхности.

• Параметр Выходной растр разности (out_difference_raster в Python) — это основные выходные данные. Это растр, содержащий максимальную разницу от средней высоты в диапазоне пространственных масштабов.

• Параметр Выходной растр масштаба (out_scale_raster в Python) предоставляет дополнительную информацию об основных выходных данных. Он содержит масштаб, при котором для каждой ячейки была найдена максимальная разница от средней высоты. Масштаб — это значение расстояния окрестности, которое представляет собой расстояние от центра целевой ячейки, создавая квадрат ячеек вокруг целевой ячейки.

• Параметры Минимальное расстояние окрестности (min_scale в Python) и Максимальное расстояние окрестности (max_scale в Python) определяют минимальный и максимальный размеры окрестности, или масштабы, для которых будет рассчитываться разница. Эти значения представляют наименьшее и наибольшее расстояние от целевой ячейки. Например, значение 1 создает окрестность размером 3 на 3 ячейки, а значение 2 создает окрестность размером 5 на 5 ячеек.

  Эти значения не могут быть меньше, чем размер ячейки входного растра или 1 ячейка.

  Значение параметра Минимальное расстояние окрестности должно быть меньше или равно значению параметра Максимальное расстояние окрестности.

• Параметр Приращение расстояния (increment в Python) — это увеличение расстояния в окрестности между масштабами.

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

• Ячейки со значением NoData во Входном растре поверхности будут проигнорированы, и этим ячейкам будут присвоены значения NoData в значениях параметра Выходной растр разницы и Выходной растр масштаба.

• Этот инструмент может быть ускорен с помощью графического процессора, то есть если в вашей системе доступен совместимый графический процессор (GPU), он будет использоваться для повышения производительности инструмента. Используйте параметр задания целевого устройства анализа Целевое устройство для анализа (analysis_target_device в Python), чтобы определить, будет ли графический процессор или CPU использоваться для запуска инструмента.

  Более подробную информацию о совместимых графических процессорах, настройке и работе с графическими устройствами, а также советы по устранению неполадок см. в разделе Работа GPU с Spatial Analyst.

• Работа с графическим процессором приводит к более высокой точности выходных данных по сравнению с ЦПУ.

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

  По умолчанию, этот инструмент будет использовать 50 процентов доступных ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Растр входной поверхности	Входной растр поверхности.	Raster Layer
Выходной растр масштаба (Дополнительный)	Выходной растр, содержащий масштаб, при котором для каждой ячейки была обнаружена наибольшая разница. Масштабы представлены в виде значений расстояния между ними в окрестности. Он будет иметь тип с плавающей точкой.	Raster Dataset
Единицы измерения расстояния (Дополнительный)	Определяет единицу измерения расстояния, которая будет использоваться для параметров Минимального расстояния окрестности, Максимальное расстояние окрестности и Приращение расстояния. Расстояние будет измеряться в количестве ячеек или заданных единицах измерения. По умолчанию используется единица карты пространственной привязки для значения Входной растр поверхности. Ячейки—Единицами измерения расстояния будут ячейки. Метры—Единицами измерения расстояния будут метры. Сантиметры—Единицей измерения расстояния будет сантиметр. Километры—Единицами измерения расстояния будут километры. Дюймы—Единицей измерения расстояния будет дюйм. Футы—Единицами измерения расстояния будут футы. Ярд—Единицей измерения расстояния будет ярд. Мили—Единицами измерения расстояния будут мили.	String
Минимальное расстояние окрестности (Дополнительный)	Расстояние, определяющее минимальный масштаб окрестности, для которого будет рассчитана разница высот. Это расстояние от центра целевой ячейки, создающее квадрат из ячеек вокруг целевой ячейки. Это значение должно быть меньше или равно значению параметра Максимальное расстояние окрестности и больше или равно размеру ячейки входного растра или одной ячейке. Значение по умолчанию в 4 раза превышает размер ячейки параметра Входной растр поверхности, что приводит к окрестности размером 9 на 9 ячеек.	Double
Максимальное расстояние окрестности (Дополнительный)	Расстояние, определяющее максимальный масштаб окрестности, для которого будет рассчитана разница высот. Это расстояние от центра целевой ячейки, создающее квадрат из ячеек вокруг целевой ячейки. Это значение должно быть больше или равно значению параметра Минимальное расстояние окрестности и размеру ячейки входного растра или одной ячейке. Значение по умолчанию в 13 раз превышает размер ячейки параметра Входной растр поверхности, что приводит к окрестности размером 27 на 27 ячеек.	Double
Приращение расстояния (Дополнительный)	Увеличение расстояния окрестности между масштабами. Значение этого параметра не может быть меньше размера ячейки Входного растра поверхности или 1 ячейки. Значением по умолчанию является размер ячейки значения параметра Входной растр поверхности.	Double
Целевое устройство для анализа (Дополнительный)	Указывает устройство, которое будет использоваться для выполнения вычисления. GPU затем CPU—Если найден совместимый графический процессор GPU, он будет использоваться для выполнения вычисления. В противном случае будет использоваться центральный процессор CPU. Это значение по умолчанию Только на CPU.—Вычисление будет выполняться только на CPU. Только на CPU.—Вычисление будет выполняться только на CPU.	String

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

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

Python

MultiscaleSurfaceDifference(in_raster, {out_scale_raster}, {distance_units}, {min_scale}, {max_scale}, {increment}, {analysis_target_device})

Имя	Описание	Тип данных
in_raster	Входной растр поверхности.	Raster Layer
out_scale_raster (Дополнительный)	Выходной растр, содержащий масштаб, при котором для каждой ячейки была обнаружена наибольшая разница. Масштабы представлены в виде значений расстояния между ними в окрестности. Он будет иметь тип с плавающей точкой.	Raster Dataset
distance_units (Дополнительный)	Указывает единицы расстояния, которые будут использоваться для параметров min_scale, max_scale и increment. Расстояние будет измеряться в количестве ячеек или заданных единицах измерения. По умолчанию для значения in_raster используется картографическая единица карты пространственной привязки. CELLS—Единицами измерения расстояния будут ячейки. METERS—Единицами измерения расстояния будут метры. CENTIMETERS—Единицей измерения расстояния будет сантиметр. KILOMETERS—Единицами измерения расстояния будут километры. INCHES—Единицей измерения расстояния будет дюйм. FEET—Единицами измерения расстояния будут футы. YARDS—Единицей измерения расстояния будет ярд. MILES—Единицами измерения расстояния будут мили.	String
min_scale (Дополнительный)	Расстояние, определяющее минимальный масштаб окрестности, для которого будет рассчитана разница высот. Это расстояние от центра целевой ячейки, создающее квадрат из ячеек вокруг целевой ячейки. Это значение должно быть меньше или равно значению параметра max_scale и больше или равно размеру ячейки входного растра или одной ячейке. Значение по умолчанию в 4 раза превышает размер ячейки параметра in_raster, что приводит к окрестности размером 9 на 9 ячеек.	Double
max_scale (Дополнительный)	Расстояние, определяющее максимальный масштаб окрестности, для которого будет рассчитана разница высот. Это расстояние от центра целевой ячейки, создающее квадрат из ячеек вокруг целевой ячейки. Это значение должно быть больше или равно значению параметра min_scale и размеру ячейки входного растра или одной ячейке. Значение по умолчанию в 13 раз превышает размер ячейки параметра in_raster, что приводит к окрестности размером 27 на 27 ячеек.	Double
increment (Дополнительный)	Увеличение расстояния окрестности между масштабами. Значение этого параметра не может быть меньше размера ячейки in_raster или 1 ячейки. Значением по умолчанию является размер ячейки значения параметра in_raster.	Double
analysis_target_device (Дополнительный)	Указывает устройство, которое будет использоваться для выполнения вычисления. GPU_THEN_CPU—Если найден совместимый графический процессор GPU, он будет использоваться для выполнения вычисления. В противном случае будет использоваться центральный процессор CPU. Это значение по умолчанию CPU_ONLY—Вычисление будет выполняться только на CPU. GPU_ONLY—Вычисление будет выполняться только на CPU.	String

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

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

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python.

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

from arcpy.sa import *
outMaxDifferences = MultiscaleSurfaceDifference("elevation.tif", "", "", "", "", "", "")
outMaxDifferences.save("C:/sapyexamples/output/outmaxdifferencs01.tif")

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

В следующем примере показано использование этого инструмента как автономного скрипта Python.

В этом примере создается растр разностей для масштабов от 10 до 100 метров с шагом 1 метр между каждым масштабом.

# Name: MultiscaleSurfaceDifference_standalone.py
# Description: Calculates the maximum difference for each cell from the mean
# over a range of spatial scales.
# Requirements: Spatial Analyst Extension

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

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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set local variables
inRaster = "elevation.tif"
inDistanceUnits = "METERS"
inMinScale = 10
inMaxScale = 100
inIncrement = 1

# Execute the tool
outMaxDifferences = MultiscaleSurfaceDifference(inRaster, "", inDistanceUnits, inMinScale,
                                                inMaxScale, inIncrement, "")

# Save the output 
outMaxDifference.save("C:/sapyexamples/output/outmaxdifferences02.tif")

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

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

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

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