VHelper

How To Guide

Video Tutorials

VAPPad

Click here for Introduction and VAP language tutorial

1.0 How do I run VHelper after downloading?

No installation required
Unpack the downloaded zip file to a local folder, then double click vhelper.exe to run
You can keep multiple versions, as long as they are in separate folder

VHelper can not start

VHelper® is compiled to .NET 3.5 framework. By default, Windows 7 comes with .NET 3.5 preloaded. VHelper won't start if your machine don't have Microsoft .NET 3.5 Run time installed. Please Click this link to download and install Microsoft .NET Framework 3.5 if you don't have it. If you still have problem, please contact me at support@trananswers.com

How do I register?

Click Help button or Press F1 shortcut key
Click button to show Register Window
Email your Serial Number to support@trananswers.com, fill in the activation Key Code (will be provided after the payment received)
Click button to Register

How to Open Options Dialog?

Click Options button
or Press F4 shortcut key

How to Open VISSIM File?

Click Open button
or Press Ctrl + O shortcut key
or Drag and Drop VISSIM .inp or .inpx files into the Map Window

How to Save VISSIM File?

Click Save button
or Press Ctrl + S shortcut key
or if you want to save to another file, Click Save As button

How to Zoom in/Zoom out and Pan the Map?

Scroll Mouse Wheel whiling holding down Ctrl Key to Zoom in/out
Scroll Mouse Wheel or Left Drag (Drag whiling holding down Left Mouse Button) to Pan the map
or if scroll bar appears, click them to Pan the map

How to Show the Full Extends of the Map?

Click Zoom All Button
or Press Ctrl + W shortcut key

How to Toggle Link Display Type among Center Line, Normal Mode and All Center Lines?

Press Ctrl + A shortcut key

or Open Options Dialog (hit F4 shortcut key or Click Options Button ), Change it under Link/Connector Tab -> Link Display -> Link Mode

How to Show/Hide Lane Markings?

Open Options Dialog, Check on/off Show Lane Markings checkbox under Link Display

How to Toggle Link Display Color among Link Type Color, Gray, Speed Based?

Press Ctrl + T shortcut key
or Open Options Dialog, Change it under Link Display -> Show Link Color dropdown box
NOTE: in order to show correct speed based color, the user need Calculate Speed first

How to Turn on/off the Arrow?

Open Options Dialog, Check on/off Draw Arrows to Show Direction checkbox under Link Display

How to Show/Hide Label for Link or Connector?

Press Ctrl + L shortcut key
or Open Options Dialog, Check on/off Show Labels checkbox

How to Toggle showing Label among volume, speed and IDs?

Open Options Dialog, Change it under Label Mode dropdown box

How to Change Background, Link or Label Color?

Open Options Dialog, go to Color Tab, Change it from there

How to Calculate Demand Volume Based on Vehicle Inputs & Static Routing?

Click Calc Volume button

Or Press Ctrl + U shortcut key

How to Calculate Link Desired Speed & Display in User Specified Color?

Click Calc Speed button

or Press Ctrl + Y shortcut key
Under Options -> Color Tab, Change the colors for speed range

How to Show Volume Bandwidth Map?

Calculate demand volume

Under Volume/Speed Tab, Check on/off Show Volume Bandwidth checkbox

How to Show Speed Contour Heatmap?

Click MOE Button to open MOE Dialog
Under Data Collection Result tab, Browse the .att file saved from VISSIM to bring in Data Collection Measurement results
Input the freeway path (space separated Link/Connector IDs)
Click Button
You can adjust font size, turn on/off border etc. in the options

How to Show Freeway Diagram & Demand Stick Diagram ?

Under Utility Tab, input the freeway path (Link/Connector IDs)
Click Build Freeway Diagram button
You need calculate demand volume first, if you to show demand stick diagram

How to Show Intersection Diagram with Volume or Delays ?

Click MOE Button to open MOE Dialog
Under Node Evaluation Result tab, browse .att file saved from VISSIM to bring in the Node Evaluation results
Input Node Matrix, tab delimited text to denote intersection relationship, best copy from Excel
Click Button
You can choose to display volume or delay, adjust font size etc in the options

If you check off Use Nodes from this Matrix, VHelper will display all Nodes by ID in a tabular format

How to Show Volume of Specific Vehicle Type?

Select Volume/Speed Tab, change it under Volume/Speed of Vehicle Type dropdown box

How to Export Calculated Link Demand Volume?

Select Volume/Speed Tab, Click Export Link Demand Volume Button

How to Import Back User Defined Link Volume?

Select Volume/Speed Tab, Click Import User-Defined Link Volume Button

How to Draw & Visualize Queue based on Queue Counte MOE Result Files?

Click MOE Button to open MOE Dialog
Select Queueing Files (*.stz) tab, Click Add File button to add MOE results Files
Click Calculate Queue button
Check on/off Show Queue in Map check box

How to Create Static Routings from OD Demand Matrix?

Download a sample Excel loading sheet

Download a sample OD Matrix text file

Open Excel, Create a n X n Matrix
Cell (1,1) -> Row 1, Column 1 is the vehicle class, default is ALL; if left blank, it will treated as ALL, not required, must be single value if fill in any value
Cell (1,2) -> Row 1, Column 2 is the favored link types (behavior types) for input vehicle class, could be multiple, separated by dash like 4-5-6, not required, default is blank
Cell (2,1) -> Row 2, Column 1 is the start and end seconds, separated by dash like 0-5400, not required, default is blank, treated as single time period 0 - 99999
Cell (2,2) -> Row 2, Column 2 is the dis-favored or penalized link types (behavior types) for input vehicle class, could be multiple, separated by dash like 1-2-3, not required, default is blank
The rest of Row 1 and Column 1 Cells are VISSIM Link IDs, First Row is Destination Zone Links, First Column is Origin Zone Links
The rest of Row 2 and Column 2 Cells are Zone IDs, used as Route Names when create static routings
The content of Matrix is the volume fractions for each OD Pairs
In order to let General Purpose (GP) vehicles stay on GP links (vice versa, HOV vehicles use HOV links preferably), the parameters of Path Building are used to increase(decrease) each link’s actual distance.
For example, when building GP path using favored link types 1-2-3 and dis-favored link types 4-5-6, GP link types 1, 2, 3 will be more attractive (70% & 85% of original length depending on setting) and non GP link types 4, 5, 6 will be more unattractive (300% & 310% of original length depending on setting), thus GP vehicles will prefer GP link types 1,2,3 and and avoid other link types 4, 5, 6.
If you penalize HOV link types 4, 5, 6 by increase penalty of dis-favored link types to 2000% (20 times of original length), GP vehicles will probably never use HOV links unless there is no other path available to reach destination.
Usually default parameters are good enough, but for a big size network, you might not be able to easily pick parameters to satisfy all your requirement. You can always do Route Replacement for undesirable path after loading. It's important to check and QA/QC routes generated.
It's worth noting here that penalized link types do not mean they will not be used at all, if there is only path available to reach destination they will be used.
If you want to completely turn off certain links, you can import Link Closures.
Copy all content to a text file in Notepad, preferably direct Copy Paste, you can use Excel Export/Save As too
Click Advanced Routing button to open advanced routing dialog, select Auto Generate Tab, Click "Create Static Routing from OD Matrix" Button to open the file you just created

How to Create Static Routings from VISUM Path?

In VISUM, export PrT path, make sure add extra column Nodes-Concatenate-Number or Links-Concatenate-Number
Click Advanced Routing button to open advanced routing dialog, select Auto Generate Tab, Click "Create Static Routing from VISUM Path (Nodes or Links)" Button correspondingly to open the file you just created

How to Create Vehicle Inputs by importing Tab Delimited Text File(s)?

Download a sample Vehicle Inputs text file

Open Excel, Create as shown
Copy all content to a text file in Notepad, preferably direct Copy Paste, don't use Excel Export function
Click Advanced Routing button to open advanced routing dialog, select Auto Generate Tab, Click Create Vehicle Inputs Button

How to Create Vehicle Compositions by importing Tab Delimited Text File(s)?

Download a sample Traffic Compositions text file

Open Excel, Create as shown
Copy all content to a text file in Notepad, preferably direct Copy Paste, don't use Excel Export function
Click Advanced Routing button to open advanced routing dialog, select Auto Generate Tab, Click Create Vehicle Compositions Button

How to Combine Static Routings?

Routing Tab, Click Button to open the Advanced Routing Dialog
Select "Combine Static Routings" Tab, Input Routing IDs you want to be combined (removed)
For example, input routing decision 3, #3 and Routes 1-1 , 2-1 will be removed, and 1-1 and 2-1 will be extended(replaced) by routing #3's routes proportionally.

How to Filter Routes?

Under Routing Tab, you can filter by Routing ID(s), Vehicle Class(es), by a Path (Link/Connector IDs seperated by space) or any combo. Then Click Filter Routes button.

If you check Filter in Real Time, Routes will be filtered instantly when you change IDs or Paths, this could be slow when the network is large

How to Find & Replace Routes?

Select Routing Tab, check on Filter by Path check box, type in To Find and Replace with Pathes(a string of Link/Connectors seperated by space)

or if you have a series of routes to be replaced, click Advanced Routing button to open advanced routing dialog, select first tab Find & Replace, click Add button to add one entry, click Import to import a comma (,) delimited text file contains To Find, To Replace, Vehicle Class information. Click Replace to process the job.

How to Create Data Collection Points along a Path?

Click MOE Button to open MOE Dialog
Select Data Collection Point tab, Type in a path (a string of Link/Connectors)
Click Create New DCP Button

How to Quickly Manipulate Lane Cloesures along a User Defined Path (a string of Link Connector IDs)?

Select Link & Connector Tab, Click corresponding Lane Cloesures buttons.

If you want to manipulate a path, first check on Filter by ID, then type in a string of IDs

Under the view, Lane Cloesures will be represented as 1:3-4;3:1-2, it means Lane 1 closed for vehicle class 3 and 4, Lane 3 closed for vehicle class 1 and 2

How to Check Coding Error?

Select Warning/Error Tab, Click Check Error button
Press Ctrl + K shortcut key