Installation et configuration
Pairing Software ne s'installe pas au sens Windows, car le fichier exécutable pairing.exe fonctionne seul et sans dépendance ou DLL additionnelle. Il contient tout ce qu'il faut pour s'exécuter. Le fichier zip à télécharger contient :
- Le programme pairing.exe
- Le fichier config.ini à placer dans le même répertoire que le programme
- Le fichier fr.lg.bin et us.lg.bin à placer dans le même répertoire que le programme (fichiers langue)
- Un fichier tournoi.ini de test
- Un fichier player.csv qui contient 16 joueurs 'test' associés au ficier du tournoi
- Un fichier simulator50.txt de test, optionnel (voir la page sur ce sujet)
- Un fichier tournoi50.ini de test, optionnel (voir la page sur ce sujet)
- Un fichier player50.csv qui contient 50 joueurs 'test' associés au ficier du tournoi50.ini
- Le fichier contenant la licence d'utilisation lisez-moi.txt
Configuration générale
Le tableau ci-dessous précise l'ensemble des paramètres à renseigner dans le fichier de configuration config.ini. Tous les paramètres sont importants et obligatoires.
| Code | Valeur | Description | Exemple |
|---|---|---|---|
| LANG_FILE | us.lg.bin ou fr.lg.bin | Fichier langue (ne pas renommer) | LANG_FILE=fr.lg.bin |
| ISCRIPTED | 0, 1 | Les fichiers de sauvegarde sont cryptées, 0=NON, 1=OUI | ISCRYPTED=1 |
| LOG_FILE | Nom de fichier | Fichier contenant les Logs (traces) | LOG_FILE=trace.txt |
| ISLOG | 0, 1 | Activation des Logs, 0=NON, 1=OUI | ISLOG=0 |
| DEBUG_MODE | 0, 1 | Activation du mode Debbug (pour les tests) | DEBUG_MODE=0 |
| # | Texte | Commentaires | # explication |
Pairing SoftWare peut tracer les différentes commandes saisies dans un fichier 'trace.txt' (par exemple). Le nom de ce fichier log est à préciser dans le fichier 'config.ini' ci-dessus ; il peut être changé. Le tracage est activé par l'option '-L' au démarrage.
Configuration du fichier du tournoi
Le tableau ci-dessous décrit le contenu du fichier INI pour la description d'un tournoi.
| Code | Valeur | Description | Exemple |
|---|---|---|---|
| TITLE | texte | titre du tournoi | TITLE=Mon tournoi |
| PROMPT | texte | texte du prompt de la commande | PROMPT=Tournoi 2022 |
| DATE_START | date au format jj/mm/aaaa | date de démarrage du tournoi | DATE_START=10/10/2022 |
| DATE_END | date au format jj/mm/aaaa | date de fin du tournoi | DATE_END=11/10/2022 |
| CADENCE | valeur entière | cadence des parties en minute | CADENCE=10 |
| SECOND_SUP | valeur entière | secondes additionnelles par coup | SECOND_SUP=2 |
| PLAYER_FILE | nom de fichier CSV | nom du fichier des joueurs au format CSV | PLAYER_FILE=player.csv |
| TYPE | 0, 1 | 0=Système Suisse, 1=Toutes rondes | TYPE=0 |
| PAIRING | 1 (pour l'instant) | type d'appariement, 1=standard (forts/faibles) | PAIRING=1 |
| SORTING | 213,123, 321, etc. | départage des joueurs, mettre dans l'ordre choisi, ex 123 ou 231, ou 213 ... | SORTING=213 |
| CHOICE_COLOR | 0,1 ou 2 | tirage de la couleur du 1er joueur, 0=alea, 1=Blanc, 2=Noir | CHOICE_COLOR=1 |
| NB_ROUND | valeur numérique > 1 | nombre de rondes, automatique pour les Toutes rondes | NB_ROUND=7 |
| APPROVAL | 0, 1 | homologué ? 0=Non, 1=Oui | APPROVAL=0 |
| ELO_DEFAULT | valeur entière > 1 | valeur du ELO donnée pour les non classés ou qui n'ont pas de ELO | ELO_DEFAULT=1399 |
| ARBITRATOR | texte | nom de l'arbitre | ARBITRATOR=John Doe |
| ROUND_FILE | nom de fichier CSV | nom du fichier des rondes exportées | ROUND_FILE=export_ronde_.csv |
| RANK_FILE | nom de fichier CSV | nom du fichier des classements exportés | RANK_FILE=export_rank.csv |
| PTS_WIN | Gain si gagnent | parametrage des points | PTS_WIN=1.0 |
| PTS_LOSE | Gain eventuel si perd | parametrage des points | PTS_LOSE=0.0 |
| PTS_EQUAL | Gain si égalité | parametrage des points | PTS_EQUAL=0.5 |
| PTS_WIN_FORFEIT | Gain si adv. forfait | parametrage des points | PTS_WIN_FORFEIT=1.0 |
| PTS_LOSE_FORFEIT | Gain si forfait | parametrage des points (en général=0) | PTS_LOSE_FORFEIT=0.0 |
| # | - | commentaire | # comment |
A noter le principe de départage :
Pairing Software utilise, pour l'instant, 3 niveaux de départage possibles, notés de 1 à 3 :
- 1 = Buchholz tronqué - Addition des points des adversaires sauf les points de l’adversaire le plus faible).
- 2 = Performance réalisée - Calcule le Elo moyen des adversaires (sommes des Elos divisée par le nombre d'adversaires) puis calcul du pourcentage de points marqués.
- 3 = Sonneborn-Berger - Consiste à ajouter les scores des adversaires que le joueur a battus, plus la moitié des scores des joueurs contre lesquels il a fait partie nulle. Les défaites sont ignorées.
Pour définir un ordre de départage des joueurs pour un tournoi, il faut préciser dans le fichier de configuration du tournoi, un entier (associé à la balise SORTING) qui correspond à l'ordre demandée. Exmple, si vous voulez l'ordre 'Performance, SoBe puis BuTr', alors saisir dans le fichier tournoi.ini, le code 231.
Avant de lancer le programme pour un nouveau tournoi, vous devez :
- Vérifier le fichier de configuration config.ini qui contient les paramètres généraux du programme
- Créer ou modifier un fichier INI qui va contenir les paramètres du TOURNOI (Cf. le tableau ci-dessus de description des balises présentes dans ce fichier)
- Créer ou modifier un fichier des joueurs au format CSV (Cf. exemple ci-dessous)
Fichier des joueurs
Les joueurs (ou participants) sont décrits dans un fichier à part au format CSV (point-vircule comme séparateur de champ dans le fichier). Ce fichier est chargé au moment du lancement du programme. Le nom de ce fichier doit être spécifié dans le fichier INI qui décrit le tournoi. Par exemple tournoi_2023.ini à la rubrique PLAYER_FILE=
Le fichier des joueurs contient :
- Une ligne obligatoire d'entête, l'ordre des colonnes est à conserver absolument, aucune colonne ne doit être enlevée ni ajoutée.
- Une ligne par joueur avec un code 'Num' (pour numéro) unique par joueur, le tri par classement ELO n'est pas obligatoire, il se fera dans le programme
Un exemple de fichier des joueurs est donné ci-dessous :
| Num | Nom/Prénom | ELO | Cat | Fédé | Ligue | Club |
|---|---|---|---|---|---|---|
| 1 | Joueur_1 | 1870 | SenM | FRA | BRE | LTT35 |
| 2 | Joueur_2 | 1850 | SenM | FRA | IDF | Pion92 |
| 3 | Joueur_3 | 1830 | SenM | FRA | BRE | LP35 |
| 4 | Joueur_4 | 1810 | SenM | FRA | BRE | LTT35 |
| 5 | Joueur_5 | 1790 | SenM | FRA | BRE | LTT35 |
| 6 | Joueur_6 | 1770 | SenM | FRA | IDF | Pion92 |
| 7 | Joueur_7 | 1750 | VetM | FRA | IDF | Pion92 |
| 8 | Joueur_8 | 1730 | VetM | FRA | IDF | Pion92 |
| 9 | Joueur_9 | 1710 | SenM | FRA | IDF | Pion92 |
| 10 | Joueur_10 | 1690 | SenM | FRA | IDF | Pion92 |
| 11 | Joueur_11 | 1670 | SenM | FRA | BRE | LP35 |
| 12 | Joueur_12 | 1514 | SenM | FRA | IDF | Pion92 |
A noter que les trois premières colonnes sont obligatoires quant à leur contenu (toutes les entêtes de colonne sont, elles, obligatoires). Si un joueur n'est pas affilié ou n'a pas de club ou n'est pas lié à une fédération, laissez ce champ vide. Voir le fichier player.csv proposé dans le package de téléchargement.
Le code ELO peut être estimé. Mettre un E après le ELO ; exemple : '1453 E' (mais ce n'est pas obligatoire). Sinon il est possible de laisser ce champ ELO vide, il sera initialisé par la valeur de la balise ELO_DEFAULT dans le fichier de configuration du tournoi.
