.. _scenarioAttLocPoint:

scenarioAttLocPoint
===================

.. raw:: html

    <iframe width="560" height="315" src="https://www.youtube.com/embed/AQAcHAmxcaU" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Overview
--------

Discusses how to use guidance modules to point a particular spacecraft axis towards an Earth
fixed location, Boulder in this example.
This script sets up a 6-DOF spacecraft which is orbiting the Earth.

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

    python3 scenarioAttLocPoint.py

The simulation uses :ref:`groundLocation` to create an output message with Boulder's inertial
position.  This is fed to the 2D pointing module :ref:`locationPointing` which
directs the 3rd body axis to point towards Boulder.

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

::

    show_plots = True

The following 2 plots illustrate the 2D pointing error and the external attitude control torque vector components.

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

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