TSL2CAV5: CAV5 ratio history from canonical acceleration time series.

In gmsp: Ground Motion Signal Processing

CAV5 ratio history from canonical acceleration time series.

Description

TSL2CAV5() computes the cumulative absolute velocity ratio using only acceleration samples with absolute value at least ⁠0.05 g⁠.

Usage

TSL2CAV5(.x, units.source, units.target = "mm", output = c("wide", "long"))

Arguments

.x	data.table. Long-format TSL with at least OCID, ID, t, and s columns plus optional metadata columns. Only rows with ID == "AT" are used.
units.source	character. Source length units of the s column ("mm", "cm", or "m"). Canonical TSL acceleration is interpreted as length units per second squared.
units.target	character. Target length units used for intermediate calculations. Default "mm".
output	character. "wide" returns one row per metadata and t, with one ratio column per OCID; "long" returns columns ⁠<metadata>, OCID, t, ratio⁠.

Value

See TSL2AI().

Examples

t <- seq(0, 1, by = 0.01)
tsl <- data.table::data.table(RecordID = "R1", OCID = "H1",
                              ID = "AT", t = t,
                              s = 1000 * sin(2 * pi * t))
TSL2CAV5(tsl, units.source = "mm")

gmsp documentation built on July 18, 2026, 5:07 p.m.