Path TimeSeries

• Command_Manual
  • Tcl Commands
  • Modeling_Commands
    • model
    • uniaxialMaterial
    • ndMaterial
    • frictionModel
    • section
    • geometricTransf
    • element
    • node
    • sp commands
      • fix
      • fixX
      • fixY
      • fixZ
    • mp commands
      • equalDOF
      • rigidDiaphragm
      • rigidLink
    • timeSeries
    • pattern
    • mass
    • block commands
      • block2D
      • block3D
    • region
    • rayleigh
  • Analysis Commands
    • constraints Command
    • numberer Command
    • system Command
    • test Command
    • algorithm Command
    • integrator Command
    • analysis Command
    • eigen Command
    • analyze Command
  • Output Commands
    • recorder
    • record
    • print
    • printA
    • logFile
    • RealTime_Output_Commands
  • Misc Commands
    • eleResponse Command
    • getTime Command
    • getEleTags Command
    • getNodeTags
    • loadConst Command
    • nodeCoord Command
    • nodeDisp Command
    • nodeVel Command
    • nodeAccel Command
    • nodeEigenvector Command
    • nodeBounds
    • print Command
    • remove Command
    • reset Command
    • testIter
    • testNorms
    • wipe Command
    • exit Command
  • DataBase Commands
    • Template:DataBaseCommandsMenu

---

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:

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:

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:

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

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

timeSeries Path $tag -fileTime $fileTime -filePath $filePath <-factor $cFactor>

---

$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}	load factor values in a tcl list
{ list_of_values}	time values in a tcl list
$cFactor	optional, a factor to multiply load factors by (default = 1.0)
-useLast	optional, to use last value after end of series (default = 0.0)
-prependZero	optional, to prepend a zero value (default = false)
$tStart	optional, to provide a start time (default = 0.0)

NOTES:

• Linear interpolation between points.
• If time specified is beyond last point (AND WATCH FOR NUMERICAL ROUNDOFF), 0.0 is returned.

EXAMPLE

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