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, η_fov, η_center, R)

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

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

   :returns: * **Λ_min** (*float*) -- Minimum value of latitude and longitude.
             * **Λ_max** (*float*) -- Maximum value of latitude and longitude.

   .. rubric:: Notes

   For further information, please take a look at "Fundamentals of Astrodynamics and Applications", 4th ed (2013)"
   by David A. Vallado, pages 853-860.


.. py:function:: ground_range_diff_at_azimuth(h, η_fov, η_center, β, φ_nadir, λ_nadir, R)

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

   :param h: Altitude over surface.
   :type h: float
   :param η_fov: Angle of the total area that a sensor can observe.
   :type η_fov: float
   :param η_center: Center boresight angle.
   :type η_center: float
   :param β: Phase angle, used to specify where the sensor is looking.
   :type β: float
   :param φ_nadir: Latitude angle of nadir point.
   :type φ_nadir: float
   :param λ_nadir: Longitude angle of nadir point.
   :type λ_nadir: float
   :param R: Earth equatorial radius.
   :type R: float

   :returns: * **delta_λ** (*float*) -- The difference in ground-range angles from the eta_center angle.
             * **φ_tgt** (*float*) -- Latitude angle of the target point.
             * **λ_tgt** (*float*) -- Longitude angle of the target point.

   .. rubric:: Notes

   For further information, please take a look at "Fundamentals of Astrodynamics and Applications", 4th ed (2013)"
   by David A. Vallado, pages 853-860.