aStudy.gather()

This command is used to gather analysis results across the designs of a parametric study.

This page discusses:

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 .fil 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 .odb 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.

 

See Also
Scripting Parametric Studies

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

main

Set main equal to the name of the main surface of the contact pair for which results are to be gathered. This name must be enclosed in matching quotation marks.

secondary

Set secondary equal to the name of the secondary surface of the contact pair for which results are to be gathered. This name must be enclosed in matching quotation marks.

Optional Data

mainInstance

This option is required only if results are gathered from an output database file and if the main surface is defined on an instance.

Set mainInstance equal to the name of the instance on which the main surface is defined. This name must be enclosed in matching quotation marks.

secondaryInstance

This option is required only if results are gathered from an output database file and if the secondary surface is defined on an instance.

Set secondaryInstance equal to the name of the instance on which the secondary surface is defined. This name must be enclosed in matching quotation marks.

Required Data When Secondary Surface Node Variable Results Are Requested

node

If secondary 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).