Annotation๏
Annotation commands are used to create, position, and modify viewport annotations.
Create annotations๏
- AnimationUserData.Arrow(name, startPoint=(0.0, 0.0), endPoint=(0.0, 0.0), startAnchor=abaqusConstants.BOTTOM_LEFT, endAnchor=abaqusConstants.BOTTOM_LEFT, startHeadStyle=abaqusConstants.NONE, endHeadStyle=abaqusConstants.FILLED_ARROW, startGap=0.0, endGap=0.0, color='White', lineStyle=abaqusConstants.SOLID, lineThickness=abaqusConstants.VERY_THIN)[source]
This method creates an Arrow object.
Note
This function can be accessed by:
mdb.Arrow session.odbs[name].userData.Arrow
Note
Check Arrow on help.3ds.com/2023.
- Parameters:
name (
str
) โ A String specifying the annotation repository key.startPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the start point X and Y offsets in millimeters from startAnchor. The default value is (0, 0).endPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the end point X and Y offsets in millimeters from endAnchor. The default value is (0, 0).startAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT,,
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
endAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
startHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:NONE
) โA SymbolicConstant specifying the style of the start head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is NONE.
endHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:FILLED_ARROW
) โA SymbolicConstant specifying the style of the end head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is FILLED_ARROW.
startGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow start point and the arrow start head. The default value is 0.0.endGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow end point and the arrow end head. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the arrow. Possible string values are any valid color. The default value is โWhiteโ.lineStyle (
Literal
[DASHED
,SOLID
,DOT_DASH
,DOTTED
], default:SOLID
) โ A SymbolicConstant specifying the line style of the arrow. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.lineThickness (
Literal
[THIN
,THICK
,VERY_THIN
,MEDIUM
], default:VERY_THIN
) โ A SymbolicConstant specifying the line thickness of the arrow. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is VERY_THIN.
- Returns:
An Arrow object.
- Return type:
- AnimationUserData.Text(name, text='', offset=(), anchor=abaqusConstants.BOTTOM_LEFT, referencePoint=abaqusConstants.BOTTOM_LEFT, rotationAngle=0, color='White', font='-*-verdana-medium-r-normal--120-*', backgroundStyle=abaqusConstants.TRANSPARENT, backgroundColor='', box=0, justification=abaqusConstants.JUSTIFY_LEFT)[source]
This method creates a Text object.
Note
This function can be accessed by:
mdb.Text session.odbs[name].userData.Text
Note
Check Text on help.3ds.com/2023.
- Parameters:
name (
str
) โ A String specifying the annotation repository key.text (
str
, default:''
) โ A String specifying the text of the Text object. The default value is an empty string.offset (
Sequence
[float
], default:()
) โ A pair of Floats specifying the X and Y offsets in millimeters of the Text object from anchor. The default value is (0, 0).anchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant specifies a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
referencePoint (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. The sequence of two Floats specifies the X and Y coordinates of the reference point of the Text annotation given as percentages of its width and height. The SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
rotationAngle (
float
, default:0
) โ A Float specifying the amount of rotation in degrees about referencePoint. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the Text object. Possible string values are any valid color. The default value is โWhiteโ.font (
str
, default:'-*-verdana-medium-r-normal--120-*'
) โ A String specifying the font of the Text object. Possible string values are any valid font specification. The default value is โ--verdana-medium-r-normalโ120-โ.backgroundStyle (
Literal
[OTHER
,MATCH
,TRANSPARENT
], default:TRANSPARENT
) โ A SymbolicConstant specifying the Text object background style. Possible values are MATCH, TRANSPARENT, and OTHER. The default value is TRANSPARENT.backgroundColor (
str
, default:''
) โ A String specifying the color of the Text object background. Possible string values are any valid color. The default value matches the viewport background.box (
Union
[AbaqusBoolean
,bool
], default:0
) โ A Boolean specifying whether the box around the text is shown. The default value is OFF.justification (
Literal
[JUSTIFY_CENTER
,JUSTIFY_LEFT
,JUSTIFY_RIGHT
], default:JUSTIFY_LEFT
) โ A SymbolicConstant specifying the Text object justification for multiline text. Possible values are JUSTIFY_LEFT, JUSTIFY_CENTER, and JUSTIFY_RIGHT. The default value is JUSTIFY_LEFT.
- Returns:
A Text object.
- Return type:
- AnimationUserData.XYData(name, data, sourceDescription='', contentDescription='', positionDescription='', legendLabel='', xValuesLabel='', yValuesLabel='', axis1QuantityType=None, axis2QuantityType=None)[source]
This method creates an XYData object from a sequence of X - Y data pairs.
Note
This function can be accessed by:
session.odbs[name].userData.XYData
Note
Check XYData on help.3ds.com/2023.
- Parameters:
name (
str
) โ A String specifying the repository key.data (
tuple
) โ A sequence of pairs of Floats specifying the X - Y data pairs.sourceDescription (
str
, default:''
) โ A String specifying the source of the X - Y data (e.g., โEntered from keyboardโ, โTaken from ASCII fileโ, โRead from an ODBโ, etc.). The default value is an empty string.contentDescription (
str
, default:''
) โ A String specifying the content of the X - Y data (e.g., โfield 1 vs. field 2โ). The default value is an empty string.positionDescription (
str
, default:''
) โ A String specifying additional information about the X - Y data (e.g., โfor whole modelโ). The default value is an empty string.legendLabel (
str
, default:''
) โ A String specifying the label to be used in the legend. The default value is the name of the XYData object.xValuesLabel (
str
, default:''
) โ A String specifying the label for the X-values. This value may be overridden if the X - Y data are combined with other X - Y data. The default value is an empty string.yValuesLabel (
str
, default:''
) โ A String specifying the label for the Y-values. This value may be overridden if the X - Y data are combined with other X - Y data. The default value is an empty string.axis1QuantityType (
Optional
[QuantityType
], default:None
) โ A QuantityType object specifying the QuantityType object associated to the X -axis1- values.axis2QuantityType (
Optional
[QuantityType
], default:None
) โ A QuantityType object specifying the QuantityType object associated to the Y -axis2- values.
- Returns:
An XYData object.
- Return type:
XYData
Other Classes๏
- class AnimationUserData[source]๏
Bases:
UserDataBase
Member Details:
- Arrow(name, startPoint=(0.0, 0.0), endPoint=(0.0, 0.0), startAnchor=abaqusConstants.BOTTOM_LEFT, endAnchor=abaqusConstants.BOTTOM_LEFT, startHeadStyle=abaqusConstants.NONE, endHeadStyle=abaqusConstants.FILLED_ARROW, startGap=0.0, endGap=0.0, color='White', lineStyle=abaqusConstants.SOLID, lineThickness=abaqusConstants.VERY_THIN)[source]๏
This method creates an Arrow object.
Note
This function can be accessed by:
mdb.Arrow session.odbs[name].userData.Arrow
Note
Check Arrow on help.3ds.com/2023.
- Parameters:
name (
str
) โ A String specifying the annotation repository key.startPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the start point X and Y offsets in millimeters from startAnchor. The default value is (0, 0).endPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the end point X and Y offsets in millimeters from endAnchor. The default value is (0, 0).startAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT,,
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
endAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
startHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:NONE
) โA SymbolicConstant specifying the style of the start head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is NONE.
endHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:FILLED_ARROW
) โA SymbolicConstant specifying the style of the end head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is FILLED_ARROW.
startGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow start point and the arrow start head. The default value is 0.0.endGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow end point and the arrow end head. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the arrow. Possible string values are any valid color. The default value is โWhiteโ.lineStyle (
Literal
[DASHED
,SOLID
,DOT_DASH
,DOTTED
], default:SOLID
) โ A SymbolicConstant specifying the line style of the arrow. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.lineThickness (
Literal
[THIN
,THICK
,VERY_THIN
,MEDIUM
], default:VERY_THIN
) โ A SymbolicConstant specifying the line thickness of the arrow. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is VERY_THIN.
- Returns:
An Arrow object.
- Return type:
- Text(name, text='', offset=(), anchor=abaqusConstants.BOTTOM_LEFT, referencePoint=abaqusConstants.BOTTOM_LEFT, rotationAngle=0, color='White', font='-*-verdana-medium-r-normal--120-*', backgroundStyle=abaqusConstants.TRANSPARENT, backgroundColor='', box=0, justification=abaqusConstants.JUSTIFY_LEFT)[source]๏
This method creates a Text object.
Note
This function can be accessed by:
mdb.Text session.odbs[name].userData.Text
Note
Check Text on help.3ds.com/2023.
- Parameters:
name (
str
) โ A String specifying the annotation repository key.text (
str
, default:''
) โ A String specifying the text of the Text object. The default value is an empty string.offset (
Sequence
[float
], default:()
) โ A pair of Floats specifying the X and Y offsets in millimeters of the Text object from anchor. The default value is (0, 0).anchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant specifies a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
referencePoint (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. The sequence of two Floats specifies the X and Y coordinates of the reference point of the Text annotation given as percentages of its width and height. The SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
rotationAngle (
float
, default:0
) โ A Float specifying the amount of rotation in degrees about referencePoint. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the Text object. Possible string values are any valid color. The default value is โWhiteโ.font (
str
, default:'-*-verdana-medium-r-normal--120-*'
) โ A String specifying the font of the Text object. Possible string values are any valid font specification. The default value is โ--verdana-medium-r-normalโ120-โ.backgroundStyle (
Literal
[OTHER
,MATCH
,TRANSPARENT
], default:TRANSPARENT
) โ A SymbolicConstant specifying the Text object background style. Possible values are MATCH, TRANSPARENT, and OTHER. The default value is TRANSPARENT.backgroundColor (
str
, default:''
) โ A String specifying the color of the Text object background. Possible string values are any valid color. The default value matches the viewport background.box (
Union
[AbaqusBoolean
,bool
], default:0
) โ A Boolean specifying whether the box around the text is shown. The default value is OFF.justification (
Literal
[JUSTIFY_CENTER
,JUSTIFY_LEFT
,JUSTIFY_RIGHT
], default:JUSTIFY_LEFT
) โ A SymbolicConstant specifying the Text object justification for multiline text. Possible values are JUSTIFY_LEFT, JUSTIFY_CENTER, and JUSTIFY_RIGHT. The default value is JUSTIFY_LEFT.
- Returns:
A Text object.
- Return type:
- class Arrow(name, startPoint=(0.0, 0.0), endPoint=(0.0, 0.0), startAnchor=abaqusConstants.BOTTOM_LEFT, endAnchor=abaqusConstants.BOTTOM_LEFT, startHeadStyle=abaqusConstants.NONE, endHeadStyle=abaqusConstants.FILLED_ARROW, startGap=0.0, endGap=0.0, color='White', lineStyle=abaqusConstants.SOLID, lineThickness=abaqusConstants.VERY_THIN)[source]๏
Bases:
Annotation
,_OptionsBase
The Arrow object stores the visual settings and location of an arrow annotation. The Arrow object is derived from the Annotation object.
Note
This object can be accessed by:
import annotationToolset mdb.annotations[name] session.odbs[name].userData.annotations[name] session.viewports[name].annotationsToPlot[i]
Note
Check Arrow on help.3ds.com/2023.
This method creates an Arrow object.
Note
This function can be accessed by:
mdb.Arrow session.odbs[name].userData.Arrow
- Parameters:
name (
str
) โ A String specifying the annotation repository key.startPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the start point X and Y offsets in millimeters from startAnchor. The default value is (0, 0).endPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the end point X and Y offsets in millimeters from endAnchor. The default value is (0, 0).startAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
endAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
startHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:NONE
) โA SymbolicConstant specifying the style of the start head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is NONE.
endHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:FILLED_ARROW
) โA SymbolicConstant specifying the style of the end head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is FILLED_ARROW.
startGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow start point and the arrow start head. The default value is 0.0.endGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow end point and the arrow end head. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the arrow. Possible string values are any valid color. The default value is โWhiteโ.lineStyle (
Literal
[DASHED
,SOLID
,DOT_DASH
,DOTTED
], default:SOLID
) โ A SymbolicConstant specifying the line style of the arrow. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.lineThickness (
Literal
[THIN
,THICK
,VERY_THIN
,MEDIUM
], default:VERY_THIN
) โ A SymbolicConstant specifying the line thickness of the arrow. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is VERY_THIN.
- Returns:
An Arrow object.
- Return type:
Member Details:
-
color:
str
= 'White'[source]๏ A String specifying the color of the arrow. Possible string values are any valid color. The default value is โWhiteโ.
-
endAnchor:
Union
[SymbolicConstant
,float
] = 'BOTTOM_LEFT'[source]๏ A SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
-
endGap:
float
= 0.0[source]๏ A Float specifying the distance in millimeters between the arrow end point and the arrow end head. The default value is 0.0.
-
endHeadStyle:
SymbolicConstant
= 'FILLED_ARROW'[source]๏ A SymbolicConstant specifying the style of the end head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is FILLED_ARROW.
-
endPoint:
Sequence
[float
] = (0.0, 0.0)[source]๏ A pair of Floats specifying the end point X and Y offsets in millimeters from endAnchor. The default value is (0, 0).
-
lineStyle:
SymbolicConstant
= 'SOLID'[source]๏ A SymbolicConstant specifying the line style of the arrow. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.
-
lineThickness:
SymbolicConstant
= 'VERY_THIN'[source]๏ A SymbolicConstant specifying the line thickness of the arrow. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is VERY_THIN.
- setValues(startPoint=(0.0, 0.0), endPoint=(0.0, 0.0), startAnchor=abaqusConstants.BOTTOM_LEFT, endAnchor=abaqusConstants.BOTTOM_LEFT, startHeadStyle=abaqusConstants.NONE, endHeadStyle=abaqusConstants.FILLED_ARROW, startGap=0.0, endGap=0.0, color='White', lineStyle=abaqusConstants.SOLID, lineThickness=abaqusConstants.VERY_THIN)[source]๏
This method modifies the Arrow object.
Note
- Parameters:
startPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the start point X and Y offsets in millimeters from startAnchor. The default value is (0, 0).endPoint (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the end point X and Y offsets in millimeters from endAnchor. The default value is (0, 0).startAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
endAnchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
startHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:NONE
) โA SymbolicConstant specifying the style of the start head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is NONE.
endHeadStyle (
Literal
[FILLED_DIAMOND
,FILLED_SQUARE
,HOLLOW_CIRCLE
,HOLLOW_SQUARE
,FILLED_ARROW
,HOLLOW_DIAMOND
,ARROW
,NONE
,FILLED_CIRCLE
], default:FILLED_ARROW
) โA SymbolicConstant specifying the style of the end head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is FILLED_ARROW.
startGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow start point and the arrow start head. The default value is 0.0.endGap (
float
, default:0.0
) โ A Float specifying the distance in millimeters between the arrow end point and the arrow end head. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the arrow. Possible string values are any valid color. The default value is โWhiteโ.lineStyle (
Literal
[DASHED
,SOLID
,DOT_DASH
,DOTTED
], default:SOLID
) โ A SymbolicConstant specifying the line style of the arrow. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.lineThickness (
Literal
[THIN
,THICK
,VERY_THIN
,MEDIUM
], default:VERY_THIN
) โ A SymbolicConstant specifying the line thickness of the arrow. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is VERY_THIN.
-
startAnchor:
Union
[SymbolicConstant
,float
] = 'BOTTOM_LEFT'[source]๏ A SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
-
startGap:
float
= 0.0[source]๏ A Float specifying the distance in millimeters between the arrow start point and the arrow start head. The default value is 0.0.
-
startHeadStyle:
SymbolicConstant
= 'NONE'[source]๏ A SymbolicConstant specifying the style of the start head. Possible values are:
ARROW
FILLED_ARROW
HOLLOW_CIRCLE
FILLED_CIRCLE
HOLLOW_DIAMOND
FILLED_DIAMOND
HOLLOW_SQUARE
FILLED_SQUARE
NONE
The default value is NONE.
-
startPoint:
Sequence
[float
] = (0.0, 0.0)[source]๏ A pair of Floats specifying the start point X and Y offsets in millimeters from startAnchor. The default value is (0, 0).
- translateEndPoint(x=None, y=None)[source]๏
This method translates the end point of the Arrow object on the viewport plane.
Note
- class Text(name, text='', offset=(0.0, 0.0), anchor=abaqusConstants.BOTTOM_LEFT, referencePoint=abaqusConstants.BOTTOM_LEFT, rotationAngle=0.0, color='White', font='-*-verdana-medium-r-normal--120-*', backgroundStyle=abaqusConstants.TRANSPARENT, backgroundColor='', box=0, justification=abaqusConstants.JUSTIFY_LEFT)[source]๏
Bases:
Annotation
,_OptionsBase
The Text object stores the text settings and location of a text annotation. The Text object is derived from the Annotation object.
Note
This object can be accessed by:
import annotationToolset mdb.annotations[name] session.odbs[name].userData.annotations[name] session.viewports[name].annotationsToPlot[i]
Note
Check Text on help.3ds.com/2023.
This method creates a Text object.
Note
This function can be accessed by:
mdb.Text session.odbs[name].userData.Text
- Parameters:
name (
str
) โ A String specifying the annotation repository key.text (
str
, default:''
) โ A String specifying the text of the Text object. The default value is an empty string.offset (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the X and Y offsets in millimeters of the Text object from anchor. The default value is (0, 0).anchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant specifies a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
referencePoint (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. The sequence of two Floats specifies the X and Y coordinates of the reference point of the Text annotation given as percentages of its width and height. The SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
rotationAngle (
float
, default:0.0
) โ A Float specifying the amount of rotation in degrees about referencePoint. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the Text object. Possible string values are any valid color. The default value is โWhiteโ.font (
str
, default:'-*-verdana-medium-r-normal--120-*'
) โ A String specifying the font of the Text object. Possible string values are any valid font specification. The default value is โ--verdana-medium-r-normalโ120-โ.backgroundStyle (
Literal
[OTHER
,MATCH
,TRANSPARENT
], default:TRANSPARENT
) โ A SymbolicConstant specifying the Text object background style. Possible values are MATCH, TRANSPARENT, and OTHER. The default value is TRANSPARENT.backgroundColor (
str
, default:''
) โ A String specifying the color of the Text object background. Possible string values are any valid color. The default value matches the viewport background.box (
Union
[AbaqusBoolean
,bool
], default:0
) โ A Boolean specifying whether the box around the text is shown. The default value is OFF.justification (
Literal
[JUSTIFY_CENTER
,JUSTIFY_LEFT
,JUSTIFY_RIGHT
], default:JUSTIFY_LEFT
) โ A SymbolicConstant specifying the Text object justification for multiline text. Possible values are JUSTIFY_LEFT, JUSTIFY_CENTER, and JUSTIFY_RIGHT. The default value is JUSTIFY_LEFT.
- Returns:
A Text object.
- Return type:
Member Details:
-
anchor:
Union
[SymbolicConstant
,float
] = 'BOTTOM_LEFT'[source]๏ A SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant specifies a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
-
backgroundColor:
str
= ''[source]๏ A String specifying the color of the Text object background. Possible string values are any valid color. The default value matches the viewport background.
-
backgroundStyle:
SymbolicConstant
= 'TRANSPARENT'[source]๏ A SymbolicConstant specifying the Text object background style. Possible values are MATCH, TRANSPARENT, and OTHER. The default value is TRANSPARENT.
-
box:
Union
[AbaqusBoolean
,bool
] = 0[source]๏ A Boolean specifying whether the box around the text is shown. The default value is OFF.
-
color:
str
= 'White'[source]๏ A String specifying the color of the Text object. Possible string values are any valid color. The default value is โWhiteโ.
-
font:
str
= '-*-verdana-medium-r-normal--120-*'[source]๏ A String specifying the font of the Text object. Possible string values are any valid font specification. The default value is โ--verdana-medium-r-normalโ120-โ.
-
height:
Optional
[float
] = None[source]๏ A Float specifying the height in millimeters of the Text object.
-
justification:
SymbolicConstant
= 'JUSTIFY_LEFT'[source]๏ A SymbolicConstant specifying the Text object justification for multiline text. Possible values are JUSTIFY_LEFT, JUSTIFY_CENTER, and JUSTIFY_RIGHT. The default value is JUSTIFY_LEFT.
-
offset:
Sequence
[float
] = (0.0, 0.0)[source]๏ A pair of Floats specifying the X and Y offsets in millimeters of the Text object from anchor. The default value is (0, 0).
-
referencePoint:
Union
[SymbolicConstant
,float
] = 'BOTTOM_LEFT'[source]๏ A SymbolicConstant or a sequence of Floats specifying a point. The sequence of two Floats specifies the X and Y coordinates of the reference point of the Text annotation given as percentages of its width and height. The SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
-
rotationAngle:
float
= 0.0[source]๏ A Float specifying the amount of rotation in degrees about referencePoint. The default value is 0.0.
- setValues(text='', offset=(0.0, 0.0), anchor=abaqusConstants.BOTTOM_LEFT, referencePoint=abaqusConstants.BOTTOM_LEFT, rotationAngle=0.0, color='White', font='-*-verdana-medium-r-normal--120-*', backgroundStyle=abaqusConstants.TRANSPARENT, backgroundColor='', box=0, justification=abaqusConstants.JUSTIFY_LEFT)[source]๏
This method modifies the Text object.
Note
- Parameters:
text (
str
, default:''
) โ A String specifying the text of the Text object. The default value is an empty string.offset (
Sequence
[float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the X and Y offsets in millimeters of the Text object from anchor. The default value is (0, 0).anchor (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. A sequence of two Floats specifies the X and Y coordinates as percentages of the viewport width and height. A Sequence of three Floats specifies the X, Y, and Z coordinates of a point in the model coordinate system. A SymbolicConstant specifies a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
referencePoint (
Union
[Literal
[CENTER_RIGHT
,TOP_CENTER
,BOTTOM_RIGHT
,BOTTOM_LEFT
,CENTER
,TOP_RIGHT
,CENTER_LEFT
,TOP_LEFT
,BOTTOM_CENTER
],float
], default:BOTTOM_LEFT
) โA SymbolicConstant or a sequence of Floats specifying a point. The sequence of two Floats specifies the X and Y coordinates of the reference point of the Text annotation given as percentages of its width and height. The SymbolicConstant indicates a relative position. Possible values are:
BOTTOM_LEFT
BOTTOM_CENTER
BOTTOM_RIGHT
CENTER_LEFT
CENTER
CENTER_RIGHT
TOP_LEFT
TOP_CENTER
TOP_RIGHT
The default value is BOTTOM_LEFT.
rotationAngle (
float
, default:0.0
) โ A Float specifying the amount of rotation in degrees about referencePoint. The default value is 0.0.color (
str
, default:'White'
) โ A String specifying the color of the Text object. Possible string values are any valid color. The default value is โWhiteโ.font (
str
, default:'-*-verdana-medium-r-normal--120-*'
) โ A String specifying the font of the Text object. Possible string values are any valid font specification. The default value is โ--verdana-medium-r-normalโ120-โ.backgroundStyle (
Literal
[OTHER
,MATCH
,TRANSPARENT
], default:TRANSPARENT
) โ A SymbolicConstant specifying the Text object background style. Possible values are MATCH, TRANSPARENT, and OTHER. The default value is TRANSPARENT.backgroundColor (
str
, default:''
) โ A String specifying the color of the Text object background. Possible string values are any valid color. The default value matches the viewport background.box (
Union
[AbaqusBoolean
,bool
], default:0
) โ A Boolean specifying whether the box around the text is shown. The default value is OFF.justification (
Literal
[JUSTIFY_CENTER
,JUSTIFY_LEFT
,JUSTIFY_RIGHT
], default:JUSTIFY_LEFT
) โ A SymbolicConstant specifying the Text object justification for multiline text. Possible values are JUSTIFY_LEFT, JUSTIFY_CENTER, and JUSTIFY_RIGHT. The default value is JUSTIFY_LEFT.
- class Annotation[source]๏
Bases:
object
The Annotation object is the abstract base type for other Annotation objects. The Annotation object has no explicit constructor. The methods and members of the Annotation object are common to all objects derived from Annotation.
Note
This object can be accessed by:
import annotationToolset mdb.annotations[name] session.odbs[name].userData.annotations[name] session.viewports[name].annotationsToPlot[i]
Note
Member Details:
- bringForward()[source]๏
This method brings the Annotation object one position up in the annotation stack.
- bringToFront()[source]๏
This method brings the Annotation object to the top of the annotation stack.
- moveAfter(name)[source]๏
This method moves the Annotation object after another object in the same repository.
Note
- Parameters:
name (
str
) โ A String specifying the name of the other Annotation object.
- moveBefore(name)[source]๏
This method moves the Annotation object before another object in the same repository.
Note
- Parameters:
name (
str
) โ A String specifying the name of the other Annotation object.
- sendBackward()[source]๏
This method sends the Annotation object one position down in the annotation stack.
- sendToBack()[source]๏
This method sends the Annotation object to the bottom of the annotation stack.
- class AnnotationViewport(name, origin=(0.0, 0.0), width=120.0, height=80.0, border=1, titleBar=1, titleStyle=abaqusConstants.SYSTEM, customTitleString='')[source]๏
Bases:
ViewportBase
The following commands operate on Viewport objects. For more information about the Viewport object, see Viewport object.
Note
This object can be accessed by:
import annotationToolset
Note
This method creates a Viewport object with the specified origin and dimensions.
Note
This function can be accessed by:
session.Viewport
- Parameters:
name (
str
) โ A String specifying the repository key.origin (
tuple
[float
,float
], default:(0.0, 0.0)
) โ A pair of Floats specifying the X and Y coordinates in millimeters in the canvas coordinate system of the lower left corner of the viewport. The default origin is (0, 0).width (
float
, default:120.0
) โ A Float specifying the width in millimeters of the viewport. Possible values are 30 โค width โค (maxWidth). The default value is 120.0. Note: The maximum value of width (maxWidth) is the width of the screen in millimeters.height (
float
, default:80.0
) โ A Float specifying the height in millimeters of the viewport. This height includes the title bar. Possible values are 30 โค height โค (maxHeight). The default value is 80.0. Note: The maximum value of height (maxHeight) is the height of the screen in millimeters.border (
Union
[AbaqusBoolean
,bool
], default:1
) โ A Boolean specifying whether the viewport border is visible in a printed image. The default value is ON.titleBar (
Union
[AbaqusBoolean
,bool
], default:1
) โ A Boolean specifying whether the viewport title should be displayed in a printed image. The default value is ON.If border = OFF, the title will not be visible, even if titleBar =ON.titleStyle (
Literal
[CUSTOM
,SYSTEM
], default:SYSTEM
) โ A SymbolicConstant specifying which title to use for the viewport title. Possible values are CUSTOM and SYSTEM. The default value is SYSTEM.If titleStyle = CUSTOM, customTitleString will be used. If titleStyle = SYSTEM, a system-generated string will be used.customTitleString (
str
, default:''
) โ A String specifying the viewport title when titleStyle =CUSTOM. The default value is an empty string.
- Returns:
A Viewport object.
- Return type:
Viewport
- Raises:
SystemError โ the current viewport may not be deleted, If the user attempts to delete the only viewport.
RangeError โ If width is out of range.
RangeError โ If height is out of range.
Member Details:
- plotAnnotation(annotation, index=0)[source]๏
This method plots an Annotation object in aViewport.
- Parameters:
annotation (
Annotation
) โ An Annotation object to plot.index (
int
, default:0
) โ An Int specifying the index of the Annotation object in the sequence of annotations to plot. The default value is zero.
- class AnnotationsToPlotArray[source]๏
Bases:
List
[Annotation
]The AnnotationsToPlotArray object is a sequence that stores references to plotted annotations. By adding annotations to and removing annotations from this sequence, you can control which annotations are displayed in a particular viewport.
Note
This object can be accessed by:
import annotationToolset session.viewports[name].annotationsToPlot
Note
Member Details:
- bringForward(index)[source]๏
This method brings the Annotation object one position forward in the AnnotationsToPlotArray sequence.
- Parameters:
index (
str
) โ An Int specifying the index of the Annotation object in the AnnotationsToPlotArray sequence.
- bringToFront(index)[source]๏
This method brings the Annotation object to the beginning of the AnnotationsToPlotArray sequence.
- Parameters:
index (
str
) โ An Int specifying the index of the Annotation object in the AnnotationsToPlotArray sequence.
- moveAfter(index, other)[source]๏
This method moves the Annotation object after another object in the same AnnotationsToPlotArray sequence.
- moveBefore(index, other)[source]๏
This method moves the Annotation object before another object in the same AnnotationsToPlotArray sequence.