GetRequestedHistory

<< Click to Display Table of Contents >>

Navigation:  Flexcom > Theory > Postprocessing > Custom Postprocessing > Database Access Routines > Database Access Routines >

GetRequestedHistory

Previous pageNext page

Returns the requested history.

Syntax

Value = GetRequestedHistory( 

  revdbm, 

  revdbf, 

  output_parameter, 

  dof, 

  node_no, 

  element_no, 

  local_node_no, 

  stored_timesteps, 

  no_timesteps, 

  array, 

  label)

 

Description of arguments

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.

 

Return Value

Value

Description

0

Successful. History is returned

A positive value

Errors occured. Please call the GetRequestedHistoryError function to check which errors occured.

 

Table of Outputs

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).