Fichiers d'entrée
L'outil supporte l'import de fichiers au format CSV. Par défaut, les caractères de citation et de séparation sont détectés automatiquement. Dans le cas échéant, vous pouvez indiquer manuellement les options de lecture dans l'encadré "options avancées CSV". Les fichiers peuvent avoir une ligne d'entête. Les fichiers sont toujours lus avec un encodage UTF-8.
On distingue deux types de fichiers se différenciant par leurs colonnes.
Fichier de données
Ce fichier permet d'associer une valeur à chaque siège. Selon le type de données choisi et la colonne selectionnée, l'outil considèrera les valeurs de cette colonne comme des catégories ou des valeurs numériques. Au mimnimum, le fichier doit comporter une colonne comportant les numéros de sièges à colorier. Nous attirons votre attention sur le fait que seulement quelques numéros de sièges sont valides, voir la section Numéros de sièges. Vous pouvez ensuite aggrémenter ce fichier d'autres colonnes.
Par exemple, créons un fichier de données associant 10 sièges de l'Hémicycle à un sigle de partis. Notez que ce fichier peut être avec entête ou sans. Le fait d'avoir une entête change uniquement la méthode de sélection des colonnes lors de l'import.
La première colonne définie le numéro de siège et la seconde la valeur du siège, ici des catégories dont les valeurs possibles sont les sigles des partis. Bien évidemment, le fichier contient uniquement 2 colonnes mais il est possible d'en ajouter autant que possible. De plus, il est possible de permuter les colonnes.
sans entête
1;LR 58;NI 103;UAI 77;MODEM 349;LREM 500;NG 589;GDR 629;LFI 83;LR 448;LREM
avec entête
siege;parti 1;LR 58;NI 103;UAI 77;MODEM 349;LREM 500;NG 589;GDR 629;LFI 83;LR 448;LREM
Ce qui correspond à cette représentation avec tirage de couleur aléatoire :
Voici maintenant un autre example de fichier. Associons chaque siège à une valeur numérique quelconque.
sans entête
1;-5 58;2 103;9 77;45 349;4.7 500;2
avec entête
siege;mesure 1;-5 58;2 103;9 77;45 349;4.7 500;2
Ce qui correspond à cette représentation avec tirage de couleur aléatoire :
Remarquez que les valeurs dans la première colonne représentent des nombres valides. Chaque valeur représentant un nombre (décimal ou non) doit représenté un nombre valide et être dans le format anglais, consultez ce document pour connaître les représentations possibles. Ainsi, "4.7" correspond en réalité à "4,7".
De plus, l'ordre des valeurs dans les colonnes importe peu même si l'outil analyse le fichier ligne par ligne à partir de la première.
L'outil remonte les erreurs de fichiers autant que possible. Aisni, si un numéro de siège est invalide ou qu'une chaîne de caractères représente un nombre érroné, l'outil affichera l'erreur et sa cause.
Palette de couleurs
Ce fichier permet d'associer une couleur à des catégories ou intervalles continus de valeurs. Notons qu'il est possible de ne pas renseigner de palette. Dans ce cas, si la représentation choisie est :
-
catégorielle : une couleur aléatoire est associée à chaque catégorie. Chaque siège prend donc la couleur de sa catégorie.
-
numérique : un dégradé de rouge à bleu sera utilisé pour attribuer une couleur à chaque siège. Cette couleur correspond à la position de la valeur associée au siège, dans l'intervalle formé par la valeur minimale et maximale dans l'ensemble de valeurs défines par la colonne.
Contrairement au fichier de données, le fichie de palette doit respecter un format particulier :
sans entête (palette catégorielle)
... [categorie];[couleur] ... ;[couleur] ...
avec entête (palette catégorielle)
categorie;couleur ... [categorie];[couleur] ... ;[couleur] ...
On désigne par « sièges absents » les numéros de siège non renseignés dans le fichier données. La couleur des sièges absents est définie dans la palette ou se voitattribuer une couleur par défaut (même couleur que la couleur des sièges au démarrage de l’application). La couleur des sièges absents est définie dans la palette par la ligne ";[couleur]" et ";;[couleur];" respectivement une palette catégorielle et numérique.
[couleur] représente une couleur valide. Elles doivent prendre comme valeur les valeurs suivantes :
- les couleurs nommées : red, orange, rebeccapurple, ...
- valeurs hexadécimales : #090, ##009900, ...
- représentation rgb : rgb(34, 12, 64), ...
- représentation hsl : hsl(30, 100%, 50%), ...
sans entête (palette numérique)
... [nombre];[nombre];[couleur];[couleur] ... ;;[couleur]; ...
avec entête (palette numérique)
min;max;couleur_dep;couleur_fin ... [nombre];[nombre];[couleur];[couleur] ... ;;[couleur]; ...
Chaque ligne de la palette numérique définie un dégradé débutant à la couleur "couleur_dep" et se terminant à "couleur_fin". De plus, la couleur des sièges prend valeur dans le dégradé uniquement si la valeur du siège est dans l'intervalle [min ; max[. En effet, borne max est exclusive alors que min est inclusive.
Les intersections entre intervalles ne sont pas autorisés et stopperont l'éxécution.
Par exemple avec une représentation catégorielle, en utilisant ce fichier comme fichier de données et celui-ci comme palette, nous obtenons ce visuel
Remarquez que certains places sont noires. En effet, ces 5 sièges n'ont pas été définie dans le fichier de données et dans la palette la couleur des sièges absents est noir.
Deuxième exemple mais cette fois en représentation numérique : assignons des dégradés selon le numéro de siège (on reprend le fichier de données précédent et cette palette). On désigne la colonne de données et de numéro de siège étant la première colonne du fichier.
Ici, on a créé deux dégradés englobant les sièges de 1 à 250 et de 400 à 650. Cette fois, la palette n'a pas définie la couleur des sièges absents, alors la couleur par défaut a été utilisé.