Přidání trénovací simulátoru do pracovního Bonsai prostoru

Trénovací simulace jsou virtuální prostředí, která modeluje chování fyzického prostředí a interakce objektů nebo agentů založených v tomto prostředí pro trénování mozku SI. Pozorovatelný stav simulátoru je datová sada, která představuje virtuální prostředí v daném bodu v čase. Pozorovatelný stav obvykle zahrnuje měření pořízená senzory připojenými k natrénované AI, například fotoaparáty, měřidla teploty nebo senzory hloubky.

V programování je kontejner spustitelný softwarový balíček, který zahrnuje vše potřebné ke spuštění aplikace, včetně podpůrných souborů nebo technologií používaných ke spuštění části kódu. Pokud chcete efektivně škálovat počet instancí simulátoru dostupných pro strojové učení, musíte simulátor před přidáním do kontejneru "kontejnerizovat". Bonsai

Důležité

Kdykoli spustíte simulátory spravované službou , bude se vám účtovat Bonsai předplatné Azure. Místně otestujte simulátor a před škálováním ověřte, že funguje podle očekávání.

Než začnete

  • Musíte mít nainstalované Rozhraní příkazového řádku Azure.
  • Na místním počítači musíte mít nainstalovaný Docker. Komunitní edice Dockeru je dostupná pro Windows, Linuxa MacOS.
  • Ke čtení a zápisu musíte mít Azure Container Registry (ACR). Bonsai poskytuje výchozí ACR při zřizování pracovního prostoru ve stejné skupině prostředků jako pracovní prostor.
  • Musíte mít nástroj VPLinkSim_ 3 ze skupiny Wood Group. Nástroj si můžete stáhnout z GitHub Mys Software.

Krok 1: Příprava simulátoru

Pokud chcete do svého prostředí přidat simulaci VP Linku, musíte vytvořit soubor ZIP ssim.zip, který Bonsai obsahuje následující: Bonsai

  • vplink_interface.json:soubor JSON vygenerovaný nástrojem VPLinkSim_ 3. Soubor rozhraní popisuje všechny značky VP Linku používané v souboru inkling pro SimStateSimAction struktury a .
  • cfg: adresář obsahující jeden nebo více souborů značek (.tag) a volitelné soubory snímků (**.icf) pro simulaci odkazu VP. Bonsai používá snímky odkazu VP k inicializaci simulačního modelu na začátku každé scény, jak je uvedeno příkazy lesson v kódu rukopisu. Pokud zahrníte více souborů značek, značky v každém souboru by měly být jedinečné.
  • data: Adresář obsahující všechny další soubory, které váš model vyžaduje ke spuštění. Pro většinu uživatelů bude adresář dat prázdný.
  • sces: prázdný adresář. Bonsai používá tento adresář k uložení scénářů propojení virtuálních aplikací, které se spustí během trénování nebo hodnocení.

Vytvoření sady souborů ZIP:

  1. Spusťte spustitelný soubor VPLinkSim_ Bonsai 3.
  2. Pomocí tlačítka Přidat značky do stavu vyberte odpovídající značky pro stavy simulátoru.
  3. Pomocí tlačítka Přidat značky do tlačítka vyberte příslušné značky pro akce simulátoru.
  4. Nastavte tlačítko Rozhraní sestavení a vytvořte soubor vplink_interface.json.
  5. Stiskněte tlačítko Create Loadable (Vytvořit načístelné) a vytvořte sim.zip soubor k nahrání.

Nástroj VP Link

Snímek obrazovky s uživatelským rozhraním nástroje VP Link, které slouží k vygenerování balíčku pro Bonsai nahrání Většina uživatelského rozhraní je tvořená selektory značek pro Akce a Stav. V pravém dolním rohu uživatelského rozhraní jsou dvě tlačítka pro sestavení souboru rozhraní a vytvoření balíčku ZIP pro nahrání.

  1. Stáhněte si Bonsai wrapper for Anylogic .
  2. Postupujte podle pokynů v souboru PDF pracovního postupu modelu obálky a integrujte a nakonfigurujte obálku pro váš simulátor.
  1. Nainstalujte Microsoft Project Bonsai Simulink Toolbox
  2. Postupujte podle pokynů v souboru README a integrujte a nakonfigurujte panel nástrojů pro váš simulátor.

Pokud chcete přidat vlastní simulátor, musíte ho zabalte jako kontejner Dockeru a přidat ho do služby Azure Container Register (ACR).

  1. Vytvořte soubor Dockerfile pro kód simulace.
  2. Přihlaste se k Azure Container Registry (ACR):
    az acr login --name ACR_NAME
    
  3. Sestavte image ze souboru Dockerfile s jedinečným názvem a značkou verze:
    az acr build             \
      --image IMAGE_NAME:TAG \
      --registry ACR_NAME    \
      --file Dockerfile .
    
  4. Zkontrolujte seznam imagí ve vašem registru a ověřte, že nahrávání proběhlo úspěšně:
    az acr repository list --name ACR_NAME --output table
    

Tip

Příkaz spustí sestavení jako úlohu přímo v ACR a při sestavování velkého kontejneru může az acr build vyprší časový limit. Pokud zjistíte, že u sestavení dochází k časovému limitu, pomocí příznaku zvyšte časový limit.

Krok 2: Přidání simulátoru do pracovního Bonsai prostoru

To je ta snadná část!

  1. Klikněte na + Přidat sim vedle seznamu Simulátory v uživatelském rozhraní.
  2. V seznamu typů simulátorů vyberte Odkaz na virtuálního poskytovatele.
  3. Vyberte soubor ZIP s odkazem na VP (sim.zip) k nahrání.
  4. Zadejte zobrazovaný název balíčku simulátoru.
  5. Kliknutím na tlačítko Vytvořit simulátor přidejte balíček simulátoru do seznamu Simulátory.

Nahrání odkazu vP sim

Snímek obrazovky s dialogem pro nahrání simulátoru VP Link

  1. Klikněte na + Přidat sim vedle seznamu Simulátory v uživatelském rozhraní.
  2. Ze seznamu typů simulátoru vyberte AnyLogic.
  3. Vyberte soubor AnyLogic k nahrání.
  4. Zadejte zobrazovaný název balíčku simulátoru.
  5. Kliknutím na tlačítko Vytvořit simulátor přidejte balíček simulátoru do seznamu Simulátory.

Tip

AnyLogic automaticky zabalí simulátor do jednoho balíčku, který obsahuje všechny požadované soubory. Ve složce exportovaného modelu můžete bezpečně odstranit složku chromium a ušetřit tak místo na disku.

AnyLogic sim upload

Snímek obrazovky s dialogem pro nahrání simulátoru AnyLogic

  1. Klikněte na + Přidat sim vedle seznamu Simulátory v uživatelském rozhraní.
  2. V seznamu typů simulátoru vyberte Simulink.
  3. Vyberte soubor Simulink k nahrání.
  4. Zadejte zobrazovaný název balíčku simulátoru.
  5. Kliknutím na tlačítko Vytvořit simulátor přidejte balíček simulátoru do seznamu Simulátory.

Simulink sim upload

Snímek obrazovky s dialogem pro nahrání simulátoru Simulink

Vlastní simulátory můžete nahrát prostřednictvím uživatelského Bonsai rozhraní nebo rozhraní příkazového řádku.

Image ACR můžete také publikovat jako balíček simulátoru pomocí Bonsai CLI . Například:

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

Pro většinu simulátorů doporučujeme následující výchozí hodnoty:

  • Jádra: 1
  • Paměť: 1 GB
  • Operační systém: Linux

Tip

Když nahrajete nový simulátor, můžete automaticky vygenerovat kód rukopisu pro struktury a SimStateSimAction . Vygenerovaný kód obsahuje komentáře pro každého člena objektu a , které označují SimStateSimAction možné hodnoty a rozsahy hodnot.

Krok 3: Škálování simulátoru

Důležité

Kvóty Azure jsou limity kreditů, nikoli záruky kapacity. V důsledku toho Azure omezuje počet instancí kontejnerů, které můžete v závislosti na vašem předplatném zvidiovat. Předplatná Azure obvykle omezují využití prostředků v daném časovém období (vymezené každou hodinu) nebo v celém předplatném. Pokud potřebujete kapacitu ve velkém měřítku, obraťte se na podpora Azure navýšit kvótu Azure.

Jakmile je simulátor nahraný do pracovního prostoru, můžete ho přiřadit k trénovací Bonsai relaci pomocí rukopisu nebo uživatelského rozhraní. Bonsai automaticky spustí několik instancí simulátoru pro trénování ve velkém měřítku.

  1. Výběrem karty Učit otevřete soubor rukopisu.
  2. V simulator inklingu vyhledejte klauzuli .
  3. Přiřaďte package název simulátoru jako zobrazovaný název, který jste nastavili dříve:
    source simulator (Action: Action, Config: SimConfig): State {
    package "example-sim"
    }
    
  4. Trénování zahájíte kliknutím na tlačítko Train (Trénovat).