.. _scenarioGroundLocationImaging:

scenarioGroundLocationImaging
=============================

Overview
--------

This scenario demonstrates imaging a target on the surface of the Earth based on access and attitude error requirements.
Simulated data generated from this image is stored in an on-board storage device and then downlinked to a ground
station.

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

    python3 scenarioGroundLocationImaging.py

The simulation uses :ref:`groundLocation` to create an output message with the desired ground target's inertial
position.  This is fed to the 2D pointing module :ref:`locationPointing` which directs the 3rd body axis to point
towards the target. Once the target is accessible per the :ref:`groundLocation` class' ``accessOutMsg`` and below the
prescribed attitude error from the :ref:`locationPointing` class' ``attGuidOutMsg``, the
:ref:`simpleInstrumentController` sends a ``deviceStatusOutMsg`` to the :ref:`simpleInstrument` to turn the imager on
for a single time step. The :ref:`simpleInstrument` sends this data to a :ref:`partitionedStorageUnit`. The data is
then downlinked using a :ref:`spaceToGroundTransmitter` once a ground station represented by another
:ref:`groundLocation` class is accessible.

A reset of the :ref:`groundLocation` and :ref:`simpleInstrumentController` for the purposes of switching to a new target
after the first one is imaged is also demonstrated.

Illustration of Simulation Results
----------------------------------

::

    show_plots = True

The following plots illustrate the 2D pointing error, access data, image commands, and level of the storage unit.

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

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

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

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