Contents: VMoveCAE Help Contents Prev: Tutorials - Controlling Midnode Writing Next: Translation Parameter Files |
![]() |
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:
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 --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