Subroutine Type

Utility/Data Access

Definition

This subroutine extracts state variables in a MotionSolve model.

Use

This function-style subroutine can be called from within any user written subroutine to extract MotionSolve results for output to a file or further processing for real time animation and plotting.

Calling Syntax

Fortran

call GET_POST_STATES(TYPE, ELEM_ID, STATES, NSTATES)

C

c_get_post_states(type, id, states, nstates)

Python

states = py_get_post_states(TYPE, ELEM_ID)

MATLAB

states = m_get_post_states(TYPE, ELEM_ID)

Input Arguments

[CHARACTER] TYPE

Select from PART, REQUEST, FLEX_BODY, or POINT_MASS.

[integer] ELEM_ID

The ID of the element whose states are desired.

Output Values

[logical] STATES

NULL when IFLAG = 1, DOUBLE array of size NSTATES when IFLAG = 0.

[logical] NSTATES

The number of elements in STATES array.

Complete Definition

The table below lists the valid options for TYPE and the size and description of the STATES array, which is returned by MotionSolve.

Type

NSTATES

STATES

PART

7

X, Y, Z, Euler parameters (E0, E1, E2, E3)

POINT_MASS

3

X, Y, Z

FLEX_BODY

20+nmodes

States[0 - 6] = X, Y, Z, E0, E1, E2, E3

States[7 - 12] =

States[13 - 18] =

States[19 - (18+nmodes)] = Modal Participation Factors

States[19+nmodes] = Strain Energy

REQUEST

8

Request values.