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:
- Define the type of elements to be create through the
NXOpen.CAE.ElementTypeBuilder
and the
- properties of
NXOpen.CAE.ElementTypeBuilder.ElementTypeName`
- Optionally define elements labeling requirements through
NXOpen.CAE.MultipleElementCreateBuilder.StartLabel`
andNXOpen.CAE.MultipleElementCreateBuilder.LabelIncrement`
- Define elements through
NXOpen.CAE.MultipleElementCreateBuilder.AddElement
- 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.
- Define the type of elements to be create through the
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 destinationNXOpen.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(increment)
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(label)
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 afterNXOpen.CAE.MultipleElementCreateBuilder.CommitElements
is done. Since element labels weren’t specified, the builder will assign them automatically based on the setting ofNXOpen.CAE.MultipleElementCreateBuilder.StartLabel`
andNXOpen.CAE.MultipleElementCreateBuilder.LabelIncrement`
Signature
AddElement(nodes)
Parameters: nodes (list of NXOpen.CAE.FENode
) – input list of nodesNew 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 afterNXOpen.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 createdNXOpen.CAE.Mesh
which contains the new elements.Builder.GetCommittedObjects
can’t be used to return elements since they are not of typeNXOpen.NXObject
. It will however return the newly createdNXOpen.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.