How to do Batch Translation?

VCollab Suite provides a batch utility called VMoveCAEBatch.exe. It is used to generate CAX files without user intervention and helps CAE analysts in automating the CAX generation process. Its usage is as follows: 

VMoveCAEBatch.exe [option=value] <model_file> [results_file] <CAX_file> 

The <model_file> and the <CAX_file> are mandatory arguments to the VMoveCAEBatch.exe.  They represent the file paths of the input CAE model file as well as the output CAX file. 

 

One very common usage scenario of VMoveCAE is to translate all the parts, and results from the given model file into a CAX file.  This can be achieved by providing the model file path and CAX file path specifying no options.  For example, the following command loads the file viewer_tutorial.odb from abaqus folder and creates a CAX file named viewer_tutorial.CAX under CAX folder. 

VMoveCAEBatch.exe abaqus\viewer_tutorial.odb CAX\viewer_tutorial.CAX 

Many native CAE software split the simulation data into model and result files. An example to this is, the Fluent .cas and .dat files. The .cas file predominantly consists of the mesh, boundary conditions and initial conditions where as the .dat file contains the simulation results. In such cases, VMoveCAE supports appending results from a result file to the mesh from the corresponding model file.  The results file path is provided by using the [results_file] optional argument.  For successful translation, the [results_file] and the <model_file> should correspond to the same case.  User also has to remember that this feature is available only for certain file types.  The following example describes how to translate mesh and results stored in different files to CAX.   

VMoveCAEBatch.exe fluent/ic3d1000.cas fluent/ic3d1000.dat CAX/ic3d1000.CAX 

VMoveCAEBatch translates all parts, results and instances when no options are specified on the command line.  However, most of the times, user wants to filter out information from CAE file and wants to translate only certain set of parts, results or instances. This filtering can be achieved in batch mode using the command-line options to VMoveCAEBatch.  Several of options provided by VMoveCAEBatch are mentioned below.

 Options:

 --results=RESULT_LIST

Translates the results listed in RESULT_LIST

Examples:

            --results=“Displacement, Stress”

            --results=“Temperature, Mach Number”

 

--filter-results=RESULT_LIST

Filters the results specified in RESULT_LIST

Examples:

--filter-results=“Von Mises Stress, Contact Pressure”

--filter-results=“Logarithmic Strain, Reaction Force”

 

--parts=PART_LIST

Translates the parts specified in PART_LIST

Example: --parts=“HINGEBASE, BOLTSURF,_PICKEDSET8”

 

--filter-parts=PART_LIST

Filters the parts specified in PART_LIST

Example: --filter-parts=“ALL ELEMENTS, WarnElemDistorted”

 

--parts-ids=PART_ID_LIST

Translates the parts having ids listed in PART_ID_LIST

Example: --part-ids=1,30-35,41

 

--filter-parts-ids=PART_ID_LIST

Filters the parts having ids listed in PART_ID_LIST

Example: --filter-part-ids=4-8,12

 

--instances=INSTANCE_LIST

Translates the instances listed in INSTANCE_LIST

Examples:

--instances=“1-6, 8-12”

--instances=“1:5-1:8, 2”

 

--filter-instances=INSTANCE_LIST

Filters the instances listed in INSTANCE_LIST

Example: --filter-instances=“:1-:4, 2”

 

--enable-mid-nodes

Enables mid-node translation

 

--disble-mid-nodes

Disables mid-node translation

 

-b <inputs_file_path>

Reads the translation parameters from the inputs_file_path.


 

Notes:

  1. The value of each option is a list whose items are separated by commas.  For example, --results=Displacement, Stress” results in a translation with “Displacement” and “Stress”. 
  2. It is mandatory to enclose the list in quotes (“”) when it involves spaces.  The quotes can be avoided if no spaces are involved.  For example, --results=Displacement, Stress” and --results=Displacement,Stress are equivalent.  However, we always advise the users to make a practice of using quotes always.
  3. The part ids as well as instances can involve the hyphens to specify a range.  For example, --filter-part-ids=4-8,12 option results in filtering of parts with ids 4, 5, 6, 7, 8 and 12.
  4. The exact interpretation of instance depends upon the context in which they are used. They are used in many places to signify the load step or time step number, increment number, vibration, or buckling mode number, etc. For example, for a CFD unsteady simulation, an instance 5 can represent fifth time-step in the simulation.   In an ABAQUS odb database the instance 3:2 is used to represent second frame of third step.
  5. Hyphens and ‘-‘ can be used together to specify the instances that need to be translated or filtered.  For example, --instances=“1-6, 8-12” option specifies that instances one to six and eight to twelve needs to be translated.  Similarly, --instances=“1:5-1:8, 2” option specifies that frames five to eight needs to be translated for the first step along with all frames for the second step.  Option --filter-instances=“:1-:4, 2” results in filtering of the frames for one to four for all steps.  It also filters out the all frames of second step.
  6. In case user specifying both --results as well as --filter-results options, the option --filter-results will be ignored to avoid the confusion on what to translate and what to filter.  Similarly, --filter-instances option will be ignored in favor of –instances option when both are specified. Options --filter-parts, and –filter-part-ids will be ignored if either of --parts, or --part-ids is specified.
  7. All the names of the results and parts are case insensitive.

 

Supported Results

The names of the results that VMoveCAE batch supports in its arguments are provided the following table.  This table also lists the corresponding data types for each result. 

Result Name

Result Type

Acceleration

Vector/SixDOF

Velocity

Vector/SixDOF

Body Force

Vector/SixDOF

Specific Heat

Scalar

Displacement

Vector/SixDOF

Density

Scalar

Contact Displacement

Vector/SixDOF

Strain

Tensor

Creep Strain

Tensor

Elastic Strain

Tensor

Equivalent Creep Strain

Scalar

Equivalent Elastic Strain

Scalar

Equivalent Plastic Strain

Scalar

Logarithmic Strain

Tensor

Plastic Strain

Tensor

Principal Strain

Scalars

Strain Rate

Tensor

Thermal Strain

Tensor

Energy

Scalar

Energy Density

Scalar

Total Energy

Scalar

Entropy

Scalar

Failure Index

Scalar

Contact Force

Vector/SixDOF

Gap Thickness

Scalar

Enthalpy

Scalar

Heat Generated

Scalar

Heat Flow

Scalar

Heat Flux

Vector/SixDOF

Heat Flux Component

Scalar

Conductive Heat Flux

Vector/SixDOF

Convective Heat Flux

Vector/SixDOF

Total Heat Flux

Scalar

Heat Gradient

Vector/SixDOF

Length

Scalar

Kinetic Energy

Scalar

Kinetic Energy Density

Scalar

Kinetic Energy Percent

Scalar

Mach Number

Scalar

Mass

Scalar

Mass Flow

Scalar

Mass Flux

Vector/SixDOF

Momentum

Vector/SixDOF

Pressure

Scalar

Contact Pressure

Scalar

Pressure Gradient

Vector/SixDOF

Reaction Force

Vector/SixDOF

Reaction Heat Flow

Scalar

Rotation Angle Vector

Vector/SixDOF

Stress

Tensor

Von Mises Stress

Scalar

Torsional Stress

Scalar

Tresca Stress

Scalar

Safety Factor

Scalar

Safety Factor Compression

Scalar

Safety Factor Tension

Scalar

Strain Energy

Scalar

Contact Status

Scalar

Thermal Energy Error

Scalar

Temperature

Scalar

Temperature Gradient

Vector/SixDOF

Total Temperature

Scalar

Thickness

Scalar

Contact Traction

Vector/SixDOF

External Applied Force

Vector/SixDOF

 

Examples: 

The following command creates a CAX file with all element sets, but with only displacement and stress results from the CAE file. 

VMoveCAEBatch.exe --results=Displacement, Stress” bracket2.op2 bracket2.CAX  

The following command creates a CAX file with all element sets, and all results except for external applied force and reaction force from the CAE file. 

VMoveCAEBatch.exe --filter-results=External Applied Force, Reaction Force” bracket2.op2 bracket2.CAX 

The following command creates a CAX file with all element sets except for “All Elements”, and results stress and displacement from the CAE file.  Only results belonging to step one, frames four to eight of step two and frames eleven to fifteen of all steps gets translated. 

VMoveCAEBatch.exe --results=Displacement, Stress” --instances=“1, 2:4-2:8, :11-:15” --filter-parts=“ALL ELEMENTS” viewer_tutorial.odb viewer_tutorial.CAX 

VMoveCAE also provides the ability to the user to speicfy the translation parameters using translation parameter files. Please refer the next section for the details on the file formats for translation parameters supported by VMoveCAE.  

VMoveCAEBatch.exe -b translation_parameters.txt