DuplicateNodesCheckBuilder Class

class NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilder

Bases: NXOpen.Builder, NXOpen.CAE.ModelCheck.ISelectionBuilder

Represents a NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilder to check for duplicate nodes within the candidate nodes.

Duplicate nodes are nodes which distance between each other is less than specific tolerance value and at least one duplicate node can be merged away.

The general workflow is:

1. Set the candidate nodes
2. Set the check settings and display settings data
3. Identify the duplicate nodes
4. Set the preference option
5. Merge duplicate nodes

You can merge duplicate nodes through Builder.Commit() or NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilder.MergeDuplicateNodes(). Commits the builder to merge duplicate nodes and update the mesh in graphic window.

To create a new instance of this class, use NXOpen.CAE.ModelCheckManager.CreateDuplicateNodesCheckBuilder()

New in version NX8.5.0.

Properties

Property	Description
CheckScopeOption	Returns or sets the check scope setting
DisplaySettingsData	Returns or sets the display settings for duplicate nodes
DuplicateNodeGroupsCount	Returns the duplicate nodes group count, each group contains nodes that are duplicates of each other and each group contains at least two duplicate nodes
IgnoreNodesConnectedToTinyEdges	Returns or sets a value indicating whether to ignore nodes connected to tiny edges
IgnoreNodesInSameMesh	Returns or sets a value indicating whether to ignore nodes in same mesh
ListingType	Returns or sets an option indicating what information to be listed
MergeOccurrenceNodes	Returns or sets a value indicating whether to merge occurrence nodes in afem context
Preference	Returns or sets the duplicate nodes merging preference
SelectPreferenceNodesList	Returns the preference nodes select list for keep selected and remove selected options
SelectionList	Returns the selected objects for checking.
Tag	Returns the Tag for this object.
Tolerance	Returns the tolerance used to determine if the nodes are duplicates of each other

Methods

Method	Description
Commit	Commits any edits that have been applied to the builder.
Destroy	Deletes the builder, and cleans up any objects created by the builder.
GetCommittedObjects	For builders that create more than one object, this method returns the objects that are created by commit.
GetDuplicateNodes	Returns the duplicate nodes of specified group index
GetObject	Returns the object currently being edited by this builder.
IdentifyDuplicateNodes	Calculates to find the duplicate nodes and display them in NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilderDisplaySettings_Struct.
MergeDuplicateNodes	Merges the duplicate nodes and clear all cached duplicate nodes in this builder.
ShowResults	Updates the model to reflect the result of an edit to the model for all builders that support showing results.
Validate	Validate whether the inputs to the component are sufficient for commit to be called.

Enumerations

DuplicateNodesCheckBuilderListOption Enumeration	Represents the duplicate nodes merging preference
DuplicateNodesCheckBuilderMergePreference Enumeration	Represents the duplicate nodes merging preference

Structs

DuplicateNodesCheckBuilderDisplaySettings_Struct Struct

Represents the display settings data

Property Detail

CheckScopeOption

DuplicateNodesCheckBuilder.CheckScopeOption

Returns or sets the check scope setting

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

Getter Method

Signature CheckScopeOption

Returns: Return type:NXOpen.CAE.ModelCheck.CheckScope

New in version NX11.0.1.

License requirements: None.

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

Setter Method

Signature CheckScopeOption

Parameters:scope (NXOpen.CAE.ModelCheck.CheckScope) –

New in version NX11.0.1.

License requirements: None.

DisplaySettingsData

DuplicateNodesCheckBuilder.DisplaySettingsData

Returns or sets the display settings for duplicate nodes

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

Getter Method

Signature DisplaySettingsData

Returns:Display settings data Return type:NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderDisplaySettings_Struct

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature DisplaySettingsData

Parameters:displaySettings (NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderDisplaySettings_Struct) – Display settings data

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

DuplicateNodeGroupsCount

DuplicateNodesCheckBuilder.DuplicateNodeGroupsCount

Returns the duplicate nodes group count, each group contains nodes that are duplicates of each other and each group contains at least two duplicate nodes

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

Getter Method

Signature DuplicateNodeGroupsCount

Returns:Duplicate node groups count Return type:int

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

IgnoreNodesConnectedToTinyEdges

DuplicateNodesCheckBuilder.IgnoreNodesConnectedToTinyEdges

Returns or sets a value indicating whether to ignore nodes connected to tiny edges

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

Getter Method

Signature IgnoreNodesConnectedToTinyEdges

Returns: Return type:bool

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature IgnoreNodesConnectedToTinyEdges

Parameters:ignoreTinyEdgeNodes (bool) –

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

IgnoreNodesInSameMesh

DuplicateNodesCheckBuilder.IgnoreNodesInSameMesh

Returns or sets a value indicating whether to ignore nodes in same mesh

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

Getter Method

Signature IgnoreNodesInSameMesh

Returns: Return type:bool

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature IgnoreNodesInSameMesh

Parameters:ignoreSameMeshNodes (bool) –

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

ListingType

DuplicateNodesCheckBuilder.ListingType

Returns or sets an option indicating what information to be listed

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

Getter Method

Signature ListingType

Returns: Return type:NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderListOption

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature ListingType

Parameters:listOption (NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderListOption) –

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

MergeOccurrenceNodes

DuplicateNodesCheckBuilder.MergeOccurrenceNodes

Returns or sets a value indicating whether to merge occurrence nodes in afem context

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

Getter Method

Signature MergeOccurrenceNodes

Returns: Return type:bool

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature MergeOccurrenceNodes

Parameters:mergeOccurrenceNodes (bool) –

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

Preference

DuplicateNodesCheckBuilder.Preference

Returns or sets the duplicate nodes merging preference

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

Getter Method

Signature Preference

Returns:Merge nodes preference Return type:NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderMergePreference

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature Preference

Parameters:mergePreference (NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilderMergePreference) – Merge nodes preference

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

SelectPreferenceNodesList

DuplicateNodesCheckBuilder.SelectPreferenceNodesList

Returns the preference nodes select list for keep selected and remove selected options

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

Getter Method

Signature SelectPreferenceNodesList

Returns:Preference nodes select list Return type:NXOpen.CAE.SelectFENodeList

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

SelectionList

DuplicateNodesCheckBuilder.SelectionList

Returns the selected objects for checking.

The objects must be NXOpen.CAE.Mesh or NXOpen.CAE.FENode

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

Getter Method

Signature SelectionList

Returns: Return type:NXOpen.SelectTaggedObjectList

New in version NX8.5.0.

License requirements: None.

Tolerance

DuplicateNodesCheckBuilder.Tolerance

Returns the tolerance used to determine if the nodes are duplicates of each other

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

Getter Method

Signature Tolerance

Returns: Return type:NXOpen.Expression

New in version NX8.5.0.

License requirements: None.

Method Detail

GetDuplicateNodes

DuplicateNodesCheckBuilder.GetDuplicateNodes

Returns the duplicate nodes of specified group index

Signature GetDuplicateNodes(groupIndex)

Parameters:groupIndex (int) – Returns: Return type:list of NXOpen.CAE.FENode

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

IdentifyDuplicateNodes

DuplicateNodesCheckBuilder.IdentifyDuplicateNodes

Calculates to find the duplicate nodes and display them in NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilderDisplaySettings_Struct.

The detected duplicate nodes are cached, to access the cached calculation result, you could use NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilder.DuplicateNodeGroupsCount() and NXOpen.CAE.ModelCheck.DuplicateNodesCheckBuilder.GetDuplicateNodes(). The previous cached data will be cleaned automatically when you start a new identification.

Signature IdentifyDuplicateNodes()

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”) OR nx_design_sim (“NX Design Simulation”)

MergeDuplicateNodes

DuplicateNodesCheckBuilder.MergeDuplicateNodes

Merges the duplicate nodes and clear all cached duplicate nodes in this builder.

The method Builder.Commit() will also do the same thing. Duplicate nodes can only be merged when the context part of this builder is a NXOpen.CAE.BaseFemPart.

Signature MergeDuplicateNodes()

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

Validate

DuplicateNodesCheckBuilder.Validate

Validate whether the inputs to the component are sufficient for commit to be called.

If the component is not in a state to commit then an exception is thrown. For example, if the component requires you to set some property, this method will throw an exception if you haven’t set it. This method throws a not-yet-implemented NXException for some components.

Signature Validate()

Returns:Was self validation successful Return type:bool

New in version NX3.0.1.

License requirements: None.