Visualizer

The Tramola Visualizer is a tool for visualizing and analyzing transportation simulation data on interactive maps. It allows you to load simulation runs, compare different scenarios, and customize the visual representation of networks and vehicles.

Getting Started

Adding Runs

To begin visualizing your data, you need to add one or more simulation runs:

1. Add a single run: Click the "Add Run +" button in the RUN section of the left sidebar
2. Add multiple runs for comparison: Click "Add Run +" multiple times to load different simulation scenarios
3. Select runs: Use the dropdown menu next to each data source to switch between available runs

When you add your first run, the visualizer automatically:

• Loads the network layer showing the transportation infrastructure
• Displays vehicles on the network

Initial View

After selecting a run, you'll see:

• Network Layer: Blue lines representing roads, tracks, or other transportation infrastructure
• Vehicles Layer: Moving or static vehicles on the network
• Timeline: Controls at the bottom for playing through time-based data
• Sidebar: Configuration options for customizing the visualization

Network Configuration

The network layer provides extensive customization options to help you analyze different aspects of your transportation data:

Data Source Selection

• Based on Data Source: Choose which run's data to use for the network visualization
• Multiple Data Sources: When you have multiple runs loaded, you can compare networks from different scenarios

Value Mapping Strategies

Constant

If no property is selected for color/width, you can choose a constant color/width.

Scale

By default, scale determines the min and max values of the selected attribute maps each values linearly to the selected range.

Color

• if your links have capacities from 0 to 10000, a link with capacity 3000 is mapped to the color at 30% of your selected color scheme

Line Width

• if your links have capacities from 0 to 10000 and you set a min width of 1 and a max width of 11, a link with capacity 3000 is mapped to line width (1 + 10 * 0.3) = 4

Scale with custom bounds

You can set custom bounds to influence the interpolation on a more granular level.

Color

• when custom bounds are set, both color and value are linearly interpolated within each section.

If you want to stay as close as possible to a predefined color scheme, we recommend setting a higher number of bounds, as this will lower the effect of the rgb interpolation between bounds.

Line Width

• for line width Tramola will linearly interpolate within each section for both the domain and the range

Bin

Binned values work similarly to scale with custom bounds, but do not apply any interpolation. The color and width value you define are the exact values you will observe on the map.

Auto-generated analysis

When a simulation run completes, Tramola automatically computes link volume and flow bundle analysis for the run. These analyses can be selected as link properties in the network section.

Link Volumes

Link Volumes count how many vehicles have passed over a link. In the bottom of the sidebar, additional filters allow to filter by time (e.g. to show only the link volumes in the morning) or to filter the data by person or trip attributes.

Note: When applying filters using the persons or trips table, trips of pt vehicles will automatically be filtered out as they are not considered as travel demand of agents – and therefore not included in the trips table generated by MATSim.

Flow Bundles

Flow Bundles (Spinnenanalyse) allow you to select a link and observe through which other links traffic is flowing through for the selected link.

Once you select flow bundle as an attribute in any layer, you can click on the map to select a link or enter a link id at the bottom of the sidebar (especially useful when comparing scenarios).

Vehicle Configuration

Vehicles can be colored by mode, absolute speed, or relative speed. Drag the global time and press play to view vehicles moving in the simulation.

Similar to link volumes, you can filter vehicles by attributes in the persons and trips table, noting that any trip of public transport vehicles will be filtered out as they are not tracked in the trips table.

Export

To save an image of the current map and it's contents, there is a small save button in the top right corner of the screen