Skip to main content

Mechanical scripting interface 2025

`ImportedBodyForceDensity`

Last update: 09.03.2026

class Ansys.ACT.Automation.Mechanical.ImportedLoads.ImportedBodyForceDensity

Bases: object

Defines a ImportedBodyForceDensity.

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 body 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 body 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 ImportedBodyForceDensity.Algorithm : Ansys.Mechanical.DataModel.Enums.MappingAlgorithm | None

Algorithm property.

property ImportedBodyForceDensity.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 ImportedBodyForceDensity.BoundingBoxTolerance : Ansys.Core.Units.Quantity | None

BoundingBoxTolerance property.

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

Gets the list of children.

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

Gets the list of associated comments.

property ImportedBodyForceDensity.CreateNameSelectionForMappedNodes : bool | None

CreateNameSelectionForMappedNodes property.

property ImportedBodyForceDensity.CreateNameSelectionForOutsideNodes : bool | None

CreateNameSelectionForOutsideNodes property.

property ImportedBodyForceDensity.CreateNameSelectionForUnmappedNodes : bool | None

CreateNameSelectionForUnmappedNodes property.

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

Gets the current DataModelObject’s category.

property ImportedBodyForceDensity.DisplayInteriorPoints : bool | None

DisplayInteriorPoints property.

property ImportedBodyForceDensity.DisplayProjectionPlane : bool | None

DisplayProjectionPlane property.

property ImportedBodyForceDensity.DisplaySourcePointIds : bool | None

DisplaySourcePointIds property.

property ImportedBodyForceDensity.DisplaySourcePoints : bool | None

DisplaySourcePoints property.

property ImportedBodyForceDensity.ExtrapolationTolerancePercent : float | None

ExtrapolationTolerancePercent property.

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

Gets the list of associated figures.

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

Gets the list of associated images.

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

Gets the internal object. For advanced usage only.

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

Interpolation property.

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

KrigingCorrelationFunction property.

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

KrigingPolynom property.

property ImportedBodyForceDensity.Limit : int | None

Limit property.

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

Gets or sets the Location.

property ImportedBodyForceDensity.MappedNodesName : str | None

MappedNodesName property.

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

Mapping property.

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

MappingControl property.

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

MaxOutsideDistance property.

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

Method property.

property ImportedBodyForceDensity.NumberOfPoints : int | None

NumberOfPoints property.

property ImportedBodyForceDensity.OrientationRealignment : bool | None

OrientationRealignment property.

property ImportedBodyForceDensity.OutsideDistanceCheck : bool | None

OutsideDistanceCheck property.

property ImportedBodyForceDensity.OutsideNodesName : str | None

OutsideNodesName property.

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

OutsideOption property.

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

Pinball property.

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

Projection property.

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

Gets the list of properties for this object.

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

RigidBodyTransformationType property.

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

RigidTransformSourceCoordinateSystem property.

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

RigidTransformTargetCoordinateSystem property.

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

Gets or sets the SharedRefBody.

property ImportedBodyForceDensity.ShellThicknessFactor : float | None

ShellThicknessFactor property.

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

SourceMaximum property.

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

SourceMinimum property.

property ImportedBodyForceDensity.Suppressed : bool | None

Gets or sets the Suppressed.

property ImportedBodyForceDensity.UnmappedNodesName : str | None

UnmappedNodesName property.

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

VariableType property.

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

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

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

Weighting property.

Method detail

ImportedBodyForceDensity.Activate() → None

Activate the current object.

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

Creates a new child Comment.

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

Creates a new child Figure.

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

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

Creates a new MappingValidation

ImportedBodyForceDensity.ClearGeneratedData() → None

Run the ClearGeneratedData action.

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

Copies all visible properties from this object to another.

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

Creates a new parameter for a Property.

ImportedBodyForceDensity.Delete() → None

Run the Delete action.

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

Creates a copy of the current DataModelObject.

ImportedBodyForceDensity.ExportToTextFile(filePath: str) → None

Run the ExportToTextFile action.

ImportedBodyForceDensity.GetActivateAtLoadStep(stepNumber: int) → bool

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

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

Gets the list of children, filtered by type.

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

Gets the parameter corresponding to the given property.

ImportedBodyForceDensity.GroupAllSimilarChildren() → None

Run the GroupAllSimilarChildren action.

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

Run the GroupSimilarObjects action.

ImportedBodyForceDensity.Import() → None

Import.

ImportedBodyForceDensity.ImportLoad() → None

Run the ImportLoad action.

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

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

Get a property by its unique name.

ImportedBodyForceDensity.ReloadConfiguration() → None

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

ImportedBodyForceDensity.RemoveParameter(propName: str) → None

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

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

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

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