# Path TimeSeries

This command is used to construct a Path TimeSeries object. The relationship between load factor and time is input by the user as a series of discrete points in the 2d space (load factor, time). The input points can come from a file or from a list in the script. When the time specified does not match any of the input points, linear interpolation is used between points. There are many ways to specify the load path:

For a load path where the factors are specified in a tcl list with a constant time interval between points:

```tcl timeSeries Path $tag -dt $dt -values {list_of_values} <-factor $cFactor> <-useLast> <-prependZero> <-startTime $tStart> ```

For a load path where the factors are specified in a file for a constant time interval between points:

```tcl timeSeries Path $tag -dt $dt -filePath $filePath <-factor $cFactor> <-useLast> <-prependZero> <-startTime $tStart> ```

For a load path where the values are specified at non-constant time intervals:

```tcl timeSeries Path $tag -time {list_of_times} -values {list_of_values} <-factor $cFactor> <-useLast> ```

For a load path where both time and values are specified in a list included in the command

```tcl timeSeries Path $tag -fileTime $fileTime -filePath $filePath <-factor $cFactor> <-useLast> ```

tag

unique tag among TimeSeries objects.

filePath

file containing the load factors values

fileTime

file containing the time values for corresponding load factors

dT

time interval between specified points.

{ list_of_times}

time values in a tcl list

{ list_of_values}

load factor values in a tcl list

cFactor

optional, a factor to multiply load factors by (default = 1.0)

-useLast

optional, to use last value after the end of the series (default = 0.0)

-prependZero

optional, to prepend a zero value to the series of load factors (default = false). See NOTES.

tStart

optional, to provide a start time for provided load factors (default = 0.0)

NOTES:

## Examples

timeSeries Path 1 -dT 0.02 -filePath A-ELC270.AT2 -factor $G

timeSeries Path 2 -time {0.0 0.2 0.4 1.0} -values {0.0 1.0 2.0 0.0}


Code Developed by: fmk