.. _scenarioCentralBody:

scenarioCentralBody
===================

Overview
--------

This script sets up a basic spacecraft in orbit about Earth. One option uses ``earth.isCentralBody = True``
and the other uses ``isCentralBody = False``. The nuances of spacecraft position and velocity I/O in these cases are
demonstrated.

.. image:: /_images/static/test_scenarioBasicOrbit.svg
   :align: center

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

    python3 scenarioCentralBody.py

.. note:: This script is a good reference for configuring the following modules:

          * :ref:`spacecraft`
          * :ref:`gravityEffector`


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

Running this example script will yield the following results.

::

    show_plots = True, useCentral = False

.. figure:: /_images/Scenarios/scenarioCentralBody10.svg
   :align: center

.. figure:: /_images/Scenarios/scenarioCentralBody20.svg
   :align: center

::

    show_plots = True, useCentral = True

.. figure:: /_images/Scenarios/scenarioCentralBody11.svg
   :align: center

.. figure:: /_images/Scenarios/scenarioCentralBody21.svg
   :align: center