...
The Integration Simulator is a standalone software that allows the end user or integrator to test and develop connections to integration plugins. Please contact your sales manager if you wish to obtain a copy of the Integration Simulation software.
...
| Info |
|---|
For customers and integrators intending to use the Integration Simulator, the documents assume a reasonable working knowledge of network communication. They are targeted at technical teams, typically with software development skills, who are integrating the output from Witness into external systems. |
| Note |
|---|
If the software won't start then you will need to delete the Highways Integration Simulator folder. It may be located here: C:\ProgramData\Navtech\Highways Integration Simulator. Please note that C:\ProgramData could be in a different place depending on where your window's application data folder is located. The Integration Simulator should then start and create a new default config. |
Contents
...
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
Plugin Tree: Lists all the integration and simulation plugins. The Start and Stop buttons will start and stop any enabled integration plugins.
Plugin Configuration Panel: This panels displays the configuration for the currently selected plugin, either integration or simulator.
Log Panel: Shows all the log output from the application and plugins.
The Integration simulator Simulator will load up two distinctly different types of plugins - integration plugins and simulation plugins.
...
Simulation plugins are specifically for the integration simulatorIntegration Simulator. They simulate the rest of the Navtech system and provide output to the integration plugins, such as alarms or carriageway statistics. Selecting a plugin, whether integration plugin or simulation plugin, will display the plugin's configuration on the Plugin Configuration Panel.
...
To configure an integration plugin, we you can select an integration plugin from the tree and click edit Edit. This will give us display the same configuration editor as we you would get see in the Witness 4 Clientclient.
Saving the configuration will have the same effect as on an actual Witness system - plugins that are enabled will try to automatically start themselves.
Like Witness, on first launching the Integration Simulator, enabled plugins will automatically start. However they can be controlled using the Start and Stop buttons if required.
| Info |
|---|
A plugin that is not enabled cannot be started. |
...
Please see the details for each integration plugin:
...
The simulation plugins are specific to the product, so ClearWay ClearWay™ and AdvanceGuard AdvanceGuard® have their own. These plugins simulate the Witness functionality associated with these products, such as raising alarms or generating tracks.
System Simulator
The System Simulator handles common system level settings, including System Profiles and Areas.
Profiles
...
System Profiles: This simulates the Witness System system profile. It shows the currently selected profile and allows you to change the profile. The profile can be changed by selecting the required profile and selecting the Set System Profile button. This can trigger outgoing profile status reports (e.g. Navtech ICD-001 Protocol) and also respond to incoming profile change requests.
...
Areas: This simulates a fixed list of areas. Each area has a different type and displays the statethe system will show its mode and if it is enabled. The state can be changed by highlighting an area and selecting the Set State button. In addition, if an area state is changed through an integration plugin then the modified state will be displayed here.
...
The health simulator enables you to generate health status reports and alarms with details of the radar and modules. You can adjust the status of the radar and the modules using the plugin configuration. For example, for example you can change a radar’s health or connection health to unhealthy, and then you can generate a status report or an alarm to report this change.
...
Modules: This is a list of pre-configured modules and active integration plugins showing their connection health status. The Management Server also has an additional status that simulates the database health. All available health states can be changed for testing purposes.
...
| Info |
|---|
To clear a health alarm, set the health status on the radar or the module back to Healthy and resend the alarms using Send Alarms. |
...
Add Alarms: Select this button to create a new alarm. Once clicked the alarm form will become be enabled so you can populate the alarm details.
...
Highways Simulator
The included Highways Simulator simulation plugin can be used to set up Carriageway carriageways and Radar entities radars and can also be used to create carriageway statistics and highway alarm messages.
Configuration
...
If the software won't start then you will need to delete the Highways Integration Simulator folder and then the Integration Simulator should create a new default config.
...
| Info |
|---|
By default, the Highways Simulator creates 2 carriageways with 10 sections each and 5 radars. |
...
Configure Radars
...
To change the number of radars:
Select Configure Radars to open the Configure Radars dialogue. Here you can choose the number of radars you need:
Click OK.
This will delete all existing radars and create
...
new ones until the desired number is reached. Any integration plugin tied directly to radar or radar entity updates will be affected by this.
...
Configure Carriageways
...
To change the number of carriageways and
...
or the number of sections per carriageway:
Select Configure Carriageways to to open the Configure Carriageways dialogue. Here you can change the number of carriageways and sections per carriageway:
Click OK.
This will recreate the carriageways
...
as required. All carriageways will be created 4 lanes and with the
...
default rules
...
; Debris,
...
Person,
...
Queue,
...
Reversing Vehicle,
...
Carriageway Configurations
...
Slow Vehicle and Stopped Vehicle.
| Info |
|---|
By default, carriageways are generated with default settings.This includes settings that include an 11 m/s queue threshold, 16 m/s heavy traffic density and a track density queue as of 4. In For some integration plugins that are able to output section queue and heavy traffic flags, these criteria will need to be met. |
...
| Note |
|---|
When restarting the system, |
...
the |
...
last saved configuration will be loaded. |
Save Configuration
Select Save Configuration to save the current configuration to file
...
| Tip |
|---|
You can pass configuration from one computer to another using save and load. |
Sending Statistics
...
:
You will receive a log message indicating a successful save and where the configuration file has been saved to. It should look something like "C:\ProgramData\Navtech\Highways Integration Simulator\HighwaysSimulatorConfig.xml". C:\ProgramData will be different depending on where your window's application data folder is located.
...
To load the configuration file from your application data folder, click Load Configuration. If the relevant file is not found, a new configuration will be generated based on defaults.
You can pass configuration from one computer to another using save and load.
Section and Rules
You can now administer the Sections and the Rules for your carriageways to send alarms against carriageway rules by selecting the sections and rules we want to raise the alarm against. Optionally, we can select a lane for the alarms as well. To do this:
Ensure the Sections and Rules tab is open:
Here there will be a list of the sections you have configured with the rules.
You can select sections and the rules that you wish to apply by selecting their check boxes:
In the example above, Section 1 of Lane 1 has been chosen with a variety of rules. The Auto Acknowledge check box has been selected by default.
Add Alarms
You can now add your selection to the alarm list.
Click the Add Alarms button:
This will add each of the rules for the section to the Alarms List as highted above.
Selecting the check box on the Alarms List toolbar will select or deselect all of the checkboxes below it:
Alternatively, you can select individual rows in the list.
Send Alarms
| Info |
|---|
The alarms are only sent to the enabled integration plugins. |
To send an alarm:
Click the Send Alarms button:
In this example, the ICD-100 XML Plugin has been enabled and the Log Panel shows that the 6 alarms have been sent (highlighted in pink).
The alarm simulator contains the same limitations as the actual Witness 4 system in that only one alarm can be raised for each rule and section combination and does not generate separate alarms for different lanes.
Clear Alarms
To clear the alarms:
Click the Clear Alarms button; you can select all alarms by selecting the checkbox in the column header or select individual alarms:
As the Auto Acknowledge check box has been selected then clearing the alarms will also acknowledge them as in the example above.
If the Auto Acknowledge check box has not been selected:
Clicking on the Clear Alarms button will clear the alarms but not auto acknowledge them:
Acknowledge Alarms
To manually acknowledge the alarms:
Select the alarms you wish to acknowledge which will enable the Acknowledge Alarms button:
This will then clear the alarms from the list:
Delete Alarms
You can delete a single or multiple alarms:
Select the alarm or alarms from the list and click the Delete Alarms button:
The selected alarms will be removed:
Send Statistics
You can use the commands available in the Carriageway Statistics section to send statistics or traffic analysis Traffic Analysis reports.
...
Click Send Statistics
...
: this will will send
...
randomly generated statistics for each section of the selected carriageway. You can change the selected carriageway from the Carriageway dropdown:
These statistics will be displayed within the Log Panel, as above.
...
Clear Traffic
...
To send stats for every section of the selected carriageway with
...
no traffic:
Click the Clear Traffic button. This will also raise the flag that the entire carriageway is clear of traffic.
Send Section TA
If any section
...
has been selected in the Section and Rules tab you can
...
send out Traffic Analysis messages
...
:
Click the Send Section TA
...
button:
This will send out a randomized traffic analysis message with reports for the selected sections
...
. In the above example it has sent out messages for section 1.
Send Clear TA
To see a message showing that there is no traffic within a section:
Click Send Clear TA
...
to send a traffic analysis message
...
for all
...
| Tip |
|---|
Need to verify if you have received the data correctly? Check what statistics were sent out from the log output. |
Sending Alarms
To send alarms against carriageway rules, we first select the sections and rules we want to raise the alarm against. Optionally, we can select a lane for the alarms as well. We can then Add Alarms to include the selected alarms in the local alarm list. Note that the alarm simulator contains the same limitations as the actual Witness 4 system in that only one alarm can be raised for each rule and section combination and does not generate separate alarms for different lanes.
To remove an alarm, tick the checkbox for the alarm under "Clear" and click "Clear Alarms". You can select all alarms by selecting the checkbox in the column header.
...
of the selected sections in the Section and Rules tab:
...
Related Information
| Filter by label (Content by label) | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...