UniformDamping

UniformDamping

UniformDamping(dampingRatio: float, freql: float, freq2: float, Ta: Optional[float] = None, Td: Optional[float] = None, tsTagScaleFactorVsTime: Optional[int] = None, user_name: Optional[str] = None)

Bases: Damping

Uniform viscous damping model spanning a specific frequency band.

UniformDamping applies a constant damping ratio uniformly between lower and upper frequencies. It supports optional activation and deactivation schedules, as well as time-series-based amplitude scaling.

Tcl form

damping Uniform <tag> <dampingRatio> <freql> <freq2> [-activateTime <Ta>] [-deactivateTime <Td>] [-fact <tsTag>]

Example

from femora.core.model import Model

model = Model()
damping = model.damping.uniform(
    dampingRatio=0.05,
    freql=0.2,
    freq2=20.0,
    Ta=0.0,
    Td=10.0,
)
print(damping.tag)

Create a uniform damping model.

Parameters:

Name	Type	Description	Default
dampingRatio	float	Constant damping ratio (between 0.0 and 1.0).	required
freql	float	Lower bound of the frequency range in Hz.	required
freq2	float	Upper bound of the frequency range in Hz (must exceed freql).	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 dampingRatio, freql, or freq2 parameters are invalid.

Methods:

get_type staticmethod

get_type() -> str

Get the damping type name.

Returns:

Type	Description
str	The string "Uniform".