.. _scenarioGroundDownlink:

scenarioGroundDownlink
======================

Overview
--------

This scenario demonstrates how the on-board power system can be used to simulate data down-link that is dependent on access
to specific geographic locations (i.e., ground stations).

.. image:: /_images/static/scenarioGroundDownlink.jpg
   :align: center

This scenario is intended to provide both an overview and a concrete demonstration of the features and interface of
:ref:`GroundLocation`, which represents a specific ground location and computes visibility from that location to spacecraft,
and :ref:`spaceToGroundTransmitter`, which represents a spacecraft-based radio system that requires
visibility to a ground station.

The script is found in the folder ``xmera/examples`` and executed by using::

      python3 scenarioGroundDownlink.py

The scenario is meant to be representative of a small satellite with constant data collection attempting to
downlink data to a ground station located in Boulder, Colorado.

When the simulation completes, the following plots are shown to
demonstrate the data stored, generated, and downlinked.

.. image:: /_images/Scenarios/scenarioGroundPassECI.svg
   :align: center

.. image:: /_images/Scenarios/scenarioGroundPassPolar.svg
   :align: center

.. image:: /_images/Scenarios/scenarioGroundPassRange.svg
   :align: center

.. image:: /_images/Scenarios/scenarioGroundPassBaud.svg
   :align: center

.. image:: /_images/Scenarios/scenarioGroundPassStorage.svg
   :align: center