Сводка
Вычисляет оптимальное соединение путей между двумя или более входными регионами.
Иллюстрация
Использование
Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise портал с расширением ArcGIS Image Server настроенный для Raster Analysis . При вызове инструмента сервера ArcGIS Pro являются клиентами, и обработка будет выполнятся на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.
Параметр Входной растровый слой поддерживает следующие элементы: слой портала, URI или URL сервиса изображений, выходные данные инструмента Создать слой сервера изображений. Сходной векторный слой может быть слоем портала. Это может быть URI или URL сервиса объектов. Указанный инструмент не поддерживает локальные наборы растровых данных или слои. Хотя вы можете использовать локальные векторные данные или слои как входные данные для инструментов портала, лучше все же использовать слои портала в качестве входных данных.
В растровых данных регион – это группа ячеек, имеющих такое же значение, как и соседние ячейки. Если ваши входные регионы идентифицированы растром, а какие-либо зоны (ячейки с одинаковыми значениями) состоят из нескольких регионов, сначала запустите инструмент Spatial Analyst расширение Группировка регионов в качестве действия по геообработке для присвоения уникальных значений регионам. Используйте полученный растр в качестве входных регионов для инструмента Оптимальные соединения регионов.
Если входные регионы растровые и диапазон ID строк очень велик (даже если имеется всего несколько регионов), производительность этого инструмента может снизиться.
Когда входные регионы представлены сервисом объектов, регионы внутренне конвертируются в растр до выполнения анализа.
Разрешение растра можно настраивать с помощью параметра среды Размер ячейки. По умолчанию, если в инструменте не указаны другие растры, разрешение будет определяться наименьшим размером ширины или высоты экстента из всех входных объектов, рассчитанным в выходной пространственной привязке и поделенным на 250.
Если входной регион является объектом, поле ObjectID будет использоваться как идентификатор региона.
Местоположения, определенные параметром Входной растр барьеров или данные объектов или местоположениями ячеек с NoData для параметра Входной растр стоимости действуют как барьеры.
Экстент обработки по умолчанию соответствует Входному растру стоимости если он задан; иначе - экстенту входных регионов.
Входной растр стоимости не может содержать нулевые значения, так как алгоритм представляет собой процесс умножения. Если растр стоимости содержит нулевые значения, и они представляют области наименьшей стоимости, замените нулевые значения на небольшие положительные числа (например, 0,01) перед запуском этого инструмента.
Для параметра Имя выходной сети окрестностей, если стоимостная поверхность не задана, то соседи определяются по евклидову расстоянию, а ближайшим соседом региона является тот, который находится ближе всего по расстоянию. Однако, когда есть стоимостная поверхность, соседи определяются по стоимостному расстоянию, и ближайший сосед региона является наименее затратным для поездки. Выполняется операция распределения по стоимостному расстоянию для определения регионов, являющихся по отношению друг к другу соседними.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})
Parameter | Объяснение | Тип данных |
inputRegionRasterOrFeatures | Входные регионы, которые должны быть соединены в оптимальную сеть. В качестве регионов можно задать растровые или векторные данные. Если входными являются растровые данные, регионы задаются как группы смежных ячеек, имеющие одинаковые значения. Регионы должны иметь уникальные номера. Ячейки, не входящие ни в один регион, должны иметь значение NoData. Растр должен быть целочисленным, а его значения могут быть как положительными, так и отрицательными. Если входные регионы представлены в виде векторных данных, это могут быть полигоны, линии или точки. Полигональные регионы не могут содержать составных объектов. | Raster Layer; Image Service; Feature Layer; String |
outputOptimalLinesName | Имя сервиса выходных линейных объектов, который соединяет каждый входной регион. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля:
Данная информация формирует понимание маршрутов сети. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий. | String |
inputBarrierRasterOrFeatures (Дополнительный) | Набор данных, определяющий барьеры. Барьеры могут быть определены сервисом изображений с целочисленными значениями, или со значениями с плавающей точкой, а также векторным слоем. Барьер сервиса изображений должен иметь допустимое значение, включая ноль, а области, которые не являются барьерами, должны быть NoData. | Raster Layer; Image Service; Feature Layer; String |
inputCostRaster | Сервис изображений, определяющий импеданс или стоимость движения в плоскости через каждую ячейку. Значение в каждой ячейке представляет стоимость движения через ячейку по поверхности стоимости, выраженную на единицу расстояния. Для получения общей стоимости прохождения через ячейку, значение каждой ячейки умножается на разрешение ячейки, с учетом возможности движения по диагонали. Значения на входном растре стоимости могут быть представлены целыми числами или числами с плавающей точкой, но они не могут быть отрицательными (стоимость не может быть отрицательной). | Raster Layer; Image Service; String |
outputNeighborConnectionsName (Дополнительный) | Выходной класс полилинейных объектов, представляющий все пути из каждого региона до ближайших или стоимостных соседей. Каждый путь (или линия) имеет уникальную нумерацию, а в дополнительных полях атрибутивной таблицы хранится специфическая информация о пути. Это следующие поля:
Данная информация формирует ваш взгляд на маршруты сети и полезна для определения того, какие пути в случае необходимости нужно удалить. Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, будет находиться несколько линий. | String |
distanceMethod (Дополнительный) | Задает, следует ли вычислять расстояние с помощью планарного (плоская земля) или геодезического (эллипсоид) метода.
| String |
connectionsWithinRegions (Дополнительный) | Указывает, будут ли пути продолжаться и соединяться в пределах входных регионов.
| String |
Производные выходные данные
Name | Объяснение | Тип данных |
outputOptimalLinesFeatures | Линии, которые оптимальным образом соединяют регионы. | Класс пространственных объектов |
outputNeighborConnectionFeatures | Объекты выходной сети окрестностей | Класс пространственных объектов |
Пример кода
Этот пример вычисляет оптимальные соединения между регионами.
import arcpy
arcpy.OptimalRegionConnections_ra(
"https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
"https://myserver/rest/services/barriers/ImageServer",
"https://myserver/rest/services/cost/ImageServer",
"outNeighborConnections")
Этот пример вычисляет оптимальные соединения между регионами.
#-------------------------------------------------------------------------------
# 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.OptimalRegionConnections_ra(inputRegionsLayer, outputName, inputBarriersLayer,
inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)
Environments
Информация о лицензиях
- Basic: Требуется ArcGIS Image Server
- Standard: Требуется ArcGIS Image Server
- Advanced: Требуется ArcGIS Image Server