Hoppa till innehåll

Förhandsgranska OpenSCENARIO-filer på GitHub — drawtonomys Chrome-tillägg

Det mesta av arbetet med OpenSCENARIO börjar på GitHub. Scenarierna ligger i ett repository och kommer in som pull requests, och för att förstå ett av dem krävs oftast att man klonar repot, sätter upp en simulator och kör filen bara för att se vad den gör.

drawtonomy for GitHub hoppar över allt det där. Det är ett gratis Chrome-tillägg som spelar upp .xosc-filer direkt på github.com — ingen nedladdning, ingen installation, ingen simulator.

Installera från Chrome Web Store →

Förhandsgranskning av esminis scenarier på GitHub, öppning av ett i editorn, redigering av en händelse och export av ett beskuret klipp.
Var det körsgithub.com — filsidor och mapplistningar
Vad det förhandsgranskarOpenSCENARIO .xosc-filer i publika repositories
Vad det löser upp automatisktVägnätet och fordonskatalogerna scenariot behöver
Vad det samlar inIngenting — ingen analys, inget konto krävs

Installera drawtonomy for GitHub från Chrome Web Store. Det finns inget att konfigurera och inget konto att skapa. Besök vilken GitHub-sida som helst med .xosc-filer så är det redo att användas.

drawtonomy for GitHub-listningen i Chrome Web Store, med scenariot lane_change.xosc förhandsgranskat direkt på en GitHub-filsida

Förhandsgranska ett scenario utan att lämna GitHub

Section titled “Förhandsgranska ett scenario utan att lämna GitHub”

Bläddra till ett publikt repository som innehåller OpenSCENARIO-filer — till exempel esmini/esmini, vars resources/-mapp innehåller dussintals exempelscenarier.

Var som helst en .xosc-fil (eller en mapp full av dem) dyker upp i en GitHub-listning ser du en liten ▶-markering. Mappar som innehåller scenarier visar också ett antal, så du vet hur många som finns innan du klickar.

En GitHub-mapplistning av esmini/resources, med play-markeringar och scenarioantal på mapparna xosc och scenario_construct_examples

Klicka på en markering så spelas scenariot upp direkt där — väg, fordon och hela händelsetidslinjen — i ett popup-fönster ovanpå sidan.

Scenariot cut-in.xosc som spelas upp i förhandsgranskningen på GitHub, med LOGIC-tidslinjen som visar händelser från CutInAndBrakeAct

Bläddrar du i en hel mapp? Använd knapparna ◀ ▶ (eller piltangenterna) för att gå till nästa scenario utan att stänga förhandsgranskningen. Klicka på filnamnet högst upp för att hoppa direkt till valfritt scenario i mappen från en lista, istället för att bläddra ett i taget. Om ett repository lagrar ett scenario per undermapp går klicket på en mapps markering igenom varje scenario i den och dess undermappar i en enda sekvens.

Öppnar du en .xosc-fil direkt (istället för en mapp) visas samma förhandsgranskning direkt på sidan, bredvid GitHubs Raw-, Copy- och Download-knappar.

TangentÅtgärd
EscStäng förhandsgranskningen
/ Föregående / nästa scenario
Flytta genom hopplistan
EnterÖppna valt scenario

Förhandsgranskningen visar vad ett scenario gör. När du vill ändra det, klicka på Open in drawtonomy för att skicka samma scenario till den fullständiga editorn i en ny flik — dess väg och eventuella kataloger den behöver är redan upplösta, så det är redo att spelas upp direkt.

Scenariot acc-test öppet i den fullständiga drawtonomy-editorn i en ny flik, med en toast som bekräftar att det öppnades från GitHub

Länken du landar på är en vanlig delbar URL — vem som helst kan öppna den, med eller utan tillägget.

När du väl är inne i editorn gör två inställningar ett scenario mycket enklare att följa:

  • Follow: Ego låser kameran på ego-fordonet, vilket spelar roll för importerade vägar som kan sträcka sig över flera kilometer.
  • Ghost lämnar ett spår av tidigare positioner, så en snabb manöver som en filbytesmanöver blir en tydlig helhetsbild istället för något du måste hinna uppfatta i stunden.

Scenariot acc-test som spelas upp i 4x hastighet med Follow Ego och ghost-spår som visar filbytesmanövern

Se Uppspelning för hela uppsättningen uppspelningskontroller.

Ett importerat scenario är inte skrivskyddat. Klicka på valfritt händelsekort för att öppna händelseeditorn och ändra dess trigger eller action, spela sedan upp igen för att se det nya beteendet.

Händelseeditorn öppen på LaneChange2Event, med dess simuleringstidstrigger och action Change Lane

Det redigerade scenariot uppspelat igen, med ghost-spåret som visar det ändrade filbytesbeteendet

Se Actions och Triggers för vad varje alternativ gör.

Exportera ett klipp av bara den del som spelar roll

Section titled “Exportera ett klipp av bara den del som spelar roll”

Du behöver sällan hela körningen — oftast bara de få sekunder där något intressant händer. Export video spelar in exakt det som en .webm-fil, redo att släppas in i en pull request-kommentar, ett ärende eller en granskningspresentation.

Panelen EXPORT VIDEO med bildförhållande, kamera, radie, ghost och ett Trim-intervall från 3.85 s till 8.33 s

Sätt Range till Trim, dra de två handtagen på tidslinjen till den tidpunkt du vill ha, och klicka på Start. Du kan också välja bildförhållande, om kameran ska följa ego-fordonet eller visa hela scenen, och om ghost-spår ska ingå i inspelningen.

Den exporterade .webm-filen som spelas upp i en webbläsarflik

Tillägget samlar inte in något — ingen analys, inget konto, inget skickas till en egen server. Att förhandsgranska en fil är detsamma som att öppna scenariot på drawtonomy.com i en ny flik. Fullständiga detaljer: Chrome-tilläggets integritetspolicy.

  • Endast publika repositories. Privata repon stöds inte.
  • Endast .xosc-filer — en fristående .xodr-vägfil går ännu inte att förhandsgranska på egen hand.
  • Scenarier som refererar till en Windows-stil sökväg eller en simulators inbyggda karta (istället för en .xodr i samma repository) kan inte lösa upp sin väg automatiskt; drawtonomy ber dig då ange en.
  • Förhandsgranskningsknappar visas för närvarande inte i pull requests “Files changed”-diffar — öppna filen direkt istället.

Du kan ändra vilken app-URL förhandsgranskningen laddas från, och slå på automatisk förhandsgranskning, från tilläggets alternativsida (verktygsfältets popup → Options).

Allt tillägget gör kan du också göra med en länk. Lägg till en GitHub-fil-URL efter ?open=:

https://drawtonomy.com/?open=https://github.com/esmini/esmini/blob/master/resources/xosc/cut-in.xosc

Öppna esminis cut-in-scenario →

Den länken fungerar för alla, med eller utan tillägget — praktiskt när du delar ett scenario med en kollega. Se Öppna och spela upp en .xosc.