# Dictionnaire des données

## pronostics-froid-v1.csv (et pronostics-direct-v2.csv, s'il est présent)

Une ligne par numéro pronostiqué. Encodage UTF-8, séparateur virgule. Une case vide veut dire : pas connu ou sans objet.

| Colonne | Type | Sens |
|---|---|---|
| `course_id` | string | Identifiant construit par TurfPronostic : date, réunion, course. |
| `date` | date | Jour de la course. |
| `hippodrome` | string | Hippodrome. |
| `reunion` | integer | Numéro de la réunion. |
| `course` | integer | Numéro de la course dans la réunion. |
| `discipline` | string | Discipline de la course. |
| `depart_prevu_utc` | datetime | Heure de départ prévue, en temps universel, connue au moment du pronostic. |
| `moteur` | string | Modèle qui a produit le pronostic. Ne pas additionner les résultats de modèles différents. |
| `version_prono` | string | Version du modèle. Ne pas additionner les résultats de versions différentes. |
| `fige_a_utc` | datetime | Heure à laquelle le pronostic a été figé, en temps universel. Une course peut avoir plusieurs pronostics : le soir, la veille, le matin. |
| `rang` | integer | Rang du numéro dans notre classement, de 1 à 5. |
| `num` | integer | Numéro du cheval dans la course. |
| `p_gagnant` | number | Probabilité estimée de gagner, entre 0 et 1, publiée avant le départ. |
| `p_place` | number | Probabilité estimée d’être placé, entre 0 et 1, publiée avant le départ. |
| `empreinte` | string | Empreinte SHA-256 du pronostic : on la retrouve dans le fichier racine de son jour, sous /donnees/pronostics/. Elle se recalcule depuis le fichier journalier quand celui-ci publie le détail ; pas pour une journée en empreintes seules. |
| `empreinte_precedente` | string | Empreinte du pronostic précédent de ce fichier ; vide pour le premier. |
| `statut_course` | string | courue, annulee ou en_attente (arrivée officielle pas encore connue). |
| `statut_cheval` | string | partant ou non_partant pour ce numéro ; vide si la course est annulée. |
| `position_arrivee` | integer | Place de ce numéro à l’arrivée officielle ; vide si elle n’est pas connue. |
| `place_oui_non` | string | oui si ce numéro a pris une place payée au simple placé (3 places à partir de 8 déclarés, 2 de 4 à 7), sinon non ; vide si cela ne peut pas être jugé. |

## racines-du-jour.csv

| Colonne | Type | Sens |
|---|---|---|
| `date` | date | Jour des courses. |
| `etape` | string | soir, veille, matin ou jour (la journée entière, une fois close). |
| `n` | integer | Nombre de pronostics couverts, y compris ceux que ce jeu ne reprend pas. |
| `racine` | string | Empreinte SHA-256 de ces pronostics (arbre de Merkle, RFC 6962). |
| `fichier` | string | Fichier racine, sous /donnees/pronostics/ : il liste les empreintes couvertes. |
| `preuve_ancrage` | string | `bitcoin:` et les blocs Bitcoin si la preuve est confirmée ; « ancrage en cours de mise en place » si elle attend ; vide sinon. |
