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

Сводка

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

Иллюстрация

Пример инструмента Оптимальные соединения регионов

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

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

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

  • В растровых данных регион – это группа ячеек, имеющих такое же значение, как и соседние ячейки. Если ваши входные регионы идентифицированы растром, а какие-либо зоны (ячейки с одинаковыми значениями) состоят из нескольких регионов, сначала запустите инструмент Spatial Analyst расширение Группировка регионов в качестве действия по геообработке для присвоения уникальных значений регионам. Используйте полученный растр в качестве входных регионов для инструмента Оптимальные соединения регионов.

  • Если входные регионы растровые и диапазон ID строк очень велик (даже если имеется всего несколько регионов), производительность этого инструмента может снизиться.

  • Когда входные регионы представлены сервисом объектов, регионы внутренне конвертируются в растр до выполнения анализа.

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

  • Если входной регион является объектом, поле ObjectID будет использоваться как идентификатор региона.

  • Местоположения, определенные параметром Входной растр барьеров или данные объектов или местоположениями ячеек с NoData для параметра Входной растр стоимости действуют как барьеры.

  • Экстент обработки по умолчанию соответствует Входному растру стоимости если он задан; иначе - экстенту входных регионов.

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

  • Для параметра Имя выходной сети окрестностей, если стоимостная поверхность не задана, то соседи определяются по евклидову расстоянию, а ближайшим соседом региона является тот, который находится ближе всего по расстоянию. Однако, когда есть стоимостная поверхность, соседи определяются по стоимостному расстоянию, и ближайший сосед региона является наименее затратным для поездки. Выполняется операция распределения по стоимостному расстоянию для определения регионов, являющихся по отношению друг к другу соседними.

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

Синтаксис

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})
ParameterОбъяснениеТип данных
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

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

NameОбъяснениеТип данных
outputOptimalLinesFeatures

Линии, которые оптимальным образом соединяют регионы.

Класс пространственных объектов
outputNeighborConnectionFeatures

Объекты выходной сети окрестностей

Класс пространственных объектов

Пример кода

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

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

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")
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.OptimalRegionConnections_ra(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

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

  • Basic: Требуется ArcGIS Image Server
  • Standard: Требуется ArcGIS Image Server
  • Advanced: Требуется ArcGIS Image Server

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