Project

General

Profile

xAPI Statements 2022-1

Back to Table of Contents

GIFT produces several different xAPI statements. The GIFT xAPI profile can be found at GIFT\config\lms\profiles\ starting in GIFT 2021-2.

Chain of custody

In every GIFT xAPI statement there is a reference to the GIFT instance and the session within that GIFT instance that produced the statement.

Currently the following attributes are provided:
  • DKF file name (e.g. React to Contact.dkf.xml)
  • Domain session log file name (e.g. domainSession790_uId1_2021-10-18_18-06-49.protobuf.bin)
  • Domain session log absolute file path (e.g. D:\\GIFT-SVN\\branches\\STE_CFT_Integration\\GIFT\\output\\domainSessions\\domainSession790_uId1)
  • IP address of GIFT machine (e.g. 172.117.12.4) - more specifically the IP address of the computer running the GIFT LMS module.
  • Date the GIFT instance was built (e.g. 2021-10-18 16:44 EDT)
  • GIFT version name (e.g. 2022-1)
  • GIFT release date (e.g. Nov 2021)

Learner State

The GIFT learner state message is sent from the Learner module to the Pedagogical module anytime a learner state changes for an individual or team during a GIFT course. The learner state contains performance, cognitive and affective data.

Performance State

In the following example the GIFT user eburmester is being actively assessed in a real-time assessment (DKF) during the course STEELR - Battle Drill 6a - Playback - Log Option 1 - Demo Version.course.xml and has a learner state performance assessment on the Concept Prevent Weapon Safety Violation which is apart of the Task Practicing Muzzle Awareness. The current, short term and predicted assessment is At Expectation.

Cognitive State

coming soon

Affective State

coming soon

Overall assessment scoring

At the end of a real-time assessment (DKF) in a GIFT course, a Published Score message can be sent from the Domain module to the LMS module. The Published score message contains overall scoring at the DKF conditions when rules have been authored for that condition instance. This scoring provides both counts and time based assessments of individuals and groups of individuals / teams. Overall assessment scoring is different than real-time assessments in that real time assessments flow from different values as events happen and overall assessment applies all of the recorded events against a scoring rule to determine overall pass/fail (or Below/At/Above assessment).

In the following example lmarshall has just finished a real-time assessment (DKF) in the course STEELR - Battle Drill 6a - Playback - Log+Option 2 - Demo Version.course.xml. The user is receiving an overall assessment score of Below Expectation for violating the Concept Prevent Weapon Safety Violation during the Task Practicing Muzzle Awareness a total of 14 times. The resulting assessment is Fail.

In the following example a group/team of 4 individuals (lmarshall, kadams, tgregory, wlawson) have just finished a real-time assessment (DKF) in the course STEELR - Battle Drill 6a - Playback - Log+Option 2 - Demo Version.course.xml. The group are receiving an overall assessment score of Below Expectation for violating the Concept Prevent Weapon Safety Violation during the Task Practicing Muzzle Awareness a total of 39 times. The resulting assessment is Fail.

In GIFT 2022-1, Stress and Difficulty where added.
E.g.

"difficultyReason": "Changed from Easy to Hard with stress now at 0.8",
"difficulty": 3,
"stressReason": "'Apply weapon malfunction to AutoRifleman' applied 0.6 stress.",
"stress": 0.8

Mission/Scenario metadata

The attributes found in common.course.dkf.session.Mission.java and displayed in the Game Master Mission panel will be written as an xAPI statement.

Team Member assignment

coming soon

Voiding/Invalidating statements

coming soon - Using the GIFT Game Master Past Session user interface, the user can alter the assessments captured during the session. This over-ride action will void the original learner state xAPI statement and create a new learner state xAPI statement. The username of the user making the change will be stored as well.

Bookmarks/Notes

These observer markers are normally created using the GIFT Game Master Active Session UI. As they make their way through the GIFT architecture they are extracted from Learner State messages.

Environment Adaptation

The Environment Control messages contain an Environment Adaptation (e.g. Time of day Midnight). These are strategies that are sent by the Domain module to the Gateway module to apply in the training application.

In GIFT 2022-1, Stress was added to the statement. E.g. "stress": 0.6