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>
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:
|
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:
|
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>
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:
|
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:
|
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.
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
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
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>
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 }
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:
|
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 }
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:
|
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>
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>
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) |