CalculCorr

Programme simple déterminant les corrélations entre deux candidats dans une série de sondages.

module

calculCorr

author

Yoann LE BARS

Pour le lancer, il suffit d’exécuter le script nommé « calculCorr.py » situé dans le répertoire « src ». La syntaxe est la suivante :

calculCorr.py [-h] [-v] nomFichierSondages nom_fichier_selectionnes

Avec nomFichierSondages le chemin d’accès au fichier contenant les sondages à analyser (il y en a de disponibles dans le répertoire ressources) et nom_fichier_selectionnes le fichier indiquant les deux candidats à évaluer.

L’option -h (ou –help) produit l’affichage d’un message d’aide et met fin au programme, tandis que l’option -v (ou –version) produit l’affichage de la version du programme et met fin à l’exécution.

Au sujet du coefficient de corrélations de Bravais-Pearson :

https://fr.wikipedia.org/wiki/Corr%C3%A9lation_(statistiques)

Au sujet de la valeur p :

https://fr.wikipedia.org/wiki/Valeur_p

Ce programme est sous contrat de distribution CeCILL v2.1. Vous pouvez le modifier et le redistribuer, à la condition que vous en citiez l’auteur original et que vous ne changez pas le contrat de distribution.

Le texte complet du contrat est disponible dans le fichier « LICENSE » et à l’adresse suivante :

https://cecill.info/licences/Licence_CeCILL_V2.1-fr.html

calculCorr.traitement(nom_fichier_sondages: os.PathLike, lst_candidats: List[str]) → Tuple[float, float]

Calcul la corrélation entre deux candidats.

Paramètres

  • nom_fichier_sondages (os.PathLike) – Chemin d’accès vers le fichier contenant les sondages.

  • lst_candidats (list) – Liste des candidats à analyser.

Renvoie

La correlation de Pearson et la valeur p.

Type renvoyé

tuple

Lève

  • FichierInexistant – Si jamais le chemin d’accès au fichier des sondages est incorrect.

  • IntentionInvalide – Si jamais une intention de vote n’est pas exprimée sous forme de nombre à virgule flottante.

  • IntentionHorsLim – Si jamais une intention de vote est inférieure à 0 % ou supérieure à 100 %.

  • NomInexistant – Si jamais un des noms de candidats donnés est introuvable.