CATIA

CATIAマクロが遅い本当の原因——1万部品でも止まらない書き方

2025.10.28 / 読了目安 9分 / 執筆: Qronix 開発チーム

#CATIA#CATIAマクロ

CATIAマクロが遅い、と相談を受けたコードのほとんどは、計算が重いのではありません。CATIAに話しかける回数が多すぎるだけです。処理速度の問題はループの最適化ではなく設計で解けます。1万部品規模のアセンブリでも止まらない書き方を、実測値とともに書きます。

作業中のPC画面Photo: Unsplash
CONTENTS
1. 遅さの正体はCOM呼び出しの回数である 2. 最大の犯人:ドットのつなぎすぎ 3. 画面更新と再計算を止める 4. 1万部品を扱うときの構造的な工夫 5. 測らずに直さない:計測の具体的なやり方 6. 速さより「止まること」を先に設計する

遅さの正体はCOM呼び出しの回数である

最初に結論を書きます。CATIAマクロの処理速度を決めているのは、CATIAのAPIを何回叩いたかです。VBAの計算そのものは、現代のPCではほぼ無視できる速度で終わります。遅いのは、マクロからCATIAへ問い合わせる一回一回の往復です。

この往復はCOMというプロセス間の仕組みを通ります。1回あたりの時間はごく短い。しかし1万回、10万回と積み重なると、そこが処理時間の9割を占めます。私たちが計測した例では、ある集計マクロの実行時間の94%がAPI呼び出しの待ち時間でした。

だから最適化の方向は明快です。ループを速くするのではなく、呼び出す回数を減らす。この一点に集約されます。変数の型宣言や配列の使い方といった一般的なVBA高速化テクニックは、CATIAマクロにおいては効果が小さい。的を外した最適化に時間を使わないでください。

遅いマクロを渡されたら、私たちはまずAPI呼び出しの箇所を数えます。ドット記法が並んだ行を数えるだけでも、当たりはつきます。

ある集計マクロの実行時間の内訳API呼び出しの待ち時間実測で実行時間の94%VBA側の計算現代のPCではほぼ無視できる
計算が重いのではない。CATIAに話しかける往復が、実行時間のほとんどを占めている。

最大の犯人:ドットのつなぎすぎ

最も典型的な遅い書き方はこれです。ループの中で毎回Documents.Item(i).Product.Parametersのように長いドット連結を書く。この一行で、CATIAへの問い合わせが4回発生します。1万回のループなら4万回です。

対策は変数への退避です。ループの外で取れるものは外で取る。ループ内で同じオブジェクトを2回以上参照するなら、必ず変数に受ける。これだけで、実測で処理時間が3分の1から5分の1になることが珍しくありません。特別なテクニックは何も使っていません。

コレクションのCountも危険です。For i = 1 To collection.Count と書くと、実装によってはループのたびにCountが評価されます。ループの前にn = collection.Countで受けてから回す。基本ですが、CATIAマクロではこの基本の効き方が桁違いです。

私たちが引き継いだ、部品表出力に42分かかっていたマクロがあります。手を入れたのはこの二点だけです。結果は6分になりました。ロジックは一行も変えていません。

部品表出力マクロ:手を入れたのは2点だけ変更前(ループ内でドットを連結)42分1行で4回、1万ループで4万回のAPI呼び出し変更後(変数へ退避・Countを事前取得)6分特別なテクニックは何も使っていない
ドットの連結をやめて変数に退避し、Countをループの前で受けた。ロジックは変えていない。
VBA参考実装例:悪い例:ループの中で毎回CATIAに問い合わせる
Sub CollectMass_Slow()
    Dim i As Long
    Dim dTotal As Double

    ' Count がループのたびに評価される可能性がある
    For i = 1 To CATIA.ActiveDocument.Product.Products.Count
        ' この1行だけで ActiveDocument / Product / Products / Item と
        ' 4回以上のCOM往復が発生する
        dTotal = dTotal + _
            CATIA.ActiveDocument.Product.Products.Item(i) _
                .Analyze.Mass

        ' さらに同じオブジェクトへ再度問い合わせている
        Debug.Print CATIA.ActiveDocument.Product.Products.Item(i).PartNumber
    Next

    MsgBox "合計質量: " & dTotal
End Sub

1万部品なら往復は数万回に達します。遅いマクロを渡されたら、まずドット記法が並んだ行を数えてください。それだけで当たりがつきます。

VBA参考実装例:良い例:外で取れるものは外で取り、結果は配列でExcelへ渡す
Sub CollectMass_Fast()
    Dim oRoot As Product
    Dim oChildren As Products
    Dim oChild As Product
    Dim i As Long, n As Long
    Dim dTotal As Double

    ' ループの外で一度だけ取得する
    Set oRoot = CATIA.ActiveDocument.Product
    Set oChildren = oRoot.Products
    n = oChildren.Count                 ' Count も事前に受ける

    ' Excel へは配列で一括受け渡しする
    Dim vBuf() As Variant
    ReDim vBuf(1 To n, 1 To 2)

    For i = 1 To n
        Set oChild = oChildren.Item(i)  ' 同じオブジェクトは変数に受ける
        vBuf(i, 1) = oChild.PartNumber
        vBuf(i, 2) = oChild.Analyze.Mass
        dTotal = dTotal + vBuf(i, 2)
    Next

    ' 1万行でもRangeへの代入は1回で済む
    xlSheet.Range(xlSheet.Cells(1, 1), xlSheet.Cells(n, 2)).Value = vBuf

    Debug.Print "件数=" & n & " 合計質量=" & dTotal
End Sub

やっているのは変数への退避と配列での一括代入だけです。それでも実測で処理時間が3分の1から5分の1になることは珍しくありません。

画面更新と再計算を止める

次に効くのが、CATIAの画面更新の抑制です。マクロがオブジェクトを操作するたび、CATIAは画面を描き直そうとします。1万部品のアセンブリで、この描画が毎回走ると致命的です。処理の前後で表示の更新を止め、最後に一度だけ戻す。これで数倍変わります。

同様に効くのが自動更新の停止です。パラメータを一つ書き換えるたびに、関連する形状の再計算が走る設定になっていると、100個のパラメータ変更で100回の再計算が発生します。まとめて書き換えて、最後に一度だけ更新をかける。これが正解です。

ただし注意があります。更新を止めている間はモデルが一時的に不整合な状態になります。ここで例外が発生してマクロが途中終了すると、更新停止のままCATIAが残ることがある。必ずエラー処理で元に戻す構造にしてください。止め忘れは、後から原因が分からない不具合として現れます。

私たちは、更新の停止と復帰を必ず対にした関数に閉じ込めています。呼び出し側が書き忘れられない形にする。速度改善のための仕組みが、新しい事故の原因になっては本末転倒です。

遅いのは計算ではない。
CATIAに話しかけすぎているだけだ。

1万部品を扱うときの構造的な工夫

小手先の最適化には限界があります。数万オブジェクトを相手にするなら、構造を変える必要があります。私たちが使う手は三つです。一度だけ全走査してメモリに載せる、Excelとのやり取りを配列で一括にする、途中経過を保存して再開できるようにする。

一つ目。ツリーを何度も走査するのが最悪です。必要な情報を一度の走査で全部集め、VBAのCollectionやDictionaryに入れる。以降の検索や集計はメモリ上でやる。CATIAには二度と聞かない。これで走査回数がNからNから1に落ちます。

二つ目。Excelへの書き出しをセル単位でやると、1万行で1万回のやり取りが発生します。2次元配列に貯めて、Range全体に一度で代入する。1万行の書き出しが数十秒から1秒未満になります。CATIAとExcelを連携させる処理では、ここが最大のボトルネックになりがちです。

三つ目。1万部品の処理は、どれだけ速くしても数分はかかります。途中で落ちたときにゼロからやり直しでは現場が使いません。100件ごとに進捗を外部ファイルに書き、再開できるようにする。速度以上に、止まっても戻れることが実運用では効きます。

1万部品を扱うときの構造的な工夫1一度だけ全走査する必要な情報をDictionaryに載せ、以降はCATIAに聞かない2Excelは配列で一括2次元配列に貯めてRangeへ一度で代入。数十秒が1秒未満に3途中経過を保存する100件ごとに進捗を書き出し、落ちても再開できるようにする
小手先の最適化には限界がある。数万オブジェクトなら構造を変える。

測らずに直さない:計測の具体的なやり方

高速化で最もよくある失敗は、遅いと思い込んだ場所を直すことです。私たちの経験では、開発者の予想は半分以上外れます。必ず計測してから手を入れてください。

方法は単純です。処理のブロックごとにTimer関数で経過時間を取り、イミディエイトウィンドウに出力する。10行程度の仕掛けで十分です。これを入れて一度実行すれば、どこに時間が消えているかが一目で分かります。予想と違う場所が光っていることに驚くはずです。

計測して分かることの典型が、意外な場所での再計算です。あるツールでは、実行時間の7割が一行のプロパティ取得に集中していました。その行が内部で形状の再計算を誘発していたのです。ドキュメントには書かれていません。計測でしか見つかりません。

そして直した後も必ず測ります。速くなったつもりで遅くなっていることがある。数字で確認する習慣がないチームは、最適化のたびに賭けをしていることになります。

遅いマクロを渡されたときの直し方遅いマクロを渡されるAPI呼び出しの箇所を数えるTimerでブロックごとの経過時間を測るループ内の参照を変数に受ける画面更新と再計算を対の関数で止める数万オブジェクトを扱う?全走査は一度だけExcelは配列で一括直した後にもう一度測る速くなった?妥当性の検査は削らずに残す現実的な時間で回す扱う扱わないいいえはい
図4: 呼び出し回数を数えて測り、回数と更新を減らし、測り直して速くなるまで繰り返す手順。

速さより「止まること」を先に設計する

ここまで処理速度の話を書いてきましたが、私たちが優先順位の一番上に置いているのは速度ではありません。異常時に確実に止まることです。速いが間違った結果を出すマクロより、遅いが間違わないマクロの方がはるかに価値があります。

私たちが「自働化」という言葉を使うのは、この順序を明確にするためです。自動で走り続けることではなく、異常を検知して止まることを設計する。トヨタ生産方式のニンベンのついた自働化と同じ考え方です。1万部品を5分で処理できても、そのうち3件が静かに間違っていたら、確認に3日かかります。

実装としては、処理の各段階で結果の妥当性を検査します。件数が想定範囲か、欠損がないか、値が物理的にあり得る範囲か。この検査を挟むと処理時間は数%増えますが、その代わり出力を信頼できます。速度のための最適化は、この検査を削らない範囲でやります。

私たちは創業2年で98本のツールを現場に入れました。速度で褒められることより、「止まってくれたおかげで助かった」と言われることの方が多い。CATIAマクロの高速化は目的ではなく、信頼できるツールを現実的な時間で回すための手段です。

同じような自働化を検討中でしたら、一度話を聞かせてください。ヒアリングと自働化設計書の提案までは無料で行っています。使えるものが無ければ、無いとお伝えします。

Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →