Usage

The VCollab installation includes a command-line tool VMoveXSubmit (VMoveXSubmit.bat on Windows / VMoveX on Linux), located in the VCollab installation folder. It can:

  • Convert supported CFD files into VCollab CAx format

  • Extract metadata such as mesh, part, and result details in XML format

    VMoveXSubmit.bat [arguments]   (Windows)
    vmovex -submit [arguments]     (Linux)
    

Translation for CFD files

Examples

VMoveXSubmit test-data\Converge\arg1.txt
VMoveXSubmit -i test-data\Fluent\in\FFF.cas.h5
VMoveXSubmit -i test-data\Ensight\heater.case -o test-data\Ensight\heater.cax

The above examples are used to convert cfd files to cax.

For additional details on argument files, see the section: Parameters Files.

Extracting Metadata Using VMoveXSubmit

VMoveXSubmit can generate and display metadata from native CFD files in XML format.

Syntax

VMoveXSubmit [options] <model_file>

Options:
-i/--in-file="input_file_path" : Extracts meta data from the input file.
-o/--out-file="file_name.xml" : Writes the file metadata to the file_name.xml file
-r/--res-file="results_file_path" : Provides the results file for fluent simulations. This option is used in conjunction with
                                    -i/--in-file option.

For Input file and results file options, * can be used as a wild card to specify multiple files with similar names. For example, if the input file is specified as "test-datainpost00016*.h5", all .h5 files with name starting with post00016 in in folder are considered as input files for Converge simulations. The same applies for results file option for fluent simulations. If the results file is specified as "test-datainFFF.1-.dat.h5", all .dat.h5 files with name starting with FFF.1- in **in* folder are considered as results files for fluent simulations.

Examples

The below example extracts the metadata from the cgns file in the sample folder. This information is written to the console in XML format.

VMoveXSumbit.bat -i "VMoveX/Samples/Cgns/in/heater.cgns" --meta-data

Instead of displaying it to the screen, an output file can be specified using the "-o/--out-file" option. This example generates a metadata.xml file in the provided folder with metadata from cgns files.

VMoveXSumbit.bat  --meta-data -i "VMoveX/Samples/Cgns/in/heater.cgns" -o "VMoveX/Samples/Cgns/in/metadata.xml"

To provide results file for fluent simulations the command to be used is "-r"

VMoveXSumbit.bat  --meta-data -i "VMoveX/Samples/Fluent/in/FFF.cas.h5" -r "VMoveX/Samples/Fluent/in/FFF.dat.h5"

The detailed explanation for each file format is provided in the respective sections of the documentation. Please refer to those sections for more information on the supported file formats and their usage.