Main Content

findStructuralDamping

Find damping model assigned to structural dynamics model

Description

example

dma = findStructuralDamping(dampingModels) returns the damping model and its parameters assigned to the entire structural dynamics model. The toolbox supports the proportional (Rayleigh) damping model and the modal damping model. The parameters of the proportional damping model are the mass and stiffness proportional damping parameters. The parameter of the modal damping model is the modal damping ratio.

Use this function to find which damping model and parameters are currently active if you made multiple damping assignments.

Examples

collapse all

Find the damping model assignment for a 3-D model.

Create a transient structural model.

structuralModel = createpde("structural","transient-solid");

Import and plot the geometry.

importGeometry(structuralModel,"Block.stl");
pdegplot(structuralModel,"CellLabels","on")

Figure contains an axes object. The axes object contains 6 objects of type quiver, text, patch, line.

Specify the stiffness proportional damping parameter.

structuralDamping(structuralModel,"Beta",40);

Now specify the mass proportional damping parameter.

structuralDamping(structuralModel,"Alpha",10);

Check the damping parameter assignment for structuralModel. Notice that the Beta parameter is empty.

findStructuralDamping(structuralModel.DampingModels)
ans = 
  StructuralDampingAssignment with properties:

      RegionType: 'Cell'
        RegionID: 1
    DampingModel: "proportional"
           Alpha: 10
            Beta: []
            Zeta: []

When you specify damping parameters by calling the structuralDamping function several times, the toolbox uses the last assignment. Specify both the mass and stiffness parameters.

structuralDamping(structuralModel,"Alpha",10,"Beta",40);

Check the damping parameter assignment for structuralModel.

findStructuralDamping(structuralModel.DampingModels)
ans = 
  StructuralDampingAssignment with properties:

      RegionType: 'Cell'
        RegionID: 1
    DampingModel: "proportional"
           Alpha: 10
            Beta: 40
            Zeta: []

Input Arguments

collapse all

Damping model of the structural model, specified as a DampingModels property of a StructuralModel object.

Example: structuralmodel.DampingModels

Output Arguments

collapse all

Damping model assignment, returned as a StructuralDampingAssignment object. For details, see StructuralDampingAssignment Properties.

Version History

Introduced in R2018a