DuplicateElementsCheckBuilder Class — NXOpen Python API Reference 12.0.0 documentation

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