Sensor Events

These are the event_output events related to the sensor.

IMAGE_CREATED

event_output Signature:

<time> <event> <sensor-platform> sensor: <sensor> Mode: <sensor-mode>   Creation_Time: <time> Number: <image-number> Size: <size> bits   Originator: LLA: <lat> <lon> <alt> m   Resolution: <resolution> m Noise_Level: <SNR> dB Background_Level: <CNR> dB Object_Count: <count>   Object: Name: <truth-name> Type: <truth-type> Side: <truth-side>
    Pixel_Count: <pixel-count> S/N: <signal-to-noise> dB Scale_Factor: <factor>

Signature Elements:

Field

Description

<time>

The current simulation time

<event>

The event name

<sensor>

The sensor name

<sensor-mode>

The mode the sensor is in

<time>

The time the image was created

<image-number>

The image serial number

<size>

The image size in bits

<lat> <lon> <alt>

The position of the originating platform; altitude is in meters

<resolution>

The image resolution

<SNR>

The signal-to-noise ratio

<count>

The number of objects contained in the image

<truth-name>

The name of the actual platform

<truth-type>

The type of the actual platform

<truth-side>

The side of the actual platform

<pixel-count>

The approximate number of pixels contained in the image

<signal-to-noise>

The signal-to-noise ratio

<factor>

The scale factor

SENSOR_BROKEN

This event has not been documented yet.

SENSOR_DETECTION_ATTEMPT

event_output Signature:

<time> <event> <sensor-platform> <target-platform> Sensor: <sensor-name> Mode: <sensor-mode> Beam: <beam-index>
<emi-data>
<failures>
Pd: <pd> RequiredPd: <required-pd> Detected: <detected>
SENSOR_DETECTION_ATTEMPT Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<sensor-platform>

Name of platform hosting sensor

<target-platform>

Name of a valid target or “UNKNOWN-TARGET”

<sensor-result-data>

Condition

Field

Description

none

<namesensor>

The name of the sensor

If the mode count > 0

<modesensor>

The name of the sensor mode

none

<indexbeam>

The index of the sensor beam that resulted in the best probability of detection

none

<emi-data>

See emi-data

If any failure occurred

<failures>

Any reason that the sensor detection failed, which is one or more of:

  • Target_Concealed

  • Doppler_Limits_Exceeded

  • Velocity_Limits_Exceeded

  • Target_Deleted

  • Detection_Stopped

none

<pdactual> <pdrequired> <detected>

The actual probability of detection The required probability of detection for the transmitter or receiver to see the target One of:

  • 0 (not detected)

  • 1 (detected)

SENSOR_DETECTION_CHANGED

event_output Signature:

<time> <event> <sensor-platform> <target-platform> Sensor: <sensor-name> Mode: <sensor-mode> Beam: <beam-index>
<emi-data>
<failures>
Pd: <pd> RequiredPd: <required-pd> Detected: <detected>
SENSOR_DETECTION_CHANGED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<sensor-platform>

Name of platform hosting sensor

<target-platform>

Name of a valid target or “UNKNOWN-TARGET”

<sensor-result-data>

Condition

Field

Description

none

<namesensor>

The name of the sensor

If the mode count > 0

<modesensor>

The name of the sensor mode

none

<indexbeam>

The index of the sensor beam that resulted in the best probability of detection

none

<emi-data>

See emi-data

If any failure occurred

<failures>

Any reason that the sensor detection failed, which is one or more of:

  • Target_Concealed

  • Doppler_Limits_Exceeded

  • Velocity_Limits_Exceeded

  • Target_Deleted

  • Detection_Stopped

none

<pdactual> <pdrequired> <detected>

The actual probability of detection The required probability of detection for the transmitter or receiver to see the target One of:

  • 0 (not detected)

  • 1 (detected)

SENSOR_FREQUENCY_CHANGED

event_output Signature:

<time> <event> <platform> Sensor: <sensor-name> Mode: <mode-name> \
  LLA: <lat> <lon> <alt> m \
  [Beam: <beam-number> Frequency Id: <id> Frequency: <frequency>] [\]
  ...

Note

There may be one or more frequency detail entries for this event, one for each beam defined for the sensor mode. This event may occur when a mode is not selected and does not necessarily represent an active transmitter frequency change.

SENSOR_FREQUENCY_CHANGED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of communications platform

<sensor-name>

Name of the sensor

<mode-name>

Sensor mode (modes are defined in user input file)

<lat> <lon> <alt>

The platform location; altitude is always in meters

<beam-number>

The sensor mode beam number for this frequency detail entry

<id>

The beam transmitter frequency Id setting from the configured alternate frequency list

<frequency>

The beam transmitter frequency setting that corresponds to the frequency Id

SENSOR_MODE_ACTIVATED

event_output Signature:

<time> <event> <platform> sensor: <name> Mode: <mode>   LLA: <lat> <lon> <alt> m
SENSOR_MODE_ACTIVATED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform that hosts sensor

<name>

Name of sensor affected

<mode>

Sensor mode (modes are defined in user input file)

<lat> <lon> <alt> m

The platform location; altitude is always in meters

SENSOR_MODE_DEACTIVATED

event_output Signature:

<time> <event> <platform> sensor: <name> Mode: <mode>   LLA: <lat> <lon> <alt> m
SENSOR_MODE_DEACTIVATED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform that hosts sensor

<name>

Name of sensor affected

<mode>

Sensor mode (modes are defined in user input file)

<lat> <lon> <alt>

The platform location; altitude is always in meters

SENSOR_NON_OPERATIONAL

This event has not been documented yet.

SENSOR_OPERATIONAL

This event has not been documented yet.

SENSOR_REQUEST_CANCELED

event_output Signature:

<time> <event> <platform> <track-target-name> sensor: <name> TrackId: <id>
SENSOR_REQUEST_CANCELED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform hosting sensor

<track-target-name>

Valid target name, trackid, or if track pointer is unavailable, ” UNKNOWN”

<name>

Name of sensor requesting change

<id>

Track id being modified

SENSOR_REQUEST_INITIATED

event_output Signature:

<time> <event> <platform> <track-target-name> sensor: <name> Mode: <name> TrackId: <id> Start_Time: <timestart> Update_Time: <timeupdate> Update_Count: <countupdate> Quality: <trackquality> Domain: <domainspatial> Type: <flagtype><flagcandidate><flagfalse target>
{ Target_Truth: Name: <platformname> Type: <platformtype> Side: <platformside> }
Originator: { <locationLLA> | <locationeci> }
{ Track: { <locationLLA> | <locationeci> } Flags: { <flagLV > }{ <flag3D> }{ <flagRV> }{ <flagBV> }{ <flagEV> } }
{ Truth: { <locationLLA> | <locationeci> } Difference: <|r|perceived - actual> }
{ { Track: Vel: <|v|perceived> m/s Hdg: <hdgperceived> deg } { Truth: Vel: <|v|actual> m/s Hdg: <hdgactual> deg } }
{ Track: { Range: <rangeperceived> m } { Bearing: <brgperceived> deg } { Elevation: <elperceived> deg } }
{ { Truth: Range: <rangeactual> m } { Bearing: <brgactual> deg } { Elevation: <elactual> deg } }
{ Measurement_Error_Sigma: { Range: <SErange> m } { Bearing: <SEbrg>> deg } { Elevation: <SEel> deg } }
{ Type_IDs: [{ <typeid> (<typequality>) }] | Type_ID: <typeid> } { Side_ID: <sideid> } { Signal-To-Noise: <log(S/N)> } { Pixel_Count: <pixel-count> }
{ Frequency: [{ (<flower> <fupper>) }] }
{ Aux_Data: <aux-data> }
{ Measurement_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg \ }
{ State_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg }
{ Residual_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg }
SENSOR_REQUEST_INITIATED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform hosting sensor

<track-target-name>

Valid target name, trackid, or if track pointer is unavailable, ” UNKNOWN”

<name>

Name of sensor requesting change

<name>

Sensor mode name (modes are entered in user input file)

<id>

Track id being modified

Note

Track refers to the perceived target. Truth refers to the actual target.

track-data

Condition

Field

Description

none

<flagtype>

One of:

  • ‘F’ (filtered sensor)

  • ‘M’ (unfiltered sensor)

  • ‘I’ (predefined or pre-briefed)

  • ‘P’ (processed)

  • ‘S’ (static image)

  • ‘V’ (pseudo sensor)

  • ‘U’ (other or unknown)

If the track is a “candidate” track

<flagcandidate>

‘C’

If the track is a false target track

<flagfalse target>

‘F’

If the track location is valid

<flagLV>

‘L’

If the track is 3D

<flag3D>

‘3’

If the track range is valid

<flagRV>

‘R’

If the track bearing is valid

<flagBV>

‘B’

If the track elevation is valid

<flagEV>

‘E’

If the target platform exists {

If the the track location is valid OR the track range AND elevation is valid

<|r|perceived - actual>

Note

The distance is in the NED reference frame.

}

If the track velocity is valid {

<|v|perceived>

<hdgperceived>

If the truth exists {

<|v|actual>

<hdgactual>

} }

If the track location, range, bearing, OR elevation is valid {

If the track range OR location is valid

<rangeperceived>

If the track bearing OR location is valid

<brgperceived>

If the track elevation OR location is valid

<hdgperceived>

If the truth range OR location is valid

<rangeactual>

If the truth bearing OR location is valid

<brgactual>

If the truth elevation OR location is valid

<elactual>

If the track is an unfiltered sensor AND has measurement error {

If the range error is non-zero

<SErange>

The standard error in the range measurement

If the bearing error is non-zero

<SEbrg>

The standard error in the bearing measurement

If the elevation error is non-zero

<SEel>

The standard error in the elevation measurement

} }

If the type IDs are valid AND there are more than one type ID {

For every type ID {

<typeid>

<typequality>

} }

Else (there is only one type ID) {

If the type ID is valid

<typeid>

}

If the side ID is valid

<sideid>

If the signal-to-noise is valid

<S/Nlog>

If the pixel count is valid

<pixel-count>

The pixel count from the image that created the track

Note

This will be zero if not from an image

If the frequency is valid {

<signal-count>

For every signal {

<flower>

<fupper>

The lower bound of the frequency interval

The upper bound of the frequency interval

} }

If the track has auxiliary data

<aux-data>

If specified to print track covariance {

If the measurement covariance is valid

<covarianceM>

The measurement covariance of the track

If the state covariance is valid

<covarianceS>

The state covariance of the track

}

If specified to print the track residual covariance

<covarianceR>

The residual covariance of the track

SENSOR_REQUEST_UPDATED

event_output Signature:

<time> <event> <platform> <track-target-name> sensor: <name> Mode: <name> TrackId: <id> Start_Time: <timestart> Update_Time: <timeupdate> Update_Count: <countupdate> Quality: <trackquality> Domain: <domainspatial> Type: <flagtype><flagcandidate><flagfalse target>
{ Target_Truth: Name: <platformname> Type: <platformtype> Side: <platformside> }
Originator: { <locationLLA> | <locationeci> }
{ Track: { <locationLLA> | <locationeci> } Flags: { <flagLV > }{ <flag3D> }{ <flagRV> }{ <flagBV> }{ <flagEV> } }
{ Truth: { <locationLLA> | <locationeci> } Difference: <|r|perceived - actual> }
{ { Track: Vel: <|v|perceived> m/s Hdg: <hdgperceived> deg } { Truth: Vel: <|v|actual> m/s Hdg: <hdgactual> deg } }
{ Track: { Range: <rangeperceived> m } { Bearing: <brgperceived> deg } { Elevation: <elperceived> deg } }
{ { Truth: Range: <rangeactual> m } { Bearing: <brgactual> deg } { Elevation: <elactual> deg } }
{ Measurement_Error_Sigma: { Range: <SErange> m } { Bearing: <SEbrg>> deg } { Elevation: <SEel> deg } }
{ Type_IDs: [{ <typeid> (<typequality>) }] | Type_ID: <typeid> } { Side_ID: <sideid> } { Signal-To-Noise: <log(S/N)> } { Pixel_Count: <pixel-count> }
{ Frequency: [{ (<flower> <fupper>) }] }
{ Aux_Data: <aux-data> }
{ Measurement_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg \ }
{ State_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg }
{ Residual_Covariance: Major Axis: <major-axis> m Minor Axis: <minor-axis> m Bearing: <brg> deg }
SENSOR_REQUEST_UPDATED Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform hosting sensor

<track-target-name>

Valid target name, trackid, or if track pointer is unavailable, ” UNKNOWN”

<name>

Name of sensor requesting change

<name>

Sensor mode name (modes are entered in user input file)

<id>

Track id being modified

Note

Track refers to the perceived target. Truth refers to the actual target.

track-data

Condition

Field

Description

none

<flagtype>

One of:

  • ‘F’ (filtered sensor)

  • ‘M’ (unfiltered sensor)

  • ‘I’ (predefined or pre-briefed)

  • ‘P’ (processed)

  • ‘S’ (static image)

  • ‘V’ (pseudo sensor)

  • ‘U’ (other or unknown)

If the track is a “candidate” track

<flagcandidate>

‘C’

If the track is a false target track

<flagfalse target>

‘F’

If the track location is valid

<flagLV>

‘L’

If the track is 3D

<flag3D>

‘3’

If the track range is valid

<flagRV>

‘R’

If the track bearing is valid

<flagBV>

‘B’

If the track elevation is valid

<flagEV>

‘E’

If the target platform exists {

If the the track location is valid OR the track range AND elevation is valid

<|r|perceived - actual>

Note

The distance is in the NED reference frame.

}

If the track velocity is valid {

<|v|perceived>

<hdgperceived>

If the truth exists {

<|v|actual>

<hdgactual>

} }

If the track location, range, bearing, OR elevation is valid {

If the track range OR location is valid

<rangeperceived>

If the track bearing OR location is valid

<brgperceived>

If the track elevation OR location is valid

<hdgperceived>

If the truth range OR location is valid

<rangeactual>

If the truth bearing OR location is valid

<brgactual>

If the truth elevation OR location is valid

<elactual>

If the track is an unfiltered sensor AND has measurement error {

If the range error is non-zero

<SErange>

The standard error in the range measurement

If the bearing error is non-zero

<SEbrg>

The standard error in the bearing measurement

If the elevation error is non-zero

<SEel>

The standard error in the elevation measurement

} }

If the type IDs are valid AND there are more than one type ID {

For every type ID {

<typeid>

<typequality>

} }

Else (there is only one type ID) {

If the type ID is valid

<typeid>

}

If the side ID is valid

<sideid>

If the signal-to-noise is valid

<S/Nlog>

If the pixel count is valid

<pixel-count>

The pixel count from the image that created the track

Note

This will be zero if not from an image

If the frequency is valid {

<signal-count>

For every signal {

<flower>

<fupper>

The lower bound of the frequency interval

The upper bound of the frequency interval

} }

If the track has auxiliary data

<aux-data>

If specified to print track covariance {

If the measurement covariance is valid

<covarianceM>

The measurement covariance of the track

If the state covariance is valid

<covarianceS>

The state covariance of the track

}

If specified to print the track residual covariance

<covarianceR>

The residual covariance of the track

SENSOR_TURNED_OFF

event_output Signature:

<time> <event> <platform> sensor: <name> Type: <type>
SENSOR_TURNED_OFF Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform hosting sensor

<name>

Sensor name being affected

<type>

Sensor type (e.g., ATC_SENSOR)

SENSOR_TURNED_ON

event_output Signature:

<time> <event> <platform> sensor: <name> Type: <type>
SENSOR_TURNED_ON Signature Elements

Fields

Description

<time>

The current simulation time

<event>

The event name

<platform>

Name of platform hosting sensor

<name>

Sensor name being affected

<type>

Sensor type (e.g., ATC_SENSOR)