SecantStiffnessProportional

SecantStiffnessProportional

SecantStiffnessProportional(damping_factor: float, Ta: Optional[float] = None, Td: Optional[float] = None, tsTagScaleFactorVsTime: Optional[int] = None, user_name: Optional[str] = None)

Bases: Damping

Secant stiffness-proportional viscous damping model.

SecantStiffnessProportional defines damping proportional to the elements' secant stiffness. It supports activation scheduling and time-series-based scaling.

Tcl form

damping SecStiff <tag> <damping_factor> [-activateTime <Ta>] [-deactivateTime <Td>] [-fact <tsTag>]

Example

from femora.core.model import Model

model = Model()
damping = model.damping.secant_stiffness_proportional(
    damping_factor=0.05,
    Ta=0.0,
)
print(damping.tag)

Create a secant stiffness-proportional damping model.

Parameters:

Name	Type	Description	Default
damping_factor	float	Damping ratio proportional to secant stiffness (between 0.0 and 1.0).	required
Ta	Optional[float]	Optional activation time in seconds.	None
Td	Optional[float]	Optional deactivation time in seconds.	None
tsTagScaleFactorVsTime	Optional[int]	Optional time series tag for scaling damping.	None
user_name	Optional[str]	Optional unique name for the damping object.	None

Raises:

Type	Description
ValueError	If damping_factor is outside [0.0, 1.0].

Methods:

get_type staticmethod

get_type() -> str

Get the damping type name.

Returns:

Type	Description
str	The string "Secant Stiffness Proportional".