External Force from File

The time series file is an ASCII text file, with comments beginning with apostrophes in the first lines on the file. The data section of the file contains time and the 6 components of the position vector.

1. File format:

1.1. File heading, arbitrary number of lines with apostrophe in the first position of the input line

' TEXT-1
' TEXT-2
' ......
' TEXT-n

1.2. 1 input line

NCOL

  • NCOL: integer: Number of columns (=6)

1.3. 1 input line

NROW

  • NROW: integer: Number of rows (i.e. no. of time incidents)

1.4. 1 input line

SAMP

  • SAMP: real: Sampling interval \(\mathrm {[T]}\)

1.5. Force components, NROW lines (one per time incident)

FX   FY   FZ   MX   MY   MZ

  • FX: real, default: 0: Force in X-direction, \(\mathrm {[F]}\)

  • FY: real, default: 0: Force in Y-direction, \(\mathrm {[F]}\)

  • FZ: real, default: 0: Force in Z-direction, \(\mathrm {[F]}\)

  • MX: real, default: 0: Moment about X-axis, \(\mathrm {[FL]}\)

  • MY: real, default: 0: Moment about Y-axis, \(\mathrm {[FL]}\)

  • MZ: real, default: 0: Moment about Z-axis, \(\mathrm {[FL]}\)

2. Example:

'text
'text
6                    ' Number of columns
1000                 ' Number of time steps
1.0                  ' Time step
F1     F2   F3   M1   M2   M3
F1     F2   F3   M1   M2   M3
F1     F2   F3   M1   M2   M3