CAE Create Result

xCreateCAENewResult

Creates new CAE result from two existing CAE results.

bool xCreateCAENewResult(String sModel, String sResult1, String sResult2, String sEquation, String sNewResult)

return

Returns True if successful.

sModel

CAE model name.

sResult1

CAE result 1 name.

sResult2

CAE result 2 name.

sEquation

It is an arithmetic expression or formula with variables A and B.

A refers to Result 1,

B refers to Result 2.

sNewResult

New CAE result name.

xCreateCAEClosureResult

Creates closure result for the user-selected result.

bool xCreateCAEClosureResult(String sModel, String sResult, String sDerived)

return

Returns True, if successful.

sModel

CAE model name.

sResult

CAE result name.

sDerived

CAE derived/scalar result name.

xCreateCAEEnvelopeResult

Creates a CAE envelope result for a transient or multi instances data.

bool xCreateCAEEnvelopeResult(String sModel, String sResult, String sDerived, bool bMax, bool bMin)

return

Returns True if successful.

sModel

CAE model name.

sResult

CAE result name.

sDerived

CAE derived/scalar result name.

bMax

Creates max envelope result if bMax is True.

bMin

Creates min envelope result if bMin is True.

xCreateCAENewDerivedResult

Creates derived or scalar CAE result from the user given non-scalar result.

bool xCreateCAENewDerivedResult(String sModel, String sResult, String sDerived, String sNewResult)

return

Returns True if successful.

sModel

CAE model Name.

sResult

CAE result name.

sDerived

CAE derived or scalar result name.

sNewResult

New CAE result name.

xCAEDeleteResult

Deletes given result entries in a model.

bool xCAEDeleteResult(const String sModel, const String sResult)

return

Returns True, if successful

sModel

Model name.

sResult

Result name that to be deleted.

xCAEDeleteInstance

Deletes instance entries in a result..

bool xCAEDeleteInstance(const String sModel, const String sResult, const String sInstance)

sModel

Model name.

sResult

Result name.

sInstance

Instance name that to be deleted.

Note: In this version, this method will work only for current result. It is needed to set sResult as the current result using `xSetCAEResult <./CAE%20Operations.md#xsetcaeresult>`__.

xImportCAEResult

Import comma seprated (.CSV) result file for an instance.

bool xImportCAEResult(String sFilePath)

return

Returns True, if successful.

sFilePath

Full file path or relative to the exe folder.

Note: This imports csv file with header #VCOLLAB_RESULTS, a new enhanced format that supports importing multiple instances. This supports old file format with header VCOLLAB_CAE_RESULT also. Refer VCollabPro help document for further details.

#VCOLLAB_RESULTS
Node,Result1,Result2,
Vector,Tensor,
#INSTANCE,[Instance 1],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
 …
 …
#INSTANCE,[Instance 2],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…

xCreateCAENewUCSResult

Creates a new CAE result with respect to another coordinate system.

bool xCreateCAENewUCSResult(String sUserCoordSysName, String sNewResultName, String sOldResultName, String sComponentName, String sModel)

return

Returns True, if successful.

Returns False, if failed.

sUserCoordSysName

Coordinate-system name used to create new result.

sNewResultName

New Result name.

sOldResultName

Old result name.

sComponentName

component Name can be empty or any one of the following

For Vector Result,

"U"
"V"
"W"

For Tensor Result,

"S11"
"S22"
"S33"
"S12"
"S23"
"S13"

sModel

CAE model name.

xCreateResultInstance

Creates a new result instance from existing any two result instance using an expression.

bool xCreateResultInstance(String sModel, String sResult, String sInstance1, String sInstance2, String sExpression, String sNewInstance, int iAttributInstanceIndex)

return

Returns True, if successfully creates a new instance.

Returns False, if any invalid expression / result / instance name.

sModel

CAE Model Name.

sResult

CAE Result Name.

sInstance1

Name of the instance 1.

sInstance2

Name of the instance 2.

sExpression

The expression should be with the characters a and b only (strictly small alphabets). a refers to sInstance1 whereas b refers to sInstance2. For example to denote subtraction of sInstance1 from sInstance2, the expression should be b-a

sNewInstance

Name of the new instance.

iAttributInstanceIndex

Out of given two instances, which one’s attribute map should be carried to a new instance.

-1 - Empty attribute map (neither instance 1 nor instance 2)
 0 - Instance 1 (a) - attributes will be carried to new Instance
 1 - Instance 2 (b) – attributes will be carried to new Instance

xImportCAEResultEx

Imports comma-separated (.csv) result file for an instance. This input file should contain all the node/element ids and results in the same order CAX model contains for other existing results.

bool xImportCAEResultEx(String sFilePath)

return

Returns True, if successful.

sFilePath

Full file path or relative to the exe folder.

Note: This supports csv files that are exported from VCollabPro with header #VCOLLAB_RESULTS_DUMP (exported using `xExportCAEResultEx <#xexportcaeresultex>`__ method)

Following is the format which has #part_key in additional to usual data.

#VCOLLAB_RESULTS_DUMP
Node,Result1,Result2, Vector,Tensor,
#INSTANCE,[Instance 1],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
#part_key:part 1,[size of rows]
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…
#INSTANCE,[Instance 2],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
#part_key:part 2,[size of rows]
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…

xExportCAEResult

Exports given instance result data into a comma-separated (.csv) result file for an instance. It prints result name, instance name, result type and column header. Further, it prints ids, result components as columns.

bool xExportCAEResult(String sFilePath, String sResult, String sInstance)

return

Returns True, if successful.

sFilePath

Full file path or relative to the exe folder.

sResult

Result name to be exported.

sInstance

Instance name to be explored.

Note: This function is enhanced for multiple results and multiple instances with new format as below.

#VCOLLAB_RESULTS Node,Result1,Result2,Vector,Tensor,
#INSTANCE,[Instance 1],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…
#INSTANCE,[Instance 2],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…

xExportCAEResultEx

Exports result instance data into csv file in the same way `xExportCAEResult <#xexportcaeresult>`__ does. But here user can export multiple results and has options to format output values and to option to write coordinates of each node.

bool xExportCAEResultEx(String sFilePath, String sResulListt, String sInstance, int iPrecision, bool bScientific, bool bPrintCoords)

return

Returns True, if successful.

sFilePath

Full file path or relative to the exe folder.

sResultList

Result names separated by ; (semi-colon).

sInstance

Instance name to be explored.

iPrecision

Decimal places for real values.

bScientific

If True, values will be printed in scientific format.

If False, values will be printed in decimal format.

bPrintCoords

If True, nodal coordinate values will be printed. Otherwise, coordinates are ignored.

Note: This function exports additional #part-key and number of rows, in additional to `xExportCAEResult <#xexportcaeresult>`__. This part_key and number of rows helps in importing again with modified data. This file can be modified but rows should not be deleted for each part_key.

#VCOLLAB_RESULTS_DUMP
Node,Result1,Result2,
Vector,Tensor,
#INSTANCE,[Instance 1],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
\#part_key:part 1,[size of rows]
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…
#INSTANCE,[Instance 2],[attribute1_key:attribute1_value],[attribute1_key:attribute1_value],…
#part_key:part 2,[size of rows]
1818,0.0e+00,0.0e+00,0.0e+00,-4.0e-01,-5.4e-01,-5.0e-01,1.6e-02,1.5e+00,-9.0e-02,
1848,0.0e+00,0.0e+00,0.0e+00,-3.3e-01,-3.9e-01,-5.3e-01,-1.1e-02,1.3e+00,-2.0e-02,
…
…

xCreateCAEThresholdResult

Creates a new threshold result from existing three tensor derived types. For example, consider ‘Stress – Maximum Principal Value’ result. User can create Average, Minimum and Maximum scalar results in VMoveCAE and bring it to CAX results.

Stress – Maximum Principal Value[avg]
Stress – Maximum Principal Value[min]
Stress – Maximum Principal Value[max]

This function reads these three results and takes the following decision.

To average at a particular node or not.
To average across all parts or not

It sets the minimum or maximum value in unaveraged nodes based on the user input parameter iOption.

bool xCreateCAEThresholdResult(String sModel, String sNewResult, String sResultList, String sInstanceList, int iOption, int iRegion, float fThreshold)

return

Returns True, if it succeeds.

Returns False, if it fails.

sModel

Name of the CAE Model.

sNewResult

Name of new CAE Result to be created.

sResultList

Result list as a single String with delimited by ; (semicolon).

sInstanceList

Instance list as a single String with delimited by ; (semicolon).

iOption

This option decides whether to set minimum value or maximum value at unaveraged locations.

– Maximum of abs(min) and abs(max)
– Minimum
– Maximum

iRegion

This option decides whether to average across parts or not.

0 – Average across parts
1 – Average within the part

fThreshold

This value is the prime factor which decides to average at a particular node or not.

          Nodal maximum – Nodal Minimum
R = -----------------------------------------
        Overall maximum – Overall Minimum

If R < fThreshold then assign averaged value or set minimum or maximum value to the particular node.

Note: In case of Average within part, R will be

         Nodal maximum – Nodal Minimum
R = -----------------------------------------
          Part maximum – Part Minimum

xCreateResultFromInstance

Extracts result data from given result instance and creates it as a new result.

bool xCreateResultFromInstance(String sModel, String sNewResult, String sNewInstance, String sResult, String sInstance, String sDerived)

return

Returns True if successfully creates a new result. False otherwise.

sModel

CAE model name.

sNewResult

Name of New result to be created.

sNewInstance

Name of new result instance to be created.

sResult

Name of the input result.

sInstance

Name of the input result instance.

sDerived

Name of the input result result derived type.

Note:

Case 1: if sDerived is empty, new result type will be same as of input type.

Case 2: if sDerived is valid derived type, then new result is of scalar type.

xCreateResultDerived

Extracts result data from given result instance and creates it as a new result.

bool xCreateResultDerived(String sModel, String sResult, String sDerived, String instanceList, String sNewResult, int iComplexType, float fComplexAngle)

return

Returns True if successfully creates a new result. False otherwise.

sModel

CAE model name.

sResult

Name of input result to be created.

sDerived

Name of the input result result derived type.

instanceList

List of instance names separated by ; (semi-colan).

If list is empty, then all instances will be created for new result.

sNewResult

Name of new result to be created.

iComplexType

Complex type.

- Real
- Imaginary
- Magnitude
– Phase
- Angle

fComplexAngle

Angle value when iComplexType is 4. This value will be ignroed when iComplexType is not equal to 4.

xCreateCAEEnvelopeResultEx

Creates a new envelope scalar result or tensor or vector result based on result type and bscalar input.

bool xCreateCAEEnvelopeResultEx(String sModel, String sResult, String sDerived, bool bMax, bool bScalar)

return

Returns False if failed.

Returns True if success.

sModel

CAE Model name.

sResult

CAE Result name.

sDerived

Derived scalar type name.

bMax

Creates max envelop if this flag is True.

Creates min envelop if this flag is False.

bScalar

Creates scalar envelop if this flag is True.

Creates vector/tensor envelop if this flag is False.

xCreateStressHarmonicResult

Creates a new CAE result extracted from the given complex eigen tensor result and model. This function identifies phase angle which gives maximum value for the Max. Principal Value from Real and Imaginary components.

bool xCreateStressHarmonicResult(String sModel, String sResult)

return

Returns True, if succesfully harmonic result is created.

Returns False otherwise.

sModel

CAE model name for which result is to be created.

sResult

Complex eigen tensor result name.

Note: This method is applicable only for complex eigen tensors, like stress and strains.

xBeginMapCAEResult

Begins pre process for mapping a result from one mesh to another mesh.

bool xBeginMapCAEResult(String srcModel, String trgModel, float fTol, int iInterpolateType, float fSearchMaxDist=-1)

return

Returns True if successfully begins.

Returns False otherwise.

srcModel

Source model, which has the result to be mapped.

trgModel

Target model, which is to mapped with result from source model.

fTol

Tolerance to avoid floating value error..

iInterpolateType

0 – refers to bary centric system (recommended)
1 – weighted area method

fSearchMaxDist

Process mapping within the given search distance. Ignore or set max value if the distance from a point to the mapped surface.

xProcessMapCAEResult

Process the mapping for the given result.

bool xProcessMapCAEResult(String srcResult, String srcInstance, String srcDerived, String trgResult, String trgInstance)

return

Returns True if successfully maps the result.

Returns False otherwise.

srcResult

Source result.

srcInstance

Source result instance.

srcDerived

Source derived type.

trgResult

New name for target model result name.

trgInstance

New instance name of target model.

xEndMapCAEResult

Ends mapping process and clear the memory.

bool xEndMapCAEResult()

return

Returns True if successfully ends the mapping.

Returns False otherwise.

xCreatePivotDeformationResult

Creates a new deformation result relative to pivot data

bool xCreatePivotDeformationResult(String sModel, String sNewResult, int iNode1, int iNode2, int iNode3, int iInputType, int iCoordSystemType)

return

Returns True if given input result is of complex type.

Returns False otherwise.

sModel

CAE Model name.

sNewResult

CAE New Result Name.

iNode1

Node ID1.

iNode2

Node ID2.

iNode3

Node ID3.

iInputeType

– Origin, X-axis, XY-plane
– Not Applicable
– 3 Points on Circle (Circle Center is origin, origin to int 1 is xAxis, normal to circle is Z axis)

iCoordinateSystemType

– Cartesian Coordinate System
– Cylindrical Coordinate System
– Spherical Coordinate System

xCreateNodalResult

Creates a nodal result from an existing elemental result with different averaging options.

bool xCreateNodalResult(String sModel, String sElementResult, String sDerivedType, String sNewNodalResult, int AvgMode, float fThresholdPercent)

return

Returns True if nodal result is created successfully.

Returns False otherwise.

sModel

CAE Model Name.

sElementResult

Existing elemental result name.

sDerivedType

Derived type result name which is used for validating thershold percent.

If derived type name is empty, compute new value based on average mode for each component.

If derived type name is valid, compute new tensor based on derived result values and average mode.

sNewNodalResult

New nodal result name.

AvgMode

Averaging options for nodal location.

- set minimum of shared elemental values to each node
- set maximum of shared elemental values to each node
- set averaged value in all nodes
- set averaged value to the node if variation not exceeds threshold percent. set minimum value if it exceeds
- set averaged value to the node if variation not exceeds threshold percent. set maximum value if it exceeds

fThresholdPercent

Threshold percent on the extreme values from associated elements.

Its value is from zero to one (0-1).

Example:

Let a node N be associated with the elements E1, E2, E3.

Let the components values of E1, E2, E3 be { [v11,v12,v13,v14,v15,v16], [v21,v22,v23,v24,v25,v26], [v31,v32,v33,v34,v35,v36] }

Let the new components of N be [c1,c2,c3,c4,c5,c6]

Case 1: Derived type is empty

Global min and max values for each component result be { [gmin1,gmin2,gmin3,gmin4,gmin5,gmin6], [gmax1,gmax2,gmax3,gmax4,gmax5,gmax6] }

threshold factor for each component for the node N is,
    factor-i = (max(Vei)-min(Vei))/(gmaxi-gmini)
where i is (1,2,3,4,5,6) and e is (1,2,3)

iAvgMode - 0
Set     c1 = minimum (v11,v21,v31)
        c2 = minimum (V12,v22,v23)...
        c6 = minimum (v16,v26,v36)

iAvgMode - 1
Set     c1 = maximum (v11,v21,v31)
        c2 = maximum (V12,v22,v23)...
        c6 = maximum (v16,v26,v36)

iAvgMode - 2
Set     c1 = average (v11,v21,v31)
        c2 = average (V12,v22,v23)...
        c6 = average (v16,v26,v36)

iAvgMode - 3
    if factor-i \< fThresholdPercent:
        Set ci = average (v1i,v2i,v3i)
    else:
        Set ci = minimum (v1i,v2i,v3i)

iAvgMode - 4
    if factor-i \< fThresholdPercent:
        Set ci = average (v1i,v2i,v3i)
    else:
        Set ci = maximum (v1i,v2i,v3i)

Case 2: Derived type is valid

Global min and max values for derived result be gmax,gmin.
derived type values of shared elements be { d1,d2,d3 }
threshold factor for the node N is,
    factor = (max(d1,d2,d3)-min(d1,d2,d3))/(gmax-gmin)

iAvgMode - 0
    j = index of minimum element (d1,d2,d3)
    Set c1 = vj1
        c2 = vj6...
        c6 = vj6

iAvgMode - 1
    j = index of maximum element (d1,d2,d3)
    Set     c1 = vj1
            c2 = vj6...
            c6 = vj6

iAvgMode - 2
    Set     c1 = average (v11,v21,v31)
            c2 = average (V12,v22,v23)...
            c6 = average (v16,v26,v36)

iAvgMode - 3
    if factor-i \< fThresholdPercent:
        Set ci = average (v1i,v2i,v3i)
    else:
        j = index of minimum element (d1,d2,d3)
        Set ci = vji

iAvgMode - 4
    if factor-i \< fThresholdPercent:
        Set ci = average (v1i,v2i,v3i)
    else:
        j = index of maximum element (d1,d2,d3)
        Set ci = vji

xCreateElementalResult

Creates a elemental result from an existing nodal result with different averaging options.

bool xCreateElementalResult(String sModel,String sNodalResult,String sDerivedType, String sNewElementalResult,int iAvgMode,float fThresholdPercent, int iSkipNoResult=0)

return

Returns True if elemental result is created successfully.

Returns False otherwise.

sModel

CAE Model Name.

sElementResult

Existing elemental result name.

sDerivedType

Derived type result name which is used for validating thershold percent.

If derived type name is empty, compute new value based on average mode for each component.
If derived type name is valid, compute new tensor based on derived result values and average mode.

sNewNodalResult

New nodal result name

iAvgMode

Averaging options for nodal location.

- set minimum of shared corner node values to each element.
- set maximum of shared corner node values to each element.
- set average of corner nodal values to the element.
- set average of corner nodal values to the element if variation not exceeds threshold percent. set minimum value if it exceeds.
- set average of corner nodal values to the element if variation not exceeds threshold percent. set maximum value if it exceeds.

fThresholdPercent

Threshold percent on the extreme values from corner nodes of an element.

Its value is from zero to one (0,1).

iSkipNoResult

For an element, if any of the nodes has a NoResult value, this option is to either set the entire element as NoResult or skip the NoResult nodes and average the remaining nodes.
0- Skips NoResult Nodes.
1 -Sets Element as NoResult

xCreateCAENewResultEx

Creates new result from existing same type results. User can provide formula with notations. Capital letters are refered to result creation.

Small letters are used to refer result-instance creation.

bool xCreateCAENewResultEx(String sModel, List<String> resultsList, List<String> derivedTypesList, String sEquation, String sNewResult, bool bInstance, bool bAllResults)

return

Returns True if successfully result or instance is created.

Returns False otherwise.

sModel

CAE Model Name.

resultsList

List of result or instance names, considered for the resut/instance creation.

Example:

For result creation - ["Displacement", "Velocity", "Acceleration"]

For instance creation - ["L1M0", "L1M3", "L1M4", "L1M8"]

derivedTypesList

List of derived types corresponding to list of results. this argument is not applicable for instance creation.

sEquation

Expression or Formula to create a new result.

Alphabets ‘A,B,C…’ are refered to result indices 0,1,2,3…

Alphabets ‘a,b,c…’ are refered to instance indices 0,1,2,3…

Result Creation:

If the results => ["Displacement", "Velocity", "Acceleration"]

    A -> "Displacement
    B -> "Velocity"
    C -> "Acceleration"

sEquation can be 'A+B-C'

Instance Creation:

If the results =\> ["L1M0", "L1M3", "L1M4", "L1M8"]

    a -> "L1M0
    b -> "L1M3"
    c -> "L1M4"
    d -> "L1M8"

sEquation can be 'max(a,b)-c'

sNewResult

New elemental result name.

bInstance

True - Creating Result-Instance.

False - Creating Result.

bAllResults

This argument is applicable only for Instance creation.

True - Creates a new instance in all the results with the same formula.

False - Creates a new instance only to current Result.

xExportCAEIDResults

Exports results for the given IDs (either node/element) into a comma seperated file (csv).

bool xExportCAEIDResults(String sModel,String sFilePath, List<int> IDs, List<String> resultList, List<String> instanceList, int iPrecision, bool bScientific, bool bPrintCoords)

return

Return True if the csv file is created, False otherwise.

sModel

Name of CAE Model.

sFilePath

Output csv file path.

IDs

List of IDs. Based on the first result type, IDs will be considered as nodes or elements.

resultList

List of results

instanceList

List of instances

iPrecision

Decimal places

bScientific

Text format: to be printed in scientific format or decimal format.

bPrintCoords

Boolean, coordinates of nodes to be printed or not. Applicable ony for nodal results.

xExportCAENodeSetResults

Exports results for the given nodeset ids (strictly node ids) into a comma seperated file (csv).

bool xExportCAENodeSetResults(String sModel,String sFilePath, List<String> NodeSetNames, List<String> resultList, List<String> instanceList, int iPrecision, bool bScientific, bool bPrintCoords)

return

Return True if the csv file is created, False otherwise.

sModel

Name of CAE Model

sFilePath

Output csv file path.

NodeSetNames

List of node set names.

resultList

List of results

instanceList

list of instances

iPrecision

Decimal places

bScientific

Text format: to be printed in scientific format or decimal format.

bPrintCoords

Boolean, coordinates of nodes to be printed or not. Applicable ony for nodal results.

xCreateCombinationResult

Allows user to create a new result by applying different scalefactors to each instance and sum it up. i.e. NewCombinationResult = Q1*R1+Q2*R2+….+Qn*Rn, where Q refers to scale value and R refers to Instance Result.

bool xCreateCombinationResult(String sModel, String sResult, List<String> instanceList, List<String> multiplicationFactorList, String sNewResult, String sNewInstancetName, bool bOverWrite)

return

Returns True if successfully creates.

Returns False otherwise.

sModel

CAE Model Name

sResult

Existing Result Name

instanceList

List of instance names

MultiplicationFactorList

List of multipliers (scale factors)

sNewResult

New Result Name

sNewInstancetName

New Result Instance Name

bOverWrite

If True overwrites the instance result if already exists.

If False returns without overwriting if already exists.

xCreateCAEComplexResult

Creates a complex result from two existing results, considering first one as real part and the second one as Imaginary Part.

bool xCreateCAEComplexResult(String sModel, String sRealResult, String sImaginaryResult, List<String> instanceList, String sNewResult)

return

Returns True if successfully creates the complex result.

Returns False otherwise.

sModel

CAE Model Name

sRealResult

Existing Result Name for real part

sImaginaryResult

Existing Result Name for imaginary part

instanceList

List of instance names

sNewResult

New Result Name

xCreateEnvelopeResult

Creates Envelope results for the selected instances with given new name and instances.

bool xCreateEnvelopeResult(String sModel, String sResult, String sDerived, List<String> instanceList, String sNewResultName, String sNewInstanceName int iMaxMinFlag, int iScalar, int iInstanceFlag, String sUserAttribList)

return

Returns True if succeeds.

Returns False otherwise.

sModel

CAE Model Name

sResult

Name of the existing result.

sDerived

Name of the derived type result.

instanceList

List of instance names

sNewResultName

Envelope Result Name

iMaxMinFlag

0 - Envelope for minimum value

1 - Envelope for maximum value

2 - Envelope for absolute maximum value.

iScalar

0 - Creates a scalar envelope result

1 - Creates vector/tensor envelope result.

iInstanceFlag

0 - Creates only base instance(with envelope value).

1 - Creates base instance and another instance for instance index(overall)

2 - Creates base instance and another instance for instance attrib value (overall) if available.

3 - Creates base instance, instance for index and one for attrib value (overall) if available.

sUserAttribList

List of attributes can be given seperated by comma.

Example: “Key1:Value1,Key2:Value2,Key3:Value3”

xCreatePivotDeformationResultEx

Creates a new deformation result relative to pivot data

bool xCreatePivotDeformationResultEx(String sModel, String sNewResult, List<int> nodeIDs, List<String> partNames, int iInputType, int iCoordSystem)

return

Returns True if given input result is of complex type.

Returns False otherwise.

sModel

CAE Model name

sNewResult

CAE New Result Name

nodeIDs

List of node IDs to define pivot data.

size of 1 for point pivot
size of 3 for plane pivot

partNames

List of part names which contains the node ids.
Size should be equal to size of nodeIDs.

iInputeType

0 – Origin, x-axis, xy-plane

1 – Not Applicable

2 – 3 Points on Circle (Circle Center is origin, origin to point 1 is xAxis, normal to circle is z axis)

iCoordinateSystemType

0 – Cartesian Coordinate System

1 – Cylindrical Coordinate System

2 – Spherical Coordinate System