Наименование программного обеспечения: ТРЭК.РоадХаб Версия документа: 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. Ограничения применения
Раздел приведён для однозначного понимания границ функциональности.
Функции, которые продукт не выполняет:
- Продукт не строит и не редактирует модель улично-дорожной сети. Исходная модель готовится в ТРЭК.Основании; недостающие в исходной модели данные при преобразовании не достраиваются и не восстанавливаются.
- Поддерживаются ровно четыре формата выгрузки — OpenDRIVE, Lanelet2, SUMO, NET329 (плюс выгрузка геометрии в GeoJSON). Выгрузка в формат Shapefile и в «сырой» формат OSM отсутствует. Иные форматы описания дорожной сети не поддерживаются.
- Взаимное преобразование внешних форматов не выполняется. Открытый с диска готовый файл доступен для просмотра и повторного сохранения в собственном формате; преобразование, например, OpenDRIVE в SUMO или загрузка внешнего файла в модель платформы не предусмотрены.
- Генерация тестовых сценариев движения, трёхмерных сцен и синтетических данных лазерного сканирования (LiDAR) отсутствует. Продукт формирует только описание дорожной сети.
- Светофорные программы в выгрузке SUMO не рассчитываются. Они строятся по фактическим сигнальным группам исходной модели с фиксированными длительностями по умолчанию. Это не расчётный цикл регулирования и не адаптивное управление; расчёт светофорного регулирования выполняется отдельным продуктом линейки.
- Набор поездок в комплекте SUMO — не расчётная матрица корреспонденций, а демонстрационный набор, предназначенный для первичного запуска модели.
- Аналитические расчёты по дорожной сети относятся к отдельному продукту линейки и в функциональность настоящего продукта не входят.
- Редактирование текстового (XML) представления результата не предусмотрено: оно доступно только для чтения.
- Собственных средств хранения результатов, ведения проектов и истории версий нет: результат преобразования существует в памяти браузера до закрытия вкладки, сохранением файлов распоряжается пользователь.
- Программа не является средством защиты информации и не заменяет сертифицированные средства защиты; разграничение доступа опирается на внешний провайдер аутентификации.
Пределы и требования к исходным данным:
| Ограничение | Значение |
|---|---|
| Единица обработки | Один слепок модели или один файл целиком; выбор фрагмента территории и объединение нескольких моделей не предусмотрены |
| Готовность исходных данных | Слепок модели должен быть полностью подготовлен в продукте-источнике и доступен пользователю на чтение; параметры оптимизации преобразования задаются в продукте-источнике и в настоящем продукте не изменяются |
| Объём территории | Ограничен объёмом оперативной памяти рабочего места: модель и результат преобразования целиком размещаются в памяти браузера. Числовой предел зависит от конфигурации рабочего места и не нормируется |
| Просмотр текстового представления NET329 | Для очень больших сетей текстовое представление не отображается; выгрузка файла при этом остаётся доступной |
| Начало отсчёта координат для Lanelet2 | Принимается равным центру текущего вида карты, то есть задаётся пользователем через положение карты, а не отдельным параметром |
| Разграничение прав внутри продукта | Отсутствует; доступ определяется правами учётной записи на уровне платформы и продукта-источника |
| Работа без сети | Невозможна: продукт является веб-приложением. Ранее выгруженные файлы от доступности сервера не зависят |
9. Сведения о поставке и поддержке
Форма поставки. Программное обеспечение поставляется в виде пресобранных контейнерных образов, размещаемых в реестре контейнеров поставщика. Доступ к реестру предоставляется по выданному поставщиком токену на чтение. Продукт поставляется и разворачивается совместно с остальными продуктами платформы и общими сервисами данных как единая инсталляция. Сборка программного обеспечения из исходного кода на стороне заказчика не предусмотрена.
Установка и настройка. Развёртывание, настройка, проверка работоспособности, резервное копирование и обновление выполняются системным администратором в порядке, изложенном в поставляемой части руководства системного администратора. На рабочие места пользователей программное обеспечение не устанавливается: работа ведётся в браузере.
Эксплуатационная документация:
| Документ | Назначение |
|---|---|
| Руководство пользователя ТРЭК.РоадХаб | Работа с продуктом: экраны, операции, форматы, действия при нештатных ситуациях |
| Руководство системного администратора. Платформа ТРЭК и поставляемая часть руководства системного администратора | Требования к средствам, развёртывание, настройка, эксплуатация инсталляции |
Техническая поддержка. Обращения принимаются по адресу электронной почты
info@trafficeq.ru с 09:00 до 18:00 по московскому времени, в рабочие дни
(понедельник — пятница). Обращения регистрируются и классифицируются по
критичности; срок реакции — от 4 рабочих часов для критичных обращений до
3 рабочих дней для консультаций.