Mapytex/documentation/source/index.rst

.. Mapytex documentation master file, created by
   sphinx-quickstart on Thu Apr 23 10:44:48 2015.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Karibou dans la documentation de Mapytex
========================================

Mapytex est un ensemble de modules écris en Python qui vise à faciliter et automatiser la conception d'exercices de math et leurs corrections. 

C'est le moteur qui va permettre à `Opytex <../opytex/>`_ de manipuler les données créer pour faire ces exercices. Il est capable de créer aléatoirement des expressions (calculs de fractions, polynomes, expressions littérales...), des données statistiques et bientôt des figures géométriques, de les simplifier et de faire des calculs avec.

À la difference d'un logiciel de calcul formel classique (comme `sympy <sympy.org>`_), Mapytex va non seulement être capable de simplifier des calculs mais surtout d'expliquer comme un élève les étapes qui permettent d'arriver au résultat.

Le module est séparé en 3 parties:

- *calculus*: Cette partie gère les expressions mathématiques et leurs calculs.

  Voici un exemple de création d'un exercice calculatoire avec des fractions.

  .. code-block:: python

        >>> from pymath import Expression
        >>> ajout_fraction = Expression.random("{a} + {b} / {c}")
        >>> print(ajout_fraction)
        2 + \frac{ 3 }{ 5 }
        >>> for i in ajout_fraction.simplify().explain():
                print(i)
        1 + \frac{ 3 }{ 5 }
        \frac{ 1 \times 5 }{ 1 \times 5 } + \frac{ 3 \times 1 }{ 5 \times 1 }
        \frac{ 5 }{ 5 } + \frac{ 3 }{ 5 }
        \frac{ 5 + 3 }{ 5 }
        \frac{ 8 }{ 5 }

  Ce qui donne une fois compilé avec Latex

    .. math::
        \begin{align*}
            1 + \frac{ 3 }{ 5 } \\
            \frac{ 1 \times 5 }{ 1 \times 5 } + \frac{ 3 \times 1 }{ 5 \times 1 } \\
            \frac{ 5 }{ 5 } + \frac{ 3 }{ 5 } \\
            \frac{ 5 + 3 }{ 5 } \\
            \frac{ 8 }{ 5 }
        \end{align*}

  Pour en savoir plus: `présentation des outils de calculs <presentation_calculs.html>`_

- *stat*: Cette partie gère la gestion de donnée (création et analyse)

  .. code-block:: python

        >>> from pytmath import Dataset
        >>> w = Dataset.random(10)
        >>> w
        [-0.14, 0.3, -0.55, 1.02, -2.02, -1.17, 1.47, 1.22, -1.38, 0.02]
        >>> w.mean()
        -0.12

  Pour en savoir plus: `présentation des outils stat <presentation_stat.html>`_

- *geometry*: (non faite) Cette partie gère la création de situations géométriques.

Sommaire:

.. toctree::
   :maxdepth: 2

   presentation_calculs
   presentation_stat
   construction
   polynom
   code/pymath



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

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