Dashboards
Assemble charts, tables and text into a page that you can revisit, and point it at a different run whenever you like.
A dashboard is a freely arranged page of charts, tables and text. It belongs to a team, so everybody in that team sees the same dashboards.
What makes a dashboard more than a collection of pictures is that it does not hold on to one particular run. The data a dashboard shows comes from one or more variables, and a variable points at a scenario or a run. Point the variable at a different run and every chart on the page is redrawn from that run’s data. The dashboard becomes a report you build once and reuse for every run that follows.
Opening the dashboards of a team Link to this section
Switch to the team in the left navigation bar, then click on . You see the dashboards of that team, with their name and their size. From here you can:
- click a name to open the dashboard,
- to create a new one,
- duplicate a dashboard, which is the quickest way to derive a variant from one that works,
- lock or unlock a dashboard,
- delete a dashboard.
A locked dashboard can still be opened and its variables can still be switched, but its layout and its items cannot be changed. Lock a dashboard once you are happy with it, so that neither you nor anybody else in the team rearranges it by accident.
The second tab, , is where the data behind the charts is administered — see Tables.
Creating a dashboard Link to this section
Click and open the new dashboard. Then:
- Give it a name by clicking the title at the top of the page and typing.
- Choose the dataset the dashboard should work with, in the variables row underneath.
- Add items with the button at the bottom of the page.
Instead of starting from an empty page, you can click and pick a prepared dashboard. This replaces the items of the dashboard with those of the template, so use it on a fresh dashboard.
Changes are saved automatically. The header shows Autosaved at … with the time of the last save; the disk button next to it saves immediately.
Variables: the datasets a dashboard shows Link to this section
Directly below the title, each variable is shown as a card with the scenario or run it currently points at, and a count of the tables available in it. Click the card to pick a different dataset.
With a single variable the card is simply labelled Dataset. This is the common case: one dashboard, one run at a time.
Clicking adds a second variable, and then a third, and so on. Each variable gets a name, and every chart is bound to one of them. This is how a dashboard compares runs: put the same chart on the page twice, bound to two different variables, and switch either one independently. See Comparing Runs.
A variable can only be deleted while no item on the dashboard uses it.
Items on the page Link to this section
at the bottom of the dashboard offers three kinds of item:
- Chart — opens the chart editor.
- Table — a tabular view of the data, configured much like a chart.
- Text — a heading or a paragraph, for titles, notes and explanations.
Items sit on a grid. Drag an item by its handle to move it, drag its corner to resize it. Each item has a menu of its own to edit, duplicate, delete it, or blow it up to fill the screen. The smallest an item can be is two grid cells by two.
The button in the header sets the size of the dashboard: normal lays the page out on 12 columns, large on 24. Large gives you finer control over widths and fits more side by side; it is the better choice for a dashboard meant to be read on a wide screen.
Before you can chart anything Link to this section
Charts read from tables, not from files. If the dataset a variable points at contains no tables, the dashboard says so and offers a link to import some. A run that reported to Tramola through the MATSim integration already brings tables with it; anything else you import yourself from a CSV file. This is explained in Tables.