Rozhraní příkazového řádku aplikace Dynamo
K čemu to slouží?
Dynamo můžete chtít ovládat z příkazového řádku z různých důvodů. Mezi ně patří například:
Automatizace mnoha spuštění aplikace Dynamo.
Testování grafů aplikace Dynamo (při použití aplikace DynamoSandbox se podívejte také na možnost -c).
Spuštění posloupnosti grafů aplikace Dynamo v určitém pořadí.
Tvorba dávkových souborů, které spouštějí více příkazových řádků.
Tvorba dalšího programu, který bude řídit a automatizovat spuštění grafů aplikace Dynamo a provádět s výsledky těchto výpočtů další skvělé akce.
Co to je?
Rozhraní příkazového řádku (DynamoCLI) je doplněk k aplikaci DynamoSandbox. Jedná se o nástroj příkazového řádku typu DOS / terminál určený k pohodlnému spouštění aplikace Dynamo pomocí argumentů příkazového řádku. Ve své první implementaci se nespouští samostatně, ale musí být spuštěn ze složky, kde se nacházejí binární soubory aplikace Dynamo, protože závisí na stejných základních knihovnách DLL jako Sandbox. Nemůže spolupracovat s jinými sestaveními aplikace Dynamo.
Rozhraní příkazového řádku (CLI) lze spustit několika různými způsoby: z příkazového řádku DOS, z dávkových souborů DOS a jako zástupce na ploše systému Windows, jehož cesta je upravena tak, aby obsahovala zadané příznaky příkazového řádku. Specifikace souboru DOS může být plně kvalifikovaná nebo relativní a podporovány jsou také mapované jednotky a syntaxe adres URL. Lze jej také sestavit pomocí platformy Mono a spustit v systému Linux nebo Mac z terminálu.
Balíčky Dynamo jsou nástrojem podporovány, nelze však načíst vlastní uzly (DYF), pouze samostatné grafy (DYN).
Při předběžném testování nástroj CLI podporuje lokalizované verze systému Windows a argumenty filespec lze zadávat velkými znaky ASCII.
K CLI lze přistupovat prostřednictvím aplikace DynamoCLI.exe. Tato aplikace umožňuje uživateli nebo jiné aplikaci komunikovat s vyhodnocovacím modelem aplikace Dynamo vyvoláním souboru DynamoCLI.exe s řetězcem příkazu. Ten může vypadat například takto:
Tento příkaz aplikaci Dynamo sdělí, aby otevřela zadaný soubor v umístění "C:\someReallyCoolDynamoFile.Dyn" bez vykreslení uživatelského rozhraní a poté jej spustila. Po dokončení běhu grafu se aplikace Dynamo ukončí.
Novinka ve verzi 2.1: Aplikace DynamoWPFCLI.exe. Tato aplikace podporuje vše, co aplikace DynamoCLI.exe, navíc s možností Geometry (-g). Aplikace DynamoWPFCLI.exe je určena pouze pro systém Windows.
Důležité poznámky
Upřednostňovanou metodou interakce s DynamoCLI je rozhraní příkazového řádku.
V tuto chvíli je rozhraní DynamoCLI třeba spouštět z jeho instalačního umístění ve složce [Verze aplikace Dynamo]. Rozhraní CLI potřebuje přístup ke stejným knihovnám DLL jako aplikace Dynamo, proto by se nemělo přesouvat.
Měli byste být schopni spouštět grafy, které jsou aktuálně otevřené v aplikaci Dynamo, ale může to způsobit nežádoucí vedlejší účinky.
Všechny cesty k souborům jsou plně kompatibilní se systémem DOS, takže by relativní a plně kvalifikované cesty měly fungovat, ale nezapomeňte cesty uzavřít do uvozovek: "C:cesta\k\soubor.dyn".
DynamoCLI je nová funkce, která se v současné době vyvíjí: aktuálně **CLI načítá pouze podmnožinu ** standardních knihoven Dynamo. Mějte to na paměti, pokud se graf nespustí správně. Tyto knihovny jsou uvedeny zde
V současné době není k dispozici žádný standardní výstup. Pokud nedojde k žádným chybám, CLI se po dokončení běhu jednoduše ukončí.
Jak se to používá?
-o
: Aplikaci Dynamo můžete otevřít tak, že bude odkazovat na soubor .dyn, a to v bezobslužném režimu, který spustí graf.
-v
: Lze použít, když je aplikace Dynamo spuštěna v bezobslužném režimu (pokud jste k otevření souboru použil příznak -o
). Tento příznak iteruje všechny uzly v grafu a vypíše jejich výstupní hodnoty do jednoduchého souboru XML. Vzhledem k tomu, že příznak --ServiceMode
může vynutit, aby aplikace Dynamo spustila více vyhodnocení grafu, bude výstupní soubor obsahovat hodnoty pro každé vyhodnocení, ke kterému dojde.
Výstupní soubor XML by měl následující podobu:
-g
: Lze použít, když je aplikace Dynamo spuštěna v bezobslužném režimu (pokud jste k otevření souboru použil příznak -o
). Tento příznak vygeneruje graf a poté vypíše výslednou geometrii do souboru JSON.
Soubor geometrie JSON by měl následující podobu:
-h
: Slouží k získání seznamu možných možností.
Příznak -i je možné použít vícekrát k importu více sestavení, která graf, jenž se pokoušíte otevřít, vyžaduje ke spuštění.
Příznak -l je možné použít ke spuštění aplikace Dynamo v jiném nastavení národního prostředí. Nastavení národního prostředí však obvykle neovlivňuje výsledky grafu
Příznak --GeometryPath lze použít k nasměrování aplikace DynamoSandbox nebo CLI na konkrétní sadu binárních souborů ASM. Použijte jej jako v následujícím příkladu:
nebo
Příznak -k lze použít k tomu, aby proces aplikace Dynamo běžel, dokud jej načtené rozšíření nevypne.
Příznak --HostName lze použít k identifikaci variace aplikace Dynamo přidružené k hostiteli.
nebo
Příznak -s lze použít k identifikaci ID relace analytického hostitele aplikace Dynamo.
Příznak -p lze použít k identifikaci ID nadřazeného analytického hostitele Dynamo.
Last updated