.. _scenarioGroundMapping:

scenarioGroundMapping
=====================

Overview
--------

This scenario demonstrates mapping several points on the surface of the Earth.

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

    python3 scenarioGroundMapping.py

The simulation uses :ref:`groundMapping` to check if a spacecraft has access to any of the mapping points defined on the
surface of the Earth. For each mapping point, a :ref:`accessMsgPayload` is output to the :ref:`mappingInstrument` module,
which images the mapping points and sends the simulated data to a :ref:`partitionedStorageUnit`. While this is not
representative of the total amount of data collected during mapping, it does store which points have and have not been
mapped, which is useful for many operations problems. It is suggested that the user adds a :ref:`simpleInstrument` and
:ref:`simpleStorageUnit` if they desire to realistically capture how much data was actually collected.

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

::

    show_plots = True

The following plots illustrate the attitude error of the spacecraft, a 3D view of the spacecraft trajectory and the mapping
points expressed in the planet-centered, planet-fixed frame, and the number of points stored in the data buffer.

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

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

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