base_interfaces¶

base_application¶

context¶

class pycatia.base_interfaces.context.CATIADocHandler(file_name=None, new_document=None)¶

A context manager to open or create a CATIA document.

Warning

The CATIA document will be closed (and not automatically saved) upon exit.

Only file_name __or__ new_document are required as one document is handled at a time.

Example - Open a CATPart

>>> from pycatia.base_interfaces.context import CATIADocHandler
>>> catia_part = 'tests//CF_catia_measurable_part.CATPart'
>>> with CATIADocHandler(catia_part) as handler:
>>>     # create the documents object.
>>>     documents = handler.documents
>>>     # create the document object.
>>>     document = handler.document
>>>     # do some stuff
>>>     # save document!
>>>     document.save()

Example - Create a new CATPart

>>> from pycatia.base_interfaces.context import CATIADocHandler
>>> with CATIADocHandler(new_document='Part') as handler:
>>>     # create the CATIA() object.
>>>     catia = handler.catia
>>>     # create the documents object.
>>>     documents = handler.documents
>>>     # create the document object.
>>>     document = handler.document
>>>     # save document!
>>>     document.save()

Parameters

file_name (str) – (optional) path filename to file
new_document (str) – (optional) ‘Part’, ‘Product’ or ‘Drawing’.

move¶

class pycatia.base_interfaces.move.Move(com_object)¶

Note

CAA V5 Visual Basic help

Represents an object associated with any kind of objects which

retrieves the corresponding movable object.An object can be moved only

if it is independent from other objects. For example, a pad can be

moved, and is as such a movable object, while an edge cannot be moved

individually. It should be moved with all the objects making up the

pad to which it belongs as a whole. In this case, the underlying

edge’s movable object is the pad.

apply(i_transformation_array)¶: Note

CAA V5 Visual Basic help

Apply

o Sub Apply( CATSafeArrayVariant iTransformationArray)

Applies a move transformation to a movable object.

Parameters:

TransformationArray

The linear transformation array initialized successively by the

four columns of the transformation matrix.

The first nine components represent the rotation matrix.

The last three components represent the translation vector.

Examples:

This example applies the transformation (45 degrees-rotation around

the x axis and a translation) stored in TransformationArray

to the Move object associated with myMovableObject:

Dim TransformationArray( 11 )

‘Rotation( 45 degrees around the x axis) components

TransformationArray( 0 ) = 1.000

TransformationArray( 1 ) = 0

TransformationArray( 2 ) = 0

TransformationArray( 3 ) = 0

TransformationArray( 4 ) = 0.707

TransformationArray( 5 ) = 0.707

TransformationArray( 6 ) = 0

TransformationArray( 7 ) = -0.707

TransformationArray( 8 ) = 0.707

‘Translation Vector (10,20,30)

TransformationArray( 9 ) = 10.000

TransformationArray( 10 ) = 20.000

TransformationArray( 11 ) = 30.000

MyMovableObject.Move.Apply TransformationArray

property movable_object¶: Note

CAA V5 Visual Basic help

MovableObject

o Property MovableObject() As Move

Returns the movable object associated with the used object. Example:

This example retrieves the myMovableObject from Move object

associated with MyObject. Dim myMovableObject As Move Set

myMovableObject = MyObject.Move.MovableObject

Parameters:

base_interfaces¶

base_application¶

context¶

move¶

pycatia¶