ProductsAbaqus/StandardAbaqus/Explicit
Command
aStudy.gather (request= , results= , step= , frameValue= | inc= | mode= , variable= , additional data)
Required data
- results
Set results equal to a name that will be used to identify the results record gathered by this command. This name must be enclosed in matching quotation marks.
- variable
Set variable equal to an output variable identifier key; this key must be enclosed in matching quotation marks.
For gathering results from the results (.fil) file only those output variable identifier keys appearing under the column heading in Abaqus/Standard output variable identifiers or Abaqus/Explicit output variable identifiers are available. For example, the U or S variable identifier keys can be specified, but the U1 or S11 variable identifier keys cannot be specified. In addition, the MODAL variable identifier key can be specified to gather frequency results (those written to the results file with the record key 1980); in this case no additional data are required in this command.
When gathering results from the output database (.odb) file, each result record to be gathered is chosen by specifying one of the available output variable identifier keys appearing under the column heading in Abaqus/Standard output variable identifiers or Abaqus/Explicit output variable identifiers. For field output the component must not be specified, while for history output the component number is required; for example, the U or S variable identifier keys can be specified for field output, while the U1 or S11 variable identifier keys can be specified for history output.
Optional data
- request
This option is applicable only if the results are to be gathered from the output database file.
Set request equal to FIELD or HISTORY to specify whether the results must be gathered from the field data or the history data in the output database file.
If request is omitted from this command, the results will be gathered from the field data.
- step
Set step equal to the analysis step number from which the results are to be gathered.
If step is specified in this command as well as in the output command, the step specification in this command is used.
If step is omitted from this command, it must have been specified in the output command.
Optional and mutually exclusive data
- frameValue
This option is applicable only if the results are to be gathered from the output database file.
Set frameValue equal to the step time or frequency value of the analysis increment in the analysis step specified from which the results are to be gathered. frameValue can also be set equal to the symbolic constant LAST to specify that results are to be gathered from the last increment of the step. If no results are available at the frameValue specified, a warning will be issued and the results will be gathered from the closest increment.
If frameValue is specified in this command as well as in the output command, the frameValue specification in this command is used for gathering.
If frameValue is omitted from this command, the results are gathered for the frameValue specified in the output command or are gathered from the last increment in the step.
- inc
Set inc equal to the number of the analysis increment of the non-frequency analysis step specified from which the results are to be gathered across the parametric study variations. inc can also be set equal to the symbolic constant LAST to specify that results are to be gathered from the last increment of the step.
If inc is specified in this command as well as in the output command, the inc specification in this command is used for gathering.
If inc is omitted from this command, the results are gathered from the increment specified in the output command or are gathered from the last increment in the step.
This option is not valid for gathering history results from the output database file.
- mode
Set mode equal to the number of the mode of the frequency analysis step specified from which the results are to be gathered across the parametric study variations.
If mode is specified in this command as well as in the output command, the mode specification in this command is used.
If mode is omitted from this command, the results are gathered from the mode specified in the output command or are gathered from the first mode in the step.
Additional data for element integration point variables
Required data
- element
Set element equal to the number of the element for which results are to be gathered.
- instance
This option is required only if results are gathered for an element on a part instance in an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the part instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Optional data
- centroid
Set centroid equal to the symbolic constant ON to indicate that the results are to be gathered at the centroid of the element. This option is valid only when the results have been written to the results file at the centroid of the element.
centroid, int, and node are mutually exclusive.
If centroid, int, and node are omitted, the default is int=1.
- int
Set int equal to the number of the integration point of the element for which results are to be gathered. This option is valid only when the results have been written to the results file at the integration points of the element.
centroid, int, and node are mutually exclusive.
If int is omitted, the default is int=1. If centroid, int, and node are omitted, the default is int=1.
- node
Set node equal to the number of the node in the element for which results are to be gathered. This option is valid only when the results have been written to the results file at the nodes of the element.
centroid, int, and node are mutually exclusive.
If centroid, int, and node are omitted, the default is int=1.
- rbnum
Set rbnum equal to the number of the rebar for which results are to be gathered. The rebar number is consistent with the order, per element, in which you define the rebar (see Defining rebar as an element property).
If rbnum is omitted, the default is rbnum=1.
Rebar information cannot be gathered from the output database file.
- rebar
Set rebar equal to the name of the rebar for which results are to be gathered (defined as described in Defining rebar as an element property). Rebar results can be obtained for continuum and beam elements only at integration points; for shell and membrane elements rebar results can be obtained at integration points and at the centroid of the element.
Rebar information cannot be gathered from the output database file.
- section
Set section equal to the number of the section point of the element for which results are to be gathered. This applies to beam, shell, or layered solid elements. section is not relevant for rebar results.
If section is omitted, the default is section=1.
Additional data for element section variables
Required data
- element
Set element equal to the number of the element for which results are to be gathered.
- instance
This option is required only if results are gathered for an element on a part instance in an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the part instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Optional data
- centroid
Set centroid equal to the symbolic token ON to indicate that the results are to be gathered at the centroid of the element. This option is valid only when the results have been written to the results file or output database at the centroid of the element.
centroid, int, and node are mutually exclusive.
If centroid, int, and node are omitted, the default is int=1.
- int
Set int equal to the number of the integration point of the element for which results are to be gathered. This option is valid only when the results have been written to the results file or output database at the integration points of the element.
centroid, int, and node are mutually exclusive.
If int is omitted, the default is int=1. If centroid, int, and node are omitted, the default is int=1.
- node
Set node equal to the number of the node in the element for which results are to be gathered. This option is valid only when the results have been written to the results file or output database at the nodes of the element.
centroid, int, and node are mutually exclusive.
If centroid, int, and node are omitted, the default is int=1.
Additional data for whole element variables
Required data
- element
Set element equal to the number of the element for which results are to be gathered.
- int
Set int = –1.
- instance
This option is required only if results are gathered for an element on a part instance in an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the part instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Additional data for partial model (element set) or whole model variables
Optional data
- elset
Set elset equal to the element set name for which results are to be gathered. If elset is omitted, results will be gathered for the whole model. This name must be enclosed in matching quotation marks.
- instance
This option is required only if results are gathered from an output database file and if the element set is defined on an instance.
Set instance equal to the name of the instance on which the element set is defined. This name must be enclosed in matching quotation marks.
If the element set is defined on the assembly, instance must not be specified in both this command and the output command.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Additional data for nodal variables
Required data
- node
Set node equal to the number of the node for which results are to be gathered.
- instance
This option is required only if results are gathered for a node on a part instance in an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Additional data for modal variables
There are no additional data.
Additional data for contact surface variables
Required data
- master
Set master equal to the name of the master surface of the contact pair for which results are to be gathered. This name must be enclosed in matching quotation marks.
- slave
Set slave equal to the name of the slave surface of the contact pair for which results are to be gathered. This name must be enclosed in matching quotation marks.
Optional data
- masterInstance
This option is required only if results are gathered from an output database file and if the master surface is defined on an instance.
Set masterInstance equal to the name of the instance on which the master surface is defined. This name must be enclosed in matching quotation marks.
- slaveInstance
This option is required only if results are gathered from an output database file and if the slave surface is defined on an instance.
Set slaveInstance equal to the name of the instance on which the slave surface is defined. This name must be enclosed in matching quotation marks.
Required data when slave surface node variable results are requested
- node
If slave surface node variable results are to be gathered, set node equal to the number of the node for which results are to be gathered.
nset and node are mutually exclusive.
- instance
This option is required only if results are gathered for a node on a part instance in an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the part instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Optional data when whole surface variable results are requested
- nset
Set nset equal to the name of the node set for which whole surface variable results are to be gathered. This name must be enclosed in matching quotation marks.
If nset is omitted, the default is the whole surface.
If the results are collected from the output database file and the node set is defined on an instance, the node set name must be prefixed with the instance name and a period (for example: “PART–1–1.TOP”).
nset and node are mutually exclusive.
- instance
This option is required only if results are gathered from an output database file and if the node set is defined on an instance.
Set instance equal to the name of the instance on which the node set is defined. This name must be enclosed in matching quotation marks.
If the node set is defined on the assembly, instance must not be specified in both this command and the output command.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Additional data for cavity radiation surface variables
Required data
- element
Set element equal to the number of the element underlying the cavity facet for which results are to be gathered.
- elface
Set elface equal to the face identifier of the face of the element underlying the cavity facet for which results are to be gathered.
- instance
This option is required only if results are gathered from an output database file generated from a model described as an assembly of part instances.
Set instance equal to the name of the part instance for which results are to be gathered. This name must be enclosed in matching quotation marks.
If instance is specified in this command as well as in the output command, the instance specification in this command is used.
Additional data for section file output
Required data
- sectionName
Set sectionName equal to the name of the section for which results are to be gathered. This name must be enclosed in matching quotation marks (see Section output from Abaqus/Standard).