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

WSF_EXOATMOSPHERIC_LETHALITY
============================

.. model:: weapon_effects WSF_EXOATMOSPHERIC_LETHALITY
   
.. parsed-literal::

   :command:`weapon_effects` <name> :model:`WSF_EXOATMOSPHERIC_LETHALITY`
     ... :command:`weapon_effects` Commands ...
     ... :model:`WSF_EXPLICIT_WEAPON_EFFECTS` Commands ...
     ... WSF_EXOATMOSPHERIC_LETHALITY_ Commands_ ...
   end_weapon_effects

Overview
--------

WSF_EXOATMOSPHERIC_LETHALITY_ computes lethality using a probability of kill (Pk) versus impact velocity and/or
impact angle.  If a Pk table is missing for the impact velocity or impact angle independent variable, that particular
contribution is assumed to be 1.0, and the remaining contributor is the only effect.  The tables are interpolated but
not extrapolated past the specified endpoints.

This lethality type is not compatible with :command:`weapon_effects` commands use_launch_pk, launch_pk, or intercept_pk
commands, and if specified, the input parsing will fail.

.. block:: WSF_EXOATMOSPHERIC_LETHALITY

Commands
--------

.. warning::

   The following :command:`weapon_effects` commands are not compatible with WSF_EXOATMOSPHERIC_LETHALITY.  Use of these commands will result in an input processing error.
   
   * :command:`weapon_effects.intercept_pk`
   * :command:`weapon_effects.launch_pk`
   * :command:`weapon_effects.use_launch_pk`
   
.. command:: impact_angle_and_pk <angle-value> <pk-value>
   
   Specify an entry in the Pk versus impact angle interpolation table.  Any number of entries may be made.  Constraints
   are zero to 180 degrees.

.. command:: impact_velocity_and_pk <speed-value> <pk-value>
   
   Specify an entry in the Pk versus impact velocity interpolation table.  Any number of entries may be made.  Impact
   velocity must be greater than zero.