ElementSplitBuilder Class — NXOpen Python API Reference 12.0.0 documentation

# ElementSplitBuilder Class

class `NXOpen.CAE.``ElementSplitBuilder`

  Bases: `NXOpen.Builder`

  Represents a `NXOpen.CAE.ElementSplitBuilder`

  To create a new instance of this class, use `NXOpen.CAE.NodeElementManager.CreateElementSplitBuilder()`

  New in version NX5.0.0.

# Properties

Property | Description
--- | ---
Elementsss | Returns the selected elements
FirstElementSplitType | Returns or sets the flip_type for first element in the selection list
JacobianToggle | Returns or sets a value indicating whether elements are to be split based on Jacobian.
JacobianValue | Returns or sets a threshold jacobian value.
MValue | Returns or sets a number of rows into which quad element to be split
MaxAngleToggle | Returns or sets a value indicating whether elements are to be split based on Maximum Angle.
MaxAngleValue | Returns or sets a threshold Maximum Angle Value
MergeDupNode | Returns or sets a value indicating whether duplicate nodes created during split are to be merged.
MinAngleToggle | Returns or sets a value indicating whether elements are to be split based on Minimum Angle.
MinAngleValue | Returns or sets a threshold minimum angle value.
NValue | Returns or sets a number of cols into which quad element to be split
Point1 | Returns or sets the point1, one end of line when split by line
Point2 | Returns or sets the point2, the other end of line when split by line
SplitMethod | Returns or sets the use existing connectivity option
Tag | Returns the Tag for this object.
Type | Returns or sets the split type
WarpToggle | Returns or sets a value indicating whether elements are to be split based on Warp.
WarpValue | Returns or sets a threshold warp value.

# 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.
Flip | Flip will not be journaled now
GetCommittedObjects | For builders that create more than one object, this method returns the objects that are created by commit.
GetObject | Returns the object currently being edited by 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

ElementSplitBuilderSplitMethodType Enumeration | the split method types
ElementSplitBuilderTypes Enumeration | the element split types

# Property Detail

## Elementsss

`ElementSplitBuilder.``Elementsss`

  Returns the selected elements

  `-------------------------------------`

  Getter Method

  Signature `Elementsss`

  Returns: |
  Return type: | `NXOpen.CAE.SelectElementsBuilder`

  New in version NX7.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## FirstElementSplitType

`ElementSplitBuilder.``FirstElementSplitType`

  Returns or sets the flip_type for first element in the selection list

  `-------------------------------------`

  Getter Method

  Signature `FirstElementSplitType`

  Returns: |
  Return type: | int

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `FirstElementSplitType`

  Parameters: | data (int) –

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## JacobianToggle

`ElementSplitBuilder.``JacobianToggle`

  Returns or sets a value indicating whether elements are to be split based on Jacobian.

  If True, elements with jacobian values that exceeds the value of `NXOpen.CAE.ElementSplitBuilder.JacobianValue`()` are split.

  `-------------------------------------`

  Getter Method

  Signature `JacobianToggle`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `JacobianToggle`

  Parameters: | jacobianToggle (bool) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## JacobianValue

`ElementSplitBuilder.``JacobianValue`

  Returns or sets a threshold jacobian value.

  `-------------------------------------`

  Getter Method

  Signature `JacobianValue`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `JacobianValue`

  Parameters: | jacobianValue (float) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MValue

`ElementSplitBuilder.``MValue`

  Returns or sets a number of rows into which quad element to be split

  `-------------------------------------`

  Getter Method

  Signature `MValue`

  Returns: |
  Return type: | int

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MValue`

  Parameters: | mValue (int) –

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MaxAngleToggle

`ElementSplitBuilder.``MaxAngleToggle`

  Returns or sets a value indicating whether elements are to be split based on Maximum Angle.

  If True, elements with maximum angle values that exceeds the value of `NXOpen.CAE.ElementSplitBuilder.MaxAngleValue`()` are split.

  `-------------------------------------`

  Getter Method

  Signature `MaxAngleToggle`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MaxAngleToggle`

  Parameters: | maxAngleToggle (bool) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MaxAngleValue

`ElementSplitBuilder.``MaxAngleValue`

  Returns or sets a threshold Maximum Angle Value

  `-------------------------------------`

  Getter Method

  Signature `MaxAngleValue`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MaxAngleValue`

  Parameters: | maxAngleValue (float) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MergeDupNode

`ElementSplitBuilder.``MergeDupNode`

  Returns or sets a value indicating whether duplicate nodes created during split are to be merged.

  If false, this is user’s responsibilty to merge duplicate nodes.

  `-------------------------------------`

  Getter Method

  Signature `MergeDupNode`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MergeDupNode`

  Parameters: | mergeDupNode (bool) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MinAngleToggle

`ElementSplitBuilder.``MinAngleToggle`

  Returns or sets a value indicating whether elements are to be split based on Minimum Angle.

  If True, elements having minimum angle values less than the value of `NXOpen.CAE.ElementSplitBuilder.MinAngleValue`()` are split.

  `-------------------------------------`

  Getter Method

  Signature `MinAngleToggle`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MinAngleToggle`

  Parameters: | minAngleToggle (bool) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## MinAngleValue

`ElementSplitBuilder.``MinAngleValue`

  Returns or sets a threshold minimum angle value.

  `-------------------------------------`

  Getter Method

  Signature `MinAngleValue`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `MinAngleValue`

  Parameters: | minAngleValue (float) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## NValue

`ElementSplitBuilder.``NValue`

  Returns or sets a number of cols into which quad element to be split

  `-------------------------------------`

  Getter Method

  Signature `NValue`

  Returns: |
  Return type: | int

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `NValue`

  Parameters: | nValue (int) –

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Point1

`ElementSplitBuilder.``Point1`

  Returns or sets the point1, one end of line when split by line

  `-------------------------------------`

  Getter Method

  Signature `Point1`

  Returns: |
  Return type: | `NXOpen.Point`

  New in version NX5.0.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Point1`

  Parameters: | point1 (`NXOpen.Point`) –

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Point2

`ElementSplitBuilder.``Point2`

  Returns or sets the point2, the other end of line when split by line

  `-------------------------------------`

  Getter Method

  Signature `Point2`

  Returns: |
  Return type: | `NXOpen.Point`

  New in version NX5.0.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Point2`

  Parameters: | point2 (`NXOpen.Point`) –

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## SplitMethod

`ElementSplitBuilder.``SplitMethod`

  Returns or sets the use existing connectivity option

  `-------------------------------------`

  Getter Method

  Signature `SplitMethod`

  Returns: |
  Return type: | `NXOpen.CAE.ElementSplitBuilderSplitMethodType`

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `SplitMethod`

  Parameters: | option (`NXOpen.CAE.ElementSplitBuilderSplitMethodType`) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Type

`ElementSplitBuilder.``Type`

  Returns or sets the split type

  `-------------------------------------`

  Getter Method

  Signature `Type`

  Returns: |
  Return type: | `NXOpen.CAE.ElementSplitBuilderTypes`

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `Type`

  Parameters: | type (`NXOpen.CAE.ElementSplitBuilderTypes`) –

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## WarpToggle

`ElementSplitBuilder.``WarpToggle`

  Returns or sets a value indicating whether elements are to be split based on Warp.

  If True, elements with warp values that exceeds the value of `NXOpen.CAE.ElementSplitBuilder.WarpValue`()` are split.

  `-------------------------------------`

  Getter Method

  Signature `WarpToggle`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `WarpToggle`

  Parameters: | warpToggle (bool) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## WarpValue

`ElementSplitBuilder.``WarpValue`

  Returns or sets a threshold warp value.

  `-------------------------------------`

  Getter Method

  Signature `WarpValue`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

  `-------------------------------------`

  Setter Method

  Signature `WarpValue`

  Parameters: | warpValue (float) –

  New in version NX7.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

# Method Detail

## Flip

`ElementSplitBuilder.``Flip`

  Flip will not be journaled now

  Signature `Flip()`

  New in version NX5.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Validate

`ElementSplitBuilder.``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.