== Graphic Traffic Events Creator - Preliminary Specification ==
The purpose of this tools is to provide a Graphical User Interface to allow the author of an Incident Script to build a file of traffic events to be used by CPTMS to show colored dots on the highway display that represent traffic congestion.

The concept is a CPTMS like display that is enhanced to allow user interaction.  The author will click on dots on the highway network to specify VDS stations whose values are to be modified.

The current CPTMS display will be enhanced to include two additional controls:

 1. A time selector - this is used to select the simulation time for which the traffic events are to be created.  The user specifies an hour (1-12), a minute(0-59), and seconds (0 or 30).  A user interface such as the Time Selector widget used in the Simulation Manager would be best (see attached screenshot).
 1. A color selector - a drop down box with three color choices: green, yellow, and red, OR three separately colored buttons on the left hand side toolbar.
 1. The current CPTMS buttons for VDS, CMS, etc should be removed.

Use Case

{{{
System: Displays the CPTMS highway network with all dots green.
System: Clears the traffic events file.
User: Selects 0:01:00 in the time selector.
User: Selects Yellow in the color selector.
User: Clicks on VDS "55 N 6.35 @ MAIN"
System: The selected dot changes to White. Dots further along 55 N also become white.
User: Clicks on VDS "55 N 6.94 @ MCARTHUR"
System: Changes all the dots between these two points to Yellow.   Restores all 
other dots on highway to their current color.
System: Calculates the distance between the two dots (in this case, 0.59 miles) 
and append one line to the traffic events file:
1   00:01:00  55     N         6.35     0.59    Y
System: Automatically advance the time selector by 30 seconds to 0:01:30.  
(The user may manually alter this time if the desire.)
User: Selects Yellow in the color selector.
User: Clicks on VDS "55 N 7.16 @ MCARTHU2"
System: Changes the above dot to White.  Changes dots further along 55 N to white.
User: Clicks on VDS "55 N 8.12 @ DYER2"
System: Changes all the dots between these two points to Yellow.   Restores all 
other dots on highway to their current color.
System: Append one line to the traffic events file:
1   00:01:30  55     N         7.16     0.96    Y

}}}
User continues to select highway segments to be assigned a specified color at a specified time.  These are all changes for a SINGLE incident.

When complete, the user manually edits the data file to change the "1" in the first column to the desired incident number, eg., 181.

User then repeats the process for the next incident.  When all incidents have been created, user manually concatenates the files for all incidents, then sorts them by timestamp.  The resulting file is ready to be used by CPTMS.

The system should have some UI features that prevent error.

 1. If a time is manually selected, it may not be prior to the current time. (I.e., you can't go backwards in time.)
 1. Don't allow a click on a dot until a color has been selected.
 1. Once the first dot is selected, the color buttons are disabled until the second dot is chosen.
 1. Once the first dot is selected, only a white dot may be chosen for the second dot.