.. Orbiter documentation master file, created by
   sphinx-quickstart on Mon Dec 10 18:04:47 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Documentation du Module  Orbiter
================================

Contents:

.. toctree::
   :maxdepth: 2

Présentation générale
=====================

Le module Orbiter basé sur le language Python, permet l'intégration numérique
des trajectoires spatiales.
* La class *Launcher* permet de modéliser un lanceur à partir de plusieurs éléments *Stage*.
* La class *Stage* modélise un étage et son moteur grace à son ISP et son débit.
* La class *Capsule* est une modélisation simple permettant de spécifier directement le delta_v d'une manoeuvre.

Ces trois class sont équivalente mais ne présente pas le même niveau de
modélisation. Elles sont basées sur 
l'intégration des lois de Newton dans le repère géocentrique en coordonnées
polaire  :math:`(r,\theta)`.

.. image:: https://hpp.education/Lessons/MecaSpace/RepereLanceur.jpg

Le système représenté est basé sur l'influence gravitationaelle d'un corps
principal et d'un corps secondaire (généralement le satellite le plus massif).
Le corp secondaire est placé initialement en :math:`\theta_L=\pi/2` et se déplace sur son orbite
circulaire dans le sens anti-horaire. Le système peut être changé en utilisant
la fonction planet(nom).

Les équations du mouvement intégrées dans la méthode integtraj() sont les suivantes:

.. math::
    m(\ddot{r}-r\dot{\theta}^2) = -P+(F_d-F_t)\sin(\gamma_e)+F_l\cos(\gamma_e)\\
    m(r\ddot{\theta}+2\dot{r}\dot{\theta}) = (F_t-F_d)\cos(\gamma_e)+F_l\sin(\gamma_e)

Notations:
:math:`F_t`: Poussée (N)

:math:`F_d`: Trainée (N).

:math:`F_l`: Portance (N).
:math:`P`: Poid (N).
:math:`\gamma_e`: Angle entre la trajectoire et l'horizontal local.
:math:`\omega` Angle de manouvre.
:math:`\Delta U` Différentielle de vitesse de la manoeuvre.

La Class SpaceDevice
====================

.. autoclass:: Orbiter.Spacedevice
   :special-members:
   :undoc-members:
   :members:
   :show-inheritance:

La Class Stage
==============

.. autoclass:: Orbiter.Stage
   :special-members:
   :undoc-members:
   :members:
   :show-inheritance:

La Class Launcher
=================

.. autoclass:: Orbiter.Launcher
   :special-members:
   :undoc-members:
   :members:
   :show-inheritance:

La Class Capsule
================

.. autoclass:: Orbiter.Capsule
   :members:
   :undoc-members:
   :show-inheritance:
   :special-members:

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`