Changes between Version 8 and Version 9 of ScriptBuilderSRS


Ignore:
Timestamp:
07/28/2017 04:40:15 PM (9 years ago)
Author:
jdalbey
Comment:

draft

Legend:

Unmodified
Added
Removed
Modified

  • ScriptBuilderSRS

    v8 v9  
    142142 
    143143 
    144 == 2.3 Support for TMC Simulation Control == 
     144=== 2.3 Support for TMC Simulation Control === 
    145145 
    146146Simulation Control Events - General 
    147147 
    148 The Script Builder shall allow for insertion ofcontrol events which drive TMC simulator systems, including theParamics traffic simulator, the CHP CAD simulator, the TMC SimulatorAudio System, the Activity Log, and the TMC Simulator CCTV videoplayback system. When the user adds a control event, a dialog boxshall be presented to the user allowing entry of details regardingthe added event. The details regarding the added event are specifiedby the XML element corresponding to the added event. These XMLelements are found in the TMC Simulator XML Script Schema.  
     148The Script Builder shall allow for insertion of control events which drive TMC simulator systems, including the Paramics traffic simulator, the CHP CAD simulator, the TMC Simulator Audio System, the Activity Log, and the TMC Simulator CCTV video playback system. When the user adds a control event, a dialog box shall be presented to the user allowing entry of details regarding the added event. The details regarding the added event are specified by the XML element corresponding to the added event. These XML elements are found in the TMC Simulator XML Script Schema.  
    149149 
    150150Paramics Control Event 
    151151 
    152 The Script shall allow for the entry of Paramicscontrol events. Paramics control events allow modification ofParamics simulation parameters to create incidents, remove incidents,etc.   
     152The Script shall allow for the entry of Paramics control events. Paramics control events allow modification of Paramics simulation parameters to create incidents, remove incidents,etc.   
    153153 
    154154ATMS Driver Control Events 
    155155 
    156 The Script Builder shall allow for control of theATMS back-end directly, bypassing Paramics.  Script Builder controlshall provide the ability to initialize the ATMS from a traffic flowperspective and then create trends, e.g. traffic dots changing fromto green to yellow to red as necessitated by the script.  By GPScooord?  By freeway section?  Ans: each dot is a series of sensorsper freeway lane, so the ATMS aggregates sensor input and allowszooming to increase resolution.   
     156The Script Builder shall allow for control of the ATMS back-end directly, bypassing Paramics.  Script Builder control shall provide the ability to initialize the ATMS from a traffic flow perspective and then create trends, e.g. traffic dots changing from to green to yellow to red as necessitated by the script.  By GPS cooord?  By freeway section?  Ans: each dot is a series of sensors per freeway lane, so the ATMS aggregates sensor input and allows zooming to increase resolution.   
    157157 
    158158CHPCAD Control Event 
    159159 
    160 The Script Builder shall allow for the entry ofCHP CAD control events.  CHP CAD Control Events allow automatedentries and hence automatic population of the data into the TMCSimulator CHP CAD database, as if it were typed by a CHP Dispatcher. 
     160The Script Builder shall allow for the entry of CHP CAD control events.  CHP CAD Control Events allow automated entries and hence automatic population of the data into the TMCSimulator CHP CAD database, as if it were typed by a CHP Dispatcher. 
    161161 
    162162Activity Log Control Event 
    163163 
    164 The Script Builder shall allow for the entry ofActivity Log control events.  Activity Log control events allowautomated entries and hence automatic population of the TMC SimulatorActivity Log, as if it were entered by TMC operators.    
     164The Script Builder shall allow for the entry of Activity Log control events.  Activity Log control events allow automated entries and hence automatic population of the TMC Simulator Activity Log, as if it were entered by TMC operators.    
    165165 
    166166CCTV Control Event 
    167167 
    168 The Script Builder shall allow for the entry ofCCTV control events.  CCTV control events allow direct control of TMCSimulator DVD players to play incident video, resume normaloperations, etc. 
     168The Script Builder shall allow for the entry of CCTV control events.  CCTV control events allow direct control of TMCSimulator DVD players to play incident video, resume normal operations, etc. 
    169169 
    170170CHP Radio, Caltrans Radio, TMT Radio ControlEvent  
    171171 
    172 The Script Builder shall allow for the entry ofradio control events.  Radio control events  can be CHP, Caltrans, orTMT Events. The Script Builder will be able to generate a printable“voice-actor script” sample? (No, but it's just the XML, whichincludes “special instructions” noted below).  to support therecording of the radio traffic based upon the radio Event. The“voice-actor script” will include the following: the specificwords to be read by the voice actor, including call numbers, etc.,the file name that the voice recording should be saved as, anyspecial instructions to the actor(s), and actor identifier to ensurethat all recordings for a given role in the field are made by thesame person. 
     172The Script Builder shall allow for the entry of radio control events.  Radio control events  can be CHP, Caltrans, orTMT Events. The Script Builder will be able to generate a printable“voice-actor script” sample? (No, but it's just the XML, which includes “special instructions” noted below).  to support the recording of the radio traffic based upon the radio Event. The“voice-actor script” will include the following: the specific words to be read by the voice actor, including call numbers, etc.,the file name that the voice recording should be saved as, any special instructions to the actor(s), and actor identifier to ensure that all recordings for a given role in the field are made by the same person. 
    173173 
    174174Tow Truck Control Event 
    175175 
    176 The Script Builder shall allow for the entry ofTow Truck Control Events.   Tow Truck control events allow tows to beadded to the CHP CAD log.  
     176The Script Builder shall allow for the entry ofTow Truck Control Events.   Tow Truck control events allow tows to be added to the CHP CAD log.  
    177177 
    178178Unit Control 
    … …  
    180180Event 
    181181 
    182 The Script Builder shall allow for the entry ofUnit Control Events.  Unit Control Events allow CHP units to bedispatched on the CHP CAD. 
     182The Script Builder shall allow for the entry of Unit Control Events.  Unit Control Events allow CHP units to be dispatched on the CHP CAD. 
    183183 
    184184Witness Control Event 
    185185 
    186 The Script Builder shall allow for the entry ofWitness Control Events.  Witness Control Events allow witness reportsto be added to the CHP CAD log. 
     186The Script Builder shall allow for the entry of Witness Control Events.  Witness Control Events allow witness reports to be added to the CHP CAD log. 
    187187 
    188188Telephone Call 
    … …  
    190190Control Event 
    191191 
    192 The Script Builder shall allow for the entry ofTelephone control events.  Telephone Call control events allow thegeneration of “voice scripts” to be included in the instructor’snotebook which allow the instructor to make relevant telephone calls,e.g. radio reporter, Caltrans headquarters, etc. into the TMC atappropriate times during a simulation.  SAMPLE? No. 
     192The Script Builder shall allow for the entry of Telephone control events.  Telephone Call control events allow the generation of “voice scripts” to be included in the instructor’s notebook which allow the instructor to make relevant telephone calls,e.g. radio reporter, Caltrans headquarters, etc. into the TMC at appropriate times during a simulation.  SAMPLE? No. 
    193193 
    194194Generic Run Script Event suggested by Neil so SimMgr can execute a predefined shell script at a given time. 
    195195 
    196 == 2.4 Supportfor Student Evaluation == 
     196=== 2.4 Support for Student Evaluation === 
    197197(ALL INSTRUCTOR NOTEBOOK) or grading sheets. None of this requires anything by Simulation mgr. 
    198198 
    … …  
    207207probably only 3 levels, then assigns score or grade. 
    208208 
    209 The Script Builder shall support the concept of a decision tree for script that it is used to build.  The content/structure of the decision tree will be developed inconjunction with the development of the script while using the ScriptBuilder, allowing the team designing the new script to articulatewhat preferred decisions to be made by the students in the simulatorare.   It is anticipated that information such as this decision treewill provide some of the basis for a future trainee scoring scheme. Note that this section required further fleshing out. 
     209The Script Builder shall support the concept of a decision tree for script that it is used to build.  The content/structure of the decision tree will be developed in conjunction with the development of the script while using the Script Builder, allowing the team designing the new script to articulate what preferred decisions to be made by the students in the simulator are.   It is anticipated that information such as this decision tree will provide some of the basis for a future trainee scoring scheme. Note that this section required further fleshing out. 
    210210 
    211211Support for Instructor Electronic Notebooks  Prototype? (Just the paperbinders) 
    212212 
    213 “Support” means the design should be able toaccommodate these events but probably won't be part of version 1. 
    214  
    215 The Script Builder output shall support the use ofelectronic script notebooks, allowing the existing instructornotebooks to be replaced with electronic versions running on a devicesuch as an iPad, tablet computer, etc.  All files required foroperation of the Instructors Electronic Notebook shall be generatedby the Script Builder.   Web interface to app syncs with script. 
     213“Support” means the design should be able to accommodate these events but probably won't be part of version 1. 
     214 
     215The Script Builder output shall support the use of electronic script notebooks, allowing the existing instructor notebooks to be replaced with electronic versions running on a devices uch as an iPad, tablet computer, etc.  All files required for operation of the Instructors Electronic Notebook shall be generated by the Script Builder.   Web interface to app syncs with script. 
    216216 
    217217Traffic Network Scoring 
    218218 
    219 The Script Builder shall support trainee scoringaggregated by highway, direction, time, and speed.  (not sure aboutthe speed here) The end result of such a scheme is that performancewill be scored based on the activity in the traffic network, henceindirectly scoring trainee actions as these actions will affect thetraffic network score.  
     219The Script Builder shall support trainee scoring aggregated by highway, direction, time, and speed.  (not sure about the speed here) The end result of such a scheme is that performance will be scored based on the activity in the traffic network, hence indirectly scoring trainee actions as these actions will affect the traffic network score.  
    220220 
    221221Assignment of Scoring Metrics to Specific Instructors 
    222222 
    223 The Script Builder shall support the generation ofa script notebook with evaluation events and other evaluation metricsassigned to specific instructors. Other evaluation metrics includesitems to score such as CMS signs, HAR messages, queue protection,etc. 
     223The Script Builder shall support the generation of a script notebook with evaluation events and other evaluation metrics assigned to specific instructors. Other evaluation metrics includes items to score such as CMS signs, HAR messages, queue protection,etc. 
    224224 
    225225Associate Score with Feedback 
    226226 
    227 The Script Builder shall support the ability toassociate a quantitative score assigned to trainees with feedback,e.g. “Here is your score, here is what you did do correctly, andhere is what you did not do” 
     227The Script Builder shall support the ability to associate a quantitative score assigned to trainees with feedback,e.g. “Here is your score, here is what you did do correctly, and here is what you did not do” 
    228228 
    229229Debrief by Position 
    230230 
    231 The Script Builder shall support the ability todebrief students at the end of a training session by position, e.g.CHP CAD, ATMS, Maintenance Radio, PIO, MIO, Facilitator, etc. 
     231The Script Builder shall support the ability to debrief students at the end of a training session by position, e.g.CHP CAD, ATMS, Maintenance Radio, PIO, MIO, Facilitator, etc. 
    232232 
    233233Aggregate TMC Operator Functions  
    234234 
    235 The Script Builder shall support the ability toaggregate multiple TMC operator functions into a individualpositions, allowing the TMC simulator to be run with a smaller groupof trainees on the floor.  All scoring, trainee debriefingfunctionality, etc. shall be aggregated so that scoring options arecoherent with position aggregation, which will be set via GUIcontrols.  
     235The Script Builder shall support the ability to aggregate multiple TMC operator functions into a individual positions, allowing the TMC simulator to be run with a smaller groupof trainees on the floor.  All scoring, trainee debriefing functionality, etc. shall be aggregated so that scoring options are coherent with position aggregation, which will be set via GUI controls.  
    236236 
    237237Student Evaluation Events – General 
    238238 
    239 The Script Builder shall allow for insertion ofEvaluation Events which allow instructors to quantitatively andqualitatively measure the performance of student trainees in the TMCSimulator.  These Evaluation Events create points in the TMCSimulator instructor notebooks, which can either be printed orelectronic, where instructors will be prompted to evaluate studentperformance in their use of any TMC Simulator system.  Instructorevaluations will be a quantified numerical rating, such as a scalefrom 1 to 5, and a written qualitative rating where the instructorcan give direct commentary regarding student performance.   Specificmeasures of performance available for each event are articulatedwithin the* ***TMC Simulator XML Script Schema. Eachcriteria to evaluate each Evaluation Event is specified in the* ***TMCSimulator XML Script Schema. 
     239The Script Builder shall allow for insertion of Evaluation Events which allow instructors to quantitatively and qualitatively measure the performance of student trainees in the TMCSimulator.  These Evaluation Events create points in the TMCSimulator instructor notebooks, which can either be printed or electronic, where instructors will be prompted to evaluate student performance in their use of any TMC Simulator system.  Instructor evaluations will be a quantified numerical rating, such as a scale from 1 to 5, and a written qualitative rating where the instructor can give direct commentary regarding student performance.   Specific measures of performance available for each event are articulated within the *TMC Simulator XML Script Schema*. Each criteria to evaluate each Evaluation Event is specified in the* *TMCSimulator XML Script Schema*. 
    240240 
    241241ATMS Utilization 
    … …  
    243243Student Performance Evaluation Event 
    244244 
    245 The Script Builder shallallow for instructors to evaluate student use of the ATMS.   ATMSevaluation events allow instructors to determine how effectivelystudents utilized the ATMS to interpret traffic conditions, set CMSmessages, etc. 
     245The Script Builder shall allow for instructors to evaluate student use of the ATMS.   ATMS evaluation events allow instructors to determine how effectively students utilized the ATMS to interpret traffic conditions, set CMSmessages, etc. 
    246246 
    247247Activity Log 
    … …  
    249249Utilization Student Performance Evaluation Event 
    250250 
    251 The Script Builder shallallow for instructors to evaluate student use of the Activity Log. 
     251The Script Builder shall allow for instructors to evaluate student use of the Activity Log. 
    252252 
    253253CHP CAD 
    … …  
    255255Utilization Student Performance Evaluation Event 
    256256 
    257 The Script Builder shallallow for instructors to evaluate student use of the CHP CAD. 
    258  
    259 Such a system might utilize modifications of theSimulator CHP CAD system to allow it to report back when and what CADlogs were utilized to determine if the trainees utilized CHP CAD tothe maximum extent possible.  These features would seek to understandif students responded properly to CHP CAD messages.  Was theirresponse delayed? Were they prompted? Was their response correct? 
     257The Script Builder shall allow for instructors to evaluate student use of the CHP CAD. 
     258 
     259Such a system might utilize modifications of the Simulator CHP CAD system to allow it to report back when and what CADlogs were utilized to determine if the trainees utilized CHP CAD to the maximum extent possible.  These features would seek to understand if students responded properly to CHP CAD messages.  Was their response delayed? Were they prompted? Was their response correct? 
    260260 
    261261CMS Utilization 
    … …  
    269269Student Performance Evaluation Event 
    270270 
    271 The Script Builder shallallow for instructors to evaluate student performance as aFacilitator. 
     271The Script Builder shall allow for instructors to evaluate student performance as aFacilitator. 
    272272 
    273273Caltrans Radio, TMTRadio, TMT Radio Utilization Student Performance Evaluation Event 
    274274 
    275 The Script Builder shallallow for instructors to evaluate student use of the each of theradio systems available to them. 
     275The Script Builder shall allow for instructors to evaluate student use of the each of theradio systems available to them. 
    276276 
    277277CCTV Utilization 
    … …  
    279279Student Performance Evaluation Event 
    280280 
    281 The Script Builder shallallow for instructors to evaluate student use of the TMC SimulatorCCTV camera selection and viewing capabilities.   These evaluationevents would allow instructors to document how trainees utilizedavailable CCTV imagery as part of their verification of a reportedincident.   
    282  
    283 Telephone UtilizationStudent Performance Event 
    284  
    285 The Script Builder shallallow for instructors to evaluate student use of the telephone.Telephone evaluation events shall allow instructors to determine ifstudents have provided them complete answers to their phone calls,including information such as callback numbers, number of lanesclosed, fatalities, etc. 
     281The Script Builder shall allow for instructors to evaluate student use of the TMC SimulatorCCTV camera selection and viewing capabilities.   These evaluation events would allow instructors to document how trainees utilized available CCTV imagery as part of their verification of a reported incident.   
     282 
     283Telephone Utilization Student Performance Event 
     284 
     285The Script Builder shall allow for instructors to evaluate student use of the telephone.Telephone evaluation events shall allow instructors to determine ifstudents have provided them complete answers to their phone calls,including information such as callback numbers, number of lanesclosed, fatalities, etc. 
    286286 
    287287 
    … …  
    291291The Script Builder shall allow for instructors toevaluate student use of SigAlerts as appropriate to the simulationenvironment. 
    292292 
    293 2.5SupportingRealism in Training 
    294  
    295 BackgroundNoise 
    296  
    297 The Script Builder shall allow background noise tobe added to a script.  Background noise will not be attached to anincident.  It enhances the realism of the simulation by addingunimportant and unrelated events.  Background noise shall includemaintenance radio chatter audio clips, lane closures, TMCAL logs,etc.  Specific background noise events will include animals in theroadway, a wild sprinkler on the freeway, a vehicle with a flat tire,etc. 
    298  
    299 AutomaticGeneration of Organization Chart for Training District (D14 – SantaLucia) Not Needed by Fall 
    300  
    301 The Script Builder shall support the automaticgeneration of an organizational chart which will be used by bothstudents and instructors in the back room and be coherent with allevents in the generated instructor scripts. 
    302  
    303 Injectionof Minor Incidents 
    304  
    305 The Script Builder shall support the automaticgeneration of secondary incidents if queue protection is notimplemented by trainees as appropriate.  This requirement impliesthat the Script Builder can encode for and the Simulation Managershall be capable of dynamically adding an incident during asimulation.   
    306  
    307 MinorIncidents 
    308  
    309 The Script Builder shall be capable of generatinga false incident which students will discover is such when theattempt to user available verification tools.   Potential steps toimplement a false incident are: 1.) start a log entry 2.) dispatch aunit 3.) survey area with surveillance tools, ATMS, etc.  4.)discover the incident does not exist.    Comment  
    310  
    311 (Minor incidents are simply incidents but narrowerin scope than typical incidents.  Ideally they are displayed at thebottom of the edit canvas. Perhaps be able to “flag” an incidentas minor.) 
    312  
    313 2.6SpecifyingExpected Traffic Network Performance 
    314  
    315 DeterminingQueue Length - amount of traffic backup  May be obsolete as we arereplacing paramics. 
    316  
    317 The Script Builder shall allow the desired queuelength for an incident to be specified.  Potential methods toaccomplish this feature are yet to be determined.  Please note thatthis is related to the ATMS Driver and the control it asserts uponthe ATMS. 
    318  
    319 2.7InstructorSupport 
    320  
    321 Assignmentof Reporter Roles to Specific Instructors 
     293=== 2.5 Supporting Realism in Training === 
     294 
     295Background Noise 
     296 
     297The Script Builder shall allow background noise to be added to a script.  Background noise will not be attached to an incident.  It enhances the realism of the simulation by adding unimportant and unrelated events.  Background noise shall include maintenance radio chatter audio clips, lane closures, TMCAL logs,etc.  Specific background noise events will include animals in the roadway, a wild sprinkler on the freeway, a vehicle with a flat tire,etc. 
     298 
     299Automatic Generation of Organization Chart for Training District (D14 – SantaLucia) Not Needed by Fall 
     300 
     301The Script Builder shall support the automatic generation of an organizational chart which will be used by both students and instructors in the back room and be coherent with all events in the generated instructor scripts. 
     302 
     303Injection of Minor Incidents 
     304 
     305The Script Builder shall support the automatic generation of secondary incidents if queue protection is not implemented by trainees as appropriate.  This requirement implies that the Script Builder can encode for and the Simulation Manager shall be capable of dynamically adding an incident during a simulation.   
     306 
     307Minor Incidents 
     308 
     309The Script Builder shall be capable of generating a false incident which students will discover is such when the attempt to user available verification tools.   Potential steps to implement a false incident are: 1.) start a log entry 2.) dispatch a unit 3.) survey area with surveillance tools, ATMS, etc.  4.)discover the incident does not exist.    Comment  
     310 
     311(Minor incidents are simply incidents but narrower in scope than typical incidents.  Ideally they are displayed at the bottom of the edit canvas. Perhaps be able to “flag” an incident as minor.) 
     312 
     313=== 2.6 Specifying Expected Traffic Network Performance === 
     314 
     315Determining Queue Length - amount of traffic backup  May be obsolete as we are replacing paramics. 
     316 
     317The Script Builder shall allow the desired queue length for an incident to be specified.  Potential methods t oaccomplish this feature are yet to be determined.  Please note that this is related to the ATMS Driver and the control it asserts upon the ATMS. 
     318 
     319=== 2.7 Instructor Support === 
     320 
     321Assignment of Reporter Roles to Specific Instructors 
    322322 
    323323The Script Builder shall allow reporter roles tobe assigned to individual instructors. 
    324324 
    325 ColorCoding Instructor Manuals 
    326  
    327 The Script Builder shall support showinginstructor roles in the instructor manuals using a unique identifiersuch as color. 
    328  
    329 2.8OtherTraining Goals 
    330  
    331 DedicatedCHP CAD Training 
    332  
    333 The Script Builder shall be capable of supportingthe development of CAD scripts, which the Simulation Manager can useto populate the CAD for the purpose of CAD specific training. 
    334  
    335 EOCTraining 
     325Color Coding Instructor Manuals 
     326 
     327The Script Builder shall support showing instructor roles in the instructor manuals using a unique identifiersuch as color. 
     328 
     329=== 2.8 Other Training Goals === 
     330 
     331Dedicated CHP CAD Training 
     332 
     333The Script Builder shall be capable of supporting the development of CAD scripts, which the Simulation Manager can use to populate the CAD for the purpose of CAD specific training. 
     334 
     335EOC Training 
    336336 
    337337The Script Builder shall support EOC training. 
    338338 
    339 Trainingfor TMC & District Management 
    340  
    341 The Script Builder shall support the developmentof training scenarios customized to TMC and District Management. 
    342  
    343 GeneralizedTransportation Training 
    344  
    345 The Script Builder shall support the developmentof training scripts related to other modes of transportation, e.g.buses, trains, etc. 
    346  
    347 3.ATMS Driver 
     339Training for TMC & District Management 
     340 
     341The Script Builder shall support the development of training scenarios customized to TMC and District Management. 
     342 
     343Generalized Transportation Training 
     344 
     345The Script Builder shall support the development of training scripts related to other modes of transportation, e.g.buses, trains, etc. 
     346 
     347== 3.ATMS Driver == 
    348348 
    3493493.1General Requirements