A FieldOutput object contains field data for a specific output variable.
import odbAccess session.odbs[name].steps[name].frames[i].fieldOutputs[name]
This method creates a FieldOutput object.
session.odbs[name].steps[name].frames[i].FieldOutput
Required arguments
A String specifying the output variable name.
A String specifying the output variable.
A SymbolicConstant specifying the output type. Possible values are SCALAR, VECTOR, TENSOR_3D_FULL, TENSOR_3D_PLANAR, TENSOR_3D_SURFACE, TENSOR_2D_PLANAR, and TENSOR_2D_SURFACE.
Optional arguments
A sequence of Strings specifying the labels for each component of the value. The length of the sequence must match the type. If type=TENSOR, the default value is name with the suffixes ('11', '22', '33', '12', '13', '23'). If type=VECTOR, the default value is name with the suffixes ('1', '2', '3'). If type=SCALAR, the default value is an empty sequence.
A sequence of SymbolicConstants specifying which invariants should be calculated for this field. An empty sequence indicates that no invariants are valid for this field. Possible values are:
The default value is an empty sequence.
MAGNITUDE
MISES
TRESCA
PRESS
INV3
MAX_PRINCIPAL
MID_PRINCIPAL
MIN_PRINCIPAL
MAX_INPLANE_PRINCIPAL
MIN_INPLANE_PRINCIPAL
OUTOFPLANE_PRINCIPAL
Return value
A FieldOutput object.
Exceptions
This method creates a FieldOutput object from an existing FieldOutput object.
session.odbs[name].steps[name].frames[i].FieldOutput
Required argument
A FieldOutput object.
Optional arguments
A String specifying the name of the FieldOutput object.
A String specifying the output variable.
Return value
A FieldOutput object.
Exceptions
This method adds data to a FieldOutput object.
Required arguments
A SymbolicConstant specifying the position of the output. Possible values are:
NODAL, specifying the values calculated at the nodes.
INTEGRATION_POINT, specifying the values calculated at the integration points.
ELEMENT_NODAL, specifying the values obtained by extrapolating results calculated at the integration points.
CENTROID, specifying the value at the centroid obtained by extrapolating results calculated at the integration points.
An OdbInstance object specifying the namespace for labels.
A sequence of Ints specifying the labels of the nodes or elements where the values in data are located. The node or element labels must be sorted in ascending order and must be specified in the same order as the values provided for the data argument.
A sequence of sequences of Floats specifying the data values for the specified position, instance, and labels. The values must be given in the correct order. Element nodal data follow the order of nodal connectivity defined in the User's Manuals. Integration point data follow the order defined in the User's Manuals. Section point data for beams and shells follow the convention given in the User's Manuals. For more information, see Part VI, “Elements,” of the Abaqus Analysis User's Manual. These data create FieldValue objects internally.
Optional arguments
A SectionPoint object specifying the location in the section. Although sectionPoint is an optional argument to the addData method, if you omit this argument when you are writing field output data for a shell or a beam you cannot subsequently select the section point to display when you are displaying the field output data using Abaqus/Viewer.
A sequence of sequences of Floats specifying the 3 x 3 matrix of direction cosines of the local coordinate system. This argument is available only for fields with type=TENSOR.
Return value
Exceptions
The addData method throws many exceptions of type odbException. For example, if the local coordinate system is specified for scalar data:
This method adds data to a FieldOutput object.
Required arguments
A SymbolicConstant specifying the position of the output. Possible values are:
NODAL, specifying the values calculated at the nodes.
INTEGRATION_POINT, specifying the values calculated at the integration points.
ELEMENT_NODAL, specifying the values obtained by extrapolating results calculated at the integration points.
CENTROID, specifying the value at the centroid obtained by extrapolating results calculated at the integration points.
An OdbInstance object specifying the namespace for labels.
A sequence of Ints specifying the labels of the nodes or elements where the values in data are located.. The node or element labels must be sorted in ascending order and must be specified in the same order as the values provided for the data argument.
A sequence of sequences of Floats specifying the data values for the specified position, instance, and labels. The values must be given in the correct order. Element nodal data follow the order of nodal connectivity defined in the User's Manuals. Integration point data follow the order defined in the User's Manuals. Section point data for beams and shells follow the convention given in the User's Manuals. For more information, see Part VI, “Elements,” of the Abaqus Analysis User's Manual. These data create FieldValue objects internally.
Optional arguments
A SectionPoint object specifying the location in the section. Although sectionPoint is an optional argument to the addData method, if you omit this argument when you are writing field output data for a shell or a beam you cannot subsequently select the section point to display when you are displaying the field output data using Abaqus/Viewer.
A sequence of matrices of floats specifying the direction cosines of the local coordinates systems, where the sequence is the same length as data. If localCoordSystem is a matrix, a different local coordinate system applies to each data value.
Return value
Exceptions
The addData method throws many exceptions of type odbException. For example, if the local coordinate system is specified for scalar data:
This method adds the data from a field created using the getSubset method and mathematical operators to the database. The user must create a field to contain the new data and then use the addData method to assign the data from the fields.
Required argument
A FieldOutput object specifying the data to add.
Optional arguments
Return value
Exceptions
The addData method throws many exceptions of type odbException. For example, if the local coordinate system is specified for scalar data:
This method generates a scalar field containing the extracted component or calculated invariant values. The new field will hold values for the same nodes or elements as the parent field. Abaqus will perform this operation on only the real part of the FieldOutput object. The operation is not performed on the conjugate data (the imaginary portion of a complex result).
Required argument
A SymbolicConstant specifying the invariant. Possible values are MAGNITUDE, MISES, TRESCA, PRESS, INV3, MAX_PRINCIPAL, MID_PRINCIPAL, and MIN_PRINCIPAL.
Optional arguments
Return value
A FieldOutput object.
Exceptions
This method generates a scalar field containing the extracted component or calculated invariant values. The new field will hold values for the same nodes or elements as the parent field. Abaqus will perform this operation on only the real part of the FieldOutput object. The operation is not performed on the conjugate data (the imaginary portion of a complex result).
Required argument
A String specifying the component label, such as “S11”.
Optional arguments
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional arguments
A SymbolicConstant specifying the position of the output in the element. Possible values are:
If the requested field values are not found in the output database at the specified ELEMENT_NODAL or CENTROID positions, they are extrapolated from the field data at the INTEGRATION_POINT position.
NODAL, specifying the values calculated at the nodes.
INTEGRATION_POINT, specifying the values calculated at the integration points.
ELEMENT_NODAL, specifying the values obtained by extrapolating results calculated at the integration points.
CENTROID, specifying the value at the centroid obtained by extrapolating results calculated at the integration points.
A Boolean specifying whether the extrapolated data returned by this call is written to the output database. The default value is OFF.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
An OdbSet specifying the region for which to extract values. Nodes in the node sets must be sorted and arranged in ascending order. Use of unsorted node sets is not supported.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
A sequence of sequences of Floats specifying the 3 × 3 matrix of direction cosines. Field values associated with the supplied coordinate system will be extracted.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
An OdbMeshElement specifying the region for which to extract values.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
An OdbMeshNode specifying the region for which to extract values.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
An OdbInstance specifying the region for which to extract values.
Return value
A FieldOutput object.
Exceptions
A FieldOutput object with a subset of the field values.
Required arguments
Optional argument
A String specifying the element type for which to extract values. The string must correspond to a valid Abaqus element type.
Return value
A FieldOutput object.
Exceptions
This method generates a new vector or tensor field containing the transformed component values of the parent field. The new field will hold values for the same nodes or elements as the parent field. Results will be transformed based on the orientations specified by the input DatumCsys object. Abaqus will perform this operation on only the real part of the FieldOutput object. The operation is not performed on the conjugate data (the imaginary portion of a complex result).
Required argument
A valid DatumCsys object designating the coordinate system. Valid systems can be fixed or positioned with respect to nodes on the model and can be cartesian, cylindrical, or spherical.
Optional arguments
An Int specifying which axis of the coordinate system will be projected as the second component for local result orientations. Valid values are 1, 2, or 3; the default value is 2.
A Double specifying the minimum allowable angle (radians) between the specified projection axis and the element normal. The next axis will be used for projection if this tolerance test fails.
Return value
A FieldOutput object.
Exceptions
This method generates a new vector or tensor field containing the transformed component values of the parent field. The new field will hold values for the same nodes or elements as the parent field. Results will be transformed based on the orientations specified by the input DatumCsys object. Abaqus will perform this operation on only the real part of the FieldOutput object. The operation is not performed on the conjugate data (the imaginary portion of a complex result).
Required argument
A valid DatumCsys object designating the coordinate system. Valid systems can be fixed or positioned with respect to nodes on the model and can be cartesian, cylindrical, or spherical.
Optional arguments
A FieldOutput object specifying the nodal displacement vectors required by moving coordinate systems to determine instantaneous configurations.
An Int specifying which axis of the coordinate system will be projected as the second component for local result orientations. Valid values are 1, 2, or 3; the default value is 2.
A Double specifying the minimum allowable angle (radians) between the specified projection axis and the element normal. The next axis will be used for projection if this tolerance test fails.
Return value
A FieldOutput object.
Exceptions
This method generates a new vector or tensor field containing the transformed component values of the parent field. The new field will hold values for the same nodes or elements as the parent field. Results will be transformed based on the orientations specified by the input DatumCsys object. Abaqus will perform this operation on only the real part of the FieldOutput object. The operation is not performed on the conjugate data (the imaginary portion of a complex result).
Required argument
A valid DatumCsys object designating the coordinate system. Valid systems can be fixed or positioned with respect to nodes on the model and can be cartesian, cylindrical, or spherical.
Optional arguments
A FieldOutput object specifying the nodal displacement vectors required by moving coordinate systems to determine instantaneous configurations.
A FieldOutput object specifying the nodal rotational displacement vectors required by moving coordinate systems that follow a 6-dof node, to determine instantaneous configurations.
An Int specifying which axis of the coordinate system will be projected as the second component for local result orientations. Valid values are 1, 2, or 3; the default value is 2.
A Double specifying the minimum allowable angle (radians) between the specified projection axis and the element normal. The next axis will be used for projection if this tolerance test fails.
Return value
A FieldOutput object.
Exceptions
The FieldOutput object has members with the same names and descriptions as the arguments to the FieldOutput method.
In addition, the FieldOutput object can have the following members:
An Int specifying the dimension of vector or the first dimension (number of rows) of matrix.
An Int specifying the second dimension (number of columns) of matrix.
A Boolean specifying whether the data are complex.
A FieldLocationArray object.
A FieldValueArray object specifying the order of the objects in the array is determined by the Abaqus Scripting Interface; see the data argument to the addData method for a description of the order.