StructuralDampingAssignment Properties

(To be removed) Damping assignment for a structural analysis model

StructuralDampingAssignment will be removed. To find Rayleigh damping parameters of the model, use the DampingAlpha and DampingBeta properties of femodel instead. (since R2023a) For more information on updating your code, see Version History.

A StructuralDampingAssignment object contains the damping model and its parameters for a structural analysis model. A StructuralModel container has a vector of StructuralDampingAssignment objects in its DampingModels.StructuralDampingAssignments property.

To set damping parameters for your structural model, use the structuralDamping function.

Properties

RegionType — Region type

'Face' | 'Cell'

Region type, specified as 'Face' for a 2-D region, or 'Cell' for a 3-D region.

Data Types: char

RegionID — Region ID

positive integer

Region ID, specified as a positive integer.

Data Types: double

DampingModel — Damping model type

"proportional" | "modal" | "hysteretic"

Damping model type, specified as "proportional", "modal", or "hysteretic".

Data Types: string

Alpha — Mass proportional damping parameter

nonnegative number

Mass proportional damping parameter, specified as a nonnegative number.

Data Types: double

Beta — Stiffness proportional damping parameter

nonnegative number

Stiffness proportional damping parameter, specified as a nonnegative number.

Data Types: double

Zeta — Modal damping ratio

nonnegative number | function handle

Modal damping ratio, specified as a nonnegative number or a function handle. Use a function handle when each mode has its own damping ratio. The function must accept a vector of natural frequencies as an input argument and return a vector of corresponding damping ratios. It must cover the full frequency range for all modes used for modal solution.

Data Types: double | function_handle

Version History

Introduced in R2018a

R2025a: To be removed

StructuralDampingAssignment will be removed. To find Rayleigh damping parameters of the model, use the DampingAlpha and DampingBeta properties of femodel instead.

For example, you can check the Rayleigh damping parameters as follows.

 model = femodel(AnalysisType="structuralTransient", ...
                 Geometry="SquareBeam.stl");
model.DampingAlpha = 10;
model.DampingBeta = 2;
model.DampingAlpha
model.DampingBeta

Modal damping is specified as the DampingZeta argument of the solve function. This parameter is not stored within femodel.

The unified finite element model workflow defines the type of a problem and all of its parameters as the properties of an femodel object. This object enables you to specify physical parameters for structural, thermal, and electromagnetic types of analyses. The solver in the unified workflow uses only the parameters (properties) appropriate for the current analysis type while ignoring all other properties. If you switch the analysis type by setting the AnalysisType property of the model, the solver uses the appropriate set of properties corresponding to the new analysis type.

For more help migrating your existing code that uses StructuralModel to the unified finite element workflow, see Migration from Domain-Specific to Unified Workflow.