Roadbook digital vs PDF o papel: los archivos de roadbook OpenRally explicados

Un roadbook en papel es un rollo impreso, y un roadbook en PDF es una imagen de ese rollo en una pantalla. Un roadbook digital en formato OpenRally es diferente: el propio archivo le indica al dispositivo la distancia de cada casilla, el CAP, los waypoints y sus radios de validación y las zonas de velocidad, con los dibujos de tulipas y notas integrados. Eso es lo que permite a un roadbook digital mantener el cuentakilómetros alineado, validar waypoints y avisarte en las zonas de velocidad.

Roadbook digital vs PDF vs papel: ¿cuál es la diferencia?

Los roadbooks en papel y en PDF muestran el recorrido como imágenes que el piloto tiene que interpretar. Un roadbook digital en formato OpenRally guarda el mismo recorrido como datos: cada casilla lleva su distancia, CAP, información de waypoint y de zona de velocidad, con los dibujos integrados. Esos datos son los que permiten al dispositivo alinear el cuentakilómetros, validar waypoints y avisarte en las zonas de velocidad.

Por qué un PDF no es “digital” en el sentido de la navegación

En una pantalla, un roadbook en PDF se ve igual que el papel, pero el dispositivo no puede leer distancias, CAP ni waypoints a partir de una imagen. Puede mostrar la página. No puede validar un waypoint, alinear el cuentakilómetros con una casilla ni avisarte en una zona de velocidad.

El papel, en pocas palabras

Tradicionalmente, los roadbooks de rally se imprimían en un rollo de papel y se avanzaban casilla a casilla. El formato viene del papel: las mismas casillas, tulipas y notas que muestra hoy un roadbook digital. La diferencia es que, en papel, cada cifra la tiene que leer y comprobar el piloto.

¿Qué es OpenRally?

OpenRally es un estándar abierto y comunitario para intercambiar electrónicamente datos de roadbooks de rally. Amplía GPX, el formato de archivo GPS más común, con etiquetas específicas de rally (distancias, CAP, tipos y radios de waypoints, zonas de velocidad, controles) e integra los dibujos de tulipas y notas en PNG o SVG, de modo que un solo archivo contiene el roadbook completo.

Quién creó OpenRally

OpenRally fue cofundado por ICO Racing y F2R, que definieron su nomenclatura y estructura iniciales. Dave Peckham, de Rally Navigator, escribió el código de la especificación. Hoy es un estándar comunitario mantenido por las empresas que lo utilizan, entre ellas fabricantes de software de roadbook, organizadores y fabricantes de dispositivos.

¿Por qué GPX?

El README de OpenRally da tres motivos: GPX es el formato de archivo de geolocalización más común, cuenta con muchas herramientas de conversión y se diseñó para poder ampliarse. OpenRally es un formato de intercambio, así que cada aplicación puede guardar los datos internamente como prefiera.

Versiones

Las notas de versión cubren la v1.0.0, que separó las etiquetas de cross-country de las de rally de carretera, eliminó etiquetas duplicadas, fijó valores por defecto según la FIM o la normativa vigente y añadió los dibujos de tulipas y notas en PNG base64 o SVG, y la v1.0.2, que añadió el marcador show_coordinates. El esquema actual usa el namespace v1.0.3 (última versión etiquetada: v1.0.2). OpenRally 1.x cubre el rally cross-country; el rally de carretera está en una rama aparte, v0.3-DRAFT.

Qué incluye un archivo OpenRally, y qué no

Un archivo OpenRally guarda las casillas del roadbook del recorrido como waypoints GPX. Cada una tiene su distancia y además puede incluir el CAP, un nivel de peligro, un tipo de waypoint con sus radios, marcadores de zona de velocidad y de control, y los dibujos de tulipas y notas. No incluye control de acceso, penalizaciones ni reglas de puntuación, mapas ni el reglamento de la prueba.

Qué incluye (según el esquema y el archivo de ejemplo oficiales)

• Cabecera: las unidades (métricas o imperiales, “statute”) y la distancia total del recorrido, en las extensions de los metadatos.
• Cada casilla: un waypoint GPX cuyas extensions guardan su distancia, el único elemento obligatorio en todas las casillas.
• Rumbo y peligro: cap y danger, con niveles de peligro del 1 al 3.
• Waypoints: tipos de waypoint con un radio de apertura (open), un radio de validación (clear) y un nombre.
• Tramo selectivo: marcadores de salida y llegada (dss y ass).
• Zonas de velocidad: inicio de zona, límite de velocidad y fin de zona (dz, speed y fz).
• Enlaces: inicio y fin de un enlace (dt y ft).
• Controles y marcadores: stop, neutralización y su fin (neutralization y fn), control horario con los minutos permitidos hasta el siguiente (timecontrol), checkpoint, combustible y puesta a cero del cuentakilómetros.
• Medios de seguridad y el marcador show_coordinates.
• Dibujos: las imágenes tulip y notes.

También se aplican los elementos GPX estándar, como la latitud y la longitud de cada waypoint. Que un archivo incluya además el track completo depende de la configuración de exportación del editor.

Qué no incluye (el esquema v1.x no tiene ningún elemento para)

• Quién puede abrir el archivo, o durante cuánto tiempo. El control de acceso lo gestionan las plataformas de distribución (RDS, por ejemplo, ofrece roadbooks no compartibles y acceso limitado en el tiempo).
• Penalizaciones, reglas de puntuación o el reglamento de la prueba. El único elemento de tiempo es timecontrol allowed, los minutos hasta el siguiente control.
• El léxico de símbolos de la FIM o de la FIA. Los dibujos son imágenes integradas, no códigos de símbolos.
• Mapas o teselas de mapa.
• Notas como texto buscable. Las notas son dibujos, aunque un dibujo SVG puede contener texto.
• Una firma digital o una comprobación de integridad.
• Reglas sobre cómo debe comportarse un dispositivo. El esquema guarda radios y marcadores; cada dispositivo decide cómo mostrarlos y cómo validar con ellos.

Etiquetas y atributos de OpenRally (referencia)

Las etiquetas OpenRally van dentro del bloque extensions estándar de GPX de cada waypoint (wpt), en el namespace http://www.openrally.org/xmlschemas/GpxExtensions/v1.0.3, normalmente con el prefijo openrally.

• Ortografía de las unidades: el comentario del esquema dice “statute”, pero su lista de valores permitidos lo escribe “statue”. Acepta ambos al leer archivos.
• Nombres antiguos: algunos nombres de etiquetas antiguos se sustituyeron en la v1.0 y están comentados en el esquema. No los trates como vigentes.
• Extras de fabricantes: algunos editores añaden atributos o modos no estándar a la especificación. Los lectores deben ignorar las etiquetas y atributos desconocidos.

Cómo conseguir un archivo de roadbook OpenRally

Un archivo OpenRally se consigue de tres maneras: te lo envía el organizador (como descarga o por email, o asignado a tu dispositivo a través de una plataforma de distribución como RDS), lo descargas de una biblioteca de roadbooks, o creas el tuyo en un editor de roadbooks que exporte OpenRally GPX.

Del organizador

Algunos organizadores envían el archivo directamente. Otros lo distribuyen a través de una plataforma. Con RDS (Roadbook Delivery System, desarrollado y gestionado por TerraPirata), los organizadores importan roadbooks, por ejemplo de Rally Navigator, o archivos OpenRally (GPX), los asignan a los pilotos por Device ID o email y pueden definir franjas horarias, zonas de velocidad, seguimiento en directo y puntuación. Los roadbooks de competición suelen estar limitados en el tiempo o no ser compartibles a propósito.

De una biblioteca

TerraPirata ofrece a los usuarios de RDS una biblioteca gratuita de roadbooks de sus socios. En la F2R Roadbook App aparecen en “Public”.

Crea el tuyo

Estos editores de roadbooks tienen exportación OpenRally verificada:

• Rally Navigator: File > Export > OpenRally GPX. Rally Navigator también publica archivos OpenRally GPX de ejemplo.
• RiverNotes 2: incluye OpenRally entre sus formatos de exportación.
• Tulip: exporta OpenRally v1.0.2, con un modo Strict y un modo Undocumented.

¿Puedo convertir un PDF a OpenRally?

Para desarrolladores: cómo crear una herramienta o un visor que lea OpenRally

Para desarrolladores

Un archivo OpenRally es XML GPX 1.1. Analiza cada waypoint, lee los elementos OpenRally dentro de sus extensions, mantén las casillas en el orden del archivo, calcula la distancia parcial entre casillas y muestra las imágenes de tulipas y notas junto a las distancias, el CAP y los marcadores.

Pasos

1. Comprueba la versión del namespace OpenRally en la raíz del archivo y analízalo según esa versión. El README lo pide, y el proyecto usa versionado semántico.
2. Lee las unidades y la distancia total en las extensions de los metadatos.
3. Para cada waypoint (wpt), lee la latitud y la longitud, la distancia total y la distancia parcial (esta casilla menos la anterior, teniendo en cuenta cualquier reset), además de cap, danger y los marcadores de waypoint, zona y control con sus atributos open, clear y name.
4. Muestra los dibujos. El contenido es una data URL PNG en base64 o SVG en línea, normalmente en CDATA. No cargues nunca referencias externas: el archivo está pensado para funcionar sin conexión.
5. Durante el desarrollo, valida con el script validate.sh del repositorio, que ejecuta xmllint contra test_wrapper.xsd (que importa openrally.xsd y gpx-strict.xsd).
6. Sé tolerante: omite los comentarios XML y las extensiones de otros fabricantes, ignora las etiquetas desconocidas y acepta tanto “statute” como “statue”.
7. Deja la lógica de navegación en la app, no en el archivo: cuentakilómetros por GPS, alineación con la distancia de la casilla, apertura de un waypoint dentro de su radio open y validación dentro de su radio clear, y avisos de zona de velocidad entre dz y fz.

Ejemplo: leer las casillas con la biblioteca estándar 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

El example.gpx oficial es un muestrario de etiquetas, no un recorrido real, así que sus distancias no siguen una secuencia real. Prueba con una exportación real, como uno de los archivos OpenRally GPX de ejemplo de Rally Navigator. En un navegador, un visor puede hacer lo mismo con DOMParser y getElementsByTagNameNS, y mostrar las tulipas PNG en un elemento img con una data URL.

Recursos

• Repositorio de OpenRally (README, notas de versión y lista de correo)
• XSD de cross-country
• example.gpx
• validate.sh
• Borrador de rally de carretera (v0.3-DRAFT)
• Esquema GPX 1.1 (Topografix)
• Guía de cross-country de Rally Navigator
• Notas de exportación OpenRally de Tulip

Cargar un archivo OpenRally en el F2R Y1000 (F2R Roadbook App)

La F2R Roadbook App del Y1000 lee archivos OpenRally .GPX y admite todas las etiquetas OpenRally. Importa un archivo desde el almacenamiento local o recíbelo a través de RDS, asignado a tu Device ID o a tu cuenta. La app te ofrece entonces cuentakilómetros, CAP, avisos de zonas de velocidad y validación de waypoints a partir de los propios datos del archivo.

Desde un archivo local

1. En la F2R Roadbook App, toca ADD.
2. Elige el archivo .GPX en Descargas, Archivos, email, Google Drive, Dropbox o cualquier otra carpeta.
3. El roadbook aparece en “My Roadbooks”. Puedes borrar en la app los roadbooks cargados localmente.

A través de RDS

1. Crea una cuenta o inicia sesión en rds.terrapirata.com.
2. Vincula el Y1000 con su Device ID, que aparece en la app MyGamma, o con el email de la cuenta de Google usada en el dispositivo.
3. El organizador, o tú mismo, asigna los roadbooks. Aparecen en “Events” durante el periodo que fije el propietario, o en “Public”.

Solo el propietario puede gestionar los roadbooks de RDS, desde RDS. Los roadbooks compartidos con un Device ID solo aparecen en ese dispositivo; el Device ID es fijo, mientras que el email se puede cambiar.

Qué hace la app con los datos

• Cuentakilómetros principal y secundario, ajustables con pulsación larga, con pulsación larga sobre la distancia de una nota o con los mandos DR001 (moto) y DRA01 (coche). El Y1000 lleva tripmasters virtuales integrados.
• Rumbo CAP.
• Una flecha de waypoint que se abre dentro del radio de apertura del waypoint y se cierra cuando se valida el waypoint o sales del radio.
• Distancia hasta el waypoint y nombre del siguiente waypoint, que parpadea en verde durante la validación.
• Una tabla de waypoints con su estado, validado o no validado, y las horas.
• Colores del velocímetro en las zonas de velocidad: dentro del límite, acercándose a él o por encima.
• Tiempo de tramo desde la validación del DSS hasta la del ASS.
• El léxico FIM con pulsación larga.
• “Go to note” en una app GPS cuando el roadbook incluye coordenadas.

• Manual de usuario de la F2R Roadbook App (PDF)
• App F2R Roadbook
• Mandos a distancia

¿Y los PDF?

El Y1000 es un dispositivo Android completo, así que un roadbook en PDF se puede leer con una app de terceros compatible de Google Play; la Guía del usuario del Y1000 cita como ejemplo Rally Roadbook Reader, de Rally Navigator. Las funciones de navegación anteriores necesitan un archivo OpenRally.

Preguntas frecuentes