Professional Documents
Culture Documents
Vissim 2022 Manual 1 191
Vissim 2022 Manual 1 191
Vissim 2022 Manual 1 191
User Manual
Copyright and legal agreements
Legal agreements
The information contained in this documentation is subject to change without notice and should
not be construed as a commitment on the part of PTV AG.
Without the prior written permission of PTV AG, this documentation may neither be reproduced,
stored in a retrieval system, nor transmitted in any form or by any means, electronically,
mechanically, photocopying, recording, or otherwise, except for the buyer's personal use.
Warranty restriction
The content accuracy is not warranted. Any information regarding mistakes in this manual is
greatly appreciated.
Imprint
PTV AG
Haid-und-Neu-Str. 15
76131 Karlsruhe
Germany
Tel. +49 721 9651-300
info@vision.ptvgroup.com
www.ptvgroup.com
vision-traffic.ptvgroup.com
© PTV GROUP 3
Contents
Copyright and legal agreements 3
Important changes compared to previous versions 15
First steps, quick starts and videos 21
Quick start guide Creating a network and starting simulation 23
Typography and conventions 25
1 Basics 27
1.1 Application area of PTV Vissim 27
1.1.1 Simulation of pedestrians with PTV Viswalk 27
1.2 PTV Vissim use cases 27
1.3 Traffic flow model and light signal control 29
1.3.1 Operating principles of the car following model 30
1.3.2 Driving states in the traffic flow model according to Wiedemann 32
1.4 Overview of add-on modules 33
1.4.1 General modules 33
1.4.2 Signal controllers (basic) 36
1.4.3 Signal controllers (advanced) 36
1.4.4 External signal controllers 38
1.4.5 Additional signal controllers 39
1.4.6 Programming interfaces 39
1.4.7 Driving simulator interface 39
1.5 Technical information and requirements 39
1.5.1 Criteria for simulation speed 39
1.5.2 Main memory recommended 40
1.5.3 Graphics card requirements 40
1.5.4 Interfaces 40
1.5.5 Number of characters of filename and path 40
1.6 How to install and start PTV Vissim 40
1.6.1 Information on installation and deinstallation 41
1.6.2 Content of the PTV Vision program group 41
1.6.3 Agreeing to share diagnostics and usage data 41
1.7 PTV Vision License Management 42
1.7.1 Basics of license management 42
1.7.2 Using PTV Vision products without a license 47
1.7.3 License handling for PTV Vision users 49
1.7.4 License handling for license administrators 59
1.7.5 Using a Thesis license 77
1.7.6 License Management – Questions & Answers 78
1.8 Properties of the Vissim versions 79
1.8.1 Overview of maximum values by version 80
1.8.2 Overview of version modules 81
1.8.3 Overview of signal controllers by version 82
© PTV GROUP V
1.8.4 Help, manual and FAQs by version 84
1.9 Using the PTV Vissim Viewer 84
1.9.1 Vissim Viewer installation and update 84
1.10 Using the PTV Vissim Simulation Engine 85
1.11 Using files with examples 85
1.11.1 Opening the Examples Demo directory 86
1.11.2 Opening the Examples Training directory 86
1.12 Opening the Working directory 86
1.12.1 Opening the working directory from the Windows Explorer 86
1.13 Documents 86
1.13.1 Showing the user manual 86
1.13.2 Showing the PTV Vissim Help 87
1.13.3 Additional documentation 87
1.14 Service and support 88
1.14.1 Using the manual, Help and FAQ list 89
1.14.2 Services by the PTV GROUP 89
1.14.3 Posting a support request 90
1.14.4 Requests to the Traffic customer service 91
1.14.5 Showing program and license information 91
1.14.6 Information about the PTV GROUP and contact data 92
1.15 Principles of operation of the program 92
1.15.1 Program start and start screen 93
1.15.2 Starting PTV Vissim via the command prompt 94
1.15.3 Using the Start page 96
1.15.4 Becoming familiar with the user interface 97
1.15.5 Using the Network object sidebar 100
1.15.6 Shortcut menu in the network object sidebar 103
1.15.7 Using the Level toolbar 104
1.15.8 Using the background image toolbar 105
1.15.9 Using the 3D info sign bar 106
1.15.10 Using the Quick View 107
1.15.11 Using the Smart Map 109
1.15.12 Using network editors 113
1.15.13 Selecting simple network display 127
1.15.14 Using the Quick Mode 128
1.15.15 Changing the display of windows 129
1.15.16 Using lists 132
1.15.17 Using coupled lists 160
1.15.18 Using the Menu bar 162
1.15.19 Using toolbars 177
1.15.20 Mouse functions and hotkeys 182
1.15.21 Saving and importing a layout of the user interface 188
1.15.22 Information in the status bar 189
VI © PTV GROUP
1.15.23 Selecting decimal separator via the control panel 191
1.16 Setting user preferences 191
1.16.1 Selecting the language of the user interface 192
1.16.2 Selecting the country for regional information on the start page 193
1.16.3 Resetting menus, toolbars, hotkeys, dialog positions 193
1.16.4 Selecting a compression program 194
1.16.5 Selecting the 3D mode and 3D recording settings 194
1.16.6 Right-click behavior and action after creating an object 195
1.16.7 Showing and hiding object information in the network editor 196
1.16.8 Defining click behavior for the activation of detectors in test mode 196
1.16.9 Showing short or long names of attributes in column headers 197
1.16.10 Managing map services of the background map 197
1.16.11 Configuring command history 197
1.16.12 Specifying automatic saving of the layout file *.layx 198
1.16.13 Checking and selecting the network with simulation start 198
1.16.14 Defining default values 199
1.16.15 Allowing the collection of usage data 199
1.17 Using 2D mode and 3D mode 200
1.17.1 Calling the 2D mode from the 3D mode 200
1.17.2 Selecting display options 200
1.17.3 Using 3D mode and specifying the display 243
1.18 Base data for simulation 253
1.18.1 Selecting network settings 253
1.18.2 Using user-defined attributes 260
1.18.3 Using aliases for attribute names 269
1.18.4 Using 2D/3D models 271
1.18.5 Defining functions for acceleration, deceleration and speed 282
1.18.6 Using distributions 292
1.18.7 Managing vehicle types, vehicle classes and vehicle categories 324
1.18.8 Defining driving behavior in a driving behavior parameter set 339
1.18.9 Defining link behavior types for links and connectors 389
1.18.10 Defining area behavior types 391
1.18.11 Defining boarding delay types 392
1.18.12 Defining display types 393
1.18.13 Defining track properties 397
1.18.14 Defining levels 398
1.18.15 Using time intervals 399
1.18.16 Toll pricing and defining managed lanes 400
1.19 Overview of PTV Vissim files 406
1.19.1 Files with results of traffic flow simulation 406
1.19.2 Files for test mode 408
1.19.3 Files of dynamic assignment 408
1.19.4 Files of the ANM import 411
© PTV GROUP IX
2.15.8 Editing a PT line stop 620
2.15.9 Calculating the public transport dwell time for PT lines and partial PT routes 624
2.15.10 Defining partial PT routes 630
2.15.11 Attributes of PT partial routing decisions 632
2.15.12 Attributes of partial PT routes 632
2.15.13 Generating a railway crossing 633
2.16 Modeling intersection control without SC 636
2.16.1 Modeling priority rules 636
2.16.2 Using conflict areas 656
2.16.3 Modeling stop signs and toll counters 671
2.16.4 Merging lanes and lane reduction 676
2.17 Modeling signal controllers 677
2.17.1 Fixed-time control and traffic-actuated controls with data files 678
2.17.2 Traffic-actuated controls without data files 678
2.17.3 Modeling signal groups and signal heads 679
2.17.4 Modeling 3D traffic signals 685
2.17.5 Using detectors 694
2.17.6 Using signal control procedures 703
2.17.7 Opening and using the SC Editor 746
2.17.8 Linking SC 790
2.17.9 Defining pedestrian crossing 791
2.17.10 Defining ramp metering controllers 792
2.17.11 Modeling railroad block signals 794
2.18 Using static 3D models 795
2.18.1 Defining static 3D models 796
2.18.2 Attributes of static 3D models 797
2.18.3 Editing static 3D models in the Network Editor 798
2.19 Modeling sections 799
2.19.1 Defining sections as a rectangle 800
2.19.2 Defining sections as a polygon 801
2.19.3 Attributes of sections 801
2.20 Using the 3D information signs 803
2.20.1 Defining 3D information signs 804
2.20.2 Positioning 3D information signs 806
2.20.3 Attributes of 3D information signs 806
2.21 Visualizing turn values 808
2.21.1 Configuring turn value visualization 811
2.21.2 Activate turn value visualization 814
2.21.3 Editing the size of turn value visualization for a node 814
2.21.4 Setting active turn value diagrams to the same size 815
3 Methods 816
3.1 Using dynamic assignment 816
3.1.1 Quick start guide Dynamic assignment 817
X © PTV GROUP
3.1.2 Differences between static and dynamic assignment 818
3.1.3 Base for calculating the dynamic assignment 819
3.1.4 Flow diagram dynamic assignment 820
3.1.5 Building an Abstract Network Graph 821
3.1.6 Modeling parking lots and zones 822
3.1.7 Modeling nodes 829
3.1.8 Creating and using edges 841
3.1.9 Modeling traffic demand with origin-destination matrices or trip chain files 846
3.1.10 Simulated travel time and generalized costs 859
3.1.11 Path search and path selection 863
3.1.12 Optional expansion for the dynamic assignment 878
3.1.13 Visualizing volumes on paths as flow bundles 891
3.1.14 Controlling dynamic assignment 896
3.1.15 Correcting demand matrices 912
3.1.16 Defining and performing Matrix correction 913
3.1.17 Generating static routes from assignment 914
3.1.18 Using an assignment from Visum for dynamic assignment 916
3.1.19 Calculating toll using dynamic assignment 921
3.2 Using mesoscopic simulation 923
3.2.1 Quick start guide Mesoscopic simulation 924
3.2.2 Car following model for mesoscopic simulation 925
3.2.3 Mesoscopic node-edge model 927
3.2.4 Node control in mesoscopic simulation 930
3.2.5 Modeling meso network nodes 932
3.2.6 Rules and examples for defining meso network nodes 933
3.2.7 Defining meso network nodes 951
3.2.8 Attributes of meso nodes 953
3.2.9 Attributes of meso edges 955
3.2.10 Attributes of meso turns 957
3.2.11 Attributes of meso turn conflicts 958
3.2.12 Generating meso graphs 960
3.2.13 Using hybrid simulation 961
3.2.14 Selecting sections for hybrid simulation 963
3.2.15 Functional differences to microscopic simulation 963
3.3 Scenario management 964
3.3.1 Basic Elements - Overview 964
3.3.2 Examples of use 966
3.3.3 Managing projects and editing attributes of base networks, scenarios and modi-
fications 967
3.3.4 Editing base networks, scenarios, and modifications in the network editor 967
3.3.5 Numbering network objects 967
3.3.6 Comparing scenarios 967
3.3.7 Calculate multiple scenarios automatically in a row 968
© PTV GROUP XI
3.3.8 Quick start guide Scenario management 968
3.3.9 Using the project explorer 968
3.3.10 Project explorer toolbar 970
3.3.11 Editing the project structure 972
3.3.12 Placing a network under scenario management 979
3.3.13 Add new scenario 980
3.3.14 Add new modification 981
3.3.15 Opening and editing the base network in the network editor 981
3.3.16 Opening and editing scenarios in the network editor 982
3.3.17 Opening and editing modifications in the network editor 983
3.3.18 Exporting base networks or scenarios 983
3.3.19 Comparing scenarios 984
3.3.20 Comparing and transferring networks 987
3.4 Testing logics without traffic flow simulation 989
3.4.1 Setting detector types interactively during a test run 989
3.4.2 Using macros for test runs 991
3.5 Using event based script files 993
3.5.1 Use cases for event-based script files 993
3.5.2 Impact on network files 993
3.5.3 Impact on animations 994
3.5.4 Impact on evaluations 994
3.5.5 Defining scripts 994
3.5.6 Starting a script file manually 995
4 Simulation 997
4.1 Running a simulation 997
4.1.1 Selecting simulation method micro or meso 997
4.1.2 Defining simulation parameters 997
4.1.3 Selecting the number of simulation runs and starting simulation 1003
4.1.4 Showing simulation run data in lists 1004
4.1.5 Displaying vehicles in the network in a list 1004
4.1.6 Showing pedestrians in the network in a list 1018
4.1.7 Reading one or multiple simulation runs additionally 1021
4.1.8 Updating attributes during simulation based on events 1022
4.1.9 Checking the network 1024
4.2 Pedestrian simulation 1026
4.2.1 Movement of pedestrians in the social force model 1026
4.2.2 Version-specific functions of pedestrian simulation 1028
4.2.3 Modeling examples and differences of the pedestrian models 1028
4.2.4 Internal procedure of pedestrian simulation 1032
4.2.5 Parameters for pedestrian simulation 1035
4.2.6 Network objects and base data for the simulation of pedestrians 1041
4.2.7 Using pedestrian types 1043
4.2.8 Using pedestrian classes 1046
© PTV GROUP 15
Important changes compared to previous versions
ANM import: If there are multiple class-specific desired speeds in the ANM file that differ by
less than 0.1 km/h, the network created during import may differ from the network in previous
versions.
Grid cells that are only partially on areas or ramps, or are partially occupied by obstacles,
are no longer considered walkable ground. This can lead to changed simulation results
compared to previous versions.
The detection of grid cells on ramps has been changed. Results of pedestrian grid cell
evaluation on ramps may differ from previous versions.
16 © PTV GROUP
Important changes compared to previous versions
A conflict area affects the vehicle when it leaves its link within the conflict area via a con-
nector.
Faster initialization and higher simulation speed in networks with parking spaces from which
vehicles can reverse out.
© PTV GROUP 17
Important changes compared to previous versions
18 © PTV GROUP
Important changes compared to previous versions
© PTV GROUP 19
Important changes compared to previous versions
20 © PTV GROUP
First steps, quick starts and videos
Quick starts
The Quick start guides show you the most steps you need to consider when using complex Vissim
functions:
Creating a network and starting simulation (see “Quick start guide Creating a network and
starting simulation” on page 23)
Dynamic assignment (see “Quick start guide Dynamic assignment” on page 817)
Mesoscopic simulation (see “Quick start guide Mesoscopic simulation” on page 924)
Scenario management (see “Quick start guide Scenario management” on page 968)
Creating charts (see “Quick start guide Creating a chart” on page 1319)
Defining pedestrians as PT pedestrians (see “Quick start guide: Defining pedestrians as
PT passengers” on page 1157)
© PTV GROUP 21
First steps, quick starts and videos
22 © PTV GROUP
Quick start guide Creating a network and starting simulation
© PTV GROUP 23
Quick start guide Creating a network and starting simulation
18. Entering priority rules for left turning vehicles in conflict at red light and crosswalks (see
“Modeling priority rules” on page 636).
19. Defining dwell time distributions (see “Using time distributions” on page 301). Inserting PT
stops in the network (see “Modeling PT stops” on page 605)
20. Defining PT lines (see “Modeling PT lines” on page 612)
21. Activating evaluations, e.g. travel times, delays, queue counter, measurements (see
“Performing evaluations” on page 1174)
22. Performing simulations (see “Selecting the number of simulation runs and starting simulation”
on page 1003)
24 © PTV GROUP
Typography and conventions
© PTV GROUP 25
Typography and conventions
If you need to use the right mouse button, you are explicitly asked to do so, e.g.:
Right-click in the list.
Tip: In Network editors, by default a right-click opens the shortcut menu. However, you can
choose to have a network object inserted instead. The right-click was used to insert
network objects in versions prior to Vissim 6 (see “Right-click behavior and action after
creating an object” on page 195).
Attribute.xlsx file: Overview of all tables, attributes, enumeration types and relations
By default, a list of all tables, attributes, enumeration types and relations of Vissim is located in the
Vissim installation directory, under ..\Doc\Eng\, in the attribute.xlsx file.
26 © PTV GROUP
1 Basics
1 Basics
Basic knowledge about the field of application, the application possibilities and the basic
functionality of Vissim and Viswalk.
© PTV GROUP 27
1.2 PTV Vissim use cases
Vissim may be deployed to answer various issues. The following use cases represent a few
possible areas of application:
Capacity analysis
Realistically model traffic flows at complex intersection systems
Account for and graphically depict the impact of throngs of arriving traffic, interlacing traffic
flows between intersections, and irregular intergreen times
28 © PTV GROUP
1.3 Traffic flow model and light signal control
© PTV GROUP 29
1.3.1 Operating principles of the car following model
30 © PTV GROUP
1.3.1 Operating principles of the car following model
Legend
Axes: d: Distance, Δv: Change in speed 3: Approaching state
1: "Unregulated behavior” state 4: Braking state
2: Following state 5: Collision state
The car following model has been calibrated through multiple measurements at the Institute of
transport studies of the Karlsruhe Institute of Technology (since 2009 KIT – Karlsruhe Institute of
Technology), Germany. Recent measurements ensure that changes in driving behavior and
technical capabilities of the vehicles are accounted for.
Vissim calculates the acceleration of a vehicle during free traffic flow, below the desired speed,
based on the following:
If the current distance corresponds to the desired safety distance, the vehicle accelerates
to the speed of the preceding vehicle. If the own desired speed is lower, the vehicle accel-
erates to it.
If the distance is between 100 and 110 percent of the desired safety distance, the target
speed is interpolated linearly.
If the desired safety distance is equal to 110 percent, the vehicle accelerates to its desired
speed.
© PTV GROUP 31
1.3.2 Driving states in the traffic flow model according to Wiedemann
For multi-lane roadways a driver in the Vissim model takes into account not only the vehicles
ahead (default: 4 vehicles), but also the vehicles in the two adjacent lanes. In addition, a signal
control for about 100 meters before reaching the stop line leads to increased attention of the
driver.
Vissim simulates the traffic flow by moving driver-vehicle-units through a network. Every driver
with his specific behavior characteristics is assigned to a specific vehicle. As a consequence, the
driving behavior corresponds to the technical capabilities of his vehicle. Attributes characterizing
each driver-vehicle unit can be subdivided into following three categories:
Technical specification of the vehicle, for example:
Vehicle length
Maximum speed
Accelerating power
and:
Actual vehicle position in the network
Actual speed and acceleration
Behavior of driver-vehicle units, for example:
Psycho-physical perception thresholds of the driver, e.g. ability to estimate, perception of
security, willingness to take risk
Driver memory
Acceleration based on current speed and driver’s desired speed
Interdependence of driver-vehicle units, for example:
Reference to vehicles in front and trailing vehicles on own and adjacent lanes
Reference to currently used network segment and next node
Reference to next traffic signal
32 © PTV GROUP
1.4 Overview of add-on modules
Wiedemann's traffic flow model is based on the assumption that there are basically four different
driving states for a driver (see “Traffic flow model and light signal control” on page 29):
Free driving: No influence of preceding vehicles can be observed. In this state, the driver
seeks to reach and maintain his desired speed. In reality, the speed in free driving will vary
due to imperfect throttle control. It will always oscillate around the desired speed.
Approaching: Process of the driver adapting his speed to the lower speed of a preceding
vehicle. While approaching, the driver decelerates, so that there is no difference in speed
once he reaches the desired safety distance.
Following: The driver follows the preceding car without consciously decelerating or accel-
erating. He keeps the safety distance more or less constant. However, again due to imperfect
throttle control, the difference in speed oscillates around zero.
Braking: Driver applies medium to high deceleration rates if distance to the preceding vehicle
falls below the desired safety distance. This can happen if the driver of the preceding vehicle
abruptly changes his speed or the driver of a third vehicle changes lanes to squeeze in
between two vehicles.
For each of the four driving states, acceleration is described as a result of current speed, speed
difference, distance to the preceding vehicle as well as of individual driver and vehicle
characteristics.
Drivers switch from one state to another as soon as they reach a certain threshold that can be
described as a function of speed difference and distance. For instance, small differences in speed
can only be perceived at short distances. Whereas large differences in speed already force
drivers to react at large distances.
The perception of speed differences as well as the desired speed and safety distance kept vary
across the driver population.
The driving state attribute in Vissim does not specify a driving state according to Wiedemann.
The attribute gives a more detailed description of the current driving state of the vehicle in the
simulation on its route through the Vissim network (see “Driving state of a vehicle” on page 1015).
© PTV GROUP 33
1.4.1 General modules
Export 3DS Max: Network data and vehicle positions are exported from Vissim as text files
and can be imported into Autodesk's 3ds Max software (see “Exporting static network data for
3ds Max” on page 473).
The 3D packet contains a script in the Autodesk macro language, as well as numerous vehicle
model information.
Example MAX files for vehicle models are located in the ..\API\3dsMaxExport\MAXModels
directory of your Vissim installation.
BIM Import (see “Importing Building Information Model files” on page 1051)
The BIM Import module converts BIM files (Building Information Model) of the data format IFC
(Industry Foundation Class) into INPX files. These converted INPX files are meant for use in
pedestrian simulation with Viswalk.
Nearly every CAD software supports IFC export and thus provides an interface between the
CAD software and Viswalk. The Importer converts slabs into areas, walls into obstacles and
can import stairways, whilst keeping the level structure. Slabs with curves or holes are
automatically optimized for use in Viswalk during data import.
COM interface (see “Using the COM Interface” on page 1368)
The script interface COM (Component Object Model) allows you to access all network objects
and their attributes in your Vissim network. COM offers the possibility to automate Vissim as
well as an extended functionality for applications beyond the Vissim user interface. In addition,
the COM interface contains event-based scripts which allow the simulation of systems that
react to different states of the simulation and/or influence the simulation through embedded
scripts.
COM supports various programming languages, for example Python, VBS, JavaScript.
A detailed description of the COM interface can be found in the following document: Vissim
<VersionNo> - COM Intro.pdf, in the directory ..\Doc\Eng\ of your Vissim installation.
The COM interface is an API, but it is not part of the API add-on module.
Dynamic assignment (see “Using dynamic assignment” on page 816)
The module Dynamic assignment is used to distribute the vehicles automatically among the
available paths. Only an origin-destination matrix and the parking lots assigned to the zones
must be predefined. It is not necessary to enter static routes manually.
With dynamic assignment, during a series of successive simulation runs, vehicles use a
number of paths that increases with each simulation run. Vissim calculates their average
travel times. Based on this information, Vissim continuously adjusts the distribution of vehicles
on the paths, using vehicle-specific factors such as travel time, path length and costs, for
example toll charges.
You can use parameters to influence the selection of destination parking lots, paths and
iterations. Furthermore, route guidance systems and parking management systems can be
modeled.
34 © PTV GROUP
1.4.1 General modules
Emissions
EnViVer Pro
EnViVer Pro is a tool used to calculate emissions based on vehicle record data. It is based
on the microscopic exhaust and emission model VERSIT+ by TNO. This model is based
on data collected from approx. 2800 vehicles. Their emissions were measured under
different driving conditions. EnViVer Pro imports the Vissim vehicle record and calculates
detailed CO2, NOx and PM10 emissions for an area. The results can be output in a table or
graph.
EnViVer Enterprise
In addition to the functions of EnViVer Pro, EnViVer Enterprise allows for the modeling of
additional vehicle classes, individual time periods as well as automatic processing of
several input files.
Bosch (see “Calculate accurate emissions with Bosch Cloud Service” on page 1180)
Emission calculation based on Bosch emissions data, if the add-on module Emissions is also
available. You can assign an emission class distribution to each vehicle type. When a vehicle
is inserted into the Vissim network during the simulation run, an emission class from the
distribution assigned to its vehicle class is assigned to the vehicle. You can record the results
in evaluations and visualize them on links in the Network Editor.
Landside Demand Generator
Script-based solution for a semi-automatic workflow to convert external flight data (such as
flight schedules, passenger arrival time patterns, etc.) into data that can be used in Vissim to
model and simulate landside road traffic at airport terminals. The demand data obtained this
way is written into an appropriately prepared Vissim network which allows users to simulate
vehicle traffic in airport forecourt area. The demand data is generated from flight plans and
other airport-related data stored in a special Excel workbook. Once the Vissim network is
modeled and configured, changes to flight-related demand no longer need to be made in the
Vissim network. A script updates the data changed by the Demand Model Generator in Vissim
and the Vissim network in a single step.
Managed lanes (see “Toll pricing and defining managed lanes” on page 400)
Allows users to define toll links and toll-free links: Both decision model and price model can be
defined for toll price models.
Mesoscopic simulation (see “Using mesoscopic simulation” on page 923)
The module allows for significantly faster simulation of larger networks compared to
microscopic simulation. The driving behavior is still based on individual vehicles and a
temporal resolution of, e.g., a tenth of a second. The difference is that the individual vehicles
are not looked at with each time step, but only when an event occurs. Such an event could, for
instance, be a vehicle reaching the end of a route and traversing a node, or an SC switching to
green.
The main benefits of mesoscopic simulation are increased simulation speed and less time
required for creating and calibrating the network.
© PTV GROUP 35
1.4.2 Signal controllers (basic)
If an area of the network still needs to be microscopically simulated, including all the details,
hybrid simulation can be used. It allows you to select one or multiple sections for microscopic
simulation, while the rest of the network undergoes mesoscopic simulation.
Synchro Import (see “Importing data from Synchro” on page 457)
Using this module, users can generate Vissim models from Synchro. The network geometry,
volumes, turns, vehicle compositions, and signalization are imported. The module supports
adaptive import. This means changes made in Vissim are not lost when more current versions
of the Synchro model are imported.
PTV Viswalk (see “Pedestrian simulation” on page 1026)
Viswalk Is used for professional pedestrian simulation, either as a stand-alone solution or in
combination with Vissim. The dynamic model is based on the Social Forces Model developed
in 1995, inter alia, by Prof. Dirk Helbing. It allows pedestrians to walk independently to their
destination, without a network model predefining their trajectories.
A simple pedestrian simulation, based on directed routes (instead of areas), is included in
Vissim. It is based on the car following model of Professor Wiedemann, as is the vehicle
simulation. It does not require the Viswalk module.
36 © PTV GROUP
1.4.3 Signal controllers (advanced)
commands for the signal control that become effective in the network. Vice versa, detector
parameters are retrieved from the Vissim network and processed in the logic.
The VAP program logic is described in a text file (*.vap) with a simple programming language.
It can be also be exported from VisVAP. The signal data file (*.pua) can either be comfortably
exported from Vissig or generated manually in a text editor.
The range of application of VAP stretches from controls for individual nodes over PT priorities
to complex control systems for entire corridors or subnetworks. Additionally, applications in
the ITS range, e.g. variable message signs (VMS) or temporary side lane clearances are
readily possible.
VisVAP (see “Graphic display and editing of flow diagrams with VisVAP” on page 742)
Flow chart editor for VAP: VisVAP (short for Visual VAP) is an easy to use tool for defining the
program logic of VAP signal controllers as a flow chart. All VAP commands are listed in a
function library. The export function allows users to generate VAP files, which saves additional
changes to the VAP file. Moreover, VisVAP provides a debug functionality that during a
running simulation in Vissim allows users to go through the control logic step by step using the
control logic. It also shows the current values of all parameters used in the logic. To start
VisVap, from the Start menu, choose > PTV Vision program group.
Balance/Epics (see “Using Balance-Central signal controllers” on page 713)
PTV Balance is a comprehensive and proven adaptive transport network control software
which is fully integrated into Vissim. Used in conjunction with the local adaptive node control
PTV Epics or on its own, it calculates new signal plans for all nodes in the simulation network
every 5 minutes based on the current detector data of the simulation.
The module balance/epics allows you to simulate PTV Balance using Vissim, just like in the
real application. The road network and traffic demand data for PTV Balance are provided by
PTV Visum, which is delivered in a limited version with the module. The signalization related
parameters of PTV Balanceare supplied with an extended version of Vissig. PTV
Balancecomes with a web-based and user-friendly program interface. It allows for a direct
comparison of the calculated traffic parameters with the vehicles simulated in Vissim.
Moreover, this supply does not contain any formatting and can also be used in real network
control projects with PTV Balance.
Epics (see “Using Epics/Balance-Local signal controllers” on page 714)
PTV Epics is a local, adaptive signal control, with a special focus on public transportation. It
can be used instead of a fixed time or VAP signal control. You can simulate it using Vissim.
Every second, the mathematical optimization function in PTV Epics uses current detector data
to calculate the best signal plan for the next 100 seconds. It then transfers this signal plan to
Vissim. All parameters required by PTV Epics are supplied by an extended version of Vissig.
All modes of transport (private, public, pedestrian) are treated similarly, but can be weighted
differently. This makes it particularly easy to implement acceleration in public transport with
PTV Epics.
RBC (see “Add-on module RBC (Ring Barrier Controller)” on page 720)
Ring Barrier Controller Level 3: This module enables PTV Vissim to simulate signal con-
trollers that are controlled according to the North American standard procedure "ring barrier
© PTV GROUP 37
1.4.4 External signal controllers
38 © PTV GROUP
1.4.5 Additional signal controllers
On our website PTV Vissim FAQs. The following information, e.g., is essential:
Entry (#VIS11217): What are the hardware and software requirements for Vissim?
Entry (#VIS19126): Which graphics card has the best performance with Vissim 3D?
© PTV GROUP 39
1.5.2 Main memory recommended
Note: Should any problems arise with the 3D display in Vissim, first install the latest driver
update for your graphics card before you contact PTV Vision Support.
1.5.4 Interfaces
Not all program interfaces are by default part of your Vissim license. They might be available as
add-on modules (see “Programming interfaces (API)” on page 1368). Add-on modules and their
documentation are saved to the directory ..\Vissim 2022\API of your Vissim installation.
40 © PTV GROUP
1.6.1 Information on installation and deinstallation
Ensure that the following system requirements are met (see “Technical information and
requirements” on page 39).
© PTV GROUP 41
1.7 PTV Vision License Management
You can deactivate the recording of diagnostics and usage data (see “Allowing the collection of
usage data” on page 199).
42 © PTV GROUP
1.7.1 Basics of license management
Note: However, two licenses that are completely identical in terms of product, "dongle
number", and firm code may not be activated in one license container. Attention should be
paid to this case especially when licenses are used that can be activated multiple times.
When trying to activate it twice in the same license container, an error message appears.
Each license is defined for one of the license container types and can be activated only on
containers of this type. For example, a license issued for USB dongles cannot be used in a soft
container. Licenses can be subsequently moved between different containers of the same type as
often as required (see “Deactivating a license on your own computer” on page 55) , (see
“Activating a license on your computer” on page 53).
In all three cases, you need the CodeMeter Runtime Kit software to access license containers
and use the licenses. This software is installed by default as part of the product installation.
Note: For license protection reasons, you cannot install soft containers on virtual
machines or borrow on them. This applies to both local systems, such as VMware ESX or
Microsoft Hyper-V, and cloud environments, such as MS Azure or Amazon AWS. This also
affects Mac OS environments that use Windows via virtualization, e.g. Parallel Desktop.
A cloud- based license container is a license storage on a cloud server. Access requires a
certificate. Cloud-based license containers are set up and managed by PTV.
All license container types can be used for single- user licenses and network licenses. The
following table illustrates the properties of the types:
© PTV GROUP 43
1.7.1 Basics of license management
PTV
Vissim
11
PTV
Vistro 7
Can be used for single-user licenses Yes Yes Yes
Can be used for network licenses Yes Yes Yes
Multiple licenses possible in one container Yes Yes Yes
Licenses can be re-hosted (= deactivated and Yes Yes n/a (done by
reinstalled on another computer) PTV)
License container can be moved as a whole Yes No No
Usable on virtual machines Yes No Yes
Requires a permanent Internet connection No No Yes
Can be locked (and replaced) in case of loss Yes Yes n/a
Note: When moving a license to another license container, see the note about matching
licenses in the topic License binding and license container (see “License binding and
license container” on page 42).
In the Web Depot (until version 2020), the license key is also required for license updates and
license returns. In this process, a new key is created for each update and sent to you via email.
Some licenses can be activated multiple times. In this case, you can install the license with the
same license key in different license containers.
44 © PTV GROUP
1.7.1 Basics of license management
You do not need a permanent connection to a license server in this use case. Operation without
an Internet connection is also unlimited.
When single- user licenses are used on server operating systems, simultaneous access by
multiple users is not possible, not even via a remote desktop connection. Select a network license
for parallel access.
© PTV GROUP 45
1.7.1 Basics of license management
Versions
With a license, you acquire the right to use a specific main version (e.g. "PTV Vissim 2021") and
all future service packs for this version. Likewise, you can use older releases as long as they are
still technologically compatible.
With a maintenance contract, you also have the right to use all main versions released during the
maintenance period. This right includes all subsequent service packs for these main versions.
46 © PTV GROUP
1.7.2 Using PTV Vision products without a license
© PTV GROUP 47
1.7.2 Using PTV Vision products without a license
48 © PTV GROUP
1.7.3 License handling for PTV Vision users
You can perform the following actions in the License Management window to control the use of
available product licenses and thus the use of product versions and add-on modules:
Show available licenses in a list
Set the license you want to use at product startup (see “Setting licenses for use” on page 58),
(see “Finding new licenses and removing licenses from the list that are not (no longer) avail-
able” on page 58)
Activate, update, deactivate, search, and remove licenses from the list (see “Activating a
license on your computer” on page 53), (see “Updating licenses on own computer” on page
54), (see “Deactivating a license on your own computer” on page 55)
Use licenses from a license server (see “Using licenses on a license server” on page 55)
Prepare licenses for borrowing (see “Preparing of licenses” on page 72)
Borrow licenses (see “Borrowing a license” on page 57), (see “Returning a borrowed license”
on page 57)
© PTV GROUP 49
1.7.3 License handling for PTV Vision users
Element Description
Settings You can hide and show this section.
Check out automatically, if possible:
50 © PTV GROUP
1.7.3 License handling for PTV Vision users
Deactivate selected license. You can activate this license later again with
the license key (see “Deactivating a license on your own computer” on page
55), (see “Deactivating a license on a license server” on page 72).
Update marked license (see “Updating licenses on own computer” on page
54), (see “Updating a license on a license server” on page 71)
Start search for new licenses on the license servers (see “Finding licenses”
on page 58)
Delete marked licenses from the list (see “Removing licenses from the list
that are not (no longer) available” on page 59)
Note: The arrow symbols are displayed only when you open the License
Management window from within the product.
Arrange marked licenses at the beginning of the list
© PTV GROUP 51
1.7.3 License handling for PTV Vision users
2. Select the desired product for which you want to manage licenses.
3. Select the desired language for the user interface of the License Management window.
4. Click the Start button.
The License Management window opens and you can execute all license management
functions on the computer (see “Using the License Management window” on page 49).
52 © PTV GROUP
1.7.3 License handling for PTV Vision users
starting from Visum 15, Vissim 8, and Vistro 4. You can download the PTV License Manager from
our web page (PTV Vision Setups).
The following icon identifies the PTV License Manager in the Windows Start menu outside the
PTV Vision program group:
Notes:
You need a connection to the Internet.
At least version 7.10 of the "CodeMeter Runtime Kit" program must be installed. By
default, the latest CodeMeter Runtime Kit is installed together with the product.
You can activate a license on your own computer or a different computer (see “Activating a
license on a license server” on page 65).
If you want to use the license management in the product for this purpose, execute the following
steps. You can also activate licenses with the standalone tool PTV License Manager (see
“Managing licenses with the PTV License Manager” on page 52) . You call up PTV License
Manager in the Windows start menu for programs.
© PTV GROUP 53
1.7.3 License handling for PTV Vision users
The license is activated in the selected license container. After that, the license will be available in
the list of licenses in the License Management window.
2. Click the notification or the symbol An update is available for your license.
A selection window opens with the options Update license and Skip.
3. Click Update license.
A window opens showing the license update process.
4. Click the Close button.
5. Restart the PTV Vision product.
Note: Changes to the license are only available after restarting the PTV Vision product.
54 © PTV GROUP
1.7.3 License handling for PTV Vision users
3. Click the Deactivate selected license symbol and confirm the security prompt with
Yes.
4. In the Deactivate licenses window, click the Close button.
The license is deactivated and removed from the list of available licenses in the License
Management window. It can then be activated again with the same license key in another license
container (see “Activating a license on your computer” on page 53) or (see “Activating a license
on a license server” on page 65).
Note: All licenses available locally on your computer will be found automatically. You must
add only other computers or network servers to the server search list.
1. Open the CodeMeter Control Center via the Windows start menu CodeMeter > CodeMeter
Control Center.
2. Click the WebAdmin button.
3. Select the Configuration tab.
© PTV GROUP 55
1.7.3 License handling for PTV Vision users
56 © PTV GROUP
1.7.3 License handling for PTV Vision users
Note: For academic licenses, the borrowing period is limited to a maximum of 180 days.
However, it may be shorter in your case if the license administrator has set a shorter
borrowing period for your activation key.
© PTV GROUP 57
1.7.3 License handling for PTV Vision users
Notes:
If you want to return a Thesis license, only use the standalone tool PTV License Man-
ager (Thesis), which you can start from the Windows Start menu.
You cannot deactivate the main license using the symbol until all borrowed sub-
licenses have been returned.
Note: The use of licenses cannot be specified with the standalone tool PTV License
Manager.
2. In the Settings section, select the Check out automatically, if possible option.
3. Activate the desired licenses in the first column of the list.
4. If necessary, change the order of the licenses with the arrow symbols to the right of the list.
5. Confirm with OK.
The selected licenses can be used if they are available.
When you start the PTV Vision product, it automatically checks whether one of the selected
licenses is available. If multiple licenses are available, the product will check out the highest
license and then start. If no license is available, the License Management window opens.
1.7.3.9 Finding new licenses and removing licenses from the list that are not (no longer)
available
You can check the available licenses in the License Management window. To ensure that the list
displays all available licenses, you can search for usable licenses, for example, after extending
the server search list (see “Adding a license server to the search list” on page 55).
Finding licenses
1. Open the License Management window (see “Managing licenses with the PTV License
Manager” on page 52) or (see “Opening the license management in the product” on page 51).
58 © PTV GROUP
1.7.4 License handling for license administrators
Note: Licenses are added to the list during the search, but no licenses are removed from
the list that are not or no longer accessible.
Removing licenses from the list that are not (no longer) available
You can remove an invalid license from the Licenses list display. This license is not deleted and
not returned. The license will only be removed from the list.
For example, if the computer or license server is temporarily unavailable, you can identify the
unavailable licenses by the red font color and the Unavailable entry in the Status column. The
status updates automatically as soon as a connection to the corresponding computer or license
server is established again.
If you have deleted a still valid license from the display of licenses, you can display it again via a
new search.
1. Select the licenses you want to remove from the list.
© PTV GROUP 59
1.7.4 License handling for license administrators
the required CodeMeter runtime environment is also installed and set up for operation on a
license server.
1. Install the Setup_LicenseManagerServer <version number>x64.exe file, making sure that the
CodeMeter Runtime Kit is also installed.
After installing the License Manager, the CodeMeter Runtime Kit <version number> Setup
window opens.
60 © PTV GROUP
1.7.4 License handling for license administrators
3. Read the End User License Agreement and agree to the terms.
4. Click the Next button.
The Installation Scope window opens.
© PTV GROUP 61
1.7.4 License handling for license administrators
62 © PTV GROUP
1.7.4 License handling for license administrators
© PTV GROUP 63
1.7.4 License handling for license administrators
64 © PTV GROUP
1.7.4 License handling for license administrators
The License Manager for managing licenses on license servers is installed and the server is set
up as a license server.
You can now activate network licenses on the license server (see “Activating a license on a
license server” on page 65).
Tip: If you do not have a connection to the Internet on the license server, please proceed
as described here: (see “Activating a license on a license server without an Internet
connection” on page 65).
Tip: If the license container is a USB dongle, we recommend that you temporarily plug it
into a computer with an Internet connection. Then, on the computer with the Internet
connection, proceed as described on the linked page (see “Activating a license on a
license server” on page 65). After successful activation on a computer with an Internet
connection, the USB dongle is then reconnected to the license server without an Internet
connection.
Only if this procedure is not possible, you have to activate the license file-based.
The file-based license activation process is summarized below and described in detail in the
following sections:
1. Start the license management on the computer with the Internet connection.
© PTV GROUP 65
1.7.4 License handling for license administrators
2. On the license server, create a license request file for the license container where you want to
activate the license (see “Creating a license request file” on page 67).
If necessary, create a soft container on the license server beforehand (see “Creating a soft
container on a license server” on page 70).
3. Transfer the created license request file from the computer with the Internet connection to the
PTV server (see “Uploading the license request file ” on page 68).
4. Get a license activation file on the computer with the Internet connection and transfer the file to
the license server (see “Transferring a license activation file to a license server” on page 68).
5. Create a receipt file on the license server and transfer the file from the computer with the
Internet connection to the PTV server (see “Creating a receipt file on a license server” on page
69).
Prerequisites are:
A current version of the software CodeMeter Runtime Kit is installed on the license server
(see “Setting up a license server” on page 59).
You have access rights to the license server. This can also be done via a remote desktop con-
nection.
You have a computer with an Internet connection to communicate with the PTV server.
A PTV Vision product or the PTV License Manager tool is installed on the computer with the
Internet connection.
1. On the computer with the Internet connection, open the License Management window (see
“Opening the license management in the product” on page 51) or (see “Managing licenses
with the PTV License Manager” on page 52).
2. Copy the desired license key to the clipboard.
66 © PTV GROUP
1.7.4 License handling for license administrators
Notes:
Make sure, that the license container matches the type of license (see “License bind-
ing and license container” on page 42).
If you want to activate a license container of the type soft container, a soft container
must exist on the license server. If this is not the case, you must now create a soft con-
tainer . Then proceed with step (see “On the License tab, select the desired license
container.” on page 67).
© PTV GROUP 67
1.7.4 License handling for license administrators
68 © PTV GROUP
1.7.4 License handling for license administrators
© PTV GROUP 69
1.7.4 License handling for license administrators
70 © PTV GROUP
1.7.4 License handling for license administrators
2. Click the Download template hyperlink and save the file to the license server.
3. On the license server, from the Windows Start menu, choose CodeMeter > CodeMeter
Control Center.
4. Drag and drop the template file SoftContainerCreator.WibuCmLif into the CodeMeter Control
Center window.
An empty soft container is created and displayed with a gray symbol in the list.
5. Continue with Creating a license request file step (see “On the License tab, select the
desired license container.” on page 67).
© PTV GROUP 71
1.7.4 License handling for license administrators
Tip: If you do not have a connection to the Internet on the license server, please proceed in
the same way as for activation without an Internet connection: (see “Activating a license on
a license server without an Internet connection” on page 65).
Tip: If you do not have a connection to the Internet on the license server, please proceed in
the same way as for activation without an Internet connection: (see “Activating a license on
a license server without an Internet connection” on page 65).
1. From the Windows Start menu, select PTV License Manager (Server).
The License Management window opens.
2. Follow the procedure described for deactivating a license on your computer from step (see “In
the Licenses window, mark the license that you want to deactivate. The serial number of the
license container is displayed in the Box column.” on page 55) (see “Deactivating a license on
your own computer” on page 55).
Note:
You can deactivate a network license set up for borrowing only after all borrowing oper-
ations have been completed. Alternatively, as an administrator, you can disable bor-
rowing from this license (see “Preparing of licenses” on page 72). After the maximum
borrowing period has expired, you can deactivate the license without first completing
all borrowing operations.
72 © PTV GROUP
1.7.4 License handling for license administrators
Note: However, the use as a standard network license in conjunction with the following
product versions is only possible with a set password (see steps (see “Click the Manage
button. ” on page 73) to (see “Confirm with OK.” on page 74)).
PTV Visum 18 and 2020
PTV Vissim 18 and 2020
PTV Viswalk 11 and 2020
PTV Vistro 7 and 2020
To be able to borrow from this license and, if necessary, create activation keys for borrowing, you
must prepare the network license for this.
Prerequisites are:
You have the password that was sent together with the license key.
You have an Internet connection.
1. In the Windows Start menu, select PTV License Manager (see “Managing licenses with the
PTV License Manager” on page 52).
2. Select the desired product and click the Start button.
The License Management window opens.
© PTV GROUP 73
1.7.4 License handling for license administrators
74 © PTV GROUP
1.7.4 License handling for license administrators
© PTV GROUP 75
1.7.4 License handling for license administrators
Element Description
Key column Displays the key string of the activation keys created. The activation key is
generated automatically and cannot be changed.
Number of For each activation key, specify how often it can be activated. The number
activations entered here is independent of the number of available licenses. Example: If an
column activation key allows five activations and has already been used five times, it
cannot be used again, even if the activation key was used to borrow a license
and the license has been returned.
Borrowing For each activation key, specify the end date for the borrowing period. By
period until default, the end date of the main license is specified.
column
8. Confirm with OK.
The activation key is created.
9. In the Manage license window, select the activation key.
10. Click the Copy to clipboard button.
11. Paste the copied activation key into an e-mail and send it to the desired recipient.
12. Confirm with OK.
76 © PTV GROUP
1.7.5 Using a Thesis license
7. If necessary, click the Find licenses symbol if no Thesis license is yet displayed in the
license list.
8. Mark the Thesis license.
9. Then click the Borrow license button.
© PTV GROUP 77
1.7.6 License Management – Questions & Answers
12. If necessary, change the borrowing duration, which is limited to a maximum of 180 days.
13. Confirm with OK.
The license is displayed as a separate row, borrowed is displayed in the Type column.
14. Close the License Management window.
15. Start the desired PTV Vision product.
If you are a license administrator and need to access the license server
You need access to the license server for the following use cases:
78 © PTV GROUP
1.8 Properties of the Vissim versions
How do I set up a computer in the network as a license server? (see “Setting up a license
server” on page 59)
How do I manage licenses on a license server without having to use license management in a
PTV Vision product? (see “Managing licenses with the PTV License Manager” on page 52)
How do I activate a license on a license server in the network? (see “Activating a license on a
license server” on page 65)
How do I use a license on a license server? (see “Using licenses on a license server” on page
55)
How do I activate licenses on a server that has no connection to the Internet? (see “Activating
a license on a license server without an Internet connection” on page 65)
How do I deactivate a license? (see “Deactivating a license on a license server” on page 72)
© PTV GROUP 79
1.8.1 Overview of maximum values by version
Student version
Evaluation can be generated.
The Vissim network can be saved.
Thesis license
The network size depends on the license type used.
Classroom license
The Classroom license is only available in the USA. Functionality and restrictions depend on the
license type used.
Academic license
Functionality and restrictions depend on the license type used.
Demo and Student Vissim Junction Vissim Corridor Vissim Advanced and
Viewer (Uni) Professional
Network size not limited 1 km x 1 km not limited not limited not limited
Max. number of signal not limited 10 10 20 not limited
controls update possible update possible
80 © PTV GROUP
1.8.2 Overview of version modules
3dsMax Export
Dynamic
assignment
Emissions optional optional
© PTV GROUP 81
1.8.3 Overview of signal controllers by version
Public transport
Synchro Import USA only USA only USA only USA only
Test mode
(signal control)
3dsMax Export
Bing Maps with maintenance with maintenance with maintenance with maintenance
contract contract contract contract
BIM import
Bosch Emissions
COM interface
Dynamic assignment
Emissions
Driving simulator
Landside Demand
Generator
Managed lanes
facilities
Meso simulation
Public transport
Synchro Import
82 © PTV GROUP
1.8.3 Overview of signal controllers by version
opt. = optional
Demo and Students Vissim Vissim Vissim Vissim
SC type Viewer (Uni) Junction Corridor Advanced Professional
Fixed time
Balance
Epics
VAP
VISSIG
Balance
Epics
External
© PTV GROUP 83
1.8.4 Help, manual and FAQs by version
Fourth Dimension D4
LISA+ OMTC
Mc Cain 2033
RBC
SCATS
SCOOT
Siemens VA
TRENDS
VAP
VISSIG
VS-PLUS
84 © PTV GROUP
1.10 Using the PTV Vissim Simulation Engine
You can download updates in the exe or zip file formats. Setups are downloaded in the zip file
format.
3. In the row of the desired Vissim viewer, click the Download button.
4. Save the downloaded file to your hard disk.
5. If you have downloaded a ZIP file, extract it.
6. Start the setup respectively update program.
The Vissim Viewer is added to the Start menu.
The Archive.zip file downloaded also includes a viewer_readme.txt. This file describes how to
create a CD for your clients that contains this limited Vissim version and your project data.
© PTV GROUP 85
1.11.1 Opening the Examples Demo directory
1.13 Documents
We provide a comprehensive manual to help you quickly become familiar with Vissim and
Viswalk:
The Help and manual describe functions and procedures. The step-by-step instructions
guide you through tasks. The Help and manual are identical in content (see “Showing the
PTV Vissim Help” on page 87), (see “Showing the user manual” on page 86).
Additional documentation is available for further information (see “Additional doc-
umentation” on page 87)
86 © PTV GROUP
1.13.2 Showing the PTV Vissim Help
Opening the PTV Vissim Help and showing the start page
On the Help menu, click > PTV Vissim Help.
© PTV GROUP 87
1.14 Service and support
PTV Vision License Borrowing.pdf: How to manage sublicenses of a Thesis license for Vision
Traffic Suite products
ReleaseNotes_Vissim_<language ID>.pdf: Release notes
VAP - Manual.pdf: User manual for VAP add-on module, which allows you to simulate a freely
programmable, stage based or signal group oriented, traffic-actuated signal control
Vissim 2022 - COM Intro.pdf: Introduction into the Vissim COM interface in English
Using the Component Object Model (COM) interface and scripts, you can access data and
functions in Vissim. By default, the Vissim 2022 - COM.chm file and the COM interface Help
are saved to the directory ..\PTV Vissim 2022.00-00\Exe.
Vissim 2022 - Manual.pdf: User manual, including descriptions of functions, network objects
and attributes.
Vissim 2022 - Installation Manual.pdf: Installation instructions for the current Vissim version
Vissim 2022 - what's new.pdf: Description of the most important changes in Vissim 2021 com-
pared to Vissim 2022
They contain information on changes, bug fixes, and new features available in the Vissim
service packs. You can access the information by keyword search. New service packs are
provided for download on a regular basis on the PTV GROUP website.
VisVAP - Manual.pdf: User manual VisVAP (tool that allows you to display the program logic
as a flow chart)
Notes: The prerequisite for technical support is participation in a basic course for Vision
Traffic Suite.
As our software is continually being improved, we regret being limited when it comes to
providing support for older program versions.
Please understand that the PTV Vision Support cannot replace a training course. PTV Vision
Support can neither impart specialist engineering knowledge which goes beyond the functionality
of the product, for example concerning demand modeling, signal control or project- related
problems. Should you require any help on these subjects, we will be happy to offer you a project-
specific training course.
88 © PTV GROUP
1.14.1 Using the manual, Help and FAQ list
1.14.1.1 FAQs
Here you can find the answers to frequently asked questions about Vissim on our web pages:
PTV Vissim FAQs
Note: For access to the FAQ list you need access to the Internet.
© PTV GROUP 89
1.14.3 Posting a support request
90 © PTV GROUP
1.14.4 Requests to the Traffic customer service
The browser opens and displays the Vissim contact form. The following information is necessary
for the smooth processing of your inquiry:
A description of the problem
The steps which were performed immediately before the problem occurred
If necessary, screenshots of the program states
All files which are necessary for the reproduction of the error
When you open the form in Vissim via the Help menu, the following data is automatically copied
into the form:
If available: PTV dongle no.
PTV customer number
Vissim version and service pack number, e.g. 2022.00-00, as listed in the title bar of the
32- or 64-bit Vissim
Vissim edition
Operating system version and service pack no.
Fill in the remaining fields:
© PTV GROUP 91
1.14.6 Information about the PTV GROUP and contact data
Note: If your Vissim license does not include the Viswalk add-on module, you may still
perform a pedestrian simulation with up to 30 pedestrians.
Version number
The Internet page of PTV GROUP
Copyright details
Note: A good knowledge of Windows is assumed for the operation of the program.
92 © PTV GROUP
1.15.1 Program start and start screen
Tip: For your first steps in Vissim you can use simple example data, which were installed
with Vissim. By default, the example data are stored under:
Users\Public\Public Documents\PTV Vision\PTV Vissim 2022\Examples Demo\
The tutorial Getting Started will help you gain a first insight into working with Vissim. By
default, the tutorial is saved under C:\Users\Public\Public Documents\PTV Vision\PTV
Vissim 2022\Tutorial First Steps
If after the initial start more than one license is found, after you start the program the window
License management - PTV Vissim opens.
1. Select the license of your choice (see “Using the License Management window” on page 49).
Vissim opens. The Start sceen shows information on the program version:
Number of Vissim version
Installation directory
Should Vissim write important messages into the Messages window while importing a network
file, a message is displayed to inform you accordingly. You can open the Messages window
immediately or later on.
© PTV GROUP 93
1.15.2 Starting PTV Vissim via the command prompt
Open immediately: In the window informing you of the messages, click the Open button.
Open later: In the window informing you of the messages, click the Open button. At a later
time of your choice, on the View menu, click > Messages.
When you open a layout or network file that contains attributes of a more recent Vissim version
than the one you are using, you will not be able to read these attributes. The following message is
displayed:
Note: Your user preferences are saved in the Windows registry and in the *.layx layout file
when Vissim is ended. The settings are used automatically when the program is restarted.
94 © PTV GROUP
1.15.2 Starting PTV Vissim via the command prompt
© PTV GROUP 95
1.15.3 Using the Start page
Parameter Description
-s <input file> Batch operation: Vissim starts the simulation and closes after the
end of the simulation. If the network file has not been saved to the
Exe directory,next to the <Input file>, enter the path. -s
must be followed by a space.
-unregserver Deregisters Vissim as a COM server.
An Internet connection is required to make use of the full functionality of the Start page.
When you open a *.inpx network file, the tab with the Start page is closed. The program elements
are then displayed based on the settings saved to the *.layx file.
96 © PTV GROUP
1.15.4 Becoming familiar with the user interface
When on the File menu, you click > New or click the New button , the tab and Start page are
moved to the background and the Network editor is displayed in foreground.
By default, the user interface contains the following elements for viewing, editing, and controlling
the network, data and simulation:
© PTV GROUP 97
1.15.4 Becoming familiar with the user interface
Element Description
(1) Title bar If a network file *.inpx is open: file name of the network file
Program name
Version number
Service pack no.
Opened version: for example Demo, Uni, Viewer, Academic license, Beta
When an Academic license is opened, diagnostic and usage data is
collected. You require an Internet connection. In the License window, in the
Version section, under Product variant Academic License is displayed.
Date of expiry of the license
(2) Menu bar You can call program functions via the menus (see “Overview of menus” on
page 162).
Network files used most recently in Vissim are shown in the File menu. Click on
the entry if you want to open one of these network files.
(3) Toolbars You can call program functions via the toolbars. Lists and network editors have
their own toolbars (see “Using toolbars” on page 177).
(4) Network Show the currently open network in one or more Network Editors. You can edit
Editors the network graphically and customize the view in each Network Editor (see
“Using network editors” on page 113).
(5) Network By default, the network object sidebar, level toolbar and background image
object side- toolbar are shown on individual tabs in a window.
bar Network object sidebar (see “Using the Network object sidebar” on page 100):
Select the Insert mode for network object types
Select visibility for network objects
Select selectability for network objects
Editing graphic parameters for network objects
Show and hide label for network objects
Shortcut menu for additional functions
(6) Levels Select visibility for levels (see “Using the Level toolbar” on page 104)
toolbar
Select editing option for levels
Select visibility for vehicles and pedestrians per level
(7) Back- Select visibility for backgrounds (see “Using the background image toolbar”
ground tool- on page 105)
bar
(8) Project Displays projects, base networks, scenarios and modifications of scenario man-
explorer agement
98 © PTV GROUP
1.15.4 Becoming familiar with the user interface
Element Description
(9) Lists In lists, you show and edit different data, for example, attributes of network
objects. You can open multiple lists and arrange them on the screen (see “Using
lists” on page 132).
(10) Quick Shows attribute values of the currently marked network object. You can change
View attribute values of the marked network objects in the Quick View (see “Using
the Quick View” on page 107).
(11) Smart Shows a small scale overview of the network. The section displayed in the Net-
Map work Editor is shown in the Smart Map by a rectangle or a cross-hair. You can
quickly access a specific network section via the Smart Map (see “Using the
Smart Map” on page 109).
(12) Status Shows the position of the cursor in the Network Editor. Shows the current
bar simulation second during a running simulation.
(13) Vertical Symbols for inserting complex network objects. The vertical toolbar is located on
toolbar the left edge of the network editor.
(14) Short
help Show or hide short help during insertion of complex network objects. The
short help describes the necessary steps when inserting complex network
objects. Images or animated GIF files can provide additional assistance. The
short help opens automatically the first time you select a function from the
vertical toolbar.
© PTV GROUP 99
1.15.5 Using the Network object sidebar
In the following cases, Vissim highlights the input fields with a red triangle and activates the
first input field:
Entry field is mandatory. You must enter a value or string in a valid data format.
Part of the value or string entered is in an invalid data format. For example, for the attribute
No of a link, a number must be entered. Characters are not accepted.
You must fill in all mandatory fields of a window to be able to close it with OK and make the data
available in Vissim.
Point the mouse pointer at the red triangle to open a quick info about the cause of error.
Tip: By default, the network object sidebar, the level toolbar, the 3D information sign
toolbar and the background toolbar are aligned with each other. Using the tabs at the
bottom of a toolbar, you can switch to another toolbar.
(3) Button with the name of the network object type (Insert mode)
Click the button with the name of the network object type to activate the Insert mode. If the Insert
mode is activated, the entire row is highlighted in orange.
You can insert new network objects of this network object type into network editors.
The network objects of this network object type are visible and selectable in all network edit-
ors.
You can switch off visibility and selectability only for the other network object types.
(5) Edit graphic parameters button: Open preview and graphic parameters
This button shows you how network objects of this type are displayed in the Network editor. The
buttons of network object types, displayed differently depending on the attribute values, consist of
several colored bars. Four gray bars indicate that the Display type is activated (see “Defining
display types” on page 393).
Click the button to open a list of graphic parameters of the network object type. In the list, you can
select and edit graphic parameters (see “Editing graphic parameters for network objects” on page
202), (see “List of graphic parameters for network objects” on page 205).
Label is shown
Function Description
Edit graphic Show list of graphic parameters of the network object type (see “Editing
parameters graphic parameters for network objects” on page 202)
Make All Display all network objects of all network object types in the Network editor
Types Visible
Make No Hide all network objects of all network object types in the Network editor
Types Visible
Make All All network objects of all network object types can be selected in the Network
Types Select- editor
able
Make No Not all network objects of all network object types can be selected in the
Types Select- Network editor
able
Selectability Show or hide the Selectability column on the network object sidebar
Column
Label Show or hide the Label column on the network object sidebar
Column
Graphic Para- Show or hide the Graphic parameters column on the network object sidebar
meters
Column
All Object On the network object sidebar, show all network objects types for vehicle and
Types pedestrian simulation
Vehicle On the network object sidebar, only show network object types for vehicle
Object Types simulation and hide network object types for pedestrian simulation
Only
Pedestrian On the network object sidebar, only show network object types for pedestrian
Object Types simulation and hide network object types for vehicle simulation
Only
Tip: By default, the network object sidebar, the level toolbar, the 3D information sign
toolbar and the background toolbar are aligned with each other. Using the tabs at the
bottom of a toolbar, you can switch to another toolbar.
Tip: By default, the network object sidebar, the level toolbar, the 3D information sign
toolbar and the background toolbar are aligned with each other. Using the tabs at the
bottom of a toolbar, you can switch to another toolbar.
Tip: By default, the network object sidebar, the level toolbar, the 3D information sign
toolbar and the background toolbar are aligned with each other. Using the tabs at the
bottom of a toolbar, you can switch to another toolbar.
Tip: The Smart Map and Quick View are displayed in the same section by default. To
switch between the Smart Map and Quick View, use the tabs.
The Quick View opens as a tab. The position depends on how your user interface is set up.
Note: The selection of attributes in the Quick view is saved separately for all objects in a
*.layx file (see “Saving and importing a layout of the user interface” on page 188).
Note: If several network objects with different attribute values are selected, the * symbol
is shown instead of the value of the attribute.
Notes: When entering numerical attribute values with a reference to length, time, speed
and acceleration, you must take the units into account:
If you enter just one digit, the value is interpreted in the format in which the attribute is
displayed. Example: If an attribute is displayed in the minutes format, the value 5 is
read as 5 minutes. You can change the format in the attribute selection window (see
“Selecting attributes and subattributes for columns of a list” on page 152).
You can enter a number with a unit. In this case, Vissim converts the value in such a
way that it is displayed accordingly in the selected format. You can enter length units
either with metrical (m, km) or imperial (ft, mi) units. For example, if an attribute is
shown in the format Minutes, you can enter 2 h. After the confirmation, the value 120
will be displayed.
The new attribute value is shown in all highlighted fields and applied to all objects that were
selected. This also applies to fields in which the symbol * referenced different attribute values.
1.15.10.4 Editing attribute values in the Quick view with arithmetic operations
Make sure that the network objects are selected in the network whose attribute values you want to
edit.
The operation is run for all marked cells with a numerical value. The result is entered as attribute
value.
Warning: If you have selected an alphanumerical cell, the text of the arithmetic
operation is entered in the cell!
Tip: The Smart Map and Quick View are displayed in the same section by default. To
switch between the Smart Map and Quick View, use the tabs.
The Smart Map opens as a tab. The position depends on how your user interface is set up.
Note: If a network is displayed in several Network editors, the Smart Map uses rectangles
to indicate the different views.
Note: If a network is displayed in several Network editors, the Smart Map uses rectangles
to indicate the different views.
Note: Make sure that you choose the desired rectangle in the next steps.
1. In the Smart Map, point the mouse pointer to a position inside the colored rectangle.
Note: If a network is displayed in several Network editors, the Smart Map uses rectangles
to indicate the different views.
Note: If a network is displayed in several Network editors, the Smart Map uses rectangles
to indicate the different views.
Note: If you want to start drawing the rectangle within a rectangle, you also have to hold
down the SHIFT key in the next step.
Tip: Alternatively, you can select Redefine section in the shortcut menu and draw a
rectangle.
Note: If a network is displayed in several Network editors, the Smart Map uses rectangles
to indicate the different views.
Element Description
Default map service Download and display BingMap map
Bing Maps (aerophoto) Download and display BingMap map
PTV Default Standard map of PTV AG showing the geographical context
PTV Gravelpit The map shows more names of places and streets than the PTV
Default map.
PTV Silica Bright map showing the geographical context
Element Description
PTV Blackmarble Dark map showing the geographical context
Disable Background Hide the currently selected live map from the Smart Map
Maps
Note: The display in the network editor is linked to the display in Smart Map (see “Using
the Smart Map” on page 109). If you change the section in the Network editor, the position
of the colored rectangle or cross hairs in Smart Map also changes and vice-versa.
The new Network Editor opens as a tab. The position depends on how your user interface is set
up.
Tip: You switch between open lists and Network Editors with CTRL+TAB.
Selection Functions
Multiple network objects of a Only the standard editing functions that can be carried out
network object type or different when multiple network objects are selected are shown, for
network object types are example:
selected Zoom To Selection
Delete
Duplicate
Copy
Paste
Show In List
Editing functions that are available for a single selected
network object are not displayed.
Only functions specific to the network object type that are
useful when multiple network objects are selected are
shown.
1.15.12.4 Zooming in
To maximize the view, on the toolbar, click the respective button or use the scroll wheel of the
mouse.
Tip: You can also change the Network editor view using the Smart Map (see “Zooming in
or out on the network in the Smart Map” on page 111).
In 2D mode, click the Zoom in button to enlarge the view of a specific section. In 3D mode,
click the Zoom in button to gradually enlarge the view.
Tip: You can also change the Network editor view using the Smart Map (see “Zooming in
or out on the network in the Smart Map” on page 111).
In 2D mode, click the Zoom out button to reduce the view of a specific section. In 3D mode,
click the Zoom out button to gradually reduce the view.
Tip: Alternatively, you can zoom out by gradually. To do so, press the PAGE DOWN key.
On the Network Editor toolbar, click the Show entire network button.
Tip: Alternatively you can also display the entire network by pressing the HOME key.
The Shift mode button is activated: . The mouse pointer becomes a symbol. This
designates the Pan mode.
2. Click any position in the network and keep the left mouse button pressed.
3. Drag the view to the desired position and release the left mouse button.
The view is shifted.
4. In the Network Editor, on the toolbar, click the Shift mode button to deactivate the 'Pan'
mode.
The Shift mode button is deactivated: . The mouse pointer is reset to the standard depiction.
Note: Only the display is shifted, the network itself is not. Coordinates remain unchanged.
When you try to place the measurement point precisely in the middle of a corner point, Vissim
assists you by showing the relevant corner points. In this case, however, the following criteria
must be fulfilled:
On the Network editor toolbar, Measure Distance is selected.
The mouse pointer is close to one or multiple corner points of construction elements.
The construction element is not selected, as then the corner points would already be dis-
played.
When you point the mouse pointer to a corner point, the point is enlarged. This makes it easier
for you to click a point. Vissim sets the measurement point precisely in the middle of the corner
point.
When you point the mouse pointer near the start or end of a link, it jumps to the respective
section. This makes it easier for you to precisely click the beginning or the end of the link.
Direction of measurement
Vissim measures the distance between successive measurement points. For each measurement
point you set, you can change the direction of measurement before setting the next measurement
point. This is not the case when measuring the distance on a route, connector or link. With these
network objects, you can only measure the distance in the direction of travel.
2. Ensure that on the Network editor toolbar, the Measure distance button is selected.
You may perform the next step multiple times and thus measure successive distances
between multiple measurement points:
4. Click the position up to which you want to carry out the measurement.
A yellow line connects the measurement points. The distance between the measurement
points is displayed centered on the line. If you have inserted multiple measurement points, the
distance to the first measurement point is displayed at each measurement point.
With the next step, you stop measuring the distance and hide measurement points, yellow
lines and text boxes.
5. Perform a double-click.
Tip: Alternatively, to stop measuring the distance, press the ESC or ENTER key.
1. In the Network editor, on the toolbar, click the Previous view button.
The previous section is displayed.
Tip: Alternatively, you can change to the previous view with the ALT + LEFT ARROW key.
2. In the Network Editor, click on the icon Next window section in the toolbar.
The next section is displayed.
Tip: Alternatively, you can change to the previous view with the ALT + RIGHT ARROW
key.
1.15.12.12 Selecting network objects in the Network editor and showing them in a list
In the network editor you can select network objects of a particular network object type and show
them, together with their attributes, in a list of network objects with the particular network type.
1. In the Network Editor, right-click the network object of your choice.
2. On the shortcut menu, click Show In List.
The list of defined network objects for the network object type opens.
The objects selected in the Network editor are marked in the list, if the list is synchronized (see
“List toolbar” on page 136).
2. On the Network editor toolbar, click the Network editor layout selection button .
3. Click Add.
4. Overwrite the selected entry with the desired name and click next to it on .
On the toolbar of all Network editors, the new Network editor layout is displayed in the
Network editor layout selection field and can be selected by clicking the button.
1. On the Network editor toolbar, click the Network editor layout selection button .
2. Point the mouse pointer at the name of the Network editor layout whose settings you want to
apply to the Network editor and click.
1. On the Network editor toolbar, click the Network editor layout selection button .
2. Point the mouse pointer at the name of the Network editor layout you want to overwrite.
Buttons for renaming, overwriting and deleting are displayed.
1. On the Network editor toolbar, click the Network editor layout selection button .
2. Point the mouse pointer at the name of the Network editor layout and click next to it on .
Tip: Alternatively, press CTRL+N or on the Edit toolbar, click Simple Network
Display.
The following network objects and their labels are hidden in the Simple Network Display. This is
also the case for network objects of the network object type selected during a simulation run in the
network object sidebar, which allows network objects to be added:
In the Simple Network Display, all other objects are displayed, if you do not individually set them
to invisible:
2. To show the hidden objects again, on the View menu, click > Simple Network Display again.
Tip: Alternatively, press CTRL+Q or on the Edit toolbar, click Quick Mode.
You have the following options to switch off the quick mode:
Auto Hide: hide The window is hidden. A tab with the name of the hidden
window is displayed at the edge of the user interface.
Use Auto Hide to show At the edge of the user interface, point the mouse to the
hidden window again tab of the desired window.
Auto Hide: show per- The window is permanently shown.
manently
Close The window closes.
You can restore the default settings (see “Resetting menus, toolbars, hotkeys, dialog positions”
on page 193).
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
1. Click the title bar of the program element, keep the mouse button held down, and drag the
program element to the position of your choice.
The symbol for anchoring the program element is shown until you drag the program element
out of Vissim.
2. Release the mouse button.
Outside of Vissim, the display of the program element floats freely.
You can restore the default settings (see “Resetting menus, toolbars, hotkeys, dialog positions”
on page 193).
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
1. Click on the title bar or the tab for the window and hold the mouse button pressed.
If you move the mouse, a symbol is displayed, which shows you the possible anchoring
positions:
Element Description
Outer symbols: This anchors the window in the destination area at
one of the four edges.
Symbol in the middle: This anchors the window as a tab.
Note: You cannot anchor all windows with all other windows as a tab. You cannot
anchor network editors and lists with the Quick View, Smart Map, Network object
sidebar, Levels toolbar or the Background toolbar as a tab.
Note: The symbol to which you drag the mouse pointer to is decisive, not the position of
the window.
1. If in a window, you have attached multiple tabs next to each other and want to detach them,
click the title bar and hold down the mouse button.
2. If in a window, you have attached multiple tabs next to each other and want to detach one, click
the tab window and hold down the mouse button.
3. Drag the mouse pointer to the desired area of the desktop and release the mouse button.
The window is released from the anchor.
You can restore the default settings (see “Resetting menus, toolbars, hotkeys, dialog positions”
on page 193).
"Normal" attribute lists contain the attributes of network objects and base data. You can
choose these lists from the Lists menu (see “Opening lists” on page 135): A list contains a
row for each object of the respective type, e.g. for a defined link. There is one column for each
attribute, e.g. name or length of the link. There is also a column for each subattribute, e.g.
time intervals or vehicle classes. "Normal" attribute lists can be extended to coupled lists, if
the network object type has relations to other objects, e.g. a link to lanes (see “Using coupled
lists” on page 160).
To select result lists, on the Lists menu, click > Results or on the Evaluation menu, click >
Result Lists (see “Configuring evaluations of the result attributes for lists” on page 1186): A
results list contains rows for each object of the respective type per time interval of each sim-
ulation run. Moreover, you can show additional rows for static results: the mean, the standard
deviation and minimum and maximum values of all simulation runs. You can further view the
mean, the standard deviation, the minimum and maximum values and total of all time inter-
vals. Only the subattributes Vehicle class or Pedestrian class are shown in the attribute
columns.
Element Description
(1) Title bar Name of list
Close list
(2) Toolbar List layout selection box: Select the name list layout (see “Using named list
layouts” on page 150)
Functions for displaying and editing (see “List toolbar” on page 136)
Relation box: Select relation to the opened list and display data of relations in
the list on the right (see “Using coupled lists” on page 160)
Element Description
(3) Column Short name of attribute
header
Sort, move and mark columns
Functions are available via the shortcut menu (see “Editing lists and data via
the shortcut menu” on page 142)
To open a quick info with an attribute description, point the mouse pointer to
the attribute name in the column header.
Right-click the column header to select the data in the column.
Filter column data to display only data that matches the filter criterion (see “Fil-
tering data of a column” on page 146).
(4) Data Attribute values. Functions are available via the shortcut menu.
If you point to the first column of a list with the cursor, the row number is shown.
(5) Orange Data is selected in one or more cells, rows or columns, and can, for example, be
cells copied or changed.
White cells Values you can change, e.g. of input attributes
In cells for selecting values, the button is shown when you click in the
cell.
For cells that allow the direct entry of values, click the cell and enter the
data.
Gray cells Values of calculated attributes or result attributes. You cannot change them.
(6) Hatched Values of irrelevant attributes with no impact due to the values of other attributes,
cells e.g. a Wiedemann 74 parameter, when for a driving behavior, the type
Wiedemann 99 is selected.
(7) Red, Only for conflict areas (see “Defining the right of way at conflict areas” on page
green, yel- 660)
low cells
(8) Cells For some attributes, in the cells, in list boxes, you can select or add attribute
with list values.
boxes
If you point the cursor to a cell that contains a selection list, the button is dis-
played.
Click the symbol to select attribute values in the list box or click Add to
define a new attribute.
Element Description
(9) Options Some cells of attributes contain a list of options that allows you to select or add
attribute values. Options will be displayed, if the selection of multiple entries is
allowed.
If this option is selected, the entry is considered.
(10) Tab When multiple lists are open, they are shown as tabs. You can thus quickly show
the desired list in the foreground.
Tip: Alternatively you can press CTRL+TAB. You thus switch between open
lists and Network Editors.
If the column width prevents the display of the entire text in a field, Vissim cuts off the text and
indicates the missing text using omission points: "..."
Element Description
Tabs with list names If you open additional lists, these are shown as tabs at the bottom of the
first list.
Network editor For network object types, whose attributes you can only edit in the
network objects list of the respective object type: Double-click the network
object to open the list.
If you open a list with network objects, you activated synchronization in this list, and in the
Network editor, you selected the network objects of the network object type of the list, these
network objects are highlighted in the list.
Tips:
You can open multiple lists and arrange them on the user interface or on multiple
screens.
You can select which attributes are displayed in the list.
1.15.16.3 Selecting network objects in the Network editor and showing them in a list
In the network editor you can select network objects of a particular network object type and show
them, together with their attributes, in a list of network objects with the particular network type.
1. In the Network Editor, right-click the network object of your choice.
2. On the shortcut menu, click Show In List.
The list of defined network objects for the network object type opens.
The objects selected in the Network editor are marked in the list, if the list is synchronized (see
“List toolbar” on page 136).
Set all column fil- If in the list columns are filtered, deactivate the filters to show all
ters passive data in the list again (see “Filtering data of a column” on page
146).
Synchronization Synchronizes list with all network editors, other synchronized lists
and the Quick View. If you select or deselect network objects in
the list, these are also selected or deselected in other windows.
If the Auto pan button is selected in a Network editor, the
selected network objects are shown automatically centered in
this Network editor. If you change the selection of network
objects in a different Network editor or synchronized list, the
section in the Network editor is automatically adjusted to your
selection.
If the Auto zoom button is selected in a Network editor,
the selected network objects are shown centered in this Net-
work editor, and the section is selected large enough to show
all selected network objects. If you change the selection of net-
work objects in a different Network Editor or synchronized list,
Note: In lists, you can use the Attribute selection icon to show and hide attribute
values (see “Selecting attributes and subattributes for columns of a list” on page 152).
Cells, in which you select one or multiple entries from list box .
Notes:
Depending on the cells, network object type or base data you selected, some func-
tions might by grayed out or hidden and thus cannot be used.
Depending on the network object type or base data used, the shortcut menu also con-
tains functions that only allow you to edit specific attributes. These functions are
described under network object types and base data (see “Network objects - over-
view” on page 416), (see “Base data for simulation” on page 253).
Function Description
Add Add a new row with a new object and selects the row. Some attribute values are
set by default. For other attribute values, a window is opened. You can then
change attribute values.
The Add command is not available for all object types.
Edit A window opens that allows you to edit the input attributes of the object.
The Edit function is not available for all object types.
Delete Deletes all objects in the rows selected.
Duplicate Copies the object and its data and inserts a copy of it into a new row. For objects
with a geographic position in the network, the copy lies exactly on the position of
the original.
Create User- Opens the Create User-Defined Attribute window and automatically adopts the
Defined object type of the list (see “Using user-defined attributes” on page 260).
Attribute
Zoom Sets the section in the network editor last active, so that the selected network
objects are all fully displayed.
Create Chart The Create Chart window opens. The network objects selected in the list are
displayed in the Create Chart window.
Note: Make sure that the data and rows copied to the Clipboard match
the data and cells of the list you want to paste the Clipboard content to.
Sort Ascend- Sorts a list by one or multiple columns in ascending order
ing
Sort Des- Sorts a list by one or multiple columns in descending order
cending
Edit A window opens that allows you to edit the input attributes of the object.
The Edit function is not available for all object types.
Delete Deletes all objects in whose rows at least one cell is selected.
Duplicate Copies the object and its data and inserts a copy of it into a new row. For objects
with a geographic position in the network, the copy lies exactly on the position of
the original.
Create User- Opens the Create User-Defined Attribute window and automatically adopts the
Defined object type of the list (see “Using user-defined attributes” on page 260).
Attribute
Function Description
Zoom Sets the section in the network editor last active, so that the selected network
objects are all fully displayed.
Create Chart Create chart for selected attributes
If on the toolbar you selected Synchronization, in the Network Editor, in 2D mode, the network
objects you select in the list are highlighted.
This is also the case for coupled lists, in the list on the right, for instance for the following relations:
At the right edge of the column header, the symbol Filter by data of this column is
displayed.
If your list contains network objects and a network editor is open, in the network editor, the
network objects are selected. In the list, all fields below the column are selected. Next to the
symbol, the filter opens and displays the following elements:
Activate filter: is automatically selected when you choose or enter filter criteria.
Filter criteria: The filter criteria displayed depend on the data type of the column. Suitable
comparison operators, selection options or input fields are displayed for , entered text,
selection fields and numerical values:
Data type of column Filter criteria
Check boxes, for Yes option: Shows data for which is selected in the
example: column of the list. The Yes option is a filter criterion selec-
ted by default, even if the filter has not yet been set to act-
ive. To use the Yes option as a filter criterion and activate
the filter, in the filter, select Activate filter to the left of
Yes option. For example, if in the Links list, for the Is con-
nector column, the Yes option remains selected and you
select the Activate filter next to it, in the Links list, only
the connectors are shown and the links are hidden.
No option: Shows data for which is not selected in the
column of the list. For example, if in the Links list, for the Is
connector column, you select the No option, Activate
filter is automatically selected. In the Links list, then only
links are shown and connectors are hidden.
Entered text The filter criterion consists of a logical operator and entered
characters.
1. In list box of the filter, select the desired logical operator:
Equal to
Not equal to
Begins with
Ends with
Contains
Does not contain
2. Into the text box of the filter, enter the desired characters.
The logical operator compares the characters entered into the
text box with the content in the fields of the column in the list.
The list is filtered accordingly.
When you choose the filter criterion, in the filter, Activate filter is selected.
3. To apply the filter, ensure that in the filter, Activate filter is selected.
After you have chosen filter criteria that allow for a filtering of the data in the list, the filter takes
immediate effect. In the list, only the data that matches the filter criterion is shown. The filter is
thus active. In the column header on the right, the symbol is displayed.
A filter is active if in the filter, Activate filter is selected and the symbol is displayed in the
column header on the right. You can deactivate the filter to show all data in the list that was hidden
based on the filter.
1. In the column of your choice, click the symbol Filter by data of this column.
To the right of the symbol, the filter opens. In the filter, Activate filter is selected.
In the column header on the right, the symbol is hidden. In the list, all data that was hidden
based on the filter of this column is shown again. Additional filters remain active and still hide
data. The previously selected filter criteria of the deactivated filter are saved. This allows you
to apply the filter, with the same filter criteria you chose, to the column again later on. To do so,
in the filter, select Activate filter.
Tip: Alternatively, click the symbol Delete object(s) to delete a selected entry (see “List
toolbar” on page 136).
When you delete network objects, this might affect other network objects, e.g. if they lie on top
of the deleted network objects, are assigned to them or vice versa. A message is displayed for
the first network object affected.
3. When the message is shown, click the desired button:
Button Description
Continue Deletes network object according to the message. Shows the next message.
When you select Do this for all messages, then all network objects are
deleted for which afterwards corresponding messages are displayed.
The window closes.
Skip Does not delete network object according to the message. Shows the next
message.
When you select Do this for all messages, then no more network objects
are deleted.
The window closes.
Cancel Closes the window without deleting any network objects. You can then, e.g.,
assign other network objects to the network objects affected, so that they no
longer have objects assigned to them that you want to delete.
If in a coupled list, you select a row in the left list and delete its data in the right list, the row
selected in the left list remains selected. This makes it easier for you to keep an overview of the
data and allows you to immediately synchronize the data of a row with the network editor (see
“List toolbar” on page 136).
Adjusting Description
an element
Hiding Shortcut menu Remove Column
columns
Showing Symbol Attribute Selection: Opens the window <Name network object
columns type>.
In the list on the left, double-click the desired attribute (see “Selecting
attributes and subattributes for columns of a list” on page 152).
Sorting (see “Sorting lists” on page 146)
columns
Moving Move column header horizontally between the columns you want to move
columns (see “Moving column in list” on page 150).
3. On the Network editor toolbar, click the List layout selection button .
4. Click Add.
5. Overwrite the selected entry with the desired name and click next to it on .
In the toolbar of all lists, the new list layout is displayed in the List layout selection field and
each time the network file is saved (see “Specifying automatic saving of the layout file *.layx” on
page 198).
1. On the Network editor toolbar, click the List layout selection button .
2. Point the mouse pointer at the name of the list layout and click next to it on .
The attribute selection window <Name Network object type>: Select Attributes opens.
On the left side, the search box is displayed at the top: . The field below displays the
attributes and subattributes of the network object type.
You can edit the data in the rows of the list on the right. The changes are accepted in the
columns of the list, when you click OK to close the <Name Network object type>: Select
Attributes window.
The attributes, which you can display as columns in the list, are displayed in an Explorer pane
on the left, in alphabetical order of the attributes' long names. Symbols indicate the properties
of the attributes:
Symbol Description
Circle, green, filled: attribute without subattribute
Circle, green, filled, with two ellipsis points: attribute, for which you must select at
least one subattribute
Ring, green: attribute without subattributes that only has values during a
simulation run
Ring, green with two ellipsis points: attribute for which you must choose at least
one subattribute and that only has values during a simulation run
User-defined attribute
Alias for an attribute that only has a value during a simulation run
Symbol Description
exactly one network object belonging to it in the respective category. You can edit
the indirect attribute if the target object can be edited.
Indirect attribute of a corresponding network object: The network object either has
or does not have a network object belonging to it in the respective category
Indirect attribute of a corresponding network object: The network object has many
corresponding network objects in the respective category. This is summarized
with aggregation functions.
Aggregation function
Scenario comparison <Name Scenario> under attribute Exists in scenario: In
the scenario currently open, network objects of this type have relations to a
scenario selected for comparison whose network has been opened in the
background (see “Comparing scenarios” on page 984).
Scenario comparison <Name Scenario>: Contains attributes, from which you
can select subattributes of scenarios for scenario comparison and add them to the
list (see “Selecting attributes for scenario comparison” on page 985)
2. If desired, filter the displayed subattributes (see “Setting a filter for selection of subattributes
displayed” on page 158).
3. Repeat the following steps for all attributes that you want to show in the list:
4. In the section on the left, select the attributes of your choice:
Select one attribute Click the desired entry.
Select several individual Hold down the CTRL key and click the desired entries one
attributes after another.
Select multiple contiguous Hold down the SHIFT key and click the first and last entry.
attributes
Below the Explorer, the Description field displays the following information for the selected
attribute:
Short name
Source:
Input attribute: The attribute value can be edited
Evaluation: Result attribute obtained from simulation
3. If you do not wish to change the view or the arrangement of the rows in the section on the
right, confirm with OK.
Moves rows down and moves columns in the list to the right
Deletes the rows selected on the right and the corresponding columns of these
attributes from the list.
Systematic sorting: Sort attribute list: The most frequently required attributes are
listed at the top of the list and indirect attributes at the bottom.
Alphanumerical order: Sort the attribute list alphanumerically and in the following
order:
displays attributes that begin with a numerical value at the beginning of the list
under the latter, displays direct attributes in alphabetical order
under the latter, displays indirect attributes in alphabetical order
Attributes at lower levels are also displayed in alphabetical order
Insert user-defined attribute: Open the User-defined attribute window and
define an attribute for the selected network object type (see “Creating user-defined
attributes” on page 261). The user-defined attribute is displayed in the section on
the left.
Filters (see “Setting a filter for selection of subattributes displayed” on page 158)
Edit aliases
In the Explorer, in the attribute list on the left, move your mouse pointer to an entry to insert, edit or
delete an alias (see “Editing aliases in the Attribute selection list” on page 271), (see “Using
aliases for attribute names” on page 269).
Add alias, Edit alias, Delete alias (see “Editing aliases in the Attribute selection list”
on page 271)
runs.
If you want to transfer only certain types of subattributes to the right side, e.g. only for the current
simulation run, you can filter the entries on the left by subattributes. On the left, only the filtered
subattribute types are displayed. From these, you can choose the ones you want to adopt into the
right side. This is particularly useful for the evaluation of result attributes.
Element Description
Simulation Setting filters for the simulation runs performed:
Runs Current run: show only attributes of the current simulation run
Average: arithmetic and thus unweighted average of all simulation runs
Standard deviation between all simulation runs
Minimum of all simulation runs
Maximum of all simulation runs
Number of each simulation run started
Time Inter- Set filter for time intervals:
vals Last completed: Shows last time interval completed of the simulation run
selected
Total: Sum of all time interval values
Maximum of all time intervals
Minimum of all time intervals
Standard deviation between all time intervals
Average: arithmetic and thus unweighted average of all time intervals
x - y: specific, individual time intervals
Vehicle Set filter for all vehicle classes or select vehicle classes. Only those vehicle
Classes classes are displayed that were selected for the collection of separate results
during global configuration of the evaluation (see “Configuring evaluations of
the result attributes for lists” on page 1186).
Pedestrian Set filter for all pedestrian classes or select pedestrian classes. Only those ped-
Classes estrian classes are displayed that were selected for the collection of separate
results during global configuration of the evaluation (see “Configuring eval-
uations of the result attributes for lists” on page 1186).
The display and name of the No active filters button is changed in . Filtered by: <Filter
criterion> Point the mouse pointer to the symbol to display the selected filter criteria in a quick
info.
For the list on the right, you can select one of the network object types or base data types with
relations to the network object type in the left list.
The left hand and right hand lists are linked to each other. If you select an object in the left list, the
right list automatically only shows objects with a relation to the object you selected. If there are no
such relations, only the column title is displayed. In the list, you can also select multiple or all
objects. Then the right list shows all objects that refer to the objects selected in the left list.
You may edit attribute values in both coupled lists, with the exception of calculated attributes and
result attributes.
In the right list, you cannot add or delete objects unless they only exist within the objects in the left
list, e.g. the lanes of a link. Independent objects, to which multiple other objects might refer (e.g.
vehicle types of a vehicle class), can only be added or deleted in their own list or in the Network
editor. To add or delete such a reference, the relevant attribute must be shown in the left list and
changed there.
Using synchronization to select objects from the list in the network editor
Synchronization with the global selection (in network windows and the Quick view) can be
activated in the lists on the left (see “List toolbar” on page 136). If on the toolbar you selected
Synchronization, the network objects you select in the list on the left or right are highlighted in the
Network Editor in 2D mode.
Selecting the network object of an assigned object which itself cannot be selected
The list on the right of a coupled list may also contain objects that cannot be displayed in a
network editor. Vissim can, however, select the corresponding network object to which this object
is assigned in the network editor.
1. Make sure that synchronization is selected for the coupled list (see “List toolbar” on page 136).
2. Select the object in the list on the right.
The selection in the list on the left list is not changed. In the network window, Vissim creates a
black border around the network object to which the object is assigned. The assigned object is the
one that you selected in the list on the right.
Note: Your user preferences are saved in the Windows registry and in the *.layx layout file
when Vissim is ended. The settings are used automatically when the program is restarted.
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
File menu
Menu command / Description
Hotkeys
New If no network has been opened and the tab on the Start page has
been moved to the foreground, the tab is moved to the
background and the network editor is displayed in foreground.
If a network has been opened, it is closed. You can create a new
network.
Edit menu
Menu Description
command
Undo
Undo with name of the last operation performed: discards this oper-
ation
Undo with subordinate menu, if multiple operations can be discarded: dis-
cards all operations, including the one selected
Redo
Redo with name of the last operation undone: performs this operation
again
Redo with subordinate menu, if multiple operations can be redone: performs
all operations undone, including the one selected
Rotate Enter angle around which the network is rotated counterclockwise (see
Network “Rotating the network” on page 475)
Move Enter the distances for the x-axis, y-xis or z-axis by which the network is moved
Network (see “Moving the network” on page 475)
User Prefer- (see “Setting user preferences” on page 191)
ences
View menu
Menu command / Description
Hotkeys
Open New Network Open new Network editor. When a Network editor has been
Editor opened, a new Network editor is added as a tab.
Start page Open start page (see “Using the Start page” on page 96)
Tip: Alternatively, you can show or hide the short help during
the insertion of complex network objects using the Short
help button. The Short help button is located on the right
side of the Network editor toolbar.
Simulation time Switching the simulation time format for the status bar (see
“Specifying the simulation time format for the status bar” on page
190)
Simulation second
Time of day: Time based on start time in the simulation para-
meters. Format [hh:mm:ss,f]
Quick Mode Activate or deactivate Quick Mode (see “Using the Quick Mode” on
CTRL+Q page 128)
Simple Network Display Activate or deactivate Simple Network Display (see “Selecting
CTRL+N simple network display” on page 127)
Lists menu
The menu commands open lists with base data, network objects or result data.
Menu Description
command
Vehicle Combine vehicle types (see “Using vehicle classes” on page 337)
Classes
Driving Beha- Driving behavior parameter sets (see “Defining driving behavior in a driving
viors behavior parameter set” on page 339)
Link Behavior Link behavior types of links, connectors and/or their lanes (see “Defining link
Types behavior types for links and connectors” on page 389)
Pedestrian You can combine pedestrians with similar properties into pedestrian types (see
Types “Using pedestrian types” on page 1043)
Pedestrian Group pedestrian types and combine them into pedestrian classes (see “Using
Classes pedestrian classes” on page 1046)
Walking Beha- Walking behavior parameter sets (see “Modeling area-based walking behavior”
viors on page 1099)
Area Beha- Area behavior types for areas, ramps & stairs (see “Defining area behavior
vior Types types” on page 1102)
Boarding Types of boarding delay for the duration of the boarding of pedestrians of
Delay Types selected pedestrian classes into a public transport vehicle (see “Defining
boarding delay types” on page 392)
Display Display for links, connectors and construction elements in the network (see
Types “Defining display types” on page 393)
Levels Levels for multistory buildings or bridge structures for links (see “Defining
levels” on page 1089)
Time Inter- Time intervals (see “Defining time intervals for a network object type” on page
vals 399)
Traffic menu
Menu Description
command
Vehicle Define and edit vehicle compositions (see “Modeling vehicle compositions” on
Compositions page 537)
Pedestrian Define and edit pedestrian compositions (see “Modeling pedestrian
Compositions compositions” on page 1097)
Pedestrian OD Define pedestrian demand on the basis of OD relations (see “Selecting origins
Matrix and destinations in the Pedestrian OD Matrix” on page 1149)
Dynamic Parameters: Defining parameters for dynamic assignment (see “Attrib-
Assignment utes for the trip chain file, matrices, path file and cost file” on page 896)
Matrices: Opening the Matrices list (see “Matrix attributes” on page 848)
Zones: open the list Zones (see “Modeling parking lots and zones” on
page 822)
OD pairs: Open and display the OD Pairs list, origin zones and des-
tination zones
Menu Description
command
Edges: open the list Edges (see “Attributes of edges” on page 843)
Paths: Open the list Paths (see “Attributes of paths” on page 877)
Read Paths: Import the path file *.weg (see “Attributes of paths” on page
877), (see “Setting volume for paths manually” on page 909)
Write Paths: Save current paths to path file *.weg
Create Static Routing from Assignment: convert the current state of
the dynamic assignment and thus also the paths found and their con-
gestions into a Vissim model with inputs and static routes (see “Gen-
erating static routes from assignment” on page 914)
Calculate PTV Visum Assignment (see “Using an assignment from
Visum for dynamic assignment” on page 916)
Toll Pricing Opens the list Toll Pricing Calculation Models / Elements (see “Defining
Calculation toll pricing calculation models” on page 404)
Models
Managed Opens the list Managed Lanes Facilities / Pricing Models (see “Defining
Lanes managed lane facilities” on page 401)
Facilities
Simulation menu
Menu Description
command /
key
Parameter Enter simulation parameters (see “Selecting simulation method micro or meso”
on page 997), (see “Defining simulation parameters” on page 997), (see
“Selecting the number of simulation runs and starting simulation” on page 1003)
Continuous Starts continuous simulation run or switches from Simulation single step mode
to Simulation continuous mode.
Menu Description
command /
key
F5
Single Step Starts simulation in Simulation single step mode or switches from Simulation
F6 continuous mode to Simulation single step mode or executes the next single
step.
Stop Quit simulation run
ESC
Check net- Check Vissim network for inconsistencies (see “Checking the network” on page
work 1024)
Evaluation menu
Activate and parameterize evaluations (see “Performing evaluations” on page 1174)
Menu Description
command
Configuration Define settings for the evaluation of simulation runs:
Result Management: (see “Managing results” on page 1314)
Define output directory for evaluation files
Result Attributes: Configure data collection in result attributes: (see “Con-
figuring evaluations of the result attributes for lists” on page 1186)
Direct Output: Configure output into files or databases (see “Configuring
evaluations for direct output” on page 1240)
Database Configure the database connection (see “Configuring the database connection
Configuration for evaluations” on page 1241)
Measurement Show lists of network objects for measurements (see “Showing results of
Definition measurements” on page 1313)
Window Configure the display of signal times table, the SC detector record and signal
changes in windows (see “Showing evaluations in windows” on page 1307)
Result Lists Open Result lists of evaluations (see “Showing result attributes in result lists”
on page 1188)
Presentation menu
Create presentation (see “Creating simulation presentations” on page 1340)
Menu command Description
Camera Positions Open list Camera Positions (see “Attributes of camera
positions” on page 1341)
Storyboards Open list Storyboards / Keyframes (see “Using storyboards
and keyframes” on page 1343)
While the animation is running, into the Go to second box, you can enter a simulation time of
your choice. This triggers an update of the Network editor and the result lists to the state of the
simulation, which corresponds to the specified simulation time period. Only aggregated result
attributes are used for visualization.
Animation Recordings Open list Animation Recordings (see “Defining an animation
recording” on page 1351)
Test menu
Perform testing of logic without simulation (see “Testing logics without traffic flow simulation” on
page 989)
Menu Description
command
Continuous Starts continuous test run or switches from Test run single step mode to Test
run continuous mode.
Single Step Starts simulation in Test run single step mode or switches from Test run
continuous mode to Test run single step mode or executes the next single
step.
Stop Quit test run
Record Enabling and disabling macro creation. Enabled: A *.m_i macro file is saved to
Macros the working directory.
Run Macro Select macro file *.m_i, enter simulation second until when you want to run
macro file, then start macro file
Edit Macro Open Macro Editor and edit macro (see “Editing a macro” on page 991)
Actions menu
Using the scripts, you manage script files and define the times at which you want to run the script
files during the simulation (see “Using event based script files” on page 993)
Menu Description
command
Attribute Open the Attribute Modifications list (see “Updating attributes during
modifications simulation based on events” on page 1022)
Event-Based Open list of event-based scripts
Scripts
Run Script File Execute script file (see “Starting a script file manually” on page 995)
Stop Running Stop initiated script file
Script
Help menu
Access to Vissim information and documents such as Help, current Vissim installation
information, service, and contact information (see “Service and support” on page 88). Register
Vissim as COM server.
If during the installation of Vissim , a document was not selected for installation, the menu
command is grayed out and is not available.
Various documents are only available in English. If during the installation of Vissim, you select the
installation of documents for another language, these will still be installed in the ..\Doc in directory
of the selected language.
Menu Description
command
PTV Vissim Opening the Vissim Help (see “Using the manual, Help and FAQ list” on page
Help 89).
COM Help Opens reference documentation of the COM interface located in the ..\exe
directory.
PTV Vissim Opens the user guide in pdf file format that is located in the ..\Doc\<language>
Manual directory.
Introduction Opens an Introduction to the VissimCOM interface Vissim 2022 - COM intro.pdf
to the Vissim in English located in the ..\Doc\<language> directory.
COM API
Open Opens the directory ..\Doc in the language selected under User Preferences >
document General > Language > Main language. All files saved to your computer during
directory the installation process are saved to this directory.
FAQ (Online) Show PTV Vissim FAQs on the web pages of PTV GROUP.
Service Pack Show the PTV Vissim & PTV Viswalk Service Pack Download Area on the
Download webpages of PTV GROUP (see “Services by the PTV GROUP” on page 89).
Technical Show the support form of the Vissim Technical Hotline on the webpages of PTV
Support GROUP (see “Service and support” on page 88).
Examples Readme Examples: Open the file Overview of examples.pdf. The file con-
tains an overview of demo examples and training examples in the file format
*.inpx that can be installed during the installation of Vissim. By default, the
file Overview of examples.pdf is saved to the following path: C:\User-
s\Public\Public Documents\PTV Vision\PTV Vissim 2022
"First Steps" Tutorial: Open the file PTV Vissim - First steps.pdf. The file
contains a tutorial that provides a first insight into Vissim and practical
examples of how to use it. By default, the file is saved to a path similar to the
following: C:\Users\Public\Public Documents\PTV Vision\PTV Vissim
2022\Tutorial First Steps
Open Demo Directory: Open the Windows Explorer and the directory
Examples Demo . The examples in the directories below illustrate typical
use cases of Vissim in subprojects. Each example is explained in *.pdf file.
The *.pdf file is always saved to the same directory as the example.
Open Training Directory: Open the Windows Explorer and show the
Examples Training directory. The examples in the directories below
demonstrate program functions or their combination in an easy to under-
stand context. Each example is explained in *.pdf file. The *.pdf file is always
saved to the same directory as the example.
License Open the License window (see “Showing program and license information” on
page 91).
Menu Description
command
Register Register Vissim as COM server.
COM Server
About Open the Info about PTV Vissim window (see “Showing program and license
PTV Vissim information” on page 91).
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
You can restore the default settings (see “Resetting menus, toolbars, hotkeys, dialog positions”
on page 193).
Changes are saved to the ToolbarLayout.dat file. By default, the file is stored in the directory
..\AppData\Roaming\PTV Vision\PTV Vissim <Version number>. The file is overwritten when you
install a service pack that contains changes to menu items and you open Vissim for the first time.
Note: Your user preferences are saved in the Windows registry and in the *.layx layout file
when Vissim is ended. The settings are used automatically when the program is restarted.
File toolbar
Edit toolbar
Symbol Description
Undo with the name of the last function performed: discards this func-
tion.
Undo with a list box if several functions can be discarded.
Redo with the name of the last function performed: performs this func-
tion again.
Redo with a list box if several functions can be restored.
Time interval after which the display of the current simulation is updated.
Value range: Each 0.1 simulation second (each time step) up to the entire
100 simulation seconds (all 1,000 time steps)
Toggle Quick Mode (see “Using the Quick Mode” on page 128)
Simulation toolbar
Start and stop simulation (see “Running a simulation” on page 997)
Animation toolbar
Start and stop animation (see “Running the animation” on page 1353) This toolbar is hidden in the
default layout.
To show the Animation toolbar, in the shortcut menu, right-click next to the toolbars (see
“Adapting the toolbar” on page 181).
Symbol Name Description
Animation Stops running animation and shows last step before the current sim-
single step ulation second.
reverse
Animation Stops running animation and plays animation in continuous reverse
continuous order.
reverse
Animation When no animation run is started: Opens a window in which you
continuous can select the *.ani file of your choice. Then starts the continuous
animation run.
When the Animation single step mode is started: Lets animation
run continuously.
Test toolbar
Test signal control logic without simulated vehicles (see “Testing logics without traffic flow
simulation” on page 989). This toolbar is hidden in the default layout.
To show the Test toolbar, in the shortcut menu, right-click next to the toolbars (see “Adapting
the toolbar” on page 181).
Symbol Name Description
Test run Starts continuous test run or switches from Test run single step
continuous mode to continuous mode.
Test run Starts simulation in Test run single step mode or switches from Test
single step run continuous to Test run single step mode or executes the next
single step.
Stop test Quit test run
run
View toolbar
If you have opened multiple windows, you can switch between them to place another window in
the foreground (see “Switching between windows” on page 132).
Toolbar in lists
Change list layout and export data (see “List toolbar” on page 136)
1. Click the left edge of the toolbar and keep the mouse button held down.
2. Drag the toolbar to the desired position and release the mouse button.
The toolbar is shown with a title line.
1.15.20.1 Using the mouse buttons, scroll wheel and DEL key
Key Description
Right You can select the function of the right mouse button (see “Right-click behavior and
mouse action after creating an object” on page 195).
button Open context menu: Opens a shortcut menu. Which functions are shown in the
shortcut menu depends on the program element or the list you click on and
whether network objects are highlighted. To insert new network objects, press
CTRL and click. To insert new links, hold down the right mouse button and drag the
mouse.
Insert network object: To insert links and connectors, hold the right mouse but-
ton down and drag the mouse. To open the shortcut menu, press the CTRL key
and right-click.
Left Click in the Network editor to select a network object.
mouse
button Hold the mouse button down and drag the mouse to move an object in the Net-
work editor.
Hold down the CTRL key and the mouse button to create a copy of the object in the
Network editor.
Hold down the ALT key and mouse button to rotate an object in the Network editor.
This function is only available for some network objects, for example for areas or
obstacles.
Double-click a network object in a Network editor to open a window in which you
can change the attributes of the selected network object (if there is such a win-
dow).
Double-clicking in lists:
Edit entry
If you can choose one of several attribute values, an attribute list is opened.
Middle Drag the mouse to move the network section in the Network editor.
mouse In the 3-D mode, press ALT to rotate the network display in the Network editor.
button
Scroll Rotating this changes the network display:
wheel
Rotate down: enlarge (zoom in)
Rotate up: reduce (zoom out)
Hold down the scroll wheel and drag the mouse: moves the network display in the
Network editor.
DEL Deletes all network objects currently selected in the network editor. If this means
that other objects must also be deleted, e.g. objects on a link, a message is dis-
played that you need to confirm before the network objects are deleted.
Removes a selected attribute value from a list, if you are allowed to edit or delete
the attribute.
Removes a network object from a list, if you selected the entire row.
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
TABULATOR Switch between overlapping network objects at the click position and
select the next network object (see “Selecting a network object from
superimposed network objects” on page 440)
CTRL+TABULATOR Switch between open lists and network editors (see “Structure of lists” on
page 133). Shows each of these in the foreground.
F5 Start continuous simulation.
Switch to continuous simulation, if simulation was started in Sim-
ulation single step mode (see “Selecting the number of simulation
runs and starting simulation” on page 1003).
F6 Start the simulation in Simulation single step mode.
Switch to single-step mode simulation, if continuous simulation has
been started.
Perform a single step, if simulation was started in Simulation single
step mode.
ESC Stop simulation (see “Selecting the number of simulation runs and starting
simulation” on page 1003)
ENTER Opens the window with the network object attributes, if a network object
has been selected in the network editor.
SPACE BAR During a simulation in Simulation single step, execute the next step.
Switch to single-step mode simulation, if continuous simulation has
been started (see “Selecting the number of simulation runs and start-
ing simulation” on page 1003).
+ If a continuous simulation has been started, increase the speed of the
simulation.
- If a continuous simulation has been started, reduce the speed of the
simulation.
* Maximum speed of the simulation.
Alternatively, press SHIFT++.
/ During a continuous simulation: Use the same speed as the last
simulation speed set.
Alternatively, press SHIFT+7.
1 Execute simulation in real time, simulation speed = 1.0
POS1 Show entire network (see “Displaying the entire network” on page 121)
PAGE UP Zoom in (see “Zooming in” on page 120)
PAGE DOWN Zoom out (see “Zooming out” on page 121)
Arrow key Move the observer position across the network, in the desired direction
A In 3D mode: Move the current observer position horizontally to the left. If
you additionally press the SHIFT key, the speed is increased.
Alternatively for A, you can press the left arrow key.
Note: Changing program elements or hotkeys can make it more difficult for you to find and
use commands. The documentation and the PTV Vision Support assume that the
standard settings are used.
1. Right-click under the title bar on the empty area next to the menu bar and the toolbar.
2. On the shortcut menu, click Customize.
The Customize window opens.
A message opens confirming the reset. The next time you start Vissim, the respective interface
elements are displayed with their default settings and in their default positions.
Note: Your user preferences are automatically saved in the registry of your computer.
These cannot be selected and imported in Vissim.
Note: Your user preferences are automatically saved in the registry of your computer.
These cannot be selected and imported in Vissim.
You can also save several *.layx files with different settings.
1. On the File menu, click > Save Layout as.
The Save layout file as window opens. By default the path to the opened network file is
selected. The File name box automatically shows the name of the layout file. By default, the
file type *.layx is selected.
2. Enter a unique name.
3. Click the Save button.
The layout is saved in the *.layx file. You can reload the layout (see “Importing the saved user
interface layout” on page 189).
Tip: You can also use a Drag-and-Drop operation to drag the file from the Microsoft
Windows Explorer to the user interface in order to open it.
Area Description
1st section left In 2D mode: Current coordinates of the mouse pointer (global coordinates
x,y in meters)
In 3D mode: fov (fieldOfView) = angle of view (FOV) of camera in
degrees from viewer's position.
2nd section Only during a simulation:
Current second or time of the simulation, followed by current cycle second of
an SC (see “Specifying the simulation time format for the status bar” on page
190)
3rd section Only during a simulation:
Current number of vehicles in the network + current number of pedestrians in
the network
4th section Only during a simulation:
Real time factor of simulation speed
In parentheses: Number of vehicles that could be simulated close to real
time (only if in the simulation parameters, the simulation speed Maximum
is selected)
if multiple simulations are running: Number of the current simulation run
(total of simulation runs) in the simulation parameters.
1.15.22.1 Specifying the simulation time format for the status bar
You can show the simulation seconds or the time.
Tip: As an alternative to the following steps, you can double-click in the status bar during
the simulation run to switch between the simulation seconds display and the time of day
display.
1.15.22.2 Switching the simulation time format for the status bar
During a simulation run, you may switch between the views Simulation Second and Time of Day.
To do so, in the status bar, in the second box, double-click the simulation time.
Specify default short name or long name for column headers (see “Showing short or long
names of attributes in column headers” on page 197)
Select map service of the background map (see “Managing map services of the back-
ground map” on page 197)
For the working environment:
Define the number of functions last performed that are to be saved (see “Configuring com-
mand history” on page 197)
Define automatic saving of the layout file *.layx (see “Specifying automatic saving of the
layout file *.layx” on page 198)
Check network at start of simulation (see “Checking and selecting the network with simulation
start” on page 198)
Define default values for lane width, minimum gap time and minimum clearance (see “Defin-
ing default values” on page 199)
Collect usage data (see “Allowing the collection of usage data” on page 199)
1.16.2 Selecting the country for regional information on the start page
The information on the start page may vary by region (see “Using the Start page” on page 96).
Some of it is available in different languages.
1. On the Edit menu, click > User Preferences.
2. In the navigator tree, choose GUI > General.
3. In the Start page section, select the desired entry in the Country list box.
4. Confirm with OK.