Skip to main content

Mechanical scripting interface

Materials

Last update: 14.01.2025

class Ansys.ACT.Automation.Mechanical.Materials

Bases: object

Defines a Materials.

Overview

Methods

Name Description
Activate Activate the current object.
AddComment Creates a new child Comment.
AddFigure Creates a new child Figure.
AddImage Creates a new child Image.
AddImportedTraceExternalData Creates a new Imported Trace (External Data).
AddMaterialAssignment Creates a new MaterialAssignment
AddMaterialCombination Creates a new MaterialCombination
AddMaterialPlot Creates a new MaterialPlot
CopyTo Copies all visible properties from this object to another.
CreateParameter Creates a new parameter for a Property.
Duplicate Creates a copy of the current DataModelObject.
GetChildren Gets the list of children, filtered by type.
GetParameter Gets the parameter corresponding to the given property.
GroupAllSimilarChildren Run the GroupAllSimilarChildren action.
GroupSimilarObjects Run the GroupSimilarObjects action.
Import
PropertyByAPIName Get a property by its API name.
PropertyByName Get a property by its unique name.
RefreshMaterials Run the RefreshMaterials action.
RemoveParameter Removes the parameter from the parameter set corresponding to the given property.

Properties

Name Description
Children Gets the list of children.
Comments Gets the list of associated comments.
DataModelObjectCategory Gets the current DataModelObject’s category.
Figures Gets the list of associated figures.
Images Gets the list of associated images.
InternalObject Gets the internal object. For advanced usage only.
MaterialAssignments Gets the MaterialAssignments.
MaterialCount Gets the MaterialCount.
Properties Gets the list of properties for this object.
ReadOnly Gets or sets the ReadOnly.
VisibleProperties Gets the list of properties that are visible for this object.

Property detail

property Materials.Children : List[Ansys.Mechanical.DataModel.Interfaces.IDataModelObject] | None

Gets the list of children.

property Materials.Comments : Iterable[Ansys.ACT.Automation.Mechanical.Comment] | None

Gets the list of associated comments.

property Materials.DataModelObjectCategory : Ansys.Mechanical.DataModel.Enums.DataModelObjectCategory | None

Gets the current DataModelObject’s category.

property Materials.Figures : Iterable[Ansys.ACT.Automation.Mechanical.Figure] | None

Gets the list of associated figures.

property Materials.Images : Iterable[Ansys.ACT.Automation.Mechanical.Image] | None

Gets the list of associated images.

property Materials.InternalObject : Ansys.Common.Interop.DSObjectsAuto.IDSMaterialGroupAuto | None

Gets the internal object. For advanced usage only.

property Materials.MaterialAssignments : int | None

Gets the MaterialAssignments.

property Materials.MaterialCount : int | None

Gets the MaterialCount.

property Materials.Properties : tuple[Ansys.ACT.Automation.Mechanical.Property] | None

Gets the list of properties for this object.

property Materials.ReadOnly : bool | None

Gets or sets the ReadOnly.

property Materials.VisibleProperties : tuple[Ansys.ACT.Automation.Mechanical.Property] | None

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

Method detail

Materials.Activate()

Activate the current object.

Materials.AddComment()

Creates a new child Comment.

Materials.AddFigure()

Creates a new child Figure.

Materials.AddImage(filePath: str)

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.

Materials.AddImportedTraceExternalData()

Creates a new Imported Trace (External Data).

Materials.AddMaterialAssignment()

Creates a new MaterialAssignment

Materials.AddMaterialCombination()

Creates a new MaterialCombination

Materials.AddMaterialPlot()

Creates a new MaterialPlot

Materials.CopyTo(other: Ansys.ACT.Automation.Mechanical.DataModelObject)

Copies all visible properties from this object to another.

Materials.CreateParameter(propName: str)

Creates a new parameter for a Property.

Materials.Duplicate()

Creates a copy of the current DataModelObject.

Materials.GetChildren(recurses: bool, children: List[ChildrenType])

Gets the list of children, filtered by type.

Materials.GetParameter(propName: str)

Gets the parameter corresponding to the given property.

Materials.GroupAllSimilarChildren()

Run the GroupAllSimilarChildren action.

Materials.GroupSimilarObjects()

Run the GroupSimilarObjects action.

Materials.Import(materialURI: str, format: Ansys.Mechanical.DataModel.MechanicalEnums.Materials.ImportFormat, settings: Ansys.Mechanical.Materials.ImportSettings)

Materials.PropertyByAPIName(name: str)

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.

Materials.PropertyByName(name: str)

Get a property by its unique name.

Materials.RefreshMaterials()

Run the RefreshMaterials action.

Materials.RemoveParameter(propName: str)

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