1 of 1

Python 및 Civil 3D

Dynamo는 시각적 프로그래밍 도구로서 매우 강력하지만 노드 및 와이어를 넘어 문자 형식으로 코드를 작성하는 것도 가능합니다. 이 작업은 다음과 같은 두 가지 방법으로 수행할 수 있습니다.

Code Block을 사용하여 DesignScript 쓰기
Python 노드를 사용하여 Python 쓰기

이 섹션에서는 Civil 3D 환경에서 Python을 활용하여 AutoCAD 및 Civil 3D .NET API를 활용하는 방법에 대해 중점적으로 설명합니다.

Dynamo에서 Python을 사용하는 방법에 대한 보다 일반적인 정보는 Python 섹션을 참조하십시오.

API 문서

AutoCAD와 Civil 3D에는 여러분과 같은 개발자가 사용자 지정 기능으로 핵심 제품을 확장할 수 있는 여러 API가 있습니다. Dynamo의 컨텍스트에서 관련성이 있는 것은 관리되는 .NET API입니다. 다음 링크는 API의 구조 및 작동 방식을 이해하는 데 필수적입니다.

AutoCAD .NET API 개발자 안내서

AutoCAD .NET API 참조 안내서

Civil 3D .NET API 개발자 안내서

Civil 3D .NET API 참조 안내서

이 섹션을 진행하면서 데이터베이스, 트랜잭션, 메서드, 특성 등 익숙하지 않은 개념이 접할 수 있습니다. 이러한 개념 중 대부분은 .NET API 작업의 핵심이며 Dynamo 또는 Python에만 국한되지 않습니다. 이러한 항목에 대해 자세히 설명하는 것은 이 입문서 섹션의 범위를 벗어나는 것이므로 더 자세한 내용은 위의 링크를 자주 참조하는 것이 좋습니다.

코드 템플릿

새 Python 노드를 처음 편집하면 시작할 수 있도록 템플릿 코드가 미리 채워져 있습니다. 아래에는 각 블록에 대한 설명과 함께 템플릿을 분석한 내용이 나와 있습니다.

sys 및 clr 모듈을 가져옵니다. 둘 다 Python 인터프리터가 제대로 작동하는 데 필요합니다. 특히 clr 모듈을 사용하면 .NET 네임스페이스를 기본적으로 Python 패키지로 처리할 수 있습니다.
AutoCAD 및 Civil 3D를 위한 관리되는 .NET API로 작업하기 위한 표준 어셈블리(예: DLL)를 로드합니다.
표준 AutoCAD 및 Civil 3D 네임스페이스에 참조를 추가합니다. 이는 각각 C# 또는 VB.NET의 using 또는 Imports 지시어와 동일합니다.
노드의 입력 포트에는 IN라는 사전 정의된 리스트를 사용하여 액세스할 수 있습니다. 색인 번호를 사용하여 특정 포트의 데이터에 액세스할 수 있습니다(예: dataInFirstPort = IN[0]).
활성 문서 및 편집기를 가져옵니다.
문서를 잠그고 데이터베이스 트랜잭션을 시작합니다.
여기에 스크립트 논리의 대부분을 배치해야 합니다.
주 작업이 완료된 후 이 행의 주석을 해제하여 트랜잭션을 커밋합니다.
노드에서 데이터를 출력하려면 스크립트 끝에 있는 OUT 변수에 데이터를 지정합니다.

사용자화하시겠습니까? C:\ProgramData\Autodesk\C3D <version>\Dynamo에 있는 PythonTemplate.py 파일을 편집하여 기본 Python 템플릿을 수정할 수 있습니다.

예

예제를 통해 Dynamo for Civil 3D에서 Python 스크립트를 작성하는 데 필요한 몇 가지 기본 개념을 살펴보겠습니다.

목표

데이터세트

다음은 이 연습에서 참조할 수 있는 예제 파일입니다.

솔루션 개요

이 그래프의 논리에 대한 개요는 다음과 같습니다.

Civil 3D API 문서 검토
문서에서 도면층 이름별로 모든 유역 선택
Dynamo 객체를 "언래핑"하여 내부 Civil 3D API 멤버에 액세스
AutoCAD 점에서 Dynamo 점 작성
점에서 PolyCurve 작성

그럼 시작하겠습니다!

API 설명서 검토

그래프 작성과 코드 작성을 시작하기 전에 Civil 3D API 문서를 살펴보고 API가 제공하는 기능을 파악하는 것이 좋습니다. 이 경우 유역의 경계 점을 반환하는 특성이 유역 클래스에 있습니다. 이 특성은 Point3dCollection 객체를 반환하는데, Dynamo에서 이 객체를 어떻게 사용할지 알 수 없습니다. 다시 말해, Point3dCollection에서 PolyCurve를 작성할 수 없으므로, 결국 모든 항목을 Dynamo 점으로 변환해야 합니다. 이에 대해서는 나중에 더 자세히 살펴보겠습니다.

모든 유역 가져오기

이제 그래프 논리 작성을 시작할 수 있습니다. 가장 먼저 해야 할 일은 문서에 있는 모든 유역 리스트를 가져오는 것입니다. 이를 위해 사용할 수 있는 노드가 있으므로 Python 스크립트에 포함할 필요가 없습니다. 노드를 사용하면 그래프를 읽을 수 있는 다른 사람에게 더 나은 가시성을 제공할 수 있습니다(Python 스크립트에 많은 코드를 묻어두는 것에 비해). 또한 Python 스크립트가 유역의 경계 점을 반환하는 한 가지 작업에 집중할 수 있도록 해줍니다.

여기서 All Objects on Layer 노드의 출력은 CivilObjects 목록입니다. 이는 현재 Dynamo for Civil 3D에 유역 작업을 위한 노드가 없기 때문이며, 이것이 바로 Python을 통해 API에 액세스해야 하는 이유입니다.

객체 언래핑

더 자세히 알아보기 전에 중요한 개념을 간단히 살펴봐야 합니다. 노드 라이브러리 섹션에서 객체와 CivilObjects가 어떻게 관련되어 있는지 살펴보았습니다. 이에 대해 조금 더 자세히 설명하자면, Dynamo 객체는 AutoCAD 도면요소를 감싸는 래퍼입니다. 마찬가지로, Dynamo CivilObject도 Civil 3D 도면요소를 감싸는 래퍼입니다. 해당 InternalDBObject 또는 InternalObjectId 특성에 액세스하여 객체의 "언래핑"할 수 있습니다.

경험상 일반적으로 InternalObjectId 특성을 사용하여 객체 ID를 가져온 다음 트랜잭션에서 래핑된 객체에 액세스하는 것이 더 안전합니다. 이는 InternalDBObject 특성이 쓰기 가능 상태가 아닌 AutoCAD DBObject를 반환하기 때문입니다.

Python 스크립트

다음은 내부 유역 객체에 액세스하는 작업을 수행하는 완전한 Python 스크립트가 해당 경계 점을 가져오는 것입니다. 강조 표시된 행은 기본 템플릿 코드에서 수정/추가된 행을 나타냅니다.

각 행에 대한 설명을 보려면 스크립트에서 밑줄이 있는 문자를 클릭합니다.

경험상 스크립트 논리의 대부분은 트랜잭션 내에 포함하는 것이 가장 좋습니다. 이렇게 하면 스크립트가 읽기/쓰기 중인 객체에 안전하게 액세스할 수 있습니다. 대부분의 경우 트랜잭션을 생략하면 치명적 오류가 발생할 수 있습니다.

PolyCurve 만들기

이 단계에서 Python 스크립트는 배경 미리보기에서 볼 수 있는 Dynamo 점 리스트를 출력해야 합니다. 마지막 단계는 점에서 PolyCurve를 만드는 것입니다. 이 작업은 Python 스크립트에서 직접 수행할 수도 있지만, 더 잘 보이도록 의도적으로 스크립트 외부의 노드에 배치했습니다. 최종 그래프의 모습은 다음과 같습니다.

결과

최종 Dynamo 형상은 다음과 같습니다.

IronPython과 CPython

마무리하기 전에 간단히 한 가지 더 알려드리겠습니다. 사용 중인 Civil 3D 버전에 따라 Python 노드가 다르게 구성될 수 있습니다. Civil 3D 2020 및 2021에서 Dynamo는 IronPython이라는 도구를 사용하여 .NET 객체와 Python 스크립트 간에 데이터를 이동했습니다. 그러나 Civil 3D 2022에서는 Dynamo가 Python 3을 사용하는 대신 표준 기본 Python 인터프리터(CPython)를 사용하도록 전환되었습니다. 이러한 전환의 이점으로는 널리 사용되는 최신 라이브러리와 새로운 플랫폼 기능, 필수 유지보수 및 보안 패치에 대한 액세스가 포함됩니다.

Dynamo 블로그에서 이 전환에 대한 자세한 내용과 기존 스크립트를 업그레이드하는 방법을 확인할 수 있습니다. IronPython을 계속 사용하려면 Dynamo Package Manager를 사용하여 DynamoIronPython2.7 패키지를 설치하기만 하면 됩니다.

이 행은 Dynamo 형상 라이브러리에서 필요한 특정 클래스를 가져옵니다. import *는 명명 충돌을 유발할 수 있으므로, 여기서는 import Point as DynPoint를 지정합니다.
여기서는 모든 입력의 전체 리스트를 참조하는 기본 IN 대신 원하는 데이터가 포함되어 있는 입력 포트를 정확하게 지정합니다.