opGUI v1.0

opGUI v1.0

This merge request introduces several feature improvements and updates across the System Editor, PRE, RUN, and MONITOR sections of the application, as well as the first HTML version of the application documentation. The main changes are summarized below.

System Editor

The System Editor was improved both functionally and visually. Component movement on the canvas was enhanced by implementing smooth micro-movement adjustments, allowing users to reposition components with significantly greater precision and stability. Support was also added for the legacy and modified XML format for the components, such as those found in the GECCO repository, ensuring backward compatibility with existing configurations while enabling full support for the new component definitions. Additionally, UI improvements were introduced to improve readability and navigation. Parameter sections within components are now visually separated using small icons, making complex component configurations easier to understand and manage.

PRE Section

The PRE section received the most significant updates. Users can now either load an existing configuration folder (e.g. Common) or create a completely new configuration from scratch. When loading a configuration folder, the application automatically detects and loads all related configuration files such as UserSettings, Scenario, Scenery, and Catalogs. When creating a new configuration, the system can automatically generate a complete configuration folder structure within the user’s workspace. After the user confirms and provides a folder name, the application generates all required configuration files (such as UserSettings, Scenario, Scenery, ProfilesCatalog, VehiclesCatalog, PedestrianCatalog, etc.) with minimal template values. This allows users to start from a valid baseline configuration while still having the flexibility to modify all parameters.

Configuration files can now also be viewed in two different ways:

• A structured and visually organized view directly within opGUI
• The original file format (XML, INI, XOSC, etc.) via a toggle switch

Editing capabilities were also extended:

• All configuration files (except ProfilesCatalog) can be opened in the external code editor defined in Global Setup
• Within opGUI itself, users can edit UserSettings, ProfilesCatalog, VehiclesCatalog, and PedestrianCatalog

Several UI improvements were implemented across the PRE section, including additional icons, improved layout consistency, and better visual organization. The configuration loading workflow was also aligned with the folder structure used in GT-GEN and GECCO repositories.

RUN Section

The RUN section now manages simulation execution with several enhancements. The UI was improved with additional icons and better layout consistency. A new Additional Settings section was introduced for each simulation execution. This allows users to adjust extra runtime parameters before starting a simulation. The most important parameter introduced is Step Size, which is required for simulations using GECCO components. Log-level handling and validation were also improved, and the execution workflow was aligned with the updated PRE configuration pipeline to ensure full compatibility with the GT-GEN simulator.

MONITOR Section

The MONITOR section provides a live overview of simulation execution. After starting simulations in the RUN section, users can monitor all running simulations in real time, including loaded configuration files, simulation duration, execution status (running, passed, failed), and additional metadata. Several UI refinements were introduced to improve readability and visual consistency, including layout improvements and additional icons across the interface.

Documentation

This merge request also introduces the first HTML version of the opGUI documentation, which was previously available only in PDF format. The documentation includes a comprehensive overview of all application sections and features, covering installation, configuration setup, and usage guidelines.

A new Tutorials subsection was added, demonstrating the complete workflow of using the application through two detailed examples:

• Running a GT-GEN simulation using GT_GEN components (example_simple_cut_in.xosc)
• Running a GT-GEN simulation using GECCO components (Common configuration)

These tutorials guide users through the entire process, from configuration preparation to simulation execution and monitoring.

In addition to these features, several bug fixes and refactoring improvements were implemented across the frontend, backend, and automated tests.