## On this page

  

 

 # `Crack`

 Last update: 16.07.2025 

<a id="ansys.mechanical.stubs.v241.Ansys.ACT.Automation.Mechanical.Crack"></a>

#### *class* Ansys.ACT.Automation.Mechanical.Crack

Bases: [`object`](https://docs.python.org/3/library/functions.html#object)

Defines a Crack.

<a id="overview"></a>

## Overview

### Methods

NameDescription[`Activate`](#Crack.Activate)Activate the current object.[`AddCommandSnippet`](#Crack.AddCommandSnippet)Creates a new CommandSnippet[`AddComment`](#Crack.AddComment)Creates a new child Comment.[`AddFigure`](#Crack.AddFigure)Creates a new child Figure.[`AddImage`](#Crack.AddImage)Creates a new child Image.[`CopyTo`](#Crack.CopyTo)Copies all visible properties from this object to another.[`CreateParameter`](#Crack.CreateParameter)Creates a new parameter for a Property.[`Delete`](#Crack.Delete)Run the Delete action.[`Duplicate`](#Crack.Duplicate)Creates a copy of the current DataModelObject.[`GetChildren`](#Crack.GetChildren)Gets the list of children, filtered by type.[`GetParameter`](#Crack.GetParameter)Gets the parameter corresponding to the given property.[`GroupAllSimilarChildren`](#Crack.GroupAllSimilarChildren)Run the GroupAllSimilarChildren action.[`GroupSimilarObjects`](#Crack.GroupSimilarObjects)Run the GroupSimilarObjects action.[`PropertyByAPIName`](#Crack.PropertyByAPIName)Get a property by its API name.[`PropertyByName`](#Crack.PropertyByName)Get a property by its unique name.[`RemoveParameter`](#Crack.RemoveParameter)Removes the parameter from the parameter set corresponding to the given property.### Properties

NameDescription[`AlignWithFaceNormal`](#Crack.AlignWithFaceNormal)Gets or sets the AlignWithFaceNormal.[`BottomFaceNodes`](#Crack.BottomFaceNodes)Gets or sets the BottomFaceNodes.[`Children`](#Crack.Children)Gets the list of children.[`CircumferentialDivisions`](#Crack.CircumferentialDivisions)Gets or sets the CircumferentialDivisions.[`Comments`](#Crack.Comments)Gets the list of associated comments.[`Contact1Nodes`](#Crack.Contact1Nodes)Gets or sets the Contact1Nodes.[`ContactPairsNodes`](#Crack.ContactPairsNodes)Gets or sets the ContactPairsNodes.[`CoordinateSystem`](#Crack.CoordinateSystem)Gets or sets the CoordinateSystem.[`CrackFacesNodes`](#Crack.CrackFacesNodes)Gets or sets the CrackFacesNodes.[`CrackFrontDivisions`](#Crack.CrackFrontDivisions)Gets or sets the CrackFrontDivisions.[`CrackFrontNodes`](#Crack.CrackFrontNodes)Gets or sets the CrackFrontNodes.[`CrackID`](#Crack.CrackID)Gets the CrackID.[`CrackShape`](#Crack.CrackShape)Gets the CrackShape.[`CrackSourceType`](#Crack.CrackSourceType)Gets the CrackSourceType.[`DataModelObjectCategory`](#Crack.DataModelObjectCategory)Gets the current DataModelObject’s category.[`FaceTopNodes`](#Crack.FaceTopNodes)Gets or sets the FaceTopNodes.[`Figures`](#Crack.Figures)Gets the list of associated figures.[`FractureAffectedZone`](#Crack.FractureAffectedZone)Gets or sets the FractureAffectedZone.[`FractureAffectedZoneHeight`](#Crack.FractureAffectedZoneHeight)Gets or sets the FractureAffectedZoneHeight.[`Images`](#Crack.Images)Gets the list of associated images.[`InternalObject`](#Crack.InternalObject)Gets the internal object. For advanced usage only.[`LargestContourRadius`](#Crack.LargestContourRadius)Gets or sets the LargestContourRadius.[`Location`](#Crack.Location)Gets the Location.[`MajorRadius`](#Crack.MajorRadius)Gets or sets the MajorRadius.[`MeshContours`](#Crack.MeshContours)Gets or sets the MeshContours.[`MinorRadius`](#Crack.MinorRadius)Gets or sets the MinorRadius.[`ProjectToNearestSurface`](#Crack.ProjectToNearestSurface)Gets or sets the ProjectToNearestSurface.[`Properties`](#Crack.Properties)Gets the list of properties for this object.[`ReadOnly`](#Crack.ReadOnly)Gets or sets the ReadOnly.[`SolutionContours`](#Crack.SolutionContours)Gets or sets the SolutionContours.[`Suppressed`](#Crack.Suppressed)Gets or sets the Suppressed.[`Target1Nodes`](#Crack.Target1Nodes)Gets or sets the Target1Nodes.[`VisibleProperties`](#Crack.VisibleProperties)Gets the list of properties that are visible for this object.[`XScaleFactor`](#Crack.XScaleFactor)Gets or sets the XScaleFactor.[`YScaleFactor`](#Crack.YScaleFactor)Gets or sets the YScaleFactor.[`ZScaleFactor`](#Crack.ZScaleFactor)Gets or sets the ZScaleFactor.<a id="property-detail"></a>

## Property detail

<a id="Crack.AlignWithFaceNormal"></a>

### *property* Crack.AlignWithFaceNormal *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the AlignWithFaceNormal.

<a id="Crack.BottomFaceNodes"></a>

### *property* Crack.BottomFaceNodes *: [str](https://docs.python.org/3/library/stdtypes.html#str) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the BottomFaceNodes.

<a id="Crack.Children"></a>

### *property* Crack.Children *: List\[Ansys.Mechanical.DataModel.Interfaces.IDataModelObject\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of children.

<a id="Crack.CircumferentialDivisions"></a>

### *property* Crack.CircumferentialDivisions *: [int](https://docs.python.org/3/library/functions.html#int) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the CircumferentialDivisions.

<a id="Crack.Comments"></a>

### *property* Crack.Comments *: Iterable\[[Ansys.ACT.Automation.Mechanical.Comment](Comment.md#ansys.mechanical.stubs.v241.Ansys.ACT.Automation.Mechanical.Comment)\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of associated comments.

<a id="Crack.Contact1Nodes"></a>

### *property* Crack.Contact1Nodes *: [str](https://docs.python.org/3/library/stdtypes.html#str) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the Contact1Nodes.

<a id="Crack.ContactPairsNodes"></a>

### *property* Crack.ContactPairsNodes *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the ContactPairsNodes.

<a id="Crack.CoordinateSystem"></a>

### *property* Crack.CoordinateSystem *: [Ansys.ACT.Automation.Mechanical.CoordinateSystem](CoordinateSystem.md#ansys.mechanical.stubs.v241.Ansys.ACT.Automation.Mechanical.CoordinateSystem) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the CoordinateSystem.

<a id="Crack.CrackFacesNodes"></a>

### *property* Crack.CrackFacesNodes *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the CrackFacesNodes.

<a id="Crack.CrackFrontDivisions"></a>

### *property* Crack.CrackFrontDivisions *: [int](https://docs.python.org/3/library/functions.html#int) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the CrackFrontDivisions.

<a id="Crack.CrackFrontNodes"></a>

### *property* Crack.CrackFrontNodes *: [str](https://docs.python.org/3/library/stdtypes.html#str) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the CrackFrontNodes.

<a id="Crack.CrackID"></a>

### *property* Crack.CrackID *: [int](https://docs.python.org/3/library/functions.html#int) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the CrackID.

<a id="Crack.CrackShape"></a>

### *property* Crack.CrackShape *: [Ansys.Mechanical.DataModel.Enums.CrackShapeType](../../../Mechanical/DataModel/Enums/CrackShapeType.md#ansys.mechanical.stubs.v241.Ansys.Mechanical.DataModel.Enums.CrackShapeType) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the CrackShape.

<a id="Crack.CrackSourceType"></a>

### *property* Crack.CrackSourceType *: [Ansys.Mechanical.DataModel.Enums.CrackSourceType](../../../Mechanical/DataModel/Enums/CrackSourceType.md#ansys.mechanical.stubs.v241.Ansys.Mechanical.DataModel.Enums.CrackSourceType) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the CrackSourceType.

<a id="Crack.DataModelObjectCategory"></a>

### *property* Crack.DataModelObjectCategory *: [Ansys.Mechanical.DataModel.Enums.DataModelObjectCategory](../../../Mechanical/DataModel/Enums/DataModelObjectCategory.md#ansys.mechanical.stubs.v241.Ansys.Mechanical.DataModel.Enums.DataModelObjectCategory) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the current DataModelObject’s category.

<a id="Crack.FaceTopNodes"></a>

### *property* Crack.FaceTopNodes *: [str](https://docs.python.org/3/library/stdtypes.html#str) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the FaceTopNodes.

<a id="Crack.Figures"></a>

### *property* Crack.Figures *: Iterable\[[Ansys.ACT.Automation.Mechanical.Figure](Figure.md#ansys.mechanical.stubs.v241.Ansys.ACT.Automation.Mechanical.Figure)\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of associated figures.

<a id="Crack.FractureAffectedZone"></a>

### *property* Crack.FractureAffectedZone *: Ansys.Core.Units.Quantity | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the FractureAffectedZone.

<a id="Crack.FractureAffectedZoneHeight"></a>

### *property* Crack.FractureAffectedZoneHeight *: Ansys.Core.Units.Quantity | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the FractureAffectedZoneHeight.

<a id="Crack.Images"></a>

### *property* Crack.Images *: Iterable\[[Ansys.ACT.Automation.Mechanical.Image](Image.md#ansys.mechanical.stubs.v241.Ansys.ACT.Automation.Mechanical.Image)\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of associated images.

<a id="Crack.InternalObject"></a>

### *property* Crack.InternalObject *: Ansys.Common.Interop.DSObjectsAuto.IDSCrackAuto | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the internal object. For advanced usage only.

<a id="Crack.LargestContourRadius"></a>

### *property* Crack.LargestContourRadius *: Ansys.Core.Units.Quantity | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the LargestContourRadius.

<a id="Crack.Location"></a>

### *property* Crack.Location *: Ansys.ACT.Interfaces.Common.ISelectionInfo | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the Location.

<a id="Crack.MajorRadius"></a>

### *property* Crack.MajorRadius *: Ansys.Core.Units.Quantity | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the MajorRadius.

<a id="Crack.MeshContours"></a>

### *property* Crack.MeshContours *: [int](https://docs.python.org/3/library/functions.html#int) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the MeshContours.

<a id="Crack.MinorRadius"></a>

### *property* Crack.MinorRadius *: Ansys.Core.Units.Quantity | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the MinorRadius.

<a id="Crack.ProjectToNearestSurface"></a>

### *property* Crack.ProjectToNearestSurface *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the ProjectToNearestSurface.

<a id="Crack.Properties"></a>

### *property* Crack.Properties *: [tuple](https://docs.python.org/3/library/stdtypes.html#tuple)\[Ansys.ACT.Automation.Mechanical.Property\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of properties for this object.

<a id="Crack.ReadOnly"></a>

### *property* Crack.ReadOnly *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the ReadOnly.

<a id="Crack.SolutionContours"></a>

### *property* Crack.SolutionContours *: [int](https://docs.python.org/3/library/functions.html#int) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the SolutionContours.

<a id="Crack.Suppressed"></a>

### *property* Crack.Suppressed *: [bool](https://docs.python.org/3/library/functions.html#bool) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the Suppressed.

<a id="Crack.Target1Nodes"></a>

### *property* Crack.Target1Nodes *: [str](https://docs.python.org/3/library/stdtypes.html#str) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the Target1Nodes.

<a id="Crack.VisibleProperties"></a>

### *property* Crack.VisibleProperties *: [tuple](https://docs.python.org/3/library/stdtypes.html#tuple)\[Ansys.ACT.Automation.Mechanical.Property\] | [None](https://docs.python.org/3/library/constants.html#None)*

Gets the list of properties that are visible for this object.

<a id="Crack.XScaleFactor"></a>

### *property* Crack.XScaleFactor *: [float](https://docs.python.org/3/library/functions.html#float) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the XScaleFactor.

<a id="Crack.YScaleFactor"></a>

### *property* Crack.YScaleFactor *: [float](https://docs.python.org/3/library/functions.html#float) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the YScaleFactor.

<a id="Crack.ZScaleFactor"></a>

### *property* Crack.ZScaleFactor *: [float](https://docs.python.org/3/library/functions.html#float) | [None](https://docs.python.org/3/library/constants.html#None)*

Gets or sets the ZScaleFactor.

<a id="method-detail"></a>

## Method detail

<a id="Crack.Activate"></a>

### Crack.Activate()

Activate the current object.

<a id="Crack.AddCommandSnippet"></a>

### Crack.AddCommandSnippet()

Creates a new CommandSnippet

<a id="Crack.AddComment"></a>

### Crack.AddComment()

Creates a new child Comment.

<a id="Crack.AddFigure"></a>

### Crack.AddFigure()

Creates a new child Figure.

<a id="Crack.AddImage"></a>

### Crack.AddImage(filePath: [str](https://docs.python.org/3/library/stdtypes.html#str))

```text
Creates a new child Image.
If a filePath is provided, the image will be loaded from that file,
if not, the image will be a screen capture of the Geometry window.

```

<a id="Crack.CopyTo"></a>

### Crack.CopyTo(other: Ansys.ACT.Automation.Mechanical.DataModelObject)

Copies all visible properties from this object to another.

<a id="Crack.CreateParameter"></a>

### Crack.CreateParameter(propName: [str](https://docs.python.org/3/library/stdtypes.html#str))

Creates a new parameter for a Property.

<a id="Crack.Delete"></a>

### Crack.Delete()

Run the Delete action.

<a id="Crack.Duplicate"></a>

### Crack.Duplicate()

Creates a copy of the current DataModelObject.

<a id="Crack.GetChildren"></a>

### Crack.GetChildren(recurses: [bool](https://docs.python.org/3/library/functions.html#bool), children: List\[ChildrenType\])

Gets the list of children, filtered by type.

<a id="Crack.GetParameter"></a>

### Crack.GetParameter(propName: [str](https://docs.python.org/3/library/stdtypes.html#str))

Gets the parameter corresponding to the given property.

<a id="Crack.GroupAllSimilarChildren"></a>

### Crack.GroupAllSimilarChildren()

Run the GroupAllSimilarChildren action.

<a id="Crack.GroupSimilarObjects"></a>

### Crack.GroupSimilarObjects()

Run the GroupSimilarObjects action.

<a id="Crack.PropertyByAPIName"></a>

### Crack.PropertyByAPIName(name: [str](https://docs.python.org/3/library/stdtypes.html#str))

```text
Get a property by its API name.
If multiple properties have the same API Name, only the first property with that name will be returned.

```

<a id="Crack.PropertyByName"></a>

### Crack.PropertyByName(name: [str](https://docs.python.org/3/library/stdtypes.html#str))

Get a property by its unique name.

<a id="Crack.RemoveParameter"></a>

### Crack.RemoveParameter(propName: [str](https://docs.python.org/3/library/stdtypes.html#str))

Removes the parameter from the parameter set corresponding to the given property.