Accessing Abaqus table collections

These utility routines can be used to activate the table collection and to access data from parameter tables and interpolate data that were defined in property tables.

These utility routines can be invoked from any Abaqus/Standard user subroutine except UEXTERNALDB.

The following topics are discussed:

SETTABLECOLLECTION—activate table collection, required in all user subroutines except UMDFLUX and UEPACTIVATIONVOL
GETPARAMETERTABLE—access parameters defined in the parameter table
GETPROPERTYTABLE—perform interpolation of properties defined in the property table
QUERYTABLECOLLECTIONSIZE—query the size of the table collection database
QUERYTABLECOLLECTIONNAMES—query the names of the table collections
QUERYTABLECOLLECTION—query properties of the active table collection
QUERYPARAMETERTABLE—query the number of parameters in a parameter table
QUERYPROPERTYTABLE—query properties of a property table

ProductsAbaqus/Standard

SETTABLECOLLECTION—activate table collection, required in all user subroutines except UMDFLUX and UEPACTIVATIONVOL

Utility routine interface

CHARACTER*80 TCNAME 
...
CALL SETTABLECOLLECTION(TCNAME, 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, 1 indicates an output request error).

GETPARAMETERTABLE—access parameters defined in the parameter table

Utility routine interface

#include <aba_tcs_param.inc>

CHARACTER*80 PARAMETERTABLETYPE, CPARAMS(MAXPARAMS)
DIMENSION IPARAMSDATATYPE(MAXPARAMS), IPARAMS(MAXPARAMS), RPARAMS(MAXPARAMS)
 

CALL GETPARAMETERTABLE(PARAMETERTABLETYPE, NUMPARAMS, IPARAMSDATATYPE, IPARAMS, RPARAMS, CPARAMS, JERROR)

Variables to be provided to the utility routine

PARAMETERTABLETYPE: The type of the parameter table to be accessed. A parameter table of this type must be defined in the active table collection.

Variables returned from the utility routine

NUMPARAMS: The number of parameters defined in this parameter table.
IPARAMSDATATYPE(MAXPARAMS): 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(MAXPARAMS): Array containing values of INTEGER parameters.
RPARAMS(MAXPARAMS): Array containing values of FLOAT-type parameters.
CPARAMS(MAXPARAMS): Array containing values of STRING-type parameters.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).

GETPROPERTYTABLE—perform interpolation of properties defined in the property table

Utility routine interface

CHARACTER*80 PROPERTYTABLETYPE
DIMENSION RINDEPVARS(MAXINDEPVARS), FIELD(*), RPROPS(MAXPROPS), DPROPDVAR(MAXPROPS,MAXVARS) 

CALL GETPROPERTYTABLE(PROPERTYTABLETYPE, RINDEPVARS, TEMP, FIELD, 
                                      NUMPROPS, RPROPS, DPROPDVAR, NUMDERVS, JERROR)

Variables to be provided to the utility routine

PROPERTYTABLETYPE: The type of the property table to be accessed. A property table of this type 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 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: The 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, and/or field variables. MAXVARS must be equal to or greater than the sum of independent variables, temperature, and field variables in the table.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).

QUERYTABLECOLLECTIONSIZE—query the size of the table collection database

Utility routine interface

#include <aba_tcs_param.inc>

DIMENSION JSIZE(n_tcsI_TCDB_size)
...
CALL QUERYTABLECOLLECTIONSIZE(JSIZE, JERROR)

Variables returned from the utility routine

JSIZE(i_tcsI_TCDB_numTCs): The number of table collections that are defined.
JSIZE(i_tcsI_TCDB_maxParams): The maximum number of parameters in any parameter table.
JSIZE(i_tcsI_TCDB_maxProps): The maximum number of properties in any property table.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).

QUERYTABLECOLLECTIONNAMES—query the names of the table collections

Utility routine interface

CHARACTER*80 TCNAMES(MAXTCS)
...
CALL QUERYTABLECOLLECTIONNAMES(TCNAMES, 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: The number of table collections.

QUERYTABLECOLLECTION—query properties of the active table collection

Utility routine interface

#include <aba_tcs_param.inc>

CHARACTER*80 CTABLECOLL(n_tcsC_TC_size)
DIMENSION JTABLECOLL(n_tcsI_TC_size)
...
CALL QUERYTABLECOLLECTION(JTABLECOLL, CTABLECOLL, JERROR)

Variables returned from the utility routine

JTABLECOLL(i_tcsI_TC_numParamTbls): The number of parameter tables in the active table collection.
JTABLECOLL(i_tcsI_TC_numPropTbls): The number of property tables in the active table collection.
JTABLECOLL(i_tcsI_TC_maxParams): The maximum number of parameters in any parameter table in the active table collection.
JTABLECOLL(i_tcsI_TC_maxProps): The maximum number of properties in any property table in the active table collection.
CTABLECOLL(i_tcsC_TC_name): The name of the active table collection.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).

QUERYPARAMETERTABLE—query the number of parameters in a parameter table

Utility routine interface

CHARACTER*80 PARAMTABLETYPE
...
QUERYPARAMETERTABLE(PARAMTABLETYPE, NUMPARAMS, JERROR)

Variables to be provided to the utility routine

PARAMETERTABLETYPE: The type of the parameter table to be queried. A parameter table of this type must be defined in the active table collection.

Variables returned from the utility routine

NUMPARAMS: The number of parameters in the parameter table.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).

QUERYPROPERTYTABLE—query properties of a property table

Utility routine interface

#include <aba_tcs_param.inc>

CHARACTER*80 PROPTABLETYPE, CPROPTABLE(n_tcsC_PRT_size)
DIMENSION JPROPTABLE(n_tcsI_PRT_size), RPROPTABLE(n_tcsr_PRT_size)
...
QUERYPROPERTYTABLE(PROPTABLETYPE, JPROPTABLE, RPROPTABLE, CPROPTABLE, JERROR)

Variables to be provided to the utility routine

PROPTABLETYPE: The type of the property table to be queried. A property table of this type must be defined in the active table collection.

Variables returned from the utility routine

JPROPTABLE(i_tcsI_PRT_numProps): The number of properties in the property table.
JPROPTABLE(i_tcsI_PRT_numIndVars): The number of independent variables in the property table.
JPROPTABLE(i_tcsI_PRT_numFieldVars): The 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.
JERROR: Return code (0 indicates no error, 1 indicates an output request error).