Úvod do skriptováníÚvod do skriptování
1. Nastavení prostředí pro psaní skriptů1. Nastavení prostředí pro psaní skriptů
Použití skriptů nabízí účinnější způsob interakce s OghmaNano. Místo používání grafického uživatelského rozhraní můžete využít svůj oblíbený programovací jazyk pro komunikaci s OghmaNano. Tím získáte možnost řídit simulace mnohem efektivněji, než by to bylo možné pouze pomocí grafického rozhraní. Níže uvádím příklady použití jazyků MATLAB a Python pro ovládání OghmaNano, ale můžete použít jakýkoli jazyk, který má čtečku/zapisovač JSON. Mezi jazyky, které mě napadají, patří například Pearl a Java.Použití skriptů nabízí účinnější způsob interakce s OghmaNano. Místo používání grafického uživatelského rozhraní můžete využít svůj oblíbený programovací jazyk pro komunikaci s OghmaNano. Tím získáte možnost řídit simulace mnohem efektivněji, než by to bylo možné pouze pomocí grafického rozhraní. Níže uvádím příklady použití jazyků MATLAB a Python pro ovládání OghmaNano, ale můžete použít jakýkoli jazyk, který má čtečku/zapisovač JSON. Mezi jazyky, které mě napadají, patří například Pearl a Java.
Než začnete psát skripty pro OghmaNano, musíte systému Windows sdělit, kam je OghmaNano nainstalováno. Standardně se OghmaNano instaluje do adresáře C:\Program Files x86\OghmaNano. V tomto adresáři najdete dva spustitelné soubory: oghma.exe, což je grafické uživatelské rozhraní, a oghma_core.exe. Soubor oghma_core.exe můžete spustit z příkazového řádku bez použití oghma.exe. Stačí přejít do adresáře, který obsahuje složku sim.oghma, a spustit oghma_core.exe. To můžete provést z příkazového řádku systému Windows, z prostředí MATLAB, Python nebo z jakéhokoli jiného skriptovacího jazyka. Nicméně, než to budete moci provést ve Windows, musíte přidat cestu C:\Program Files x86\OghmaNano do systémové proměnné PATH, aby Windows věděl, kam je OghmaNano nainstalováno. Příklad, jak to provést v moderní verzi Windows, najdete v tomto odkazu: https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14)Než začnete psát skripty pro OghmaNano, musíte systému Windows sdělit, kam je OghmaNano nainstalováno. Standardně se OghmaNano instaluje do adresáře C:\Program Files x86\OghmaNano. V tomto adresáři najdete dva spustitelné soubory: oghma.exe, což je grafické uživatelské rozhraní, a oghma_core.exe. Soubor oghma_core.exe můžete spustit z příkazového řádku bez použití oghma.exe. Stačí přejít do adresáře, který obsahuje složku sim.oghma, a spustit oghma_core.exe. To můžete provést z příkazového řádku systému Windows, z prostředí MATLAB, Python nebo z jakéhokoli jiného skriptovacího jazyka. Nicméně, než to budete moci provést ve Windows, musíte přidat cestu C:\Program Files x86\OghmaNano do systémové proměnné PATH, aby Windows věděl, kam je OghmaNano nainstalováno. Příklad, jak to provést v moderní verzi Windows, najdete v tomto odkazu: https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14)
Zdá se, že každá nová verze systému Windows přemisťuje možnosti konfigurace, takže možná budete muset najít návod pro vaši verzi systému Windows.Zdá se, že každá nová verze systému Windows přemisťuje možnosti konfigurace, takže možná budete muset najít návod pro vaši verzi systému Windows.
2. Další užitečné rady ohledně psaní skriptů.2. Další užitečné rady ohledně psaní skriptů.
sim.json ve formě stromové struktury, kterou lze procházet.Nástroj JSON Explorer zobrazuje strukturu dat sim.json ve formě stromové struktury, kterou lze procházet.Představte si grafické uživatelské rozhraní jako strukturovaný prohlížeč JSON.Představte si grafické uživatelské rozhraní jako strukturovaný prohlížeč JSON.
Užitečný mentální model při vytváření skriptů pro OghmaNano spočívá v tom, že se na celé grafické uživatelské rozhraní (GUI) nahlíží jako na strukturovaný prohlížeč a editor pro základní soubor sim.json. Každý ovládací prvek, posuvník, tabulka a dialog nakonec čte data z tohoto souboru a zapisuje do něj. Neexistuje žádný samostatný „stav GUI“ – JSON představuje samotný stav. V pásu karet Automatizace umožňuje nástroj JSON Explorer (obrázek ??) procházet soubor sim.json přímo jako hierarchický strom. To je často nejrychlejší způsob, jak zjistit, kde se daný parametr „nachází“ v JSON a ověřit, zda akce v GUI zapisuje do očekávaného pole.Užitečný mentální model při vytváření skriptů pro OghmaNano spočívá v tom, že se na celé grafické uživatelské rozhraní (GUI) nahlíží jako na strukturovaný prohlížeč a editor pro základní soubor sim.json. Každý ovládací prvek, posuvník, tabulka a dialog nakonec čte data z tohoto souboru a zapisuje do něj. Neexistuje žádný samostatný „stav GUI“ – JSON představuje samotný stav. V pásu karet Automatizace umožňuje nástroj JSON Explorer (obrázek ??) procházet soubor sim.json přímo jako hierarchický strom. To je často nejrychlejší způsob, jak zjistit, kde se daný parametr „nachází“ v JSON a ověřit, zda akce v GUI zapisuje do očekávaného pole.
Kontrola objektů pomocí funkce kopírování a vkládání.Kontrola objektů pomocí funkce kopírování a vkládání.
Další užitečná technika spočívá v tom, že využijete způsob, jakým funguje kopírování a vkládání v celém grafickém uživatelském rozhraní. Když zkopírujete objekt – například kliknutím pravým tlačítkem a zkopírováním vrstvy v editoru vrstev nebo zkopírováním vybraného objektu v 3D zobrazení – OghmaNano může umístit základní strukturu JSON, která je zodpovědná za generování daného objektu, přímo do schránky.Další užitečná technika spočívá v tom, že využijete způsob, jakým funguje kopírování a vkládání v celém grafickém uživatelském rozhraní. Když zkopírujete objekt – například kliknutím pravým tlačítkem a zkopírováním vrstvy v editoru vrstev nebo zkopírováním vybraného objektu v 3D zobrazení – OghmaNano může umístit základní strukturu JSON, která je zodpovědná za generování daného objektu, přímo do schránky.
Pokud zkopírujete tento obsah schránky a vložíte ho do textového editoru (Poznámkový blok, Notepad++, VS Code atd.), můžete si prohlédnout přesný blok JSON, který se používá k definování daného objektu nebo položky v tabulce. Tím získáte přímý a jednoznačný pohled na to, jak je objekt interně reprezentován, a často je to nejrychlejší způsob, jak identifikovat relevantní klíče pro skriptování.Pokud zkopírujete tento obsah schránky a vložíte ho do textového editoru (Poznámkový blok, Notepad++, VS Code atd.), můžete si prohlédnout přesný blok JSON, který se používá k definování daného objektu nebo položky v tabulce. Tím získáte přímý a jednoznačný pohled na to, jak je objekt interně reprezentován, a často je to nejrychlejší způsob, jak identifikovat relevantní klíče pro skriptování.
Mnoho kontextových nabídek také nabízí možnosti, jako je Kopírovat JSON, Kopírovat cestu JSON nebo Kopírovat skriptovanou cestu. Tyto příkazy odhalují přesné umístění objektu v hierarchii JSON, čímž se výrazně usnadňuje vyhledání a úprava odpovídající položky ve skriptech.Mnoho kontextových nabídek také nabízí možnosti, jako je Kopírovat JSON, Kopírovat cestu JSON nebo Kopírovat skriptovanou cestu. Tyto příkazy odhalují přesné umístění objektu v hierarchii JSON, čímž se výrazně usnadňuje vyhledání a úprava odpovídající položky ve skriptech.
Pokud se opravdu nemůžete pohnout z místa: použijte nástroj pro porovnávání souborů.Pokud se opravdu nemůžete pohnout z místa: použijte nástroj pro porovnávání souborů.
Pokud si nejste jisti, jak konkrétní prvek grafického uživatelského rozhraní souvisí se souborem sim.json, můžete použít jednoduchou a účinnou metodu ladění, a to porovnání souborů.Pokud si nejste jisti, jak konkrétní prvek grafického uživatelského rozhraní souvisí se souborem sim.json, můžete použít jednoduchou a účinnou metodu ladění, a to porovnání souborů.
- Vytvořte záložní kopii souboru se simulací, například
sim.json→sim.back.Vytvořte záložní kopii souboru se simulací, napříkladsim.json→sim.back. - Změňte jeden parametr v grafickém uživatelském rozhraní.Změňte jeden parametr v grafickém uživatelském rozhraní.
- Porovnejte upravený soubor
sim.jsons vaší záložní kopií pomocí nástroje pro porovnávání souborů, jako je například KDiff3.Porovnejte upravený souborsim.jsons vaší záložní kopií pomocí nástroje pro porovnávání souborů, jako je například KDiff3. - Výstup nástroje pro porovnání souborů vám přesně ukáže, která řádka (nebo blok) v souboru JSON se změnila, a odhalí tak, jak je daný prvek uživatelského rozhraní interně reprezentován.Výstup nástroje pro porovnání souborů vám přesně ukáže, která řádka (nebo blok) v souboru JSON se změnila, a odhalí tak, jak je daný prvek uživatelského rozhraní interně reprezentován.
Často se jedná o nejrychlejší způsob, jak přiřadit prvek uživatelského rozhraní konkrétnímu poli v JSON, zejména v rozsáhlých stromových strukturách parametrů.Často se jedná o nejrychlejší způsob, jak přiřadit prvek uživatelského rozhraní konkrétnímu poli v JSON, zejména v rozsáhlých stromových strukturách parametrů.
Použití identifikátorů objektů k vyhledávání záznamů v sim.json.Použití identifikátorů objektů k vyhledávání záznamů v sim.json.
Většina strukturovaných objektů v OghmaNano – jako jsou vrstvy, tvary, skeny parametrů a další hierarchické entity – má přiřazen unikátní identifikátor (ID), obvykle náhodný hexadecimální řetězec o délce přibližně 16 znaků.Většina strukturovaných objektů v OghmaNano – jako jsou vrstvy, tvary, skeny parametrů a další hierarchické entity – má přiřazen unikátní identifikátor (ID), obvykle náhodný hexadecimální řetězec o délce přibližně 16 znaků.
ID objektu se často zobrazuje přímo v grafickém uživatelském rozhraní. Například na obrázku ?? je ID uvedeno v levém dolním rohu okna editoru objektu. Stejný identifikátor se také nachází v odpovídající položce v souboru sim.json.ID objektu se často zobrazuje přímo v grafickém uživatelském rozhraní. Například na obrázku ?? je ID uvedeno v levém dolním rohu okna editoru objektu. Stejný identifikátor se také nachází v odpovídající položce v souboru sim.json.
Tato ID jsou mimořádně užitečná při práci s rozsáhlými nebo složitými JSON strukturami. Vyhledáním řetězce ID v sim.json můžete okamžitě najít přesný objekt, který je spojen s daným prvkem grafického uživatelského rozhraní, a to i v případě, že je okolní hierarchie složitá.Tato ID jsou mimořádně užitečná při práci s rozsáhlými nebo složitými JSON strukturami. Vyhledáním řetězce ID v sim.json můžete okamžitě najít přesný objekt, který je spojen s daným prvkem grafického uživatelského rozhraní, a to i v případě, že je okolní hierarchie složitá.