Usage

The usage of the VMoveXSubmit script is provided below.

VMoveXSubmit [options] [arguments_file]   (On Windows)
VMoveXSubmit [options] [arguments_file]   (On Linux)

Arguments File

The arguments_file is a text file containing the inputs and controls to the VMoveXSubmit translation. Let us consider the following example.

VMoveXSubmit test-data\arg_file.txt

VMoveXSubmit distribution consists of a test-data folder containing sample argument and input files. The above command tells the VMoveXSubmit to

  • read the arg_file.txt located in the test-data folder,

  • read the Fluent and dat .h5 files specified in this arg_file.txt

  • use the controls specified in this arg_file.txt

  • export to the Cax specified in this arg_file.txt

Let us now look at the contents of the above mentioned arguments file to understand its structure and format.

* FILES
- in\sample.vtk, TYPE=VTK
- out\sample.cax, TYPE=VCOLLAB_CAX
* PARTS
- *
* RESULTS
- *Temp
* CUTSECTIONS
- "CS1", EQUATION="1Z=0.47"
* FLOWLINES
- "Fl1", COMPONENT=part1, TYPE=TUBE, TUBE_DIA=0.0025, RESULT=VELOCITY, NO_OF_LINES=3500

It is observed that,

  • It reads mesh from “sample.vtk” located in the “in” folder and results are read from dat.h5 file with same name as mesh file.

  • It then creates the “sample.cax” file and writes it to the “out” folder.

  • The “in” and “out” folders are relative to the “arg_file.txt”, i.e. they are located in the “test-data” folder.

  • The cax consists of all parts.

  • The generated CAX file will contain results: Temp from the fluent file. Other results will be filtered out and will not be exported.

  • The output CAX file will also contain one cut-sections: 1z=0.47 and a flowline feature for Velocity, starting from part1 component.

Options

In the case of the simplest usage scenario, where the user intends to create a CAX file from the given input Fluent file without additional controls, it is possible to skip the creation of argument file and specify the inputs using command-line options as shown below.

VMoveXSubmit --in-file test-data\in\sample1.vtk --out-file test-data\out\sample1.cax
VMoveXSubmit -i test-data\in\sample1.vtk -o test-data\out\sample1.cax
VMoveXSubmit -i test-data\out\sample1.vtk

All the above commands provide the same functionality. They read the “sample1.vtk” from “test-data\in” folder and export the mesh and all the results to “sample1.cax” file into the “test-data\out” folder.

The list of supported command-line options are provided below.

--in-file, -i input_file

Input vtk/vtm file path

--out-file, -o out_file

Output CAX file path. If not specified, the h5 file path with ‘.cax’ extension is used.