TriangularTimeSeries

TriangularTimeSeries(tStart: float = 0.0, tEnd: float = 1.0, period: float = 1.0, factor: float = 1.0, shift: float = 0.0)

Bases: TimeSeries

Triangular-wave load-factor time series.

This time series generates a triangular wave between tStart and tEnd. It is useful for cyclic or piecewise-linear load-factor histories in dynamic analyses.

Tcl form

timeSeries Triangular <tag> <tStart> <tEnd> <period> -factor <factor> -shift <shift>

Attributes:

Name	Type	Description
`tStart`		Start time of the triangular wave.
`tEnd`		End time of the triangular wave.
`period`		Wave period.
`factor`		Scale factor for wave amplitude.
`shift`		Phase shift applied to the wave.

Example

from femora.core.model import Model

model = Model()
ts = model.time_series.triangular(
    tStart=0.0,
    tEnd=10.0,
    period=2.0,
    factor=1.5,
    shift=0.5,
)
pattern = model.pattern.plain(time_series=ts)
print(ts.tag)

Create a triangular time series.

Parameters:

Name	Type	Description	Default
`tStart`	`float`	Start time of the triangular wave.	`0.0`
`tEnd`	`float`	End time of the triangular wave.	`1.0`
`period`	`float`	Period of the triangular wave.	`1.0`
`factor`	`float`	Scale factor applied to the wave amplitude.	`1.0`
`shift`	`float`	Phase shift applied to the wave.	`0.0`

Raises:

Type	Description
`ValueError`	If numeric arguments are invalid, if `tStart` is not less than `tEnd`, or if `period` is not positive.