Tato příručka Primer je pouze začátkem vaší cesty s aplikací Dynamo for Civil 3D. K dispozici je množství znalostí dostupných od aktivní komunity uživatelů aplikace Dynamo. Během učení vám doporučujeme prozkoumat některé z těchto zdrojů.

Nápověda k aplikaci Civil 3D

Fórum aplikace Dynamo

Web Autodesk University

Knihy

Silnice, železnice, terén, inženýrské sítě, zaměření, GIS...

Stavební infrastruktura je tohle všechno a ještě mnohem víc! Tato část obsahuje několik praktických a relevantních vzorových grafů, které vám pomohou posunout se k mistrovskému zvládnutí aplikace Dynamo a odhalit plný potenciál aplikace Dynamo for Civil 3D. Každý graf obsahuje podrobný popis logiky, která byla použita k jeho vytvoření, abyste jej mohli nejen používat, ale také pochopit.

Tyto příklady navíc obsahují osvědčené postupy pro vytváření silných grafů. Doporučujeme vám, abyste se při práci s příklady seznámili také s částí Osvědčené postupy, kde naleznete další nápady, jak vytvářet výkonné, flexibilní a udržovatelné grafy.

Aplikace Dynamo byla původně vytvořena s ohledem na aplikaci Revit, její všestrannost jako nástroje pro vizuální programování však přesahuje rámec aplikace Revit. Aplikace Dynamo je také integrována do aplikace Civil 3D, což uživatelům umožňuje vytvářet výkonné postupy automatizace pro projekty stavební infrastruktury. Jedná se o mimořádně užitečný nástroj pro zpracování čehokoli od běžných úkolů po nejsložitější pracovní postupy návrhu, který vám v konečném důsledku pomáhá šetřit čas, optimalizovat návrhy a přijímat lepší rozhodnutí o návrhu. Aplikace Dynamo nabízí celou sadu uzlů speciálně navržených pro aplikaci Civil 3D a také knihovny třetích stran od široké komunity uživatelů.

Tato kapitola příručky Primer se zaměří na aplikaci Dynamo for Civil 3D, počínaje základy a konče pokročilejšími tématy.

Již dříve jsme uvedli, že uzly jsou základními stavebními bloky grafu aplikace Dynamo a jsou uspořádány do logických skupin v knihovně. V aplikaci Dynamo for Civil 3D jsou v knihovně dvě kategorie (neboli police), které obsahují vyhrazené uzly pro práci s objekty aplikací AutoCAD a Civil 3D, například trasy, profily, koridory, reference bloků atd. Zbytek knihovny obsahuje uzly, které jsou obecnější povahy, a jsou konzistentní mezi všemi verzemi aplikace Dynamo (například Dynamo pro aplikaci Revit, Dynamo Sandbox atd.).

1. Specifické uzly pro práci s objekty aplikací AutoCAD a Civil 3D

2. Obecné uzly

3. Uzly z balíčků třetích stran, které lze instalovat samostatně.

Hierarchie uzlů

Aby bylo možné pracovat s uzly aplikací AutoCAD a Civil 3D, je důležité plně porozumět hierarchii objektů v jednotlivých policích. Pamatujete si taxonomii z biologie? Říše, kmen, třída, řád, čeleď, rod, druh? Objekty aplikací AutoCAD a Civil 3D jsou uspořádány do kategorií podobným způsobem. Vysvětleme si to na několika příkladech.

Objekty aplikace Civil

Jako příklad použijeme trasu.

Řekněme, že vaším cílem je změnit název trasy. Dalším uzlem, který byste zde měli přidal, je uzel CivilObject.SetName.

Zpočátku se to nemusí zdát příliš intuitivní. Co je CivilObject a proč knihovna nemá uzel Alignment.SetName? Odpověď souvisí s opakovatelnou použitelností a jednoduchostí. Pokud se nad tím zamyslíte, proces změny názvu objektu aplikace Civil 3D je stejný, ať už se jedná o trasu, koridor, profil nebo něco jiného. Takže místo opakujících se uzlů, které v podstatě provádějí totéž (například Alignment.SetName, Corridor.SetName, Profile.SetName atd.), by bylo vhodné tuto funkci zabalit do jediného uzlu. Přesně to dělá uzel CivilObject.SetName!

Jiný způsob, jak o tom přemýšlet, je z hlediska vztahů. Trasa a koridor jsou oba typy objektů aplikace Civil, stejně jako jablko a hruška jsou oba typy ovoce. Uzly CivilObject se používají u všech typů objektů aplikace Civil, stejně jako můžete chtít použít jednu škrabku k loupání jablek i hrušek. Ve vaší kuchyni by byl pořádný chaos, kdybyste měli pro každý typ ovoce samostatnou škrabku! V tomto smyslu je knihovna uzlů aplikace Dynamo stejná jako vaše kuchyně.

Objekty

Nyní se posuneme o krok dál. Řekněme, že chcete změnit hladinu trasy. Uzel, který byste použili, je uzel Object.SetLayer.

Proč neexistuje uzel s názvem CivilObject.SetLayer? Platí zde stejné zásady opakované použitelnosti a jednoduchosti, o kterých jsme hovořili dříve. Vlastnost hladina je společná pro všechny objekty v aplikaci AutoCAD, které lze nakreslit nebo vložit, jako je úsečka, křivka, text, reference bloku atd. Objekty aplikace Civil 3D, například trasy a koridory, spadají do stejné kategorie, takže jakýkoliv uzel, který se vztahuje k objektu, lze použít také s libovolným objektem aplikace Civil.

Když jste si teď udělali základní obrázek, pojďme se rovnou pustit do vytváření prvního grafu aplikace Dynamo v aplikaci Civil 3D!

Otevření aplikace Dynamo

Nejprve otevřete prázdný dokument v aplikaci Civil 3D. V tomto dokumentu poté na pásu karet aplikace Civil 3D přejděte na kartu Správa a vyhledejte panel Vizuální programování.

Kliknutím na tlačítko Dynamo spusťte aplikaci Dynamo v samostatném okně.

Zahájení nového grafu

Po otevření aplikace Dynamo se zobrazí úvodní obrazovka. Kliknutím na tlačítko Nový otevřete prázdný pracovní prostor.

Přidání uzlů

Nyní byste měli vidět prázdný pracovní prostor. Vyzkoušejme si aplikaci Dynamo v akci! Zde je náš cíl:

Vypadá to jednoduše, že? Než však začneme, musíme se seznámit s několika základními pojmy.

Základní stavební bloky grafu aplikace Dynamo se nazývají uzly. Uzel je jako malý počítač – vložíte do něj data, on s nimi provede nějakou práci a vygeneruje výsledek. Aplikace Dynamo for Civil 3D obsahuje knihovnu uzlů, které můžete propojit pomocí drátů a vytvořit tak graf, který dokáže větší a lepší věci než kterýkoli uzel sám o sobě.

Dobrá. Pojďme nyní sestavit náš graf. Zde je seznam všech uzlů, které budeme potřebovat.

Tyto uzly můžete najít zadáním jejich názvu do vyhledávacího řádku v knihovně nebo kliknutím pravým tlačítkem myši kdekoli na kreslicí ploše a následným vyhledáním.

Takto by měl vypadat výsledný graf.

Shrňme si, co jsme zde udělali:

1. Vybrali jsme, ve kterém dokumentu budeme pracovat. V tomto případě (a v mnoha dalších případech) chceme pracovat v aktivním dokumentu v aplikaci Civil 3D.

2. Definovali jsme cílový blok, ve kterém má být vytvořen textový objekt (v tomto případě modelový prostor).

3. Pomocí uzlu String jsme určili, do které hladiny má být text umístěn.

4. Pomocí uzlu Point.ByCoordinates jsme vytvořili bod, který definuje umístění textu.

5. Pomocí dvou uzlů Number Slider jsme definovali souřadnice X a Y bodu vložení textu.

6. Pomocí dalšího uzlu String jsme definovali obsah textového objektu.

7. Nakonec jsme vytvořili textový objekt.

Podívejme se na výsledky našeho nového krásného grafu!

Zobrazení výsledku

V aplikaci Civil 3D zkontrolujte, zda je vybrána karta Model. Měl by se zobrazit nový textový objekt vytvořený aplikací Dynamo.

Výborně! Nyní provedeme několik aktualizací textu.

Vraťte se do grafu aplikace Dynamo a změňte několik vstupních hodnot, například textový řetězec, souřadnice bodu vložení atd. Text by se měl v aplikaci Civil 3D automaticky aktualizovat. Všimněte si také, že pokud odpojíte některý ze vstupních portů, text se odstraní. Pokud vše připojíte zpět, text se znovu vytvoří.

Další postup

Tento příklad je pouze malou ukázkou toho, co všechno lze s aplikací Dynamo for Civil 3D dělat. Čtěte dál a dozvíte se více!

Inženýrský návrh typické bytové výstavby zahrnuje práci s několika podzemními inženýrskými sítěmi, jako je splašková kanalizace, dešťová kanalizace, rozvody pitné vody nebo jiné. V tomto příkladu si ukážeme, jak lze aplikaci Dynamo použít k nakreslení servisních přípojek z rozvodné sítě k danému pozemku (tj. parcely). Je běžné, že každá parcela vyžaduje servisní přípojku, což vyžaduje značné množství zdlouhavé práce při umisťování všech služeb. Aplikace Dynamo může tento proces urychlit automatickým přesným nakreslením nezbytné geometrie a také poskytuje flexibilní vstupy, které lze upravit tak, aby vyhovovaly místním standardům.

Cíl

Klíčové koncepty

• Použití uzlu Select Object pro uživatelský vstup

• Práce se souřadnicovými systémy

• Použití geometrických operací, jako jsou například Geometry.DistanceTo a Geometry.NearestPointTo

• Vytvoření referencí bloků

• Řízení nastavení vazeb objektů

Kompatibilita verzí

Datová sada

Začněte stažením níže uvedených vzorových souborů a poté otevřete soubor DWG a graf aplikace Dynamo.

Řešení

Zde je uveden přehled logiky tohoto grafu.

1. Získání geometrie křivky pro rozvodnou síť.

2. Získání geometrie křivky pro uživatelem vybranou linii pozemku, v případě potřeby obrácení směru.

3. Generování bodů vložení pro měřiče služeb.

4. Získání bodů na rozvodné síti, které jsou nejblíže umístění měřičů služeb.

5. Vytvoření referencí bloků a čar v modelovém prostoru.

Pojďme na to!

Získání geometrie rozvodné sítě

Prvním krokem je získání geometrie rozvodné sítě do aplikace Dynamo. Místo výběru jednotlivých čar nebo křivek získáme všechny objekty v určité hladině a spojíme je dohromady jako objekt PolyCurve aplikace Dynamo.

Získání geometrie linie pozemku

Nyní je nutné načíst geometrii vybrané linie pozemku do aplikace Dynamo, abychom s ní mohli pracovat. Správným nástrojem pro tuto úlohu je uzel Select Object, který umožňuje uživateli grafu vybrat konkrétní objekt v aplikaci Civil 3D.

Musíme se také vypořádat s potenciálním problémem, který může nastat. Linie pozemku má počáteční a koncový bod, což znamená, že má směr. Aby graf poskytoval konzistentní výsledky, je nutné, aby všechny linie pozemku měly konzistentní směr. Tuto podmínku můžeme zohlednit přímo v logice grafu, díky čemuž je graf odolnější.

1. Získá počáteční a koncový bod linie pozemku.

2. Změří vzdálenost od každého bodu k rozvodné síti a pak zjistí, která vzdálenost je větší.

3. Požadovaným výsledkem je, aby počáteční bod linie byl co nejblíže k rozvodné síti. Pokud tomu tak není, obrátíme směr linie pozemku. V opačném případě jednoduše vrátíme původní linii pozemku.

Vytvoření bodů vložení

Je čas zjistit, kde budou umístěny měřiče služeb. Umístění je obvykle určeno požadavky místních úřadů, takže pouze zadáme vstupní hodnoty, které lze změnit tak, aby vyhovovaly různým podmínkám. Jako referenci pro vytvoření bodů použijeme souřadnicový systém podél linie pozemku. To velmi usnadní definování odsazení vzhledem k linii pozemku, bez ohledu na její orientaci.

Získání bodů připojení

Nyní je potřeba získat body na rozvodné síti, které jsou nejblíže umístění měřičů služeb. To nám umožní nakreslit servisní přípojky v modelovém prostoru tak, aby byly vždy kolmé k rozvodné síti Ideálním řešením je uzel Geometry.NearestPointTo.

1. Toto je křivka PolyCurve rozvodné sítě.

2. Toto jsou body vložení měřičů služeb.

Vytvoření objektů

Posledním krokem je vytvoření objektů v modelovém prostoru. Dříve vytvořené body vložení použijeme k vytvoření referencí bloků a pak pomocí bodů na rozvodné síti nakreslíme čáry k servisním přípojkám.

Výsledek

Při spuštění grafu byste měli vidět nové reference bloků a čáry servisních přípojek v modelovém prostoru. Zkuste změnit některé vstupy a sledujte, jak se vše automaticky aktualizuje!

Bonus: Povolení sekvenčního umístění

Možní jste si všimli, že po umístění objektů pro jednu linii pozemku se při výběru jiné linie pozemku objekty „přesunou“.

Toto je výchozí chování aplikace Dynamo, které je v mnoha případech velmi užitečné. Může se však stát, že budete chtít postupně umístit několik servisních přípojek a nechat aplikaci Dynamo při každém spuštění vytvořit nové objekty, místo aby upravovala ty původní. Toto chování můžete ovládat změnou nastavení vazby objektů.

Změna tohoto nastavení způsobí, že aplikace Dynamo „zapomene“ na objekty, které vytvoří při každém spuštění. Zde je příklad spuštění grafu s vypnutou vazbou objektů pomocí Přehrávače skriptů Dynamo.

Nápady

Zde je několik nápadů, jak byste mohli rozšířit možnosti tohoto grafu.

Aplikace Dynamo for Civil 3D přináší paradigma vizuálního programování projektantům a návrhářům pracujícím na projektech stavební infrastruktury. Aplikaci Dynamo si můžete představit jako určitý digitální multifunkční nástroj pro uživatele aplikace Civil 3D – ať už se jedná o jakoukoli úlohu, má pro ni ten správný nástroj. Její intuitivní rozhraní umožňuje vytvářet výkonné a přizpůsobitelné postupy bez nutnosti napsání jediného řádku kódu. Abyste mohli používat aplikaci Dynamo, nemusíte být programátorem, ale musíte být schopni myslet logicky jako programátor. Tato kapitola vám spolu s ostatními kapitolami příručky Primer pomůže vybudovat takové logické dovednosti, abyste mohli řešit úlohu s ohledem na výpočetní návrh.

Historie

Aplikace Dynamo byla poprvé představena v aplikaci Civil 3D 2020 a od té doby se neustále vyvíjí. Původně se instalovala samostatně prostřednictvím aktualizace softwaru, nyní je součástí všech verzí aplikace Civil 3D. V závislosti na používané verzi aplikace Civil 3D si můžete všimnout, že rozhraní aplikace Dynamo vypadá trochu jinak než v příkladech uvedených v této kapitole. Důvodem je skutečnost, že v aplikaci Civil 3D 2023 došlo k výraznému přepracování rozhraní.

Jedním z mnoha případů skvělého použití aplikace Dynamo je dynamické umísťování samostatných objektů podél modelu koridoru. Často je potřeba objekty umístit na místa, která jsou nezávislá na vložených sestavách podél koridoru, což je velmi zdlouhavý úkol, který je třeba provést ručně. A pokud se změní horizontální nebo vertikální geometrie koridoru, je nutné provést značné množství předělávek.

Cíl

Klíčové koncepty

• Načítání dat z externího souboru (v tomto případě soubor aplikace Excel)

• Uspořádání dat ve slovnících

• Použití souřadnicových systémů k řízení polohy, měřítka nebo natočení

• Umístění referencí bloků

• Vizualizace geometrie v aplikaci Dynamo

Kompatibilita verzí

Datová sada

Začněte stažením níže uvedených vzorových souborů a poté otevřete soubor DWG a graf aplikace Dynamo.

Řešení

Zde je uveden přehled logiky tohoto grafu.

1. Načtěte soubor aplikace Excel a importujte data do aplikace Dynamo.

2. Získejte návrhové linie ze zadané základny koridoru.

3. Vytvořte souřadnicové systémy podél návrhové linie koridoru v požadovaných staničeních.

4. Pomocí souřadnicových systémů umístěte reference bloků v modelovém prostoru.

Pojďme na to!

Získání dat ze souboru aplikace Excel

V tomto vzorovém grafu použijeme soubor aplikace Excel k uložení dat, která aplikace Dynamo použije k umístění referencí bloků sloupů osvětlení. Tabulka vypadá následovně.

Data ze souboru aplikace Excel se do aplikace Dynamo importují následujícím způsobem.

Nyní, když máme data, je nutné je rozdělit podle sloupců (Corridor, Baseline, PointCode atd.), aby je bylo možné použít ve zbývající části grafu. Běžně se to dělá pomocí uzlu List.GetItemAtIndex a zadáním čísla indexu každého sloupce, který chceme použít. Například sloupec Corridor má index 0, sloupec Baseline má index 1 atd.

Vypadá to dobře, že? Ale tento přístup v sobě skrývá možný problém. Co když se v budoucnu změní pořadí sloupců v souboru aplikace Excel? Nebo se mezi dva sloupce přidá nový sloupec? Potom graf nebude správně fungovat a bude vyžadovat aktualizaci. Budoucí fungování grafu můžeme zajistit vložením dat do slovníku, přičemž záhlaví sloupců v souboru aplikace Excel budou sloužit jako klíče a zbývající data jako hodnoty.

Graf je díky tomu odolnější, protože umožňuje flexibilně měnit pořadí sloupců v souboru aplikace Excel. Dokud záhlaví sloupců zůstanou stejná, pak lze data jednoduše načíst ze slovníku pomocí jeho klíče (tj. záhlaví sloupce), což nyní provedeme.

Získání návrhových linií koridorů

Nyní, když máme importovaná a připravená data aplikace Excel, začneme je používat k získávání informací o modelech koridorů z aplikace Civil 3D.

1. Vybere model koridoru podle jeho názvu.

2. Získá konkrétní základnu v rámci koridoru.

3. Získá návrhovou linii v rámci základny podle kódu bodu.

Vytvoření souřadnicových systémů

Nyní vytvoříme souřadnicové systémy podél návrhových linií koridoru v hodnotách staničení, které jsme zadali v souboru aplikace Excel. Tyto souřadnicové systémy budou použity k definování polohy, otočení a měřítka referencí bloků sloupů osvětlení.

Všimněte si, že je zde použit blok kódu k otočení souřadnicových systémů v závislosti na tom, na které straně základny se nacházejí. Toho lze dosáhnout pomocí posloupnosti několika uzlů, ale toto je dobrý příklad situace, kdy je jednodušší to prostě sepsat.

Vytvoření referencí bloků

Blížíme se k cíli! Máme všechny informace, které potřebujeme, abychom mohli skutečně umístit reference bloků. Nejprve je nutné získat požadované definice bloků pomocí sloupce BlockName v souboru aplikace Excel.

Posledním krokem je vytvoření referencí bloků.

Výsledek

Po spuštění grafu by se měly v modelovém prostoru podél koridoru zobrazit nové reference bloků. A tady je ta skvělá část – pokud je režim spuštění grafu nastaven na Automaticky a upravíte soubor aplikace Excel, reference bloků se automaticky aktualizují!

Zde je příklad spuštění grafu pomocí Přehrávače skriptů Dynamo.

Bonus: Vizualizace v aplikaci Dynamo

Vizualizace geometrie koridoru v aplikaci Dynamo může být užitečná kvůli získání kontextu. Tento konkrétní model má tělesa koridoru již extrahovaná v modelovém prostoru, takže je přeneseme do aplikace Dynamo.

Je tu však ještě něco, co musíme vzít v úvahu. Tělesa jsou relativně „těžkým“ typem geometrie, což znamená, že tato operace zpomalí graf. Proto by se hodilo, kdyby existoval jednoduchý způsob, jak zvolit, zda chceme tělesa zobrazit, nebo ne. Zřejmou odpovědí je odpojení uzlu Corridor.GetSolids, což však vytvoří upozornění pro všechny navazující uzly, což je trochu nepřehledné. To je situace, kdy vítězoslavně použijeme uzel ScopeIf.

1. Všimněte si šedé čáry v dolní části uzlu Object.Geometry. To znamená, že náhled uzlu je vypnutý (přístupný po kliknutí pravým tlačítkem myši na uzel), což umožňuje, aby uzel GeometryColor.ByGeometryColor „nebojoval“ s jinou geometrií o prioritu zobrazení v náhledu na pozadí.

2. Uzel ScopeIf v zásadě umožňuje selektivně spustit celou větev uzlů. Pokud je vstup test nastaven na hodnotu false, potom se nespustí žádné uzly připojené k uzlu ScopeIf.

Zde je výsledek v náhledu na pozadí v aplikaci Dynamo.

Nápady

Zde je několik nápadů, jak byste mohli rozšířit možnosti tohoto grafu.

Časem možná zjistíte, že potřebujete jít nad rámec základů a ponořit se do vnitřního fungování aplikace Dynamo. Stránky v této části vám poskytnou návod, jak používat pokročilé funkce v aplikaci Dynamo for Civil 3D, abyste mohli grafy posunout na vyšší úroveň.

Práce s body COGO a skupinami bodů v aplikaci Civil 3D je základním prvkem mnoha komplexních procesů využívajících data získaná v terénu. Aplikace Dynamo skutečně vyniká v oblasti správy dat a v tomto příkladu si ukážeme jeden z případů možného použití.

Cíl

Klíčové koncepty

• Práce se seznamy

• Seskupení podobných objektů pomocí uzlu List.GroupByKey

• Zobrazení vlastního výstupu v Přehrávači skriptů Dynamo

Kompatibilita verzí

Datová sada

Začněte stažením níže uvedených vzorových souborů a poté otevřete soubor DWG a graf aplikace Dynamo.

Řešení

Zde je uveden přehled logiky tohoto grafu.

1. Získejte všechny body COGO v dokumentu.

2. Seskupte body COGO podle popisu.

3. Vytvořte skupiny bodů.

4. Odešlete souhrn do Přehrávače skriptů Dynamo.

Pojďme na to!

Získání bodů COGO

V prvním kroku získáme všechny skupiny bodů v dokumentu a potom všechny body COGO v každé skupině. Tím získáme vnořený seznam neboli „seznam seznamů“, se kterým se nám bude později lépe pracovat, pokud vše sloučíme do jediného seznamu pomocí uzlu List.Flatten.

Seskupení bodů podle popisu

Nyní, když máme všechny body COGO, je třeba je rozdělit do skupin podle jejich popisů. Přesně to dělá uzel List.GroupByKey. V podstatě seskupuje všechny položky, které sdílejí stejný klíč.

Vytvořte skupiny bodů.

To nejtěžší je za námi! Posledním krokem je vytvoření nových skupin bodů aplikace Civil 3D ze seskupených bodů COGO.

Výstupní souhrn

Při spuštění grafu není v náhledu na pozadí v aplikaci Dynamo nic vidět, protože nepracujeme s žádnou geometrií. Takže jediný způsob, jak zjistit, zda byl graf správně proveden, je zkontrolovat prostor nástrojů nebo se podívat na náhledy výstupu uzlu. Pokud však graf spustíme pomocí Přehrávače skriptů Dynamo, můžeme získat další zpětnou vazbu o výsledcích grafu vypsáním přehledu vytvořených skupin bodů. Stačí kliknout pravým tlačítkem myši na uzel a nastavit jej na možnost Je výstup. V tomto případě zobrazíme výsledky pomocí přejmenovaného uzlu Watch.

Výsledek

Zde je příklad spuštění grafu pomocí Přehrávače skriptů Dynamo.

Nápady

Zde je několik nápadů, jak byste mohli rozšířit možnosti tohoto grafu.

Při přidávání potrubí a stavebních objektů do potrubní sítě používá aplikace Civil 3D šablonu k automatickému přiřazení názvů. To je obvykle dostačující během počátečního umístění, ale názvy se budou v budoucnu nevyhnutelně měnit s tím, jak se bude návrh vyvíjet. Kromě toho existuje mnoho různých vzorů pojmenování, které mohou být vyžadovány, například postupné pojmenování stavebních objektů v potrubní trase počínaje nejvzdálenějším stavebním objektem, nebo podle vzoru pojmenování, který je v souladu s datovým schématem vyžadovaným místními úřady. V tomto příkladu si ukážeme, jak lze aplikaci Dynamo použít k definování libovolného typu strategie pojmenování a jejímu důslednému používání.

Cíl

Klíčové koncepty

• Práce s ohraničujícími kvádry

• Filtrování dat pomocí uzlu List.FilterByBoolMask

• Třídění dat pomocí uzlu List.SortByKey

• Generování a úprava textových řetězců

Kompatibilita verzí

Datová sada

Začněte stažením níže uvedených vzorových souborů a poté otevřete soubor DWG a graf aplikace Dynamo.

Řešení

Zde je uveden přehled logiky tohoto grafu.

1. Vyberte stavební objekty podle hladiny.

2. Získejte umístění stavebních objektů.

3. Filtrujte stavební objekty podle odsazení a pak je uspořádejte podle staničení.

4. Vytvořte nové názvy.

5. Přejmenujte stavební objekty.

Pojďme na to!

Výběr stavebních objektů

Nejprve je třeba vybrat všechny stavení objekty, se kterými chceme pracovat. Provedeme to tak, že jednoduše vybereme všechny objekty v určité hladině, což znamená, že můžeme vybrat stavební objekty z různých potrubních sítí (za předpokladu, že sdílejí stejnou hladinu).

1. Tento uzel zajišťuje, že neúmyslně nevybereme žádné nežádoucí typy objektů, které by mohly sdílet stejnou hladinu jako stavební objekty.

Získání umístění stavebních objektů

Nyní, když máme stavební objekty, musíme zjistit jejich polohu v prostoru, abychom je mohli seřadit podle jejich umístění. K tomu využijeme ohraničující kvádr každého objektu. Ohraničující kvádr objektu je kvádr minimální velikosti, který zcela obsahuje geometrické rozměry objektu. Výpočtem středu ohraničujícího kvádru získáte poměrně dobrou aproximaci bodu vložení stavebního objektu.

Tyto body použijeme k získání staničení a odsazení stavebních objektů vzhledem k vybrané trase.

Filtrování a řazení

Tady to začíná být trochu složitější. V této fázi máme velký seznam všech stavebních objektů na hladině, kterou jsme určili, a vybrali jsme trasu, podle které jsme je chtěli seřadit. Problém je v tom, že v seznamu mohou být stavební objekty, které nechceme přejmenovat. Nemusí například být součástí konkrétní trasy, která nás zajímá.

1. Vybraná trasa

2. Stavební objekty, které chceme přejmenovat

3. Stavební objekty, které mají být ignorovány

Proto je nutné seznam stavebních objektů filtrovat, aby nebyly brány v úvahu stavební objekty, jejichž odsazení od trasy je větší než zadaná hodnota. To lze nejlépe provést pomocí uzlu List.FilterByBoolMask. Po filtrování seznamu stavebních objektů je pomocí uzlu List.SortByKey uspořádáme podle hodnot staničení.

1. Zkontroluje, zda je odsazení stavebního objektu menší než prahová hodnota.

2. Nahradí nulové hodnoty hodnotou false.

3. Filtruje seznam stavebních objektů a staničení.

4. Uspořádá stavební objekty podle staničení.

Generování nových názvů

Poslední část práce, kterou je třeba udělat, je vytvoření nových názvů struktur. Formát, který použijeme, je <alignment name>-STRC-<number>. Je zde několik dalších uzlů, které v případě potřeby doplní čísla dalšími nulami (například 01 místo 1).

Přejmenování stavebních objektů

A v neposlední řadě přejmenujeme stavební objekty.

Výsledek

Zde je příklad spuštění grafu pomocí Přehrávače skriptů Dynamo.

Bonus: Vizualizace v aplikaci Dynamo

Pro účely vizualizace dočasných výstupů grafu místo pouze konečného výsledku může být užitečné využít 3D náhled na pozadí v aplikaci Dynamo. Jednou z jednoduchých věcí, kterou můžeme udělat, je zobrazit ohraničující kvádry pro stavební objekty. Tato konkrétní datová sada navíc obsahuje v dokumentu koridor, takže můžeme přenést geometrii návrhové linie koridoru do aplikace Dynamo a získat tak určitý kontext pro umístění stavebních objektů v prostoru. Pokud by graf byl použit v datové sadě, která nemá žádné koridory, pak tyto uzly jednoduše nebudou provádět žádné akce.

Nyní lépe rozumíme tomu, jak funguje proces filtrování stavebních objektů podle odsazení.

Nápady

Zde je několik nápadů, jak byste mohli rozšířit možnosti tohoto grafu.

Vývoj kinematických obálek pro ověření průjezdnosti je důležitou součástí návrhu železnice. Aplikaci Dynamo lze použít k vytvoření těles pro obalovou křivku místo vytváření a správy složitých podsestav koridoru pro tuto úlohu.

Cíl

Klíčové koncepty

• Práce s návrhovými liniemi koridoru

• Transformace geometrie mezi souřadnicovými systémy

• Vytvoření těles šablonováním

• Řízení chování uzlu pomocí nastavení vázání

Kompatibilita verzí

Datová sada

Začněte stažením níže uvedených vzorových souborů a poté otevřete soubor DWG a graf aplikace Dynamo.

Řešení

Zde je uveden přehled logiky tohoto grafu.

1. Získejte návrhové linie ze zadané základny koridoru.

2. Vytvořte souřadnicové systémy podél návrhové linie koridoru s požadovanou roztečí.

3. Transformujte geometrii bloku profilu do souřadnicových systémů.

4. Šablonujte těleso mezi profily.

5. Vytvořte tělesa v aplikaci Civil 3D.

Pojďme na to!

Získání dat koridoru

Prvním krokem je získání dat koridoru. Model koridoru vybereme podle jeho názvu, v rámci koridoru vybereme konkrétní základnu a poté získáme návrhovou linii v rámci základny podle jejího kódu bodu.

Vytvoření souřadnicových systémů

Nyní vytvoříme souřadnicové systémy podél návrhových linií koridoru mezi daným počátečním a koncovým staničením. Tyto souřadnicové systémy se použijí k zarovnání geometrie bloku profilu vozidla s koridorem.

1. Všimněte si malých písmen XXX v pravém dolním rohu uzlu. Tato písmena znamenají, že nastavení vázání uzlu je nastaveno na hodnotu Vektorový součin, což je nutné k vytvoření souřadnicových systémů ve stejných hodnotách staničení pro obě návrhové linie.

Transformace geometrie bloku

Nyní je třeba nějakým způsobem vytvořit pole profilů vozidel podél návrhových linií. Provedeme transformaci geometrie z definice bloku profilu vozidla pomocí uzlu Geometry.Transform. Tento koncept je složitý na vizualizaci, takže než se podíváme na uzly, zde je grafické znázornění toho, co se stane.

V podstatě tedy přebíráme geometrii aplikace Dynamo z jedné definice bloku a přesouváme/otáčíme ji, přičemž vytváříme pole podél návrhové linie. Skvělá věc! Takto vypadá posloupnost uzlů.

1. Tento uzel získá definici bloku z dokumentu.

2. Tyto uzly získají geometrii objektů aplikace Dynamo v rámci bloku.

3. Tyto uzly v podstatě definují souřadnicový systém, ze kterého transformujeme geometrii.

4. A konečně tento uzel provádí vlastní transformaci geometrie.

5. Všimněte, že v tomto uzlu je definováno vázání Nejdelší.

A tady vidíme výsledek v aplikaci Dynamo.

Vytvoření těles

Máme pro vás skvělou zprávu. To nejtěžší je za námi. Nyní je třeba pouze vygenerovat tělesa mezi profily. Toho snadno dosáhneme pomocí uzlu Solid.ByLoft.

Zde je výsledek. Nezapomeňte, že se jedná o tělesa aplikace Dynamo – musíme je ještě vytvořit v aplikaci Civil 3D.

Výstup těles do aplikace Civil 3D

Posledním krokem je vytvoření vygenerovaných těles v modelovém prostoru. Také jim přiřadíme barvu, aby byly dobře viditelné.

Výsledek

Zde je příklad spuštění grafu pomocí Přehrávače skriptů Dynamo.

Nápady

Zde je několik nápadů, jak byste mohli rozšířit možnosti tohoto grafu.

Aplikace Dynamo for Civil 3D obsahuje velmi výkonný mechanismus pro „zapamatování“ objektů vytvořených jednotlivými uzly. Tento mechanismus se nazývá vazby objektů a umožňuje grafu aplikace Dynamo vytvářet konzistentní výsledky při každém spuštění ve stejném dokumentu. I když je to v mnoha situacích velmi žádoucí, existují jiné situace, kdy budete chtít mít nad chováním aplikace Dynamo větší kontrolu. Tato část vám pomůže pochopit, jak vazby objektů fungují a jak je můžete využít.

Příklad

Podívejme se na tento graf, který vytváří kružnici v modelovém prostoru v aktuální hladině.

Všimněte si, co se stane, když se poloměr změní.

Toto je vazba objektů v akci. Aplikace Dynamo se ve výchozím nastavení chová tak, že upraví poloměr kružnice, místo aby při každé změně vstupu poloměru vytvořila novou kružnici. Je tomu tak proto, že uzel Object.ByGeometry si „pamatuje“, že při každém spuštění grafu vytvořil tuto konkrétní kružnici. Aplikace Dynamo si navíc tuto informaci uloží, takže při příštím otevření dokumentu aplikace Civil 3D a spuštění grafu se bude chovat úplně stejně.

Jiný příklad

Podívejme se na příklad, ve kterém můžete chtít změnit výchozí chování vazby objektů aplikace Dynamo. Řekněme, že chcete vytvořit graf, který umístí text do středu kružnice. Vaším záměrem je však, aby graf mohl být spouštěn stále dokola a přitom se pokaždé umístil nový text do jakékoli vybrané kružnice. Níže vidíte, jak by mohl tento graf vypadat.

Toto se však ve skutečnosti stane, když je vybrána jiná kružnice.

Po provedení této změny získáme požadované chování.

Nastavení vazby

Aplikace Dynamo for Civil 3D umožňuje upravit výchozí chování vazby objektů pomocí nastavení Úložiště dat vazeb v nabídce aplikace Dynamo.

Ve výchozím nastavení jsou povoleny všechny možnosti. Zde je souhrn toho, co jednotlivé možnosti dělají.

Možnost 1: Nebyla zachována žádná data vazeb

Pokud je tato povolena možnost, aplikace Dynamo „zapomene“ na objekty, které vytvořila při posledním spuštění grafu. Graf lze tedy spustit v libovolném výkresu v libovolné situaci a pokaždé vytvoří nové objekty.

Možnost 2: Uložit v grafu pro aplikaci Dynamo

Tato možnost znamená, že metadata vazby objektů budou při ukládání serializována do grafu (soubor .dyn). Pokud graf zavřete nebo znovu otevřete a spustíte jej ve stejném výkresu, pak by mělo vše fungovat stejně, jako když jste jej opustili. Jestliže graf spustíte v jiném výkresu, budou data vazby z grafu odstraněna a vytvoří se nové objekty. To znamená, že pokud otevřete původní výkres a spustíte graf znovu, vytvoří se kromě starých objektů i nové.

Možnost 3: Uložit ve výkresu pro aplikaci Dynamo

Tato možnost je podobná možnosti 2, s tím rozdílem, že data vazby objektu jsou jsou serializována ve výkresu namísto v souboru .dyn. Pokud graf zavřete nebo znovu otevřete a spustíte jej ve stejném výkresu, pak by mělo vše fungovat stejně, jako když jste jej opustili. Jestliže graf spustíte v jiném výkresu, data vazby zůstanou zachována v původním výkresu, protože jsou uložena ve výkresu, nikoli v grafu.

Možnost 4: Uložit ve výkresu pro aplikaci Přehrávač skriptů Dynamo

V první řadě je třeba poznamenat, že tato možnost nemá žádný vliv na interakci grafu s výkresem při spuštění grafu prostřednictvím hlavního rozhraní aplikace Dynamo. Tato možnost se použije pouze tehdy, když je graf spuštěn pomocí Přehrávače skriptů Dynamo.

Jestliže graf spustíte pomocí hlavního rozhraní aplikace Dynamo a pak jej zavřete a spustíte stejný graf pomocí Přehrávače skriptů Dynamo, vytvoří se nové objekty nad těmi, které byly vytvořeny dříve. Jakmile však Přehrávač skriptů Dynamo graf jednou spustí, serializuje data vazeb objektů ve výkresu. Pokud tedy graf spustíte vícekrát prostřednictvím Přehrávače skriptů Dynamo, bude objekty aktualizovat, místo aby vytvářel nové. Jestliže graf spustíte v Přehrávači skriptů Dynamo v jiném výkresu, data vazby zůstanou zachována v původním výkresu, protože jsou uložena ve výkresu, nikoli v grafu.

Aplikace Dynamo je sice jako nástroj pro extrémně výkonná, ale můžete jít také nad rámec uzlů a drátů a psát kód v textové podobě. To lze provést dvěma způsoby:

1. Psát v jazyce DesignScript pomocí bloku kódu.

2. Psát v jazyce Python pomocí uzlu jazyka Python.

V této části se zaměříme na to, jak lze pomocí jazyka Python v prostředí aplikace Civil 3D efektivně využívat rozhraní .NET API aplikací AutoCAD a Civil 3D.

Dokumentace k rozhraní API

Aplikace AutoCAD i Civil 3D mají k dispozici několik rozhraní API, která umožňují vývojářům, jako jste vy, rozšířit základní produkt o vlastní funkce. V kontextu aplikace Dynamo jsou relevantní spravovaná rozhraní .NET API. Následující odkazy jsou důležité pro pochopení struktury rozhraní API a způsobu jejich fungování.

Šablona kódu

Při první úpravě nového uzlu jazyka Python bude tento uzel předvyplněn kódem šablony, abyste mohli začít. Zde je rozpis šablony s vysvětlením jednotlivých bloků.

1. Importuje moduly sys a clr, které jsou nezbytné pro správnou funkci interpretu jazyka Python. Modul clr zejména umožňuje, aby se se jmennými prostory .NET zacházelo v podstatě jako s balíčky jazyka Python.

2. Načte standardní sestavy (tj. knihovny DLL) pro práci se spravovanými rozhraními .NET API pro aplikace AutoCAD a Civil 3D.

3. Přidá odkazy na standardní jmenné prostory aplikací AutoCAD a Civil 3D. Jsou ekvivalentní direktivám using nebo Imports v jazyce C# nebo VB.NET (v uvedeném pořadí).

4. Vstupní porty uzlu jsou přístupné pomocí předdefinovaného seznamu s názvem IN. K datům v určitém portu můžete přistupovat pomocí jeho čísla indexu, například dataInFirstPort = IN[0].

5. Vrátí aktivní dokument a editor.

6. Uzamkne dokument a zahájí transakci databáze.

7. Zde byste měli umístit většinu logiky skriptu.

8. Zrušte komentář tohoto řádku, aby se po dokončení hlavní práce provedla transakce.

9. Pokud chcete z uzlu získat výstup libovolných dat, přiřaďte je na konci skriptu proměnné OUT.

Příklad

Pojďme si na příkladu ukázat některé základní koncepty psaní skriptů jazyka Python v aplikaci Dynamo for Civil 3D.

Cíl

Datová sada

Zde jsou příklady souborů, na které se můžete odkazovat v tomto cvičení.

Přehled řešení

Zde je uveden přehled logiky tohoto grafu.

1. Zkontrolujte dokumentaci rozhraní API aplikace Civil 3D.

2. Vyberte všechna povodí v dokumentu podle názvu hladiny.

3. „Rozbalte“ objekty aplikace Dynamo a získejte přístup k interním prvkům rozhraní API aplikace Civil 3D.

4. Vytvořte body aplikace Dynamo z bodů aplikace AutoCAD.

5. Vytvořte pomocí bodů objekty PolyCurve.

Pojďme na to!

Kontrola dokumentace rozhraní API

Načtení všech povodí

Nyní můžeme začít vytvářet logiku grafu. Nejprve je nutné získat seznam všech povodí v dokumentu. Pro tuto operaci jsou k dispozici uzly, takže ji nemusíme zahrnovat do skriptu jazyka Python. Použití uzlů nabízí lepší přehlednost pro někoho, kdo by mohl graf číst (místo procházení velkého množství kódu ve skriptu jazyka Python), a také udržuje skript jazyka Python zaměřený na jednu věc: vrácení hraničních bodů povodí.

Všimněte si, že výstup z uzlu All Objects on Layer je seznam objektů CivilObject. Je tomu tak proto, že aplikace Dynamo for Civil 3D aktuálně nemá žádné uzly pro práci s povodími, což je celý důvod, proč přistupovat k rozhraní API prostřednictvím jazyka Python.

Rozbalení objektů

Skript jazyka Python

Zde je úplný skript jazyka Python, který provádí přístup k vnitřním objektům povodí a získává jejich hraniční body. Zvýrazněné řádky jsou upraveny/přidány oproti výchozímu kódu šablony.

Vytvoření objektů PolyCurves

V této fázi by měl skript jazyka Python vygenerovat seznam bodů aplikace Dynamo, který si můžete prohlédnout v náhledu na pozadí. Posledním krokem je jednoduché vytvoření objektů PolyCurve z těchto bodů. To lze provést také přímo ve skriptu jazyka Python, ale záměrně jsme tento krok umístili mimo skript do uzlu kvůli lepší přehlednosti. Zde je výsledný graf.

Výsledek

A zde je výsledná geometrie aplikace Dynamo.

IronPython vs. CPython

Jen stručná poznámka, než skončíme toto téma. V závislosti na používané verzi aplikace Civil 3D může být uzel jazyka Python konfigurován odlišně. V aplikacích Civil 3D 2020 a 2021 používala aplikace Dynamo k přesunu dat mezi objekty .NET a skripty jazyka Python nástroj IronPython. V aplikaci Civil 3D 2022 však aplikace Dynamo používá standardní nativní interpret jazyka Python (neboli CPython), který používá jazyk Python 3. Mezi výhody přechodu na tento interpret patří přístup k oblíbeným moderním knihovnám a novým funkcím platformy, nezbytná údržba a bezpečnostní opravy.

1. Tento řádek získá konkrétní třídu, kterou potřebujeme, z knihovny geometrie aplikace Dynamo. Všimněte si, že zde uvádíme import Point as DynPoint místo import *, protože druhá možnost by mohla způsobit kolizi názvů.

2. Zde přesně určíme, který vstupní port obsahuje požadovaná data, namísto výchozího zadání IN, které odkazuje na celý seznam všech vstupů.

Přehrávač skriptů Dynamo nabízí zjednodušený způsob spouštění grafů aplikace Dynamo v aplikaci Civil 3D. Jakmile je graf vytvořen, nejsou k používání Přehrávače a spouštění grafů zapotřebí žádné odborné znalosti aplikace Dynamo. To usnadňuje sdílení grafů s ostatními uživateli, kteří nemají zájem pronikat do detailů uzlů a drátů.

Balíčky aplikace Dynamo jsou sady nástrojů vyvinuté třetími stranami za účelem rozšíření základních funkcí aplikace Dynamo. Jsou přístupné všem a připravené ke stažení kliknutím na tlačítko.

Zde je seznam některých nejoblíbenějších balíčků, které mohou posunout vaše grafy aplikace Dynamo for Civil 3D na vyšší úroveň.

Civil 3D Toolkit

Civil 3D Toolkit je balíček pro aplikaci Dynamo for Civil 3D, který nabízí významná vylepšení funkcí aplikace Dynamo prostřednictvím velkého množství dalších uzlů.

Zpětná vazba

Související kurzy na webu Autodesk University

Camber

Camber je balíček pro aplikaci Dynamo for Civil 3D s otevřeným zdrojovým kódem, který obsahuje stovky uzlů pro práci s popisky, externími referencemi, datovými zkratkami, styly a pro další akce.

Zpětná vazba

Zdrojový kód

CivilConnection

CivilConnection je balíček pro aplikaci Dynamo pro aplikaci Revit s otevřeným zdrojovým kódem, který umožňuje výměnu informací mezi aplikacemi Civil 3D, Dynamo a Revit.

Související kurzy na webu Autodesk University

Zdrojový kód

Arkance Systems Nodes

Arkance Systems Nodes je balíček pro aplikaci Dynamo for Civil 3D, který obsahuje řadu užitečných uzlů pro práci s kótami, tabulkami, pohledy, řízením vrtání a dalšími funkcemi.

Zpětná vazba

Dokumentace