FAQ — drawtonomy, la lavagna per scenari di guida autonoma

Posso usare drawtonomy per disegnare figure per un articolo, una slide o un documento sulla guida autonoma?

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?

Sì. drawtonomy authoring ASAM OpenDRIVE 1.8 e OpenSCENARIO 1.2 visivamente, ed esegue lo scenario nel browser. Disegni la scena — corsie, incroci, veicoli — poi costruisci lo storyboard con 35 azioni e 19 condizioni di trigger, imposti condizioni END / FAIL, e lo riproduci su esmini compilato a WebAssembly con verdetto PASS / FAIL — nessuna installazione. Puoi anche importare un .xosc esistente, modificarlo visivamente e riproiettarlo, o esportare .xodr + .xosc per un’esecuzione nativa di esmini. Vedi l’editor di scenari e 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. Gestisce mappe di grandi dimensioni, e per una modifica rapida su una piccola sezione puoi importare solo le corsie di cui hai bisogno. 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?

Il .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 condividere un diagramma drawtonomy con un link?

Sì. Apri il menu, fai clic su Export, quindi Copy URL, e drawtonomy compatta l’intera scena — corsie, veicoli, connessioni, e l’origine della mappa — in un singolo link. Invialo in chat, email o in una issue su GitHub, e chiunque lo apra vede la figura esatta nel suo browser, completamente modificabile. Nessun account, nessun caricamento e niente viene archiviato su un server — il diagramma è codificato nell’URL stesso. Seleziona prima le forme per condividere solo parte di una scena. Scene molto grandi ricadono su un link locale dello stesso browser; condividi quelle come un file .drawtonomy.svg. Vedi Condividere un diagramma tramite URL.

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?

Sì. drawtonomy gestisce reti stradali di grandi dimensioni, quindi puoi importare e modificare mappe di notevoli dimensioni. Per una modifica rapida su una piccola sezione, importare solo le corsie o le strade di cui hai bisogno mantiene l’editor al massimo della velocità.

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

Sì. Il 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 attualmente. drawtonomy authoring e esecuzione OpenSCENARIO 1.x XML — esportando le versioni 1.0-1.2 oggi (1.3 in arrivo presto) — che è ciò che la maggior parte dei simulatori (CARLA, esmini, IPG CarMaker) consumano oggi. OpenSCENARIO 2.0 / DSL e M-SDL sono linguaggi parametrici diversi per generare flotte di scenari — un livello diverso dall’authoring di scenari singoli che drawtonomy fa, e non implementati.

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ì — e può eseguirli. Cut-in, cambio corsia, svolta a sinistra non protetta, immissione in rotatoria, attraversamento pedonale, frenata del veicolo di testa e scenari analoghi iniziano inserendo il template stradale e posizionando ego e altri attori. Da lì aggiungi azioni e condizioni di trigger, imposti una condizione PASS / FAIL, e riproduci lo storyboard nel browser su esmini-WASM. 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.