16 KiB
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,” 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 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” in “Output to the data and results files,” Section 4.1.2).
20.2.6 aStudy.generate(): Generate the analysis job data for a parametric study.
Products: Abaqus/Standard Abaqus/Explicit
This command is used to generate the analysis input files for a parametric study.
Reference:
• “Scripting parametric studies,” Section 20.1.1
Command:
aStudy.generate (template= )
Required data:
template
Set template equal to the name of the template input file from which the input files of each of the parametric study variations are to be generated; this name must be enclosed in matching quotation marks.
20.2.7 aStudy.output(): Specify the source of parametric study results.
Products: Abaqus/Standard Abaqus/Explicit
This command should precede any results gather commands. It is used to specify from where the results of a parametric study will be gathered.
Reference:
• “Scripting parametric studies,” Section 20.1.1
Command:
a S t u d y. o u t p u t (f i l e = , i n s t a n c e = , o v e r l a y = , r e q u e s t = , s t e p = , f r a m e V a l u e = | i n c = | m o d e =)
Optional data:
file
Set file equal to FIL or ODB to specify that results must be read from the results (.fil) file or output database (.odb) file.
If file is omitted from this command, the results will be read from the results (.fil) file.
instance
This option is applicable only if results are gathered from an output (.odb) database 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 results are gathered for a set defined on the assembly, instance must not be specified in both this command and the gather command.
If instance is omitted from this command and an instance name is required to gather the results, it must be specified in the gather command.
overlay
This option is applicable only if results are gathered from an output (.odb) database.
This option is used to control the trade-off between memory usage and execution speed. Set overlay equal to OFF (the default) or ON to specify whether the memory used for an output database should be overwritten. If memory usage is a problem, set overlay equal to ON to specify that the memory used for an output database must be overwritten after a gather is performed for the specific output database. If execution speed is more important than memory usage, set overlay equal to OFF to specify that memory must be allocated for each output database.
The overlay option affects your ability to separately manipulate the output database (.odb) file. When you set overlay equal to OFF, the file will remain open after accessing the results from the gather command, which may affect your ability to separately access or manipulate the file (to delete the file, for
example). Set overlay equal to ON to separately access the .odb file after accessing the gather based results.
request
This option is applicable only if the results are to be gathered from the output (.odb) database.
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.
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 omitted from this command, it must be specified in the gather command.
Optional and mutually exclusive data:
frameValue
This option is applicable only if the results are to be gathered from the output (.odb) database.
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 omitted from this command, the results are gathered from the last increment in the step or are gathered from the increment specified in the gather command.
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. 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 specified.
If inc is omitted from this command, the results are gathered from the last increment in the step or are gathered from the increment specified in the gather command.
This option is not valid for gathering history results from the output (.odb) database.
mode
Set mode equal to the mode number of the frequency analysis step specified from which the results are to be gathered across the parametric study variations.
If mode is omitted, the results are gathered from the mode specified in the gather command or are gathered from the first mode in the step.