readsubcase

Returns a vector from the specified data file.

Syntax

readsubcase(file_name, subcase, type, request, component)

Argument

file_name
The name of the file from which to read.
subcase
The data subcase to read, either a string identifier as specified in the import template or external reader, or the explicit numerical index.
type
The type of data to read, either a string identifier as specified in the import template or external reader, or the explicit numerical index.
request
The data request to read, either a string identifier as specified in the import template or external reader, or the explicit numerical index.
component
The data component to read, either a string identifier as specified in the import template or external reader, or the explicit numerical index.

Example

Templex Expression
{

a = readsubcase("two.xy", 0, 0, 0, 0);

b = readsubcase("two.xy", 0, 0, 1, 0);

table(a, b, "%8.2f %8.2f", 0, 5);

}

{

a = readsubcase("indy.req", 0, 0, 0, 0);

b = readsubcase("indy.req", "Displacement", "Displacement", "REQ/997000 Global CG movement", "X")

table(a, b, "%8.2f %8.2f", 0, 5);

}

Comments

The resultant vector is read from the specified file using the appropriate import template or external reader in the MotionView or HyperGraph installation. Import templates and external readers contain the read instructions for the data file. Once these read instructions are registered with the software, all files of this type are automatically recognized by the software. Currently, there are over 40 different standard file types registered with the software. If a template or reader is not available, you can write a custom template and register it with the software describing the read instructions. Explicit numerical indices start at 0. If the “Time” vector is explicitly defined in the import template or external reader, then type is automatically 0. If you don’t know the data string identifier for a data file, load the file into MotionView or HyperGraph using the Build Plots panel. The appropriate string identifiers are displayed for each of the subcase, type, request, and component fields.