MultipleNodeCreateBuilder Class¶
-
class
NXOpen.CAE.MultipleNodeCreateBuilder¶ Bases:
NXOpen.BuilderRepresents a
NXOpen.CAE.MultipleNodeCreateBuilderwhich can be used to create mutiple nodes in one efficient opertation.To create a new instance of this class, use
NXOpen.CAE.NodeElementManager.CreateMultipleNodeCreateBuilder()New in version NX7.5.2.
Properties¶
| Property | Description |
|---|---|
| LabelIncrement | Returns or sets the label increment used when calculating next node label when assigning node labels |
| StartLabel | Returns or sets the starting label used to assign node labels, if no explicit labels were defined. |
| Tag | Returns the Tag for this object. |
Methods¶
| Method | Description |
|---|---|
| AddNodes | Adds new node definitions at specifiied positions with repect to the defined refernce coordinate system. |
| Commit | Commits any edits that have been applied to the builder. |
| CommitNodes | Commits the Builder, which creates nodes as they were defined and returns the newly create nodes. |
| 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¶
LabelIncrement¶
-
MultipleNodeCreateBuilder.LabelIncrement¶ Returns or sets the label increment used when calculating next node label when assigning node labels
-------------------------------------Getter Method
Signature
LabelIncrementReturns: Return type: int New in version NX7.5.2.
License requirements: None.
-------------------------------------Setter Method
Signature
LabelIncrementParameters: increment (int) – New in version NX7.5.2.
License requirements: nx_masterfem (“Finite Element Modeling”)
StartLabel¶
-
MultipleNodeCreateBuilder.StartLabel¶ Returns or sets the starting label used to assign node labels, if no explicit labels were defined.
If no start label is specified, the next available node for this part.
-------------------------------------Getter Method
Signature
StartLabelReturns: Return type: int New in version NX7.5.2.
License requirements: None.
-------------------------------------Setter Method
Signature
StartLabelParameters: label (int) – New in version NX7.5.2.
License requirements: nx_masterfem (“Finite Element Modeling”)
Method Detail¶
AddNodes¶
-
MultipleNodeCreateBuilder.AddNodes¶ Overloaded method AddNodes
AddNodes(positions)AddNodes(positions, labels)
-------------------------------------Adds new node definitions at specifiied positions with repect to the defined refernce coordinate system. New node will be created only after when
NXOpen.CAE.MultipleNodeCreateBuilder.CommitNodes()is done. Since node labels weren’t specified, the builder will assign them automatically based on the setting ofNXOpen.CAE.MultipleNodeCreateBuilder.StartLabel`()andNXOpen.CAE.MultipleNodeCreateBuilder.LabelIncrement`()Signature
AddNodes(positions)Parameters: positions (list of NXOpen.Point3d) – new FENodes positionsNew in version NX7.5.2.
License requirements: nx_masterfem (“Finite Element Modeling”)
-------------------------------------Adds a new node definition at specifiied positions with repect to the defined refernce coordinate system. New node will be created only after when
NXOpen.CAE.MultipleNodeCreateBuilder.CommitNodes()is done. Since node labels weren’t specified, the builder will assign them automatically based on the setting ofNXOpen.CAE.MultipleNodeCreateBuilder.StartLabel`()andNXOpen.CAE.MultipleNodeCreateBuilder.LabelIncrement`()Signature
AddNodes(positions, labels)Parameters: - positions (list of
NXOpen.Point3d) – new FENodes positions - labels (list of int) – new FENodes labels. 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”)
-------------------------------------
CommitNodes¶
-
MultipleNodeCreateBuilder.CommitNodes¶ Commits the Builder, which creates nodes as they were defined and returns the newly create nodes.
The method
Builder.Commit()will also do the same thing except no nodes are returned andBuilder.GetCommittedObjects()can’t be used since these nodes are not of typeNXOpen.NXObjectSignature
CommitNodes()Returns: new FENodes positions Return type: list of NXOpen.CAE.FENodeNew in version NX7.5.2.
License requirements: nx_masterfem (“Finite Element Modeling”)
Validate¶
-
MultipleNodeCreateBuilder.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.