Руководство пользователя

Программный продукт: ТРЭК.РоадХаб Версия документа: 1.1 Год: 2026

---

Для кого этот документ

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

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

Публичное имя продукта в документе — ТРЭК.РоадХаб. В интерфейсе продукт подписан как «ТРЭК.Роадхаб».

Карта документа

---

1. Введение

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

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

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

Продукт работает как «переходник»: на входе — готовая дорожная модель, подготовленная в ТРЭК.Основание, либо готовый файл HD-карты; на выходе — файл в одном из четырёх стандартных форматов, который читают внешние симуляторы и AV-стеки.

1.2. Краткое описание возможностей

• Загрузка исходной дорожной модели из ТРЭК.Основание по идентификатору слепка или ссылке.
• Загрузка готового файла HD-карты с локального диска с автоматическим определением формата по содержимому.
• Конвертация модели в форматы OpenDRIVE (XODR), Lanelet2, SUMO, NET329.
• Просмотр исходной модели и результата конвертации на двух синхронно настраиваемых картах с выбором подложки.
• Инспекция объектов: таблица свойств выбранного объекта, дерево маршрутов перекрёстка.
• Просмотр исходного XML результата конвертации во встроенном редакторе с подсветкой синтаксиса и переходом к элементу по клику на карте.
• Выгрузка результата в файл выбранного формата; для Lanelet2 — дополнительно файл параметров проекции, для SUMO — запускаемый комплект «сеть + трафик + конфигурация».
• Выгрузка геометрии результата в GeoJSON или копирование её в буфер обмена.
• Переход во внешние онлайн-просмотрщики форматов и картографические сервисы с текущей позицией карты.

Границы продукта. РоадХаб — конвертер и просмотрщик. Он не строит и не редактирует дорожную модель, не генерирует тестовые сценарии движения и 3D-сцены, не создаёт синтетические LiDAR-карты. Выгрузка в форматы Shapefile и «сырой» OSM в продукте отсутствует. Аналитические функции по дорожной сети относятся к отдельному продукту линейки и в настоящем руководстве не рассматриваются (см. п. 4.3.3).

1.3. Уровень подготовки пользователя

Для работы с продуктом пользователю необходимо:

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

1.4. Перечень эксплуатационной документации

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

1. с настоящим руководством пользователя;
2. с документом «Руководство системного администратора. Платформа ТРЭК» и поставляемой частью руководства системного администратора — в части адреса стенда, порядка выдачи доступа и регламента резервного копирования.

Дополнительно полезно руководство пользователя продукта ТРЭК.Основание — там описано, как готовится исходная модель и где взять идентификатор слепка.

1.5. Термины и сокращения

---

2. Назначение и условия применения

2.1. Виды деятельности и автоматизируемые функции

Продукт предназначен для автоматизации следующих видов деятельности:

2.2. Условия применения

Серверное окружение. Серверная часть разворачивается администратором на отечественных операционных системах из единого реестра российского ПО — Astra Linux Special Edition 1.7 и 1.8 либо Альт p11 (архитектура x86-64). Продукт работает в веб-браузере, особых требований к операционной системе рабочего места не предъявляется.

Рабочее место пользователя. Современный браузер (Chrome, Яндекс.Браузер, Firefox) последних версий; минимальное разрешение экрана 1920×1080 — интерфейс картоцентричный, на меньшем разрешении панели перекрывают карту.

Дополнительно для рабочего места:

• В браузере должен быть разрешён JavaScript, сохранение файлов и открытие новых вкладок (переходы во внешние просмотрщики выполняются в новой вкладке).
• Устанавливать что-либо на рабочее место не требуется. Конвертация и подготовка файлов выполняются в браузере, поэтому объём доступной оперативной памяти влияет на предельный размер обрабатываемой сети.
• Для работы с выгруженными файлами нужен внешний инструмент (симулятор, AV-стек, редактор формата) — в состав продукта он не входит.

Входная информация. Продукт принимает данные ровно из двух источников:

Выходная информация. Файлы форматов дорожной сети, файл параметров проекции, архив запускаемого комплекта SUMO, файл GeoJSON — сохраняются на диск рабочего места пользователя (см. Приложение А).

Требования к подготовке специалистов. См. п. 1.3. Отдельного обучения не требуется; рекомендуемый порядок освоения приведён в разделе 6.

---

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

3. Подготовка к работе

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

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

1. адрес продукта — ссылку вида https://<адрес-стенда>/app/;
2. учётную запись в единой системе аутентификации платформы и доступ к продукту ТРЭК.РоадХаб;
3. при необходимости — адрес и идентификатор демонстрационного слепка для проверки работоспособности (см. п. 3.3 и раздел 6).

3.2. Порядок загрузки и входа в систему

1. Открыть адрес продукта в браузере. Неавторизованному пользователю показывается страница приветствия с описанием продукта и кнопкой «Войти».
2. Нажать «Войти». Откроется страница единого входа платформы, где вводятся учётные данные.
3. После ввода учётных данных приложение возвращается на свою страницу и показывает сообщение «Завершаем вход…», затем «Готово, перенаправляю…».
4. Автоматически открывается рабочий экран загрузки модели.

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

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

3.3. Порядок проверки работоспособности

После входа последовательно убедиться в следующем.

Выполнение шагов 1–7 без ошибок означает, что продукт работоспособен: доступны аутентификация, связь с источником моделей, конвертация, отображение и выгрузка. Полный сквозной пример с ожидаемым результатом приведён в п. 6.2.

---

4. Описание операций

4.1. Состав экранов

Отдельной страницы настроек, справки или переключателя языка в интерфейсе нет. Язык интерфейса (русский или английский) задаётся при развёртывании продукта администратором.

4.1.1. Экран приветствия

4.1.2. Экран загрузки модели

Сверху — шапка с названием продукта и плашкой аккаунта. Ниже — две независимые секции ввода источника. У каждой секции есть пояснение, свёрнутое до двух строк, с ссылкой «развернуть» / «свернуть».

4.1.3. Экран просмотра и выгрузки

Двухпанельный экран с перетаскиваемым разделителем. Слева — источник (карта исходной модели либо её результирующий XML), справа — карта результата конвертации с панелью выгрузки. Заголовок продукта здесь не показывается: карта является рабочей поверхностью. Плашка аккаунта вынесена в правый верхний угол, кнопка «Назад» — в левый верхний.

Обозначения: 🌐 — внешние картографические сервисы, ▤ (вверху) — выбор подложки, ↗ — внешние просмотрщики форматов, ⑂ — маршруты перекрёстка, ▤ Св. — свойства выбранного объекта.

4.2. Экран загрузки модели — элементы

Секция «Создать из гео модели ТРЭК.Основание». Здесь загружается модель, подготовленная в редакторе ТРЭК.Основание.

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

Секция «Просмотр готового файла». Здесь открывается готовый файл HD-карты с локального диска.

Формат файла указывать вручную не требуется: он определяется по корневому элементу содержимого (<OpenDRIVE>, <osm>, <net>, <network>). При открытии готового файла левая панель с исходной моделью не используется и скрывается.

4.3. Экран просмотра и выгрузки — элементы

4.3.1. Общие элементы экрана

4.3.2. Левая панель — источник

Левая панель показывается, когда модель загружена из ТРЭК.Основание, и имеет два режима, переключаемых кнопкой на панели результата.

Режим карты исходной модели.

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

Режим XML. Показывает XML результата конвертации в режиме только для чтения (см. п. 4.3.5). Для формата NET329, если сеть слишком велика (более 50 000 элементов — узлов, рёбер и связей суммарно), вместо XML выводится сообщение «XML слишком большой для отображения».

4.3.3. Правая панель — результат конвертации

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

Клик по объекту на карте результата открывает таблицу его полей и одновременно подсвечивает соответствующий элемент в XML на левой панели — редактор прокручивается к строке с этим идентификатором.

Режим «Аналитика дорог». Если на экране загрузки выбран пункт «Аналитика дорог», вместо карты результата открывается набор аналитических таблиц. Этот режим относится к отдельному аналитическому продукту линейки и не входит в функциональность ТРЭК.РоадХаба как конвертера и просмотрщика; в настоящем руководстве он не описывается.

4.3.4. Маршруты перекрёстка

Когда на карте источника выбран перекрёсток, кнопка маршрутов становится доступной и показывает числовой значок — общее количество маршрутов через узел. По нажатию раскрывается дерево, сгруппированное по подходам (узлы вида «Подход: …»); отметка листового элемента подсвечивает соответствующий маршрут на карте. Поддерживается одновременная отметка нескольких маршрутов. Выбор другого объекта или снятие выделения сбрасывает подсветку.

4.3.5. XML результата

Встроенный редактор кода показывает XML результата конвертации только для чтения:

• подсветка синтаксиса XML (теги, атрибуты, значения, комментарии);
• нумерация строк и сворачивание вложенных элементов;
• переход к элементу по клику на объект карты результата — поиск ведётся по атрибутам id, signalId, junctionId, laneId, roadId.

Для больших файлов подсветка автоматически упрощается ради скорости работы (пороги — 5 МБ и 15 МБ). Редактирование XML в продукте не предусмотрено.

4.3.6. Плашка аккаунта

Плашка в правом верхнем углу показывает инициалы и имя (или адрес электронной почты) вошедшего пользователя. По нажатию раскрывается меню:

4.3.7. Страница «Не найдено»

При переходе по несуществующему адресу показывается страница с заголовком «404», сообщением «Страница не найдена» и кнопкой «На главную».

4.4. Операции

Операция 1. Загрузка и конвертация модели из ТРЭК.Основание

Операция 2. Открытие готового файла HD-карты

Операция 3. Инспекция объекта модели

Операция 4. Просмотр маршрутов перекрёстка

Операция 5. Обновление исходных данных

Операция 6. Выгрузка результата в файл формата

6.1. Особенности выгрузки Lanelet2. Кнопка «Загрузить lanelet2» — раскрывающееся меню:

Файл параметров проекции нужен инструментам, которым для корректной привязки модели требуется знать систему координат. Важно: начало отсчёта берётся из текущего центра карты, поэтому перед выгрузкой следует установить вид так, чтобы центр соответствовал желаемой точке привязки.

6.2. Особенности выгрузки SUMO. Кнопка «Загрузить sumo» — раскрывающееся меню:

Архив распаковывается в одну папку и запускается штатными средствами SUMO по файлу конфигурации. Трафик генерируется в браузере: формируется демонстрационный набор поездок между въездами и выездами сети, детерминированный для одной и той же модели — повторная выгрузка того же слепка даёт тот же трафик. Это отправная точка для запуска модели, а не расчётная матрица корреспонденций.

Ограничение по светофорам. Светофорные программы в выгрузке SUMO строятся автоматически по фактическим сигнальным группам перекрёстка, но с фиксированными длительностями по умолчанию (при единственной сигнальной группе — постоянно разрешающий сигнал). Расчёт длительностей и адаптивное управление не выполняются: для точной настройки светофорного регулирования программу следует доработать в SUMO или подготовить в специализированном продукте линейки.

Операция 7. Выгрузка геометрии в GeoJSON

Операция 8. Переход во внешний просмотрщик

Операция 9. Передача ссылки на текущее состояние

Операция 10. Завершение работы

4.5. Параметры отображения

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

Идентификатор слепка, целевой формат, подложка, центр и масштаб карты хранятся в параметрах адресной строки — поэтому ссылку на текущее состояние можно сохранить или передать (операция 9).

---

5. Аварийные ситуации

5.1. Действия при несоблюдении условий выполнения

5.2. Действия по восстановлению программ и данных

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

5.3. Действия при обнаружении несанкционированного доступа к данным

Признаки, при которых следует считать, что доступ к данным получил посторонний:

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

Немедленные действия:

1. Завершить сессию: раскрыть плашку аккаунта и нажать «Завершить сессию». Это гасит сеанс единого входа для всех продуктов платформы.
2. Сменить пароль учётной записи в личном кабинете («Аккаунт»).
3. Не выполнять выгрузку и не передавать выгруженные файлы до выяснения обстоятельств.
4. Сообщить о происшествии администратору стенда и в техническую поддержку (info@trafficeq.ru), указав дату и время, адрес стенда, имя учётной записи, идентификаторы затронутых слепков и наблюдаемые признаки.
5. Сохранить свидетельства: снимки экрана, адрес страницы, текст сообщений — они нужны для разбора инцидента.

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

5.4. Прочие аварийные ситуации

---

6. Рекомендации по освоению

6.1. Порядок освоения

1. Прочитать разделы 1 и 2 — понять область применения и границы продукта.
2. Войти в систему и пройти проверку работоспособности (п. 3.3).
3. Выполнить контрольный пример (п. 6.2) — он проходит через все ключевые операции.
4. Освоить инспекцию: свойства объекта, маршруты перекрёстка, связь карты и XML (операции 3 и 4). Это основной инструмент проверки качества модели.
5. Пройти выгрузку в свой рабочий формат и загрузить результат в свой инструмент (операция 6). Для SUMO — начинать с пункта «Сеть + трафик + конфиг (.zip)»: он даёт запускаемую модель без дополнительной подготовки.
6. Освоить передачу ссылки на состояние (операция 9) — это основной способ обсуждения конкретного места модели с коллегами.

6.2. Контрольный пример

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

Исходные данные. Идентификатор демонстрационного слепка дорожной модели. Его выдаёт администратор стенда; при работе со свободной версией слепок готовится самостоятельно в редакторе (небольшая территория — район с несколькими регулируемыми перекрёстками).

Правила запуска. Выполнять шаги подряд, не закрывая вкладку. Ожидаемое время прохождения — 10–15 минут.

Критерий успеха. Все двенадцать шагов дали ожидаемый результат; сохранённые файлы открываются в целевых инструментах (архив SUMO — по файлу конфигурации, файл .xodr — в онлайн-просмотрщике ODR Viewer, доступном по кнопке внешних просмотрщиков).

Если результат отличается. Сопоставить наблюдаемое с таблицами раздела 5; при неустранимом расхождении обратиться в техническую поддержку, приложив номер шага контрольного примера, на котором произошёл сбой.

6.3. Советы по работе

• Проверяйте источник, а не только результат. Если в результате конвертации чего-то не хватает, сначала посмотрите, есть ли это на левой панели: продукт не достраивает данные, отсутствующие в исходной модели.
• Параметр оптимизации трансформации задаётся в ТРЭК.Основание, а не в РоадХабе. Именно он определяет качество геометрии в результате.
• Перед выгрузкой параметров проекции Lanelet2 установите центр карты в желаемой точке привязки: координаты начала отсчёта берутся из текущего вида.
• Тёмная подложка («Carto Dark», «OFM Dark», «Esri World») удобна для просмотра плотной сети: дорожная сеть автоматически переключается в контрастную палитру.
• Для сверки карты и XML используйте связку «клик по объекту → «Смотреть XML»»: это быстрее, чем искать элемент в файле вручную.
• Передавайте коллегам ссылку из адресной строки, а не описание словами: она восстанавливает слепок, формат, подложку и вид карты.
• Имена файлов при выгрузке назначаются автоматически и содержат случайный номер — переименовывайте файлы в диалоге сохранения, если работаете с несколькими вариантами.

6.4. Горячие клавиши

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

---

Приложение А. Форматы и файлы

А.1. Форматы конвертации и выгрузки

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

Названия OpenDRIVE, Lanelet2, SUMO, NET329, а также CARLA, Esmini, Autoware, Aimsun, PTV Vissim — это открытые стандарты и сторонние продукты, читающие выгруженные файлы. ТРЭК.РоадХаб формирует сами файлы; их загрузка во внешний инструмент выполняется средствами этого инструмента.

А.2. Форматы файлов, принимаемых на просмотр

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

А.3. Техническая поддержка

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