Een trainingssimulator toevoegen aan uw Bonsai werkruimte

  • Artikel
  • 7 minuten om te lezen

Trainingssimulaties zijn virtuele omgevingen die het gedrag van een fysieke omgeving modelleren en de interacties van objecten of agents die in die omgeving zijn gebaseerd, met het oog op het trainen van een AI-brein. De waarneembare status van een simulator is de gegevensset die de virtuele omgeving op een bepaald moment vertegenwoordigt. Normaal gesproken bevat de waarneembare status metingen die worden uitgevoerd door sensoren die zijn verbonden met een AI die wordt getraind, bijvoorbeeld camera's, temperatuurmeters of dieptesensoren.

Bij het programmeren is een container een uitvoerbare softwarebundel die alles bevat wat nodig is om een toepassing uit te voeren, inclusief ondersteunende bestanden of technologie die worden gebruikt om een stukje code uit te voeren. Als u het aantal simulator-exemplaren dat beschikbaar is voor machine teaching effectief wilt schalen, moet u de simulator 'containeriseren' voordat u deze toevoegt aan Bonsai .

Belangrijk

Steeds wanneer u simulators die worden beheerd door , worden er kosten in rekening gebracht Bonsai voor uw Azure-abonnement. Test uw simulator lokaal en controleer of deze werkt zoals verwacht voordat u gaat schalen.

Voordat u begint

  • U moet de Azure CLI hebben geïnstalleerd.
  • Docker moet zijn geïnstalleerd op uw lokale computer. De community-editie van Docker is beschikbaar voor Windows,Linuxen MacOS.
  • U moet lees-/schrijftoegang hebben tot Azure Container Registry (ACR). Bonsai biedt een standaard-ACR wanneer u een werkruimte inrichten onder dezelfde resourcegroep als de werkruimte.
  • U moet het hulpprogramma VPLinkSim_ 3 van Wood Group hebben. U kunt het hulpprogramma downloaden van de Cape Software GitHub-repo.

Stap 1: de simulator voorbereiden

Als u een VP Link-simulatie wilt toevoegen aan uw omgeving, moet u een BonsaiBonsaimaken,sim.zip, dat het volgende bevat:

  • vplink_interface.json:een JSON-bestand dat is gegenereerd door het hulpprogramma VPLinkSim_ 3. In het interfacebestand worden alle VP Link-tags beschreven die in uw Inkling-bestand worden gebruikt voor de SimState structuren SimAction en .
  • cfg:een map met een of meer tagbestanden (.tag) en optionele momentopnamebestanden (**.icf) voor uw VP Link-simulatie. Bonsai maakt gebruik van VP Link-momentopnamen om het simulatiemodel aan het begin van elke aflevering te initialiseren, zoals aangegeven door de instructies lesson in uw Inkling-code. Als u meerdere tagbestanden op te nemen, moeten de tags in elk bestand uniek zijn.
  • data:een map met alle andere bestanden die uw model nodig heeft om uit te voeren. Voor de meeste gebruikers is de gegevensmap leeg.
  • sces:een lege map. Bonsai gebruikt deze map om de VP Link-scenario's op te slaan die worden uitgevoerd tijdens een training of evaluatie.

Ga als volgende te werk om uw zip-bundel te maken:

  1. Voer het uitvoerbare VPLinkSim_ Bonsai 3 uit.
  2. Gebruik de knop Tags toevoegen aan status om de relevante tags voor uw simulatortoestanden te selecteren.
  3. Gebruik de knop Tags toevoegen aan knop om de relevante tags voor uw simulatoracties te selecteren.
  4. Druk op de knop Build Interface om het bestand vplink_interface.json te maken.
  5. Druk op de knop Laadbaar maken om uw sim.zip te maken voor uploaden.

Vp Link-hulpprogramma

  1. Download de Bonsai wrapper for Anylogic .
  2. Volg de instructies in het PDF-bestand Wrapper Model Workflow om de wrapper voor uw simulator te integreren en te configureren.
  1. Installeer de Microsoft Project Bonsai Simulink Toolbox
  2. Volg de instructies in het LEESMIJ-bestand om de werkset voor uw simulator te integreren en te configureren.

Als u uw aangepaste simulator wilt toevoegen, moet u deze verpakken als een Docker-container en toevoegen aan Azure Container Register (ACR).

  1. Maak een Dockerfile voor uw simulatiecode.
  2. Meld u aan bij Azure Container Registry (ACR)-exemplaar:
    az acr login --name ACR_NAME
  3. Bouw een afbeelding van uw Dockerfile met een unieke naam en versietag:
    az acr build             \
  --image IMAGE_NAME:TAG \
  --registry ACR_NAME    \
  --file Dockerfile .
  4. Controleer of het uploaden is geslaagd door de lijst met afbeeldingen in uw register te controleren:
    az acr repository list --name ACR_NAME --output table

Tip

Met de opdracht wordt de build als een taak rechtstreeks op ACR uitgevoerd en az acr build kan er een time-out worden gegeven bij het bouwen van een grote container. Als u vindt dat er een time-out is voor uw builds, gebruikt u de vlag om de time-outlimiet te verhogen.

Stap 2: de simulator toevoegen aan uw Bonsai werkruimte

Dit is het gemakkelijke deel!

  1. Klik op + Sim toevoegen naast de lijst Simulators in de gebruikersinterface.
  2. Selecteer 'VP Link' in de lijst met simulatortypen.
  3. Selecteer uw ZIP-bestand (sim.zip) voor uploaden.
  4. Geef een weergavenaam op voor het simulatorpakket.
  5. Klik op de knop Simulator maken om uw simulatorpakket toe te voegen aan de lijst Simulators.

VP Link sim upload

  1. Klik op + Sim toevoegen naast de lijst Simulators in de gebruikersinterface.
  2. Selecteer AnyLogic in de lijst met simulatortypen.
  3. Selecteer het AnyLogic-bestand dat u wilt uploaden.
  4. Geef een weergavenaam op voor het simulatorpakket.
  5. Klik op de knop Simulator maken om uw simulatorpakket toe te voegen aan de lijst Simulators.

Tip

AnyLogic bundelt uw simulator automatisch in één pakket dat alle vereiste bestanden bevat. In de map met geëxporteerde modellen kunt u de map chromium veilig verwijderen om schijfruimte te besparen.

AnyLogic Sim-upload

  1. Klik op + Sim toevoegen naast de lijst Simulators in de gebruikersinterface.
  2. Selecteer 'Simulink' in de lijst met simulatortypen.
  3. Selecteer uw Simulink-bestand om te uploaden.
  4. Geef een weergavenaam op voor het simulatorpakket.
  5. Klik op de knop Simulator maken om uw simulatorpakket toe te voegen aan de lijst Simulators.

Simulink sim upload

U kunt aangepaste simulators uploaden via de Bonsai gebruikersinterface of de CLI.

U kunt ook een ACR-afbeelding publiceren als een simulatorpakket met behulp van Bonsai CLI de . Bijvoorbeeld:

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

Tip

We raden de volgende standaardinstellingen aan voor de meeste simulators:

  • Kernen: 1
  • Geheugen: 1 GB
  • Besturingssysteem: Linux

Tip

Wanneer u een nieuwe simulator uploadt, kunt u automatisch Inkling-code genereren voor SimState - en SimAction -structuren. De gegenereerde code bevat opmerkingen voor elk lid van de SimState en SimAction die toegestane waarden en waardebereiken aangeven.

Stap 3: de simulator schalen

Belangrijk

Azure-quota zijn tegoedlimieten, geen capaciteitsgaranties. Als gevolg hiervan beperkt Azure het aantal container-exemplaren dat u kunt instellen op basis van uw abonnement. Azure-abonnementen beperken het resourcegebruik doorgaans binnen een bepaalde periode (elk uur met een bereik) of voor het hele abonnement. Als u behoefte hebt aan grootschalige capaciteit, moet u contact opnemen met ondersteuning voor Azure of uw Azure-quotum verhogen.

Zodra de simulator is geüpload naar uw werkruimte, kunt u deze toewijzen aan uw trainingssessie met Bonsai behulp van Inkling of de gebruikersinterface. Bonsai zal automatisch meerdere exemplaren van de simulator maken om op schaal te trainen.

  1. Selecteer het tabblad Leren om uw Inkling-bestand te openen.
  2. Zoek de simulator -component in Inkling.
  3. Wijs de package simulatornaam toe als de weergavenaam die u eerder hebt ingesteld:
    source simulator (Action: Action, Config: SimConfig): State {
package "example-sim"
}
  4. Klik op de knop Trainen om te beginnen met trainen.