Roadbook digital vs PDF ou papel: os ficheiros de roadbook OpenRally explicados

Um roadbook em papel é um rolo impresso, e um roadbook em PDF é uma imagem desse rolo num ecrã. Um roadbook digital em formato OpenRally é diferente: o próprio ficheiro indica ao dispositivo a distância de cada caixa, o CAP, os waypoints e os respetivos raios de validação e as zonas de velocidade, com os desenhos de tulipas e notas incorporados. É isso que permite a um roadbook digital manter o odómetro alinhado, validar waypoints e avisá-lo nas zonas de velocidade.

Roadbook digital vs PDF vs papel: qual é a diferença?

Os roadbooks em papel e em PDF mostram o percurso como imagens que o piloto tem de interpretar. Um roadbook digital em formato OpenRally guarda o mesmo percurso como dados: cada caixa tem a sua distância, CAP, informação de waypoint e de zona de velocidade, com os desenhos incorporados. São esses dados que permitem ao dispositivo alinhar o odómetro, validar waypoints e alertá-lo nas zonas de velocidade.

Porque é que um PDF não é “digital” no sentido da navegação

Num ecrã, um roadbook em PDF parece igual ao papel, mas o dispositivo não consegue ler distâncias, CAP ou waypoints a partir de uma imagem. Consegue mostrar a página. Não consegue validar um waypoint, alinhar o odómetro com uma caixa nem avisá-lo numa zona de velocidade.

O papel, em resumo

Tradicionalmente, os roadbooks de rally eram impressos num rolo de papel e avançados caixa a caixa. É do papel que vem o formato: as mesmas caixas, tulipas e notas que um roadbook digital mostra hoje. A diferença é que, no papel, cada número tem de ser lido e comparado pelo piloto.

O que é o OpenRally?

O OpenRally é um standard aberto e comunitário para a troca eletrónica de dados de roadbooks de rally. Estende o GPX, o formato de ficheiro GPS mais comum, com tags específicas de rally (distâncias, CAP, tipos e raios de waypoints, zonas de velocidade, controlos) e incorpora os desenhos de tulipas e notas em PNG ou SVG, para que um único ficheiro contenha o roadbook completo.

Quem criou o OpenRally

O OpenRally foi cofundado pela ICO Racing e pela F2R, que definiram a sua nomenclatura e estrutura iniciais. Dave Peckham, da Rally Navigator, escreveu o código da especificação. Hoje é um standard comunitário mantido pelas empresas que o utilizam, incluindo fabricantes de software de roadbook, organizadores e fabricantes de dispositivos.

Porquê GPX?

O README do OpenRally apresenta três razões: o GPX é o formato de ficheiro de georreferenciação mais comum, existem muitas ferramentas de conversão e foi concebido para ser estendido. O OpenRally é um formato de intercâmbio, por isso cada aplicação é livre de guardar os dados internamente como entender.

Versões

As notas de versão abrangem a v1.0.0, que separou as tags de todo-o-terreno (cross-country) das de rally de estrada, removeu tags duplicadas, definiu valores por defeito segundo a FIM ou os regulamentos em vigor e acrescentou os desenhos de tulipas e notas em PNG base64 ou SVG, e a v1.0.2, que acrescentou o marcador show_coordinates. O schema atual usa o namespace v1.0.3 (última versão etiquetada: v1.0.2). O OpenRally 1.x abrange o rally todo-o-terreno; o rally de estrada está num ramo separado, v0.3-DRAFT.

O que um ficheiro OpenRally inclui, e o que não inclui

Um ficheiro OpenRally guarda as caixas do roadbook do percurso como waypoints GPX. Cada uma tem a sua distância e pode ainda incluir o CAP, um nível de perigo, um tipo de waypoint com os respetivos raios, marcadores de zona de velocidade e de controlo, e os desenhos de tulipas e notas. Não inclui controlo de acesso, penalizações ou regras de pontuação, mapas nem o regulamento da prova.

O que inclui (segundo o schema e o ficheiro de exemplo oficiais)

• Cabeçalho: as unidades (métricas ou imperiais, “statute”) e a distância total do percurso, nas extensions dos metadados.
• Cada caixa: um waypoint GPX cujas extensions guardam a sua distância, o único elemento obrigatório em todas as caixas.
• Rumo e perigo: cap e danger, com níveis de perigo de 1 a 3.
• Waypoints: tipos de waypoint com um raio de abertura (open), um raio de validação (clear) e um nome.
• Setor seletivo: marcadores de início e fim (dss e ass).
• Zonas de velocidade: início de zona, limite de velocidade e fim de zona (dz, speed e fz).
• Ligações: início e fim de um setor de ligação (dt e ft).
• Controlos e marcadores: stop, neutralização e o seu fim (neutralization e fn), controlo horário com os minutos permitidos até ao seguinte (timecontrol), checkpoint, combustível e reposição do odómetro.
• Meios de segurança e o marcador show_coordinates.
• Desenhos: as imagens tulip e notes.

Os elementos GPX normais também se aplicam, como a latitude e a longitude de cada waypoint. Se um ficheiro inclui também o traçado completo depende das definições de exportação do editor.

O que não inclui (o schema v1.x não tem nenhum elemento para)

• Quem pode abrir o ficheiro, ou durante quanto tempo. O controlo de acesso fica a cargo das plataformas de distribuição (o RDS, por exemplo, oferece roadbooks não partilháveis e acesso limitado no tempo).
• Penalizações, regras de pontuação ou o regulamento da prova. O único elemento de tempo é timecontrol allowed, os minutos até ao controlo seguinte.
• O léxico de símbolos da FIM ou da FIA. Os desenhos são imagens incorporadas, não códigos de símbolos.
• Mapas ou mosaicos de mapa.
• Notas como texto pesquisável. As notas são desenhos, embora um desenho SVG possa conter texto.
• Uma assinatura digital ou verificação de integridade.
• Regras sobre o comportamento do dispositivo. O schema guarda raios e marcadores; cada dispositivo decide como os mostra e como valida com base neles.

Tags e atributos OpenRally (referência)

As tags OpenRally ficam dentro do bloco extensions normal do GPX de cada waypoint (wpt), no namespace http://www.openrally.org/xmlschemas/GpxExtensions/v1.0.3, normalmente com o prefixo openrally.

• Grafia das unidades: o comentário do schema diz “statute”, mas a lista de valores permitidos escreve “statue”. Aceite ambos ao ler ficheiros.
• Nomes antigos: alguns nomes de tags mais antigos foram substituídos na v1.0 e estão comentados no schema. Não os trate como atuais.
• Extras de fabricantes: alguns editores acrescentam atributos ou modos não normalizados à especificação. Os leitores devem ignorar tags e atributos desconhecidos.

Como obter um ficheiro de roadbook OpenRally

Há três formas de obter um ficheiro OpenRally: o organizador envia-o (por download ou email, ou atribuído ao seu dispositivo através de uma plataforma de distribuição como o RDS), descarrega-o de uma biblioteca de roadbooks, ou cria o seu num editor de roadbooks que exporte OpenRally GPX.

Do organizador

Alguns organizadores enviam o ficheiro diretamente. Outros distribuem-no através de uma plataforma. Com o RDS (Roadbook Delivery System, desenvolvido e gerido pela TerraPirata), os organizadores importam roadbooks, por exemplo do Rally Navigator, ou ficheiros OpenRally (GPX), atribuem-nos aos pilotos por Device ID ou email e podem definir janelas de tempo, zonas de velocidade, live tracking e pontuação. Os roadbooks de competição são muitas vezes, por definição, limitados no tempo ou não partilháveis.

De uma biblioteca

A TerraPirata oferece aos utilizadores do RDS uma biblioteca gratuita de roadbooks de parceiros. Na F2R Roadbook App, estes aparecem em “Public”.

Crie o seu

Estes editores de roadbooks têm exportação OpenRally verificada:

• Rally Navigator: File > Export > OpenRally GPX. O Rally Navigator também publica ficheiros OpenRally GPX de exemplo.
• RiverNotes 2: inclui o OpenRally entre os seus formatos de exportação.
• Tulip: exporta OpenRally v1.0.2, com um modo Strict e um modo Undocumented.

Posso converter um PDF em OpenRally?

Para programadores: como criar uma ferramenta ou visualizador que leia OpenRally

Para programadores

Um ficheiro OpenRally é XML GPX 1.1. Analise cada waypoint, leia os elementos OpenRally dentro das suas extensions, mantenha as caixas pela ordem do ficheiro, calcule a distância parcial entre caixas e apresente as imagens das tulipas e notas junto às distâncias, ao CAP e aos marcadores.

Passos

1. Verifique a versão do namespace OpenRally na raiz do ficheiro e faça a análise de acordo com ela. O README pede isto, e o projeto usa versionamento semântico.
2. Leia as unidades e a distância total nas extensions dos metadados.
3. Para cada waypoint (wpt), leia a latitude e a longitude, a distância total e a distância parcial (esta caixa menos a anterior, tendo em conta qualquer reset), bem como cap, danger e os marcadores de waypoint, zona e controlo com os seus atributos open, clear e name.
4. Apresente os desenhos. O conteúdo é um data URL PNG em base64 ou SVG inline, normalmente em CDATA. Nunca vá buscar referências externas: o ficheiro foi concebido para funcionar offline.
5. Durante o desenvolvimento, valide com o script validate.sh do repositório, que corre o xmllint contra o test_wrapper.xsd (este importa o openrally.xsd e o gpx-strict.xsd).
6. Seja tolerante: ignore comentários XML e extensões de outros fabricantes, ignore tags desconhecidas e aceite tanto “statute” como “statue”.
7. Mantenha a lógica de navegação na aplicação, não no ficheiro: odómetro por GPS, alinhamento com a distância da caixa, abertura de um waypoint dentro do seu raio open e validação dentro do seu raio clear, e alertas de zona de velocidade entre dz e fz.

Exemplo: ler as caixas com a biblioteca padrão 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

O example.gpx oficial é uma montra de tags, não um percurso real, por isso as suas distâncias não seguem uma sequência real. Teste com uma exportação real, como um dos ficheiros OpenRally GPX de exemplo do Rally Navigator. Num browser, um visualizador pode fazer o mesmo com DOMParser e getElementsByTagNameNS, e mostrar as tulipas PNG num elemento img com um data URL.

Recursos

• Repositório OpenRally (README, notas de versão e lista de correio)
• XSD de todo-o-terreno (cross-country)
• example.gpx
• validate.sh
• Rascunho de rally de estrada (v0.3-DRAFT)
• Schema GPX 1.1 (Topografix)
• Guia de todo-o-terreno do Rally Navigator
• Notas de exportação OpenRally do Tulip

Carregar um ficheiro OpenRally no F2R Y1000 (F2R Roadbook App)

A F2R Roadbook App no Y1000 lê ficheiros OpenRally .GPX e suporta todas as tags OpenRally. Importe um ficheiro do armazenamento local ou receba-o através do RDS, atribuído ao seu Device ID ou à sua conta. A aplicação dá-lhe então odómetros, CAP, alertas de zonas de velocidade e validação de waypoints a partir dos próprios dados do ficheiro.

A partir de um ficheiro local

1. Na F2R Roadbook App, toque em ADD.
2. Escolha o ficheiro .GPX em Transferências, Ficheiros, email, Google Drive, Dropbox ou qualquer outra pasta.
3. O roadbook aparece em “My Roadbooks”. Pode apagar na aplicação os roadbooks carregados localmente.

Através do RDS

1. Crie uma conta ou inicie sessão em rds.terrapirata.com.
2. Associe o Y1000 através do seu Device ID, indicado na aplicação MyGamma, ou do email da conta Google usada no dispositivo.
3. O organizador, ou o próprio piloto, atribui os roadbooks. Aparecem em “Events” durante o período definido pelo proprietário, ou em “Public”.

Só o proprietário pode gerir os roadbooks RDS, a partir do RDS. Os roadbooks partilhados para um Device ID só aparecem nesse dispositivo; o Device ID é fixo, enquanto o email pode ser alterado.

O que a aplicação faz com os dados

• Odómetros principal e secundário, ajustáveis com toque longo, com toque longo na distância de uma nota, ou com os comandos DR001 (moto) e DRA01 (carro). O Y1000 tem tripmasters virtuais integrados.
• Rumo CAP.
• Uma seta de waypoint que abre dentro do raio de abertura do waypoint e fecha quando o waypoint é validado ou quando sai do raio.
• Distância até ao waypoint e nome do waypoint seguinte, que pisca a verde durante a validação.
• Uma tabela de waypoints com o estado validado ou falhado, com as horas.
• Cores do velocímetro nas zonas de velocidade: dentro do limite, a aproximar-se dele ou acima dele.
• Tempo de setor desde a validação do DSS até à do ASS.
• O léxico FIM com toque longo.
• “Go to note” numa aplicação GPS quando o roadbook inclui coordenadas.

• Manual do utilizador da F2R Roadbook App (PDF)
• App F2R Roadbook
• Comandos remotos

E os PDFs?

O Y1000 é um dispositivo Android completo, por isso um roadbook em PDF pode ser lido com uma aplicação de terceiros compatível do Google Play; o Guia do Utilizador do Y1000 dá como exemplo o Rally Roadbook Reader, da Rally Navigator. As funções de navegação acima precisam de um ficheiro OpenRally.

FAQ