FAQ — drawtonomy, la lavagna per scenari di guida autonoma

Posso usare drawtonomy per figure su guida autonoma in articoli o slide?

Sì — è uno dei casi d’uso principali. Corsie, incroci, veicoli e pedoni sono forme integrate, quindi una figura per uno scenario di guida che richiederebbe mezz’ora con uno strumento generico si realizza in pochi minuti. Esporta come .drawtonomy.svg, PDF o EPS per LaTeX, presentazioni e Markdown.

drawtonomy è gratuito?

Sì. drawtonomy.com gira interamente nel tuo browser. Nessun account, nessuna installazione e niente viene caricato online. L’SDK e le estensioni sono open source su GitHub.

drawtonomy è un editor gratuito di OpenSCENARIO e OpenDRIVE?

drawtonomy è una lavagna che esporta verso ASAM OpenDRIVE 1.8 e OpenSCENARIO 1.3, incluso un bundle zip unico pronto per la riproduzione con esmini. Disegni la scena visivamente — corsie, incroci, veicoli, percorsi — e drawtonomy genera i file .xodr e .xosc. Vedi Esporta verso OpenDRIVE / OpenSCENARIO / esmini.

drawtonomy può modificare le mappe Lanelet2 (.osm) nel browser?

Sì. drawtonomy può importare file OSM Lanelet2 (incluse le mappe campione di Autoware), modificare visivamente la geometria delle corsie e le connessioni, ed esportare di nuovo in Lanelet2 OSM. Per prestazioni ottimali, mantieni le importazioni sotto le 500 corsie circa per scena. Vedi Importare un file Lanelet2 (.osm).

Posso importare una mappa di griglia di occupazione ROS?

Sì. drawtonomy legge il formato map_server di ROS (.pgm + .yaml) usato da nav2, Cartographer, Gmapping e strumenti SLAM simili. La griglia viene visualizzata come livello di sfondo per disegnare corsie, percorsi e ostacoli direttamente sopra. Vedi Importare una OccupancyGrid ROS.

In cosa drawtonomy è diverso dagli strumenti di disegno generici?

Gli strumenti generici conoscono solo forme generiche, quindi una corsia è soltanto un rettangolo da ridisegnare ogni volta che la strada curva. drawtonomy include corsie, incroci, attraversamenti pedonali, semafori, segnaletica orizzontale, veicoli e pedoni come forme integrate, e le corsie portano connessioni Next / Previous / Left / Right. Trascina un bordo e le corsie collegate seguono. Vedi Perché drawtonomy e il modello di connessione delle corsie.

Devo installare qualcosa?

No. drawtonomy gira in qualsiasi browser web moderno. Apri drawtonomy.com e inizia a disegnare. Gli sviluppatori di estensioni possono anche usare il dev server locale (@drawtonomy/dev-server), che ospita l’editor su localhost.

drawtonomy può generare uno scenario di guida dal linguaggio naturale?

Sì. L’estensione AI Scene Generator legge un prompt in linguaggio naturale o XML OpenSCENARIO e produce un canvas modificabile — corsie, veicoli, percorsi e pedoni come normali forme drawtonomy. Supporta Anthropic Claude, OpenAI GPT e Google Gemini.

Quale formato di file mantiene una scena drawtonomy modificabile?

.drawtonomy.svg — il formato SVG nativo di drawtonomy. È un normale file SVG — visualizzabile in browser, GitHub, presentazioni e renderer Markdown — con metadati che drawtonomy usa per ricostruire ogni forma, connessione, punto condiviso e relazione di sovrapposizione quando riapri il file. Salvare come .drawtonomy.svg di default ti dà sia un SVG visualizzabile che un sorgente modificabile in un unico file. Vedi Esporta la tua scena e il riferimento al formato .drawtonomy.svg.

Posso aggiungere i miei template di veicoli o segnali?

Sì. I template sono SVG registrati in templates/manifest.json. Inserisci il tuo nella cartella corretta (vehicle, pedestrian, road_marking, sign, other), apri una PR e verrà incluso nel menu dell’editor accanto ai template integrati. Vedi Contribuire con template.

drawtonomy supporta reti stradali di grandi dimensioni?

drawtonomy è ottimizzato per i diagrammi piuttosto che per mappe a scala urbana. Per una modifica fluida, mantieni una singola scena sotto le 500 corsie circa. Per aree più grandi, suddividi il lavoro in più file o importa solo la regione necessaria.

Posso usare i diagrammi drawtonomy in articoli, slide o documentazione?

Sì. Il formato drawtonomy.svg è SVG valido, quindi si integra in articoli, slide, Markdown e siti web senza conversione. PDF, PNG, JPG ed EPS sono disponibili anche per le pipeline di pubblicazione tradizionali.

drawtonomy è open source?

L’SDK drawtonomy, il framework per le estensioni, i template e questo sito di documentazione sono open source su GitHub. L’applicazione drawtonomy.com è source-available, con SDK ed estensioni come superficie OSS su cui costruire.

drawtonomy carica i miei disegni o dati di scena su un server?

No. drawtonomy gira interamente nel tuo browser. La scena vive nella memoria del browser e nel tuo file system locale quando salvi. Niente viene caricato — nessun account, nessuna telemetria sui dati delle forme, nessuna sincronizzazione cloud. L’estensione AI Scene Generator invia i prompt al provider LLM che configuri (Claude, GPT o Gemini), ma solo il testo del prompt — non la scena esistente.

Posso usare drawtonomy offline?

Sì, dopo il primo caricamento. drawtonomy.com è una single-page application — una volta caricata nel browser, puoi continuare a modificare e salvare senza connessione. Riapri il file drawtonomy.svg salvato in seguito per continuare. I tile satellitari e l’estensione AI Scene Generator sono le uniche funzionalità che richiedono la rete.

drawtonomy supporta OpenSCENARIO 2.0 / DSL?

Non ancora. drawtonomy esporta XML OpenSCENARIO 1.3, la versione consumata oggi dalla maggior parte dei simulatori (CARLA, esmini, IPG CarMaker). OpenSCENARIO 2.0 / DSL è un linguaggio parametrico diverso ed è nella roadmap, ma non ancora implementato.

drawtonomy può essere usato come canvas infinito per scenari di guida?

Sì. drawtonomy è un canvas infinito con pan e zoom, ottimizzato per gli scenari di guida. Naviga su layout di qualsiasi dimensione, inserisci sfondi satellitari o roadmap per tracciare da luoghi reali, e il sistema di snap e punti condivisi mantiene la geometria delle corsie allineata senza ritocchi manuali.

drawtonomy può schizzare scenari ADAS come cut-in, cambio corsia o svolta a sinistra non protetta?

Sì. Questi sono schizzi di routine in drawtonomy. Cut-in, cambio corsia, svolta a sinistra non protetta, immissione in rotatoria, attraversamento pedonale, frenata del veicolo di testa e scenari funzionali o logici analoghi si disegnano inserendo il template stradale, posizionando ego e altri attori, e aggiungendo frecce di percorso per le traiettorie. Vedi Schizzare scenari di test ADAS per un esempio completo.

Dov’è il codice sorgente?

L’SDK, le estensioni, i template e questo sito di documentazione sono su github.com/kosuke55/drawtonomy. L’applicazione vera e propria è su drawtonomy.com.