MultipleNodeCreateBuilder Class — NXOpen Python API Reference 12.0.0 documentation

# MultipleNodeCreateBuilder Class

class `NXOpen.CAE.``MultipleNodeCreateBuilder`

  Bases: `NXOpen.Builder`

  Represents a `NXOpen.CAE.MultipleNodeCreateBuilder` which 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 `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

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

## 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 of `NXOpen.CAE.MultipleNodeCreateBuilder.StartLabel`()` and `NXOpen.CAE.MultipleNodeCreateBuilder.LabelIncrement`()`

  Signature `AddNodes(positions)`

  Parameters: | positions (list of `NXOpen.Point3d`) – new FENodes positions

  New 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 of `NXOpen.CAE.MultipleNodeCreateBuilder.StartLabel`()` and `NXOpen.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 and `Builder.GetCommittedObjects()` can’t be used since these nodes are not of type `NXOpen.NXObject`

  Signature `CommitNodes()`

  Returns: | new FENodes positions
  Return type: | list of `NXOpen.CAE.FENode`

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