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

.. _ALTERNATE_LOCATIONS_INITIALIZED:

ALTERNATE_LOCATIONS_INITIALIZED
-------------------------------

When an Alternate Locations component initializes the location of an owning platform, this event output will print the relevant information.

Format
======

::

 <time> <event> <platform> Type: <alternate locations type> Draw: <random draw> Sum-Of-Weights: <sum of weights> Location-Index: <location index>
  Reference: <base platform> Location-<location index> <base location>
  Offset ARA Angle: <offset angle> Radius: <offset radius> Altitude: <offset altitude> Heading: <heading>
  Offset LLA: <offset latitude> <offset longitude> <offset altitude> Heading: <heading>
  <location>

Breakdown
=========

<time>
    current simulation time
<event>
    simulation event that occurred
<platform>
    name of the platform being initialized via alternate locations
<alternate locations type>
    "Local"  a location was individually randomized from the listed locations in the platform's alternate_locations block
    "Global"  a location was randomized using a global random draw from the listed locations in the platform's alternate_locations block
    "Reference"  a location was selected to match the index of the location selected for the corresponding base platform
    "Offset"  a location was generated by applying an offset to the location selected for the corresponding base platform
<random draw>
    if the alternate locations type is "Local" or "Global", the random draw that was used to select the platform's location
<sum of weights>
    if the alternate locations type is "Local" or "Global", the sum of the weights of all potential locations in the platform's alternate locations block
<location index>
    if the alternate locations type is "Local", "Global", or "Reference", the 1-based index of the platform's selected location
<base platform>
    name of the platform which is being used as the reference for index ("Reference") or location ("Offset")
<base location>
    the reference platform's selected location
<offset angle>
    the angle from due north of the great-circle-arc offset applied to the base location
<offset radius>
    the length of the great-circle-arc offset applied to the base location
<offset altitude>
    the length of the altitude offset applied to the base location
<offset latitude>
    the latitude offset applied to the base location
<offset longitude>
    the longitude offset applied to the base location
<location>
    the location initialized to the platform via Alternate Locations
<heading>
    the heading initialized to the platform via Alternate Locations

How it Appears in Output
========================

::

 0.00000 ALTERNATE_LOCATIONS_INITIALIZED sam-1 Type: Local Draw: 44.4019 Sum-Of-Weights: 50 Location-Index: 4  \
  LLA: 30:20:00.00n 82:40:00.00w 0 m Heading: 0 deg  \

 0.00000 ALTERNATE_LOCATIONS_INITIALIZED target_1 Type: Offset Location  \
  Reference: sam-1 Location-4 LLA: 30:20:00.00n 82:40:00.00w 0 m  \
  Offset ARA Angle: 0 deg Radius: 20372 m Altitude: 0 m  \
  LLA: 30:31:01.55n 82:40:00.00w 0 m Heading: 0 deg  \

 0.00000 ALTERNATE_LOCATIONS_INITIALIZED target_3 Type: Offset Location  \
  Reference: sam-1 Location-4 LLA: 30:20:00.00n 82:40:00.00w 0 m  \
  Offset LLA: 00:00:00.0n 00:00:00.0e 0 m Heading: 0 deg  \
  LLA: 30:20:00.00n 82:40:00.00w 0 m Heading: 0 deg  \

 0.00000 ALTERNATE_LOCATIONS_INITIALIZED uav-1 Type: Local Draw: 0.0574 Sum-Of-Weights: 1 Location-Index: 1  \
  LLA: 30:30:00.00n 79:00:00.00w 10668 m Heading: 90 deg  \
 
 0.00000 ALTERNATE_LOCATIONS_INITIALIZED uav-2 Type: Reference Location-Index: 1  \
  Reference: uav-1 LLA: 30:30:00.00n 79:00:00.00w 10668 m  \
  LLA: 30:18:42.17n 78:48:39.59w 10668 m Heading: 90 deg  \

How to Show Event Messages
==========================

.. parsed-literal::

  :command:`event_output`
     file replay.evt              # write event messages to file "replay.evt"
     enable ALTERNATE_LOCATIONS_INITIALIZED
  end_event_output