Products
Abaqus/Standard
Abaqus/Explicit
setTableCollection
Activate table collection, required in all user subroutines except UMDFLUX, UEPACTIVATIONVOL, UELEMDRESP, and material-related
user subroutines.
Utility Routine Interface
Fortran:
character*80 tcName
...
call setTableCollection(tcName, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
void setTableCollectionC(const char* tcName, int &jError);
Variables to Be Provided to the Utility Routine
-
tcName
-
The name of the table collection that will be accessed.
Variables Returned from the Utility Routine
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
getParameterTable
Access parameters defined in the parameter table.
Utility Routine Interface
Fortran:
include 'aba_tcs_param.inc'
character*80 parameterTableLabel, cParams(maxParams)
dimension iParamsDataType(maxParams), iParams(maxParams), rParams(maxParams)
...
call getParameterTable(parameterTableLabel, numParams, iParamsDataType, iParams, rParams, cParams, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
#include <aba_tcs_param.h>
void getParameterTableC(const char* parameterTableLabel, int &numParams, int *iParamsDataType,
int *iParams, double *rParams, std::vector<std::string> &cParams, int &jError);
Variables to Be Provided to the Utility Routine
-
parameterTableLabel
-
Label of the parameter table to be accessed. A parameter table with this label must
be defined in the active table collection.
Variables Returned from the Utility Routine
-
numParams
-
Number of parameters defined in a row of this parameter table.
-
iParamsDataType(numParams)
-
Array containing integer flags for data types of parameters:
j_tcsI_PDT_int,
j_tcsI_PDT_float, or
j_tcsI_PDT_string, which are defined in the
aba_tcs_param.inc include file.
maxParams must be equal to or greater than
numParams.
-
iParams(numParams*numRows)
-
Array containing values of INTEGER parameters.
numRows is the number of rows in the parameter
table. You can get this value from the
queryParameterTable utility. The
parameters are ordered in row-by-row format.
-
rParams(numParams*numRows)
-
Array containing values of FLOAT-type parameters.
The parameters are ordered in row-by-row format.
-
cParams(numParams*numRows)
-
Array containing values of STRING-type parameters.
The parameters are ordered in row-by-row format.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
getParameterTableRow
Access a row of parameters defined in the parameter table.
Utility Routine Interface
Fortran:
include 'aba_tcs_param.inc'
character*80 parameterTableLabel, cParams(maxParams)
dimension iParamsDataType(maxParams), iParams(maxParams), rParams(maxParams)
call getParameterTableRow(parameterTableLabel, jRow, numParams, iParamsDataType, iParams,
rParams, cParams, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
#include <aba_tcs_param.h>
void getParameterTableRowC(const char* parameterTableLabel, int jRow, int &numParams, int *iParamsDataType,
int *iParams, double *rParams, std::vector<std::string> &cParams, int &jError);
Variables to Be Provided to the Utility Routine
-
parameterTableLabel
-
Label of the parameter table to be accessed. A parameter table with this label must
be defined in the active table collection.
-
jRow
-
Row of the parameter table to be accessed.
Variables Returned from the Utility Routine
-
numParams
-
Number of parameters defined in a row of this parameter table.
-
iParamsDataType(numParams)
-
Array containing integer flags for data types of parameters
j_tcsI_PDT_int,
j_tcsI_PDT_float, or
j_tcsI_PDT_string, which are defined in the
aba_tcs_param.inc include file.
maxParams must be equal to or greater than
numParams.
-
iParams(numParams)
-
Array containing values of INTEGER parameters in
jRow row of this parameter table.
-
rParams(numParams)
-
Array containing values of FLOAT-type parameters in
jRow row of this parameter table.
-
cParams(numParams)
-
Array containing values of STRING-type parameters
in jRow row of this parameter table.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
getPropertyTable
Perform interpolation of properties defined in the property table in
Abaqus/Standard.
Utility Routine Interface
Fortran:
character*80 propertyTableLabel
dimension field(*)
dimension rIndepVars(maxIndepVars), rProps(maxProps), dPropDVar(maxProps*maxVars)
...
call getPropertyTable(propertyTableLabel, rIndepVars, temp, field,
numProps, rProps, dPropDVar, numDervs, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
void getPropertyTableC(const char* propertyTableLabel, double *rIndepVars, double *temp, double *field,
int &numProps, double *rProps, double *dPropDVar, int &numDervs, int &jError);
Variables to Be Provided to the Utility Routine
-
propertyTableLabel
-
Label of the property table to be accessed. A property table with this label must
be defined in the active table collection.
-
rIndepVars(maxIndepVars)
-
Array containing values of independent variables.
maxIndepVars must be equal to or greater than the
number of independent variables in the table.
-
temp
-
Temperature.
-
field(*)
-
Array of values of predefined field variables.
-
numDervs
-
Flag to indicate if the calculation of derivatives is required (0 indicates that
no calculation of derivatives is required, 1 indicates that calculation of
derivatives is required with respect to the first variable, and 2 or higher
indicates that calculation of derivatives is required with respect to all
variables).
Variables Returned from the Utility Routine
-
numProps
-
Number of properties defined in this property table.
-
rProps(maxProps)
-
Array containing interpolated values of properties.
maxProps must be equal to or greater than
numProps.
-
dPropDVar(maxProps*maxVars)
-
Array containing derivatives of properties with respect to independent variables,
temperature, or field variables. maxVars must be
equal to or greater than the sum of independent variables, temperature, and field
variables in the table. The derivatives are returned in the following order:
- Derivatives of the first property, second property, …
numProps with respect to the first variable.
- Derivatives of the first property, second property, …
numProps with respect to the second variable.
- …
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
vGetPropertyTable
Perform interpolation of properties defined in the property table in Abaqus/Explicit.
Utility Routine Interface
character*80 propertyTableLabel
dimension temp(nBlock), field(nBlock,*)
dimension rIndepVars(maxBlock*maxIndepVars), rProps(maxBlock*maxProps),
dPropDIVar(maxBlock*maxProps*maxIndepVars), dPropdTemp(maxBlock*maxProps)
...
call vGetPropertyTable(propertyTableLabel, nBlock, rIndepVars, temp, field,
numProps, rProps, dPropDIVar, dPropDTemp, jDervs, jError)
Variables to Be Provided to the Utility Routine
-
propertyTableLabel
-
Label of the property table to be accessed. A property table with this label must
be defined in the active table collection.
-
nBlock
-
Number of points at which properties are evaluated in this call to
vGetPropertyTable.
-
rIndepVars(maxIndepVars)
-
Array containing values of independent variables.
maxIndepVars must be equal to or greater than the
number of independent variables in the table.
-
temp(nBlock)
-
Temperature.
-
field(nBlock,*)
-
Array of values of predefined field variables.
-
jDervs
-
Flag to indicate if the calculation of derivatives is required (0 indicates that
no calculation of derivatives is required, 1 indicates that calculation of
derivatives is required with respect to all independent variables and temperature).
Variables Returned from the Utility Routine
-
numProps
-
Number of properties defined in this property table.
-
rProps(maxBlock*maxProps)
-
Array containing interpolated values of properties.
maxBlock must be equal to or greater than
nBlock. maxProps
must be equal to or greater than numProps.
-
dPropDIVar(maxBlock*maxProps*maxIndepVars)
-
Array containing derivatives of properties with respect to independent variables.
The derivatives are returned in the following order:
- nBlock derivatives of the first property with
respect to the first independent variable, nBlock
derivatives of the first property with respect to the second independent
variable, and so on.
- nBlock derivatives of the second property with
respect to the first independent variable, nBlock
derivatives of the second property with respect to the second independent
variable, and so on.
- …
-
dPropdTemp(maxBlock,maxProps)
-
Array containing derivatives of properties with respect to temperature. The
derivatives are returned in the following order:
- nBlock derivatives of the first property with
respect to temperature.
- nBlock derivatives of the second property with
respect to temperature.
- …
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
vGetPropertyTablePtr
Perform interpolation of properties defined in the property table in Abaqus/Explicit. You pass independent variables as pointers, which offers better performance compared to
vGetPropertyTable when you pass more than one
independent variable.
Utility Routine Interface
character*80 propertyTableLabel
integer*8 mIndepVars(maxIndepVars)
dimension temp(nBlock), field(nBlock,*)
dimension rProps(maxBlock*maxProps), dPropDIVar(maxBlock*maxProps*maxIndepVars), dPropdTemp(maxBlock*maxProps)
...
call SMASetPointer(mIndVarPtrs(1), eqps)
call SMASetPointer(mIndVarPtrs(2), eqpsRate)
call vGetPropertyTablePtr(propertyTableLabel, nBlock, mIndepVars, temp, field,
numProps, rProps, dPropDIVar, dPropDTemp, jDervs, jError)
Variables to Be Provided to the Utility Routine
-
propertyTableLabel
-
Label of the property table to be accessed. A property table with this label must
be defined in the active table collection.
-
nBlock
-
Number of points at which properties are evaluated in this call to
vGetPropertyTablePtr.
-
mIndepVars(maxIndepVars)
-
Array, declared as an 8-byte integer that contains pointers to arrays with
independent variables initialized with the
SMASetPointer utility routine.
maxIndepVars must be equal to or greater than the
number of independent variables in the table.
-
temp(nBlock)
-
Temperature.
-
field(nBlock,*)
-
Array of values of predefined field variables.
-
jDervs
-
Flag to indicate if the calculation of derivatives is required (0 indicates that
no calculation of derivatives is required, 1 indicates that calculation of
derivatives is required with respect to all independent variables and temperature).
Variables Returned from the Utility Routine
-
numProps
-
Number of properties defined in this property table.
-
rProps(maxBlock*maxProps)
-
Array containing interpolated values of properties.
maxBlock must be equal to or greater than
nBlock. maxProps
must be equal to or greater than numProps.
-
dPropDIVar(maxBlock*maxProps*maxIndepVars)
-
Array containing derivatives of properties with respect to independent variables.
The derivatives are returned in the following order:
- nBlock derivatives of the first property with
respect to the first independent variable, nBlock
derivatives of the first property with respect to the second independent
variable, and so on.
- nBlock derivatives of the second property with
respect to the first independent variable, nBlock
derivatives of the second property with respect to the second independent
variable, and so on.
- …
-
dPropdTemp(maxBlock*maxProps)
-
Array containing derivatives of properties with respect to temperature. The
derivatives are returned in the following order:
- nBlock derivatives of the first property with
respect to temperature.
- nBlock derivatives of the second property with
respect to temperature.
- …
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
queryTableCollectionSize
Query the size of the table collection database.
Utility Routine Interface
Fortran:
include 'aba_tcs_param.inc'
dimension jSize(n_tcsI_TCDB_size)
...
call queryTableCollectionSize(jSize, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
#include <aba_tcs_param.h>
void queryTableCollectionSizeC(int *jSize, int &jError);
Variables Returned from the Utility Routine
-
jSize(i_tcsI_TCDB_numTCs)
-
Number of table collections that are defined.
-
jSize(i_tcsI_TCDB_maxParams)
-
Maximum number of parameters in any parameter table.
-
jSize(i_tcsI_TCDB_maxParamRows)
-
Maximum number of rows in any parameter table.
-
jSize(i_tcsI_TCDB_maxProps)
-
Maximum number of properties in any property table.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
queryTableCollectionNames
Query the names of the table collections.
Utility Routine Interface
Fortran:
character*80 tcNames(maxTCs)
...
call queryTableCollectionNames(tcNames, numTCs)
or
C++:
#include <SMAAspUserSubroutines.h>
void queryTableCollectionNamesC(std::vector<std::string> &tcNames, int &numTCs);
Variables Returned from the Utility Routine
-
tcNames(maxTCs)
-
Array containing names of all defined table collections.
maxTCs must be equal to or greater than
numTCs.
-
numTCs
-
Number of table collections.
queryTableCollection
Query properties of the active table collection.
Utility Routine Interface
Fortran:
include 'aba_tcs_param.inc'
character*80 cTableColl(n_tcsC_TC_size)
dimension jTableColl(n_tcsI_TC_size)
...
call queryTableCollection(jTableColl, cTableColl, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
#include <aba_tcs_param.h>
void queryTableCollectionC(int *jTableColl, std::vector<std::string> &cTableColl,
int &jError);
Variables Returned from the Utility Routine
-
jTableColl(i_tcsI_TC_numParamTbls)
-
Number of parameter tables in the active table collection.
-
jTableColl(i_tcsI_TC_numPropTbls)
-
Number of property tables in the active table collection.
-
jTableColl(i_tcsI_TC_maxParams)
-
Maximum number of parameters in any parameter table in the active table collection.
-
jTableColl(i_tcsI_TC_maxParamRows)
-
Maximum number of rows in any parameter table in the active table collection.
-
jTableColl(i_tcsI_TC_maxProps)
-
Maximum number of properties in any property table in the active table collection.
-
cTableColl(i_tcsC_TC_name)
-
Name of the active table collection.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
queryParameterTable
Query the number of parameters in a parameter table.
Utility Routine Interface
Fortran:
character*80 parameterTableLabel
...
call queryParameterTable(parameterTableLabel, numParams, numRows, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
void queryParameterTableC(const char *parameterTableLabel, int &numParams,
int &numRows, int &jError);
Variables to Be Provided to the Utility Routine
-
parameterTableLabel
-
Label of the parameter table to be queried. A parameter table with this label must
be defined in the active table collection.
Variables Returned from the Utility Routine
-
numParams
-
Number of parameters in the parameter table.
-
numRows
-
Number of rows in the parameter table, which is a multiple of the parameter number
declared for the parameter table type of this table.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
queryPropertyTable
Query properties of a property table.
Utility Routine Interface
Fortran:
include 'aba_tcs_param.inc'
character*80 propertyTableLabel, cPropTable(n_tcsC_PRT_size)
dimension jPropTable(n_tcsI_PRT_size), rPropTable(n_tcsR_PRT_size)
...
call queryPropertyTable(propertyTableLabel, jPropTable, rPropTable, cPropTable, jError)
or
C++:
#include <SMAAspUserSubroutines.h>
#include <aba_tcs_param.h>
void queryPropertyTableC(const char *propertyTableLabel, int *jPropTable, double *rPropTable,
std::vector<std::string> &cPropTable, int &jError);
Variables to Be Provided to the Utility Routine
-
propertyTableLabel
-
Label of the property table to be queried. A property table with this label must
be defined in the active table collection.
Variables Returned from the Utility Routine
-
jPropTable(i_tcsI_PRT_numProps)
-
Number of properties in the property table.
-
jPropTable(i_tcsI_PRT_numIndVars)
-
Number of independent variables in the property table.
-
jPropTable(i_tcsI_PRT_numFieldVars)
-
Number of field variables in the property table.
-
jPropTable(i_tcsI_PRT_tempDep)
-
0 indicates that properties in the property table are not temperature dependent, 1
indicates that properties are temperature dependent.
-
jPropTable(i_tcsI_PRT_extrapolation)
-
0 indicates constant extrapolation of properties in the property table, 1
indicates linear extrapolation of properties.
-
jPropTable(i_tcsI_PRT_regularize)
-
0 indicates that property table data is not regularized, 1 indicates that property
table data is regularized.
-
jPropTable(i_tcsI_PRT_origin)
-
0 indicates that property values at point 0 of the first independent variable
might be not preserved, 1 indicates that property values at point 0 of the first
independent variable are preserved.
-
rPropTable(i_tcsR_PRT_rTol)
-
Tolerance used to regularize the property table data.
-
jError
-
Return code (0 indicates no error, nonzero indicates an output request error).
|