    

 ## On this page

  

 

 # `FaceMeshing`

 Last update: 09.03.2026 

<a id="ansys.mechanical.stubs.v251.Ansys.ACT.Automation.Mechanical.MeshControls.FaceMeshing"></a>

#### *class* Ansys.ACT.Automation.Mechanical.MeshControls.FaceMeshing

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

Defines a FaceMeshing.

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

## Overview

### Methods

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

NameDescription[`Active`](#FaceMeshing.Active)Gets the Active.[`Children`](#FaceMeshing.Children)Gets the list of children.[`Comments`](#FaceMeshing.Comments)Gets the list of associated comments.[`ConstrainBoundary`](#FaceMeshing.ConstrainBoundary)Gets or sets the ConstrainBoundary.[`DataModelObjectCategory`](#FaceMeshing.DataModelObjectCategory)Gets the current DataModelObject’s category.[`Figures`](#FaceMeshing.Figures)Gets the list of associated figures.[`Images`](#FaceMeshing.Images)Gets the list of associated images.[`InternalNumberOfDivisions`](#FaceMeshing.InternalNumberOfDivisions)Gets or sets the InternalNumberOfDivisions.[`InternalObject`](#FaceMeshing.InternalObject)Gets the internal object. For advanced usage only.[`Location`](#FaceMeshing.Location)Gets or sets the Location.[`MappedMesh`](#FaceMeshing.MappedMesh)Gets or sets the MappedMesh.[`Method`](#FaceMeshing.Method)Gets or sets the Method.[`MultiZoneSemiStructured`](#FaceMeshing.MultiZoneSemiStructured)Gets or sets the Semi-Structured in MZ Face Meshing (Mapping).[`NamedSelection`](#FaceMeshing.NamedSelection)Gets or sets the NamedSelection.[`Properties`](#FaceMeshing.Properties)Gets the list of properties for this object.[`ScopingMethod`](#FaceMeshing.ScopingMethod)Gets or sets the ScopingMethod.[`SpecifiedCorners`](#FaceMeshing.SpecifiedCorners)Gets or sets the SpecifiedCorners.[`SpecifiedEnds`](#FaceMeshing.SpecifiedEnds)Gets or sets the SpecifiedEnds.[`SpecifiedSides`](#FaceMeshing.SpecifiedSides)Gets or sets the SpecifiedSides.[`Suppressed`](#FaceMeshing.Suppressed)Gets or sets the Suppressed.[`TransitionType`](#FaceMeshing.TransitionType)Gets or sets the TransitionType of MZ Face Meshing (Mapping)[`VisibleProperties`](#FaceMeshing.VisibleProperties)Gets the list of properties that are visible for this object.<a id="property-detail"></a>

## Property detail

<a id="FaceMeshing.Active"></a>

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

Gets the Active.

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

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

Gets the list of children.

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

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

Gets the list of associated comments.

<a id="FaceMeshing.ConstrainBoundary"></a>

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

Gets or sets the ConstrainBoundary.

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

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

Gets the current DataModelObject’s category.

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

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

Gets the list of associated figures.

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

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

Gets the list of associated images.

<a id="FaceMeshing.InternalNumberOfDivisions"></a>

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

Gets or sets the InternalNumberOfDivisions.

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

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

Gets the internal object. For advanced usage only.

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

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

Gets or sets the Location.

<a id="FaceMeshing.MappedMesh"></a>

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

Gets or sets the MappedMesh.

<a id="FaceMeshing.Method"></a>

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

Gets or sets the Method.

<a id="FaceMeshing.MultiZoneSemiStructured"></a>

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

Gets or sets the Semi-Structured in MZ Face Meshing (Mapping).

<a id="FaceMeshing.NamedSelection"></a>

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

Gets or sets the NamedSelection.

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

### *property* FaceMeshing.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="FaceMeshing.ScopingMethod"></a>

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

Gets or sets the ScopingMethod.

<a id="FaceMeshing.SpecifiedCorners"></a>

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

Gets or sets the SpecifiedCorners.

<a id="FaceMeshing.SpecifiedEnds"></a>

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

Gets or sets the SpecifiedEnds.

<a id="FaceMeshing.SpecifiedSides"></a>

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

Gets or sets the SpecifiedSides.

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

### *property* FaceMeshing.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="FaceMeshing.TransitionType"></a>

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

Gets or sets the TransitionType of MZ Face Meshing (Mapping)

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

### *property* FaceMeshing.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="method-detail"></a>

## Method detail

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

### FaceMeshing.Activate()

Activate the current object.

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

### FaceMeshing.AddComment()

Creates a new child Comment.

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

### FaceMeshing.AddFigure()

Creates a new child Figure.

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

### FaceMeshing.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="FaceMeshing.CopyTo"></a>

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

Copies all visible properties from this object to another.

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

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

Creates a new parameter for a Property.

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

### FaceMeshing.Delete()

Run the Delete action.

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

### FaceMeshing.Duplicate()

Creates a copy of the current DataModelObject.

<a id="FaceMeshing.GenerateMesh"></a>

### FaceMeshing.GenerateMesh()

Generate the Mesh.

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

### FaceMeshing.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="FaceMeshing.GetParameter"></a>

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

Gets the parameter corresponding to the given property.

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

### FaceMeshing.GroupAllSimilarChildren()

Run the GroupAllSimilarChildren action.

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

### FaceMeshing.GroupSimilarObjects()

Run the GroupSimilarObjects action.

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

### FaceMeshing.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="FaceMeshing.PropertyByName"></a>

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

Get a property by its unique name.

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

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

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

<a id="FaceMeshing.RenameBasedOnDefinition"></a>

### FaceMeshing.RenameBasedOnDefinition()

Run the RenameBasedOnDefinition action.