HyperMath

ReadVectorBuilder

ReadVectorBuilder

 Previous topic Next topic No expanding text in this topic  

ReadVectorBuilder

 Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

ReadVectorBuilder is a utility tool that reads CAE results/data files supported by HyperMath.  It helps you create the right ReadVector() and ReadMultVectors() commands.

The tool opens the ReadVector Utility dialog that can be used to select results files and navigate into the subcases, time steps, types, requests, and components contained in the selected file.

Upon making your selections and selecting Print, the appropriate HyperMath command (using either the ReadVector or ReadMultVectors command) is displayed.

Syntax

ReadVectorBuilder()

a = ReadVectorBuilder()

Outputs

Name

Description

 

a

Optional.  Returns 0 on success (integer).

Example

Example 1

 

Read values across all time steps.

 

read_vector_utility_dialog

The result file ANGACC is selected.

It contains no subcases (the field remains inactive).

All times steps are selected and the resultant angular acceleration of the lower torso is selected.

The command ReadVector("E:/Altair/13.0/tutorials/mv_hv_hg/plotting/ANGACC",2,1,1) can now be used in either the HML command window or a script.

Commands can be generated either with indices (integer) or strings by using the Insert data as strings checkbox.  The following two commands are equivalent:

ReadVector("E:/Altair/13.0/tutorials/mv_hv_hg/plotting/ANGACC",2,1,1)

ReadVector("E:/Altair/13.0/tutorials/mv_hv_hg/plotting/ANGACC","Angular Acceleration","50th% Hybrid3   - LOWER TORSO","Res. ang. acc.")

Executing these commands in HyperMath produces the following graph:

read_vector_utility_fnc_img2

The same file can be read in Altair HyperGraph:

read_vector_utility_fnc_img3

Example 2

In this example, one time step is selected, but multiple requests and multiple components are selected, creating a matrix of results.

read_vector_utility_fnc_img4

In this case, the first time step is selected and multiple requests and components are selected.  The resulting command

z=ReadMultVectors("E:/Altair/13.0.0/tutorials/mv_hv_hg/plotting/ANGACC",2,1,3,2,3,2)

will produce a 3x2 matrix:

read_vector_utility_fnc_img5

Example 3

In this example, subcases are available in the data file.  The third subcase is selected. There is no Time Step information available.  One node (for example, 236) is picked and the Z-displacement is queried.

read_vector_utility_fnc_img6

In HyperMath, these commands extract the displacement along Z of node 236 in the third subcase of this result file:

read_vector_utility_fnc_img7

Comments

The ReadVectorBuilder() utility contains the following fields:

 

•FilePath: Type in or open a file browser to select a CAE result file.
 
•Subcases: For the selected file, all subcases (if any) contained in the file are listed.
 
•Time Step: For the selected file, all time steps (if any) contained in the file are listed.
 
•Types: For the selected file, all types (if any) contained in the file are listed.
 
•Request Start: For the selected file, all requests contained in the file are listed.
 
•Request End: If the selection allows for selecting a range of requests, all requests contained in the file are listed.
 
•Display Filtered Components: Used to filter true components.  Some files list additional components (mostly Time), but those are not applicable.  They can be filtered out.

read_vector_utility_fnc_img8

•Component Start: For the selected file, all requests contained in the file are listed.
 
•Component End: If the selection allows for selecting a range of components, all components contained in the file are listed.
 
•Insert data as strings: By default, the ReadVector() and ReadMultVectors() commands generated by this utility use integer indices.  Use this checkbox to use strings.
 
•Help: Access to this help page.
 
•Print: After selecting items in the different fields, press Print to display the HyperMath command in the edition area (supports copy, paste, clear).

See Also

ReadVector

ReadMultVectors