A collection of PyCATIA scripts for automating CATIA V5, designed to be used with CatiaMenuWin32 — a native Windows launcher that syncs and runs these scripts directly from this repository.
Python: 3.9+
Packages:
pip install pycatia wxPython xlsxwriter
Or use the ↓ Deps button in CatiaMenuWin32 to install automatically.
CATIA V5 must be running before executing scripts that interact with it.
| Script | Description |
|---|---|
Batch_CATDrawing_To_PDF.py |
Export all CATDrawing files in a selected folder to PDF |
Find_And_Select_By_Name.py |
Find and select all hybrid shapes whose names contain a search string |
Hide_Planes_And_Axis_Systems.py |
Hides all planes and axis systems in a Part or Product document |
Rename_Hybrid_Shapes.py |
Rename hybrid shapes interactively via message box |
Replace_Name_Hybrid_Shapes.py |
Search and replace any hybrid shape name |
Toggle_Show_Hide_Geometric_Set.py |
Toggle the visibility of a selected geometric set and all its children |
| Script | Description |
|---|---|
Axis_To_Axis_Keep_History.py |
Axis-to-axis transformation keeping the original hybrid shape name and parametric history |
Axis_To_Axis_Keep_History_And_Structure.py |
Axis-to-axis transformation on all shapes in a geometric set, preserving names, structure and parametric history |
Axis_To_Axis_Keep_Name.py |
Axis-to-axis transformation keeping the original hybrid shape name |
Axis_To_Axis_Keep_Name_And_Structure.py |
Axis-to-axis transformation on all shapes in a geometric set, preserving names and structure |
Batch_Isolate_Geometric_Set.py |
Isolate every element in a geometric set as a datum in one operation |
Check_Duplicate_Names_In_Geometric_Set.py |
Scan a geometric set and report any elements that share a name |
Copy_Geometric_Set_To_New_Part.py |
Copy a selected geometric set and all its contents into a new blank CATPart |
Create_Construction_Planes.py |
Create a series of offset planes from a reference plane at a user-defined step and count |
Create_ISM_OSM_STEP_Files.py |
Select two faces/surfaces, extract in tangency and export as ISM and OSM STEP files |
Delete_Deactivated_Features.py |
Delete all deactivated hybrid shapes inside a selected geometric set |
Export_All_Parameters_To_CSV.py |
Export all parameters from the active part to CSV |
Export_Curve_Lengths_Surface_Areas_To_CSV.py |
Export curve lengths and surface areas from a geometric set to CSV |
Export_Geometric_Set_Structure_To_CSV.py |
Export the full geometric set tree and its contents to CSV |
Export_Mass_CoG_Inertia_To_CSV.py |
Export mass, centre of gravity and inertia tensor from all solid bodies to CSV |
Export_Points_Select_Axis_and_Geo_Set_To_CSV.py |
Export points from a geometric set relative to a selected axis system to CSV |
Export_Points_Select_Axis_and_Geo_Set_To_XYZ.py |
Export points from a geometric set relative to a selected axis system to XYZ (PCDimms format) |
Export_Points_Select_Geo_Set_To_CSV.py |
Export points from a geometric set relative to absolute axis to CSV |
Export_Points_Select_Geo_Set_To_XYZ.py |
Export points from a geometric set relative to absolute axis to XYZ (PCDimms format) |
Extract_Boundary_Curves.py |
Extract boundary edges of a selected surface as datum curves |
IGES_Export_Curve_AXIS.py |
Export curve to IGES after moving from a reference axis system to absolute |
Insert_Points_Catia.py |
Insert points into active part from tab-separated or CSV file as datums |
Insert_Points_Catia_Keep_History.py |
Insert points into active part from tab-separated or CSV file, preserving parametric history |
Insert_Points_Catia_With_Names.py |
Insert named points into active part from tab-separated or CSV file as datums |
Insert_Points_Catia_With_Names_Keep_History.py |
Insert named points into active part from tab-separated or CSV file, preserving parametric history |
Join_Explicit_No_Connect.py |
Join curves or surfaces without connex check, as datum |
Join_Explicit_No_Connect_Curve.py |
Join curves without connex check, as datum |
Join_Explicit_No_Connect_Surface.py |
Join surfaces without connex check, as datum |
Measure_Curve_With_3_PTS_AS_CIRCLE.py |
Measure curve radius using a 3-point circle |
Measure_Curve_With_3_PTS_AS_CIRCLE_Keep_Con.py |
Measure curve radius using a 3-point circle without removing construction elements |
Measure_Radius_Surface.py |
Measure surface radius using intersection and 3-point circle without removing construction |
Measure_Radius_Surface_Keep_Con.py |
Measure surface radius using intersection and 3-point circle, keeping all construction elements |
Measure_Radius_Surface_Keep_Con_Auto_Edge.py |
Measure radius of all border edges of a surface automatically via intersection and 3-point circle, keeping construction geometry |
Mirror_Keep_History.py |
Mirror hybrid shapes about a plane keeping their original names and parametric history |
Mirror_Keep_History_And_Structure.py |
Mirror all shapes in a geometric set about a plane, preserving names, structure and parametric history |
Mirror_Keep_Name.py |
Mirror hybrid shapes about a plane keeping their original names |
Mirror_Keep_Name_And_Structure.py |
Mirror all shapes in a geometric set about a plane, preserving names and structure |
Publish_Hybrid_Shapes_In_Geometric_Set.py |
Publish all hybrid shapes in a selected geometric set |
Reorder_Geometric_Set_Alphabetically.py |
Sort all elements inside a geometric set alphabetically by name |
Rotate_Angle_Keep_History.py |
Rotate hybrid shapes by an angle around an axis keeping their original names and parametric history |
Rotate_Angle_Keep_History_And_Structure.py |
Rotate all shapes in a geometric set by an angle, preserving names, structure and parametric history |
Rotate_Angle_Keep_Name.py |
Rotate hybrid shapes by an angle around an axis keeping their original names |
Rotate_Angle_Keep_Name_And_Structure.py |
Rotate all shapes in a geometric set by an angle, preserving names and structure |
Rotate_Three_Points_Keep_History.py |
Rotate hybrid shapes using three points definition keeping their original names and parametric history |
Rotate_Three_Points_Keep_History_And_Structure.py |
Rotate all shapes in a geometric set using three points, preserving names, structure and parametric history |
Rotate_Three_Points_Keep_Name.py |
Rotate hybrid shapes using three points definition keeping their original names |
Rotate_Three_Points_Keep_Name_And_Structure.py |
Rotate all shapes in a geometric set using three points, preserving names and structure |
Scale_Keep_History.py |
Scale hybrid shapes about a center point while keeping their original names and parametric history |
Scale_Keep_History_And_Structure.py |
Scale all shapes in a geometric set about a center point, preserving names, structure and parametric history |
Scale_Keep_Name.py |
Scale hybrid shapes about a center point while keeping their original names |
Scale_Keep_Name_And_Structure.py |
Scale all shapes in a geometric set about a center point, preserving names and structure |
Spline_Through_Points_In_Geometric_Set.py |
Create a spline through all points in a selected geometric set |
Translate_Direction_Distance_Keep_History.py |
Translate hybrid shapes keeping their original names and parametric history |
Translate_Direction_Distance_Keep_History_And_Structure.py |
Translate all shapes in a geometric set by direction and distance, preserving names, structure and parametric history |
Translate_Direction_Distance_Keep_Name.py |
Translate hybrid shapes keeping their original names |
Translate_Direction_Distance_Keep_Name_And_Structure.py |
Translate all shapes in a geometric set by direction and distance, preserving names and structure |
| Script | Description |
|---|---|
Involute_Gear_Generator_Mathamatical.py |
Generate an involute gear profile from user-defined parameters |
| Script | Description |
|---|---|
Check_Operation_Parameters_Against_Limits.py |
Check all operation parameters against predefined min/max limits and flag violations |
Export_NC_Program_Names_To_CSV.py |
Export all manufacturing program names and descriptions to CSV |
Export_Process_Table_Parameters.py |
Export machining program parameters to Excel |
Export_ResourceList.py |
Export names of all resources in a process document to CSV |
Export_Tool_List_From_Process.py |
Export all cutting tools from a process document to Excel |
Rename_Operations_From_Tool_Name.py |
Automatically rename each operation to match the assigned tool name |
| Script | Description |
|---|---|
Batch_Instance_Name_Equal_Part_Number.py |
Set every instance name in the active product tree to match its part number |
BOM_Export_To_CSV.py |
Export a bill of materials from the active product to a CSV file |
Export_Assembly_As_STEP.py |
Export the active product assembly as a single STEP file |
Save_Child_Parts_To_STEP.py |
Save all parts in a product to separate STEP files |
CatiaMenuWin32 is a native Windows launcher that syncs directly from this repository and presents each script as a clickable button. No manual path setup required.
- Download CatiaMenuWin32
- Launch the app — scripts sync automatically
- Click any button to run the script
Every script includes a structured metadata header that CatiaMenuWin32 reads to display script information in its tooltip:
'''
-----------------------------------------------------------------------------------------------------------------------
Script name: Script_Name.py
Version: 1.0
Code: Python3.10.4, Pycatia 0.8.3
Release: V5R32
Purpose: One line summary shown on the script button.
Author: Your Name
Date: DD.MM.YY
Description: Full description of what the script does.
Continuation lines must be indented.
dependencies = [
"pycatia",
]
requirements: Python >= 3.10
pycatia
Catia V5 running with an open document.
-----------------------------------------------------------------------------------------------------------------------
'''Contributions are welcome! Starting points and guidance:
- Script Templates — copy a ready-to-use template from
setup/templates/and follow theEDIT:and# TODO:markers - Writing Scripts — folder structure, header format, naming conventions, and the persistent data pattern
- Script Templates (wiki) — how to choose the right template and step-by-step setup guide
- Common Functions — reusable helpers available in
setup/templates/common_functions.py - CONTRIBUTING.md — pull request process and code style
MIT License — Copyright © 2025 Kai-Uwe Rathjen
- CatiaMenuWin32 — the launcher app for these scripts
- Wiki — full documentation including script guides and templates
- PyCATIA — the Python CATIA V5 automation library
- PyCATIA Documentation
Author: Kai-Uwe Rathjen