Евклидово расстояние (Euclidean Distance) (Spatial Analyst)

Уровень лицензии:BasicStandardAdvanced

Резюме

Вычисляет, для каждой ячейки, Евклидово расстояние до ближайшего источника.

Более подробно об анализе Евклидова расстояния

Рисунок

Иллюстрация инструмента Евклидово расстояние (Euclidean Distance)
Euc_Dist = EucDistance(Source_Ras)

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

Синтаксис

EucDistance (in_source_data, {maximum_distance}, {cell_size}, {out_direction_raster})
ПараметрОбъяснениеТип данных
in_source_data

Входные местоположения источников.

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

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

Raster Layer | Feature Layer
maximum_distance
(дополнительно)

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

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

Значение по умолчанию равно расстоянию до границы выходного растра.

Double
cell_size
(дополнительно)

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

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

  • Если исходные данные - растр, выходные данные будут иметь тот же размер ячеек.
  • Если входные данные источников представлены классом пространственных объектов, размер ячейки по умолчанию будет равен длине меньшей из сторон (по высоте или по ширине) экстента входных объектов во входной пространственной привязке, деленной на 250.

Analysis Cell Size
out_direction_raster
(дополнительно)

Выходной растр Евклидова направления.

Растр направления содержит вычисленное направление в градусах, определяющее положение центра каждой ячейки по отношению к центру ближайшей ячейки источника.

Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление прямо на восток (вправо) определяется, как равное 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север).

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

Raster Dataset

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

ИмяОбъяснениеТип данных
out_distance_raster

Выходной растр Евклидова расстояния.

Растр расстояния определяет для каждой ячейки Евклидово расстояние до ближайшей ячейки источника, набора ячеек источников или местоположения источника.

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

Raster

Пример кода

Евклидово расстояние. Пример 1 (окно Python)

В следующем скрипте Python Window показано, как использовать инструмент Евклидово расстояние (Euclidean Distance).

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outEucDistance = EucDistance("rec_sites.shp", 5000, 5, 
                             "c:/sapyexamples/output/EucDirOut")
outEucDistance.save("C:/sapyexamples/output/eucdist")
Евклидово расстояние. Пример 2 (автономный скрипт)

Вычисляет для каждой ячейки расстояние по прямой линии до ближайшего источника.

# Name: EucDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance to the nearest source.
# 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
inSourceData = "rec_sites.shp"
maxDistance = 4000
cellSize = 4
outDirectionRaster = "C:/sapyexamples/output/eucdirect"

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

# Execute EucDistance
outEucDistance = EucDistance(inSourceData, maxDistance, cellSize, outDirectionRaster)

# Save the output 
outEucDistance.save("C:/sapyexamples/output/eucdist")

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует Spatial Analyst
ArcGIS for Desktop Standard: Требует Spatial Analyst
ArcGIS for Desktop Advanced: Требует Spatial Analyst
9/11/2013