BlankNestingBuilder Class — NXOpen Python API Reference 12.0.0 documentation

# BlankNestingBuilder Class

class `NXOpen.Tooling.``BlankNestingBuilder`

  Bases: `NXOpen.Builder`

  Blank Nesting Builder of PDW, EDW and Die Engineering.

  No object is returned by this builder. To create a new instance of this class, use `NXOpen.Tooling.BlankNestingCollection.CreateBlankNestingBuilder()`

  Default values.

  Property | Value
  --- | ---
  AngleResult | 0
  AngleStep | 25
  BlankArea | 0
  BoundarySegment | 200
  HeightStep | 25
  LayoutType | Rectangle
  MinimumDistance | 0
  PitchResult | 0
  StripWidthResult | 0
  Utilization | 0
  WebDistance | 0

  New in version NX8.5.0.

# Properties

Property | Description
--- | ---
AngleResult | Returns or sets the angle between processed blank and original blank.
AngleStep | Returns or sets the angle increment to use when rotating the blank during the processing to find the best layout.
BlankArea | Returns or sets the up datum face area that was found in the processing.
BoundarySegment | Returns or sets the number of boundary segment.
HeightStep | Returns or sets the distance increment to use when translating the blank in the vertical direction during the processing to find the best layout.
LayoutType | Returns or sets the type of layout to use in the blank nesting processing.
MinimumDistance | Returns or sets the minimum distance between the adjacent blanks.
PitchResult | Returns or sets the distance between blanks that was found in the processing.
SelectObject | Returns the selected entities making up the blank to be nested.
StripWidthResult | Returns or sets the strip width.
Tag | Returns the Tag for this object.
Utilization | Returns or sets the maximum material utilization of the blank.
WebDistance | Returns or sets the distance between the blank and the strip.

# Methods

Method | Description
--- | ---
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.
GetObject | Returns the object currently being edited by this builder.
LayoutCalculation | The method to calculate maximum material utilization for the selected entities.
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

BlankNestingBuilderLayoutTypeSpecification Enumeration | Specifies the layout type of blank nesting.

# Property Detail

## AngleResult

`BlankNestingBuilder.``AngleResult`

  Returns or sets the angle between processed blank and original blank.

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

  Getter Method

  Signature `AngleResult`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `AngleResult`

  Parameters: | angleResult (float) –

  New in version NX8.5.0.

  License requirements: None.

## AngleStep

`BlankNestingBuilder.``AngleStep`

  Returns or sets the angle increment to use when rotating the blank during the processing to find the best layout.

  The angle is specified in degrees.

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

  Getter Method

  Signature `AngleStep`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `AngleStep`

  Parameters: | angleStep (float) –

  New in version NX8.5.0.

  License requirements: None.

## BlankArea

`BlankNestingBuilder.``BlankArea`

  Returns or sets the up datum face area that was found in the processing.

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

  Getter Method

  Signature `BlankArea`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `BlankArea`

  Parameters: | blankArea (float) –

  New in version NX8.5.0.

  License requirements: None.

## BoundarySegment

`BlankNestingBuilder.``BoundarySegment`

  Returns or sets the number of boundary segment.

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

  Getter Method

  Signature `BoundarySegment`

  Returns: |
  Return type: | int

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `BoundarySegment`

  Parameters: | boundarySegment (int) –

  New in version NX8.5.0.

  License requirements: None.

## HeightStep

`BlankNestingBuilder.``HeightStep`

  Returns or sets the distance increment to use when translating the blank in the vertical direction during the processing to find the best layout.

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

  Getter Method

  Signature `HeightStep`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `HeightStep`

  Parameters: | heightStep (float) –

  New in version NX8.5.0.

  License requirements: None.

## LayoutType

`BlankNestingBuilder.``LayoutType`

  Returns or sets the type of layout to use in the blank nesting processing.

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

  Getter Method

  Signature `LayoutType`

  Returns: |
  Return type: | `NXOpen.Tooling.BlankNestingBuilderLayoutTypeSpecification`

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `LayoutType`

  Parameters: | layoutType (`NXOpen.Tooling.BlankNestingBuilderLayoutTypeSpecification`) –

  New in version NX8.5.0.

  License requirements: None.

## MinimumDistance

`BlankNestingBuilder.``MinimumDistance`

  Returns or sets the minimum distance between the adjacent blanks.

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

  Getter Method

  Signature `MinimumDistance`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `MinimumDistance`

  Parameters: | minimumDistance (float) –

  New in version NX8.5.0.

  License requirements: None.

## PitchResult

`BlankNestingBuilder.``PitchResult`

  Returns or sets the distance between blanks that was found in the processing.

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

  Getter Method

  Signature `PitchResult`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `PitchResult`

  Parameters: | pitchResult (float) –

  New in version NX8.5.0.

  License requirements: None.

## SelectObject

`BlankNestingBuilder.``SelectObject`

  Returns the selected entities making up the blank to be nested.

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

  Getter Method

  Signature `SelectObject`

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

  New in version NX8.5.0.

  License requirements: None.

## StripWidthResult

`BlankNestingBuilder.``StripWidthResult`

  Returns or sets the strip width.

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

  Getter Method

  Signature `StripWidthResult`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `StripWidthResult`

  Parameters: | stripWidthResult (float) –

  New in version NX8.5.0.

  License requirements: None.

## Utilization

`BlankNestingBuilder.``Utilization`

  Returns or sets the maximum material utilization of the blank.

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

  Getter Method

  Signature `Utilization`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `Utilization`

  Parameters: | utilization (float) –

  New in version NX8.5.0.

  License requirements: None.

## WebDistance

`BlankNestingBuilder.``WebDistance`

  Returns or sets the distance between the blank and the strip.

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

  Getter Method

  Signature `WebDistance`

  Returns: |
  Return type: | float

  New in version NX8.5.0.

  License requirements: None.

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

  Setter Method

  Signature `WebDistance`

  Parameters: | webDistance (float) –

  New in version NX8.5.0.

  License requirements: None.

# Method Detail

## LayoutCalculation

`BlankNestingBuilder.``LayoutCalculation`

  The method to calculate maximum material utilization for the selected entities.

  Signature `LayoutCalculation()`

  New in version NX8.5.0.

  License requirements: None.

## Validate

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