ТРЭК
Документация
ТРЭК.РоадХаб

Описание функциональных характеристик

Наименование программного обеспечения: ТРЭК.РоадХаб Версия документа: 1.0 Год: 2026


1. Общие сведения

Наименование программного обеспечения: ТРЭК.РоадХаб.

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

Класс решаемых задач. Преобразование цифровой модели улично-дорожной сети из внутреннего представления платформы в форматы обмена; визуальный контроль корректности исходной модели и результата преобразования; подготовка файлов для загрузки во внешние расчётные и симуляционные инструменты.

Продукт выполняет роль преобразователя данных: на входе — подготовленная модель дорожной сети либо готовый файл HD-карты, на выходе — файл в одном из четырёх поддерживаемых форматов. Построение и редактирование самой дорожной модели выполняется другим продуктом линейки (ТРЭК.Основание) и в состав функций настоящего продукта не входит.

Область применения:

  • лаборатории транспортного моделирования и микросимуляции транспортных потоков;
  • разработка и испытания систем автоматизированного вождения;
  • научные и образовательные организации, готовящие дорожные сцены для исследований и учебных задач;
  • проектные организации — передача модели улично-дорожной сети во внешние расчётные инструменты.

Пользователи (роли). Продукт рассчитан на одну пользовательскую роль — специалист по подготовке дорожных моделей (инженер симуляционной или беспилотной лаборатории, исследователь, специалист проектной организации). Разграничение прав внутри продукта не предусмотрено: доступ пользователя определяется правами на чтение модели в продукте-источнике и правом входа в продукт, которые выдаёт администратор платформы. Развёртывание и сопровождение серверной части выполняет системный администратор.


Персональные данные. Продукт не обрабатывает персональные данные.

2. Функциональные характеристики

Функции сгруппированы по назначению. Нумерация сквозная.

2.1. Приём исходных данных

№ Функция Описание
Ф-1 Загрузка модели дорожной сети из продукта-источника По введённому идентификатору подготовленного слепка модели либо по ссылке на него выполняется чтение модели из ТРЭК.Основания. Принимаются: идентификатор слепка, ссылка на интерфейс редактора с параметром слепка, адрес слепка в сервисе данных. Нераспознанное значение отклоняется с индикацией ошибки в поле ввода
Ф-2 Повторное чтение исходных данных По команде пользователя модель перечитывается из источника без выхода с рабочего экрана; карта источника и результат преобразования пересобираются по обновлённым данным
Ф-3 Открытие готового файла HD-карты Файл считывается с носителя рабочего места. Формат определяется автоматически по корневому элементу содержимого (OpenDRIVE, osm, net, network); указание формата пользователем не требуется. Файл, не соответствующий ни одному из распознаваемых корневых элементов, не открывается

2.2. Преобразование в форматы описания дорожной сети

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

№ Функция Описание
Ф-4 Преобразование в формат OpenDRIVE Строится описание дорожной сети в формате ASAM OpenDRIVE: опорные линии дорог, полосы движения с шириной и типом, связи полос между дорогами, съезды и перекрёстки с перечнем соединений, дорожная разметка, ограничения скорости, ограничения доступа для видов транспорта, светофорные объекты и стоп-линии со сведением их в группы управления. Геометрия опорной линии аппроксимируется последовательностью примитивов: прямая, дуга, переходная кривая (клотоида), параметрический полином третьей степени. Выбор примитива выполняется автоматически по критерию соответствия исходной геометрии
Ф-5 Преобразование в формат Lanelet2 Строится описание сети связных полос: левая и правая границы каждой полосы, тип и знак разметки границ, связи между полосами, пешеходные переходы, полосы парковки, направляющие стрелки. Формируются регуляторные элементы: светофорное регулирование, стоп-линии, приоритет проезда, пешеходный переход, посадочная платформа остановочного пункта
Ф-6 Преобразование в формат SUMO Строится сеть симулятора транспортных потоков: рёбра и полосы с геометрией, перекрёстки с определением типа узла, связи между полосами с указанием направления манёвра и приоритета проезда, разрешённые и запрещённые на полосе классы транспортных средств. Для перекрёстков со светофорным регулированием формируются светофорные программы (см. Ф-7)
Ф-7 Формирование светофорных программ в выгрузке SUMO Светофорная программа перекрёстка строится по фактическим сигнальным группам исходной модели: каждой группе назначается собственная фаза, длина строки состояния соответствует числу фактически построенных связей узла. Длительности фаз — фиксированные значения по умолчанию (при единственной группе — постоянно разрешающий сигнал). Расчёт длительностей, оптимизация цикла и адаптивное управление не выполняются
Ф-8 Преобразование в формат NET329 Строится описание дорожной сети в формате NET329: узлы, рёбра, связи, полосы и площадные контуры проезжей части

2.3. Отображение и контроль модели

№ Функция Описание
Ф-9 Двухпанельное отображение Исходная модель и результат преобразования отображаются на двух картах одновременно, что позволяет визуально сопоставить вход и выход преобразования. Соотношение размеров панелей регулируется
Ф-10 Выбор слоя исходной модели Исходная модель отображается в одном из двух представлений: площадные объекты проезжей части с разметкой либо граф связей полос
Ф-11 Выбор картографической подложки Для каждой из карт независимо выбирается фоновая картографическая основа (схематические, спутниковые, светлые и тёмные варианты, пользовательский источник, пустой фон). При тёмной подложке оформление дорожной сети переключается в контрастную палитру
Ф-12 Инспекция объекта По выбранному на карте объекту (полоса, ребро, перекрёсток, связь, светофорный объект) выводится таблица его свойств в виде пар «имя поля — значение». Функция доступна как для исходной модели, так и для результата преобразования
Ф-13 Просмотр маршрутов перекрёстка Для выбранного перекрёстка выводится общее количество разрешённых траекторий проезда и их перечень, сгруппированный по подходам. Отметка элемента перечня подсвечивает соответствующую траекторию на карте; допускается одновременная отметка нескольких траекторий
Ф-14 Просмотр исходного XML результата Результат преобразования отображается в текстовом виде в режиме только для чтения: подсветка синтаксиса, нумерация строк, сворачивание вложенных элементов. Для файлов большого объёма подсветка автоматически упрощается. Редактирование содержимого не предусмотрено
Ф-15 Связывание карты и текстового представления При выборе объекта на карте результата текстовое представление автоматически позиционируется на описывающем его элементе; поиск ведётся по идентифицирующим атрибутам элемента

2.4. Выгрузка результата

№ Функция Описание
Ф-16 Выгрузка файла целевого формата Результат преобразования сохраняется в файл соответствующего формата на носитель рабочего места. Имя файла назначается автоматически и может быть изменено в диалоге сохранения
Ф-17 Выгрузка параметров проекции для Lanelet2 Дополнительно к файлу модели формируется файл описания системы координат: тип проекции (поперечная Меркатора), вертикальная система отсчёта, координаты начала отсчёта. Начало отсчёта принимается равным центру текущего вида карты
Ф-18 Формирование запускаемого комплекта SUMO Помимо файла сети формируется архив из трёх файлов: сеть, набор поездок и файл конфигурации запуска. Формируется демонстрационный набор поездок для первичного запуска модели; он не является расчётной матрицей корреспонденций. Генератор детерминирован — одна и та же сеть даёт один и тот же набор поездок
Ф-19 Выгрузка геометрии в GeoJSON Геометрия результата преобразования выгружается в файл формата GeoJSON либо копируется в буфер обмена для передачи в геоинформационные инструменты

2.5. Сеансовые и вспомогательные функции

№ Функция Описание
Ф-20 Аутентификация через единую подсистему платформы Вход выполняется в подсистеме аутентификации платформы по протоколу OpenID Connect. Обращение к рабочим экранам без входа перенаправляется на страницу приветствия; после успешного входа пользователь доставляется на запрошенный адрес. Предусмотрено завершение сессии единого входа
Ф-21 Отображение сведений об учётной записи и переходов между продуктами Выводятся имя и адрес электронной почты пользователя, наименование организации и обозначение тарифного плана, перечень продуктов платформы с указанием доступных и недоступных пользователю, переход в личный кабинет
Ф-22 Сохранение состояния рабочего экрана в адресе страницы Идентификатор исходной модели, целевой формат, выбранная подложка, центр и масштаб карты сохраняются в параметрах адреса страницы. Адрес может быть сохранён или передан другому пользователю и восстанавливает состояние экрана при открытии (при наличии у него прав на чтение модели)
Ф-23 Переходы во внешние инструменты Из карты результата открываются сторонние онлайн-просмотрщики форматов, из карты источника — картографические сервисы и редакторы, с передачей текущей позиции карты. Файл в сторонний инструмент автоматически не передаётся
Ф-24 Локализация интерфейса Интерфейс поставляется на русском и английском языках. Язык задаётся при развёртывании; переключение языка пользователем не предусмотрено

3. Состав и структура программного обеспечения

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

3.1. Серверная часть

Компонент Назначение
Сервер приложения продукта Раздача клиентского приложения и параметров конфигурации инсталляции; переадресация с корня адреса на адрес приложения
Веб-шлюз платформы Единая точка входа, терминирование TLS, маршрутизация обращений по имени поддомена продукта
Подсистема аутентификации платформы Вход пользователя, выдача и проверка маркеров доступа по протоколу OpenID Connect
Сервис моделей дорожной сети (ТРЭК.Основание) Поставщик исходных данных: выдаёт подготовленный слепок модели по программному интерфейсу. Собственным компонентом настоящего продукта не является

Собственной базы данных у продукта нет: пользовательские данные на сервере продукта не хранятся.

3.2. Клиентская часть

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

3.3. Схема взаимодействия

        Рабочее место пользователя
 +--------------------------------------------+
 |  Браузер                                    |
 |   +--------------------------------------+  |
 |   | Клиентское приложение ТРЭК.РоадХаб   |  |
 |   |  - интерфейс, две карты, текст XML   |  |
 |   |  - преобразование форматов           |  |
 |   |  - формирование файлов и архивов     |  |
 |   +--------------------------------------+  |
 +---------|---------------|--------------|----+
           | HTTPS         | HTTPS        | сохранение
           v               v              v   файлов на диск
 +------------------+  +------------------------+
 |   Веб-шлюз платформы (единая точка входа)    |
 +---|--------------|---------------|-----------+
     v              v               v
 +----------+  +--------------+  +---------------------+
 | Сервер   |  | Подсистема   |  | Сервис моделей      |
 | приложе- |  | аутентифика- |  | дорожной сети       |
 | ния      |  | ции (OIDC)   |  | (ТРЭК.Основание)    |
 +----------+  +--------------+  +---------------------+

4. Требования к аппаратному обеспечению

4.1. Сервер

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

Параметр Значение
Архитектура x86-64
Процессор от 4 vCPU (демонстрационная инсталляция, малый город); 8 и более vCPU для города-миллионника
Оперативная память от 16 ГБ; 32 ГБ рекомендуется для города-миллионника
Дисковая подсистема SSD от 50 ГБ; 200 ГБ и более для инсталляции с историей данных города-миллионника. Данные рекомендуется размещать на отдельном томе
Сеть Исходящий доступ к реестру контейнеров поставщика; запись в DNS на поддомены инсталляции

Собственная нагрузка настоящего продукта на серверные ресурсы невелика: сервер раздаёт клиентское приложение и не выполняет вычислений.

4.2. Рабочее место пользователя

Параметр Значение
Разрешение экрана не менее 1920×1080 (интерфейс картоцентричный, на меньшем разрешении панели перекрывают карту)
Оперативная память Определяет предельный размер обрабатываемой сети: преобразование и формирование файлов выполняются в браузере, модель целиком размещается в его памяти
Установка программного обеспечения не требуется

5. Требования к программному обеспечению

5.1. Сервер

Компонент Требование
Операционная система Astra Linux Special Edition 1.7 и 1.8 (x86-64), Альт p11 (x86-64) — целевые платформы поставки. Работоспособность обеспечивается также на иных 64-разрядных Linux-платформах (Debian 11/12, Ubuntu 22.04 LTS)
Среда контейнеризации Docker Engine версии 24 и выше, плагин Docker Compose версии 2

Контейнеризация применяется как способ упаковки и развёртывания и не является архитектурным требованием: каждый сервис инсталляции — самостоятельное серверное приложение и может запускаться штатными средствами операционной системы.

5.2. Рабочее место пользователя

Компонент Требование
Браузер Chrome, Яндекс.Браузер, Firefox последних версий
Настройки браузера Разрешены исполнение JavaScript, сохранение файлов, открытие новых вкладок
Операционная система Требований не предъявляется
Дополнительное программное обеспечение Для работы с выгруженными файлами необходим внешний инструмент (симулятор, программный стек автоматизированного вождения, редактор формата); в состав поставки он не входит

6. Входные и выходные данные

6.1. Входные данные

Вид Источник Форма представления
Модель улично-дорожной сети Подготовленный слепок модели в ТРЭК.Основании Идентификатор слепка либо ссылка на него; данные модели читаются по программному интерфейсу продукта-источника
Готовый файл HD-карты Носитель рабочего места Файлы с расширениями .xodr, .osm, .n329, .n329fa, .net.xml, .xml; формат определяется по корневому элементу содержимого

6.2. Выходные данные

Вид Формат Примечание
Описание дорожной сети OpenDRIVE, файл .xodr Формат ASAM OpenDRIVE
Описание дорожной сети Lanelet2, файл .osm Дополнительно — файл параметров проекции в формате YAML
Описание дорожной сети SUMO, файл .net.xml Дополнительно — архив «сеть, поездки, конфигурация запуска»
Описание дорожной сети NET329, файл .n329fa —
Геометрия результата GeoJSON, файл .geojson Также доступно копирование в буфер обмена

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

OpenDRIVE, Lanelet2, SUMO, NET329, GeoJSON — открытые форматы и стандарты, разработкой поставщика не являющиеся. Продукт формирует файлы указанных форматов; их загрузка во внешние инструменты выполняется средствами этих инструментов.


7. Интеграционные возможности

Направление Описание
Получение моделей дорожной сети Чтение подготовленного слепка модели из ТРЭК.Основания по программному интерфейсу поверх HTTPS. Обмен односторонний: обратной записи в продукт-источник не выполняется
Единая аутентификация платформы Вход по протоколу OpenID Connect через подсистему аутентификации платформы: одна учётная запись даёт доступ ко всем продуктам, на которые у пользователя есть права
Переход между продуктами платформы Из интерфейса продукта доступен переход в другие продукты линейки и в личный кабинет пользователя
Передача состояния ссылкой Состояние рабочего экрана кодируется в адресе страницы, что позволяет передавать его между пользователями и внешними системами как обычную ссылку
Передача данных во внешние инструменты Выполняется файлами поддерживаемых форматов (раздел 6.2). Программного интерфейса приёма данных внешними системами напрямую от продукта не предусмотрено
Переходы во внешние онлайн-сервисы Открытие сторонних просмотрщиков форматов и картографических сервисов на текущей позиции карты, в новой вкладке браузера. Передаётся только позиция; данные модели в сторонние сервисы не передаются

8. Ограничения применения

Раздел приведён для однозначного понимания границ функциональности.

Функции, которые продукт не выполняет:

  1. Продукт не строит и не редактирует модель улично-дорожной сети. Исходная модель готовится в ТРЭК.Основании; недостающие в исходной модели данные при преобразовании не достраиваются и не восстанавливаются.
  2. Поддерживаются ровно четыре формата выгрузки — OpenDRIVE, Lanelet2, SUMO, NET329 (плюс выгрузка геометрии в GeoJSON). Выгрузка в формат Shapefile и в «сырой» формат OSM отсутствует. Иные форматы описания дорожной сети не поддерживаются.
  3. Взаимное преобразование внешних форматов не выполняется. Открытый с диска готовый файл доступен для просмотра и повторного сохранения в собственном формате; преобразование, например, OpenDRIVE в SUMO или загрузка внешнего файла в модель платформы не предусмотрены.
  4. Генерация тестовых сценариев движения, трёхмерных сцен и синтетических данных лазерного сканирования (LiDAR) отсутствует. Продукт формирует только описание дорожной сети.
  5. Светофорные программы в выгрузке SUMO не рассчитываются. Они строятся по фактическим сигнальным группам исходной модели с фиксированными длительностями по умолчанию. Это не расчётный цикл регулирования и не адаптивное управление; расчёт светофорного регулирования выполняется отдельным продуктом линейки.
  6. Набор поездок в комплекте SUMO — не расчётная матрица корреспонденций, а демонстрационный набор, предназначенный для первичного запуска модели.
  7. Аналитические расчёты по дорожной сети относятся к отдельному продукту линейки и в функциональность настоящего продукта не входят.
  8. Редактирование текстового (XML) представления результата не предусмотрено: оно доступно только для чтения.
  9. Собственных средств хранения результатов, ведения проектов и истории версий нет: результат преобразования существует в памяти браузера до закрытия вкладки, сохранением файлов распоряжается пользователь.
  10. Программа не является средством защиты информации и не заменяет сертифицированные средства защиты; разграничение доступа опирается на внешний провайдер аутентификации.

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

Ограничение Значение
Единица обработки Один слепок модели или один файл целиком; выбор фрагмента территории и объединение нескольких моделей не предусмотрены
Готовность исходных данных Слепок модели должен быть полностью подготовлен в продукте-источнике и доступен пользователю на чтение; параметры оптимизации преобразования задаются в продукте-источнике и в настоящем продукте не изменяются
Объём территории Ограничен объёмом оперативной памяти рабочего места: модель и результат преобразования целиком размещаются в памяти браузера. Числовой предел зависит от конфигурации рабочего места и не нормируется
Просмотр текстового представления NET329 Для очень больших сетей текстовое представление не отображается; выгрузка файла при этом остаётся доступной
Начало отсчёта координат для Lanelet2 Принимается равным центру текущего вида карты, то есть задаётся пользователем через положение карты, а не отдельным параметром
Разграничение прав внутри продукта Отсутствует; доступ определяется правами учётной записи на уровне платформы и продукта-источника
Работа без сети Невозможна: продукт является веб-приложением. Ранее выгруженные файлы от доступности сервера не зависят

9. Сведения о поставке и поддержке

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

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

Эксплуатационная документация:

Документ Назначение
Руководство пользователя ТРЭК.РоадХаб Работа с продуктом: экраны, операции, форматы, действия при нештатных ситуациях
Руководство системного администратора. Платформа ТРЭК и поставляемая часть руководства системного администратора Требования к средствам, развёртывание, настройка, эксплуатация инсталляции

Техническая поддержка. Обращения принимаются по адресу электронной почты info@trafficeq.ru с 09:00 до 18:00 по московскому времени, в рабочие дни (понедельник — пятница). Обращения регистрируются и классифицируются по критичности; срок реакции — от 4 рабочих часов для критичных обращений до 3 рабочих дней для консультаций.