# ORDOSTAT

## Interface de Calcul Elo Haute Précision

GUIDE D'UTILISATION OFFICIEL
Auteur : Valter DRAZIC
Laboratoire Maison — Chroniques Software
24 Mars 2026

## Table des matières

- 1. Introduction
- 2. Architecture Statistique
- 3. Configuration des Fichiers
- 4. Utilisation Avancée
- 5. Maintenance et Compilation

## 1. Introduction

OrdoStat est une interface graphique (GUI) développée en Python/PyQt6 conçue pour simplifier l'utilisation du programme `Ordo` de Miguel Ballicora. Il permet d'extraire des statistiques de performance à partir de fichiers PGN, en utilisant le principe du maximum de vraisemblance plutôt qu'un simple calcul de pourcentage de points.

## 2. Architecture Statistique

L'outil repose sur la fonction logistique de probabilité. Pour deux entités i et j de classements respectifs Ri et Rj, la probabilité de victoire est :

P(i,j) = 1 / (1 + 10-(Ri - Rj)/400)

OrdoStat pilote le moteur de calcul pour minimiser l'erreur statistique globale sur l'ensemble des parties fournies dans le fichier PGN.

## 3. Configuration des Fichiers

L'interface est structurée autour de trois champs de sélection obligatoires :

- Fichier PGN : Source des parties (ex: `TotalGames3.pgn`).
- Exécutable Ordo : Le moteur de calcul binaire (`ordo-win64.exe`).
- Résultat .txt : Le chemin de sortie pour le rapport détaillé (`rating.txt`).

## 4. Utilisation Avancée

### 4.1. L'Ancrage (Anchoring)

Sans ancre, le classement produit est relatif. Pour obtenir des valeurs comparables à l'échelle officielle, vous devez utiliser :

1. L'ancre simple : Saisir un nom de moteur et son Elo connu.
2. Le fichier d'ancres : Charger un `.csv` (ex: `anchors.csv`) contenant une liste de références.

### 4.2. Interprétation du Tableau

Le tableau de bord OrdoStat fournit les métriques suivantes :

Donnée | Unité | Description
--- | --- | ---
Rating | Elo | Force brute calculée.
Error | ± | Marge d'erreur (StD Error).
Opponent | Elo | Niveau moyen de l'opposition rencontrée.

## 5. Maintenance et Compilation

Le script `compiler.bat` automatise la création de l'exécutable autonome. Il utilise `PyInstaller` avec des exclusions de modules pour optimiser le poids final.

    pyinstaller --noconfirm --onefile --windowed --exclude-module matplotlib ordo_gui.py

Note Technique La compression UPX est recommandée après compilation pour diviser par trois la taille de l'exécutable `dist/OrdoStat.exe`.