FieldReport#

Field report commands are used to write a field output report and free body computational results to an ASCII file.

Create field reports in Session#

class FieldReportSession[source]#
writeFieldReport(filename, append, sortItem, odb, step, frame, outputPosition, displayGroup, variable, numericForm=None, complexAngle=None, stepFrame=abaqusConstants.SPECIFY)[source]#

This method writes a FieldOutput object to a user-defined ASCII file.

Note

This function can be accessed by:

session.writeFieldReport

Note

Check FieldReportSession.writeFieldReport on help.3ds.com/0.1..

Parameters:

  • filename (str) – A String specifying the name of the file to which field output will be written.

  • append (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to append the field output to an existing file. The default value is ON.

  • sortItem (str) – A String specifying the item by which to sort the tabular values.

  • odb (Odb) – An Odb object from which to obtain field output values.

  • step (int) – An Int (or stepIndex) specifying the step from which to obtain field output values. Possible values are 0 ≤ step ≤ (numSteps − 1).

  • frame (int) – An Int (or frameIndex) specifying the frame from which to obtain field output values. Possible values are 0 ≤ frame ≤ (numFramesInStep − 1).

  • outputPosition (SymbolicConstant) – A SymbolicConstant specifying the position from which to obtain data. Possible values are NODAL, INTEGRATION_POINT, ELEMENT_FACE, ELEMENT_NODAL, ELEMENT_CENTROID, WHOLE_ELEMENT, WHOLE_REGION, WHOLE_PART_INSTANCE, WHOLE_MODEL, and GENERAL_PARTICLE.

  • displayGroup (DisplayGroup) – A DisplayGroup object specifying the subset of the model for which to obtain data.

  • variable (SymbolicConstant) –

    A sequence of variable description sequences specifying one or more field output variables for which to obtain data. Each variable description sequence contains the following elements:

    • element0: A String specifying the name of the variable.

    • element1: A SymbolicConstant specifying the output position at which to report data. Possible values are ELEMENT_CENTROID, ELEMENT_FACE, ELEMENT_NODAL, GENERAL_PARTICLE, INTEGRATION_POINT, NODAL, WHOLE_ELEMENT, WHOLE_MODEL, WHOLE_PART_INSTANCE, and WHOLE_REGION.

    • element2: A Sequence of tuples each consisting of a SymbolicConstant specifying the refinement (COMPONENT or INVARIANT), followed by a String specifying the name of a component or invariant for which to obtain values. If this element is omitted, data are written for all components and invariants (if applicable). This element is required if element3 (the following element in the tuple) is included.

    • element3 (if applicable): A Dictionary with a String key and a String value specifying a single section point at which to report data. The key specifies a region in the model; the corresponding value specifies a section point within that region. For example:

      {'shell < MAT > < 7 section points >': 'SPOS (fraction = 1.0)'}

      If this element is omitted, data are written for all section points (if applicable). If this element is omitted, data are written for all section points (if applicable).

  • numericForm (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the numeric form in which to display results that contain complex numbers. Possible values are COMPLEX_MAGNITUDE, COMPLEX_PHASE, REAL, IMAGINARY, and COMPLEX_MAG_AT_ANGLE. The initial value is COMPLEX_MAGNITUDE.

  • complexAngle (Optional[float], default: None) – A Float specifying the angle (in degrees) at which to display results that contain complex numbers when numericForm = COMPLEX_MAG_AT_ANGLE. The initial value is 0.

  • stepFrame (SymbolicConstant, default: SPECIFY) – A SymbolicConstant indicating whether to obtain the values from the specified frame or from all active frames. Possible values are SPECIFY and ALL. The default value is SPECIFY.

writeFreeBodyReport(fileName, append, step=None, frame=None, stepFrame=abaqusConstants.SPECIFY, odb=None)[source]#

This method writes a FreeBody object to a user-defined ASCII file.

Note

This function can be accessed by:

session.writeFreeBodyReport

Note

Check FieldReportSession.writeFreeBodyReport on help.3ds.com/0.1..

Parameters:

  • fileName (str) – A String specifying the name of the file to which the free body output will be written.

  • append (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to append the free body output to an existing file. The default value is ON.

  • step (Optional[int], default: None) – An Int identifying the step from which to obtain values. The default value is the current step.

  • frame (Optional[int], default: None) – An Int identifying the frame from which to obtain values. The default value is the current frame.

  • stepFrame (SymbolicConstant, default: SPECIFY) – A SymbolicConstant indicating whether to obtain the values from the specified frame or from all active frames. Possible values are SPECIFY and ALL. The default value is SPECIFY.

  • odb (Optional[Odb], default: None) – An Odb object specifying the output database from which data will be read.

Object features#

FieldReportOptions#

class FieldReportOptions[source]#

The FieldReportOptions object stores settings used by the writeFieldReport method when you write a FieldOutput object to an ASCII file. The FieldReportOptions object has no constructor. Abaqus creates the fieldReportOptions member when you import the Visualization module.

Note

This object can be accessed by:

import visualization
session.defaultFieldReportOptions
session.fieldReportOptions

Note

Check FieldReportOptions on help.3ds.com/0.1..

Public Data Attributes:

numberFormat

Format of the number

Public Methods:

setValues(numColumns, numberFormat[, ...])

This method modifies the FieldReportOptions object.

NumberFormat([blankPad, format, numDigits, ...])

This method creates a NumberFormat object.
NumberFormat(blankPad=ON, format=abaqusConstants.ENGINEERING, numDigits=6, precision=0)[source]#

This method creates a NumberFormat object.

Note

This function can be accessed by:

session.defaultFieldReportOptions.NumberFormat
session.fieldReportOptions.NumberFormat
session.journalOptions.NumberFormat

Note

Check NumberFormat on help.3ds.com/0.1..

Parameters:

  • blankPad (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the printed digits should be padded with blank characters to ensure equal sized fields. The blankPad argument is useful when your printed output includes columns. The default value is ON.

  • format (SymbolicConstant, default: ENGINEERING) – A SymbolicConstant specifying the formatting type. Possible values are ENGINEERING, SCIENTIFIC, and AUTOMATIC. The default value is ENGINEERING.

  • numDigits (int, default: 6) – An Int specifying the number of digits to be displayed in the result. numDigits >0>0. The default value is 6.

  • precision (int, default: 0) – An Int specifying the number of decimal places to which the number is to be truncated for display. precision ≤0≤0. If precision =0, no truncation is applied. The default value is 0.

Returns:

A NumberFormat object.

Return type:

NumberFormat

numberFormat: NumberFormat = <abaqus.Session.NumberFormat.NumberFormat object>[source]#

Format of the number

setValues(numColumns, numberFormat, printXYData=ON, printTotal=ON, printMinMax=ON, pageWidth=abaqusConstants.NO_LIMIT, columnLayout=abaqusConstants.SINGLE_TABLE, sort=abaqusConstants.ASCENDING, printLocalCSYS=OFF)[source]#

This method modifies the FieldReportOptions object.

Note

Check FieldReportOptions.setValues on help.3ds.com/0.1..

Parameters:

  • numColumns (int) – An Int specifying the number of columns to display for the tabular report. The default value is 80.

  • numberFormat (NumberFormat) – A NumberFormat object specifying the format type, number of digits and precision used to print the numeric output.

  • printXYData (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include X - Y data values in the tabular report. The default value is ON.

  • printTotal (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include column totals in the tabular report. The default value is ON.

  • printMinMax (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include column summary minimum and maximum values in the tabular report. The default value is ON.

  • pageWidth (SymbolicConstant, default: NO_LIMIT) – A SymbolicConstant specifying how the width of the tabular report is to be determined. Possible values are NO_LIMIT and SPECIFY. The default value is NO_LIMIT.

  • columnLayout (SymbolicConstant, default: SINGLE_TABLE) – A SymbolicConstant specifying how values are to be presented in the tabular report. Possible values are SINGLE_TABLE and SEPARATE_TABLES. The default value is SINGLE_TABLE.

  • sort (SymbolicConstant, default: ASCENDING) – A SymbolicConstant specifying the order in which values are to be sorted within a tabular report. Possible values are ASCENDING and DESCENDING. The default value is ASCENDING.

  • printLocalCSYS (Union[AbaqusBoolean, bool], default: OFF) –

    A Boolean specifying whether to include the local coordinate system values in the tabular report. The default value is OFF.

    New in version 2022: The printLocalCSYS argument was added.

Returns:

A FieldReportOptions object.

Return type:

FieldReportOptions

FreeBodyReportOptions#

class FreeBodyReportOptions[source]#

The FreeBodyReportOptions object stores settings used by the writeFreeBodyReport method when you write free body computational results to an ASCII file. The FreeBodyReportOptions object has no constructor. Abaqus creates the freeBodyReportOptions member when you import the Visualization module.

Note

This object can be accessed by:

import visualization
session.defaultFreeBodyReportOptions
session.freeBodyReportOptions

Note

Check FreeBodyReportOptions on help.3ds.com/0.1..

Public Methods:

setValues([numDigits, forceThreshold, ...])

This method modifies the FreeBodyReportOptions object.
setValues(numDigits=3, forceThreshold=None, momentThreshold=None, numberFormat=abaqusConstants.SCIENTIFIC, reportFormat=abaqusConstants.NORMAL_ANNOTATED, csysType=abaqusConstants.GLOBAL)[source]#

This method modifies the FreeBodyReportOptions object.

Note

Check FreeBodyReportOptions.setValues on help.3ds.com/0.1..

Parameters:

  • numDigits (int, default: 3) – An Int specifying the number of decimal places. The default value is 3.

  • forceThreshold (Optional[float], default: None) – A Float specifying the threshold value for force. The default value is 10-6.

  • momentThreshold (Optional[float], default: None) – A Float specifying the threshold value for moment. The default value is 10-6.

  • numberFormat (SymbolicConstant, default: SCIENTIFIC) – A SymbolicConstant specifying the number format. Possible values are SCIENTIFIC, FIXED, and ENGINEERING. The default value is SCIENTIFIC.

  • reportFormat (SymbolicConstant, default: NORMAL_ANNOTATED) – A SymbolicConstant specifying the report format. Possible values are NORMAL_ANNOTATED and COMMA_SEPARATED_VALUES. The default value is NORMAL_ANNOTATED.

  • csysType (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying the coordinate system type. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

Returns:

A FreeBodyReportOptions object.

Return type:

FreeBodyReportOptions

OdbFieldVarList#

class OdbFieldVarList(iterable=(), /)[source]#

The read-only OdbFieldVarList object is a sequence listing all variables available for the current step and frame. Each item in the sequence is itself a sequence fully describing the given variable.

Note

This object can be accessed by:

import visualization
session.viewports[name].layers[name].odbDisplay.fieldVariables
session.viewports[name].odbDisplay.fieldVariables

Note

Check OdbFieldVarList on help.3ds.com/0.1..

Public Methods:

Inherited from list

__repr__()

Return repr(self).

__getattribute__(name, /)

Return getattr(self, name).

__lt__(value, /)

Return self<value.

__le__(value, /)

Return self<=value.

__eq__(value, /)

Return self==value.

__ne__(value, /)

Return self!=value.

__gt__(value, /)

Return self>value.

__ge__(value, /)

Return self>=value.

__iter__()

Implement iter(self).

__init__(*args, **kwargs)

__len__()

Return len(self).

__getitem__

x.__getitem__(y) <==> x[y]

__setitem__(key, value, /)

Set self[key] to value.

__delitem__(key, /)

Delete self[key].

__add__(value, /)

Return self+value.

__mul__(value, /)

Return self*value.

__rmul__(value, /)

Return value*self.

__contains__(key, /)

Return key in self.

__iadd__(value, /)

Implement self+=value.

__imul__(value, /)

Implement self*=value.

__reversed__()

Return a reverse iterator over the list.

__sizeof__()

Return the size of the list in memory, in bytes.

clear()

Remove all items from list.

copy()

Return a shallow copy of the list.

append(object, /)

Append object to the end of the list.

insert(index, object, /)

Insert object before index.

extend(iterable, /)

Extend list by appending elements from the iterable.

pop([index])

Remove and return item at index (default last).

remove(value, /)

Remove first occurrence of value.

index(value[, start, stop])

Return first index of value.

count(value, /)

Return number of occurrences of value.

reverse()

Reverse IN PLACE.

sort(*[, key, reverse])

Sort the list in ascending order and return None.

__class_getitem__

See PEP 585
Inherited from Generic

__class_getitem__

See PEP 585

__init_subclass__(*args, **kwargs)

This method is called when a class is subclassed.

Private Data Attributes:

Inherited from Generic

_is_protocol

OdbModelFieldVarList#

class OdbModelFieldVarList[source]#

The read-only OdbModelFieldVarList object lists all variables available for the model in the current OdbDisplay object.

Note

This object can be accessed by:

import visualization
session.viewports[name].layers[name].odbDisplay.modelVariableList
session.viewports[name].odbDisplay.modelVariableList

Note

Check OdbModelFieldVarList on help.3ds.com/0.1..

writeFieldReport#

writeFieldReport(filename, append, sortItem, odb, step, frame, outputPosition, displayGroup, variable, numericForm=None, complexAngle=None, stepFrame=abaqusConstants.SPECIFY)[source]#

This function writes a FieldOutput object to a user-defined ASCII file.

Note

This function can be accessed by:

session.writeFieldReport

Note

Check writeFieldReport.writeFieldReport on help.3ds.com/0.1..

Parameters:

  • filename (str) – A String specifying the name of the file to which field output will be written.

  • append (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to append the field output to an existing file. The default value is ON.

  • sortItem (str) – A String specifying the item by which to sort the tabular values.

  • odb (Odb) – An Odb object from which to obtain field output values.

  • step (int) – An Int (or stepIndex) specifying the step from which to obtain field output values. Possible values are 0 ≤ step ≤ (numSteps − 1).

  • frame (int) – An Int (or frameIndex) specifying the frame from which to obtain field output values. Possible values are 0 ≤ frame ≤ (numFramesInStep − 1).

  • outputPosition (SymbolicConstant) – A SymbolicConstant specifying the position from which to obtain data. Possible values are NODAL, INTEGRATION_POINT, ELEMENT_FACE, ELEMENT_NODAL, ELEMENT_CENTROID, WHOLE_ELEMENT, WHOLE_REGION, WHOLE_PART_INSTANCE, WHOLE_MODEL, and GENERAL_PARTICLE.

  • displayGroup (DisplayGroup) – A DisplayGroup object specifying the subset of the model for which to obtain data.

  • variable (SymbolicConstant) –

    A sequence of variable description sequences specifying one or more field output variables for which to obtain data. Each variable description sequence contains the following elements:

    • element0: A String specifying the name of the variable.

    • element1: A SymbolicConstant specifying the output position at which to report data. Possible values are ELEMENT_CENTROID, ELEMENT_FACE, ELEMENT_NODAL, GENERAL_PARTICLE, INTEGRATION_POINT, NODAL, WHOLE_ELEMENT, WHOLE_MODEL, WHOLE_PART_INSTANCE, and WHOLE_REGION.

    • element2: A Sequence of tuples each consisting of a SymbolicConstant specifying the refinement (COMPONENT or INVARIANT), followed by a String specifying the name of a component or invariant for which to obtain values. If this element is omitted, data are written for all components and invariants (if applicable). This element is required if element3 (the following element in the tuple) is included.

    • element3 (if applicable): A Dictionary with a String key and a String value specifying a single section point at which to report data. The key specifies a region in the model; the corresponding value specifies a section point within that region. For example:

      {'shell < MAT > < 7 section points >': 'SPOS (fraction = 1.0)'}

      If this element is omitted, data are written for all section points (if applicable). If this element is omitted, data are written for all section points (if applicable).

  • numericForm (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the numeric form in which to display results that contain complex numbers. Possible values are COMPLEX_MAGNITUDE, COMPLEX_PHASE, REAL, IMAGINARY, and COMPLEX_MAG_AT_ANGLE. The initial value is COMPLEX_MAGNITUDE.

  • complexAngle (Optional[float], default: None) – A Float specifying the angle (in degrees) at which to display results that contain complex numbers when numericForm = COMPLEX_MAG_AT_ANGLE. The initial value is 0.

  • stepFrame (SymbolicConstant, default: SPECIFY) – A SymbolicConstant indicating whether to obtain the values from the specified frame or from all active frames. Possible values are SPECIFY and ALL. The default value is SPECIFY.

writeFreeBodyReport#

writeFreeBodyReport(fileName, append, step=None, frame=None, stepFrame=abaqusConstants.SPECIFY, odb=None)[source]#

This method writes a FreeBody object to a user-defined ASCII file.

Note

This function can be accessed by:

session.writeFreeBodyReport

Note

Check writeFreeBodyReport.writeFreeBodyReport on help.3ds.com/0.1..

Parameters:

  • fileName (str) – A String specifying the name of the file to which the free body output will be written.

  • append (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to append the free body output to an existing file. The default value is ON.

  • step (Optional[int], default: None) – An Int identifying the step from which to obtain values. The default value is the current step.

  • frame (Optional[int], default: None) – An Int identifying the frame from which to obtain values. The default value is the current frame.

  • stepFrame (SymbolicConstant, default: SPECIFY) – A SymbolicConstant indicating whether to obtain the values from the specified frame or from all active frames. Possible values are SPECIFY and ALL. The default value is SPECIFY.

  • odb (Optional[Odb], default: None) – An Odb object specifying the output database from which data will be read.