Returns the requested history.
Value = GetRequestedHistory(
revdbm,
revdbf,
output_parameter,
dof,
node_no,
element_no,
local_node_no,
stored_timesteps,
no_timesteps,
array,
label)
Argument |
Description |
revdbm |
Revision number of the motion database file. Integer scalar (input) |
revdbf |
Revision number of the force database file. Integer scalar (input) |
output_parameter |
Requested output parameter. Integer scalar (input). See Table of Outputs for more details. |
dof |
Requested output parameter degree of freedom. Integer scalar (input). See Table of Outputs for more details. |
node_no |
Node number. Integer scalar (input/output). This may also be used to specify a guide surface, zero-gap guide or pipe-in-pipe connection number. If a node label is specified and a value of zero is specified for this variable, then the actual node number designated by the label is returned here. |
element_no |
Element number. Integer scalar (input). |
local_node_no |
Element local node number. Integer scalar (input). |
stored_timesteps |
Number of outputted time-steps to the database. Integer scalar (input). Call GetDatabaseInfo function to retrieve this value. |
no_timesteps |
Number of time steps requested for output. Integer scalar (input). |
array |
Output parameter history information. Real array of dimension (no_timesteps) (output). |
label |
Node label. Character string of unspecified length (input). This is relevant only if the node number was specifed as zero otherwise the node number specified takes precedence. |
Value |
Description |
0 |
Successful. History is returned |
A positive value |
Errors occured. Please call the GetRequestedHistoryError function to check which errors occured. |
Output parameter |
DOF |
Location of data |
Description. |
1 |
N/A |
Motion/Force Database |
Time. |
2 |
N/A |
Motion/Force Database |
Time-Step. |
3 |
N/A |
Motion/Force Database |
Water Surface Elevation. |
4 |
N/A |
Motion/Force Database |
Kinetic Energy. |
5 |
1-7 |
Motion Database |
Motion (DOFs 1-6, 7 - resultant rotation). |
6 |
1-7 |
Motion Database |
Velocity (DOFs 1-6, 7 - resultant angular velocity). |
7 |
1-7 |
Motion Database |
Acceleration (DOFs 1-6, 7 - resultant angular acceleration). |
8 |
1-3 |
Motion Database |
Guide Surface Origin Position (X,Y,Z). |
8 |
4-6 |
Motion Database |
Guide Surface Local-x Vector (X,Y,Z). |
8 |
7-9 |
Motion Database |
Guide Surface Local-y Vector (X,Y,Z). |
9 |
1-3 |
Motion Database |
Zero-Gap Guide Origin Position (X,Y,Z). |
9 |
4-6 |
Motion Database |
Zero-Gap Guide Direction (X,Y,Z) |
10 |
1-4 |
Motion Database |
Seabed contact flag and X, Y and Z reactions, on node-by-node basis. |
10 |
5-8 |
Motion Database |
Guide contact flag and X, Y and Z reactions, on node-by-node basis. |
11 |
1 |
Motion Database |
Clashing Clearance. |
11 |
2-3 |
Force Database |
Clashing Reaction and Impulse. |
12 |
1-3 |
Motion Database |
Motion of Auxiliary Nodes (X,Y,Z). |
13 |
1-7 |
Force Database |
Node Reactions (DOFs 1-6, 7 - resultant moment). |
14 |
1-4 |
Force Database |
Guide Surface Contact Reactions (X,Y,Z,magnitude), on guide-by-guide basis. |
15 |
1-4 |
Force Database |
Zero-Gap Guide Contact Reactions (X,Y,Z,magnitude), on guide-by-guide basis. |
16 |
1-4 |
Force Database |
Pipe-In-Pipe Connection Reactions (1-axial, 2-normal, 3-transverse, 4-magnitude). |
17 |
1 |
Force Database |
Axial Force. |
17 |
2 |
Force Database |
Local-y Shear Force. |
17 |
3 |
Force Database |
Local-z Shear Force. |
17 |
4 |
Force Database |
Torque. |
17 |
5 |
Force Database |
Local-y Bending Moment. |
17 |
6 |
Force Database |
Local-z Bending Moment. |
17 |
7 |
Force Database |
Effective Tension. |
17 |
8 |
Force Database |
Resultant Bending Moment. |
17 |
9 |
Force Database |
Resultant Curvature. |
17 |
10 |
Force Database |
Resultant Shear Force. |
17 |
11 |
Force Database |
Local-y Curvature. |
17 |
12 |
Force Database |
Local-z Curvature. |
17 |
13 |
Force Database |
Axial Strain. |
17 |
14 |
Force Database |
Temperature. |
18 |
1-2 |
Force Database |
Pressure (1-Internal, 2-External). |