Оптимальные соединения регионов (Анализ растра)—ArcGIS Pro

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

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

Иллюстрация

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

Этот инструмент портала для анализа растров доступен, если вы вошли в портал ArcGIS Enterprise с ArcGIS Image Server, настроенным для Анализ растров. Когда инструмент запущен, ArcGIS Pro выступает в качестве клиента, а обработка происходит на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.
Параметр Входной растровый слой поддерживает слой портала, URI или URL сервиса изображений или выходные данные инструмента Создать слой сервера изображений. Входной векторный слой может быть слоем портала или URI либо URL сервиса объектов. Указанный инструмент не поддерживает локальные наборы растровых данных или слои. Хотя вы можете использовать локальные векторные данные или слои как входные данные для инструментов портала, лучше все же использовать слои портала в качестве входных данных.
В растровых данных регион – это группа ячеек, имеющих такое же значение, как и соседние ячейки. Если ваши входные регионы задаются растром, а какие-либо зоны (ячейки с одинаковыми значениями) состоят из нескольких регионов, сначала запустите инструмент Spatial Analyst Группировка в качестве действия по геообработке для присвоения уникальных значений регионам. Используйте полученный растр в качестве входных регионов для инструмента Оптимальные соединения регионов.
Если входные регионы растровые и диапазон ID строк очень велик (даже если имеется всего несколько регионов), производительность этого инструмента может снизиться.
Когда входные регионы представлены сервисом объектов, регионы внутренне конвертируются в растр до выполнения анализа.
Разрешение растра можно настраивать с помощью параметра среды Размер ячейки. По умолчанию, если в инструменте не указаны другие растры, разрешение будет определяться наименьшим размером ширины или высоты экстента из всех входных объектов, рассчитанным в выходной пространственной привязке и поделенным на 250.
Когда вход региона является пространственным объектом, поле ObjectID будет использоваться в качестве идентификатора региона.
Местоположения, определенные параметром Входной растр или объекты-барьеры или местоположениями ячеек с NoData для параметра Входной растр стоимости действуют как барьеры.
Экстент обработки по умолчанию соответствует Входному растру стоимости если он задан; иначе - экстенту входных регионов.
Отрицательные или нулевые значения Растра стоимости недействительны, но будут рассматриваться как небольшие положительные значения. Алгоритм накопительной стоимости представляет собой мультипликативный процесс, и он не может правильно рассчитать накопительную стоимость, если значения стоимости отрицательные или равны нулю. Если растр стоимости содержит эти значения, а эти местоположения представляют области, которые следует исключить из анализа, перед запуском инструмента присвойте этим ячейкам значение NoData. Это можно сделать с помощью расширения ArcGIS Spatial Analyst Установить Null. В данном анализе значение NoData рассматривается как барьер, поэтому любые местоположения, имеющие значение NoData во входных данных, будут иметь значение NoData в результате.
Для параметра Имя выходных соединительных линий соседств, если стоимостная поверхность не задана, то соседи определяются по евклидову расстоянию, а ближайшим соседом региона является тот, который находится ближе всего по расстоянию. Однако, когда есть стоимостная поверхность, соседи определяются по стоимостному расстоянию, и ближайший сосед региона является наименее затратным для поездки. Выполняется операция распределения по стоимостному расстоянию для определения регионов, являющихся по отношению друг к другу соседними.
Среда анализа Маска может быть настроена для объекта или набора растровых данных. Если маска является пространственным объектом, она будет преобразована в растр. Ячейки, имеющие значение, определяют местоположения, которые находятся в области маски. Ячейки NoData определяют местоположения, которые находятся за пределами области маски и будут рассматриваться как барьер.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входной растр или объекты регионов	Входные регионы, которые должны быть соединены в оптимальную сеть. В качестве регионов можно задать растровые или векторные данные. Если входными регионами являются растровые данные, регионы задаются как группы смежных ячеек, имеющие одинаковые значения. Регионы должны иметь уникальные номера. Ячейки, не входящие ни в один регион, должны иметь значение NoData. Растр должен быть целочисленным, а его значения могут быть как положительными, так и отрицательными. Если входные регионы представлены в виде векторных данных, это могут быть полигоны, линии или точки. Полигональные регионы не могут содержать составных объектов.	Raster Layer; Image Service; Feature Layer; String
Имя выходных линий оптимальной связности	Имя сервиса выходных линейных объектов, который соединяет каждый входной регион. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля: PATHID– уникальный идентификатор пути PATHCOST– общее накопленное расстояние или стоимость для пути REGION1– первый регион, который соединяется путями REGION2– другие регионы, которые соединяются путями Данная информация формирует понимание маршрутов сети. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий.	String
Входной растр или объекты-барьеры (Дополнительный)	Набор данных, определяющий барьеры. Барьеры могут быть определены сервисом изображений с целочисленными значениями, или со значениями с плавающей точкой, а также векторным слоем. Для сервиса объектов типами входных данных могут быть точки, линии или полигоны. Барьер сервиса изображений должен иметь допустимое значение, включая ноль, а области, которые не являются барьерами, должны быть NoData.	Raster Layer; Image Service; Feature Layer; String
Входной растр стоимости	Сервис изображений, определяющий импеданс или стоимость движения в плоскости через каждую ячейку. Значение в каждой ячейке представляет стоимость движения через ячейку по поверхности стоимости, выраженную на единицу расстояния. Для получения общей стоимости прохождения через ячейку, значение каждой ячейки умножается на разрешение ячейки, с учетом возможности движения по диагонали. Значения растра стоимости могут быть целыми числами или числами с плавающей точкой. Отрицательные или нулевые значения Растра стоимости недействительны, но будут рассматриваться как небольшие положительные значения стоимости.	Raster Layer; Image Service; String
Имя выходных соединительных линий соседств (Дополнительный)	Выходной класс полилинейных объектов, представляющий все пути из каждого региона до ближайших или стоимостных соседей. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля: PATHID– уникальный идентификатор пути PATHCOST– общее накопленное расстояние или стоимость для пути REGION1– первый регион, который соединяется путями REGION2– другие регионы, которые соединяются путями Данная информация формирует ваш взгляд на сетевые пути и очень полезна для определения того, какие пути в случае необходимости нужно удалить. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий.	String
Метод расстояний (Дополнительный)	Указывает, будет ли расстояние вычисляться с использованием планарного (плоская поверхность земли) или геодезического (эллипсоид) метода. Плоскостной—Расчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию Геодезический—Расчет расстояния будет производиться по эллипсоиду. Независимо от входной или выходной проекции, результаты не меняются.	String
Связи внутри регионов (Дополнительный)	Определяет, будут ли пути продолжены и будут ли они соединяться внутри входных регионов. Создать соединения—Пути будут продолжены внутри входных регионов, чтобы все пути в регионе были соединены. Нет соединений—Пути будут останавливаться на ребрах входных регионов и не будут продолжаться и соединяться внутри регионов.	String

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

Подпись	Описание	Тип данных
Выходные линии оптимальных соединений	Линии, которые оптимальным образом соединяют регионы.	Feature Class
Выходные соединительные линии соседств	Объекты выходной сети окрестностей	Feature Class

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})

Имя	Описание	Тип данных
inputRegionRasterOrFeatures	Входные регионы, которые должны быть соединены в оптимальную сеть. В качестве регионов можно задать растровые или векторные данные. Если входными регионами являются растровые данные, регионы задаются как группы смежных ячеек, имеющие одинаковые значения. Регионы должны иметь уникальные номера. Ячейки, не входящие ни в один регион, должны иметь значение NoData. Растр должен быть целочисленным, а его значения могут быть как положительными, так и отрицательными. Если входные регионы представлены в виде векторных данных, это могут быть полигоны, линии или точки. Полигональные регионы не могут содержать составных объектов.	Raster Layer; Image Service; Feature Layer; String
outputOptimalLinesName	Имя сервиса выходных линейных объектов, который соединяет каждый входной регион. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля: PATHID– уникальный идентификатор пути PATHCOST– общее накопленное расстояние или стоимость для пути REGION1– первый регион, который соединяется путями REGION2– другие регионы, которые соединяются путями Данная информация формирует понимание маршрутов сети. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий.	String
inputBarrierRasterOrFeatures (Дополнительный)	Набор данных, определяющий барьеры. Барьеры могут быть определены сервисом изображений с целочисленными значениями, или со значениями с плавающей точкой, а также векторным слоем. Для сервиса объектов типами входных данных могут быть точки, линии или полигоны. Барьер сервиса изображений должен иметь допустимое значение, включая ноль, а области, которые не являются барьерами, должны быть NoData.	Raster Layer; Image Service; Feature Layer; String
inputCostRaster	Сервис изображений, определяющий импеданс или стоимость движения в плоскости через каждую ячейку. Значение в каждой ячейке представляет стоимость движения через ячейку по поверхности стоимости, выраженную на единицу расстояния. Для получения общей стоимости прохождения через ячейку, значение каждой ячейки умножается на разрешение ячейки, с учетом возможности движения по диагонали. Значения растра стоимости могут быть целыми числами или числами с плавающей точкой. Отрицательные или нулевые значения Растра стоимости недействительны, но будут рассматриваться как небольшие положительные значения стоимости.	Raster Layer; Image Service; String
outputNeighborConnectionsName (Дополнительный)	Выходной класс полилинейных объектов, представляющий все пути из каждого региона до ближайших или стоимостных соседей. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля: PATHID– уникальный идентификатор пути PATHCOST– общее накопленное расстояние или стоимость для пути REGION1– первый регион, который соединяется путями REGION2– другие регионы, которые соединяются путями Данная информация формирует ваш взгляд на сетевые пути и очень полезна для определения того, какие пути в случае необходимости нужно удалить. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий.	String
distanceMethod (Дополнительный)	Указывает, будет ли расстояние вычисляться с использованием планарного (плоская поверхность земли) или геодезического (эллипсоид) метода. PLANAR—Расчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию GEODESIC—Расчет расстояния будет производиться по эллипсоиду. Независимо от входной или выходной проекции, результаты не меняются.	String
connectionsWithinRegions (Дополнительный)	Определяет, будут ли пути продолжены и будут ли они соединяться внутри входных регионов. GENERATE_CONNECTIONS—Пути будут продолжены внутри входных регионов, чтобы все пути в регионе были соединены. NO_CONNECTIONS—Пути будут останавливаться на ребрах входных регионов и не будут продолжаться и соединяться внутри регионов.	String

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

Имя	Описание	Тип данных
outputOptimalLinesFeatures	Линии, которые оптимальным образом соединяют регионы.	Feature Class
outputNeighborConnectionFeatures	Объекты выходной сети окрестностей	Feature Class

Пример кода

Optimal Region Connections , пример 1 (окно Python)

Этот пример вычисляет оптимальные соединения между регионами.

import arcpy

arcpy.ra.OptimalRegionConnections(
    "https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
    "https://myserver/rest/services/barriers/ImageServer",
    "https://myserver/rest/services/cost/ImageServer",
    "outNeighborConnections")

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

Этот пример вычисляет оптимальные соединения между регионами.

#-------------------------------------------------------------------------------
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal connections between regions.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputRegionsLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/regions/ImageServer'
outputName = 'outOptimalConnections'
inputBarriersLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/barriers/ImageServer'
inputCostLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
outputName02 = 'outNeighborConnections'
distanceMethod = 'GEODESIC'
connectionsWithinRegions = 'GENERATE_CONNECTIONS' 

arcpy.ra.OptimalRegionConnections(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

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

Размер ячейки, Экстент, Маска, Выходная система координат, Растр привязки

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

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

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

Отзыв по этому разделу?

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

Иллюстрация

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

Параметры

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

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

Пример кода

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

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

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

В этом разделе