Dynamo可視化程式結構剖析【BIM】

Dynamo 使我們能夠采用一種可視化的方法建立程式。在這篇文章中，我們将介紹了Dynamo可視化程式的元素、Dynamo 庫中可用的節點的組織、節點的部件和狀态以及工作空間的最佳實踐。

1、節點

在 Dynamo 中，節點是你用來連接配接以形成可視化程式的對象。每個節點執行特定的操作 - 有時可能像存儲數字一樣簡單，有時又可能是一個更複雜的操作，如建立或查詢幾何形狀。

1.1 Dynamo節點

Dynamo 中的大多數節點由五個部分組成。雖然有例外，如輸入節點，但每個節點的結構可描述為：

• 名稱 - 遵循Category.Name 命名慣例的節點名稱
• 主體 - 節點的主體 - 在此處單擊右鍵可以顯示整個節點級别的選項
• 端口（輸入/輸出） - 向節點提供輸入資料，或者輸出節點操作的結果，作為連接配接線的錨點
• 綁帶圖示 - 表示為比對清單輸入指定的綁帶選項（稍後将進一步說明）
• 預設值 - 在輸入端口單擊右鍵 - 某些節點具有可使用或不使用的預設值。

1.2 節點端口

節點的輸入和輸出稱為端口，并充當連接配接線的錨點。資料通過左側的端口進入節點，并在其右側執行操作後流出節點。端口隻能接收特定類型的資料。例如，通過Coordinate節點将2.75等數字連接配接到Point節點上的端口将成功地建立Point：但是，如果我們向同一端口提供"Red"字元串，則會導緻錯誤。

提示：懸停在端口上，檢視包含預期資料類型的提示。

1. 端口辨別
2. 提示資訊
3. 資料類型
4. 預設值

1.3 節點狀态

Dynamo 根據每個節點的狀态，用不同的配色方案渲染節點，進而表現可視化程式的執行狀态。此外，在名稱或端口上懸停或右鍵單擊還會提供其他資訊和選項。

1. 活動 - 具有深灰色背景标題的節點連接配接良好，并且其所有輸入都成功連接配接
2. 非活動 - 灰色節點處于非活動狀态，需要與線連接配接才能成為活動工作空間中程式流的一部分
3. 錯誤狀态 - 紅色表示節點處于錯誤狀态
4. 當機 - 透明節點已當機，暫停執行節點
5. 已標明 - 目前標明的節點其邊框高亮
6. 警告 - 黃色節點處于警告狀态，這意味着它們可能具有不正确的資料類型
7. 背景預覽 - 深灰色表示幾何預覽已關閉

如果你的可視化程式包含警告或錯誤，Dynamo 将提供有關該問題的更多資訊。任何黃色節點在名稱上方也會有一個提示資訊。将滑鼠懸停在提示資訊上可以将其展開。

提示：使用此提示資訊，檢查上遊節點，檢視所需的資料類型或資料結構是否出錯。

1. 警告資訊 - “空” 輸入或沒有資料可以解讀為雙精度浮點數。
2. 使用Watch節點檢查輸入資料
3. 上遊的Number節點存儲"Red"而不是數字

2、Dynamo連接配接線

節點之間的連接配接線，用來建立關系并建立我們的可視化程式流。我們可以把它們想象成電線，将資料脈沖從一個對象傳到另一個對象。

2.1 程式流

連接配接線将一個節點的輸出端口連接配接到另一個節點的輸入端口。此方向性在可視化程式中建立了資料流。雖然我們可以在工作空間中自由地放置節點，但由于輸出端口位于節點的右側，輸入端口位于左側，我們通常可以說程式流從左到右移動。

2.2 建立連接配接線

在一個節點的端口上單擊左鍵，然後在另一節點的端口上再次單擊左鍵，就建立了連接配接線。當我們在進行連接配接時，連接配接線顯示為虛線，并在成功連接配接時變成實線。資料将始終通過此線從輸出流到輸入：但是，我們可以通過改變點選端口的順序來向任一方向建立導線。

提示：在第二次單擊完成連接配接之前，請允許連接配接線捕捉端口，并将滑鼠懸停在那裡檢視端口的提示資訊。

1. 單擊Number Sequence節點的輸出端口seq
2. 當你将滑鼠移動到另一個端口時，連接配接線顯示為虛線
3. 單擊Point.ByCoordinates的輸入端口y完成連接配接

2.3 編輯連接配接線

我們經常希望通過編輯 連接配接來調整可視化程式流。要編輯連接配接線，請左鍵單擊已連接配接的節點輸入端口。您現在有兩個選項：

1. 現有連接配接線
2. 要更改連接配接的輸入端口，請左鍵單擊另一個輸入端口
3. 要删除連接配接線，請将連接配接線拉開，然後左鍵單擊工作區

*注意-Dynomo新版本可以一次移動多個連接配接線，詳情查閱這裡。

2.4 連接配接線預覽

預設情況下，預覽時連接配接線将顯示為灰色。選中一個節點時，該節點的任何連接配接線也同樣高亮顯示。

1. 預設連接配接線
2. 高亮顯示的連接配接線

Dynamo 還允許我們通過"視圖>連接配接器菜單"自定義我們的連接配接線在工作空間中的外觀。在這裡，我們可以在Curve或PolyLine之間切換。

1. 連接配接器類型：曲線
2. 連接配接器類型：多段線

3、Dynamo庫

Dynamo 庫包含我們添加到工作空間的節點，以定義要執行的可視化程式。在庫中，我們可以搜尋或浏覽節點。節點包括 - 已安裝的基本節點、我們定義的自定義節點以及我們添加到 Dynamo 的包管理器中的節點 - 按類别進行進階别組織。讓我們回顧一下庫的組織，并探索我們将經常使用的主要節點。

3.1 庫集合

我們在應用程式中與之互動的 Dynamo庫實際上是功能庫的集合，每個庫都包含按類别分組的節點。雖然這一開始看起來有些笨拙，但它是組織 Dynamo 預設安裝附帶的節點的靈活架構 - 當我們開始使用自定義節點和附加包擴充此基礎功能時，情況會更好。

3.2 組織方案

Dynamo UI 的庫部分由分層組織起來的庫組成。當我們深入到庫中時，會依次浏覽庫、庫的類别以及該類别的子類别以查找節點。

1. 庫界面 - Dynamo界面區域
2. 一個庫 - 相關類别的集合，如幾何
3. 一個類别 - 相關節點的集合，如與圓相關的一切
4. 一個子類别 - 類别内節點的細分，通常細分為建立、操作或查詢
5. 一個節點 - 添加到工作空間以執行操作的對象

3.3 命名約定

每個庫的層次結構反映在添加到工作空間的節點名稱中，我們也可以在搜尋字段或代碼塊（使用Dynamo 文本語言）中使用該節點。除了使用關鍵詞嘗試查找節點之外，我們還可以鍵入以句号分割的層次結構。

在庫層級中的不同位置按格式library.category.nodeNamege 輸入将得到不同的結果：

• library.category.nodeName
• category.nodeName
• nodeName或keyword

通常，工作區中的節點名稱将以category.nodeName格式呈現，但有一些顯著的例外，特别是在Input和View類别中。注意具有類似命名的節點，并了解類别之間的差異：

1. 大多數庫的節點将包括類别格式
2. Point.ByCoordinates 和 UV.ByCoordinates 有相同的名稱，但來自不同的類别
3. 顯著的例外包括内置功能、Core.Input、Core.View和操作符

3.4 常用節點

Dynamo 的基本安裝中包含了數百個節點，哪些節點對于開發我們的可視化程式至關重要？讓我們專注于那些讓我們定義程式的參數（輸入），檢視節點的操作（觀看）的結果，并通過快捷方式（代碼塊）定義輸入或功能。

輸入節點：Input

輸入節點是我們可視化程式的使用者（無論你自己還是其他人）與關鍵參數互動的主要手段。以下是核心庫輸入類别中的節點：

1. 布爾
2. 數值
3. 字元串
4. 數字滑塊
5. 整數滑塊
6. 目錄路徑
7. 檔案路徑

監視節點：Watch

監視節點對于管理流經可視化程式的資料至關重要。雖然你可以通過節點資料預覽檢視節點的結果，但是你可能希望将其保留在監視節點中，或通過Watch3D節點檢視幾何結果。這兩個節點都位于核心庫中的視圖類别中。

提示：當你的視覺程式包含大量節點時， 3D 預覽可能會分散注意力。考慮取消選中"設定"菜單中的顯示背景預覽選項，并使用 Watch3D 節點預覽你的幾何形狀。

1. Watch節點 - 請注意，當你在"Watch節點"中選擇項目時，它将在 Watch3D 和 3D 預覽中标記
2. Watch3D - 按住右下角來調整預覽視窗大小，滑鼠操作方式同 3D 預覽

代碼塊：Code Block

代碼塊節點可用于定義由半結腸分離的行的代碼塊。這可以很簡單。我們還可以使用代碼塊作為定義數字輸入或調用其他節點功能的捷徑。這樣做的文法遵循Dynamo文本語言的命名公約，設計腳本，并涵蓋在第7.2節。讓我們嘗試用這條快捷方式做一個圓圈：X/Y

1. 輕按兩下滑鼠以建立代碼塊節點
2. 輸入Circle.ByCenterPointRadius(x,y);
3. 單擊工作空間以清除選擇，應自動添加和輸入xy
4. 建立Point.ByCoordinates節點和數字滑塊節點，然後将它們連接配接到代碼塊的輸入
5. 執行可視化程式的結果應該是 3D 預覽中的一個圓

4、管理Dynamo程式

可視化程式設計過程可能是一項強大的創意活動，但很快，程式流和關鍵使用者輸入就會被工作空間的複雜性和/或布局所掩蓋。讓我們回顧一些管理Dynamo程式的最佳實踐。

4.1 對奇

一旦我們在工作空間中添加了多個節點，可能就需要重新組織節點的布局，以便于清晰起見。通過選擇多個節點并在工作區上右鍵單擊，彈出視窗包括一個"對齊選擇"菜單，其中包含 X 和 Y 中的對齊和分布選項。

1. 選擇多個節點
2. 右鍵單擊工作區
3. 使用對齊選擇選項

4.2 注釋

有了一些Dynamo經驗之後，我們也許可以通過檢視節點名稱并跟蹤程式流來"閱讀"可視化程式。對于所有級别的使用者來說，包括純語言标簽和描述也是一種好的做法。Dynamo 有一個具有可編輯文本字段的Note節點。我們可以通過兩種方式将Note添加到工作空間：

1. 浏覽菜單編輯>建立Note
2. 使用鍵盤快捷方式

将 Note 添加到工作區後，将彈出一個文本字段，以便我們編輯注釋文本。建立後，我們可以通過輕按兩下或右鍵單擊Note節點來編輯其中的注釋。

4.3 分組

當我們的可視化程式變大以後，識别将要執行的較大步驟是有幫助的。我們可以突出顯示帶有組的較大節點集合，以便在背景中用彩色矩形和标題标記它們。有三種方法可以使一個組選擇多個節點：

1. 浏覽菜單編輯>建立組
2. 使用鍵盤快捷方式
3. 右鍵單擊工作區并選擇"建立組"

建立組後，我們可以編輯其設定，如标題和顔色。

提示：同時使用Note和Group是注釋檔案和提高可讀性的有效方法。

以下是我們從第 2.4 節開始的程式，并添加了說明群組：

1. Grouping Example
2. Note：“網格參數”
3. Note：“網格點”
4. Group: “Create a Grid of Points”
5. Group: “Create an Attractor Point”
6. Note: “Calibrate Distance Values”
7. Note: “Variable Grid of Circles”

原文連結：Dynamo可視化程式解剖 — BimAnt