Matrix Browser

The Matrix browser is used to explore the HyperMesh and HyperView data entities and export the entities to external files for further analysis.

To open the Matrix browser, click Tools > Matrix Browser from the menu bar.

The Matrix browser is organized into two main sections. The top half of the browser provides a table view similar to an Excel spreadsheet. The bottom half of the browser shows and allows you to browse the HyperMesh/HyperView (data source) and its data entity (object) names and their data names (attributes). The HyperMesh database entities are shown in green and the HyperView database entities are shown in yellow. When you select a column in the table it becomes an active column and is highlighted in blue. All of the following searches are conducted on the active column.

The Matrix browser's context menu contains functionality unique to the browser.

matrix_browser_layout

Below is a highlight of the functionalities supported by the Matrix browser.

•	Query and modify HyperMesh and HyperView data entities without writing cumbersome TCL coding

•	Export HyperMesh and HyperView data to an Excel file for further post-processing and report generation

•	Establish a link between HyperMesh and HyperView in order to access model data (such as material, property, beam section) and results data in a single environment. The browser supports the selection of multiple load cases from the HyperView results database.

•	Create new procedures (macros) to enable automation with minimum TCL coding and also capture the automation process as TCL scripts. These macros can be used external to the Matrix browser, like the tools in the Altair script exchange.

Note:

The Matrix browser does not allow for the creation of new HyperMesh entities. The tool queries and modifies existing entity data. The browser also does not allow extensive geometry (lines, surface, solids) data query. It is intended for FE data and results that are already in the HypeMesh/HyperView databases.

1.	Open an existing HyperMesh model or import solver data.

2.	Use the split screen and invoke HyperView.

3.	Load the results file for the solved data into HyperMesh.

4.	Click Tools > Matrix Browser from the menu bar in HyperMesh.

matrix_browser_hm_hv_loaded

The image above shows HyperMesh and HyperView loaded

Note:

HyperView is only needed if the results are accessed from the Matrix browser. Please use HyperWorks Desktop to access HyperView functions from HyperMesh in the browser.

1.	In the DataSource column, select HMdata.

2.	In the Entities column, select a HyperMesh entity.

3.	Click Query.

4.	In the panel area, use the entity selector to select HyperMesh entities to add to the matrix.

A new green colored column is added to the matrix.

5.	In the matrix, click the elements header to access entity data.

The elements column turns blue when clicked, indicating the entities are active for the search operation. The Datanames column is populated with entity attributes from the HyperMesh database for the element IDs shown in the elements column.

matrix_browser_columns

6.	Select the material, property, or any other attribute(s) and click Query. One of more columns will be added. If you selected material, the material IDs will be shown.

7.	The next step is to get E, Nu from the material. Activate the material column, and then select E and Nu from the data names.

matrix_browser_getmaterial

8.	Click Query.

9.	Repeat this process for property and get the element thickness.

Derived data access

Derived data is not stored in HyperMesh data. It is calculated by a procedure predefined by the Matrix browser to calculate useful data from HyperMesh data. You can create these TCL procedures and store them in the Matrix start up. They will show up in the browser as derived_datanames. The pre-installed derived_datanames are width, height, radius and adjacent.

1.	In HyperMesh Desktop, split the graphics area into two windows. In the first screen, use HyperMesh to load the model files. In the second screen, use HyperView to load results files.

2.	From the menubar, click Tools > Matrix Browser. The Matrix browser opens.

3.	In the DataSource column, select HMdata.

4.	In the Entities column, select the required element directly or select components, material, property, or sets.

5.	In the DataSource column, select HVdata.

6.	In the Entities column, select Results.

7.	In the Subcase Options column, select multiple_subcases.

matrix_browser_1

8.	Select the results type(s) available in the solver results.

matrix_browser_2

9.	Select layer information (if available) and the results system in which the results are to be interpreted. User defined system results are available as long as a system is available in HyperView.

10.	By default, the matrix only displays the results for each subcase in separate column. Retrieve additional information by right-clicking and selecting Show all columns from the context menu.

Current_subcase selection is same as multiple_subcase, except that it provides the ability to create multiple worksheets when you run the macros.

1.	In HyperMesh Desktop, split the graphics area into two windows. In the first screen, use HyperMeshto load the model files. In the second screen, use HyperView to load results files.

2.	From the menubar, click Tools > Matrix Browser. The Matrix browser opens.

3.	In the DataSource column, select HMdata.

4.	In the Entities column, select the required element directly or select components, material, property, or sets.

5.	In the DataSource column, select HVdata.

6.	In the Entities column, select Results.

7.	In the Subcase Options column, select current_subcase.

matrix_browser_3

8.	Select the results type.

9.	In the HVSubcases dialog, select layer and system information.

Results for the current subcase display in the column.

matrix_browser_4

10.	From the Macro pull-down, click Save.

matrix_browser_4

11.	From the Macro pull-down, click Run.

12.	After the macro is finished running, you will be asked to select the load case. If you select multiple load cases, separate worksheets will be created for each load case as in the case of current load case.

matrix_browser_5

13.	Select the worksheet corresponding to the simulation.

1.	In HyperView, select the required results and contour data.

matrix_browser_6

matrix_browser_7

2.	From the menubar, click Tools > Matrix Browser. The Matrix browser opens.

3.	In the DataSource column, select HVdata.

4.	In the Entities column, select Results.

5.	In the Subcase Options column, select current_contour.

matrix_browser_8

6.	The current contour selection does not prompt you for load case, layer, or system information. The displayed results are queried in HyperView and sent to the matrix.

When you query max/min results for component/sets/material /property, HyperMesh will search the max/min values for the elements in that component and provide single values and the element ID/load case ID where that values occurs.

1.	In the DataSource column, select HMdata.

2.	In the Entities column, select components, sets, materials, or property.

matrix_browser_9

3.	In the DataSource column, select HVdata.

4.	Select results and the required data type.

5.	In the HVSubcases dialog, select layer, corner data type, system, and averaging methods.

matrix_browser_10

6.	The max/min results for that component display. In a separate column, additional data lines display the loads case and node/element information for the particular data.

matrix_browser_11

In the Matrix browser you can create and delete annotations (HV-notes) for selected column results using the right-click context menu option Notes to HV.

matrix_browser_12

matrix_browser_13

It is often useful to add additional data that is not in the HyperMesh or HyperView databases, which is known as user data.

1.	Click user_data in the Data Source column.

2.	Click Create in the user variables GUI column.

3.	Click double in the variable types column.

4.	Click Query.

5.	In the dialog provide the column label name, in this example Area_factor, select Multiple values and activate the Create a column on OK checkbox.

matrix_browser_user_data

6.	Click OK. The user data is added to the Matrix browser.

7.	In the matrix, right-click on the user data you created and select Create Metadata from the context menu.

8.	In the dialog, select entities to create metadata for.

matrix_browser_15

9.	Retrieve this data using entity based metadata.

matrix_browser_14

Once the HyperMesh, HyperView and user data is gathered in the Matrix browser the data can be exported to Excel by clicking Excel in the top right-hand corner of the browser.

1.	You can hide some of the columns that are not needed for export by right-clicking and selecting Hide Columns from the context sensitive menu.

matrix_browser_hide_columns

2.	You can also add more columns. To import the new column(s) from Excel into the Matrix browser click Matrix.

Displaying data in HyperMesh

1.	Click Correlations > Contour. A dialog opens.

2.	Select elements for the Entity Column label and Net_area for the Column on Y field.

3.	Click OK. The contour appears in HyperMesh.

Displaying data in HyperView

1.	Click Export > HyperView.

2.	Select a column to export. The exported data will appear in HyperView. You can post-process this data in the same manner as other HyperView data types.

matrix_browser_export_hyperview

matrix_browser_contour_hm_hv

The image above shows contouring in both HyperMesh and HyperView

HyperMesh has a built in scripting language based on TCL programming language. TCL is used to access HyperMesh and HyperView functionalities\methods as well as internal data. The following example calculates element strain (yy) from element 2D-Force-YY for a shell element.

1.	Click user_data in the Data Source column.

2.	Click Create in the user variables GUI column.

3.	Click Procedure in the variable type column. A dialog opens.

4.	Enter the column and function name.

5.	Activate the Create a column on OK checkbox.

6.	Add the following TCL code, based on Matrix column names, and then click OK.

proc Element_strain_calc { } {

set force_fyy[::MatrixBrowser::getColumn2D_Element_Force:YY]

set width [::MatrixBrowser::getColumn Width]

set young_mod [::MatrixBrowser::getColumn E]

set thickness [::MatrixBrowser::getColumn PSHELL_T]

set Strain_yy ""

set Strain_yy [expr $force_fyy/$width/$thickness/$young_mod]

return $Strain_yy

}

matrix_browser_element_strains

Element_strains are calculated and displayed

The process developed in the previous section can be stored as a macro (script) and can be reused with another HyperMesh data model or other HyperView databases.

1.	Click Macro > Save. Enter the Macro Name in the dialog and click OK. This macro can also be added to the menu bar and accessed and run without using the Matrix browser. The scripts are stored and can be reused like other HyperWorks scripts without the Matrix tool.

matrix_browser_create_macro