Skip to main content

Mechanical scripting interface 2025

`ImportedSurfaceForceDensity`

Last update: 09.03.2026

class Ansys.ACT.Automation.Mechanical.ImportedLoads.ImportedSurfaceForceDensity

Bases: object

Defines a ImportedSurfaceForceDensity.

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.
AddMappingValidation Creates a new MappingValidation
ClearGeneratedData Run the ClearGeneratedData action.
CopyTo Copies all visible properties from this object to another.
CreateParameter Creates a new parameter for a Property.
Delete Run the Delete action.
Duplicate Creates a copy of the current DataModelObject.
ExportToTextFile Run the ExportToTextFile action.
GetActivateAtLoadStep Gets whether the imported surface force density is active at the specified load step.
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 Import.
ImportLoad Run the ImportLoad action.
PropertyByAPIName Get a property by its API name.
PropertyByName Get a property by its unique name.
ReloadConfiguration Reload the Imported Load’s setup from its associated configuration file (if available).
RemoveParameter Removes the parameter from the parameter set corresponding to the given property.
SetActivateAtLoadStep Sets whether the imported surface force density is active at the specified load step.
SyncAnalysisFrequencies Synchronizes the analysis settings’ RPMs and frequencies based on the selected imported load.

Properties

Name Description
Algorithm Algorithm property.
ApplyAs This controls how the imported load is applied, either as a boundary condition or an initial condition.
BoundingBoxTolerance BoundingBoxTolerance property.
Children Gets the list of children.
Comments Gets the list of associated comments.
CreateNameSelectionForMappedNodes CreateNameSelectionForMappedNodes property.
CreateNameSelectionForOutsideNodes CreateNameSelectionForOutsideNodes property.
CreateNameSelectionForUnmappedNodes CreateNameSelectionForUnmappedNodes property.
DataModelObjectCategory Gets the current DataModelObject’s category.
DisplayInteriorPoints DisplayInteriorPoints property.
DisplayProjectionPlane DisplayProjectionPlane property.
DisplaySourcePointIds DisplaySourcePointIds property.
DisplaySourcePoints DisplaySourcePoints property.
ExtrapolationTolerancePercent ExtrapolationTolerancePercent property.
Figures Gets the list of associated figures.
Images Gets the list of associated images.
InternalObject Gets the internal object. For advanced usage only.
Interpolation Interpolation property.
KrigingCorrelationFunction KrigingCorrelationFunction property.
KrigingPolynom KrigingPolynom property.
Limit Limit property.
Location Gets or sets the Location.
MappedNodesName MappedNodesName property.
Mapping Mapping property.
MappingControl MappingControl property.
MaxOutsideDistance MaxOutsideDistance property.
Method Method property.
NumberOfPoints NumberOfPoints property.
OrientationRealignment OrientationRealignment property.
OutsideDistanceCheck OutsideDistanceCheck property.
OutsideNodesName OutsideNodesName property.
OutsideOption OutsideOption property.
Pinball Pinball property.
Projection Projection property.
Properties Gets the list of properties for this object.
RigidBodyTransformationType RigidBodyTransformationType property.
RigidTransformSourceCoordinateSystem RigidTransformSourceCoordinateSystem property.
RigidTransformTargetCoordinateSystem RigidTransformTargetCoordinateSystem property.
SharedRefBody Gets or sets the SharedRefBody.
ShellThicknessFactor ShellThicknessFactor property.
SourceMaximum SourceMaximum property.
SourceMinimum SourceMinimum property.
Suppressed Gets or sets the Suppressed.
UnmappedNodesName UnmappedNodesName property.
VariableType VariableType property.
VisibleProperties Gets the list of properties that are visible for this object.
Weighting Weighting property.

Property detail

property ImportedSurfaceForceDensity.Algorithm : Ansys.Mechanical.DataModel.Enums.MappingAlgorithm | None

Algorithm property.

property ImportedSurfaceForceDensity.ApplyAs : Ansys.Mechanical.DataModel.Enums.ExternalLoadApplicationType | None

This controls how the imported load is applied, either as a boundary condition or an initial condition.

property ImportedSurfaceForceDensity.BoundingBoxTolerance : Ansys.Core.Units.Quantity | None

BoundingBoxTolerance property.

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

Gets the list of children.

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

Gets the list of associated comments.

property ImportedSurfaceForceDensity.CreateNameSelectionForMappedNodes : bool | None

CreateNameSelectionForMappedNodes property.

property ImportedSurfaceForceDensity.CreateNameSelectionForOutsideNodes : bool | None

CreateNameSelectionForOutsideNodes property.

property ImportedSurfaceForceDensity.CreateNameSelectionForUnmappedNodes : bool | None

CreateNameSelectionForUnmappedNodes property.

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

Gets the current DataModelObject’s category.

property ImportedSurfaceForceDensity.DisplayInteriorPoints : bool | None

DisplayInteriorPoints property.

property ImportedSurfaceForceDensity.DisplayProjectionPlane : bool | None

DisplayProjectionPlane property.

property ImportedSurfaceForceDensity.DisplaySourcePointIds : bool | None

DisplaySourcePointIds property.

property ImportedSurfaceForceDensity.DisplaySourcePoints : bool | None

DisplaySourcePoints property.

property ImportedSurfaceForceDensity.ExtrapolationTolerancePercent : float | None

ExtrapolationTolerancePercent property.

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

Gets the list of associated figures.

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

Gets the list of associated images.

property ImportedSurfaceForceDensity.InternalObject : Ansys.Common.Interop.DSObjectsAuto.IDSExternalLoadAuto | None

Gets the internal object. For advanced usage only.

property ImportedSurfaceForceDensity.Interpolation : Ansys.Mechanical.DataModel.Enums.InterpolationType | None

Interpolation property.

property ImportedSurfaceForceDensity.KrigingCorrelationFunction : Ansys.Mechanical.DataModel.Enums.KrigingCorrFuncType | None

KrigingCorrelationFunction property.

property ImportedSurfaceForceDensity.KrigingPolynom : Ansys.Mechanical.DataModel.Enums.KrigingPolynomType | None

KrigingPolynom property.

property ImportedSurfaceForceDensity.Limit : int | None

Limit property.

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

Gets or sets the Location.

property ImportedSurfaceForceDensity.MappedNodesName : str | None

MappedNodesName property.

property ImportedSurfaceForceDensity.Mapping : Ansys.Mechanical.DataModel.Enums.MappingInterpolationType | None

Mapping property.

property ImportedSurfaceForceDensity.MappingControl : Ansys.Mechanical.DataModel.Enums.MappingControlType | None

MappingControl property.

property ImportedSurfaceForceDensity.MaxOutsideDistance : Ansys.Core.Units.Quantity | None

MaxOutsideDistance property.

property ImportedSurfaceForceDensity.Method : Ansys.Mechanical.DataModel.Enums.MappingMethod | None

Method property.

property ImportedSurfaceForceDensity.NumberOfPoints : int | None

NumberOfPoints property.

property ImportedSurfaceForceDensity.OrientationRealignment : bool | None

OrientationRealignment property.

property ImportedSurfaceForceDensity.OutsideDistanceCheck : bool | None

OutsideDistanceCheck property.

property ImportedSurfaceForceDensity.OutsideNodesName : str | None

OutsideNodesName property.

property ImportedSurfaceForceDensity.OutsideOption : Ansys.Mechanical.DataModel.Enums.MappingOutsideOption | None

OutsideOption property.

property ImportedSurfaceForceDensity.Pinball : Ansys.Core.Units.Quantity | None

Pinball property.

property ImportedSurfaceForceDensity.Projection : Ansys.ACT.Automation.Mechanical.CoordinateSystem | None

Projection property.

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

Gets the list of properties for this object.

property ImportedSurfaceForceDensity.RigidBodyTransformationType : Ansys.Mechanical.DataModel.Enums.RigidBodyTransformationType | None

RigidBodyTransformationType property.

property ImportedSurfaceForceDensity.RigidTransformSourceCoordinateSystem : Ansys.ACT.Automation.Mechanical.CoordinateSystem | None

RigidTransformSourceCoordinateSystem property.

property ImportedSurfaceForceDensity.RigidTransformTargetCoordinateSystem : Ansys.ACT.Automation.Mechanical.CoordinateSystem | None

RigidTransformTargetCoordinateSystem property.

property ImportedSurfaceForceDensity.SharedRefBody : Ansys.ACT.Automation.Mechanical.Body | None

Gets or sets the SharedRefBody.

property ImportedSurfaceForceDensity.ShellThicknessFactor : float | None

ShellThicknessFactor property.

property ImportedSurfaceForceDensity.SourceMaximum : Ansys.Core.Units.Quantity | None

SourceMaximum property.

property ImportedSurfaceForceDensity.SourceMinimum : Ansys.Core.Units.Quantity | None

SourceMinimum property.

property ImportedSurfaceForceDensity.Suppressed : bool | None

Gets or sets the Suppressed.

property ImportedSurfaceForceDensity.UnmappedNodesName : str | None

UnmappedNodesName property.

property ImportedSurfaceForceDensity.VariableType : Ansys.Mechanical.DataModel.Enums.MappingVariableType | None

VariableType property.

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

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

property ImportedSurfaceForceDensity.Weighting : Ansys.Mechanical.DataModel.Enums.WeightingType | None

Weighting property.

Method detail

ImportedSurfaceForceDensity.Activate() → None

Activate the current object.

ImportedSurfaceForceDensity.AddComment() → Ansys.ACT.Automation.Mechanical.Comment

Creates a new child Comment.

ImportedSurfaceForceDensity.AddFigure() → Ansys.ACT.Automation.Mechanical.Figure

Creates a new child Figure.

ImportedSurfaceForceDensity.AddImage(filePath: str) → Ansys.ACT.Automation.Mechanical.Image

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.

ImportedSurfaceForceDensity.AddMappingValidation() → Ansys.ACT.Automation.Mechanical.MappingValidation

Creates a new MappingValidation

ImportedSurfaceForceDensity.ClearGeneratedData() → None

Run the ClearGeneratedData action.

ImportedSurfaceForceDensity.CopyTo(other: Ansys.ACT.Automation.Mechanical.DataModelObject) → None

Copies all visible properties from this object to another.

ImportedSurfaceForceDensity.CreateParameter(propName: str) → Ansys.ACT.Interfaces.Mechanical.IParameter

Creates a new parameter for a Property.

ImportedSurfaceForceDensity.Delete() → None

Run the Delete action.

ImportedSurfaceForceDensity.Duplicate() → Ansys.Mechanical.DataModel.Interfaces.IDataModelObject

Creates a copy of the current DataModelObject.

ImportedSurfaceForceDensity.ExportToTextFile(filePath: str) → None

Run the ExportToTextFile action.

ImportedSurfaceForceDensity.GetActivateAtLoadStep(stepNumber: int) → bool

Gets whether the imported surface force density is active at the specified load step.

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

Gets the list of children, filtered by type.

ImportedSurfaceForceDensity.GetParameter(propName: str) → Ansys.ACT.Interfaces.Mechanical.IParameter

Gets the parameter corresponding to the given property.

ImportedSurfaceForceDensity.GroupAllSimilarChildren() → None

Run the GroupAllSimilarChildren action.

ImportedSurfaceForceDensity.GroupSimilarObjects() → Ansys.ACT.Automation.Mechanical.TreeGroupingFolder

Run the GroupSimilarObjects action.

ImportedSurfaceForceDensity.Import() → None

Import.

ImportedSurfaceForceDensity.ImportLoad() → None

Run the ImportLoad action.

ImportedSurfaceForceDensity.PropertyByAPIName(name: str) → Ansys.ACT.Automation.Mechanical.Property

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.

ImportedSurfaceForceDensity.PropertyByName(name: str) → Ansys.ACT.Automation.Mechanical.Property

Get a property by its unique name.

ImportedSurfaceForceDensity.ReloadConfiguration() → None

Reload the Imported Load’s setup from its associated configuration file (if available).

ImportedSurfaceForceDensity.RemoveParameter(propName: str) → None

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

ImportedSurfaceForceDensity.SetActivateAtLoadStep(stepNumber: int, bActive: bool) → None

Sets whether the imported surface force density is active at the specified load step.

ImportedSurfaceForceDensity.SyncAnalysisFrequencies() → None

Synchronizes the analysis settings' RPMs and frequencies based on the selected imported load.
    A `NotSupportedException` exception will be thrown when called with any non-supported imported loads.

Connect with Ansys