: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_SURFACE_WAVE_RADAR_SENSOR
-----------------------------

.. model:: sensor WSF_SURFACE_WAVE_RADAR_SENSOR

    .. parsed-literal::
     sensor *<name>* :model:`WSF_SURFACE_WAVE_RADAR_SENSOR`
        ... :ref:`Platform_Part_Commands` ...
        ... :ref:`Articulated_Part_Commands` ...
        ... :ref:`sensor Commands <Sensor.Commands>` ...
        mode *<name>*
           ... :ref:`Sensor Mode Commands <Sensor.Common_Mode_Commands>`...
           ... :ref:`WSR_RADAR_SENSOR Beam Commands <WSF_RADAR_SENSOR.Beam_Commands>` ...
           ... WSF_SURFACE_WAVE_RADAR_SENSOR Commands_ ...
        end_mode
     end_sensor

Overview
========

:model:`WSF_SURFACE_WAVE_RADAR_SENSOR` implements an over-the-horizon radar that relies on the propagation of RF energy along the earth's surface (i.e., does not rely on ionosphere backscatter).

The detection capability of these radars are driven by external noise.  This noise consists of galactic, atmospheric and man-made noise.  The galactic noise is a function of the operating frequency of the radar.  The atmospheric noise is a function of the radar's operating location, season and time of day.  The man-made noise is a function of the man-made environment near the radar location.  The sensor will use the simulation's date and time, as specified in :ref:`Simulation_Control_Commands` to determine the appropriate atmospheric noise.

The ground-wave propagation is a C++ port of the GRWAVE FORTRAN code available from the International Telecommunication Union, Radiocommunication Sector, Study Group 3 (Radiowave propagation).  The GRWAVE program and documentation can be retrieved from http://www.itu.int/ITU-R/index.asp?category=documents&link=rsg3%E2%8C%A9=en.

.. block:: WSF_SURFACE_WAVE_RADAR_SENSOR

Commands
========

.. command:: transmitter  ... end_transmitter
   :block:

   A :command:`_.transmitter` block that defines the properties of the transmitter.  There is a unique propagation model for
   surface wave radar sensors.

   .. command:: propagation_model groundwave_propagation ... end_propagation_model

      .. command:: relative_permittivity <number>

         The relative permittivity of the surface of the earth.

         **Default:** 70.0 (sea)

      .. command:: conductivity <number>

         The conductivity of the earth's surface (Siemens/meter).

         **Default:** 5.0

      .. command:: troposphere_refractivity <number>

         The refractivity of the troposphere at the surface of the earth (N-units).

         **Default:** 315.0

      .. command:: troposphere_height_scale <length-value>

         The scale height of the troposphere.

         **Default:** 7.35 km

      .. command:: minimum_computation_distance <length-value>

         The minimum distance from the radar that propagation will be computed for.

         **Default:** 10.0 km

      .. command:: computation_distance_interval <length-value>

         The distance interval between cell centers for propagation computation.

         **Default:** 10.0 km

.. command:: noise_environment [ business | residential | rural | quiet_rural ]

   Defines the man-made noise environment that the sensor operates in.

   **Default:** quiet_rural