DuplicateElementsCheckBuilder Class

class NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilder

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

Represents a NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilder to check for duplicate elements within the candidate elements.

Duplicate elements are elements which share the same corner nodes,but do not include the middle nodes.

The general workflow is:

  1. Set the candidate elements
  2. Set the display settings data
  3. Identify the duplicate elements
  4. Set the preference option
  5. Delete the duplicate elements

You can delete duplicate elements through Builder.Commit() or NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilder.DeleteDuplicateElements(). Commits the builder to delete duplicate elements.

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

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 elements
DuplicateElementGroupsCount Returns the duplicate elements group count, each group contains elements that are duplicates of each other and each group contains at least two duplicate elements
Preference Returns or sets the duplicate elements deleting preference
PreferenceElements Returns the preference elements for keep selected and remove selected options
SelectionList Returns the selected objects to be checked.
Tag Returns the Tag for this object.

Methods

Method Description
Commit Commits any edits that have been applied to the builder.
DeleteDuplicateElements Deletes the duplicate elements and clear all cached duplicate elements in this 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.
GetDuplicateElements Returns the duplicate elements of specified group index
GetObject Returns the object currently being edited by this builder.
IdentifyDuplicateElements Calculates to find the duplicate elements and display them in the NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilderDisplaySettings_Struct.
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

DuplicateElementsCheckBuilderDeletePreference Enumeration Represents the duplicate elements deleting preference

Structs

DuplicateElementsCheckBuilderDisplaySettings_Struct Struct Represents the display settings of duplicated elements detected

Property Detail

CheckScopeOption

DuplicateElementsCheckBuilder.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

DuplicateElementsCheckBuilder.DisplaySettingsData

Returns or sets the display settings for duplicate elements

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

Getter Method

Signature DisplaySettingsData

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

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature DisplaySettingsData

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

New in version NX8.5.0.

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

DuplicateElementGroupsCount

DuplicateElementsCheckBuilder.DuplicateElementGroupsCount

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

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

Getter Method

Signature DuplicateElementGroupsCount

Returns:Duplicate element 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”)

Preference

DuplicateElementsCheckBuilder.Preference

Returns or sets the duplicate elements deleting preference

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

Getter Method

Signature Preference

Returns:Delete elements preference
Return type:NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilderDeletePreference

New in version NX8.5.0.

License requirements: None.

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

Setter Method

Signature Preference

Parameters:deletePreference (NXOpen.CAE.ModelCheck.DuplicateElementsCheckBuilderDeletePreference) – Delete elements preference

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

PreferenceElements

DuplicateElementsCheckBuilder.PreferenceElements

Returns the preference elements for keep selected and remove selected options

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

Getter Method

Signature PreferenceElements

Returns:Preference elements
Return type:NXOpen.CAE.SelectElementsBuilder

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

SelectionList

DuplicateElementsCheckBuilder.SelectionList

Returns the selected objects to be checked.

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

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

Getter Method

Signature SelectionList

Returns:
Return type:NXOpen.SelectTaggedObjectList

New in version NX8.5.0.

License requirements: None.

Method Detail

DeleteDuplicateElements

DuplicateElementsCheckBuilder.DeleteDuplicateElements

Deletes the duplicate elements and clear all cached duplicate elements in this builder.

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

Signature DeleteDuplicateElements()

New in version NX8.5.0.

License requirements: nx_masterfem (“Finite Element Modeling”)

GetDuplicateElements

DuplicateElementsCheckBuilder.GetDuplicateElements

Returns the duplicate elements of specified group index

Signature GetDuplicateElements(groupIndex)

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

New in version NX8.5.0.

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

IdentifyDuplicateElements

DuplicateElementsCheckBuilder.IdentifyDuplicateElements

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

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

Signature IdentifyDuplicateElements()

New in version NX8.5.0.

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

Validate

DuplicateElementsCheckBuilder.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.