:orphan:
.. ****************************************************************************
.. CUI
..
.. The Advanced Framework for Simulation, Integration, and Modeling (AFSIM)
..
.. The use, dissemination or disclosure of data in this file is subject to
.. limitation or restriction. See accompanying README and LICENSE for details.
.. ****************************************************************************
.. _emi-data:
emi-data
--------
This is documentation for the <**emi-data**> field referenced in the :command:`csv_event_output` and :command:`event_output` documentation.
.. contents::
:local:
:depth: 1
.. include:: event/print_location_data_format.txt
.. include:: event/print_non_location_data_format.txt
.. |CSV_ABSOLUTE_LOCATION_DATA| replace:: <platform\ :sub:`type`\ >,
|CSV_LOCATION_DATA|,
|CSV_NON_LOCATION_DATA|
.. |EVT_ABSOLUTE_LOCATION_DATA| replace:: Type: <platform\ :sub:`type`\ >
|EVT_LOCATION_DATA| |EVT_NON_LOCATION_DATA|
.. |CSV_RELATIVE_LOCATION_DATA| replace:: <range\ :sub:`m`\ >,
<brg\ :sub:`true`\ >,<el\ :sub:`true`\ >,
<brg\ :sub:`apparent`\ >,<el\ :sub:`apparent`\ >
.. |EVT_RELATIVE_LOCATION_DATA| replace:: Range: <range\ :sub:`km`\ > km (<range\ :sub:`nmi`\ > nm)
Brg: <brg\ :sub:`true`\ > El: <el\ :sub:`true`\ > Apparent: Brg: <brg\ :sub:`apparent`\ > El: <el\ :sub:`apparent`\ >
.. |CSV_BEAM_DATA| replace:: <brg\ :sub:`beam point`\ >,<el\ :sub:`beam point`\ >,
<az\ :sub:`beam`\ >,<el\ :sub:`beam`\ >,
<az\ :sub:`beam EBS`\ >,<el\ :sub:`beam`\ >,<omega\ :sub:`A`\ >,
<gain>
.. |EVT_BEAM_DATA| replace:: Brg: <brg\ :sub:`beam point`\ > deg El: <el\ :sub:`beam point`\ > deg
TgtRel Az: <el\ :sub:`beam`\ > deg El: <el\ :sub:`beam`\ > deg
EBS Az: <az\ :sub:`beam EBS`\ > deg El: <el\ :sub:`beam EBS`\ > Omega: <omega\ :sub:`A`\ > deg
Gain: <log(gain)> dB
.. |CSV_OTHER_DATA| replace:: { ,<log(signature\ :sub:`radar`\ )>,<signature\ :sub:`radar`\ >,<az\ :sub:`radar`\ >,<el\ :sub:`radar`\ > | ,,,, }
{ ,<log(signature\ :sub:`optical`\ )>,<signature\ :sub:`optical`\ >,<az\ :sub:`optical`\ >,<el\ :sub:`optical`\ >, { <reflectivity\ :sub:`optical`\ > } | ,,,,, }
{ ,<signature\ :sub:`infrared`\ >,<az\ :sub:`radar`\ >,<el\ :sub:`radar`\ > { ,<I\ :sub:`BR`\ >,<I\ :sub:`CR`\ >,<F\ :sub:`A`\ > | ,,, } | ,,,,,, }
{ { ,<log(F\ :sub:`A`\ )>,<F\ :sub:`A`\ > | ,, } { ,<log(F\ :sup:`4`\ :sub:`P`\ )>,<F\ :sup:`4`\ :sub:`P`\ >,<F\ :sub:`P`\ > | ,,, },{ <F\ :sub:`M`\ > } | ,,,,,, }
{ ,{ <log(P\ :sub:`T`)> },{ <log(P\ :sub:`R`)> },{ <log(P\ :sub:`RN`)> },{ <log(P\ :sub:`C`)> },{ <log(P\ :sub:`I`)> } { <emi-component-power-data> | ,,, },{ <pixel-count> }
{ ,<log(S/I)>,{ <log(threshold)> } { ,<log(S/N)>,<log(S/(N+C))>,<log(S/(N+C+J))> | ,,, } | ,,,,, } | ,,,,,,,,,,,,,, },
<emi-component-data>,<emi-failures>
.. |EVT_OTHER_DATA| replace:: { Radar_Sig: <log(signature\ :sub:`radar`\ )> dBsm (<signature\ :sub:`radar`\ > m^2) Az: <az\ :sub:`radar`\ > deg El: <el\ :sub:`radar`\ > deg }
{ Optical_Sig: <log(signature\ :sub:`optical`\ )> dBsm (<signature\ :sub:`optical`\ > m^2) Az: <az\ :sub:`optical`\ > deg El: <el\ :sub:`optical`\ > deg Reflectivity: <reflectivity\ :sub:`optical`\ > }
{ { Infrared_Sig: <signature\ :sub:`infrared`\ > w/sr Az: <az\ :sub:`infrared`\ > deg El: <el\ :sub:`infrared`\ > deg }
{ Background_radiant_intensity: <I\ :sub:`BR`\ > w/sr Contrast_radiant_intensity: <I\ :sub:`CR`\ > w/sr Transmittance: <F\ :sub:`A`\ > } }
{ { Absorption_factor: <log(F\ :sub:`A`\ )> dB (<F\ :sub:`A`\ >) }
{ Propagation_factor_F^4: <log(F\ :sup:`4`\ :sub:`P`\ )> dB (<F\ :sup:`4`\ :sub:`P`\ >) F: <F\ :sub:`P`\ > } { Masking_Factor: <F\ :sub:`M`\ > } }
{ { Xmtd_Power: <log(P\ :sub:`T`)> dBw } { Rcvd_Power: <log(P\ :sub:`R`)> dBw } { Rcvr_Noise: <log(P\ :sub:`RN`)> dBw } { Clutter_Power: <log(P\ :sub:`C`)> dBw } { <Label\ :sub:`SNR_Int`\ >: <log(P\ :sub:`I`)> dBw } { <emi-component-power-data> } { Pixel_Count: <pixel-count> }
{ S/I: <log(S/I)> dB { Threshold: <log(threshold)> dB } { S/N: <log(S/N)> dB S/(N+C): <log(S/(N+C))> dB <Label\ :sub:`SNR_Int`\ >: <log(S/(N+C+J))> dB } } }
<emi-component-data>
<emi-failures>
Possible Signatures
===================
*The documentation has the csv_event_output signatures on separate lines for readability. The actual csv_event_output is on a single line.*
.. list-table::
:header-rows: 1
:align: left
:widths: auto
* - Condition
- CSV Signature
- EVT Signature
* - If the EMI is one-way between transmitter and receiver
- | <**absolute-location-data** :sub:`xmtr`\ >,
| <**absolute-location-data** :sub:`rcvr`\ >,
| <**relative-location-data** :sub:`xmtr->rcvr`\ >,
| <**relative-location-data** :sub:`rcvr->xmtr`\ >,
| <**beam-data**\ :sub:`xmtr`\ >,
| <**beam-data**\ :sub:`rcvr`\ >,
| <**other-data**>
- | Xmtr: <**absolute-location-data**\ :sub:`xmtr`\ >
| Rcvr: <**absolute-location-data**\ :sub:`rcvr`\ >
| Xmtr->Rcvr: <**relative-location-data**\ :sub:`xmtr->rcvr`\ >
| Rcvr->Xmtr: <**relative-location-data**\ :sub:`rcvr->xmtr`\ >
| XmtrBeam: <**beam-data**\ :sub:`xmtr`\ >
| RcvrBeam: <**beam-data**\ :sub:`rcvr`\ >
| <**other-data**>
* - If the EMI is one-way between receiver and target
- | <**absolute-location-data**\ :sub:`rcvr`\ >,
| <**absolute-location-data**\ :sub:`tgt`\ >,
| <**relative-location-data**\ :sub:`rcvr->tgt`\ >,
| <**relative-location-data**\ :sub:`tgt->rcvr`\ >,
| <**beam-data**\ :sub:`rcvr`\ >,
| <**other-data**>
- | Rcvr: <**absolute-location-data**\ :sub:`rcvr`\ >
| Tgt: <**absolute-location-data**\ :sub:`tgt`\ >
| Rcvr->Tgt: <**relative-location-data**\ :sub:`rcvr->tgt`\ >
| Tgt->Rcvr: <**relative-location-data**\ :sub:`tgt->rcvr`\ >
| RcvrBeam: <**beam-data**\ :sub:`rcvr`\ >
| <**other-data**>
* - If the EMI is bistatic, two-way between transmitter, receiver, and target
- | <**absolute-location-data**\ :sub:`xmtr`\ >,
| <**absolute-location-data**\ :sub:`rcvr`\ >,
| <**absolute-location-data**\ :sub:`tgt`\ >,
| <**relative-location-data**\ :sub:`xmtr->tgt`\ >,
| <**relative-location-data**\ :sub:`tgt->xmtr`\ >,
| <**relative-location-data**\ :sub:`rcvr->tgt`\ >,
| <**relative-location-data**\ :sub:`tgt->rcvr`\ >,
| <**beam-data**\ :sub:`xmtr`\ >,
| <**beam-data**\ :sub:`rcvr`\ >,
| <**other-data**>
- | Xmtr: <**absolute-location-data**\ :sub:`xmtr`\ >
| Rcvr: <**absolute-location-data**\ :sub:`rcvr`\ >
| Tgt: <**absolute-location-data**\ :sub:`tgt`\ >
| Xmtr->Tgt: <**relative-location-data**\ :sub:`xmtr->tgt`\ >
| Tgt->Xmtr: <**relative-location-data**\ :sub:`tgt->xmtr`\ >
| Rcvr->Tgt: <**relative-location-data**\ :sub:`rcvr->tgt`\ >
| Tgt->Rcvr: <**relative-location-data**\ :sub:`tgt->rcvr`\ >
| XmtrBeam: <**beam-data**\ :sub:`xmtr`\ >
| RcvrBeam: <**beam-data**\ :sub:`rcvr`\ >
| <**other-data**>
* - If the EMI is non-bistatic, two-way between transmitter, receiver, and target
- | <**absolute-location-data**\ :sub:`xmtr/rcvr`\ >,
| <**absolute-location-data**\ :sub:`tgt`\ >,
| <**relative-location-data**\ :sub:`xmtr/rcvr->tgt`\ >,
| <**relative-location-data**\ :sub:`tgt->xmtr/rcvr`\ >,
| <**beam-data**\ :sub:`xmtr/rcvr`\ >,
| <**beam-data**\ :sub:`tgt`\ >,
| <**other-data**>
- | Xmtr/Rcvr: <**absolute-location-data**\ :sub:`xmtr/rcvr`\ >
| Tgt: <**absolute-location-data**\ :sub:`tgt`\ >
| Xmtr/Rcvr->Tgt: <**relative-location-data**\ :sub:`xmtr/rcvr->tgt`\ >
| Tgt->Xmtr/Rcvr: <**relative-location-data**\ :sub:`tgt->xmtr/rcvr`\ >
| XmtrBeam: <**beam-data**\ :sub:`xmtr/rcvr`\ >
| RcvrBeam: <**beam-data**\ :sub:`tgt`\ >
| <**other-data**>
To :ref:`Top of Page<emi-data>`
Signature Elements
==================
Expanded Compound Signature Elements
************************************
Compound signature elements encapsulate related signature elements and appear in bold. These are included to improve readability of the documentation.
.. list-table::
:header-rows: 1
:align: left
:widths: auto
* - Field
- CSV
- EVT
* - <**absolute-location-data**>
- |CSV_ABSOLUTE_LOCATION_DATA|
- |EVT_ABSOLUTE_LOCATION_DATA|
* - <**relative-location-data**>
- |CSV_RELATIVE_LOCATION_DATA|
- |EVT_RELATIVE_LOCATION_DATA|
* - <**beam-data**>
- |CSV_BEAM_DATA|
- |EVT_BEAM_DATA|
* - <**location**\ :sub:`LLA`\ >
- |CSV_LOCATION_LLA|
- |EVT_LOCATION_LLA|
* - <**location**\ :sub:`ECI`\ >
- |CSV_LOCATION_ECI|
- |EVT_LOCATION_ECI|
* - <**orientation**>
- |CSV_ORIENTATION|
- |EVT_ORIENTATION|
* - <**velocity**\ :sub:`NED`\ >
- |CSV_VELOCITY_NED|
- |EVT_VELOCITY_NED|
* - <**velocity**\ :sub:`ECI`\ >
- |CSV_VELOCITY_ECI|
- |EVT_VELOCITY_ECI|
* - <**acceleration**\ :sub:`NED`\ >
- |CSV_ACCELERATION_NED|
- |EVT_ACCELERATION_NED|
* - <**acceleration**\ :sub:`ECI`\ >
- |CSV_ACCELERATION_ECI|
- |EVT_ACCELERATION_ECI|
<**other-data**> includes a variety of signature elements. It may be further sub-divided in the future.
.. list-table::
:header-rows: 1
:align: left
:widths: auto
* - Field
- CSV
- EVT
* - <**other-data**>
- |CSV_OTHER_DATA|
- |EVT_OTHER_DATA|
To :ref:`Top of Page<emi-data>`
Conditional Signature Elements
******************************
<relative-location-data>
^^^^^^^^^^^^^^^^^^^^^^^^
.. table::
:align: left
:widths: auto
================================================================================ ================================================================================ ================================================================================
Field Condition Description
================================================================================ ================================================================================ ================================================================================
<range\ :sub:`unit`\ > [1]: If the range > 0.0 The distance between the source and destination system (in the specified units, denoted with the subscript).
<brg\ :sub:`true`\ > The direction based off the true unit vector in azimuth/elevation.
<el\ :sub:`true`\ >
<brg\ :sub:`apparent`\ > [1]: AND If the earth radius scale != 1.0 The direction based off the apparent unit vector in azimuth/elevation.
<el\ :sub:`true`\ >
================================================================================ ================================================================================ ================================================================================
<beam-data>
^^^^^^^^^^^
.. table::
:align: left
:widths: auto
================================================================================ ================================================================================ ================================================================================
Field Condition Description
================================================================================ ================================================================================ ================================================================================
<brg\ :sub:`beam point`\ > [1]: If the gain >= 0.0 The direction the beam is pointing in azimuth/elevation.
<el\ :sub:`beam point`\ >
<brg\ :sub:`beam`\ > The direction of the target with respect to the beam in azimuth/elevation.
<el\ :sub:`beam`\ >
{ [2]: [1] AND If the gain > 0.0
<brg\ :sub:`beam EBS`\ > [2] AND If the antenna is in EBS mode The direction of the beam with respect to the antenna face in azimuth/elevation.
<el\ :sub:`beam EBS`\ >
<omega\ :sub:`A`\ > The solid angle that the antenna beam makes with the antenna face.
<gain> [2] The beam gain.
<log(gain)>
}
================================================================================ ================================================================================ ================================================================================
<other-data>
^^^^^^^^^^^^
.. table::
:align: left
:widths: auto
================================================================================ ================================================================================ ================================================================================
Field Condition Description
================================================================================ ================================================================================ ================================================================================
<log(signature\ :sub:`radar`\ )> [1] If the radar signature > 0.0
<signature\ :sub:`radar`\ >
<az\ :sub:`radar`\ >
<el\ :sub:`radar`\ >
<log(signature\ :sub:`optical`\ )> [2] If the optical signature > 0.0
<signature\ :sub:`optical`\ >
<az\ :sub:`optical`\ >
<el\ :sub:`optical`\ >
<reflectivity\ :sub:`optical`\ > [2] AND If the optical reflectivity > 0.0
<signature\ :sub:`infrared`\ > [3] If the infrared signature > 0.0
<az\ :sub:`infrared`\ >
<el\ :sub:`infrared`\ >
<I\ :sub:`BR`\ > [4] If the signal-to-noise > 0.0
<I\ :sub:`CR`\ >
<I\ :sub:`F`\ >
{ [5] If the absorption factor > 0.0 OR
the propagation factor > 0.0 OR
0.0 <= masking factor < 1.0
<log(F\ :sub:`A`\ )> [5] AND If the absorption factor > 0.0
<F\ :sub:`A`\ >
<log(F\ :sup:`4`\ :sub:`P`\ )> [5] AND If the propagation factor > 0.0
<F^4\ :sup:`4`\ :sub:`P`\ >
<F\ :sub:`P`>
<F\ :sub:`M`\ > [5] AND If 0.0 <= masking factor < 1.0
}
{
[6] If the transmitted power > 0.0 OR
the received power > 0.0 OR
the pixel count > 0.0 OR
the signal-to-noise > 0.0
<log(P\ :sub:`T`\ )> [6] AND If the transmitted power > 0.0
<log(P\ :sub:`R`\ )> [6] AND If the received power > 0.0
<log(P\ :sub:`RN`\ )> [6] AND If the receiver noise power > 0.0
<log(P\ :sub:`C`\ )> [6] AND If the clutter power > 0.0
<log(P\ :sub:`I`\ )> [6] AND If the interference power > 0.0
<emi-component-powers-data> [7] For each emi-component Power data associated with specific components.
.. note::
Actual output may vary.
<count\ :sub:`pixel`\ > [8] If the pixel count > 0.0 The approximate number of pixels the target occupies in the image.
<emi-component-data> Other data associated with specific components.
.. note::
Actual output may vary.
<emi-failure> [9] If any failure occurred The failure strings, which can be one or more of the following:
* Xmtr_Range_Limits_Exceeded
* Rcvr_Range_Limits_Exceeded
* Xmtr_Altitude_Limits_Exceeded
* Rcvr_Altitude_Limits_Exceeded
* Xmtr_Angle_Limits_Exceeded
* Rcvr_Angle_Limits_Exceeded
* Xmtr_Masked_By_Horizon
* Rcvr_Masked_By_Horizon
* Xmtr_Masked_By_Terrain
* Rcvr_Masked_By_Terrain
* Insufficient_Signal
================================================================================ ================================================================================ ================================================================================
To :ref:`Top of Page<emi-data>`