OVERVIEW OF EXAMPLES IN THE VISUM INSTALLATION

General
The following overview shows a list of examples which are included in the delivery of PTV VISUM. They are categorized in Training
examples, Short tutorials, Full demo, Example of User Manual and COM-example. The sample folder is located in the following data path
C:\USERS\PUBLIC\DOCUMENTS\PTV VISION\PTV VISUM 14, partially the files can be opened directly from VISUM (in menu Help).

Training examples
Training examples demonstrate features of Visum in a compact and comprehensible form.
EXAMPLE

FILE DIRECTORY

FUNCTIONALITY

ASSIGNMENT WITH ICA

\EXAMPLES\EXAMPLES\
ASSIGNMENTICA\

The example demonstrates the use of the method Assignment with ICA including different options.

DEMAND 4-STEP MODEL

\EXAMPLES\EXAMPLES\
DEMAND_4-STEP\

The example demonstrates the demand calculation based on the 4 step model, i.e. the example
contains all the zone attributes and procedure steps for running the demand model with a
feedback loop.

DEMAND EVA

\EXAMPLES\EXAMPLES\
DEMAND_EVA\

The version file contains an example with all the procedure steps of the demand model EVA,
including EVA trip generation, EVA weighting and EVA-distribution/mode choice.

DEMAND NESTED LOGIT

\EXAMPLES\EXAMPLES\
DEMAND_NESTEDLOGIT\

The example demonstrates the demand calculation based on a nested logit model. The
description also contains advice for developing the model including definition of the attributes and
parameters.

DEMAND VISEM

\EXAMPLES\EXAMPLES\VISEM\

The example demonstrates the demand calculation using the tour-based demand model VISEM.
In the example the procedures Tour-based model Trip generation and Tour-based model
Combined trip distribution / mode choice are calculated. An extension deals with the functionality
Rubberbanding for destination choice.

DUE

\EXAMPLES\EXAMPLES\DUE\

The example describes two variants (with and without spillback) of the dynamic user equilibrium
assignment

FARES DETAILED

\EXAMPLES\EXAMPLES\FARES\
DETAILED_TT

The example demonstrates the application of the fare model in conjunction with a timetable-based
PuT assignment.

FARES FAREPOINTS

\EXAMPLES\EXAMPLES\FARES\
FAREPOINTS_HB

The example demonstrates the use of the fare model in the headway-based assignment.

FILTERS

\EXAMPLES\EXAMPLES\FILTER\

This example demonstrates the use of complex filters.

LIST AGGREGATION

\EXAMPLES\EXAMPLES\

This example demonstrates how user-defined attributes (UDA) with formulas and aggregation

AND UDA WITH

FORMULAS

FORMULA_LISTAGGREGATION\

functions in lists can be used for data analysis.

HBEFA

\EXAMPLES\EXAMPLES\
HBEFA_EMISSIONS\

The example demonstrates the calculation of emissions with respect to the Handbook Emission
Factors for Road Transport (HBEFA 3.1)

Importer PuT from Visum

\EXAMPLES\EXAMPLES\
PUT_IMPORTER\

The example demonstrates various use cases for the (partial) Import of PuT supply from another
Visum version file

IMPORT
OPENSTREETMAP

\EXAMPLES\EXAMPLES\
IMPORT_OSM

The example demonstrates how to import data from OpenStreetMap as a road network

LINE BLOCKING

\EXAMPLES\EXAMPLES\
LINEBLOCKING\

The example demonstrates the use of line blocking.

MATRIXEDITOR

\EXAMPLES\EXAMPLES\
MATRIXEDITOR\

The example demonstrates a wide range of options for editing, calculating and analyzing matrices
within the matrix editor.

MODEL TRANSFERFILES

\EXAMPLES\EXAMPLES\
MODELTRANSFER\

This example demonstrates how scenarios can be developed and managed using model transfer
files.

PRT PATHS

\EXAMPLES\EXAMPLES\
PRTPATH\

The example demonstrates the use of the network object PrT path for comparisons of assigned
and observed journey times.

CAPACITY RESTRAINED
PUT ASSIGNMENT
TIMETABLE-BASED

\EXAMPLES\EXAMPLES\
PUT_CAPRESTRAINED\
TIMETABLE-BASED

The example shows an application of capacity restrictions in the timetable-based PuT assignment
including the effects on connection search and choice.

CAPACITY RESTRAINED
PUT ASSIGNMENT
HEADWAY-BASED

\EXAMPLES\EXAMPLES\
PUT_CAPRESTRAINED\
HEADWAY-BASED

The example shows an application of capacity restrictions in the headway-based PuT assignment.

PUT PASSENGER
ONBOARD-SURVEY

\EXAMPLES\EXAMPLES\
ETICKET\

The example demonstrates the use of the module Passenger onboard survey. This module
enables to determine demand based on PuT surveys and E-Ticketing systems.

SCENARIO
MANAGEMENT I

\EXAMPLES\EXAMPLES\SZENA
RIOMANAGEMENT\PART_I\

Part I: This example shows how the Visum project management feature can be used for the
creation, management and network-wide analysis of scenarios.

SCENARIO
MANAGEMENT II

\EXAMPLES\EXAMPLES\SZENA
RIOMANAGEMENT\PART_II\

Part II: This example shows how the Visum project management feature can be used for the
creation, management and detailed analysis of scenarios.

SCHEMATIC LINE
DIAGRAM

\EXAMPLES\EXAMPLES\
SCHEMATICLINEDIAGRAM\

The example shows insights into the editing options and graphical possibilities of the schematic
line diagram.

SIGNAL OPTIMISATION

\EXAMPLES\EXAMPLES\
SIGNALOPTIMIZATION\

The example demonstrates the possibilities of optimization of signal programs.

MATRIX CORRECTION
DISTRIBUTION

\EXAMPLES\EXAMPLES\
TFLOWFUZZY\TFF_DISTRIBUTI
ON\

The example demonstrates use of an empirical trip length distribution for the matrix estimation.
The creation of matrix histograms is described as well.

MATRIX CORRECTION
COUNT DATA

\EXAMPLES\EXAMPLES\
TFLOWFUZZY\TFF_COUNTS\

The example demonstrates matrix estimation based on count data for links as well as the
possibility of diagnosis in case of errors.

TOLL

\EXAMPLES\EXAMPLES\TOLL\

The example shows the use of different toll models for Highway.

VERSION COMPARISON

\EXAMPLES\EXAMPLES\
VERSIONCOMPARISON\

The example demonstrates how version comparisons can be used to analyze the model results of
different scenarios.

VISSIG

\EXAMPLES\EXAMPLES\VISSIG\

The example shows how external signal control with VISSIG can be modeled. It is also explained
how you can switch between signal controls of one node for different periods of the day.

Tutorials
Tutorials demonstrate basic modeling workflows by giving step-by-step instructions and providing all required data.
TUTORIAL
First Steps

FILE DIRECTORY
\EXAMPLES\
TUTORIAL_FIRSTSTEPS\

FUNCTIONALITY
The tutorial demonstrates exemplary the first steps for working with PTV Visum. It is addressed to
unexperienced users to get a first impression of the program operation in PTV Visum. Covered
topics are:
Network coding Highway and PT
Procedure flow
Graphic parameter

Quickstart

\EXAMPLES\
QUICKSTART TUTORIAL\

This tutorial will assist you in learning how to use PTV Visum. The step-by-step instructions will
demonstrate typical approaches to frequent requirements when working on a project. Covered
topics are:
Creation and attribution of network objects
Inserting travel demand
Assigning travel demand to the network
Analyzing the network
Optimizing a bus network
Analyzing the existing line network
Assignment and indicator calculation
Analyzing PuT-supply quality

Short tutorials
Short Tutorials demonstrate some advanced modeling workflows by giving step-by-step instructions and providing all required data.
TUTORIAL
AMN export

FILE DIRECTORY
\TUTORIALS\AMNEXPORT\

FUNCTIONALITY
The tutorial shows the export of a sub-network to Vissim (ANM export). Open the file
README_ANM_EXPORT.PDF and follow the instructions step by step to learn more about:
Defining node geometries and using the Vissim preview.
Creating a sub-network as preparation for the export to Vissim.
Executing the ANM export from Visum and the ANM import into Vissim.
Analysis of the imported model and evaluation of errors.
Principles of the adaptive ANM export and ANM import

Park+Ride

\TUTORIALS\PARK+RIDE\

The tutorial describes how Park+Ride can be implemented within the mode choice calculation.
The required steps are explained as well as the use of special Add-ins for modelling Park+Ride.

Line blocking

\TUTORIALS\LINEBLOCKING\

The Tutorial (only in German available!) describes methods and tools for working with line blocks
in Visum. Starting with a simple example more complex problems are derived and solved over the
course of this tutorial. Additionally, you learn about
the parts of the data model used for modeling line blocks
the graphic options for displaying results of the line block calculation
the procedure for calculating line blocks and its settings.

TFlowFuzzy

\TUTORIALS\TFLOWFUZZY\

Example for matrix calibration with TFlowFuzzy. Open the file README_TFLOWFUZZY.PDF and
follow the instructions step by step to learn more about:
Principles of TFlowFuzzy.
Importing traffic count data to Visum.
Using the procedure assignment analysis.
Setting up the tolerance intervals and the filters as a preparation for the execution of
TFlowFuzzy.
Configuring the procedure dialog for TFlowFuzzy.
Analysis of the procedure results.
Solving typical errors when working with TFlowFuzzy.

Full Demo
FILES

FUNCTIONALITY

\Demo_Karlsruhe\
KA.VER
KA.PAR

Subarea cut from a comprehensive network of Karlsruhe, Germany. The following features are demonstrated:
Incremental highway assignment.
PuT procedures: timetable-based assignment and calculation of PuT operating indicators.
This network contains points of interest (POI).
Detailed modeling of the transit stop at the main station (Karlsruhe Hauptbahnhof).
Schematic line diagram (see extra description, module required)
Transfer display of regular services for the main station (Karlsruhe Hauptbahnhof).
Timetable editor tabular and graphical.
Take a look at the main nodes modeled in this example and test the Vissim preview:
Mark the main node and double click on it.
Change to Geometry to have a look at legs, lanes, lane turns and signals.
Press the button VISSIM NODE PREVIEW.
The Vissim preview is started in a new window.
Note: the parameter file KA.PAR contains the parameter settings for this example. In case you changed the
settings you can restore the original procedure sequence by opening this file.
-

KA_DYN.VER
KA_DYN.PAR

Same PrT supply as in KA.VER, but demand is segmented by trip purpose and mapped with daily time series:
Show dynamic link bars using the tool bar Analysis time intervals to show values of the Current interval.
Show the results of the dynamic timetable-based assignment as a column chart for each link:
Mark a link which is traversed by a PuT line.
Right click on the link and choose Column charts from the menu bar.
A chart displaying the volume over the time (analysis intervals) is displayed.
Note: the parameter file KA_DYN.PAR contains the parameter settings for this example. In case you changed the
settings you can restore the original procedure sequence by opening this file.

KA_DUE.VER
KA_DUE.PAR

\TIMETABLEEDITOR\

*.TLY (Fahrplaneditorlayouts)

Same PrT supply as KA.VER, but modeled for a DUE assignment. The assignment parameters used in the
example define a dynamic assignment for a period of 2 h in 19 time intervals. Depending on the hardware, the
computation time can take up to 30min. To take a look at the assignment results: you can either open a column
chart for the link or view dynamic link bars by using the tool bar Analysis time interval.
Note: the parameter file KA_DUE.PAR contains the parameter settings for this example. In case you changed the
settings you can restore the original procedure sequence by opening this file.
Demonstrates the graphical functionalities of the timetable editor:
Open KA.VER.

*.GPT (Fahrplaneditorgrafikparameter)

Choose FILE > PROJECT DIRECTORIES > EDIT PROJECT DIRECTORIES from the menu bar and ensure that the
settings for .GPT files are set to the \TIMETABLEEDITOR\ directory.
Choose SCRIPTS > RUN SCRIPT FILE from the menu bar and select GPT_DEMO.PY.
A floating dialog is displayed: choose one of the items from the combo box.
The graphical settings and the layout are changed as soon as you select one of the items.

\GRAPHICPARAMETERS\

*.GPA (Grafikparameterdateien)

Demonstrates graphic parameter settings in the network editor and the possibilities of the GPA-Selector:
Open KA.VER.
Choose FILE > PROJECT DIRECTORIES > EDIT PROJECT DIRECTORIES from the menu bar and ensure that the
settings for .GPA files are set to the \GRAPHICPARAMETERS\ directory.
Select one of the files from the GPA Selector in the tool bar of the network editor.
The display of your map is changed according to the selected .GPA file.

\PASSENGERSURVEY\
KA_PASSENGERSURVEY.XML
KA_PASSENGERSURVEY.GPA
KA_PASSENGERSURVEY.TXT

Example of passenger survey for demonstrating the passenger survey add-on module: reading of survey data,
plausibilization of survey data and direct assignment:
Open KA.VER
Open the procedure parameters KA_PASSENGERSURVEY.XML and choose the settings to replace the
existing procedure sequence.
Confirm the initialization of existing assignment results in the next dialog by choosing YES.
Take a look in the procedures dialog and press the EXECUTE button to run the procedures.
Open the graphic parameters file KA_PASSENGERSURVEY.GPA to display the results of the direct assignment
in the network.
A detailed description of the procedures and its parameters can be found in the Visum manual.

\PUTOPERATINGINDICATORS\

The example describes the calculation and analysis of PuT operating indicators. Open the file
README_PUTOPERATINGINDICATORS.PDF and follow the instructions step by step for learning more about:
Analysis of indicators related to time intervals and territories.
Analysis of indicators on different aggregation levels of the line hierarchy.
Approximate estimation of revenues for PuT.
Detailed calculation of revenues using the fare model.
Modeling and calculation of costs for providing PuT services.
Calculation of user defined indicators for PuT.

Example of user manual

This example network is used as a reference throughout the Visum user manual.
FILES

FUNCTIONALITY

\Example_Net\
EXAMPLE.VER

Introductory example for using the net editor and for demonstrating simple assignments on an example network:
Advantage: due to the small network size assignment results can also be calculated manually in most cases.
This example network is used as a reference throughout the Visum user manual.

EXAMPLEDYN.VER

This version contains the same network as EXAMPLE.VER, but is parameterized for dynamic highway
assignment.

EXAMPLE_LLE.VER

This version contains the same network as EXAMPLE.VER, but is parametrized for line costing. It is used in
chapter 7 (PuT Operator Model), Part Fundamentals, for demonstration purposes.

EXAMPLE_LINEBLOCKING_CLOSED.VER

These two examples are used in the Visum manual to demonstrate the differences between closed and open
blocks in the line blocking procedure.

EXAMPLE_LINEBLOCKING_OPENCLOSED.VER

COM Example
The directory \PTV VISUM 14\COM contains various examples for COM scripting with Visum. The file INTRODUCTION TO THE PTV VISUM
COM-API.PDF located in that folder provides an introduction to using the COM-API of Visum.
FUNCTIONALITY / PATH

WHAT CAN YOU LEARN?

HOW DO YOU USE THIS EXAMPLE?

\Examples_ComDocu\
Overview over basic elements of the
Visum COM interface.
Examples which are referenced in the
COM Documentation

Basic scripting possibilities for

operating Visum by VBA.

Open one of the Excel files.

Change the path in cell B3 to your own file location.
Press CTRL + F11. The Microsoft Visual Basic editor is opened.
Have a look at the source code and its comments.
Change back to the Excel worksheet.
Press the START button. The VBA script is excecuted.
Compare the new Version file with the original one.

\VBScript\
Add a stop, stop area and stop point
(burger) for the currently selected
node.
Specify certain attributes to be copied
from the node to the stop, stop area,
and stop point, respectively.

Running scripts from within

Visum using a VBS script.
Customizing Visum by adding
own entries to the menu bar.
Setting attribute values via
AttValue.

Open the script file ADDBURGER.VBS in a text editor (e.g. TextPad).

Specifiy the attributes you want to copy from the node to the stop, stop
area, and stop point in line 12 of the script.
Open a version file in which you want to use the script.
Select the node for which you want to add the burger in the single
select mode.
Choose SCRIPTS > RUN SCRIPT FILE from the menu bar.
Open the file ADDBURGER.VBS. Stop, stop area, and stop point are
inserted and the specified attributes are copied from the node.

\Python\
Introduces the powerful Python scripting
features.
To make your start with Python as easy
as possible, you can find several
example scripts in this folder.
\Python\addburger.py

Using

Pythons
easy-to-use
functions for matrix editing.

Adding custom charts and

graphical user interfaces to
Visum.

The following applies to all Python examples:

Make sure that Python is installed.

Select SCRIPTS > RUN SCRIPT FILE from the menu bar.
Open the script file you like to execute.

 Offers

the

same

functionality

If you want to use this script regularly, you can add a menu item to start it
from the Visum menu bar:
Choose SCRIPTS > EDIT SCRIPT MENU from the menu bar.

as

ADDBURGER.VBS.

Press the CREATE Button.

Enter Add Burger next to Menu command.
Under script name select the script file ADDBURGER.VBS.
Specify optionally a key combination for running the script with a
shortcut.
Press the OK Button twice.
Now you can select the script from the Scripts-menu whenever you
need it.
\Python\calculateIntrazonal.py
Calculating intra-zonal values for a
matrix
Setting the values of the diagonal of a
matrix as factor * nearest destination
zone.

Using matrices with Python.

Access to Visum Objects (here:
skim
matrices)
using
ItemByKey.

Precondition: Version file contains skim matrices.

Open the script file CALCULATEINTRAZONAL.PY in a text editor.
Specifiy the skim matrix number you want to edit with the script by
changing the matrix number after ItemByKey in lines 21 and 27.
Run the script from the menu bar via SCRIPTS > RUN SCRIPT FILES

Extending Visums graphical

and analysis capabilities by
exports to Microsoft Excel.

Precondition: make sure that Excel is installed on your computer and

that the model contains a PuT assignment result and analysis time
intervals, for which volumes have been saved.
Run the script LINELOADINGS.PY in Visum.

\Python\lineloadings.py
Producing a 2D plot of line volumes for
a selected line route in Microsoft Excel.

A floating dialog appears. Choose one of the displayed lines.

Excel is opened and a corresponding diagram displayed.
\Python\PrTAssignmentQualityListing.py
Creates an Excel chart showing the
convergence of an assignment.

Extending Visums graphical

and analysis capabilities by
exports to Microsoft Excel.

Precondition: make sure that Excel is installed on your computer and

that the model contains a PrT assignment result.
Run the script PRTASSIGNMENTQUALITYLISTING.PY in Visum.
Excel is opened and a diagram a chart of the convergence is displayed.

Others

Folder \MAPMATCHER

Matching external data (e.g. FCD

trajectories) to a road network

A detailed description of the example workflow is provided in

README_MAPMATCHER-COM_ENG.PDF