Import
VCollab users can import the following file types using the Import option:
Supported files and data
*.py (python script file to run set of commands)
*.csv (User defined result file )
*.vpt (Viewpoints file)
*.cax (Result data from cax file)
Importing Python script file
Launch VCollabPro application.
Click File | Import option.
Under Files of Type, select Python Script Files (* .py).
Select a python script file.
Click Open to run the script.
Importing viewpoints
Launch VCollabPro application.
Load a CAX (*.cax) file
Click File | Import option.
Select Files of Type as VCollab Files (*.vpt) or VCollab Files (*.cax).
Select a file.
Click Open to import all view paths from the external file.
Importing CAE Results
VCollab Pro supports importing of external CAE results from CSV files. 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
|
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.
Python API Support
VCollab Pro provides the following methods to export and import result instances.
xImportCAEResult(String sFilePath,int iOverwrite=0);
xImportCAEResultEx(String sFilePath, int iOverwrite = 0);
xExportCAEResult(String sFilePath, String sResult, String sInstance, int iPrecision = 3, bool bScientific = false, bool bPrintCoords = false);
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 CAE result files
Launch VCollab Pro application.
Load a CAX (*.cax) file
Click File | Import option which opens a file browser dialog box
Under Files of Type select Result Files (*.csv)
Select a VCollab Pro supported CSV file.
Click Open to import all CAE results.
Check CAE | Results List for the result name / instance name.