: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.
.. ****************************************************************************

track
-----

.. command:: track ... end_track
    :block:

    .. parsed-literal::

     track
        position_ ...
        mgrs_coordinate_ ...
        altitude_ ...
        range_ ...
        bearing_ ...
        elevation_ ...
        speed_ ...
        heading_ ...
        type_ ...
        side_ ...
        spatial_domain_ ...
        frequency_ ...
        platform_ ...
        :command:`_.aux_data`... end_aux_data
     end_track

Overview
========

The :command:`track` block is a subcommand of :command:`platform` or :command:`track_manager` that defines an initial track (or perception) of another object. Multiple track blocks may be specified in a given platform. Commands should only be specified for those attributes that are perceived to be known. All other attributes should be omitted.

If no track location is explicitly specified using position_, mgrs_coordinate_, range_, or bearing_, the truth location of the target platform_, if one is provided, will be used to initially populate the location data in the track.

.. note::
   The position_ and mgrs_coordinate_ commands are mutually exclusive with range_ and bearing_.

Commands
========

.. command:: position <latitude-value> <longitude-value>

   Perceived position of the object.

.. command:: mgrs_coordinate <MGRS-value>

   Perceived coordinates of the object in the Military Grid Reference System.

.. command:: altitude <length-value> [ agl | msl ]

   Perceived altitude of the object.  **agl** (above ground level) and **msl** (above mean sea level) specify the reference for the altitude specification.  If the reference specification is omitted then **msl** is assumed.

.. command:: range <length-value>

   Perceived range to the object from the initial position of the tracking platform.

.. command:: bearing <angle-value>

   Perceived bearing to the object from the initial position of the tracking platform.

.. command:: elevation <angle-value>

   Perceived elevation of the object from the initial position of the tracking platform.

.. command:: speed <speed-value>

   Perceived speed of the object.

.. command:: heading <angle-value>

   Perceived heading of the object.

.. command:: type <platform-type>

   Perceived type of the object.

.. command:: side <side-name>

   Perceived side ("team' or "affiliation') of the object.

.. command:: spatial_domain [ land | air | surface | subsurface | space ]

   Defines the perceived spatial domain of the object.

.. command:: frequency <frequency>

   Perceived frequency of the object.

.. command:: platform <platform-name>

   The platform whose truth location to use when initially populating the location data in the track, if no location is specified. The platform must be defined prior to the track.

   .. warning::
      Input file order dependency!