15.2.5 aStudy.gather()

15.2.5 aStudy.gather(): Gather the results of a parametric study.

Products: ABAQUS/Standard ABAQUS/Explicit

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

Reference

“Scripting parametric studies,” Section 15.1.1

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,” Section 4.2.1, or “ABAQUS/Explicit output variable identifiers,” Section 4.2.2, 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,” Section 4.2.1, or “ABAQUS/Explicit output variable identifiers,” Section 4.2.2. 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 from an output database file containing multiple 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,” Section 2.2.4).

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,” Section 2.2.4). 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 from an output database file containing multiple 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 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

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

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 from an output database file containing multiple 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 from an output database file containing multiple 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 from an output database file containing multiple 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 containing multiple 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” in “Output to the data and results files,” Section 4.1.2).