Вычислить расстояние (Анализ растра)

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

Вычисляет евклидово расстояние от одного или нескольких источников.

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

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

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

Иллюстрация

Иллюстрация инструмента Вычислить расстояние

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

  • Этот инструмент портала для анализа растров доступен, если вы вошли в портал ArcGIS Enterprise с ArcGIS Image Server, настроенным для Анализ растров. Когда инструмент запущен, ArcGIS Pro выступает в качестве клиента, а обработка происходит на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.

    Параметр Входной растровый слой поддерживает слой портала, URI или URL сервиса изображений или выходные данные инструмента Создать слой сервера изображений. Входной векторный слой может быть слоем портала или URI либо URL сервиса объектов. Указанный инструмент не поддерживает локальные наборы растровых данных или слои. Хотя вы можете использовать локальные векторные данные или слои как входные данные для инструментов портала, лучше все же использовать слои портала в качестве входных данных.

  • Одним из примеров использования этого инструмента является нахождение расстояния до любого местоположения в ближайшем городе.

  • Когда входные данные источников – сервис изображений, набор ячеек источников состоит из всех ячеек в исходном растре, которые имеют действительные значения. Ячейки, имеющие значение NoData, не включаются в набор источников. Нулевое значение рассматривается как истинный источник.

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

Параметры

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

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

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

Для сервиса объектов, входными данными могут точки, линии или полигоны.

Raster Layer; Image Service; Feature Layer; String
Имя выходного расстояния

Имя выходного сервиса растра расстояния.

String
Максимальное расстояние
(Дополнительный)

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

Единицами измерения являются Километры, Метры, Сухопутные мили, Международные ярды, Международные футы, Геодезические мили США, Геодезические ярды США и Геодезические футы США.

Единицы измерения по умолчанию метры.

Linear Unit
Размер выходной ячейки
(Дополнительный)

Задает размер ячейки и единицы измерения выходного растра.

Единицами измерения являются Километры, Метры, Сухопутные мили, Международные ярды, Международные футы, Геодезические мили США, Геодезические ярды США и Геодезические футы США.

Единицы измерения по умолчанию метры.

Linear Unit
Имя выходного путевого листа
(Дополнительный)

Имя выходного сервиса растра путевого листа.

String
Имя выходного распределения
(Дополнительный)

Имя выходного сервиса растра распределения.

String
Поле распределения
(Дополнительный)

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

String
Метод расстояний
(Дополнительный)

Задает, следует ли вычислять расстояние с помощью планарного (плоская земля) или геодезического (эллипсоид) метода.

  • ПланарныйРасчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию
  • ГеодезическийРасчет расстояния будет производиться по эллипсоиду. Поэтому, независимо от входной или выходной проекции, результаты не меняются.
String
Входной растр барьеров или объектов
(Дополнительный)

Набор данных, которым задаются барьеры.

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

Raster Layer; Image Service; Feature Layer; String
Имя выходного направления стока
(Дополнительный)

Имя выходного растрового сервиса направления стока.

String

Производные выходные данные

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

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

Raster Layer
Выходной растр направления

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

Raster Layer
Выходной растр обратного направления

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

Raster Layer
Выходной растр распределения

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

Raster Layer

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})
ИмяОписаниеТип данных
inputSourceRasterOrFeatures

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

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

Для сервиса объектов, входными данными могут точки, линии или полигоны.

Raster Layer; Image Service; Feature Layer; String
outputDistanceName

Имя выходного сервиса растра расстояния.

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

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

Единицами измерения являются Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards и Feet.

Единицы измерения по умолчанию метры.

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

Задает размер ячейки и единицы измерения выходного растра.

Единицами измерения являются Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards и Feet.

Единицы измерения по умолчанию метры.

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

Имя выходного сервиса растра путевого листа.

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

Имя выходного сервиса растра распределения.

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

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

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

Задает, следует ли вычислять расстояние с помощью планарного (плоская земля) или геодезического (эллипсоид) метода.

  • PlanarРасчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию
  • GeodesicРасчет расстояния будет производиться по эллипсоиду. Поэтому, независимо от входной или выходной проекции, результаты не меняются.
String
inputBarrierRasterOrFeatures
(Дополнительный)

Набор данных, которым задаются барьеры.

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

Raster Layer; Image Service; Feature Layer; String
outputBackDirectionName
(Дополнительный)

Имя выходного растрового сервиса направления стока.

String

Производные выходные данные

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

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

Raster Layer
outputDirectionRaster

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

Raster Layer
outputBackDirectionRaster

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

Raster Layer
outputAllocationRaster

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

Raster Layer

Пример кода

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

В данном примере вычисляется евклидово расстояние от одного источника.

import arcpy
arcpy.ra.CalculateDistance('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           "outDistance", "5000", "10", "outDirection", "outAllocation", "siting")
CalculateDistance, пример 2 (автономный скрипт)

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

# Name: CalculateDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance, direction and allocation
#              to the nearest source.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSourceData = 'https://MyPortal.esri.com/server/rest/services/Hosted/reccenter/ImageServer'
outDistanceName = "eucdistance"
maxDistance = "4000"
cellSize = "10"
outDirectionName = "eucdirect"
outAllocationName = "eurallocation"
allocationField = "dataid"


# Execute EucDistance
arcpy.ra.CalculateDistance(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
                           outAllocationName, allocationField)

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

  • Basic: Обязательно ArcGIS Image Server
  • Standard: Обязательно ArcGIS Image Server
  • Advanced: Обязательно ArcGIS Image Server

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