TRAFFIC > MOBILITY > LOGISTICS

VISSIM 5.10-06
COM Interface Manual
Copyright
© PTV AG 2009
Planung Transport Verkehr AG
Stumpfstraße 1
D-76131 Karlsruhe
Germany

All rights reserved.

January 2009
Table of Contents

1 Introduction 7
1.1 Introductory Example 9
1.2 License and Registration 11
1.3 Instances 12
1.4 Conventions 13

2 Object Model 15

3 Language Reference 16
3.1 Base Objects 17
3.1.1 Vissim 17
3.1.2 Net 23
3.2 COM Data Objects 28
3.2.1 WorldPoint 28
3.3 VISSIM Base Data 31
3.3.1 DrivingBehaviorParSets 31
3.3.2 DrivingBehaviorParSet 32
3.3.3 PedTypes 35
3.3.4 PedType 36
3.3.5 PedClasses 38
3.3.6 PedClass 39
3.3.7 PedWalkingBehaviorParSets 41
3.3.8 PedWalkingBehaviorParSet 43
3.4 Network 45
3.4.1 Link-based 45
3.4.1.1 DesiredSpeedDecisions 45
3.4.1.2 DesiredSpeedDecision 46
3.4.1.3 Links 49
3.4.1.4 Link 51
3.4.1.5 Nodes 56
3.4.1.6 Node 59
3.4.1.7 ParkingLots 62
3.4.1.8 ParkingLot 63
3.4.1.9 ReducedSpeedAreas 65
3.4.1.10 ReducedSpeedArea 67
3.4.2 Area-based (Pedestrians) 70
3.4.2.1 PedAreas 70
3.4.2.2 PedArea 72

VISSIM 5.10-06 © PTV AG 2009 3

Table of Contents

3.4.3 PedAreaBehaviorTypes 74
3.4.4 PedAreaBehaviorType 75
3.5 Traffic 78
3.5.1 Vehicles 78
3.5.1.1 Vehicles 78
3.5.1.2 Vehicle 84
3.5.2 Private Traffic 88
3.5.2.1 Routes 88
3.5.2.2 Route 90
3.5.2.3 RoutingDecisions 92
3.5.2.4 RoutingDecision 95
3.5.2.5 TrafficCompositions 99
3.5.2.6 TrafficComposition 100
3.5.2.7 VehicleInputs 103
3.5.2.8 VehicleInput 105
3.5.3 Transit 107
3.5.3.1 TransitLines 107
3.5.3.2 TransitLine 109
3.5.3.3 TransitStops 111
3.5.3.4 TransitStop 113
3.5.4 Pedestrians 115
3.5.4.1 PedPedestrians 115
3.5.4.2 PedPedestrian 117
3.5.4.3 PedInputs 119
3.5.4.4 PedInput 120
3.5.4.5 PedRoutes 122
3.5.4.6 PedRoute 124
3.5.4.7 PedRoutingDecisions 126
3.5.4.8 PedRoutingDecision 128
3.5.5 Dynamic Assignment 132
3.5.5.1 DynamicAssignment 132
3.5.5.2 Paths 136
3.5.5.3 Path 140
3.6 Intersection Control 142
3.6.1 Non-signalized 142
3.6.1.1 StopSigns 142
3.6.1.2 StopSign 143
3.6.2 Signal Control 146
3.6.2.1 Detectors 146
3.6.2.2 Detector 147
3.6.2.3 PTCallingPoints 150
3.6.2.4 SignalControllers 152
3.6.2.5 SignalController 153
3.6.2.6 SignalGroups 156
3.6.2.7 SignalGroup 158
3.6.2.8 SignalHeads 161
3.6.2.9 SignalHead 162

4 VISSIM 5.10-06 © PTV AG 2009

 Table of Contents

3.7 Simulation & Test 165

3.7.1 Simulation 165
3.8 Graphics & Presentation 173
3.8.1 Graphics 173
3.8.2 Presentation 176
3.8.3 StaticObjects 178
3.8.4 StaticObject 180
3.9 Results 182
3.9.1 Evaluation 182
3.9.2 AnalyzerEvaluation 185
3.9.3 DataCollections 186
3.9.4 DataCollection 189
3.9.5 DataCollectionEvaluation 192
3.9.6 Delays 193
3.9.7 Delay 195
3.9.8 DelayEvaluation 197
3.9.9 LinkEvaluation 199
3.9.10 NodeEvaluation 201
3.9.11 QueueCounters 203
3.9.12 QueueCounter 204
3.9.13 QueueCounterEvaluation 207
3.9.14 TravelTimes 208
3.9.15 TravelTime 210
3.9.16 TravelTimeEvaluation 212
3.9.17 PedTravelTimes 213
3.9.18 PedTravelTime 215
3.9.19 PedTravelTimeEvaluation 217
3.9.20 PedDataCollectionEvaluation 218
3.9.21 PedProtocolEvaluation 219
3.10 Triggered Scripting 221
3.10.1 TriggeredScripting 221
3.10.2 ManagedLanesTollCalculation 221

4 COM Access 223

4.1 Visual Basic 224
4.1.1 Creation of a Visual Basic Client 224
4.1.2 Collections (Different Ways to Enumerate) 225
4.1.3 Arrays 226
4.1.4 Error Handling 227
4.1.5 A Visual Basic Client Example 227
4.1.6 Advanced Issues Using Visual Basic 228

COM Interface Manual © PTV AG 2009 5

Table of Contents

4.2 Visual C++ 231

4.2.1 Creation of a VC++ Client 231
4.2.2 Collections (Different Ways to Enumerate) 233
4.2.3 Arrays 233
4.2.4 Error Handling 234
4.2.5 A Visual C++ Client Example 235
4.3 .NET 237
4.3.1 Creation of a Client Using Visual Studio .NET 237
4.3.2 Arrays 240
4.3.3 Events 240
4.3.4 Error Handling 240
4.4 Java 243
4.4.1 Creation of a COM Wrapper 243
4.4.2 Creation of a Java client 243
4.5 Delphi 245
4.5.1 Creation of a Client Using Delphi 2006 245

5 Remote COM Access 249

6 Annexes 251
6.1 Error Messages 252
6.2 Warning Messages 258
6.3 Tips and Hints 259
6.4 Registry 260

6 VISSIM 5.10-06 © PTV AG 2009

1 Introduction

VISSIM can be applied as a powerful tool in analysis of a huge variety of

transportation problems. Occasionally projects will require extensive pre- or
post-processing or numerous scenarios to be investigated. For these cases
VISSIM can be run from within other applications serving as a toolbox for
transportation planning algorithms. Access to model data and simulations is
provided through a COM interface, which allows VISSIM to work as an
Automation Server and to export the objects, methods and properties
described in this document. The VISSIM COM interface supports Microsoft
Automation, so you can use any of the RAD (Rapid Application
Development) tools ranging from scripting languages like Visual Basic Script
or Java Script to programming environments like Visual C++ or Visual J++.
The examples presented in this manual are mainly in Visual Basic, see page
213 for a little introduction. You will also find a short introduction on how to
use it with Visual C++ on page 231.
An introductory Visual Basic example will illustrate the flexibility of this
approach. Assume that we want to run several simulations with different
random seeds and get their respective link evaluations. You can use Excel
and VBA (Visual Basic for Applications) to load the network, set the different
random seeds and start the process. For example, if you want to use the
network “fixed_time.inp” and to run four simulations with the random seeds
10, 20, 30 and 42 you can edit the following Excel sheet:
random seed simulation file
10 G:\PTV\DATA\FIXED_TIME.INP
20
30
42

You can also insert a button “START” (from the

toolbox) to link with the Visual Basic code presented Start
at the end of this section:
To get the link evaluations by running the Excel macro you have to create a
*.SAK file within the same directory beforehand. You may use the VISSIM
Link Evaluation Dialog (or the LinkEvaluation interface) for this purpose:

VISSIM 5.10-06 © PTV AG 2009 7

1 Introduction

It is also necessary to check the box for the link evaluations in the
Evaluations Æ Files Dialog and to save the options in a *.INI file, for example
LINK_EVAL.INI, with SAVE AS… from the View menu.

8 VISSIM 5.10-06 © PTV AG 2009

 Introductory Example

1.1 Introductory Example

We will now present the Visual Basic code that will run four simulations,
accessing the Excel sheet to get the network file name and the respective
random seeds. The code is defined in a procedure called
RandomSeed2VISSIM that must be called from the “OnClick” command of
the START button in the Excel sheet. The lines starting with an apostrophe
mark (‘) are comments that explain the code lines or parts.
SUB RandomSeed2VISSIM()
' Declare VISSIM COM types for a Vissim and a Simulation object
DIM Vissim AS Vissim
DIM Simulation AS Simulation
' Declare further types
DIM SimulationFile AS String ‘ Name of the network file (with the full path)
DIM RandomSeed AS Integer ‘ Current random seed
DIM RunIndex AS Integer ‘ Simulation running index
' Start Vissim and create an instance of a Vissim object and a Simulation object
SET Vissim = CreateObject("VISSIM.Vissim")
SET Simulation = Vissim.Simulation
‘ Get the network file name
Sheets("VISSIM").Select ‘ Select the example sheet named VISSIM
Range("C2").Select ‘ Select the cell with the network file name
SimulationFile = Selection.Value ‘ Get the network file name
' Load the network and the *.ini file
Vissim.LoadNet SimulationFile
Vissim.LoadLayout "link_eval.ini"
' Initialize simulation values
Simulation.Period = 100 ‘ 100 second simulations
Simulation.Resolution = 1 ‘ 1 step per second resolution
RunIndex = 0 ‘ Simulation running index initialization
' Loop of simulation runs
Range("A2").Select ‘ Select the first random seed cell
WHILE Selection <> "" ‘ Run until no more random seeds are available
‘ Get current random seed from the current selected cell
RandomSeed = Selection.Value
‘ Set simulation parameters for next simulation
Simulation.RunIndex = RunIndex ‘ Set the simulation run index
Simulation.Comment = "Random Seed = " & RandomSeed ‘ Set simulation comment
Simulation.RandomSeed = RandomSeed ‘ Set random seed
‘ Run simulation continuously
Simulation.RunContinuous
‘ Initilize next simulation values
ActiveCell.Offset(1, 0).Select ‘ Select the next random seed cell
RunIndex = RunIndex + 1 ‘ Next simulation running index
WEND
END SUB
After the creation of a VISSIM object the code demonstrates how to obtain
references to other VISSIM data objects (in this case a Simulation object)
and how to access their properties and methods.
In a similar way it is possible to use the Visual Basic programming
environment to create a desktop application to control simulation runs having
access not only to the random seeds but also to the other simulation
parameters.

COM Interface Manual © PTV AG 2009 9

1 Introduction

It is necessary that VISSIM has been registered to the Windows system

before it can be started automatically from a COM client. You can do this
registration manually (see page 11) or simply by starting VISSIM once which
will cause the program to register itself. Furthermore a reference to the
VISSIM COM Library can be set within the programming environment to help
code editing and improve performance by early binding. In Excel’s Basic
Editor this can be done from the EXTRAS menu REFERENCES….

When using early binding (refer to page 228 for more information) a
reference to the VISSIM COM server type library must be set within the VB
programming environment. This can cause some conflicts when installing
newer versions of VISSIM, which could have modified the type library.
Unselecting and selecting again the reference to the VISSIM COM server
forces VB to reinterpret the type library. Please refer to the annex "Tips and
hints" on page 259 for more details about VISSIM versions and its COM
server interface

10 VISSIM 5.10-06 © PTV AG 2009

 License and Registration

1.2 License and Registration

The appropriate VISSIM license is necessary to use the VISSIM COM
server. This license actives the self registering procedure of all COM
interfaces, which will be called automatically when VISSIM is installed, and
allows the instantiation and use of the VISSIM COM objects from other
programs or development environments, like Visual Basic or Visual C++.
A manual registration of the COM Server is also possible using the following
parameters from the command line:
VISSIM -RegServer
VISSIM -UnregServer

In the case of using a Vista operative system, please use de item “Register
COM Server” on the Windows start menu, in order to get the required
administrator rights.

Calling VISSIM with one of this two

parameters doesn’t start the main
VISSIM window. It registers /
unregisters silently the VISSIM COM
Server and its interfaces. A dialog
message will show up with an error
message if the
registration/unregistration failed
(detailed error information is also
written to the VISSIM.ERR file in this
case):
Please refer to the annex for more information about the necessary Registry
entries to use VISSIM as a COM server.

COM Interface Manual © PTV AG 2009 11

1 Introduction

1.3 Instances
Surely you are used to working with several instances of VISSIM by simply
starting the program several times. When working with COM applications
VISSIM’s behavior is exactly specified as follows:

► If there are one or more running instances of VISSIM, a COM application

connects to the first started VISSIM instance.
► If there is no instance running, creating a COM object automatically
invokes a new instance of VISSIM (see page 16 on how to create a
Vissim object).
► By default each VISSIM instance can be used as server for only one
COM application. If more COM applications are started later each of
them opens a new VISSIM instance. Use the Automation mode (see
below) to grant that two ore more COM programs do not access the
same VISSIM instance simultaneously.

In some cases it may be useful to allow one VISSIM instance to be the

server for several COM programs. You can control VISSIM behavior using
these parameters:

► Embedded: with this parameter you start a VISSIM instance which will
behave exactly as described above (default behavior). A VISSIM
instance can be used as server for only one COM application.
Additionally the instance will be closed automatically if the COM-object
has been released, explicitly or by ending the COM client.
► Automation: with this parameter each VISSIM instance serves all COM
applications until it is closed manually or explicitly from the COM client.

While a client is connected to the instance no other COM applications

should be started. Automation servers are only useful if you don't want to
run several COM applications simultaneously.

It is possible instanciate a concrete version of VISSIM if several VISSIM

versions are installed on your computer. Please refer to the Vissim object
chapter on page 16 for this purpose)

12 VISSIM 5.10-06 © PTV AG 2009

 Conventions

1.4 Conventions
This manual follows an uniform pattern for the description of the objects and
interface. Nevertheless some conventions should be taken in account before
reading this manual:
► Object Model
The name of objects representing single entities or elements in VISSIM
are singular, like Vissim, Net, Simulation, Link, SignalHead, ... and the
name of the objects representing a set (collections, lists, arrays) of other
objects are in plural, like Links, SignalHeads, ... .
► Description of properties and methods:
The full signature with a description and examples is presented for each
property and method of every interface, making it self-explaining. The
following notation is used for the attributes and type of the parameters:
[in] : input parameter
[out, retval] : output parameter
unsigned char : A 8-bit integer type (0 to 255)
long : A 32-bit integer type (-2,147,483,648 to 2,147,483,647)
double: A 64-bits floating point type (-1.7E308 to 1.7E308)
BSTR: A 16-bit string type
VARIANT: A data type capable of representing various different types.
IObjekt: The interface of a VISSIM COM object; for example ILink
Reference types (pointer types or simply pointers) are marked with an
asterisk (*) operator. A reference type is one that points (refers) to one
specific instance of a type. For example long*, ILink*, VARIANT*.

See a description of the IDL (Interface Definition Language) for more

details.

No int type is being used in the interfaces, because of the language

mapping to long in Visual Basic and because of the change in size across
different platforms.

Visual Basic examples:

All examples in this manual are written in the Visual Basic (with the
exception of a C++ section on page 231). The language keywords are
written in capital keys, for example DIM, SET, FOR EACH … NEXT, … . See
a program example on the section below.

COM Interface Manual © PTV AG 2009 13

2 Object Model

The VISSIM COM object model is based on a strict object hierarchy. To

access the different lower-level objects, e.g. a Link object of a Net object,
you have to follow this hierarchy. Vissim is the highest object; all other
objects belong to Vissim. The following figure illustrates some of the object
instantiation dependences (page 15).
Collections are a special object type; they serve as a container for single
objects and are used to enumerate network elements. As a rule their name
is in plural. Two examples are the objects Links and Vehicles. Visual Basic
provides a special language element For Each ... Next to iterate through a
collection; see page 225 for more details.

Model Overview

V issim

N et

Links Link

N odes N ode

P arkingLots P arkingLot

P aths P ath

D rivingB ehaviorP arS ets D rivingB ehaviorP arS et

TrafficC om positions TrafficC om position

V ehicleInputs V ehicleInput

V ehicles V ehicle

R outingD ecisions R outingD ecision

R outes R oute

D esiredS peedD ecisions DesiredS peedDecision

R educedS peedA reas R educedS peedA reas

S topS igns S topS ign

S taticO bjects S taticO bject

S ignalC ontrollers S ignalC ontroller

D etectors D etector

S ignalG roups S ignalG roup

S ignalH eads S ignalHead

VISSIM 5.10-06 © PTV AG 2009 15

3 Language Reference

3 Language Reference

16 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

3.1 Base Objects

3.1.1 Vissim
Vissim is the highest object of the model; Vissim
all other objects belong to Vissim and can
only be instantiated through the IVissim Net
interface. With the creation of a Vissim
object the COM-Applications gains access Simulation
to the first VISSIM instance running or,
without any instance present, a new
instance is started (see page 12).
The interface IVissim allows, besides other things, to load networks and to
create second level objects like Net or Simulation.
Examples
► Creation of a Vissim Object:
DIM vissim AS Vissim
SET vissim = NEW Vissim
- Alternatively, the CreateObject function (specific of VBScript) can be
used with the identifier string for the Vissim object
“VISSIM.Vissim.500”, allowing the instantiation of concrete VISSIM
versions. VISSIM stands for VISSIM-COMServer, Vissim for the
Vissim class object and 500 for the VISSIM version:
SET vissim = CreateObject ("VISSIM.Vissim.500")
- If you have installed and registered an earlier version of VISSIM 4.20
use the string “VISSIM.Vissim.1” to instanciate it. If you obviate the
version number the newest registered version will be instanciated:
SET vissim = CreateObject ("VISSIM.Vissim")

Please refer to the Visual Basic issues on page 228 for more concrete
information about the difference between NEW and CreateObject
► Deletion of a Vissim Object
In Visual Basic and VBScript an object is deleted by assigning the
language keyword “Nothing”:
SET vissim = NOTHING
In this case, if the Automation mode is being used, the VISSIM
application itself won’t be closed (compare to the method Exit below). In
Embedded mode has the same effect as calling vissim.Exit().

Depending on the used client environment (for example Visual Basic

Scripting or Excel) the working directory of VISSIM can be set to the
system directory. If a vissim.ini file exists in this directory it is used for the
initialization (of window position, view and evaluation settings).

COM Interface Manual © PTV AG 2009 17

3 Language Reference

Properties of the IVissim Interface

Net ([out, retval] INet **ppNet)

Instantiates a Net object, that gives access to the network functionality (see
page 23).
Parameters
[out, retval] INet **ppNet: returned Net object
Example
DIM net AS Net
SET net = vissim.Net

Simulation ([out, retval] ISimulation **ppSimulation)

Instantiates a Simulation object, that gives access to the simulation
functionality (see page 165).
Parameters
[out, retval] ISimulation **ppSimulation: returned Simulation object
Example
DIM simulation AS Simulation
SET simulation = vissim.Simulation

Graphics ([out, retval] IGraphics **ppGraphics)

Instantiates a Graphics object, that gives access to the graphics options (see
page 173).
Parameters
[out, retval] IGraphics **ppGraphics : returned Graphics object
Example
DIM graphics AS Graphics
SET graphics = vissim.Graphics

Evaluation ([out, retval] IEvaluation **ppEvaluation)

Instantiates an Evaluation object, that gives access to the evaluation options
(see page 182).
Parameters
[out, retval] IEvaluation **ppEvaluation : returned Evaluation object
Example
DIM evaluation AS Evaluation
SET evaluation = vissim. Evaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a VISSIM general option. Please get the language independent
attribute tags from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

18 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

Example
distance_unit1 = vissim.AttValue(„UNITDISTANCE1“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a VISSIM general option. Please get the language independent
attribute tags from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Value : new attribute value. (type according to the attribute)
Example
vissim.AttValue(„UNITDISTANCE1“) = 1 ‘in feet

Attribute outline :

R W Attribute Description
9 9 MENU Enable/Disable the main menu.
9 REVISION VISSIM revision number in text format.
9 9 TOOLBAR Enable/Disable all toolbars except Zoom
(File, Selection, Run Control, Network
Elements, Animation, Test, and Simulation).
9 VERSION VISSIM version in text format.
9 9 UNITDISTANCE1 0 = [m], 1 = [ft]
9 9 UNITDISTANCE2 0 = [km], 1 = [mi]
9 9 UNITSPEED 0 = [km/h], 1 = [mph]
9 9 UNITACCEL 0 = [m/s²], 1 = [ft/s²]

Methods of the IVissim Interface

New ()
Creates a new empty network.
Example
SET vissim = NEW Vissim
vissim.New

LoadNet ([in, defaultvalue(“”)] BSTR NetPath, [in, defaultvalue(0)] BYTE

Additive)
Loads the VISSIM network specified within the string NetPath.
Parameters
[in] BSTR NetPath : path + filename (*.inp) of the network file to be loaded. This
parameter is optional. If no path is passed a browser file dialog will show up.

COM Interface Manual © PTV AG 2009 19

3 Language Reference

[in] BYTE Additve : if the value is different than 0 the file will be read additionally.
This parameter is optional with 0 as default value (non additive reading form).
Example
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\data\example.inp”
vissim.LoadNet “c:\vissim\data\example_bis.inp”, 1 ‘read additionally

SaveNet ()
Saves the network under the same name.
Example
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\data\example.inp”
vissim.SaveNet

SaveNetAs ([in, defaultvalue(“”)] BSTR NetPath)

Saves the network under the name specified in the string NetPath
Parameters
[in] BSTR NetPath : path + filename (*.inp) where the network will be saved. If an empty
or no path is passed a browser file dialog will show up.
Example
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\data\example.inp”
vissim.SaveNetAs “c:\vissim\data\example_bis.inp”

ImportANM ([in, defaultvalue(“”)] BSTR NetPath, [in, defaultvalue(“”)]

BSTR RoutesPath, [in, defaultvalue(“”)] BSTR InputPath, [in,
defaultvalue(ImportInitial)] ImportType ImportType, [in,
defaultvalue(0xFF)] int importOptions, [in, defaultvalue(600)] int
evaluationInterval)
Imports a network in ANM format initially or adaptively.
Parameters
[in] BSTR NetPath : path + filename (*.anm) of the network file to be loaded.
[in] BSTR RoutesPath : path + filename (*.anmRoutes) of the routing file to be loaded.
[in] BSTR InputPath : path + filename (*.inp) of the input file, where the import result
should be saved. This parameter is required, if adaptive reading in a future import should
be possible or routing informations for a dynamic assignment should be created.
[in] ImportType ImportType : Whether the import should be done initially or adaptively.
[in] int importOptions : Further import options.
[in] int evaluationInterval) : The evaluation interval. This is required, if routing
informations for dynamic assignment should be imported.
Example
SET vissim = NEW Vissim
vissim.ImportANM “c:\vissim\data\example.anm”, “c:\vissim\data\example.anmRoutes”,
“c:\vissim\data\example.inp”, ImportInitial, ImportForDynAssign, 900

20 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

importType outline :

Attribute Description
ImportInitial Initial import
ImportAdditive Adaptive import without removing obsolete obects
ImportDifference Adaptive import with removing obsolete obects

importOptions outline :

Attribute Description
ImportForDynAssign Import routing informations for dynamic
assignment
ImportNodeRoutes Import routing informations for node routes
ImportForceRoutingImport Import routing information, although no
changes are made to the *.anmRoutes file

LoadLayout ([in, defaultvalue(“”)] BSTR LayoutPath)

Loads a VISSIM layout file (*.INI) specified in the string LayoutPath. If no or
an empty LayoutPath parameter is given the browser file dialog appears.
Parameters
[in] BSTR LayoutPath : path + filename (*.ini) of the layout file to be read
Example
SET vissim = NEW Vissim
vissim.LoadLayout “c:\vissim\data\example.ini”

SaveLayout ([in, defaultvalue(“”)] BSTR LayoutPath)

Saves the current VISSIM layout into a file (*.INI) specified in the string
LayoutPath. If an empty LayoutPath parameter is given the default name
“vissim.ini” will be used. If no path is passed the browser file dialog appears.
Parameters
[in] BSTR LayoutPath : path + filename (*.ini)
Example
SET vissim = NEW Vissim
vissim.SaveLayout “c:\vissim\data\example.ini”

Exit ()
Exits the VISSIM program and implicitly deletes the Vissim object instance
(also in Automation mode. See 12).
Example

COM Interface Manual © PTV AG 2009 21

3 Language Reference

SET vissim = NEW Vissim

vissim.Exit

ShowMaximized ()
The VISSIM main window is displayed with maximum size.

ShowMinimized ()
The VISSIM main window is only visible in the task bar.

GetWindow ([out] VARIANT *Top, [out] VARIANT *Left, [out] VARIANT

*Bottom, [out] VARIANT *Right)
Retrieve the position of the VISSIM main window. The dimensions are given
in screen coordinates that are relative to the upper-left corner of the screen.
Parameters
[out] VARIANT *Top : the screen coordinate of the top edge
[out] VARIANT *Left : the screen coordinate of the left edge
[out] VARIANT *Bottom : the screen coordinate of the bottom edge
[out] VARIANT *Right : the screen coordinate of the right edge
Example
SET vissim = NEW Vissim
vissim.GetWindow top, left, bottom, right

SetWindow ([in] VARIANT Top, [in] VARIANT Left, [in] VARIANT

Bottom, [in] VARIANT Right)
Set the position of the VISSIM main window. The dimensions are given in
screen coordinates that are relative to the upper-left corner of the screen.
Parameters
[in] VARIANT Top : the screen coordinate of the top edge
[in] VARIANT Left : the screen coordinate of the left edge
[in] VARIANT Bottom : the screen coordinate of the bottom edge
[in] VARIANT Right : the screen coordinate of the right edge
Example
SET vissim = NEW Vissim
vissim.SetWindow 0, 0, 800, 1000

NewWorldPoint([in, defaultvalue(0.0)] double X, [in, defaultvalue(0.0)]

double Y, [in, defaultvalue(0.0)] double Z, [out, retval] IWorldPoint
**ppWorldPoint)
Method for the creation of WorldPoint objects.
Parameters
[out, retval] IWorldPoint **ppWorldPoint : returned WorldPoint object
Example
DIM wp AS WorldPoint
SET wp = vissim.NewWorldPoint(100.0, 100.0, 100.0)
SET so = vissim.Net.StatictsObjects.GetStaticObjectByCoord(wp)

22 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

DoEvents()
Allows VISSIM to process its queued events. Only useful when executing
scripts from VISSIM self.
Example
Set vis = CreateObject("VISSIM.Vissim")
set sim = vis.simulation
for i = 1 to (sim.Period * sim.resolution)
sim.runsinglestep
vis.doevents
next

3.1.2 Net
The Net object belongs to Vissim and can Vissim
be accessed through the property Net of
the IVissim interface. It gives access to Net
the network objects like links, signal
controllers or vehicles. VISSIM is a single
project program, i.e. it allows to work with
no more than one network at a time.
Therefore, a Net instance always
references the currently opened network
of its Vissim instance (see example
below).
Example
DIM vissim AS Vissim
DIM net1, net2 AS Net
SET vissim = NEW Vissim
SET net1 = vissim.Net
vissim.LoadNet “c:\vissim\daten\example.inp”
SET net2 = vissim.Net
The objects „Net1“ und „Net2“ refer to the same network, that is to
“example.inp“.

Properties of the INet Interface

Name ([out, retval] BSTR *pName)

Returns the simulation’s comment.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = net.Name

COM Interface Manual © PTV AG 2009 23

3 Language Reference

Name ([in] BSTR Name)

Sets the simulation’s comment.
Parameters
[in] BSTR Name : new name.
Example
net.Name = „Barcelona Eixample Sim1“

Links ([out, retval] ILinks **ppLinks)

Creates an instance of a Links object (see page 49), that gives individual
access to the link elements of the network.
Parameters
[out, retval] ILinks **ppLinks : returned Links object
Example
DIM links AS Links
SET links = net.Links

Nodes ([out, retval] INodes **ppNodes)

Creates an instance of a Nodes object (see page 56), that gives individual
access to the node elements of the network.
Parameters
[out, retval] INodes **ppNodes : returned Nodes object
Example
DIM nodes AS Nodes
SET nodes = net.Nodes

Paths ([out, retval] IPaths **ppPaths)

Creates an instance of a Paths object (see page 185), that gives individual
access to the path elements of the network inserted through the IPaths
interface..
Parameters
[out, retval] IPaths **ppPaths : returned Paths object
Example
DIM paths AS Paths
SET paths = net.Paths

Vehicles ([out, retval] IVehicles **ppVehicles)

Creates an instance of a Vehicles object (see page 185), that gives
individual access to the vehicles on the network, including the parked ones.
Parameters
[out, retval] IVehicles **ppVehicles : returned Vehicles object
Example
DIM vehicles AS Vehicles
SET vehicles = net.Vehicles

24 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

VehicleInputs ([out, retval] IVehicleInputs **ppVehicleInputs)

Creates an instance of a VehicleInputs object (see page 103), that gives
individual access to the vehicle inputs of the network.
Parameters
[out, retval] IVehicleInputs **ppVehicleInputs : returned VehicleInputs object
Example
DIM inps AS VehicleInputs
SET inps = net.VehicleInputs

RoutingDecisions ([out, retval] IRoutingDecisions

**ppRoutingDecisions)
Creates an instance of a RoutingDecisions object (see page 185), that gives
individual access to the routing decisions of the network.
Parameters
[out, retval] IRoutingDecisions **ppRDs : returned RoutingDecisions object
Example
DIM rds AS RoutingDecisions
SET rds = net.RoutingDecisions

SignalControllers ([out, retval] ISignalControllers

**ppSignalControllers)
Creates an instance of a SignalControllers object (see page 142), that gives
individual access to the signal controller elements of the network.
Parameters
[out, retval] ISignalControllers **ppSignalControllers : returned
SignalControllers object
Example
DIM scs AS SignalControllers
SET scs = net.SignalControllers

DataCollections ([out, retval] IDataCollections **ppDataCollections)

Creates an instance of a DataCollections object (see page 165), that gives
individual access to the data collections defined in the network.
Parameters
[out, retval] IDataCollections **ppDataCollections : returned DataCollections object
Example
DIM colls AS DataCollections
SET colls = net.DataCollections

QueueCounters ([out, retval] IQueueCounters **ppQueueCounters)

Creates an instance of a QueueCounters object (see page 192), that gives
individual access to the queue counters defined in the network.
Parameters
[out, retval] IQueueCounters **ppQueueCounters : returned QueueCounters object

COM Interface Manual © PTV AG 2009 25

3 Language Reference

Example
DIM qcs AS QueueCounters
SET qcs = net.QueueCounters

TravelTimes ([out, retval] ITravelTimes **ppTravelTimes)

Creates an instance of a TravelTimes object (see page 207), that gives
individual access to the trave times defined in the network.
Parameters
[out, retval] ITravelTimes **ppTravelTimes : returned TravelTimes object
Example
DIM tts AS TravelTimes
SET tts = net.TravelTimes

Delays ([out, retval] IDelays **ppDelays)

Creates an instance of a Delays object (see page 212), that gives individual
access to the delays defined in the network.
Parameters
[out, retval] IDelays **ppDelays : returned Delays object
Example
DIM dels AS Delays
SET dels = net.Delays

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a network property. Please get the language independent attribute
tags from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
width = net.AttValue(“WIDTH“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a network property. Please get the language independent attribute tags
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Value : new attribute value. (type according to the attribute)
Example
net.AttValue(“NAME“) = “my network”

Attribute outline :

R W Attribute Description
9 ID Not used

26 VISSIM 5.10-06 © PTV AG 2009

 Base Objects

R W Attribute Description
9 9 NAME Name (currently equivalent to the simulation
comment)
9 HEIGHT Network vertical dimension ([m], [ft])
9 WIDTH Network horizontal dimension ([m], [ft])

Methods of the INet Interface

Rotate ([in] double Angle)

Rotates the network counterclockwise by the specified angle in degrees.
Parameters
[in] double Angle : angle in degrees

Translate ([in] double X, [in] double X, [in] double Z)

Translates the network by the specified X, Y and Z distance using the
current units setting.
Parameters
[in] double X : X coordinate in current units
[in] double Y : Y coordinate in current units
[in] double Z : Z coordinate in current units

COM Interface Manual © PTV AG 2009 27

3 Language Reference

3.2 COM Data Objects

3.2.1 WorldPoint
This object defines the very Vissim WorldPoint
general type world point
which can be used as a
parameter and/or returned as
a result within some
methods. As all objects of the
VISSIM COM interface, this
object must be created using
the interface IVissim (see
method NewWorldPoint)
when needed as a
parameter.
Examples
DIM wp AS WorldPoint
SET wp = vissim.NewWorldPoint(100.0, 100.0, 100.0)
SET so = vissim.Net.StatictsObjects.GetStaticObjectByCoord(wp)

DIM veh AS Vehicle

DIM pos AS WorldPoint
SET veh = vissim.Net.Vehicles.GetVehiclesByNumber(1)
SET pos = veh.AttValue(“POINT”)
x= pos.X
y= pos.Y
z= pos.Z

Properties of the Interface INodeEvaluation

X ([out, retval] double *pX)

Gets the X coordinate of the world point (x, y, z).
Parameters
[out, retval] double *pX : returned x coordinate.

X ([in] double X)
Sets the X coordinate of the world point (x, y, z).
Parameters
[in] double X : new x coordinate.

28 VISSIM 5.10-06 © PTV AG 2009

 COM Data Objects

Y ([out, retval] double *pY)

Gets the Y coordinate of the world point (x, y, z).
Parameters
[out, retval] double *pY : returned y coordinate.

Y ([in] double Y)
Sets the Y coordinate of the world point (x, y, z).
Parameters
[in] double Y : new y coordinate.

Z ([out, retval] double *pZ)

Gets the Z coordinate of the world point (x, y, z).
Parameters
[out, retval] double *pZ : returned z coordinate.

Z ([in] double Z)
Sets the Z coordinate of the world point (x, y, z).
Parameters
[in] double Z : new z coordinate.

COM Interface Manual © PTV AG 2009 29

3.3 VISSIM Base Data

3.3.1 DrivingBehaviorParSets
The Net
DrivingBehaviorParSets
DrivingBehaviorParSets DrivingBehaviorParSet
object is a collection of
DrivingBehaviorParSet
objects (see page 185).
It belongs to the Net object and can be accessed through the
DrivingBehaviorParSets property of the INet interface. It contains all driving
behavior parameter sets of the loaded network and allows the iteration
through all of them as well as individual access (see also
DrivingBehaviorParSet object).
Example
Instantiation of a DrivingBehaviorParSets object and access to all its
DrivingBehaviorParSet objects:
DIM vissim As Vissim
DIM dbpss As DrivingBehaviorParSets
DIM dbps As DrivingBehaviorParSet
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set dbpss = Vissim.Net.DrivingBehaviorParSets
FOR EACH dbps IN dbpss ‘access to _NewEnum to create an enumeration
…
NEXT dbps

‘or also:

FOR i = 1 TO dbpss.Count
SET dbps = dbpss(i) ‘or dbpss.Item(i)
…
NEXT i

Properties of the IDrivingBehaviorParSets Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all
DrivingBehaviorParSet objects. Once a collection is created, individual
members can be returned using the GetDrivingBehaviorParSetByNumber
method, while the entire collection can be iterated using a FOR ...TO ...
NEXT statement. In Visual Basic you can use the statement FOR
EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see DrivingBehaviorParSets example above).

VISSIM 5.10-06 © PTV AG 2009 31

3 Language Reference

Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IDrivingBehaviorParSet

**ppDBPS)
Returns a single DrivingBehaviorParSet of the collection selected by
position. This is useful only when all driving behavior parameter sets shall be
accessed (see the DrivingBehaviorParSets example above). To select a
driving behavior parameter set by its identifier number use
GetDrivingBehaviorParSetByNumber (see below). Since Item is the default
property for a collection the following commands are equivalent:
SET dbps = dbpss(1)
SET dbps = dbpss.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IDrivingBehaviorParSet **ppDBPS: returned DrivingBehaviorParSet object

Count ([out, retval] long *pCount)

Returns the number of DrivingBehaviorParSet objects in the collection. See
the DrivingBehaviorParSets example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IDrivingBehaviorParSets Interface

GetDrivingBehaviorParSetByNumber ([in] long Number, [out, retval]

IDrivingBehaviorParSet **ppDBPS)
Returns the DrivingBehaviorParSet object with the identifier number
Number.
Parameters
[in] long Number : identifier number
[out, retval] IDrivingBehaviorParSet **ppDBPS : returned DrivingBehaviorParSet object
Example
SET dbps = dbpss.GetDrivingBehaviorParSetByNumber(2)
IF NOT (dbps IS NOTHING) THEN
name = dbps.AttValue(“NAME”)
END IF

3.3.2 DrivingBehaviorParSet
A DrivingBehaviorParSet DrivingBehaviorParSets DrivingBehaviorParSet
object represents a driving
behavior parameter set

32 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

element and belongs to the

DrivingBehaviorParSets
object.
It can be accessed through the DrivingBehaviorParSets object to in two
ways:
► access via iteration through the collection
DIM dbps As DrivingBehaviorParSet
FOR EACH dbps IN vissim.Net.DrivingBehaviorParSets
List.AddItem dbps.ID
NEXT dbps
► individual access via identifier
DIM dbps As DrivingBehaviorParSet
SET dbps = vissim.Net.DrivingBehaviorParSets.GetDrivingBehaviorParSetByNumber(2)
The DrivingBehaviorParSet object enables access to the properties of the
driving behavior parameter set through the IDrivingBehaviorParSet interface.

Properties of the Interface IDrivingBehaviorParSet

ID ([out, retval] long *pID)

Returns the identifier number of the driving behavior parameter set.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = dbps.ID

Name ([out, retval] BSTR *pName)

Returns the name of the driving behavior parameter set.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = dbps.Name

Name ([in] BSTR Name)

Sets the name of the driving behavior parameter set. Maximal 255
characters.
Parameters
[in] BSTR Name : new name.
Example
dbps.Name = „XXX“

COM Interface Manual © PTV AG 2009 33

3 Language Reference

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a driving behavior parameter set attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = dbps.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a driving behavior parameter set attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
dbps.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 CC0 Standstill Distance (current distance units set)
9 9 CC1 Headway Time [s]
9 9 CC2 ‘Following’ Variation (current distance units set)
9 9 CC3 Threshold of entering ‘Following’ [-]
9 9 CC4 Negative ‘Following’ Threshold [-]
9 9 CC5 Positive ‘Following’ Threshold [-]
9 9 CC6 Speed dependeny of Oscillation
9 9 CC7 Oscillation Acceleration [m/s2]
9 9 CC8 Standstill Acceleration [m/s2]
9 9 CC9 Acceleration at 80 km/h [m/s2]

34 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

3.3.3 PedTypes
The PedTypes object is a Net

collection of PedType objects PedTyes PedType

(see page 36).

It belongs to the Net object and can be accessed through the PedTypes
property of the INet interface. It contains all pedestrian types of the loaded
network and allows the iteration through all of them as well as individual
access (see also PedType object).
Example
Instantiation of a PedTypes object and access to all its PedType objects:
DIM vissim As Vissim
DIM pTypes As PedTypes
DIM pType As PedType
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set pTypes = Vissim.Net.PedTypes
FOR EACH pType IN pTypes ‘access to _NewEnum to create an enumeration
…
NEXT pType

‘or also:

FOR i = 1 TO pTypes.Count
SET pType = pTypes(i) ‘or pTypes.Item(i)
…
NEXT i

Properties of the IPedTypes

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all PedType objects.
Once a collection is created, individual members can be returned using the
PedTypeByNumber method, while the entire collection can be iterated using
a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see DrivingBehaviorParSets example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedType **pppType)

Returns a single PedType of the collection selected by position. This is
useful only when all pedestrian types shall be accessed (see the PedTypes
example above). To select a pedestrian type by its identifier number use

COM Interface Manual © PTV AG 2009 35

3 Language Reference

PedTypeByNumber (see below). Since Item is the default property for a

collection the following commands are equivalent:
SET pType = pTypes(1)
SET pType = pTypes.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedType **pppType: returned PedType object

Count ([out, retval] long *pCount)

Returns the number of PedType objects in the collection. See the PedTypes
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedTypes Interface

PedTypeByNumber ([in] long Number, [out, retval] IPedType

**pppType)
Returns the PedType object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedType **pppType : returned PedType object
Example
SET ptype = pTypes.PedTypeByNumber(2)
IF NOT (pType IS NOTHING) THEN
name = pType.AttValue(“NAME”)
END IF

3.3.4 PedType
A PedType object represents PedTypes PedType
a pedestrian type element
and belongs to the PedTypes
object.
It can be accessed through the PedTypes object to in two ways:
► access via iteration through the collection
DIM pType As PedType
FOR EACH pType IN vissim.Net.PedTypes
List.AddItem pType.ID
NEXT pType
► individual access via identifier
DIM pType As PedType
SET pType = vissim.Net.PedTypes.PedTypeByNumber(2)

36 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

The PedType object enables access to the properties of the pedestrian type
through the IPedType interface.

Properties of the Interface IPedType

ID ([out, retval] long *pID)

Returns the identifier number of the pedestrian type.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = pType.ID

Name ([out, retval] BSTR *pName)

Returns the name of the pedestrian type.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pType.Name

Name ([in] BSTR Name)

Sets the name of the pedestrian type. Maximal 255 characters.
Parameters
[in] BSTR Name : new name.
Example
pType.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian type attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = pType.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian type attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)

COM Interface Manual © PTV AG 2009 37

3 Language Reference

Example
pType.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

3.3.5 PedClasses
The PedClasses object is a Net

collection of PedClass objects PedClasses PedClasse

(see page 39).

It belongs to the Net object and can be accessed through the PedClasses
property of the INet interface. It contains all pedestrian classes of the loaded
network and allows the iteration through all of them as well as individual
access (see also PedClass object).
Example
Instantiation of a PedClasses object and access to all its PedClass objects:
DIM vissim As Vissim
DIM pClasses As PedClasses
DIM pClass As PedClass
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set pClasses = Vissim.Net.PedClasses
FOR EACH pClass IN pClassess ‘access to _NewEnum to create an enumeration
…
NEXT pClass

‘or also:

FOR i = 1 TO pClasses.Count
SET pClass = pClasses(i) ‘or pClasses.Item(i)
…
NEXT i

Properties of the IPedClasses Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all PedClass objects.
Once a collection is created, individual members can be returned using the

38 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

PedClassByNumber method, while the entire collection can be iterated using

a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see PedClasses example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedClass **pppClass)

Returns a single PedClass of the collection selected by position. This is
useful only when all pedestrian classes shall be accessed (see the
PedClasses example above). To select a pedestrian class by its identifier
number use PedClassByNumber (see below). Since Item is the default
property for a collection the following commands are equivalent:
SET pClass = pClasses(1)
SET pClass = pClasses.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedClass **pppClass: returned PedClass object

Count ([out, retval] long *pCount)

Returns the number of PedClass objects in the collection. See the
PedClasses example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedClasses Interface

PedClassByNumber ([in] long Number, [out, retval] IPedClass

**pppClass)
Returns the PedClass object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedClass **pppClass : returned PedClass object
Example
SET pClass = pClasses.PedClassByNumber(2)
IF NOT (pClass IS NOTHING) THEN
name = pClass.AttValue(“NAME”)
END IF

3.3.6 PedClass
A PedClass object PedClasses PedClass

COM Interface Manual © PTV AG 2009 39

3 Language Reference

represents a pedestrian class

element and belongs to the
PedClasses object.
It can be accessed through the PedClasses object to in two ways:
► access via iteration through the collection
DIM pClass As PedClass
FOR EACH pClass IN vissim.Net.PedClasses
List.AddItem pClass.ID
NEXT pClass
► individual access via identifier
DIM pClass As PedClass
SET pClass = vissim.Net.PedClasses.PedClassByNumber(2)
The PedClass object enables access to the properties of the pedestrian
class through the IPedClass interface.

Properties of the Interface IPedClass

ID ([out, retval] long *pID)

Returns the identifier number of the pedestrian class.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = pClass.ID

Name ([out, retval] BSTR *pName)

Returns the name of the pedestrian class.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pClass.Name

Name ([in] BSTR Name)

Sets the name of the pedestrian class. Maximal 255 characters.
Parameters
[in] BSTR Name : new name.
Example
pClass.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian class attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters

40 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

[in] BSTR Attribute : attribute name (see table below)

[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = pClass.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian class attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
pClass.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

3.3.7 PedWalkingBehaviorParSets
The Net

PedWalkingBehaviorParSets PedWalkingBehaviorParSets PedWalkingBehaviorParSet

object is a collection of
PedWalkingBehaviorParSet
objects (see page 185).
It belongs to the Net object and can be accessed through the
PedWalkingBehaviorParSets property of the INet interface. It contains all
driving behavior parameter sets of the loaded network and allows the
iteration through all of them as well as individual access (see also
PedWalkingBehaviorParSet object).
Example
Instantiation of a PedWalkingBehaviorParSets object and access to all its
PedWalkingBehaviorParSet objects:
DIM vissim As Vissim
DIM wbpss As PedWalkingBehaviorParSets
DIM wbps As PedWalkingBehaviorParSet
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set wbpss = Vissim.Net.PedWalkingBehaviorParSets
FOR EACH wbps IN wbpss ‘access to _NewEnum to create an enumeration
…
NEXT wbps

COM Interface Manual © PTV AG 2009 41

3 Language Reference

‘or also:

FOR i = 1 TO wbpss.Count
SET wbps = wbpss(i) ‘or wbpss.Item(i)
…
NEXT i

Properties of the IPedWalkingBehaviorParSets Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all
PedWalkingBehaviorParSet objects. Once a collection is created, individual
members can be returned using the
GetPedWalkingBehaviorParSetByNumber method, while the entire collection
can be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you
can use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally. (see PedWalkingBehaviorParSets
example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedWalkingBehaviorParSet

**ppWBPS)
Returns a single PedWalkingBehaviorParSet of the collection selected by
position. This is useful only when all driving behavior parameter sets shall be
accessed (see the PedWalkingBehaviorParSets example above). To select
a driving behavior parameter set by its identifier number use
GetPedWalkingBehaviorParSetByNumber (see below). Since Item is the
default property for a collection the following commands are equivalent:
SET wbps = wbpss(1)
SET wbps = wbpss.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedWalkingBehaviorParSet **ppWBPS: returned PedWalkingBehaviorParSet object

Count ([out, retval] long *pCount)

Returns the number of PedWalkingBehaviorParSet objects in the collection.
See the PedWalkingBehaviorParSets example above.
Parameters
[out, retval] long *pCount : returned number of objects.

42 VISSIM 5.10-06 © PTV AG 2009

 VISSIM Base Data

Methods of the IPedWalkingBehaviorParSets Interface

PedWalkingBehaviorParSetByNumber ([in] long Number, [out, retval]

IPedWalkingBehaviorParSet **ppWBPS)
Returns the PedWalkingBehaviorParSet object with the identifier number
Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedWalkingBehaviorParSet **ppWBPS :returned PedWalkingBehaviorParSet object
Example
SET wbps = wbpss.PedWalkingBehaviorParSetByNumber(2)
IF NOT (wbps IS NOTHING) THEN
name = wbps.AttValue(“NAME”)
END IF

3.3.8 PedWalkingBehaviorParSet
A PedWalkingBehaviorParSets PedWalkingBehaviorParSet

PedWalkingBehaviorParSet
object represents a driving
behavior parameter set
element and belongs to the
PedWalkingBehaviorParSets
object.
It can be accessed through the PedWalkingBehaviorParSets object to in two
ways:
► access via iteration through the collection
DIM wbps As PedWalkingBehaviorParSet
FOR EACH wbps IN vissim.Net.PedWalkingBehaviorParSets
List.AddItem wbps.ID
NEXT wbps
► individual access via identifier
DIM wbps As PedWalkingBehaviorParSet
SET wbps = vissim.Net.PedWalkingBehaviorParSets.PedWalkingBehaviorParSetByNumber(2)
The PedWalkingBehaviorParSet object enables access to the properties of
the driving behavior parameter set through the IPedWalkingBehaviorParSet
interface.

Properties of the Interface IPedWalkingBehaviorParSet

ID ([out, retval] long *pID)

Returns the identifier number of the driving behavior parameter set.

COM Interface Manual © PTV AG 2009 43

3 Language Reference

Parameters
[out, retval] long *pID :returned identifier.
Example
id = wbps.ID

Name ([out, retval] BSTR *pName)

Returns the name of the driving behavior parameter set.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = wbps.Name

Name ([in] BSTR Name)

Sets the name of the driving behavior parameter set. Maximal 255
characters.
Parameters
[in] BSTR Name : new name.
Example
wbps.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a driving behavior parameter set attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = wbps.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a driving behavior parameter set attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
wbps.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

44 VISSIM 5.10-06 © PTV AG 2009

 Network

3.4 Network

3.4.1 Link-based

3.4.1.1 DesiredSpeedDecisions
The Desired Speed Net
Decisions object is a
collection of Desired DesiredSpeedDecisions DesiredSpeedDecision

Speed Decision objects

(see page 46).
It belongs to the Net object and can be accessed through the
DesiredSpeedDecisions property of the INet interface. It contains all desired
speed decisions of the loaded network and allows the iteration through all of
them as well as individual access (see also DesiredSpeedDecision object).
Example
Instantiation of a DesiredSpeedDecisions object and access to all its
DesiredSpeedDecision objects:
DIM vissim As Vissim
DIM decisions As DesiredSpeedDecisions
DIM decision As DesiredSpeedDecision
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET decisions = Vissim.Net.DesiredSpeedDecisions
FOR EACH decision IN decisions ‘access to _NewEnum to create an enumeration
…
NEXT decision

‘or also:

FOR i = 1 TO decisions.Count
SET decision = decisions(i) ‘or decisions.Item(i)
…
NEXT i

Properties of the IDesiredSpeedDecisions Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all
DesiredSpeedDecision objects. Once a collection is created, individual
members can be returned using the GetDesiredSpeedDecisionByNumber
method, while the entire collection can be iterated using a FOR ...TO ...
NEXT statement. In Visual Basic you can use the statement FOR

COM Interface Manual © PTV AG 2009 45

3 Language Reference

EACH…NEXT without using the property _NewEnum, which VB calls

internally. (see DesiredSpeedDecisions example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IDesiredSpeedDecision

**ppDecision)
Returns a single DesiredSpeedDecision of the collection selected by
position. This is useful only when all desired speed decisions shall be
accessed (see the DesiredSpeedDecisions example above). To select a
desired speed decision by its identifier number use
GetDesiredSpeedDecisionByNumber (see below). Since Item is the default
property for a collection the following commands are equivalent:
SET decision = decisions(1)
SET decision = decisions.Item(1)
Parameters
[in] long Index: index between 1 and Count
[out, retval] IDesiredSpeedDecision **ppDecision: returned DesiredSpeedDecision

Count ([out, retval] long *pCount)

Returns the number of DesiredSpeedDecision objects in the collection. See
the DesiredSpeedDecisions example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IDesiredSpeedDecisions Interface

GetDesiredSpeedDecisionByNumber ([in] long Number, [out, retval]

IDesiredSpeedDecision **ppDecision)
Returns the DesiredSpeedDecision object with the identifier number
Number.
Parameters
[in] long Number : identifier number
[out, retval] IDesiredSpeedDecision **ppDecision :returned DesiredSpeedDecision
Example
SET decision = decisions.GetDesiredSpeedDecisionByNumber (2)
IF NOT (decision IS NOTHING) THEN
name = decision.AttValue(“NAME”)
END IF

3.4.1.2 DesiredSpeedDecision
A DesiredSpeed- DesiredSpeedDecisions DesiredSpeedDecision
Decision object

46 VISSIM 5.10-06 © PTV AG 2009

 Network

represents a
desired speed
decision element
and belongs to
the Desired-
SpeedDecisions
object.
It can be accessed through the DesiredSpeedDecisions object to in two
ways:
► access via iteration through the collection
DIM decision As DesiredSpeedDecision
FOR EACH decision IN vissim.Net.DesiredSpeedDecisions
List.AddItem decision.ID
NEXT decision
► individual access via identifier
DIM decision As DesiredSpeedDecision
SET decision = vissim.Net.DesiredSpeedDecisions.
GetDesiredSpeedDecisionByNumber (12)
The DesiredSpeedDecision object enables access to the properties of the
desired speed decision through the IDesiredSpeedDecision interface.

Properties of the Interface IDesiredSpeedDecision

ID ([out, retval] long *pID)

Returns the desired speed decision identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = decision.ID

Name ([out, retval] BSTR *pName)

Returns the name of the desired speed decision.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = decision.Name

Name ([in] BSTR Name)

Sets the decision’s name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
decision.Name = „XXX“

COM Interface Manual © PTV AG 2009 47

3 Language Reference

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a desired speed decision attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = decision.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a desired speed decision attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
decision.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 TIMEFROM Time interval start of activation[s].
9 9 TIMEUNTIL Time interval end of activation[s].
9 9 DESIREDSPEED Desired speed distribution number of the
first vehicle class.
9 VEHICLECLASSES Affected vehicle classes (Array of
numbers)
9 VEHICLETYPES Affected vehicle types (Array of numbers)

Note: It is required that TIMEUNTIL is greater or equal than TIMEFROM

when setting the interval. If the current interval is [100, 1000] and you want
to set it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a desired speed decision attribute with one parameter. Please get
the language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)

48 VISSIM 5.10-06 © PTV AG 2009

 Network

[in] VARIANT Parameter : attribute dependent parameter (see below)

[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a desired speed decision attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 DESIREDSPEED Desired speed distribution number.
Parameter: vehicle class.
9 9 VEHICLECLASS TRUE if the vehicle class is affected.
Parameter: vehicle class number.
9 VEHICLETYPE TRUE if the vehicle class is affected.
Parameter: vehicle type number.

Changes will affect immediately if called during a simulation.

3.4.1.3 Links
The Links object is a Net
collection of Link objects
(see page 51). It belongs
to the Net object and can Links Link
be accessed through the
Links property of the INet
interface.
It contains all links and connectors of the loaded network and allows the
iteration through all of them as well as individual access (see also Link
object).
Example
Instantiation of Links object and access to all its Link objects:
Dim vissim As Vissim
Dim links As Links
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set links = Vissim.Net.Links

FOR EACH link IN links ‘access to the method _NewEnum to create an enumeration

COM Interface Manual © PTV AG 2009 49

3 Language Reference

…
NEXT link

‘or also:

FOR i = 1 TO links.Count
SET link = links(i) ‘or links.Item(i)
…
NEXT i

Properties of the ILinks Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Link objects in the
current network. Once a collection is created, individual members can be
returned using the GetLinkByNumber method, while the entire collection can
be iterated through using a FOR ...TO ... NEXT statement. In Visual Basic
you can use the statement FOR EACH…NEXT without using _NewEnum,
which VB calls internally (see Links example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ILink **ppLink)

Returns a single Link of the collection selected by position. This is useful
only when all links shall be accessed (see the Links example above). To
select a link by its identifier number use GetLinkByNumber (see below).
Since Item is the default property for a collection the following commands
are equivalent:
SET link = links(1)
SET link = links.Item(1)
Parameters
[in] long Index: index between 1 and Links.Count
[out, retval] ILink **ppLink: returned Link object

Count ([out, retval] long *pCount)

Returns the number of Link objects in the collection. See the Links example
above.
Parameters
[out, retval] long *pCount : returned number of objects.

50 VISSIM 5.10-06 © PTV AG 2009

 Network

Methods of the ILinks Interface

GetLinkByNumber ([in] long Number, [out, retval] ILink **ppLink)

Returns the Link object with the identifier number Number.
Parameters
[in] long Number: link identifier
[out, retval] ILink **ppLink: returned Link object
Example
SET link = links.GetLinkByNumber(1001)

3.4.1.4 Link
This object represents a link or Links Link
connector element and belongs to the
Links object. A Link object can be
accessed through the Links object in two
ways:
► access via iteration through the collection
DIM links As Links
DIM link As Link
SET links = Vissim.Net.Links
FOR EACH link IN links
List.AddItem link.ID
NEXT link
► individual access via identifier
DIM links As Links
DIM link As Link
SET links = Vissim.Net.Links
SET link = links. GetLinkByNumber(1000)
The Link object enables access to the properties of the link through the ILink
interface.

Properties of the ILink Interface

ID ([out, retval] long *pID)

Returns the link identifier number. If the Link object doesn’t refer to a valid
VISSIM link element anymore the returned value is 0.
Parameters
[out, retval] long *pID : returned identifier (0 if reference no longer valid)
Example
DIM link AS Link
id = link.ID

COM Interface Manual © PTV AG 2009 51

3 Language Reference

Name ([out, retval] BSTR *pName)

Returns the link name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = link.Name

Name ([in] BSTR Name)

Sets the link name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
link.Name = „Banbury Road up“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a link attribute. Please get the language independent attribute tag
from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
length = link.AttValue(„LENGTH“)
polyline = link.AttValue(„POINTS“)
FOR i = LBOUND(polyline) TO UBOUND(polyline)
x = polyline (i).X
y = polyline (i).Y
NEXT i

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a link attribute. Please get the language independent attribute tag from
the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
link.AttValue(„NAME“) = “stumpfstr.”

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 BEHAVIORTYPE Link behavior type

52 VISSIM 5.10-06 © PTV AG 2009

 Network

R W Attribute Description
9 CONNECTOR True if the link is a connector
9 9 COST Link cost per km
9 9 DISPLAYTYPE Link display type
9 9 EMERGENCYSTOP Connector emergency stop parameter
9 FROMLANE If it is a connector: the number of the right
most lane of the origin link. Otherwise 0.
9 FROMLINK If it is a connector: the number of the origin
link. Otherwise 0.
9 GRADIENT Gradient in %
9 9 LANECHANGE Connector lane change parameter
9 LANEWIDTH Lane width the units of the current options
9 LENGTH Length in the units of the current options
9 NUMLANES Lanes number
9 POINTS Reference line through the center of the
link (array of VARIANTs).
9 9 SURCHARGE1 Weight sensitive surcharge
9 9 SURCHARGE2 Weight insensitive surcharge
9 TOLANE If it is a connector: the number of the right
most lane of the destination link. Otherwise
0.
9 TOLINK If it is a connector: the number of the
destination link. Otherwise 0.

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a link attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a link attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)

COM Interface Manual © PTV AG 2009 53

3 Language Reference

[in] VARIANT Parameter : attribute dependent parameter (see below)

[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 CLOSED Connector closure. Parameter: vehicle
class number

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [out, retval] VARIANT *pValue)
Returns a link attribute with two parameters. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter1 : first attribute dependent parameter (see below)
[in] VARIANT Parameter2 : second attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
isclosed = link.AttValue2(„LANECLOSED“, lanenr, vehclass)

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [in] VARIANT Value)
Sets a link attribute with two parameters. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter1 : first attribute dependent parameter (see below)
[in] VARIANT Parameter2 : second attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
link.AttValue2(„LANECLOSED“, lanenr, vehclass) = TRUE

Attribute outline

R W Attribute Description
9 9 LANECLOSED Lane closure. Parameters: lane number and
vehicle class number

54 VISSIM 5.10-06 © PTV AG 2009

 Network

Methods of the ILink Interface

GetSegmentResult ([in] BSTR Parameter, [in] long VehicleClass, [in]

double XCoord, [in, defaultvalue(1)] int Lane, [in, defaultvalue(0)] BYTE
Cumulative, [in, retval] VARIANT *pValue)
Returns the last collected result (see note below) of a previously configured
segment. The link must have the segment evaluation flag set and a segment
length defined. Use lane number 1 if evaluation data is not collected per lane
(see ILinkEvaluation interface on page 207). Use a negative link coordinate if
a two dimensional array of values for all segments is requested. In this case,
the second dimension will be of size 2 and will contain the segment start
coordinate and the result respectively. See the table below for a list of the
possible parameter names.
Parameters
[in] BSTR Parameter : parameter name (see below)
[in] long VehicleClass: vehicle class number; 0 for all vehicle types
[in] double XCoord : link coordinate (from 0.0 to link length; a negative
value (i.e.–1.0) for a two dimensional array of values
for each segment)
[in] int Lane : lane number (from 1 to n if “per lane” evaluations are
collected, 1 otherwise)
[in] BYTE Cumulative: cumulative evaluation flag (false as a default)
[out, retval] VARIANT *pValue : returned value (real) or array of values (of reals)
Example
val = link.GetSegmentResult(“SPEED”, 0, 0.0) ‘ first segment result for lane 1 or all
link if data is not being collected per lane
vals = link.GetSegmentResult(“SPEED”, 0, -1) ‘ array of results for each segment.
FOR i = LBOUND(vals) TO UBOUND(vals)
segindex = vals(i, 0) ‘ segment index
val = vals(i, 1) ‘segment result
NEXT i

Parameters outline

Attribute Description
DENSITY Average density (current unit selection)
DELAY Average relative lost time [s/s]
NVEHICLES Number of vehicles (cumulative value of VOLUME).
VOLUME must be activated within the evaluation
configuration.
SPEED Average speed (current unit selection)
VOLUME Average volume [veh/h]

COM Interface Manual © PTV AG 2009 55

3 Language Reference

The results refer to the data collected during the last completed time
interval. The data of a time interval is available immediately after the last
time step of the interval has been simulated but not if this is the last time
step of the simulation period as well.

To get results, a link evaluation configuration must be defined in VISSIM

and stored in a *.sak file before requests can be done. The Offline Analysis
option for Link Evaluation must be also enabled. Otherwise an error
message will be returned (“The specified configuration is not defined within
VISSIM”).

GetVehicles ([out, retval] IVehicles** ppVehicles)

Returns a collection with all vehicles currently travelling on this link. This
method is suposed to be called during a simulation. The returned collection
actues as a reference to the dynamic list of vehicles on the link and is
subjected to changes on each simulation step. (see note 83 for a more
detailed explanation).
Parameters
[out, retval] IVehicles** ppVehicles : returned Vehicles object.
Example
vehicles = link.GetVehicles
FOR EACH v IN vehicles
IF v.AttValue(“SPEED”) > 100.0 THEN
v.AttValue(“COLOR”) = RGB(255, 0, 0)
END IF
NEXT v

3.4.1.5 Nodes
The Nodes object is a Net
collection of Node objects.
It belongs to the Net object
and can be accessed Nodes Node
through the Nodes
property of the INet
interface.
It contains all nodes of the loaded network and enables iteration through the
collection or individual access to a Node object.
Example
Instantiation of Nodes object and access to all its Node objects:
Dim vissim As Vissim
Dim nodes As Nodes
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set nodes = Vissim.Net.Nodes

FOR EACH node IN nodes ‘access to the _NewEnum to create an enumeration

56 VISSIM 5.10-06 © PTV AG 2009

 Network

…
NEXT node

‘or also:

FOR i = 1 TO nodes.Count
SET node = nodes(i) ‘or nodes.Item(i)
…
NEXT i

Properties of the INodes Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Node objects. Once
a collection is created, individual members can be returned using the
GetNodeByNumber method, while the entire collection can be iterated using
a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see Nodes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] INode **ppNode)

Returns a single Node of the collection selected by position. This is useful
only when all nodes shall be accessed (see the Nodes example above). To
select a node by its identifier number use GetNodeByNumber (see below).
Since Item is the default property for a collection the following commands
are equivalent:
SET node = nodes(1)
SET node = nodes.Item(1)
Parameters
[in] long Index: index between 1 and Nodes.Count
[out, retval] INode **ppNode: returned Node object

Count ([out, retval] long *pCount)

Returns the number of Node objects in the collection. See the Nodes
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

COM Interface Manual © PTV AG 2009 57

3 Language Reference

Methods of the INodes Interface

GetNodeByNumber ([in] long Number, [out, retval] INode **ppNode)

Returns the Node object with the identifier number Number.
Parameters
[in] long Number: node identifier
[out, retval] INode **ppNode: returned Node object
Example
DIM node AS Node
SET node =nodes.GetNodeByNumber(101)

Methods of the Interface INodes

GetResult ([in] double Time, [in] BSTR Parameter, [in] BSTR Function,
[in] long VehicleClass, [out, retval] VARIANT *pValue)
This method returns the collected result for all nodes and for the requested
named parameter (see parameters table below) and vehicle class. The
returned value refers to the current collected result for the time interval
enclosing the specified time point. The Function parameter has currently no
meaning.
Parameters
[in] double Time : time point in seconds
[in] BSTR Parameter : parameter name (see below)
[in] BSTR Function : not used
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue: returned value (real number)
Example
nv = nodes.GetResult(600, „NVEHICLES“, “”, 0) ‘ system total vehicle throughput

Parameters outline

Parameter Description
DELAY Average total delay per vehicle [s]
PERSONSDELAY Average total delay per person [s]
NPERSONS Persons throughput (Number of people)
NSTOPS Average number of stops per vehicle [s]
NVEHICLES Vehicles throughput (Number of vehicles)
QUEUELENGTHAVG Average queue length (current unit selection)
QUEUELENGTHMAX Maximum queue length (current unit selection)
STOPPEDDELAY Average stand still time (stopped delay) per

58 VISSIM 5.10-06 © PTV AG 2009

 Network

Parameter Description
vehicle [s]

To get results, the Offline Analysis option for nodes must be enabled.
Otherwise the result will be 0.0.

3.4.1.6 Node
A Node object represents a node Nodes Node
element and belongs to the Nodes
object. It can be accessed through the
Nodes object in two ways:
► access via iteration through the collection
DIM nodes As Nodes
DIM node As Node
SET nodes = Vissim.Net.Nodes
FOR EACH node IN nodes
List.AddItem node.ID
NEXT node
► individual access via identifier
DIM nodes As Nodes
DIM node As Node
SET nodes = Vissim.Net.Nodes
SET node = nodes. GetNodeByNumber(101)
The Node object enables access to the properties of the node through the
INode interface.

Properties of the INode Interface

ID ([out, retval] long *pID)

Returns the node identifier number. If the Node object doesn’t refer to a valid
VISSIM node element anymore the returned value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = node.ID

Name ([out, retval] BSTR *pName)

Returns the node name.
Parameters
[out, retval] BSTR *pName : returned name.
Example

COM Interface Manual © PTV AG 2009 59

3 Language Reference

name = node.Name

Name ([in] BSTR Name)

Sets the node name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
node.Name = „Durlachertor“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a node attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
node = node.AttValue(“NAME”)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a node attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
node.AttValue(„NAME“) = “Piccadilly Circus”

Attribute outline

R W Attribute Description
9 ID Identifier number
9 NAME Name

Methods of the Interface INode

GetResult ([in] double Time, [in] BSTR Parameter, [in] BSTR Function,
[in] long VehicleClass, [out, retval] VARIANT *pValue)
This method returns collected result for the node total (all turn relations) and
for the requested named parameter (see parameters table below) and
vehicle class. The returned value refers to the current collected result for the

60 VISSIM 5.10-06 © PTV AG 2009

 Network

time interval enclosing the specified time point. The Function parameter has
currently no meaning.
Parameters
[in] double Time : time point in seconds
[in] BSTR Parameter : parameter name (see below)
[in] BSTR Function : not used
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue: returned value (real number)
Example
nv = node.GetResult(600, „NVEHICLES“, “”, 0) ‘vehicle throughput
del = node.GetResult(600, “DELAY”, “”, 1) ‘average delay per vehicle of vehicle class 1

GetMovementResult ([in] double Time, [in] long FromLink, [in] long

ToLink [in] BSTR Parameter, [in] BSTR Function, [in] long
VehicleClass, [out, retval] VARIANT *pValue)
This method returns the collected result for the specified turn relation and for
the requested named parameter (see parameters table below) and vehicle
class. The returned value refers to the data collected up to this moment for
the time interval enclosing the specified time point. The Function parameter
has currently no meaning.
Parameters
[in] double Time : time point in seconds
[in] long FromLink : number of the link entering the node
[in] long ToLink : number of the link leaving the node
[in] BSTR Parameter : parameter name (see below)
[in] BSTR Function : not used
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue: returned value (real number)
Example
nv = n.GetResult(600,11,12, „NVEHICLES“, “”, 0) ‘vehicle throughput entering from link 11
and leaving trhough link 12

Parameters outline

Parameter Description
DELAY Average total delay per vehicle [s]
PERSONSDELAY Average total delay per person [s]
NPERSONS Persons throughput (Number of people)
NSTOPS Average number of stops per vehicle [s]
NVEHICLES Vehicles throughput (Number of vehicles)
QUEUELENGTHAVG Average queue length (current unit selection)
QUEUELENGTHMAX Maximum queue length (current unit selection)
STOPPEDDELAY Average stand still time (stopped delay) per
vehicle [s]

COM Interface Manual © PTV AG 2009 61

3 Language Reference

To get results, the Offline Analysis option for nodes must be enabled.
Otherwise the result will be 0.0.

3.4.1.7 ParkingLots
The ParkingLots object is a Net
collection of ParkingLot
objects (see page 185). It
belongs to the Net object ParkingLots ParkingLot
and can be accessed
through the ParkingLots
property of the INet
interface.
It contains all parking lots of the loaded network and allows the iteration
through all of them as well as individual access (see also ParkingLot object).
Example
Instantiation of a ParkingLots object and access to all its ParkingLot objects:
DIM vissim As Vissim
DIM pls As ParkingLots
DIM pl As ParkingLot
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set pls = Vissim.Net.ParkingLots
FOR EACH pl IN pls ‘access to _NewEnum to create an enumeration
…
NEXT pl

‘or also:

FOR i = 1 TO pls.Count
SET pl = pls(i) ‘or pls.Item(i)
…
NEXT i

Properties of the IParkingLots Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all ParkingLot objects.
Once a collection is created, individual members can be returned using the
GetParkingLotByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see ParkingLots example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

62 VISSIM 5.10-06 © PTV AG 2009

 Network

Item ([in] VARIANT Index, [out, retval] IParkingLot **ppParkingLot)

Returns a single ParkingLot of the collection selected by position. This is
useful only when all parking lots shall be accessed (see the ParkingLots
example above). To select a parking lot by its identifier number use
GetParkingLotByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET pl = pls(1)
SET pl = pls.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IParkingLot **ppParkingLots: returned ParkingLot object

Count ([out, retval] long *pCount)

Returns the number of ParkingLot objects in the collection. See the
ParkingLots example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IParkingLots Interface

GetParkingLotByNumber ([in] long Number, [out, retval] IParkingLot

**ppParkingLot)
Returns the ParkingLot object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IParkingLot **ppParkingLot : returned ParkingLot object
Example
SET pl = pls.GetParkingLotByNumber (2)
IF NOT (pl IS NOTHING) THEN
name = pl.AttValue(“NAME”)
END IF

3.4.1.8 ParkingLot
A ParkingLot object represents a ParkingLots ParkingLot
parking lot element and belongs to
the ParkingLots object. It can be
accessed through the ParkingLots
object to in two ways:
► access via iteration through the collection
DIM pl As ParkingLot
FOR EACH pls IN vissim.Net.ParkingLots
List.AddItem pl.ID
NEXT pl

COM Interface Manual © PTV AG 2009 63

3 Language Reference

► individual access via identifier

DIM pl As ParkingLot
SET pl = vissim.Net.ParkingLots.GetParkingLotByNumber (12)
The ParkingLot object enables access to the properties of the parking lot
through the IParkingLot interface.

Properties of the Interface IParkingLot

ID ([out, retval] long *pID)

Returns the parking lot identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = pl.ID

Name ([out, retval] BSTR *pName)

Returns the name of the parking lot.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pl.Name

Name ([in] BSTR Name)

Sets the name of the parking lot. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
pl.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a parking lot attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = pl.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a parking lot attribute. Please get the language independent attribute
tag from the table at the end of this section.

64 VISSIM 5.10-06 © PTV AG 2009

 Network

Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
pl.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 LINK Identifier number of the position link
9 OCCUPANCY Amount of currently parked vehicles (see note
below)
9 RELATIVEFLOW Percentage of the zone´s total demand.
9 NVEHICLES Total number of vehicles in the parking lot (see
note below)
9 ZONE Zone number

The named attribute NVEHICLES considers total loaded traffic demand

independently of the user defined parking lot initial occupancy. On the
other hand. The attribute OCCUPANCY doesn’t consider the intial traffic
load but the user defined parking lot initial occupancy together with the
arrived and parked vehicles which are considered to determine if a parking
lot is full.

3.4.1.9 ReducedSpeedAreas
The ReducedSpeed- Net
Areas object is a
collection of Reduced- ReducedSpeedAreas ReducedSpeedArea

SpeedArea objects (see

page 49). It belongs to
the Net object and can
be accessed through the
ReducedSpeedAreas
property of the INet
interface.
It contains all reduced speed areas of the loaded network and allows the
iteration through all of them as well as individual access (see also
ReducedSpeedArea object).
Example

COM Interface Manual © PTV AG 2009 65

3 Language Reference

Instantiation of a ReducedSpeedAreas object and access to all its

ReducedSpeedArea objects:
DIM vissim As Vissim
DIM speedareas As ReducedSpeedAreas
DIM speedarea As ReducedSpeedArea
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET speedareas = Vissim.Net.ReducedSpeedAreas
FOR EACH speedarea IN speedareas ‘access to create an enumeration
…
NEXT speedarea

‘or also:

FOR i = 1 TO speedareas.Count
SET speedarea = speedareas(i) ‘or speedareas.Item(i)
…
NEXT i

Properties of the IReducedSpeedAreas Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all ReducedSpeedArea
objects. Once a collection is created, individual members can be returned
using the GetReducedSpeedAreaByNumber method, while the entire
collection can be iterated using a FOR ...TO ... NEXT statement. In Visual
Basic you can use the statement FOR EACH…NEXT without using the
property _NewEnum, which VB calls internally. (see ReducedSpeedAreas
example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IReducedSpeedArea

**ppSpeedArea)
Returns a single ReducedSpeedArea of the collection selected by position.
This is useful only when all reduced speed areas shall be accessed (see the
ReducedSpeedAreas example above). To select a reduced speed area by
its identifier number use GetReducedSpeedAreaByNumber (see below).
Since Item is the default property for a collection the following commands
are equivalent:
SET speedarea = speedareas(1)
SET speedarea = speedareas.Item(1)
Parameters
[in] long Index: index between 1 and Count
[out, retval] IReducedSpeedArea **ppSpeedArea: returned ReducedSpeedArea

66 VISSIM 5.10-06 © PTV AG 2009

 Network

Count ([out, retval] long *pCount)

Returns the number of ReducedSpeedArea objects in the collection. See the
ReducedSpeedAreas example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IReducedSpeedAreas Interface

GetReducedSpeedAreaByNumber ([in] long Number, [out, retval]

IReducedSpeedArea ** ppSpeedArea)
Returns the ReducedSpeedArea object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IReducedSpeedArea ** ppSpeedArea: returned ReducedSpeedArea
Example
SET speedarea = speedareas.GetReducedSpeedAreaByNumber (2)
IF NOT (speedarea IS NOTHING) THEN
name = speedarea.AttValue(“NAME”)
END IF

3.4.1.10 ReducedSpeedArea
A ReducedSpeedArea ReducedSpeedAreas ReducedSpeedArea
object represents a
reduced speed area
element and belongs to
the ReducedSpeedAreas
object. It can be
accessed through the
ReducedSpeedAreas
object to in two ways:
► access via iteration through the collection
DIM speedarea As ReducedSpeedArea
FOR EACH speedarea IN vissim.Net.ReducedSpeedAreas
List.AddItem speedarea.ID
NEXT speedarea
► individual access via identifier
DIM speedarea As ReducedSpeedArea
SET speedarea = vissim.Net.ReducedSpeedAreas.
GetReducedSpeedAreaByNumber (12)
The ReducedSpeedArea object enables access to the properties of the
reduced speed area through the IReducedSpeedArea interface.

COM Interface Manual © PTV AG 2009 67

3 Language Reference

Properties of the Interface IReducedSpeedArea

ID ([out, retval] long *pID)

Returns the reduced speed area identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = speedarea.ID

Name ([out, retval] BSTR *pName)

Returns the name of the reduced speed area.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = speedarea.Name

Name ([in] BSTR Name)

Sets the name of the reduced speed area. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
speedarea.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a reduced speed area attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = speedarea.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a reduced speed area attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
speedarea.AttValue(„NAME“)=„XXX“

68 VISSIM 5.10-06 © PTV AG 2009

 Network

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 TIMEFROM Time interval start of activation[s].
9 9 TIMEUNTIL Time interval end of activation[s].
9 9 DESIREDSPEED Desired speed distribution number of the
first vehicle class.
9 VEHICLECLASSES Affected vehicle classes (Array of numbers)
9 VEHICLETYPES Affected vehicle types (Array of numbers)

It is required that TIMEUNTIL is greater or equal than TIMEFROM when

setting the interval. If the current interval is [100, 1000] and you want to set
it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a reduced speed area attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a reduced speed area attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 DESIREDSPEED Desired speed distribution number. Parameter:
vehicle class.
9 9 VEHICLECLASS TRUE if the vehicle class is affected.
Parameter: vehicle class number.

COM Interface Manual © PTV AG 2009 69

3 Language Reference

R W Attribute Description
9 VEHICLETYPE TRUE if the vehicle class is affected.
Parameter: vehicle type number.

Changes will affect immediately if called during a simulation.

3.4.2 Area-based (Pedestrians)

3.4.2.1 PedAreas
The PedAreas object is a Net

collection of PedArea objects

PedAreas PedArea
(see page 72). It belongs to
the Net object and can be
accessed through the
PedAreas property of the
INet interface.
It contains all pedestrian areas of the loaded network and allows the iteration
through all of them as well as individual access (see also PedArea object).
Example
Instantiation of PedAreas object and access to all its PedArea objects:
Dim vissim As Vissim
Dim pedareas As PedAreas
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set pedareas = Vissim.Net.PedAreas

FOR EACH pedarea IN pedareas ‘access to the method _NewEnum to create an enumeration
…
NEXT pedarea

‘or also:

FOR i = 1 TO pedareas.Count
SET pedarea = pedareas(i) ‘or pedareas.Item(i)
…
NEXT i

70 VISSIM 5.10-06 © PTV AG 2009

 Network

Properties of the IPedAreas Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all PedArea objects in
the current network. Once a collection is created, individual members can be
returned using the PedAreaByNumber method, while the entire collection
can be iterated through using a FOR ...TO ... NEXT statement. In Visual
Basic you can use the statement FOR EACH…NEXT without using
_NewEnum, which VB calls internally (see PedAreas example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedArea **ppLink)

Returns a single PedArea of the collection selected by position. This is
useful only when all pedestrian areas shall be accessed (see the PedAreas
example above). To select a pedestrian area by its identifier number use
PedAreaByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET pedarea = pedareas(1)
SET pedarea = pedareas.Item(1)
Parameters
[in] long Index: index between 1 and PedAreas.Count
[out, retval] IPedArea **ppPedArea: returned PedArea object

Count ([out, retval] long *pCount)

Returns the number of PedArea objects in the collection. See the PedAreas
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedAreas Interface

PedAreaByNumber ([in] long Number, [out, retval] IPedArea

**ppPedArea)
Returns the PedArea object with the identifier number Number.
Parameters
[in] long Number: pedestrian area identifier
[out, retval] IPedArea **ppPedArea: returned PedArea object
Example
SET pedarea = pedareas.PedAreaByNumber(1001)

COM Interface Manual © PTV AG 2009 71

3 Language Reference

3.4.2.2 PedArea
This object represents a PedAreas PedArea
pedestrian area element and
belongs to the PedAreas
object. A PedArea object can
be accessed through the
PedAreas object in two ways:
► access via iteration through the collection
DIM pedareas As PedAreas
DIM pedarea As PedArea
SET pedareas = Vissim.Net.PedAreas
FOR EACH pedarea IN pedareas
List.AddItem pedarea.ID
NEXT pedarea
► individual access via identifier
DIM pedareas As PedAreas
DIM pedarea As PedArea
SET pedareas = Vissim.Net.PedAreas
SET pedarea = pedareas. PedAreaByNumber(1000)
The PedArea object enables access to the properties of the pedestrian area
through the IPedArea interface.

Properties of the IPedArea Interface

ID ([out, retval] long *pID)

Returns the pedestrian area identifier number. If the PedArea object doesn’t
refer to a valid VISSIM pedestrian area element anymore the returned value
is 0.
Parameters
[out, retval] long *pID : returned identifier (0 if reference no longer valid)
Example
DIM pedarea AS PedArea
id = pedarea.ID

Name ([out, retval] BSTR *pName)

Returns the pedestrian area name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pedarea.Name

Name ([in] BSTR Name)

Sets the pedestrian area name. Maximal 255 charatcters.

72 VISSIM 5.10-06 © PTV AG 2009

 Network

Parameters
[in] BSTR Name : new name.
Example
pedarea.Name = „Picadilly Circus“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian area attribute. Please get the language independent
attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
polyline = pedarea.AttValue(„POINTS“)
FOR i = LBOUND(polyline) TO UBOUND(polyline)
x = polyline (i).X
y = polyline (i).Y
NEXT i

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian area attribute. Please get the language independent
attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
pedarea.AttValue(„NAME“) = “Times Square”

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

Methods of the IPedArea Interface

COM Interface Manual © PTV AG 2009 73

3 Language Reference

3.4.3 PedAreaBehaviorTypes
The PedAreaBehaviorTypes Net

object is a collection of
PedAreaBehaviorTypes PedAreaBehaviorType
PedAreaBehaviorType objects
(see page 75).
It belongs to the Net object and can be accessed through the
PedAreaBehaviorTypes property of the INet interface. It contains all area
behavior types of the loaded network and allows the iteration through all of
them as well as individual access (see also PedAreaBehaviorType object).
Example
Instantiation of a PedAreaBehaviorTypes object and access to all its
PedAreaBehaviorType objects:
DIM vissim As Vissim
DIM abts As PedAreaBehaviorTypes
DIM abt As PedAreaBehaviorType
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set abts = Vissim.Net.PedAreaBehaviorTypes
FOR EACH abt IN abts ‘access to _NewEnum to create an enumeration
…
NEXT abt

‘or also:

FOR i = 1 TO abts.Count
SET abt = abts(i) ‘or abts.Item(i)
…
NEXT i

Properties of the IPedAreaBehaviorTypes Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all
PedAreaBehaviorType objects. Once a collection is created, individual
members can be returned using the PedAreaBehaviorTypeByNumber
method, while the entire collection can be iterated using a FOR ...TO ...
NEXT statement. In Visual Basic you can use the statement FOR
EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see PedAreaBehaviorTypes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedAreaBehaviorType **ppABT)

Returns a single PedAreaBehaviorType of the collection selected by
position. This is useful only when all area behavior types shall be accessed

74 VISSIM 5.10-06 © PTV AG 2009

 Network

(see the PedAreaBehaviorTypes example above). To select an area

behavior type by its identifier number use PedAreaBehaviorTypeByNumber
(see below). Since Item is the default property for a collection the following
commands are equivalent:
SET abt = abts(1)
SET abt = abts.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedAreaBehaviorType **ppABT: returned PedAreaBehaviorType object

Count ([out, retval] long *pCount)

Returns the number of PedAreaBehaviorType objects in the collection. See
the PedAreaBehaviorTypes example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedAreaBehaviorTypes Interface

PedAreaBehaviorTypeByNumber ([in] long Number, [out, retval]

IPedAreaBehaviorType **ppABT)
Returns the PedAreaBehaviorType object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedAreaBehaviorType **ppABT : returned PedAreaBehaviorType object
Example
SET abt = abts.PedAreaBehaviorTypeByNumber(2)
IF NOT (abt IS NOTHING) THEN
name = abt.AttValue(“NAME”)
END IF

3.4.4 PedAreaBehaviorType
A PedAreaBehaviorType PedAreaBehaviorTypes PedAreaBehaviorType
object represents an area
behavior type element and
belongs to the
PedAreaBehaviorTypes
object.
It can be accessed through the PedAreaBehaviorTypes object to in two
ways:
► access via iteration through the collection
DIM abt As PedAreaBehaviorType
FOR EACH abt IN vissim.Net.PedAreaBehaviorTypes

COM Interface Manual © PTV AG 2009 75

3 Language Reference

List.AddItem abt.ID
NEXT abt
► individual access via identifier
DIM abt As PedAreaBehaviorType
SET abt = vissim.Net.PedAreaBehaviorTypes.PedAreaBehaviorTypeByNumber(2)
The PedAreaBehaviorType object enables access to the properties of the
area behavior type through the IPedAreaBehaviorType interface.

Properties of the Interface IPedAreaBehaviorType

ID ([out, retval] long *pID)

Returns the identifier number of the area behavior type.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = abt.ID

Name ([out, retval] BSTR *pName)

Returns the name of the area behavior type.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = abt.Name

Name ([in] BSTR Name)

Sets the name of the area behavior type. Maximal 255 characters.
Parameters
[in] BSTR Name : new name.
Example
abt.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns an area behavior type attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = abt.AttValue(„NAME“)

76 VISSIM 5.10-06 © PTV AG 2009

 Network

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets an area behavior type attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
abt.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

COM Interface Manual © PTV AG 2009 77

3 Language Reference

3.5 Traffic

3.5.1 Vehicles

3.5.1.1 Vehicles
The Vehicles object is a Net
collection of Vehicle
objects (see page 84). It
belongs to the Net object Vehicles Vehicle
and can be accessed
through the Vehicles
property of the INet
interface.
It contains all vehicles currently traveling on the network during a simulation,
including the parked ones. It enables iteration through the collection or
individual access to a Vehicle object.
Example
Instantiation of a Vehicles object and access to all its Vehicle objects:
DIM vissim As Vissim
DIM vehicles As Vehicles
DIM vehicle As Vehicle
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set vehicles = Vissim.Net.Vehicles
FOR EACH vehicle IN vehicles ‘access to _NewEnum to create an enumeration
…
NEXT vehicle

‘or also:

FOR i = 1 TO vehicles.Count
SET vehicle = vehicles(i) ‘or vehicles.Item(i)
…
NEXT i

Properties of the IVehicles Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all Vehicle objects.
Once a collection is created, individual members can be returned using the
GetVehicleByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the

78 VISSIM 5.10-06 © PTV AG 2009

 Traffic

statement FOR EACH…NEXT without using the property _NewEnum, which

VB calls internally. (see Vehicles example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IVehicle **ppVehicle)

Returns a single Vehicle of the collection selected by position. This is useful
only when all vehicles shall be accessed (see the Vehicles example above).
To select a vehicle by its identifier number use GetVehicleByNumber (see
below). Since Item is the default property for a collection the following
commands are equivalent:
SET vehicle = vehicles(1)
SET vehicle = vehicles.Item(1)
Parameters
[in] long Index : index between 1 and vehicles.Count
[out, retval] IVehicle **ppVehicles: returned Vehicle object

Count ([out, retval] long *pCount)

Returns the number of Vehicle objects in the collection. See the Vehicles
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

IDs ([in, defaultvalue(0)] BSTR Attribute, [in, defaultvalue(0)] VARIANT

Value, [out, retval] VARIANT *pIDs)
Returns an array of vehicle IDs complying the condition “Attribute = Value” if
a vehicle attribute an a value (see the attribute table on page 85) are given,
otherwise an array with the IDs of all vehicles in the collection is returned.
Parameters
[in] BSTR Attribute : attribute name (see IVehicle attribute table)
[in] VARIANT Value : attribute value or array of values (type according to
attribute)
[out, retval] VARIANT *pIDs : returned array of IDs.
Example
ids = vehicles.IDs(„TYPE“, 1) ‘array with the IDs of all vehicles of type 1

Methods of the IVehicles Interface

GetVehicleByNumber ([in] long Number, [out, retval] IVehicle

**ppVehicle)
Returns the Vehicle object with the identifier number Number.
Parameters
[in] long Number : identifier number

COM Interface Manual © PTV AG 2009 79

3 Language Reference

[out, retval] IVehicle **ppVehicle : returned Vehicle object

Example
DIM vehicle AS Vehicle
SET vehicle = vehicles.GetVehicleByNumber (11)
IF NOT (vehicle IS NOTHING) THEN
speed = vehicle.AttValue(“SPEED”)
END IF

GetMultiAttValues ([in] VARIANT IDs, [in] BSTR Attribute, [out]

VARIANT *pValues)
Fills the array pValues with the respective attribute values for the requested
IDs (use the Variant Empty to get it for all vehicles in the collection). Please
get the language independent attribute tag from the table on page 85.
Parameters
[in] VARIANT IDs : array of vehicle IDs or vehicle ID
[in] BSTR Attribute : attribute name (see IVehicle attribute table)
[out] VARIANT *pValues : returned array of values
Example
vehs.GetMultiAttValues Array(1, 2, 3, 4, 5), "SPEED", values)
For i = LBound(values) To UBound(values)
val = values (i)
Next i

SetMultiAttValues ([in] VARIANT IDs, [in] BSTR Attribute, [in] VARIANT

Values)
Sets the attribute values of every required vehicle in the passed array of IDs
with their respective new values (use the Variant Empty to set it for all
vehicles in the collection). If a value, instead of an array of values, is passed
the same value will be used for every vehicle. Please get the language
independent attribute tag from the table on page 85.
Parameters
[in] VARIANT IDs : array of vehicle IDs or vehicle ID
[in] BSTR Attribute : attribute name (see IVehicle attribute table)
[in] VARIANT Values : array of values or value (type according to attribute)
Example
vehs.SetMultiAttValues Empty, "COLOR”, RGB(255, 0, 0)

AddVehicleInZone ([in] long Type, [in] long ZoneNr, [out, retval]

IVehicle **ppVehicle)
This method places a new vehicle of type Type in the specified zone
number. The parking lot will be selected from the set of all parking lots with
this zone number according to their relative flows. If a non valid type or zone
number is passed an error will be returned and no vehicle will be created.
The vehicle gets the current simulation time as its departure time (0 if no
simulation is running) and will depart as soon as it has been assigned a
destination zone, destination parking lot or a path (see attributes
“DESTZONE”, “DESTPARKLOT” and “PATH” of IVehicle on page 85).

80 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Parameters
[in] long Type : vehicle type according to the current network
[in] long ParkingID : parking lot identifier number
[out, retval] IVehicle **ppVehicle : returned Vehicle object
Example
DIM vehicle AS Vehicle
vehicle = vehicles.AddVehicleInZone (1, 2)

AddVehicleInParkingLot ([in] long Type, [in] long ParkingID, [out,

retval] IVehicle **ppVehicle)
This method places a new vehicle of type Type on the parking lot identified
with the number ParkingID. If a non valid type or parking lot number is
passed an error will be returned and no vehicle will be created. The vehicle
gets the current simulation time as its departure time (0 if no simulation is
running) and will depart as soon as it has been assigned a path (see
attribute “PATH” of IVehicle on page 85).
Parameters
[in] long Type : vehicle type according to the current network
[in] long ParkingID : parking lot identifier number
[out, retval] IVehicle **ppVehicle : returned Vehicle object
Example
DIM vehicle AS Vehicle
vehicle = vehicles.AddVehicleInParkingLot (1, 10)

AddVehicleAtLinkCoordinate ([in] long Type, [in] double DesiredSpeed,

[in] long Link, [in] int Lane, [in] double XCoord, [in, defaultvalue(1)]
BYTE Interaction, [out, retval, defaultvalue(0)] IVehicle **ppVeh)
This method places a new vehicle of type Type on the lane Lane at the link
coordinate XCoord of link Link. The standard mode of this method will let the
placed vehicle interact with their neighbors and set its speed according to
the current situation and to the DesiredSpeed. It is also possible to set the
flag Interaction to false (0) and let the vehicle ignore the traffic flow
conditions, traveling directly at its desired speed. As a difference to the
method AddVehicleInZone or AddVehicleInParkingLot, the vehicles placed
this way don’t travel with a specific path and they will depart on the next
simulation second. Therefore calling this method with the simulation not
running will cause an error.
Parameters
[in] long Type : vehicle type according to the current network
[in] double DesiredSpeed: desired speed (speed if interaction is disabled)
[in] long Link : link identifier number
[in] int Lane : lane number (from 1 to n according to the link)
[in] double XCoord : link coordinate (from 0.0 to link length)
[in] BYTE Interaction: interaction flag (true as a default)
[out, retval] IVehicle **ppVeh : returned Vehicle object
Example
DIM vehicle AS Vehicle
vehicle = vehicles.AddVehicleAtLinkCoordinate (1, 40.0, 1000, 1, 20.0)

COM Interface Manual © PTV AG 2009 81

3 Language Reference

AddVehicleInTransitLine ([in] long Type, [in] long TranslitLineNr, [out,

retval] IVehicle **ppVehicle)
This method places a new vehicle of type Type into the specified transit line.
If a non valid type or transit line number is passed an error will be returned
and no vehicle will be created. The vehicle will depart on the next simulation
second.
Parameters
[in] long Type : vehicle type according to the current network
[in] long ParkingID : parking lot identifier number
[out, retval] IVehicle **ppVehicle : returned Vehicle object
Example
DIM vehicle AS Vehicle
vehicle = vehicles.AddVehicleInParkingLot (1, 10)

RemoveVehicle ([in] long Number)

Removes the vehicle with the number Number from the network, whether it
is parked or not.
Parameters
[in] long Number : vehicle identifier number
Example
vehicles.RemoveVehicle (112)

GetQueued ([out, retval] IVehicles **ppVehicles)

This method returns a collection of Vehicle objects containing all vehicles
that are in a queued condition (according to the current queue configuration).
Parameters
[out, retval] IVehicles **ppVehicles : returned Vehicles object
Example
DIM queued_vehicles AS Vehicles
queued_vehicles = vehicles.GetQueued

GetArrived ([out, retval] IVehicles **ppVehicles)

This method returns a collection of vehicle objects containing all vehicles
that have reached their destination parking lot (according to the assigned
path) in the last simulation step. Vehicles created through OD-matrices
disappear when reaching their parking lot destination and thus can not be
accessed with this method.
Parameters
[out, retval] IVehicles **ppVehicles : returned Vehicles object
Example
DIM arrived_vehicles AS Vehicles
arrived_vehicles = vehicles.GetArrived

82 VISSIM 5.10-06 © PTV AG 2009

 Traffic

GetParked ([out, retval] IVehicles **ppVehicles)

This method returns a collection of vehicle objects containing all vehicles
that are parked in parking lots. (Vehicles defined by a matrix file are visible
only in their origin parking lot, vehicles defined by a trip chain file or set into
the network through the COM interface are visible in their destination parking
lot as well.)
Parameters
[out, retval] IVehicles **ppVehicles : returned Vehicles object
Example
DIM parked_vehicles AS Vehicles
parked_vehicles = vehicles.GetParked

Useful to know

Attributes
The named attributes for the AttValue methods are the same as the ones
used in the IVehicle interface (see attribute table on page 85)

Vehicles collections
Vehicles are dynamic network elements (i.e. the are created, removed and
changed during a simulation run). Therefore, vehicle collections are also
dynamic and change their internal elements (vehicles) and order of the
elements during the simulation. In a client programming context this means
that a collection variable refers to the current network status. In the following
example the vehicles collection variable queued_vehicles may not contain
the same vehicles after the simulation step (i.e. n_before and n_after could
differ):
DIM queued_vehicles AS Vehicles
queued_vehicles = vehicles.GetQueued
n_before = queued_vehicles.Count
sim.RunSimulationStep
n_after = queued_vehicles.Count

AddVehicleAtLinkCoordinate
When adding a vehicle to a link coordinate the vehicle will be appear at that
coordinate with the next simulation step. Use the method Redraw of
IGraphics to see the vehicle.

Virtual memory option

The virtual memory check box for parked vehicles within the dynamic
assignment options, has no effect on vehicles inserted with the method
AddVehicleInParkingLot().

COM Interface Manual © PTV AG 2009 83

3 Language Reference

3.5.1.2 Vehicle
A Vehicle object represents a single Vehicles Vehicle
vehicle and belongs to the Vehicles
object. It can be accessed through the
Vehicles object in two ways:
► access via iteration through the collection
DIM vehicle As Vehicle
FOR EACH vehicle IN vissim.Net.Vehicles
List.AddItem vehicle.ID
NEXT vehicle
► individual access via identifier number
DIM vehicle As Vehicle
SET vehicle = vissim.Net.Vehicles.GetVehicleByNumber (101)
The Vehicle object enables access to the properties of the vehicle through
the IVehicle interface. It is not guaranteed that an instantiated Vehicle object
refers to a valid vehicle in VISSIM after the execution of a simulation step
(please refer to the note at the end of this section about the dynamic aspect
of vehicles). Use the property ID (see below) for a validity check.

Properties of the IVehicle Interface

ID ([out, retval] long *pID)

Returns the vehicle’s identifier number. . If the Vehicle object doesn’t refer to
a valid VISSIM vehicle anymore the returned value is 0.
Parameters
[out, retval] long *pID : returned identifier (0 if reference no longer valid)
Example
id = vehicle.ID

Name ([out, retval] BSTR *pName)

Returns the vehicle’s name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = vehicle.Name

Name ([in] BSTR Name)

Sets the vehicle’s name.
Parameters
[in] BSTR Name : new name.
Example
vehicle.Name = „KA-LK 240“

84 VISSIM 5.10-06 © PTV AG 2009

 Traffic

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a vehicle attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
speed = vehicle.AttValue(„SPEED“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a vehicle attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value (type according to attribute)
Example
vehicle.AttValue(„PATH“)= 1

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 BOARDEDPASS Number of boarding passengers
9 9 COLOR Color in RGB format
9 9 ALIGHTEDPASS Number of alighting passengers
9 DESLANECHANGE Desired lane change (1=left, 0=none, -
1=right)
9 9 DESIREDSPEED Desired speed in the units of the current
options
9 9 DESSPEEDFRACTIL Random selected fractil (0,1) for desired
speed selection
9 9 DESTPARKLOT Destination parking lot number (0 if none)
9 9 DESTZONE Destination zone number (0 if none)
9 ELAPSEDTIME Total time in network [s]
9 9 INTERACTION Flag (true/false) if vehicle interacts with
neighborhood
9 9 LANE Current lane on which the vehicle is
positioned
9 LANECHANGE Current lane change (1=left, 0=none, -

COM Interface Manual © PTV AG 2009 85

3 Language Reference

R W Attribute Description
1=right)
9 LASTLANECHANGE Time since last lane change started [s]
9 LASTNODE Previous node number to be traveled (0 if
none)
9 9 LENGTH Real vehicle length (current units set)
9 9 LINK Current link where the vehicle is
positioned
9 9 LINKCOORD Current x coordinate of the current link
9 NEXTNODE Next node number to be traveled (0 if
none)
9 ORIGPARKLOT Origin parking lot number (0 if none)
9 ORIGZONE Origin zone number (0 if none)
9 9 PARKLOT Parking lot number where the vehicle is
parked (0 if none)
9 9 PASSENGERS Number of passengers in the vehicles
9 9 PATH Current used path number (0 if none)
9 POINT World coordinates of vehicle’s position
(see note below)
9 PRECEDING Number of the next (not necessarily
relevant) vehicle downstream
9 QUEUECOUNTER Number of queue encounters
9 9 SPEED Current speed in the units of the current
options
9 TOTALDISTANCE Total distance traveled in the network
(current units set)
9 TRAILING Number of the next (not necessarily
relevant) vehicle upstream
9 9 TYPE Vehicle type number
9 9 3DMODELSTATE 3D model state (vehicles with pedestrian
categorie are excluded)
9 9 WEIGHT Vehicle total weight [mt]
See page 174 for a note on the RGB color format

The coordinates of a world point are available through the interface

IWorldPoint described in page 213

86 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Methods of the IVehicle Interface

MoveToLinkCoordinate ([in] long Link, [in] int Lane, [in] double

XCoord)
This method places a vehicle on the lane Lane at the link coordinate XCoord
of link Link. It is only applicable to vehicles traveling on the network. If the
vehicle is parked the method will not have any effect.
Parameters
[in] long Link : link identifier number
[in] int Lane : lane number (from 1 to n according to the link)
[in] double XCoord : link coordinate (from 0.0 to link length)
Example
DIM vehicle AS Vehicle
SET vehicle = vehicles.GetVehicleByNumber (12)
vehicle.MoveToLinkCoordinate (1000, 1, 20.0)

Useful to Know

Attributes
LINK: writing on this attribute has the same effect as the method
MoveToLinkCoordinate applied to the assigned link number and to the
current lane and coordinate.
DESTZONE: writing on this attribute will assign to the vehicle a route of the
dynamic assignment path set driving to a parking lot destination choosen
according to the parking lot selection model of the dynamic assignment. If no
route is possible the vehicle won’t depart.
DESTPARKLOT: writing on this attribute will assign to the vehicle a route of
the dynamic assignment path set driving to the specified parking lot. If no
route is possible the vehicle won’t depart.
PATH: it is possible to use this attribute for re-routing overwriting the current
assigned path with a new overlapping path and when the vehicle is driving
on the overlapping section.
LINKCOORD: writing on this attribute has the same effect as the method
MoveToLinkCoordinate applied to the current link and lane but changing the
coordinate to the assigned value.
PARKLOT: writing on this attribute moves a parked vehicle to the assigned
parking lot number. If the vehicle is not parked the assignment will no have
any effect.
INTERACTION: turning the interaction off will let the vehicle traveling at
constant speed without paying attention to vehicles ahead.

COM Interface Manual © PTV AG 2009 87

3 Language Reference

Vehicle is a dynamic network element

Vehicles are dynamic network elements (i.e. the are created, removed and
changed during a simulation run). In a client programming context this
means that a vehicle variable refers to the current network status. In the
following example the speed variable may not be the same value after the
simulation step (i.e. speed_before and speed_after could differ):
DIM veh AS Vehicle
SET veh = vehicles.GetVehicleByNumber(1)
speed_before = veh.AttValue(“SPEED”)
sim.RunSimulationStep
speed_after = veh.AttValue(“SPEED”)

3.5.2 Private Traffic

3.5.2.1 Routes
The Routes object RoutingDecision
is a collection of
Route objects (see
page 99). It Routes Route
belongs to the
RoutingDecision
object and can be
accessed through
the Routes
property of the
IRoutingDecision
interface.
It contains all routes of the routing decsion and allows the iteration through
all of them as well as individual access (see also Route object).
Example
Instantiation of a Routes object and access to all its Route objects:
DIM vissim As Vissim
DIM routes As Routes
DIM route As Route
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET routes = Vissim.Net.RouteDecisions(1).Routes
FOR EACH route INroutes ‘access to _NewEnum to create an enumeration
…
NEXT route

‘or also:

FOR i = 1 TO routes.Count
SET route = routes (i) ‘or routes.Item(i)
…

88 VISSIM 5.10-06 © PTV AG 2009

 Traffic

NEXT i

Properties of the IRoutes Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all Route objects.
Once a collection is created, individual members can be returned using the
GetRouteByNumber method, while the entire collection can be iterated using
a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally (see Routes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IRoute **ppRoute)

Returns a single Route of the collection selected by position. This is useful
only when all routes shall be accessed (see the Routes example above). To
select a route by its identifier number use GetRouteByNumber (see below).
Since Item is the default property for a collection the following commands
are equivalent:
SET route = routes(1)
SET route = routes.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IRoute **ppRoutes: returned Route object

Count ([out, retval] long *pCount)

Returns the number of Route objects in the collection. See the Routes
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IRoutes Interface

GetRouteByNumber ([in] long Number, [out, retval] IRoute **ppRoute)

Returns the Route object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IRoute **ppRoute : returned Route object
Example
SET route = routes.GetRouteByNumber(2)

COM Interface Manual © PTV AG 2009 89

3 Language Reference

IF NOT (route IS NOTHING) THEN

rf = route.AttValue(“RELATIVEFLOW”)
END IF

AddRoute ([in] long Link, [in] double Xcoord, [out, retval] long
*pNumber)
Adds a new route with the specified specified link coordinate destination and
with a default relative flow 1.0 for each time interval. If successful, it returns
the assigned number, otherwise 0.
Parameters
[in] long Link : Destination link identifier number
[in] double XCoord : Destination link coordinate
[out, retval] long *pNumber : returned route identifier number
Example
id = decisions.AddStaticRoutingDecision(1, 100.0)
SET decision = decisions.GetRoutingDecisionByNumber (id)
IF NOT (decision IS NOTHING) THEN
decision.AddRoute(2, 200.0)
END IF

RemoveRoute ([in] long Number)

Removes the route with the specified identifier number.
Parameters
[in] long Number : Identifier number

3.5.2.2 Route
A Route object represents a Routes Route
route element of a routing
decision and belongs to the
Routes object. It can be
accessed through the
Routes object to in two
ways:
► access via iteration through the collection
DIM routes As Routes
DIM route As Route
SET routes = Vissim.Net.RouteDecisions(1).Routes
FOR EACH route IN routes
List.AddItem route.ID
NEXT route
► individual access via identifier
DIM route As Route
SET route = vissim.Net.RouteDecisions(1).Routes.GetRouteByNumber (12)
The Route object enables access to the properties of the route through the
IRoute interface.

90 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Properties of the Interface IRoute

ID ([out, retval] long *pID)

Returns the route identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = route.ID

Name ([out, retval] BSTR *pName)

Returns the route name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = route.Name

Name ([in] BSTR Name)

Sets the route’s name.
Parameters
[in] BSTR Name : new name.
Example
route.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a route attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = route.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a route attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
route.AttValue(„NAME“)=„XXX“

COM Interface Manual © PTV AG 2009 91

3 Language Reference

Attribute outline

R W Attribute Description
9 ID Identifier number
9 NAME Name

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a route attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a route attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow of time intervall. Parameter: time
interval index (1..n).

Changes will affect immediately if called during a simulation.

3.5.2.3 RoutingDecisions
The Routing- Net
Decisions object is
a collection of
RoutingDecision RoutingDecisions RoutingDecisio
objects (see page n
95).
It belongs to the Net object and can be accessed through the
RoutingDecisions property of the INet interface. It contains all routing

92 VISSIM 5.10-06 © PTV AG 2009

 Traffic

decisions of the loaded network and allows the iteration through all of them
as well as individual access (see also RoutingDecision object).
Example
Instantiation of a RoutingDecisions object and access to all its
RoutingDecision objects:
DIM vissim As Vissim
DIM decisions As RoutingDecisions
DIM decision As RoutingDecision
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET decisions = Vissim.Net.RoutingDecisions
FOR EACH decision IN decisions ‘access to _NewEnum to create an enumeration
…
NEXT decision

‘or also:

FOR i = 1 TO decisions.Count
SET decision = decisions(i) ‘or decisions.Item(i)
…
NEXT i

Properties of the IRoutingDecisions Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all RoutingDecision
objects. Once a collection is created, individual members can be returned
using the GetRoutingDecisionByNumber method, while the entire collection
can be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you
can use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally. (see RoutingDecisions example
above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IRoutingDecision **ppDecision)

Returns a single RoutingDecision of the collection selected by position. This
is useful only when all routing decisions shall be accessed (see the
RoutingDecisions example above). To select a routing decision by its
identifier number use GetRoutingDecisionByNumber (see below). Since Item
is the default property for a collection the following commands are
equivalent:
SET decision = decisions(1)
SET decision = decisions.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IRoutingDecision **ppDecision: returned RoutingDecision object

COM Interface Manual © PTV AG 2009 93

3 Language Reference

Count ([out, retval] long *pCount)

Returns the number of RoutingDecision objects in the collection. See the
RoutingDecisions example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IRoutingDecisions Interface

GetRoutingDecisionByNumber ([in] long Number, [out, retval]

IRoutingDecision **ppDecision)
Returns the RoutingDecision object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IRoutingDecision **ppDecision : returned RoutingDecision object
Example
SET decision = decisions.GetRoutingDecisionByNumber (2)
IF NOT (decision IS NOTHING) THEN
name = decision.AttValue(“NAME”)
END IF

AddStaticRoutingDecision ([in] long Link, [in] double Xcoord, [out,

retval] long *pNumber)
Adds a new static routing decision at the specified link coordinate and with
the default time interval 0-99999. If successful, it returns the assigned
number, otherwise 0.
Parameters
[in] long Link : Link identifier number
[in] double XCoord : Link coordinate
[out, retval] long *pNumber : returned routing decision identifier number
Example
id = decisions.AddStaticRoutingDecision(1, 100.0)
SET decision = decisions.GetRoutingDecisionByNumber (id)
IF NOT (decision IS NOTHING) THEN
decision.AddRoute(2, 200.0)
END IF

RemoveRoutingDecision ([in] long Number)

Removes the routing decision with the specified identifier number.
Parameters
[in] long Number : Identifier number

94 VISSIM 5.10-06 © PTV AG 2009

 Traffic

3.5.2.4 RoutingDecision
A RoutingDecision object RoutingDecisions RoutingDecision
represents a routing decision
element and belongs to the
RoutingDecisions object.
It can be accessed through the RoutingDecisions object to in two ways:
► access via iteration through the collection
DIM decision As RoutingDecision
FOR EACH decision IN vissim.Net.RoutingDecisions
List.AddItem decision.ID
NEXT decision
► individual access via identifier
DIM decision As RoutingDecision
SET decision = vissim.Net.RoutingDecisions.GetRoutingDecisionByNumber (12)
The RoutingDecision object enables access to the properties of the routing
decision through the IRoutingDecision interface.

Properties of the Interface IRoutingDecision

ID ([out, retval] long *pID)

Returns the routing decision identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = decision.ID

Name ([out, retval] BSTR *pName)

Returns the routing decision name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = decision.Name

Name ([in] BSTR Name)

Sets the decision’s name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
decision.Name = „XXX“

COM Interface Manual © PTV AG 2009 95

3 Language Reference

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a routing decision attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = decision.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a routing decision attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
decision.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 VEHICLECLASSES Affected vehicle classes (Array of numbers)
9 VEHICLETYPES Affected vehicle types (Array of numbers)

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a routing decision attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a routing decision attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

96 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow for the curring time intervall (the
first one if no simulation is running).
Parameter: routing number.
9 9 TIMEFROM Time interval start [s]. Parameter: interval
time order (1..n)
9 9 TIMEUNTIL Time interval end [s]. Parameter: interval time
order (1..n)
9 9 VEHICLECLASS TRUE if the vehicle class is affected.
Parameter: vehicle class number (0 for all
vehicle types)
VEHICLETYPE TRUE if the vehicle class is affected.
Parameter: vehicle type number.

Changes will affect immediately if called during a simulation.

It is required that TIMEUNTIL is greater or equal than TIMEFROM when

setting the interval. If the current interval is [100, 1000] and you want to set
it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [out, retval] VARIANT *pValue)
Returns a routing decision attribute with two parameters. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] VARIANT Parameter1 : first attribute dependent parameter
[in] VARIANT Parameter2 : second attribute dependent parameter
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [in] VARIANT Value)
Sets a routing decision attribute with two parameters. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see table below)
[in] VARIANT Parameter1 : first attribute dependent parameter
[in] VARIANT Parameter2 : second attribute dependent parameter
[in] VARIANT Value : Attribute value. (type according to attribute)

COM Interface Manual © PTV AG 2009 97

3 Language Reference

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow for time intervall and routing
number. Parameter1: routing number.
Parameter2: a time point of the requested
time interval.

Changes will affect immediately if called during a simulation.

Routes ([out, retval] IRoutes **ppRoutes)

Creates an instance of a Routes object (see page 99), that gives individual
access to the routes defined in the network for this routing decision.
Parameters
[out, retval] IRoutes **ppRoutes : returned Routes object
Example
DIM routes AS Routes
DIM decision As RoutingDecision
SET decision = vissim.Net.RoutingDecisions.GetRoutingDecisionByNumber (10)
SET routes = decision.Routes

Methods of the IRoutingDecision Interface

AddTimeInterval ([in] double From, [in] double To, [out, retval] long
*pIndex)
Adds a new time interval. If successful, it returns the assigned list postion
index (1..n), otherwise 0.
Parameters
[in] double From : Time interval start
[in] double To : Time interval end
[out, retval] long *pIndex : returned list position index
Example
id = decisions.AddStaticRoutingDecision(1, 100.0)
SET decision = decisions.GetRoutingDecisionByNumber (id)
IF NOT (decision IS NOTHING) THEN
decision.AttValue1(“TIMEUNTIL”, 1) = 1799 ‘sets default time interval to [0-1799]
index = decision.AddTimeInterval(1800, 3600)
END IF

98 VISSIM 5.10-06 © PTV AG 2009

 Traffic

3.5.2.5 TrafficCompositions
The TrafficCompositions Net
object is a collection of
TrafficComposition TrafficCompositions TrafficComposition
objects (see page 185).

It belongs to the Net object and can be accessed through the

TrafficCompositions property of the INet interface. It contains all traffic
compositions of the loaded network and allows the iteration through all of
them as well as individual access (see also TrafficComposition object).
Example
Instantiation of a TrafficCompositions object and access to all its
TrafficComposition objects:
DIM vissim As Vissim
DIM tcs As TrafficCompositions
DIM tc As TrafficComposition
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set tcs = Vissim.Net.TrafficCompositions
FOR EACH tc IN tcs ‘access to _NewEnum to create an enumeration
…
NEXT tc

‘or also:

FOR i = 1 TO tcs.Count
SET tc = tcs(i) ‘or tcs.Item(i)
…
NEXT i

Properties of the ITrafficCompositions Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all TrafficComposition
objects. Once a collection is created, individual members can be returned
using the GetTrafficCompositionByNumber method, while the entire
collection can be iterated using a FOR ...TO ... NEXT statement. In Visual
Basic you can use the statement FOR EACH…NEXT without using the
property _NewEnum, which VB calls internally. (see TrafficCompositions
example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

COM Interface Manual © PTV AG 2009 99

3 Language Reference

Item ([in] VARIANT Index, [out, retval] ITrafficComposition **ppTC)

Returns a single TrafficComposition of the collection selected by position.
This is useful only when all traffic compositions shall be accessed (see the
TrafficCompositions example above). To select a traffic composition by its
identifier number use GetTrafficCompositionByNumber (see below). Since
Item is the default property for a collection the following commands are
equivalent:
SET tc = tcs(1)
SET tc = tcs.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] ITrafficComposition **ppTC: returned TrafficComposition object

Count ([out, retval] long *pCount)

Returns the number of TrafficComposition objects in the collection. See the
TrafficCompositions example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ITrafficCompositions Interface

GetTrafficCompositionByNumber ([in] long Number, [out, retval]

ITrafficComposition **ppTC)
Returns the TrafficComposition object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] ITrafficComposition **ppTC : returned TrafficComposition object
Example
SET tc = tcs.GetTrafficCompositionByNumber(2)
IF NOT (tc IS NOTHING) THEN
name = tc.AttValue(“NAME”)
END IF

3.5.2.6 TrafficComposition
A TrafficComposition object TrafficCompositions TrafficComposition
represents a traffic com-
position element and belongs
to the TrafficCompositions
object.
It can be accessed through the TrafficCompositions object to in two ways:
► access via iteration through the collection
DIM tc As TrafficComposition
FOR EACH tc IN vissim.Net.TrafficCompositions

100 VISSIM 5.10-06 © PTV AG 2009

 Traffic

List.AddItem tc.ID
NEXT tc
► individual access via identifier
DIM tc As TrafficComposition
SET tc = vissim.Net.TrafficCompositions.GetTrafficCompositionByNumber(2)
The TrafficComposition object enables access to the properties of the traffic
composition through the ITrafficComposition interface.

Properties of the Interface ITrafficComposition

ID ([out, retval] long *pID)

Returns the identifier number of the traffic composition.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = tc.ID

Name ([out, retval] BSTR *pName)

Returns the name of the traffic composition.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = tc.Name

Name ([in] BSTR Name)

Sets the name of the traffic composition. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
tc.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a traffic composition attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = tc.AttValue(„NAME“)

COM Interface Manual © PTV AG 2009 101

3 Language Reference

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a traffic composition attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
tc.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a traffic composition attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a traffic composition attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow for the specified vehicle type.
Parameter: vehicle type number.

Changes will affect immediately if called during a simulation. For example,

changing the relative flows will affect the vehicle types composition of each
vehicle input that use it.

102 VISSIM 5.10-06 © PTV AG 2009

 Traffic

3.5.2.7 VehicleInputs
The VehicleInputs object is Net
a collection of VehicleInput
objects (see page 105). It
belongs to the Net object VehicleInputs VehicleInput
and can be accessed
through the VehicleInputs
property of the INet
interface.
It contains all vehicle inputs of the loaded network and allows the iteration
through all of them as well as individual access (see also VehicleInput
object).
Example
Instantiation of a VehicleInputs object and access to all its VehicleInput
objects:
DIM vissim As Vissim
DIM vehins As VehicleInputs
DIM vehin As VehicleInput
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set inputs = Vissim.Net.VehicleInputs
FOR EACH vehin IN vehins ‘access to _NewEnum to create an enumeration
…
NEXT vehin

‘or also:

FOR i = 1 TO vehins.Count
SET vehin = vehins(i) ‘or vehins.Item(i)
…
NEXT i

Properties of the IVehicleInputs Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all VehicleInput
objects. Once a collection is created, individual members can be returned
using the GetVehicleInputByNumber method, while the entire collection can
be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you can
use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally. (see VehilcleInputs example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

COM Interface Manual © PTV AG 2009 103

3 Language Reference

Item ([in] VARIANT Index, [out, retval] IVehicleInput **ppVehicleInput)

It returns a single VehicleInput of the collection selected by position. This is
useful only when all vehicle inputs shall be accessed (see the VehicleInputs
example above). To select a vehicle input by its identifier number use
GetVehicleInputByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET vehin = inputs(1)
SET vehin = inputs.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IVehicleInput **ppVehicleInputs: returned VehicleInput object

Count ([out, retval] long *pCount)

Returns the number of VehicleInput objects in the collection. See the
VehicleInputs example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IVehicleInputs Interface

GetVehicleInputByNumber ([in] long Number, [out, retval] IVehicleInput

**ppVehicleInput)
Returns the VehicleInput object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IVehicleInput **ppVehicleInput : returned VehicleInput object
Example
SET vehin = vehins.GetVehicleInputByNumber (2)
IF NOT (vehin IS NOTHING) THEN
name = vehin.AttValue(“NAME”)
END IF

GetVehicleInputsOnLink ([in] long LinkID, [out, retval] IVehicleInputs

**ppVehicleInputs)
Returns a collection of VehicleInput objects containing all vehicle inputs with
link number specified with the passed identifier number.
Parameters
[in] long LinkID : link identifier number
[out, retval] IVehicleInputs **ppVehicleInputs : returned VehicleInputs collection
Example
SET vehinpslink = vehinps.GetVehicleInputsOnLink (11)
FOR EACH vehinp IN vehinpslink
name = vehinp.AttValue(“NAME”)
NEXT vehinp

104 VISSIM 5.10-06 © PTV AG 2009

 Traffic

AddVehicleInput([in] long LinkID, [in] double From, [in] double To, [out,
retval] IVehicleInput** ppVehicleInput)
Adds a new vehicle input into the link <LinkID> and for time interval [From,
To].
Parameters
[in] long LinkID : link identifier number
[in] double From: from time
[in] double To : to time
[out, retval] IVehicleInput **ppVehicleInput : returned VehicleInput
Example
SET vehinp = vehinps.AddVehicleInput(10, 1200, 1800)

RemoveVehicleInput([in] long Number)

Removes the vehicle input with ID <Number> from the collection.
Parameters
[in] long Number : vehicle input identifier number
Example
vehinps.RemoveVehicleInput(vehinp.ID)

3.5.2.8 VehicleInput
A VehicleInput object represents a VehicleInputs VehicleInput
vehicle input element and belongs to
the VehicleInputs object. It can be
accessed through the VehicleInputs
object to in two ways:
► access via iteration through the collection
DIM vehin As VehicleInput
FOR EACH vehin IN vissim.Net.VehicleInputs
List.AddItem vehin.ID
NEXT vehin
► individual access via identifier
DIM vehin As VehicleInput
SET vehin = vissim.Net.VehicleInputs.GetVehicleInputByNumber (12)
The VehicleInput object enables access to the properties of the vehicle input
through the IVehicleInput interface.

Properties of the Interface IVehicleInput

ID ([out, retval] long *pID)

Returns the vehicle input identifier number.
Parameters
[out, retval] long *pID :returned identifier.

COM Interface Manual © PTV AG 2009 105

3 Language Reference

Example
id = vehin.ID

Name ([out, retval] BSTR *pName)

Returns the vehicle input name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = vehin.Name

Name ([in] BSTR Name)

Sets the input’s name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
vehin.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a vehicle input attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = vehin.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a vehicle input attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
vehin.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 LINK Link number
9 9 TIMEFROM Time interval start [s]

106 VISSIM 5.10-06 © PTV AG 2009

 Traffic

R W Attribute Description
9 9 TIMEUNTIL Time interval end [s]
9 9 TRAFFICCOMPOSITION Traffic Composition number
9 9 VOLUME Volume [Veh/h]

Changes will affect immediately if called during a simulation. If the option

“Generate exact number of vehicles” is checked, changing the time interval
(using the attributes TIMEFROM or TIMEUNTIL) will force to regenerate
the sequence of vehicles with the current attributes.

It is required that TIMEUNTIL is greater or equal than TIMEFROM when

setting the interval. If the current interval is [100, 1000] and you want to set
it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

3.5.3 Transit

3.5.3.1 TransitLines
The TransitLines object is Net
a collection of Transit Line
objects (see page 109).
TransitLines TransitLine

It belongs to the Net object and can be accessed through the TransitLines
property of the INet interface. It contains all transit lines of the loaded
network and allows the iteration through all of them as well as individual
access (see also TransitLine object).
Example
Instantiation of a TransitLines object and access to all its TransitLine objects:
DIM vissim As Vissim
DIM transitlines As TransitLines
DIM transitline As TransitLine
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET transitlines = Vissim.Net.TransitLines
FOR EACH transitline IN transitlines ‘access to _NewEnum to create an enumeration
…
NEXT transitline

‘or also:

COM Interface Manual © PTV AG 2009 107

3 Language Reference

FOR i = 1 TO transitlines.Count
SET transitline = transitlines(i) ‘or transitlines.Item(i)
…
NEXT i

Properties of the ITransitLines Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all TransitLine objects.
Once a collection is created, individual members can be returned using the
GetTransitLineByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see TransitLines example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ITransitLine **ppTransitLine)

Returns a single TransitLine of the collection selected by position. This is
useful only when all transit lines shall be accessed (see the TransitLines
example above). To select a transit line by its identifier number use
GetTransitLineByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET transitline = transitlines(1)
SET transitline = transitlines.Item(1)
Parameters
[in] long Index: index between 1 and Count
[out, retval] ITransitLine **ppTransitLine: returned TransitLine

Count ([out, retval] long *pCount)

Returns the number of TransitLine objects in the collection. See the
TransitLines example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ITransitLines Interface

GetTransitLineByNumber ([in] long Number, [out, retval] ITransitLine

**ppTransitLine)
Returns the TransitLine object with the identifier number Number.
Parameters

108 VISSIM 5.10-06 © PTV AG 2009

 Traffic

[in] long Number : identifier number

[out, retval] ITransitLine **ppTransitLine : returned TransitLine
Example
SET transitline = transitlines.GetTransitLineByNumber (2)
IF NOT (transitline IS NOTHING) THEN
name = transitline.AttValue(“NAME”)
END IF

3.5.3.2 TransitLine
A TransitLine object represents a TransitLines TransitLine
transit line element and belongs to
the TransitLines object.
It can be accessed through the TransitLines object to in two ways:
► access via iteration through the collection
DIM transitline As TransitLine
FOR EACH transitline IN vissim.Net.TransitLines
List.AddItem transitline.ID
NEXT transitline
► individual access via identifier
DIM transitline As TransitLine
SET transitline = vissim.Net.TransitLines.
GetTransitLineByNumber (12)
The TransitLine object enables access to the properties of the transit line
through the ITransitLine interface.

Properties of the Interface ITransitLine

ID ([out, retval] long *pID)

Returns the transit line identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = transitline.ID

Name ([out, retval] BSTR *pName)

Returns the name of the transit line.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = transitline.Name

Name ([in] BSTR Name)

Sets the name of the transit line. Maximal 255 charatcters.

COM Interface Manual © PTV AG 2009 109

3 Language Reference

Parameters
[in] BSTR Name : new name.
Example
transitline.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a transit line attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = transitline.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a transit line attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
transitline.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a transit line attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a transit line attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)

110 VISSIM 5.10-06 © PTV AG 2009

 Traffic

[in] VARIANT Parameter : attribute dependent parameter (see below)

[in] VARIANT Value : attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 ALIGHTINGPROB Percentage of passengers that alight at
that stop.
9 9 DWELLTIME Dwell time distribution number to be used
to determine the stop time

Changes will affect immediately if called during a simulation.

3.5.3.3 TransitStops
The Transit Stops Net
object is a collection of
Transit Stop objects
TransitStops TransitStop
(see page 113).

It belongs to the Net object and can be accessed through the TransitStops
property of the INet interface. It contains all transit stops of the loaded
network and allows the iteration through all of them as well as individual
access (see also TransitStop object).
Example
Instantiation of a TransitStops object and access to all its TransitStop
objects:
DIM vissim As Vissim
DIM transitstops As TransitStops
DIM transitstop As TransitStop
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET transitstops = Vissim.Net.TransitStops
FOR EACH transitstop IN transitstops ‘access to _NewEnum to create an enumeration
…
NEXT transitstop

‘or also:

FOR i = 1 TO transitstops.Count
SET transitstop = transitstops(i) ‘or transitstops.Item(i)
…
NEXT i

COM Interface Manual © PTV AG 2009 111

3 Language Reference

Properties of the ITransitStops Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all TransitStop objects.
Once a collection is created, individual members can be returned using the
GetTransitStopByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see TransitStops example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ITransitStop **ppTransitStop)

Returns a single TransitStop of the collection selected by position. This is
useful only when all transit stops shall be accessed (see the TransitStops
example above). To select a transit stop by its identifier number use
GetTransitStopByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET transitstop = transitstops(1)
SET transitstop = transitstops.Item(1)
Parameters
[in] long Index: index between 1 and Count
[out, retval] ITransitStop **ppTransitStop: returned TransitStop

Count ([out, retval] long *pCount)

Returns the number of TransitStop objects in the collection. See the
TransitStops example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ITransitStops Interface

GetTransitStopByNumber ([in] long Number, [out, retval] ITransitStop

**ppTransitStop)
Returns the TransitStop object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] ITransitStop **ppTransitStop : returned TransitStop
Example
SET transitstop = transitstops.GetTransitStopByNumber (2)
IF NOT (transitstop IS NOTHING) THEN
name = transitstop.AttValue(“NAME”)
END IF

112 VISSIM 5.10-06 © PTV AG 2009

 Traffic

3.5.3.4 TransitStop
A TransitStop object represents a TransitStops TransitStop
transit stop element and belongs to
the TransitStops object.
It can be accessed through the TransitStops object to in two ways:
► access via iteration through the collection
DIM transitstop As TransitStop
FOR EACH transitstop IN vissim.Net.TransitStops
List.AddItem transitstop.ID
NEXT transitstop
► individual access via identifier
DIM transitstop As TransitStop
SET transitstop = vissim.Net.TransitStops.
GetTransitStopByNumber (12)
The TransitStop object enables access to the properties of the transit stop
through the ITransitStop interface.

Properties of the Interface ITransitStop

ID ([out, retval] long *pID)

Returns the transit stop identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = transitstop.ID

Name ([out, retval] BSTR *pName)

Returns the name of the transit stop.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = transitstop.Name

Name ([in] BSTR Name)

Sets the name of the transitstop. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
transitstop.Name = „XXX“

COM Interface Manual © PTV AG 2009 113

3 Language Reference

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a transit stop attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = transitstop.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a transit stop attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
transitstop.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

Methods of the ITransitStop Interface

GetVehicle ([out, retval] IVehicle **ppVehicle)

It returns the first vehicle serving on the transit stop.
Parameters
[out, retval] IVehicle **ppVehicle : returned Vehicle object
Example
DIM veh AS Vehicle
SET veh = transitstop.GetVehicle()
passengers = veh.AttValue(“PASSENGERS”)

114 VISSIM 5.10-06 © PTV AG 2009

 Traffic

3.5.4 Pedestrians

3.5.4.1 PedPedestrians
The PedPedestrians object is Net
a collection of PedPedestrian
objects (see page 117). It PedPedestrians PedPedestrian
belongs to the Net object and
can be accessed through the
PedPedestrians property of
the INet interface.
It contains all pedestrians currently traveling on the network during a
simulation, including the parked ones. It enables iteration through the
collection or individual access to a PedPedestrian object.
Example
Instantiation of a PedPedestrians object and access to all its PedPedestrian
objects:
DIM vissim As Vissim
DIM pedestrians As PedPedestrians
DIM pedestrian As PedPedestrian
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set pedestrians = Vissim.Net.PedPedestrians
FOR EACH pedestrian IN pedestrians ‘access to _NewEnum to create an enumeration
…
NEXT pedestrian

‘or also:

FOR i = 1 TO pedestrians.Count
SET pedestrian = pedestrians(i) ‘or pedestrians.Item(i)
…
NEXT i

Properties of the IPedPedestrians Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all PedPedestrian
objects. Once a collection is created, individual members can be returned
using the PedPedestrianByNumber method, while the entire collection can
be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you can
use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally. (see PedPedestrians example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

COM Interface Manual © PTV AG 2009 115

3 Language Reference

Item ([in] VARIANT Index, [out, retval] IPedPedestrian

**ppPedPedestrian)
Returns a single PedPedestrian of the collection selected by position. This is
useful only when all pedestrians shall be accessed (see the PedPedestrians
example above). To select a pedestrian by its identifier number use
PedPedestrianByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET pedestrian = pedestrians(1)
SET pedestrian = pedestrians.Item(1)
Parameters
[in] long Index : index between 1 and pedestrians.Count
[out, retval] IPedPedestrian **ppPedPedestrians: returned PedPedestrian object

Count ([out, retval] long *pCount)

Returns the number of PedPedestrian objects in the collection. See the
PedPedestrians example above.
Parameters
[out, retval] long *pCount : returned number of objects.

IDs ([in, defaultvalue(0)] BSTR Attribute, [in, defaultvalue(0)] VARIANT

Value, [out, retval] VARIANT *pIDs)
Returns an array of pedestrian IDs complying the condition “Attribute =
Value” if a pedestrian attribute an a value (see the attribute table on page
85) are given, otherwise an array with the IDs of all pedestrians in the
collection is returned.
Parameters
[in] BSTR Attribute : attribute name (see IPedPedestrian attribute table)
[in] VARIANT Value : attribute value or array of values (type according to
attribute)
[out, retval] VARIANT *pIDs : returned array of IDs.
Example
ids = pedestrians.IDs(„TYPE“, 1) ‘array with the IDs of all pedestrians of type 1

Methods of the IPedPedestrians Interface

PedPedestrianByNumber ([in] long Number, [out, retval]

IPedPedestrian **ppPedPedestrian)
Returns the PedPedestrian object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedPedestrian **ppPedPedestrian : returned PedPedestrian object
Example
DIM pedestrian AS PedPedestrian
SET pedestrian = pedestrians.PedPedestrianByNumber (11)

116 VISSIM 5.10-06 © PTV AG 2009

 Traffic

IF NOT (pedestrian IS NOTHING) THEN

speed = pedestrian.AttValue(“SPEED”)
END IF

3.5.4.2 PedPedestrian
A PedPedestrian object represents a PedPedestrians PedPedestrian
single pedestrian and belongs to the
PedPedestrians object. It can be
accessed through the
PedPedestrians object in two ways:
► access via iteration through the collection
DIM pedestrian As PedPedestrian
FOR EACH pedestrian IN vissim.Net.PedPedestrians
List.AddItem pedestrian.ID
NEXT pedestrian
► individual access via identifier number
DIM pedestrian As PedPedestrian
SET pedestrian = vissim.Net.PedPedestrians.PedPedestrianByNumber (101)
The PedPedestrian object enables access to the properties of the pedestrian
through the IPedPedestrian interface. It is not guaranteed that an
instantiated PedPedestrian object refers to a valid pedestrian in VISSIM after
the execution of a simulation step (please refer to the note at the end of this
section about the dynamic aspect of pedestrians). Use the property ID (see
below) for a validity check.

Properties of the IPedPedestrian Interface

ID ([out, retval] long *pID)

Returns the pedestrian’s identifier number. . If the PedPedestrian object
doesn’t refer to a valid VISSIM pedestrian anymore the returned value is 0.
Parameters
[out, retval] long *pID : returned identifier (0 if reference no longer valid)
Example
id = pedestrian.ID

Name ([out, retval] BSTR *pName)

Returns the pedestrian’s name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pedestrian.Name

COM Interface Manual © PTV AG 2009 117

3 Language Reference

Name ([in] BSTR Name)

Sets the pedestrian’s name.
Parameters
[in] BSTR Name : new name.
Example
pedestrian.Name = „KA-LK 240“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
speed = pedestrian.AttValue(„SPEED“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value (type according to attribute)
Example
pedestrian.AttValue(„PATH“)= 1

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

118 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Methods of the IPedPedestrian Interface

3.5.4.3 PedInputs
The PedInputs object is a Net
collection of PedInput objects
(see page 120). It belongs to PedInputs PedInput
the Net object and can be
accessed through the
PedInputs property of the INet
interface.
It contains all pedestrian inputs of the loaded network and allows the
iteration through all of them as well as individual access (see also PedInput
object).
Example
Instantiation of a PedInputs object and access to all its PedInput objects:
DIM vissim As Vissim
DIM pedins As PedInputs
DIM pedin As PedInput
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set inputs = Vissim.Net.PedInputs
FOR EACH pedin IN pedins ‘access to _NewEnum to create an enumeration
…
NEXT pedin

‘or also:

FOR i = 1 TO pedins.Count
SET pedin = pedins(i) ‘or pedins.Item(i)
…
NEXT i

Properties of the IPedInputs Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all PedInput objects.
Once a collection is created, individual members can be returned using the
GetPedInputByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see PedInputs example above).
Parameters

COM Interface Manual © PTV AG 2009 119

3 Language Reference

[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedInput **ppPedInput)

It returns a single PedInput of the collection selected by position. This is
useful only when all pedestrian inputs shall be accessed (see the PedInputs
example above). To select a pedestrian input by its identifier number use
PedInputByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET pedin = inputs(1)
SET pedin = inputs.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedInput **ppPedInputs: returned PedInput object

Count ([out, retval] long *pCount)

Returns the number of PedInput objects in the collection. See the PedInputs
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedInputs Interface

PedInputByNumber ([in] long Number, [out, retval] IPedInput

**ppPedInput)
Returns the PedInput object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedInput **ppPedInput : returned PedInput object
Example
SET pedin = pedins.GetPedInputByNumber (2)
IF NOT (pedin IS NOTHING) THEN
name = pedin.AttValue(“NAME”)
END IF

3.5.4.4 PedInput
A PedInput object represents a PedInputs PedInput
pedestrian input element and belongs
to the PedInputs object. It can be
accessed through the PedInputs
object to in two ways:

120 VISSIM 5.10-06 © PTV AG 2009

 Traffic

► access via iteration through the collection

DIM pedin As PedInput
FOR EACH pedin IN vissim.Net.PedInputs
List.AddItem pedin.ID
NEXT pedin
► individual access via identifier
DIM pedin As PedInput
SET pedin = vissim.Net.PedInputs.PedInputByNumber (12)
The PedInput object enables access to the properties of the pedestrian input
through the IPedInput interface.

Properties of the Interface IPedInput

ID ([out, retval] long *pID)

Returns the pedestrian input identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = pedin.ID

Name ([out, retval] BSTR *pName)

Returns the pedestrian input name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pedin.Name

Name ([in] BSTR Name)

Sets the input’s name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
pedin.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian input attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = pedin.AttValue(„NAME“)

COM Interface Manual © PTV AG 2009 121

3 Language Reference

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian input attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
pedin.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 TIMEFROM Time interval start [s]
9 9 TIMEUNTIL Time interval end [s]
9 9 PEDCOMPOSITION Ped Composition number
9 9 VOLUME Volume [Ped/h]

Changes will affect immediately if called during a simulation. If the option

“Generate exact number of pedestrians” is checked, changing the time
interval (using the attributes TIMEFROM or TIMEUNTIL) will force to
regenerate the sequence of pedestrians with the current attributes.

It is required that TIMEUNTIL is greater or equal than TIMEFROM when

setting the interval. If the current interval is [100, 1000] and you want to set
it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

3.5.4.5 PedRoutes
The PedRoutes object is a Net
collection of PedRoute objects
(see page 124). It belongs to PedRoutes PedRoute
the PedRouteDecision object
and can be accessed through
the PedRoutes property of the
IPedRouteDecision interface.
It contains all pedestrian routes of the routing decsion and allows the
iteration through all of them as well as individual access (see also PedRoute
object).
Example
Instantiation of a PedRoutes object and access to all its PedRoute objects:

122 VISSIM 5.10-06 © PTV AG 2009

 Traffic

DIM vissim As Vissim

DIM pedroutes As PedRoutes
DIM pedroute As PedRoute
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET pedroutes = Vissim.Net.PedRouteDecisions(1).PedRoutes
FOR EACH pedroute INpedroutes ‘access to _NewEnum to create an enumeration
…
NEXT pedroute

‘or also:

FOR i = 1 TO pedroutes.Count
SET pedroute = pedroutes (i) ‘or pedroutes.Item(i)
…
NEXT i

Properties of the IPedRoutes Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all PedRoute objects.
Once a collection is created, individual members can be returned using the
GetPedRouteByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally (see PedRoutes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedRoute **ppPedRoute)

Returns a single PedRoute of the collection selected by position. This is
useful only when all pedestrian routes shall be accessed (see the
PedRoutes example above). To select a pedestrian route by its identifier
number use GetPedRouteByNumber (see below). Since Item is the default
property for a collection the following commands are equivalent:
SET pedroute = pedroutes(1)
SET pedroute = pedroutes.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedRoute **ppPedRoutes: returned PedRoute object

Count ([out, retval] long *pCount)

Returns the number of PedRoute objects in the collection. See the
PedRoutes example above.
Parameters
[out, retval] long *pCount : returned number of objects.

COM Interface Manual © PTV AG 2009 123

3 Language Reference

Methods of the IPedRoutes Interface

PedRouteByNumber ([in] long Number, [out, retval] IPedRoute

**ppPedRoute)
Returns the PedRoute object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedRoute **ppPedRoute : returned PedRoute object
Example
SET pedroute = pedroutes.PedRouteByNumber(2)
IF NOT (pedroute IS NOTHING) THEN
rf = pedroute.AttValue(“RELATIVEFLOW”)
END IF

3.5.4.6 PedRoute
A PedRoute object represents a PedRoutes PedRoute
pedestrian route element of a routing
decision and belongs to the
PedRoutes object. It can be accessed
through the PedRoutes object to in
two ways:
► access via iteration through the collection
DIM pedroutes As PedRoutes
DIM pedroute As PedRoute
SET pedroutes = Vissim.Net.PedRoutingDecisions(1).PedRoutes
FOR EACH pedroute IN pedroutes
List.AddItem pedroute.ID
NEXT pedroute
► individual access via identifier
DIM pedroute As PedRoute
SET pedroute = vissim.Net.PedRoutingDecisions(1).PedRoutes.PedRouteByNumber (12)
The PedRoute object enables access to the properties of the pedestrian
route through the IPedRoute interface.

Properties of the Interface IPedRoute

ID ([out, retval] long *pID)

Returns the pedestrian route identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = pedroute.ID

124 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Name ([out, retval] BSTR *pName)

Returns the pedestrian route name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = pedroute.Name

Name ([in] BSTR Name)

Sets the pedestrian route’s name.
Parameters
[in] BSTR Name : new name.
Example
pedroute.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian route attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = pedroute.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian route attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
pedroute.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 NAME Name

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a pedestrian route attribute with one parameter. Please get the
language independent attribute tag from the table below.

COM Interface Manual © PTV AG 2009 125

3 Language Reference

Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a pedestrian route attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow of time intervall. Parameter: time
interval index (1..n).

Changes will affect immediately if called during a simulation.

3.5.4.7 PedRoutingDecisions
The PedRoutingDecisions Net

object is a collection of PedRoutingDecisions PedRoutingDecision

PedRoutingDecision objects
(see page 95).
It belongs to the Net object and can be accessed through the
PedRoutingDecisions property of the INet interface. It contains all routing
decisions of the loaded network and allows the iteration through all of them
as well as individual access (see also PedRoutingDecision object).
Example
Instantiation of a PedRoutingDecisions object and access to all its
PedRoutingDecision objects:
DIM vissim As Vissim
DIM decisions As PedRoutingDecisions
DIM decision As PedRoutingDecision
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET decisions = Vissim.Net.PedRoutingDecisions
FOR EACH decision IN decisions ‘access to _NewEnum to create an enumeration
…
NEXT decision

‘or also:

126 VISSIM 5.10-06 © PTV AG 2009

 Traffic

FOR i = 1 TO decisions.Count
SET decision = decisions(i) ‘or decisions.Item(i)
…
NEXT i

Properties of the IPedRoutingDecisions Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all
PedRoutingDecision objects. Once a collection is created, individual
members can be returned using the GetPedRoutingDecisionByNumber
method, while the entire collection can be iterated using a FOR ...TO ...
NEXT statement. In Visual Basic you can use the statement FOR
EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see PedRoutingDecisions example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedRoutingDecision

**ppDecision)
Returns a single PedRoutingDecision of the collection selected by position.
This is useful only when all routing decisions shall be accessed (see the
PedRoutingDecisions example above). To select a routing decision by its
identifier number use PedRoutingDecisionByNumber (see below). Since
Item is the default property for a collection the following commands are
equivalent:
SET decision = decisions(1)
SET decision = decisions.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IPedRoutingDecision **ppDecision: returned PedRoutingDecision object

Count ([out, retval] long *pCount)

Returns the number of PedRoutingDecision objects in the collection. See the
PedRoutingDecisions example above.
Parameters
[out, retval] long *pCount : returned number of objects.

COM Interface Manual © PTV AG 2009 127

3 Language Reference

Methods of the IPedRoutingDecisions Interface

PedRoutingDecisionByNumber ([in] long Number, [out, retval]

IRoutingDecision **ppDecision)
Returns the RoutingDecision object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IRoutingDecision **ppDecision : returned RoutingDecision object
Example
SET decision = decisions.GetRoutingDecisionByNumber (2)
IF NOT (decision IS NOTHING) THEN
name = decision.AttValue(“NAME”)
END IF

3.5.4.8 PedRoutingDecision
A PedRoutingDecision PedRoutingDecisions PedRoutingDecision
object represents a routing
decision element and
belongs to the
PedRoutingDecisions object.
It can be accessed through the PedRoutingDecisions object to in two ways:
► access via iteration through the collection
DIM decision As PedRoutingDecision
FOR EACH decision IN vissim.Net.PedRoutingDecisions
List.AddItem decision.ID
NEXT decision
► individual access via identifier
DIM decision As PedRoutingDecision
SET decision = vissim.Net.PedRoutingDecisions.PedRoutingDecisionByNumber (12)
The PedRoutingDecision object enables access to the properties of the
routing decision through the IPedRoutingDecision interface.

Properties of the Interface IPedRoutingDecision

ID ([out, retval] long *pID)

Returns the routing decision identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = decision.ID

128 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Name ([out, retval] BSTR *pName)

Returns the routing decision name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = decision.Name

Name ([in] BSTR Name)

Sets the decision’s name. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
decision.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a routing decision attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = decision.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a routing decision attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
decision.AttValue(„NAME“)=„XXX“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 PEDCLASSES Affected pedestrian classes (Array of
numbers)
9 PEDTYPES Affected pedestrian types (Array of
numbers)

COM Interface Manual © PTV AG 2009 129

3 Language Reference

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a routing decision attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a routing decision attribute with one parameter. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow for the curring time intervall (the
first one if no simulation is running).
Parameter: routing number.
9 9 TIMEFROM Time interval start [s]. Parameter: interval
time order (1..n)
9 9 TIMEUNTIL Time interval end [s]. Parameter: interval time
order (1..n)
9 9 PEDCLASS TRUE if the pedestrian class is affected.
Parameter: pedestrian class number (0 for all
vehicle types)
PEDTYPE TRUE if the pedestrian class is affected.
Parameter: pedestrian type number.

Changes will affect immediately if called during a simulation.

It is required that TIMEUNTIL is greater or equal than TIMEFROM when

setting the interval. If the current interval is [100, 1000] and you want to set
it to [1100, 2000] you are forced to set first TIMEUNTIL to 2000 and
afterwards TIMEFROM to 1100, otherwise you will get an error message.

130 VISSIM 5.10-06 © PTV AG 2009

 Traffic

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [out, retval] VARIANT *pValue)
Returns a routing decision attribute with two parameters. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] VARIANT Parameter1 : first attribute dependent parameter
[in] VARIANT Parameter2 : second attribute dependent parameter
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue2 ([in] BSTR Attribute, [in] VARIANT Parameter1, [in] VARIANT

Parameter2, [in] VARIANT Value)
Sets a routing decision attribute with two parameters. Please get the
language independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see table below)
[in] VARIANT Parameter1 : first attribute dependent parameter
[in] VARIANT Parameter2 : second attribute dependent parameter
[in] VARIANT Value : Attribute value. (type according to attribute)

Attribute outline

R W Attribute Description
9 9 RELATIVEFLOW Relative flow for time intervall and routing
number. Parameter1: routing number.
Parameter2: a time point of the requested
time interval.

Changes will affect immediately if called during a simulation.

Routes ([out, retval] IRoutes **ppRoutes)

Creates an instance of a Routes object (see page 99), that gives individual
access to the pedestrian routes defined in the network for this routing
decision.
Parameters
[out, retval] IRoutes **ppRoutes : returned Routes object
Example
DIM pedroutes AS Routes
DIM decision As PedRoutingDecision
SET decision = vissim.Net.PedRoutingDecisions.PedRoutingDecisionByNumber (10)
SET pedroutes = decision.Routes

COM Interface Manual © PTV AG 2009 131

3 Language Reference

Methods of the IPedRoutingDecision Interface

AddTimeInterval ([in] double From, [in] double To, [out, retval] long
*pIndex)
Adds a new time interval. If successful, it returns the assigned list postion
index (1..n), otherwise 0.
Parameters
[in] double From : Time interval start
[in] double To : Time interval end
[out, retval] long *pIndex : returned list position index
Example
id = decisions.AddStaticPedRoutingDecision(1, 100.0)
SET decision = decisions.PedRoutingDecisionByNumber (id)
IF NOT (decision IS NOTHING) THEN
decision.AttValue1(“TIMEUNTIL”, 1) = 1799 ‘sets default time interval to [0-1799]
index = decision.AddTimeInterval(1800, 3600)
END IF

3.5.5 Dynamic Assignment

3.5.5.1 DynamicAssignment
The DynamicAssignment object belongs to Vissim
Vissim and can be accessed through the
property DynamicAssignment of the
DynamicAssignment
IVissim interface. It enables configuration
and control of dynamic assignment
options. A DynamicAssignment instance
references always the current dynamic
assignment options for the currently
opened network.
Example
DIM vissim AS Vissim
DIM dynassig AS DynamicAssignment
SET vissim = NEW Vissim
SET dynassig = vissim.DynamicAssignment
vissim.LoadNet “example.inp”
dynassig.AttValue(“STOREPATHS”)

132 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Properties of the IDynamicAssignment Interface

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a dynamic assignment attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT*pValue : return of the attribute value
Example
period = dynassig.AttValue(„STOREPATHS “)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a dynamic assignment attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
dynassig.AttValue(„STOREPATHS“) = TRUE

Attribute outline

R W Attribute Description
9 9 APS Flag to check the Alternative Path
Search with stochastic edge
penalization
9 9 APSSPREAD Maximum spread share
9 9 APSPASSES Number of stochastic passes.
9 CONVERGEALL True if all active convergence
checks assert true
9 9 CONVERGENCETTEDGESC Flag to check edge travel times
HECK convergence
9 9 CONVERGENCETTEDGESF Factor edge travel times
ACTOR convergence [%]
9 9 CONVERGENCETTEDGESM Current maximal percentage
AX difference between old and new
edge travel times [%]
9 9 CONVERGENCETTPATHSC Flag to check path travel times
HECK convergence
9 9 CONVERGENCETTPATHSFA Factor path travel times
CTOR convergence [%]

COM Interface Manual © PTV AG 2009 133

3 Language Reference

R W Attribute Description
9 9 CONVERGENCETTPATHSM Current maximal percentage
AX difference between old and new
path travel times [%]
9 9 CONVERGENCEVOLEDGES Flag to check edge volumes
CHECK convergence
9 9 CONVERGENCEVOLEDGES Factor edge volumes
FACTOR convergence [Veh]
9 9 CONVERGENCEVOLEDGES Current maximal difference
MAX between old and new edge
volumes [%]
9 9 EVENTSMOOTHING Enable/Disable the event
EdgeSmoothing
9 9 EVENTROUTECHOICEDIST Enable/Disable the event
RouteChoiceDistribution
9 9 KIRCHHOFF Kirchhoff exponent for the route
choice
9 9 PSALLPAIRS Flag to search paths for O-D
pairs with zero volume
9 9 PSLIMIT Flag to llimit the number of paths
per parking lot relation
9 9 PSLIMITNUM Number of allowed paths per
parking lot relation
9 9 PSREJECTPATHS Check to reject paths with total
cost higher than the total cost of
the best path
9 9 PSREJECTPATHSFACTOR Thereshold factor to reject paths
9 9 SEARCHPATHS Flag to search new dynamic
assignment paths
9 9 STORECOSTS Flag to store costs to the BEW
file
9 9 STOREPATHS Flag to store paths to the WEG
file
9 9 VOLUME Scales the total volume [%]

134 VISSIM 5.10-06 © PTV AG 2009

 Traffic

As a complementary information to the convergence options of the

dynamic assignment, the convergence of path travel times, edge travel
times and edge volumes can be checked individually using the named
attributes CONVERGETTEDGESMAX, CONVERGETTPATHSMAX and
CONVERGEVOLEDGESMAX. These results are available during and after
the simulation. But a result will be useful for comparision only at the end of
every simulation starting from the second iteration.

Methods of the IDynamicAssignment Interface

Events of the DynamicAssignment Object

EdgeSmoothing ([in] double oldVal, [in] doule newVal, [out, retval]

doule retVal)
Created event (if attribute EVENTSMOOTHING enabled) for every
calculation of the smoothed edge travel times during the simulation. VISSIM
will use the returned value as the new smoothed edge value.
Parameters
[in] double oldVal : old smoothed value
[in] double newVal : newly measured value
[out, retval] double retVal : new computated smoothed value
Example
DIM vis AS Vissim
DIM sim AS Simulation
Dim WithEvents dyn as DynamicAssignment
Dim nIteration AS Long

‘ implementation of the DynamicAssignment event EdgeSmoothing

Private Function dyn_EdgeSmoothing(ByVal oldVal As Long, ByVal newVal As Long) As Double
‘ Method of successive Averages (MSA)
dyn_EdgeSmoothing = oldVal * (1# - 1# / nIteration)+ newVal * 1# / nIteration
End Function

SET vis = NEW Vissim

SET sim = vis.Simulation
SET dyn = vis.DynamicAssignment

vis.LoadNet “example.inp”)
dyn.AttValue(“EVENTSMOOTHING”) = TRUE
FOR nIteration = 1 TO 10
sim.RunContinuous
NEXT nIteration

COM Interface Manual © PTV AG 2009 135

3 Language Reference

RouteChoiceDistribution ([in] VARIANT Costs, [out] VARIANT

*Distribution)
Created event (if the attribute EVENTROUTECHOICEDIST is enabled) for
the calculation of the route choice distribution of a parking lot relation.
VISSIM will use the returned relative percentages in Distribution to distribute
the vehicles on the different routes.
Parameters
[in] VARIANT Costs : current paths costs of the parking lot relation
[out] VARIANT *Distribution : returned relative percentages
Example
DIM vis AS Vissim
DIM sim AS Simulation
Dim WithEvents dyn as DynamicAssignment

‘ implementation of the DynamicAssignment event RouteChoiceDistribution

Private Sub dyn_RouteChoiceDistribution (ByVal Costs As VARIANT,
ByRef Distribution As VARIANT)
‘ Logit function:
DIM dist() AS Double
s = 0#
FOR i = LBOUND(Costs) To UBOUND(Costs)
s = s + EXP(0.2 / Costs(i))
NEXT i
FOR i = LBOUND(Costs) To UBOUND(Costs)
dist(i) = EXP(0.2 / Costs(i)) / s
NEXT i
Distribution = dist
END SUB

SET vis = NEW Vissim

SET sim = vis.Simulation
SET dyn = vis.DynamicAssignment

vis.LoadNet “example.inp”)
dyn.AttValue(“EVENTROUTECHOICEDIST”) = TRUE
sim.RunContinuous

3.5.5.2 Paths
The Paths object is a Net
collection of Path objects.
It belongs to the Net object
and can be accessed Paths Path
through the Paths property
of the INet interface.
It contains all paths inserted using this interface (not the dynamic
assignment paths, see note at the end of this chapter) and enables iteration
through the collection or individual access to a Path object.
Example

136 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Instantiation of Paths object and access to all its Path objects (see page
140):
DIM vissim AS Vissim
DIM paths AS Paths
DIM path AS Path
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET paths = Vissim.Net.Paths
FOR EACH path IN paths ‘access to the method _NewEnum to create an enumeration
…
NEXT path

‘or also:

FOR i = 1 TO paths.Count
SET path = paths(i) ‘or paths.Item(i)
…
NEXT i

Properties of the IPaths Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Path objects. Once
a collection is created, individual members can be returned using the
GetPathByNumber method, while the entire collection can be iterated using
a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see Paths example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPath **ppPath)

Returns a single Path of the collection selected by position. This is useful
only when all paths shall be accessed (see the Paths example above). To
select a path by its identifier number use GetPathByNumber (see below).
Since Item is the default property for a collection the following commands
are equivalent:
SET path = paths(1)
SET path = paths.Item(1)
Parameters
[in] long Index : index between 1 and Paths.Count
[out, retval] IPath **ppPath : returned Path object

Count ([out, retval] long *pCount)

Returns the number of Path objects in the collection. See the Paths example
above.

COM Interface Manual © PTV AG 2009 137

3 Language Reference

Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPaths Interface

GetPathByNumber ([in] long Number, [out, retval] IPath **ppPath)

Returns the Path object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPath **ppPath : returned Path object
Example
DIM path AS Path
SET path = paths.GetPathByNumber (11)

AddPathAsNodeSequence ([in] long Number, [in] VARIANT Nodes,

[out, retval] IPath **ppPath)
This method creates and inserts a new path based on the given sequence of
nodes in the array Nodes. If 0 is passed as the identifier number the method
will set the path number automatically. A non valid node sequence will
produce an error message (see the possible error messages below and the
page 227 for error handling). An origin parking lot must be available between
the first and second node and a destination parking lot in-between the two
last nodes.
Parameters
[in] long Number : identifier number or 0
[in] VARIANT Nodes : array of node identifier numbers
[out, retval] IPath **ppPath : returned Path object
Example
DIM path AS Path
path = paths.AddPathAsNodeSequence (1, Array(10, 20, 30, 40))

RemovePath ([in] long Number)

This method removes the Path object identified with Number from the
collection of paths inserted with the COM interface. Nothing is done if the
path doesn’t exist in this collection. If the path is used for VISSIM’s dynamic
assignment, it belongs to the dynamic assignment path collection (*.weg file)
and it will not be removed from this collection. A path can be removed during
a simulation; in this case it won’t be possible to assign to the path to any
further vehicle after the method is called and it will be physically removed
from the network as soon as no vehicles are using it.
Parameters
[in] long Number : identifier number
Example
paths.RemovePath (11)

138 VISSIM 5.10-06 © PTV AG 2009

 Traffic

Useful to Know

Path network element

Although paths are static network elements, it is possible to insert and use
paths during the simulation at any simulation step using the IPaths interface.

Paths and dynamic assignment

Paths inserted using the IPaths interface are not collected to the path
collection of the dynamic assignment (*.WEG file) if they are not found by the
short path search algorithm (if they are found they are treated as normal
dynamic assignment paths).
Path insertion, using the IPaths interface, doesn’t consider any type of
closure (neither link, edge nor route closures).
Paths inserted using the IPaths interface are never considered long detours.
Only the paths inserted before the simulation start will affect the option for
high cost path rejection (Path Search – Reject paths with total cost higher by
% than total cost of the best path).
The path numbers used by the IPath interface don’t necessarily correspond
to the path numbers used by the path evaluation file (*.WGA).

Possible Errors

“An object with the same identifier number already exists.”

This message will appear when using an identifier number assigned to an
existing path to add a path. Correct the number or use automatic identifier
assignment (0).

“The object with specified identifier number doesn’t exists.”

This message will appear when using non existing node identifier numbers.

"No origin parking lot between the first two nodes."

A path must start on a parking lot. The existence of a parking lot in-between
the first two nodes must be guaranteed.

"No destination parking lot between the last two nodes."

A path must end up on a parking lot. The existence of a parking lot in-
between the last two nodes must be guaranteed.

COM Interface Manual © PTV AG 2009 139

3 Language Reference

“No valid node sequence.”

This message will occur when:
1. The node sequence can’t meet any valid path.
2. The node sequence is valid for more that one path. Use intermediate
nodes in-between to solve the ambiguity.

3.5.5.3 Path
A Path object represents a path element Paths Path
and belongs to the Paths object. It can
be accessed through the Paths object in
two ways:
► access via iteration through the collection
DIM paths AS Paths
DIM path AS Path
SET paths = Vissim.Net.Paths
FOR EACH path IN paths
List.AddItem path.ID
NEXT path
► individual access via identifier
DIM paths AS Paths
DIM path AS Path
SET paths = Vissim.Net.Paths
SET path = paths.GetPathByNumber (11)
The Path object enables access to the properties of the path through the
IPath interface.
As a difference to other network elements, the paths inserted through the
IPaths interface are not strictly the same as the dynamic assignment paths
(see the “Useful to Know” section on page 139 for more information)

Properties of the IPath Interface

ID ([out, retval] long *pID)

Returns the path identifier number. If the Path object doesn’t refer to a valid
VISSIM path element anymore the returned value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = path.ID

Name ([out, retval] BSTR *pName)

Returns the path name.
Parameters

140 VISSIM 5.10-06 © PTV AG 2009

 Traffic

[out, retval] BSTR *pName : returned name.

Example
name = path.Name

Name ([in] BSTR Name)

Sets the path name.
Parameters
[in] BSTR Name : new name.
Example
path.Name = „Markplatz_Stumpftsr“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a path attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
length = path.AttValue(„LENGTH“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a path attribute. Please get the language independent attribute tag from
the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value (type, according to the attribute)
Example
path.AttValue(„NAME“) = „Markplatz_Stumpfstrasse“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 LENGTH Length in the units of the current options

COM Interface Manual © PTV AG 2009 141

3 Language Reference

3.6 Intersection Control

3.6.1 Non-signalized

3.6.1.1 StopSigns
The StopSigns object is a Net
collection of StopSign
objects (see page 49). It
belongs to the Net object StopSigns StopSign
and can be accessed
through the StopSigns
property of the INet
interface.
It contains all stop signs (not transit stops) of the loaded network and allows
the iteration through all of them as well as individual access (see also
StopSign object).
Example
Instantiation of a StopSigns object and access to all its StopSign objects:
DIM vissim As Vissim
DIM stops As StopSigns
DIM stop As StopSign
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set stops = Vissim.Net.StopSigns
FOR EACH stop IN stops ‘access to _NewEnum to create an enumeration
…
NEXT stop

‘or also:

FOR i = 1 TO stops.Count
SET stop = stops(i) ‘or stops.Item(i)
…
NEXT i

Properties of the IStopSigns Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all StopSign objects.
Once a collection is created, individual members can be returned using the
GetStopSignByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the

142 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

statement FOR EACH…NEXT without using the property _NewEnum, which

VB calls internally (see the StopSigns example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IStopSign **ppStopSign)

Returns a single StopSign of the collection selected by position. This is
useful only when all stop signs shall be accessed (see the StopSigns
example above). To select a stop sign by its identifier number use
GetStopSignByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET stop = stops(1)
SET stop = stops.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IStopSign **ppStopSigns: returned StopSign object

Count ([out, retval] long *pCount)

Returns the number of StopSign objects in the collection. See the StopSigns
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IStopSigns Interface

GetStopSignByNumber ([in] long Number, [out, retval] IStopSign

**ppStopSign)
Returns the StopSign object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IStopSign **ppStopSign : returned StopSign object
Example
SET stop = stops.GetStopSignByNumber (2)
IF NOT (stop IS NOTHING) THEN
name = stop.AttValue(“NAME”)
END IF

3.6.1.2 StopSign
A StopSign object represents a stop StopSigns StopSign
sign element and belongs to the
StopSigns object. It can be accessed
through the StopSigns object to in two
ways:

COM Interface Manual © PTV AG 2009 143

3 Language Reference

► access via iteration through the collection

DIM stop As StopSign
FOR EACH stop IN vissim.Net.StopSigns
List.AddItem stop.ID
NEXT stop
► individual access via identifier
DIM stop As StopSign
SET stop = vissim.Net.StopSigns.GetStopSignByNumber (12)
The StopSign object enables access to the properties of the stop sign
through the IStopSign interface.

Properties of the Interface IStopSign

ID ([out, retval] long *pID)

Returns the stop sign identifier number.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = stop.ID

Name ([out, retval] BSTR *pName)

Returns the name of the stop sign.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = stop.Name

Name ([in] BSTR Name)

Sets the name of the stop sign. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
stop.Name = „XXX“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a stop sign attribute. Please get the language independent attribute
tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = stop.AttValue(„NAME“)

144 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a named attribute. Please get the language independent attribute tag
from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
stop.AttValue(„NAME“) = “cashbox1”

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [out, retval]

VARIANT *pValue)
Returns a stop sign attribute with one parameter. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : Attribute dependent parameter (see below)
[out, retval] VARIANT *pValue : returned value of the attribute

AttValue1 ([in] BSTR Attribute, [in] VARIANT Parameter, [in] VARIANT

Value)
Sets a stop sign attribute with one parameter. Please get the language
independent attribute tag from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Parameter : Attribute dependent parameter (see below)
[in] VARIANT Value : Attribute value. (type according to the attribute)

Attribute outline

R W Attribute Description
9 9 TIMEDIST Time distribution number for dwell time (Writeable
during simulation time). Parameter: vehicle class
number. Assign 0 to remove an assigned time
distribution to a vehicle class.

COM Interface Manual © PTV AG 2009 145

3 Language Reference

3.6.2 Signal Control

3.6.2.1 Detectors
The Detectors object is a SignalController
collection of Detector
objects (see page 156). It
belongs to a Detectors Detector
SignalController object and
can be accessed through
the Detectors property of
the ISignalController
interface.
It contains all detectors of the refered signal controller and enables iteration
through the collection or individual access to a Detector object.
Example
Instantiation of a Detectors object and access to all its Detector objects:
DIM vissim AS Vissim
DIM dets AS Detectors
DIM det AS Detector
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET dets = Vissim.Net.SignalControllers(1).Detectors
FOR EACH det IN dets ‘access to _NewEnum to create an enumeration
…
NEXT det

‘or also:

FOR i = 1 TO dets.Count
SET det = dets(i) ‘or dets.Item(i)
…
NEXT i

Properties of the IDetectors Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Detector objects.
Once a collection is created, individual members can be returned using the
GetDetectorByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see Detectors example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

146 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

Item ([in] VARIANT Index, [out, retval] IDetector **ppDetector)

Returns a single Detector of the collection selected by position. This is useful
only when all detectors shall be accessed (see the Detectors example
above). To select a detector by its identifier number use
GetDetectorByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET det = dets(1)
SET det = dets.Item(1)
Parameters
[in] long Index : index between 1 and dets.Count
[out, retval] IDetector **ppDetector : returned Detector object

Count ([out, retval] long *pCount)

Returns the number of Detector objects in the collection. See the Detectors
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IDetectors Interface

GetDetectorByNumber ([in] long Number, [out, retval] IDetector

**ppDetector)
Returns the Detector object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IDetector **ppDetector: returned Detector object
Example
DIM det AS Detector
SET det = dets.GetDetectorByNumber(1)

3.6.2.2 Detector
A Detector object belongs to a Detector Detectors
controller’s Detectors object.
Through this a detector can be
accessed in two ways:

► access via iteration through the collection

DIM dets As Detectors
DIM det As Detector
SET dets = Vissim.Net.SignalControllers(1).Detectors
FOR EACH det IN dets
List.AddItem det.ID
NEXT det

COM Interface Manual © PTV AG 2009 147

3 Language Reference

► individual access via identifier

DIM dets As Detectors
DIM det As Detector
SET dets = Vissim.Net.SignalControllers(1).Detectors
SET det = dets.GetDetectorByNumber(10)
The Detector object enables access to the properties of the detector through
the IDetector interface.

Properties of the IDetector interface

ID ([out, retval] long *pID)

Returns the identifier of the detector.
Parameters
[out, retval] long pID : returned identifier.
Example
id = det.ID

Name ([out, retval] BSTR *pName)

Returns the name of the detector.
Parameters
[out, retval] BSTR pName : returned name.
Example
name = det.Name

Name ([in] BSTR Name)

Sets the name of the detector. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
det.Name = „detectomat“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a detector attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
cycle = det.AttValue(„CONTROLLER“)

148 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a detector attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] BSTR Value : Attribute value. (type according to attribute)
Example
det.AttValue(„CONTROLLER“) = 1

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 CONTROLLER Signal controller identifier number
9 9 DETECTION Reading: 1 if there is or was a vehicle on
the detector since the previous signal
controller time step, else 0. Writing: will set
an impulse like a vehicle that arrives in the
current time step on the detector (i.e. a
front end is detected) but does not leave it
again during the current time step.
9 HEADWAY Time gap in seconds. 0 if the detector is
occupied at the end of the current signal
controller time step
9 IMPULSE Returns 1 if the impulse memory is 1 (i.e. a
vehicle front end has been detected in the
current signal controller time step).
Otherwise it returns 0
9 LINK Link identifier number
9 LANE Lane number
9 OCCUPANCY Time in seconds since the arrival of a
vehicle. 0 if no vehicle was detected at the
end of the current signal controller time
step 0
9 OCCUPANCYRATE Smoothed occupancy rate
9 PRESENCE 1 if a vehicle has been on the detector at
the end of the last simulation time step,
else 0. (Note: This is different from the
VAP function presence()!)
9 VEHICLEID If a vehicle front end has been detected in
the current simulation time step it returns

COM Interface Manual © PTV AG 2009 149

3 Language Reference

R W Attribute Description
the ID number of this vehicle. Otherwise 0.
If more than one vehicle front end has
been detected the result is unspecified.
9 VEHICLELENGTH Length (in the units of the current options)
LENGTH of the last vehicle that was detected within
the current signal controller time step. If no
vehicle was detected 0
9 VELOCITY Speed (in the units of the current options)
SPEED of the last vehicle that was detected within
VEHICLESPEED the current signal controller time step. If no
vehicle was detected 0

3.6.2.3 PTCallingPoints
The PTCallingPoints object Net
is a collection of Detector
objects, defined as public
transport calling point, (see PTCallingPoints Detector
page 156). It belongs to a
Net object and can be
accessed through the
PTCallingPoints property
of the INet interface.
It contains all PT calling points (special type of detector) of the the loaded
network and enables iteration through the collection or individual access to a
Detector object.
Example
Instantiation of a PTCallingPoints object and access to all its Detector
objects defined as public transport calling point:
DIM vissim AS Vissim
DIM ptcps AS PTCallingPoints
DIM det AS Detector
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET dets = Vissim.Net.PTCallingPoints
FOR EACH det IN ptcps ‘access to _NewEnum to create an enumeration
…
NEXT det

‘or also:

FOR i = 1 TO ptcps.Count
SET det = ptcps (i) ‘or ptcps.Item(i)
…
NEXT i

150 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

Properties of the IPTCallingPoints Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Detector objects
defined as public transport calling point. Once a collection is created,
individual members can be returned using the GetDetectorByNumber
method, while the entire collection can be iterated using a FOR ...TO ...
NEXT statement. In Visual Basic you can use the statement FOR
EACH…NEXT without using the property _NewEnum, which VB calls
internally. (see Detectors example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IDetector **ppPTCallingPoint)

Returns a single Detector of the collection selected by position. This is useful
only when all detectors, defined as public transport calling point, shall be
accessed (see the Detectors example above). To select a detector by its
identifier number use GetPTCallingPointByNumber (see below). Since Item
is the default property for a collection the following commands are
equivalent:
SET det = ptcps(1)
SET det = ptcps.Item(1)
Parameters
[in] long Index : index between 1 and ptcps.Count
[out, retval] IDetector **ppPTCallingPoint : returned Detector object

Count ([out, retval] long *pCount)

Returns the number of Detector objects, defined as public transport calling
point, in the collection. See the Detectors example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IDetectors interface

GetPTCallingPointByNumber ([in] long Number, [out, retval] IDetector

** ppPTCallingPoint)
Returns the Detector object, defined as public transport calling point, with the
identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IDetector ** ppPTCallingPoint: returned Detector object
Example

COM Interface Manual © PTV AG 2009 151

3 Language Reference

DIM det AS Detector

SET det = ptcps.GetPTCallingPointrByNumber(1)

3.6.2.4 SignalControllers
The Signal- Net
Controllers object is
a collection of
Signal objects (see SiganlControllers SignalController
page 147). It
belongs to the Net
object and can be
accessed through
the Signal-
Controllers property
of the INet interface.
It contains all signal controllers of the loaded network and enables iteration
through the collection or individual access to a SignalController object.
Example
Instantiation of a SignalControllers object and access to all its
SignalController objects:
DIM vissim AS Vissim
DIM controllers AS SignalControllers
DIM controller AS SignalController
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET controllers = Vissim.Net.SignalControllers
FOR EACH controller IN controllers ‘access to _NewEnum to create an enumeration
…
NEXT controller

‘or also:

FOR i = 1 TO controllers.Count
SET controller = controllers(i) ‘or controllers.Item(i)
…
NEXT i

Properties of the ISignalControllers Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all SignalController
objects. Once a collection is created, individual members can be obtained
using the GetSignalControllerByNumber method, while the entire collection
can be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you
can use the statement FOR EACH…NEXT without using the property

152 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

_NewEnum, which VB calls internally. (see SignalControllers example

above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ISignalController **ppSC)

Returns a single SignalController of the collection selected by position. This
is useful only when all signal controllers shall be accessed (see the
SignalControllers example above). To select a signal controller by its
identifier number use GetSignalControllerByNumber (see below). Since Item
is the default property for a collection the following commands are
equivalent:
SET sc = controllers(1)
SET sc = controllers.Item(1)
Parameters
[in] long Index : index between 1 and controllers.Count
[out, retval] ISignalController **ppSC : returned SignalController object

Count ([out, retval] long *pCount)

Returns the number of SignalController objects in the collection. See the
SignalControllers example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ISignalControllers Interface

GetSignalControllerByNumber ([in] long Number,[out, retval]

ISignalController **ppSC)
Returns the SignalController object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] ISignalController *ppSC : returned SignalController object
Example
DIM sc AS SignalController
SET sc = controllers.GetSignalControllerByNumber (11)

3.6.2.5 SignalController
A SignalController object belongs SignalControllers SignalController
to the network’s SignalControllers
object. Through this a signal
controller can be accessed in two
ways:

COM Interface Manual © PTV AG 2009 153

3 Language Reference

► access via iteration through the collection

DIM controllers As SignalControllers
DIM controller As SignalController
SET controllers = Vissim.Net.SignalControllers
FOR EACH controller IN controllers
List.AddItem controller.ID
NEXT controller
► individual access via identifier
DIM controllers As SignalControllers
DIM controller As SignalController
SET controllers = Vissim.Net.SignalControllers
SET controller = controllers.GetSignalControllerByNumber(1000)
The SignalController object enables access to the properties of the signal
controller through the ISignalController interface.

Properties of the ISignalController Interface

ID ([out, retval] long *pID)

Returns the identifier of the signal controller.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = sc.ID

Name ([out, retval] BSTR *pName)

Returns the name of the signal controller.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = sc.Name

Name ([in] BSTR Name)

Sets the name of the signal controller.
Parameters
[in] BSTR Name : new name.
Example
sc.Name = „CanPanegre“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a signal controller attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)

154 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

[out, retval] VARIANT *pValue : returned value of the attribute

Example
cycle = sc.AttValue(„CYCLETIME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a signal controller attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] BSTR Value : Attribute value. (type according to attribute)
Example
sc.AttValue(„TYPE“) = 1 ‘fixed time

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 CYCLETIME Cylcle time [s]
9 9 LOGFILE Filename for the record file (*.ldp)
9 9 PROGRAM VAP program number
9 9 OFFSET Offset time [s]
9 9 TYPE Type (1: fixed, 2: SDM, 3: VS_PLUS, 4: TRENDS,
5: VAP, 6: TL, 7: VOS, 8: NEMA, 9: External)

Detectors ([out, retval] IDetectors **ppDetectors)

Creates an instance of a Detectors object (see page 156), that gives
individual access to the detector elements of the network.
Parameters
[out, retval] IDetectors**ppDetectors : returned Detectors object
Example
DIM dets AS Detectors
SET dets = sc.Detectors

SignalGroups ([out, retval] ISignalGroups **ppSignalGroups)

Creates an instance of a SignalGroups object (see page 156), that gives
individual access to the signal group elements of the network.
Parameters
[out, retval] ISignalGroups **ppSignalGroups : returned SignalGroups object
Example
DIM sgs AS SignalGroups
SET sgs = sc.SignalGroups

COM Interface Manual © PTV AG 2009 155

3 Language Reference

Methods of the ISignalController Interface

ReadChannel([in] int channelId, [out, retval] long *pValue)

Returns the value on the specified channel of the signal controller. If the
channel does not exist, the function always returns -1.
Parameters
[in] int channeled: The channel id
[out, retval] long *pValue: The value on the channel, if exists, otherwise -1

WriteChannel([in] int channelId, [in] long value)

Sets the value on the specified channel of the signal controller. If the channel
is not connected to a channel on another signal controller, a temporary data
link will be inserted with no input signal control.
Parameters
[in] int channeled: The channel id
[in] int value: The new value on the channel

3.6.2.6 SignalGroups
The SignalGroups object is SignalController
a collection of SignalGroup
objects (see page 158). It
belongs to a Signal- SignalGroups SignalGroup
Controller object and can
be accessed through the
SignalGroups property of
the ISignalController
interface.
It contains all signal groups of the refered signal controller and enables
iteration through the collection or individual access to a SignalGroup object.
Example
Instantiation of a SignalGroups object and access to all its SignalGroup
objects:
DIM vissim AS Vissim
DIM groups AS SignalGroups
DIM group AS SignalGroup
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET groups = Vissim.Net.SignalControllers(1).SignalGroups
FOR EACH group IN groups ‘access to _NewEnum to create an enumeration
…
NEXT group

‘or also:

FOR i = 1 TO groups.Count
SET group = groups (i) ‘or groups.Item(i)

156 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

…
NEXT i

Properties of the ISignalGroups Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all SignalGroup
objects. Once a collection is created, individual members can be returned
using the GetSignalGroupByNumber method, while the entire collection can
be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you can
use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally. (see SignalGroups example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ISignalGroup **ppSG)

Returns a single SignalGroup of the collection selected by position. This is
useful only when all signal groups shall be accessed (see the SignalGroups
example above). To select a signal group by its identifier number use
GetSignalGroupByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET sg = groups(1)
SET sg = groups.Item(1)
Parameters
[in] long Index : index between 1 and groups.Count
[out, retval] ISignalGroup **ppSG : returned SignalGroup object

Count ([out, retval] long *pCount)

Returns the number of SignalGroup objects in the collection. See the
SignalGroups example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ISignalGroups Interface

GetSignalGroupByNumber ([in] long Number, [out, retval] ISignalGroup

**ppSG)
Returns the SignalGroup object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] ISignalGroup **ppSG : returned SignalGroup object

COM Interface Manual © PTV AG 2009 157

3 Language Reference

Example
DIM sg AS SignalGroup
SET sg = groups.GetSignalGroupByNumber (1)

3.6.2.7 SignalGroup
A SignalGroup object SignalController
belongs to a controller’s
SignalGroups object.
Through this a signal group SignalGroups SignalGroup
can be accessed in two
ways:
► access via iteration through the collection
DIM groups As SignalGroups
DIM group As SignalGroup
SET groups = Vissim.Net.SignalControllers(1).SignalGroups
FOR EACH group IN groups
List.AddItem group.ID
NEXT group
► individual access via identifier
DIM groups As SignalGroups
DIM group As SignalGroup
SET groups = Vissim.Net.SignalControllers(1).SignalGroups
SET group = groups.GetSignalGroupByNumber(10)
The SignalGroup object enables access to the properties of the signal group
through the ISignalGroup interface.

Properties of the ISignalGroup Interface

ID ([out, retval] long *pID)

Returns the identifier of the signal group.
Parameters
[out, retval] long pID : returned identifier.
Example
id = group.ID

Name ([out, retval] BSTR *pName)

Returns the name of the signal group.
Parameters
[out, retval] BSTR pName : returned name.
Example
name = group.Name

158 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

Name ([in] BSTR Name)

Sets the name of the signal group. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
group.Name = „phaseone“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a signal group attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
cycle = group.AttValue(„TYPE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a signal group attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] BSTR Value : Attribute value. (type according to attribute)
Example
group.AttValue(„TYPE“) = 1

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 AMBER Amber time [s] (0 for switching off)
9 9 CONTROLLER Signal controller identifier number
9 9 GREENEND Green end [s]
9 9 GREENEND2 Additional green end [s] (negative or 0 when
non used)
9 9 REDAMBER Red/Amber time [s] (0 for switching off)
9 9 REDEND Red end [s]
9 9 REDEND2 Additional red end [s] (negative or 0 when
non used)
9 STATE 1 = Red, 2 = Redamber, 3 = Green, 4 =
Amber, 5 = Off, 6 = Undefined, 7 = Flashing

COM Interface Manual © PTV AG 2009 159

3 Language Reference

R W Attribute Description
Amber, 8 = Flashing Red, 9 = Flashing
Green, 10 = Flashing Redgreen, 11 =
Greenamber, 12 = Off_red
9 9 TYPE 1 = cycle, 2 = Permanent green, 3 =
Permanent Red

State ([out, retval] SignalState *pState)

Returns the current state of the signal group according to the following
SignalState types table:

Attribute Description
Red Red
Redamber Red and amber
Green Green
Amber Amber
Off Off, meaning no light
Undefined State not defined
Amber_f Flashing amber
Red_f Flashing red
Green_f Flashing green
Redgreen_f Flashing red and green
Greenamber Green and amber
Off_red Off, meaning red

Parameters
[out, retval] SignalSate *pState : returned state
Example
DIM state AS SignalState
state = group.State

SignalHeads ([out, retval] ISignalHeads **ppSignalHeads)

Creates an instance of a SignalHeads object (see page 161), that gives
individual access to the signal group elements of the network.
Parameters
[out, retval] ISignalHeads **ppSignalHeads : returned SignalHeads object
Example

160 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

DIM shs AS SignalHeads

SET shs = group.SignalHeads

3.6.2.8 SignalHeads
The SignalHeads object is SignalGroup
a collection of SignalHead
objects (see page 162). It
belongs to a SignalGroup SignalHeads SignalHead
object and can be
accessed through the
SignalHeads property of
the ISignalGroup interface.
It contains all signal heads of the refered signal group and enables iteration
through the collection or individual access to a SignalHead object.
Example
Instantiation of a SignalHeads object and access to all its SignalHead
objects:
DIM vissim AS Vissim
DIM heads AS SignalHeads
DIM head AS SignalHead
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET heads = Vissim.Net.SignalControllers(1).SignalGroups(1).SignalHeads
FOR EACH head IN heads ‘access to _NewEnum to create an enumeration
…
NEXT head

‘or also:

FOR i = 1 TO heads.Count
SET head = heads(i) ‘or heads.Item(i)
…
NEXT i

Properties of the ISignalHeads Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all SignalHead objects.
Once a collection is created, individual members can be returned using the
GetSignalHeadByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally. (see SignalHeads example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

COM Interface Manual © PTV AG 2009 161

3 Language Reference

Item ([in] VARIANT Index, [out, retval] ISignalHead **ppSH)

Returns a single SignalHead of the collection selected by position. This is
useful only when all signal heads shall be accessed (see the SignalHeads
example above). To select a signal head by its identifier number use
GetSignalHeadByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET sh = heads(1)
SET sh = heads.Item(1)
Parameters
[in] long Index : index between 1 and heads.Count
[out, retval] ISignalController *ppSH : returned SignalHead object

Count ([out, retval] long *pCount)

Returns the number of SignalHead objects in the collection. See the
SignalHeads example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ISignalHeads Interface

GetSignalHeadByNumber ([in] long Number, [out, retval] ISignalHead

**ppSH)
Returns the SignalHead object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] ISignalHead **ppSH : returned SignalHead object
Example
DIM sh AS SignalHead
SET sh = heads.GetSignalHeadByNumber (1)

3.6.2.9 SignalHead
A SignalHead object SignalGroup
belongs to a signal
group’s SignalHeads
object. Through this a SignalHeads SignalHead
signal head can be
accessed in two ways:

► access via iteration through the collection

DIM heads As SignalHeads
DIM head As SignalHead
SET heads = Vissim.Net.SignalControllers(1).SignalGroups(1).SignalHeads
FOR EACH head IN heads

162 VISSIM 5.10-06 © PTV AG 2009

 Intersection Control

List.AddItem head.ID
NEXT heads
► individual access via identifier
DIM heads As SignalHeads
DIM head As SignalHeads
SET heads = Vissim.Net.SignalControllers(1).SignalGroups(1).SignalHeads
SET head = heads.GetSignalHeadByNumber(10)
The SignaHead object enables access to the properties of the signal head
through the ISignalHead interface.

Properties of the ISignalHead Interface

ID ([out, retval] long *pID)

Returns the identifier of the signal head.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = head.ID

Name ([out, retval] BSTR *pName)

Returns the name of the signal head.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = head.Name

Name ([in] BSTR Name)

Sets the name of the signal head. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
head.Name = „turnright“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a signal head attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
or = head.AttValue(„ORSIGNALGROUP“)

COM Interface Manual © PTV AG 2009 163

3 Language Reference

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a signal head attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] BSTR Value : Attribute value. (type according to attribute)
Example
head.AttValue(„ORSIGNALGROUP “) = 5

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 9 CONTROLLER Signal controller number
9 9 GROUP Signal group number
9 9 LINK Link identifier number
9 9 LANE Lane number
9 9 ORGROUP Alternative signal group
9 9 LINKCOORD Link coordinate (in current units)

Changes will affect immediately if called during a simulation.

It is required that CONTROLLER and GROUP are used consistently.

Changing the signal controller requires that the current group number
exists within the new assigned controller and, the other way around,
assigning a new signal group requires its existence within the current signal
controller.

164 VISSIM 5.10-06 © PTV AG 2009

 Simulation & Test

3.7 Simulation & Test

3.7.1 Simulation
The Simulation object belongs to Vissim Vissim
and can be accessed through the property
Simulation of the IVissim interface. It Simulation
enables configuration and control of
simulation runs. VISSIM is a single project
program, i.e. it can simulate only one
network simultaneously. Therefore, a
Simulation instance always references the
current simulation and the parameters set
for the currently opened network.
Example
DIM vissim AS Vissim
DIM simulation AS Simulation
SET vissim = NEW Vissim
SET simulation = vissim.Simulation
vissim.LoadNet “example.inp”
simulation.RunContinuous ‘ it runs an entire simulation synchronously

Properties of the ISimulation Interface

Comment ([out, retval] BSTR *pComment)

Returns the comment in the simulation parameters.
Parameters
[out, retval] BSTR *pComment : returned comment
Example
comment = simulation.Comment

Comment ([in] BSTR Comment)

Sets the comment in the simulation parameters. Maximal 199 charatcters.
Parameters
[in] BSTR Comment : new comment
Example
simulation.Comment = „Karlsruhe-Durlach Test11“

Period ([out, retval] double *pPeriod)

Returns the simulation period.
Parameters

COM Interface Manual © PTV AG 2009 165

3 Language Reference

[out, retval] double *pPeriod : returned period in simulation seconds

Example
period = simulation.Period

Period ([in] double Period)

Sets the simulation period.
Parameters
[in] double Period : new period in simulation seconds
Example
simulation.Period = 3600

StartTime ([out, retval] BSTR *pStartTime)

Returns the start time of the simulation.
Parameters
[out, retval] BSTR *pStartTime : returned start time in hh:mm:ss
Example
starttime = simulation.StartTime

StartTime ([in] BSTR StartTime)

Sets the start time of the simulation.
Parameters
[in] BSTR StartTime : new start time in hh:mm:ss
Example
simulation.StartTime = „10:30:00“

Speed ([out, retval] double *pSpeed)

Returns the speed of the simulation runs (simulated seconds per real time
second rate). It returns a negative value if maximum is selected.
Parameters
[out, retval] double *pSpeed : returned speed in simulation seconds per real second (≤
0 if maximum speed is set)
Example
speed = simulation.Speed

Speed ([in] double Speed)

Sets the speed of the simulation runs (simulated seconds per real time
second rate). A negative value or 0 switches to maximum speed but stores,
if the value is lesser than 0, the unsigned value as the new simulation speed
rate.
Parameters
[in] double Speed : new speed in simulation seconds per real second (≤ 0 for maximal
speed)
Example
simulation.Speed = 10.0

166 VISSIM 5.10-06 © PTV AG 2009

 Simulation & Test

simulation.Speed = 0 ‘maximum speed, without setting the rate

simulation.Speed = -10.0 ‘sets the rate to 10 Sim.sec/sec but uses maximum speed

Resolution ([out, retval] int *pResolution)

Returns the simulation resolution.
Parameters
[out, retval] int *pResolution : returned resolution in time steps per simulation
second
Example
resolution = simulation.Resolution

Resolution ([in] int Resolution)

Sets the simulation resolution .
Parameters
[in] int Resolution : new resolution in time steps per simulation second
Example
simulation.Resolution = 5 ‘ Time step(s) / Sim.sec.

ControllerFrequency ([out, retval] int *pControllerFrequency)

Returns the controller frequency of the simulation.
Parameters
[out, retval] int *pControllerFrequency : returned controller frequency (number of passes
per simulation second)
Example
controllerfreq = simulation.ControllerFrequency ‘ Number of passes / Sim.sec.

ControllerFrequency ([in] int ControllerFrequency)

Sets the controller frequency of the simulation.
Parameters
[in] int ControllerFrequency : new controller frequency (number of passes per
simulation second)
Example
simulation.ControllerFrequency = 5 ‘ Number of passes / Sim.sec.

RandomSeed ([out, retval] long *pRandomSeed)

Returns the random seed of the simulation.
Parameters
[out, retval] long *pRandomSeed : returned random seed.
Example
randomseed = simulation.RandomSeed

RandomSeed ([in] long RandomSeed)

Sets the random seed of the simulation.

COM Interface Manual © PTV AG 2009 167

3 Language Reference

Parameters
[in] long RandomSeed : new random seed.
Example
simulation.RandomSeed = 13

BreakAt ([out, retval] double *pBreakAt)

Returns the second at which the simulation shall halt and change to single
step mode.
Parameters
[out, retval] double *pBreakAt : returned break-at-simulation-second value.
Example
breakat = simulation.BreakAt

BreakAt ([in] double BreakAt)

Sets the second at which the simulation shall halt and change to single step
mode.
Parameters
[in] double BreakAt : new break-at-simulation-second value.
Example
simulation.BreakAt = 1000 ‘stop simulation when 1000 seconds have been simulated

After a continuous simulation has been halted because of the property

BreakAt, it is possible to continue the simulation process in single step or
continuous mode with the method RunSingleStep or RunContinuously
respectively. If a whole new simulation run is to be started, the method
Stop must be called before calling a Run… function again.

LeftSideTraffic ([out, retval] unsigned char *pLeftSideTraffic)

Returns true if the side of traffic flow is set to “left”, otherwise false.
Parameters
[out, retval] unsigned char *pLeftSideTraffic : returned 1 for left side traffic,
otherwise 0.
Example
is_leftsidetraffic = simulation.LeftSideTraffic

LeftSideTraffic ([in] unsigned char LeftSideTraffic)

Turns the left side traffic switch on/off.
Parameters
[in] unsigned char LeftSideTraffic : 0 for left side traffic off, otherwise on
Example
simulation.LeftSideTraffic= 1 ‘left side traffic on

168 VISSIM 5.10-06 © PTV AG 2009

 Simulation & Test

RunIndex ([out, retval] long *pIndex)

Returns the internal simulation run index, that is used when several
simulations are run consecutively. The index can only be changed with the
put version of this property (see below).
Parameters
[out, retval] long *pIndex : returned index
Example
index = simulation.RunIndex

RunIndex ([in] long Index)

Sets the simulation run index. It affects some evaluation files (like link and
path evaluation) and is useful when running several consecutive simulations.
The index must be initialized to 0 at incremented by 1 on each iteration when
the Microsoft Access database is used to collect the evaluation results.
Parameters
[in] long Index : new index
Example
simulation.RunIndex = 2

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a simulation attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT*pValue : return of the attribute value
Example
period = simulation.AttValue(„PERIOD“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a simulation attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
simulation.AttValue(„PERIOD“) = 3600

Attribute outline :

R W Attribute Description
9 9 ARCHIVEFILES Path and costs files (*.weg, *bew) backtrack
ing (True/False)
9 9 BREAKAT Break at a given simulation second

COM Interface Manual © PTV AG 2009 169

3 Language Reference

R W Attribute Description
9 9 COMMENT Comment as a string
9 9 CONTROLLERFRE Controller frequency: Number of passes per
QUENCY simulation second of signal controllers
9 9 DIRECTORY Output directory for multi-run processes
9 ELAPSEDTIME Simulated time seconds since start of
simulation [s]
9 ISRUNNING Simulation is running (True/False)
9 9 LEFTSIDETRAFFIC 0 for right-side traffic , ≠ 0 for left-side traffic
9 9 NUMRUNS Number of simulation runs for a multi-run
process
9 9 PERIOD Period in simulation seconds
9 9 RANDOMSEED Random seed
9 9 RANDOMSEEDINC Random seed increment for multi-runs
9 9 RESOLUTION Resolution in time steps per simulation
second
9 9 RUNINDEX Run index for evaluation with consecutive
simulation runs
9 9 SEARCHPATHS Flag to search new dynamic assignment
paths
9 9 SPEED Speed in simulation seconds per second. ≤
0 maximal speed
9 9 STARTTIME Start time as a string with the format
“hh:mm:ss”
9 9 STATUSLINE Enables/disables the status line when
simulating.
9 9 STORECOSTS Flag to store dynamic assignment costs to
the BEW file
9 9 STOREPATHS Flag to store dynamic assignment paths to
the WEG file
9 9 THREADS Number of threads for the simulation kernel.
To be set previous to the simulation start.
9 TIME Simulation time [hh:mm:ss]
9 9 VOLUME Dynamic Assignment volume increment for
multi-runs

170 VISSIM 5.10-06 © PTV AG 2009

 Simulation & Test

Methods of the ISimulation Interface

RunContinuous
Starts or continues (if coming changing from single step mode) a simulation
run in continuous mode (see the BreakAt property for switching into single
step mode at a predetermined simulation time). If a simulation is currently
running it will be stopped before.
Example
simulation.RunContinuous

RunSingleStep
Executes a single simulation time step. It starts a simulation run if no
simulation is running.
Example
simulation.RunSingleStep

RunMulti ([in, defaultvalue(10)] long NumRuns)

Starts a multi-run process consisting of <NumRuns> simulations runs.
Example
simulation.AttValue(“RANDOMSEEDINC”) = 3
simulation.AttValue(“DIRECTORY”) = ‘C:\example\output1’
simulation.RunMulti(5)

Stop
Stops a simulation run. If no simulation is running this command is ignored.
Example
simulation.Stop

LoadSnapshot ([in, defaultvalue(“”)] BSTR SnapshotPath)

Loads the simulation state saved of the given and starts a simulation in
single step mode.
Parameters
[in] BSTR SnapshotPath : path + filename (*.snp) of the snapshot file to be read
Example
SET vissim = NEW Vissim
vissim. Simulation.LoadSnapshot “c:\vissim\data\example.snp”

SaveSnapshot ([in, defaultvalue(“”)] BSTR SnapshotPath)

Save the current simulation state into a snapshot file (*.snp).
Parameters
[in] BSTR SnapshotPath : path + filename (*.snp) of the snapshot file to be read
Example
SET vissim = NEW Vissim

COM Interface Manual © PTV AG 2009 171

3 Language Reference

vissim.Simulation.SaveSnapshot “c:\vissim\data\example.snp”

All simulation methods (RunContinuous included) are executed

synchronously. No other command can be processed until the current one
is done. In terms of a Visual Basic program it means that the client will wait
until the VISSIM COM server has executed the command. See the property
BreakAt to interrupt a simulation in continuous mode at a predetermined
simulation time.

Examples
► Running the first 1000 simulation seconds in continuous mode and then
one additional single time step:
simulation.BreakAt = 1000
simulation.RunContinuous
simulation.RunSingleStep
► Running a simulation with possible manual stop:
FOR i = 0 TO simulation.Period ‘if resolution is 1 step per second
simulation.RunSingleStep

DOEVENTS ‘allow Visual Basic to detect new events

IF stop_pushed THEN GOTO the_end
NEXT I

the_end:
simulation.Stop
► Running 10 simulations continuously with different run indices and
random seeds:
simulation.RunIndex = 0
FOR i = 0 to 10
simulation.RunContinuous

simulation.RunIndex = simulation.RunIndex + 1
simulation. RandomSeed = simulation.RandomSeed + 1
NEXT i

If you are using database evaluation start from index 0. Otherwise the
database won’t be created and an error will occur.

172 VISSIM 5.10-06 © PTV AG 2009

 Graphics & Presentation

3.8 Graphics & Presentation

3.8.1 Graphics
The Graphics object belongs to Vissim and Vissim
can be accessed through the property
Graphics of the IVissim interface. It gives
access to the network graphics options. Graphics
These options are globally used for the
Vissim instance and affect all networks and
simulations during its existence. The VISSIM
internal set of default graphic options is used
for the creation of a new instance. Use the
IVissim method LoadLayout to load a stored
set of graphics.
Example
DIM vissim AS Vissim
DIM graphics AS Graphics
SET vissim = NEW Vissim
SET graphics = vissim.Graphics

Properties of the IGraphics Interface

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a graphic attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : return of the attribute value
Example
type = graphics.AttValue(„VISUALIZATION“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a graphic attribute. Please get the language independent attribute tag
from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see table below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
graphics.AttValue(„VISUALIZATION“) = 0 ‘disabled

COM Interface Manual © PTV AG 2009 173

3 Language Reference

Attribute outline

R W Attribute Description
9 9 3D 0 = 2D mode, 1 = 3d mode
9 9 DISPLAY 0 = normal, 1 = center line, 2 = invisible, 3 =
alternative
9 9 LAND Land color as a long in RGB format
9 9 LINKS Links color as a long in RGB format
9 9 SKY Sky color as a long in RGB format
9 9 VISUALIZATION Vehicles/aggregated values visualization on/off
(true/false)

Note: The color values passed to or returned from VISSIM must be/are in
RGB format. The valid range for a normal RGB color is 0 to 16,777,215
(&HFFFFFF). Each color setting (property or argument) is a 4-byte integer.
The high byte of a number in this range equals 0. The lower 3 bytes, from
least to most significant byte, determine the amount of red, green, and
blue, respectively. The red, green, and blue components are each
represented by a number between 0 and 255 (&HFF). In Visual Basic you
can use the RGB(red, green, blue) function to obtain the corresponding
integer.

If you are working with applications that require the byte order to be reversed
you can use one of the following methods in VB:
color = CLng(blue + (green*&H100) + (red*&H10000))
rgb = RGB(&HFF And (color\&H10000), &HFF And (color\&H100), &HFF And color)

Methods of the IGraphics Interface

Redraw ()
Redraw the network repainting all elements with the current graphic options.
Example
Dim vissim As Vissim
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
vissim.Graphics.Redraw

174 VISSIM 5.10-06 © PTV AG 2009

 Graphics & Presentation

GetWindow ([in] BSTR WinName, [out] VARIANT *Top, [out] VARIANT

*Left, [out] VARIANT *Bottom, [out] VARIANT *Right, [in,
defaultvalue(0)] long ID)
Retrieve the position of the window specified with the name attribute
WinName and the optional ID number. The dimensions are given in screen
coordinates that are relative to the upper-left corner of the screen.
Parameters
[in] BSTR Attribute : Window name (see table below)
[out] VARIANT *Top : the screen coordinate of the top edge
[out] VARIANT *Left : the screen coordinate of the left edge
[out] VARIANT *Bottom : the screen coordinate of the bottom edge
[out] VARIANT *Right : the screen coordinate of the right edge
[in] long ID : Optional window ID number (see table below)
Example
SET gr = vissim.Graphics
gr.GetWindow “SIGNALTT”, top, left, bottom, right, 1

SetWindow ([in] BSTR WinName, [in] VARIANT Top, [in] VARIANT Left,
[in] VARIANT Bottom, [in] VARIANT Right, ,m[in, defaultvalue(0)] long
ID)
Set the position of the window specified with the name attribute WinName
and the optional ID number. The dimensions are given in screen coordinates
that are relative to the upper-left corner of the screen.
Parameters
[in] BSTR Attribute : Window name (see table below)
[in] VARIANT Top : the screen coordinate of the top edge
[in] VARIANT Left : the screen coordinate of the left edge
[in] VARIANT Bottom : the screen coordinate of the bottom edge
[in] VARIANT Right : the screen coordinate of the right edge
[in] long ID : Optional window ID number (see table below)
Example
SET gr = vissim.Graphics
gr.SetWindow “SIGNALTT”, 800, 1000, 900, 1100, 1

WinName ID Description
NETWORK - Currently the main window
SCDETRECORD SC Identifier number Signal Control Detector Record
window of the ID signal
controller.
SIGNALTT SC Identifier number Signal Times Table window of
the ID signal controller.

COM Interface Manual © PTV AG 2009 175

3 Language Reference

Screenshot ([in] BSTR FileName, [in, defaultvalue(1)] double

sizeFactor)
It creates a graphic file of the VISSIM main window formatted according to
its extension: PNG, TIFF, GIF, JPG, JPEG or BMP. A BMP file will be written
if the extension can not be recognized.
Parameters
[in] BSTR FileName: File name with a graphic extension
[in, defaultvalue(1)] double sizeFactor: relative size factor

3.8.2 Presentation
The Presentation object belongs to Vissim Vissim
and can be accessed through the property
Presentation of the IVissim interface. It
allows to record and control presentations. Presentation

Example
DIM vissim AS Vissim
DIM present AS Presentation
SET vissim = NEW Vissim
SET present = vissim.Presentation

Properties of the IPresentation Interface

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a presentation attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : return of the attribute value
Example
backwards = present.AttValue(„BACKWARDS“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a presentation attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
present.AttValue(„RECORDING“) = TRUE

176 VISSIM 5.10-06 © PTV AG 2009

 Graphics & Presentation

Attribute outline :

R W Attribute Description
9 9 BACKWARDS Backwards animation.
9 9 FORWARDS Forwards animation.
9 NINTERVALS Return the number of recorded time intervals
9 9 RECORDING Recording the animation during a simulation.
9 TIMEFROM Time intervals start [s]. Parameter: interval time
order (1..n)
9 TIMEUNTIL Time intervals end [s]. Parameter: interval time
order (1..n)

Currently the name for the animation file (*.ani) will be the same as the
name of the*.inp file. When recording, if this exists it will be overwritten.
Also, it is required to set the recording attribute previous to the simulation
start. If enabled the animation of the whole network will be recorded until
simulation stop.

Methods of the IPresentation Interface

RunContinuous
Start or continues (if coming changing from single step mode) a presentation
in continuous mode using the *.ani file named as the *.inp file. If a
presentation is currently running it will be stopped before.
Example
present.RunContinuous

RunSingleStep
Execute a single presentation time step. It starts a presentation if no
presentation is yet running. Uses the *.ani file named as the *.inp file.
Example
present.RunSingleStep

Stop
Stop a presentation. If no presentation is running this command is ignored.
Example
present.Stop

COM Interface Manual © PTV AG 2009 177

3 Language Reference

3.8.3 StaticObjects
The StaticObjects object is Net
a collection of StaticObject
objects (see page 185). It
belongs to the Net object StaticObjects StaticObject
and can be accessed
through the StaticObjects
property of the INet
interface.
It contains all 3D static obejcts of the loaded network and allows the iteration
through all of them as well as individual access (see also StaticObject
object).
Example
Instantiation of a StaticObjects object and access to all its StaticObject
objects:
DIM vissim As Vissim
DIM stobjs As StaticObjects
DIM stobj As StaticObject
SET vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
SET stobjs = Vissim.Net.StaticObjects
FOR EACH stobj IN stobjs ‘access to _NewEnum to create an enumeration
…
NEXT stobj

‘or also:

FOR i = 1 TO stobjs.Count
SET stobj = stobjs(i) ‘or stobjs.Item(i)
…
NEXT i

Properties of the IStaticObjects Interface

_NewEnum ([out, retval] LPUNKOWN *ppEnum)

This property creates a collection (or enumeration) of all StaticObject
objects. Once a collection is created, individual members can be returned
using the GetStaticObjectByNumber method, while the entire collection can
be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you can
use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally (see the StaticObjects example
above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

178 VISSIM 5.10-06 © PTV AG 2009

 Graphics & Presentation

Item ([in] VARIANT Index, [out, retval] IStaticObject **ppStaticObject)

Returns a single StaticObject of the collection selected by position. This is
useful only when all static obejcts shall be accessed (see the StaticObjects
example above). To select a static object by its identifier number use
GetStaticObjectByNumber (see below). Since Item is the default property for
a collection the following commands are equivalent:
SET stobj = stobjs(1)
SET stobj = stobjs.Item(1)
Parameters
[in] long Index : index between 1 and Count
[out, retval] IStaticObject **ppStaticObjects: returned StaticObject object

Count ([out, retval] long *pCount)

Returns the number of StaticObject objects in the collection. See the
StaticObjects example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IStaticObjects interface

GetStaticObjectByName ([in] BSTR Name, [in, defaultvalue(0)]

IWorldPoint *pWorldPoint, [out, retval] IStaticObject **ppStaticObject)
Returns the StaticObject object with the name Name and world coordinates
pWorldPoint. The name of a static object is the file name of its 3D model
(*.v3d). If no world coordinates are specified the first static object
encountered with the name Name will be returned.
Parameters
[in] BSTR Name : Name (Name of the *.v3d file)
[in] IWorldPoint *pWorldPoint : Optional position world coordinates
[out, retval] IStaticObject **ppStaticObject : returned StaticObject object
Example
SET stobj = stobjs.GetStaticObjectByName(“Biz-Man_suit.v3d”)
IF NOT (stobj IS NOTHING) THEN
state = stobj.AttValue(“STATE”)
END IF

GetStaticObjectByCoord ([in] IWorldPoint *pWorldPoint, [in,

defaultvalue(“”)]BSTR Name, [out, retval] IStaticObject
**ppStaticObject)
Returns the StaticObject object within the position with world coordinates
pWorldPoint and the name Name. The name of a static object is the file
name of its 3D model (*.v3d). If no name is specified the first static object
encountered on the position pWorldPoint will be returned.
Parameters

COM Interface Manual © PTV AG 2009 179

3 Language Reference

[in] IWorldPoint *pWorldPoint : Position world coordinates

[in] BSTR Name : Optional name (Name of the *.v3d file)
[out, retval] IStaticObject **ppStaticObject : returned StaticObject object
Example
DIM wp AS WorldPoint
SET wp = vissim.NewWorldPoint(100, 100, 100)
SET stobj = stobjs.GetStaticObjectByCoord(wp)
IF NOT (stobj IS NOTHING) THEN
state = stobj.AttValue(“STATE”)
END IF

3.8.4 StaticObject
A StaticObject object represents a StaticObjects StaticObject
static object element and belongs to
the StaticObjects object. It can be
accessed through the StaticObjects
object to in two ways:
► access via iteration through the collection
DIM stobj As StaticObject
FOR EACH stobj IN vissim.Net.StaticObjects
List.AddItem stobj.ID
NEXT stobj
► individual access via identifier
DIM stobj As StaticObject
SET stobj = vissim.Net.StaticObjects.GetStaticObjectByName (“Biz-Man_suit.v3d”)
The StaticObject object enables access to the properties of the static object
through the IStaticObject interface.

Properties of the Interface IStaticObject

ID ([out, retval] long *pID)

Returns the static object identifier number. The identifier number is resolved
internally and may change when the network is modified.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = stobj.ID

Name ([out, retval] BSTR *pName)

Returns the name of the static object. The name of the static object is the
name of ist *.v3d file.
Parameters
[out, retval] BSTR *pName : returned name.

180 VISSIM 5.10-06 © PTV AG 2009

 Graphics & Presentation

Example
name = stobj.Name

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a static object attribute. Please get the language independent
attribute tag from the table below.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
state = stobj.AttValue(„STATE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a named attribute. Please get the language independent attribute tag
from the table below.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
stobj.AttValue(„STATE“) = 2

Attribute outline

R W Attribute Description
9 ID Identifier number
9 NAME Name
9 NSTATES Number of possible 3D model states of the object.
9 POSITION World coordinates of the object position on the
network
9 9 STATE Current object 3D model state.

Changes will affect immediately if called during a simulation. Example:

DIM sim AS Simulation

DIM stobj AS StaticObject
SET sim = vissim.Simulation
SET stobj = vissim.Net. StaticObjects.GetStaticObjectByName (“Biz-Man_suit.v3d”)
n_states = stobj.AttValue(„NSTATES“)
FOR i = 1 TO sim.Period * sim.Resolution
sim.RunSingleStep
stobj.AttValue(„STATE“) = (stobj.AttValue(„STATE“) + 1) MOD n_states
NEXT si

COM Interface Manual © PTV AG 2009 181

3 Language Reference

3.9 Results

3.9.1 Evaluation
The Evaluation object belongs to Vissim and Vissim
can be accessed through the property
Evaluation of the IVissim interface. It gives
access to the simulation evaluation options. Evaluation
These options are globally used for the
Vissim instance and affect all networks and
simulations during its existence. No set of
default evaluation options is used for the
creation of a new instance. Use the IVissim
method LoadLayout to load a stored set of
evaluations.
Example
DIM vissim AS Vissim
DIM eval AS Evaluation
SET vissim = NEW Vissim
SET eval = vissim.Evaluation

Properties of the IEvaluation Interface

LinkEvaluation ([out, retval] ILinkEvaluation **ppLinkEvaluation)

Creates an instance of a LinkEvaluation object (see page 207), that gives
access to the individual configuration of the evaluation.
Parameters
[out, retval] ILinkEvaluation **ppLinkEvaluation : returned object
Example
DIM linkeval AS LinkEvaluation
SET linkeval = eval.LinkEvaluation

DataCollectionEvaluation ([out, retval] IDataCollectionEvaluation

**ppEval)
Creates an instance of a DataCollectionEvaluation object (see page 212),
that gives access to the individual configuration of the evaluation.
Parameters
[out, retval] IDataCollectionEvaluation **ppEval : returned object
Example
DIM dceval AS DataCollectionEvaluation
SET dceval = eval.DataCollectionEvaluation

182 VISSIM 5.10-06 © PTV AG 2009

 Results

QueueCounterEvaluation ([out, retval] IQueueCounterEvaluation

**ppEval)
Creates an instance of a QueueCounterEvaluation object (see page 212),
that gives access to the individual configuration of the evaluation.
Parameters
[out, retval] IQueueCounterEvaluation **ppEval : returned object
Example
DIM qceval AS QueueCounterEvaluation
SET qceval = eval.QueueCounterEvaluation

TravelTimeEvaluation ([out, retval] ITravelTimeEvaluation **ppEval)

Creates an instance of a TravelTimeEvaluation object (see page 212), that
gives access to the individual configuration of the evaluation.
Parameters
[out, retval] ITravelTimeEvaluation **ppEval : returned object
Example
DIM tteval AS TravelTimeEvaluation
SET tteval = eval.TravelTimeEvaluation

DelayEvaluation ([out, retval] IDelayEvaluation **ppEval)

Creates an instance of a DelayEvaluation object (see page 213), that gives
access to the individual configuration of the evaluation.
Parameters
[out, retval] IDelayEvaluation **ppEval : returned object
Example
DIM deval AS DelayEvaluation
SET deval = eval.DelayEvaluation

NodeEvaluation ([out, retval] INodeEvaluation **ppEval)

Creates an instance of a NodeEvaluation object (see page 213), that gives
access to the individual configuration of the evaluation.
Parameters
[out, retval] INodeEvaluation **ppEval : returned object
Example
DIM nodeeval AS NodeEvaluation
SET nodeeval = eval.NodeEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns an evaluation attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[out, retval] VARIANT *pValue : return of the attribute value
Example

COM Interface Manual © PTV AG 2009 183

3 Language Reference

enabled = eval.AttValue(„VEHICLERECORD“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets an evaluation attribute. Please get the language independent attribute
tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : Attribute name (see below)
[in] VARIANT Value : Attribute value. (type according to attribute)
Example
eval.AttValue(„VEHICLERECORD“) = True

Attribute outline

R W Attribute Description
9 9 ANALYZER Analyzer database (True/False)
9 9 CONVERGENCE Convergence evaluations (True/False)
9 9 DATACOLLECTION Data collections (True/False)
9 9 DELAY Delays (True/False)
9 9 EXPORT Export evaluations (True/False)
9 9 GREENTIMES Distance of Green times (True/False)
9 9 LANECHANGE Lane change evaluations (True/False)
9 9 LINK Link segment evaluations (True/False)
9 9 NETPERFORMANCE Net performance evaluations (True/False)
9 9 NODE Node evaluations (True/False)
9 9 PATHS Dynamic assignment path evaluations
(True/False)
9 9 PUBLICWAITTIME Bus/Tram waiting time (True/False)
9 9 OBSERVER Observer evaluations (True/False)
9 9 QUEUECOUNTER Queue counter (True/False)
9 9 SCDETRECORD Signal changes/Detector record
(True/False)
9 9 SIGNALCHANGES Signal changes protocol (True/False)
9 9 SPECIAL Special evaluations (True/False)
9 9 TRAVELTIME Travel times (True/False)
9 9 VEHICLEINPUT Vehicle inputs (True/False)
9 9 VEHICLERECORD Vehicle record (True/False)

184 VISSIM 5.10-06 © PTV AG 2009

 Results

3.9.2 AnalyzerEvaluation
This object allows the Evaluation AnalyzerEvaluation
configuration of analyzer
evaluations through the
methods and properties of
the IAnalyzerEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
ANALYZER of the IEvaluation interface on page 182).

Properties of the Interface IAnalyzerEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = anaeval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
anaeval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 FILE Write evaluation file flag (true/false)

Setting the FILE attribute to FALSE avoids writing the *.MDB database
evaluation file while collecting evaluation data (if Analyzer evaluation is
activated) for possible online requests. This attribute is specific to the COM
interface and is global to the VISSIM program (i.e. it will preserve its state
independently from the loaded *.INP file).

COM Interface Manual © PTV AG 2009 185

3 Language Reference

Methods of the Interface IAnalyzerEvaluation

LoadReport ([in] BSTR ReportPath)

Loads an analyzer report database (*.mdb). No check is done of the file
extension and path. It is up to the user to make sure that the file has the
appropriate format. If no file path is given, a database browser dialog will
appear.
Parameters
[in] BSTR ReportPath : path incl. filename of the report database to be
loaded
Example
anaeval.LoadReport(“example.mdb”)

3.9.3 DataCollections
The DataCollections Net
object is a collection of
DataCollection objects
DataCollections DataCollection
(see page 189). It
belongs to the Net
object and can be
accessed through the
DataCollections
property of the INet
interface.
It contains all currently defined data collection measurements of the loaded
network and enables iteration through the collection or individual access to a
DataCollection object.
Example
Instantiation of a DataCollections object and access to all its DataCollection
objects:
Dim vissim As Vissim
Dim datacollections As DataCollections
Dim datacollection As DataCollection
Set vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set datacollections = Vissim.Net.DataCollections
FOR EACH datacollection IN datacollections ‘access to _NewEnum
…
NEXT datacollection

‘or also:

FOR i = 1 TO datacollections.Count
SET datacollection = datacollections(i) ‘or datacollections.Item(i)
…
NEXT i

186 VISSIM 5.10-06 © PTV AG 2009

 Results

Properties of the IDataCollections Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all DataCollection
objects. Once a collection is created, individual members can be returned
using the GetDataCollectionByNumber method, while the entire collection
can be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you
can use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally (see DataCollections example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IDataCollection **ppDC)

Returns a single DataCollection of the collection selected by position. This is
useful only when all data collections shall be accessed (see the
DataCollections example above). To select a data collection by its identifier
number use GetDataCollectionByNumber (see below). Since Item is the
default property for a collection the following commands are equivalent:
SET dc = DataCollections(1)
SET dc = DataCollections.Item(1)
Parameters
[in] long Index : index between 1 and DataCollections.Count
[out, retval] IDataCollection **ppDC : returned DataCollection object

Count ([out, retval] long *pCount)

Returns the number of DataCollection objects in the collection. See the
DataCollections example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IDataCollections Interface

GetDataCollectionByNumber ([in] long Number, [out, retval]

IDataCollection **ppDC)
Returns the DataCollection object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IDataCollection **ppDC : returned DataCollection object
Example
DIM dc AS DataCollection
SET dc = DataCollections.GetDataCollectionByNumber(101)

COM Interface Manual © PTV AG 2009 187

3 Language Reference

GetIDs ([out] VARIANT *pIDs, [in, defaultvalue("")] BSTR Attribute, [in,

optional] VARIANT Value, [in, defaultvalue(0)] short Compare)
Returns an array of the data collection identifier numbers that assert the
condition “DataCollection(Attribute) <Compare> Value”, where Compare can
get three different values: -1 for “less than”, 0 for “equal to” and 1 for “greater
than”. If an empty attribute or no attribute is given an array with all identifier
numbers of the collection will be returned.
Parameters
[out] VARIANT *pIDs: returned array of IDs (array of VARIANTs)
[in] BSTR Attribute: attribute to be compared. If empty the condition will always be true.
[in] VARIANT Value : value to be compared.
[in] short Compare : -1, 0 or 1 for “less than”, “equal to” or “greater that” respectively
Example
DIM ids() AS LONG
dcs.GetIDs ids ‘ ids will contain all IDs

GetMultiAttValues ([in] VARIANT IDs, [in] BSTR Attribute, [out]

VARIANT *pValues)
Returns an array of values for the passed attribute tag and the requested
data collections in the identifier numbers array IDs and in the same order. If
no identifier number is requested (IDs is Empty) then the returned array will
contain the values of all data collections in an unspecified order. If IDs is a
identifier number but not an array then the method will return the value of the
specified attribute for the passed ID.
Parameters
[in] VARIANT IDs : requested identifiers (array of VARIANTs)
[in] BSTR Attribute : attribute name (see IDataCollection attribute table)
[out] VARIANT *pValues : returned array of values.
Example
dcs.GetMultiAttValues Empty, “NAME”, vals ‘ vals will contain all names

SetMultiAttValues ([in] VARIANT IDs, [in] BSTR Attribute, [in] VARIANT

Values)
Updates the attribute with the passed array of values for the requested data
collections in the identifier numbers array IDs and in the same order. If not
enough values are given the last value will be taken until complete the
update. Exceeding values will not be taken in account. If no identifier number
is requested (IDs is Empty) then all data collections will be considered. It is
possible to pass a value instead of an array of values; in this case the same
value will be used for the update.
Parameters
[in] VARIANT IDs : requested identifiers (array of VARIANTs)
[in] BSTR Attribute : attribute name (see IDataCollection attribute table)
[in] VARIANT Values : value or array of values.
Example
dcs.SetMultiAttValues Empty, “NAME”, “” ‘ remove all names

188 VISSIM 5.10-06 © PTV AG 2009

 Results

3.9.4 DataCollection
A DataCollection object represents a DataCollections DataColection
data collection measurement (defined
through the configuration of Data
collection for Offline Analysis) and
belongs to the DataCollections object.
It can be accessed through the DataCollections object to in two ways:
► access via iteration through the collection
DIM datacollection As DataCollection
FOR EACH datacollection IN vissim.Net.DataCollections
List.AddItem datacollection.ID
NEXT datacollection
► individual access via identifier
DIM datacollection As DataCollection
SET datacollection = vissim.Net.DataCollections.GetDataCollectionByNumber (101)
The DataCollection object enables access to the properties of the data
collection through the IDataCollection interface.

Properties of the Interface IDataCollection

ID ([out, retval] long *pID)

Returns the data collection identifier number. If the DataCollection object
doesn’t refer to a valid VISSIM data collection element anymore the returned
value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = datacollection.ID

Name ([out, retval] BSTR *pName)

Returns the data collection name. If no name was given the name of the first
data collection point for this data collection will be used.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = datacollection.Name

Name ([in] BSTR Name)

Sets the data collection’s name.
Parameters
[in] BSTR Name : new name.
Example

COM Interface Manual © PTV AG 2009 189

3 Language Reference

datacollection.Name = „Friedhofeingang“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a data collection attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = datacollection.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a data collection attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
datacollection.AttValue(„NAME“)=„Friedhofeingang“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name
9 VEHICLEIDS Array of the current reported vehicle IDs within the
interval.

VEHICLEIDS refers always to the data collected during the last completed
time interval.

Methods of the Interface IDataCollection

GetResult ([in] BSTR Parameter, [in] BSTR Function, [in] long

VehicleClass [out, retval] VARIANT *pValue)
This method returns the last collected result (see notes below) of the
previously configured parameter with its function and vehicle class. The
returned value will be an 2d-array if the function “FREQUENCIES” is used.
In this case, the second dimension will be of size 3 and will contain the lower
and upper class limits and the result itself respectively.
Parameters

190 VISSIM 5.10-06 © PTV AG 2009

 Results

[in] BSTR Parameter : parameter name (see below)

[in] BSTR Function : function name (see below)
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue : returned value (real) or array of values (of reals)
Example
maxspeed = datacollection.GetResult(„SPEED“, „MAX“, 0)
minspeed = datacollection.GetResult(„SPEED“, „MIN“, 0)
freqs = datacollection.GetResult(„SPEED“, „FREQUENCIES“, 0)
FOR i = LBOUND(freqs) TO UPBOUND(freqs)
List.AddItem “From “+ CStr(freqs(i,0)) + “, To “+ CStr(freqs(i,1)) + “ : “+
CStr(freqs(i,2))
NEXT i

Parameters outline

Parameter Description
ACCELERATION Acceleration [m/s2] [ft/s2]. MIN, MAX, MEAN,
FREQUENCIES
LENGTH Vehicle length [m] [ft]. MIN, MAX, MEAN,
FREQUENCIES
MOTORTEMPERATURE Cooling water temperature [°C]. MIN, MAX,
MEAN, FREQUENCIES
NVEHICLES Number of vehicles. SUM
NPERSONS Number of people. MIN, MAX, MEAN, SUM,
FREQUENCIES
OCCUPANCYRATE Occupancy rate [%]. SUM
QUEUEDELTIME Total queue delay time [s]. MIN, MAX, MEAN,
SUM, FREQUENCIES
SPEED Speed [km/h] [mph]. MIN, MAX, MEAN,
FREQUENCIES
TACHO Total distance traveled in the network [m] [ft].
MIN, MAX, MEAN, FREQUENCIES

Functions outline

Function Description
MIN Maximum value
MAX Minimum value
MEAN Mean value
SUM Total sum
FREQUENCIES All configured frequencies in an array

COM Interface Manual © PTV AG 2009 191

3 Language Reference

Note: The parameters “NVEHICLES” and “OCCUPANCYRATE” can be used

with the function “SUM” only. For example:
result = datacollection.GetResult(„NVEHICLES“, „SUM“, 0)
Note: The results refer to the data collected during the last completed time
interval. The data of a time interval is available immediately after the last
time step of the interval has been simulated but not if this is the last time
step of the simulation period as well
Note: To receive results from collected data, a configuration must be defined
in VISSIM and stored in a *.qmk file before requests can be done. The
Offline Analysis option for data collections must be also enabled. Otherwise
an error message will be returned (“The specified configuration is not defined
within VISSIM”).

3.9.5 DataCollectionEvaluation
This object allows the Evaluation DatatCollectionEvaluation
configuration of data
collection evaluations
through the methods and
properties of the IData-
CollectionEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
DATACOLLECTION of the IEvaluation interface on page 182) and online
evaluations are possible through the method GetResult() of the
IDataCollection interface.

Properties of the Interface IDataCollectionEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = dceval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters

192 VISSIM 5.10-06 © PTV AG 2009

 Results

[in] BSTR Attribute : attribute name (see table below)

[in] BSTR Value : attribute value. (type according to attribute)
Example
dceval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 COMPILED Write the flag for compiled output (true/false)
9 9 FILE Write evaluation file flag (true/false)
9 9 RAW Write the flag for raw data output (true/false)

Setting the FILE attribute to FALSE avoids writing the *.MES and *.MER
evaluation files while collecting evaluation data (if data collection evaluation
is activated) for possible online requests. This attribute is specific to the
COM interface and is global to the VISSIM program (i.e. it will preserve its
state independently from the loaded *.INP file).

Methods of the Interface IDataCollectionEvaluation

3.9.6 Delays
The Delays object is a Net
collection of Delay
objects (see page
Delays Delay
212). It belongs to the
Net object and can be
accessed through the
Delays property of the
INet interface.
It contains all currently defined delay measurements of the loaded network
(during a simulation run including the temporary ones created for node
evaluation) and enables iteration through the collection or individual access
to a Delay object.
Example
Instantiation of a Delays object and access to all its Delay objects:
Dim vissim As Vissim
Dim delays As Delays
Dim delay As Delay
Set vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”

COM Interface Manual © PTV AG 2009 193

3 Language Reference

Set delays = Vissim.Net.Delays

FOR EACH delay IN delays ‘access to _NewEnum
…
NEXT delay

‘or also:

FOR i = 1 TO delays.Count
SET delay = delays (i) ‘or delays.Item(i)
…
NEXT i

Properties of the IDelays Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all Delay objects. Once
a collection is created, individual members can be returned using the
GetDelayByNumber method, while the entire collection can be iterated using
a FOR ...TO ... NEXT statement. In Visual Basic you can use the statement
FOR EACH…NEXT without using the property _NewEnum, which VB calls
internally (see Delays example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IDelay **ppDelay)

Returns a single Delay of the collection selected by position. This is useful
only when all delay measurements shall be accessed (see the Delays
example above). To select a data collection by its identifier number use
GetDelayByNumber (see below). Since Item is the default property for a
collection the following commands are equivalent:
SET delay = Delays(1)
SET delay = Delays.Item(1)
Parameters
[in] long Index : index between 1 and Delays.Count
[out, retval] IDelay **ppDelay : returned Delay object

Count ([out, retval] long *pCount)

Returns the number of Delay objects in the collection. See the Delays
example above.
Parameters
[out, retval] long *pCount : returned number of objects.

194 VISSIM 5.10-06 © PTV AG 2009

 Results

Methods of the IDelays Interface

GetDelayByNumber ([in] long Number, [out, retval] IDelay **ppDelay)

Returns the Delay object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IDelay **ppDelay : returned Delay object
Example
DIM delay AS Delay
SET delay = Delays.GetDelayByNumber (123)

3.9.7 Delay
A Delay object represents a delay Delays Delay
measurement element and belongs to
the Delays object. It can be accessed
through the Delays object to in two
ways:
► access via iteration through the collection
DIM delay As Delay
FOR EACH delay IN vissim.Net.Delays
List.AddItem delay.ID
NEXT delay
► individual access via identifier
DIM delay As Delay
SET delay = vissim.Net. Delays.GetDelayByNumber (123)
The Delay object enables access to the properties of the delay through the
IDelay interface.

Properties of the Interface IDelay

ID ([out, retval] long *pID)

Returns the delay identifier number. If the Delay object doesn’t refer to a
valid VISSIM delay measurement element anymore the returned value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = delay.ID

COM Interface Manual © PTV AG 2009 195

3 Language Reference

Name ([out, retval] BSTR *pName)

Returns the delay measurement name. If no name was given the name of
the first travel time measurement for this delay will be used.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = delay.Name

Name ([in] BSTR Name)

Sets the name of the delay measurement.
Parameters
[in] BSTR Name : new name.
Example
delay.Name = „xxx“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a delay measurement attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = delay.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a delay measurement attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
delay.AttValue(„NAME“)=„xxx“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

196 VISSIM 5.10-06 © PTV AG 2009

 Results

Methods of the Interface IDelay

GetResult ([in] double Time, [in] BSTR Parameter, [in] BSTR Function,
[in] long VehicleClass, [out, retval] VARIANT *pValue)
This method returns the collected result for the requested named parameter
(see parameters table below) and vehicle class. The returned value refers to
the data collected up to this moment for the time interval enclosing the
specified time point. The Function parameter has currently no meaning.
Parameters
[in] double Time : Time point in seconds
[in] BSTR Parameter : parameter name (see below)
[in] BSTR Function : not used
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue: returned value (real number)
Example
delay = delay.GetResult(600, „DELAY“,””, 0) ‘average total delay per vehicle
delay = delay.GetResult(600, „DELAY“,””, 1) ‘average total delay per vehicle for class 1

Parameters outline

Parameter Description
DELAY Average total delay per vehicle [s]
PERSONS Average total delay per person [s]
NPERSONS Persons throughput
NVEHICLES Vehicles throughput
NSTOPS Average number of stops per vehicle [s]
STOPPEDDELAY Average stand still time per vehicle [s]

To get results, the Offline Analysis option for delays must be enabled.
Otherwise the result will be 0.0.

Data for each defined vehicle class can be requested even if the vehicle
class is not selected for the delay measurement.

3.9.8 DelayEvaluation
This object allows the Evaluation DelayEvaluation
configuration of delay
evaluations through the
methods and properties of
the IDelayEvaluation
interface.

COM Interface Manual © PTV AG 2009 197

3 Language Reference

Offline evaluations are possible setting the appropriated flag (see attribute
DELAY of the IEvaluation interface on page 182).

Properties of the Interface IDelayEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = deval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
deval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 COMPILED Write the flag for compiled output (true/false)
9 9 FILE Write evaluation file flag (true/false)
9 9 RAW Write the flag for raw data output (true/false)

Setting the FILE attribute to FALSE avoids writing the *.VLZ and *.VLR
evaluation files while collecting evaluation data (if delay evaluation is
activated) for possible online requests. This attribute is specific to the COM
interface and is global to the VISSIM program (i.e. it will preserve its state
independently from the loaded *.INP file).

Methods of the Interface IDelayEvaluation

198 VISSIM 5.10-06 © PTV AG 2009

 Results

3.9.9 LinkEvaluation
This object allows the configuration of Evaluation LinkEvaluation
link evaluations through the methods
and properties of the ILinkEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
LINK of the IEvaluation interface on page 182) and online evaluations are
possible through the method GetSegmentResult() of the ILink interface (refer
to page 51).
Example
Loading an existing link evaluation configuration (*.sak):
DIM linkeval As LinkEvaluation
SET linkeval = vissim.Evaluation.LinkEvaluation
linkeval.LoadConfiguration(“c:\vissim\daten\example.sak”)

Properties of the Interface ILinkEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
interval = linkeval.AttValue(„INTERVAL“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
linkeval.AttValue(„UNTIL“)= 3600

Attribute outline

R W Attribute Description
9 9 DATABASE Database flag
9 9 EXPORT Export to VISUM
9 9 FILE Write evaluation file flag (true/false)

COM Interface Manual © PTV AG 2009 199

3 Language Reference

R W Attribute Description
9 9 FILENAME Path and filename for the configuration file
9 9 FROM First second
9 9 INTERVAL Data collection interval
9 9 PERLANE Separate Data collection for each lane
9 9 TABLENAME Database name
9 9 UNTIL Last second

Setting the FILE attribute to FALSE avoids writing the *.STR evaluation file
while collecting evaluation data (if link segment evaluation is activated) for
possible online requests. This attribute is specific to the COM interface and
is global to the VISSIM program (i.e. it will preserve its state independently
from the loaded *.INP file).

Methods of the Interface ILinkEvaluation

LoadConfiguration ([in] BSTR ConfigurationPath)

Loads a link evaluation configuration file (*.sak). No check is done of the file
extension and path. It is up to the user to make sure that the file has the
appropriate format. If no file path is given, a file browser dialog will appear.
Parameters
[in] BSTR ConfigurationPath : path incl. filename of configuration file to be loaded
Example
linkeval.LoadConfiguration(“example.sak”)

SaveConfiguration ([in] BSTR ConfigurationPath)

Saves the currently selected configuration to the file in VISISM format
(*.sak). No check of the file extension and working path is done.
Parameters
[in] BSTR ConfigurationPath : path incl. filename of configuration file to be saved
Example
linkeval.SaveConfiguration(“example.sak”)

When loading/saving a configuration with LoadConfiguration(), the

configuration’s filename for the link evaluation of the currently loaded
network will not be updated. To do that use the “FILENAME” attribute. If
another path than the current network working path is used, the simulation
will show an error on starting (if link evaluation is activated).

200 VISSIM 5.10-06 © PTV AG 2009

 Results

AddParameter ([in] BSTR Parameter, [in] long VehicleClass)

Adds a new parameter to evaluate, restricted to the given vehicle class or for
all vehicle classes if VehicleClass is 0. No check is done for repetitions.
Parameters
[in] BSTR Parameter : parameter name (see table below)
[in] long VehicleClass : vehicle class number or 0 for all classes
Example
linkeval.AddParameter(“SPEED”, 0) ‘segment average speed for all vehicle types

RemoveParameter ([in] BSTR Parameter, [in] long VehicleClass)

Removes the specified parameter for the for the given vehicle class (0 for all
vehicle classes) from the list of evaluated parameters. If there is no entry
matching the parameter/vehicle class combination nothing will be done. If
there are several matches the only first one will be removed.
Parameters
[in] BSTR Parameter : parameter name (see table below)
[in] long VehicleClass : vehicle class number
Example
linkeval.RemoveParameter(“SPEED”, 0) ‘segment average speed for all vehicle types

Parameter outline

R W Parameter Description
9 9 TIMESTEP Simulation time step [s]
9 9 SPEED Average speed [km/h] or [mph]
9 9 VOLUME Average volume [veh/h]
9 9 NVEHICLES Cumulated number of vehicles
9 9 DENSITY Average density [veh/km]
9 9 DELAY Relative lost time [s/s]

3.9.10 NodeEvaluation
This object allows the Evaluation NodeEvaluation
configuration of node
evaluations through the
methods and properties of
the INodeEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
NODE of the IEvaluation interface on page 182).

COM Interface Manual © PTV AG 2009 201

3 Language Reference

Properties of the Interface INodeEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = nodeeval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
nodeeval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 FILE Write evaluation file flag (true/false)

Setting the FILE attribute to FALSE avoids writing the *.KNA evaluation file
while collecting evaluation data (if node evaluation is activated) for possible
online requests. This attribute is specific to the COM interface and is global
to the VISSIM program (i.e. it will preserve its state independently from the
loaded *.INP file).

202 VISSIM 5.10-06 © PTV AG 2009

 Results

Methods of the Interface INodeEvaluation

3.9.11 QueueCounters
The QueueCounters Net
object is a collection of
QueueCounter objects
QueueCounters QueueCounter
(see page 204). It
belongs to the Net
object and can be
accessed through the
QueueCounters
property of the INet
interface.
It contains all currently defined queue counters of the loaded network (during
a simulation run including the temporary ones created for node evaluation)
and enables iteration through the collection or individual access to a
QueueCounter object.
Example
Instantiation of a QueueCounters object and access to all its QueueCounter
objects:
Dim vissim As Vissim
Dim queuecounters As QueueCounters
Dim queuecounter As QueueCounter
Set vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set queuecounters = Vissim.Net.QueueCounters
FOR EACH queuecounter IN queuecounters ‘access to _NewEnum
…
NEXT queuecounter

‘or also:

FOR i = 1 TO queuecounters.Count
SET queuecounter = queuecounters (i) ‘or queuecounters.Item(i)
…
NEXT i

Properties of the IQueueCounters Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all QueueCounter
objects. Once a collection is created, individual members can be returned
using the GetQueueCounterByNumber method, while the entire collection
can be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you

COM Interface Manual © PTV AG 2009 203

3 Language Reference

can use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally (see QueueCounters example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IQueueCounter **ppQC)

Returns a single QueueCounter of the collection selected by position. This is
useful only when all queue counters shall be accessed (see the
QueueCounters example above). To select a data collection by its identifier
number use GetQueueCounterByNumber (see below). Since Item is the
default property for a collection the following commands are equivalent:
SET qc = QueueCounters(1)
SET qc = QueueCounters.Item(1)
Parameters
[in] long Index : index between 1 and QueueCounters.Count
[out, retval] IQueueCounter **ppQC : returned QueueCounter object

Count ([out, retval] long *pCount)

Returns the number of QueueCounter objects in the collection. See the
QueueCounters example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IQueueCounters Interface

GetQueueCounterByNumber ([in] long Number, [out, retval]

IQueueCounter **ppQC)
Returns the QueueCounter object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IQueueCounter **ppQC : returned QueueCounter object
Example
DIM qc AS QueueCounter
SET qc = QueueCounters.GetQueueCounterByNumber (123)

3.9.12 QueueCounter
A QueueCounter object represents a QueueCounters QueueCounter
queue counter element and belongs
to the QueueCounters object. It can
be accessed through the
QueueCounters object to in two ways:

204 VISSIM 5.10-06 © PTV AG 2009

 Results

► access via iteration through the collection

DIM queuecounter As QueueCounter
FOR EACH queuecounter IN vissim.Net.QueueCounters
List.AddItem queuecounter.ID
NEXT queuecounter
► individual access via identifier
DIM queuecounter As QueueCounter
SET queuecounter = vissim.Net.QueueCounters.GetQueueCounterByNumber(123)
The QueueCounter object enables access to the properties of the queue
counter through the IQueueCounter interface.

Properties of the Interface IQueueCounter

ID ([out, retval] long *pID)

Returns the queue counter identifier number. If the QueueCounter object
doesn’t refer to a valid VISSIM queue counter element anymore the returned
value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = queuecounter.ID

Name ([out, retval] BSTR *pName)

Returns the queue counter name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = queuecounter.Name

Name ([in] BSTR Name)

Sets the name of the queue counter.
Parameters
[in] BSTR Name : new name.
Example
queuecounter.Name = „xxx“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a queue counter attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute

COM Interface Manual © PTV AG 2009 205

3 Language Reference

Example
name = queuecounter.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a queue counter attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
queuecounter.AttValue(„NAME“)=„xxx“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

Methods of the Interface IQueueCounter

GetResult ([in] double Time, [in] BSTR Parameter, [out, retval]

VARIANT *pValue)
This method returns the last collected result (see note below) for the
requested named parameter (see parameters table below). The returned
value refers to the data collected up to this moment for the time interval
enclosing the specified time point.
Parameters
[in] double Time : Time point in seconds
[in] BSTR Parameter : parameter name (see below)
[out, retval] VARIANT *pValue : returned value (real number)
Example
mean = queuecounter.GetResult(600, „MEAN“)
max = queuecounter.GetResult(600, “MAX”)
stops = queuecounter.GetResult(600, “STOPS”)

Parameters outline

Parameter Description
MEAN Average queue length ([m] or [ft], depending on current unit
selection)
MAX Maximum queue length ([m] or [ft], depending on current unit
selection)

206 VISSIM 5.10-06 © PTV AG 2009

 Results

Parameter Description
NSTOPS Number of stops in the queue area

To get results, the Offline Analysis option for queue counters must be
enabled. Otherwise the result will be 0.0.

3.9.13 QueueCounterEvaluation
This object allows the Evaluation QueueCounterEvaluation
configuration of queue
counter evaluations
through the methods and
properties of the
IQueueCounterEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
QUEUECOUNTER of the IEvaluation interface on page 182). and online
evaluations are possible through the method GetResult() of the
IQueueCounter interface.

Properties of the Interface IQueueCounterEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = qceval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
qceval.AttValue(„FILE“)= FALSE

COM Interface Manual © PTV AG 2009 207

3 Language Reference

Attribute outline

R W Attribute Description
9 9 FILE Write evaluation file flag (true/false)

Setting the FILE attribute to FALSE avoids writing the *.STZ evaluation file
while collecting evaluation data (if queue counter evaluation is activated)
for possible online requests. This attribute is specific to the COM interface
and is global to the VISSIM program (i.e. it will preserve its state
independently from the loaded *.INP file).

Methods of the Interface IQueueCounterEvaluation

3.9.14 TravelTimes
The TravelTimes Net
object is a collection of
TravelTime objects
TravelTimes TravelTime
(see page 210). It
belongs to the Net
object and can be
accessed through the
TravelTimes property
of the INet interface.
It contains all currently defined travel time measurements of the loaded
network (during a simulation run including the temporary ones created for
node evaluation) and enables iteration through the collection or individual
access to a TravelTime object.
Example
Instantiation of a TravelTimes object and access to all its TravelTime
objects:
Dim vissim As Vissim
Dim traveltimes As TravelTimes
Dim traveltime As TravelTime
Set vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set traveltimes = Vissim.Net.TravelTimes
FOR EACH traveltime IN traveltimes ‘access to _NewEnum
…
NEXT traveltime

‘or also:

208 VISSIM 5.10-06 © PTV AG 2009

 Results

FOR i = 1 TO traveltimes.Count
SET traveltime = traveltimes (i) ‘or traveltimes.Item(i)
…
NEXT i

Properties of the ITravelTimes Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all TravelTime objects.
Once a collection is created, individual members can be returned using the
GetTravelTimeByNumber method, while the entire collection can be iterated
using a FOR ...TO ... NEXT statement. In Visual Basic you can use the
statement FOR EACH…NEXT without using the property _NewEnum, which
VB calls internally (see TravelTimes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] ITravelTime **ppTT)

Returns a single TravelTime of the collection selected by position. This is
useful only when all travel time measurements shall be accessed (see the
TravelTimes example above). To select a data collection by its identifier
number use GetTravelTimeByNumber (see below). Since Item is the default
property for a collection the following commands are equivalent:
SET tt = TravelTimes(1)
SET tt = TravelTimes.Item(1)
Parameters
[in] long Index : index between 1 and TravelTimes.Count
[out, retval] ITravelTime **ppTT : returned TravelTime object

Count ([out, retval] long *pCount)

Returns the number of TravelTime objects in the collection. See the
TravelTimes example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the ITravelTimes Interface

GetTravelTimeByNumber ([in] long Number, [out, retval] ITravelTime

**ppTT)
Returns the TravelTime object with the identifier number Number.

COM Interface Manual © PTV AG 2009 209

3 Language Reference

Parameters
[in] long Number : identifier number
[out, retval] ITravelTime **ppTT : returned TravelTime object
Example
DIM tt AS TravelTime
SET tt = TravelTimes.GetTravelTimeByNumber (123)

3.9.15 TravelTime
A TravelTime object represents a TravelTimes TravelTime
travel time measurement element and
belongs to the TravelTimes object. It
can be accessed through the
TravelTimes object to in two ways:
► access via iteration through the collection
DIM traveltime As TravelTime
FOR EACH traveltime IN vissim.Net.TravelTimes
List.AddItem traveltime.ID
NEXT traveltime
► individual access via identifier
DIM traveltime As TravelTime
SET traveltime = vissim.Net. TravelTimes.GetTravelTimeByNumber (123)
The TravelTime object enables access to the properties of the travel time
measurement through the ITravelTime interface.

Properties of the Interface ITravelTime

ID ([out, retval] long *pID)

Returns the travel time measurement identifier number. If the TravelTime
object doesn’t refer to a valid VISSIM travel time measurement element
anymore the returned value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = traveltime.ID

Name ([out, retval] BSTR *pName)

Returns the travel time measurement name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = traveltime.Name

210 VISSIM 5.10-06 © PTV AG 2009

 Results

Name ([in] BSTR Name)

Sets the name of the travel time measurement. Maximal 255 charatcters.
Parameters
[in] BSTR Name : new name.
Example
traveltime.Name = „xxx“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a travel time measurement attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = traveltime.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a travel time measurement attribute. Please get the language
independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
traveltime.AttValue(„NAME“)=„xxx“

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

Methods of the Interface ITravelTime

GetResult ([in] double Time, [in] BSTR Parameter, [in] BSTR Function,
[in] long VehicleClass, [out, retval] VARIANT *pValue)
This method returns the collected result for the requested named parameter
(see parameters table below) and vehicle class. The returned value refers to
the data collected up to this moment for the time interval enclosing the
specified time point (it includes only travel times of vehicles that have
already passed the travel time destination section). The Function parameter
has currently no meaning.

COM Interface Manual © PTV AG 2009 211

3 Language Reference

Parameters
[in] double Time : Time point in seconds
[in] BSTR Parameter : parameter name (see below)
[in] BSTR Function : not used
[in] long VehicleClass: vehicle class number. 0 for all vehicle types
[out, retval] VARIANT *pValue: returned value (real number)
Example
nv = traveltime.GetResult(600, „NVEHICLES“, “”, 0) ‘vehicle throughput
tt = traveltime.GetResult(600, “TRAVELTIME”, “”, 1) ‘travel time for vehicles of class 1

Parameters outline

Parameter Description
NVEHICLES Vehicle throughput (numbe of vehicle measured)
TRAVELTIME Travel time [s]

To get results, the Offline Analysis option for travel times must be enabled.
Otherwise the result will be 0.0.

Data for each defined vehicle class can be requested even if the vehicle
class is not selected for the travel time measurement.

3.9.16 TravelTimeEvaluation
This object allows the Evaluation TravelTimeEvaluation
configuration of travel time
evaluations through the
methods and properties of
the ITravelTimeEvaluation
interface.
Offline evaluations are possible setting the appropriated flag (see attribute
TRAVELTIME of the IEvaluation interface on page 182).

Properties of the Interface ITravelTimeEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example

212 VISSIM 5.10-06 © PTV AG 2009

 Results

writtingfile = tteval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
tteval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 COMPILED Write the flag for compiled output (true/false)
9 9 FILE Write evaluation file flag (true/false)
9 9 RAW Write the flag for raw data output (true/false)

Setting the FILE attribute to FALSE avoids writing the *.RSZ and *.RSR
evaluation files while collecting evaluation data (if travel time evaluation is
activated) for possible online requests. This attribute is specific to the COM
interface and is global to the VISSIM program (i.e. it will preserve its state
independently from the loaded *.INP file).

Methods of the Interface ITravelTimeEvaluation

3.9.17 PedTravelTimes
The PedTravelTimes object is Net
a collection of PedTravelTime
objects (see page 210). It PedTravelTimes PedTravelTime
belongs to the Net object and
can be accessed through the
PedTravelTimes property of
the INet interface.
It contains all currently defined pedestrian travel time measurements of the
loaded network (during a simulation run including the temporary ones
created for node evaluation) and enables iteration through the collection or
individual access to a PedTravelTime object.

COM Interface Manual © PTV AG 2009 213

3 Language Reference

Example
Instantiation of a PedTravelTimes object and access to all its PedTravelTime
objects:
Dim vissim As Vissim
Dim traveltimes As PedTravelTimes
Dim traveltime As PedTravelTime
Set vissim = NEW Vissim
vissim.LoadNet “c:\vissim\daten\example.inp”
Set traveltimes = Vissim.Net.PedTravelTimes
FOR EACH traveltime IN traveltimes ‘access to _NewEnum
…
NEXT traveltime

‘or also:

FOR i = 1 TO traveltimes.Count
SET traveltime = traveltimes (i) ‘or traveltimes.Item(i)
…
NEXT i

Properties of the IPedTravelTimes Interface

_NewEnum ([out, retval] LPUNKNOWN *ppEnum)

This property creates a collection (or enumeration) of all PedTravelTime
objects. Once a collection is created, individual members can be returned
using the PedTravelTimeByNumber method, while the entire collection can
be iterated using a FOR ...TO ... NEXT statement. In Visual Basic you can
use the statement FOR EACH…NEXT without using the property
_NewEnum, which VB calls internally (see PedTravelTimes example above).
Parameters
[out, retval] LPUNKNOWN *ppEnum : returned Enumeration

Item ([in] VARIANT Index, [out, retval] IPedTravelTime **ppTT)

Returns a single PedTravelTime of the collection selected by position. This is
useful only when all pedestrian travel time measurements shall be accessed
(see the PedTravelTimes example above). To select a data collection by its
identifier number use PedTravelTimeByNumber (see below). Since Item is
the default property for a collection the following commands are equivalent:
SET tt = PedTravelTimes(1)
SET tt = PedTravelTimes.Item(1)
Parameters
[in] long Index : index between 1 and PedTravelTimes.Count
[out, retval] IPedTravelTime **ppTT : returned PedTravelTime object

214 VISSIM 5.10-06 © PTV AG 2009

 Results

Count ([out, retval] long *pCount)

Returns the number of PedTravelTime objects in the collection. See the
PedTravelTimes example above.
Parameters
[out, retval] long *pCount : returned number of objects.

Methods of the IPedTravelTimes Interface

PedTravelTimeByNumber ([in] long Number, [out, retval]

IPedTravelTime **ppTT)
Returns the PedTravelTime object with the identifier number Number.
Parameters
[in] long Number : identifier number
[out, retval] IPedTravelTime **ppTT : returned PedTravelTime object
Example
DIM tt AS PedTravelTime
SET tt = PedTravelTimes.PedTravelTimeByNumber (123)

3.9.18 PedTravelTime
A PedTravelTime object PedTravelTimes PedTravelTime
represents a pedestrian travel
time measurement element
and belongs to the
PedTravelTimes object. It can
be accessed through the
PedTravelTimes object to in
two ways:
► access via iteration through the collection
DIM traveltime As PedTravelTime
FOR EACH traveltime IN vissim.Net.PedTravelTimes
List.AddItem traveltime.ID
NEXT traveltime
► individual access via identifier
DIM traveltime As PedTravelTime
SET traveltime = vissim.Net. PedTravelTimes.PedTravelTimeByNumber (123)
The PedTravelTime object enables access to the properties of the
pedestrian travel time measurement through the IPedTravelTime interface.

COM Interface Manual © PTV AG 2009 215

3 Language Reference

Properties of the Interface IPedTravelTime

ID ([out, retval] long *pID)

Returns the pedestrian travel time measurement identifier number. If the
PedTravelTime object doesn’t refer to a valid VISSIM pedestrian travel time
measurement element anymore the returned value is 0.
Parameters
[out, retval] long *pID :returned identifier.
Example
id = traveltime.ID

Name ([out, retval] BSTR *pName)

Returns the pedestrian travel time measurement name.
Parameters
[out, retval] BSTR *pName : returned name.
Example
name = traveltime.Name

Name ([in] BSTR Name)

Sets the name of the pedestrian travel time measurement. Maximal 255
charatcters.
Parameters
[in] BSTR Name : new name.
Example
traveltime.Name = „xxx“

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a pedestrian travel time measurement attribute. Please get the
language independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
name = traveltime.AttValue(„NAME“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a pedestrian travel time measurement attribute. Please get the
language independent attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
traveltime.AttValue(„NAME“)=„xxx“

216 VISSIM 5.10-06 © PTV AG 2009

 Results

Attribute outline

R W Attribute Description
9 ID Identifier number
9 9 NAME Name

Methods of the Interface IPedTravelTime

3.9.19 PedTravelTimeEvaluation
This object allows the Evaluation PedTravelTimeEvaluation
configuration of travel time
evaluations through the methods and properties of the
IPedTravelTimeEvaluation interface.
Offline evaluations are possible setting the appropriated flag (see attribute
TRAVELTIME of the IEvaluation interface on page 182).

Properties of the Interface IPedTravelTimeEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = tteval.AttValue(„FILE“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
tteval.AttValue(„FILE“)= FALSE

COM Interface Manual © PTV AG 2009 217

3 Language Reference

Attribute outline

R W Attribute Description
9 9 COMPILED Write the flag for compiled output (true/false)
9 9 FILE Write evaluation file flag (true/false)
9 9 RAW Write the flag for raw data output (true/false)

Setting the FILE attribute to FALSE avoids writing the *.RSZ and *.RSR
evaluation files while collecting evaluation data (if travel time evaluation is
activated) for possible online requests. This attribute is specific to the COM
interface and is global to the VISSIM program (i.e. it will preserve its state
independently from the loaded *.INP file).

Methods of the Interface IPedTravelTimeEvaluation

3.9.20 PedDataCollectionEvaluation
This object allows the Evaluation PedTravelTimeEvaluation
PedDataCollectionEvaluation
configuration of data
collection
evaluations through the methods and properties of the
IPedDataCollectionEvaluation interface.
Offline evaluations are possible setting the appropriated flag (see attribute
DATACOLLECTION of the IEvaluation interface on page 182).

Properties of the Interface IPedDataCollectionEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
writtingfile = tteval.AttValue(„FILE“)

218 VISSIM 5.10-06 © PTV AG 2009

 Results

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
tteval.AttValue(„FILE“)= FALSE

Attribute outline

R W Attribute Description
9 9 COMPILED Write the flag for compiled output (true/false)
9 9 FILE Write evaluation file flag (true/false)
9 9 RAW Write the flag for raw data output (true/false)

Setting the FILE attribute to FALSE avoids writing the *.MEZP and *.MERP
evaluation files while collecting evaluation data (if data collection evaluation
is activated) for possible online requests. This attribute is specific to the
COM interface and is global to the VISSIM program (i.e. it will preserve its
state independently from the loaded *.INP file).

Methods of the Interface IPedDataCollectionEvaluation

3.9.21 PedProtocolEvaluation
This object allows the Evaluation PedTravelTimeEvaluation
PedPrptocolEvaluation
configuration of data
collection
evaluations through the methods and properties of the
IPedProtocolEvaluation interface.
Offline evaluations are possible setting the appropriated flag (see attribute
PROTOCOL of the IEvaluation interface on page 182).

COM Interface Manual © PTV AG 2009 219

3 Language Reference

Properties of the Interface IPedProtocolEvaluation

AttValue ([in] BSTR Attribute, [out, retval] VARIANT *pValue)

Returns a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[out, retval] VARIANT *pValue : returned value of the attribute
Example
tFrom = ppeval.AttValue(„TIMEFROM“)

AttValue ([in] BSTR Attribute, [in] VARIANT Value)

Sets a configuration’s attribute. Please get the language independent
attribute tag from the table at the end of this section.
Parameters
[in] BSTR Attribute : attribute name (see table below)
[in] BSTR Value : attribute value. (type according to attribute)
Example
ppeval.AttValue(„TIMEFROM“)= 42

Attribute outline

R W Attribute Description
9 9 TIMEFROM Write the flag to define the start time for the
evaluation
9 9 TIMEUNTIL Write the flag to define the end time for the
evaluation
9 9 RESOLUTION Write the flag to set the time resolution of the
evaluation

Setting the FILE attribute to FALSE avoids writing the *.PP evaluation files
while collecting evaluation data (if protocol evaluation is activated) for
possible online requests. This attribute is specific to the COM interface and
is global to the VISSIM program (i.e. it will preserve its state independently
from the loaded *.INP file).

Methods of the Interface IPedProtocolEvaluation

220 VISSIM 5.10-06 © PTV AG 2009

 Triggered Scripting

3.10 Triggered Scripting

VISSIM provides internal “hooks” where user-defined scripts can be attached
to be executed in certain situations. Access is done through the
TriggeredScripting interface.

3.10.1 TriggeredScripting
The TriggeredScripting Vissim TriggeredScripting
object belongs to Vissim
and can be accessed through the property TriggeredScripting of the IVissim
interface. It gives access to the configuration and information of triggered
scripts and their specific interfaces.
Example (instantiation of a TriggeredScripting object):
DIM vissim AS Vissim
DIM trigscripting AS TriggeredScripting
SET vissim = NEW Vissim
SET trigscripting = vissimm.TriggeredScripting

Properties of the ITriggeredScripting Interface

ManagedLanesTollCalculation([out, retval]
IManagedLanesTollCalculation** ppManagedLanesTollCalc);
Creates an instance of a ManagedLanesTollCalculation object (see page
221), that gives access to the individual properties of the triggered scripting
for the toll calculation of managed lanes.
Parameters
[out, retval] IManagedLanesTollCalculation ** ppManagedLanesTollCalc: returned object
Example
DIM managlaneTollCalc AS ManagedLanesTollCalculation
SET managlaneTollCalc = trigscripting.ManagedLanesTollCalculation

3.10.2 ManagedLanesTollCalculation

TriggeredScripting ManagedLanesTollCalculation

The ManagedLanesTollCalculation belongs to the TriggeredScripting object

and can be accessed through the property ManagedLanesTollCalculation of
the ITriggeredScripting interface. It gives access to the individual properties
of the triggered scripting for the toll calculation of managed lanes.

COM Interface Manual © PTV AG 2009 221

3 Language Reference

Example (instantiation of a ManagedLanesTollCalculation object):

DIM managlaneTollCalc AS ManagedLanesTollCalculation
SET managlaneTollCalc = trigscript.ManagedLanesTollCalculation

Properties of the IManagedLanesTollCalculation Interface

CurrentFacilityNo([out, retval] long* pNo)

Returns the number of the managed lanes facility which is referred by the
triggered script, i.e. the managed lanes facility for which this script should
calculate the toll.
Parameters
[out, retval] long* pNo : returned facility number.

CurrentUserClass([out, retval] long* pUserClass)

Returns the user class for which this script should calculate the toll.
User class 1 = SOV (single occupancy vehicle, 1 occupant)
User class 2 = HOV (high occupancy vehicle, 2 occupants)
User class 3 = HOV3+ (3 or more occupants)
Parameters
[out, retval] long* pUserClass : returned user class.

CurrentToll([in] double toll)

Sets the toll value in the current facility for the current user class.
Parameters
[in] double toll : toll value.

222 VISSIM 5.10-06 © PTV AG 2009

 Triggered Scripting

4 COM Access

All VISSIM COM interfaces support automation – they are based on the
Microsoft standard interface IDispatch. Automation interfaces disclose the
COM objects allowing the use of generic programming environments like
Visual Basic or Script languages like Visual Basic Script (VBScript) or Java
Script (JScript).

COM Interface Manual © PTV AG 2009 223

4 COM Access

4.1 Visual Basic

This chapter introduces the use of Visual Basic to create client applications.

4.1.1 Creation of a Visual Basic Client

To make VISSIM objects available from Visual Basic code, set a reference to
the VISSIM COM server type library:

With an active reference to the COM type information, Visual Basic is able to
list the possible object declarations and method calls during code editing:
Dim vissim As Vissim
Dim net As Net
Identifying the class name also provides Auto
List Member functionality. Each time you enter
the object variable name, you get the drop-
down list of the properties and methods
exposed by the object:

224 VISSIM 5.10-06 © PTV AG 2009

 Visual Basic

Vissim Furthermore, the object catalog enables you to browse

through all available objects, interface properties and
methods of the VISSIM COM server library. It also offers
a short description of every method and property of the
VISSIM COM server interfaces:

4.1.2 Collections (Different Ways to Enumerate)

Visual Basic has a special language constructor to handle collections:
FOR EACH element IN collection
‘ do something with the element
NEXT element
In order to use this kind of syntax to loop over collections, a specific COM
standard interface must be supported (IEnumVARIANT). The VISSIM
objects named with plural (like Nodes, Paths, Vehicles, …) are collection
objects that implement this functionality. These objects can be treated as
enumerations and allow to handle all the objects they contain sequentially:
For example, the following Visual Basic code will loop over all link objects of
the collection links:

COM Interface Manual © PTV AG 2009 225

4 COM Access

DIM links AS Links

DIM link AS Link
SET links = vissim.Net.Links
FOR EACH link IN links
WITH link
nr = .ID
name = .Name
length = .AttValue (“LENGTH”)
END WITH
NEXT link
The number of elements of a VISSIM object collection can be requested with
the method Count:
Dim number As Long
number = links.Count

4.1.3 Arrays
Another language element for object sequences is the array. In the context
of the VISSIM COM server an array is a fixed n-dimensional sequence of
indexed elements. These elements can be VISSIM objects or Visual Basic
types and are encapsulated by a VARIANT type. The array type returned for
some of the VISSIM object methods conforms to automation and allows the
use of the Visual Basic array functionality as LBOUND and UBOUND to
ensure safe access within the array limits. To know which method returns or
needs an array as a parameter, refer to the respective specification in this
document. For example: to access to the link geometry the AttValue together
with the named attribute “POINTS” can be used. This attribute returns an
array of world xy-coordinates:
DIM polyline() ´array of VARIANT
polyline = link.AttValue(„POINTS“)
FOR i = LBOUND(polyline) TO UBOUND(polyline)
x = polyline (i).X
y = polyline (i).Y
NEXT i
Results from a data collection point (like speed or accelerations) will be
returned in a two dimensional array:
res = datacollection.GetResult(„ACCELERATION“, „FREQUENCIES“) ‘2-dim array
FOR i = LBOUND(res) TO UPBOUND(res)
from = res(i, 0)
to = res(i, 1)
val = res(i, 2)
NEXT i
Methods like AddPathAsNodeSequence from the IPaths interface, need an
array as a parameter. In this case the use of the Visual Basic function Array
is suggested, which creates an array as a VARIANT from a sequence of
given parameters:
DIM path AS Path
SET path = paths.AddPathAsNodeSequence (1, Array(10, 20, 30, 40))

226 VISSIM 5.10-06 © PTV AG 2009

 Visual Basic

4.1.4 Error Handling

When an interface returns an error, the intrinsic object “Err” with global
scope is created and can be used within the exception handling mechanism
of Visual Basic: On Error GoTo. If you don't use an On Error GoTo
statement, any run-time error that occurs is fatal; that is, an error message is
displayed and execution stops. The following example shows a way to
handle errors:
DIM net as Net
DIM links AS Links
SUB Load_Click()
SET net = vissim.Net
SET links = net.Nodes
ON ERROR GOTO exception ‘ an Err object is created and continues in exception

NodesListbox.Clear
FOR EACH link IN links
NodesListbox.AddItem link.ID
NEXT link

EXIT SUB ‘subroutine ends here

excpetion:
MsgBox Err.Description ‘ use here the created Err object
END SUB
The error-handling routine – a section of code marked by a label, here
“exception” – should test or save relevant property values of the Err object
before any other error can occur or before a procedure that might cause an
error is called. The property values of the Err object reflect only the most
recent error. The error message associated with the property Err.Number is
contained in property Err.Description. See the annex on page 252 for a
summary of all error messages of the VISSIM server.
Other possible error handling mechanisms of Visual Basic are the On Error
Resume Next and On Error Goto 0. Refer to the VB manual for more details.

4.1.5 A Visual Basic Client Example

The following simple VB client shows how to run several simulations with
different random seeds:
‘declare some VISSIM COM types
DIM vissim AS Vissim
DIM simulation AS Simulation
Sub Main()
ON ERROR GOTO exception
‘start VISSIM and create an instance of a Vissim object
SET vissim = NEW Vissim
‘load a network
vissim.LoadNet App.Path + "\3path.inp"
‘run a simulation
DIM seeds AS VARIANT
seeds = Array(22, 34, 56, 11)

COM Interface Manual © PTV AG 2009 227

4 COM Access

SET simulation = vissim.Simulation

FOR i = LBOUND(seeds) TO UBOUND(seeds)
simulation.RandomSeed = seeds(i)
simulation.RunContinuous
NEXT i
vissim.Exit
EXIT SUB
exception:
MsgBox Err.Description ‘ use here the create Err object
END SUB
It is possible to collect results of every simulation like path evaluations using
the method RunIndex of the ISimulation interface. This method allows you to
index the evaluation files of each run. It is suggested to configure an *.ini file
with the desired options and to load it with the method LoadLayout of the
IVissim interface before starting the iteration procedure.

4.1.6 Advanced Issues Using Visual Basic

Creating the Vissim class object

Internally, VB has two mechanisms for creating objects: VB can use its own
object creation services, or it can use the services of the Component Object
Model (COM). VB selects the services depending on the location of the class
and on the code used to create the object. There are three coding
techniques for creating a Vissim object. You can create it explicitly using the
NEW keyword with the SET statement as seen on the examples above. You
can create it implicitly using the NEW keyword on the declaration or you can
use the CreateObject function:
‘ 1) explicit creation through VB internal creation services
DIM vissim AS Vissim
SET vissim = NEW Vissim

‘ 2) implicit creation through VB internal creation services

DIM vissim AS NEW Vissim
Vissim.LoadNet(“example.inp”)

‘ 3) creation through the register (no type library reference in VB is needed)

DIM v AS Object
SET v = CreateObject(“VISSIM.Vissim”)

VB uses its own object services (and the referenced type library information)
when you use the NEW keyword either on the declaration or in the SET
statement. VB uses COM (with the register information) if you use the
CreateObject function (a reference to the VISSIM COM server type library is
not necessary in this case). This distinction can make a difference in how
you can develop your application and how it executes.
Furthermore it is possible to create an instance of a Vissim object class
remotely using the optional parameter of CreateObject:
‘ 3) creation through the register information of a remote machine

228 VISSIM 5.10-06 © PTV AG 2009

 Visual Basic

DIM v AS Object
SET v = CreateObject(“VISSIM.Vissim”, “MyServer”) ‘ name or IP address
Please refer to the remote access chapter on page 249 for details.

Early-Bound versus Late-Bound

When you call a property or method on an object, VB must look up the
property or method, place the arguments on the stack, invoke the property or
method, and return. Early binding implies VB can look up the properties and
methods of an object at compile time. It can then store the internal location
of the property or method in the compiled code. When VB calls a method at
run time, it can execute the method directly. Late binding means VB can’t
look up an object’s properties and methods until run time, this lookup means
another cross process call, thereby doubling the call overhead.
How you declare the object, not how you create the object, determines
whether the properties and methods of the object are early-bound or late-
bound. For early binding, you identify the name of the class on the
declaration:
DIM vissim AS Vissim
This allows VB to perform the binding at compile time. For late binding, you
simply identify an object:
DIM vissim AS Object
In this case the object is identified at run time. VB must then look up each
property and method for that particular object. This means there’s a greater
chance of runtime errors, because VB can’t determine the list of properties
and methods exposed by the object until run time.

When using early binding a reference to the VISSIM COM server type
library must be set within the VB programming environment. This can
cause some conflicts when installing newer versions of VISSIM, which
could have modified the type library. Unselecting and selecting again the
reference to the VISSIM COM server forces VB to reinterpret the type
library. Please refer to the annex “Tips and hints” on page 259 for details
about VISSIM versions and its COM server interface.

COM Interface Manual © PTV AG 2009 229

4.2 Visual C++
The programming of a COM client in C++ alters according to platform,
compiler and library. The initialization and declarations for using the COM
functionality and components suggested here are focused on the Microsoft
Visual C++ compiler and its standard COM library (ole32.lib). Other less
specific alternatives will be also pointed to in the course of this chapter.

4.2.1 Creation of a VC++ Client

Client applications must initialize the COM library before they can call COM
library functions. This can be done with the functions CoInitialize() or
CoInitializeEx(). The respective end of initialization function CoUninitialize()
must be called on application shutdown; it will release automatically all
created COM objects. The preprocessor directive _WIN32_DCOM must be
defined and the header file <objbase.h> must be included in order to use
these functions.
#define _WIN32_DCOM
#include <iostream>
using namespace std;
#include <objbase.h>
int main()
{
cout << "Client: Calling CoInitialize()" << endl;
CoInitializeEx(NULL, COINIT_MULTITHREADED);
// do something
cout << "Client: Calling CoUninitialize()" << endl;
CoUninitialize ();
return 0;
}
With the Visual C++ compiler you can use the #import preprocessor directive
to make VISSIM objects available for Visual C++ code:
// modify path to your needs
#import "c:\Programs\ptv-vision\VISSIM400\exe\vissim.exe"
using namespace VISSIM_COMSERVERLib;
You can use the directive option no_namespace if you don’t want to use a
namespace for the VISSIM COM server. Alternatively you can import the
supplied TLB library VISSIM_COMServer.tlb with the same effect. The
application of this directive allows the direct use of the Microsoft specific
smart pointers when working with COM objects (see the compiler-generated
Primary Type Library Header File, *.tlh, for details on the declarations).
Smart pointers offer a straight access to the VISSIM COM server objects;
the following code line creates an instance of a Vissim object:
IVissimPtr spVissim(__uuidof(Vissim));
The smart-pointer IVissimPtr is declared in the generated *.tlh file using the
template _com_ptr_t. This implementation encapsulates interface pointers
and eliminates the need of keeping track of the reference count calling

VISSIM 5.10-06 © PTV AG 2009 231

4 COM Access

AddRef() and Release() functions. In addition, it hides the

CoCreateInstance() call.
Another possibility is the use of the CreateInstance() method:
HRESULT hr;
IVissimPtr spVissim;
hr = spVissim.CreateInstance("VISSIM.Vissim", NULL, CLSCTX_LOCAL_SERVER);
The directive #import also facilitates usage of the interface methods and
properties by declaring appropriate wrapping inline member methods for
every interface (see the compiler-generated Secondary Type Library Header
File, *.tli, for details on the declarations). Once a VISSIM instance is created
the Net and Simulation objects can be accessed through the IVissim
interface:
INetPtr spNet;
spNet = spVissim->GetNet();
ISimulationPtr spSim;
spSim = spVissim->GetSimulation();
double period = spSim->GetPeriod();
When using other compilers than Microsoft Visual C++ a more standard way
of using COM components must be applied. The supplied files
VISSIM_COMServer.h and VISSIM_COMServer_i.c contain the standard
C++ code declarations for the VISSIM server interfaces. Including these to
files has a similar effect like the VC++ #import preprocessor directive:
#include "VISSIM_COMServer.h"
#include "VISSIM_COMServer_i.c"
In this case it is necessary to work with C++ pointers and to use the
available functions of the COM technology implementation. In the case of
Microsoft, the objbase.h file must be included and the use of
CoCreateInstance allows the first instantiation of the Vissim object:
HRESULT hr;
IVissim* pVissim;
hr = CoCreateInstance(CLSID_Vissim, NULL,
CLSCTX_LOCAL_SERVER, IID_IVissim, (void**)&pVissim);
if (FAILED(hr)) exit;
The access to the methods and properties must use the functions declarated
in the header file: VISSIM_COMServer.h:
HRESULT hr;
INet* pNet;
hr = pVissim->get_Net(&pNet);
if (FAILED(hr)) exit;
ISimulation* pSim;
hr = pVissim->get_Simulation(&pSim);
if (FAILED(hr)) exit;
double period;
hr = pSim->get_Period(&period);
if (FAILED(hr)) exit;

232 VISSIM 5.10-06 © PTV AG 2009

 Visual C++

4.2.2 Collections (Different Ways to Enumerate)

As in Visual Basic it is possible to iterate through a collection in different
ways: 1) using the IEnumVARIANT interface, supported for all VISSIM COM
server enumeration objects, and 2) using the Item() method.
While the use of the of the _NewEnum() method is implicit in VB, in C++ it
must be called explicitly. But thanks to the combination of template classes
that allow to cast smart pointers instead of having to call QueryInterface(),
the code just takes one line:
IEnumVARIANTPtr spEnum(spLinks->Get_NewEnum());
The smart-pointer spEnum points to the enumeration object of the collection
and offers the method Next() to iterate over its elements:
long id;
unsigned long ulFetched;
_variant_t var;
spEnum->Next(1, &var, &ulFetched);
while (ulFetched == 1) {
id = ((ILinkPtr)var.pdispVal)->GetID();
spEnum->Next(1, &var, &ulFetched);
}
a more efficient form is calling the method Next() just once for an array:
long id, count = spLinks->GetCount();
unsigned long ulFetched;
_variant_t* avar= new _variant_t[count];
spEnum->Next(count, avar, &ulFetched);
for (int i = 0; i < count; i++) {
id = ((ILinkPtr)avar[i].pdispVal)->GetID();
}
and alternatively it is possible to iterate as in VB, using the Item() method:
long jCount = spLinks->GetCount();
_variant_t jvar = 1L;
for (long j = 1; j <= jCount; j++, jvar = j) {
id = spLinks->GetItem(jvar)->GetID();
}

4.2.3 Arrays
The Automation type for arrays is the SAFEARRAY. A SAFEARRAY is a
self-descriptive, multidimensional vector type. It was introduced originally by
Visual Basic and therefore this type is identical to the Visusal Basic array. In
C++ it is necessary some help to deal with them. We purpose here two
possibilites to deal with SAFEARRAYS with C++: 1) using API functions and
2) using the Active Template Library ATL wrappers (starting at version ATL
7.0).
The use of the API function SafeArrayCreate() is somehow more tediuos and
implies more lines of code. For example to create an arry containing
long ids[] = {1, 2, 5, 11, 3, 7};
VARIANT var;
VariantInit(&var);

COM Interface Manual © PTV AG 2009 233

4 COM Access

SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];
long rgindice[1];
rgsabound[0].lLbound = 0;
rgsabound[0].cElements = sizeof ids / sizeof *ids;
psa = SafeArrayCreate(VT_VARIANT, 1, rgsabound);
for (long i = 0; i < sizeof ids / sizeof *ids; i++) {
rgindice[0] = i;
var.lVal = ids[i];
var.vt = VT_I4;
SafeArrayPutElement(psa, rgindice, &var);
}
var.parray = psa;
var.vt = VT_ARRAY | VT_VARIANT;
spPaths->AddPathAsNodeSequence(1, var);
The available SAFEARRAY wrapper classe introduced in ATL7
CComSafeArray<T>, simplify the construction and access:
CComSafeArray<VARIANT> array(sizeof ids / sizeof *ids);
for (long i = 0; i < sizeof ids / sizeof *ids; i++) {
array.SetAt(i, CComVariant(ids[i]));
}
spPaths->AddPathAsNodeSequence(1, CComVariant(array));

4.2.4 Error Handling

The wrapping functions declared in the Secondary Type Library Header File
(*.tli) check the availability of an error after calling the interface’s virtual
functions, convert it into a _com_error (a class that encapsulates the COM
error object) and throw it. Therefore, when using the #import preprocessor
directive, error handling is limited to the catch of _com_error exceptions:
try {
IVissimPtr spVissim(__uuidof(Vissim));
ISimulationPtr pSim;
pSim = pVissim->GetSimulation();
}
catch (_com_error &error) {
cout << error.Description() << endl;
}
The Microsoft specific error-handling wrapper class _com_error
encapsulates the HRESULT and offers the possibility to get more precise
error information (if an ErrorInfo object is associated to the error, which will
be the case for all VISSIM VOM server objects).
When you do not use the #import directive you must check the returned
HRESULT and access the IErrorInfo manually:
HRESULT hr;
INet* pNet;
hr = pVissim->get_Net(&pNet);
If (FAILED(hr)) {
BSTR description = 0;
IErrorInfo* pEI;
GetErrorInfo (0, & pEI);

234 VISSIM 5.10-06 © PTV AG 2009

 Visual C++

pEI->GetDescription (&description);
}

4.2.5 A Visual C++ Client Example

The following simple VC++ client shows how to run several simulations with
different random seeds:
#define _WIN32_DCOM
#include <iostream>
using namespace std;
// import of all VISSIM COM server interfaces // modify path to your needs
#import "G:\VISSIM\Exes\371#\vissim.exe"
using namespace VISSIM_COMSERVERLib;
int main()
{
HRESULT hr;

cout << "Client: Calling CoInitialize()" << endl;

hr = CoInitialize(NULL);
if (FAILED(hr)) return 1;
try {
// Create the Vissim object (connection to ISSIM COM server)
cout << "Client: Creating a Vissim instance with the smartpointer IVissimPtr" <<
endl;
IVissimPtr spVissim(__uuidof(Vissim));
// Create a Simulation object
cout << "Client: Calling GetSimulation()" << endl;
ISimulationPtr spSim;
spSim = spVissim->GetSimulation();
// read network and layout
char buf[255] = "";
GetCurrentDirectory (sizeof(buf), buf);
_bstr_t path(buf);
spVissim->LoadNet (path + "\\fixed_time.inp", 0);
spVissim->LoadLayout (path + "\\link_eval.ini");
// initialize simulations
cout << "Client: Setting simulations" << endl;
long seeds[4] = {10, 20, 30, 42};
spSim->PutPeriod(100);
spSim->PutResolution(1);
spSim->PutSpeed(5);
// run simulations
cout << "Client: Starting simulations:" << endl;
for (int index = 0; index < 4; index++) {
cout << " Client: Initializating simulation " << index+1 << endl;
spSim->PutRunIndex(index);
spSim->PutRandomSeed(seeds[index]);
spSim->PutComment("Random seed =" + _bstr_t(ltoa(seeds[index], buf, 10)));
cout << " Client: Running simulation " << index+1 << " ..." << endl;
spSim->RunContinuous();
}
}
catch (_com_error &error) {
cout << (char*)(error.Description()) << endl;

COM Interface Manual © PTV AG 2009 235

4 COM Access

}
cout << "Client: Calling CoUninitialize()" << endl;
CoUninitialize ();
return 0;
}

236 VISSIM 5.10-06 © PTV AG 2009

4.3 .NET
There is a two-way interoperability between COM and .NET technology.
Because of that, the use of the VISSIM COM Server from a .NET based
client is almost automatic. Almost, because it is necessary the generation of
an assembly that matches the metadata of the VISSIM COM Server type
library.
There are four ways to get the respective assembly:
Using Visual Studio .NET Automatically converts COM types in a type
library to metadata in an assembly.
Using the Type Library Provides command-line switches to adjust
Importer tool (tlbimp.exe) metadata in the resulting file, imports types
from an existing type library, and generates an
assembly and a namespace.
Using the Exposes methods that perform conversion-
TypeLibraryConverter related actions.
class
Programming a As a less desirable option, you can create type
customized wrapper. definitions from scratch.
If you are using Visual Studio .NET to generate a .NET client we recommend
the first possibility. If not, the use of .NET Framework tool TLBIMP.EXE. The
other two possibilities are required for the use of the VISSIM CM Server.

4.3.1 Creation of a Client Using Visual Studio .NET

Independently of the chosen programming language, when using Visual
Studio .NET it is necessary to add a reference to the VISSIM COM Server
by:
1. From the Project menu, select References.
2. Select the COM tab.
3. Select the VISSIMCOM_Server library from the references list
4. Click OK.

VISSIM 5.10-06 © PTV AG 2009 237

4 COM Access

This will automatically create the wrapper assembly

Interop.VISSIM_COMSERVERLib.dll (Interop stands for the interoperability
between COM and .NET) that allows the access to the objects and
interfaces of the VISSIM COM Server through the default namespace
VISSIM_COMSERVERLib.
Interfaces, normally prefixed with an ”I”, get an additional name without
prefix (for example, VISSIM_COMSERVERLib::ISimulation and
VISSIM_COMSERVERLib:: Simulation, are allowed to refer for ISimulation
interface).
COM Objects are suffixed with “Class”. In our case this is only relevant for
the Vissim object, which must be referred as
VISSIM_COMSERVERLib::VissimClass.

Example with Visual Basic .NET

Dim vis As VISSIM_COMSERVERLib.Vissim
Dim sim As VISSIM_COMSERVERLib.Simulation

vis = New VISSIM_COMSERVERLib.VissimClass

vis.LoadNet(“example.inp")
sim = vis.Simulation
sim.RunContinuous()

238 VISSIM 5.10-06 © PTV AG 2009

 .NET

Please, refer to the chapter “Upgrading from Visual Basic 6.0” of the MSDN
for a description of the differences between the Visual Basic and Visual
Basic .NET.

Example with Visual C++.NET

#using <mscorlib.dll>
using namespace VISSIM_COMSERVERLib;
int main()
{
Vissim *vis = new VissimClass;
vis->LoadNet("example.inp", false);
Simulation *sim = vis->Simulation;
sim->RunContinuous();
return 0;
}

Example with Visual C#

using System;

using VISSIM_COMSERVERLib;

public class Client

{
public static void Main()
{
Vissim vis = new VissimClass();
vis.LoadNet("E:\\VISSIM\\COM\\VBA\\GROSSFKT.INP", 0);

Simulation sim = vis.Simulation;

sim.RunContinuous();

System.Console.WriteLine("Hello, World!");
}
}

Example with Visual J#

package VissimClient;
import VISSIM_COMSERVERLib.*;
public class Client
{
public static void main()
{
Vissim vis = new VissimClass();
vis.LoadNet("E:\\VISSIM\\COM\\VBA\\GROSSFKT.INP", (ubyte)0);
Simulation sim = vis.get_Simulation();
sim.RunContinuous();
}
}

Please, refer to the chapter “Upgrading from Visual J++ 6.0” of the MSDN
for a description of the differences between the Visual J++ and Visual J#.

COM Interface Manual © PTV AG 2009 239

4 COM Access

4.3.2 Arrays
The corresponding .NET Framework built-in type for the COM Automation
type VARIANT is the System.Object type. Because array in VISSIM are
passed as VARIANTs and the managed arrays of the .NET Framework are
System.Objects, we can use directly the managed array operator __gc[ ] to
construct array for VISSIM. Methods like AddPathAsNodeSequence() from
the IPaths interface, need and array of VARIANTs therefore we need also to
encapsulate the values on System.Objects. For this purpose we use the
keyword __box:
System::Object* array __gc[] = {__box(1), __box(2), __box(5), __box(7)};
pPaths->AddPathAsNodeSequence(1, array);
The variable array is here a managed array of System.Objects which will be
passed as an Object itself and marshaled by default into a VARIANT.
Similarly in Visual Basic .Net it would be:
Dim array() As Object = {1, 2, 5, 11, 3, 7}
paths.AddPathAsNodeSequence(1, array)

4.3.3 Events
Some objects of the VISSIM COM Server (see the description of the
DynmamicAssignment on page 182 for an example) sent events to the
client. To consume an event in a client application, you must provide an
event handler (an event-handling method) that executes program logic in
response to the event and register the event handler with the event source.
The WithEvents statement and the Handles clause provide a declarative way
of specifying event handlers. Events raised by an object declared with the
WithEvents keyword can be handled by any procedure with a Handles
statement for that event. The following Visual Basic .NET code illustrates
how to do this, taking the example of the DynamicAssignment object and its
event EdgeSmoothing:
Dim WithEvents dyn As DynamicAssignemnt
Private Function dyn_EventHandler(ByVal a As Double, ByVal b As Double) As Double Handles
dyn.EdgeSmoothing
Return (1.0# - 1.0# / nIt) * a + 1.0# / nIt * b
End Function
The EdgeSmoothing events raised by the obejct dyn will be handled by the
function dyn_EventHandler.

4.3.4 Error Handling

COM methods report errors by returning HRESULTs; .NET methods report
them by throwing exceptions. The runtime automatically maps the HRESULT
from COM interop to more specific exceptions. For example,
E_OUTOFMEMORY becomes OutOfMemoryException. If the HRESULT is

240 VISSIM 5.10-06 © PTV AG 2009

 .NET

a custom result or if it is unknown to the runtime, the runtime passes a

generic COMException to the client. The ErrorCode property of the
COMException contains the HRESULT value. The in C++ could be:
try {
vis->LoadNet("example.inp", false);
}
catch (System::Exception* pEx) {
System::Console::WriteLine(S"Generic Exception Handler: {0}", pEx->Message);
}
and in Visual Basic .NET:
Try
vis.LoadNet("example.inp")
Catch ex As Exception
MsgBox(ex.Message)
End Try

COM Interface Manual © PTV AG 2009 241

4.4 Java
Similarly to the use of the use of .NET, the use of Java is very
homogeneous. The objects and interfaces of the VISSIM COM Server type
library are made available to a Java client by generating a package with
wrapper classes for all entities present in the type library. This package can
be used by any Java code, typically with a import statement to make
possible the use of abbreviated names for the classes.

4.4.1 Creation of a COM Wrapper

A large list of tools to create Java-COM bridges, commercials and not
commercials, are available (Jawin, Jace, JACOB, R-JAX, jacoZoom,
jactivex, J-Integra, JunC++ion, JCOM, ...). Depending on the concrete
platform and software environment, a tool will be preferred to another. The
support of COM Automation types must be guaranteed. For example, a map
of the COM VARIANT type into a java type, e.g. java.lang.Object type and a
VARIANT containing an array maps to a Java array. If you are looking for a
Java-COM bridge that works for any Java VM on any platform, including
UNIX, please check out the J-Integra product.
If using Microsoft Java Virtual Machine Support (MSJVM) and the tool
jactivex, please consider the notes on
http://www.microsoft.com/mscorp/java/. The MSJVM will reach its end of life
on December 31, 2007.
An alternative ist the use of a software solution for bridging Java and .NET.
Consider the way interoperability between COM and .NET technology (see
chapter on using COM eith .NET on page 237) and the use of the
VISSIMCOMServer assembly.

4.4.2 Creation of a Java client

Once the COM wrapper classes has been created, Java can use the VISSIM
objects and interfaces exactly as if they were native Java objects and
interfaces. The wrapper classes have the same names as the corresponding
VISSIM COM Server entities:
import VISSIM.VISSIM_COMSERVER.*;
class VissimSim
{
private static IVissim vis;
private static ISimulation sim;
public static void main ( String[] args )
{
try {
vis = new Vissim();
sim = vis.getSimulation();

VISSIM 5.10-06 © PTV AG 2009 243

4 COM Access

sim.runContinuous();
}
catch (Exception e) {
e.printStackTrace();
}
}
}
Please refer to the documentation of the used Java-COM bridge for the use
of Automations types.

244 VISSIM 5.10-06 © PTV AG 2009

 Delphi

4.5 Delphi
Similary to Microsoft Visual Studio, the Borland Developer Studio Delphi
offers also the possibility to import a Type Library. This chapter introduces
briefly to the use of the VISSIM COM interface using Delphi 2006 and with
an example using Object Pascal.

4.5.1 Creation of a Client Using Delphi 2006

Primarily it is necessary to add a reference to the VISSIM COM Server by:

1. From the Delphi IDE select the Import Component submenu form the
Component Menu.
2. Select “Import a Type Library”.
3. Select the VISSIMCOM_Server library from the registered Type Libraries
list and click “Next >>”

4. Toggle on “Generate Component Wrappers”. This will generate the

necessary wrapper classes. Meanwhile, in the “Unit or Dir Name”, specify

COM Interface Manual © PTV AG 2009 245

4 COM Access

the path for the unit file to be generated. This file is named
VISSIM_COMSERVERLib_TLB.pas.

5. Select “Create Unit” and click “Finish”.

Example
The following code illustrates the use of the COM interface in Object Pascal.
Note that the unit “VISSIM_COMSERVERLib_TLB” is included in the uses
list:

unit VISSIMCOM_Delphi;
interface
uses
Windows, Messages , SysUtils, Variants, Classes, VISSIMCOMSERVERLib_TLB;
implementation
procedure start;
var
intfVISSIM : TVissim;
intfSIMULATION : TSimulation
begin
intfVISSIM := TVissim.Create(Self);
intfSIMULATION := intfVISSIM.Simulation;
intfSIMULATION.RunContinuous;
intfVISSIM.Exit;
intfVISSIM.Free;
end;

246 VISSIM 5.10-06 © PTV AG 2009

 Delphi

end.

COM Interface Manual © PTV AG 2009 247

5 Remote COM Access

Some issues must be taken in account when accessing the VISSIM COM
Server from a client on a remote machine. First of all, VISSIM must be
registered on the server machine as usual (see page 11 about registration).
Second, launch and access permissions must be properly set in order to
allow the client’s identification to run and use the registered VISSIM COM
server.
In order to configure the security matters the DCOMCNFG.EXE is suggested
(please refer to the Windows documentation for the use of this tool). This
tool allows mainly to set properly the necessary permissions flags for the
authentication level, the launch permission and the access permission. It
also allows you to select the identity (or the RunAs register) for the server
process 1) interactive user, 2) launching user and 3) a specific user:

If you choose interactive user, you're commanding COM to assign the server
process the identity of the person logged in at the server console -the
"interactive user"- when a launch occurs. Interactive is the only option that
permits to start VISSIM normally with its GUI. But it can't be launched if
there's no one logged in on the server -that is, if there is no interactive user.

VISSIM 5.10-06 © PTV AG 2009 249

5 Remote COM Access

The launching user simply tells COM to assign the server process the
identity of the remote client process that did the launching. This enables the
process to launch even if no interactive user is logged in, which means that
the VISSIM will work in underground mode without a GUI.
The "This user" option sets up a special user account for each server to run
under. If a COM server is configured to run as Vissim Object, and if Vissim
Object is a valid account on the server, then when launched, the remote
server process is assigned the identity of Vissim Object. It matters not who's
logged in on the server (or if anyone is logged in at all) or who launched the
process.

250 VISSIM 5.10-06 © PTV AG 2009

6 Annexes

VISSIM 5.10-06 © PTV AG 2009 251

6 Annexes

6.1 Error Messages

All possible errors that can occur during the use of the VISSIM COM Server
are classified in four categories:
1. Windows errors: Low level exceptions generated by the system (wrong
memory handling, division by zero, etc). It is not possible to recover the
COM server when such an error occurs. These errors must be reported
and fixed by the VISSIM development team. Please, contact the VISSIM
hotline.
2. COM errors: Exception generated by one of the COM support classes
and libraries (e.g.: the COM object Vissim couldn’t be instantiated). A
common COM error occurs when using a previously working client,
having installed a new version of VISSIM. Refer to the Tips and Hints
annex on page 259 to solve this problem. Other probably causes of
these kind of errors are corrupted registering of VISSIM or user system
rights. Please ensure that VISSIM has been installed correctly (refer to
11) and with administration rights and that all register entries are
available (refer to annex for a detailed list of the register information). If
the error persists or you are not aware of the system register function,
please contact the VISSIM hotline.
3. VISSIM errors: Exception generated by internal VISSIM procedures
(e.g.: a simulation couldn’t write the required results). These kinds of
errors can be of very different nature, depending on the context and the
concrete used interface and method. Please, refer to the list of
messages below to handle or workaround adequately the error. Another
possibility is the use of the interface on a not expected but valid way; this
could imply a desired enhancement for future versions. Please contact
the VISSIM hotline to report the concrete case.
4. User errors: Errors generated by the wrong use of the COM interfaces
(e.g.: a wrong node sequence is used for the creation of a new path).
Again, these kind of errors can be of very different nature, depending on
the context and the concrete used interface and method. Please, refer to
the list of messages below to handle or workaround adequately the
error.
COM error messages Description
An unspecified error has General message if no more concrete
occurred in COM. information is available.
An error has occurred The COM server couldn’t be initialized.
while initializing the VISSIM will work without supporting the COM
VISSIM COM server. Error functionality. This error should never show up,
<number> returned. please contact the VISSIM hotline.
Access denied while VISSIM couldn’t set up register with the
registering the COM entries for the COM server interfaces,
server. because of system access rights. VISSIM will
work without supporting the COM

252 VISSIM 5.10-06 © PTV AG 2009

 Error Messages

COM error messages Description

functionality. Please, be sure you have he
user rights for accessing (reading and writing)
the system register.
An error has occurred VISSIM couldn’t set up register with the
while registering the entries for the COM server interfaces,
VISSIM COM server. Error because of unknown reasons. VISSIM will
<number> returned. work without supporting the COM
functionality. Please, be sure you have he
user rights for accessing (reading and writing)
the system register.
Access denied while VISSIM couldn’t set up remove the register
unregistering the COM entries for the COM server interfaces,
server. because of system access rights.
An error has occurred VISSIM couldn’t set up remove the register
while unregistering the entries for the COM server interfaces,
VISSIM COM server. Error because unknown reasons.
<number> returned.
An error has occurred It has not been possible to create an instance
while creating an object. of a requested object. A possible cause is the
use of a previously working client with a new
installed VISSIM version (refer to the Tips and
Hints annex on page 259).
An error has occurred Internal error. The requested object couldn’t
while binding an object. be bound to the VISSIM data. The causes of
this error are of internal nature a can neither
be solved by the user nor have a possible
workaround. Please report it to the VISSIM
hotline.
Not implemented method The interface method is not supported.
called. Possibly the method is still not implemented
or the concrete object instance don’t support
it.

VISSIM error messages Description

An unspecified error has General message if no more concrete
occurred in VISSIM. information is available. Please contact to the
VISSIM hotline.
An error has occurred VISSIM couldn’t server a requested event
dispatching the VISSIM from a COM call. There is any concrete cause
event <number>. for this error. Please report it to the VISSIM
hotline.
The object link to the The object on the client side is no longer valid

COM Interface Manual © PTV AG 2009 253

6 Annexes

VISSIM error messages Description

VISSIM data is no longer in VISSIM. The most common case for this
valid. error is the Vehicle objects, which are
available only during a time frame of the
simulation period. Trying to access them
outside this time frame, once they have been
previously instantiated and accessed
successfully, produce this error. Refer to the
notes in the IVehicle interface description on
this document for more information. Another
possibility is when the data (network element,
e.g. link, data collection ...) has been removed
manually from the network editor.
The file couldn't be loaded. It is not possible to open or read the
requested file. Please be sure of the
existence, format and access rights to the file.
The file couldn't be saved. It is not possible to write the requested file.
Please be sure that you have the writing
accesses and that the hard drive is not full.
No valid time text. The passed string format couldn’t be
interpreted to a valid time. Valid formats are:
[hh:mm:ss] or [h:mm:ss], [hh:mm.ss] or
[h:mm.ss], [hh:mm] or [h:mm].
The simulation couldn't be Not possible to start a simulation. The
initialized reasons are of different nature. Please, try to
start the simulation manually from the network
editor and ensure that all necessary data for
the requested simulation is available (e.g.
configuration files for results, signal control
files, etc.). Try also to save the layout (*.ini
file) of the working simulation and load it
within the IVissim interface with the
LoadLayout() method.

User error messages Description

An unspecified error has General message if no more concrete
occurred. information is available. Please contact to the
VISSIM hotline.
A wrong data type has No valid data type has been passed to a
been passed as a method. Please, refer to the use description of
parameter. the interface method in this document.
No valid directory. The passed path string don’t match a valid
directory on the hard drive.

254 VISSIM 5.10-06 © PTV AG 2009

 Error Messages

User error messages Description

No valid file name The passed name string doesn’t represent
any existing file.
Method call only possible Because of internal VISSIM simulation
during a simulation run. initializations some methods have a sense
only in the context of a running simulation. It is
possible to use them, using the method
RunSingleStep() of the ISimulation interface.
This error message occurs when calling them
outside a simulation running.
The object with the When identifier numbers are needed as a
specified identifier number parameter for the execution of a method, this
doesn't exist. error occurs if one of this identifiers doesn’t
represent a valid element. For example
passing a no valid node number to the
method AddPathAsNodeSequence()of the
IPaths interface.
Identifier number overflow. Because of the Automation conformance, the
maximum identifier number using the COM
interfaces is 2,147,483,647. Otherwise
VISSIM allows to use identifier numbers up to
4,294,967,295. An overflow error occurs when
using methods interchanging identifier
numbers greater than 2,147,483,647.
Too large value. To large value has been passed. Please, refer
to the concrete interface method use
description of this document.
Too low value. To low value has been passed. Please, refer
to the concrete interface method use
description of this document.
An object with the same The passed identifier number has been used
identifier number already before. Use a different identifier.
exists.
The specified attribute The passed string name doesn’t match any
<attribute name> is valid attribute.
unknown.
The specified attribute The passed attribute is not valid for the
<attribute name> is not method. Please, refer to the listed attributes
allowed. on the interface method use description of this
document.
The specified attribute The passed attribute is not valid to get data.
<attribute name> is not Please, refer to the listed attributes on the
readable. interface method use description of this

COM Interface Manual © PTV AG 2009 255

6 Annexes

User error messages Description

document.
The specified attribute The passed attribute is not valid to set data.
<attribute name> is not Please, refer to the listed attributes on the
writable. interface method use description of this
document.
The specified attribute An additional parameter is needed for the
<attribute name> requires passed attribute. Please, refer to the listed
one parameter. attributes on the interface method use
description of this document.
The specified attribute Two additional parameter is needed for the
<attribute name> requires passed attribute. Please, refer to the listed
two parameters. attributes on the interface method use
description of this document.
First passed parameter is The first passed parameter can’t be used. For
not valid. example no valid lane number using the
attribute LANECLOSED” of the ILink interface.
Second passed parameter The second passed parameter can’t be used.
is not valid. For example no valid vehicle class number
using the attribute LANECLOSED” of the ILink
interface.
The passed value is not The passed value can’t be used for setting the
valid. requested data. For example no valid desired
speed fractil using the attribute
DESSPEEDFRACTIL” of the IVehicle
interface.
The specified parameter is The passed string name doesn’t match any
unknown. valid named parameter.
The specified parameter is The passed named parameter is not valid for
not allowed. the method. Please, refer to the listed
possible parameters on the interface method
use description of this document (normally for
evaluations results).
The specified function is The passed string name doesn’t match any
unknown. valid named function.
The specified function is The passed named function is not valid for the
not allowed. method. Please, refer to the listed possible
functions on the interface method use
description of this document (normally for
evaluations results).
The specified configuration Some methods for evaluations results need a
is not defined within previously configuration for data collection.

256 VISSIM 5.10-06 © PTV AG 2009

 Error Messages

User error messages Description

VISSIM. This error occurs when requesting results that
have not been previously configured. For
example, using the GetSegmentResult()
method of the ILink interface to request
density results can end up with this error if the
density has not been requested within the
configuration.
The specified vehicle class Methods that require a vehicle class number
doesn't exist. can produce this error if a wrong identifier has
been passed. Please, be sure that the vehicle
class number exist in the used project.
A path requires at less 3 Error message when passing an array with
nodes. less than 3 node identifiers to the method
AddPathAsNodeSequence() of the IPaths
interface.
No valid node sequence. It is not possible to build a path from the
passed node sequence using the method
AddPathAsNodeSequence() of the IPaths
interface. Please, be sure that all passed
nodes exist and are connected with links and
connectors in the same order as the passed
sequence.
No origin parking lot A path must start on a parking lot. The
between the first two existence of a parking lot in-between the first
nodes. two nodes must be guaranteed.
No destination parking lot A path must end up on a parking lot. The
between the last two existence of a parking lot in-between the last
nodes. two nodes must be guaranteed.

COM Interface Manual © PTV AG 2009 257

6 Annexes

6.2 Warning Messages

Warning messages are written in the VISSIM trace file (with the same name
as the input file and the extension *.ERR).
Warning messages Description
The <network element> When using the MultiAttValues() methods of
with the specified identifier object collections, identifier numbers must be
number <number> doesn't passed as parameter. This warning is written
exist. in to the trace file for each not existing
element.
The path <p>, starting from A path p was has been tried to be assigned to
parking lot <plo>, can't be a vehicle parked on a different parking lot pl
assigned to vehicle <v> than the origin plo of the path.
parked in parking lot <pl>.

258 VISSIM 5.10-06 © PTV AG 2009

 Tips and Hints

6.3 Tips and Hints

Using Excel as client comes the warning “Microsoft Excel is waiting for
another application to complete an OLE action”
A call to the VISSIM COM interface, like RunContinuous in IVissim, is taking
more time than the expected. Excel indicates that it is waiting for VISSIM to
finish. In order to disable this warning you can set the Excel property
DisplayAlerts of the Application object to false.
The VISSIM COM server interface and the VISSIM versions
Because of the currently evolving state of the VISSIM COM server, the
interface is subjected to constant enhancements. A direct consequence of
interface changes is the no longer consistent type library information of
earlier working clients. For this reason it is recommended either to code
client with late binding when possible or to recompile the clients (or reset the
reference to the VISSIM type library if it is the case of the programming
environment) when a new VISSIM version has been installed. On a more
complete state of the VISSIM COM server the need of this client
actualization will not be longer necessary.

COM Interface Manual © PTV AG 2009 259

6 Annexes

6.4 Registry
The Windows Registry plays a central role during the creation and use of
COM objects. The VISSIM COM Server must be appropriately registered
before a client can use some of its interfaces (see chapter 1.1 License and
Registration on page 11 on how to do this registration).
Different types of information are registered in the system for the use of the
VISSIM COM Server. The following detailed list of entries can be used to
check the correctness of the registration, when necessary (For notational
convenience HKEY_CLASSES_ROOT will be abbreviated to HKCR):
ProgID
[HKEY_CLASSES_ROOT\VISSIM.Vissim]
@="Vissim Class"
[HKEY_CLASSES_ROOT\VISSIM.Vissim\CLSID]
@="{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}"
[HKEY_CLASSES_ROOT\VISSIM.Vissim\CurVer]
@="VISSIM.Vissim.500"
[HKEY_CLASSES_ROOT\VISSIM.Vissim.500]
@="Vissim Class"
[HKEY_CLASSES_ROOT\VISSIM.Vissim.500\CLSID]
@="{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}"
AppID
[HKEY_CLASSES_ROOT\AppID\{79C4AA74-E6DB-4727-B5A9-2E6D16917263}]
@="VISSIM_COMServer"
[HKEY_CLASSES_ROOT\AppID\VISSIM_COMServer.EXE]
"AppID"="{79C4AA74-E6DB-4727-B5A9-2E6D16917263}"
Type library ID
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}]
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}\1.0]
@="VISSIM_COMServer 1.0 Type Library"
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}\1.0\0]
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}\1.0\0\win32]
@="C:\Programme\PTV_Vision\VISSIM\Exe\VISSIM.exe"
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}\1.0\FLAGS]
@="0"
[HKEY_CLASSES_ROOT\TypeLib\{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}\1.0\HELPDIR]
@="C:\Programme\PTV_Vision\VISSIM\Exe\VISSIM.exe"
VISSIM class object ID
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}]
@="Vissim Class"
"AppID"="{79C4AA74-E6DB-4727-B5A9-2E6D16917263}"
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}\LocalServer32]
@="C:\Programme\PTV_Vision\VISSIM\Exe\VISSIM.exe"
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}\ProgID]
@="VISSIM.Vissim.500"
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}\Programmable]
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}\TypeLib]
@="{0B9A4ADC-F3E4-4513-A129-9F0983C149E9}"
[HKCR\CLSID\{2FFFE6E8-47C1-4ad4-97ED-C8E284C9B806}\VersionIndependentProgID]
@="VISSIM.Vissim"

260 VISSIM 5.10-06 © PTV AG 2009