Translate Direction Distance Keep History And Structure

Translate Direction Distance Keep History And Structure

File: Part_Document_Scripts/Translate_Direction_Distance_Keep_History_And_Structure.py
Version: 1.0
Document Type: Part (also works with Part inside Product or Process)

---

Description

Translates every hybrid shape inside a selected geometric set by a user-defined direction and distance, recreating the full geometric set structure in the current in-work object and preserving the original names of all shapes and geometric sets. Recurses through all child geometric sets automatically. Results are left as live parametric features with a link to the source geometry.

---

Requirements

Requirement	Value
Python	>= 3.10
pycatia	>= 0.8.3
wxPython	Required
Open document	Part, or Part inside Product/Process

---

Usage

1. Open a CATPart document containing a geometric set and an axis system
2. Run the script
3. Selection 1: Select the geometric set to translate
4. Selection 2: Select a face or line of an axis system to define the translation direction
5. A dialog appears — enter the distance in mm and click OK
6. The translated structure is created inside the current in-work geometric set

---

Output

A child geometric set named after the source is created inside the in-work object, containing the full recreated structure with all shapes translated as live parametric features:

[in-work object]
  └── SourceSetName
        ├── Shape_A
        ├── Shape_B
        └── ChildSetName
              ├── Shape_C
              └── Shape_D

---

Notes

• The direction must be defined by selecting a face or line of an axis system — selecting other geometry types will cause the script to exit with an error
• All results are live parametric features — they retain a link to the source geometry and can be edited
• The source geometric set is not modified
• The selected geometric set must not be the current in-work object — the script will exit with an error if this is the case
• Use this script when you need to keep the parametric history; use Translate Direction Distance Keep Name And Structure when you want isolated datums instead
• For translating individual selected shapes rather than a whole set use Translate Direction Distance Keep History