Dynamo は当初は Revit を念頭に置いて開発されたものでしたが、ビジュアル プログラミング ツールとしての汎用性は Revit を超えています。Dynamo は Civil 3D にも統合されるため 、ユーザは土木インフラストラクチャ プロジェクト用の強力な自動化ルーチンを作成できます。これは、一般的なタスクから最も複雑な設計ワークフローまで、あらゆる処理を行う上で非常に便利なツールであり、最終的に、時間の節約、設計の最適化、設計の意思決定の向上に役立ちます。Dynamo には、Civil 3D 専用に設計されたさまざまなノードが用意されています。さらに活発なコミュニティで、各種のサードパーティ製ライブラリが開発されています。

Primer のこの章では、Dynamo for Civil 3D の基本から始めて、より高度なトピックへと進んでいきます。

全体像について少し詳しく理解できたところで、Civil 3D で最初の Dynamo グラフを作成してみましょう。

Dynamo を開く

最初の手順は、Civil 3D で空のドキュメントを開くことです。次に、Civil 3D リボンの [管理] タブにナビゲートし、[ビジュアル プログラミング] パネルを探します。

Dynamo ボタンをクリックすると、別のウィンドウで Dynamo が起動します。

新しいグラフを開始する

Dynamo を開くと、開始画面が表示されます。[新規] をクリックして、空のワークスペースを開きます。

ノードを追加する

現在、空のワークスペースが表示されているはずです。Dynamo を実際に使用してみましょう。目標は次のとおりです。

🎯 モデル空間にテキストを挿入する Dynamo グラフを作成します。

とても簡単ですよね?しかし、開始する前に、いくつかの基礎事項を確認する必要があります。

Dynamo グラフの主要な構成要素は、ノードと呼ばれます。ノードは小さなマシンのようなものです。ノードにデータを入れると、そのデータに対して何らかの処理が行われ、結果が出力されます。Dynamo for Civil 3D には、ノードのライブラリが用意されています。このライブラリをワイヤで接続して、ノードが単独で実行する以上の規模と内容を実行できるグラフを形成することができます。

では、グラフを作成しましょう。必要なすべてのノードのリストを以下に示します。

これらのノードを見つけるには、ライブラリの検索バーにノード名を入力するか、キャンバス内の任意の場所を右クリックして検索します。

最終的なグラフは次ようになります。

ここで行った作業をまとめてみましょう。

1. 作業するドキュメントを選択しました。この場合(多くの場合)、Civil 3D のアクティブなドキュメントで作業します。

2. Text オブジェクトを作成する対象のブロック(この場合はモデル空間)を定義しました。

3. String ノードを使用して、テキストを配置するレイヤを指定しました。

真新しいグラフの結果を確認しましょう。

結果を確認する

Civil 3D に戻り、[モデル] タブが選択されていることを確認します。Dynamo で作成された新しい Text オブジェクトが表示されるはずです。

素晴らしい。次に、テキストを更新します。

Dynamo グラフに戻り、テキスト文字列、挿入位置の座標などの入力値をいくつか変更します。Civil 3D でテキストが自動的に更新されます。また、入力ポートの 1 つを接続解除すると、テキストが削除されることにも注意してください。元通りにつなぎ直すと、テキストが再度作成されます。

🎉 ミッションが達成されました。

次のステップ

この例では、Dynamo for Civil 3D で実行できる機能の基礎に触れただけです。詳細については読み続けてください。

時間の経過とともに、基本を超えて、Dynamo の内部の仕組みを詳細に理解する必要が出てくることがあります。このセクションのページでは、グラフを次のレベルに引き上げることができるように、Dynamo for Civil 3D の高度な機能を明らかにしていきます。

Dynamo for Civil 3D は、土木インフラ プロジェクトで作業するエンジニアや設計者に ビジュアル プログラミング のパラダイムを提供します。Dynamo は、Civil 3D ユーザ向けの一種のデジタル マルチツールと考えることができ、タスクが何であれ、作業に適したツールを提供します。直感的なインタフェースにより、一行もコードを記述することなく、強力でカスタマイズ可能なルーチンを作成できます。Dynamo を使用するにはプログラマで ある 必要はありませんが、プログラマのロジックを使用して 考える ことができる必要があります。この章は、Primer の他の章と併せて、計算設計の観点からどのようなタスクにも取り組むことができるように、ロジック スキルを構築するのに役立ちます。

履歴

Dynamo は Civil 3D 2020 で初めて導入され、その後も進化を続けています。当初はソフトウェアの更新プログラムを介して個別にインストールされていましたが、今では Civil 3D のすべてのバージョンにバンドルされるようになりました。使用している Civil 3D のバージョンによっては、Dynamo のインタフェースがこの章で示す例とは若干異なる場合があります。これは、Civil 3D 2023 のインタフェースが大幅に改良されたためです。

Dynamo の開発に関する最新情報については、 を参照してください。次の表は、Dynamo for Civil 3D のライフスパンにおける主要なマイルストーンの一覧です。

以前に、ノードは Dynamo グラフの主要な構成要素であり、ライブラリ内で論理グループに編成されていると説明しました。Dynamo for Civil 3D では、ライブラリ内に、Alignments、Profiles、Corridors、Block References など、AutoCAD および Civil 3D オブジェクトを操作するための専用ノードを含む 2 つのカテゴリ(シェルフ)があります。ライブラリの残りの部分には、本質的により汎用的であり、Dynamo のすべての「フレーバー」(Revit 用の Dynamo、Dynamo Sandbox など)間で一貫しているノードが含まれています。

1. AutoCAD および Civil 3D オブジェクトを操作するための特定のノード

2. 汎用ノード

3. 個別にインストールできるサードパーティ製パッケージのノード

ノード階層

AutoCAD ノードと Civil 3D ノードを使用するには、各シェルフ内のオブジェクト階層をしっかり理解しておくことが重要です。生物学ではあらゆる生物が体系的に分類されており、その分類法は、上位から下位にかけて、界、門、網、目、科、属、種という階層構造から成り立っています。AutoCAD と Civil 3D のオブジェクトも同様に分類されています。いくつかの例を使用して説明しましょう。

Civil オブジェクト

例として Alignment を使用しましょう。

目的が Alignment の名前を変更することであるとします。次に追加するノードは CivilObject.SetName ノードです。

最初は、あまり直感的には見えないかもしれません。CivilObject とは何ですか?ライブラリに Alignment.SetName ノードがないのはなぜですか?この答えは、再利用 と 簡易化 に関連しています。考えてみると、Civil 3D オブジェクトの名前を変更するプロセスは、オブジェクトが Alignment、Corridor、Profile など何であっても同じです。したがって、基本的にすべて同じ処理を行う繰り返しノード(Alignment.SetName、Corridor.SetName、Profile.SetName など)を使用する代わりに、その機能を単一のノードにラップすることをお勧めします。これはまさに、CivilObject.SetName で行うことです。

これについては、関係 の観点で考えることもできます。Alignment と Corridor は、リンゴと梨の両方が果実の一種であるように、どちらも Civil オブジェクトの一種です。Civil オブジェクト ノードはあらゆるタイプの Civil オブジェクトに適用されますが、これは、リンゴと梨の両方の皮をむくのに単一のピーラーを使用するのに似ています。果物の種類ごとに専用のピーラーを揃えていたら、キッチンはひどく散らかってしまいます。その意味で、Dynamo ノード ライブラリはキッチンとまったく同じです。

オブジェクト

では、この手順を一歩進めてみましょう。Alignment のレイヤを変更するとします。使用するノードは、Object.SetLayer ノードです。

CivilObject.SetLayer というノードがないのはなぜでしょうか?前述の再利用とシンプルさの原則が、ここにも適用されます。layer プロパティは、Line、Polyline、Text、Block Reference など、AutoCAD で描画または挿入できるオブジェクトに共通のものです。Alignment や Corridor などの Civil 3D オブジェクトは同じカテゴリに分類されるため、オブジェクトに適用されるノードは、どの Civil オブジェクトでも使用できます。

この Primer は、Dynamo for Civil 3D を使用する際の出発点にすぎません。Dynamo ユーザの発達したコミュニティがあり、豊富な知識を得ることができます。これらのリソース参照しながら、学習を続けてください。

Civil 3D ヘルプ

Dynamo フォーラム

Autodesk University

書籍

クリアランス検証のための運動学的エンベロープの開発は、鉄道設計の重要な部分です。Dynamo を使用すると、複雑なコリドー サブアセンブリを作成して管理する代わりに、エンベロープのソリッドを生成してこのジョブを実行できます。

目標

🎯 車両の縦断ブロックを使用して、コリドーに沿ってクリアランスのエンベロープ 3D ソリッドを生成します。

Dynamo for Civil 3D には、各ノードで作成されたオブジェクトを「記憶する」ための非常に強力なメカニズムが含まれています。このメカニズムはオブジェクト バインドと呼ばれ、これにより、Dynamo グラフは同じドキュメントで実行されるたびに一貫した結果を生成することができます。これは多くの状況で非常に望ましいことですが、Dynamo の動作をより詳細にコントロールしなければならない場合もあります。このセクションでは、オブジェクト バインドの仕組みと、その利点について説明します。

例

現在のレイヤでモデル空間に円を作成するこのグラフについて考えてみましょう。

半径が変更されるとどうなるかに注目してください。

Dynamo パッケージは、Dynamo のコア機能を拡張するためにサード パーティが開発したツールセットです。すべてのユーザがアクセスでき、ボタンをクリックすることでダウンロードできます。

Dynamo for Civil 3D のグラフを次のレベルに引き上げることができる最も人気の高いパッケージをいくつかご紹介します。

一般的な住宅開発のエンジニアリング設計には、汚水管、雨水排水、飲料水などの地下ユーティリティの使用が含まれます。この例では、Dynamo を使用して、配水本管から特定の区画にサービス接続を描画する方法を示します。これは、サービス接続を必要とするすべての区画で一般的であり、すべてのサービスを配置するには非常に面倒な作業が発生します。Dynamo を使用すると、必要なジオメトリを正確に自動的に描画したり、現地の関係機関の標準に合わせて調整できる柔軟な入力を提供したりすることで、プロセスをスピードアップすることができます。

目標

🎯水道メーターのブロック参照を区画線から指定したオフセットに配置し、配水本管に垂直に各サービス接続の線分を描画します。

主要な概念

• ユーザ入力に Select Object ノードを使用する

• 座標系を使用する

• Geometry.DistanceTo や Geometry.ClosestPointTo などのジオメトリ操作を使用する

バージョンの互換性

データセット

まず、以下のサンプル ファイルをダウンロードし、DWG ファイルと Dynamo グラフを開きます。

対処法

このグラフのロジックの概要を以下に示します。

1. 排水本管の曲線ジオメトリを取得する

2. ユーザ選択の区画線の曲線ジオメトリを取得し、必要に応じて反転する

3. サービス メーターの挿入点を生成する

以上です。

配水本管のジオメトリを取得する

最初の手順では、Dynamo に配水本管のジオメトリを取得します。Lines または Polylines を個別に選択するのではなく、特定のレイヤ上のすべてのオブジェクトを取得し、Dynamo のポリカーブとしてそれらを結合します。

区画線ジオメトリを取得する

次に、選択した区画線のジオメトリを Dynamo に取り込んで、作業できるようにする必要があります。このジョブに適したツールは Select Object ノードで、グラフのユーザは、Civil 3D で特定のオブジェクトを選択できます。

また、発生する可能性のある潜在的な問題にも対処する必要があります。区画線には始点と終点があります。つまり、方向があります。グラフで一貫した結果を生成するには、すべての区画線の方向が一貫している必要があります。この条件はグラフ ロジックで直接考慮できるため、グラフの弾力性が向上します。

1. 区画線の始点と終点を取得します。

2. 各点から配水本管までの距離を測定し、どちらの距離が大きいかを特定します。

3. 望ましい結果は、線分の始点が配水本管に最も近くなることです。そうでない場合は、区画線の方向を反転します。それ以外の場合は、元の区画線を返します。

挿入点を生成する

次に、サービス メーターが配置される場所を決定します。通常、配置は現地の関係機関の要件によって決定されるため、さまざまな条件に合わせて変更できる入力値を指定します。点を作成するための参照として、区画線に沿って座標系を使用します。これにより、区画線に対するオフセットを、その向きに関係なく、非常に簡単に定義できます。

接続点を取得する

次に、サービス メーターの位置に最も近い点を配水本管上で取得する必要があります。これにより、サービス接続が配水本管に対して常に垂直になるようにモデル空間にサービス接続を描画できます。Geometry.ClosestPointTo ノードは最適な対処法です。

1. これは配水本管のポリカーブです

2. これらは、サービス メーターの挿入点です

オブジェクトを作成する

最後の手順は、モデル空間にオブジェクトを実際に作成することです。以前に生成した挿入点を使用してブロック参照を作成し、次に、配水本管上のポイントを使用してをサービス接続に線分を描画します。

結果

グラフを実行すると、モデル空間に新しいブロック参照とサービス接続線が表示されます。入力をいくつか変更して、すべてが自動的に更新されるのを確認してください。

ボーナス: 順次配置を有効にする

1 つの区画線にオブジェクトを配置した後に、別の区画線を選択すると、オブジェクトが「移動」することがあります。

これは Dynamo の既定の動作で、多くの場合に非常に便利です。ただし、複数のサービス接続を順番に配置し、元の接続を変更するのではなく、Dynamo に実行ごとに新しいオブジェクトを作成させたい場合があるかもしれません。この動作は、オブジェクト バインドの設定を変更することでコントロールできます。

この設定を変更すると、Dynamo は各実行で作成されるオブジェクトを「忘れる」ようになります。次に、Dynamo プレーヤを使用してオブジェクト バインドをオフに設定した状態でグラフを実行する例を示します。

🎉 ミッションが達成されました。

アイデア

このグラフの機能を拡張する方法について、いくつかのアイデアを示します。

Civil 3D で COGO ポイントとポイント グループを使用して作業することは、多くのデータの一貫処理のプロセスの中核となる要素です。Dynamo はデータ管理に関して非常に優れています。この例では、その潜在的な使用例の 1 つを示します。

目標

🎯 一意の COGO ポイントの説明ごとにポイント グループを作成します。

主要な概念

• リストの操作

• List.GroupByKey ノードを使用して類似オブジェクトをグループ化する

• Dynamo プレーヤでカスタム出力を表示する

バージョンの互換性

データセット

まず、以下のサンプル ファイルをダウンロードし、DWG ファイルと Dynamo グラフを開きます。

対処法

このグラフのロジックの概要を以下に示します。

1. ドキュメント内のすべての COGO ポイントを取得する

2. COGO ポイントを説明でグループ化する

3. ポイント グループを作成する

以上です。

COGO ポイントを取得する

最初に、ドキュメント内のすべてのポイントグループを取得し、次に各グループ内のすべての COGO ポイントを取得します。これにより、ネストされたリスト、つまり「リストのリスト」が得られます。これは、List.Flatten ノードを使用してリスト全体をフラット化する場合に、後で操作が簡単になります。

ポイントを説明でグループ化する

すべての COGO ポイントを取得できたので、説明に基づいてグループに分類する必要があります。これは、まさに List.GroupByKey ノードが行う処理です。基本的に、同じキーを共有する項目をグループ化します。

ポイント グループを作成する

大変な作業は終わりました。最後の手順は、グループ化された COGO ポイントから新しい Civil 3D ポイント グループを作成することです。

概要を出力する

グラフを実行しても、ジオメトリを操作していないため、Dynamo の背景プレビューには何も表示されません。グラフが正しく実行されたかどうかを確認する唯一の方法は、ツールスペースを確認するか、ノード出力のプレビューを確認することです。ただし、Dynamo プレーヤを使用してグラフを実行する場合は、作成したポイント グループの概要を出力することで、グラフの結果に関するフィードバックを増やすことができます。必要な操作は、ノードを右クリックして[出力]に設定することだけです。この場合、名前を変更した Watch ノードを使用して結果を表示します。

結果

以下に、Dynamo プレーヤを使用してグラフを実行する例を示します。

🎉 ミッションが達成されました。

アイデア

このグラフの機能を拡張する方法について、いくつかのアイデアを示します。

Dynamo の多くの優れた使用事例の 1 つは、コリドー モデルに沿って個別のオブジェクトを動的に配置することです。多くの場合、オブジェクトはコリドーに沿って挿入されたアセンブリとは独立した位置に配置する必要があります。これは、手動で行うにはきわめて面倒な作業です。コリドーの水平ジオメトリまたは垂直ジオメトリが変更されると、大量の再作業が必要になります。

目標

🎯 Excel ファイルで指定した測点値でコリドーに沿って照明柱のブロック参照を配置します。

主要な概念

• 外部ファイル(この場合は Excel)からデータを読み込む

• ディクショナリ内のデータを編成する

• 座標系を使用して位置/尺度/回転をコントロールする

バージョンの互換性

データセット

まず、以下のサンプル ファイルをダウンロードし、DWG ファイルと Dynamo グラフを開きます。

対処法

このグラフのロジックの概要を以下に示します。

1. Excel ファイルを読み込み、データを Dynamo に読み込む

2. 指定したコリドー基線から計画線を取得する

3. 目的の測点でコリドー計画線に沿って座標系を生成する

以上です。

Excel データを取得する

このサンプル グラフでは、Excel ファイルを使用して、Dynamo が照明柱のブロック参照を配置するために使用するデータを保存します。表は次のようになります。

Excel データは、次ように Dynamo に読み込まれます。

データが得られたら、列(Corridor、Baseline、PointCode など)で分割して、グラフの残りの部分で使用できるようにする必要があります。これを行う一般的な方法は、List.GetItemAtIndex ノードを使用して、必要な列のインデックス番号を指定することです。たとえば、[Corridor] 列はインデックス 0、[Baseline] 列はインデックス 1、などです。

問題なさそうですね?しかし、このアプローチには潜在的な問題があります。Excel ファイルの列の順序が将来変更されたらどうなるでしょうか?あるいは、2 つの列の間に新しい列が追加されたら?その場合は、グラフが正しく機能しなくなり、更新が必要になります。Excel の列ヘッダーを キー として、残りのデータを 値 として使用して、データをディクショナリに入れることで、グラフを将来も使用できるように保証します。

これにより、Excel で列の順序を柔軟に変更できるため、グラフの柔軟性が向上します。列ヘッダーが同じであるかぎり、キー(列ヘッダー)を使用してディクショナリからデータを取得できます。これを次に実行します。

コリドー計画線を取得する

これで Excel データが読み込まれ、準備ができたので、このデータを使用して、コリドー モデルに関する情報を Civil 3D から取得しましょう。

1. コリドー モデルを名前で選択します。

2. コリドー内の特定の基線を取得します。

3. 基線内の計画線をポイント コードにより取得します。

座標系を生成する

ここで、Excel ファイルで指定した測点値でコリドー計画線に沿って座標系を生成します。これらの座標系は、照明柱のブロック参照の位置、回転、および尺度を定義するために使用されます。

基線のどちら側に座標系があるかに応じて座標系を回転するために、ここでコード ブロックを使用します。これは複数のノードのシーケンスを使用して実現できますが、これは単に書き出すほうが簡単である良い例です。

ブロック参照を作成する

あと少しです。ブロック参照を実際に配置するために必要なすべての情報が揃いました。まず、Excel ファイルの BlockName 列を使用して必要なブロック定義を取得します。

ここから、最後の手順としてブロック参照を作成します。

結果

グラフを実行すると、コリドーに沿ってモデル空間に新しいブロック参照が表示されます。これが素晴らしいところで、グラフの実行モードが[自動]に設定されている状態で Excel ファイルを編集すると、ブロック参照が自動的に更新されます。

以下に、Dynamo プレーヤを使用してグラフを実行する例を示します。

🎉 ミッションが達成されました。

ボーナス: Dynamo での視覚化

コンテキストを提供するために、Dynamo でコリドー ジオメトリを視覚化すると便利です。この特定のモデルでは、モデル空間で既に抽出されたコリドーのソリッドが存在するため、Dynamo に取り込んでみましょう。

しかし、他にも検討する必要があることがあります。ソリッドは比較的重いジオメトリ タイプであるため、この操作によってグラフの速度が低下します。ソリッドを表示するかどうかを、簡単に 選択 できる方法があれば便利です。解決策は非常に単純で、 Corridor.GetSolids ノードの接続を解除するだけですが、これによってすべての下流ノードに警告が生成されてしまう点が少々面倒です。この状況では、ScopeIf ノードが役に立ちます。

1. Object.Geometry ノードの下部にグレーのバーがあることに注目してください。これは、ノードのプレビューがオフになり(ノードを右クリックしてアクセス可能)、GeometryColor.ByGeometryColor が、背景プレビューでの表示優先順位に関して他のジオメトリとの「競合」を回避できることを意味します。

2. ScopeIf ノードを使用すると、基本的にノードのブランチ全体を選択的に実行できます。test 入力が false の場合、ScopeIf ノードに接続されたすべてのノードは実行されません。

Dynamo の背景プレビューの結果は次のとおりです。

アイデア

このグラフの機能を拡張する方法について、いくつかのアイデアを示します。

パイプ ネットワークにパイプと構造物を追加する場合、Civil 3D はテンプレートを使用して名前を自動的に割り当てます。通常、初期の配置時にはこの値で十分ですが、設計が進行するにつれて、必然的に名前を変更する必要が出てきます。さらに、要求される命名パターンは多数あります。たとえば、パイプ配管内で最も下流の構造物から始めて構造物に順番に命名したり、現地の関係機関のデータ スキーマに沿った命名パターンに従ったりすることです。この例では、Dynamo を使用して、あらゆるタイプの命名方法を定義して、一貫して適用する方法を示します。

目標

🎯 Alignment の測点に基づいて、パイプ ネットワーク構造物の名前を順番に変更します。

Dynamo プレーヤを使用すると、Civil 3D で Dynamo グラフを簡単に実行することができます。グラフが作成されたら、Dynamo の専門知識がなくても、Dynamo プレーヤを使用してグラフを実行できます。これにより、ノードやワイヤの詳細に関心のない他のユーザとグラフを簡単に共有できます。

道路、鉄道、土地、ユーティリティ、測量、GIS...。

土木インフラは、これらすべてが含まれますが、それだけではありません。このセクションでは、Dynamo に習熟し、Dynamo for Civil 3D の可能性を最大限に引き出すための、実践的で関連性の高いサンプル グラフをいくつか紹介します。各グラフには、作成に使用されたロジックの詳細な説明が含まれています。これにより、そのロジックを 使用 できるだけでなく、理解 できるようになります。

さらに、これらのサンプルは、強力なグラフを構築するための実績のあるベスト プラクティスを具体化しています。サンプルを使用して作業する際に、強力で柔軟性があり、保守が可能なグラフを構築する方法についてのアイデアについて、「」セクションを読むことをお勧めします。

Dynamo はビジュアル プログラミング ツールとして非常に強力ですが、ノードやワイヤを超えて、テキスト形式でコードを記述することもできます。これを行うには、次の 2 つの方法があります。

1. Code Block ノードを使用して DesignScript を記述する

2. Python ノードを使用して Python を記述する

このセクションでは、Civil 3D 環境で Python を活用して、AutoCAD および Civil 3D .NET API を利用する方法について説明します。

API ドキュメント

AutoCAD と Civil 3D にはどちらにも、開発者がカスタム機能を使用してコア製品を拡張できるようにする複数の API が用意されています。Dynamo のコンテキストで関連するのは、Managed .NET API です。次のリンクは、API の構造とその仕組みを理解するために不可欠です。

コード テンプレート

新しい Python ノードを初めて編集すると、開始するためのテンプレート コードがあらかじめ入力されます。ここでは、テンプレートの概要と各ブロックに関する説明を示します。

1. sys モジュールおよび clr モジュールを読み込みます。どちらも Python インタプリタが正しく機能するために必要なモジュールです。特に、clr モジュールを使用すると、.NET 名前空間を基本的に Python パッケージとして扱うことができます。

2. AutoCAD および Civil 3D のマネージド .NET API を使用するための標準アセンブリ(DLL)をロードします。

例

Dynamo for Civil 3D で Python スクリプトを作成する場合の基本的な概念について、例を見ていきましょう。

目標

🎯 図面内のすべての集水域の境界ジオメトリを取得します。

データセット

この演習で参照できるサンプル ファイルを次に示します。

対処法の概要

このグラフのロジックの概要を次に示します。

1. Civil 3D API のドキュメントを確認する

2. レイヤ名でドキュメント内のすべての集水域を選択する

3. Dynamo オブジェクトを「アンラップ」して、内部の Civil 3D API メンバーにアクセスする

以上です。

API ドキュメントを確認する

グラフの作成とコードの作成を開始する前に、Civil 3D API のドキュメントを参照して、API が提供する機能を理解することをお勧めします。この場合、集水域の境界点を返すに存在します。このプロパティは、Dynamo が処理する必要があるオブジェクトとは異なる Point3dCollection オブジェクトを返すことに注意してください。つまり、Point3dCollection からポリカーブを作成することはできないため、最終的にはすべてを Dynamo の点に変換する必要があります。詳細については、後で説明します。

すべての集水域を取得する

これで、グラフ ロジックの作成を開始することができます。最初に、ドキュメント内のすべての集水域のリストを取得します。これに使用できるノードがあるため、Python スクリプトに含める必要はありません。ノードを使用すると、(Python スクリプトに多くのコードを埋め込むんだ場合に比べて)、他のユーザはグラフを読みやすくなり、Python スクリプトは集水域の境界点を返すという 1 つの事柄にも対処できます。

All Objects on Layer ノードからの出力は、CivilObjects のリストであることに注意してください。これは、Dynamo for Civil 3D には現在、集水域を操作するためのノードが存在しないためです。これが、Python を使用して API にアクセスする必要がある理由です。

オブジェクトをアンラップする

先に進む前に、重要な概念について簡単に説明する必要があります。「」セクションで、オブジェクトと CivilObjects の関係について説明しました。これをもう少し詳しく説明すると、Dynamo オブジェクト は AutoCAD 図形 のラッパーです。同様に、Dynamo CivilObject は、Civil 3D 図形のラッパーです。InternalDBObject プロパティまたは InternalObjectId プロパティにアクセスすることで、オブジェクトを「アンラップ」することができます。

Python スクリプト

内部の集水域オブジェクトにアクセスして境界点を取得する作業を行う完全な Python スクリプトを以下に示します。ハイライト表示された行は、既定のテンプレート コードから修正または追加された行を表します。

ポリカーブを作成する

この段階では、Python スクリプトは、背景プレビューで確認できるように Dynamo の点のリストを出力する必要があります。最後の手順は、点から単純にポリカーブを作成します。これは Python スクリプトで直接行うこともできますが、より見やすくするために、ノードのスクリプトの外側に意図的に配置しています。最終的なグラフは次のようなものになります。

結果

最終的な Dynamo ジオメトリは次のとおりです。

🎉 ミッションが達成されました。

IronPython と CPython

最後に、注意事項を簡単に説明します。使用している Civil 3D のバージョンに応じて、Python ノードの設定が異なる場合があります。Civil 3D 2020 および 2021 では、Dynamo は IronPython というツールを使用して .NET オブジェクトと Python スクリプトの間でデータを移動しました。Civil 3D 2022 では、Dynamo は Python 3 を使用するのではなく、標準のネイティブ Python インタプリタ(CPython とも呼ばれる)を使用するように移行しました。この移行には、人気のある最新ライブラリや新しいプラットフォーム機能、基本的なメンテナンス、セキュリティ パッチへのアクセスなどのメリットがあります。