Skip to main content

Mechanical scripting interface

FatigueLife

Last update: 14.01.2025

class Ansys.ACT.Automation.Mechanical.Results.FatigueToolResults.FatigueLife

Bases: object

Defines a FatigueLife.

Overview

Methods

Name Description
Activate Activate the current object.
AddAlert Creates a new Alert
AddComment Creates a new child Comment.
AddConvergence Creates a new Convergence
AddFigure Creates a new child Figure.
AddImage Creates a new child Image.
ClearGeneratedData Run the ClearGeneratedData action.
CopyTo Copies all visible properties from this object to another.
CreateParameter CreateParameter method.
CreateResultsAtAllSets Creates results at all sets for results under a solution.
Delete Run the Delete action.
Duplicate Creates a copy of the current DataModelObject.
DuplicateWithoutResults Run the DuplicateWithoutResults action.
EvaluateAllResults Run the EvaluateAllResults action.
ExportAnimation Run the ExportAnimation action.
ExportToTextFile Run the ExportToTextFile action.
FetchRemoteResults Run the FetchRemoteResult action.
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.
PromoteToNamedSelection Run the PromoteToNamedSelection action.
PropertyByAPIName Get a property by its API name.
PropertyByName Get a property by its unique name.
RemoveParameter Removes the parameter from the parameter set corresponding to the given property.
RenameBasedOnDefinition Run the RenameBasedOnDefinition action.

Properties

Name Description
Average Gets the Average.
AverageAcrossBodies Gets or sets the AverageAcrossBodies.
By Gets or sets the By.
CalculateTimeHistory Gets or sets the CalculateTimeHistory.
Children Gets the list of children.
CombinationNumber Gets or sets the Combination Number for a Solution Combination result.
Comments Gets the list of associated comments.
CoordinateSystem Gets or sets the Coordinate System.
CrackFrontNumber Gets or sets the CrackFrontNumber.
DataModelObjectCategory Gets the current DataModelObject’s category.
DesignLife Gets or sets the DesignLife.
DisplayOption Gets or sets the DisplayOption.
DisplayTime Gets or sets the DisplayTime.
DpfEvaluation Gets or sets the DpfEvaluation.
Figures Gets the list of associated figures.
GlobalIDs Gets or sets the GlobalIDs.
GraphControlsXAxis Gets or sets the GraphControlsXAxis.
Identifier Gets or sets the Identifier.
Images Gets the list of associated images.
InternalObject Gets the internal object. For advanced usage only.
IsSolved Gets the IsSolved.
ItemType Gets or sets the ItemType.
IterationNumber Gets the IterationNumber.
LoadStep Gets the LoadStep.
LoadStepForMaximumOfMaximumValues Get the Load Step for the maximum of maximum values.
LoadStepForMaximumOfMinimumValues Get the Load Step for the maximum of minimum values.
LoadStepForMinimumOfMaximumValues Get the Load Step for the minimum of maximum values.
LoadStepForMinimumOfMinimumValues Get the Load Step for the minimum of minimum values.
LoadStepNumber Gets or sets the LoadStepNumber.
Location Gets or sets the Location.
Maximum Gets the Maximum.
MaximumOccursOn Gets the MaximumOccursOn.
MaximumOfMaximumOverTime Gets the MaximumOfMaximumOverTime.
MaximumOfMinimumOverTime Gets the MaximumOfMinimumOverTime.
Method Gets the Method.
Minimum Gets the Minimum.
MinimumOccursOn Gets the MinimumOccursOn.
MinimumOfMaximumOverTime Gets the MinimumOfMaximumOverTime.
MinimumOfMinimumOverTime Gets the MinimumOfMinimumOverTime.
NamedSelections Gets or sets the NamedSelections.
Path Path property.
PlotData Gets the result table.
Properties Gets the list of properties for this object.
RPMSelection Gets or sets the RPM Selection value at which the results are evaluated.
ScopingMethod Gets or sets the ScopingMethod.
SetNumber Gets or sets the Set Number.
SolutionCombinationDriver Gets or sets the SolutionCombinationDriver.
SolverComponentIDs Gets or sets the SolverComponentIDs.
Substep Gets the Substep.
Suppressed Gets or sets the Suppressed.
Surface Surface property.
SurfaceCoating SurfaceCoating property.
Time Gets the Time.
TimeForMaximumOfMaximumValues Get the Time for the maximum of maximum values.
TimeForMaximumOfMinimumValues Get the Time for the maximum of minimum values.
TimeForMinimumOfMaximumValues Get the Time for the minimum of maximum values.
TimeForMinimumOfMinimumValues Get the Time for the minimum of minimum values.
Total Gets the Total.
VisibleProperties Gets the list of properties that are visible for this object.

Property detail

property FatigueLife.Average : Ansys.Core.Units.Quantity | None

Gets the Average.

property FatigueLife.AverageAcrossBodies : bool | None

Gets or sets the AverageAcrossBodies.

property FatigueLife.By : Ansys.Mechanical.DataModel.Enums.SetDriverStyle | None

Gets or sets the By.

property FatigueLife.CalculateTimeHistory : bool | None

Gets or sets the CalculateTimeHistory.

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

Gets the list of children.

property FatigueLife.CombinationNumber : int | None

Gets or sets the Combination Number for a Solution Combination result.

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

Gets the list of associated comments.

property FatigueLife.CoordinateSystem : Ansys.ACT.Automation.Mechanical.CoordinateSystem | None

Gets or sets the Coordinate System. Accepts/Returns None for Solution Coordinate System in the general case (if applicable). Accepts/Returns None for Fiber Coordinate System for a result that is sub scoped by ply.

property FatigueLife.CrackFrontNumber : int | None

Gets or sets the CrackFrontNumber.

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

Gets the current DataModelObject’s category.

property FatigueLife.DesignLife : float | None

Gets or sets the DesignLife.

property FatigueLife.DisplayOption : Ansys.Mechanical.DataModel.Enums.ResultAveragingType | None

Gets or sets the DisplayOption.

property FatigueLife.DisplayTime : Ansys.Core.Units.Quantity | None

Gets or sets the DisplayTime.

property FatigueLife.DpfEvaluation : Ansys.Mechanical.DataModel.Enums.DpfEvaluationType | None

Gets or sets the DpfEvaluation.

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

Gets the list of associated figures.

property FatigueLife.GlobalIDs : str | None

Gets or sets the GlobalIDs.

property FatigueLife.GraphControlsXAxis : Ansys.Mechanical.DataModel.Enums.GraphControlsXAxis | None

Gets or sets the GraphControlsXAxis.

property FatigueLife.Identifier : str | None

Gets or sets the Identifier.

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

Gets the list of associated images.

property FatigueLife.InternalObject : Ansys.Common.Interop.DSObjectsAuto.IDSResultAuto | None

Gets the internal object. For advanced usage only.

property FatigueLife.IsSolved : bool | None

Gets the IsSolved.

property FatigueLife.ItemType : Ansys.Mechanical.DataModel.Enums.ResultFileItemType | None

Gets or sets the ItemType.

property FatigueLife.IterationNumber : int | None

Gets the IterationNumber.

property FatigueLife.LoadStep : int | None

Gets the LoadStep.

property FatigueLife.LoadStepForMaximumOfMaximumValues : int | None

Get the Load Step for the maximum of maximum values.

property FatigueLife.LoadStepForMaximumOfMinimumValues : int | None

Get the Load Step for the maximum of minimum values.

property FatigueLife.LoadStepForMinimumOfMaximumValues : int | None

Get the Load Step for the minimum of maximum values.

property FatigueLife.LoadStepForMinimumOfMinimumValues : int | None

Get the Load Step for the minimum of minimum values.

property FatigueLife.LoadStepNumber : int | None

Gets or sets the LoadStepNumber.

property FatigueLife.Location : Ansys.ACT.Interfaces.Common.ISelectionInfo | None

Gets or sets the Location.

property FatigueLife.Maximum : Ansys.Core.Units.Quantity | None

Gets the Maximum.

property FatigueLife.MaximumOccursOn : str | None

Gets the MaximumOccursOn.

property FatigueLife.MaximumOfMaximumOverTime : Ansys.Core.Units.Quantity | None

Gets the MaximumOfMaximumOverTime.

property FatigueLife.MaximumOfMinimumOverTime : Ansys.Core.Units.Quantity | None

Gets the MaximumOfMinimumOverTime.

property FatigueLife.Method : int | None

Gets the Method.

property FatigueLife.Minimum : Ansys.Core.Units.Quantity | None

Gets the Minimum.

property FatigueLife.MinimumOccursOn : str | None

Gets the MinimumOccursOn.

property FatigueLife.MinimumOfMaximumOverTime : Ansys.Core.Units.Quantity | None

Gets the MinimumOfMaximumOverTime.

property FatigueLife.MinimumOfMinimumOverTime : Ansys.Core.Units.Quantity | None

Gets the MinimumOfMinimumOverTime.

property FatigueLife.NamedSelections : Iterable[Ansys.Mechanical.DataModel.Interfaces.IDataModelObject] | None

Gets or sets the NamedSelections.

property FatigueLife.Path : Ansys.ACT.Automation.Mechanical.Path | None

Path property.

property FatigueLife.PlotData : Ansys.Mechanical.DataModel.Results.ResultDataTable | None

Gets the result table.

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

Gets the list of properties for this object.

property FatigueLife.RPMSelection : Ansys.Core.Units.Quantity | None

Gets or sets the RPM Selection value at which the results are evaluated.

property FatigueLife.ScopingMethod : Ansys.Mechanical.DataModel.Enums.GeometryDefineByType | None

Gets or sets the ScopingMethod.

property FatigueLife.SetNumber : int | None

Gets or sets the Set Number.

property FatigueLife.SolutionCombinationDriver : Ansys.Mechanical.DataModel.Enums.SolutionCombinationDriverStyle | None

Gets or sets the SolutionCombinationDriver.

property FatigueLife.SolverComponentIDs : str | None

Gets or sets the SolverComponentIDs.

property FatigueLife.Substep : int | None

Gets the Substep.

property FatigueLife.Suppressed : bool | None

Gets or sets the Suppressed.

property FatigueLife.Surface : Ansys.ACT.Automation.Mechanical.Surface | None

Surface property.

property FatigueLife.SurfaceCoating : Ansys.ACT.Automation.Mechanical.SurfaceCoating | None

SurfaceCoating property.

property FatigueLife.Time : Ansys.Core.Units.Quantity | None

Gets the Time.

property FatigueLife.TimeForMaximumOfMaximumValues : Ansys.Core.Units.Quantity | None

Get the Time for the maximum of maximum values.

property FatigueLife.TimeForMaximumOfMinimumValues : Ansys.Core.Units.Quantity | None

Get the Time for the maximum of minimum values.

property FatigueLife.TimeForMinimumOfMaximumValues : Ansys.Core.Units.Quantity | None

Get the Time for the minimum of maximum values.

property FatigueLife.TimeForMinimumOfMinimumValues : Ansys.Core.Units.Quantity | None

Get the Time for the minimum of minimum values.

property FatigueLife.Total : Ansys.Core.Units.Quantity | None

Gets the Total.

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

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

Method detail

FatigueLife.Activate()

Activate the current object.

FatigueLife.AddAlert()

Creates a new Alert

FatigueLife.AddComment()

Creates a new child Comment.

FatigueLife.AddConvergence()

Creates a new Convergence

FatigueLife.AddFigure()

Creates a new child Figure.

FatigueLife.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.

FatigueLife.ClearGeneratedData()

Run the ClearGeneratedData action.

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

Copies all visible properties from this object to another.

FatigueLife.CreateParameter(propName: str)

CreateParameter method.

FatigueLife.CreateResultsAtAllSets()

Creates results at all sets for results under a solution.

FatigueLife.Delete()

Run the Delete action.

FatigueLife.Duplicate()

Creates a copy of the current DataModelObject.

FatigueLife.DuplicateWithoutResults()

Run the DuplicateWithoutResults action.

FatigueLife.EvaluateAllResults()

Run the EvaluateAllResults action.

FatigueLife.ExportAnimation(filePath: str, format: Ansys.Mechanical.DataModel.Enums.GraphicsAnimationExportFormat, settings: Ansys.Mechanical.Graphics.AnimationExportSettings)

Run the ExportAnimation action.

FatigueLife.ExportToTextFile(filePath: str)

Run the ExportToTextFile action.

FatigueLife.FetchRemoteResults()

Run the FetchRemoteResult action.

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

Gets the list of children, filtered by type.

FatigueLife.GetParameter(propName: str)

Gets the parameter corresponding to the given property.

FatigueLife.GroupAllSimilarChildren()

Run the GroupAllSimilarChildren action.

FatigueLife.GroupSimilarObjects()

Run the GroupSimilarObjects action.

FatigueLife.PromoteToNamedSelection()

Run the PromoteToNamedSelection action.

FatigueLife.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.

FatigueLife.PropertyByName(name: str)

Get a property by its unique name.

FatigueLife.RemoveParameter(propName: str)

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

FatigueLife.RenameBasedOnDefinition()

Run the RenameBasedOnDefinition action.