boinor.core.sensors
===================

.. py:module:: boinor.core.sensors


Functions
---------

.. autoapisummary::

   boinor.core.sensors.min_and_max_ground_range
   boinor.core.sensors.ground_range_diff_at_azimuth


Module Contents
---------------

.. py:function:: min_and_max_ground_range(h, eta_fov, eta_center, R)

   Calculates the minimum and maximum values of ground-range angles.

   :param h: Altitude over surface.
   :type h: float
   :param eta_fov: Angle of the total area that a sensor can observe.
   :type eta_fov: float
   :param eta_center: Center boresight angle.
   :type eta_center: float
   :param R: Attractor equatorial radius.
   :type R: float

   :returns: * **lambdaBig_min** (*float*) -- Minimum value of latitude and longitude.
             * **lambdaBig_max** (*float*) -- Maximum value of latitude and longitude.

   .. rubric:: Notes

   For further information, please take a look at :cite:t:`Vallado2013`, pages 853-860.


.. py:function:: ground_range_diff_at_azimuth(h, eta_fov, eta_center, beta, phi_nadir, lambda_nadir, R)

   Calculates the difference in ground-range angles from the eta_center angle and the latitude and longitude of the target
   for a desired phase angle, beta, used to specify where the sensor is looking.

   :param h: Altitude over surface.
   :type h: float
   :param eta_fov: Angle of the total area that a sensor can observe.
   :type eta_fov: float
   :param eta_center: Center boresight angle.
   :type eta_center: float
   :param beta: Phase angle, used to specify where the sensor is looking.
   :type beta: float
   :param phi_nadir: Latitude angle of nadir point.
   :type phi_nadir: float
   :param lambda_nadir: Longitude angle of nadir point.
   :type lambda_nadir: float
   :param R: Earth equatorial radius.
   :type R: float

   :returns: * **delta_lambda** (*float*) -- The difference in ground-range angles from the eta_center angle.
             * **phi_tgt** (*float*) -- Latitude angle of the target point.
             * **lambda_tgt** (*float*) -- Longitude angle of the target point.

   .. rubric:: Notes

   For further information, please take a look at :cite:t:`Vallado2013`, pages 853-860.