Utilitaires

Ensemble de fonctions utilitaires pour l’analyse de sondages.

module

utilitaires

author

Yoann LE BARS

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

class utilitaires.TripletErreur(jour, a, b)
a

Alias for field number 1

b

Alias for field number 2

jour

Alias for field number 0

utilitaires.calcul_duree(debut: datetime.datetime, fin: datetime.datetime, colonne: int, nom_fichier: os.PathLike) → datetime.timedelta

Fonction calculant la durée d’un sondage.

Paramètres

  • debut (datetime) – Jour de démarrage du sondage.

  • fin (datetime) – Jour de fin du sondage.

  • colonne (int) – Colonne du fichier de données en cours de traitement.

  • nom_fichier (os.PathLike) – Nom du fichier en cours de traitement.

Renvoie

La durée du sondage.

Type renvoyé

timedelta

Lève

FinAvantDebut – Si jamais la date de fin est antérieur à la date de début.

utilitaires.converti_echantillon(t: str, nom_fichier: os.PathLike, liste_echantillons: list) → int

Fonction convertissant une chaîne de caractères en taille d’échantillon sous forme d’un entier et gérant les erreurs.

Paramètres

  • t (str) – La chaine de caractère à convertir.

  • nom_fichier (str) – Nom du fichier en cours de traitement.

  • liste_echantillons (list[str]) – Liste de tous les échantillons.

Renvoie

La taille de l’échantillon.

Type renvoyé

int

Lève
utilitaires.extrapole(w: numpy.ndarray, durees: list, jours_dispo: numpy.ndarray, intentions: numpy.ndarray)

Extrapole les intentions de votes pour un candidat donné et affiche la courbe associée.

Paramètres

  • w (np.ndarray) – Liste des inverses des écarts types pour chaque sondage.

  • durees (list[timedelta]) – Liste des durées des sondages.

  • jours_dispo (np.ndarray) – Liste des jours disponibles pour le candidat courant.

  • intentions (np.ndarray) – Listes des intentions de vote pour le candidat courant.

Renvoie

Série extrapolée des intentions de vote.

utilitaires.format_corr(nom_fichier_sondages: os.PathLike, candidat1: str, candidat2: str) → str

Formate les chaînes de caractères pour la sortie des corrélations et valeurs p.

Paramètres

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

  • candidat1 (str) – Nom du premier candidat à tester.

  • candidat2 (str) – Nom du deuxième candidat à tester.

Renvoie

Une chaîne de caractères proprement formatée contenant corrélation et valeur p.

Type renvoyé

str

utilitaires.selectionne_ligne(evenement)

Gestion de l’évènement lorsque que l’utilisateur sélectionne une ligne de la légende.

Paramètres

evenement – Descripteur de l’évènement.

utilitaires.selectionne_point(label: str)

Gestion de l’évènement lorsque l’utilisateur sélectionne un point de la liste des candidats.

Paramètres

label (str) – Label de la case cochée.

utilitaires.traite_date(chaine_valeur: str, nom_fichier: os.PathLike, ligne: int, colonne: int) → numpy.datetime64

Convertit une chaîne de caractères en une date et renvoie une erreur en cas de format invalide.

Paramètres

  • chaine_valeur (str) – La chaîne de caractères à convertir.

  • nom_fichier (os.PathLike) – Chemin d’accès au fichier contenant les intentions de votes.

  • ligne (int) – Indice de la ligne courante.

  • colonne (int) – Indice de la colonne courante.

Renvoie

La date sous forme de datetime.

Type renvoyé

np.datetime64

Lève

JourInvalide – Si jamais une date n’est pas renseignée sous forme d’une chaîne de caractères valide.

utilitaires.traite_intentions(q: float, nom_fichier: os.PathLike, nom_candidat: str, ligne: List[str], t_ech: numpy.array) → Tuple[numpy.array, numpy.array, numpy.array]

Traite les intentions de vote envers un candidat.

Paramètres

  • q (float) – Coefficient pour le calcul de l’intervalle de confiance.

  • nom_fichier (os.PathLike) – Chemin d’accès au fichier en cours de traitement.

  • nom_candidat (str) – Nom du candidat en cours de traitement.

  • ligne (list[str]) – Contenu de la ligne en cours de traitement.

  • t_ech (list) – Liste des tailles d’échantillon.

Renvoie

Les arrays complétées des intentions de votes, des inverses des écarts-types des sondages et des intervalles de confiances.

Type renvoyé

Tuple[np.array, np.array, np.array]

Lève

  • IntentionInvalide – Si une intention de vote ne correspond pas à un nombre à virgule flottante.

  • IntentionHorsLimites – Si une intention de vote n’est pas comprise entre 0 et 100.