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

Доступно с лицензией Spatial Analyst.

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

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

Более подробно о работе инструментов накопления расстояния

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

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

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

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

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

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

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

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

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

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

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

  Если растр стоимости содержит эти значения, а эти местоположения представляют области, которые следует исключить из анализа, перед запуском инструмента присвойте этим ячейкам значение NoData. Это можно реализовать с помощью инструмента Установить Null.

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

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

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

  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
  Hiking time               ~       -70    70     ~      ~      ~      ~
  Bidirectional hiking time ~       -70    70     ~      ~      ~      ~

• Выходные данные инструмента Экспозиция могут использоваться в качестве входных данных для параметра Входного горизонтального растра.

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

  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, чтобы получить подробную информацию об этой возможности и о том, как ее настроить.

  При использовании параллельной обработки будут записаны временные данные для управления обрабатываемыми фрагментами данных. Папка temp по умолчанию располагается на диске C: вашего компьютера. Вы можете управлять расположением этой папки, настроив Переменную системной среды с именем TempFolders и указав путь к папке, которая будет использоваться (например, E:\RasterCache). При наличии прав администратора на вашем компьютере, вы также можете использовать ключ реестра (например, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

  По умолчанию, этот инструмент использует половину доступных ядер. Если размер входных данных меньше, чем 5000 на 5000 ячеек, может использоваться меньшее число ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.

• Если формат выходного растра .crf, этот инструмент поддерживает параметр среды хранения растровых изображений Пирамида. Пирамиды будут созданы в выходных данных по умолчанию. Для любого другого формата вывода этот параметр среды не поддерживается, и пирамиды создаваться не будут.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные растровые или векторные объекты источников	Входные местоположения источников. Это растр или объект (точка, линия или полигон), определяющий ячейки или местоположения, которые будут использоваться для расчета расстояния с наименьшей накопленной стоимостью для каждого местоположения выходной ячейки. Для растров, входной тип может быть целочисленным или с плавающей точкой.	Raster Layer; Feature Layer
Входной растр или объекты-барьеры (Дополнительный)	Набор данных, определяющий барьеры. Барьеры могут быть определены целым числом или растром с плавающей запятой, либо точечным, линейным или полигональным объектом. Для растрового барьера барьер должен иметь допустимое значение, включая ноль, а области, которые не являются барьерами, должны иметь значение 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 не отрицательный. Время Пешей Прогулки — VF является функцией времени пешего перехода VRMA. Время Пешей Прогулки в Обоих Направлениях — VF является двунаправленной модифицированной функцией времени пешего перехода VRMA. Таблица - файл таблицы будет применяться для определения диаграммы вертикального фактора, используемого для определения различных VF. Модификаторы для ключевых слов вертикального фактора: Нулевой фактор – вертикальный фактор, используемый в случаях, когда VRMA равен 0. Этот фактор определяет точку пересечения с осью y для указанной функции. По определению, нулевой фактор не применим ни к одной из тригонометрических вертикальных функций (COS, SEC, COS-SEC или SEC-COS). Пересечение с осью Y устанавливается этими функциями. Нижний пороговый угол – значение угла VRMA, ниже которого VF будет задан равным бесконечности. Верхний пороговый угол – значение угла VRMA, при превышении которого VF будет задан равным бесконечности. Уклон – уклон прямой линии, используемый с ключевыми словами вертикального фактора Линейный и Обратный Линейный. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона - это 1/45 (значение при вводе равно 0,02222)). Имя таблицы – имя таблицы, задающей VF.	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. Таблица – файл таблицы будет использоваться для определения диаграммы горизонтального фактора, используемых для определения HFs. Модификаторы для горизонтального фактора: Нулевой фактор – горизонтальный фактор, используемый в случаях, когда HRMA равен 0. Этот фактор определяет точку пересечения с осью y для любой из функций горизонтального фактора. Пороговый угол – угол HRMA, при превышении которого HF будет задан равным бесконечности. Уклон – наклон прямой линии, используемый с ключевыми словами горизонтального фактора Линейный и Обратный линейный. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона - это 1/45 (значение при вводе равно 0,02222)). Значение стороны – HF в тех случаях, когда HRMA больше или равен 45 градусам и меньше 90 градусов, при использовании ключевого слова горизонтального фактора Вперед. Имя таблицы – имя таблицы, задающей HF.	Horizontal Factor
Выходной растр накопления расстояния (Дополнительный)	Выходной растр расстояния. Растр накопления расстояния содержит информацию об общем расстоянии для каждой ячейки «от» или «до», источника наименьшей стоимости.	Raster Dataset
Выходной растр обратного направления (Дополнительный)	Растр обратного направления содержит рассчитанное направление в градусах. Направление определяет следующую ячейку по кратчайшему пути до ближайшего источника, избегая барьеры. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север). Тип выходного растра – float.	Raster Dataset
Выходной растр направлений источника (Дополнительный)	Исходный растр направлений определяет направление ячейки источника с наименьшей суммой затрат, как выраженный в градусах азимут. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север). Тип выходного растра – float.	Raster Dataset
Выходной растр местоположений источника (Дополнительный)	Растр местоположений источника - выходные многоканальные данные. В первом канале содержится индекс строки, а во втором - индекс столбца. Эти индексы определяют местоположение исходной ячейки, которая находится на расстоянии наименьшей накопленной стоимости.	Raster Dataset
Поле источника (Дополнительный)	Поле, используемое для присвоения значений местоположениям источников. Должен быть целочисленным.	Field
Начальное накопление (Дополнительный)	Стоимость начального накопления, которая будет использоваться для начала расчета стоимости. Позволяет задавать фиксированную стоимость, связанную с источником. Алгоритм стоимости будет начинать с этого значения для Начальной стоимости, а не с нуля. Значения должны быть больше или равны нулю. Значение по умолчанию равно 0.	Double; Field
Максимальное накопление (Дополнительный)	Максимальное накопление для перемещающегося (для источника). Вычисление стоимости продолжается для каждого источника, пока не будет достигнуто указанное накопление. Значения должны быть больше нуля. Накопление по умолчанию рассчитывается к ребру выходного растра.	Double; Field
Множитель для применения к стоимости (Дополнительный)	Множитель, который будет применяться к значениям стоимости. Этот параметр позволяет управлять режимом перемещения или магнитудой источника. Чем больше множитель, тем выше стоимость перемещения по каждой ячейке. Значения должны быть больше нуля. Значение по умолчанию равно 1.	Double; Field
Направление движения (Дополнительный)	Определяет направление передвижения путешественника, если применяются горизонтальные и вертикальные факторы. Если выбрана опция Строка, вы можете выбрать направление от или до, которое будет применено ко всем источникам. Если выбран параметр Поле, можно выбрать поле из исходных данных, определяющее направление для каждого источника. Поле должно содержать текстовую строку FROM_SOURCE или TO_SOURCE. Перемещение от источника—Горизонтальный и вертикальный факторы будут применены, начиная от входного источника, и при перемещении по другим ячейкам, не являющимися источниками. Используется по умолчанию. Перемещение к источнику—Горизонтальный и вертикальный факторы будут применены, начиная от каждой ячейки, не являющейся источником, и при перемещении в обратном направлении к источнику.	String; Field
Метод расстояний (Дополнительный)	Указывает, будет ли расстояние вычисляться с использованием планарного (плоская поверхность земли) или геодезического (эллипсоид) метода. Плоскостной—Расчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Используется по умолчанию. Геодезический—Расчет расстояния будет производиться по эллипсоиду. Независимо от входной или выходной проекции, результаты не меняются.	String

Возвращаемое значение

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

Python

DistanceAllocation(in_source_data, {in_barrier_data}, {in_surface_raster}, {in_cost_raster}, {in_vertical_raster}, {vertical_factor}, {in_horizontal_raster}, {horizontal_factor}, {out_distance_accumulation_raster}, {out_back_direction_raster}, {out_source_direction_raster}, {out_source_location_raster}, {source_field}, {source_initial_accumulation}, {source_maximum_accumulation}, {source_cost_multiplier}, {source_direction}, {distance_method})

Имя	Описание	Тип данных
in_source_data	Входные местоположения источников. Это растр или объект (точка, линия или полигон), определяющий ячейки или местоположения, которые будут использоваться для расчета расстояния с наименьшей накопленной стоимостью для каждого местоположения выходной ячейки. Для растров, входной тип может быть целочисленным или с плавающей точкой.	Raster Layer; Feature Layer
in_barrier_data (Дополнительный)	Набор данных, определяющий барьеры. Барьеры могут быть определены целым числом или растром с плавающей запятой, либо точечным, линейным или полигональным объектом. Для растрового барьера барьер должен иметь допустимое значение, включая ноль, а области, которые не являются барьерами, должны иметь значение NoData.	Raster Layer; Feature Layer
in_surface_raster (Дополнительный)	Растр, определяющий значения высот в каждой ячейке. Значения используются для вычисления действительного расстояния по поверхности, которое будет пройдено при перемещении между ячейками.	Raster Layer
in_cost_raster (Дополнительный)	Растр, определяющий полное сопротивление или стоимость движения в плоскости через каждую ячейку. Значение в каждом местоположении ячейки представляет собой стоимость за единицу расстояния для перемещения через ячейку. Для получения общей стоимости прохождения через ячейку, значение каждой ячейки умножается на разрешение ячейки, с учетом возможности движения по диагонали. Значения растра стоимости могут быть целыми числами или числами с плавающей точкой. Отрицательные или нулевые значения Растра стоимости недействительны, но будут рассматриваться как небольшие положительные значения стоимости.	Raster Layer
in_vertical_raster (Дополнительный)	Растр, определяющий z-значения для каждого местоположения ячейки. Значения используются для вычисления уклонов, применяемых при определении вертикального фактора, учитываемого при перемещении из одной ячейки в другую.	Raster Layer
vertical_factor (Дополнительный)	Объект Vertical factor определяет отношение между фактором вертикальной стоимости и вертикальным углом относительного перемещения (VRMA). Существует несколько факторов с различными модификаторами, которые задают определенный график вертикального фактора. Дополнительно, для создания пользовательского графика можно воспользоваться таблицей. Графики применяются для определения вертикального фактора, используемого в вычислениях общей стоимости перемещения в соседнюю ячейку. В приведенных ниже пояснениях используются два сокращения: VF обозначает вертикальный фактор, идентифицирующий трудности преодоления разности высот, возникающие при продвижении от одной ячейки к другой; VRMA обозначает относительный вертикальный угол движения, который идентифицирует угол уклона между анализируемой ячейкой От и ячейкой До. Объект представлен в следующих формах: VfBinary, VfLinear, VfInverseLinear, VfSymLinear, VfSymInverseLinear, VfCos, VfSec, VfSec, VfCosSec, VfSecCos, VfHikingTime, VfBidirHikingTime, VfTable. Их определения и параметры выглядят так: 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 не отрицательный. VfHikingTime({lowCutAngle}, {highCutAngle}) VF является функцией времени пешего перехода VRMA. VfBidirHikingTime({lowCutAngle}, {highCutAngle}) VF является двунаправленной модифицированной функцией времени пешего перехода VRMA. VfTable(inTable) Файл таблицы будет применяться для определения диаграммы вертикального фактора, используемых для определения различных VF. Модификаторы для ключевых слов вертикального фактора выглядят так: 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)). inTable - имя таблицы, задающей VF.	Vertical Factor
in_horizontal_raster (Дополнительный)	Растр, определяющий горизонтальное направление в каждой ячейке. Значения на растре должны быть целыми числами в диапазоне от 0 до 360, значение 0 градусов соответствует направлению на север, или в верхнюю часть экрана. Значения увеличиваются по часовой стрелке. Плоским участкам должно быть присвоено значение, равное -1. Для определения дополнительной стоимости в горизонтальной плоскости, возникающей при движении из ячейки в соседние с ней ячейки, значения в каждом местоположении будут использоваться в сочетании с параметром horizontal_factor.	Raster Layer
horizontal_factor (Дополнительный)	Объект Horizontal Factor определяет отношение между горизонтальным фактором стоимости и горизонтальным относительным углом движения. Существует несколько факторов с различными модификаторами, которые задают определенный график горизонтального фактора. Дополнительно, для создания пользовательского графика можно воспользоваться таблицей. Графики применяются для определения горизонтального фактора, используемого в вычислениях общей стоимости перемещения в соседнюю ячейку. В приведенных ниже пояснениях используются два сокращения: HF обозначает горизонтальный фактор, идентифицирующий определенные препятствия при продвижении от одной ячейки к другой; HRMA обозначает относительный горизонтальный угол движения, который идентифицирует угол между направлением по горизонтали и направлением движения. Объект представлен в следующих формах: HfBinary, HfForward, HfLinear, HfInverseLinear и HfTable. Их определения и параметры выглядят так: 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. HfTable(inTable) Файл таблицы будет использоваться для определения диаграммы горизонтального фактора, используемых для определения HFs. Модификаторы для ключевых слов горизонтального фактора выглядят так: zeroFactor - горизонтальный фактор, используемый в случаях, когда HRMA равен 0. Этот фактор определяет точку пересечения с осью y для любой из функций горизонтального фактора. cutAngle - угол HRMA, при превышении которого HF будет задан равным бесконечности. slope - уклон прямой линии, используемый с ключевыми словами горизонтального фактора HfLinear и HfInverseLinear. Уклон задается как отношение подъема к расстоянию (например, 45 процентов уклона - это 1/45 (значение при вводе равно 0,02222)). sideValue - HF в тех случаях, когда HRMA больше или равен 45 градусам и меньше 90 градусов, при использовании ключевого слова горизонтального фактора HfForward. inTable - имя таблицы, задающей HF.	Horizontal Factor
out_distance_accumulation_raster (Дополнительный)	Выходной растр расстояния. Растр накопления расстояния содержит информацию об общем расстоянии для каждой ячейки «от» или «до», источника наименьшей стоимости.	Raster Dataset
out_back_direction_raster (Дополнительный)	Растр обратного направления содержит рассчитанное направление в градусах. Направление определяет следующую ячейку по кратчайшему пути до ближайшего источника, избегая барьеры. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север). Тип выходного растра – float.	Raster Dataset
out_source_direction_raster (Дополнительный)	Исходный растр направлений определяет направление ячейки источника с наименьшей суммой затрат, как выраженный в градусах азимут. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север). Тип выходного растра – float.	Raster Dataset
out_source_location_raster (Дополнительный)	Растр местоположений источника - выходные многоканальные данные. В первом канале содержится индекс строки, а во втором - индекс столбца. Эти индексы определяют местоположение исходной ячейки, которая находится на расстоянии наименьшей накопленной стоимости.	Raster Dataset
source_field (Дополнительный)	Поле, используемое для присвоения значений местоположениям источников. Должен быть целочисленным.	Field
source_initial_accumulation (Дополнительный)	Стоимость начального накопления, которая будет использоваться для начала расчета стоимости. Позволяет задавать фиксированную стоимость, связанную с источником. Алгоритм стоимости будет начинать с этого значения для Начальной стоимости, а не с нуля. Значения должны быть больше или равны нулю. Значение по умолчанию равно 0.	Double; Field
source_maximum_accumulation (Дополнительный)	Максимальное накопление для перемещающегося (для источника). Вычисление стоимости продолжается для каждого источника, пока не будет достигнуто указанное накопление. Значения должны быть больше нуля. Накопление по умолчанию рассчитывается к ребру выходного растра.	Double; Field
source_cost_multiplier (Дополнительный)	Множитель, который будет применяться к значениям стоимости. Этот параметр позволяет управлять режимом перемещения или магнитудой источника. Чем больше множитель, тем выше стоимость перемещения по каждой ячейке. Значения должны быть больше нуля. Значение по умолчанию равно 1.	Double; Field
source_direction (Дополнительный)	Определяет направление передвижения путешественника, если применяются горизонтальные и вертикальные факторы. FROM_SOURCE—Горизонтальный и вертикальный факторы будут применены, начиная от входного источника, и при перемещении по другим ячейкам, не являющимися источниками. Используется по умолчанию. TO_SOURCE—Горизонтальный и вертикальный факторы будут применены, начиная от каждой ячейки, не являющейся источником, и при перемещении в обратном направлении к источнику. Укажите ключевое слово FROM_SOURCE или TO_SOURCE, которое будет применено ко всем источникам, либо укажите поле в исходных данных, которое содержит ключевые слова, необходимые для идентификации направления перемещения для каждого источника. Это поле должно содержать строки FROM_SOURCE или TO_SOURCE.	String; Field
distance_method (Дополнительный)	Указывает, будет ли расстояние вычисляться с использованием планарного (плоская поверхность земли) или геодезического (эллипсоид) метода. PLANAR—Расчет расстояний выполняется на проецированной плоскости при использовании декартовой системы координат 2D. Используется по умолчанию. GEODESIC—Расчет расстояния будет производиться по эллипсоиду. Независимо от входной или выходной проекции, результаты не меняются.	String

Возвращаемое значение

Имя	Описание	Тип данных
out_distance_allocation_raster	Выходной растр распределения по расстоянию.	Raster

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outDistAlloc = DistanceAllocation("insources.shp", "barriers.tif")
outDistAlloc.save("c:/sapyexamples/output/distalloc.tif")

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

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

# Name: DistanceAllocation_Ex_02.py
# Description: Calculates the distance allocation.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSources = "insources.shp"
inBarrier = "barriers.tif"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute EucDirections
outDistAlloc = DistanceAllocation(inSources, inBarrier)

# Save the output 
outDistAlloc.save("c:/sapyexamples/output/distAllo2.tif")

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

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Пирамидные слои, Коэффициент параллельной обработки, Временная рабочая область, Растр привязки, Размер листа

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

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst