Hole Class

class NXOpen.Features.Hole

Bases: NXOpen.Features.RPO

Represents a Hole feature

To create or edit an instance of this class, use NXOpen.Features.HoleFeatureBuilder

New in version NX3.0.0.

Properties

Property Description
AlgorithmVersion Returns the algorithm version of the feature
ContainerFeature Returns the container feature for this feature.
CounterboreDepth Returns the counterbore depth of the hole.
CounterboreDiameter Returns the counterbore diameter of the hole.
CountersinkAngle Returns the countersink angle of the hole.
CountersinkDiameter Returns the countersink diameter of the hole.
Depth Returns the depth of the hole.
Diameter Returns the diameter of the hole.
FeatureType Returns the feature type
IsContainedFeature Returns true if the feature is a contained feature.
IsInternal Returns true if the feature is internal.
IsOccurrence Returns whether this object is an occurrence or not.
JournalIdentifier Returns the identifier that would be recorded in a journal for this object.
Location Returns the location of the feature
Name Returns the custom name of the object.
OwningComponent Returns the owning component, if this object is an occurrence.
OwningPart Returns the owning part of this object
PlacementFace Returns the placement face of the hole.
Prototype Returns the prototype of this object if it is an occurrence.
Suppressed Returns the suppression status of the feature
Tag Returns the Tag for this object.
ThruFace Returns the thru face of the hole.
Timestamp Returns the timestamp of the feature
TipAngle Returns the tip angle of the hole.

Methods

Method Description
BreakWaveLink Break Wave Link Feature
ChangeBooleanType Change Boolean Type
CreateAttributeIterator Create an attribute iterator
DeleteAllAttributesByType Deletes all attributes of a specific type.
DeleteAttributeByTypeAndTitle Deletes an attribute by type and title.
DeleteClueAlerts Delete all clue alerts from the features
DeleteHintAlerts Delete all clue alerts from the features
DeleteInformationalAlerts Delete all informational alerts from the features
DeleteUserAttribute Deletes the first attribute encountered with the given Type, Title.
DeleteUserAttributes Deletes the attributes on the object, if any, that satisfy the given iterator
DeleteWarningAlerts Delete all warning alerts from the features
FindObject Finds the NXOpen.NXObject with the given identifier as recorded in a journal.
GetAllChildren Returns all immediate child features.
GetAttributeTitlesByType Gets all the attribute titles of a specific type.
GetBodies Returns the bodies created by the feature
GetBooleanUserAttribute Gets a boolean attribute by Title and array Index.
GetChildren Returns the immediate child features.
GetComputationalTimeUserAttribute Gets a time attribute by Title and array Index.
GetCounterboreHole Retrieves parameters of counterbore hole.
GetCountersinkHole Retrieves parameters of countersink hole.
GetEdges Returns the edges created by the feature
GetEntities Returns the entities created by the feature.
GetExpressions Returns the expressions created by the feature.
GetFaces Returns the faces created by the feature
GetFeatureClueHintMessages Returns both clue and hint messages of the feature.
GetFeatureClueMessages Returns the feature clue messages.
GetFeatureColor The feature color
GetFeatureErrorMessages Returns the feature error messages.
GetFeatureHintMessages Returns the feature hint messages.
GetFeatureInformationalMessages Returns the feature informational messages.
GetFeatureName Returns the displayed name of the feature.
GetFeatureWarningMessages Returns the feature warning messages.
GetIntegerAttribute Gets an integer attribute by title.
GetIntegerUserAttribute Gets an integer attribute by Title and array Index.
GetNextUserAttribute Gets the next attribute encountered on the object, if any, that satisfies the given iterator.
GetParents Returns the immediate parent features.
GetPdmReferenceAttributeValue Gets the value of PDM Reference attribute for given object.
GetPositioningDimensions Returns array of positioning dimensions attached to the hole
GetRealAttribute Gets a real attribute by title.
GetRealUserAttribute Gets a real attribute by Title and array Index.
GetReferenceAttribute Gets the reference string (not the calculated value) of a string attribute that uses a reference string.
GetSections Queries a feature for list of its sections.
GetSimpleHole Retrieves parameters of simple hole.
GetStringAttribute Gets a string attribute value by title.
GetStringUserAttribute Gets a string attribute by Title and array Index.
GetSubtype Returns the subtype of the hole.
GetTimeAttribute Gets a time attribute by title.
GetTimeUserAttribute Gets a time attribute by Title and array Index.
GetUserAttribute Gets the first attribute encountered on the object, if any, with a given Title, Type and array Index.
GetUserAttributeAsString Gets the first attribute encountered on the object, if any, with a given title, type and array index.
GetUserAttributeCount Gets the count of set attributes on the object, if any, that satisfy the given iterator.
GetUserAttributeLock Determine the lock of the given attribute.
GetUserAttributeSize Gets the size of the first attribute encountered on the object, if any, with a given Title and Type.
GetUserAttributeSourceObjects Returns an array of objects from which this object presents attributes.
GetUserAttributes Gets all the attributes that have been set on the given object, if any, that satisfy the given iterator.
GetUserAttributesAsStrings Gets all the attributes that have been set on the given object.
HasUserAttribute Determines if an attribute exists on the object, that satisfies the given iterator
HideBody Hide the body created by the feature
HideParents Hide the body created by the parent feature
Highlight Highlight the body created by the feature
LogDiagnostic Log a diagnostic alert for this feature
MakeCurrentFeature Make current feature
MakeSketchExternal Make the parent sketch external for reuse by other features.
MakeSketchInternal Make the parent sketch internal if referenced only by this feature.
Print Prints a representation of this object to the system log file.
RemoveForEdit Remove all the feature faces before a NoHistory mode edit.
RemoveParameters Remove Local feature parameters in history free mode.
SetAttribute Creates or modifies an integer attribute.
SetBooleanUserAttribute Creates or modifies a boolean attribute with the option to update or not.
SetGroupActive Set a feature group as active group.
SetName Sets the custom name of the object.
SetPdmReferenceAttribute Sets the value of PDM Reference attribute on the object.
SetReferenceAttribute Creates or modifies a string attribute which uses a reference string.
SetTimeAttribute Creates or modifies a time attribute.
SetTimeUserAttribute Creates or modifies a time attribute with the option to update or not.
SetUserAttribute Creates or modifies an attribute with the option to update or not.
SetUserAttributeLock Lock or unlock the given attribute.
ShowBody Show the body created by the feature.
ShowDimensions Show all feature dimensions of a feature.
ShowParents Show the body created by the parent feature.
Suppress Suppress the feature
Unhighlight Unhighlight the body created by the feature
Unsuppress Unsuppress the feature

Enumerations

HoleSubtype Enumeration Represents the subtype of the hole

Property Detail

CounterboreDepth

Hole.CounterboreDepth

Returns the counterbore depth of the hole.

-------------------------------------

Getter Method

Signature CounterboreDepth

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

CounterboreDiameter

Hole.CounterboreDiameter

Returns the counterbore diameter of the hole.

-------------------------------------

Getter Method

Signature CounterboreDiameter

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

CountersinkAngle

Hole.CountersinkAngle

Returns the countersink angle of the hole.

-------------------------------------

Getter Method

Signature CountersinkAngle

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

CountersinkDiameter

Hole.CountersinkDiameter

Returns the countersink diameter of the hole.

-------------------------------------

Getter Method

Signature CountersinkDiameter

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

Depth

Hole.Depth

Returns the depth of the hole.

-------------------------------------

Getter Method

Signature Depth

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

Diameter

Hole.Diameter

Returns the diameter of the hole.

-------------------------------------

Getter Method

Signature Diameter

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

IsOccurrence

Hole.IsOccurrence

Returns whether this object is an occurrence or not.

-------------------------------------

Getter Method

Signature IsOccurrence

Returns:This object is an occurrence
Return type:bool

New in version NX3.0.0.

License requirements: None.

JournalIdentifier

Hole.JournalIdentifier

Returns the identifier that would be recorded in a journal for this object.

This may not be the same across different releases of the software.

-------------------------------------

Getter Method

Signature JournalIdentifier

Returns:
Return type:str

New in version NX3.0.0.

License requirements: None.

Name

Hole.Name

Returns the custom name of the object.

-------------------------------------

Getter Method

Signature Name

Returns:
Return type:str

New in version NX3.0.0.

License requirements: None.

OwningComponent

Hole.OwningComponent

Returns the owning component, if this object is an occurrence.

-------------------------------------

Getter Method

Signature OwningComponent

Returns:
Return type:NXOpen.Assemblies.Component

New in version NX3.0.0.

License requirements: None.

OwningPart

Hole.OwningPart

Returns the owning part of this object

-------------------------------------

Getter Method

Signature OwningPart

Returns:The owning part of this object or null if it does not have an owner
Return type:NXOpen.BasePart

New in version NX3.0.0.

License requirements: None.

PlacementFace

Hole.PlacementFace

Returns the placement face of the hole.

-------------------------------------

Getter Method

Signature PlacementFace

Returns:
Return type:NXOpen.ISurface

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

Prototype

Hole.Prototype

Returns the prototype of this object if it is an occurrence.

-------------------------------------

Getter Method

Signature Prototype

Returns:The prototype of this object or null if this object is not an occurrence
Return type:NXOpen.INXObject

New in version NX3.0.0.

License requirements: None.

ThruFace

Hole.ThruFace

Returns the thru face of the hole.

-------------------------------------

Getter Method

Signature ThruFace

Returns:
Return type:NXOpen.ISurface

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

TipAngle

Hole.TipAngle

Returns the tip angle of the hole.

-------------------------------------

Getter Method

Signature TipAngle

Returns:
Return type:NXOpen.Expression

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

Method Detail

FindObject

Hole.FindObject

Finds the NXOpen.NXObject with the given identifier as recorded in a journal.

An object may not return the same value as its JournalIdentifier in different versions of the software. However newer versions of the software should find the same object when FindObject is passed older versions of its journal identifier. In general, this method should not be used in handwritten code and exists to support record and playback of journals.

An exception will be thrown if no object can be found with the given journal identifier.

Signature FindObject(journalIdentifier)

Parameters:journalIdentifier (str) – Journal identifier of the object
Returns:
Return type:NXOpen.INXObject

New in version NX3.0.0.

License requirements: None.

GetCounterboreHole

Hole.GetCounterboreHole

Retrieves parameters of counterbore hole.

Signature GetCounterboreHole()

Returns:a tuple
Return type:A tuple consisting of (diameter, depth, tipAngle, cboreDiameter, cboreDepth). diameter is a NXOpen.Expression. Expression for diameter depth is a NXOpen.Expression. Expression for depth tipAngle is a NXOpen.Expression. Expression for tip angle cboreDiameter is a NXOpen.Expression. Expression for counterbore diameter cboreDepth is a NXOpen.Expression. Expression for counterbore depth

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

GetCountersinkHole

Hole.GetCountersinkHole

Retrieves parameters of countersink hole.

Signature GetCountersinkHole()

Returns:a tuple
Return type:A tuple consisting of (diameter, depth, tipAngle, csinkDiameter, csinkAngle). diameter is a NXOpen.Expression. Expression for diameter depth is a NXOpen.Expression. Expression for depth tipAngle is a NXOpen.Expression. Expression for tip angle csinkDiameter is a NXOpen.Expression. Expression for countersink diameter csinkAngle is a NXOpen.Expression. Expression for countersink angle

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

GetPositioningDimensions

Hole.GetPositioningDimensions

Returns array of positioning dimensions attached to the hole

Signature GetPositioningDimensions()

Returns:
Return type:list of NXOpen.PositioningDimension

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

GetSimpleHole

Hole.GetSimpleHole

Retrieves parameters of simple hole.

Signature GetSimpleHole()

Returns:a tuple
Return type:A tuple consisting of (diameter, depth, tipAngle). diameter is a NXOpen.Expression. Expression for diameter depth is a NXOpen.Expression. Expression for depth tipAngle is a NXOpen.Expression. Expression for tip angle

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

GetSubtype

Hole.GetSubtype

Returns the subtype of the hole.

Signature GetSubtype()

Returns:Subype of the hole, simple, counterbore, or countersink
Return type:NXOpen.Features.HoleSubtype

New in version NX3.0.0.

License requirements: features_modeling (“FEATURES MODELING”), solid_modeling (“SOLIDS MODELING”)

Print

Hole.Print

Prints a representation of this object to the system log file.

Signature Print()

New in version NX3.0.0.

License requirements: None.

SetName

Hole.SetName

Sets the custom name of the object.

NOTE: This method should not be used to edit a read-only object such as a Mirrored PMI object. If it is, the changes will be overridden when the part is updated.

Signature SetName(name)

Parameters:name (str) –

New in version NX3.0.0.

License requirements: None.