res_utl_extract_elem_pos_ids | (result_ids, elem_list, count, ids, npos, posids) |
Description: | ||
This function will extract the internal element position identifiers for the results data associated with a list of elements. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
STRING | elem_list[] | This value specifies a list of elements for which results are extracted. |
Output: | ||
INTEGER | count | This value returns the number of returned element identifiers. |
INTEGER | ids(VIRTUAL) | This value returns the list of element identifiers. |
INTEGER | npos(VIRTUAL) | This value returns the number of element positions per element. |
INTEGER | posids(VIRTUAL) | This value returns all of the element position identifiers for the specified elements. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500014 | An error has occurred interpreting the input List string. | |
4500017 | The specified operation is not valid. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
res_utl_get_elem_pos_loc | (elem_id, param_flag, epos_id, location) |
Description: | ||
This function will extract the internal element position location for the results data associated with an element identifier. | ||
Input: | ||
INTEGER | elem_id | This value specifies the element identifier. |
INTEGER | param_flag | This value specifies the setting of the parameter flag: 0=XYZ global coordinates and 1=element parametric coordinates. |
INTEGER | epos_id | This value specifies the element position identifier. |
Output: | ||
REAL | location(4) | This value returns the XYZ or element parametric coordinates. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500008 | The input Location string is invalid. | |
13000021 | Element not found. |
res_utl_get_result_info | (result_ids, title, nres, data_type, assoc, resloc, cidflag, minloc, maxloc) |
Description: | ||
This function extracts information about the specified results data. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
Output: | ||
STRING | title[80](3) | This value returns the title of the current result. |
INTEGER | nres | This value returns the total number of results. |
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | assoc | This value returns the association type. Valid values are: 1=nodal and 2=element. |
INTEGER | resloc | This value returns the results location. Valid values are: 1=centroidal, 2=nodal, and 3=gauss point. |
LOGICAL | cidflag | This value returns TRUE if the results are defined in a non-global system. |
INTEGER | minloc(2,6) | This value returns the identifier and location for each minimum result component. The location is used only for multiple element results. |
INTEGER | maxloc(2,6) | This value returns the identifier and location for each maximum result component. The location is used only for multiple element results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000086 | No Records Found. | |
13000210 | The system is out of virtual memory. |
res_utl_clear_result | () |
Description: | ||
This function clears any previously used results data from memory. | ||
Input: | ||
None. | ||
Output: | ||
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully. |
Error Conditions: | ||
None. |
res_utl_get_result_entities | (result_ids, id_list) |
Description: | ||
This function returns a list of the identifiers for which the specified results exist. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
Output: | ||
STRING | id_list[VIRTUAL] | This value returns a list of the identifiers for which the specified results exist. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000086 | No Records Found. | |
13000210 | The system is out of virtual memory. | |
14000001 | LpGetHeapSpace: Allocated heapspace is exhausted. | |
14000201 | Invalid output string specified for call. |
res_utl_get_result_type | (result_ids, result_type) |
Description: | ||
This function returns the result type for the specified results. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
Output: | ||
INTEGER | result_type | This value returns the result type. Valid values are: 1=Scalar, 2=Vector, and 3=Tensor. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000210 | The system is out of virtual memory. |
res_utl_get_results_cids | (result_ids, result_type, nids, ids, cids) |
Description: | ||
This function returns the coordinate frame identifiers used for the result defined at the specified node or element locations. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
INTEGER | result_type | This value specifies the type: 1=node, and 2=element. |
INTEGER | nids | This value specifies the number of identifiers. |
INTEGER | ids(nids) | This value specifies node or element identifiers. |
Output: | ||
INTEGER | cids() | This value returns a list of coordinate frame identifiers in which the results specified are oriented. Valid values are: -1=element local and 0=global. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500016 | The input list type is not valid. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000086 | No Records Found. | |
13000210 | The system is out of virtual memory. |
res_utl_extract_nodal_results | (result_ids, node_list, derivation, cid, data_type, nres, ids, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
STRING | node_list[] | This value specifies a list of nodes for which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | nres | This value returns the number of returned node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified nodes. |
INTEGER | minloc(6) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(6) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500002 | An error has occurred calculating a nodal averaged result. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1” | “P2” | ||
“P3” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
Tensor to Vector: | “PV1” | “PV2” | “PV3” | |
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
res_utl_extract_nodal_results2 | (result_ids, node_list, derivation, cid_list, avg_method, avg_domain, extrap_method, complex_form, complex_angle, data_type, nres, ids, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
STRING | node_list[] | This value specifies a list of nodes for which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
STRING | avg_method[] | This value specifies the averaging method to be used. |
STRING | avg_domain[] | This value specifies the averaging domain to be used. |
STRING | extrap_method[] | This value specifies the extrapolation method to be used. |
STRING | complex_form[] | This value specifies the form to be used for complex numbers. |
REAL | complex_angle | This value is used with the complex results when the complex_form is “Angle”. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | nres | This value returns the number of returned node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified nodes. |
INTEGER | minloc(6) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(6) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500002 | An error has occurred calculating a nodal averaged result. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXCP2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
Tensor to Vector: | “PV1”/”MAJORV” | “PV2”/”INTERV” | “PV3”/”MINORV” | |
“MJRV2D” | “MNRV2D” | |||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
INTEGER i, nres, dtype, minloc(6), maxloc(6), status
INTEGER nids(VIRTUAL)
REAL results(VIRTUAL)
/* Extract von Mises nodal results from the element tensor result with Loadcase ID=2, Subcase ID=1,Primary Res ID=3, Secondary Res ID=1, Layer ID=1 */
status = res_utl_extract_nodal_results( [2,1,3,1,1], "Node 1:#", @
"vonm", "", dtype, nres, nids, results, minloc, maxloc )
IF( status != 0 ) THEN @ /* print message if error */
msg_to_form( status, 4, 0, 0, 0., "" )
ELSE
/* print out min/max */
i = minloc(1)
ui_writec(" Min Id= %d, von Mises Stress= %g", ids(i), results(i) )
i = maxloc(1)
ui_writec(" Max Id= %d, von Mises Stress= %g", ids(i), results(i) )
END IF
res_utl_extract_nodal_history | (nlcs, lcids, subids, result_ids, node_list, derivation, cid, data_type, nres, ids, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | nlcs | This value specifies the number of result cases to be extracted. |
INTEGER | lcids(nlcs) | This value specifies the loadcase identifiers. |
INTEGER | subids(nlcs) | This value specifies the subcase identifiers. |
INTEGER | result_ids(3) | This value specifies the primary result identifier, secondary result identifier, and layer identifier. |
STRING | node_list[] | This value specifies a list of nodes at which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | nres | This value returns the number of node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified nodes for each result case. |
INTEGER | minloc(VIRTUAL) | This value returns the load case or subcase identifier array offsets for each node minimum in the output value results. |
INTEGER | maxloc(VIRTUAL) | This value returns the load case or subcase identifier array offsets for each maximum node in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500002 | An error has occurred calculating a nodal averaged result. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXCP2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
Tensor to Vector: | “PV1”/”MAJORV” “MJRV2D” | “PV2”/”INTERV” “MNRV2D” | “PV3”/”MINORV” | |
“MJRV2D” | “MNRV2D” | |||
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
res_utl_extract_nodal_history2 | (nlcs, lcids, subids, result_ids, node_list, derivation, cid, avg_method, avg_domain, extrap_method, complex_form, complex_angle, data_type, nres, ids, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | nlcs | This value specifies the number of result cases to be extracted. |
INTEGER | lcids(nlcs) | This value specifies the loadcase identifiers. |
INTEGER | subids(nlcs) | This value specifies the subcase identifiers. |
INTEGER | result_ids(3) | This value specifies the primary result identifier, secondary result identifier, and layer identifier. |
STRING | node_list[] | This value specifies a list of nodes at which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
STRING | avg_method[] | This value specifies the averaging method to be used. |
STRING | avg_domain[] | This value specifies the averaging domain to be used. |
STRING | extrap_method[] | This value specifies the extrapolation method to be used. |
STRING | complex_form[] | This value specifies the form to be used for complex numbers. |
REAL | complex_angle | This value is used with complex results when the complex_form is “Angle”. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | nres | This value returns the number of node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified nodes for each result case. |
INTEGER | minloc(VIRTUAL) | This value returns the load case or subcase identifier array offsets for each node minimum in the output value results. |
INTEGER | maxloc(VIRTUAL) | This value returns the load case or subcase identifier array offsets for each maximum node in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500002 | An error has occurred calculating a nodal averaged result. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXCP2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
Tensor to Vector: | “PV1”/”MAJORV” “MJRV2D” | “PV2”/”INTERV” “MNRV2D” | “PV3”/”MINORV” | |
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
INTEGER i, j, nres, dtype, minloc(VIRTUAL), maxloc(VIRTUAL), status
INTEGER nids(VIRTUAL), subids(5) = 1,2,3,4,5
REAL results(VIRTUAL)
/* Extract von Mises nodal results from the element tensor result with Loadcases ID=2, Subcases ID=1 thru 5,Primary Res ID=3, Secondary Res ID=1, Layer ID=1 */
status = res_utl_extract_nodal_results( 5,[2,2,2,2,2],subids, @
[3,1,1], "Node 1:#", "vonm", "", dtype, nres, nids, results, @
minloc, maxloc )
IF( status != 0 ) THEN /* print message if error */
msg_to_form( status, 4, 0, 0, 0., "" )
ELSE
/* print out min/max subcase/value for each node */
FOR( i = 1 TO nres )
ui_writec(" Id= %d, Min Subcase= %d, von Mises Stress= %g", @
ids(i), subids(minloc(i)), results(minloc(i),i) )
ui_writec(" Id= %d, Max Subcase= %d, von Mises Stress= %g", @
ids(i), subids(maxloc(i)), results(maxloc(i),i) )
END FOR
END IF
res_utl_create_nodal_result | (result_ids, primary_title, secondary_title, nids, ids, cid_list, data_type, results) |
Description: | ||
This function adds the specified results data to the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. The primary and result identifiers are not used as inputs by this function. This value is used as both an input and an output to the function and would be passed by the calling function as a single argument. |
STRING | primary_title[80] | This value specifies the primary result title. |
STRING | secondary_title[80] | This value specifies the secondary result title. |
INTEGER | nids | This value specifies the number of input node identifiers. |
INTEGER | ids(nids) | This value specifies the node identifiers for the results. |
STRING | cid_list[] | This value specifies the alternate coordinate system for the vector or tensor results. A null string is used for the global coordinate system. |
INTEGER | data_type | This value specifies the data type to use: 1=scalar, 2=vector, and 3=tensor. |
REAL | results() | This value specifies all of the results at the specified nodes. |
Output: | ||
INTEGER | result_ids(5) | This value returns the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. The load case, subcase, and layer identifiers are not used as output values by this function. The primary and result identifiers are used as outputs by this function. This value is used as both an input and an output to the function and would be passed by the calling function as a single argument. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. |
res_utl_extract_elem_results | (result_ids, elem_list, derivation, location, cid, data_type, resloc, nres, ids, nresults, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
STRING | elem_list[] | This value specifies a list of elements for which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | location[] | This value specifies the location of the coordinate frame identifier: "", "A" = axis, "C" = centroid, and "N" = nodal. |
STRING | cid[] | This value specifies the coordinate system for vector and tensor transformations. A null string is used to leave the coordinate frame identifier as is. Valid Coordinate sytem strings types are: "Global", "Material", "IJK", "Nodal", "Coord", "ResCoord", "Bisector", "CQUAD8", "Unknown", "Default", "LocalDir", "AsIs". For a more detailed explanation of Coordinate Systems in Patran, please see Coordinate Systems (p. 27) in the Results Postprocessing |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | resloc | This value returns the result location. Valid values are: 1=centroid, 2=nodal, 3=multiple, and 4=mixed. |
INTEGER | nres | This value returns the number of returned element identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of element identifiers. |
INTEGER | nresults(VIRTUAL) | This value returns the number of results per element. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified element locations. |
INTEGER | minloc(12) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(12) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500008 | The input Location string is invalid. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXCP2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
“VMSTRN” | ||||
Tensor to Vector: | “PV1”/”MAJORV” | “PV2”/”INTERV” | “PV3”/”MINORV” | |
“MJRV2D” | “MNRV2D” | |||
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
res_utl_extract_elem_results2 | (result_ids, elem_list, derivation, location, cid, avg_method, avg_domain, extrap_method, complex_form, complex_angle, data_type, resloc, nres, ids, nresults, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
STRING | elem_list[] | This value specifies a list of elements for which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | location[] | This value specifies the location of the coordinate frame identifier: "", "A" = axis, "C" = centroid, and "N" = nodal. |
STRING | cid[] | This value specifies the coordinate system for vector and tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
STRING | avg_method[] | This value specifies the averaging method to be used. |
STRING | avg_domain[] | This value specifies the averaging domain to be used. |
STRING | extrap_method[] | This value specifies the method to use in extrapolation. |
STRING | complex_form[] | This value specifies the form to be used for complex numbers. |
REAL | complex_angle | This value is used with complex results when the complex_form is “Angle”. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | resloc | This value returns the result location. Valid values are: 1=centroid, 2=nodal, 3=multiple, and 4=mixed. |
INTEGER | nres | This value returns the number of returned element identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of element identifiers. |
INTEGER | nresults(VIRTUAL) | This value returns the number of results per element. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified element locations. |
INTEGER | minloc(12) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(12) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500008 | The input Location string is invalid. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXCP2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
“VMSTRN” | ||||
Tensor to Vector: | “PV1”/”MAJORV” | “PV2”/”INTERV” | “PV3”/”MINORV” | |
“MJRV2D” | “MNRV2D” | |||
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
INTEGER i, j, idx, nres, dtype, resloc, minloc(2,6), maxloc(2,6), status
INTEGER eids(VIRTUAL), nresults(VIRTUAL)
REAL results(VIRTUAL)
/* Extract the element tensor result with Loadcase ID=2, Subcase ID=1,Primary Res ID=3, Secondary Res ID=1, Layer ID=1 at the element nodes and orient the tensor with the global*/
status = res_utl_extract_elem_results( [2,1,3,1,1], "Elm 1:#", @
"", "n", "Coord 0", dtype, resloc, nres, eids, nresults, @
results, minloc, maxloc )
IF( status != 0 ) THEN @ /* print message if error */
msg_to_form( status, 4, 0, 0, 0., "" )
ELSE
/* print out min/max for each stress component */
FOR( j = 1 TO 6 )
idx = minloc(2,j)
FOR( i = 1 TO minloc(1,j)-1)
idx += nresults(i)
END FOR
ui_writec(" Min Id= %d, Comp= %d, Stress= %g", @
ids(minloc(1,i)), j, results(idx,j) )
idx = maxloc(2,j)
FOR( i = 1 TO maxloc(1,j)-1)
idx += nresults(i)
END FOR
ui_writec(" Max Id= %d, Comp= %d, Stress= %g", @
ids(maxloc(1,i)), j, results(idx,j) )
END FOR
END IF
res_utl_extract_elem_history | (nlcs, lcids, subids, result_ids, elem_list, derivation, location, cid, data_type, resloc, nres, ids, nresults, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | nlcs | This value specifies the number of result cases to be extracted. |
INTEGER | lcids(nlcs) | This value specifies the load case identifiers. |
INTEGER | subids(nlcs) | This value specifies the subcase identifiers. |
INTEGER | result_ids(3) | This value specifies the primary result identifier, secondary result identifier, and layer identifier. |
STRING | elem_list[] | This value specifies a list of elements at which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | location[] | This value specifies the coordinate frame identifier location: "", "A" = axis, "C" = centroid, and "N" = nodal. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | resloc | This value returns the results location. Valid values are: 1=centroid, 2=nodal, and 3=multiple. |
INTEGER | nres | This value returns the number of node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
INTEGER | nresults(VIRTUAL) | This value returns the number of results per element. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified node for each result case. |
INTEGER | minloc(VIRTUAL) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(VIRTUAL) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500008 | The input Location string is invalid. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1” | “P2” | ||
“P3” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
Tensor to Vector: | “PV1” | “PV2” | “PV3” | |
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
res_utl_extract_elem_history2 | (nlcs, lcids, subids, result_ids, elem_list, derivation, location, cid, avg_method, avg_domain, extrap_method, complex_form, complex_angle, data_type, resloc, nres, ids, nresults, results, minloc, maxloc) |
Description: | ||
This function extracts the specified results data from the database. | ||
Input: | ||
INTEGER | nlcs | This value specifies the number of result cases to be extracted. |
INTEGER | lcids(nlcs) | This value specifies the load case identifiers. |
INTEGER | subids(nlcs) | This value specifies the subcase identifiers. |
INTEGER | result_ids(3) | This value specifies the primary result identifier, secondary result identifier, and layer identifier. |
STRING | elem_list[] | This value specifies a list of elements at which to extract results. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | location[] | This value specifies the coordinate frame identifier location: "", "A" = axis, "C" = centroid, and "N" = nodal. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
STRING | avg_method[] | This value specifies the averaging method to use. |
STRING | avg_domain[] | This value specifies the averaging domain to use. |
STRING | extrap_method[] | This value specifies the extrapolation method to use. |
STRING | complex_form[] | This value specifies the form to be used with complex numbers. |
REAL | complex_angle | This value is used with complex results when the complex_form is “Angle”. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
INTEGER | resloc | This value returns the results location. Valid values are: 1=centroid, 2=nodal, and 3=multiple. |
INTEGER | nres | This value returns the number of node identifiers. |
INTEGER | ids(VIRTUAL) | This value returns a list of node identifiers. |
INTEGER | nresults(VIRTUAL) | This value returns the number of results per element. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified node for each result case. |
INTEGER | minloc(VIRTUAL) | This value returns the array offsets for each minimum result component in the output value results. |
INTEGER | maxloc(VIRTUAL) | This value returns the array offsets for each maximum result component in the output value results. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500008 | The input Location string is invalid. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500014 | An error has occurred interpreting the input List string. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000085 | Cursor not open. | |
13000086 | No Records Found. | |
13000117 | The query specified has completed. | |
13000210 | The system is out of virtual memory. | |
14000281 | LpExpandPclVariables: Virtual memory is full. | |
14000298 | LpPicklistDecoder: Parse error. | |
14000299 | LpPicklistDecoder: Memory is exhausted. | |
14000302 | LpPicklistDecoderWithLookup: Memory is exhausted. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1”/”MAJOR” | “P2”/”INTER” | ||
“P3”/”MINOR” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
“MXSH2D” | “MXSH2D” | “MNCP2D” | ||
“MJR2D” | “MNR2D” | “TRES2D” | ||
Tensor to Vector: | “PV1”/”MAJORV” | “PV2”/”INTERV” | “PV3”/”MINORV” | |
“MJRV2D” | “MNRV2D” | |||
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
INTEGER i, nres, dtype, resloc, minloc(VIRTUAL), @
maxloc(VIRTUAL), status
INTEGER eids(VIRTUAL), nresults(VIRTUAL), lcids(5)=2,5,9,11,15
REAL results(VIRTUAL)
/* Extract the element tensor result with Loadcases ID=2,5,9,11,15, Subcase ID=1,Primary Res ID=3, Secondary Res ID=1, Layer ID=1 at the element centroids. Transform to the cylindrical system Coord 1 and retrieve the Theta component for element 101. Create an XY plot of the result */
status = res_utl_extract_elem_history( 5, lcids,[1,1,1,1,1], @
[3,1,1], “Elm 101", “yy”, “c”, “Coord 1”, type, resloc, @
nres, eids, nresults, results, minloc, maxloc )
IF( status != 0 ) THEN @ /* print message if error */
msg_to_form( status, 4, 0, 0, 0., “”)
ELSE
/* Create the plot */
xy_window_create(“res_utls”, 2., 2., 6., 6. )
xy_window_location_set(“res_utls”, 2., 2., 0 )
xy_curve_create(“theta_stress”, “theta_stress”, 7 )
xy_curve_data_set(“theta_stress”, TRUE, 5, [0., 0., 0., 0., 0.], @
results )
END IF
res_utl_create_elem_result | (result_ids, primary_title, secondary_title, nids, ids, cid_list, n_comp, data_type, location, nresults, results) |
Description: | ||
This function adds the specified results data to the database. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. The primary and result identifiers are not used as inputs by this function. This value is used as both an input and an output to the function and would be passed by the calling function as a single argument. |
STRING | primary_title[80] | This value specifies the primary result title. |
STRING | secondary_title[80] | This value specifies the secondary result title. |
INTEGER | nids | This value specifies the number of input element identifiers. |
INTEGER | ids() | This value specifies the element identifiers for the results. |
STRING | cid_list[] | This value specifies the alternate coordinate system for vector or tensor results. A null string is used for the global coordinate system. |
INTEGER | data_type | This value specifies the data type to use: 1=scalar, 2=vector, and 3=tensor. |
STRING | location[] | This value specifies the location to use: "C" = centroid, and "N" = nodal. |
INTEGER | nresults() | This value specifies the number of results per element. |
REAL | results() | This value specifies an array of all of the results at the specified nodes. |
Output: | ||
INTEGER | result_ids(5) | This value returns the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. The load case, subcase, and layer identifiers are not used as output values by this function. The primary and result identifiers are used as outputs by this function. This value is used as both an input and an output to the function and would be passed by the calling function as a single argument. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500005 | No Elements are found for the specified result matching the input list. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500008 | The input Location string is invalid. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
13000054 | Result case not found. |
res_utl_extract_path_results | (result_ids, npts, pts, derivation, cid, data_type, results, minloc, maxloc, elem_ids) |
Description: | ||
This function extracts the specified results data from the database and interpolate as needed to obtain results along a specified set of XYZ coordinates defining the path. | ||
Input: | ||
INTEGER | result_ids(5) | This value specifies the load case identifier, subcase identifier, primary result identifier, secondary result identifier, and layer identifier. |
INTEGER | npts | This value specifies the number of path points. |
REAL | pts(npts*3) | This value specifies global XYZ point locations. |
STRING | derivation[10] | This value specifies the derivation specifier if the results are to be derived. A value of null will leave the result as is. See the remarks below for more information. |
STRING | cid[] | This value specifies the coordinate system for vector/tensor transformations. A null string is used to leave the coordinate frame identifier as is. |
Output: | ||
INTEGER | data_type | This value returns the data type. Valid values are: 1=scalar, 2=vector, and 3=tensor. |
REAL | results(VIRTUAL) | This value returns all of the results at the specified path points. |
INTEGER | minloc(6) | This value returns the point index for each minimum result component. |
INTEGER | maxloc(6) | This value returns the point index for each maximum result component. |
INTEGER | elem_ids(npts) | This value returns identifiers for elements containing each point. No identifiers or 0 will be returned if a point was not interpolated. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
1 | This is an internal status condition. There is no corresponding status message in the message database. | |
4500002 | An error has occurred calculating a nodal averaged result. | |
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500004 | No Nodes found in the database matching the input list. | |
4500005 | No Elements found in the database matching the input list. | |
4500006 | The Loadcase/Subcase/Primary Result/ Secondary Result Id combination specified cannot be found. | |
4500007 | The specified Layer Id is not associated with the specified result. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500010 | The derivation specified in invalid. | |
4500011 | A error has occurred extrapolating this result to the element nodes. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500018 | The Coordinate Frame List is not valid. | |
4500020 | The input path specified points which did not interpolate to any elements. | |
13000054 | Result case not found. | |
13000056 | Coordinate frame not found. | |
13000071 | Result case type not found. | |
13000086 | No Records Found. | |
13000210 | The system is out of virtual memory. |
Tensor to Scalar: | “VONM” | “OCT” | “HYDRO”, | |
“TRESCA” | “INV1” | “INV2” | ||
“INV3” | “MAXSHR” | “MAXCMP” | ||
“MINCMP” | “P1” | “P2” | ||
“P3” | “XX” | “YY” | ||
“XY” | “YZ” | “ZX” | ||
Tensor to Vector: | “PV1” | “PV2” | “PV3” | |
any six characters such as “XXYYZZ” | ||||
Vector to Scalar: | “XX” | “YY” | “ZZ” | |
“MAG” | “MAXCMP” | “MINCMP” | ||
“AVG” |
res_utl_get_loadcases | (ncases, lcids, nsub) |
Description: | ||
This function retrieves the existing load cases with associated results from the database. | ||
Input: | ||
None. | ||
Output: | ||
INTEGER | ncases | This value returns the number of load cases found. |
INTEGER | lcids(VIRTUAL) | This value returns a list of load case identifiers. |
INTEGER | nsub(VIRTUAL) | This value returns the number of subcases for each load case. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
13000052 | Load case not found. |
res_utl_get_subcases | (lcid, nsub, subids) |
Description: | ||
This function retrieves the existing subcases with associated results from the database. | ||
Input: | ||
INTEGER | lcid | This value specifies the loadcase identifier. |
Output: | ||
INTEGER | nsub | This value returns the number of subcases found. |
INTEGER | subids(VIRTUAL) | This value returns a list of subcase identifiers. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
13000052 | Load case not found. | |
13000053 | Sub case not found. |
res_utl_get_result_ids | (nlcs, lcid, subids, nres, primary_id, secondary_id) |
Description: | ||
This function retrieves the existing results identifiers associated with a list of load case and subcase identifiers from the database. | ||
Input: | ||
INTEGER | nlcs | This value specifies the number of load cases. |
INTEGER | lcid(nlcs) | This value specifies load case identifiers. |
INTEGER | subids() | This value specifies subcase identifiers. |
Output: | ||
INTEGER | nres | This value returns the number of results found. |
INTEGER | primary_id(VIRTUAL) | This value returns a list of primary result identifiers. |
INTEGER | secondary_id(VIRTUAL) | |
This value returns a list of secondary result identifiers. | ||
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500009 | No results are found in the database matching the specified Ids. |
res_utl_get_result_layers | (result_ids, nlayers, ids, labels) |
Description: | ||
This function retrieves the layer positions associated with results from the database. | ||
Input: | ||
INTEGER | result_ids(4) | This value specifies the load case identifier, subcase identifier, primary result identifier, and secondary result identifier. |
Output: | ||
INTEGER | nlayers | This value returns the number of associated layers found. |
INTEGER | ids(VIRTUAL) | This value returns a list of layer position identifiers. |
STRING | labels[80](VIRTUAL) | This value returns the labels for the layers found. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
13000054 | Result case not found. | |
13000071 | Result case type not found. | |
13000093 | Too Many Values Returned for Space Allocated. | |
13000210 | The system is out of virtual memory. |
res_utl_get_global_vars | (nvar, var_name) |
Description: | ||
This function retrieves the existing global variables from the database. | ||
Input: | ||
None. | ||
Output: | ||
INTEGER | nvar | This value returns the number of global variables found. |
STRING | var_name[80](VIRTUAL) | |
This value returns the labels for the variables found. | ||
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. |
Description: | ||
This function retrieves the value of a specific global variable associated with a load case and subcase. | ||
Input: | ||
INTEGER | lcid | This value specifies the load case identifier. |
INTEGER | subid | This value specifies the subcase identifier. |
STRING | var_name[] | This value specifies the global variable name. |
Output: | ||
INTEGER | ncomp | This value returns the number of components used for the variable value 1, 3 or 6. |
REAL | vals(6) | This value returns the value[s] for the global variable. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500012 | The specified global variable is not found. | |
13000054 | Result case not found. | |
13000055 | Global variable not found. |
res_utl_get_subcases_by_gv | (lcid, var_name, compnum, val1, val2, method, nscs, subids) |
Description: | ||
This function retrieves all subcase identifiers with the specified global variable value within the specified range. | ||
Input: | ||
INTEGER | lcid | This value specifies the loadcase identifier. |
STRING | var_name[] | This value specifies the global variable name. |
INTEGER | compnum | This value specifies the component of the values to use. This value is usually set to 1. |
REAL | val1 | This value specifies the lower value of the range. |
REAL | val2 | This value specifies the upper value of the range. |
STRING | method[] | This value specifies the method used to retrieve the subcase identifiers. Valid values are: "U" = under, "B" = between, "A" = above, and "O" = outside. |
Output: | ||
INTEGER | nscs | This value returns the number of subcases found. |
INTEGER | subids(VIRTUAL) | This value returns a list of subcase identifiers. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500003 | A memory allocation error has occurred. Please check function inputs and call RES_UTL_FREE_RESULTS() before proceeding. | |
4500009 | No results are found in the database matching the specified Ids. | |
4500013 | The filter method specified is not valid. | |
13000052 | Load case not found. | |
13000053 | Sub case not found. |
res_utl_calc_results | (res1, operator, res2, res3) |
Description: | ||
This function operates mathematically on two result values on a component by component basis. | ||
Input: | ||
REAL | res1() | This value specifies the first result value or constant. |
STRING | operator[] | This value specifies the operator to use. A “+” will add the input values res1+res2. |
REAL | res2() | This value specifies the second result value or constant. |
Output: | ||
REAL | res3() | This value returns the result value. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500001 | One of the input array arguments is of an insufficient dimension. | |
4500017 | The specified operation is not valid. |
“-” | will subtract RES1-RES2 | |
“*” | will multiply RES1*RES2 | |
“/” | will divide RES1/RES2 | |
“^” | will exponentiate RES1^RES2 | |
“<” | will place the lesser of RES1 and RES2 in RES3 | |
“>” | will place the greater of RES1 and RES2 in RES3 | |
“SIND” | will place SIND(RES1) in RES3 | |
“COSD” | will place COSD(RES1) in RES3 | |
“ASIND” | will place ASIND(RES1) in RES3 | |
“ACOSD” | will place ACOSD(RES1) in RES3 | |
“SINR” | will place SINR(RES1) in RES3 | |
“COSR” | will place COSR(RES1) in RES3 | |
“TAND” | will place TAND(RES1) in RES3 | |
“ATAND” | will place ATAND(RES1) in RES3 | |
“TANR” | will place TANR(RES1) in RES3 | |
“ATANR” | will place ATANR(RES1) in RES3 | |
“ATAN2D” | will place ATAN2D(RES1,RES2) in RES3 | |
“ATAN2R” | will place ATAN2R(RES1,RES2) in RES3 | |
“SQRT” | will place SQRT(RES1) in RES3 | |
“LN” | will place LN(RES1) in RES3 | |
“LOG” | will place LOG(RES1) in RES3 | |
“EXP” | will place EXP(RES1) in RES3 | |
“ABS” | will place ABS(RES1) in RES3 |
res_utl_dot_results | (nres, res1, res2, res3) |
Description: | ||
This function calculates the dot product of 2 vector result values. | ||
Input: | ||
INTEGER | nres | This value specifies the number of result vectors in the values. |
REAL | res1(nres,3) | This value specifies the first vector result value. |
REAL | res2(nres,3) | This value specifies the second vector result value. |
Output: | ||
REAL | res3(nres) | This value returns the scalar results value of dot products. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully. |
Error Conditions: | ||
None. |
res_utl_cross_results | (nres, res1, res2, res3) |
Description: | ||
This function calculates the cross product of two vector result values. | ||
Input: | ||
INTEGER | nres | This value specifies the number of result vectors in values. |
REAL | res1(nres,3) | This value specifies the first vector result value. |
REAL | res2(nres,3) | This value specifies the second vector result value. |
Output: | ||
REAL | res3(nres,3) | This value returns the vector results value of cross products. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully. |
Error Conditions: | ||
None. |
res_utl_transform_results | (nvals, ncomp, in_vals, from_cid, to_cid, out_vals) |
Description: | ||
This function transforms the input vector or tensor values from one rectangular coordinate system to another. | ||
Input: | ||
INTEGER | nvals | This value specifies the number of result vectors in the result values. |
INTEGER | ncomp | This value specifies the number of components as 3 or 6 |
REAL | in_vals(nvals,ncomp) | This value specifies the result value. |
INTEGER | from_cid | This value specifies the FROM coordinate frame identifier. |
INTEGER | to_cid | This value specifies the TO coordinate frame identifier. |
Output: | ||
REAL | out_vals(nvals,ncomp) | This value returns the transformed result value. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
4500001 | One of the input array arguments is of an insufficient dimension. | |
4500015 | The specified Coordinate Frame does not exist. | |
4500017 | The specified operation is not valid. | |
4500018 | The Coordinate Frame List is not valid. |
db_get_connector_fastener | (id, pname, fmt, nid_gs, xyz_gs, nid_ga, nid_gb, id_pata, id_patb) |
Description: | ||
This function retrieves fastener connector attributes from the database. | ||
Input: | ||
INTEGER | list | The connector ID. |
Output: | ||
STRING[] | pname | The name of the associated connector property. |
INTEGER | fmt | The format of the spot weld (enum: SW_UNKNOWN=0, SW_PARTPAT=1, SW_ELPAT=2, SW_ELEMID=3, SW_GRIDID=4, OR SW_ALIGN=5). |
INTEGER | nid_gs | ID of the node at the connector location (if zero, use xyz_gs - supported for ELPAT and PARTPAT formats only). |
REAL(3) | xyz_gs | XYZ location of the connector location (used only if nid_gs is zero - ELPAT and PARTPAT formats only). |
INTEGER | nid_ga | ID of the node at the pierce location on surface patch A (zero if not specified). |
INTEGER | nid_gb | Id of the node at the pierce location on surface patch B (zero if not specified). |
INTEGER(33) | id_pata | The element ID, property ID or array of node ids defining surface patch A (all formats except ALIGN). |
INTEGER | id_patb | The element ID, property ID or array of node ids defining surface patch B(all formats except ALIGN). |
STRING[] | type | The connector type (e.g., Spot Weld, Fastener). |
INTEGER | <Return Value> | This function returns a value of 0 if successful. |
Error Conditions: | ||
DbConnectorNotFound DbConnectorWrongType |
db_get_connector_spot_weld | (id, pname, fmt, nid_gs, xyz_gs, nid_ga, nid_gb, id_pata, id_patb) |
Description: | ||
This function retrieves spot weld connector attributes from the database. | ||
Input: | ||
INTEGER | list | The connector ID. |
Output: | ||
STRING[] | pname | The name of the associated connector property. |
INTEGER | fmt | The format of the spot weld (enum: SW_UNKNOWN=0, SW_PARTPAT=1, SW_ELPAT=2, SW_ELEMID=3, SW_GRIDID=4, OR SW_ALIGN=5). |
INTEGER | nid_gs | ID of the node at the connector location (if zero, use xyz_gs - supported for ELPAT and PARTPAT formats only). |
REAL(3) | xyz_gs | XYZ location of the connector location (used only if nid_gs is zero - ELPAT and PARTPAT formats only). |
INTEGER | nid_ga | ID of the node at the pierce location on surface patch A (zero if not specified). |
INTEGER | nid_gb | Id of the node at the pierce location on surface patch B (zero if not specified). |
INTEGER(33) | id_pata | The element ID, property ID or array of node ids defining surface patch A (all formats except ALIGN). |
INTEGER | id_patb | The element ID, property ID or array of node ids defining surface patch B(all formats except ALIGN). |
STRING[] | type | The connector type (e.g., Spot Weld, Fastener). |
INTEGER | <Return Value> | This function returns a value of 0 if successful. |
Error Conditions: | ||
DbConnectorNotFound DbConnectorWrongType |
db_get_connector_type | (id, title) |
Description: | ||
Given a connector ID, this function retrieves the connector type from the database.. | ||
Input: | ||
INTEGER | list | The connector ID. |
Output: | ||
STRING[] | type | The connector type (e.g., Spot Weld, Fastener). |
INTEGER | <Return Value> | This function returns a value of 0 if successful. |
Error Conditions: | ||
MSG_FEM_CONN_NOT_FOUND |
db_get_load_case_title | (id, title) |
Description: | ||
This function retrieves the title for a specified loadcase identifier. | ||
Input: | ||
INTEGER | id | This value specifies the loadcase identifier. |
Output: | ||
STRING | title[80] | This value returns the loadcase title. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000052 | Load case not found. |
db_get_load_case_id | (title, id) |
Description: | ||
This function retrieves the id for a specified loadcase title. | ||
Input: | ||
STRING | title[80] | This value specifies the loadcase title. |
Output: | ||
INTEGER | id | This value returns the loadcase identifier. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000052 | Load case not found. |
db_get_sub_case_title | (lcid, subid, title) |
Description: | ||
This function retrieves the title for a specified loadcase and subcase identifier. It returns the title of a subcase excluding any extension added to the name to distinguish it, in the GUI, from other subcases with the same name.If you want to keep the name extensions that Patran adds to the loadcase and subcase identifier, use the function res_data_get_subcase_name, 1483. | ||
Input: | ||
INTEGER | lcid | This value specifies the loadcase identifier. |
INTEGER | subid | This value specifies the subcase identifier. |
Output: | ||
STRING | title[31] | This value returns the subcase title. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000053 | Sub case not found. |
db_get_sub_case_id | (lcid, title, subid) |
Description: | ||
This function retrieves the subcase identifier for a specified loadcase identifier, subcase title. | ||
Input: | ||
INTEGER | lcid | This value specifies the loadcase identifier. |
STRING | title[31] | This value specifies the subcase title. |
Output: | ||
INTEGER | subid | This value returns the subcase identifier. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000053 | Sub case not found. |
db_get_primary_res_label | (primary_id, label) |
Description: | ||
This function retrieves the label for a specified primary result identifier. | ||
Input: | ||
INTEGER | primary_id | This value specifies the primary result identifier. |
Output: | ||
STRING | label[80] | This value returns the primary result label. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000054 | Result case not found. |
db_get_primary_res_id | (label, primary_id) |
Description: | ||
This function retrieves the identifier for a specified primary result label. | ||
Input: | ||
STRING | label[80] | This value specifies the primary result label. |
Output: | ||
INTEGER | primary_id | This value returns the primary result identifier. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
13000054 | Result case not found. |
db_get_secondary_res_label | (primary_id, secondary_id, label) |
Description: | ||
This function retrieves the label for a specified secondary result identifier. | ||
Input: | ||
INTEGER | primary_id | This value specifies the primary results identifier. |
INTEGER | secondary_id | This value specifies the secondary result identifier. |
Output: | ||
STRING | label[80] | This value returns the secondary result label. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
See the Status Messages (Ch. 11) for information on any error values returned by this function. |
db_get_secondary_res_id | (primary_id, label, secondary_id) |
Description: | ||
This function retrieves the identifier for a specified secondary result label. | ||
Input: | ||
INTEGER | primary_id | This value specifies the primary result identifier. |
STRING | label[80] | This value specifies the secondary result label. |
Output: | ||
INTEGER | secondary_id | This value returns the secondary result identifier. |
INTEGER | <Return Value> | This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error. |
Error Conditions: | ||
See the Status Messages (Ch. 11) for information on any error values returned by this function. |