ProjectNodesToCadGeometryBuilder Class — NXOpen Python API Reference 12.0.0 documentation

# ProjectNodesToCadGeometryBuilder Class

class `NXOpen.CAE.``ProjectNodesToCadGeometryBuilder`

  Bases: `NXOpen.Builder`

  Allows you to query the mesh nodes that are off the underlying Cad geometry by a given tolerance, and if requested this builder can adjust the node locations to put them back on to the underlying Cad geometry.

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

  New in version NX6.0.4.

# Properties

Property | Description
--- | ---
AdjustedNodeLocationColor | Returns or sets the display color of proximity node new location which will meet the given tolerance with undelying CAD geometry.
CheckedObjectsList | Returns the selected objects for checking.
IncludeMidnodes | Returns or sets a value indicating whether to include element midnodes in the operation.
ListingOptionState | Returns or sets the listing option
OperationState | Returns or sets the operation to be performed.
OriginalNodeLocationColor | Returns or sets the display color of proximity nodes’ original location.
ProximityTolerance | Returns or sets the proximity tolerance used to determine if nodes on close enough to be considered on the CAD geometry
SelectionList | Returns the selected meshes
ShowNodeLabels | Returns or sets a value indicating whether to show the labels for proximity nodes are off underlying CAD geometry.
ShowNodeLocations | Returns or sets a value indicating whether to show original location and adjusted location for the proximity nodes that are off the underlying CAD geometry by a given tolerance.
Tag | Returns the Tag for this object.
Tolerance | Returns the proximity tolerance used to determine if nodes on close enough to be considered on the CAD geometry

# Methods

Method | Description
--- | ---
AdjustProximityNodes | Adjusts the proximity nodes identified to the new location to meet the given tolerance with underlying CAD geometries.
Commit | Commits any edits that have been applied to the builder.
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.
GetNodes | Returns the cached nodes calculated by `CAE.ProjectNodesToCadGeometryBuilder.IdentifyCadGeometry()`.
GetObject | Returns the object currently being edited by this builder.
GetProximityNodes | Returns the cached proximity nodes calculated by `CAE.ProjectNodesToCadGeometryBuilder.IdentifyProximityNodes()`.
IdentifyCadGeometry | Identifies the relationship between CAD geometry and the nodes, The identified result will be cached, you could access the cached results by calling `CAE.ProjectNodesToCadGeometryBuilder.GetNodes()`.
IdentifyProximityNodes | Identifies the proximity nodes which are off the underlying CAD geometry according to `CAE.ProjectNodesToCadGeometryBuilder.ProximityTolerance`()` and `CAE.ProjectNodesToCadGeometryBuilder.IncludeMidnodes`()`.
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

ProjectNodesToCadGeometryBuilderListingOption Enumeration | Listing Options
ProjectNodesToCadGeometryBuilderOperation Enumeration | Operations

# Property Detail

## AdjustedNodeLocationColor

`ProjectNodesToCadGeometryBuilder.``AdjustedNodeLocationColor`

  Returns or sets the display color of proximity node new location which will meet the given tolerance with undelying CAD geometry.

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

  Getter Method

  Signature `AdjustedNodeLocationColor`

  Returns: |
  Return type: | Id

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `AdjustedNodeLocationColor`

  Parameters: | locationColor (Id) –

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## CheckedObjectsList

`ProjectNodesToCadGeometryBuilder.``CheckedObjectsList`

  Returns the selected objects for checking.

  The objects must be `CAE.Mesh`, `CAE.CAEBody` or `CAE.CAEFace`

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

  Getter Method

  Signature `CheckedObjectsList`

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

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## IncludeMidnodes

`ProjectNodesToCadGeometryBuilder.``IncludeMidnodes`

  Returns or sets a value indicating whether to include element midnodes in the operation.

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

  Getter Method

  Signature `IncludeMidnodes`

  Returns: |
  Return type: | bool

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

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

  Setter Method

  Signature `IncludeMidnodes`

  Parameters: | bIncludeMidnodes (bool) –

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## ListingOptionState

`ProjectNodesToCadGeometryBuilder.``ListingOptionState`

  Returns or sets the listing option

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

  Getter Method

  Signature `ListingOptionState`

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

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

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

  Setter Method

  Signature `ListingOptionState`

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

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## OperationState

`ProjectNodesToCadGeometryBuilder.``OperationState`

  Returns or sets the operation to be performed.

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

  Getter Method

  Signature `OperationState`

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

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

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

  Setter Method

  Signature `OperationState`

  Parameters: | operation (`NXOpen.CAE.ProjectNodesToCadGeometryBuilderOperation`) –

  New in version NX6.0.4.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## OriginalNodeLocationColor

`ProjectNodesToCadGeometryBuilder.``OriginalNodeLocationColor`

  Returns or sets the display color of proximity nodes’ original location.

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

  Getter Method

  Signature `OriginalNodeLocationColor`

  Returns: |
  Return type: | Id

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `OriginalNodeLocationColor`

  Parameters: | locationColor (Id) –

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## ProximityTolerance

`ProjectNodesToCadGeometryBuilder.``ProximityTolerance`

  Returns or sets the proximity tolerance used to determine if nodes on close enough to be considered on the CAD geometry

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

  Getter Method

  Signature `ProximityTolerance`

  Returns: |
  Return type: | float

  New in version NX6.0.4.

  Deprecated since version NX8.5.0: Use `CAE.ProjectNodesToCadGeometryBuilder.Tolerance()` instead.

  License requirements: nx_masterfem (“Finite Element Modeling”)

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

  Setter Method

  Signature `ProximityTolerance`

  Parameters: | dProximityTolerance (float) –

  New in version NX6.0.4.

  Deprecated since version NX8.5.0: Use `CAE.ProjectNodesToCadGeometryBuilder.Tolerance()` instead.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## SelectionList

`ProjectNodesToCadGeometryBuilder.``SelectionList`

  Returns the selected meshes

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

  Getter Method

  Signature `SelectionList`

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

  New in version NX6.0.4.

  Deprecated since version NX8.5.0: Use `CAE.ProjectNodesToCadGeometryBuilder.CheckedObjectsList()` instead.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## ShowNodeLabels

`ProjectNodesToCadGeometryBuilder.``ShowNodeLabels`

  Returns or sets a value indicating whether to show the labels for proximity nodes are off underlying CAD geometry.

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

  Getter Method

  Signature `ShowNodeLabels`

  Returns: |
  Return type: | bool

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `ShowNodeLabels`

  Parameters: | showLabels (bool) –

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## ShowNodeLocations

`ProjectNodesToCadGeometryBuilder.``ShowNodeLocations`

  Returns or sets a value indicating whether to show original location and adjusted location for the proximity nodes that are off the underlying CAD geometry by a given tolerance.

  The original node location will be displayed in color `CAE.ProjectNodesToCadGeometryBuilder.OriginalNodeLocationColor`()`. The adjusted node location will be displayed in color `CAE.ProjectNodesToCadGeometryBuilder.AdjustedNodeLocationColor`()`.

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

  Getter Method

  Signature `ShowNodeLocations`

  Returns: |
  Return type: | bool

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `ShowNodeLocations`

  Parameters: | showLocations (bool) –

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Tolerance

`ProjectNodesToCadGeometryBuilder.``Tolerance`

  Returns the proximity tolerance used to determine if nodes on close enough to be considered on the CAD geometry

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

  Getter Method

  Signature `Tolerance`

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

  New in version NX8.5.0.

  License requirements: None.

# Method Detail

## AdjustProximityNodes

`ProjectNodesToCadGeometryBuilder.``AdjustProximityNodes`

  Adjusts the proximity nodes identified to the new location to meet the given tolerance with underlying CAD geometries.

  The cached identified result will be clean when the adjust work is completed. The method `Builder.Commit()` will do the same thing. The adjust work is only available when the context part of this builder is a `CAE.FemPart`.

  Signature `AdjustProximityNodes()`

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## GetNodes

`ProjectNodesToCadGeometryBuilder.``GetNodes`

  Returns the cached nodes calculated by `CAE.ProjectNodesToCadGeometryBuilder.IdentifyCadGeometry()`.

  Signature `GetNodes()`

  Returns: | a tuple
  Return type: | A tuple consisting of (projectLocations, nodes, cadGeometries). projectLocations is a list of `NXOpen.Point3d`. nodes is a list of `NXOpen.CAE.FENode`. cadGeometries is a list of `NXOpen.NXObject`.

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## GetProximityNodes

`ProjectNodesToCadGeometryBuilder.``GetProximityNodes`

  Returns the cached proximity nodes calculated by `CAE.ProjectNodesToCadGeometryBuilder.IdentifyProximityNodes()`.

  Signature `GetProximityNodes()`

  Returns: | a tuple
  Return type: | A tuple consisting of (projectLocations, proximityNodes). projectLocations is a list of `NXOpen.Point3d`. proximityNodes is a list of `NXOpen.CAE.FENode`.

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## IdentifyCadGeometry

`ProjectNodesToCadGeometryBuilder.``IdentifyCadGeometry`

  Identifies the relationship between CAD geometry and the nodes, The identified result will be cached, you could access the cached results by calling `CAE.ProjectNodesToCadGeometryBuilder.GetNodes()`.

  Old cached results are automatically cleaned up when the new identify process is running.

  Signature `IdentifyCadGeometry()`

  New in version NX11.0.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## IdentifyProximityNodes

`ProjectNodesToCadGeometryBuilder.``IdentifyProximityNodes`

  Identifies the proximity nodes which are off the underlying CAD geometry according to `CAE.ProjectNodesToCadGeometryBuilder.ProximityTolerance`()` and `CAE.ProjectNodesToCadGeometryBuilder.IncludeMidnodes`()`.

  If showing nodes is true, the identified node location will be displayed. The identified result will be cached, you could access the cached identified nodes by `CAE.ProjectNodesToCadGeometryBuilder.GetProximityNodes()`. Each time, the old cached result will be clean up when the new identify process is running.

  Signature `IdentifyProximityNodes()`

  New in version NX8.5.0.

  License requirements: nx_masterfem (“Finite Element Modeling”)

## Validate

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