Si vous constatez la perte de tickets, de commentaires ou de projets, veuillez consulter la page https://status.framasoft.org/incident/626.

README.md 11.9 KB
Newer Older
Miguel Tremblay's avatar
Miguel Tremblay committed
1
Identifier le genre du prénom des donateurs aux partis politiques du Québec
Miguel Tremblay's avatar
Miguel Tremblay committed
2 3 4 5 6
=============

Introduction
------------

7
`donsprenoms.py` est un script python 3 qui analyse les dons politiques du Québec, en les classant par parti politique, et permet de relier les prénoms des donateurs aux partis politiques du Québec selon le genre, en reliant le prénom à des listes de prénoms de filles et de garçons. Ces listes ont été créées, notamment, à l'aide de la [banque des prénoms de Retraite Québec](https://www.donneesquebec.ca/recherche/fr/organization/rrq) et des listes de prénoms sur Wikipédia.
Miguel Tremblay's avatar
Miguel Tremblay committed
8

Miguel Tremblay's avatar
Miguel Tremblay committed
9 10
Il est possible de consulter les fichiers d'analyses des dons politiques, par année, dans le répertoire [analyse-prenoms](/analyse-prenoms).  

Miguel Tremblay's avatar
Miguel Tremblay committed
11

Miguel Tremblay's avatar
Miguel Tremblay committed
12 13
Source des données 
------------
14

15 16 17
Prénoms des donateurs:
* [Donateurs aux partis politiques du Québec](https://www.electionsquebec.qc.ca/francais/provincial/financement-et-depenses-electorales/recherche-sur-les-donateurs.php)

18
Prénoms filles/gars:
Miguel Tremblay's avatar
Miguel Tremblay committed
19 20
* [Banque de prénoms des filles](https://www.donneesquebec.ca/recherche/fr/dataset/banque-de-prenoms-filles)
* [Banque de prénoms des garçons](https://www.donneesquebec.ca/recherche/fr/dataset/banque-de-prenoms-garcons)
21
 
Miguel Tremblay's avatar
Miguel Tremblay committed
22

Miguel Tremblay's avatar
Miguel Tremblay committed
23
### Listes des prénoms fournies avec donsprenoms
Miguel Tremblay's avatar
Miguel Tremblay committed
24

Miguel Tremblay's avatar
Miguel Tremblay committed
25 26 27 28
Les prénoms de la banque ont été combinés à l'aide du script `merge_dico.py`. Les prénoms ont ainsi été séparés en trois listes:
1. [Prénoms uniques aux filles](prenoms/filles-prenoms-uniques.txt) (169631 entrées, aucune occurrence de ces prénoms féminins dans la liste des prénoms des garçons)
2. [Prénoms uniques aux garçons](prenoms/gars-prenoms-uniques.txt) (164378 entrées, aucune occurrence de ces prénoms masculins dans la liste des prénoms des filles)
3. [Prénoms communs aux filles et garçons](prenoms/prenoms-gars-filles-communs.txt) (10778 entrées, au moins une occurrence dans chacune des listes)
Miguel Tremblay's avatar
Miguel Tremblay committed
29

Miguel Tremblay's avatar
Miguel Tremblay committed
30 31 32 33
Les autres listes de prénoms, telles que celles ayant dans le nom de fichier le mot 'grec' ou 'arabe' proviennent de Wikipédia. Par exemple:
1. [Liste de prénoms grecs](https://fr.wikipedia.org/wiki/Liste_de_pr%C3%A9noms_grecs)
2. [Liste de prénoms arabes](https://fr.wikipedia.org/wiki/Liste_de_pr%C3%A9noms_arabes)

Miguel Tremblay's avatar
Miguel Tremblay committed
34 35
### Licences des données

Miguel Tremblay's avatar
Miguel Tremblay committed
36
Bien que ce logiciel soit distribué avec la licence GPL version 3, les données provenant de Retraite Québec sont distribuées sous la licence [CC-BY](https://www.donneesquebec.ca/fr/licence/#cc-by) et celles d'Élection Québec sont sous [leur propre licence](http://dgeq.org/#license) (cliquer sur « Licence d'utilisation »). Les listes de prénoms supplémentaires (ex.: prénoms arabes) proviennent de Wikipédia et sont sous licence [CC-BY](https://www.donneesquebec.ca/fr/licence/#cc-by).
Miguel Tremblay's avatar
Miguel Tremblay committed
37

Miguel Tremblay's avatar
Miguel Tremblay committed
38 39 40
Méthodologie
------------

Miguel Tremblay's avatar
Miguel Tremblay committed
41 42
### Prénoms dans la banque de données de Retraite Québec

Miguel Tremblay's avatar
Miguel Tremblay committed
43
La colonne des prénoms de la liste des donateurs est utilisée pour identifier si la personne est un homme ou une femme. Lorsque le prénom est analysé, il y a 3 cas de figure qui peuvent survenir:
Miguel Tremblay's avatar
Miguel Tremblay committed
44 45 46 47
1. Le prénom est dans la liste des filles;
2. Le prénom est dans la liste des garçons;
3. Le prénom est dans la liste des filles et des garçons.

Miguel Tremblay's avatar
Miguel Tremblay committed
48
Bien que la liste des prénoms communs entre filles et garçons ne représente qu'environ 6% de tous les prénoms de la liste de Retraite Québec, 60% de tous les donateurs ont un prénom dans cette liste. Il est donc essentiel de répartir les donateurs ayant un prénom commun aux filles et garçons, car si les seuls 40% des donateurs ayant un prénom uniquement de fille ou de garçon étaient analysés, le résultat pourrait ne pas être représentatif de l'ensemble.
Miguel Tremblay's avatar
Miguel Tremblay committed
49

Miguel Tremblay's avatar
Miguel Tremblay committed
50
Ainsi, dans le cas de figure ou le prénom est une fille (1) ou un garçon (2), le donateur et le montant est ajouté à la liste correspondant au genre du prénom. Lorsque le prénom appartient à la fois à la liste des filles et des garçons, il est pondéré selon le nombre de prénoms qui a été donné à chacun des genres dans la liste des prénoms de Retraite Québec. Par exemple, le prénom 'Elli' ayant été donné à 19 filles et à 10 garçons, pour un ratio fille/garçon de 0,66, un donateur prénommé 'Elli' comptera pour 0,66 femme et 0,33 garçon. Le montant du don sera divisé selon le même ratio.
Miguel Tremblay's avatar
Miguel Tremblay committed
51

Miguel Tremblay's avatar
Miguel Tremblay committed
52 53
#### Cas spéciaux

MiguelTremblay's avatar
MiguelTremblay committed
54
Lorsqu'un prénom n'est pas textuellement dans la liste de retraite Québec, certains traitements sont appliqués pour aider à identifier le genre d'un prénom:
55
1. Les prénoms des donateurs se terminant ou débutant par une lettre majuscule seule suivie d'un point ont été simplifiés en retirant cette dernière. "Louise M." devient ainsi "Louise", "W. David" devient "David". La classification se fait par la suite sur le prénom résultant dans la liste de Retraite Québec.
Miguel Tremblay's avatar
ortho  
Miguel Tremblay committed
56
2. Les prénoms des donateurs se terminant par une lettre majuscule seule précédée d'un tiret ont été simplifiés en retirant cette dernière. "Louis-T" devient ainsi "Louis". La classification se fait par la suite sur le prénom résultant dans la liste de Retraite Québec.
Miguel Tremblay's avatar
Miguel Tremblay committed
57 58
3. Les prénoms terminant par "Sr." ou "Jr.", avec toutes leurs variantes majuscules/minuscules, sont considérés comme étant des prénoms masculins.
4. Lorsqu'un prénom est composé de plusieurs prénoms, séparés par un tiret ou un espace, une moyenne des ratios filles/garçons est opérée sur la série de prénoms, lorsque ceux-ci sont dans la liste de Retraite Québec, ou sont ignorés lorsqu'ils en sont absents. Par exemple "Jenny-Marie", sera séparé en "Jenny" (ratio 0,99) et "Marie" (ratio 1.0) pour un ratio moyen de 0,995. De même, "Vouli Spyridoula" sera séparée en "Vouli" (non listé) et "Spyridoula" (dans la liste de prénom unique de fille), et sera considérée comme un prénom féminin.
Miguel Tremblay's avatar
Miguel Tremblay committed
59 60 61 62

### Prénoms absents de Retraite Québec

Plusieurs prénoms dans la liste de donateurs du DGEQ ne se trouvaient pas dans les listes de Retraite Québec. Afin d'avoir une classification la plus complète possible, une vérification manuelle de certains prénoms des donateurs a été effectuée. Les étapes suivantes pour identifier le genre d'un prénom a ont été utilisés:
Miguel Tremblay's avatar
Miguel Tremblay committed
63 64 65
1. Classement trivial (ex.: "Hughette")
2. Recherche sur le web pour voir s'il ne s'agissait pas d'un prénom typique à un genre (ex.: "[Minying](http://images.google.com/images?q=%minying)")
3. Trouver le nom de famille correspond au prénom dans le fichier du DGEQ, et tenter de trouver une photo de la personne par une recherche web (ex.: "[Nochane Rousseau](http://www.lapresse.ca/affaires/portfolio/developpement-minier/201604/25/01-4974709-une-annee-charniere-pour-plusieurs-mines.php)")
Miguel Tremblay's avatar
Miguel Tremblay committed
66 67 68 69 70

Les prénoms ainsi identifiés ont été classés dans les deux fichiers:
* [filles-non-listees.txt](prenoms/filles-non-listees.txt)
* [gars-non-listees.txt](prenoms/gars-non-listees.txt)

Miguel Tremblay's avatar
Miguel Tremblay committed
71
La liste complète des prénoms communs se trouve dans le fichier [prénoms communs aux filles et garçons](prenoms/prenoms-gars-filles-communs.txt). 
Miguel Tremblay's avatar
Miguel Tremblay committed
72

73
Ceux qui n'ont pas été classés sont dans le fichier [inconnus.txt](prenoms/inconnus.txt). Vous pouvez [contacter le développeur](mailto:donsprenoms.miguel@ptaff.ca) pour proposer de classer l'un de ces prénoms dans fille ou garçon, avec justification.
Miguel Tremblay's avatar
Miguel Tremblay committed
74

Miguel Tremblay's avatar
Miguel Tremblay committed
75 76 77 78 79
Résultats
------------

Les fichiers résultants de l'analyse se trouvent dans le répertoire [analyse-prenoms](analyse-prenoms/) et sont en format CSV. Une analyse manuelle supplémentaire a été effectuée, et contient notamment des graphiques, grâce au logiciel [gnumeric](http://www.gnumeric.org/).  Ce logiciel, d'un version égale ou supérieure à 1.12, doit être utilisé pour ouvrir les données avec l'extension _.gnumeric_. 

Miguel Tremblay's avatar
Miguel Tremblay committed
80 81 82 83
[Graphiques](graphiques/):
* [Montant et proportion de femmes ayant fait un don (2000-2018)](graphiques/proportion_femmes_dons_montants.png )
* [Proportion des femmes ayant fait des dons aux 4 principaux partis politiques au Québec (2000-2018)](graphiques/proportion_femmes_caq-plq-pq-qs.png )
* [Proportion des femmes ayant fait des dons aux partis politiques du Québec 2018 (jusqu'au 1 août)](graphiques/proportion_femmes_2018_caq-plq-pq-qs.png)
Miguel Tremblay's avatar
Miguel Tremblay committed
84

Miguel Tremblay's avatar
Miguel Tremblay committed
85 86 87 88 89
Dans les médias
------------

Couverture médiatique portant sur les résultats de ce script:
* [Beaucoup de femmes «poteaux» à la CAQ](https://www.journaldequebec.com/2018/08/31/beaucoup-de-femmes-poteaux-a-la-caq), Journal de Québec, 31 août 2018
Miguel Tremblay's avatar
Miguel Tremblay committed
90
* [Analyse des donateurs politiques selon le genre au Québec](http://ptaff.ca/blogue/2018/09/12/analyse_des_donateurs_politiques_selon_le_genre_au_qubec/), Hors des lieux communs, 12 septembre 2018
Miguel Tremblay's avatar
Miguel Tremblay committed
91

Miguel Tremblay's avatar
Miguel Tremblay committed
92

Miguel Tremblay's avatar
Miguel Tremblay committed
93 94 95
Prérequis
------------

Miguel Tremblay's avatar
Miguel Tremblay committed
96
* [python 3](https://www.python.org/downloads/)
97
* [unidecode](https://pypi.org/project/Unidecode/)
Miguel Tremblay's avatar
Miguel Tremblay committed
98
* [progress](https://pypi.python.org/pypi/progress)
Miguel Tremblay's avatar
Miguel Tremblay committed
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113

Téléchargement
--------
La dernière version peut être téléchargée ici:<br>
https://framagit.org/MiguelTremblay/donsprenoms

La version git peut être téléchargée ici:<br>
 ```git clone https://framagit.org/MiguelTremblay/donsprenoms.git```
 

 Manuel
--------

De façon générale, ce logiciel devrait être appelé en ligne de commande de cette manière:
```bash
Miguel Tremblay's avatar
Miguel Tremblay committed
114
python3 donsprenoms.py -d FICHIER_DGEQ.csv -f filles-prenoms-uniques.txt -g gars-prenoms-uniques.txt -c prenoms-gars-filles-communs.txt
Miguel Tremblay's avatar
Miguel Tremblay committed
115 116 117
```


Miguel Tremblay's avatar
Miguel Tremblay committed
118 119 120
| Options                                  | Description |
| -------                                  | ------------|
| `-h`, `--help`                           | Afficher ce message d'aide et quitter.|
Miguel Tremblay's avatar
-o  
Miguel Tremblay committed
121
| `-o` `--fichier-sortie`&nbsp;CHEMIN                     |Fichier de sortie CSV où seront inscrit les résultats de l'analyse. Si aucune valeur n'est indiquée, le résultat est inscrit dans le terminal|
Miguel Tremblay's avatar
Miguel Tremblay committed
122 123 124 125
| `-d` `--DGEQ`&nbsp;CHEMIN                     | Fichier CSV provenant du site du DGEQ contenant les noms et montants des donateurs à un ou des partis politiques|
| `-f` `--Fille`&nbsp;CHEMIN1&nbsp;CHEMIN2&nbsp;[...]     | Fichier(s) contenant les prénoms des filles (un prénom par ligne)|
| `-g` `--Gars`&nbsp;CHEMIN1&nbsp;CHEMIN2&nbsp;[...]      | Fichier(s) contenant les prénoms des gars (un prénom par ligne)|
| `-c` `--Commun`&nbsp;CHEMIN              |Fichier contenant les prénoms communs aux filles et garçons (prénom, ration f/g)|
Miguel Tremblay's avatar
Miguel Tremblay committed
126
| `-i` `--inconnu`               | Afficher les prénoms inconnus|¸
Miguel Tremblay's avatar
Miguel Tremblay committed
127 128
| `-s` `--limite-sup` Montant ($)          |  Compter seulement les dons au-dessous de ce montant
| `-I ` `--limite-inf` Montant ($)          |  Compter seulement les dons au-dessus de ce montant
129 130
|`-v` `--verbose`                          | Expliquer ce qui se passe.|
|`-V` `--version`                          | Écrire l'information sur la version et quitter.|
Miguel Tremblay's avatar
Miguel Tremblay committed
131

Miguel Tremblay's avatar
Miguel Tremblay committed
132 133 134 135 136
Utilisation
-----

Pour utiliser avec les fichiers qui sont fournis avec le code:
```bash
Miguel Tremblay's avatar
Miguel Tremblay committed
137
python3 donsprenoms.py -d FICHIER_DGEQ.csv -f prenoms/filles-prenoms-uniques.txt prenoms/filles-non-listees.txt -g prenoms/gars-prenoms-uniques.txt prenoms/gars-non-listees.txt -c prenoms/prenoms-gars-filles-communs.txt -o analyse-prenoms/donateurs.csv
Miguel Tremblay's avatar
Miguel Tremblay committed
138 139
```

Miguel Tremblay's avatar
Miguel Tremblay committed
140 141 142 143 144 145 146
Sortie
-----

Les informations suivantes sont extraites du fichier (F = Femmes, H = Hommes, I = Inconnu ):
* Année
* Parti politique
* Nbr donateurs
147 148
* Proportion donateurs (%)
* Proportion argent (%)
Miguel Tremblay's avatar
Miguel Tremblay committed
149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
* Montant total
* Montant moyen
* Nbr F
* Montant F
* Montant moyen F
* Proportion donateurs F
* Proportion montants F
* Nbr H
* Montant H
* Montant moyen H
* Proportion donateurs H
* Proportion montants H
* Nbr I
* Montant I
* Montant moyen I
* Proportion donateurs I
* Proportion montant I


Miguel Tremblay's avatar
Miguel Tremblay committed
168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183
Bogues
-----

Si vous trouvez un bogue, vous pouvez le rapporter à [donsprenoms.miguel@ptaff.ca](mailto:donsprenoms.miguel@ptaff.ca)

Auteur
-----

[Miguel Tremblay](http://ptaff.ca/miguel/)

Licence
-----

Copyright © 2018 Miguel Tremblay.

donsprenoms.py est un logiciel libre; vous pouvez le redistribuer et/ou le modifier selon les termes de la GNU General Public License (Licence Publique Générale GNU) telle qu'elle a été publiée par la Free Software Foundation; soit la version 3 de la licence, soit (comme vous le souhaitez) toute version ultérieure.