ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Справка
  • Sign Out
ArcGIS Desktop

ArcGIS Online

Картографическая платформа вашей организации

ArcGIS Desktop

Полноценная профессиональная ГИС

ArcGIS Enterprise

ГИС предприятия

ArcGIS Developers

Инструменты для встраивания приложений с местоположениями

ArcGIS Solutions

Бесплатные шаблоны карт и приложений для отрасли

ArcGIS Marketplace

Получение приложения и данных для вашей организации.

  • Документация
  • Поддержка
Esri
  • Войти
user
  • Мой профиль
  • Выход

ArcMap

  • На главную
  • Начало работы
  • Карта
  • Анализ
  • Управление данными
  • Инструменты
  • Дополнительные модули

Построить матрицу Источник-Назначение

  • Сводка
  • Использование
  • Синтаксис
  • Пример кода
  • Параметры среды
  • Информация о лицензиях

Сводка

Создает матрицу Источник-назначение (OD) из множества исходных в множество конечных точек. Матрица Источник-Назначение – это таблица, содержащая время и расстояние в пути от каждого исходного пункта к каждому пункту назначения. Также матрица присваивает ранги пунктам назначения, с которыми в порядке возрастания соединяется каждый начальный пункт на основании минимального времени или расстояния, необходимых для перемещения от данного начального пункта к каждому пункту назначения. Лучший путь по уличной сети определяется для каждой пары источник-назначение, а времена в пути и расстояния сохраняются в таблице атрибутов выходных линий. Несмотря на то, что с целью повышения производительности линии прямые, они всегда хранят время в пути и расстояния вдоль уличной сети, а не прямолинейные расстояния.

Более подробно о выходных данных матрицы Источник-Назначение

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

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

  • В диалоговом окне инструмента есть разнообразные дополнительные параметры, сгруппированные для удобства работы в следующие шесть категорий:

    • Расширенный анализ
    • Барьеры
    • Пользовательский режим передвижения
    • Набор сетевых данных
    • Сетевые положения
    • Выходные данные
    • Возможности сервиса

Синтаксис

arcpy.na.GenerateOriginDestinationCostMatrix(Origins, Destinations, Network_Dataset, Output_Geodatabase, Output_Origin_Destination_Lines_Name, Output_Origins_Name, Output_Destinations_Name, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Impedance_Attribute}, {Impedance_Attribute_Units}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {UTurn_Policy}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Origin_Destination_Line_Shape}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, Maximum_Origins, Maximum_Destinations, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Overrides})
ПараметрОбъяснениеТип данных
Origins

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

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

Name - имя источника. Имя может быть уникальным идентификатором исходной точки. Имя включается в выходные линии (как поле OriginName) и в выходные источники (как поле Name) и может быть использовано для присоединения дополнительной информации из выходных данных инструмента к атрибутам ваших источников.

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

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

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

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

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

  • 0 (С любой стороны) – транспортное средство может отправляться от источника в любом направлении, т.е. в источнике разрешен разворот. Данный параметр можно выбрать, если для вашего транспортного средства возможно и желательно развернуться в источнике. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в источнике места для стоянки, где транспортное средство может выполнить разворот.
  • 1 (Справа по направлению движения) – когда транспортное средство отправляется от источника, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась справа.
  • 2 (Слева по направлению движения) – когда транспортное средство отправляется от источника, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны отправляться от автобусной остановки так, чтобы она находилась слева.
  • 3 (Разворот запрещен) – для данного инструмента значение Разворот запрещен (3) идентично значению С любой стороны.

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Для начала рассмотрим случай, когда остановка располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон подъехать к остановке, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо подходить к остановке так, чтобы отсутствовала полоса движения между транспортным средством и остановкой, то в США необходимо выбрать правую сторону транспорта (1), а в Великобритании левую сторону (2).

Feature Set
Destinations

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

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

Name – имя пункта назначения. Имя может быть уникальным идентификатором пункта назначения. Имя включается в выходные линии (как поле DestinationName) и в выходные пункты назначения (как поле Name) и может быть использовано для присоединения дополнительной информации из выходных данных инструмента к атрибутам пунктов назначения.

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

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

  • 0 (С любой стороны) – транспортное средство может прибыть в пункт назначения в любом направлении, т.е. в пункте назначения разрешен разворот. Данный параметр можно выбрать, если для транспортного средства возможно и желательно развернуться в пункте назначения. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в пункте назначения места для стоянки, где транспортное средство может выполнить разворот.
  • 1 (Справа по направлению движения) – когда транспортное средство прибывает в пункт назначения, пункт назначения должен находиться справа от транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа.
  • 2 (Слева по направлению движения) – когда транспортное средство прибывает в пункт назначения, бордюр должен находиться слева от транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева.
  • 3 (Разворот запрещен) – для данного инструмента значение Разворот запрещен (3) идентично значению С любой стороны.

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Для начала рассмотрим случай, когда остановка располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон подъехать к остановке, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо подходить к остановке так, чтобы отсутствовала полоса движения между транспортным средством и остановкой, то в США необходимо выбрать правую сторону транспорта (1), а в Великобритании левую сторону (2).

Feature Set
Network_Dataset

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

Network Dataset Layer
Output_Geodatabase

Выходная рабочая область. Рабочая область должна существовать.

Workspace
Output_Origin_Destination_Lines_Name

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

Выходные данные инструмента Построить матрицу Источник-Назначение описывают схему выходного класса пространственных объектов.

String
Output_Origins_Name

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

Выходные данные инструмента Построить матрицу Источник-Назначение описывают схему выходного класса пространственных объектов.

String
Output_Destinations_Name

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

Выходные данные инструмента Построить матрицу Источник-Назначение описывают схему выходного класса пространственных объектов.

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

Выберите режим передвижения для анализа. CUSTOM можно выбрать всегда. Чтобы появились другие режимы, они должны быть представлены в наборе сетевых данных в параметре Network_Dataset. (Функция arcpy.na.GetTravelModes содержит словарь объектов режима движения для класса сетевых объектов, а свойство name возвращает имя объекта режима передвижения.)

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

  • UTurn_Policy

  • Time_Attribute

  • Time_Attribute_Units

  • Distance_Attribute

  • Distance_Attribute_Units

  • Use_Hierarchy_in_Analysis

  • Restrictions

  • Attribute_Parameter_Values

  • Route_Line_Simplification_Tolerance

  • CUSTOM —Определите режим, соответствующий вашим нуждам. При выборе режима CUSTOM инструмент не перезаписывает параметры режима, перечисленные выше. Это значение используется по умолчанию.
String
Time_Units
(Дополнительный)

Укажите единицы, которые должны использоваться для измерения и указания общего времени в пути для каждой пары Источник-Назначение. Можно выбрать следующие варианты:

  • Секунды
  • Минуты
  • Часы
  • Дни

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

Укажите единицы, которые должны использоваться для измерения и указания общего расстояния в пути для каждой пары Источник-Назначение.

Можно выбрать следующие варианты:

  • Мили
  • Километры
  • Метры
  • Футы
  • Ярды
  • Морские мили

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

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

Long
Cutoff
(Дополнительный)

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

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

Double
Time_of_Day
(Дополнительный)

Указывает время и дату начала маршрутов.

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

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

Инструмент игнорирует этот параметр, если в Единицах измерения не выбрано время.

Date
Time_Zone_for_Time_of_Day
(Дополнительный)

Указывает часовой пояс параметра Время суток.

  • GEO_LOCAL —Значение параметра Время дня относится к часовому поясу, в котором находится первая остановка маршрута. Если вы создаете несколько маршрутов в различных часовых поясах, время начала будет отсчитываться от Всемирного координированного времени (UTC). Например, если Время дня (Time of Day) имеет значение 2-е Января, 10:00 a.m., это означает, что маршрут начнется в 10:00 утра Восточное время (3.00 p.m. по UTC) для часового пояса Восточное время, и в 10:00 утра Центральное поясное время (4:00 p.m. по UTC) для часового пояса Центральное время. Время начала по UTC будет отличаться на один час.Время и дата прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать часовому поясу первой остановки каждого маршрута.
  • UTC —Значения параметра Время суток указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если вы хотите создать маршрут для определенного времени, например текущего, но точно не знаете, в каком часовом поясе будет находиться первая остановка.Если вы создаете несколько маршрутов, охватывающих различные часовые пояса, время начала по UTC будет синхронизировано. Например, если Время дня имеет значение 2-е Января, 10:00 a.m., это означает, что маршрут начнется в 5:00 утра по Стандартному Восточному времени (UTC-5:00) для часового пояса Восточное время, и в 4:00 утра по Центральному стандартному времени (UTC-6:00) для маршрутов в часовом поясе Центральное время. Оба маршрута начнутся в 10:00 утра по UTC.Времена и даты прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать времени UTC.
String
Point_Barriers
(Дополнительный)

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

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

BarrierType:

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

  • Ограничение (0) – запрещает перемещение через барьер. Это значение используется по умолчанию.
  • Дополнительная стоимость (2) – Прохождение через барьер увеличивает сетевую стоимость на значение, указанное в полях Additional_Time и Additional_Distance.

Используйте значение 0 для Ограничения и 2 для Дополнительной стоимости.

Additional_Time:

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

Additional_Distance:

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

Feature Set
Line_Barriers
(Дополнительный)

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

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

Feature Set
Polygon_Barriers
(Дополнительный)

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

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

BarrierType:

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

  • Ограничение (0) – запрещает прохождение через любую часть барьера. Это значение используется по умолчанию.
  • Масштабированная стоимость (1) – Масштабирует импеданс исходных ребер, умножая его на значение свойства ScaledCostFactor. Если ребра частично перекрыты барьером, будет умножаться пропорциональная доля импеданса.

Используйте значение 0 для Ограничения и 1 для Масштабированной стоимости.

ScaledTimeFactor:

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

ScaledDistanceFactor:

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

Feature Set
Impedance_Attribute
(Дополнительный)

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

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

Единицы атрибута сетевого импеданса, определенные параметром Атрибут импеданса.

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

Значение этого параметра перезаписывается, если для Режима передвижения установлено не Пользовательское значение.

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

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

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский.

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

Единицы атрибута времени. Вы можете явно задать единицы атрибута времени, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы.

Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM.

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

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

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский.

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

Единицы атрибута расстояния. Вы можете явно задать единицы атрибута расстояния, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы.

Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM.

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

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

  • ALLOW_UTURNS —Развороты разрешены в соединениях с любым количеством смежных ребер или улиц. Это значение используется по умолчанию.
  • NO_UTURNS —Развороты запрещены во всех соединениях, вне зависимости от их валентности.
  • ALLOW_DEAD_ENDS_ONLY —Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Зачастую, моделирующие улицы сети имеют избыточные соединения в середине сегментов дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский..

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

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

  • USE_HIERARCHY — Использовать иерархию при нахождении маршрутов. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка (такие как скоростные автострады) улицам более низкого порядка (таким как местные дороги) и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным пунктам обслуживания, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае междугородних поездок, поскольку инструмент выбирает лучший маршрут из сравнительно небольшого поднабора улиц.
  • NO_HIERARCHY — Не использовать иерархию при нахождении маршрутов. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города.

Параметр не используется, если в наборе сетевых данных, используемом для выполнения анализа, не задан атрибут иерархии. В таких случаях используйте в качестве значения параметра "#".

Можно использовать параметр Force_Hierarchy_Beyond_Distance , чтобы механизм расчета принудительно применял иерархию, даже если параметр Use_Hierarchy_in_Analysis задан как False.

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

Boolean
Restrictions
[restriction,...]
(Дополнительный)

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский.

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

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский..

Набор записей значений параметра атрибута имеет связанные атрибуты. Ниже приведены поля в таблице атрибутов с описанием.

ObjectID:

Управляемое системой поле ID.

AttributeName:

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

ParameterName:

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

ParameterValue:

Значение, которое вы хотите задать для параметра атрибута. Если значение не указано, для параметра атрибута устанавливается значение NULL.

Record Set
Accumulate_Attributes
[attribute,...]
(Дополнительный)

Список атрибутов стоимости, который будет суммироваться во время анализа. Эти атрибуты накопления служат исключительно для справки; механизм расчета использует только атрибут стоимости, определенный параметром Атрибут времени (Time_Attribute в Python) или Атрибут расстояния (Distance_Attribute в Python), для вычисления кратчайшего пути.

Для каждого кумулятивного атрибута стоимости к выходным маршрутам механизма расчета добавляется свойство Total_[attribute].

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

Максимальный допуск замыкания представляет собой самое дальнее расстояние, которое Network Analyst находится при размещении или повторном размещении точки в сети. Выполняется поиск подходящих ребер или соединений, далее выполняется замыкание точки на ближайший объект. Если подходящее положение не было найдено в пределах максимального допуска замыкания, то объект обозначается, как неразмещенный.

Linear unit
Feature_Locator_WHERE_Clause
(Дополнительный)

Выражение SQL, используемое для создания поднабора исходных пространственных объектов, определяющего элементы сети, на которых могут быть расположены остановки. Синтаксис данного параметра состоит их двух частей: первая – имя источника класса пространственных объектов (после которого имеется пробел), вторая – выражение SQL. Чтобы записать выражение SQL для двух или более классов пространственных объектов, их необходимо разделить точкой с запятой.

Чтобы пункты обслуживания не располагались на шоссе с ограниченным доступом, например, напишите выражение SQL, аналогичное следующему, с целью исключить такие источники объектов: "Streets" "FUNC_CLASS not in('1', '2')".

Обратите внимание, что барьеры игнорируют Условие Where локатора объектов во время загрузки.

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

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

  • STRAIGHT_LINES — Прямые линии соединяют источники с пунктами назначения.
  • NO_LINES — Не возвращает никакой геометрии для линий, соединяющих источники и пункты назначений. Это удобно при большом количестве исходных и конечных пунктов, когда необходимо получить только табличные данные (без линий маршрутов).
String
Maximum_Features_Affected_by_Point_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют точечные барьеры

NULL соответствует отсутствию ограничений.

Long
Maximum_Features_Affected_by_Line_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют линейные барьеры

NULL соответствует отсутствию ограничений.

Long
Maximum_Features_Affected_by_Polygon_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют полигональные барьеры.

NULL соответствует отсутствию ограничений.

Long
Maximum_Origins

Ограничивает число источников, которые можно добавить к анализу матрицы Источник-Назначение.

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Destinations

Ограничивает число пунктов назначения, которые можно добавить к анализу матрицы Источник-Назначение.

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

NULL соответствует отсутствию ограничений.

Long
Force_Hierarchy_Beyond_Distance
(Дополнительный)

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

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

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

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

Double
Save_Output_Network_Analysis_Layer
(Дополнительный)
  • NO_SAVE_OUTPUT_LAYER —Слой сетевого анализа не включается в выходные данные.
  • SAVE_OUTPUT_LAYER —В выходные данные включается слой сетевого анализа с результатами.

В любом случае будут возвращены классы объектов, содержащие результаты. Однако администратор сервера может также выбрать вывод и слоя сетевого анализа, чтобы настройку и результаты работы инструмента можно было отладить с использованием средств управления Network Analyst в среде ArcGIS Desktop. Это намного упрощает процесс отладки.

В ArcGIS Desktop выходное местоположение слоя сетевого анализа по умолчанию – это временная папка. Вы можете определить местоположение временной папки по значению arcpy.env.scratchFolder среды геообработки. Выходной слой сетевого анализа хранится в виде LYR-файла, имя которого начинается с _ags_gpna, а затем следует буквенно-числовое значение GUID.

Boolean
Overrides
(Дополнительный)

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

Для этого параметра должно быть задано значение в формате JavaScript Object Notation (JSON). К примеру, корректным значением является следующее: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми.

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

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

string

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

ИмяОбъяснениеТип данных
Solve_Succeeded

Определяет, смог ли сервис успешно создать матрицу стоимости источник-назначение.

Логические
Output_Origin_Destination_Lines

Готовые маршруты из источников в пункты назначения.

Набор объектов
Output_Origins

Источники, участвующие в анализе.

Набор объектов
Output_Destinations

Пункты назначения, участвующие в анализе.

Набор объектов
Output_Network_Analysis_Layer

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

Файл

Пример кода

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

Выполните инструмент с использованием обязательных параметров.

origins = arcpy.FeatureSet()
origins.load("Warehouses")

destinations = arcpy.FeatureSet()
destinations.load("Stores")

arcpy.na.GenerateOriginDestinationCostMAtrix(origins, destinations, "ParisMultimodal_ND")
GenerateOriginDestinationCostMatrix, пример 2 (автономный скрипт)

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

# Name: GenerateOriginDestinationCostMatrix_Workflow.py
# Description: Find and measure the least-cost paths along the network from multiple
#              origins to multiple destinations.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension('Network')

    #Set environment settings
    env.workspace = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Paris.gdb'
    env.overwriteOutput = True

    #Set local variables
    inOrigins = 'Analysis/Warehouses'
    inDestinations = 'Analysis/Stores'
    inNetworkDataset = 'Transportation/ParisMultimodal_ND'
    outGeodatabase = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Output.gdb'
    
    # Run GenerateODCostMatrix
    arcpy.na.GenerateOriginDestinationCostMatrix(inOrigins, inDestinations, inNetworkDataset, outGeodatabase,
                                                 Cutoff=10, Origin_Destination_Line_Shape='STRAIGHT_LINES')
    print 'Script completed successfully'

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print 'An error occured on line %i' % tb.tb_lineno
    print str(e)

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

  • Текущая рабочая область
  • Выходная система координат

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

  • Basic: Требуется Network Analyst
  • Standard: Требуется Network Analyst
  • Advanced: Требуется Network Analyst

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

  • Создать слой матрицы Источник-Назначение
  • Анализ матрицы Источник-Назначение
  • Выходные данные инструмента Построить матрицу Источник-Назначение

ArcGIS Desktop

  • На главную
  • Документация
  • Поддержка

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

Об Esri

  • О нас
  • Карьера
  • Блог Esri
  • Конференция пользователей
  • Саммит разработчиков
Esri
Расскажите нам, что вы думаете.
Copyright © 2021 Esri. | Конфиденциальность | Правовая информация