GageMap Overview

Third Party Libraries

Some features of GageMap are only available with third-party libraries. In order to make these libraries available to GageMap, they need to be found in the path of the operating system. This applies to such libraries as MATLAB and ANSYS.

Tools such as MATLAB and Abaqus are installed with libraries that GageMap can use. For example, Model Export can export to MATLAB MAT format if it has access to those libraries. These tools cannot be packaged with GageMap as they are proprietary, but if they are installed on the local machine, various features will be enabled.

In order for GageMap to find the needed libraries, they must be available in a system path. The following is a simple guide in setting this up for Windows and Linux.

Windows

There is a setup panel for environment variables in the Control Panel of Windows. On modern operating systems, the quickest route is to open the start menu and use the search bar at the bottom to find ‘environment variables’. The widget will contain a button for editing these variables.

Both the user and the system variables may have a variable called “Path” which can be set to anything. Whatever is in that path, GageMap will see.

GageMap will need a complete path leading to the library files desired. For example, Windows’ MATLAB requires a path along the lines of the following:

C:Program FilesMATLABR2012bbinwin64

WARNING: Do not delete existing paths. Append new paths only, or other system operations may cease to operate correctly.

Linux

Either install the third-party library to the standardize paths such as /usr/lib or /usr/lib64, or set the environment variable LD_LIBRARY_PATH to point to its custom location.

To set this field temporarily in a terminal, use: export LD_LIBRARY_PATH=”<path>:$LD_LIBRARY_PATH”

To set this field permanently, review how this is done for the Linux distribution in use. It is likely to be a matter of editing a file such as .bashrc or .profile. The internet provides ample information for every flavor of Linux.

Alternatively, you may edit the script files used to launch GageMap executables and add the path to the same place that the scripts already adjust LD_LIBRARY_PATH.

Required Libraries

For MATLAB: Point to the path containing libmat.so(Linux) or libmat.dll(Windows)

For ANSYS: Point to the path containing libansys.so(Linux) or libansys.dll(Windows)

Note

As of GageMap version 3.6, this is no longer required

For ABAQUS: Point to the path containing the ABAQUS libraries. A list of these libraries can be seen here: Required Abaqus Libraries

Starting the Software

When starting the software, the startup screen will appear.

GageMap Splash Screen

The startup screen shows the version of GageMap and the licensing information for the current GageMap installation. The same information is also available in the program’s Help > About GageMap from the Main Menu. Pressing the close button on the splash screen, closes the splash screen and opens the GageMap Main Window.

The Main Interface

GageMap Main Interface

Quick Bar

_images/quickbar.png

Quick access links to the most frequently used features of GageMap includeing all of the tasks described under the task menu option. See Tasks

Toolbars

These toolbars are quick access view options for the model view. See View

_images/toolbar.png

View Options

These quick viewing options allow you to turn various visual representations on the model off or on. This includes the nodes, edges, and faces.

_images/viewopts.png

Labeling

These options toggle labels for nodes and faces. When turned on, the labels will appear as small text near each node or face, and can be useful for tracking down a specific region of the model.

_images/labeling.png

Selection Tools

Using the selection tools, you can choose either a face or a node to highlight for more information, such as strains and stresses, and displacement at various modes. When you are finished selecting faces or nodes, you should click the “X” selection tool to change back to regular mouse controls.

_images/selection.png