Lägga till en träningssimulator till din Bonsai arbetsyta

  • Artikel
  • 6 minuter för att läsa

Träningssimuleringar är virtuella miljöer som modellerar beteendet för en fysisk miljö och interaktioner mellan objekt eller agenter som är baserade i den miljön för att kunna träna en AI-hjärna. Det observerbara tillståndet för en simulator är den datauppsättning som representerar den virtuella miljön vid en viss tidpunkt. Det observerbara tillståndet omfattar vanligtvis mätningar som skulle göras av sensorer som är anslutna till en AI som tränas, till exempel kameror, temperaturmätare eller djupsensorer.

Vid programmering är en container ett körbart programpaket som innehåller allt som behövs för att köra ett program, inklusive eventuella stödfiler eller teknik som används för att köra ett kodstycke. För att effektivt skala antalet simulatorinstanser som är tillgängliga för maskinlärning måste du "containerisera" simulatorn innan du lägger till den i Bonsai .

Viktigt

Varje gång du kör simulatorer som hanteras av Bonsai debiteras din Azure-prenumeration. Testa simulatorn lokalt och bekräfta att den fungerar som förväntat före skalningen.

Innan du börjar

  • Du måste ha Azure CLI installerat.
  • Du måste ha Docker installerat på den lokala datorn. Community-versionen av Docker är tillgänglig för Windows,Linuxoch MacOS.
  • Du måste ha läs-/skrivbehörighet till Azure Container Registry (ACR). Bonsai tillhandahåller en standard-ACR när du etablerar en arbetsyta under samma resursgrupp som arbetsytan.

Steg 1: Förbered simulatorn

Om du vill lägga till en VP Link-simulering i din miljö måste du skapa Bonsai en Bonsai, som innehåller följande:

  • vplink_interface.json:en JSON-fil som genererats av VPLinkSim_ 3-verktyget. Gränssnittsfilen beskriver alla VP Link-taggar som används i indelningsfilen för SimState strukturerna och SimAction .
  • cfg:en katalog som innehåller en eller flera taggfiler (.tag)och valfria ögonblicksbildsfiler (**.icf) för din VP Link-simulering. Bonsai använder VP Link-ögonblicksbilder för att initiera simuleringsmodellen i början av varje avsnitt, vilket anges av lesson -isatserna i indikeringskoden. Om du inkluderar flera taggfiler ska taggarna i varje fil vara unika.
  • data:en katalog som innehåller andra filer som din modell behöver köra. För de flesta användare är datakatalogen tom.
  • sces:en tom katalog. Bonsai använder den här katalogen för att spara VP Link-scenarierna som körs under ett tränings- eller utvärderingsavsnitt.

Så här skapar du zip-paketet:

  1. Kör den körbara VPLinkSim_ Bonsai 3.
  2. Använd knappen Lägg till taggar i tillstånd för att välja relevanta taggar för simulatortillstånden.
  3. Använd knappen Lägg till taggar till knapp för att välja relevanta taggar för dina simulatoråtgärder.
  4. Tryck på knappen Build Interface (Skapa gränssnitt) för att skapa vplink_interface.json-filen.
  5. Tryck på knappen Skapa inläsningsbar för att skapa sim.zip fil för uppladdning.

VP Link-verktyg

  1. Ladda ned Bonsai wrapper for Anylogic .
  2. Följ anvisningarna i PDF-filen för wrapper-modellarbetsflödet för att integrera och konfigurera omslutningsmodellen för simulatorn.
  1. Installera Microsoft Project Bonsai Simulink Toolbox
  2. Följ anvisningarna i README-filen för att integrera och konfigurera verktygslådan för simulatorn.

Om du vill lägga till en anpassad simulator måste du paketera den som en Docker-container och lägga till den i Azure Container Register (ACR).

  1. Skapa en Dockerfile för simuleringskoden.
  2. Logga in på din Azure Container Registry instans (ACR):
    az acr login --name ACR_NAME
  3. Skapa en avbildning från din Dockerfile med ett unikt namn och en versionstagg:
    az acr build             \
  --image IMAGE_NAME:TAG \
  --registry ACR_NAME    \
  --file Dockerfile .
  4. Kontrollera att uppladdningen lyckades genom att kontrollera listan över avbildningar i registret:
    az acr repository list --name ACR_NAME --output table

Tips

Kommandot az acr build kör bygget som en uppgift direkt på ACR och kan timeout när du skapar en stor container. Om tidsgränsen för dina byggen är över kan du använda flaggan för att öka tidsgränsen.

Steg 2: Lägg till simulatorn på din Bonsai arbetsyta

Det här är den enkla delen!

  1. Klicka på + Lägg till sim bredvid simulatorlistan i användargränssnittet.
  2. Välj "VP Link" i listan över simulatortyper.
  3. Välj ZIP-filen för VP Link (sim.zip) för uppladdning.
  4. Ange ett visningsnamn för simulatorpaketet.
  5. Klicka på knappen Skapa simulator för att lägga till simulatorpaketet i listan Simulatorer.

VP Link sim upload

  1. Klicka på + Lägg till sim bredvid simulatorlistan i användargränssnittet.
  2. Välj "AnyLogic" i listan över simulatortyper.
  3. Välj din AnyLogic-fil för uppladdning.
  4. Ange ett visningsnamn för simulatorpaketet.
  5. Klicka på knappen Skapa simulator för att lägga till simulatorpaketet i listan Simulatorer.

Tips

AnyLogic paketerar automatiskt simulatorn i ett enda paket som innehåller alla nödvändiga filer. I den exporterade modellmappen kan du på ett säkert sätt ta bort mappen chromium för att spara på diskutrymmet.

AnyLogic sim upload

  1. Klicka på + Lägg till sim bredvid simulatorlistan i användargränssnittet.
  2. Välj "Simulink" i listan över simulatortyper.
  3. Välj din Simulink-fil för uppladdning.
  4. Ange ett visningsnamn för simulatorpaketet.
  5. Klicka på knappen Skapa simulator för att lägga till simulatorpaketet i listan Simulatorer.

Simulink sim upload

Du kan ladda upp anpassade simulatorer via Bonsai användargränssnittet eller CLI.

Du kan också publicera en ACR-avbildning som ett simulatorpaket med hjälp av Bonsai CLI . Exempel:

bonsai simulator package container create -n clientmoabdemo:latest \
   -u bonsaisimdev.azurecr.io/clientmoabdemo:latest \
   --i 500 \
   --min-instance-count 50 \
   --max-instance-count 500 \
   -r 0.25 \
   -m 0.5 \
   --auto-scale True \
   -p Linux

Tips

Vi rekommenderar följande standardinställningar för de flesta simulatorer:

  • Kärnor: 1
  • Minne: 1 GB
  • Operativsystem: Linux

Tips

När du laddar upp en ny simulator kan du automatiskt generera Inskt-kod för SimState strukturerna SimAction och . Den genererade koden innehåller kommentarer för varje medlem i SimState och SimAction som anger tillåtna värden och värdeintervall.

Steg 3: Skala simulatorn

Viktigt

Azure-kvoter är kreditgränser, inte kapacitetsgarantier. Därför begränsar Azure antalet containerinstanser som du kan sätta upp baserat på din prenumeration. Azure-prenumerationer begränsar vanligtvis resursanvändningen under en viss tidsperiod (per timme) eller över hela prenumerationen. Om du har storskaliga kapacitetsbehov bör du kontakta Azure-supporten eller öka din Azure-kvot.

När simulatorn har laddats upp till Bonsai arbetsytan kan du tilldela den till din träningssession med hjälp av Inkling eller användargränssnittet. Bonsai startar automatiskt flera instanser av simulatorn för att träna i stor skala.

  1. Välj fliken Teach (Lär) för att öppna indelningsfilen.
  2. Hitta simulator -satsen i Inkling.
  3. Tilldela simulatornamnet package till det visningsnamn som du konfigurerade tidigare:
    source simulator (Action: Action, Config: SimConfig): State {
package "example-sim"
}
  4. Klicka på knappen Träna för att börja träna.