Roadbook digitale vs PDF o carta: i file di roadbook OpenRally spiegati

Un roadbook cartaceo è un rotolo stampato e un roadbook PDF è un’immagine di quel rotolo su uno schermo. Un roadbook digitale in formato OpenRally è diverso: è il file stesso a comunicare al dispositivo la distanza di ogni casella, il CAP, i waypoint con i loro raggi di validazione e le zone di velocità, con i disegni dei tulip e delle note incorporati. È questo che permette a un roadbook digitale di mantenere allineato il contachilometri, validare i waypoint e avvisarti nelle zone di velocità.

Roadbook digitale vs PDF vs carta: qual è la differenza?

I roadbook cartacei e PDF mostrano il percorso come immagini che il pilota deve interpretare. Un roadbook digitale in formato OpenRally memorizza lo stesso percorso come dati: ogni casella contiene la sua distanza, il CAP e le informazioni su waypoint e zone di velocità, con i disegni incorporati. Sono questi dati a permettere al dispositivo di allineare il contachilometri, validare i waypoint e avvisarti nelle zone di velocità.

Perché un PDF non è «digitale» in senso di navigazione

Su uno schermo un roadbook PDF sembra in tutto e per tutto carta, ma il dispositivo non può leggere distanze, CAP o waypoint da un’immagine. Può mostrare la pagina. Non può validare un waypoint, allineare il contachilometri a una casella o avvisarti in una zona di velocità.

La carta, in breve

Tradizionalmente i roadbook da rally venivano stampati su un rotolo di carta fatto avanzare casella per casella. Il formato nasce dalla carta: le stesse caselle, tulip e note che oggi mostra un roadbook digitale. La differenza è che sulla carta ogni numero deve essere letto e confrontato dal pilota.

Che cos’è OpenRally?

OpenRally è uno standard aperto e comunitario per lo scambio elettronico dei dati dei roadbook da rally. Estende il GPX, il formato di file GPS più diffuso, con tag specifici per il rally (distanze, CAP, tipi e raggi dei waypoint, zone di velocità, controlli) e incorpora i disegni dei tulip e delle note in PNG o SVG, così un solo file contiene l’intero roadbook.

Chi ha creato OpenRally

OpenRally è stato cofondato da ICO Racing e F2R, che ne hanno definito la nomenclatura e la struttura iniziali. Dave Peckham di Rally Navigator ha scritto il codice della specifica. Oggi è uno standard comunitario mantenuto dalle aziende che lo usano, tra cui produttori di software per roadbook, organizzatori e produttori di dispositivi.

Perché il GPX?

Il README di OpenRally indica tre motivi: il GPX è il formato di file di geolocalizzazione più diffuso, dispone di molti strumenti di conversione ed è stato progettato per essere esteso. OpenRally è un formato di scambio, quindi ogni app può memorizzare i dati internamente come preferisce.

Versioni

Le note di rilascio coprono la v1.0.0, che ha separato i tag del cross-country da quelli del rally stradale, eliminato i tag duplicati, impostato valori predefiniti secondo la FIM o i regolamenti vigenti e aggiunto i disegni dei tulip e delle note in PNG base64 o SVG, e la v1.0.2, che ha aggiunto il marcatore show_coordinates. Lo schema attuale usa il namespace v1.0.3 (ultima release con tag: v1.0.2). OpenRally 1.x copre i rally cross-country; il rally stradale si trova in un ramo separato, v0.3-DRAFT.

Cosa contiene un file OpenRally e cosa no

Un file OpenRally contiene le caselle del roadbook del percorso come waypoint GPX. Ognuna ha la sua distanza e può includere anche il CAP, un livello di pericolo, un tipo di waypoint con i suoi raggi, marcatori di zona di velocità e di controllo e i disegni dei tulip e delle note. Non contiene controllo degli accessi, penalità o regole di classifica, mappe né il regolamento dell’evento.

Cosa contiene (secondo lo schema e il file di esempio ufficiali)

• Intestazione: le unità (metriche o imperiali, «statute») e la distanza totale del percorso, nelle extensions dei metadati.
• Ogni casella: un waypoint GPX le cui extensions contengono la sua distanza, l’unico elemento che ogni casella deve avere.
• Rotta e pericolo: cap e danger, con livelli di pericolo da 1 a 3.
• Waypoint: tipi di waypoint con un raggio di apertura (open), un raggio di validazione (clear) e un nome.
• Prova speciale: marcatori di partenza e arrivo (dss e ass).
• Zone di velocità: inizio zona, limite di velocità e fine zona (dz, speed e fz).
• Trasferimenti: inizio e fine di un trasferimento (dt e ft).
• Controlli e marcatori: stop, neutralizzazione e sua fine (neutralization e fn), controllo orario con i minuti concessi fino al successivo (timecontrol), checkpoint, rifornimento e azzeramento del contachilometri.
• Mezzi di sicurezza e il marcatore show_coordinates.
• Disegni: le immagini tulip e notes.

Valgono anche gli elementi GPX standard, come latitudine e longitudine di ogni waypoint. Se un file contenga anche la traccia completa dipende dalle impostazioni di esportazione dell’editor.

Cosa non contiene (lo schema v1.x non ha elementi per)

• Chi può aprire il file, o per quanto tempo. Il controllo degli accessi spetta alle piattaforme di distribuzione (RDS, per esempio, offre roadbook non condivisibili e accesso limitato nel tempo).
• Penalità, regole di classifica o il regolamento dell’evento. L’unico elemento temporale è timecontrol allowed, i minuti fino al controllo successivo.
• Il lessico dei simboli FIM o FIA. I disegni sono immagini incorporate, non codici di simboli.
• Mappe o tile di mappa.
• Note come testo ricercabile. Le note sono disegni, anche se un disegno SVG può contenere testo.
• Una firma digitale o un controllo di integrità.
• Regole su come deve comportarsi un dispositivo. Lo schema memorizza raggi e marcatori; ogni dispositivo decide come mostrarli e come validare rispetto a essi.

Tag e attributi OpenRally (riferimento)

I tag OpenRally si trovano nel blocco standard extensions del GPX di ogni waypoint (wpt), nel namespace http://www.openrally.org/xmlschemas/GpxExtensions/v1.0.3, di solito con il prefisso openrally.

• Grafia delle unità: il commento dello schema dice «statute», ma il suo elenco di valori ammessi lo scrive «statue». Accetta entrambe le forme quando leggi i file.
• Vecchi nomi: alcuni vecchi nomi di tag sono stati sostituiti nella v1.0 e sono commentati nello schema. Non considerarli attuali.
• Aggiunte dei produttori: alcuni editor aggiungono alla specifica attributi o modalità non standard. I lettori dovrebbero ignorare tag e attributi sconosciuti.

Come ottenere un file di roadbook OpenRally

Ci sono tre modi per ottenere un file OpenRally: te lo invia l’organizzatore (come download o via e-mail, oppure assegnato al tuo dispositivo tramite una piattaforma di distribuzione come RDS), lo scarichi da una libreria di roadbook oppure crei il tuo in un editor di roadbook che esporta in OpenRally GPX.

Dall’organizzatore

Alcuni organizzatori inviano direttamente il file. Altri lo distribuiscono tramite una piattaforma. Con RDS (Roadbook Delivery System, sviluppato e gestito da TerraPirata) gli organizzatori importano roadbook, per esempio da Rally Navigator, o file OpenRally (GPX), li assegnano ai piloti tramite Device ID o e-mail e possono impostare fasce orarie, zone di velocità, tracking live e classifica. I roadbook di gara sono spesso, per scelta, limitati nel tempo o non condivisibili.

Da una libreria

TerraPirata offre agli utenti RDS una libreria gratuita di roadbook dei partner. Nella F2R Roadbook App compaiono in «Public».

Crea il tuo

Questi editor di roadbook hanno un’esportazione OpenRally verificata:

• Rally Navigator: File > Export > OpenRally GPX. Rally Navigator pubblica anche file OpenRally GPX di esempio.
• RiverNotes 2: elenca OpenRally tra i suoi formati di esportazione.
• Tulip: esporta OpenRally v1.0.2, con una modalità Strict e una Undocumented.

Posso convertire un PDF in OpenRally?

Per sviluppatori: creare uno strumento o un visualizzatore che legge OpenRally

Per sviluppatori

Un file OpenRally è XML GPX 1.1. Analizza ogni waypoint, leggi gli elementi OpenRally nelle sue extensions, mantieni le caselle nell’ordine del file, calcola la distanza parziale tra le caselle e mostra le immagini dei tulip e delle note accanto a distanze, CAP e marcatori.

Passaggi

1. Controlla la versione del namespace OpenRally nella radice del file ed esegui il parsing in base a essa. Lo richiede il README e il progetto usa il versionamento semantico.
2. Leggi le unità e la distanza totale dalle extensions dei metadati.
3. Per ogni waypoint (wpt) leggi latitudine e longitudine, la distanza totale e la distanza parziale (questa casella meno la precedente, tenendo conto di un eventuale reset), più cap, danger e i marcatori di waypoint, zona e controllo con i loro attributi open, clear e name.
4. Mostra i disegni. Il contenuto è una data URL PNG base64 oppure SVG inline, di norma in CDATA. Non caricare mai riferimenti esterni: il file è pensato per funzionare offline.
5. Durante lo sviluppo valida con lo script validate.sh del repository, che esegue xmllint su test_wrapper.xsd (che importa openrally.xsd e gpx-strict.xsd).
6. Sii tollerante: salta i commenti XML e le estensioni di altri produttori, ignora i tag sconosciuti e accetta sia «statute» sia «statue».
7. Mantieni la logica di navigazione nell’app, non nel file: contachilometri da GPS, allineamento alla distanza della casella, apertura di un waypoint entro il suo raggio open e validazione entro il suo raggio clear, e avvisi delle zone di velocità tra dz e fz.

Esempio: leggere le caselle con la libreria standard di 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

L’example.gpx ufficiale è una vetrina di tag, non un percorso reale, quindi le sue distanze non formano una vera sequenza. Fai i test con un’esportazione reale, per esempio uno dei file OpenRally GPX di esempio di Rally Navigator. In un browser un visualizzatore può fare lo stesso con DOMParser e getElementsByTagNameNS e mostrare i tulip PNG in un elemento img con una data URL.

Risorse

• Repository OpenRally (README, note di rilascio e mailing list)
• XSD cross-country
• example.gpx
• validate.sh
• Bozza rally stradale (v0.3-DRAFT)
• Schema GPX 1.1 (Topografix)
• Guida cross-country di Rally Navigator
• Note di Tulip sull’esportazione OpenRally

Caricare un file OpenRally sul F2R Y1000 (F2R Roadbook App)

La F2R Roadbook App del Y1000 legge i file OpenRally .GPX e supporta tutti i tag OpenRally. Importa un file dalla memoria locale o ricevilo tramite RDS, assegnato al tuo Device ID o al tuo account. L’app ti offre poi contachilometri, CAP, avvisi delle zone di velocità e validazione dei waypoint a partire dai dati del file stesso.

Da un file locale

1. Nella F2R Roadbook App tocca ADD.
2. Scegli il file .GPX da Download, File, e-mail, Google Drive, Dropbox o qualsiasi altra cartella.
3. Il roadbook compare in «My Roadbooks». I roadbook caricati in locale si possono eliminare nell’app.

Tramite RDS

1. Crea un account o accedi su rds.terrapirata.com.
2. Collega il Y1000 con il suo Device ID, mostrato nell’app MyGamma, o con l’e-mail dell’account Google usato sul dispositivo.
3. L’organizzatore, o tu stesso, assegna i roadbook. Compaiono in «Events» per il periodo stabilito dal proprietario, oppure in «Public».

Solo il proprietario può gestire i roadbook RDS, da RDS. I roadbook condivisi con un Device ID compaiono solo su quel dispositivo; il Device ID è fisso, mentre l’e-mail può essere modificata.

Cosa fa l’app con i dati

• Contachilometri principale e secondario, regolabili con pressione prolungata, con pressione prolungata sulla distanza di una nota o con i comandi DR001 (moto) e DRA01 (auto). Il Y1000 ha tripmaster virtuali integrati.
• Rotta CAP.
• Una freccia del waypoint che si apre entro il raggio di apertura del waypoint e si chiude quando il waypoint è validato o esci dal raggio.
• Distanza dal waypoint e nome del waypoint successivo, che lampeggia in verde durante la validazione.
• Una tabella dei waypoint con lo stato validato o mancato e gli orari.
• Colori del tachimetro nelle zone di velocità: sotto il limite, in avvicinamento o oltre.
• Tempo di tappa dalla validazione del DSS a quella dell’ASS.
• Il lessico FIM con pressione prolungata.
• «Go to note» in un’app GPS quando il roadbook contiene coordinate.

• Manuale utente della F2R Roadbook App (PDF)
• App F2R Roadbook
• Comandi remoti

E i PDF?

Il Y1000 è un dispositivo Android completo, quindi un roadbook PDF si può leggere con un’app di terze parti compatibile da Google Play; la guida utente del Y1000 cita come esempio Rally Roadbook Reader di Rally Navigator. Le funzioni di navigazione descritte sopra richiedono un file OpenRally.

FAQ