Распределение по расстоянию (Анализ растра)

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

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

Иллюстрация

Рабочий процесс Распределения по расстоянию

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

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

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

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

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

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

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

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

  • Барьеры - это препятствия, которые необходимо обходить. Их можно определить двумя способами.

    Для параметра Входные векторные или растровые данные барьеров, барьеры могут быть представлены либо ячейками с допустимым значением, либо данными объекта, которые преобразованы в растр. Там, где барьеры соединены только диагональными ячейками, барьеры будут утолщены, чтобы сделать их непроницаемыми.

    Барьеры также определяются местоположениями, в которых ячейки NoData существуют в следующих входных данных: Входной растр стоимости, Растр входной поверхности, Входной растр вертикального фактора и Входной растр горизонтального фактора. Если NoData соединяется только диагональными ячейками, оно будет усилено дополнительными ячейками NoData, чтобы сделать его непроницаемым барьером.

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

  • Значения по умолчанию для модификаторов Вертикального фактора следующие:

    Keyword                   Zero    Low    High   Slope  Power  Cos    Sec
                              factor  cut    cut                  power  power
                                      angle  angle                             
    ------------------------  ------  -----  -----  -----  -----  -----  -----
    Binary                    1.0     -30    30     ~      ~      ~      ~
    Linear                    1.0     -90    90      1/90  ~      ~      ~
    Symmetric linear          1.0     -90    90      1/90  ~      ~      ~
    Inverse linear            1.0     -45    45     -1/45  ~      ~      ~
    Symmetric inverse linear  1.0     -45    45     -1/45  ~      ~      ~
    Cos                       ~       -90    90     ~      1.0    ~      ~
    Sec                       ~       -90    90     ~      1.0    ~      ~
    Cos_sec                   ~       -90    90     ~      ~      1.0    1.0
    Sec_cos                   ~       -90    90     ~      ~      1.0    1.0
  • Выходные данные инструмента Экспозиция могут использоваться в качестве входных данных для параметра Входной горизонтальный растр.

  • Значения по умолчанию для модификаторов Горизонтального фактора следующие:

    Keywords         Zero factor   Cut angle     Slope   Side value
    --------------   -----------   -----------   -----   ---------
    Binary           1.0            45           ~       ~
    Forward          0.5            45 (fixed)   ~       1.0
    Linear           0.5           181            1/90   ~
    Inverse linear   2.0           180           -1/90   ~
  • Характеристики начальной точки или объекта, перемещающегося от начальной точки или возвращающегося в нее, контролируются определенными параметрами.

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

  • Если любые из характеристик источника указаны с использованием поля, характеристика источника будет применена по принципу источник-за-источником на основе информации в заданном поле для исходных данных. Если используется ключевое слово или константа, они применяются ко всем источникам.

  • Если задано значение Начальное накопление, исходным местоположениям на выходной поверхности стоимостного расстояния будет присвоено значение параметра Начальное накопление; иначе им будет присвоено значение 0.

  • Если параметр среды Экстент не задан, экстент обработки определяется следующим образом:

    Если указаны только значения Входные растровые или векторные данные источника и Входные векторные или растровые данные барьеров, то в качестве экстента обработки используется объединенный экстент входных данных, расширенный на ширину двух ячеек с каждой стороны. Причина, по которой выходной растр расширяется на две строки и два столбца, заключается в том, что выходные данные используются в вычислении Оптимального пути как растра и Оптимального пути как линии, а созданные пути могут огибать барьеры. Чтобы использовать экстент в качестве неявного барьера, необходимо задать значение Экстент в параметрах среды.

    Экстент обработки будет пересечением Входного растра поверхности, Входного растра стоимости, Входного растра вертикального фактора или Входного растра горизонтального фактора, если он указан.

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

  • Если параметры среды Размер ячейки или Растр привязки не заданы, а в качестве входных данных задано несколько растров, Размер ячейки и Растр привязки задаются в порядке очередности: Входной растр стоимости, Входная растровая поверхность, Входной растр вертикального фактора, Входной растр горизонтального фактора, Входные растровые или векторные данные источника и Входной растр барьеров или векторные объекты барьеры.

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

Параметры

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

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

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

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

Raster Layer; Feature Layer
Имя выходного растра распределения по расстоянию

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

String
Входной растр барьеров или объектов
(Дополнительный)

Набор данных, определяющий барьеры.

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

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

Raster Layer; Feature Layer
Входной растр поверхности
(Дополнительный)

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

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

Raster Layer
Входной растр стоимости
(Дополнительный)

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

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

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

Raster Layer
Входной растр вертикального фактора
(Дополнительный)

Сервис изображений, определяющий z-значения для каждого местоположения ячейки.

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

Raster Layer
Вертикальный фактор
(Дополнительный)

Определяет отношение между фактором вертикальной стоимости и вертикальным углом относительного перемещения (VRMA).

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

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

Для Вертикального фактора доступны следующие опции:

  • Двоичный – если VRMA больше нижнего порогового угла и меньше верхнего порогового угла, значение VF устанавливается равным значению, связанному с нулевым фактором; в противном случае, значение равно бесконечности.
  • Линейный – VF является линейной функцией VRMA.
  • Симметричный линейный – VF является линейной функцией VRMA либо с положительной, либо с отрицательной стороны VRMA, соответственно; эти две линейные функции симметричны относительно оси VF (оси y).
  • Обратный линейный – VF является обратной линейной функцией VRMA.
  • Симметричный обратный линейный – VF является обратный линейной функцией VRMA либо с положительной, либо с отрицательной стороны VRMA, соответственно; эти две линейные функции симметричны относительно оси VF (оси y).
  • Cos – VF является функцией косинуса VRMA.
  • Sec – VF является функцией секанса VRMA.
  • Cos-Sec - VF является косинусом угла VRMA, когда VRMA отрицательный, и секансом угла VRMA, когда VRMA не отрицательный.
  • Sec-Cos - VF является секансом угла VRMA, когда VRMA отрицательный, и косинусом угла VRMA, когда VRMA не отрицательный.

Модификаторы для ключевых слов вертикального фактора:

  • Нулевой фактор – вертикальный фактор, используемый в случаях, когда VRMA равен 0. Этот фактор определяет точку пересечения с осью y для указанной функции. По определению, нулевой фактор не применим ни к одной из тригонометрических вертикальных функций (COS, SEC, COS-SEC или SEC-COS). Пересечение с осью Y устанавливается этими функциями.
  • Нижний пороговый угол – значение угла VRMA, ниже которого VF будет задан равным бесконечности.
  • Верхний пороговый угол – значение угла VRMA, при превышении которого VF будет задан равным бесконечности.
  • Уклон – наклон прямой линии, используемый с ключевыми словами вертикального фактора Линейный и Обратный линейный. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона – это 1/45 (значение при вводе равно 0,02222)).
Vertical Factor
Входной растр горизонтального фактора
(Дополнительный)

Сервис изображений, определяющий горизонтальное направление в каждой ячейке.

Значения на растре должны быть целыми числами в диапазоне от 0 до 360, значение 0 градусов соответствует направлению на север, или в верхнюю часть экрана. Значения увеличиваются по часовой стрелке. Плоским участкам должно быть присвоено значение, равное -1. Для определения дополнительной стоимости в горизонтальной плоскости, возникающей при движении из ячейки в соседние с ней ячейки, значения в каждом местоположении будут использоваться в сочетании с Горизонтальным фактором.

Raster Layer
Горизонтальный фактор
(Дополнительный)

Задает отношение между коэффициентом горизонтальной стоимости и горизонтальным углом относительного перемещения (HRMA).

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

В приведенных ниже пояснениях используются два сокращения: HF обозначает горизонтальный фактор, идентифицирующий определенные препятствия при продвижении от одной ячейки к другой, а HRMA - относительный горизонтальный угол движения, который идентифицирует угол между направлением по горизонтали и направлением движения.

Для Горизонтального фактора доступны следующие опции:

  • Двоичный – если HRMA меньше порогового угла, значение HF устанавливается равным значению, связанному с нулевым фактором; в противном случае, значение равно бесконечности.
  • Вперед – движение возможно только вперед. Значение HRMA должно быть больше или равным 0 и меньше 90 градусов (0 <= HRMA < 90). Если HRMA больше 0 и меньше 45 градусов, HF для ячейки задаётся равным значению, связанному с нулевым фактором. Если HRMA больше или равен 45 градусам, тогда используется модификатор бокового значения. HF для любого HRMA, больше или равного 90 градусам, задается равным бесконечности.
  • Линейный – HF является линейной функцией HRMA.
  • Обратный линейный – HF является обратной линейной функцией HRMA.

Модификаторы для горизонтального фактора:

  • Нулевой фактор – горизонтальный фактор, используемый в случаях, когда HRMA равен 0. Этот фактор определяет точку пересечения с осью y для любой из функций горизонтального фактора.
  • Пороговый угол – угол HRMA, при превышении которого HF будет задан равным бесконечности.
  • Уклон – наклон прямой линии, используемый с ключевыми словами горизонтального фактора Линейный и Обратный линейный. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона – это 1/45 (значение при вводе равно 0,02222)).
  • Значение стороны – HF в тех случаях, когда HRMA больше или равен 45 градусам и меньше 90 градусов, при использовании ключевого слова горизонтального фактора Вперед.
Horizontal Factor
Имя выходного растра накопления расстояния
(Дополнительный)

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

Растр накопления расстояния содержит информацию об общем расстоянии для каждой ячейки «от» или «до», источника наименьшей стоимости.

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

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

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

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

Тип выходного растра – float.

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

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

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

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

Тип выходного растра – float.

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

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

Растр местоположений источника - выходные многоканальные данные. В первом канале содержится индекс строки, а во втором - индекс столбца. Эти индексы определяют местоположение исходной ячейки, которая находится на расстоянии наименьшей накопленной стоимости.

String
Поле источника
(Дополнительный)

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

Field
Начальное накопление
(Дополнительный)

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

Позволяет задавать фиксированную стоимость, связанную с источником. Алгоритм стоимости будет начинать с указанного для параметра Начальное накопление значения, а не с нуля.

Значения должны быть больше или равны нулю. По умолчанию - 0.

Double; Field
Максимальное накопление
(Дополнительный)

Максимальное накопление при перемещении к источнику.

Вычисление стоимости для каждого источника продолжается до тех пор, пока не будет достигнуто указанное накопление.

Значения должны быть больше нуля. По умолчанию на краю выходного растра идет накопление.

Double; Field
Множитель для применения к стоимости
(Дополнительный)

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

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

Значения должны быть больше нуля. Значение по умолчанию равно 1.

Double; Field
Направление движения
(Дополнительный)

Указывает направление перемещения при применении горизонтальных и вертикальных факторов.

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

Если выбран параметр Поле, можно выбрать поле из исходных данных, определяющее направление для каждого источника. Поле должно содержать текстовую строку FROM_SOURCE или TO_SOURCE.

  • Перемещение от источникаГоризонтальный и вертикальный факторы будут применены, начиная с входного источника и переходя к ячейкам без источника. Это значение по умолчанию
  • Перемещение к источникуГоризонтальный фактор и вертикальный фактор будут применены, начиная от каждой ячейки, не являющейся источником, затем будут распространяться назад до входного источника.
String; Field
Метод расстояний
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

Raster
Выходной растр местоположений источника

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

Raster

arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName, {inputBarrierRasterOrFeatures}, {inputSurfaceRaster}, {inputCostRaster}, {inputVerticalRaster}, {verticalFactor}, {inputHorizontalRaster}, {horizontalFactor}, {outputDistanceAccumulationRasterName}, {outputBackDirectionRasterName}, {outputSourceDirectionRasterName}, {outputSourceLocationRasterName}, {sourceField}, {sourceInitialAccumulation}, {sourceMaximumAccumulation}, {sourceCostMultiplier}, {sourceDirection}, {distanceMethod})
ИмяОписаниеТип данных
inputSourceRasterOrFeatures

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

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

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

Raster Layer; Feature Layer
outputDistanceAllocationRasterName

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

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

Набор данных, определяющий барьеры.

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

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

Raster Layer; Feature Layer
inputSurfaceRaster
(Дополнительный)

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

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

Raster Layer
inputCostRaster
(Дополнительный)

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

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

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

Raster Layer
inputVerticalRaster
(Дополнительный)

Сервис изображений, определяющий z-значения для каждого местоположения ячейки.

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

Raster Layer
verticalFactor
(Дополнительный)

Объект Vertical factor определяет отношение между фактором вертикальной стоимости и вертикальным углом относительного перемещения (VRMA).

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

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

Объект представлен в следующих формах: VfBinary, VfLinear, VfInverseLinear, VfSymLinear, VfSymInverseLinear, VfCos, VfSec, VfSec, VfCosSec и VfSecCos

Определения и параметры этих форм следующие:

  • VfBinary({zeroFactor}, {lowCutAngle}, {highCutAngle})

    Если VRMA больше нижнего порогового угла и меньше верхнего порогового угла, значение VF устанавливается равным значению, связанному с нулевым фактором; в противном случае, значение равно бесконечности.

  • VfLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    VF является линейной функцией VRMA.

  • VfInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    VF является обратной линейной функцией VRMA.

  • VfSymLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    VF является линейной функцией VRMA либо с отрицательной, либо с положительной стороны VRMA, соответственно; эти две линейные функции симметричны относительно оси VF (оси y).

  • VfSymInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    VF является обратной линейной функцией VRMA либо с отрицательной, либо с положительной стороны VRMA, соответственно; эти две линейные функции симметричны относительно оси VF (оси y).

  • VfCos({lowCutAngle}, {highCutAngle}, {cosPower})

    VF является функцией косинуса VRMA.

  • VfSec({lowCutAngle}, {highCutAngle}, {secPower})

    VF является функцией секанса VRMA.

  • VfCosSec({lowCutAngle}, {highCutAngle}, {cosPower}, {secPower})

    VF является косинусом угла VRMA, когда VRMA отрицательный, и секансом угла VRMA, когда VRMA не отрицательный.

  • VfSecCos({lowCutAngle}, {highCutAngle}, {secPower}, {cos_power})

    VF является секансом угла VRMA, когда VRMA отрицательный, и косинусом угла VRMA, когда VRMA не отрицательный.

Модификаторы для параметров вертикального фактора:

  • zeroFactor – вертикальный фактор, используемый в случаях, когда VRMA равен 0. Этот фактор определяет точку пересечения с осью y для указанной функции. По определению, нулевой фактор не применим ни к одной из тригонометрических вертикальных функций (Cos, Sec, Cos-Sec или Sec-Cos). Пересечение с осью Y устанавливается этими функциями.
  • lowCutAngle – значение угла VRMA, ниже которого VF будет задан равным бесконечности.
  • highCutAngle – значение угла VRMA, выше которого VF будет задан равным бесконечности.
  • slope – наклон прямой линии, используемый с параметрами VfLinear и VfInverseLinear. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона – это 1/45 (значение при вводе равно 0,02222)).
Vertical Factor
inputHorizontalRaster
(Дополнительный)

Растр, определяющий горизонтальное направление в каждой ячейке.

Значения на растре должны быть целыми числами в диапазоне от 0 до 360, значение 0 градусов соответствует направлению на север, или в верхнюю часть экрана. Значения увеличиваются по часовой стрелке. Плоским участкам должно быть присвоено значение, равное -1. Для определения дополнительной стоимости в горизонтальной плоскости, возникающей при движении из ячейки в соседние с ней ячейки, значения в каждом местоположении будут использоваться в сочетании с horizontal_factor.

Raster Layer
horizontalFactor
(Дополнительный)

Объект Horizontal Factor определяет отношение между горизонтальным фактором стоимости и горизонтальным относительным углом движения.

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

В приведенных ниже пояснениях используются два сокращения: HF обозначает горизонтальный фактор, идентифицирующий определенные препятствия при продвижении от одной ячейки к другой, а HRMA - относительный горизонтальный угол движения, который идентифицирует угол между направлением по горизонтали и направлением движения.

Объект представлен в следующих формах: HfBinary, HfForward, HfLinear и HfInverseLinear

Определения и параметры этих форм следующие:

  • HfBinary({zeroFactor}, {cutAngle})

    Если HRMA меньше порогового угла, значение HF устанавливается равным значению, связанному с нулевым фактором; в противном случае, значение равно бесконечности.

  • HfForward({zeroFactor}, {sideValue})

    Движение возможно только вперед. HRMA должен быть больше или равен 0 и меньше 90 градусов (0 < = HRMA < 90). Если HRMA больше 0 и меньше 45 градусов, HF для ячейки задаётся равным значению, связанному с нулевым фактором. Если HRMA больше или равен 45 градусам, тогда используется модификатор бокового значения. HF для любого HRMA, больше или равного 90 градусам, задается равным бесконечности.

  • HfLinear({zeroFactor}, {cutAngle}, {slope})

    HF является линейной функцией HRMA.

  • HfInverseLinear({zeroFactor}, {cutAngle}, {slope})

    HF является обратной линейной функцией HRMA.

Модификаторы для ключевых слов горизонтального фактора:

  • zeroFactor - горизонтальный фактор, используемый в случаях, когда HRMA равен 0. Этот фактор определяет точку пересечения с осью y для любой из функций горизонтального фактора.
  • cutAngle – угол HRMA, при превышении которого HF будет задан равным бесконечности.
  • slope – наклон прямой линии, используемый с ключевыми словами горизонтального фактора HfLinear и HfInverseLinear. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона – это 1/45 (значение при вводе равно 0,02222)).
  • sideValue – HF в тех случаях, когда HRMA больше или равен 45 градусам и меньше 90 градусов, при использовании ключевого слова горизонтального фактора HfForward.

Horizontal Factor
outputDistanceAccumulationRasterName
(Дополнительный)

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

Растр накопления расстояния содержит информацию об общем расстоянии для каждой ячейки «от» или «до», источника наименьшей стоимости.

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

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

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

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

Тип выходного растра – float.

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

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

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

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

Тип выходного растра – float.

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

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

Растр местоположений источника - выходные многоканальные данные. В первом канале содержится индекс строки, а во втором - индекс столбца. Эти индексы определяют местоположение исходной ячейки, которая находится на расстоянии наименьшей накопленной стоимости.

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

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

Field
sourceInitialAccumulation
(Дополнительный)

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

Позволяет задавать фиксированную стоимость, связанную с источником. Вместо начала вычисления стоимости с нуля, алгоритм стоимости начинает со значения, заданного параметром source_initial_accumulation.

Значения должны быть больше или равны нулю. По умолчанию - 0.

Double; Field
sourceMaximumAccumulation
(Дополнительный)

Максимальное накопление при перемещении к источнику.

Вычисление стоимости для каждого источника продолжается до тех пор, пока не будет достигнуто указанное накопление.

Значения должны быть больше нуля. По умолчанию на краю выходного растра идет накопление.

Double; Field
sourceCostMultiplier
(Дополнительный)

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

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

Значения должны быть больше нуля. Значение по умолчанию равно 1.

Double; Field
sourceDirection
(Дополнительный)

Указывает направление перемещения при применении горизонтальных и вертикальных факторов.

  • FROM_SOURCEГоризонтальный и вертикальный факторы будут применены, начиная с входного источника и переходя к ячейкам без источника. Это значение по умолчанию
  • TO_SOURCEГоризонтальный фактор и вертикальный фактор будут применены, начиная от каждой ячейки, не являющейся источником, затем будут распространяться назад до входного источника.

Укажите ключевое слово FROM_SOURCE или TO_SOURCE, которое будет применено ко всем источникам, либо укажите поле в исходных данных, содержащее ключевые слова, необходимые для идентификации направления перемещения для каждого источника. Это поле должно содержать строки FROM_SOURCE или TO_SOURCE.

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

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

  • PLANARРасчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию
  • GEODESICРасчет расстояния будет производиться по эллипсоиду. Независимо от входной или выходной проекции, результаты не меняются.
String

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

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

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

Raster
outputDistanceAccumulationRaster

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

Raster
outputBackDirectionRaster

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

Raster
outputSourceDirectionRaster

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

Raster
outputSourceLocationRaster

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

Raster

Пример кода

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

В следующем скрипте окна Python показано, как используется инструмент DistanceAllocation.

import arcpy

arcpy.ra.DistanceAllocation('https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer',
                            'outDistanceAllocation',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer')
DistanceAllocation, пример 2 (автономный скрипт)

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

# Name: DistanceAllocation_Ex_02.py
# Description: Calculates the distance allocation.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
outputDistanceAllocationRasterName = "outDistAllo"
inputBarrierRasterOrFeatures  = 'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer'
inputSurfaceRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer'
inputCostRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
inputVerticalRaster = 'https://MyPortal.esri.com/server/rest/services/vertical/sources/ImageServer'
verticalFactor = ""
inputHorizontalRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/horizontal/ImageServer'
horizontalFactor = ""
outputDistanceAccumulationRasterName = "outAccum"
outputBackDirectionRasterName = "outBackDir"
outputSourceDirectionRasterName = "outSourceDir"
outputSourceLocationRasterName = "outSourceLocation"
sourceField = "SourceID"
sourceInitialAccumulation = "IntitalAccum"
sourceMaximumAccumulation = "500000"
sourceCostMultiplier = "CostMultiplier"
sourceDirection = "FROM_SOURCE"
distanceMethod = "PLANAR"

# Execute 
arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName,
                            inputBarrierRasterOrFeatures, inputSurfaceRaster,
                            inputCostRaster, inputVerticalRaster, verticalFactor,
                            inputHorizontalRaster, horizontalFactor,
                            outputDistanceAccumulationRasterName, outputBackDirectionRasterName,
                            outputSourceDirectionRasterName, outputSourceLocationRasterName,
                            sourceField, sourceInitialAccumulation, sourceMaximumAccumulation,
                            sourceCostMultiplier, sourceDirection, distanceMethod)

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

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

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