Накопление расстояния

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

Примечание:

Для запуска этого инструмента портал должен быть настроен для анализа растров.

Если вы не видите этот инструмент в Map Viewer, свяжитесь с администратором портала. Возможно, ваш портал не настроен для анализа растров, или у вас может не быть прав, необходимых для запуска инструмента.

Схема рабочего процесса

Примеры

Примеры задач, в которых необходимо вычислять расстояния:

• Каково расстояние до ближайшего города?
• Каково стоимостное расстояние до ближайшей дороги?
• Каково расстояние с учетом объезда барьера до ближайшего источника водоснабжения?

Примечания по использованию

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметры этого инструмента перечислены в следующей таблице:

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

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

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

Этот инструмент поддерживает следующие Параметры среды анализа:

• Выходная система координат - Задает систему координат выходного слоя.
• Экстент - указывает область, которая будет использоваться для анализа.
• Растр привязки - настраивает экстент выхода таким образом, чтобы он соответствовал выравниванию ячеек указанного растрового слоя привязки.
• Размер ячейки - размер ячейки для использования в выходном слое.
• Маска - указывает слой маски, в котором для анализа будут использоваться только ячейки, попадающие в область маски.

Сходные инструменты и функции растра

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

Инструменты анализа Map Viewer и функции растра

Используйте инструмент Распределение по расстоянию или функцию растра Распределение по расстоянию, если требуются выходные данные сервиса изображения распределения по расстоянию.

Накопление расстояния также доступен как функция растра.

Инструменты анализа ArcGIS Pro и функции растра

Инструменты геообработки Накопление расстояния и Распределение по расстоянию доступны в наборе инструментов Spatial Analyst.

Инструменты геообработки Накопление расстояния и Распределение по расстоянию доступны в наборе инструментов Raster Analysis.

Накопление расстояния и Распределение по расстоянию доступны как функции растра.

Ресурсы для разработчиков ArcGIS Enterprise

Если вы работаете в ArcGIS REST API, используйте задачи Distance Accumulation и Distance Allocation.

Если вы работаете в ArcGIS API for Python, используйте Distance Accumulation и Distance Allocation из модуля arcgis.raster.functions.gbl.