# Configuration Files

HvTrans uses configuration files to receive a set of data requests and settings from you. These files can be created manually or by using the HvTrans GUI.

## Save Settings to a Configuration File

From the File menu, select Save Config File.

## Open a Configuration File

1. From the File menu, select Open config file.
2. To reselect the desired result type from what you previously defined in the configuration file, load the solver result file first, then load the configuration file in HvTrans.
The selection is now set as it is defined in the configuration file.
Note: If a configuration file which has derived subcases defined like "Linear Superposition" or "Envelope" is opened, a warning message is displayed stating that these derived subcases will be ignored in translation.

## Configuration Files Example

A description of some of the commands in the configuration file is provided below.

 BeginParts/EndParts block This block lists part IDs that identify which model and result information will be translated to the new file. If this block is missing or all parts are listed, the data selected in the Subcase block (described below) will be translated for the whole model. BeginSubcase/EndSubcase block This block defines which subcase (referenced by subcase ID or (all) for all subcases) should be used for the following list of simulations (described below). BeginDerivedSubcase/EndDerivedSubcase block Used for defining a derived subcase (basic, superposition, or envelope). This block defines which subcase, referenced by subcase ID or all (for all subcases), should be used for the following list of simulations (described below). BeginSimulation/EndSimulation subblock of This block defines which simulations (referenced by index, beginning with "1" for the first simulation, or (all) for all simulations) should be accessed to extract the list of datatype requests that follows (described below). Note: Even if the list is empty, datatypes that can be used for animation will be automatically extracted. Strings in the form, datatype|layer|component or its variations, define data requests (see example). Format The type of derived subcase defined inside a BeginDerivedSubcase/EndDerivedSubcase block. Valid options are: basic, superposition, or envelope. Title The label used for a derived subcase defined inside a BeginDerivedSubcase/EndDerivedSubcase block. Scale The scale factor applied to a simulation step which is included in the derived subcase block. EnableCompression = %error, ziplevel This command defines compression. If the command line argument, -z %error, is provided, it takes precedence over configuration settings.Note: Regardless of user-defined settings, a default of 7 is always used for ziplevel. ResultReader = "reader name" This command enforces the use of a particular reader for results data. Otherwise, HvTrans automatically detects which reader to use. ModelReader = "reader name" This command enforces the use of a particular reader for model data. Otherwise, HvTrans automatically detects which reader to use. Extended Info This command contains information for the "All" check boxes (On or Off) of the Result type, Entity with layers, and Result components. There will be information for these check boxes for each result type requested.In the example below, there are two result types requested. ExtendedInfo: {{3 0 1 1}}{{3 0 1 1}} {{3 0 1 1}} means->For the first result type requested: 3 - Subcase ID 0 - "All" check box for Result type is Off 1 - "All" check box for Entity with layers is On 1 - "All" check box for Result components is On

The configuration file may contain other settings that could be used by other HvTrans modules.

A typical configuration file created by the HvTrans GUI is shown below.
---------------------------------------------------
EnableCompression = 0.0100, 7
BeginParts
BeginPool:Shell
8
1
5
2
4
EndPool
EndParts
BeginSubcase:1
BeginSimulation:1
Stress
EndSimulation
BeginSimulation:4
Stress
EndSimulation
EndSubcase
BeginSubcase:2
BeginSimulation:(all)
(all)
EndSimulation
EndSubcase
BeginSubcase:3
BeginSimulation:(all)
Stress|(Max)|vonMises
Stress|(Max)|P1
Stress|(Max)|P2
Stress|(Max)|P3
Stress|(Min)|vonMises
Stress|(Min)|P1
Stress|(Min)|P2
Stress|(Min)|P3
EndSimulation
EndSubcase
ExtendedInfo: {{3 0 1 1}}{{3 0 1 1}}
----------------------------------------------------------
A typical configuration file with derived subcases is shown below:
-------------------------
BeginParts
BeginPool:Shell
8
1
5
2
4
EndPool
EndParts
BeginSubcase:1
BeginSimulation:1
Displacement
Stress
Velocity
EndSimulation
BeginSimulation:4
Displacement
Stress
Velocity
EndSimulation
BeginSimulation:5
Displacement
Stress
Velocity
EndSimulation
EndSubcase
ExtendedInfo: {{1 0 1 1} {1 0 1 1} {1 0 1 1}}
##############################################
// Defining a basic derived subcase
BeginDerivedSubcase : 2
Format = basic
BeginSimulation : 4
subcase = 1
simulation = 4
scale = 1
EndSimulation
BeginSimulation : 1
subcase = 1
simulation = 1
scale = 1
EndSimulation
EndDerivedSubcase
##############################################
// Defining a linear superposition derived subcase
BeginDerivedSubcase : 3
Format = superposition
Title = SuperPosition Subcase
BeginSimulation : 1
subcase = 1
simulation = 1
scale = 1
EndSimulation
BeginSimulation : 5
subcase = 1
simulation = 5
scale = 1
EndSimulation
EndDerivedSubcase
##############################################
// Defining an Envelope derived subcase
BeginDerivedSubcase : 4
Format = envelope
Function = max
BeginSimulation : 1
subcase = 1
simulation = 1
scale = 1
EndSimulation
BeginSimulation : 5
subcase = 1
simulation = 5
scale = 1
EndSimulation
BeginSimulation : 4
subcase = 1
simulation = 4
scale = 1
EndSimulation
EndDerivedSubcase
##############################################