SimWrapper

SimWrapper

  • Documentation
  • Examples
  • News
  • GitHub

›API Reference / General

Introduction

  • SimWrapper
  • Examples
  • File management
  • Getting help

Guides

  • 1. Getting started tutorial
  • 2. Dashboards in depth
  • 3. Building a project site
  • 4. Publishing to the web

API Reference / MATSim

  • MATSim Network link plots
  • MATSim Carrier viewer
  • MATSim DRT vehicle animation
  • MATSim Logistics Viewer
  • MATSim Public transit supply/demand
  • MATSim Events viewer

API Reference / General

  • Aggregate O/D flows
  • Bar, area, and line charts
  • Calculation tables
  • CSV table viewer
  • Flow maps
  • Gridmap
  • Heatmap chart
  • Matrix (HDF5) Viewer
  • Pie charts
  • Plotly
  • Sankey/Alluvial diagrams
  • Scatter plots
  • Shapefiles: Area maps, network links, and GeoJSON
  • Text blocks
  • Tiles
  • Vega-Lite charts
  • Video player
  • XML Viewer
  • XY hexagons (aggregate)
  • X/Y/Time point data

For Developers

  • Conversion scripts
  • Developing SimWrapper
  • Plugin writing guide
  • SimWrapper Change Log

Bar, area, and line charts

bar area example Some typical bar, area, and line charts

These simple charts are the core of many dashboards.

Usage

Bar, area, and line charts can only be included as panels in Dashboards. See Dashboard documentation for general tips on creating dashboard configurations.

  • Each chart panel is defined inside a row in a dashboard-*.yaml file.
  • Choose from panel types bar line and area in the dashboard configuration.
  • Standard title, description, and width fields define the frame.

Sample dashboard.yaml config snippet

layout:
  row1:
    - type: 'bar'
      title: 'Bar Plot'
      description: 'By iteration'
      width: 2
      dataset: '*drt_customer_stats.csv'
      x: 'iteration'
      xAxisName: 'Iteration'
      yAxisName: 'Distance'

    - type: 'area'
      title: 'Mode Share Progression'
      description: 'By iteration'
      width: 1
      dataset: '*modestats.txt'
      x: 'Iteration'

    - type: 'line'
      title: 'Mean Distances by Mode'
      description: 'per Iteration'
      width: 1
      dataset: '*drt_customer_stats.csv'
      x: 'iteration'
      xAxisName: 'Iteration'
      yAxisName: 'Distance'
      columns: [distance_m_mean, directDistance_m_mean]
      legendTitles: ['Distance (mean)', 'Direct Distance (mean)']

Bar, area, line chart properties

Each chart can have the following properties:

dataset: (Required) String. The filepath containing the data. May include wildcards * and ?.

x: (Required) String. The column containing x-values.

columns: (Required) Array of strings. List the column names of the columns which have the values to be graphed. Each element will be its own line/color. Example: ['distance', 'duration']

useLastRow: true/false. If set to true, only the last row of the datafile will be used to build the pie chart. For example, this is useful for MATSim outputs which list every iteration's output, and you are only interested in the final iteration.

stacked: true/false for bar charts: whether to stack multiple bars

legendTitles: Array of strings. Legend titles for each data column. The column names will be used if this is omitted.

xAxisName/yAxisName: Labels for the axes.

← Aggregate O/D flowsCalculation tables →
SimWrapper
Docs
Getting StartedDeveloper GuideLatest Updates
More
VSP HomeMATSim.org⭐ us on GitHub!
Copyright © 2025 VSP, TU Berlin