Import

This command helps user to import various data files into VCollab Pro.

  • *.py (python script file to run set of commands)

  • *.csv (User defined result file )

  • *.npz (User defined result file )

  • *.vpt (Viewpoints file)

  • *.cax (Viewpoints from cax file)

How to run python script files?

  1. Select Import option in the File toolbar,

    image1

  2. Select Python script files (*.py),

  3. Click open to run the script.

How to import viewpoints from external files?

  1. Launch VCollabPro application.

  2. Load a CAX (*.cax) file.

  3. Click Import option in the File toolbar,

  4. It pops up file browser dialog.

  5. Select 'Files of Type' as VCollab Files (*.vpt) or VCollab Files (*.cax).

  6. File browser dialog lists all either viewpoint files or CAX files.

  7. Select a file.

  8. Click Open to import all view paths from the external file.

Importing CAE Results

VCollab Pro supports importing of external CAE results from files in CSV (comma separated values) format. These results are added as new results or instances of existing results. VCollab Pro imports results only for the visible parts based on node or element numbers.

Sample CSV File

#VCOLLAB_RESULTS

Node,Displacement,Stress,

Vector,Tensor,

#INSTANCE,L1M1,Label:Step1,Time:0.1

1818,0.000000,0.000000,0.000000,0.401617,-0.543105,-0.496605, 0.016011,1.541499,-0.090037,

1848,0.000000,0.000000,0.000000,-0.330866,-0.389335,-0.527343,-0.010698,1.284187,-0.019899,

1845,0.000000,0.000000,0.000000,-0.486035,-0.668757,-0.667392,-0.024487,1.603551,-0.030750,

#INSTANCE,L2M1,Label:Step2,Time:0.2

1818,-0.543105,-0.496605, 0.016011,1.541499,0.000000,0.000000,0.000000,0.401617,-0.090037,

1848,-0.010698,1.284187,-0.0198990.000000,0.000000,0.000000,-0.330866,-0.389335,-0.527343,

1845,0.000000,0.000000,-0.486035,-0.6687570.000000,0.000000,0.000000,-0.486035,-0.668757,

CSV File Format

Line No

Description

Example

1

#VCOLLAB_RESULTS

Header line to identify VCollab CSV format.

2

Node/Element, Result1, Result2,....

Use Node for nodal result and Element for elemental result. All results should be of same type.

3

Result Types for each result.

Scalar / Vector / SixDof / Tensor

For complex results:

Scalar_RI / Vector_RI / SixDof_RI Tensor_RI

For unsigned integer results:(Non Negative)

Scalar_uint / Vector_uint / SixDof_uint / Tensor_uint

4

#INSTANCE, [Instance_name1], Instance attributes

Each attribute should have key and value separated by ':' For example, Time: 1.0, Label:Step-1,

5

node/element ID value1, value2, value3,....

6

node/element ID value1, value2, value3,....

7

node/element ID value1, value2, value3,....

...

#INSTANCE, [Instance_name2],Instance attributes

Multiple instances are supported

...

...

...

...

node/element ID value1, value2, value3,....

...

node/element ID value1, value2, value3,....

...

node/element ID value1, value2, value3,....

...

Note

  • From VCollab Pro 19.0, CSV format is modified to support multiple instances and complex results. Old format is also supported.

  • Import CSV results may not work for features like cut section, iso-surface, etc.

  • Unsigned Integer result:

    • Supported from VCollab Pro version 26.2 onwards with limited functionalities

    • Supported functionalities: Color Plot, Hotspot and Probe

    • Unsupported: XYPlot, Create Result,Complex Eigen results,etc.

    • CAE Legend format should be as below in Auto format case, - scientific - Off - precision - 0

  • Any value less than 0 and greater than UINT_MAX-1 (2^32-1) will be treated as No Result.

  • Float Result:

    • By default VCollab Pro supports float type result values.

    • It supports upto FLT_MAX defined in the system. But there will be a dato loss beyond 2^24.

Result Types

Number of columns in the CSV file is based on the result type. For example, Vector result is expected to have 3 columns. Refer to the table below for the different result types and their corresponding number of columns.

OverWriting Result

When an imported CSV file contains result values for an existing result or instance name, VCollab prompts the user to choose whether to overwrite the existing result or skip the import. The application then performs the following actions based on the user's choice:

  • Yes (Overwrite): Existing result values are overwritten only for the node IDs present in the CSV file. Values associated with node IDs that are not included in the CSV file remain unchanged.

  • No (Do Not Overwrite): For each node ID in the CSV file, the application checks whether a result value already exists. If the existing value is NoResult, it is replaced with the value from the CSV file. Otherwise, the existing value is preserved, and the corresponding value from the CSV file is ignored.

    image2

Python API Support

VCollab Pro provides the following methods to export and import result instances.

  1. xImportCAEResult(String sFilePath,int iOverwrite=0);

  2. xImportCAEResultEx(String sFilePath, int iOverwrite = 0);

  3. xExportCAEResult(String sFilePath, String sResult, String sInstance, int iPrecision = 3, bool bScientific = false, bool bPrintCoords = false);

  4. xExportCAEResultEx(String sFilePath, String sResultList,String sInstance,int iPrecision,bool bScientific,bool bPrintCoords);

Note

For details, check the API document in the VCollab installed directory

Refer to VCollab Pro API manual available in the local installation folder for usage and syntax.

Steps to Import Results from a CSV file

  1. Launch VCollabPro application.

  2. Load a CAX (*.cax) file

  3. Click File | Import option.

  4. It pops up file browser dialog.

  5. Select 'Files of Type' as Result Files (*.csv)

  6. File browser dialog lists all csv files.

  7. Select VCollab supported csv file.

  8. Click Open to import all CAE results.

  9. Check 'CAE | Results List' for the result name / instance name.