MultipleElementCreateBuilder Class

class NXOpen.CAE.MultipleElementCreateBuilder

Bases: NXOpen.Builder

Represents a NXOpen.CAE.MultipleElementCreateBuilder which can be used to create mutiple elements in one efficient opertation.

The general procedure for creating elements is to:

  1. Define the type of elements to be create through the NXOpen.CAE.ElementTypeBuilder and the
properties of NXOpen.CAE.ElementTypeBuilder.ElementTypeName`()
  1. Optionally define elements labeling requirements through

NXOpen.CAE.MultipleElementCreateBuilder.StartLabel`() and NXOpen.CAE.MultipleElementCreateBuilder.LabelIncrement`()

  1. Define elements through NXOpen.CAE.MultipleElementCreateBuilder.AddElement()
  2. Create Mesh and elements through Builder.Commit() or

NXOpen.CAE.MultipleElementCreateBuilder.CommitElements(). Commiting the builder removes the current element defintions so that it can be reused to create more elements.

The

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

New in version NX7.5.2.

Properties

Property Description
ElementType Returns the element type builder.
LabelIncrement Returns or sets the label increment used when calculating next element label when assigning element labels
StartLabel Returns or sets the starting label used to assign element labels, if no explicit labels were defined.
Tag Returns the Tag for this object.

Methods

Method Description
AddElement Adds new element definition defined by the list of input NXOpen.CAE.FENode objects.
Commit Commits any edits that have been applied to the builder.
CommitElements Commits the Builder, which creates elements as they were defined and returns the newly create elements.
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.
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.

Property Detail

ElementType

MultipleElementCreateBuilder.ElementType

Returns the element type builder.

Through the NXOpen.CAE.ElementTypeBuilder you can specify both the type of element to create as well as the destination NXOpen.CAE.MeshCollector the new elements will be placed in.

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

Getter Method

Signature ElementType

Returns:
Return type:NXOpen.CAE.ElementTypeBuilder

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

LabelIncrement

MultipleElementCreateBuilder.LabelIncrement

Returns or sets the label increment used when calculating next element label when assigning element labels

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

Getter Method

Signature LabelIncrement

Returns:
Return type:int

New in version NX7.5.2.

License requirements: None.

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

Setter Method

Signature LabelIncrement

Parameters:increment (int) –

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

StartLabel

MultipleElementCreateBuilder.StartLabel

Returns or sets the starting label used to assign element labels, if no explicit labels were defined.

If no start label is specified, the next available element for this part.

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

Getter Method

Signature StartLabel

Returns:
Return type:int

New in version NX7.5.2.

License requirements: None.

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

Setter Method

Signature StartLabel

Parameters:label (int) –

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

Method Detail

AddElement

MultipleElementCreateBuilder.AddElement

Overloaded method AddElement

  • AddElement(nodes)
  • AddElement(nodes, label)

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

Adds new element definition defined by the list of input NXOpen.CAE.FENode objects. New element will be created only after NXOpen.CAE.MultipleElementCreateBuilder.CommitElements() is done. Since element labels weren’t specified, the builder will assign them automatically based on the setting of NXOpen.CAE.MultipleElementCreateBuilder.StartLabel`() and NXOpen.CAE.MultipleElementCreateBuilder.LabelIncrement`()

Signature AddElement(nodes)

Parameters:nodes (list of NXOpen.CAE.FENode) – input list of nodes

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

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

Adds new element definition defined by the list of input NXOpen.CAE.FENode objects. New element will be created only after NXOpen.CAE.MultipleElementCreateBuilder.CommitElements() is done.

Signature AddElement(nodes, label)

Parameters:
  • nodes (list of NXOpen.CAE.FENode) – input list of nodes, The number of nodes and the order of the nodes must be consistent with the defined element type.
  • label (int) – new FEElement label. If the specified label is less than or equal to 0 then the builder will automatically assign a valid label based on the builders labeling rules. If a label is specified it must be unique in this part.

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

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

CommitElements

MultipleElementCreateBuilder.CommitElements

Commits the Builder, which creates elements as they were defined and returns the newly create elements.

The method Builder.Commit() will also do the same thing except instead of returning elements, it will return the newly created NXOpen.CAE.Mesh which contains the new elements. Builder.GetCommittedObjects() can’t be used to return elements since they are not of type NXOpen.NXObject. It will however return the newly created NXOpen.CAE.Mesh

Signature CommitElements()

Returns:new FEElements positions
Return type:list of NXOpen.CAE.FEElement

New in version NX7.5.2.

License requirements: nx_masterfem (“Finite Element Modeling”)

Validate

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