Język Python i program Civil 3D
Last updated
Last updated
Dodatek Dynamo daje niezwykłe możliwości jako narzędzie do programowania wizualnego. Można jednak pominąć węzły i przewody, aby pisać kod w postaci tekstowej. Można to zrobić na dwa sposoby:
Pisanie kodu DesignScript za pomocą węzła Code Block
Pisanie kodu Python za pomocą węzła Python
W tej sekcji omówiono używanie języka Python w środowisku programu Civil 3D w celu wykorzystywania interfejsów API .NET programów AutoCAD i Civil 3D.
Aby uzyskać bardziej ogólne informacje na temat używania języka Python w dodatku Dynamo, skorzystaj z sekcji Python.
Dla programów AutoCAD i Civil 3D jest dostępnych po kilka interfejsów API, które umożliwiają programistom rozszerzanie produktu podstawowego o funkcje niestandardowe. W kontekście dodatku Dynamo istotne są interfejsy API kodu zarządzanego .NET. Poniższe łącza prowadzą do informacji niezbędnych do zrozumienia struktury tych interfejsów API i sposobu ich działania.
Podręcznik programisty interfejsu API .NET dla programu AutoCAD
Podręcznik użytkownika interfejsu API .NET dla programu AutoCAD
Podręcznik programisty interfejsu API .NET dla programu Civil 3D
Podręcznik użytkownika interfejsu API .NET dla programu Civil 3D
Podczas zapoznawania się z tą sekcją możesz zetknąć się z pewnymi nowymi dla Ciebie pojęciami, takimi jak bazy danych, transakcje, metody, właściwości itp. Wiele z tych pojęć należy do podstaw pracy z interfejsami API .NET i nie są one charakterystyczne ani dla dodatku Dynamo, ani dla języka Python. Szczegółowe omówienie tych elementów wykracza poza zakres tej sekcji przewodnika Primer, dlatego zaleca się częste korzystanie z informacji, do których prowadzą powyższe łącza.
Podczas pierwszej edycji nowego węzła w języku Python jest on wstępnie wypełniany kodem-szablonem, aby przyspieszyć rozpoczęcie pracy. Oto podział szablonu z objaśnieniami dotyczącymi każdego bloku.
Importuje moduły
sys
iclr
, które są niezbędne do poprawnego działania interpretera języka Python. W szczególności modułclr
umożliwia traktowanie przestrzeni nazw .NET jako pakietów Python.Wczytuje standardowe zespoły (np. pliki DLL) do pracy z interfejsami API kodu zarządzanego .NET dla programów AutoCAD i Civil 3D.
Dodaje odniesienia do standardowych przestrzeni nazw programów AutoCAD i Civil 3D. Są one równoważne z dyrektywami
using
lubImports
odpowiednio w języku C# i w języku VB.NET.Dostęp do portów wejściowych węzła można uzyskać za pomocą wstępnie zdefiniowanej listy o nazwie
IN
. Dostęp do danych w określonym porcie można uzyskać, używając numeru indeksu, na przykładdataInFirstPort = IN[0]
.Pobiera aktywny dokument i edytor.
Blokuje dokument i inicjuje transakcję bazy danych.
W tym miejscu należy umieścić większość kodu logiki skryptu.
Usuń oznaczenie komentarza tego wiersza, aby zatwierdzić transakcję po zakończeniu głównej pracy.
Aby zapisać dane wyjściowe węzła, należy przypisać je do zmiennej
OUT
na końcu skryptu.
Chcesz wprowadzić dostosowania?
Domyślny szablon w języku Python można zmodyfikować, edytując plik PythonTemplate.py
znajdujący się w folderze C:\ProgramData\Autodesk\C3D <version>\Dynamo
.
Przeanalizujmy przykład, aby zademonstrować niektóre z najważniejszych pojęć dotyczących pisania skryptów w języku Python w dodatku Dynamo for Civil 3D.
Poniżej przedstawiono przykładowe pliki, z których można korzystać w trakcie tego ćwiczenia.
Poniżej przedstawiono przegląd logiki na tym wykresie.
Zapoznaj się z dokumentacją interfejsu API programu Civil 3D
Wybranie wszystkich zlewni w dokumencie na podstawie nazwy warstwy
„Odpakowanie” obiektów Dynamo, aby uzyskać dostęp do wewnętrznych składników interfejsu API programu Civil 3D
Utworzenie punktów dodatku Dynamo na podstawie punktów programu AutoCAD
Utworzenie krzywych PolyCurve z punktów
Zacznijmy!
Przed rozpoczęciem tworzenia wykresu i pisania kodu warto zapoznać się z dokumentacją interfejsu API programu Civil 3D i dowiedzieć się, co udostępnia ten interfejs API. W tym przypadku istnieje właściwość w klasie zlewni (Catchment), która zwraca punkty obwiedni zlewni. Ta właściwość zwraca obiekt Point3dCollection
, którego dodatek Dynamo nie jest w stanie domyślnie obsługiwać. Oznacza to, że nie można utworzyć krzywej PolyCurve z obiektu Point3dCollection
, więc konieczne będzie przekształcenie wszystkiego w punkty dodatku Dynamo. Więcej informacji na ten temat podamy w dalszej części.
Teraz możemy zacząć tworzyć logikę wykresu. Pierwszą czynnością, którą należy wykonać, jest pobranie listy wszystkich zlewni w dokumencie. Dostępne są węzły do obsługi tej operacji, więc nie trzeba uwzględniać jej w skrypcie w języku Python. Używanie węzłów zapewnia lepszą przejrzystość dla innych osób czytających wykres (w przeciwieństwie do używania dużej ilości kodu w skrypcie w języku Python) i pozwala skupić się w kodzie w języku Python na jednej rzeczy: zwróceniu punktów obwiedni zlewni.
Warto zwrócić uwagę, że wyjście z węzła All Objects on Layer jest listą obiektów programu Civil (CivilObject). Jest to spowodowane tym, że dodatek Dynamo for Civil 3D nie zawiera obecnie żadnych węzłów do pracy ze zlewniami. Dlatego właśnie należy uzyskać dostęp do interfejsu API za pośrednictwem języka Python.
Zanim przejdziemy dalej, musimy krótko odnieść się do ważnego pojęcia. W sekcji Biblioteka węzłów omówiono powiązania obiektów i obiektów programu Civil (CivilObject). Bardziej szczegółowo można powiedzieć, że obiekt Dynamo jest opakowaniem dla elementu programu AutoCAD. Podobnie obiekt programu Civil w dodatku Dynamo (CivilObject) jest opakowaniem dla elementu programu Civil 3D. Można „odpakować” obiekt, uzyskując dostęp do jego właściwości InternalDBObject
lub InternalObjectId
.
Obiekt Autodesk.AutoCAD.DynamoNodes.Object
Element Autodesk.AutoCAD.DatabaseServices.Entity
CivilObject Autodesk.Civil.DynamoNodes.CivilObject
Element Autodesk.Civil.DatabaseServices.Entity
Ogólnie bezpieczniej jest uzyskać identyfikator obiektu za pomocą właściwości InternalObjectId
, a następnie uzyskać dostęp do opakowanego obiektu w transakcji. Wynika to z tego, że właściwość InternalDBObject
zwraca obiekt DBObject programu AutoCAD, który nie jest w stanie zapisywalnym.
Oto pełny skrypt w języku Python, który wykonuje operacje polegające na uzyskaniu dostępu do wewnętrznych obiektów zlewni i pobraniu ich punktów obwiedni. Wyróżnione wiersze to te zmodyfikowane lub dodane w domyślnym kodzie-szablonie.
Klikaj podkreślony tekst w skrypcie, aby uzyskać wyjaśnienia dotyczące poszczególnych wierszy.
Ogólnie najlepszą praktyką jest umieszczenie większości kodu logiki skryptu wewnątrz transakcji. Zapewnia to bezpieczny dostęp do obiektów, które są odczytywane/zapisywane przez skrypt. W wielu przypadkach pominięcie transakcji może spowodować błąd krytyczny.
Na tym etapie skrypt w języku Python powinien zwrócić listę punktów dodatku Dynamo, które można wyświetlić w podglądzie w tle. Ostatnią czynnością jest utworzenie krzywych PolyCurve na podstawie punktów. Warto zauważyć, że można to również zrobić bezpośrednio w skrypcie w języku Python. Jednak celowo umieściliśmy tę operację poza skryptem w węźle, aby była bardziej widoczna. Oto ostateczny wykres.
Oto ostateczna geometria dodatku Dynamo.
Zanim zakończymy tę część, omówmy jeszcze jedną kwestię. W zależności od używanej wersji programu Civil 3D węzeł w języku Python może być skonfigurowany w określony sposób. W programach Civil 3D 2020 i 2021 dodatek Dynamo używał narzędzia o nazwie IronPython do przenoszenia danych między obiektami .NET a skryptami w języku Python. Jednak w programie Civil 3D 2022 dodatek Dynamo używa standardowego natywnego interpretera języka Python (znanego jako CPython), w którym jest używany język Python 3. Korzyści płynące z przejścia na nowy model obejmują dostęp do popularnych nowoczesnych bibliotek i nowych funkcji platformy, niezbędne poprawki konserwacyjne i poprawki zabezpieczeń.
Więcej informacji na temat tego przejścia i uaktualniania starszych skryptów można znaleźć w blogu dotyczącym dodatku Dynamo. Aby nadal używać mechanizmu IronPython, wystarczy zainstalować pakiet DynamoIronPython2.7 za pomocą Menedżera pakietów Dynamo.
Ten wiersz pobiera określoną potrzebną klasę z biblioteki geometrii dodatku Dynamo. Uwaga: określono tutaj import Point as DynPoint
zamiast import *
, ponieważ ta druga opcja spowodowałaby kolizje nazw.
Tutaj dokładnie określamy, który port wejściowy zawiera dane, jakie mają być używane, zamiast domyślnych IN
, które odnoszą się do całej listy wszystkich danych wejściowych.
Pobieranie geometrii obwiedni wszystkich zlewni na rysunku.
Misja wykonana!