【極限の設計自動化】アセンブリ・ツリーの階層構造を「図面バルーン」に同期させる:論理順序の完全制御
設計自動化の現場において、多くのエンジニアが「自動バルーン配置」という甘い言葉の罠に落ちる。
SolidWorksの標準機能による自動バルーン配置は、極めて「空間的」なアルゴリズムに基づいている。つまり、図面上の座標(XY平面上の距離)に基づいて、数学的に「近い」ものから順に番号を振っていくのだ。しかし、製造現場や組立工程の人間が求めているのは、空間的な近さではない。「アセンブリの構成ツリー(FeatureManager)の論理的な並び順」である。
ツリーの順序とバルーンの番号が一致しない図面は、部品表(BOM)との整合性に疑義を生じさせ、大規模プロジェクトにおける誤組立のリスクを増大させる。
本稿では、単なる「配置の自動化」を超え、アセンブリの階層構造を完全に掌握し、その論理的順序を図面上のバルーンに強制的に同期させるための、プロフェッショナルな実装アプローチを解説する。
1. アーキテクチャの設計思想:空間から論理への転換
一般的な自動化スクリプトは、`DrawingDoc` から `View` を取得し、その中の `Annotation` をループで回すだけで終わる。しかし、それでは「どのバルーンがどのコンポーネントに紐付いているか」という、階層構造の情報を欠落させてしまう。
我々が構築すべきアルゴリズムは、以下の3層構造でなければならない。
1. Hierarchy Traversal Layer(階層走査層):
アセンブリの `Component2` を再帰的に走査し、FeatureManager上の出現順序に基づいた「コンポーネント・インデックス・マップ」を構築する。
2. Mapping Layer(紐付け層):
図面ビュー内の各バルーン(`Note` または `Annotation`)が、どのコンポーネントを指し示しているかを API を通じて特定する。
3. Re-ordering/Relabeling Layer(再配置・再番号層):
構築したマップに基づき、バルーンの属性(テキストまたは連番)を、ツリーの順序に従って再定義する。
2. 実装:再帰的コンポーネント走査とバルーン同期
以下に、シニアエンジニアが実装すべき堅牢なコードの骨格を示す。ここでは、メモリリークを防ぐための明示的なオブジェクト解放と、再帰呼び出しによるツリー探索を実装している。
'**
' Module: BalloonOrderMaster
' Description: Synchronizes Drawing Balloon sequence with Assembly Tree order.
' Author: Legendary Chief Architect
'**
Option Explicit
' Windows API: プロセス制御や高度なUI操作が必要な場合に使用するが、
' 本実装ではメモリ管理の重要性を説くため、ここでは標準的なCOM操作に集中する。
Sub Main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swAssy As SldWorks.AssemblyDoc
Dim swView As SldWorks.View
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' 1. 実行環境のバリデーション
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY And swModel.GetType <> swDocDRAWING Then
MsgBox "アセンブリ、または図面を開いてください。"
Exit Sub
End If
' 2. コンポーネント・マップの構築 (Dictionaryを使用)
' ※ Microsoft Scripting Runtime の参照設定が必要
Dim compMap As Object
Set compMap = CreateObject("Scripting.Dictionary")
If swModel.GetType = swDocASSEMBLY Then
Set swAssy = swModel
' アセンブリのルートから再帰的に走査
Dim rootComp As SldWorks.Component2
Set rootComp = swAssy.GetRootComponent3(True)
TraverseComponentTree rootComp, compMap, 1
ElseIf swModel.GetType = swDocDRAWING Then
' 図面からアセンブリを参照している場合、そのモデルを解析
Dim refModel As SldWorks.ModelDoc2
Set refModel = swModel.GetReferenceModel()
If Not refModel Is Nothing Then
If refModel.GetType = swDocASSEMBLY Then
Set swAssy = refModel
Set rootComp = swAssy.GetRootComponent3(True)
TraverseComponentTree rootComp, compMap, 1
End If
End If
End If
' 3. 図面ビューへの適用
If swModel.GetType = swDocDRAWING Then
Set swDraw = swModel
Set swView = swDraw.GetFirstView ' Sheet view
Set swView = swView.GetNextView ' First actual drawing view
Do While Not swView Is Nothing
ProcessViewBalloons swView, compMap
Set swView = swView.GetNextView
Loop
End If
' 4. メモリの明示的解放 (Object Lifecycle Management)
Set compMap = Nothing
Set swAssy = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Set swApp = Nothing
MsgBox "バルーンの論理順序同期が完了しました。"
End Sub
'------------------------------------------------------------------------------
' 関数: TraverseComponentTree (再帰的走査)
' 引数: swComp (現在のコンポーネント), dict (マップ), depth (階層深さ)
'------------------------------------------------------------------------------
Private Sub TraverseComponentTree(ByRef swComp As SldWorks.Component2, ByRef dict As Object, ByVal ByRef counter As Long)
Dim vChildren As Variant
Dim i As Long
Dim childComp As SldWorks.Component2
Dim compName As String
' コンポーネント名をキーとして登録 (同一名称の別パーツを考慮する場合はFullNameを使用)
compName = swComp.Name2
' すでに登録されている場合はスキップ(重複回避ロジック)
If Not dict.Exists(compName) Then
dict.Add compName, counter
counter = counter + 1
End If
' 子コンポーネントの取得
vChildren = swComp.GetChildren
If Not IsEmpty(vChildren) Then
For i = 0 To UBound(vChildren)
Set childComp = vChildren(i)
TraverseComponentTree childComp, dict, counter
Next i
End If
' 再帰呼び出し終了時にローカルオブジェクトを解放する習慣を
Set childComp = Nothing
End Sub
'------------------------------------------------------------------------------
' 関数: ProcessViewBalloons (ビュー内のバルーン処理)
'------------------------------------------------------------------------------
Private Sub ProcessViewBalloons(ByRef swView As SldWorks.View, ByRef dict As Object)
Dim swNote As SldWorks.Note
Dim swAnn As SldWorks.Annotation
Dim swComp As SldWorks.Component2
Dim compName As String
Dim targetIndex As Long
' ビュー内の最初のノート(バルーン)を取得
Set swNote = swView.GetFirstNote
Do While Not swNote Is Nothing
Set swAnn = swNote.GetAnnotation
' バルーンがコンポーネントに紐付いているか確認
' Noteの属性から紐付け先のコンポーネント情報を取得するロジックが必要
' ここでは簡略化のため、Noteのテキストまたは参照から取得するプロセスを想定
' ※ 実務上の重要ポイント:
' BalloonはNoteの一種だが、特定のコンポーネントへのリンクを持つ。
' swNote.GetSelectedEntity を利用して、参照先のComponent2を特定する。
' [ロジック抜粋]
' 1. Noteからコンポーネントを取得
' 2. compMap からそのコンポーネントの「ツリー順序」を引き出す
' 3. その順序に従って、Noteのテキストを書き換える、あるいは位置を調整する
' ※ 実際の高度な実装では、ここでバルーンの座標(swAnn.GetPosition)を
' ツリー順序に基づいて再計算し、重なりを防ぐロジックを組み込む。
Set swNote = swNote.GetNext
Loop
Set swAnn = Nothing
Set swNote = Nothing
Set swView = Nothing
End Sub
3. 伝説的アーキテクトの知見:パフォーマンスと保守性
このコードを単なる「動くスクリプト」から「プロフェッショナルなシステム」へと昇華させるためには、以下の3点に留意せよ。
① オブジェクトのライフサイクル管理
VBAにおける最大の敵は、COMオブジェクトの「残存」である。特に再帰関数(`TraverseComponentTree`)内で `Set childComp = Nothing` を怠ると、大規模アセンブリの走査時にメモリ消費が指数関数的に増大し、SolidWorksのプロセスが不安定になる。「使い終わったオブジェクトは、スコープを抜ける前に必ず屠る」。これが鉄則である。
② Dictionaryの選択
`Scripting.Dictionary` は強力だが、大規模データではハッシュ衝突の可能性を考慮すべきだ。しかし、アセンブリのコンポーネント数(数千件程度まで)であれば、この実装が最もバランスが良い。もし数万件を超える超大規模アセンブリを扱うなら、VB.NETへの移行を検討し、`ConcurrentDictionary` を使用したマルチスレッド走査を検討せよ。
③ エラーハンドリングの深度
実務環境では、コンポーネントが「抑制(Suppressed)」されていたり、参照が壊れているケースが多々ある。`If Not swComp Is Nothing` だけでなく、`swComp.GetSuppression` をチェックし、抑制されたコンポーネントを走査対象から除外するロジックを組み込むことで、実行時エラーを未然に防ぐことが可能だ。
結びに代えて
図面自動化の本質は、単に「作業を減らすこと」ではない。「設計者が意図した論理構造を、いかに正確に、かつ美しく出力物に反映させるか」にある。
空間的な座標に依存した「動的な配置」に甘んじるのではなく、ツリー構造という「設計の背骨」を制御下に置くこと。それこそが、シニアエンジニアに求められる設計自動化の真髄である。
