VISSIM 5.30-05 User Manual

3.5 The COM Interface (Optional Module)
The COM Interface (Optional Module)
VISSIM offers an additional module which provides COM (component object
model) functionality for use with external programming environments (e.g.
VBA in Microsoft Excel). This way it is possible to automate certain tasks
in VISSIM by executing COM commands from an external program.
A list of all available functions and commands in the COM interface is
included in the documentation VISSIM_COM.PDF which is contained in the
folder \DOC.
Please note that neither the external COM interface nor the SCRIPTS menu is
provided with VISSIM demo or viewer versions, cf. section 2.4.
3.5.1 Loading and Running Scripts in VISSIM
Example
*.VBS
External scripts can be read from file interactively via
menu SCRIPTS - RUN SCRIPT FILE.
The execution of the script will start automatically then.
Open script file
► Click menu SCRIPTS – RUN SCRIPT FILE.
► The window Open Script File appears.
► Select a file and click OPEN.
In VISSIM, script files have the extensions *.VBS, *.JS, *.PYS or *.PY.
Notes to users starting a script file interactively
The global variable Vissim can be used throughout the script without prior
initialization. It always refers to the VISSIM instance from which the script is
run.
This object Vissim on top of the script file has not been created with
CreateObject, because VISSIM is already running (it is possible however, to
do so if further Vissim instances are needed in the script). Scripts can use
the entire command set of the Visual Basic Scripting Edition (VBS), e.g.
loops, if-then-else, I/O functions and error handling. Scripts may not contain
any global declarations.
This script serves for dividing all input flow volumes by two:
Set all_flows = VISSIM.Net.VehicleInputs
For i = 1 To all_flows.Count
all_flows(i).AttValue("VOLUME") = 0.5 * all_flows(i).AttValue("VOLUME")
Next
User Manual © PTV AG 2011 57