Changes between Version 1 and Version 2 of GraphicTrafficEventsCreator_userguide


Ignore:
Timestamp:
02/02/2020 08:39:47 AM (6 years ago)
Author:
jdalbey
Comment:

draft

Legend:

Unmodified
Added
Removed
Modified

  • GraphicTrafficEventsCreator_userguide

    v1 v2  
    44The 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. 
    55 
    6 The current CPTMS display will be enhanced to include two additional controls: 
     6[[Image(wiki:GraphicTrafficEventsCreator_userguide:gtec_startup.png)]] 
    77 
    8  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). 
    9  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. 
    10  1. The current CPTMS buttons for VDS, CMS, etc should be removed. 
     8The initial display shows two controls: 
     9 
     10 1. A time selector - Displays the simulation time for which the traffic events are to be created.  It starts at zero and automatically increments by 30 second intervals.  The user may input a time by specifying an hour (1-12), a minute(0-59), and seconds (0-59).   Once a time has been specified, it will automatically increment by 30 seconds. 
     11 1. A color selector - three color buttons: green, yellow, and red. 
    1112 
    1213Use Case 
    1314 
    1415{{{ 
    15 System: Displays the CPTMS highway network with all dots green. 
    16 System: Clears the traffic events file. 
    17 User: Selects 0:01:00 in the time selector. 
    18 User: Selects Yellow in the color selector. 
     16System: Displays the CPTMS highway network with Yellow button selected and time zero. 
    1917User: Clicks on VDS "55 N 6.35 @ MAIN" 
    2018System: The selected dot changes to White. Dots further along 55 N also become white. 
    … …  
    2422System: Calculates the distance between the two dots (in this case, 0.59 miles)  
    2523and append one line to the traffic events file: 
    26 1   00:01:00  55     N         6.35     0.59    Y 
     24101   00:00:00  55     N         6.35     0.590    Y 
    2725System: Automatically advance the time selector by 30 seconds to 0:01:30.   
    28 (The user may manually alter this time if the desire.) 
    29 User: Selects Yellow in the color selector. 
    3026User: Clicks on VDS "55 N 7.16 @ MCARTHU2" 
    3127System: Changes the above dot to White.  Changes dots further along 55 N to white. 
    … …  
    3430other dots on highway to their current color. 
    3531System: Append one line to the traffic events file: 
    36 1   00:01:30  55     N         7.16     0.96    Y 
    37  
     32101   00:00:30  55     N         7.16     0.960    Y 
     33User: Enters "00:05:00" in the time box. 
     34User: Clicks the Red button. 
     35User: Clicks on VDS "405 N 7.07 @ JAMBOREE2" 
     36System: Changes the above dot to White.  Changes dots further along 405 N to white. 
     37User: Clicks on VDS "405 N 9.46 @ BRISTOL 1" 
     38System: Append one line to the traffic events file: 
     39101   00:05:00  405     N       7.07    2.390   R    
    3840}}} 
    3941User continues to select highway segments to be assigned a specified color at a specified time.  These are all changes for a SINGLE incident. 
    4042 
    41 When complete, the user manually edits the data file to change the "1" in the first column to the desired incident number, eg., 181. 
     43When complete, the user manually edits the data file to change the "101" in the first column to the desired incident number, eg., 181. 
    4244 
    4345User 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. 
    4446 
    45 Note the system does very little error checking.  It doesn't not verify that a manually entered time is subsequent to the current time and if a prior time is entered the sequence of events in the output file will be out of order.  There is no validation for time format.  If an invalid time is entered the output will shows "Invalid Date" instead of a time.  
     47Note the system does very little error checking.  It doesn't not verify that a manually entered time is subsequent to the current time and if a prior time is entered the sequence of events in the output file will be out of order.  There is no validation for time format.  If an invalid time is entered the output will shows "Invalid Date" instead of a time. 
    4648 
    47 The system should have some UI features that prevent error. 
    48  
    49  1. Don't allow a click on a dot until a color has been selected. 
    50  1. Once the first dot is selected, the color buttons are disabled until the second dot is chosen. 
    51  1. Once the first dot is selected, only a white dot may be chosen for the second dot. 
     49The system does have one feature that prevent errors:  Once the first dot is selected, only a white dot may be chosen for the second dot.