C3Fire Log Events
Log Events
When the C3Fire server is running a session it creates a session event log. The session log file contains all events that occur in the session. The contents in the log depends on the configuration and on the activated modules.
The event log contain all information on what happened during a session, and it is possible to analyse the session and make a reply on what did happen in the session based on the information in the event log.
All events belongs to a specific event type. The event types in C3Fire are described below.
Log File Management
The Log File Management tool in C3Fire analysis can be used to sort all events in the session log file to separate log files, one log file for each event type.
In the event type description below the content of each event type log file are described in the table cells with white background.
Database Support
In version 4.2.x.x the database connection is disabled!
It is also possible to insert all events to a database. This is done in the Database tool in C3Fire analysis.
The database will contain a table for each event type. The database tables are given a name based on the event type.
Database specific information is described in the table cells with green background.
Log File Structure
Identification numbers
Role ID Numbers
The role id number are defined in the xml element <RoleIDNrs> in the event log file main xml element <C3FireLog>.
Example
<RoleIDNrs>
<Role IdNr = "0" IdName = "Ground Chief A" />
<Role IdNr = "1" IdName = "Ground Chief B" />
<Role IdNr = "2" IdName = "Ground Chief C" />
<Role IdNr = "3" IdName = "Ground Chief D" />
</RoleIDNrs>
Unit ID Numbers
The unit id numbers are defined in the xml element <UnitIDNrs> in the event log file main xml element <C3FireLog>.
Example
<UnitIDNrs>
<Unit IdNr = "0" IdName = "F1" />
<Unit IdNr = "1" IdName = "F2" />
<Unit IdNr = "2" IdName = "F3" />
<Unit IdNr = "3" IdName = "F4" />
<Unit IdNr = "4" IdName = "L5" />
<Unit IdNr = "5" IdName = "L6" />
<Unit IdNr = "6" IdName = "R7" />
<Unit IdNr = "7" IdName = "R8" />
<Unit IdNr = "8" IdName = "D9" />
</UnitIDNrs>
Unit Activity ID Numbers
The possible unit activity depends on the configuration and activated modules. The possible units events are described in the xml element <LogEventInfo> whitch is the second xml element in the event log file.
Example
Unit Activity 0 = Not Defined
Unit Activity 1 = Inactive
Unit Activity 2 = Moving
Unit Activity 3 = Mobilizing
Unit Activity 4 = Fire Fighting
Unit Activity 5 = De Mobilizing
Unit Activity 6 = Refill Water
Unit Activity 7 = Refill Fule
Unit Activity 8 = Tap Water
Unit Activity 9 = Tap Fule
Unit Activity 10 = Hover
Unit Activity 11 = Refill People
Unit Activity 12 = Tap People
Fire State ID Numbers
The fire state id numbers are defined in the xml element <FireTypeIDNrs> in the event log file main xml element <C3FireLog>.
Example
<FireTypeIDNrs>
<FireType IdNr = "1" IdName = "Clear" />
<FireType IdNr = "2" IdName = "Fire" />
<FireType IdNr = "3" IdName = "ClosedOut" />
<FireType IdNr = "4" IdName = "BurnedOut" />
</FireTypeIDNrs>
Object Type ID Numbers
The object type id number are defined in the xml element <ObjectTypeIDNrs> in the event log file main xml element <C3FireLog>.
Example
<ObjectTypeIDNrs>
<ObjectType IdNr = "0" IdName = "Normal" />
<ObjectType IdNr = "1" IdName = "Pine" />
<ObjectType IdNr = "2" IdName = "Birch" />
<ObjectType IdNr = "3" IdName = "House" />
<ObjectType IdNr = "4" IdName = "Water" />
<ObjectType IdNr = "5" IdName = "Fuel" />
<ObjectType IdNr = "6" IdName = "People" />
<ObjectType IdNr = "7" IdName = "Tent" />
<ObjectType IdNr = "8" IdName = "MedicalTransitPoint" />
<ObjectType IdNr = "9" IdName = "UAVBaseNW" />
<ObjectType IdNr = "10" IdName = "UAVBaseN" />
<ObjectType IdNr = "11" IdName = "UAVBaseNE" />
<ObjectType IdNr = "12" IdName = "UAVBaseW" />
<ObjectType IdNr = "13" IdName = "UAVBaseC" />
<ObjectType IdNr = "14" IdName = "UAVBaseE" />
<ObjectType IdNr = "15" IdName = "UAVBaseSW" />
<ObjectType IdNr = "16" IdName = "UAVBaseS" />
<ObjectType IdNr = "17" IdName = "UAVBaseSE" />
</ObjectTypeIDNrs>
Person Type ID Numbers
The person type id number are defined in the xml element <PersonTypeIDNrs> in the event log file main xml element <C3FireLog>.
Example
<PersonTypeIDNrs>
<PersonType IdNr = "0" IdName = "Adult" />
<PersonType IdNr = "1" IdName = "Child" />
</PersonTypeIDNrs>
Event Types
Scenario Event
A scenario event is a time stamped event that is done in the simulation, at some specified time.
The event type id number are 10.
The event type file that contain all scenario events are named scenario_event.txt.
The database table that contain all scenario events are named scenario_event.
Database table specific properties | Description |
GroupNumber | This events group nr.
The value is an integer. Example: 5 |
SessionNumber | This events session nr. The value is an integer. Example: 12 |
Event properties | Description |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
Command | Events that effect the session. The value is a string. Possible values = "SetTime", "SetWindDirection", "SetWindSpeed", "StartFire", "SendMail", "Pause", "End". |
Fire Event
A Fire Event defines the fire state in one specific position on the map.
The event type id number are 11.
The information that is written in the fire state events are described in the xml element <LogEventInfo>.
Example
11 = "Fire Event : State PosX PosY"
The event type file that contain all fire events are named fire_event.txt.
The database table that contain all fire events are named fire_event.
Database table specific properties | Description |
GroupNumber | This events group nr.
The value is an integer. Example: 5 |
SessionNumber | This events session nr. The value is an integer. Example: 12 |
Event properties | Description |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
State | The state of the fire at the specified position. The value is an integer. Example: 2.
|
PosX | Horizontal position on the Map. |
PosY | Vertical position the Map. |
Unit State
When a unit perform some action an event is inserted in the log file. What information inserted in a unit state events depends on the configuration and the activated modules.
The event type id number are 12.
The information that is written in the unit state events are described in the xml element <LogEventInfo>.
Example
12 = "Unit State : Unit Activity PosX PosY IntentionX IntentionY WaterLevel WaterRefillSpeed WaterTapSpeed FuelLevel FuelRefillSpeed FuelTapSpeed PeopleTransportNrOfPeople PeopleTransportEnterTime PeopleTransportLeaveTime"
The event type file that contain all unit state events are named unit_state.txt.
The database table that contain all unit state events are named unit_state.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Unit | The id number for the unit.
The value is an integer. Example: 1 |
|
Activity | The activity the unit currently are doing. The value is an integer. Example: 1 |
|
PosX | Current horizontal position on the Map.
The value is an integer. Example: 5 |
|
PosY | Current vertical position the Map.
The value is an integer. Example: 6 |
|
IntentionX | Horizontal position on the map towards which the unit is heading.
The value is an integer. Example: 22 |
|
IntentionY | Vertical position on the map towards which the unit is heading.
The value is an integer. Example: 37 |
|
WaterLevel | The amount of water in the unit's water tank.
The value is an integer. Example: 34 |
WaterLogistic |
WaterRefillSpeed | The current speed with which the water level is refilled from a water tank unit or a water tank station. The
number of water levels moved every second. The value is a decimal number. Example 3.5 |
WaterLogistic |
WaterTapSpeed | The current speed with which the water level is taped from the water to a unit. The number of water levels
moved every second. The value is a decimal number. Example 5.5 |
WaterLogistic |
FuelLevel | The amount of fuel in the unit's fuel tank.
The value is a decimal number. Example 55.4 |
FuelLogistic |
FuelRefillSpeed | The current speed with which the fuel level is refilled from a fuel tank unit or a fuel tank station. The
number of fuel levels moved every second. The value is a decimal number. Example 3.5 |
FuelLogistic |
FuelTapSpeed | The current speed with which the fuel level is taped from the fuel to a unit. The amount of fuel moved every second.
The value is a decimal number. Example 4.2 |
FuelLogistic |
PeopleTransportNrOfPeople | The number of people in unit.
The value is an integer. Example 2 |
People |
PeopleTransportEnterTime | The current speed with which the people is enter the unit. The
number of seconds it takes for one person to enter the unit. The value is a decimal number. Example 10.5 |
People |
PeopleTransportLeaveTime | The current speed with which the people leave the unit. The
number of seconds it takes for one person to leave the unit. The value is a decimal number. Example 6.0 |
People |
Unit send Unit State to Role
The units have ability to send information of its current activity and state to any role (player). Which role the information should be sent to is defined in the session configuration. When the state is send to a role an log event is created.
The event type id number are 13.
The information that is written in the send unit state events are described in the xml element <LogEventInfo>.
Example
13 = "Unit send Unit State to Role : SenderUnit ReceiverRole Activity PosX PosY IntentionX IntentionY WaterLevel FuelLevel PeopleTransportNrOfPeople"
The event type file that contain all send unit state events are named unit_send_unit_state_to_role.txt.
The database table that contain all send unit state events are named unit_send_unit_state_to_role.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Unit | The ID number for the unit.
The value is an integer. Example: 1 |
|
ReceiverRole | The ID number for the role that the information is send to.
The value is an integer. Example: 1 |
|
Activity | The activity the unit currently are doing. The value is an integer. Example: 1 |
|
PosX | Current horizontal position on the Map.
The value is an integer. Example: 5 |
|
PosY | Current vertical position the Map.
The value is an integer. Example: 6 |
|
IntentionX | Horizontal position on the map towards which the unit is heading.
The value is an integer. Example: 22 |
|
IntentionY | Vertical position on the map towards which the unit is heading.
The value is an integer. Example: 37 |
|
WaterLevel | The amount of water in the unit's water tank.
The value is an integer. Example: 34 |
WaterLogistic |
FuelLevel | The amount of fuel in the unit's fuel tank.
The value is a decimal number. Example 55.4 |
FuelLogistic |
PeopleTransportNrOfPeople | The number of people in the unit.
The value is an integer. Example 2 |
People |
Unit send observed Object to Role
The units have ability to send information about objects in its range of sight to any role (player). Which role the information is sent
to is configured in session configuration. When sent, the object appears in the receiving roles map.
The event type id number are 14.
The information that is written in the send observed object events are described in the xml element <LogEventInfo>.
Example
14 = "Unit send observed Object to Role : SenderUnit ReceiverRole PosX PosY Object"
The event type file that contain all send observed objects events are named unit_send_observed_object_to_role.txt.
The database table that contain all send observed objects events are named unit_send_observed_object_to_role.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Unit | The id number for the unit.
The value is an integer. Example: 1 |
|
ReceiverRole | The ID number for the role that the information is send to.
The value is an integer. Example: 1 |
|
PosX | Current horizontal position on the Map.
The value is an integer. Example: 6 |
|
PosY | Current vertical position the Map.
The value is an integer. Example: 5 |
|
Object | The ID number for the object this unit have in its range of sight. The value is an integer. Example: 5 |
Unit send observed Fire to Role
The units have ability to send information about fire in its range of sight to any role (player). Which role the information is sent
to is configured in session configuration. When sent, the fire appears in the receiving roles map.
The event type id number are 15.
The information that is written in the send observed fire events are described in the xml element <LogEventInfo>.
Example
15 = "Unit send observed Fire to Role : SenderUnit ReceiverRole PosX PosY Fire"
The event type file that contain all send observed fire events are named unit_send_observed_fire_to_role.txt.
The database table that contain all send observed fire events are named unit_send_observed_fire_to_role.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Unit | The id number for the unit.
The value is an integer. Example: 1 |
|
ReceiverRole | The ID number for the role that the information is send to.
The value is an integer. Example: 1 |
|
PosX | Current horizontal position on the Map.
The value is an integer. Example: 6 |
|
PosY | Current vertical position the Map.
The value is an integer. Example: 5 |
|
Fire | The ID number for the fire type this unit have in its range of sight. The value is an integer. Example: 5 |
Unit send observed Unit to Role
The units have ability to send information about the units that is in its range of sight to any role (player). Which role the information is sent
to is configured in session configuration. When sent, the unit will appears in the receiving roles map.
The event type id number are 16.
The information that is written in the send observed unit events are described in the xml element <LogEventInfo>.
Example
16 = "Unit send observed Unit to Role : SenderUnit ReceiverRole PosX PosY Unit IsVisible"
The event type file that contain all send observed unit events are named unit_send_observed_unit_to_role.txt.
The database table that contain all send observed unit events are named unit_send_observed_unit_to_role.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an event occur in the session it will get a unique identification number. First event get 0 , next get 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event did occur. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
SenderUnit | The id number for the unit.
The value is an integer. Example: 1 |
|
ReceiverRole | The ID number for the role that the information is send to.
The value is an integer. Example: 1 |
|
PosX | Current horizontal position on the Map.
The value is an integer. Example: 6 |
|
PosY | Current vertical position the Map.
The value is an integer. Example: 5 |
|
Unit (observed) | The ID number for the unit this unit have in its range of sight. The value is an integer. Example: 5 |
|
IsVisible | If the unit is visible or not.
The false value is used to tell the role that it no longer can see the unit. Possible values : "false", "true" in log file and "0", "1" in the database. |
Person Move From To Unit or Pos Event
A Person Move From To Unit or Pos Event defines the movement of a person from and to a Unit or position on the map. This event type covers the full range of ways in which a civilian person can be moved:
- A Player loads a person from a position to a Unit
- A Player unloads a person from a Unit to a position
- A Manager or Player moves a person from a position to another position
The event type id number is 51.
The information that is written to the Person Move From To Unit or Pos Event is described in the xml element <LogEventInfo>.
Example
51 = "Person Move From To Unit or Pos : Person PersonType MoveType Unit1 Unit2 Pos1X Pos1Y Pos2X Pos2Y"
The event type file that contains all Person Move From To Unit or Pos Events is named person_move_from_to_unit_or_pos.txt.
The database table that contains all Person Move From To Unit or Pos Events is named person_move_from_to_unit_or_pos.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an events occurs in the session it is given a unique identification number. The first event is numbered 0 , the next is numbered 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event occurred. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Person | The ID number for the person.
The value is an integer. Example: 1 |
|
PersonType | The ID for the type of person.
The value is an integer. Example: 1 |
|
MoveType | The type of person movement.
The value is an integer. Example: 5 1 : Move from Pos to Unit, argument Pos1 and Unit1 are used. |
|
Unit1 | The ID number for the unit that the person was moved from. If the person was moved from a location, this value is -1. The value is an string. Example: R9 |
|
Unit2 | The ID number for the unit that the person was moved to. If the person was moved to a location, this value is -1. The value is an string. Example: R9 |
|
Pos1X | The horizontal position on the map that the person was moved from. If the person is loaded from a Unit, this value is -1. The value is an integer. Example: 6 |
|
Pos1Y | The vertical position the map that the person was moved from. If the person is loaded from a Unit, this value is -1. The value is an integer. Example: 5 |
|
Pos2X | The horizontal position on the map that the person was moved to. If the person is loaded to a Unit, this value is -1. The value is an integer. Example: 10 |
|
Pos2Y | The vertical position the map that the person was moved to. If the person is loaded to a Unit, this value is -1.
The value is an integer. Example: 12 |
Manager or player change Role Control Unit Event
A Manager or player change Role Control Unit Event defines the change of Role configuration, specifically the control of Units by a Role.
The event type id number is 60.
The information that is written to the Manager or player change Role Control Unit Event is described in the xml element <LogEventInfo>.
Example
60 = "Manager or player change Role Control Unit : Changer Role Units"
The event type file that contains all Manager or player change Role Control Unit Events is named manager_or_player_change_role_control_unit.txt.
The database table that contains all Manager or player change Role Control Unit Events is named manager_or_player_change_role_control_unit.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an events occurs in the session it is given a unique identification number. The first event is numbered 0 , the next is numbered 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event occurred. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Changer | The ID for the Manager or Player that made the configuration change.
The value is an integer. Example: -1 |
|
Role | The ID for the Role that has been configured.
The value is an string. Example: A |
|
Units | The IDs for all Units that are under control of the Role following the configuration event.
The value is an string. Example: F1,F2,F3,F4 |
Manager or player change Unit Send Info To Role Event
A Manager or player change Unit Send Info To Role Event defines the change of Unit configuration, specifically which Roles a Unit sends information (within its observation area) to.
The event type id number is 61.
The information that is written to the Manager or player change Unit Send Info To Role Event is described in the xml element <LogEventInfo>.
Example
61 = "Manager or player change Unit Send Info To Role : Changer Unit Roles"
The event type file that contains all Manager or player change Unit Send Info To Role Events is named manager_or_player_change_unit_send_info_to_role.txt.
The database table that contains all Manager or player change Unit Send Info To Role Events is named manager_or_player_change_role_control_unit.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an events occurs in the session it is given a unique identification number. The first event is numbered 0 , the next is numbered 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event occurred. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Changer | The ID for the Manager or Player that made the configuration change.
The value is an integer. Example: -1 |
|
Unit | The ID for the Unit that has been configured.
The value is an string. Example: F1 |
|
Roles | The IDs for all Roles that the Unit sends information (within its observation area) to.
The value is an string. Example: A,B,C |
Manager or player change Role Can Send Mail To Role Event
A Manager or player change Role Can Send Mail To Role Event defines the change of Role configuration, specifically which Roles and Mail Groups a Role can send mail to.
The event type id number is 62.
The information that is written to the Manager or player change Role Can Send Mail To Role Event is described in the xml element <LogEventInfo>.
Example
62 = "Manager or player change Role Can Send Mail To Role : Changer Role Roles"
The event type file that contains all Manager or player change Role Can Send Mail To Role Events is named manager_or_player_change_role_can_send_mail_to_role.txt.
The database table that contains all Manager or player change Role Can Send Mail To Role Events is named manager_or_player_change_role_can_send_mail_to_role.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an events occurs in the session it is given a unique identification number. The first event is numbered 0 , the next is numbered 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event occurred. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Changer | The ID for the Manager or Player that made the configuration change.
The value is an integer. Example: -1 |
|
Role | The ID for the Role that has been configured.
The value is an string. Example: A |
|
Roles | The IDs for all Roles and Mail Groups that the Role can send mail to.
The value is an string. Example: B,C,All |
Manager or player change Mail Group Members Event
A Manager or player change Mail Group Members Event defines the change of Mail Group configuration, specifically which Roles are included in the Mail Group.
The event type id number is 63.
The information that is written to the Manager or player change Mail Group Members Event is described in the xml element <LogEventInfo>.
Example
63 = "Manager or player change Mail Group Members : Changer MailGroup Members"
The event type file that contains all Manager or player change Mail Group Members Events is named manager_or_player_change_mail_group_members.txt.
The database table that contains all Manager or player change Mail Group Members Events is named mmanager_or_player_change_mail_group_members.
Database table specific properties | Description | |
GroupNumber | This events group nr.
The value is an integer. Example: 5 | |
SessionNumber | This events session nr. The value is an integer. Example: 12 | |
Event properties | Description | Module |
EventNumber | When an events occurs in the session it is given a unique identification number. The first event is numbered 0 , the next is numbered 1, and so on. The value is an integer. Example: 625 |
|
Time | The session time when the event occurred. The value is a string "HH:MM:SS". Value example = "02:15:00" |
|
Changer | The ID for the Manager or Player that made the configuration change.
The value is an integer. Example: -1 |
|
MailGroup | The ID for the Mail Group that has been configured.
The value is an string. Example: All |
|
Members | The IDs for all Roles included in the Mail Group.
The value is an string. Example: A,B,C |