Debrief Page

From SIMboxWiki
Jump to navigation Jump to search

Here, we will learn how to make the most out of lesson/scenario debrief pages. The key to a detailed, helpful, and useful debrief page is how you create the agent for the particular lesson. There are many useful pieces of information that can be reported in a debrief page, so knowing where they are and how to report them is an important step in creating one.

Debrief pages most typically include the total time the lesson took to complete along with accompanying time stamps provided for specific actions, VI Guidance text that was entered in the Debrief section of VI Guidance properties, Objective values, and user inputs (if you have selected for the user input reactor to be on). There are many more options to display on a debrief page, but we will focus on the ones mentioned above.


1. In order to view a debrief page, you must run the scenario in Go mode. For illustration purposes, we will use a scenario created for a wiki page (create the Calling Actions in Agents first to create a template for this Debrief Wiki Tutorial). (Make sure that the scenario is “checked in”, to ensure proper loading. Right click on the scenario > Check In > Final > Check In).


2. Select the scenario and click on the Go button.



After running this particular scenario “Calling Actions in Agents” we can see the following debrief page.


We can see that the lesson took 56 seconds to complete, but other than that, this debrief is not all that informative. Let’s look at the ways in which we can make the most of our debrief page.

Creating Content to Display in a Debrief Page

This was the original agent (Calling Actions in Agents):


Output VI Guidance

3. Edit or create new VI Guidance and enter text into the Debrief text box at the bottom. From here you can also delegate whether the text is a general comment, positive remark, a warning, or an alert. Each category will have a specific icon in the debrief page. Here, let’s enter a general comment that the lesson has started. Right click Instructions > Instructional Aids > VI Guidance. Add the text, select General from the drop down menu and click OK.


Output Time Stamps

Let’s create a time stamp so we know how long it takes to lower the flaps all the way and then raise them again.

4. Right click on the VI Guidance that says “First, we will lower the flaps.” > Advanced > Call Action. Search for ACTION_RESET_TIME_COUNTER_1 (check Show hidden tokens box). Add the action to reset time counter 1.


5. Next, add the text to be displayed for the debrief page right after the actions for raising the flaps all the way up. We want the text to display the amount of time that has passed, from the time counter reset up to this point. Right click on this area and select Instructional Aids > VI Guidance. Down in the Debrief text box right click and select Attribute.



6. Add ATT_TIME_COUNTER_1 to the Debrief box so it can be output. When the Attribute Characteristics window appears, just click OK. We don’t need to worry about changing anything here.



You should now see something like this:


7. To make this output a bit more informative we could add text around the time counter attribute. (Note: The time counter is output in seconds). Click OK.


Output Objective Values

8. To output objectives, first we must create one. Let’s create an objective called Score. Open the Objectives window by clicking Tools at the top of the Scenario Editor toolbar > Objectives Center. Create a new Objective by right clicking in right hand side of the Objective window and selecting New.


9. Add the new object to the beginning of the agent to set an initial score of 100. Right click Instructions > Set Objective.


10. Select Score from the drop down menu and enter 100 into the New Value box. This is initializing the score at the beginning of the lesson to ensure that the trainee is starting off with 100%.


Now let’s add some opportunities for the trainee to actually perform a task. We will have them perform the 180 degree turn instead of the autopilot. They will have 20 seconds to perform the task and then points will be deducted from their score if they fail to turn in a timely manner.

11. Turn the autopilot off and delete the autopilot actions and Scenario End (everything located in the box below).


12. Add a new step with a Continue to monitor the trainee’s actions. Add the attribute ATT_TRUE_HEADING (check Show hidden tokens box) to the Range and edit the range to 170 < x < 190 (right click the attribute > Edit).




13. Now, add VI Guidance (with accompanying debrief outputs) telling the trainee to turn to a heading of 180 degrees. Tell them three times with a 20 second time out, a 10 second timeout and a 5 second timeout in between each reminder. After the 5 second timeout, tell the trainee that they have failed.

Your agent should look something like this:


Note: All the Debrief outputs have been labeled as either general remarks, warnings, or alerts, as appropriate.

14. Next, set the objective Score to decrease 25 points every time the trainee does not turn in the allotted time. The Score should be added after the timeouts. Right click on the timeout > Set Objective > set Score to equal Score -25.


Your agent should look something like this:


Note: Just copy and paste the objective Score in the appropriate locations, there is no need to perform the above step multiple times. Ctrl+C and Ctrl+V are valid functions in the agent. Select the Score and copy it, then select the timeout which you want to paste the score under.

We must put a Scenario End whether the trainee passes or fails the lesson.

15. To pass a trainee, put a Scenario End after the Continue step monitoring the heading. Right click Continue > Instructional Aids > Scenario End. Set Score as the Grade and Status passed.



16. Add a second Continue to this same step which measures Trainee Info. Right click Trainee Info > Compare Objective. When Score = 25, end the scenario




17. Assign a Score as a Grade in the Session End window.


18. Also assign the appropriate lesson Status (here we select failed).


19. Finally, add VI Guidance to let the trainee know that the session will be ending, in either case. Either they passed the lesson or they failed. Right click on Continue > Instructional Aids > VI Guidance. Add appropriate debrief text, as show below. After the VI Guidance, in either case, add a 2 second timeout before the Scenario End.


Your agent should look something like this:


20. Save and check in your agent. Run in Go mode to test and then view the Debrief page.

A sample of the Debrief page:


See Also

Calling Actions in Agents