Background
==============

Comparaison Matlab - Python
--------------------------

C'est la fonction principale de calcul du fond de ciel. Les résultats sont légèrement différents de ceux données par le programme originel en Matlab. Prenons par exemple la donnée suivante : 

* a=[3, 4, 3, 5, 2, 5, 4, 3, 1, 2, 3, 1, 2, 4, 5, 2, 1, 2, 3, 6, 5, 4, 2, 1, 5, 3, 2, 1, 4, 3, 2, 1, 4, 2, 2, 3, 6]

Pour une régression linéaire d'ordre 1, nous obtenons les résultats suivants, en fonction de la fonction utilisé : 

.. csv-table:: Comparaison des valeurs de polifit entre Python et Matlab
   :header: "Fonction utilisée", "x0", "x1", "x0 error", "x1 error"
   :widths: 50, 20, 20, 20, 20

   "Matlab polyfit", "-0.0085", "3.1622", "", ""
   "Matlab fitlm", "-0.0085349", "3.1622", "0.022941", "0.49998"
   "Matlab fit", "-0.0085", "3.1622", "0.0229", "0.5"
   "Python numpy polyfit", "-0.00853485", "3.16216216", "0.02294058", "0.49997666"

A noter que la fonction polyfit de Matlab ne permet pas de calculer directement l'erreur. 

Dans le cas de l'utilisation d'une fonction de poids, les outils Matlab ne permettent pas de calculer la régression polynomiale, alors qu'elle est possible avec Python et la librairie Numpy. Pour tester cela, prenons les valeurs suivantes (même que "a", sauf une valeur qui a été changée de 1 à 100): 

* b=[3, 4, 3, 5, 2, 5, 4, 3, 1, 2, 3, 100, 2, 4, 5, 2, 1, 2, 3, 6, 5, 4, 2, 1, 5, 3, 2, 1, 4, 3, 2, 1, 4, 2, 2, 3, 6]

.. csv-table:: Comparaison des valeurs de polifit entre Python et Matlab, avec l'utilisation d'une fonction de poids (racine carrée du signal)
   :header: "Fonction utilisée", "x0", "x1", "x0 error", "x1 error"
   :widths: 50, 20, 20, 20, 20

   "Matlab fit", "-0.0244", "2.8749", "0.0249", "0.5597"
   "Python numpy polyfit", "-0.02438482", "2.87488398", "0.0213165", "1.08084752"

Main functions
--------------

.. autofunction:: SignalCreation.Pretreatment.Background.get_sky_background

.. autofunction:: SignalCreation.Pretreatment.Background.apply_pretreatment

Specific sky background functions
---------------------------------

.. autofunction:: SignalCreation.Pretreatment.Background.background_process



Tools functions
---------------

.. autofunction:: SignalCreation.Pretreatment.Background.check_mandatory_parameters

.. autofunction:: SignalCreation.Pretreatment.Background.value_to_pint