Home

Pycatia Scripts Wiki

Welcome to the documentation for the Pycatia Scripts collection. These scripts automate common tasks in CATIA V5 using the pycatia Python library.

---

Requirements

Requirement	Version
Python	>= 3.10
pycatia	>= 0.8.3 (>= 0.9.5 for Process scripts)
wxPython	>= 4.2.5 (where required)
xlsxwriter	(Process export scripts only)
CATIA V5	V5R32

---

Installation

See the Installation and Setup page for full instructions on setting up Python, pycatia, and configuring CATIA V5 to run scripts.

---

Script Categories

Any Document Scripts

Scripts that work on Part, Product, or Process documents.

Script	Description
Batch CATDrawing To PDF	Exports all CATDrawing files in a selected folder to PDF
Find And Select By Name	Find and select all elements whose names contain a search string
Hide Planes And Axis Systems	Hides all planes and axis systems in the active document
Rename Hybrid Shapes	Renames multiple selected hybrid shapes in one go
Replace Name Hybrid Shapes	Find and replace text in the names of selected hybrid shapes
Toggle Show Hide Geometric Set	Toggle the visibility of a selected geometric set and all its children

---

Part Document Scripts

Scripts that require an open CATPart document.

Script	Description
Axis To Axis Keep History	Moves hybrid shapes from one axis system to another, preserving parametric history
Axis To Axis Keep History And Structure	Axis-to-axis transformation on all shapes in a geometric set, preserving history and structure
Axis To Axis Keep Name	Moves hybrid shapes from one axis system to another, preserving names
Axis To Axis Keep Name And Structure	Axis-to-axis transformation on all shapes in a geometric set, preserving names and structure
Batch Isolate Geometric Set	Isolates every element in a geometric set as a datum in one operation
Check Duplicate Names In Geometric Set	Scans a geometric set and reports any elements that share a name
Copy Geometric Set To New Part	Copies a selected geometric set and all its contents into a new blank CATPart
Create Construction Planes	Creates a series of evenly spaced offset planes from a reference plane
Create ISM OSM STEP Files	Creates two STEP files from ISM and OSM surfaces
Delete Deactivated Features	Deletes all deactivated hybrid shapes inside a selected geometric set
Export All Parameters To CSV	Exports all parameters from the active part to CSV
Export Curve Lengths Surface Areas To CSV	Exports curve lengths and surface areas from a geometric set to CSV
Export Geometric Set Structure To CSV	Exports the full geometric set tree and its contents to CSV
Export Mass CoG Inertia To CSV	Exports mass, centre of gravity and inertia tensor from all solid bodies to CSV
Export Points Axis and Geo Set To CSV	Exports points from a geometric set to CSV relative to a selected axis
Export Points Axis and Geo Set To XYZ	Exports points from a geometric set to XYZ relative to a selected axis
Export Points Geo Set To CSV	Exports points from a geometric set to CSV relative to the absolute axis
Export Points Geo Set To XYZ	Exports points from a geometric set to XYZ relative to the absolute axis
Extract Boundary Curves	Extracts boundary edges of a selected surface as datum curves
IGES Export Curve Axis	Exports curves as IGES after moving them to the absolute axis
Insert Points Catia	Imports points from a TXT or CSV file into CATIA
Insert Points Catia Keep History	Imports points from a TXT or CSV file into CATIA, preserving parametric history
Insert Points Catia With Names	Imports named points from a TXT or CSV file into CATIA
Insert Points Catia With Names Keep History	Imports named points from a TXT or CSV file into CATIA, preserving parametric history
Join Explicit No Connect	Joins surfaces or curves without checking for connexity
Join Explicit No Connect Curve	Joins curves without checking for connexity
Join Explicit No Connect Surface	Joins surfaces without checking for connexity
Measure Curve With 3 Points As Circle	Measures the radius of a curve by fitting a 3-point circle
Measure Curve With 3 Points As Circle Keep Con	Same as above but keeps the construction geometry
Measure Radius Surface	Measures the radius of a surface by intersection and 3-point circle
Measure Radius Surface Keep Con	Same as above but keeps the construction geometry
Mirror Keep History	Mirrors hybrid shapes while preserving parametric history
Mirror Keep History And Structure	Mirrors all shapes in a geometric set, preserving history and structure
Mirror Keep Name	Mirrors hybrid shapes while keeping the names
Mirror Keep Name And Structure	Mirrors all shapes in a geometric set, preserving names and structure
Publish Hybrid Shapes In Geometric Set	Publishes all hybrid shapes in a selected geometric set
Reorder Geometric Set Alphabetically	Sorts all elements inside a geometric set alphabetically by name
Rotate Angle Keep History	Rotates hybrid shapes by an angle around an axis, preserving parametric history
Rotate Angle Keep History And Structure	Rotates all shapes in a geometric set by angle, preserving history and structure
Rotate Angle Keep Name	Rotates hybrid shapes by an angle around an axis, preserving names
Rotate Angle Keep Name And Structure	Rotates all shapes in a geometric set by angle, preserving names and structure
Rotate Three Points Keep History	Rotates hybrid shapes using three points, preserving parametric history
Rotate Three Points Keep History And Structure	Rotates all shapes in a geometric set using three points, preserving history and structure
Rotate Three Points Keep Name	Rotates hybrid shapes using three points, preserving names
Rotate Three Points Keep Name And Structure	Rotates all shapes in a geometric set using three points, preserving names and structure
Scale Keep History	Scales hybrid shapes while preserving parametric history
Scale Keep History And Structure	Scales all shapes in a geometric set, preserving history and structure
Scale Keep Name	Scales hybrid shapes while keeping the names
Scale Keep Name And Structure	Scales all shapes in a geometric set, preserving names and structure
Spline Through Points In Geometric Set	Creates a spline through all points in a selected geometric set
Translate Direction Distance Keep History	Translates hybrid shapes by direction and distance, preserving parametric history
Translate Direction Distance Keep History And Structure	Translates all shapes in a geometric set by direction and distance, preserving history and structure
Translate Direction Distance Keep Name	Translates hybrid shapes by a direction and distance, preserving names
Translate Direction Distance Keep Name And Structure	Translates all shapes in a geometric set by direction and distance, preserving names and structure

---

Shape Generation Scripts

Scripts that generate geometry from mathematical definitions.

Script	Description
Involute Gear Generator	Generates a fully parametric involute spur gear

---

Process Document Scripts

Scripts that require an open CATProcess document.

Script	Description
Check Operation Parameters Against Limits	Checks all operation parameters against predefined min/max limits and flags violations
Export NC Program Names To CSV	Exports all manufacturing program names and descriptions to CSV
Export Process Table Parameters	Exports machining parameters from all operations to an Excel file
Export Resource List	Exports the names of all resources in a process document to CSV
Export Tool List From Process	Exports all cutting tools from a process document to Excel
Rename Operations From Tool Name	Automatically renames each operation to match the assigned tool name

---

Product Document Scripts

Scripts that require an open CATProduct document.

Script	Description
Batch Instance Name Equal Part Number	Sets every instance name in the active product tree to match its part number
BOM Export To CSV	Exports a bill of materials from the active product to CSV
Export Assembly As STEP	Exports the active product assembly as a single STEP file
Save Child Parts To STEP	Saves all child CATParts in a product to STEP files

---

Contributing

• Writing Scripts — folder structure, header format, naming, and the persistent data pattern
• Script Templates — copy-paste starting points for every document type and complexity level
• CONTRIBUTING.md — full guidelines for submitting new scripts or reporting issues