Drift

The Drift type records the displacement drift between two nodes. The drift is taken as the ratio between the prescribed relative displacement and the specified distance between the nodes. The command to create a drift recorder is:

recorder Drift < -file $fileName > < -xml $fileName > < -binary $fileName > 
  < -tcp $inetAddress $port > < -precision $nSD > < -time > 
  -iNode $inode1 $inode2 ... -jNode $jnode1 $jnode2 ... 
  -dof $dof1 $dof2 ... -perpDirn $perpDirn1 $perpDirn2...

fileName

name of file to which output is sent. Each line of the file contains the result for a committed state of the domain file output is either in xml format (-xml option), textual (-file option) or binary (-binary option)

inetAddr

ip address, “xx.xx.xx.xx”, of remote machine to which data is sent

port

port on remote machine awaiting tcp

nSD

number of significant digits (optional, default is 6)

-time

using this option places domain time in first entry of each data line (optional, default: omitted)

inode1 inode2 …

tags of set of i nodes for which drift is being recorded

jnode1 jnode2 …

tags of set of j nodes for which drift is being recorded

dof1 dof2 …

set of nodal degrees of freedom for which drift is being recorded. Valid range is from 1 through ndf (the number of nodal degrees of freedom).

perpDirn1 perpDirn2 …

set of perpendicular global directions (1=\(X\), 2=\(Y\), 3=\(Z\)). This input is needed to calculate the length between the nodes whose drift is calculated.

NOTES

  • Only one of -file, -xml, -binary, -tcp will be used. If multiple specified last option is used.
  • -tcp option only available for version 2.2.1 and higher.
  • Does not work in OpenSeesSP.

Examples

recorder Drift -file drift.out -time -iNode 1 2 -jNode 3 4 -dof 1 -perpDirn 2

Code Developed by: fmk