CATIA

pyCATIAは「遅い」で終わらせていい話ではない——CATIA自働化の手段を10種類そろえる理由

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

#CATIA#CATIAマクロ#CAD自働化#開発の作法

「PythonでCATIAを自動化できますか」という相談が、この1年で明らかに増えました。多くはAIを扱う会社からで、pyCATIAという名前が一緒に出てきます。できます。ただ、できることと、それが最適かどうかは別の話です。この記事では実際に動くコードを示したうえで、なぜ私たちが手段を10種類そろえているのかを書きます。結論を先に言えば、選ぶべきは言語ではなく、やりたいことの形です。

サーバールームPhoto: Unsplash
CONTENTS
1. なぜpyCATIAに人が集まるのか 2. まず動かす——PythonからCATIAを叩く最小のコード 3. なぜ遅いのか——プロセスの外から話しかけているから 4. 速さは、自分の環境で測ったほうがいい 5. 「何ができるか」ではなく「何がしたいか」 6. 私たちが手段を10種類そろえている理由 7. pyCATIAを使う場面は、ちゃんとある 8. 一つの武器で挑むか、適材適所で挑むか

なぜpyCATIAに人が集まるのか

pyCATIAは、CATIA V5をPythonから操作するためのオープンソースのライブラリです。pip install pycatia で入り、Python 3.9以降で動きます。CATIAのセッションを先に起動しておく必要があります。

人気の理由ははっきりしています。AIを扱う人にとって、Pythonが唯一の母語だからです。生成AIの周辺はPythonで出来ており、そこからCADへ手を伸ばそうとしたとき、Pythonのまま書ける入口があるのは強い。CATIAのオブジェクト構造を知らなくても、とりあえず動くところまで行けます。

私たちはこれを悪いことだとは思っていません。入口が広いのは良いことです。問題はその先で、入口の形がそのまま出口の形になってしまう場合があります。Pythonで始めたから全部Pythonで書く、という決め方です。

CADを長くやってきた側から見ると、これは道具箱を1つしか開けずに作業を始めるのに似ています。開けていない引き出しに、その仕事に合った工具が入っているかもしれません。

PYTHON参考実装例①:ライブラリを使わずPythonからCATIAにつなぐ(pywin32のみ)
# CATIA V5 は COM で外部に窓口を開けている。pywin32 だけで操作できる。
#   前提: CATIA を先に起動しておくこと(起動していないと接続で落ちる)
#   pip install pywin32
import sys

import pythoncom
import win32com.client


def connect_catia():
    """起動中の CATIA につなぐ。いなければ理由を出して終わる。"""
    try:
        # GetActiveObject は「すでに起動しているもの」を掴む。
        # Dispatch にすると勝手に起動してしまい、無人実行で事故になる。
        return win32com.client.GetActiveObject("CATIA.Application")
    except pythoncom.com_error:
        print("CATIA が起動していません。先に CATIA を開いてください。")
        return None


def main():
    catia = connect_catia()
    if catia is None:
        sys.exit(1)

    # 前提の検査。ここを飛ばすと、想定外のドキュメントで静かに変な結果が出る。
    if catia.Documents.Count < 1:
        print("ファイルが開かれていません。")
        sys.exit(1)

    doc = catia.ActiveDocument
    # TypeName 相当。CATPart 以外なら止める。
    if not doc.Name.lower().endswith(".catpart"):
        print(f"CATPart を開いてください(いま開いているのは {doc.Name})。")
        sys.exit(1)

    params = doc.Part.Parameters
    print(f"{doc.Name} のパラメータ {params.Count} 件")

    for i in range(1, params.Count + 1):
        p = params.Item(i)
        # 数値として読めないパラメータもある。落とさずに飛ばす。
        try:
            value = p.Value
        except pythoncom.com_error:
            value = "(数値ではない)"
        print(f"  {p.Name}\t{value}")


if __name__ == "__main__":
    main()


# 注: この並びは CATIA の VBA とまったく同じ。
#     CATIA.ActiveDocument.Part.Parameters.Item(i).Value
#     言語が変わっただけで、触っているオブジェクトは同一のもの。

まず動かす——PythonからCATIAを叩く最小のコード

話を具体的にするために、実際に動くものを示します。ライブラリを使わなくても、PythonからCATIAは操作できます。必要なのは pywin32 だけで、CATIAはCOMという仕組みで外部に窓口を開けているからです。

下のコード①は、起動中のCATIAにつないで、開いているパートのパラメータを一覧に出すだけのものです。CATIAのマクロを書いたことがある方なら、CATIA.ActiveDocument.Part.Parameters という並びに見覚えがあるはずです。名前はVBAとまったく同じで、書く言語が変わっただけです。

コード②は、同じことをpyCATIAで書いたものです。from pycatia import catia の1行で接続でき、オブジェクトがPythonのクラスとして包まれているので、補完が効いて読みやすくなります。素のCOMだと型が分からず手探りになる部分が、かなり楽になります。

つまりpyCATIAの価値は、新しいことができるようになる点ではなく、すでにCOMで出来ることをPythonらしく書ける点にあります。ここを取り違えると、後で困ります。

命令がどこから出て、どこで実行されるかCATIA内のVBA同じ場所で完結CATScript同じ場所で完結外部の.NET/C#境界をまたぐPython / pyCATIA境界+一部VBA変換
図1: 外から叩く手段は、1行ごとにプログラムの境界をまたぎます。
PYTHON参考実装例②:同じことを pyCATIA で書く
# pyCATIA は上の COM 操作を Python のクラスとして包んだライブラリ。
#   pip install pycatia    (Python 3.9 以降 / CATIA V5 を先に起動しておくこと)
#   オブジェクトに型が付くので補完が効き、素の COM より読み書きしやすい。
import sys

from pycatia import catia
from pycatia.mec_mod_interfaces.part_document import PartDocument


def main():
    # 起動中の CATIA セッションに接続する
    application = catia()

    if application.documents.count < 1:
        print("ファイルが開かれていません。")
        sys.exit(1)

    document = application.active_document

    # CATPart 以外なら止める(前提の検査は言語が変わっても同じ形)
    if not document.name.lower().endswith(".catpart"):
        print(f"CATPart を開いてください(いま開いているのは {document.name})。")
        sys.exit(1)

    part_document = PartDocument(document.com_object)
    parameters = part_document.part.parameters

    print(f"{document.name} のパラメータ {parameters.count} 件")

    for i in range(1, parameters.count + 1):
        parameter = parameters.item(i)
        try:
            value = parameter.value
        except Exception:
            value = "(数値ではない)"
        print(f"  {parameter.name}\t{value}")


if __name__ == "__main__":
    main()


# 書きやすさは上がるが、やっていることは①と同じ COM 呼び出し。
# pyCATIA は、素の COM では扱えないメソッドを
# CATIA 側で VBA の式を評価させる仕組みで補っている部分がある。
# 「Python で書いたつもりの処理が、内側で VBA になっている」場面があるということ。

なぜ遅いのか——プロセスの外から話しかけているから

速度の話をします。CATIAに内蔵されたVBAやCATScriptは、CATIAというソフトの中で動きます。命令を出す側と受ける側が同じ場所にいるので、やり取りに費用がかかりません。

一方、Pythonや.NET、C#で外から書いたものは、CATIAとは別のプログラムとして動きます。1行ごとに、プログラムの境界をまたいで話しかけることになります。1回あたりは短い時間でも、これが数千回、数万回積み上がると、体感できる差になります。

pyCATIAはこの上にもう一段乗っています。素のCOMでは扱えないメソッドがあるため、一部の機能はCATIAの中でVBAの式を評価させる仕組みを使って実現しています。つまり、Pythonで書いたつもりの処理が、内側でVBAに変換されて動いている場面があります。ラッパーと呼ぶのはそういう意味です。

だから私たちは、CATIAを自働化する手段の中でpyCATIAを速度の面で最も不利な側に置いています。ただし、これは机上の理屈です。あなたの環境で本当にそうなのかは、測れば分かります。

PYTHON参考実装例③:往復の速さを、自分の環境で測る
# 他所の速度比較を信じず、自分の CATIA・自分の PC で測るためのスクリプト。
#   同じ読み取りを N 回繰り返し、1 回あたりの往復時間を出す。
#   同じループを CATIA 内の VBA でも書いて、並べて比べること。
import sys
import time

import pythoncom
import win32com.client

COUNTS = (100, 500, 2000)          # 回数を変えて、比例して伸びるかを見る


def main():
    try:
        catia = win32com.client.GetActiveObject("CATIA.Application")
    except pythoncom.com_error:
        print("CATIA が起動していません。")
        sys.exit(1)

    if catia.Documents.Count < 1:
        print("ファイルが開かれていません。")
        sys.exit(1)

    params = catia.ActiveDocument.Part.Parameters
    if params.Count < 1:
        print("パラメータが 1 つも無いモデルでは測れません。")
        sys.exit(1)

    print("回数\t合計(秒)\t1回あたり(ミリ秒)")

    for n in COUNTS:
        # 毎回 Item から取り直す。これが「境界をまたぐ回数」になる。
        start = time.perf_counter()
        for _ in range(n):
            _ = params.Item(1).Name
        elapsed = time.perf_counter() - start

        print(f"{n}\t{elapsed:.3f}\t\t{elapsed / n * 1000:.3f}")

    # 参考: 一度だけ取り出して使い回すと、往復が消えて速くなる。
    #   外から叩くときは「まとめて取る・回数を減らす」が最大の改善になる。
    first = params.Item(1)
    start = time.perf_counter()
    for _ in range(COUNTS[-1]):
        _ = first.Name
    elapsed = time.perf_counter() - start
    print(f"(使い回した場合){COUNTS[-1]}\t{elapsed:.3f}\t\t{elapsed / COUNTS[-1] * 1000:.3f}")


if __name__ == "__main__":
    main()

速さは、自分の環境で測ったほうがいい

私たちは記事に数字を書くとき、自社で測った値しか書かない方針でいます。速度はCATIAの版、PCの構成、モデルの大きさで大きく変わるので、他所の数字を持ってきても判断材料になりません。

代わりに測り方を置いておきます。コード③は、同じ処理の往復回数を変えながら時間を出す短いスクリプトです。1回あたりの往復にどれくらいかかっているかが分かります。

比べたいのは、同じ処理をCATIAの中のVBAで書いた場合です。同じループをCATIA側のマクロとして書き、実行時間を出して並べてください。何倍という数字より、自分の業務のループ回数だと何分の差になるのかを見るほうが実務の役に立ちます。

測った結果、差が数秒しかないなら、書きやすいほうを選べばいい。1回30分の処理が5分になるなら、話は変わります。判断の材料を作ってから決める、という順番です。

選ぶべきは言語ではなく、
やりたいことの形です。

手段を選ぶときの2つの軸速度が要る配布は難しくてよいCAA・内蔵VBA速度が要る多人数に配るCATScript・VBAで作り込む速度は要らない一人で使うPython・pyCATIAが向く速度は要らない全社で使うテンプレート・パワーコピー・EKL速度が必要か配布・運用のしやすさ
図2: 速度が要るか、配りやすさが要るか。ここが決まると手段は絞れます。

「何ができるか」ではなく「何がしたいか」

ここからが本題です。言語の比較をしていると、いつのまにかできることの多さで優劣を決めようとしてしまいます。しかしCATIAの自働化に関して言えば、カバー範囲の広さでは内蔵のVBAでほとんど足ります。外から叩けるものは、内から叩けるからです。

実際の案件で効いてくるのは、そこではありません。誰がどこで実行するのか。何人に配るのか。更新は誰がやるのか。Excelや社内システムと行き来するのか。夜間に無人で回すのか。他のPCでも動くのか。これらはすべて、言語ではなく運用の話です。

配って終わりにしたい小さな道具ならCATScript。フォームを出したい、Excelと行き来したいならVBA。社内の別システムから起動したいなら外部プログラム。形状のルールを設計に埋め込みたいならEKLやテンプレート、パワーコピー。CATIAの中に自社専用のコマンドとして住まわせたいならCAA。

この対応づけは、やりたいことが決まって初めて引けます。逆から引こうとすると、使える言語に業務のほうを合わせることになります。

言語から入っていないかの点検✓誰がどこで実行するかが決まっている✓何人に配るか、更新は誰がやるかが決まっている✓自分の環境で速度を測った✗書ける人がいる、という理由で言語を決めた✗他社の速度比較の数字をそのまま使っている✗検討した手段が1種類しかない
図3: ✕が残っていると、業務のほうを言語に合わせることになります。

私たちが手段を10種類そろえている理由

クロニクスは、CATIAを自働化するための手段をひととおり持っています。CATIAマクロ、VBA、VBScript、CATScript、Python、.NET、C#、EKL、テンプレート、パワーコピー、CAA。並べると多く見えますが、増やしたくて増やしたわけではありません。案件ごとに最適な手段が違ったから、結果としてこうなりました。

1つの武器しか持たない場合、相談を受けたときの答えは「それはできます」か「それはできません」の二択になります。10種類あると、答えが「それはこの手段が向いています」に変わります。同じ相談でも、お客様に返るものが違ってきます。

たとえば、数十人に配る小さな点検ツールをCAAで作ったら、費用も納期も見合いません。逆に、毎日全社で走る重い処理をPythonの外部スクリプトで組んだら、待ち時間が業務を圧迫します。どちらも技術的には作れますが、現場は楽になりません。

手段の幅は、速く作るためではなく、間違った作り方を避けるために持っています。持っていない手段は、無意識に候補から外れます。

pyCATIAを使う場面は、ちゃんとある

誤解のないように書いておくと、私たちはpyCATIAを否定していません。向いている場面があります。

AI側の処理とCADの操作を1本のスクリプトでつなぎたいとき。既存のPython資産(データ処理、機械学習、社内API)から数回だけCATIAを触りたいとき。試作や検証で、とにかく早く動くものを見たいとき。こういう場面では、速度より書きやすさが勝ちます。

向かないのは、大量のループを回すとき、多人数に配って長く使うとき、CATIAの起動を前提にできないときです。pyCATIAはCATIAのセッションが動いていることが前提なので、無人運用の設計は別に考える必要があります。

使う・使わないではなく、どこまでをpyCATIAでやり、どこから別の手段に渡すか。私たちが設計で決めているのは、たいていこの境目です。

pyCATIAで書くか、別の手段に渡すかpyCATIAで書くか検討誰がどこで実行し何人に配るかを決めるCATIAのセッションを前提にできる?無人運用は別に設計する大量ループや多人数への長期配布がある?同じ処理をCATIA内のVBAでも書いて測る差は数秒程度?書きやすさで選ぶpyCATIAが向く重い部分は別の手段に渡すどこまでpyCATIAで、どこから別手段か決める手段を決めて作るできないできるないあるはいいいえ
図4: 無人運用の有無と処理の重さを確かめ、重いときは自分の環境で測ってから手段の境目を決める流れ。

一つの武器で挑むか、適材適所で挑むか

同じ課題でも、1種類の道具で解こうとするのと、10種類から選んで解くのとでは、お客様に返る結果がまったく変わります。前者では「その言語でできる範囲の解決」になり、後者では「その課題に合った解決」になります。

AIの周辺が盛り上がっている今、CADを知らない側からの提案が増えています。入口が広がるのは歓迎すべきことです。ただ、入口の言語がそのまま出口の設計になっていないかは、一度確かめる価値があります。

確かめ方は簡単で、「なぜこの言語なのですか」と聞くことです。やりたいことから説明が返ってくるなら、たぶん大丈夫です。書ける人がいるからです、という答えなら、少し止まったほうがいい。

いま検討している自働化があれば、言語を決める前に一度見せてください。ヒアリングと自働化設計書の提案までは無料で行っています。pyCATIAで足りるならそう言いますし、別の手段が向いているならその理由も含めてお伝えします。

Qronix 開発チーム

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

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

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

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