part_interfaces

add

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.add.Add(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.BooleanShape
Add

Represents the add, or union boolean operation.
It is performed between a body and the current shape.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

affinity

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.affinity.Affinity(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Affinity

Represents the hybrid shape Affinity feature object.
This solid feature is created from an underlying HybridShapeAffinity aggregated
by the Affinity. Role: To access the data of the hybrid shape Affinity feature
object. This data includes:

The element to Affinity
Origin for the Affinity
Plane for the Affinity
Direction for the Affinity
XRatio Value for the Affinity
YRatio Value for the Affinity
ZRatio Value for the Affinity
The translation distance and its value

Use the CATIAHybridShapeFactory to create HybridShapeFeature
object.

See also:
HybridShapeFactory
property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeAffinity.

Example:
The following example explains how to retrieve the underlying
HybridShape Affinity

Dim oHybridShape as AnyObject
Set oHybridShape=oAffinity.HybridShape
oHybridShape.ElemToAffinity = reference1
Returns

HybridShape

angular_repartition

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.angular_repartition.AngularRepartition(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.Repartition
AngularRepartition

Represents the angular repartition.
It is used by the circular pattern. It is made up of a number of times the
shape is copied and of an angular spacing between two consecutive copies of the
shape along a crown. The number of times the shape is copied is accessible
using the Repartition.InstancesCount property.

See also:
CircPattern
property angular_spacing

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngularSpacing() As Angle (Read Only)

Returns the angle between two consecutive copies of a shape along the
repartition crown.

Example:
The following example returns in AngSpace1 the angular spacing of the
angular repartition firstRepartition:

Set AngSpace1 = firstRepartition.AngularSpacing
Returns

Angle

property instance_spacing

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property InstanceSpacing() As Angle (Read Only)

Returns the angle at which the pattern spacing is done for unequal angular
spacing mode.

Example:
The following example returns in AngSpace1 the angular spacing of the
angular repartition firstRepartition:

Set AngSpace1 = firstRepartition.AngularSpacing
Returns

Angle

assemble

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.assemble.Assemble(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.BooleanShape
Assemble

Represents the assemble boolean operation.
It is performed between a body and the current shape. An assemble operation
adds material if the body is “positive” and remove material if the body is
“negative”.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

auto_draft

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.auto_draft.AutoDraft(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
AutoDraft

Represents the AutoDraft shape.
property functional_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FunctionalFace(Reference iFace) (Write Only)
Returns

False

property functional_faces

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FunctionalFaces() As References (Read Only)

Returns or sets the functional faces.

Example:
The following example returns in FunctionalFaces the list functional
faces of the AutoDraft AutoDraft, and then sets NewFunctionalFace as a
functional face:

Set FunctionalFaces = AutoDraft.FunctionalFace
AutoDraft.FunctionalFace = NewFunctionalFace
Returns

References

property main_draft_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MainDraftAngle() As Reference

Returns or sets the main draft angle.

Example:
The following example returns in MainDraftAngle the main draft angle of
the AutoDraft AutoDraft, and then sets it to
NewMainDraftAngle.:

Set MainDraftAngle = AutoDraft.MainDraftAngle
AutoDraft.MainDraftAngle = NewMainDraftAngle
Returns

Reference

property mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Mode() As Reference

Returns or sets the draft mode.

Example:
The following example returns in Mode the mode of the draft AutoDraft
AutoDraft, and then sets it to NewMode:

Set Mode = AutoDraft.Mode
AutoDraft.Mode = NewMode
Returns

Reference

property parting_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PartingElement() As Reference

Returns or sets the parting element.

Example:
The following example returns in PartingElement the parting element of
the AutoDraft AutoDraft, and then sets it to
NewpartingElement:

Set PartingElement = AutoDraft.PartingElement
AutoDraft.PartingElement = NewPartingElement
Returns

Reference

property pulling_direction

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PullingDirection() As Reference

Returns or sets the pulling direction.

Example:
The following example returns in PullingDirection the pulling direction
of the AutoDraft AutoDraft, and then sets it to
NewPullingDirection.:

Set PullingDirection = AutoDraft.PullingDirection
AutoDraft.PullingDirection = NewPullingDirection
Returns

Reference

auto_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.auto_fillet.AutoFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
AutoFillet

Represents the AutoFillet shape.
A AutoFillet fillets all the edges of Solid
property curvature_radius

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CurvatureRadius() As Length (Read Only)

Returns the Curvature radius.

Example:
The following example returns in Curvature radius the Curvature radius
of the AutoFillet Autofillet:

Set Curvatureradius = Autofillet.Radius
Returns

Length

property faces_to_fillet

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FacesToFillet() As References (Read Only)

Returns or sets the faces to fillet.

Example:
The following example returns in facestofillet the faces required for
autofillet autoFillet, and then sets it to
NewFacestofillet:

Set Facestofillet = autoFillet.Facestofillet
autofillet.Facestofillet = NewFacestofillet
Returns

References

property faces_to_fillets

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FacesToFillets(Reference iFace) (Write Only)
Returns

False

property fillet_radius

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FilletRadius() As Length (Read Only)

Returns the Fillet radius.

Example:
The following example returns in fillet radius the fillet radius of the
AutoFillet Autofillet:

Set Filletradius = Autofillet.Radius
Returns

Length

property functional_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FunctionalFace(Reference iFace) (Write Only)
Returns

False

property functional_faces

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FunctionalFaces() As References (Read Only)

Returns or sets the functional face.

Example:
The following example returns in functionalface the functional face of
the autofillet autoFillet, and then sets it to
NewfunctionalFace:

Set functionalFace = autoFillet.FunctionalFace
autofillet.FunctionalFace = NewfunctionalFace
Returns

References

property parting_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PartingElement() As Reference

Returns or sets the parting element.

Example:
The following example returns in partingelement the parting element of
the autofillet autoFillet, and then sets it to Newparting
element:

Set Parting element = autoFillet.PartingElement
autofillet.PartingElement = NewPartingElement
Returns

Reference

property round_radius

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RoundRadius() As Length (Read Only)

Returns the Round radius.

Example:
The following example returns in round radius the round radius of the
AutoFillet Autofillet:

Set roundradius = Autofillet.Radius
Returns

Length

property round_radius_activation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RoundRadiusActivation() As boolean

Returns the AutoFillet RoundRadiusActivation flag (for AutoFillet
only).
It returns 1 if RoundRadius is activated, 0 if not.

Returns:
oRoundRadActivation The RoundRadActivation flag as an
int

Example:
Returns

bool

property slivers_and_crack

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SliversAndCrack(Reference iSlivers) (Write Only)
Returns

False

property slivers_and_cracks

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SliversAndCracks() As References (Read Only)

Returns or sets the slivers face.

Example:
The following example returns in slivers the sliver face of the
autofillet autoFillet, and then sets it to Newsliver:

Set sliversFace = autoFillet.SliversFace
autofillet.SliversFace = NewsliversFace
Returns

References

property support_surface

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SupportSurface() As Reference

Returns or sets the support surface.

Example:
The following example returns in SupportSurface the support surface
required for autofillet autoFillet, and then sets it to
NewSupportSurface:

Set SupportSurface = autoFillet.SupportSurface
autofillet.SupportSurface = NewSupportSurface
Returns

Reference

axis_to_axis

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.axis_to_axis.AxisToAxis(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
AxisToAxis

Represents the hybrid shape AxisToAxis feature object.
This solid feature is created from an underlying HybridShapeAxisToAxis
aggregated by the AxisToAxis. Role: To access the data of the hybrid shape
AxisToAxis feature object. This data includes:

The element to AxisToAxis
Origin for the AxisToAxis
Plane for the AxisToAxis
Direction for the AxisToAxis
XRatio Value for the AxisToAxis
YRatio Value for the AxisToAxis
ZRatio Value for the AxisToAxis
The translation distance and its value

Use the CATIAHybridShapeFactory to create HybridShapeFeature
object.

See also:
HybridShapeFactory
property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeAxisToAxis.

Example:
The following example explains how to retrieve the underlying
HybridShape AxisToAxis

Dim oHybridShape as AnyObject
Set oHybridShape=oAxisToAxis.HybridShape
oHybridShape.ElemToAxisToAxis = reference1
Returns

HybridShape

boolean_shape

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.boolean_shape.BooleanShape(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
BooleanShape

Represents the shapes based on boolean operations on other
shapes.
It is the base object for add, assemble, intersect, remove, and split
shapes.

See also:
Add, Assemble, Intersect, Remove, Split, Trim
property body

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Body() As Body (Read Only)

Returns the inserted body.
Returns

Body

set_operated_object(i_reference_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetOperatedObject(Reference iReferenceObject)

Modifies the Second Operand. input object to replace with Body or Volume
Parameters

i_reference_object (Reference) –

Returns

None

set_operating_volume(i_reference_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetOperatingVolume(Reference iReferenceObject)

Swaps the operands. Both the Operands must be Volume. This is available
only for Volume Add and Volume UnionTrim Operations
Parameters

i_reference_object (Reference) –

Returns

None

chamfer

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.chamfer.Chamfer(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Chamfer

Represents the chamfer shape.
A chamfer is made up of a list of geometrical elements to process, such as
faces, and is defined using a couple of parameters, such as two lengths, or a
length and an angle.
add_element_to_chamfer(i_element_to_chamfer)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddElementToChamfer(Reference iElementToChamfer)

Adds a new geometrical element to be chamfered.

Parameters:

iElementToChamfer
The new element to be chamfered
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example adds the new element element to be chamfered for the
firstChamfer chamfer:

firstChamfer.AddElementToChamfer(element)
Parameters

i_element_to_chamfer (Reference) –

Returns

None

property angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Angle() As Angle (Read Only)

Returns the chamfer angle. This is valid only if the chamfer is defined
using a length and an angle, that is if the chamfer definition mode
CatChamferMode is set to catLengthAngleChamfer.

Example:
The following example returns in angle the angle of the firstChamfer
chamfer:

Set angle = firstChamfer.Angle
Returns

Angle

property elements_to_chamfer

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ElementsToChamfer() As References (Read Only)

Returns the collection of geometrical elements to be
chamfered.

Example:
The following example returns in list the list of elements of the
firstChamfer chamfer:

Set list = firstChamfer.ElementsToChamfer
Returns

References

property length1

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Length1() As Length (Read Only)

Returns the chamfer first length. This is the first length if the chamfer
is defined by two lengths, or the chamfer if the chamfer is defined by a
length and an angle.

Example:
The following example returns in length1 the first length of the
firstChamfer chamfer:

Set length1 = firstChamfer.Length1
Returns

Length

property length2

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Length2() As Length (Read Only)

Returns the chamfer second length. This is valid only if the chamfer is
defined using two lengths, that is if the chamfer definition mode
CatChamferMode is set to catTwoLengthChamfer.

Example:
The following example returns in length2 the second length of the
firstChamfer chamfer:

Set length2 = firstChamfer.Length2
Returns

Length

property mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Mode() As CatChamferMode

Returns or sets the chamfer definition mode. The chamfer definition mode
enables the chamfer to be defined using either two lengths or a length and an
angle.

Example:
The following example returns in mode how the parameters of the
firstChamfer chamfer are defined, and then sets it to
catTwoLengthChamfer:

Set mode = firstChamfer.Mode
firstChamfer.Mode = catTwoLengthChamfer
Returns

enum cat_chamfer_mode

property orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Orientation() As CatChamferOrientation

Returns or sets the chamfer orientation.

Example:
The following example returns in orient the orientation mode of the
firstChamfer chamfer, and then sets it to
catReverseChamfer:

Set orient = firstChamfer.Orientation
firstChamfer.Orientation = catReverseChamfer
Returns

enum cat_chamfer_orientation

property propagation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Propagation() As CatChamferPropagation

Returns or sets the propagation mode of the geometrical elements to be
chamfered.

Example:
The following example returns in prop the propagation mode of the
firstChamfer chamfer, and then sets it to
catMinimalChamfer:

Set prop = firstChamfer.Propagation
firstChamfer.Propagation = catMinimalChamfer
Returns

enum cat_chamfer_propagation

withdraw_element_to_chamfer(i_element_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawElementToChamfer(Reference iElementToWithdraw)

Withdraws a geometrical element from those to be
chamfered.

Parameters:

iElementToWithdraw
The existing element to withdraw
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example withdraws an existing element element to be chamfered
from the firstChamfer chamfer:

firstChamfer.WithdrawElementToChamfer(element)
Parameters

i_element_to_withdraw (Reference) –

Returns

None

circ_pattern

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.circ_pattern.CircPattern(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
PartInterfaces.Pattern
CircPattern

Represents the circular pattern.
The shape is duplicated along concentric circles to build crowns. A linear
repartition object defines the duplication along radial directions, thus
determining the number of crowns. An angular repartition object defines the
duplication on the crowns.

See also:
LinearRepartition, AngularRepartition
property angular_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngularDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the angular
direction.

Example:
The following example returns in AngularDirPos the position of the
shape to be copied along the angular direction.

Set AngularDirPos = firstPattern.AngularDirectionRow
Returns

IntParam

property angular_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngularRepartition() As AngularRepartition (Read
Only)

Returns the angular repartition. The angular repartition is the repartition
on a crown.

Example:
The following example returns in repartA the angular repartition of the
circular pattern firstPattern:

Set repartA = firstPattern.AngularRepartition
Returns

AngularRepartition

property circular_pattern_parameters

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CircularPatternParameters() As
CatCircularPatternParameters

Returns or sets the circular pattern parameters required to define the
pattern. These parameters are used when reading the CATIAAngularRepartition
properties.

Example:
The following example returns in parameters the circular pattern
parameters of the firstPattern circular pattern, and then sets it to
catCompleteCrown, so that only the number of instances is used to define the
Pattern:

Set parameters = firstPattern.CircularPatternParameters
Set firstPattern.CircularPatternParameters = catCompleteCrown
Returns

enum cat_circular_pattern_parameters

get_rotation_axis(io_rotation_axis)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetRotationAxis(CATSafeArrayVariant ioRotationAxis)

Returns the rotation axis. The rotation axis is returned as an array
containing the rotation axis vector components. Assume this array is
oRotationAxis. It contains:

oRotationAxis[0],oRotationAxis[1],oRotationAxis[2]
The X, Y, and Z rotation axis vector components

Example:
The following example returns in axisArray the rotation axis components
of the circular pattern firstPattern:

Call firstPattern.GetRotationAxis(axisArray)
Set x = axisArray[0]
Set y = axisArray[1]
Set z = axisArray[2]
Parameters

io_rotation_axis (tuple) –

Returns

None

get_rotation_center(io_rotation_center)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetRotationCenter(CATSafeArrayVariant
ioRotationCenter)

Returns the rotation center if the user defined it. Returns E_FAIL if no
rotation center has been defined The rotation center is returned as an array
containing the rotation center coordinates. Assume this array is
oRotationCenter. It contains:

oRotationCenter[0],oRotationCenter[1],oRotationCenter[2]
The X, Y, and Z rotation center coordinates

Example:
The following example returns in centerArray the rotation center
coordinates of the circular pattern firstPattern, and saves them in
variables:

Call firstPattern.GetRotationCenter(centerArray)
x = centerArray[0]
y = centerArray[1]
z = centerArray[2]
Parameters

io_rotation_center (tuple) –

Returns

None

property radial_alignment

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialAlignment() As boolean

Returns or sets whether the copied shapes should be rotated or radial
aligned with respect to the original one.
True if the copied shapes are rotated.

Example:
The following example returns in alignedR the radial alignment of the
circular pattern firstPattern, and then sets it to
False:

Set alignedR = firstPattern.RadialAlignment
firstPattern.RadialAlignment = False
Returns

bool

property radial_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the radial
direction.

Example:
The following example returns in RadialDirPos the position of the shape
to be copied along the radial direction.

Set RadialDirPos = firstPattern.RadialDirectionRow
Returns

IntParam

property radial_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialRepartition() As LinearRepartition (Read
Only)

Returns the radial repartition. The radial repartition is the repartition
along a radius.

Example:
The following example returns in repartR the radial repartition of the
circular pattern firstPattern:

Set repartR = firstPattern.RadialRepartition
Returns

LinearRepartition

property rotation_orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RotationOrientation() As boolean

Returns or sets whether the shapes are copied clockwise on the crowns with
respect to the rotation axis direction.
True if the shapes are copied counterclockwise when the rotation axis
direction goes towards you when you look at the crown.

Example:
The following example returns in alignedAxis whether the circular
pattern firstPattern is built clockwise, and then sets it to
True:

alignedAxis = firstPattern.RotationOrientation
firstPattern.RotationOrientation = True
Returns

bool

set_instance_angular_spacing(i_instance_number, i_angular_spacing)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetInstanceAngularSpacing(long iInstanceNumber,
double iAngularSpacing)

Sets the InstanceAngularSpacing.

Parameters:

iInstanceNumber
The Instance Number
iAngularSpacing
The Angular Spacing

Example:
The following example sets the InstanceAngularSpacing of the circular
pattern
Parameters
  • i_instance_number (int) –

  • i_angular_spacing (float) –

Returns

None

set_rotation_axis(i_rotation_axis)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetRotationAxis(Reference iRotationAxis)

Sets the rotation axis.

Parameters:

iRotationAxis
The rotation axis. It is passed as reference and can be valuated
with a line, an edge or a plane reference: in this case the plane normal is
taken into account.
The following

Boundary objects are supported: PlanarFace, CylindricalFace
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.


Example:
The following example sets the rotation axis of the circular pattern
firstPattern with the refLine1 reference:

firstPattern.SetRotationAxis refLine1
Parameters

i_rotation_axis (Reference) –

Returns

None

set_rotation_center(i_rotation_center)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetRotationCenter(Reference iRotationCenter)

Sets the rotation center.

Parameters:

iRotationCenter
The rotation center

Example:
The following example sets the rotation center of the circular pattern
firstPattern with point1Ref point:

firstPattern.SetRotationCenter point1Ref
Parameters

i_rotation_center (Reference) –

Returns

None

set_unequal_instance_number(i_instance_number)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetUnequalInstanceNumber(long iInstanceNumber)

Sets the Instance Number.

Parameters:

iInstanceNumber
The Instance Number

Example:
The following example modifies the instance number for unequal angular
spacing
Parameters

i_instance_number (int) –

Returns

None

set_unequal_step(i_instance_number)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetUnequalStep(long iInstanceNumber)

This method is deprecated Sets the UnequalStep.

Parameters:

iInstanceNumber
The Instance Number

Example:
The following example creates the number of pattern spacing objects in
pattern object
Parameters

i_instance_number (int) –

Returns

None

close_surface

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.close_surface.CloseSurface(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
PartInterfaces.Pattern
CircPattern

Represents the circular pattern.
The shape is duplicated along concentric circles to build crowns. A linear
repartition object defines the duplication along radial directions, thus
determining the number of crowns. An angular repartition object defines the
duplication on the crowns.

See also:
LinearRepartition, AngularRepartition
property angular_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngularDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the angular
direction.

Example:
The following example returns in AngularDirPos the position of the
shape to be copied along the angular direction.

Set AngularDirPos = firstPattern.AngularDirectionRow
Returns

IntParam

property angular_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngularRepartition() As AngularRepartition (Read
Only)

Returns the angular repartition. The angular repartition is the repartition
on a crown.

Example:
The following example returns in repartA the angular repartition of the
circular pattern firstPattern:

Set repartA = firstPattern.AngularRepartition
Returns

AngularRepartition

property circular_pattern_parameters

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CircularPatternParameters() As
CatCircularPatternParameters

Returns or sets the circular pattern parameters required to define the
pattern. These parameters are used when reading the CATIAAngularRepartition
properties.

Example:
The following example returns in parameters the circular pattern
parameters of the firstPattern circular pattern, and then sets it to
catCompleteCrown, so that only the number of instances is used to define the
Pattern:

Set parameters = firstPattern.CircularPatternParameters
Set firstPattern.CircularPatternParameters = catCompleteCrown
Returns

enum cat_circular_pattern_parameters

get_rotation_axis(io_rotation_axis)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetRotationAxis(CATSafeArrayVariant ioRotationAxis)

Returns the rotation axis. The rotation axis is returned as an array
containing the rotation axis vector components. Assume this array is
oRotationAxis. It contains:

oRotationAxis[0],oRotationAxis[1],oRotationAxis[2]
The X, Y, and Z rotation axis vector components

Example:
The following example returns in axisArray the rotation axis components
of the circular pattern firstPattern:

Call firstPattern.GetRotationAxis(axisArray)
Set x = axisArray[0]
Set y = axisArray[1]
Set z = axisArray[2]
Parameters

io_rotation_axis (tuple) –

Returns

None

get_rotation_center(io_rotation_center)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetRotationCenter(CATSafeArrayVariant
ioRotationCenter)

Returns the rotation center if the user defined it. Returns E_FAIL if no
rotation center has been defined The rotation center is returned as an array
containing the rotation center coordinates. Assume this array is
oRotationCenter. It contains:

oRotationCenter[0],oRotationCenter[1],oRotationCenter[2]
The X, Y, and Z rotation center coordinates

Example:
The following example returns in centerArray the rotation center
coordinates of the circular pattern firstPattern, and saves them in
variables:

Call firstPattern.GetRotationCenter(centerArray)
x = centerArray[0]
y = centerArray[1]
z = centerArray[2]
Parameters

io_rotation_center (tuple) –

Returns

None

property radial_alignment

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialAlignment() As boolean

Returns or sets whether the copied shapes should be rotated or radial
aligned with respect to the original one.
True if the copied shapes are rotated.

Example:
The following example returns in alignedR the radial alignment of the
circular pattern firstPattern, and then sets it to
False:

Set alignedR = firstPattern.RadialAlignment
firstPattern.RadialAlignment = False
Returns

bool

property radial_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the radial
direction.

Example:
The following example returns in RadialDirPos the position of the shape
to be copied along the radial direction.

Set RadialDirPos = firstPattern.RadialDirectionRow
Returns

IntParam

property radial_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RadialRepartition() As LinearRepartition (Read
Only)

Returns the radial repartition. The radial repartition is the repartition
along a radius.

Example:
The following example returns in repartR the radial repartition of the
circular pattern firstPattern:

Set repartR = firstPattern.RadialRepartition
Returns

LinearRepartition

property rotation_orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RotationOrientation() As boolean

Returns or sets whether the shapes are copied clockwise on the crowns with
respect to the rotation axis direction.
True if the shapes are copied counterclockwise when the rotation axis
direction goes towards you when you look at the crown.

Example:
The following example returns in alignedAxis whether the circular
pattern firstPattern is built clockwise, and then sets it to
True:

alignedAxis = firstPattern.RotationOrientation
firstPattern.RotationOrientation = True
Returns

bool

set_instance_angular_spacing(i_instance_number, i_angular_spacing)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetInstanceAngularSpacing(long iInstanceNumber,
double iAngularSpacing)

Sets the InstanceAngularSpacing.

Parameters:

iInstanceNumber
The Instance Number
iAngularSpacing
The Angular Spacing

Example:
The following example sets the InstanceAngularSpacing of the circular
pattern
Parameters
  • i_instance_number (int) –

  • i_angular_spacing (float) –

Returns

None

set_rotation_axis(i_rotation_axis)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetRotationAxis(Reference iRotationAxis)

Sets the rotation axis.

Parameters:

iRotationAxis
The rotation axis. It is passed as reference and can be valuated
with a line, an edge or a plane reference: in this case the plane normal is
taken into account.
The following

Boundary objects are supported: PlanarFace, CylindricalFace
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.


Example:
The following example sets the rotation axis of the circular pattern
firstPattern with the refLine1 reference:

firstPattern.SetRotationAxis refLine1
Parameters

i_rotation_axis (Reference) –

Returns

None

set_rotation_center(i_rotation_center)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetRotationCenter(Reference iRotationCenter)

Sets the rotation center.

Parameters:

iRotationCenter
The rotation center

Example:
The following example sets the rotation center of the circular pattern
firstPattern with point1Ref point:

firstPattern.SetRotationCenter point1Ref
Parameters

i_rotation_center (Reference) –

Returns

None

set_unequal_instance_number(i_instance_number)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetUnequalInstanceNumber(long iInstanceNumber)

Sets the Instance Number.

Parameters:

iInstanceNumber
The Instance Number

Example:
The following example modifies the instance number for unequal angular
spacing
Parameters

i_instance_number (int) –

Returns

None

set_unequal_step(i_instance_number)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetUnequalStep(long iInstanceNumber)

This method is deprecated Sets the UnequalStep.

Parameters:

iInstanceNumber
The Instance Number

Example:
The following example creates the number of pattern spacing objects in
pattern object
Parameters

i_instance_number (int) –

Returns

None

const_rad_edge_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.const_rad_edge_fillet.ConstRadEdgeFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
PartInterfaces.Fillet
PartInterfaces.EdgeFillet
ConstRadEdgeFillet

Represents the edge fillet shape with a constant radius.
The resulting shape is made up of edge fillets built with a constant
radius.
add_object_to_fillet(i_object_to_fillet)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddObjectToFillet(Reference iObjectToFillet)

Adds a new sub-element to be filleted. This sub-element is usually an
edge.

Parameters:

iObjectToFillet
The sub-element to be filleted
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example adds a new geometrical element element to be filleted
by the constant radius edge fillet firstCstEdgeFillet:

firstCstEdgeFillet.AddObjectToFillet(element)
Parameters

i_object_to_fillet (Reference) –

Returns

None

property objects_to_fillet

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ObjectsToFillet() As References (Read Only)

Returns the collection of reference elements to be
filleted.

Example:
The following example returns in elements the reference elements to be
filleted of the constant radius edge fillet
firstCstEdgeFillet:

Set elements = firstCstEdgeFillet.ObjectsToFillet
Returns

References

property radius

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Radius() As Length (Read Only)

Returns the edge fillet constant radius.

Example:
The following example returns in radius the radius of the constant
radius edge fillet firstCstEdgeFillet:

Set radius = firstCstEdgeFillet.Radius
Returns

Length

withdraw_object_to_fillet(i_object_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawObjectToFillet(Reference iObjectToWithdraw)

Withdraws a sub-element from those to be filleted. This sub-element is
usually an edge.

Parameters:

iObjectToWithdraw
The sub-element to withdraw
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example withdraws the geometrical element element from those
to be filleted by the constant radius edge fillet
firstCstEdgeFillet:

firstCstEdgeFillet.WithdrawObjectToFillet(element)
Parameters

i_object_to_withdraw (Reference) –

Returns

None

defeaturing

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing.Defeaturing(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Defeaturing

Represents the defeaturing.
property filters

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Filters() As DefeaturingFilters (Read Only)

Returns the filter collection of the Defeaturing. The returned object is
the filter collection associated to this Defeaturing object. All changes
applied to the returned collection will be automatically applied to the
Defeaturing object. As a consequence there is no need to affect the collection
to the defeaturing after the change to update the
property.

Returns:
oFilters The filter collection (see DefeaturingFilters for list of
possible actions)

Example:
The following example returns in myDefeaturingFiltersCollection the
filter collection of the Defeaturing
firstDefeaturing:

Set myDefeaturingFiltersCollection = firstDefeaturing.Filters
Returns

DefeaturingFilters

defeaturing_fillet_filter

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing_fillet_filter.DefeaturingFilletFilter(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.DefeaturingFilter
PartInterfaces.DefeaturingFilterWithRange
DefeaturingFilletFilter

Represents the defeaturing fillet filter.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

defeaturing_filter

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing_filter.DefeaturingFilter(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
DefeaturingFilter

Represents the base object for defeaturing filters.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

defeaturing_filter_with_range

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing_filter_with_range.DefeaturingFilterWithRange(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.DefeaturingFilter
DefeaturingFilterWithRange

Represents the base object for defeaturing filters which uses range(s) of
values
get_maximum_activity(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMaximumActivity(CATBSTR iRangeId) As boolean
Parameters

i_range_id (str) –

Returns

bool

get_maximum_angle(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMaximumAngle(CATBSTR iRangeId) As Angle
Parameters

i_range_id (str) –

Returns

Angle

get_maximum_length(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMaximumLength(CATBSTR iRangeId) As Length
Parameters

i_range_id (str) –

Returns

Length

get_maximum_value(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMaximumValue(CATBSTR iRangeId) As double
Parameters

i_range_id (str) –

Returns

float

get_minimum_activity(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMinimumActivity(CATBSTR iRangeId) As boolean

Returns the minimum or maximum value activity of the filter for the given
range id.

Parameters:

iRangeId
The identificator of the range on which the minimum/maximum should
be read - if iRangeId is empty or equal to “Default”, takes the default range
as defined by the filter (“RibbonRadius” for FilletFilter, “MainDiameter” for
HoleFilter) - else iRangeId should be chosen among: *
{“RibbonRadius”,”RibbonAngle”,”RibbonLength”} for FilletFilter *
{“MainDiameter”} for HoleFilter * any defined and supported range id in case of
a user-defined filter

Returns:
oValue The filter minimum/maximum activity for the specified
range

Example:
The following example returns in theMinActivity the minimum value
activity of filter myFilter for the range myRange:

Set theMinActivity = myFilter.getMinimumActivity(myRange)
Parameters

i_range_id (str) –

Returns

bool

get_minimum_angle(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMinimumAngle(CATBSTR iRangeId) As Angle
Parameters

i_range_id (str) –

Returns

Angle

get_minimum_length(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMinimumLength(CATBSTR iRangeId) As Length
Parameters

i_range_id (str) –

Returns

Length

get_minimum_value(i_range_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func getMinimumValue(CATBSTR iRangeId) As double

Returns the minimum or maximum value of the filter for the given range id,
if defined and active.

Parameters:

iRangeId
The identificator of the range on which the minimum/maximum should
be read - if iRangeId is empty or equal to “Default”, takes the default range
as defined by the filter (“RibbonRadius” for FilletFilter, “MainDiameter” for
HoleFilter) - else iRangeId should be chosen among: *
{“RibbonRadius”,”RibbonAngle”,”RibbonLength”} for FilletFilter *
{“MainDiameter”} for HoleFilter * any defined and supported range id in case of
a user-defined filter

Returns:
oValue The filter minimum/maximum value for the specified range if
defined and active ELSE the method FAILS (to avoid this,
getMinimumValueActivity/getMaximumValueActivity can be called prior to calling
getMinimumValue/getMaximumValue) Signature with double works for angles as well
as for lengths / EXPRESSED in MODEL UNIT (mm/deg) Signatures with CATIALength
or CATIAAngle must be used with care and will fail if the range nature and the
expected type are incompatible

Example:
The following example returns in theMinValue the minimum value of
filter myFilter for the range myRange:

theMinValue = myFilter.getMinimumValue(myRange)

The following example returns in theMinAngle the minimum value as
an angle of filter myFilter for the range myRange:

Set theMinAngle = myFilter.getMinimumAngle(myRange)

The following example returns in theMaxLength the maximum value as
a length of filter myFilter for the range myRange:

Set theMaxLength = myFilter.getMaximumLength(myRange)
Parameters

i_range_id (str) –

Returns

float

set_maximum_activity(i_range_id, i_value)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub setMaximumActivity(CATBSTR iRangeId,
boolean iValue)
Parameters
  • i_range_id (str) –

  • i_value (bool) –

Returns

None

set_maximum_value(i_range_id, i_value)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub setMaximumValue(CATBSTR iRangeId,
double iValue)
Parameters
  • i_range_id (str) –

  • i_value (float) –

Returns

None

set_minimum_activity(i_range_id, i_value)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub setMinimumActivity(CATBSTR iRangeId,
boolean iValue)

Sets the defeaturing minimum or maximum value activity of the filter for
the given range id.

Parameters:

iRangeId
The identificator of the range on which the minimum/maximum should
be read - if iRangeId is empty or equal to “Default”, takes the default range
as defined by the filter (“RibbonRadius” for FilletFilter, “MainDiameter” for
HoleFilter) - else iRangeId should be chosen among: *
{“RibbonRadius”,”RibbonAngle”,”RibbonLength”} for FilletFilter *
{“MainDiameter”} for HoleFilter * any defined and supported range id in case of
a user-defined filter
iValue
The filter minimum/maximum activity for the specified
range

Example:
The two following examples set theMaxActivity as the maximum
value activity of filter myFilter for the range
myRange:

Call myFilter.setMaximumActivity(myRange,theMaxActivity)
myFilter.setMaximumActivity myRange
theMaxActivity
Parameters
  • i_range_id (str) –

  • i_value (bool) –

Returns

None

set_minimum_value(i_range_id, i_value)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub setMinimumValue(CATBSTR iRangeId,
double iValue)

Sets the minimum or maximum value of the filter for the given range id.
Forces the activation of the minimum or maximum value if not the case
yet.

Parameters:

iRangeId
The identificator of the range on which the minimum/maximum should
be read - if iRangeId is empty or equal to “Default”, takes the default range
as defined by the filter (“RibbonRadius” for FilletFilter, “MainDiameter” for
HoleFilter) - else iRangeId should be chosen among: *
{“RibbonRadius”,”RibbonAngle”,”RibbonLength”} for FilletFilter *
{“MainDiameter”} for HoleFilter * any defined and supported range id in case of
a user-defined filter
iValue
The filter minimum/maximum value for the specified range / MUST BE
EXPRESSED in MODEL UNIT (mm/deg) iValue must be consistent with the other value
if defined and active - new minimum iValue must be smaller than existing active
maximum value if any - new maximum iValue must be larger than existing active
minimum value if any ELSE the method FAILS

Example:
The two following examples set theMaxValue as the maximum value
of filter myFilter for the range myRange:

Call
myFilter.setMaximumValue(myRange,theMaxValue)
myFilter.setMaximumValue myRange theMaxValue
Parameters
  • i_range_id (str) –

  • i_value (float) –

Returns

None

defeaturing_filters

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing_filters.DefeaturingFilters(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.Collection
DefeaturingFilters

Represents the filter collection of a defeaturing object.
add(i_filter_type_to_add)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func Add(CATBSTR iFilterTypeToAdd) As long

Creates a new filter and adds it to the Defeaturing filters
collection.

Parameters:

iFilterTypeToAdd
The type of the new filter to add among : - “DefeaturingFilletFilter” -
“DefeaturingHoleFilter” - or any user-defined filter’s type

Returns:
oAddedFilterIndex The added filter’s index - equals to 0 if
FAILED

Example:
The following example adds a new filter of type theFilterType to
defeaturing colelction firstDefeaturingFilters and returns the index theIndex
of the new filter

Set theIndex = firstDefeaturingFilters.Add(theFilterType)
Parameters

i_filter_type_to_add (str) –

Returns

int

item(i_filter_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func Item(CATVariant iFilterId) As DefeaturingFilter

Returns the filter of the Defeaturing filters collection using its index or
its name.

Parameters:

iFilterId
The index or the name of the filter to retrieve As a numerics, must
be in [1;Count])

Returns:
oFilter The filter (see DefeaturingFilter for list of possible
actions)

Example:
The following example returns in myFilter the filter number
theIndex of Defeaturing collection
firstDefeaturingFilters:

Set myFilter = firstDefeaturingFilters.Item(theIndex)
Parameters

i_filter_id (CATVariant) –

Returns

DefeaturingFilter

remove(i_filter_id)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub Remove(CATVariant iFilterId)

Removes a filter from the Defeaturing filters collection and deletes it,
using its index or its name.

Parameters:

iFilterId
The index or the name of the filter to retrieve As a numerics, must
be in [1;Count])

Example:
The two following examples remove the filter number theIndex
from Defeaturing collection
firstDefeaturingFilters:

Call firstDefeaturingFilters.Remove(theIndex)
firstDefeaturingFilters.Remove theIndex
Parameters

i_filter_id (CATVariant) –

Returns

None

defeaturing_hole_filter

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.defeaturing_hole_filter.DefeaturingHoleFilter(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.DefeaturingFilter
PartInterfaces.DefeaturingFilterWithRange
DefeaturingHoleFilter

Represents the defeaturing hole filter.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

draft

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.draft.Draft(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Draft

Represents the draft shape.
A draft shape is made up of draft domains (at least one) and of a parting
element.
property draft_domains

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property DraftDomains() As DraftDomains (Read Only)

Returns the collection of draft domains.

Example:
The following example returns in list the collection of draft domains
of the firstDraft draft:

Set list = firstDraft.DraftDomains
Returns

DraftDomains

property mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Mode() As CatDraftMode

Returns or sets the draft mode.

Example:
The following example returns in mode the draft mode of the firstDraft
draft, and then sets it to
CatReflectKeepFaceDraftMode:

Set mode = firstDraft.Mode
Set firstDraft.Mode = CatReflectKeepFaceDraftMode
Returns

enum cat_draft_mode

property parting_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PartingElement() As Reference

Returns or sets the draft parting element.
To set the property, you can use the following Boundary object:
PlanarFace.

Example:
The following example returns in element the parting element of the
firstDraft draft, and then sets it to the element2 geometrical
element:

Set element = firstDraft.PartingElement
Set firstDraft.PartingElement = element2
Returns

Reference

draft_domain

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.draft_domain.DraftDomain(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
DraftDomain

Represents the draft domain.
A draft domain is a basic object used by a draft shape. It contains objects
such as an angle, a pulling direction, and a collection of faces to be
drafted.
add_face_to_draft(i_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToDraft(Reference iFace)

Adds a face to those to be drafted.

Parameters:

iFace
The face to add to those to be drafted
The following

Boundary object is supported: ScFace.

Example:
The following example adds the face NewFaceToDraft to the draft domain
CurrentDraftDomain:

CurrentDraftDomain.AddFaceToDraft(NewFaceToDraft)
Parameters

i_face (Reference) –

Returns

None

property draft_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property DraftAngle() As Angle (Read Only)

Returns the draft angle.

Example:
The following example returns in angle the draft angle of the draft
domain firstDraftDomain:

Set angle = firstDraftDomain.DraftAngle
Returns

Angle

property faces_to_draft

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FacesToDraft() As References (Read Only)

Returns the faces to be drafted. They are returned as a collection of
reference geometric elements.

Example:
The following example returns the collection of faces to be drafted of
the draft domain firstDraftDomain in list:

Set list = firstDraftDomain.FacesToDraft
Returns

References

get_pulling_direction(io_pulling_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetPullingDirection(CATSafeArrayVariant
ioPullingDirection)

Returns the draft pulling direction. The pulling direction is returned as
an array containing the pulling direction vector components. Assume this array
is PullDir. It contains:

PullDir[0],PullDir[1],PullDir[2]
The X, Y, and Z pulling direction vector components

Example:
The following example returns in PullDir the pulling direction vector
components of the draft domain firstDraftDomain:

Set PullDir = firstDraftDomain.PullingDirection
Set x = PullDir[0]
Set y = PullDir[1]
Set z = PullDir[2]
Parameters

io_pulling_direction (tuple) –

Returns

None

property multiselection_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MultiselectionMode() As CatDraftMultiselectionMode

Changes the multiselection mode.

Parameters:

iMultiselectionMode.
The elements to be drafted can be selected explicitly
(CATNoneDraftMultiselectionMode) or can implicitly selected as neighbors of the
neutral face (CATMultiselectionByNeutralMode)

Example:
The following example returns in MultiselMode the
multiselection mode of the draft domain firstDraftDomain, and then sets it to
CATMultiselectionByNeutralMode

Set MultiselMode = firstDraftDomain.MultiselectionMode
firstDraftDomain.MultiselectionMode = CATMultiselectionByNeutralMode
Returns

enum cat_draft_multiselection_mode

property neutral_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NeutralElement() As Reference

Returns or sets the draft neutral element.
To set the property, you can use the following Boundary object:
PlanarFace.

Example:
The following example returns in neutral the neutral element of the
draft domain firstDraftDomain, and then sets it to
newNeutral:

Set neutral = firstDraftDomain.NeutralElement
firstDraftDomain.NeutralElement = newNeutral
Returns

Reference

property neutral_propagation_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NeutralPropagationMode() As
CatDraftNeutralPropagationMode

Returns or sets the neutral element propagation mode. This mode is used
when computing the needed neutral elements.

Example:
The following example returns in propMode the neutral propagation mode
of the draft domain firstDraftDomain, and then sets it to
CATSmoothDraftNeutralPropagationMode so that the neutral propagation will now
be smooth:

Set propMode = firstDraftDomain.NeutralPropagationMode
firstDraftDomain.NeutralPropagationMode = CATSmoothDraftNeutralPropagationMode
Returns

enum cat_draft_neutral_propagation_mode

property pulling_direction_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PullingDirectionElement() As Reference

Returns or sets the draft pulling direction element.
To set the property, you can use one of the following Boundary objects:
PlanarFace or RectilinearTriDimFeatEdge.

Example:
The following example returns in pullingdirection the pulling direction
element of the draft domain firstDraftDomain, and then sets it to
newPullingDirection:

Set pullingdirection = firstDraftDomain.NeutralElement
firstDraftDomain.PullingDirectionElement = newPullingDirection
Returns

Reference

remove_face_to_draft(i_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub RemoveFaceToDraft(Reference iFace)

Removes a face from those to be drafted.

Parameters:

iFace
The face to be removed from those to be drafted
The following

Boundary object is supported: Face.

Example:
The following example removes the face FaceToRemove from the draft domain
CurrentDraftDomain:

CurrentDraftDomain.RemoveFaceToDraft(FaceToRemove)
Parameters

i_face (Reference) –

Returns

None

set_pulling_direction(i_x, i_y, i_z)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetPullingDirection(double iX,
double iY,
double iZ)

Sets the draft pulling direction.

Parameters:

iX,iY,iZ
The X, Y, and Z pulling direction vector components


Example:
The following example sets the draft pulling direction of the draft
domain firstDraftDomain to the direction with the vector components 10, -5,
10:

firstDraftDomain.PullingDirection 10, -5, 10
Parameters
  • i_x (float) –

  • i_y (float) –

  • i_z (float) –

Returns

None

set_volume_support(i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetVolumeSupport(Reference iVolumeSupport)

Value the support of draft.

Parameters:

iVolumeSupport
Parameters

i_volume_support (Reference) –

Returns

None

draft_domains

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.draft_domains.DraftDomains(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.Collection
DraftDomains

The collection of draft domains used by the draft shape.
item(i_index)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func Item(CATVariant iIndex) As DraftDomain

Returns a draft domain using its index or its name from the DraftDomains
collection.

Parameters:

iIndex
The index or the name of the draft domain to retrieve from the
collection of draft domains. As a numerics, this index is the rank of the draft
domain in the collection. The index of the first draft domain in the collection
is 1, and the index of the last draft domain is Count. As a string, it is the
name you assigned to the draft domain using the

AnyObject.Name property.
Returns:
The retrieved draft domain

Example:
The following example returns in domain the third draft domain of
the firstDraftDomains collection:

Set domain = firstDraftDomains.Item(3)
Parameters

i_index (CATVariant) –

Returns

DraftDomain

dress_up_shape

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.dress_up_shape.DressUpShape(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
DressUpShape

Represents the shapes built with other shape sub-elements such as faces or
edges.
It is the base object for chamfers, drafts, fillets, scalings, shells, and
thickness objects.

See also:
Chamfer, Draft, Fillet, Scaling, Shell, Thickness

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

edge_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.edge_fillet.EdgeFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
PartInterfaces.Fillet
EdgeFillet

Represents the edges-based fillet shape.
It is the base object for constant radius edge fillets and variable radius edge
fillets.

See also:
ConstRadEdgeFillet, VarRadEdgeFillet
add_edge_to_keep(i_edge_to_keep)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddEdgeToKeep(Reference iEdgeToKeep)

Adds a new edge to keep by the filleting operation. The edge to keep is not
modified by the fillet.

Parameters:

iEdgeToKeep
The edge to keep by the filleting operation
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example adds the new edge edge to be kept from filleting by
the constant radius edge fillet firstCstEdgeFillet:

firstCstEdgeFillet.AddEdgeToKeep(edge)
Parameters

i_edge_to_keep (Reference) –

Returns

None

property edge_propagation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property EdgePropagation() As CatFilletEdgePropagation

Returns or sets the edge fillet propagation mode. This propagation mode is
used when computing the edges to be filleted.

Example:
The following example returns in mode the edge fillet propagation mode
of the firstEdgeFillet edge fillet, and then sets it to
CATMinimalFilletEdgePropagation, so that a minimum numbers of edges will be
filleted:

Set mode = firstEdgeFillet.EdgePropagation
Set firstEdgeFillet.EdgePropagation = CATMinimalFilletEdgePropagation
Returns

enum cat_fillet_edge_propagation

property edges_to_keep

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property EdgesToKeep() As References (Read Only)

Returns the collection of edges to keep by the edge
fillet.

Example:
The following example returns in edges the edges to keep of the
constant radius edge fillet firstCstEdgeFillet:

Set edges = firstCstEdgeFillet.EdgesToKeep
Returns

References

withdraw_edge_to_keep(i_edge_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawEdgeToKeep(Reference iEdgeToWithdraw)

Withdraws an edge from those kept by a filleting
operation.

Parameters:

iEdgeToWithdraw
The edge to withdraw
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example withdraws the edge edge from those kept from
filleting by the constant radius edge fillet
firstCstEdgeFillet:

firstCstEdgeFillet.WithdrawEdgeToKeep(edge)
Parameters

i_edge_to_withdraw (Reference) –

Returns

None

face_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.face_fillet.FaceFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
PartInterfaces.Fillet
FaceFillet

Represents the face fillet shape.
A face fillet shape is built between two faces with a fillet
radius.
property first_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstFace() As Reference

Returns or sets the first limiting face.
To set the property, you can use the following Boundary object:
Face.

Example:
The following example returns in face1 the first limiting face of the
face fillet firstFaceFillet, and then sets it to
NewFace1:

Set face1 = firstFaceFillet.FirstFace
firstFaceFillet.FirstFace = NewFace1
Returns

Reference

property radius

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Radius() As Length (Read Only)

Returns the face fillet radius.

Example:
The following example returns in radius the fillet radius of the face
fillet firstFaceFillet:

Set radius = firstFaceFillet.Radius
Returns

Length

property second_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondFace() As Reference

Returns or sets the second limiting face.
To set the property, you can use the following Boundary object:
Face.

Example:
The following example returns in face2 the second limiting face of the
face fillet firstFaceFillet, and then sets it to
NewFace2:

Set face2 = firstFaceFillet.SecondFace
firstFaceFillet.SecondFace = NewFace2
Returns

Reference

fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.fillet.Fillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Fillet

Represents the fillet shape.
It is the base object for face fillets and edge fillets.

See also:
FaceFillet, EdgeFillet
property fillet_boundary_relimitation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FilletBoundaryRelimitation() As
CatFilletBoundaryRelimitation

Returns or sets the fillet boundary relimitation mode. This boundary
relimitation mode is used when computing the fillet.

Example:
The following example returns in mode the fillet boundary relimitation
mode of the firstFillet fillet, and then sets it to
catMinimumFilletBoundaryRelimitation, so that the fillet expands up to the
limits of the smallest shell:

Set mode = firstFillet.FilletBoundaryRelimitation
Set FirstFillet.FilletBoundaryRelimitation = catMinimumFilletBoundaryRelimitation
Returns

enum cat_fillet_boundary_relimitation

property fillet_trim_support

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FilletTrimSupport() As CatFilletTrimSupport

Returns or sets the fillet Trim Support mode. This Trim Support mode is
used when computing the fillet.

Example:
The following example returns in mode the fillet Trim Support mode of
the firstFillet fillet, and then sets it to catMinimumFilletTrimSupport, so
that the fillet expands up to the limits of the smallest
shell:

Set mode = firstFillet.FilletTrimSupport
Set FirstFillet.FilletTrimSupport = catNoTrimFilletSupport
Returns

enum cat_fillet_trim_support

groove

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.groove.Groove(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Revolution
Groove

Represents the groove shape.
A groove is made up of a sketch, used as the groove profile, containing an
axis, used as the revolution axis, and two limiting angles around this axis.
This is a “negative” shape: it removes material from the body it belongs
to.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

hole

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.hole.Hole(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
Hole

Hole Feature in Part Design.
property anchor_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AnchorMode() As CatHoleAnchorMode

Returns the hole anchor mode.
This information is pertinent when hole type is Counterbored or
Counterdrilled only.

Returns:
oMode The hole anchor mode (see CatHoleAnchorMode for list of possible
types)

Example:
The following example returns in holeAnchorMode the anchor mode of
hole firstHole:

Set holeAnchorMode = firstHole.AnchorMode
Returns

enum cat_hole_anchor_mode

property bottom_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property BottomAngle() As Angle (Read Only)

Returns the hole bottom angle.
This call is valid when the hole bottom type is : VBottom.

Returns:
oBottomAngle An Angle object controlling the hole bottom angle (see
Angle for more information)

Example:
The following example returns in holeBottomAngle the bottom angle
of hole firstHole:

Set holeBottomAngle = firstHole.BottomAngle
Returns

Angle

property bottom_limit

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property BottomLimit() As Limit (Read Only)

Returns the bottom limit.
This call is valid when the hole bottom type is : BlindHole or ThruHole.

Returns:
oBottomLimit A Limit object controlling the hole bottom limit (see
Limit for more information)

Example:
The following example returns in holeBottomLimit the bottom limit
of hole firstHole:

Set holeBottomLimit = firstHole.BottomLimit
Returns

Limit

property bottom_type

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property BottomType() As CatHoleBottomType

Returns the hole bottom type.

Returns:
oBottomType The hole bottom type (see CatHoleBottomType for list of
possible types)

Example:
The following example returns in holeBottomType the bottom type of
hole firstHole:

Set holeBottomType = firstHole.BottomType
Returns

enum cat_hole_bottom_type

property counter_sunk_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CounterSunkMode() As CatCSHoleMode

Returns the mode of a countersunk hole .

Returns:
CSMode Value of the countersunk mode (see CatCSHoleMode for list of
possible types)

Example:
The following example returns in CSMode the CSMode of hole
firsthole:

Set CSMode = firsthole.CounterSunkMode
Returns

enum cat_cs_hole_mode

create_standard_thread_design_table(i_standard_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub CreateStandardThreadDesignTable(CatHoleThreadStandard
iStandardType)

Creates a Standard Thread design table .
This call is valid when the hole threading mode is : CATThreadedHoleThreading.

Parameters:

iStandardType
Standard type for thread (see

CatHoleThreadStandard for list of possible types)

Example:
The following example creates a standard table for MetricThinPitch
for hole firstHole:

firstHole.CreateStandardThreadDesignTable
catHoleMetricThinPitch
Parameters

i_standard_type (CatHoleThreadStandard) –

Returns

None

create_user_standard_design_table(i_standard_name, i_path)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub CreateUserStandardDesignTable(CATBSTR iStandardName,
CATBSTR iPath)

Creates a UserStandard Thread design table .
This call is valid when the hole threading mode is : CATThreadedHoleThreading.

Parameters:

iStandardName
Name of the UserStandard thread. iStandardName should be empty if
filepath is to be defined.
iPath
Path of the UserStandard file. iPath is empty if the filepath is
already defined through CATReffilesPath.

Example1:
The following example creates a standard table for UserStandard
for hole firstHole. The file path is already defined thru
CATReffilesPath:

firstHole.CreateUserStandardDesignTable
“UserStandard”,”“

Example2:
The following example creates a standard table for UserStandard
for hole firstHole when file path is not defined thru
CATReffilesPath:

firstHole.CreateUserStandardDesignTable
“”,”E://user//standard//UserStandard.txt”
Parameters
  • i_standard_name (str) –

  • i_path (str) –

Returns

None

property diameter

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Diameter() As Length (Read Only)

Returns the hole diameter.

Returns:
oDiameter A Length object controlling the hole diameter (see Length for
more information)

Example:
The following example returns in holeDiam the diameter of hole
firstHole:

Set holeDiam = firstHole.Diameter
Returns

Length

get_direction(io_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetDirection(CATSafeArrayVariant ioDirection)

Returns the hole direction with absolute coordinates.
It provides a safe array with 3 elements : X, Y, Z direction coordinates

Returns:
oDirection The direction coordinates

Example:
The following example returns in dirArray the direction coordinates
of hole firstHole:

Call firstHole.GetDirection dirArray
Set x = dirArray[1]
Set y = dirArray[2]
Set z = dirArray[3]
Parameters

io_direction (tuple) –

Returns

None

get_origin(io_origin)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetOrigin(CATSafeArrayVariant ioOrigin)

Returns the origin point which the hole is anchored to.
This point belongs to a tangent plane.

Returns:
oOrigin A Safe Array made up of 3 doubles : X, Y, Z - Hole origin point coordinates

Example:
The following example returns in coordArray the coordinates of hole
firstHole:

Call firstHole.GetOrigin coordArray
Set x = coordArray[1]
Set y = coordArray[2]
Set z = coordArray[3]
Parameters

io_origin (tuple) –

Returns

None

property head_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HeadAngle() As Angle (Read Only)

Returns the hole head angle.
This call is valid when the hole type is : Tapered or Counterdrilled or Countersunk.

Returns:
oHeadAngle An Angle object controlling the hole head angle (see Angle
for more information)

Example:
The following example returns in holeHeadAngle the head angle of
hole firstHole:

Set holeHeadAngle = firstHole.HeadAngle
Returns

Angle

property head_depth

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HeadDepth() As Length (Read Only)

Returns the hole head depth.
This call is valid when the hole type is : Counterbored or Counterdrilled or Countersunk.

Returns:
oHeadDepth A Length object controlling the hole head depth (see Length
for more information)

Example:
The following example returns in holeHeadDepth the head depth of
hole firstHole:

Set holeHeadDepth = firstHole.HeadDepth
Returns

Length

property head_diameter

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HeadDiameter() As Length (Read Only)

Returns the hole head diameter.
This call is valid when the hole type is : Counterbored or Counterdrilled.

Returns:
oHeadDiameter A Length object controlling the hole head diameter (see
Length for more information)

Example:
The following example returns in holeHeadDiam the head diameter of
hole firstHole:

Set holeHeadDiam = firstHole.HeadDiameter
Returns

Length

property hole_thread_description

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HoleThreadDescription() As StrParam (Read Only)

Returns the hole thread description parameter. This call is valid when the hole threading mode is:
CATThreadedHoleThreading.
This call is valid only when a standard/user design table
exists

Returns:
oThreadDescParam A Parameter object controlling the hole thread
description (see StrParam for more information)

Example:
The following example returns in holeThreadDescription the thread
description (M12 etc) of hole firstHole:

Set holeThreadDescription = firstHole.HoleThreadDescription
Returns

StrParam

reverse()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub Reverse()

Reverses the hole direction .

Example:
The following example reverses the current direction of hole
firstHole:

firstHole.Reverse()
Returns

None

set_direction(i_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetDirection(Reference iDirection)

Sets the hole associative direction.

Parameters:

iDirection
A Reference object to an edge or a line (see

Reference for more information)
The following Boundary objects are supported:
RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge and
RectilinearMonoDimFeatEdge.

Example:
The following example sets the support direction of hole firstHole
with holeDirRef direction reference :

firstHole.SetDirection holeDirref
Parameters

i_direction (Reference) –

Returns

None

set_origin(i_x, i_y, i_z)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetOrigin(double iX,
double iY,
double iZ)

Sets the origin point which the hole is anchored to.
If mandatory, the entry point will be projected onto a tangent
plane.

Parameters:

iX
Origin point x absolute coordinate
iY
Origin point y absolute coordinate
iZ
Origin point z absolute coordinate

Example:
The following example sets the coordinates of hole firstHole to
10., 20., -5. :

firstHole.SetOrigin 10., 20., 5.
Parameters
  • i_x (float) –

  • i_y (float) –

  • i_z (float) –

Returns

None

property thread_depth

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadDepth() As Length (Read Only)

Returns the hole thread depth.
This call is valid when the hole threading mode is : CATThreadedHoleThreading.

Returns:
oThreadDepth A Length object controlling the hole thread depth (see
Length for more information)

Example:
The following example returns in holeThreadDepth the thread depth
of hole firstHole:

Set holeThreadDepth = firstHole.ThreadDepth
Returns

Length

property thread_diameter

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadDiameter() As Length (Read Only)

Returns the hole thread diameter.
This call is valid when the hole threading mode is : CATThreadedHoleThreading.

Returns:
oThreadDiameter A Length object controlling the hole thread diameter
(see Length for more information)

Example:
The following example returns in holeThreadDiameter the thread
diameter of hole firstHole:

Set holeThreadDiameter = firstHole.ThreadDiameter
Returns

Length

property thread_pitch

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadPitch() As Length (Read Only)

Returns the hole thread pitch.
This call is valid when the hole threading mode is : CATThreadedHoleThreading.

Returns:
oThreadPitch A Length object controlling the hole thread pitch (see
Length for more information)

Example:
The following example returns in holeThreadPitch the thread pitch
of hole firstHole:

Set holeThreadPitch = firstHole.ThreadPitch
Returns

Length

property thread_side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadSide() As CatHoleThreadSide

Returns the hole thread side.

Returns:
oThreadSide The hole thread side (see CatHoleThreadSide for list of
possible sides)

Example:
The following example returns in holeThreadSide the thread side of
hole firstHole:

Set holeThreadSide = firstHole.ThreadSide
Returns

enum cat_hole_thread_side

property threading_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadingMode() As CatHoleThreadingMode

Returns the hole threading mode.

Returns:
oThreadingMode The hole threading mode (see CatHoleThreadingMode for
list of possible types)

Example:
The following example returns in holeThreadingMode the threading
mode of hole firstHole:

Set holeThreadingMode = firstHole.ThreadingMode
Returns

enum cat_hole_threading_mode

property type

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Type() As CatHoleType

Returns the hole type.

Returns:
oType The hole type (see CatHoleType for list of possible
types)

Example:
The following example returns in holeType the type of hole
firstHole:

Set holeType = firstHole.Type
Returns

enum cat_hole_type

intersect

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.intersect.Intersect(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.BooleanShape
Intersect

Represents the intersect boolean operation.
It is performed between a body and the current shape.

Example

The following example shows how to create a new shape by intersecting two
existing pads Pad1 and Pad2, created in two different bodies Body1 and Body2
respectively, using the existing shape factory named
shapeFactory.

‘ Make Pad1 the current shape
CATIA.ActiveDocument.Part.CurrentShape = Pad1
‘ Create the intersection between Pad1 and Body2
Set NewShape = shapeFactory.AddNewIntersect(Body2)


Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

limit

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.limit.Limit(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
Limit

Represents the limit of a prism or a hole shape.

See also:
Prism, Hole
property dimension

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Dimension() As Length (Read Only)

Returns or sets the limit dimension. This property is valid for the offset
limit mode only, that is when CatLimitMode is set to catOffsetLimit .
Returns

Length

property limit_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property LimitMode() As CatLimitMode

Returns or sets the limit mode.
Returns

enum cat_limit_mode

property limiting_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property LimitingElement() As Reference

Returns or sets the limiting element. This property is valid when the
limiting object is a surface or a plane, that is when CatLimitMode is set to
catUpToSurfaceLimit and catUpToPlaneLimit.
To set the property, you can use the following Boundary object: Face.
Returns

Reference

linear_repartition

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.linear_repartition.LinearRepartition(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.Repartition
LinearRepartition

Represents the linear repartition.
It is used by the rectangular and circular patterns. It is made up of a number
of times the shape is copied and of a spacing distance between two consecutive
copies of this shape along a direction. The number of times the shape is copied
is accessible using the Repartition.InstancesCount property.

See also:
RectPattern, CircPattern
property spacing

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Spacing() As Length (Read Only)

Returns the distance between two consecutive shapes along the repartition
direction.

Example:
The following example returns in space1 the spacing distance of the
linear repartition firstRepartition:

Set space1 = firstRepartition.Spacing
Returns

Length

loft

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.loft.Loft(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Loft

Loft feature.
Manipulation of solid Loft feature. Allows to access data of the Loft feature
created by the CATIAShapeFactory. This solid feature is created from an
underlying HybridShapeLoft aggregated by the Loft.

See also:
ShapeFactory
property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeLoft.

Example:
The following example explains how to retrieve the underlying
HybridShape Loft

Dim oHybridShape as AnyObject
Set oHybridShape=oLoft.HybridShape
oHybridShape.SectionCoupling = 2
Returns

HybridShape

mirror

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.mirror.Mirror(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
Mirror

Represents the mirror shape.
It duplicates a shape with respect to a planar mirroring element, such as a
planar face or a plane.
property mirroring_object

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MirroringObject() As AnyObject (Read Only)

Returns the mirroring Object.
Returns

AnyObject

property mirroring_plane

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MirroringPlane() As Reference

Returns or sets the mirroring reference plane. It can be a plane, or a
plane face.
To set the property, you can use the following Boundary object:
PlanarFace.

Example:
The following example returns in ref the mirroring reference plane of
the mirroring firstMirroring, and then sets it to the created
MyRef:

Set ref = firstMirroring.MirroringPlane
Set MyRef = part.CreateReferenceFromGeometry (plane)
firstMirroring.MirroringPlane = MyRef
Returns

Reference

pad

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.pad.Pad(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Prism
Pad

Represents the pad shape.
A pad is created by extruding a profile represented by a sketch in one or two
opposite directions. It is a “positive” shape: it adds material to the body it
belongs to.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

pattern

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.pattern.Pattern(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
Pattern

Represents the pattern shape.
It is the base object for rectangular and circular patterns. A pattern shape is
a set of copies of the same shape. The copy is done according to linear and
angular repartitions.

See also:
CircPattern, RectPattern, Repartition, LinearRepartition,
AngularRepartition
activate_position(i_pos_u, i_pos_v)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub ActivatePosition(long iPosU,
long iPosV)

Allows user to activate an instance of the pattern.

Parameters:

iPosU
The position of the instance in the U direction
iPosV
The position of the instance in the V direction
Parameters
  • i_pos_u (int) –

  • i_pos_v (int) –

Returns

None

desactivate_position(i_pos_u, i_pos_v)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub DesactivatePosition(long iPosU,
long iPosV)

Allows user to desactivate an instance of the pattern.

Parameters:

iPosU
The position of the instance in the U direction
iPosV
The position of the instance in the V direction
Parameters
  • i_pos_u (int) –

  • i_pos_v (int) –

Returns

None

property item_to_copy

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ItemToCopy() As AnyObject

Returns or sets the shape to be copied.

Example:
The following example returns in shape the copied shape of the pattern
firstPattern, and then sets it to pad1:

Set shape = firstPattern.ItemToCopy
firstPattern.ItemToCopy = pad1
Returns

AnyObject

property rotation_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RotationAngle() As Angle (Read Only)

Returns the pattern global rotation angle. The rotation is applied to the
whole pattern, but not to the shapes themselves. The shape to be copied is used
as the rotation center.

Example:
The following example returns in globAng the rotation of pattern
firstPattern:

Set globAng = firstPattern.RotationAngle
Returns

Angle

pocket

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.pocket.Pocket(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Prism
Pocket

Represents the pocket shape.
A pocket is created by extruding a profile represented by a sketch in one or
two opposite directions. It is a “negative” shape: it removes material from the
body it belongs to. The sketch is usually drawn on another shape
face.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

prism

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.prism.Prism(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
Prism

Prism-based features in Part Design : base for pad or pocket.
property direction_orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property DirectionOrientation() As CatPrismOrientation

Returns the prism direction orientation.

Returns:
oOrientation The direction orientation (see CatPrismOrientation for
list of possible types)

Example:
The following example saves in dirOrientation the direction
orientation of prism firstPrism, and then sets it so that the direction will be
now inversed :

Set dirOrientation = firstPrism.DirectionOrientation
firstPrism.DirectionOrientation = catInverseOrientation
Returns

enum cat_prism_orientation

property direction_type

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property DirectionType() As CatPrismExtrusionDirection

Returns the prism direction type.

Returns:
oDirType The direction type (see CatPrismExtrusionDirection for list of
possible types)

Example:
The following example saves in dirType the direction type of prism
firstPrism, and then sets it so that the direction will be now normal to the
sketch :

Set dirType = firstPrism.DirectionType
firstPrism.DirectionType = catNormalToSketchDirection
Returns

enum cat_prism_extrusion_direction

property first_limit

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstLimit() As Limit (Read Only)

Returns the first prism limit (one of the two).
This limit manages the way the prism is ended.

Returns:
oFirstLimit The first limit (see Limit for more
information)

Example:
The following example returns in firstLimit the first limit of
prism firstPrism:

Set firstLimit = firstPrism.FirstLimit
Returns

Limit

get_direction(io_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetDirection(CATSafeArrayVariant ioDirection)

Returns the prism direction with absolute coordinates.
It needs a safe array with 3 elements : X, Y, Z direction coordinates The array must be
previously initialized

Returns:
ioDirection The direction coordinates

Example:
The following example returns in dirArray the direction coordinates
of prism firstPrism:

Dim dirArray(2)
Call firstPrism.GetDirection(dirArray)
Set x = dirArray[1]
Set y = dirArray[2]
Set z = dirArray[3]
Parameters

io_direction (tuple) –

Returns

None

property is_symmetric

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsSymmetric() As boolean

Returns the prism symmetry flag.
It returns TRUE if the prism is symmetric (from the base sketch), FALSE if
not.

Returns:
oIsSymmetric The symmetry flag as a boolean

Example:
The following example saves in symFlag the symmetry flag of prism
firstPrism, and then sets it so that it will be now symmetric (from the base
sketch) :

Set symFlag = firstPrism.IsSymmetric
firstPrism.IsSymmetric = TRUE
Returns

bool

property is_thin

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsThin() As boolean

Returns the prism thin flag.
It returns TRUE if the prism is a thin prism , FALSE if
not.

Returns:
oIsThin The thin flag as a boolean

Example:
The following example saves in thinFlag the thin flag of prism
firstPrism, and then sets it so that it will be now thin
:

Set thinFlag = firstPrism.IsThin
firstPrism.IsThin = TRUE
Returns

bool

property merge_end

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MergeEnd() As boolean

Returns the prism merge end flag (for thin prism only).
It returns TRUE if merge ends is required , FALSE if not.

Returns:
oIsMergeEnd The merge end flag as a boolean

Example:
The following example saves in MergeEndFlag the merge end flag of
prism firstPrism, and then sets it so that merge end will be required
:

Set MergeEndFlag = firstPrism.IsMergeEnd
firstPrism.IsMergeEnd = TRUE
Returns

bool

property neutral_fiber

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NeutralFiber() As boolean

Returns the prism neutral fiber flag (for thin prism
only).
It returns TRUE if the prism is a neutral fiber prism , FALSE if
not.

Returns:
oIsNeutralFiber The neutral fiber flag as a boolean

Example:
The following example saves in NeutralFiberFlag the neutral fiber
flag of prism firstPrism, and then sets it so that it will be now neutral fiber
:

Set NeutralFiberFlag = firstPrism.IsNeutralFiber
firstPrism.IsNeutralFiber = TRUE
Returns

bool

reverse_inner_side()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub ReverseInnerSide()

Reverses the prism inner side when the profile is open. This is useful for
finding the shape to reach.

Example:
The following example reverses the current inner side of prism
firstPrism :

firstPrism.ReverseInnerSide
Returns

None

property second_limit

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondLimit() As Limit (Read Only)

Returns the second prism limit (one of the two).
This limit manages the way the prism is ended.

Returns:
oSecondLimit The second limit (see Limit for more
information)

Example:
The following example returns in secondLimit the second limit of
prism firstPrism:

Set secondLimit = firstPrism.SecondLimit
Returns

Limit

set_direction(i_line)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetDirection(Reference iLine)

Sets the prism associative direction.

Parameters:

iLine
The support direction reference (see

Reference for more information)
This reference can be valuated with a reference to a line or an
edge.
The following Boundary objects are supported: PlanarFace,
RectilinearTriDimFeatEdge and
RectilinearBiDimFeatEdge.

Example:
The following example sets the prism direction reference of prism
firstPrism with prismDirRef line :

firstPrism.SetDirection prismDirRef
Parameters

i_line (Reference) –

Returns

None

rect_pattern

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.rect_pattern.RectPattern(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
PartInterfaces.Pattern
RectPattern

Represents the rectangular pattern.
The shape is copied along two directions. Two linear repartitions control the
shape copy.

See also:
LinearRepartition
property first_direction_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstDirectionRepartition() As LinearRepartition (Read
Only)

Returns the linear repartition along the first direction.

Example:
The following example returns in repart1 the first linear repartition
of the rectangular pattern firstPattern:

Set repart1 = firstPattern.FirstDirectionRepartition
Returns

LinearRepartition

property first_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the first linear
direction.

Example:
The following example returns in FirstDirPos the position of the shape
to be copied along the first linear direction in the rectangular pattern
firstPattern:

Set FirstDirPos = firstPattern.FirstDirectionRow
Returns

IntParam

property first_orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstOrientation() As boolean

Returns or sets whether the pattern is built towards the first direction
orientation.
True if the pattern is built towards the first direction
orientation.

Example:
The following example returns in aligned1 whether the rectangular
pattern firstPattern is built towards the first direction orientation, and then
sets its to True:

Set aligned1 = firstPattern.FirstOrientation
firstPattern.FirstOrientation = True
Returns

bool

property first_rectangular_pattern_parameters

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstRectangularPatternParameters() As
CatRectangularPatternParameters

Returns or sets the rectangular pattern parameters required to define the
pattern. These parameters are used when reading the CATIALinearRepartition
properties.

Example:
The following example returns in parameters the rectangular pattern
parameters of the firstPattern rectangular pattern, and then sets it to
catUnequalSpacing, so that the unqual spacing will be defined in first
direction:

Set parameters = firstPattern.FirstCircularPatternParameters
Set firstPattern.FirstCircularPatternParameters = catUnequalSpacing
Returns

enum cat_rectangular_pattern_parameters

get_first_direction(io_first_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetFirstDirection(CATSafeArrayVariant
ioFirstDirection)

Returns the first repartition direction. The first repartition direction is
returned as an array containing the direction vector components. Assume this
array is o1stDirRep. It contains:

o1stDirRep[0],o1stDirRep[1],o1stDirRep[2]
The X, Y, and Z direction vector components

Example:
The following example returns in FirstDir the first repartition
direction vector components of the rectangular pattern firstPattern and saves
them in variables:

Dim FirstDir()
Call firstPattern.GetFirstDirection(FirstDir)
x = FirstDir(0)
y = FirstDir(1)
z = FirstDir(2)
Parameters

io_first_direction (tuple) –

Returns

None

get_second_direction(io_second_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub GetSecondDirection(CATSafeArrayVariant
ioSecondDirection)

Returns the second repartition direction. The second repartition direction
is returned as an array containing the direction vector components. Assume this
array is o2ndDirRep. It contains:

o2ndDirRep[0],o2ndDirRep[1],o2ndDirRep[2]
The X, Y, and Z direction vector components

Example:
The following example returns in SecondDir the second repartition
direction vector components of the rectangular pattern firstPattern and saves
them in variables:

Call firstPattern.GetSecondDirection(SecondDir)
x = SecondDir[0]
y = SecondDir[1]
z = SecondDir[2]
Parameters

io_second_direction (tuple) –

Returns

None

property second_direction_repartition

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondDirectionRepartition() As LinearRepartition (Read
Only)

Returns the linear repartition along the second direction.

Example:
The following example returns in repart2 the second linear repartition
of the rectangular pattern firstPattern:

Set repart2 = firstPattern.SecondDirectionRepartition
Returns

LinearRepartition

property second_direction_row

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondDirectionRow() As IntParam (Read Only)

Returns the position of the shape to be copied along the second linear
direction.

Example:
The following example returns in SecondDirPos the position of the shape
to be copied along the second linear direction in the rectangular pattern
firstPattern:

Set SecondDirPos = firstPattern.SecondDirectionRow
Returns

IntParam

property second_orientation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondOrientation() As boolean

Returns or sets whether the pattern is built towards the second direction
orientation.
True if the pattern is built towards the second direction
orientation.

Example:
The following example returns in aligned2 whether the rectangular
pattern firstPattern is built towards the second direction orientation, and
then sets its to False, meaning the pattern is built in the opposite
direction:

Set aligned2 = firstPattern.SecondOrientation
firstPattern.SecondOrientation = False
Returns

bool

property second_rectangular_pattern_parameters

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondRectangularPatternParameters() As
CatRectangularPatternParameters

Returns or sets the rectangular pattern parameters required to define the
pattern. These parameters are used when reading the CATIALinearRepartition
properties.

Example:
The following example returns in parameters the rectangular pattern
parameters of the secondPattern rectangular pattern, and then sets it to
catUnequalSpacing, so that the unqual spacing will be defined in second
direction:

Set parameters = secondPattern.SecondCircularPatternParameters
Set secondPattern.SecondCircularPatternParameters = catUnequalSpacing
Returns

enum cat_rectangular_pattern_parameters

set_first_direction(i_first_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetFirstDirection(Reference iFirstDirection)

Sets the first repartition direction.

Parameters:

iFirstDirection
The first repartition direction. It is passed as a


Reference and can be valuated with a reference to a line or an
edge.
The following Boundary objects are supported: PlanarFace,
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.


Example:
The following example sets the first repartition direction of the
rectangular pattern firstPattern with the refToLine1 reference
:

firstPattern.SetFirstDirection refToLine1
Parameters

i_first_direction (Reference) –

Returns

None

set_instance_spacing(i_instance_number, i_spacing, i_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetInstanceSpacing(long iInstanceNumber,
double iSpacing,
long iDirection)

Sets the InstanceSpacing.

Parameters:

iInstanceNumber
The Instance Number
iSpacing
The Spacing
iDirection
The Instance direction

Example:
The following example sets the InstanceSpacing in a direction for
unequal spacing
Parameters
  • i_instance_number (int) –

  • i_spacing (float) –

  • i_direction (int) –

Returns

None

set_second_direction(i_second_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetSecondDirection(Reference iSecondDirection)

Sets the second repartition direction.

Parameters:

iSecondDirection
The second repartition direction. It is passed as a


Reference and can be valuated with a reference to a line or an
edge.
The following Boundary objects are supported: PlanarFace,
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.


Example:
The following example sets the second repartition direction of the
rectangular pattern firstPattern with the refToLine2 reference
:

firstPattern.SetSecondDirection refToLine2
Parameters

i_second_direction (Reference) –

Returns

None

set_unequal_instance_number(i_instance_number, i_direction)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetUnequalInstanceNumber(long iInstanceNumber,
long iDirection)

Sets the Instance Number.

Parameters:

iInstanceNumber
The Instance Number
iDirection
The Instance direction

Example:
The following example modifies the instance number for unequal spacing
Parameters
  • i_instance_number (int) –

  • i_direction (int) –

Returns

None

remove

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.remove.Remove(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.BooleanShape
Remove

Represents the remove, or substract boolean operation.
It is performed between a body and the current shape.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

remove_face

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.remove_face.RemoveFace(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
RemoveFace

Represents the Remove Face operation.
It removes a face or a set of faces.
property keep_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property KeepFace(Reference iKeepFace) (Write Only)

Adds a new face to be Kept.

Parameters:

iKeepFace
The new face to process
The following

Boundary object is supported: Face.
Returns

False

property keep_faces

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property KeepFaces() As References (Read Only)

Get the specified faces to be kept.
Returns

References

property propagation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Propagation() As References (Read Only)

Get the faces that will be removed.
Returns

References

property remove_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RemoveFace(Reference iRemoveFace) (Write Only)

Adds a new face to be removed.

Parameters:

iRemoveFace
The new face to process
The following

Boundary object is supported: Face.
Returns

False

property remove_faces

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RemoveFaces() As References (Read Only)

Get the specified faces to be removed.
Returns

References

remove_keep_face(i_keep_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub remove_KeepFace(Reference iKeepFace)

Removes a face to be Kept.

Parameters:

iKeepFace
The new face to process
The following

Boundary object is supported: Face.
Parameters

i_keep_face (Reference) –

Returns

None

remove_remove_face(i_remove_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub remove_RemoveFace(Reference iRemoveFace)

Removes a face to be removed.

Parameters:

iRemoveFace
The new face to process
The following

Boundary object is supported: Face.
Parameters

i_remove_face (Reference) –

Returns

None

repartition

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.repartition.Repartition(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
Repartition

Represents the repartition.
A repartition is a set of objects used by the pattern shapes. It is the base
object for linear and angular repartitions.

See also:
LinearRepartition, AngularRepartition
property instances_count

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property InstancesCount() As IntParam (Read Only)

Returns the total number of copied shapes.

Example:
The following example returns in Nb the number of shapes of the
repartition firstRepartition:

Set Nb = firstRepartition.InstancesCount
Returns

IntParam

replace_face

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.replace_face.ReplaceFace(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SurfaceBasedShape
ReplaceFace

Represents the Replace Face operation.
It replaces a face or a set of faces obtained by tangency continuity by a
replacing element, such as a surface or a face or a skin.
add_remove_face(i_remove_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddRemoveFace(Reference iRemoveFace)

Sets the face to be removed.
Parameters

i_remove_face (Reference) –

Returns

None

add_split_plane(i_split_plane)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddSplitPlane(Reference iSplitPlane)

Sets the replacing element.
Parameters

i_split_plane (Reference) –

Returns

None

delete_remove_face(i_remove_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub DeleteRemoveFace(Reference iRemoveFace)

Remove the face to be removed.
Parameters

i_remove_face (Reference) –

Returns

None

property remove_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RemoveFace() As References (Read Only)

Returns the face to be removed.
Returns

References

property splitting_side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SplittingSide() As CatSplitSide

Returns or sets the splitting side . The splitting side is the side of the
body kept after the splitting. A positive side refers to the same orientation
than the splitting element normal vector.
Returns

enum cat_split_side

revolution

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.revolution.Revolution(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
Revolution

Represents the revolution-based shapes.
It is the base objects for shaft and grooves.

See also:
Shaft, Groove
property first_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstAngle() As Angle (Read Only)

Returns the revolution first angle. This angle is computed around the
revolution axis, starting from the sketch plane trace on the plane
perpendicular to the revolution axis, and is counted positive clockwise when
looking at this plane in the revolution axis direction.

Example:
The following example returns in firstAngle the first angle of the
MyRevolution revolution object:

Set firstAngle = MyRevolution.FirstAngle
Returns

Angle

property is_thin

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsThin() As boolean

Returns the Revol thin flag.
It returns TRUE if the Revol is a thin Revol , FALSE if
not.

Returns:
oIsThin The thin flag as a boolean

Example:
The following example saves in thinFlag the thin flag of Revol
firstRevol, and then sets it so that it will be now thin
:

Set thinFlag = firstRevol.IsThin
firstRevol.IsThin = TRUE
Returns

bool

property merge_end

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MergeEnd() As boolean

Returns the Revol merge end flag (for thin Revol only).
It returns TRUE if merge ends is required , FALSE if not.

Returns:
oIsMergeEnd The merge end flag as a boolean

Example:
The following example saves in MergeEndFlag the merge end flag of
Revol firstRevol, and then sets it so that merge end will be required
:

Set MergeEndFlag = firstRevol.IsMergeEnd
firstRevol.IsMergeEnd = TRUE
Returns

bool

property neutral_fiber

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NeutralFiber() As boolean

Returns the Revol neutral fiber flag (for thin Revol
only).
It returns TRUE if the Revol is a neutral fiber Revol , FALSE if
not.

Returns:
oIsNeutralFiber The neutral fiber flag as a boolean

Example:
The following example saves in NeutralFiberFlag the neutral fiber
flag of Revol firstRevol, and then sets it so that it will be now neutral fiber
:

Set NeutralFiberFlag = firstRevol.IsNeutralFiber
firstRevol.IsNeutralFiber = TRUE
Returns

bool

property revolute_axis

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RevoluteAxis() As Reference

Returns or sets the rotation axis for Revol.
To set the property, you can use one of the following Boundary objects:
RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge or
RectilinearMonoDimFeatEdge.

Example: This example retrieves in RevoluteAxis the rotation axis for the Rotate axis of the
Revol feature
Dim RevoluteAxis As Reference
Set RevoluteAxis = Rotate.Axis
Returns

Reference

property second_angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondAngle() As Angle (Read Only)

Returns the revolution second angle. This angle is computed around the
revolution axis, starting from the sketch plane trace on the plane
perpendicular to the revolution axis, and is counted positive counterclockwise
when looking at this plane in the revolution axis direction. Its default value
is 0.

Example:
The following example returns in secondAngle the second angle of the
MyRevolution revolution object:

Set secondAngle = MyRevolution.SecondAngle
Returns

Angle

rib

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.rib.Rib(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Sweep
Rib

Represents the rib shape.
The rib shape is made up of a profile represented by a sketch swept along a
center curve represented by another sketch. This is a “positive” shape: it adds
material to the body it belongs to.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

rotate

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.rotate.Rotate(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Rotate

Represents the shape rotate feature object.
This solid feature is created from an underlying HybridShapeRotate aggregated
by the Rotate. Role: To access the data of the hybrid shape rotate feature
object. This data includes:

The element to be rotated
The rotation axis
The angle and its value

Use the CATIAShapeFactory to create ShapeFeature object.

See also:
ShapeFactory
property angle

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Angle() As Angle (Read Only)

Returns the rotation angle.
Returns

Angle

property angle_value

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AngleValue() As double

Returns or sets the rotation angle value.

Example: This example retrieves in AngleValue the angle value for the
Rotate hybrid shape feature.

Dim AngleValue As double
Set AngleValue = Rotate.AngleValue
Returns

float

property axis

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Axis() As Reference

Returns or sets the rotation axis.
To set the property, you can use one of the following Boundary objects:
RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge or
RectilinearMonoDimFeatEdge.

Example: This example retrieves in RotationAxis the rotation axis for the
Rotate hybrid shape feature.

Dim RotationAxis As Reference
Set RotationAxis = Rotate.Axis
Returns

Reference

property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeRotate.

Example:
The following example explains how to retrieve the underlying
HybridShape Rotate

Dim oHybridShape as AnyObject
Set oHybridShape=oRotate.HybridShape
oHybridShape.SectionCoupling = 2
Returns

HybridShape

scaling

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.scaling.Scaling(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Scaling

Represents the scaling shape.
The scaling shape is made up of a scaling reference element, such as a point,
and a scaling factor.
property factor

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Factor() As RealParam (Read Only)

Returns the scaling factor.

Example:
The following example returns in factor the scaling factor of the
scaling firstScaling:

Set factor = firstScaling.Factor
Returns

RealParam

property scaling_reference

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ScalingReference() As Reference

Returns or sets the scaling reference element. It can be a
point.
To set the property, you can use one of the following Boundary objects:
PlanarFace or Vertex.

Example:
The following example returns in ref the scaling reference element of
the scaling firstScaling, and then sets it to the created
MyRef:

Set ref = firstScaling.ScalingSupport
Set MyRef = part.CreateReferenceFromGeometry (Point)
firstScaling.ScalingSupport = MyRef
Returns

Reference

scaling2

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.scaling2.Scaling2(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Scaling2

Represents the Scaling2 feature object.
This solid feature is created from an underlying HybridShapeScaling aggregated
by the Scaling. Role: To access the data of the feature object. This data
includes:

The element to be transformed using the Scaling2
The reference element for the Scaling2 which is a point or a
plane
The ratio and its value

Use the CATIAShapeFactory to create Part object.

See also:
ShapeFactory
property center

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Center() As Reference

Returns or sets the reference element.This element can be a point or a
plane.
To set the property, you can use one of the following Boundary objects:
PlanarFace or Vertex.

Example:
This example retrieves in RefElem the reference element for the
Scaling2 hybrid shape feature.

Dim RefElem As Reference
Set RefElem = Scaling2.Center
Returns

Reference

property ratio

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Ratio() As RealParam (Read Only)

Returns the scaling ratio.
Returns

RealParam

property ratio_value

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property RatioValue() As double

Returns or sets the scaling ratio value.

Example:
This example retrieves in Value the ratio value for the Scaling hybrid
shape feature.

Dim Value As double
Set Value = Scaling2.RatioValue
Returns

float

sew_surface

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.sew_surface.SewSurface(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SurfaceBasedShape
SewSurface

Represents the sewing operation.
It sews a shape using a sewing element, such as a surface or a
face
property deviation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Deviation() As double

Sets or Gets the maximum deviation allowed for smoothing operation in
sewing command. This value must be set in SI unit (m).

Example: This example retrieves in DeviationValue the maximum deviation
value for the Sewfeature.

Dim DeviationValue As double
Set DeviationValue = Sew.MaximumDeviationValue
Returns

float

property deviation_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property DeviationMode() As long

Returns or sets the Deviation mode taken into account during Sew
construction.
Legal values:

0
Unknown Deviation mode.
1
None Deviation mode. Error thrown if maximum deviation exceeds CATIA
resolution.
2
Automatic Deviation mode. Error thrown if maximum deviation exceeds 100
times CATIA resolution.
3
Manual Deviation mode. Error thrown if maximum deviation exceeds input
user deviation.

Example:
This example retrieves in oMode the Deviation mode for the Sew
feature.

Dim oMode
Set oMode = Sew.DeviationMode
Returns

int

set_surface_support(i_support_surface)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetSurfaceSupport(Reference iSupportSurface)

Sets the surface support for surfacic sew surface.

Parameters:

iSupportSurface
A Reference object to a surface (see

Reference for more information)
Parameters

i_support_surface (Reference) –

Returns

None

set_volume_support(i_volume)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetVolumeSupport(Reference iVolume)

Sets the volume support for volume sew surface.

Parameters:

iVolume
A Reference object to a volume (see

Reference for more information)

Example:
The following example sets the volume support of SewSurface
firstSewSurface to volumeExtrude volume reference
:

firstSewSurface.SetVolumeSupport volumeExtrudeRef
Parameters

i_volume (Reference) –

Returns

None

property sewing_intersection_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SewingIntersectionMode() As
CatSewingIntersectionMode

Returns or sets the sewing mode . The sewing side is the side of the body
kept after the sewing. A positive side refers to the same orientation than the
sewing element normal vector.

Example:
The following example returns in sptSide the sewing side of the sew
shape mySew, and then sets it to catPositiveSide:

Set sptSide = mySew.SewingSide
mySew.SewingSide = catPositiveSide
Returns

enum cat_sewing_intersection_mode

property sewing_side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SewingSide() As CatSplitSide

Returns or sets the sewing side . The sewing side is the side of the body
kept after the sewing. A positive side refers to the same orientation than the
sewing element normal vector.

Example:
The following example returns in sptSide the sewing side of the sew
shape mySew, and then sets it to catPositiveSide:

Set sptSide = mySew.SewingSide
mySew.SewingSide = catPositiveSide
Returns

enum cat_split_side

shaft

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.shaft.Shaft(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Revolution
Shaft

Represents the shaft shape.
A shaft is made up of a sketch, used as the shaft profile, and containing an
axis, used as the revolution axis, and two limiting angles around this axis.
This is a “positive” shape: it adds material to the body it belongs
to.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

shape_factory

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.shape_factory.ShapeFactory(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Factory
ShapeFactory

Represents the factory for shapes to create all kinds of shapes that may be
needed for part design.

The Shapefactory mission is to build from scratch shapes that will be used
within the design process of parts. Those shapes have a strong mechanical
built-in knowledge, such as chamfer or hole, and in most cases apply
contextually to the part being designed. When created, they become part of the
definition of whichever body or shape that is current at that time. After they
are created, they become in turn the current body or shape. In most cases,
shapes are created from a factory with a minimum number of parametersr. Other
shapes parameters may be set further on by using methods offered by the shape
itself.
add_new_add(i_body_to_add)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAdd(Body iBodyToAdd) As Add

Creates and returns a new add operation within the current
body.

Parameters:

iBodyToAdd
The body to add to the current body

Returns:
The created add operation
Parameters

i_body_to_add (Body) –

Returns

Add

add_new_affinity2(x_ratio, y_ratio, z_ratio)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAffinity2(double XRatio,
double YRatio,
double ZRatio) As AnyObject

Creates and returns a Affinity feature.

Parameters:

XRatio
Value for the XRatio.
YRatio
Value for the YRatio.
ZRatio
Value for the ZRatio.

Returns:
the created Affinity feature.
Parameters
  • x_ratio (float) –

  • y_ratio (float) –

  • z_ratio (float) –

Returns

AnyObject

add_new_assemble(i_body_to_assemble)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAssemble(Body iBodyToAssemble) As Assemble

Creates and returns a new assembly operation within the current
body.

Parameters:

iBodyToAssemble
The body to assemble with the current body

Returns:
The created assembly operation
Parameters

i_body_to_assemble (Body) –

Returns

Assemble

add_new_auto_draft(i_draft_angle)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAutoDraft(double iDraftAngle) As AutoDraft

Creates and returns a new solid autodraft.
Use this method to create autodraft by providing draft
angle.

Parameters:

iDraftAngle
The draft angle.

Returns:
The created autodraft.
Parameters

i_draft_angle (float) –

Returns

AutoDraft

add_new_auto_fillet(i_fillet_radius, i_round_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAutoFillet(double iFilletRadius,
double iRoundRadius) As AutoFillet

Creates and returns a new solid autofillet.
Use this method to create autofillet by providing fillet and round radius
values.

Parameters:

iFilletRadius
The fillet radius
iRoundRadius
The round radius

Returns:
The created autofillet
Parameters
  • i_fillet_radius (float) –

  • i_round_radius (float) –

Returns

AutoFillet

add_new_axis_to_axis2(i_reference, i_target)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewAxisToAxis2(Reference iReference,
Reference iTarget) As AnyObject

Creates and returns an AxisToAxis transformation feature.

Parameters:

iReference
The reference axis.
iTarget
The target axis.

Returns:
The created AxisToAxis transformation feature.
Parameters
Returns

AnyObject

add_new_blend()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewBlend() As AnyObject

Creates and returns a new Blend feature.

Returns:
The created Blend feature
Returns

AnyObject

add_new_chamfer(i_object_to_chamfer, i_propagation, i_mode, i_orientation, i_length1, i_length2_or_angle)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewChamfer(Reference iObjectToChamfer,
CatChamferPropagation iPropagation,
CatChamferMode iMode,
CatChamferOrientation iOrientation,
double iLength1,
double iLength2OrAngle) As Chamfer

Creates and returns a new chamfer within the current body.

Parameters:

iObjectToChamfer
The first edge or face to chamfer
The following

Boundary object is supported: TriDimFeatEdge.
iPropagation
Controls if and how the chamfering operation should propagate beyond
the first chamfer element iObjectToChamfer, when it is an edge

iMode
Controls if the chamfer is defined by two lengths, or by an angle and
a length
The value of this argument changes the way the arguments iLength1 and
iLength2OrAngle should be interpreted.
iOrientation
Defines the relative meaning of arguments iLength1 and iLength2OrAngle
when defining a chamfer by two lengths
iLength1
The first value for chamfer dimensioning. It represents the chamfer
first length if the chamfer is defined by two lengths, or the chamfer length
if the chamfer is defined by a length and an angle.
iLength2OrAngle
The second value for chamfer dimensioning. It represents the chamfer
second length if the chamfer is defined by two lengths, or the chamfer angle
if the chamfer is defined by a length and an angle.
Returns:
The created chamfer
Parameters
  • i_object_to_chamfer (Reference) –

  • i_propagation (CatChamferPropagation) –

  • i_mode (CatChamferMode) –

  • i_orientation (CatChamferOrientation) –

  • i_length1 (float) –

  • i_length2_or_angle (float) –

Returns

Chamfer

add_new_circ_pattern(i_shape_to_copy, i_nb_of_copies_in_radial_dir, i_nb_of_copies_in_angular_dir, i_step_in_radial_dir, i_step_in_angular_dir, i_shape_to_copy_position_along_radial_dir, i_shape_to_copy_position_along_angular_dir, i_rotation_center, i_rotation_axis, i_is_reversed_rotation_axis, i_rotation_angle, i_is_radius_aligned)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewCircPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInRadialDir,
long iNbOfCopiesInAngularDir,
double iStepInRadialDir,
double iStepInAngularDir,
long iShapeToCopyPositionAlongRadialDir,
long iShapeToCopyPositionAlongAngularDir,
Reference iRotationCenter,
Reference iRotationAxis,
boolean iIsReversedRotationAxis,
double iRotationAngle,
boolean iIsRadiusAligned) As CircPattern

Creates and returns a new circular pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the circular pattern
iNbOfInstancesInRadialDir
The number of times iShapeToCopy will be copied along pattern
radial direction
iNbOfInstancesInAngularDir
The number of times iShapeToCopy will be copied along pattern
angular direction
iStepInRadialDir
The distance that will separate two consecutive copies in the
pattern along its radial direction
iStepInAngularDir
The angle that will separate two consecutive copies in the pattern
along its angular direction
iShapeToCopyPositionAlongRadialDir
Specifies the position of the original shape iShapeToCopy among its
copies along the radial direction
iShapeToCopyPositionAlongAngularDir
Specifies the position of the original shape iShapeToCopy among its
copies along the angular direction
iRotationCenter
The point or vertex that specifies the pattern center of rotation

iRotationAxis
The line or linear edge that specifies the axis around which
instances will be rotated relative to each other
The following

Boundary objects are supported: PlanarFace , CylindricalFace ,
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.

iIsReversedRotationAxis
The boolean flag indicating wether the natural orientation of
iRotationAxis should be used to orient the pattern operation. A value of true
indicates that iItemToDuplicate are copied in the direction of the natural
orientation of iRotationAxis.
iRotationAngle
The angle applied to the direction iRotationAxis prior to applying the
pattern. The original shape iShapeToCopy is used as the rotation center.
Nevertheless, the copied shapes themselves are not rotated. This allows the
definition of a circular pattern relatively to existing geometry, but not
necessarily parallel to it.
iIsRadiusAligned
The boolean flag that specifies whether the instances of
iItemToDuplicate copied by the pattern should be kept parallel to each other
(True) or if they should be aligned with the radial direction they lie upon
(False).
Returns:
The created circular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_radial_dir (int) –

  • i_nb_of_copies_in_angular_dir (int) –

  • i_step_in_radial_dir (float) –

  • i_step_in_angular_dir (float) –

  • i_shape_to_copy_position_along_radial_dir (int) –

  • i_shape_to_copy_position_along_angular_dir (int) –

  • i_rotation_center (Reference) –

  • i_rotation_axis (Reference) –

  • i_is_reversed_rotation_axis (bool) –

  • i_rotation_angle (float) –

  • i_is_radius_aligned (bool) –

Returns

CircPattern

add_new_circ_patternof_list(i_shape_to_copy, i_nb_of_copies_in_radial_dir, i_nb_of_copies_in_angular_dir, i_step_in_radial_dir, i_step_in_angular_dir, i_shape_to_copy_position_along_radial_dir, i_shape_to_copy_position_along_angular_dir, i_rotation_center, i_rotation_axis, i_is_reversed_rotation_axis, i_rotation_angle, i_is_radius_aligned)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewCircPatternofList(AnyObject iShapeToCopy,
long iNbOfCopiesInRadialDir,
long iNbOfCopiesInAngularDir,
double iStepInRadialDir,
double iStepInAngularDir,
long iShapeToCopyPositionAlongRadialDir,
long iShapeToCopyPositionAlongAngularDir,
Reference iRotationCenter,
Reference iRotationAxis,
boolean iIsReversedRotationAxis,
double iRotationAngle,
boolean iIsRadiusAligned) As CircPattern

V5R8 Only: Creates and returns a new circular pattern within the current
body using a list of shapes.

Parameters:

iShapeToCopy
The shape to be copied by the circular pattern. Others shapes will
be add by put_ItemToCopy with CATIAPattern interface

iNbOfInstancesInRadialDir
The number of times iShapeToCopy will be copied along pattern
radial direction
iNbOfInstancesInAngularDir
The number of times iShapeToCopy will be copied along pattern
angular direction
iStepInRadialDir
The distance that will separate two consecutive copies in the
pattern along its radial direction
iStepInAngularDir
The angle that will separate two consecutive copies in the pattern
along its angular direction
iShapeToCopyPositionAlongRadialDir
Specifies the position of the original shape iShapeToCopy among its
copies along the radial direction
iShapeToCopyPositionAlongAngularDir
Specifies the position of the original shape iShapeToCopy among its
copies along the angular direction
iRotationCenter
The point or vertex that specifies the pattern center of rotation

iRotationAxis
The line or linear edge that specifies the axis around which
instances will be rotated relative to each other
iIsReversedRotationAxis
The boolean flag indicating wether the natural orientation of
iRotationAxis should be used to orient the pattern operation. A value of true
indicates that iItemToDuplicate are copied in the direction of the natural
orientation of iRotationAxis.
iRotationAngle
The angle applied to the direction iRotationAxis prior to applying
the pattern. The original shape iShapeToCopy is used as the rotation center.
Nevertheless, the copied shapes themselves are not rotated. This allows the
definition of a circular pattern relatively to existing geometry, but not
necessarily parallel to it.
iIsRadiusAligned
The boolean flag that specifies whether the instances of
iItemToDuplicate copied by the pattern should be kept parallel to each other
(True) or if they should be aligned with the radial direction they lie upon
(False).

Returns:
The created circular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_radial_dir (int) –

  • i_nb_of_copies_in_angular_dir (int) –

  • i_step_in_radial_dir (float) –

  • i_step_in_angular_dir (float) –

  • i_shape_to_copy_position_along_radial_dir (int) –

  • i_shape_to_copy_position_along_angular_dir (int) –

  • i_rotation_center (Reference) –

  • i_rotation_axis (Reference) –

  • i_is_reversed_rotation_axis (bool) –

  • i_rotation_angle (float) –

  • i_is_radius_aligned (bool) –

Returns

CircPattern

add_new_close_surface(i_close_element)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewCloseSurface(Reference iCloseElement) As
CloseSurface

Creates and returns a new CloseSurface feature.

Parameters:

iCloseElement
The skin that will be closed and add with the current body


Returns:
The created CloseSurface feature
Parameters

i_close_element (Reference) –

Returns

CloseSurface

add_new_defeaturing()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewDefeaturing() As Defeaturing

Creates and returns a new defeaturing operation within the current
container.

Returns:
The created defeaturing operation
Returns

Defeaturing

add_new_draft(i_face_to_draft, i_neutral, i_neutral_mode, i_parting, i_dir_x, i_dir_y, i_dir_z, i_mode, i_angle, i_multiselection_mode)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewDraft(Reference iFaceToDraft,
Reference iNeutral,
CatDraftNeutralPropagationMode iNeutralMode,
Reference iParting,
double iDirX,
double iDirY,
double iDirZ,
CatDraftMode iMode,
double iAngle,
CatDraftMultiselectionMode iMultiselectionMode) As Draft

Creates and returns a new draft within the current body.
The draft needs a reference face on the body. This face will remain
unchanged in the draft operation, while faces adjacent to it and specified for
drafting will be rotated by the draft angle.

Parameters:

iFaceToDraft
The first face to draft in the body. This face should be adjacent
to the iFaceToDraft face. If several faces are to be drafted, only the first
one is specified here, the others being inferred by propagating the draft
operation onto faces adjacent to this first face. This is controlled by the
iNeutralMode argument.
The following

Boundary object is supported: Face.
iNeutral
The reference face for the draft. The draft needs a reference face on
the body, that will remain unchanged in the draft operation, while faces
adjacent to it and specified for drafting will be rotated according to the
draft angle iAngle.
The following Boundary object is supported:
PlanarFace.
iNeutralMode
Controls if and how the drafting operation should be propagated beyond
the first face to draft iFaceToDraft to other adjacent faces.

iParting
The draft parting plane, face or surface. It specifies the element
within the body to draft that represents the bottom of the mold. This element
can be located either somewhere in the middle of the body or be one of its
boundary faces. When located in the middle of the body, it crosses the faces to
draft, and as a result, those faces are drafted with a positive angle on one
side of the parting surface, and with a negative angle on the other
side.
The following Boundary object is supported:
PlanarFace.
iDirX,iDirY,iDirZ
The X, Y, and Z components of the absolute vector representing the
drafting direction (i.e. the mold extraction direction).

iMode
The draft connecting mode to its reference face iFaceToDraft

iAngle
The draft angle
iMultiselectionMode.
The elements to be drafted can be selected explicitly or can implicitly
selected as neighbors of the neutral face
Returns:
The created draft
Parameters
  • i_face_to_draft (Reference) –

  • i_neutral (Reference) –

  • i_neutral_mode (CatDraftNeutralPropagationMode) –

  • i_parting (Reference) –

  • i_dir_x (float) –

  • i_dir_y (float) –

  • i_dir_z (float) –

  • i_mode (CatDraftMode) –

  • i_angle (float) –

  • i_multiselection_mode (CatDraftMultiselectionMode) –

Returns

Draft

add_new_edge_fillet_with_constant_radius(i_edge_to_fillet, i_propag_mode, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewEdgeFilletWithConstantRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
double iRadius) As ConstRadEdgeFillet

Deprecated:
V5R14 #AddNewEdgeFilletWithConstantRadius use
AddNewSolidEdgeFilletWithConstantRadius or
AddNewSurfaceEdgeFilletWithConstantRadius depending on the type of fillet you
want to create
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_radius (float) –

Returns

ConstRadEdgeFillet

add_new_edge_fillet_with_varying_radius(i_edge_to_fillet, i_propag_mode, i_variation_mode, i_default_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewEdgeFilletWithVaryingRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
CatFilletVariation iVariationMode,
double iDefaultRadius) As VarRadEdgeFillet

Deprecated:
V5R14 #AddNewEdgeFilletWithVaryingRadius use
AddNewSolidEdgeFilletWithVaryingRadius or
AddNewSurfaceEdgeFilletWithVaryingRadius depending on the type of fillet you
want to create
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_variation_mode (CatFilletVariation) –

  • i_default_radius (float) –

Returns

VarRadEdgeFillet

add_new_face_fillet(i_f1, i_f2, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewFaceFillet(Reference iF1,
Reference iF2,
double iRadius) As FaceFillet

Deprecated:
V5R14 #AddNewFaceFillet use AddNewSolidFaceFillet or
AddNewSurfaceFaceFillet depending on the type of fillet you want to create
Parameters
Returns

FaceFillet

add_new_groove(i_sketch)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewGroove(Sketch iSketch) As Groove

Creates and returns a new groove within the current body.
The Revolution, as a supertype for grooves, provides starting and ending
angles for the groove definition.

Parameters:

iSketch
The sketch defining the groove section. The sketch must contain a
contour and an axis that will be used to rotate the contour in the space, thus
defining the groove. The contour has to penetrate in 3D space the current
shape.

Returns:
The created groove
Parameters

i_sketch (Sketch) –

Returns

Groove

add_new_groove_from_ref(i_profile_elt)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewGrooveFromRef(Reference iProfileElt) As Groove

Creates and returns a new groove within the current body.

Parameters:

iProfileElt
The reference on the element defining the groove base


Returns:
The created groove
Parameters

i_profile_elt (Reference) –

Returns

Groove

add_new_gsd_circ_pattern(i_shape_to_copy, i_nb_of_copies_in_radial_dir, i_nb_of_copies_in_angular_dir, i_step_in_radial_dir, i_step_in_angular_dir, i_shape_to_copy_position_along_radial_dir, i_shape_to_copy_position_along_angular_dir, i_rotation_center, i_rotation_axis, i_is_reversed_rotation_axis, i_rotation_angle, i_is_radius_aligned, i_complete_crown, i_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewGSDCircPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInRadialDir,
long iNbOfCopiesInAngularDir,
double iStepInRadialDir,
double iStepInAngularDir,
long iShapeToCopyPositionAlongRadialDir,
long iShapeToCopyPositionAlongAngularDir,
Reference iRotationCenter,
Reference iRotationAxis,
boolean iIsReversedRotationAxis,
double iRotationAngle,
boolean iIsRadiusAligned,
boolean iCompleteCrown,
double iType) As CircPattern

Deprecated:
V5R15 #AddNewSurfacicCircPattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_radial_dir (int) –

  • i_nb_of_copies_in_angular_dir (int) –

  • i_step_in_radial_dir (float) –

  • i_step_in_angular_dir (float) –

  • i_shape_to_copy_position_along_radial_dir (int) –

  • i_shape_to_copy_position_along_angular_dir (int) –

  • i_rotation_center (Reference) –

  • i_rotation_axis (Reference) –

  • i_is_reversed_rotation_axis (bool) –

  • i_rotation_angle (float) –

  • i_is_radius_aligned (bool) –

  • i_complete_crown (bool) –

  • i_type (float) –

Returns

CircPattern

add_new_gsd_rect_pattern(i_shape_to_copy, i_nb_of_copies_in_dir1, i_nb_of_copies_in_dir2, i_step_in_dir1, i_step_in_dir2, i_shape_to_copy_position_along_dir1, i_shape_to_copy_position_along_dir2, i_dir1, i_dir2, i_is_reversed_dir1, i_is_reversed_dir2, i_rotation_angle, i_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewGSDRectPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInDir1,
long iNbOfCopiesInDir2,
double iStepInDir1,
double iStepInDir2,
long iShapeToCopyPositionAlongDir1,
long iShapeToCopyPositionAlongDir2,
Reference iDir1,
Reference iDir2,
boolean iIsReversedDir1,
boolean iIsReversedDir2,
double iRotationAngle,
double iType) As RectPattern

Deprecated:
V5R15 #AddNewSurfacicRectPattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_dir1 (int) –

  • i_nb_of_copies_in_dir2 (int) –

  • i_step_in_dir1 (float) –

  • i_step_in_dir2 (float) –

  • i_shape_to_copy_position_along_dir1 (int) –

  • i_shape_to_copy_position_along_dir2 (int) –

  • i_dir1 (Reference) –

  • i_dir2 (Reference) –

  • i_is_reversed_dir1 (bool) –

  • i_is_reversed_dir2 (bool) –

  • i_rotation_angle (float) –

  • i_type (float) –

Returns

RectPattern

add_new_hole(i_support, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHole(Reference iSupport,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iSupport
The support defining the hole reference plane.
Anchor point is located at the barycenter of the support. The hole
axis in 3D passes through that point and is normal to the
plane.
The following

Boundary object is supported: Face.
iDepth
The hole depth.
Returns:
The created hole
Parameters
  • i_support (Reference) –

  • i_depth (float) –

Returns

Hole

add_new_hole_from_point(i_x, i_y, i_z, i_support, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHoleFromPoint(double iX,
double iY,
double iZ,
Reference iSupport,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iX
Origin point x absolute coordinate
iY
Origin point y absolute coordinate
iZ
Origin point z absolute coordinate
Sets the origin point which the hole is anchored
to.
If mandatory, the entry point will be projected onto a tangent
plane.
iSupport
The support defining the hole reference plane.
The following

Boundary object is supported: Face.
iDepth
The hole depth.
Returns:
The created hole
Parameters
  • i_x (float) –

  • i_y (float) –

  • i_z (float) –

  • i_support (Reference) –

  • i_depth (float) –

Returns

Hole

add_new_hole_from_ref_point(i_origin, i_support, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHoleFromRefPoint(Reference iOrigin,
Reference iSupport,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iOrigin
The origin point which the hole is anchored to.
iSupport
The support defining the hole reference plane.
The following

Boundary object is supported: Face.
iDepth
The hole depth.
Returns:
The created hole
Parameters
Returns

Hole

add_new_hole_from_sketch(i_sketch, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHoleFromSketch(Sketch iSketch,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iSketch
The sketch defining the hole reference plane and anchor
point.
This sketch must contain a single point that defines the hole axis:
the hole axis in 3D passes through that point and is normal to the sketch
plane.
iDepth
The hole depth.

Returns:
The created hole
Parameters
  • i_sketch (Sketch) –

  • i_depth (float) –

Returns

Hole

add_new_hole_with2_constraints(i_x, i_y, i_z, i_edge1, i_edge2, i_support, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHoleWith2Constraints(double iX,
double iY,
double iZ,
Reference iEdge1,
Reference iEdge2,
Reference iSupport,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iX
Origin point x absolute coordinate
iY
Origin point y absolute coordinate
iZ
Origin point z absolute coordinate
Sets the origin point which the hole is anchored
to.
If mandatory, the entry point will be projected onto a tangent
plane.
iEdge
The edge which the hole is constrained to.
The origin of the hole will have a length constraint with each
edge.
The following

Boundary object is supported: TriDimFeatEdge.
iSupport
The support defining the hole reference plane.
The following Boundary object is supported: Face.
iDepth
The hole depth.
Returns:
The created hole
Parameters
  • i_x (float) –

  • i_y (float) –

  • i_z (float) –

  • i_edge1 (Reference) –

  • i_edge2 (Reference) –

  • i_support (Reference) –

  • i_depth (float) –

Returns

Hole

add_new_hole_with_constraint(i_x, i_y, i_z, i_edge, i_support, i_depth)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewHoleWithConstraint(double iX,
double iY,
double iZ,
Reference iEdge,
Reference iSupport,
double iDepth) As Hole

Creates and returns a new hole within the current shape.
Actual hole shape is defined by editing hole properties after its
creation.

Parameters:

iX
Origin point x absolute coordinate
iY
Origin point y absolute coordinate
iZ
Origin point z absolute coordinate
Sets the origin point which the hole is anchored
to.
If mandatory, the entry point will be projected onto a tangent
plane.
iEdge
The edge which the hole is constrained to.
If edge is circular, the origin of the hole will be concentric to
the edge (iX, iY, iZ will be overridden). if not, the origin of the hole will
have a length constraint with the edge.
The following

Boundary object is supported: TriDimFeatEdge.
iSupport
The support defining the hole reference plane.
The following Boundary object is supported: Face.
iDepth
The hole depth.
Returns:
The created hole
Parameters
  • i_x (float) –

  • i_y (float) –

  • i_z (float) –

  • i_edge (Reference) –

  • i_support (Reference) –

  • i_depth (float) –

Returns

Hole

add_new_intersect(i_body_to_intersect)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewIntersect(Body iBodyToIntersect) As Intersect

Creates and returns a new intersect operation within the current
body.

Parameters:

iBodyToIntersect
The body to intersect with the current body

Returns:
The created intersect operation
Parameters

i_body_to_intersect (Body) –

Returns

Intersect

add_new_loft()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewLoft() As AnyObject

Creates and returns a new Loft feature.

Returns:
The created Loft feature
Returns

AnyObject

add_new_mirror(i_mirroring_element)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewMirror(Reference iMirroringElement) As Mirror

Creates and returns a new mirror within the current body.
A mirror allows for transforming existing shapes by a symmetry with respect
to an existing plane.

Parameters:

iMirroringElement
The plane used by the mirror as the symmetry
plane.
The following

Boundary object is supported: PlanarFace.
Returns:
The created mirror
Parameters

i_mirroring_element (Reference) –

Returns

Mirror

add_new_pad(i_sketch, i_height)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewPad(Sketch iSketch,
double iHeight) As Pad

Creates and returns a new pad within the current body.

Parameters:

iSketch
The sketch defining the pad base
iHeight
The pad height

Returns:
The created pad
Parameters
  • i_sketch (Sketch) –

  • i_height (float) –

Returns

Pad

add_new_pad_from_ref(i_profile_elt, i_height)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewPadFromRef(Reference iProfileElt,
double iHeight) As Pad

Creates and returns a new pad within the current body.

Parameters:

iProfileElt
The reference on the element defining the pad base

iHeight
The pad height

Returns:
The created pad
Parameters
  • i_profile_elt (Reference) –

  • i_height (float) –

Returns

Pad

add_new_pocket(i_sketch, i_height)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewPocket(Sketch iSketch,
double iHeight) As Pocket

Creates and returns a new pocket within the current shape.

Parameters:

iSketch
The sketch defining the pocket base
iDepth
The pocket depth

Returns:
The created pocket
Parameters
  • i_sketch (Sketch) –

  • i_height (float) –

Returns

Pocket

add_new_pocket_from_ref(i_profile_elt, i_height)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewPocketFromRef(Reference iProfileElt,
double iHeight) As Pocket

Creates and returns a new pocket within the current shape.

Parameters:

iProfileElt
The reference on the element defining the pocket base

iDepth
The pocket depth

Returns:
The created pocket
Parameters
  • i_profile_elt (Reference) –

  • i_height (float) –

Returns

Pocket

add_new_rect_pattern(i_shape_to_copy, i_nb_of_copies_in_dir1, i_nb_of_copies_in_dir2, i_step_in_dir1, i_step_in_dir2, i_shape_to_copy_position_along_dir1, i_shape_to_copy_position_along_dir2, i_dir1, i_dir2, i_is_reversed_dir1, i_is_reversed_dir2, i_rotation_angle)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRectPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInDir1,
long iNbOfCopiesInDir2,
double iStepInDir1,
double iStepInDir2,
long iShapeToCopyPositionAlongDir1,
long iShapeToCopyPositionAlongDir2,
Reference iDir1,
Reference iDir2,
boolean iIsReversedDir1,
boolean iIsReversedDir2,
double iRotationAngle) As RectPattern

Creates and returns a new rectangular pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the rectangular pattern
iNbOfCopiesInDir1
The number of times iShapeToCopy will be copied along the pattern
first direction
iNbOfCopiesInDir2
The number of times iShapeToCopy will be copied along the pattern
second direction
iStepInDir1
The distance that will separate two consecutive copies in the
pattern along its first direction
iStepInDir2
The distance that will separate two consecutive copies in the
pattern along its second direction
iShapeToCopyPositionAlongDir1
Specifies the position of the original shape iShapeToCopy among its
copies along iDir1
iShapeToCopyPositionAlongDir2
Specifies the position of the original shape iShapeToCopy among its
copies along iDir2
iDir1
The line or linear edge that specifies the pattern first
repartition direction
The following

Boundary objects are supported: PlanarFace, RectilinearTriDimFeatEdge,
RectilinearBiDimFeatEdge.
iDir2
The line or linear edge that specifies the pattern second repartition
direction
The following Boundary objects are supported: PlanarFace,
RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge.
iIsReversedDir1
The boolean flag indicating whether the natural orientation of iDir1
should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir1.

iIsReversedDir2
The boolean flag indicating whether the natural orientation of iDir2
should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir2.

iRotationAngle
The angle applied to both directions iDir1 and iDir2 prior to applying
the pattern. The original shape iShapeToCopy is used as the rotation center.
Nevertheless, the copied shapes themselves are not rotated. This allows the
definition of a rectangular pattern relatively to existing geometry, but not
necessarily parallel to it.
Returns:
The created rectangular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_dir1 (int) –

  • i_nb_of_copies_in_dir2 (int) –

  • i_step_in_dir1 (float) –

  • i_step_in_dir2 (float) –

  • i_shape_to_copy_position_along_dir1 (int) –

  • i_shape_to_copy_position_along_dir2 (int) –

  • i_dir1 (Reference) –

  • i_dir2 (Reference) –

  • i_is_reversed_dir1 (bool) –

  • i_is_reversed_dir2 (bool) –

  • i_rotation_angle (float) –

Returns

RectPattern

add_new_rect_patternof_list(i_shape_to_copy, i_nb_of_copies_in_dir1, i_nb_of_copies_in_dir2, i_step_in_dir1, i_step_in_dir2, i_shape_to_copy_position_along_dir1, i_shape_to_copy_position_along_dir2, i_dir1, i_dir2, i_is_reversed_dir1, i_is_reversed_dir2, i_rotation_angle)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRectPatternofList(AnyObject iShapeToCopy,
long iNbOfCopiesInDir1,
long iNbOfCopiesInDir2,
double iStepInDir1,
double iStepInDir2,
long iShapeToCopyPositionAlongDir1,
long iShapeToCopyPositionAlongDir2,
Reference iDir1,
Reference iDir2,
boolean iIsReversedDir1,
boolean iIsReversedDir2,
double iRotationAngle) As RectPattern

V5R8 Only: Creates and returns a new rectangular pattern within the current
body using a list of shapes.

Parameters:

iShapeToCopy
The shape to be copied by the rectangular pattern Others shapes
will be add by put_ItemToCopy with CATIAPattern interface

iNbOfCopiesInDir1
The number of times iShapeToCopy will be copied along the pattern
first direction
iNbOfCopiesInDir2
The number of times iShapeToCopy will be copied along the pattern
second direction
iStepInDir1
The distance that will separate two consecutive copies in the
pattern along its first direction
iStepInDir2
The distance that will separate two consecutive copies in the
pattern along its second direction
iShapeToCopyPositionAlongDir1
Specifies the position of the original shape iShapeToCopy among its
copies along iDir1
iShapeToCopyPositionAlongDir2
Specifies the position of the original shape iShapeToCopy among its
copies along iDir2
iDir1
The line or linear edge that specifies the pattern first
repartition direction
iDir2
The line or linear edge that specifies the pattern second
repartition direction
iIsReversedDir1
The boolean flag indicating whether the natural orientation of
iDir1 should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir1.

iIsReversedDir2
The boolean flag indicating whether the natural orientation of
iDir2 should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir2.

iRotationAngle
The angle applied to both directions iDir1 and iDir2 prior to
applying the pattern. The original shape iShapeToCopy is used as the rotation
center. Nevertheless, the copied shapes themselves are not rotated. This allows
the definition of a rectangular pattern relatively to existing geometry, but
not necessarily parallel to it.

Returns:
The created rectangular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_dir1 (int) –

  • i_nb_of_copies_in_dir2 (int) –

  • i_step_in_dir1 (float) –

  • i_step_in_dir2 (float) –

  • i_shape_to_copy_position_along_dir1 (int) –

  • i_shape_to_copy_position_along_dir2 (int) –

  • i_dir1 (Reference) –

  • i_dir2 (Reference) –

  • i_is_reversed_dir1 (bool) –

  • i_is_reversed_dir2 (bool) –

  • i_rotation_angle (float) –

Returns

RectPattern

add_new_remove(i_body_to_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRemove(Body iBodyToRemove) As Remove

Creates and returns a new remove operation within the current
body.

Parameters:

iBodyToRemove
The body to remove from the current body

Returns:
The created remove operation
Parameters

i_body_to_remove (Body) –

Returns

Remove

add_new_remove_face(i_keep_faces, i_remove_faces)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRemoveFace(Reference iKeepFaces,
Reference iRemoveFaces) As RemoveFace

Creates and returns a new RemoveFace feature.

Parameters:

iKeepFaces
The reference of the face to Keep.
iRemoveFaces
The reference of the face to Remove.

Returns:
The created RemoveFace feature.
Parameters
Returns

RemoveFace

add_new_removed_blend()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRemovedBlend() As AnyObject

Creates and returns a new Removed Blend feature.

Returns:
The created Removed Blend feature
Returns

AnyObject

add_new_removed_loft()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRemovedLoft() As AnyObject

Creates and returns a new Removed Loft feature.

Returns:
The created Removed Loft feature
Returns

AnyObject

add_new_replace_face(i_split_plane, i_remove_face, i_splitting_side)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewReplaceFace(Reference iSplitPlane,
Reference iRemoveFace,
CatSplitSide iSplittingSide) As ReplaceFace

Creates and returns a new Align/ ReplaceFace feature.

Parameters:

iSplitPlane
The reference of the element defining the Splitting Plane.

iRemoveFace
The reference of the Face to Remove.
iSplittingSide
The specification for which side of the current body should be
Align

Returns:
The created Align/ ReplaceFace feature.
Parameters
  • i_split_plane (Reference) –

  • i_remove_face (Reference) –

  • i_splitting_side (CatSplitSide) –

Returns

ReplaceFace

add_new_rib(i_sketch, i_center_curve)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRib(Sketch iSketch,
Sketch iCenterCurve) As Rib

Creates and returns a new rib within the current body.

Parameters:

iSketch
The sketch defining the rib section
iCenterCurve
The sketched curve that defines the rib center curve. It must cross
the section definition sketch iSketch within the inner part of its contour.


Returns:
The created rib
Parameters
Returns

Rib

add_new_rib_from_ref(i_profile, i_center_curve)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewRibFromRef(Reference iProfile,
Reference iCenterCurve) As Rib

Creates and returns a new rib within the current body.

Parameters:

iProfile
The Profile defining the rib section
iCenterCurve
The curve that defines the rib center curve.
The following

Boundary object is supported: TriDimFeatEdge.
Returns:
The created rib
Parameters
Returns

Rib

add_new_scaling(i_scaling_reference, i_factor)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewScaling(Reference iScalingReference,
double iFactor) As Scaling

Creates and returns a new scaling within the current body.

Parameters:

iScalingReference
The point, plane or face of the current body that will remain fixed
during the scaling process: even if the face itself shrinks or expands during
the scaling, its supporting plane will remain unchanged after the
scaling.
The following

Boundary objects are supported: PlanarFace and Vertex.

iFactor
The scaling factor
Returns:
The created scaling
Parameters
  • i_scaling_reference (Reference) –

  • i_factor (float) –

Returns

Scaling

add_new_sew_surface(i_sewing_element, i_sewing_side)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSewSurface(Reference iSewingElement,
CatSplitSide iSewingSide) As SewSurface

Creates and returns a new sewing operation within the current
body.

Parameters:

iSewingElement
The face or skin or surface that will be sewn on the current body

iSewingSide
The specification for which side of the current body should be kept
at the end of the sewing operation

Returns:
The created sewing operation
Parameters
  • i_sewing_element (Reference) –

  • i_sewing_side (CatSplitSide) –

Returns

SewSurface

add_new_shaft(i_sketch)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewShaft(Sketch iSketch) As Shaft

Creates and returns a new shaft within the current body.
The Revolution, as a supertype for shafts, provides starting and ending
angles for the shaft definition.

Parameters:

iSketch
The sketch defining the shaft section.

If the shaft applies to the current body, then the sketch must
contain a contour and an axis that will be used to rotate the contour in the
space, thus defining the shaft.
If the shaft is the first shape defined, there is not current
body to apply to. In such a case, the sketch must contain a curve whose end
points are linked by an axis. By rotating the curve in the space around the
axis, the shaft operation will define a revolution shape. This also works if
the sketch contains a closed contour and an axis outside of this contour: in
that case a revolution shape will be created, for example a torus.


Returns:
The created shaft
Parameters

i_sketch (Sketch) –

Returns

Shaft

add_new_shaft_from_ref(i_profile_elt)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewShaftFromRef(Reference iProfileElt) As Shaft

Creates and returns a new shaft within the current body.

Parameters:

iProfileElt
The reference on the element defining the shaft base


Returns:
The created shaft
Parameters

i_profile_elt (Reference) –

Returns

Shaft

add_new_shell(i_face_to_remove, i_internal_thickness, i_external_thickness)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewShell(Reference iFaceToRemove,
double iInternalThickness,
double iExternalThickness) As Shell

Creates and returns a new shell within the current body.

Parameters:

iFaceToRemove
The first face to be removed in the shell process.
The following

Boundary object is supported: Face.
iInternalThickness
The thickness of material to be added on the internal side of all the
faces during the shell process, except for those to be removed

iExternaThickness
The thickness of material to be added on the external side of all the
faces during the shell process, except for those to be removed

Returns:
The created shell
Parameters
  • i_face_to_remove (Reference) –

  • i_internal_thickness (float) –

  • i_external_thickness (float) –

Returns

Shell

add_new_slot(i_sketch, i_center_curve)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSlot(Sketch iSketch,
Sketch iCenterCurve) As Slot

Creates and returns a new slot within the current shape.

Parameters:

iSketch
The sketch defining the slot section
iCenterCurve
The sketched curve that defines the slot center curve. It must
cross the section definition sketch iSketch within the inner part of its
contour.

Returns:
The created slot
Parameters
Returns

Slot

add_new_slot_from_ref(i_profile, i_center_curve)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSlotFromRef(Reference iProfile,
Reference iCenterCurve) As Slot

Creates and returns a new slot within the current shape.

Parameters:

iProfile
The sketch defining the slot section
iCenterCurve
The curve that defines the slot center curve.
The following

Boundary object is supported: TriDimFeatEdge.
Returns:
The created slot
Parameters
Returns

Slot

add_new_solid_combine(i_profile_elt_first, i_profile_elt_second)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSolidCombine(Reference iProfileEltFirst,
Reference iProfileEltSecond) As SolidCombine

Creates and returns a new SolidCombine feature.

Parameters:

iProfileEltFirst
The reference of the element defining the profile for first
component.
iProfileEltSecond
The reference of the element defining the profile for second
component.

Returns:
The created SolidCombine feature.
Parameters
Returns

SolidCombine

add_new_solid_edge_fillet_with_constant_radius(i_edge_to_fillet, i_propag_mode, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSolidEdgeFilletWithConstantRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
double iRadius) As ConstRadEdgeFillet

Creates and returns a new solid edge fillet with a constant radius. within
the current body.

Parameters:

iEdgeToFillet
The edge that will be filleted first
The following

Boundary object is supported: TriDimFeatEdge.
iPropagMode
Controls whether other edges found adjacent to the first one should
also be filleted in the same operation
iRadius
The fillet radius
Returns:
The created edge fillet
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_radius (float) –

Returns

ConstRadEdgeFillet

add_new_solid_edge_fillet_with_varying_radius(i_edge_to_fillet, i_propag_mode, i_variation_mode, i_default_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSolidEdgeFilletWithVaryingRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
CatFilletVariation iVariationMode,
double iDefaultRadius) As VarRadEdgeFillet

Creates and returns a new solid edge fillet with a varying radius. within
the current body.

Parameters:

iEdgeToFillet
The edge that will be filleted first
The following

Boundary object is supported: TriDimFeatEdge.
iPropagMode
Controls whether other edges found adjacent to the first one should
also be filleted in the same operation
iVariationMode
Controls the law of evolution for the fillet radius between specified
control points, such as edges extremities
iDefaultRadius
The fillet default radius, that will apply when no other radius can be
inferred from the iVariationMode parameter
Returns:
The created edge fillet
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_variation_mode (CatFilletVariation) –

  • i_default_radius (float) –

Returns

VarRadEdgeFillet

add_new_solid_face_fillet(i_f1, i_f2, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSolidFaceFillet(Reference iF1,
Reference iF2,
double iRadius) As FaceFillet

Creates and returns a new solid face-to-face fillet.
Use this method to created face-to-face fillets with varying fillet radii,
by editing fillet attributes driving its radius after its
creation.

Parameters:

iF1
The first face that will support the fillet
The following

Boundary object is supported: Face.
iF2
The second face that will support the fillet
The following Boundary object is supported: Face.
iRadius
The fillet radius
Returns:
The created face-to-face fillet
Parameters
Returns

FaceFillet

add_new_solid_tritangent_fillet(i_f1, i_f2, i_removed_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSolidTritangentFillet(Reference iF1,
Reference iF2,
Reference iRemovedFace) As TritangentFillet

Creates and returns a new solid tritangent fillet within the current
body.
This kind of fillet begins with tangency on a first face iF1, gets tangent
to a second one iRemovedFace and ends with tangency to a third one iF2. During
the process the second face iRemovedFace is removed.

Parameters:

iF1
The starting face for the fillet
The following

Boundary object is supported: Face.
iF2
The ending face for the fillet
The following Boundary object is supported: Face.
iRemovedFace
The face used as an intermediate tangent support for the fillet during
its course from iF1 to iF2. This face will be removed at the end of the
filleting operation.
The following Boundary object is supported: Face
Returns:
The created tritangent fillet
Parameters
Returns

TritangentFillet

add_new_split(i_splitting_element, i_split_side)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSplit(Reference iSplittingElement,
CatSplitSide iSplitSide) As Split

Creates and returns a new split operation within the current
body.

Parameters:

iSplittingElement
The face or plane that will split the current body
The following

Boundary object is supported: Face.
iSplitSide
The specification for which side of the current body should be kept at
the end of the split operation
Returns:
The created split operation
Parameters
  • i_splitting_element (Reference) –

  • i_split_side (CatSplitSide) –

Returns

Split

add_new_stiffener(i_sketch)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewStiffener(Sketch iSketch) As Stiffener

Creates and returns a new stiffener within the current
body.
A stiffener is made up of a sketch used as the stiffener profile, that is
extruded (offset) and that fills the nearest shape.

Parameters:

iSketch
The sketch defining the stiffener border. It must contain a line or
a curve that does not cross in 3D space the face(s) to stiffen.


Returns:
The created stiffener
Parameters

i_sketch (Sketch) –

Returns

Stiffener

add_new_stiffener_from_ref(i_profile_elt)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewStiffenerFromRef(Reference iProfileElt) As
Stiffener

Creates and returns a new stiffener within the current
body.

Parameters:

iProfileElt
The reference on the element defining the stiffener profile


Returns:
The created stiffener
Parameters

i_profile_elt (Reference) –

Returns

Stiffener

add_new_surface_edge_fillet_with_constant_radius(i_edge_to_fillet, i_propag_mode, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfaceEdgeFilletWithConstantRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
double iRadius) As ConstRadEdgeFillet

Creates and returns a new surface edge fillet with a constant radius.
within the current body.

Parameters:

iEdgeToFillet
The edge that will be filleted first
The following

Boundary object is supported: TriDimFeatEdge.
iPropagMode
Controls whether other edges found adjacent to the first one should
also be filleted in the same operation
iRadius
The fillet radius
Returns:
The created edge fillet
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_radius (float) –

Returns

ConstRadEdgeFillet

add_new_surface_edge_fillet_with_varying_radius(i_edge_to_fillet, i_propag_mode, i_variation_mode, i_default_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfaceEdgeFilletWithVaryingRadius(Reference
iEdgeToFillet,
CatFilletEdgePropagation iPropagMode,
CatFilletVariation iVariationMode,
double iDefaultRadius) As VarRadEdgeFillet

Creates and returns a new surface edge fillet with a varying radius. within
the current body.

Parameters:

iEdgeToFillet
The edge that will be filleted first
The following

Boundary object is supported: TriDimFeatEdge.
iPropagMode
Controls whether other edges found adjacent to the first one should
also be filleted in the same operation
iVariationMode
Controls the law of evolution for the fillet radius between specified
control points, such as edges extremities
iDefaultRadius
The fillet default radius, that will apply when no other radius can be
inferred from the iVariationMode parameter
Returns:
The created edge fillet
Parameters
  • i_edge_to_fillet (Reference) –

  • i_propag_mode (CatFilletEdgePropagation) –

  • i_variation_mode (CatFilletVariation) –

  • i_default_radius (float) –

Returns

VarRadEdgeFillet

add_new_surface_face_fillet(i_f1, i_f2, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfaceFaceFillet(Reference iF1,
Reference iF2,
double iRadius) As FaceFillet

Creates and returns a new surface face-to-face fillet.
Use this method to created face-to-face fillets with varying fillet radii,
by editing fillet attributes driving its radius after its
creation.

Parameters:

iF1
The first face that will support the fillet
The following

Boundary object is supported: Face.
iF2
The second face that will support the fillet
The following Boundary object is supported: Face.
iRadius
The fillet radius
Returns:
The created face-to-face fillet
Parameters
Returns

FaceFillet

add_new_surface_tritangent_fillet(i_f1, i_f2, i_removed_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfaceTritangentFillet(Reference iF1,
Reference iF2,
Reference iRemovedFace) As TritangentFillet

Creates and returns a new surface tritangent fillet within the current
body.
This kind of fillet begins with tangency on a first face iF1, gets tangent
to a second one iRemovedFace and ends with tangency to a third one iF2. During
the process the second face iRemovedFace is removed.

Parameters:

iF1
The starting face for the fillet
The following

Boundary object is supported: Face.
iF2
The ending face for the fillet
The following Boundary object is supported: Face.
iRemovedFace
The face used as an intermediate tangent support for the fillet during
its course from iF1 to iF2. This face will be removed at the end of the
filleting operation.
The following Boundary object is supported: Face
Returns:
The created tritangent fillet
Parameters
Returns

TritangentFillet

add_new_surfacic_auto_fillet(i_fillet_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfacicAutoFillet(double iFilletRadius) As
AutoFillet

Creates and returns a new Surfacic autofillet.
Use this method to create autofillet by providing fillet radius
value.

Parameters:

iFilletRadius
The fillet radius

Returns:
The created autofillet
Parameters

i_fillet_radius (float) –

Returns

AutoFillet

add_new_surfacic_circ_pattern(i_shape_to_copy, i_nb_of_copies_in_radial_dir, i_nb_of_copies_in_angular_dir, i_step_in_radial_dir, i_step_in_angular_dir, i_shape_to_copy_position_along_radial_dir, i_shape_to_copy_position_along_angular_dir, i_rotation_center, i_rotation_axis, i_is_reversed_rotation_axis, i_rotation_angle, i_is_radius_aligned, i_complete_crown)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfacicCircPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInRadialDir,
long iNbOfCopiesInAngularDir,
double iStepInRadialDir,
double iStepInAngularDir,
long iShapeToCopyPositionAlongRadialDir,
long iShapeToCopyPositionAlongAngularDir,
Reference iRotationCenter,
Reference iRotationAxis,
boolean iIsReversedRotationAxis,
double iRotationAngle,
boolean iIsRadiusAligned,
boolean iCompleteCrown) As CircPattern

Creates and returns a new gsd circular pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the circular pattern
iNbOfInstancesInRadialDir
The number of times iShapeToCopy will be copied along pattern
radial direction
iNbOfInstancesInAngularDir
The number of times iShapeToCopy will be copied along pattern
angular direction
iStepInRadialDir
The distance that will separate two consecutive copies in the
pattern along its radial direction
iStepInAngularDir
The angle that will separate two consecutive copies in the pattern
along its angular direction
iShapeToCopyPositionAlongRadialDir
Specifies the position of the original shape iShapeToCopy among its
copies along the radial direction
iShapeToCopyPositionAlongAngularDir
Specifies the position of the original shape iShapeToCopy among its
copies along the angular direction
iRotationCenter
The point or vertex that specifies the pattern center of rotation

iRotationAxis
The line or linear edge that specifies the axis around which
instances will be rotated relative to each other
The following

Boundary objects are supported: PlanarFace , CylindricalFace ,
RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.

iIsReversedRotationAxis
The boolean flag indicating wether the natural orientation of
iRotationAxis should be used to orient the pattern operation. A value of true
indicates that iItemToDuplicate are copied in the direction of the natural
orientation of iRotationAxis.
iRotationAngle
The angle applied to the direction iRotationAxis prior to applying the
pattern. The original shape iShapeToCopy is used as the rotation center.
Nevertheless, the copied shapes themselves are not rotated. This allows the
definition of a circular pattern relatively to existing geometry, but not
necessarily parallel to it.
iIsRadiusAligned
The boolean flag that specifies whether the instances of
iItemToDuplicate copied by the pattern should be kept parallel to each other
(True) or if they should be aligned with the radial direction they lie upon
(False).
iCompleteCrown
The boolean flag specifies the mode of angular distribution. True
indicates that the angular step will be equal to 360 degrees iNba.

Returns:
The created circular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_radial_dir (int) –

  • i_nb_of_copies_in_angular_dir (int) –

  • i_step_in_radial_dir (float) –

  • i_step_in_angular_dir (float) –

  • i_shape_to_copy_position_along_radial_dir (int) –

  • i_shape_to_copy_position_along_angular_dir (int) –

  • i_rotation_center (Reference) –

  • i_rotation_axis (Reference) –

  • i_is_reversed_rotation_axis (bool) –

  • i_rotation_angle (float) –

  • i_is_radius_aligned (bool) –

  • i_complete_crown (bool) –

Returns

CircPattern

add_new_surfacic_rect_pattern(i_shape_to_copy, i_nb_of_copies_in_dir1, i_nb_of_copies_in_dir2, i_step_in_dir1, i_step_in_dir2, i_shape_to_copy_position_along_dir1, i_shape_to_copy_position_along_dir2, i_dir1, i_dir2, i_is_reversed_dir1, i_is_reversed_dir2, i_rotation_angle)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfacicRectPattern(AnyObject iShapeToCopy,
long iNbOfCopiesInDir1,
long iNbOfCopiesInDir2,
double iStepInDir1,
double iStepInDir2,
long iShapeToCopyPositionAlongDir1,
long iShapeToCopyPositionAlongDir2,
Reference iDir1,
Reference iDir2,
boolean iIsReversedDir1,
boolean iIsReversedDir2,
double iRotationAngle) As RectPattern

Creates and returns a new GSD rectangular pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the rectangular pattern
iNbOfCopiesInDir1
The number of times iShapeToCopy will be copied along the pattern
first direction
iNbOfCopiesInDir2
The number of times iShapeToCopy will be copied along the pattern
second direction
iStepInDir1
The distance that will separate two consecutive copies in the
pattern along its first direction
iStepInDir2
The distance that will separate two consecutive copies in the
pattern along its second direction
iShapeToCopyPositionAlongDir1
Specifies the position of the original shape iShapeToCopy among its
copies along iDir1
iShapeToCopyPositionAlongDir2
Specifies the position of the original shape iShapeToCopy among its
copies along iDir2
iDir1
The line or linear edge that specifies the pattern first
repartition direction
The following

Boundary objects are supported: PlanarFace, RectilinearTriDimFeatEdge,
RectilinearBiDimFeatEdge.
iDir2
The line or linear edge that specifies the pattern second repartition
direction
The following Boundary objects are supported: PlanarFace,
RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge.
iIsReversedDir1
The boolean flag indicating whether the natural orientation of iDir1
should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir1.

iIsReversedDir2
The boolean flag indicating whether the natural orientation of iDir2
should be used to orient the pattern operation. True indicates that
iShapeToCopy is copied in the direction of the natural orientation of iDir2.

iRotationAngle
The angle applied to both directions iDir1 and iDir2 prior to applying
the pattern. The original shape iShapeToCopy is used as the rotation center.
Nevertheless, the copied shapes themselves are not rotated. This allows the
definition of a rectangular pattern relatively to existing geometry, but not
necessarily parallel to it.
Returns:
The created rectangular pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies_in_dir1 (int) –

  • i_nb_of_copies_in_dir2 (int) –

  • i_step_in_dir1 (float) –

  • i_step_in_dir2 (float) –

  • i_shape_to_copy_position_along_dir1 (int) –

  • i_shape_to_copy_position_along_dir2 (int) –

  • i_dir1 (Reference) –

  • i_dir2 (Reference) –

  • i_is_reversed_dir1 (bool) –

  • i_is_reversed_dir2 (bool) –

  • i_rotation_angle (float) –

Returns

RectPattern

add_new_surfacic_sew_surface(i_type, i_support_surface, i_sewing_element, i_sewing_side)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfacicSewSurface(long iType,
Reference iSupportSurface,
Reference iSewingElement,
CatSplitSide iSewingSide) As SewSurface

Creates and returns a new volume sewing operation within the current
OGS/GS.

Parameters:

iType
Parameter to determine the sewing type. For Volume sewing Type = 4
iSupportSurface
The surfacic support on which sew operation will be performed

iSewingElement
The face or skin or surface that will be sewn on the current volume
support
iSewingSide
The specification for which side of the current volume should be
kept at the end of the sewing operation

Returns:
The created sewing operation
Parameters
  • i_type (int) –

  • i_support_surface (Reference) –

  • i_sewing_element (Reference) –

  • i_sewing_side (CatSplitSide) –

Returns

SewSurface

add_new_surfacic_user_pattern(i_shape_to_copy, i_nb_of_copies)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewSurfacicUserPattern(AnyObject iShapeToCopy,
long iNbOfCopies) As UserPattern

Creates and returns a new GSD user pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the user pattern
iNbOfCopies
The number of times iShapeToCopy will be copied

Returns:
The created user pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies (int) –

Returns

UserPattern

add_new_thick_surface(i_offset_element, i_isens_offset, i_top_offset, i_bot_offset)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewThickSurface(Reference iOffsetElement,
long iIsensOffset,
double iTopOffset,
double iBotOffset) As ThickSurface

Creates and returns a new ThickSurface feature.

Parameters:

iOffsetElement
The skin that will be thicken and added with the current body

iIsensOffset
The direction of the offset in regard to the direction of the
normal
iTopOffset
The Offset between the iOffsetElement and the upper skin of the
resulting feature
iBotOffset
The Offset between the iOffsetElement and the lower skin of the
resulting feature

Returns:
The created ThickSurface feature
Parameters
  • i_offset_element (Reference) –

  • i_isens_offset (int) –

  • i_top_offset (float) –

  • i_bot_offset (float) –

Returns

ThickSurface

add_new_thickness(i_face_to_thicken, i_offset)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewThickness(Reference iFaceToThicken,
double iOffset) As Thickness

Creates and returns a new thickness within the current
body.

Parameters:

iFaceToThicken
The first face to thicken in the thickening
process.
New faces to thicken can be added to the thickness afterwards by
using methods offered by the created thickness
The following

Boundary object is supported: Face.
iOffset
The thickness of material to be added on the external side of the face
iFaceToThicken during the thickening process
Returns:
The created thickness
Parameters
  • i_face_to_thicken (Reference) –

  • i_offset (float) –

Returns

Thickness

add_new_thread_with_out_ref()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewThreadWithOutRef() As Thread

Creates and returns a new thread/tap within the current
body.

Returns:
The created Thread
Returns

Thread

add_new_thread_with_ref(i_lateral_face, i_limit_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewThreadWithRef(Reference iLateralFace,
Reference iLimitFace) As Thread

Creates and returns a new thread/tap within the current
body.

Parameters:

iLateralFace
The Face defining the support of thread/tap
The following

Boundary object is supported: Face.
iLimitFacee
The Face defining the origin of the thread.
The following Boundary object is supported:
PlanarFace.
Returns:
The created Thread
Parameters
Returns

Thread

add_new_trim(i_body_to_trim)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewTrim(Body iBodyToTrim) As Trim

Creates and returns a new Trim operation within the current
body.

Parameters:

iBodyToTrim
The body to Trim with current body.

Returns:
The created Trim operation
Parameters

i_body_to_trim (Body) –

Returns

Trim

add_new_tritangent_fillet(i_f1, i_f2, i_removed_face)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewTritangentFillet(Reference iF1,
Reference iF2,
Reference iRemovedFace) As TritangentFillet

Deprecated:
V5R14 #AddNewTritangentFillet use AddNewSolidTritangentFillet or
AddNewSurfaceTritangentFillet depending on the type of fillet you want to
create
Parameters
Returns

TritangentFillet

add_new_user_pattern(i_shape_to_copy, i_nb_of_copies)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewUserPattern(AnyObject iShapeToCopy,
long iNbOfCopies) As UserPattern

Creates and returns a new user pattern within the current
body.

Parameters:

iShapeToCopy
The shape to be copied by the user pattern
iNbOfCopies
The number of times iShapeToCopy will be copied

Returns:
The created user pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies (int) –

Returns

UserPattern

add_new_user_patternof_list(i_shape_to_copy, i_nb_of_copies)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewUserPatternofList(AnyObject iShapeToCopy,
long iNbOfCopies) As UserPattern

V5R8 Only: Creates and returns a new user pattern within the current body
using a list of shapes.

Parameters:

iShapeToCopy
The shape to be copied by the user pattern Others shapes will be
add by put_ItemToCopy with CATIAPattern interface
iNbOfCopies
The number of times iShapeToCopy will be copied

Returns:
The created user pattern
Parameters
  • i_shape_to_copy (AnyObject) –

  • i_nb_of_copies (int) –

Returns

UserPattern

add_new_volume_add(i_body1, i_body2, i_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeAdd(Reference iBody1,
Reference iBody2,
double iType) As Add

Creates and returns a Volumic Add feature.

Parameters:

iBody1
The volume or body to be modified.
iBody2
The volume or body to be operated.
iType
iType = 0 if Part Design, = 4 if GSD.

Returns:
The created Volumic Add feature.
Parameters
Returns

Add

add_new_volume_close_surface(i_close_element)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeCloseSurface(Reference iCloseElement) As
CloseSurface

Creates and returns a new VolumeCloseSurface feature.

Parameters:

iCloseElement
The skin that will be closed and add with the current body


Returns:
The created CloseSurface feature
Parameters

i_close_element (Reference) –

Returns

CloseSurface

add_new_volume_intersect(i_body1, i_body2, i_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeIntersect(Reference iBody1,
Reference iBody2,
double iType) As Intersect

Creates and returns a Volumic Intersect feature.

Parameters:

iBody1
The volume or body to be modified.
iBody2
The volume or body to be operated.
iType
iType = 0 if Part Design, = 4 if GSD.

Returns:
The created Volumic Intersect feature.
Parameters
Returns

Intersect

add_new_volume_remove(i_body1, i_body2, i_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeRemove(Reference iBody1,
Reference iBody2,
double iType) As Remove

Creates and returns a Volumic Remove feature.

Parameters:

iBody1
The volume or body to be modified.
iBody2
The volume or body to be operated.
iType
iType = 0 if Part Design, = 4 if GSD.

Returns:
The created Volumic Remove feature.
Parameters
Returns

Remove

add_new_volume_sew_surface(i_type, i_support_volume, i_sewing_element, i_sewing_side)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeSewSurface(long iType,
Reference iSupportVolume,
Reference iSewingElement,
CatSplitSide iSewingSide) As SewSurface

Creates and returns a new volume sewing operation within the current
OGS/GS.

Parameters:

iType
Parameter to determine the sewing type. For Volume sewing Type = 4
iSupportVolume
The volume support on which sew operation will be performed

iSewingElement
The face or skin or surface that will be sewn on the current volume
support
iSewingSide
The specification for which side of the current volume should be
kept at the end of the sewing operation

Returns:
The created sewing operation
Parameters
  • i_type (int) –

  • i_support_volume (Reference) –

  • i_sewing_element (Reference) –

  • i_sewing_side (CatSplitSide) –

Returns

SewSurface

add_new_volume_shell(i_face_to_remove, i_internal_thickness, i_external_thickness, i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeShell(Reference iFaceToRemove,
double iInternalThickness,
double iExternalThickness,
Reference iVolumeSupport) As Shell

Creates and returns a Volumic Shell feature.

Parameters:

iFacesToRemove
The Faces of the Volume
iFacesToThicken
The Faces of the Volume
iInternalThickness
The thickness of material to be added on the internal side of all
the faces during the shell process, except for those to be removed

iExternaThickness
The thickness of material to be added on the external side of all
the faces during the shell process, except for those to be removed

iVolumeSupport
The Volume related the faces to remove and faces to thicken


Returns:
The created Volumic Shell.
Parameters
  • i_face_to_remove (Reference) –

  • i_internal_thickness (float) –

  • i_external_thickness (float) –

  • i_volume_support (Reference) –

Returns

Shell

add_new_volume_thick_surface(i_offset_element, i_isens_offset, i_top_offset, i_bot_offset)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeThickSurface(Reference iOffsetElement,
long iIsensOffset,
double iTopOffset,
double iBotOffset) As ThickSurface

Creates and returns a new VolumeThickSurface feature.

Parameters:

iOffsetElement
The skin that will be thicken and added with the current OGS/GS

iIsensOffset
The direction of the offset in regard to the direction of the
normal
iTopOffset
The Offset between the iOffsetElement and the upper skin of the
resulting feature
iBotOffset
The Offset between the iOffsetElement and the lower skin of the
resulting feature

Returns:
The created ThickSurface feature
Parameters
  • i_offset_element (Reference) –

  • i_isens_offset (int) –

  • i_top_offset (float) –

  • i_bot_offset (float) –

Returns

ThickSurface

add_new_volume_thickness(i_face_to_thicken, i_offset, i_type, i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeThickness(Reference iFaceToThicken,
double iOffset,
long iType,
Reference iVolumeSupport) As Thickness

Creates and returns a volume new thickness within the current GS or
OGS.

Parameters:

iFaceToThicken
The first face to thicken in the thickening
process.
New faces to thicken can be added to the thickness afterwards by
using methods offered by the created thickness
The following

Boundary object is supported: Face.
iOffset
The thickness of material to be added on the external side of the face
iFaceToThicken during the thickening process
iType
The mode of thickness creation (4=Volume)
iVolumeSupport
The support volume for volumic draft
Returns:
The created thickness
Parameters
  • i_face_to_thicken (Reference) –

  • i_offset (float) –

  • i_type (int) –

  • i_volume_support (Reference) –

Returns

Thickness

add_new_volume_trim(i_support_volume, i_cutting_volume)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumeTrim(Reference iSupportVolume,
Reference iCuttingVolume) As Trim

Creates and returns a new Volume Trim operation within the
GS/OGS.

Parameters:

iSupportVolume
The Support Volume
iCutttingVolume
The trimming Volume

Returns:
The created Trim operation
Parameters
Returns

Trim

add_new_volumic_draft(i_face_to_draft, i_neutral, i_neutral_mode, i_parting, i_dir_x, i_dir_y, i_dir_z, i_mode, i_angle, i_multiselection_mode, i_type, i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func AddNewVolumicDraft(Reference iFaceToDraft,
Reference iNeutral,
CatDraftNeutralPropagationMode iNeutralMode,
Reference iParting,
double iDirX,
double iDirY,
double iDirZ,
CatDraftMode iMode,
double iAngle,
CatDraftMultiselectionMode iMultiselectionMode,
long iType,
Reference iVolumeSupport) As Draft

Creates and returns a new volume draft within the current
body.
The draft needs a reference face on the body. This face will remain
unchanged in the draft operation, while faces adjacent to it and specified for
drafting will be rotated by the draft angle.

Parameters:

iFaceToDraft
The first face to draft in the body. This face should be adjacent
to the iFaceToDraft face. If several faces are to be drafted, only the first
one is specified here, the others being inferred by propagating the draft
operation onto faces adjacent to this first face. This is controlled by the
iNeutralMode argument.
The following

Boundary object is supported: Face.
iNeutral
The reference face for the draft. The draft needs a reference face on
the body, that will remain unchanged in the draft operation, while faces
adjacent to it and specified for drafting will be rotated according to the
draft angle iAngle.
The following Boundary object is supported:
PlanarFace.
iNeutralMode
Controls if and how the drafting operation should be propagated beyond
the first face to draft iFaceToDraft to other adjacent faces.

iParting
The draft parting plane, face or surface. It specifies the element
within the body to draft that represents the bottom of the mold. This element
can be located either somewhere in the middle of the body or be one of its
boundary faces. When located in the middle of the body, it crosses the faces to
draft, and as a result, those faces are drafted with a positive angle on one
side of the parting surface, and with a negative angle on the other
side.
The following Boundary object is supported:
PlanarFace.
iDirX,iDirY,iDirZ
The X, Y, and Z components of the absolute vector representing the
drafting direction (i.e. the mold extraction direction).

iMode
The draft connecting mode to its reference face iFaceToDraft

iAngle
The draft angle
iMultiselectionMode.
The elements to be drafted can be selected explicitly or can implicitly
selected as neighbors of the neutral face
iType
The mode of draft creation (4=Volume)
iVolumeSupport
The support volume for volumic draft
Returns:
The created draft
Parameters
  • i_face_to_draft (Reference) –

  • i_neutral (Reference) –

  • i_neutral_mode (CatDraftNeutralPropagationMode) –

  • i_parting (Reference) –

  • i_dir_x (float) –

  • i_dir_y (float) –

  • i_dir_z (float) –

  • i_mode (CatDraftMode) –

  • i_angle (float) –

  • i_multiselection_mode (CatDraftMultiselectionMode) –

  • i_type (int) –

  • i_volume_support (Reference) –

Returns

Draft

shell

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.shell.Shell(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Shell

Represents the shell shape.
A shell shape is made up of a list of faces to process and two thickness
parameters.
add_face_to_remove(i_face_to_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToRemove(Reference iFaceToRemove)

Adds a new face to those to be removed by the shell
process.

Parameters:

iFaceToRemove
The face to be removed
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to be removed in the shell
firstShell:

call firstShell.AddFaceToRemove(face)
Parameters

i_face_to_remove (Reference) –

Returns

None

add_face_with_different_thickness(i_face_to_thicken)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceWithDifferentThickness(Reference
iFaceToThicken)

Adds a new face to be thicken with different offset
values.

Parameters:

iFaceToThicken
The face to be thicken with different offset
values
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to be thicken with different
offset values in the shell firstShell:

call firstShell.AddFaceWithDifferentThickness(face)
Parameters

i_face_to_thicken (Reference) –

Returns

None

property external_thickness

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ExternalThickness() As Length (Read Only)

Returns the shell external thickness.

Example:
The following example returns in extThick the external thickness of the
shell firstShell:

Set extThick = firstShell.ExternalThickness
Returns

Length

property faces_to_remove

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FacesToRemove() As References (Read Only)

Returns the collection of faces to be removed by the shell
process.

Example:
The following example returns in list the faces to be removed from the
shell firstShell:

Set list = firstShell.FacesToRemove
Returns

References

property internal_thickness

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property InternalThickness() As Length (Read Only)

Returns the shell internal thickness.

Example:
The following example returns in intThick the internal thickness of the
shell firstShell:

Set intThick = firstShell.InternalThickness
Returns

Length

remove_face_with_different_thickness(i_face_to_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub RemoveFaceWithDifferentThickness(Reference
iFaceToRemove)

Removes an existing face from those to be thicken with different offset
values by the shell process.

Parameters:

iFaceToRemove
The face to be removed from the shell
specifications
The following

Boundary object is supported: Face.

Example:
The following example removes the face face from the list of faces in the
shell firstShell:

call firstShell.RemoveFaceWithDifferentThickness(face)
Parameters

i_face_to_remove (Reference) –

Returns

None

set_volume_support(i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetVolumeSupport(Reference iVolumeSupport)

Set the Support Volume of the faces to modify during Shell operation.
Parameters

i_volume_support (Reference) –

Returns

None

withdraw_face_to_remove(i_face_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToRemove(Reference iFaceToWithdraw)

Withdraws an existing face from those to be removed by the shell
process.

Parameters:

iFaceToWithdraw
The face to be withdrawn from the shell
The following

Boundary object is supported: Face.

Example:
The following example removes the face face from the list of faces in the
shell firstShell:

call firstShell.WithdrawFaceToRemove(face)
Parameters

i_face_to_withdraw (Reference) –

Returns

None

sketch_based_shape

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.sketch_based_shape.SketchBasedShape(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
SketchBasedShape

Represents the shapes based on sketched 2D geometry.
It is the base object for prisms, holes, revolutions, stiffeners, and
sweeps.

See also:
Prism, Hole, Revolution, Stiffener, Sweep
set_profile_element(i_profile_element)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetProfileElement(Reference iProfileElement)

Returns or sets a profile element.
Parameters

i_profile_element (Reference) –

Returns

None

property sketch

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Sketch() As Sketch (Read Only)

Returns the sketch the shape is based on.

Example:
The following example returns the sketch a pad named firstPad is based
on:

Set sketchPad = firstPad.Sketch
Returns

Sketch

slot

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.slot.Slot(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
PartInterfaces.Sweep
Slot

Represents the slot shape.
The slot shape is made up of a profile represented by a sketch swept along a
center curve represented by another sketch. This is a “negative” shape: it
removes material from the body it belongs to. The profile sketch is usually
drawn on another shape face.

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

solid_combine

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.solid_combine.SolidCombine(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
SolidCombine

The interface to access a CATIASolidCombine.
property first_component_direction

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstComponentDirection() As Reference

Returns or sets the direction of first component of
SolidCombine.

Example:
The following example returns in firstDirection the direction of first
component of firstSolidCombine SolidCombine feature, and then sets it to the
firstDirection2 direction element.

Set firstDirection = firstSolidCombine.FirstComponentDirection
Set firstSolidCombine.FirstComponentDirection = firstDirection2
Returns

Reference

property first_component_profile

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstComponentProfile() As Reference

Returns or sets the profile of first component of
SolidCombine.

Example:
The following example returns in firstProfile the profile of first
component of firstSolidCombine SolidCombine feature, and then sets it to the
firstProfile2 profile element:

Set firstProfile = firstSolidCombine.FirstComponentProfile
Set firstSolidCombine.FirstComponentProfile = firstProfile2
Returns

Reference

property second_component_direction

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondComponentDirection() As Reference

Returns or sets the direction of second component of
SolidCombine.

Example:
The following example returns in secondDirection the direction of
second component of firstSolidCombine SolidCombine feature, and then sets it to
the secondDirection2 direction element.

Set secondDirection = firstSolidCombine.SecondComponentDirection
Set firstSolidCombine.SecondComponentDirection = secondDirection2
Returns

Reference

property second_component_profile

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondComponentProfile() As Reference

Returns or sets the profile of second component of
SolidCombine.

Example:
The following example returns in secondProfile the profile of second
component of firstSolidCombine SolidCombine feature, and then sets it to the
secondProfile2 profile element:

Set secondProfile = firstSolidCombine.SecondComponentProfile
Set firstSolidCombine.SecondComponentProfile = secondProfile2
Returns

Reference

split

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.split.Split(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SurfaceBasedShape
Split

Represents the split operation.
It splits a shape using a splitting element, such as a surface, a face or a
plane.
property splitting_side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SplittingSide() As CatSplitSide

Returns or sets the splitting side . The splitting side is the side of the
splitting element kept after the split. A positive side refers to the same
orientation than the splitting element normal vector.

Example:
The following example returns in sptSide the splitting side of the
split shape mySplit, and then sets it to
catPositiveSide:

Set sptSide = mySplit.SplittingSide
mySplit.SplittingSide = catPositiveSide
Returns

enum cat_split_side

stiffener

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.stiffener.Stiffener(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
Stiffener

Represents the stiffener shape.
A stiffener is made up of a sketch used as the stiffener profile, that is
extruded (offset) and that fills the nearest shape. This is a “positive” shape:
it adds material to the body it belongs to.
property is_from_top

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsFromTop() As boolean

Returns or sets whether the stiffener is From Side or From
Top.
True if the stiffener is From Top stiffener with respect to the base
sketch. False if the stiffener is From Side stiffener with respect to the base
sketch.

Example:
The following example returns in FromTopFlag whether the firstStiffener
stiffener is From Top, and then sets it as From Top stiffener with respect to
its base sketch:

Set FromTopFlag = firstStiffener.IsFromTop
firstStiffener.IsFromTop = True
Returns

bool

property is_symmetric

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsSymmetric() As boolean

Returns or sets whether the stiffener is symmetric.
True if the stiffener is symmetric with respect to the base
sketch.

Example:
The following example returns in symFlag whether the firstStiffener
stiffener is symmetric, and then sets it as symmetric with respect to its base
sketch:

Set symFlag = firstStiffener.IsSymmetric
firstStiffener.IsSymmetric = True
Returns

bool

reverse_depth()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub ReverseDepth()

Reverses the stiffener direction. This is useful for finding the shape to
reach.

Example:
The following example reverses the current direction of the
firstStiffener stiffener:

firstStiffener.ReverseDepth
Returns

None

reverse_thickness()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub ReverseThickness()

Reverses the stiffener thickness direction. The stiffener thickness is
swapped with respect to the base sketch.

Example:
The following example reverses the current direction of the
firstStiffener stiffener:

firstStiffener.ReverseThickness
Returns

None

property thickness

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Thickness() As Length (Read Only)

Returns the stiffener thickness. This is half of the thickness if the
stiffener is symmetrical, and the thickness otherwise.

Example:
The following example returns in thickness the thickness of the
firstStiffener stiffener:

Set thickness = firstStiffener.Thickness
Returns

Length

property thickness_from_top

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThicknessFromTop() As Length (Read Only)

Returns the stiffener thickness top in case of From Top stiffener. This is
equal to first thickness if the stiffener is symmetrical,

Example:
The following example returns in thicknessfromtop the thickness of the
firstStiffener stiffener:

Set thicknessfromtop = firstStiffener.ThicknessFromTop
Returns

Length

surface_based_shape

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.surface_based_shape.SurfaceBasedShape(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
SurfaceBasedShape

Represents the shapes based on Surface.
It is the base object for Split , SewSurface , CloseSurface and ThickSurface
shapes.

See also:
Split, SewSurface, CloseSurface, ThickSurface
property surface

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Surface() As Reference

Returns or sets the surface.
Returns

Reference

sweep

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.sweep.Sweep(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SketchBasedShape
Sweep

Represents the sweep shape.
It is the base object for ribs and slots.
property anchor_dir_reverse

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AnchorDirReverse() As boolean

Returns the Sweep AnchorDirReverse flag (for Sweep Move Profile
only).
It returns TRUE if Anchor direction is reversed , FALSE if
not.

Returns:
oAnchorDirReverse The oAnchorDirReverse flag as a
boolean

Example:
Returns

bool

property center_curve

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CenterCurve() As Sketch (Read Only)

Returns the sketch used as the sweep center curve. The sweep is built along
this sketch.

Example:
The following example returns in centerCurve the sketch used as center
curve by the firstSweep sweep object:

Set centerCurve = firstSweep.CenterCurve
Returns

Sketch

property center_curve_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property CenterCurveElement() As Reference

Returns or sets the center curve .
To set the property, you can use the following Boundary object:
TriDimFeatEdge.
Returns

Reference

property is_thin

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property IsThin() As boolean

Returns the Sweep thin flag.
It returns TRUE if the Sweep is a thin Sweep , FALSE if
not.

Returns:
oIsThin The thin flag as a boolean

Example:
The following example saves in thinFlag the thin flag of Sweep
firstSweep, and then sets it so that it will be now thin
:

Set thinFlag = firstSweep.IsThin
firstSweep.IsThin = TRUE
Returns

bool

property merge_end

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MergeEnd() As boolean

Returns the Sweep merge end flag (for thin Sweep only).
It returns TRUE if merge ends is required , FALSE if not.

Returns:
oIsMergeEnd The merge end flag as a boolean

Example:
The following example saves in MergeEndFlag the merge end flag of
Sweep firstSweep, and then sets it so that merge end will be required
:

Set MergeEndFlag = firstSweep.IsMergeEnd
firstSweep.IsMergeEnd = TRUE
Returns

bool

property merge_mode

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MergeMode() As CatMergeMode

Returns or sets the end mode .
Returns

enum cat_merge_mode

property move_profile_to_path

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property MoveProfileToPath() As boolean

Returns the Sweep MoveProfileToPath flag (for Sweep Move Profile
only).
It returns TRUE if move profile is required , FALSE if
not.

Returns:
oIsMoveProfileToPath The MoveProfileToPath flag as a
boolean

Example:
Returns

bool

property neutral_fiber

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NeutralFiber() As boolean

Returns the Sweep neutral fiber flag (for thin Sweep
only).
It returns TRUE if the Sweep is a neutral fiber Sweep , FALSE if
not.

Returns:
oIsNeutralFiber The neutral fiber flag as a boolean

Example:
The following example saves in NeutralFiberFlag the neutral fiber
flag of Sweep firstSweep, and then sets it so that it will be now neutral fiber
:

Set NeutralFiberFlag = firstSweep.IsNeutralFiber
firstSweep.IsNeutralFiber = TRUE
Returns

bool

property normal_axis_dir_reverse

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property NormalAxisDirReverse() As boolean

Returns the Sweep NormalAxisDirReverse flag (for Sweep Move Profile
only).
It returns TRUE if Normal Axis direction is reversed , FALSE if
not.

Returns:
oNormalAxisDirReverse The oNormalAxisDirReverse flag as a
boolean

Example:
Returns

bool

property pulling_dir_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property PullingDirElement() As Reference

Returns or sets the pulling direction .
To set the property, you can use one of the following Boundary objects:
PlanarFace, RectilinearTriDimFeatEdge, RectilinearBiDimFeatEdge,
RectilinearMonoDimFeatEdge.
Returns

Reference

property reference_surface_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ReferenceSurfaceElement() As Reference

Returns or sets the reference surface .
To set the property, you can use the following Boundary object: Face.
Returns

Reference

set_keep_angle_option()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetKeepAngleOption()

Actives KeepAngleOption.
Returns

None

symmetry

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.symmetry.Symmetry(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Symmetry

Represents the shape symmetry feature object.
This solid feature is created from an underlying HybridShapeSymmetry aggregated
by the Symmetry. Role: To access the data of the symmetry shape feature object.
The data includes:

The element to be transformed
The reference element which can be a point, a line or a
plane

Use the CATIAShapeFactory to create ShapeFeature object.

See also:
ShapeFactory
property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeSymmetry.

Example:
The following example explains how to retrieve the underlying
HybridShape Symmetry

Dim oHybridShape as AnyObject
Set oHybridShape=oSymmetry.HybridShape
oHybridShape.SectionCoupling = 2
Returns

HybridShape

thick_surface

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.thick_surface.ThickSurface(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.SurfaceBasedShape
ThickSurface

Represents the ThickSurface feature.
It thicks surface using an offset element (such as a surface or a skin) and two
offset values TopOffset and Botoffset. TopOffset is the offset between the
offset element and the top skin of the feature. BotOffset is the offset between
the offset element and the bottom skin of the feature.
property bot_offset

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property BotOffset() As Length (Read Only)

Returns the value of the bottom offset.

Example:
The following example returns in botoffset the bottom offset of the
thicksurface firstThickSurface:

Set botoffset = firstThickSurface.BotOffset
Returns

Length

property offset_side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property OffsetSide() As long (Read Only)

Returns the offset direction (defines in regards of the normal direction)
.

Example:
The following example returns in offsetside the side of the
ThickSurface firstThickSurface:

Set offsetside = firstThickSurface.OffsetSide
Returns

int

swap_offset_side()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub swap_OffsetSide()

Swap the side of the offset.

Example:
The following example changes the side of the ThickSurface
firstThickSurface:

call firstThickSurface.swap_OffsetSide()


Copyright © 1999-2011, Dassault Systèmes. All rights
reserved.
Returns

None

property top_offset

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property TopOffset() As Length (Read Only)

Returns the value of the top offset.

Example:
The following example returns in topoffset the top offset of the
ThickSurface firstThickSurface:

Set topoffset = firstThickSurface.TopOffset
Returns

Length

thickness

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.thickness.Thickness(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Thickness

Represents the thickness shape.
The thickness shape is made up of a collection of faces to process and an
offset parameter.
add_face_to_thicken(i_face_to_thicken)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToThicken(Reference iFaceToThicken)

Adds a new face to be thickened.

Parameters:

iFaceToThicken
The new face to process
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to thicken for the thickness
firstThickness:

call firstThickness.AddFaceToThicken(face)
Parameters

i_face_to_thicken (Reference) –

Returns

None

add_face_with_different_thickness(i_face_to_thicken)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceWithDifferentThickness(Reference
iFaceToThicken)

Adds a new face to thicken with a different offset value.

Parameters:

iFaceToThicken
The new face to process
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to thicken with a different
offset value for the thickness firstThickness:

call firstThickness.AddFaceWithDifferentThickness(face)
Parameters

i_face_to_thicken (Reference) –

Returns

None

property faces_to_thicken

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FacesToThicken() As References (Read Only)

Returns the collection of faces to be thickened.

Example:
The following example returns in list the list of faces of the
thickness firstThickness:

Set list = firstThickness.FacesToThicken
Returns

References

property offset

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Offset() As Length (Read Only)

Returns the thickness offset.

Example:
The following example returns in offset the offset of the thickness
firstThickness:

Set offset = firstThickness.Offset
Returns

Length

remove_face_with_different_thickness(i_face_to_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub RemoveFaceWithDifferentThickness(Reference
iFaceToRemove)

Removes an existing thickened face.

Parameters:

iFaceToRemove
The face to remove
The following

Boundary object is supported: Face.

Example:
The following example removes the existing face thickened face from the
thickness firstThickness:

call firstThickness.RemoveFaceWithDifferentThickness(face)(face)
Parameters

i_face_to_remove (Reference) –

Returns

None

set_volume_support(i_volume_support)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetVolumeSupport(Reference iVolumeSupport)

Set support of Thickness feature.
Parameters

i_volume_support (Reference) –

Returns

None

withdraw_face_to_thicken(i_face_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToThicken(Reference iFaceToWithdraw)

Withdraws an existing thickened face.

Parameters:

iFaceToWithdraw
The face to withdraw
The following

Boundary object is supported: Face.

Example:
The following example withdraws the existing face thickened face from the
thickness firstThickness:

call firstThickness.WithdrawFaceToThicken(face)
Parameters

i_face_to_withdraw (Reference) –

Returns

None

thread

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.thread.Thread(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
Thread

Represents the Thread feature.
It threads or taps cylindrical surface .
create_standard_thread_design_table(i_standard_type)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub CreateStandardThreadDesignTable(CatThreadStandard
iStandardType)

Creates a Standard Thread design table .

Parameters:

iStandardType
Standard type for thread (see

CatThreadStandard for list of possible types)

Example:
The following example creates a standard table for MetricThinPitch
for thread firstthread:

firstthread.CreateStandardThreadDesignTable
catMetricThinPitch
Parameters

i_standard_type (CatThreadStandard) –

Returns

None

create_user_standard_design_table(i_standard_name, i_path)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub CreateUserStandardDesignTable(CATBSTR iStandardName,
CATBSTR iPath)

Creates a UserStandard Thread design table .

Parameters:

iStandardName
Name of the UserStandard thread. iStandardName should be empty if
filepath is to be defined.
iPath
Path of the UserStandard file. iPath is empty if the filepath is
already defined through CATReffilesPath.

Example1:
The following example creates a standard table for UserStandard
for thread firstThread. The file path is already defined thru
CATReffilesPath:

firstThread.CreateUserStandardDesignTable
“UserStandard”,”“

Example2:
The following example creates a standard table for UserStandard
for thread firstThread when file path is not defined thru
CATReffilesPath:

firstThread.CreateUserStandardDesignTable
“”,”E://user//standard//UserStandard.txt”
Parameters
  • i_standard_name (str) –

  • i_path (str) –

Returns

None

property depth

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Depth() As double

Returns the thread/tap depth.

Returns:
oDepth Value of the thread/tap depth

Example:
The following example returns in Depth the depth of thread
firstthread:

Set Depth = firstthread.Depth
Returns

float

property diameter

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Diameter() As double

Returns the thread/tap diameter.

Returns:
oDiameter Value of the thread/tap diameter

Example:
The following example returns in ThreadDiameter the diameter of
thread firstthread:

Set ThreadDiameter = firstthread.Diameter
Returns

float

property lateral_face_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property LateralFaceElement() As Reference

Returns or sets the lateral face (must be cylindrical) .
To set the property, you can use the following Boundary object: Face.
Returns

Reference

property limit_face_element

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property LimitFaceElement() As Reference

Returns or sets the limit face (must be planar ) .
To set the property, you can use the following Boundary object: PlanarFace.
Returns

Reference

property pitch

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Pitch() As double

Returns the thread/tap pitch.

Returns:
oPitch Value of the thread/tap pitch

Example:
The following example returns in ThreadPitch the thread pitch of
thread firstthread:

Set ThreadPitch = firstthread.ThreadPitch
Returns

float

reverse_direction()

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub ReverseDirection()

Swap the direction of the thread or the tap.
Returns

None

set_explicit_polarity(i_thread_polarity)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub SetExplicitPolarity(CatThreadPolarity iThreadPolarity)

Sets the thread polarity explicit. Thread polarity is no more evaluated
implicitly on basis of support face polarity

Parameters:

iThreadPolarity
Standard type for thread (see

CatThreadPolarity for list of possible types)

Example:
The following example sets the thread polarity to Tap explicitly
thread firstthread:

firstthread.SetExplicitPolarity catTap
Parameters

i_thread_polarity (CatThreadPolarity) –

Returns

None

property side

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property Side() As CatThreadSide

Returns the thread or tap side.

Returns:
oThreadSide The thread/tap side (see CatThreadSide for list of possible
sides)

Example:
The following example returns in ThreadSide the thread/tap side of
thread firstthread:

Set ThreadSide = firstthreadoThreadSide
Returns

enum cat_thread_side

property thread_description

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ThreadDescription() As StrParam (Read Only)

Returns the thread/tap description parameter. This call is valid only when
a standard/user design table created

Returns:
oThreadDescParam A Parameter object controlling the thread/tap
description (see StrParam for more information)

Example:
The following example returns in threadDescription the thread
description (M12 etc) of thread firstthread:

Set threadDescription = firstthread.ThreadDescription
Returns

StrParam

transformation_shape

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.transformation_shape.TransformationShape(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
TransformationShape

Represents the shapes based on a transformation of another
shape.
It is the base object for mirrors and patterns.

See also:
Mirror, Pattern, RectPattern, CircPattern

Copyright © 1999-2011, Dassault Systèmes. All rights reserved.

translate

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.translate.Translate(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
Translate

Represents the hybrid shape translate feature object.
This solid feature is created from an underlying HybridShapeTranslate
aggregated by the Translate. Role: To access the data of the hybrid shape
translate feature object. This data includes:

The element to translate
The translation direction
The translation distance and its value

Use the CATIAHybridShapeFactory to create HybridShapeFeature
object.

See also:
HybridShapeFactory
property hybrid_shape

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property HybridShape() As HybridShape (Read Only)

Gets the underlying HybridShapeTranslate.

Example:
The following example explains how to retrieve the underlying
HybridShape Translate

Dim oHybridShape as AnyObject
Set oHybridShape=oTranslate.HybridShape
oHybridShape.ElemToTranslate = reference1
Returns

HybridShape

trim

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.trim.Trim(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.BooleanShape
Trim

Represents the Trim, or union trim boolean operation.
It is performed between a body and the current shape.
add_face_to_keep(i_face_to_keep)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToKeep(Reference iFaceToKeep)

Adds a new face to be kept (if face is not divided by
operation).

Parameters:

iFaceToKeep
The new face to process
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to Keep for the Trim
firstTrim:

call firstTrim.AddFaceToKeep(face)
Parameters

i_face_to_keep (Reference) –

Returns

None

add_face_to_keep2(i_face_to_keep, i_face_adjacent_for_keep)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToKeep2(Reference iFaceToKeep,
Reference iFaceAdjacentForKeep)

Adds a new face to be kept (if face is divided by
operation).

Parameters:

iFaceToKeep
The new face to process
The following

Boundary object is supported: Face.
iFaceAdjacentForKeep
An adjacent face of iFaceToKeep belonging to the other
operand
The following Boundary object is supported: Face.

Example:
The following example adds the new face face to Keep for the Trim
firstTrim:

call firstTrim.AddFaceToKeep(face)
Parameters
Returns

None

add_face_to_remove(i_face_to_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToRemove(Reference iFaceToRemove)

Adds a new face to be Removed (if face not divided by
operation).

Parameters:

iFaceToRemove
The new face to process
The following

Boundary object is supported: Face.

Example:
The following example adds the new face face to Remove for the Trim
firstTrim:

call firstTrim.AddFaceToRemove(face)
Parameters

i_face_to_remove (Reference) –

Returns

None

add_face_to_remove2(i_face_to_remove, i_face_adjacent_for_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFaceToRemove2(Reference iFaceToRemove,
Reference iFaceAdjacentForRemove)

Adds a new face to be Removed (if face is divided by
operation).

Parameters:

iFaceToRemove
The new face to process
The following

Boundary object is supported: Face.
iFaceAdjacentForRemove
An adjacent face of iFaceToRemove belonging to the other
operand
The following Boundary object is supported: Face.

Example:
The following example adds the new face face to Remove for the Trim
firstTrim:

call firstTrim.AddFaceToRemove(face)
Parameters
Returns

None

withdraw_face_to_keep(i_face_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToKeep(Reference iFaceToWithdraw)

Withdraws an existing Kept face (if face is not divided by operation)
.

Parameters:

iFaceToWithdraw
The face to withdraw
The following

Boundary object is supported: Face.

Example:
The following example withdraws the existing face Kept face from the Trim
firstTrim:

call firstTrim.WithdrawFaceToKeep(face)
Parameters

i_face_to_withdraw (Reference) –

Returns

None

withdraw_face_to_keep2(i_face_to_withdraw, i_face_adjacent_for_keep)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToKeep2(Reference iFaceToWithdraw,
Reference iFaceAdjacentForKeep)

Withdraws an existing Kept face (if face is divided by
operation).

Parameters:

iFaceToWithdraw
The face to withdraw
The following

Boundary object is supported: Face.
iFaceAdjacentForKeep
An adjacent face of iFaceToKeep belonging to the other
operand
The following Boundary object is supported: Face.

Example:
The following example withdraws the existing face Kept face from the Trim
firstTrim:

call firstTrim.WithdrawFaceToKeep(face)
Parameters
Returns

None

withdraw_face_to_remove(i_face_to_withdraw)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToRemove(Reference iFaceToWithdraw)

Withdraws an existing Removed face (if face not divided by
operation).

Parameters:

iFaceToWithdraw
The face to withdraw
The following

Boundary object is supported: Face.

Example:
The following example withdraws the existing face Removed face from the
Trim firstTrim:

call firstTrim.WithdrawFaceToRemove(face)
Parameters

i_face_to_withdraw (Reference) –

Returns

None

withdraw_face_to_remove2(i_face_to_withdraw, i_face_adjacent_for_remove)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawFaceToRemove2(Reference iFaceToWithdraw,
Reference iFaceAdjacentForRemove)

Withdraws an existing Removed face (if face is divided by
operation).

Parameters:

iFaceToWithdraw
The face to withdraw
The following

Boundary object is supported: Face.
iFaceAdjacentForRemove
An adjacent face of iFaceToRemove belonging to the other
operand
The following Boundary object is supported: Face.

Example:
The following example withdraws the existing face Removed face from the
Trim firstTrim:

call firstTrim.WithdrawFaceToRemove(face)
Parameters
Returns

None

tritangent_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.tritangent_fillet.TritangentFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
PartInterfaces.Fillet
TritangentFillet

The Tritangent Fillet feature : a fillet is built between 3 faces,
2 faces will be relimited, the third one (“face to remove”)
will
be used for fillet tangency ; this face will disappear within the resulting
shape.
property face_to_remove

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FaceToRemove() As Reference

Returns the face to be removed by the tritangent fillet.

Returns:
oFaceToRemove The face to be removed by the fillet (@see CATIAReference
for more information)

Example:
The following example returns in removedFace the face to be removed
of
tritangent fillet firstTritangentFillet:

Set removedFace = firstTritangentFillet.FaceToRemove
Returns

Reference

property first_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FirstFace() As Reference

Returns the first face limiting the tritangent fillet.

Returns:
oFirstFace The limiting face (@see CATIAReference for more
information)

Example:
The following example returns in face1 the first limiting face
of
tritangent fillet firstTritangentFillet:

Set face1 = firstTritangentFillet.FirstFace
Returns

Reference

property second_face

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property SecondFace() As Reference

Returns the second face limiting the tritangent fillet.

Returns:
oSecondFace The limiting face (@see CATIAReference for more
information)

Example:
The following example returns in face2 the second limiting face
of
tritangent fillet firstTritangentFillet:

Set face2 = firstTritangentFillet.SecondFace
Returns

Reference

user_pattern

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.user_pattern.UserPattern(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.TransformationShape
PartInterfaces.Pattern
UserPattern

Represents the user pattern.
The shape is copied along user’s positions.
add_feature_to_locate_positions(i_feature_to_locate_positions)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFeatureToLocatePositions(AnyObject
iFeatureToLocatePositions)

Adds a new feature to locate instances.

Parameters:

iFeatureToLocatePositions
The new object containing points of positioning

Example:
The following example adds the new feature feature to locate instances
of the Pattern firstPattern:

call firstPattern.AddFeatureToLocatePositions(object)
Parameters

i_feature_to_locate_positions (AnyObject) –

Returns

None

property anchor_point

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property AnchorPoint() As AnyObject

Returns the anchor point of the user pattern.

Example:
The following example returns in anchor the anchor point of the Pattern
firstPattern:

Set anchor = firstPattern.AnchorPoint
Returns

AnyObject

property feature_to_locate_positions

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FeatureToLocatePositions() As AnyObject (Read
Only)

Returns the collection of feature to locate instances.

Example:
The following example returns in list the list of feature to locate
instances of the Pattern firstPattern:

Set list = firstPattern.FeatureToLocatePositions
Returns

AnyObject

user_repartition

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.user_repartition.UserRepartition(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
PartInterfaces.Repartition
UserRepartition

Represents the User Pattern repartition.
It is made up of a number of times the shape is copied and the location of
instances. The number of times the shape is copied is accessible using the
Repartition.InstancesCount property.
add_feature_to_locate_positions(i_feature_to_locate_positions)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddFeatureToLocatePositions(AnyObject
iFeatureToLocatePositions)

Adds a new feature to locate instances.

Parameters:

iFeatureToLocatePositions
The new face to process

Example:
The following example adds the new feature feature to locate instances
of the Pattern firstPattern:

call firstPattern.AddFeatureToLocatePositions(face)
Parameters

i_feature_to_locate_positions (AnyObject) –

Returns

None

property feature_to_locate_positions

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FeatureToLocatePositions() As AnyObject (Read
Only)

Returns the collection of feature to locate instances.

Example:
The following example returns in list the list of feature to locate
instances of the Pattern firstPattern:

Set list = firstPattern.FeatureToLocatePositions
Returns

AnyObject

var_rad_edge_fillet

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.part_interfaces.var_rad_edge_fillet.VarRadEdgeFillet(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.AnyObject
MecModInterfaces.Shape
PartInterfaces.DressUpShape
PartInterfaces.Fillet
PartInterfaces.EdgeFillet
VarRadEdgeFillet

Represents the edge fillet shape with a variable radius.
The resulting shape is made up of edges fillets controlled by couples of
radius/vertex.
add_edge_to_fillet(i_edge, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddEdgeToFillet(Reference iEdge,
double iRadius)

Adds a new edge to the variable radius edge fillet.

Parameters:

iEdge
The edge to be filleted
The following

Boundary object is supported: TriDimFeatEdge.
iRadius
The radius to impose along the edge. This radius is imposed at both end
points of the edge.

Example:
The following example adds the new edge edge to be filleted to the variable
radius edge fillet firstVarEdgeFillet:

call firstVarEdgeFillet.AddEdgeToFillet(edge, 5.)
Parameters
  • i_edge (Reference) –

  • i_radius (float) –

Returns

None

add_imposed_vertex(i_vertex, i_radius)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub AddImposedVertex(Reference iVertex,
double iRadius)

Adds a new control couple. A control couple is made up of a vertex and a
radius.

Parameters:

iVertex
The vertex where to impose the radius
iRadius
The radius to impose at the given vertex

Example:
The following example adds a new control couple (vertex, radius) to the
variable radius edge fillet firstVarEdgeFillet set with the vertex vertex and a
radius of 50.

call firstVarEdgeFillet.AddImposedVertex(vertex, 50.)
Parameters
  • i_vertex (Reference) –

  • i_radius (float) –

Returns

None

property bitangency_type

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property BitangencyType() As CatFilletBitangencyType

Returns or set the fillet bitangency type.

Parameters:

iType
The type used to perform the fillet : catSphereBitangencyType or catCircleBitangencyType
Returns

enum cat_fillet_bitangency_type

property edges_to_fillet

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property EdgesToFillet() As References (Read Only)

Returns the collection of edges to be filleted.

Example:
The following example returns in edges the edges to fillet of variable
radius edge filletfirstVarEdgeFillet:

Set edges = firstVarEdgeFillet.EdgesToFillet
Returns

References

property fillet_spine

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FilletSpine() As Reference

Returns or set the spine for circle bitangency fillet.

Parameters:

iSpin
The spine to be used for a circle bitangency
fillet
Returns

Reference

property fillet_variation

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property FilletVariation() As CatFilletVariation

Returns or sets the edge fillet radius variation mode.

Example:
The following example returns in mode the radius variation mode of the
variable radius edge filletfirstVarEdgeFillet, and then sets it to
CATLinearFilletVariation so that the radius variation is linear between two
control vertices:

mode = firstVarEdgeFillet.FilletVariation
firstVarEdgeFillet.FilletVariation = CATLinearFilletVariation
Returns

enum cat_fillet_variation

imposed_vertex_radius(i_imposed_vertex)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Func ImposedVertexRadius(Reference iImposedVertex) As
Length

Returns the fillet radius on an imposed vertex.

Parameters:

iImposedVertex
The vertex where to retrieve the fillet radius

Returns:
The fillet radius
Example:
The following example returns in radius the fillet radius of the
variable radius edge fillet firstVarEdgeFillet at the vertex
vertex:

Set radius = firstVarEdgeFillet.ImposedVertexRadius(vertex)
Parameters

i_imposed_vertex (Reference) –

Returns

Length

property imposed_vertices

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)
o Property ImposedVertices() As References (Read Only)

Returns the collection of vertices where a radius has been
imposed.

Example:
The following example returns in vertices the collection of imposed
vertices of the variable radius edge
filletfirstVarEdgeFillet:

Set vertices = firstVarEdgeFillet.ImposedVertices
Returns

References

withdraw_edge_to_fillet(i_edge)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawEdgeToFillet(Reference iEdge)

Withdraws an edge from the variable radius edge fillet.

Parameters:

iEdge
The edge to be withdrawn
The following

Boundary object is supported: TriDimFeatEdge.

Example:
The following example withdraws the edge edge from those to be filleted of
the variable radius edge fillet firstVarEdgeFillet:

call firstVarEdgeFillet.WithdrawEdgeToFillet(edge)
Parameters

i_edge (Reference) –

Returns

None

withdraw_imposed_vertex(i_vertex)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445))
o Sub WithdrawImposedVertex(Reference iVertex)

Withdraws a control couple.

Parameters:

iVertex
The vertex where the radius is imposed

Example:
The following example withdraws the imposed radius on the vertex vertex
for the variable radius edge fillet
firstVarEdgeFillet:

call firstVarEdgeFillet.WithdrawImposedVertex(vertex)
Parameters

i_vertex (Reference) –

Returns

None