Roadbook numérique vs PDF ou papier : les fichiers de roadbook OpenRally expliqués

Un roadbook papier est un rouleau imprimé, et un roadbook PDF est une image de ce rouleau sur un écran. Un roadbook numérique au format OpenRally est différent : le fichier lui-même indique à l’appareil la distance de chaque case, le CAP, les waypoints et leurs rayons de validation et les zones de vitesse, avec les dessins des tulipes et des notes intégrés. C’est ce qui permet à un roadbook numérique de garder votre odomètre aligné, de valider les waypoints et de vous alerter dans les zones de vitesse.

Roadbook numérique vs PDF vs papier : quelle différence ?

Les roadbooks papier et PDF montrent le parcours sous forme d’images que le pilote doit interpréter. Un roadbook numérique au format OpenRally enregistre le même parcours sous forme de données : chaque case porte sa distance, son CAP, ses informations de waypoint et de zone de vitesse, avec les dessins intégrés. Ce sont ces données qui permettent à l’appareil d’aligner votre odomètre, de valider les waypoints et de vous alerter dans les zones de vitesse.

Pourquoi un PDF n’est pas « numérique » au sens de la navigation

Sur un écran, un roadbook PDF ressemble en tout point au papier, mais l’appareil ne peut pas lire des distances, un CAP ou des waypoints dans une image. Il peut afficher la page. Il ne peut pas valider un waypoint, aligner l’odomètre sur une case ni vous alerter dans une zone de vitesse.

Le papier, en bref

Traditionnellement, les roadbooks de rallye étaient imprimés sur un rouleau de papier que l’on faisait défiler case par case. Le format vient du papier : les mêmes cases, tulipes et notes qu’affiche aujourd’hui un roadbook numérique. La différence, c’est que sur papier, chaque chiffre doit être lu et vérifié par le pilote.

Qu’est-ce qu’OpenRally ?

OpenRally est un standard ouvert et communautaire pour l’échange électronique de données de roadbook de rallye. Il étend le GPX, le format de fichier GPS le plus courant, avec des balises propres au rallye (distances, CAP, types et rayons de waypoints, zones de vitesse, contrôles) et intègre les dessins des tulipes et des notes en PNG ou SVG, pour qu’un seul fichier contienne tout le roadbook.

Qui a créé OpenRally

OpenRally a été cofondé par ICO Racing et F2R, qui en ont défini la nomenclature et la structure initiales. Dave Peckham, de Rally Navigator, a écrit le code de la spécification. C’est aujourd’hui un standard communautaire maintenu par les entreprises qui l’utilisent, dont des éditeurs de logiciels de roadbook, des organisateurs et des fabricants d’appareils.

Pourquoi le GPX ?

Le README d’OpenRally donne trois raisons : le GPX est le format de fichier de géolocalisation le plus courant, il dispose de nombreux outils de conversion et il a été conçu pour être étendu. OpenRally est un format d’échange : chaque application est libre de stocker les données en interne comme elle le souhaite.

Versions

Les notes de version couvrent la v1.0.0, qui a séparé les balises du rallye-raid (cross-country) de celles du rallye routier, supprimé les balises en double, fixé des valeurs par défaut selon la FIM ou les règlements en vigueur et ajouté les dessins des tulipes et des notes en PNG base64 ou SVG, et la v1.0.2, qui a ajouté le marqueur show_coordinates. Le schéma actuel utilise le namespace v1.0.3 (dernière version étiquetée : v1.0.2). OpenRally 1.x couvre le rallye-raid ; le rallye routier se trouve dans une branche séparée, v0.3-DRAFT.

Ce que contient un fichier OpenRally, et ce qu’il ne contient pas

Un fichier OpenRally contient les cases du roadbook du parcours sous forme de waypoints GPX. Chacune a sa distance et peut aussi porter le CAP, un niveau de danger, un type de waypoint avec ses rayons, des marqueurs de zone de vitesse et de contrôle, ainsi que les dessins des tulipes et des notes. Il ne contient ni contrôle d’accès, ni pénalités ou règles de classement, ni cartes, ni le règlement de l’épreuve.

Ce qu’il contient (selon le schéma et le fichier d’exemple officiels)

• En-tête : les unités (métriques ou impériales, « statute ») et la distance totale du parcours, dans les extensions des métadonnées.
• Chaque case : un waypoint GPX dont les extensions contiennent sa distance, le seul élément obligatoire dans chaque case.
• Cap et danger : cap et danger, avec des niveaux de danger de 1 à 3.
• Waypoints : des types de waypoint avec un rayon d’ouverture (open), un rayon de validation (clear) et un nom.
• Secteur sélectif : marqueurs de départ et d’arrivée (dss et ass).
• Zones de vitesse : début de zone, limite de vitesse et fin de zone (dz, speed et fz).
• Liaisons : début et fin d’une liaison (dt et ft).
• Contrôles et marqueurs : stop, neutralisation et sa fin (neutralization et fn), contrôle horaire avec les minutes accordées jusqu’au suivant (timecontrol), checkpoint, carburant et remise à zéro de l’odomètre.
• Moyens de sécurité et le marqueur show_coordinates.
• Dessins : les images tulip et notes.

Les éléments GPX standard s’appliquent aussi, comme la latitude et la longitude de chaque waypoint. Qu’un fichier contienne aussi la trace complète dépend des réglages d’export de l’éditeur.

Ce qu’il ne contient pas (le schéma v1.x n’a aucun élément pour)

• Qui peut ouvrir le fichier, ou pendant combien de temps. Le contrôle d’accès relève des plateformes de diffusion (RDS, par exemple, propose des roadbooks non partageables et un accès limité dans le temps).
• Les pénalités, les règles de classement ou le règlement de l’épreuve. Le seul élément de temps est timecontrol allowed, les minutes jusqu’au contrôle suivant.
• Le lexique de symboles de la FIM ou de la FIA. Les dessins sont des images intégrées, pas des codes de symboles.
• Des cartes ou des tuiles de carte.
• Des notes sous forme de texte consultable. Les notes sont des dessins, même si un dessin SVG peut contenir du texte.
• Une signature numérique ou un contrôle d’intégrité.
• Des règles sur le comportement d’un appareil. Le schéma enregistre des rayons et des marqueurs ; chaque appareil décide comment les afficher et comment valider par rapport à eux.

Balises et attributs OpenRally (référence)

Les balises OpenRally se trouvent dans le bloc extensions standard du GPX de chaque waypoint (wpt), dans le namespace http://www.openrally.org/xmlschemas/GpxExtensions/v1.0.3, généralement avec le préfixe openrally.

• Orthographe des unités : le commentaire du schéma indique « statute », mais sa liste de valeurs autorisées l’écrit « statue ». Acceptez les deux à la lecture des fichiers.
• Anciens noms : quelques anciens noms de balises ont été remplacés en v1.0 et sont commentés dans le schéma. Ne les considérez pas comme actuels.
• Ajouts des éditeurs : certains éditeurs ajoutent des attributs ou des modes non standard à la spécification. Les lecteurs doivent ignorer les balises et attributs inconnus.

Comment obtenir un fichier de roadbook OpenRally

Il y a trois façons d’obtenir un fichier OpenRally : l’organisateur vous l’envoie (en téléchargement ou par e-mail, ou attribué à votre appareil via une plateforme de diffusion comme RDS), vous le téléchargez depuis une bibliothèque de roadbooks, ou vous créez le vôtre dans un éditeur de roadbook qui exporte en OpenRally GPX.

Par l’organisateur

Certains organisateurs envoient le fichier directement. D’autres le diffusent via une plateforme. Avec RDS (Roadbook Delivery System, développé et exploité par TerraPirata), les organisateurs importent des roadbooks, par exemple depuis Rally Navigator, ou des fichiers OpenRally (GPX), les attribuent aux pilotes par Device ID ou par e-mail, et peuvent définir des créneaux horaires, des zones de vitesse, le suivi en direct et le classement. Les roadbooks de compétition sont souvent, par conception, limités dans le temps ou non partageables.

Depuis une bibliothèque

TerraPirata propose aux utilisateurs de RDS une bibliothèque gratuite de roadbooks de partenaires. Dans la F2R Roadbook App, ils apparaissent dans « Public ».

Créez le vôtre

Ces éditeurs de roadbook disposent d’un export OpenRally vérifié :

• Rally Navigator: File > Export > OpenRally GPX. Rally Navigator publie aussi des fichiers OpenRally GPX d’exemple.
• RiverNotes 2: cite OpenRally parmi ses formats d’export.
• Tulip: exporte en OpenRally v1.0.2, avec un mode Strict et un mode Undocumented.

Puis-je convertir un PDF en OpenRally ?

Pour les développeurs : créer un outil ou un visualiseur qui lit OpenRally

Pour les développeurs

Un fichier OpenRally est du XML GPX 1.1. Analysez chaque waypoint, lisez les éléments OpenRally dans ses extensions, gardez les cases dans l’ordre du fichier, calculez la distance partielle entre les cases et affichez les images des tulipes et des notes à côté des distances, du CAP et des marqueurs.

Étapes

1. Vérifiez la version du namespace OpenRally à la racine du fichier et analysez-le en fonction de celle-ci. Le README le demande, et le projet utilise le versionnage sémantique.
2. Lisez les unités et la distance totale dans les extensions des métadonnées.
3. Pour chaque waypoint (wpt), lisez la latitude et la longitude, la distance totale et la distance partielle (cette case moins la précédente, en tenant compte d’un éventuel reset), ainsi que cap, danger et les marqueurs de waypoint, de zone et de contrôle avec leurs attributs open, clear et name.
4. Affichez les dessins. Le contenu est soit une data URL PNG en base64, soit du SVG intégré, normalement en CDATA. Ne chargez jamais de références externes : le fichier est conçu pour fonctionner hors ligne.
5. Pendant le développement, validez avec le script validate.sh du dépôt, qui exécute xmllint avec test_wrapper.xsd (lequel importe openrally.xsd et gpx-strict.xsd).
6. Soyez tolérant : ignorez les commentaires XML et les extensions d’autres éditeurs, ignorez les balises inconnues et acceptez à la fois « statute » et « statue ».
7. Gardez la logique de navigation dans l’application, pas dans le fichier : odomètre par GPS, alignement sur la distance de la case, ouverture d’un waypoint dans son rayon open et validation dans son rayon clear, et alertes de zone de vitesse entre dz et fz.

Exemple : lire les cases avec la bibliothèque standard de Python

import xml.etree.ElementTree as ET
GPX = "{http://www.topografix.com/GPX/1/1}"

def read_openrally(path):
    root = ET.parse(path).getroot()
    boxes, prev = [], 0.0
    for wpt in root.findall(GPX + "wpt"):
        ext = wpt.find(GPX + "extensions")
        if ext is None:
            continue
        box = {"lat": float(wpt.get("lat")), "lon": float(wpt.get("lon"))}
        for el in ext:
            if not isinstance(el.tag, str) or "openrally" not in el.tag:
                continue  # skip comments and other vendors' extensions
            tag = el.tag.split("}")[1]          # e.g. "distance", "wpm", "tulip"
            box[tag] = dict(el.attrib) if el.attrib else (el.text or "").strip()
        total = float(box.get("distance", prev))  # total distance from start
        box["partial"] = round(total - prev, 2)   # distance since previous box
        prev = total
        boxes.append(box)
    return boxes

Le example.gpx officiel est une vitrine de balises, pas un vrai parcours : ses distances ne forment donc pas une vraie séquence. Testez avec un vrai export, par exemple l’un des fichiers OpenRally GPX d’exemple de Rally Navigator. Dans un navigateur, un visualiseur peut faire la même chose avec DOMParser et getElementsByTagNameNS, et afficher les tulipes PNG dans un élément img avec une data URL.

Ressources

• Dépôt OpenRally (README, notes de version et liste de diffusion)
• XSD rallye-raid (cross-country)
• example.gpx
• validate.sh
• Brouillon rallye routier (v0.3-DRAFT)
• Schéma GPX 1.1 (Topografix)
• Guide rallye-raid de Rally Navigator
• Notes d’export OpenRally de Tulip

Charger un fichier OpenRally sur le F2R Y1000 (F2R Roadbook App)

La F2R Roadbook App du Y1000 lit les fichiers OpenRally .GPX et prend en charge toutes les balises OpenRally. Importez un fichier depuis le stockage local ou recevez-le via RDS, attribué à votre Device ID ou à votre compte. L’application vous donne alors odomètres, CAP, alertes de zones de vitesse et validation des waypoints à partir des données du fichier lui-même.

Depuis un fichier local

1. Dans la F2R Roadbook App, touchez ADD.
2. Choisissez le fichier .GPX dans Téléchargements, Fichiers, vos e-mails, Google Drive, Dropbox ou tout autre dossier.
3. Le roadbook apparaît dans « My Roadbooks ». Vous pouvez supprimer dans l’application les roadbooks chargés localement.

Via RDS

1. Créez un compte ou connectez-vous sur rds.terrapirata.com.
2. Associez le Y1000 avec son Device ID, affiché dans l’application MyGamma, ou avec l’adresse e-mail du compte Google utilisé sur l’appareil.
3. L’organisateur, ou vous-même, attribue les roadbooks. Ils apparaissent dans « Events » pendant la période fixée par le propriétaire, ou dans « Public ».

Seul le propriétaire peut gérer les roadbooks RDS, depuis RDS. Les roadbooks partagés vers un Device ID n’apparaissent que sur cet appareil ; le Device ID est fixe, alors que l’e-mail peut être modifié.

Ce que l’application fait des données

• Odomètres principal et secondaire, réglables par appui long, par appui long sur la distance d’une note, ou avec les télécommandes DR001 (moto) et DRA01 (voiture). Le Y1000 intègre des tripmasters virtuels.
• Cap (CAP).
• Une flèche de waypoint qui s’ouvre dans le rayon d’ouverture du waypoint et se ferme lorsque le waypoint est validé ou que vous quittez le rayon.
• Distance jusqu’au waypoint et nom du waypoint suivant, qui clignote en vert pendant la validation.
• Un tableau des waypoints indiquant s’ils sont validés ou manqués, avec les heures.
• Couleurs du compteur de vitesse dans les zones de vitesse : sous la limite, en approche ou au-dessus.
• Temps de spéciale entre la validation du DSS et celle de l’ASS.
• Le lexique FIM par appui long.
• « Go to note » dans une application GPS quand le roadbook contient des coordonnées.

• Manuel d’utilisation de la F2R Roadbook App (PDF)
• Application F2R Roadbook
• Commandes à distance

Et les PDF ?

Le Y1000 est un appareil Android complet : un roadbook PDF peut donc être lu avec une application tierce compatible de Google Play ; le guide d’utilisation du Y1000 cite en exemple Rally Roadbook Reader, de Rally Navigator. Les fonctions de navigation ci-dessus nécessitent un fichier OpenRally.

FAQ