房間屬性更新

基本邏輯

房間屬性更新工具用於自動偵測並更新房間（Room）或空間（Space）周圍的結構元素高程資訊。系統會根據房間邊界向外擴展搜尋範圍，自動查找附近的樓板、天花板與牆壁元素，讀取它們的高程值後，將結果寫入到您指定的房間欄位中。

此外，工具也會一併填寫房間內建的「地板完成面」、「天花板表面」與「牆面裝飾」材質名稱，讓您的 BIM 模型擁有更完整的房間屬性資料。

此功能對於機電專業特別重要，因為需要準確掌握每個房間的地板完成面（FFL）與天花板底面（SOL）高程，以進行管線配置與淨高檢查。

使用情境

情境一：機電專業房間資料建置

在機電建模前，需要批量取得所有房間的地板與天花板高程，作為管線配置的基準參考。

情境二：建築設計變更後的資料更新

當樓板高度或天花板位置調整後，可快速同步更新房間參數中的相關高程資訊，保持資料一致性。

情境三：淨高分析與檢查

取得房間的地板結構高程與天花板高程後，可用於計算有效淨高並進行規範符合性檢查。

情境四：確認房間裝飾材質

工具會自動讀取樓板、天花板與牆壁元素的材質名稱（例如：大理石、乳膠漆、輕隔間等），填入房間的完成面材質屬性中，方便後續排程表彙整。

前置設定

開啟工具後，您會看到以下主要區域：

最左側欄位（階段清單）：列出本案所有設計階段，可勾選要處理的範圍。
樓層／空間樹狀選單：以樹狀結構呈現各樓層及其包含的所有房間與空間，方便選擇目標。
右側設定區：配置要更新的高程類型、對應欄位以及搜尋範圍擴大係數。
下方結果清單：執行後顯示每間房間已偵測到的結構元素對應關係。

第一步：選擇階段範圍

在「階段」清單中勾選需要處理的設計階段（如「新建」、「既存」等）。系統將只更新所選階段內的房間或空間元素。若不勾選任何階段，則會處理所有階段的元素。

第二步：設定樓層／房間範圍

在「樓層／空間」樹狀選單中：

勾選樓層名稱：該樓層下的所有房間都會被處理。
勾選個別房間：只處理該特定房間。
雙擊樓層或房間：可直接在 Revit 模型中選取對應的元素，方便您確認目標是否正確。

第三步：配置高程偵測選項

在右側設定區，您可以啟用以下三項高程偵測（勾選即表示要更新該欄位），每項都需搭配一個「目標參數」來指定資料寫入的位置：

天花高程

勾選此選項後，系統會在房間範圍附近尋找天花板元素，讀取其最低點高程值（天花板底面高程），並填入您指定的參數。
在「天花板對應欄位」下拉選單中，選擇要接收資料的房間欄位。系統會自動列出目前可編輯的數值型欄位供您挑選。

地板高程

勾選此選項後，系統會在房間範圍附近尋找樓板元素，讀取其最高點高程值（樓板完成面高程），並填入您指定的參數。
在「地板對應欄位」下拉選單中，選擇要接收資料的房間欄位。

地板結構高程

勾選此選項後，系統會讀取樓板的最低點高程值（結構底板面），並填入您指定的參數。這有助於區分「完成面」與「結構面」的高程差異。
在「地板結構對應欄位」下拉選單中，選擇要接收資料的房間欄位。

💡 可編輯欄位的來源

下拉選單中的欄位清單，系統會自動從本案現有的房間中讀取所有「可編輯的數值型欄位」。如果您找不到目標欄位，請確認：

該欄位確實已新增到房間類別中
欄位類型為「數值（Number）」
欄位不是唯讀狀態

第四步：設定房間範圍擴大係數

在「房間範圍擴大係數」控制項中設定搜尋半徑的倍率（預設值 1.10，可調範圍 1.00 ~ 2.00）。

💡 擴大係數說明

系統會以房間邊界為基準，向外擴展搜尋距離來尋找樓板與天花板。預設值 1.10 表示搜尋範圍是房間實際尺寸的 1.1 倍（即向外延伸約 10%），有助於捕捉緊鄰房間邊緣的結構元素。

調整建議：

標準情況：使用預設值 1.10 即可
樓板與房間邊界有間隔：可增大至 1.2 ~ 1.5
鄰近房間的樓板容易混淆：可縮小至 1.00 ~ 1.05，避免抓到錯誤元素的值

⚠️ 參數設定檢查

執行前請確認：

所有勾選的高程類型都有對應的目標欄位（不可為空）
目標欄位已加入 Room/Space 類別中
欄位類型為可儲存高程值的數值（Number）類型
欄位非唯讀狀態且可編輯

操作步驟

確認房間與結構元素存在
確保目標樓層的房間標籤已正確放置，且該區域已有樓板、天花板或牆壁等結構元素。
設定階段與樓層／房間範圍
在左側「階段」清單勾選要處理的階段，並在「樓層／空間」樹狀選單中勾選目標樓層或個別房間。
選擇要更新的高程類型與欄位
根據需求勾選「天花高程」、「地板高程」或「地板結構高程」，並分別從下拉選單中指定對應的目標參數欄位。每項啟用後需搭配一個目標欄位。
調整搜尋範圍係數（如需要）
預設 1.10 通常已足夠。若房間與結構元素間距特殊，可適當調整此值。（請參閱上方的設定說明）
執行更新命令
點擊右側「更新」按鈕開始處理。系統會自動：
- 讀取所有您勾選的房間／空間
- 根據擴大的搜尋範圍，查找附近的天花板、樓板與牆壁元素
- 過濾掉不符合所選階段的元素
- 針對天花：尋找最近的天花板，取其最低點作為天花板底面高程
- 針對地板：尋找最近的樓板，取其最高點作為完成面高程，並取其最低點作為結構面高程
- 將偵測到的高程值寫入對應的目標欄位
- 一併填寫房間的「天花板裝飾」、「地板裝飾」與「牆面裝飾」材質名稱
檢視更新結果
處理完成後，下方「更新結果」清單會顯示：
- 房間：已處理的房間名稱
- 對應元素：系統偵測到的結構元素類型與名稱（格式如「天花：XXX」或「樓版：XXX」）
若您想確認系統抓取的對象是否正確，雙擊結果清單中的任意一列，系統會直接在 Revit 模型中同時選取該房間及對應的結構元素，方便您視覺檢查。
儲存設定（建議）
若您覺得目前的設定很方便，可以透過上方「設定」功能表進行儲存：
- Open：從檔案載入之前儲存的設定
- Load：重新載入目前儲存的設定到本視窗
- Save：將目前的設定儲存至檔案（覆蓋舊檔）
- Save As：將目前的設定另存為新檔案，方便保留多個不同版本的設定
下次使用時，點擊「Load」即可快速恢復上次的選擇與配置。

✓ 使用結果驗證

在 Revit 中選取幾個房間標籤，開啟屬性視窗確認高程參數是否已正確寫入。建議隨機抽查不同位置的房間（如中心區域、邊緣區域）以確保偵測準確性。

進階應用技巧

分樓層處理大型專案

針對大型專案，建議先選擇單一個樓層的房間來執行更新，確認結果正確後，再逐步擴展至其他樓層。這樣可以降低出錯風險，也方便追蹤問題。

結合排程表使用

更新完成後，可在 Revit 中建立房間排程表（Schedule），直接匯出所有房間的高程與材質資料，方便快速比對或提供給其他專業團隊。

設定檔重複使用

若您有固定使用的欄位名稱與參數配置，善用「Save」功能將設定存入檔案。換一台電腦或新專案時，透過「Open」即可快速套用相同的設定流程。

⚠️ 注意事項

元素存在性：若某個房間周邊沒有樓板或天花板，對應的參數值可能不會被更新（保持空白），且該項目不會出現在結果清單中。
多重結構處理：當搜尋範圍內有多個不同高程的樓板時，系統會選擇最接近完成面高度的樓板；天花板則取最近的最低點。
階段控制影響：系統會根據元素的「創建階段」進行篩選。若元素屬於您未勾選的階段，將不會被處理。
牆壁材質：工具會自動偵測房間四周最近的牆壁，並填入其裝飾材質名稱到房間屬性中。即使您沒有特別設定，這項功能也會自動執行。
單一執行：工具在同一時間只能執行一次。若在前一次處理完成前嘗試再次點擊「更新」按鈕，系統會等待當前工作結束後繼續處理。

常見疑難排解

問題現象	可能原因	解決方法
部分房間參數未更新	該區域沒有樓板／天花板，或元素屬於不同階段	檢查階段設定與元素可見性；在 Revit 中確認相關結構元素已建立且在正確階段。
高程值不正確	搜尋範圍過大抓到錯誤元素，或房間邊界未與樓板重疊	調小「房間範圍擴大係數」；使用雙擊結果清單功能在模型中檢查系統抓取的元素是否正確。
所有房間都無法更新	目標欄位未正確設定、不可寫入，或未勾選任何樓層／房間	檢查參數是否已加入 Room 類別且為數值型可編輯欄位；確認您已在樓層／空間選單中勾選目標。
下拉選單中沒有可用的欄位	本案尚未建立任何房間，或現有房間都沒有可編輯的數值型參數	先確認模型中存在至少一個房間；並檢查該房間是否有設定可編輯的自訂數值欄位。
單位不一致	專案單位與期望值不同（Revit 內部使用英吋作為基本單位）	確認 Revit 專案的單位設定；工具輸入的高程值會自動轉換為欄位對應的單位。
更新過程中斷或無反應	房間數量過多或模型過於複雜	系統已加入進度回報機制，請等待處理完成。若時間過長，可嘗試減少同時勾選的房間數量分批處理。

結合其他工具的建議

💡 最佳工作流程

先用「樓層調整」工具確認各樓層高程正確無誤
使用「房間樓板與天花」工具確保每個房間都有對應的結構元素
執行本工具更新房間屬性中的高程參數與裝飾材質
最後使用「房間屬性鍵結」進行衍生計算（如淨高、使用人數等）