PathTime

The PathTime time series represents a time series where both time points and values are specified, either directly or from separate files.

Parameters:

Parameter	Description	Type
time	List of time points (optional if using fileTime)	list[float]
fileTime	Path to file containing time points (optional if using time)	str
values	List of force values (optional if using filePath)	list[float]
filePath	Path to file containing force values (optional if using values)	str
factor	Scale factor for force values (default: 1.0)	float
useLast	Use last force value beyond the last time point (default: False)	bool
prependZero	Prepend a zero value at the start (default: False)	bool
startTime	Start time of the time series (default: 0.0)	float

Example

# Using direct values
from femora.components.TimeSeries.timeSeriesBase import TimeSeriesManager

ts_manager = TimeSeriesManager()
pathtime_ts = ts_manager.create_time_series(
    'PathTime',
    time=[0.0, 0.1, 0.2, 0.3, 0.4],
    values=[0.0, 0.5, 1.0, 0.5, 0.0],
    factor=2.0
)

# Using files
pathtime_ts = ts_manager.create_time_series(
    'PathTime',
    fileTime='data/time.txt',
    filePath='data/forces.txt',
    factor=9.81,
    useLast=True
)

# Via Femora
import femora as fm


pathtime_ts = fm.timeSeries.create_time_series(
    'PathTime',
    time=[0, 1, 2, 3],
    values=[0, 1, 0, -1],
    factor=1.5,
    prependZero=True
)

File Format

When using files to specify the time and force values, each file should contain one value per line:

time.txt:

0.0
0.1
0.2
0.3
0.4

forces.txt:

0.0
0.5
1.0
0.5
0.0

The number of time points must match the number of force values.