Basic Geometry

The basic geometry commands create geometric entities that are referenced by Part objects, Instance objects, and GeometrySet objects.

Other Classes

class BasicGeometryPart(
name: str,
dimensionality: SymbolicConstant,
type: SymbolicConstant,
twist: AbaqusBoolean | bool = OFF,
)[源代码]
class BasicGeometryPart(
name: str,
objectToCopy: str,
scale: float = 1,
mirrorPlane: SymbolicConstant = NONE,
compressFeatureList: AbaqusBoolean | bool = OFF,
separate: AbaqusBoolean | bool = OFF,
)

基类:PartBase

Member Details:

InterestingPoint(edge, rule)[源代码]

This method creates an interesting point along an edge. An InterestingPoint is a temporary object.

备注

This function can be accessed by:

mdb.models[name].parts[name].InterestingPoint
mdb.models[name].rootAssembly.instances[name].InterestingPoint
参数:
edge

An Edge object specifying the edge on which the interesting point is positioned.

rule

A SymbolicConstant specifying the position of the interesting point. Possible values are MIDDLE or CENTER.

返回:

An InterestingPoint object.

返回类型:

InterestingPoint

class Edge[源代码]

基类:object

Edges are one-dimensional regions of geometry.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].edges[i]
mdb.models[name].parts[name].allInternalSurfaces[name].edges[i]
mdb.models[name].parts[name].allSets[name].edges[i]
mdb.models[name].parts[name].allSurfaces[name].edges[i]
mdb.models[name].parts[name].edges[i]
mdb.models[name].parts[name].sets[name].edges[i]
mdb.models[name].parts[name].surfaces[name].edges[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].edges[i]
mdb.models[name].rootAssembly.allInstances[name].sets[name].edges[i]
mdb.models[name].rootAssembly.allInstances[name].surfaces[name].edges[i]
mdb.models[name].rootAssembly.allInternalSets[name].edges[i]
mdb.models[name].rootAssembly.allInternalSurfaces[name].edges[i]
mdb.models[name].rootAssembly.allSets[name].edges[i]
mdb.models[name].rootAssembly.allSurfaces[name].edges[i]
mdb.models[name].rootAssembly.edges[i]
mdb.models[name].rootAssembly.instances[name].edges[i]
mdb.models[name].rootAssembly.instances[name].sets[name].edges[i]
mdb.models[name].rootAssembly.instances[name].surfaces[name].edges[i]
mdb.models[name].rootAssembly.modelInstances[i].edges[i]
mdb.models[name].rootAssembly.modelInstances[i].sets[name].edges[i]
mdb.models[name].rootAssembly.modelInstances[i].surfaces[name].edges[i]
mdb.models[name].rootAssembly.sets[name].edges[i]
mdb.models[name].rootAssembly.surfaces[name].edges[i]

Member Details:

featureName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the feature that created this edge.

getAdjacentEdges()[源代码]

This method returns an array of Edge objects that share at least one vertex of the edge.

返回:

An EdgeArray object, which is a sequence of Edge objects.

返回类型:

EdgeArray

getCurvature(parameter, point)[源代码]

This method returns curvature information at a location on the edge.

参数:
parameter

A Float specifying the normalized parameter location on the edge where the curvature is to be computed. This argument is mutually exclusive with the argument point.

point

A tuple of X, Y, and Z coordinates of a point at which the curvature is to be computed. If point does not lie on the edge an attempt is made to project it onto the edge and use the projected point.

返回:

A dictionary with keys 'evaluationPoint', 'curvature', 'radius', and 'tangent', where 'evaluationPoint' specifies the location at which the curvature was computed; 'curvature' specifies the curvature vector at that location; 'radius' is the radius of curvature; and 'tangent' specifies the tangent to the edge at that location.

返回类型:

dict

抛出:

The given edge is straight --

getEdgesByEdgeAngle(angle)[源代码]

This method returns an array of Edge objects that are obtained by recursively finding adjacent edges that are at an angle of less than or equal to the specified face angle.

参数:
angle

A float specifying the value of the face angle in degrees.

返回:

An EdgeArray object, which is a sequence of Edgeobjects.

返回类型:

EdgeArray

getElements()[源代码]

This method returns an array of element objects that are associated with the edge.

返回:

A MeshElementArray object which is a sequence of MeshElement objects.

返回类型:

MeshElementArray

getFaces()[源代码]

This method returns a sequence consisting of the face ids of the faces which share this edge.

返回:

A tuple of integers.

返回类型:

tuple[int]

getNodes()[源代码]

This method returns an array of node objects that are associated with the edge.

返回:

A MeshNodeArray object, which is a sequence of MeshNode objects.

返回类型:

MeshNodeArray

getRadius()[源代码]

This method returns the radius of circular edges.

返回:

A Float specifying the radius.

返回类型:

float

抛出:

The given edges is not circular --

getSize(printResults=True)[源代码]

This method returns a Float indicating the length of the edge.

参数:
printResults=True

A Bool specifying whether verbose output is printed. The default is True.

返回:

A Float.

返回类型:

float

getVertices()[源代码]

This method returns a sequence of indices of the vertices that bound this edge. The first index refers to the vertex where the normalized curve parameter = 0.0, and the second index refers to the vertex where the normalized curve parameter = 1.0. If the edge is a closed curve, only one vertex index is returned.

返回:

A tuple of integers.

返回类型:

tuple[int]

index : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]

An Int specifying the index of the edge in the EdgeArray.

instanceName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the part instance for this edge (if applicable).

isReferenceRep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]

A Boolean specifying whether the edge belongs to the reference representation of the Part or Instance.

isTangentFlipped()[源代码]

This method determines whether the tangent to the edge is flipped from its default direction by the use of the flipTangent method on a Part object.

返回:

A Boolean value of True if the tangent is flipped and False if not.

返回类型:

Boolean

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the X, Y, and Z coordinates of a point located on the edge.

class InterestingPoint(edge, rule)[源代码]

基类:object

Interesting points can be located at the following:

  • The middle of an edge.

  • The middle of an arc.

  • The center of an arc.

An InterestingPoint object is a temporary object and cannot be accessed from the Mdb object.

备注

This object can be accessed by:

import part
import assembly

Member Details:

class Cell[源代码]

基类:object

Cells are volumetric regions of geometry.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].cells[i]
mdb.models[name].parts[name].allSets[name].cells[i]
mdb.models[name].parts[name].cells[i]
mdb.models[name].parts[name].sets[name].cells[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].cells[i]
mdb.models[name].rootAssembly.allInstances[name].sets[name].cells[i]
mdb.models[name].rootAssembly.allInternalSets[name].cells[i]
mdb.models[name].rootAssembly.allSets[name].cells[i]
mdb.models[name].rootAssembly.instances[name].cells[i]
mdb.models[name].rootAssembly.instances[name].sets[name].cells[i]
mdb.models[name].rootAssembly.modelInstances[i].sets[name].cells[i]
mdb.models[name].rootAssembly.sets[name].cells[i]

Member Details:

featureName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the feature that created this cell.

getAdjacentCells()[源代码]

This method returns an array of cell objects that share at least one face of the cell.

返回:

A CellArray object which is a sequence of Cell objects.

返回类型:

CellArray

getEdges()[源代码]

This method returns a sequence consisting of the edge IDs of the edges on the cell.

返回:

A tuple of integers.

返回类型:

Sequence[int]

getElements()[源代码]

This method returns an array of element objects that are associated with the cell.

返回:

A MeshElementArray object which is a sequence of MeshElement objects.

返回类型:

MeshElementArray

getFaces()[源代码]

This method returns a sequence consisting of the face IDs of the faces which bound the cell.

返回:

A tuple of integers.

返回类型:

Sequence[int]

getNodes()[源代码]

This method returns an array of node objects that are associated with the cell.

返回:

A MeshNodeArray object which is a sequence of MeshNode objects.

返回类型:

MeshNodeArray

getSize(printResults=True)[源代码]

This method returns a Float indicating the volume of the cell.

参数:
printResults=True

A Boolean that determines whether a verbose output is to be printed. The default is True.

返回:

A Float.

返回类型:

float

getVertices()[源代码]

This method returns a sequence consisting of the vertex IDs of the vertices on the cell.

返回:

A tuple of integers.

返回类型:

Sequence[int]

index : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]

An Int specifying the index of the cell in the CellArray.

instanceName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the part instance for this cell (if applicable).

isReferenceRep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]

A Boolean specifying whether the cell belongs to the reference representation of the Part or Instance.

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the X, Y, and Z coordinates of a point located on the cell.

class CellArray(cells)[源代码]

基类:List[Cell]

The CellArray is a sequence of Cell objects.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].cells
mdb.models[name].parts[name].allSets[name].cells
mdb.models[name].parts[name].cells
mdb.models[name].parts[name].sets[name].cells
import assembly
mdb.models[name].rootAssembly.allInstances[name].cells
mdb.models[name].rootAssembly.allInstances[name].sets[name].cells
mdb.models[name].rootAssembly.allInternalSets[name].cells
mdb.models[name].rootAssembly.allSets[name].cells
mdb.models[name].rootAssembly.instances[name].cells
mdb.models[name].rootAssembly.instances[name].sets[name].cells
mdb.models[name].rootAssembly.modelInstances[i].sets[name].cells
mdb.models[name].rootAssembly.sets[name].cells

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) Cell[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Cell]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Cell]
findAt(*args, **kwargs)

This method returns the object or objects in the CellArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any entity that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). The arbitrary point must not be shared by a second cell. If two cells intersect or coincide at the arbitrary point, findAt chooses the first cell that it encounters, and you should not rely on the return value being consistent. findAt will always try to find objects among all the cells in the part or assembly instance and will not restrict itself to a subset even if the CellArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find. findAt returns either a Cell object or a sequence of Cell objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the Cell object at that point.

  • If coordinates is a sequence of sequence of Floats, findAt returns a sequence of Cell objects at the given locations. The sequence of sequence of Floats must be a sequence of sequence of point and normal data, not a sequence of point data. For example:

    cells1 = myCrackedBlockInstance.cells.findAt(((5.5, -8.3, 294.2),),
                                                 ((12.1, -8.3, 287.8),),
                                                 ((14.4, -10.4, 285.5),),)
    

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

A Cell object.

返回类型:

Cell

getBoundingBox()[源代码]

This method returns a dictionary of two tuples representing minimum and maximum boundary values of the bounding box of the minimum size containing the cell sequence.

返回:

A Dictionary object with the following items:

  • low: a tuple of three floats representing the minimum X -, Y -, and Z -boundary values of the bounding box.

  • high: a tuple of three floats representing the maximum X -, Y -, and Z -boundary values of the bounding box.

返回类型:

dict[str, tuple[float, float, float]]

getByBoundingBox(xMin=0, yMin=0, zMin=0, xMax=0, yMax=0, zMax=0)[源代码]

This method returns an array of cell objects that lie within the specified bounding box.

参数:
xMin=0

A float specifying the minimum X boundary of the bounding box.

yMin=0

A float specifying the minimum Y boundary of the bounding box.

zMin=0

A float specifying the minimum Z boundary of the bounding box.

xMax=0

A float specifying the maximum X boundary of the bounding box.

yMax=0

A float specifying the maximum Y boundary of the bounding box.

zMax=0

A float specifying the maximum Z boundary of the bounding box.

返回:

A CellArray object, which is a sequence of Cell objects.

返回类型:

CellArray

getByBoundingCylinder(center1, center2, radius)[源代码]

This method returns an array of cell objects that lie within the specified bounding cylinder.

参数:
center1

A tuple of the X, Y, and Z coordinates of the center of the first end of the cylinder.

center2

A tuple of the X, Y, and Z coordinates of the center of the second end of the cylinder.

radius

A float specifying the radius of the cylinder.

返回:

A CellArray object, which is a sequence of Cell objects.

返回类型:

CellArray

getByBoundingSphere(center, radius)[源代码]

This method returns an array of cell objects that lie within the specified bounding sphere.

参数:
center

A tuple of the X, Y, and Z coordinates of the center of the sphere.

radius

A float specifying the radius of the sphere.

返回:

A CellArray object, which is a sequence of Cell objects.

返回类型:

CellArray

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(mask)[源代码]

This method returns the object or objects in the CellArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When large number of objects are involved, this method is highly efficient.

参数:
mask

A String specifying the object or objects.

返回:

A Cell object or a sequence of Cell objects.

返回类型:

Cell

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

class EdgeArray(edges)[源代码]

基类:List[Edge]

The EdgeArray is a sequence of Edge objects. If the part is modified, then EdgeArray must be updated for that part.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].edges
mdb.models[name].parts[name].allInternalSurfaces[name].edges
mdb.models[name].parts[name].allSets[name].edges
mdb.models[name].parts[name].allSurfaces[name].edges
mdb.models[name].parts[name].edges
mdb.models[name].parts[name].sets[name].edges
mdb.models[name].parts[name].surfaces[name].edges
import assembly
mdb.models[name].rootAssembly.allInstances[name].edges
mdb.models[name].rootAssembly.allInstances[name].sets[name].edges
mdb.models[name].rootAssembly.allInstances[name].surfaces[name].edges
mdb.models[name].rootAssembly.allInternalSets[name].edges
mdb.models[name].rootAssembly.allInternalSurfaces[name].edges
mdb.models[name].rootAssembly.allSets[name].edges
mdb.models[name].rootAssembly.allSurfaces[name].edges
mdb.models[name].rootAssembly.edges
mdb.models[name].rootAssembly.instances[name].edges
mdb.models[name].rootAssembly.instances[name].sets[name].edges
mdb.models[name].rootAssembly.instances[name].surfaces[name].edges
mdb.models[name].rootAssembly.modelInstances[i].edges
mdb.models[name].rootAssembly.modelInstances[i].sets[name].edges
mdb.models[name].rootAssembly.modelInstances[i].surfaces[name].edges
mdb.models[name].rootAssembly.sets[name].edges
mdb.models[name].rootAssembly.surfaces[name].edges

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) Edge[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Edge]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Edge]
findAt(*args, **kwargs)

This method returns the object or objects in the EdgeArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any edge that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). The arbitrary point must not be shared by a second edge. If two edges intersect or coincide at the arbitrary point, findAt chooses the first edge that it encounters, and you should not rely on the return value being consistent. findAt will always try to find objects among all the edges in the part or assembly instance and will not restrict itself to a subset even if the EdgeArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find. findAt returns either an Edge object or a sequence of Edge objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the Edge object at that point.

  • If you omit the coordinates keyword argument, findAt accepts as arguments a sequence of sequence of floats in the following format:

    edges = e.findAt(((20.19686, -169.513997, 27.798593), ),
                     ((19.657627, -167.295749, 27.056402), ),
                     ((18.274129, -157.144741, 25.15218), ))
    

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

An Edge object or a sequence of Edge objects.

返回类型:

Edge

getBoundingBox()[源代码]

This method returns a dictionary of two tuples representing minimum and maximum boundary values of the bounding box of the minimum size containing the edge sequence.

返回:

A Dictionary object with the following items:

  • low: a tuple of three floats representing the minimum X -, Y -, and Z -boundary values of the bounding box.

  • high: a tuple of three floats representing the maximum X -, Y -, and Z -boundary values of the bounding box.

返回类型:

dict[str, tuple[float, float, float]]

getByBoundingBox(xMin=0, yMin=0, zMin=0, xMax=0, yMax=0, zMax=0)[源代码]

This method returns an array of edge objects that lie within the specified bounding box.

参数:
xMin=0

A float specifying the minimum X boundary of the bounding box.

yMin=0

A float specifying the minimum Y boundary of the bounding box.

zMin=0

A float specifying the minimum Z boundary of the bounding box.

xMax=0

A float specifying the maximum X boundary of the bounding box.

yMax=0

A float specifying the maximum Y boundary of the bounding box.

zMax=0

A float specifying the maximum Z boundary of the bounding box.

返回:

An EdgeArray object, which is a sequence of Edge objects.

返回类型:

EdgeArray

getByBoundingCylinder(center1, center2, radius)[源代码]

This method returns an array of edge objects that lie within the specified bounding cylinder.

参数:
center1

A tuple of the X, Y, and Z coordinates of the center of the first end of the cylinder.

center2

A tuple of the X, Y, and Z coordinates of the center of the second end of the cylinder.

radius

A float specifying the radius of the cylinder.

返回:

An EdgeArray object, which is a sequence of Edge objects.

返回类型:

EdgeArray

getByBoundingSphere(center, radius)[源代码]

This method returns an array of edge objects that lie within the specified bounding sphere.

参数:
center

A tuple of the X, Y, and Z coordinates of the center of the sphere.

radius

A float specifying the radius of the sphere.

返回:

An EdgeArray object, which is a sequence of Edge objects.

返回类型:

EdgeArray

getClosest(coordinates, searchTolerance='')[源代码]

This method returns an object or objects in the EdgeArray closest to the given set of points, where the given points need not lie on the edges in the EdgeArray.

参数:
coordinates

A sequence of a sequence of floats, where each sequence of floats describes the X, Y, and Z coordinates of a point:

>>> r=e.getClosest(coordinates=((20.0, 20.0, 10.0), (-1.0, -15.0, 15), ))
>>> r.keys()
[0, 1]
>>> r[0]
(mdb.models['Model-1'].parts['Part-1'].edges[3], (15.7090625762939, 20.0, 10.0))

searchTolerance=''

A double specifying the distance within which the closest object must lie. The default value is half of the parent part/instance size.

返回:

This method returns a dictionary object. The key to the dictionary object is the position of the input point in the tuple specified in the coordinates starting at index 0. If a closest edge could be found then the value is a sequence consisting of two objects. The first object in the sequence is an Edge that is close to the input point referred to by the key. The second object in the sequence is a sequence of floats that specifies the X, Y, and Z location of the closest point on the Edge to the given point. See program listing above.

返回类型:

dict

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(mask: str) Edge[源代码]
getSequenceFromMask(
mask: Sequence[str],
) list[Edge]
getSequenceFromMask(mask)

This method returns the object or objects in the EdgeArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When a large number of objects are involved, this method is highly efficient.

参数:
mask: str
mask: Sequence[str]
mask

A String specifying the object or objects.

返回:

An Edge object or a sequence of Edge objects.

返回类型:

Edge

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

class Face[源代码]

基类:object

Faces are two-dimensional regions of geometry.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].faces[i]
mdb.models[name].parts[name].allInternalSurfaces[name].faces[i]
mdb.models[name].parts[name].allSets[name].faces[i]
mdb.models[name].parts[name].allSurfaces[name].faces[i]
mdb.models[name].parts[name].faces[i]
mdb.models[name].parts[name].sets[name].faces[i]
mdb.models[name].parts[name].surfaces[name].faces[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].faces[i]
mdb.models[name].rootAssembly.allInstances[name].sets[name].faces[i]
mdb.models[name].rootAssembly.allInstances[name].surfaces[name].faces[i]
mdb.models[name].rootAssembly.allInternalSets[name].faces[i]
mdb.models[name].rootAssembly.allInternalSurfaces[name].faces[i]
mdb.models[name].rootAssembly.allSets[name].faces[i]
mdb.models[name].rootAssembly.allSurfaces[name].faces[i]
mdb.models[name].rootAssembly.instances[name].faces[i]
mdb.models[name].rootAssembly.instances[name].sets[name].faces[i]
mdb.models[name].rootAssembly.instances[name].surfaces[name].faces[i]
mdb.models[name].rootAssembly.modelInstances[i].sets[name].faces[i]
mdb.models[name].rootAssembly.modelInstances[i].surfaces[name].faces[i]
mdb.models[name].rootAssembly.sets[name].faces[i]
mdb.models[name].rootAssembly.surfaces[name].faces[i]

Member Details:

featureName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the feature that created this face.

getAdjacentFaces()[源代码]

This method returns an array of face objects that share at least one edge of the face.

返回:

A FaceArray object which is a sequence of Face objects.

返回类型:

FaceArray

getCells()[源代码]

This method returns a sequence consisting of the cell ids of the cells to which this face belongs.

返回:

A tuple of integers.

返回类型:

Sequence[int]

getCentroid()[源代码]

This method returns the centroid of a face.

返回:

A sequence of Floats specifying the X, Y, and Z coordinates of the centroid of the face.

返回类型:

Sequence[float]

getCurvature(point, uParam, vParam)[源代码]

This method returns information about the curvature at a location on the face.

参数:
point

A tuple specifying the X, Y, and Z coordinates of the point where the curvature is desired. If the point does not lie on the face it will be projected onto the face. This argument and uParam and vParam are mutually exclusive.

uParam

A Float specifying the normalized U parameter value at which the curvature is to be computed. This value must lie between (0,1). vParam must also be specified. This argument is mutually exclusive with point.

vParam

A Float specifying the normalized V parameter value at which the curvature is to be computed. This value must lie between (0,1).

返回:

A dictionary with keys 'evaluationPoint', 'principalAxis1', 'principalAxis2', 'curvature1', 'curvature2' and 'gaussianCurvature'. Where the evaluationPoint specifies the location at which the curvature was evaluated. 'principalAxis1' and 'principalAxis2' refer to the vectors specifying the two principal axes of the face. 'curvature1' and 'curvature2' specify the curvatures along the two principal axes.

返回类型:

dict[str, float]

getEdges()[源代码]

This method returns a sequence consisting of the edge ids of the edges on the face.

返回:

  • Sequence[int]

  • A tuple of integers.

getElementFaces(faceSide=BOTH_SIDES)[源代码]

This method returns an array of mesh face objects. Each mesh face object contains the element label and the side of the element that lies on the geometric face.

参数:
faceSide=BOTH_SIDES

A symbolic constant specifying the side of the geometric face of a solid from which the element faces should be retrieved. Possible values are SIDE1, SIDE2, and BOTH_SIDES. The default value is BOTH_SIDES. For shell faces this option is ignored.

返回:

A MeshFaceArray object which is a sequence of MeshFace objects.

返回类型:

MeshFaceArray

getElements()[源代码]

This method returns an array of element objects that are associated with the face.

返回:

A MeshElementArray object which is a sequence of MeshElement objects.

返回类型:

MeshElementArray

getFacesByCurvature()[源代码]

This method returns an array of Face objects that are obtained by recursively finding adjacent faces that share the same curvature.

返回:

A FaceArray object, which is a sequence of Face objects.

返回类型:

FaceArray

getFacesByFaceAngle(angle)[源代码]

This method returns an array of Face objects that are obtained by recursively finding adjacent faces that are at an angle of less than or equal to the specified angle.

参数:
angle

A float specifying the value of the face angle.

返回:

A FaceArray object, which is a sequence of Face objects.

返回类型:

FaceArray

getNodes(faceSide=BOTH_SIDES)[源代码]

This method returns an array of mesh node objects. Each mesh node object contains the label of the node that lies on the geometric face.

参数:
faceSide=BOTH_SIDES

A symbolic constant specifying the side of the geometric face of a solid from which the nodes should be retrieved. Possible values are xo*SIDE1*, SIDE2, and BOTH_SIDES. The default value is BOTH_SIDES. For shell faces and for faces with compatible meshes on either sides this option is ignored. Otherwise, the nodes on the specified side(s) of the face are output.

返回:

A MeshNodeArray object which is a sequence of MeshNode objects.

返回类型:

MeshNodeArray

getNormal(point)[源代码]

This method returns the normal to a face at the location specified by the pointOn member. The normal at a different location on the face can be obtained by specifying the optional point argument.

参数:
point

A tuple specifying the X, Y, and Z coordinates of the point where the normal to the face is desired. If the point does not lie on the face it will be projected onto the face.

返回:

A sequence of Floats specifying the X, Y, and Z components of the normal to the face.

返回类型:

Sequence[float]

抛出:
  • An exception is raised if the optional argument point is provided but the point cannot --

  • be projected onto the face. --

getSize(printResults=True)[源代码]

This method returns a Float indicating the area of the face.

参数:
printResults=True

A Bool specifying whether verbose output is printed. The default value is True.

返回:

A Float.

返回类型:

float

getVertices()[源代码]

This method returns a sequence consisting of the vertex ids of the vertices of the face.

返回:

A tuple of integers.

返回类型:

Sequence[int]

index : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]

An Int specifying the index of the face in the FaceArray.

instanceName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the name of the part instance for this face (if applicable).

isNormalFlipped()[源代码]

This method determines whether the normal to the face is flipped from its default direction by the use of the flipNormal method on a Part object.

返回:

A Boolean value of True if the normal is flipped and False if not.

返回类型:

Boolean

isReferenceRep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]

A Boolean specifying whether the face belongs to the reference representation of the Part or Instance.

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of tuples of Floats specifying the coordinates. For a face of a shell pointOn specifies the X, Y, and Z coordinates of a point located on the face and the X, Y, and Z components of the normal to the face.For a face of a solid pointOn specifies the X, Y, and Z coordinates of a point located on the face.

class FaceArray(faces)[源代码]

基类:List[Face]

The FaceArray is a sequence of Face objects. If the part is modified, then FaceArray must be updated for that part.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].faces
mdb.models[name].parts[name].allInternalSurfaces[name].faces
mdb.models[name].parts[name].allSets[name].faces
mdb.models[name].parts[name].allSurfaces[name].faces
mdb.models[name].parts[name].faces
mdb.models[name].parts[name].sets[name].faces
mdb.models[name].parts[name].surfaces[name].faces
import assembly
mdb.models[name].rootAssembly.allInstances[name].faces
mdb.models[name].rootAssembly.allInstances[name].sets[name].faces
mdb.models[name].rootAssembly.allInstances[name].surfaces[name].faces
mdb.models[name].rootAssembly.allInternalSets[name].faces
mdb.models[name].rootAssembly.allInternalSurfaces[name].faces
mdb.models[name].rootAssembly.allSets[name].faces
mdb.models[name].rootAssembly.allSurfaces[name].faces
mdb.models[name].rootAssembly.instances[name].faces
mdb.models[name].rootAssembly.instances[name].sets[name].faces
mdb.models[name].rootAssembly.instances[name].surfaces[name].faces
mdb.models[name].rootAssembly.modelInstances[i].sets[name].faces
mdb.models[name].rootAssembly.modelInstances[i].surfaces[name].faces
mdb.models[name].rootAssembly.sets[name].faces
mdb.models[name].rootAssembly.surfaces[name].faces

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) Face[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Face]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[Face]
findAt(*args, **kwargs)

This method returns the object or objects in the FaceArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any face that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). The arbitrary point must not be shared by a second face. If two faces intersect or coincide at the arbitrary point, findAt chooses the first face that it encounters, and you should not rely on the return value being consistent. findAt will always try to find objects among all the faces in the part or assembly instance and will not restrict itself to a subset even if the FaceArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find. findAt returns either a Face object or a sequence of Face objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the Face object at that point.

  • If you omit the coordinates keyword argument, findAt accepts as arguments a sequence of pairs of sequences describing each face's coordinate and normal, and findAt returns a sequence of Face objects at the given locations. If you omit the coordinates keyword argument, you must also omit the normal argument:

    faces = f.findAt(((-16.438578, -41.835673, -24.19804), ),
                     ((25.210364, -35.689868, 1.860314), ),
                     ((26.727683, -38.207055, 4.164759), ))
    

normal

A sequence of Floats specifying the X, Y, and Z components of a vector indicating the face normal.

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

A Face object.

返回类型:

Face

getBoundingBox()[源代码]

This method returns a dictionary of two tuples representing minimum and maximum boundary values of the bounding box of the minimum size containing the face sequence.

返回:

A Dictionary object with the following items:

  • low: a tuple of three floats representing the minimum X -, Y -, and Z -boundary values of the bounding box.

  • high: a tuple of three floats representing the maximum X -, Y -, and Z -boundary values of the bounding box.

返回类型:

dict[str, Sequence[float]]

getByBoundingBox(xMin=0, yMin=0, zMin=0, xMax=0, yMax=0, zMax=0)[源代码]

This method returns an array of face objects that lie within the specified bounding box.

参数:
xMin=0

A float specifying the minimum X boundary of the bounding box.

yMin=0

A float specifying the minimum Y boundary of the bounding box.

zMin=0

A float specifying the minimum Z boundary of the bounding box.

xMax=0

A float specifying the maximum X boundary of the bounding box.

yMax=0

A float specifying the maximum Y boundary of the bounding box.

zMax=0

A float specifying the maximum Z boundary of the bounding box.

返回:

A FaceArray object, which is a sequence of Face objects.

返回类型:

FaceArray

getByBoundingCylinder(center1, center2, radius)[源代码]

This method returns an array of face objects that lie within the specified bounding cylinder.

参数:
center1

A tuple of the X, Y, and Z coordinates of the center of the first end of the cylinder.

center2

A tuple of the X, Y, and Z coordinates of the center of the second end of the cylinder.

radius

A float specifying the radius of the cylinder.

返回:

A FaceArray object, which is a sequence of Face objects.

返回类型:

FaceArray

getByBoundingSphere(center, radius)[源代码]

This method returns an array of face objects that lie within the specified bounding sphere.

参数:
center

A tuple of the X, Y, and Z coordinates of the center of the sphere.

radius

A float specifying the radius of the sphere.

返回:

A FaceArray object, which is a sequence of Face objects.

返回类型:

FaceArray

getClosest(coordinates, searchTolerance='')[源代码]

This method returns an object or objects in the FaceArray closest to the given set of points, where the given points need not lie on the faces in the FaceArray.

参数:
coordinates

A sequence of a sequence of floats, where each sequence of floats describes the X, Y, and Z coordinates of a point:

>>> r=f.getClosest(coordinates=((20.0, 20.0, 10.0), (-1.0, -15.0, 15), ))
>>> r.keys()
[0, 1]
>>> r[0]
(mdb.models['Model-1'].parts['Part-1'].faces[0], (15.7090625762939, 20.0, 10.0))

searchTolerance=''

A double specifying the distance within which the closest object must lie. The default value is half of the parent part/instance size.

返回:

This method returns a dictionary object. The key to the dictionary object is the position of the input point in the tuple specified in the coordinates starting at index 0. If a closest face could be found then the value is a sequence consisting of two objects. The first object in the sequence is a Face that is close to the input point referred to by the key. The second object in the sequence is a sequence of floats that specifies the X, Y, and Z location of the closest point on the Face to the given point. See program listing above.

返回类型:

dict

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(mask)[源代码]

This method returns the object or objects in the FaceArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When a large number of objects are involved, this method is highly efficient.

参数:
mask

A String specifying the object or objects.

返回:

A Face object or a sequence of Face objects.

返回类型:

Face

class IgnoredEdge[源代码]

基类:object

An IgnoredEdge object is a one-dimensional region of geometry that has been abstracted away by a virtual topology feature.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].ignoredEdges[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].ignoredEdges[i]
mdb.models[name].rootAssembly.instances[name].ignoredEdges[i]

Member Details:

getCurvature(parameter, point)[源代码]

This method returns curvature information at a location on the IgnoredEdge object.

参数:
parameter

A Float specifying the normalized parameter location on the IgnoredEdge where the curvature is to be computed. This argument is mutually exclusive with the argument point.

point

A tuple of X, Y, and Z coordinates of a point at which the curvature is to be computed. If point does not lie on the IgnoredEdge an attempt is made to project it onto the IgnoredEdge and use the projected point.

返回:

A dictionary with keys 'evaluationPoint', 'curvature', 'radius', 'tangent'. Where 'evaluationPoint' specifies the location at which the curvature was computed. 'curvature' specifies the curvature vector at that location. 'radius' is the Radius of curvature and 'tangent' specifies the tangent to the IgnoredEdge at that location.

返回类型:

dict

抛出:

The given IgnoredEdge is straight --

getRadius()[源代码]

This method returns the radius of a circular IgnoredEdge object.

返回:

A Float specifying the radius.

返回类型:

float

抛出:

The given IgnoredEdge object is not circular --

getSize(printResults=True)[源代码]

This method returns a Float indicating the length of the edge.

参数:
printResults=True

A Bool specifying whether verbose output is printed. The default is True.

返回:

A Float.

返回类型:

float

index : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]

An Int specifying the index of the IgnoredEdge in the IgnoredEdgeArray.

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the X, Y, and Z coordinates of a point located on the edge.

class IgnoredEdgeArray(iterable=(), /)[源代码]

基类:List[IgnoredEdge]

The IgnoredEdgeArray is a sequence of IgnoredEdge objects. If the part is modified, then IgnoredEdgeArray must be updated for that part.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].ignoredEdges
import assembly
mdb.models[name].rootAssembly.allInstances[name].ignoredEdges
mdb.models[name].rootAssembly.instances[name].ignoredEdges

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) IgnoredEdge[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[IgnoredEdge]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[IgnoredEdge]
findAt(*args, **kwargs)

This method returns the object or objects in the IgnoredEdgeArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any IgnoredEdge that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). The arbitrary point must not be shared by a second IgnoredEdge. If two IgnoredEdge objects intersect or coincide at the arbitrary point, findAt chooses the first IgnoredEdge that it encounters, and you should not rely on the return value being consistent. findAt will always try to find objects among all the ignored edges in the part or assembly instance and will not restrict itself to a subset even if the IgnoredEdgeArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find.findAt returns either an IgnoredEdge object or a sequence of IgnoredEdge objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the IgnoredEdge object at that point.

  • If you omit the coordinates keyword argument, findAt accepts as arguments a sequence of sequence of floats in the following format:

    ignoredEdges = e.findAt(((20.19686, -169.513997, 27.798593), ),
                            ((19.657627, -167.295749, 27.056402), ),
                            ((18.274129, -157.144741, 25.15218), ))
    

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

An IgnoredEdge object or a sequence of IgnoredEdge objects.

返回类型:

IgnoredEdge

getClosest(coordinates, searchTolerance='')[源代码]

This method returns a object or objects in the IgnoredEdgeArray closest to the given set of points, where the given points need not lie on the edges in the IgnoredEdgeArray.

参数:
coordinates

A sequence of a sequence of floats, where each sequence of floats describes the X, Y, and Z coordinates of a point:

>>> r=e.getClosest(coordinates=((20.0, 20.0, 10.0),(-1.0, -15.0, 15), ))
>>> r.keys()
[0, 1]
>>> r[0]
(mdb.models['Model-1'].parts['Part-1'].ignoredEdges[3], (15.7090625762939, 20.0, 10.0))

searchTolerance=''

A double specifying the distance within which the closest object must lie. The default value is half of the parent part/instance size.

返回:

This method returns a dictionary object. The key to the dictionary object is the position of the input point in the tuple specified in the coordinates starting at index 0. If a closest IgnoredEdge could be found then the value is a sequence consisting of two objects. The first object in the sequence is an IgnoredEdge that is close to the input point referred to by the key. The second object in the sequence, is a sequence of floats which specify the X, Y, and Z location of the closest point on the IgnoredEdge to the given point. See program listing above.

返回类型:

dict

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(
mask: str,
) IgnoredEdge[源代码]
getSequenceFromMask(
mask: Sequence[str],
) list[IgnoredEdge]
getSequenceFromMask(mask)

This method returns the object or objects in the IgnoredEdgeArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When large number of objects are involved, this method is highly efficient.

参数:
mask: str
mask: Sequence[str]
mask

A String specifying the object or objects.

返回:

An IgnoredEdge object or a sequence of IgnoredEdge objects.

返回类型:

IgnoredEdge

class IgnoredVertex[源代码]

基类:object

An IgnoredVertex object is a point region of the geometry that was abstracted away by a virtual topology feature.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].ignoredVertices[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].ignoredVertices[i]
mdb.models[name].rootAssembly.instances[name].ignoredVertices[i]

Member Details:

index : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]

An Int specifying the index of the IgnoredVertex in the IgnoredVertexArray.

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[源代码]

A tuple of Floats specifying the X, Y, and Z coordinates of the vertex.

class IgnoredVertexArray(iterable=(), /)[源代码]

基类:List[IgnoredVertex]

The IgnoredVertexArray is a sequence of IgnoredVertex objects. If the part is modified, then IgnoredVertexArray must be updated for that part.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].ignoredVertices
import assembly
mdb.models[name].rootAssembly.allInstances[name].ignoredVertices
mdb.models[name].rootAssembly.instances[name].ignoredVertices

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) IgnoredVertex[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[IgnoredVertex]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[IgnoredVertex]
findAt(*args, **kwargs)

This method returns the object or objects in the IgnoredVertexArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any IgnoredVertex object that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). findAt will always try to find objects among all the ignored vertices in the part or assembly instance and will not restrict itself to a subset even if the IgnoredVertexArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find.findAt returns either a IgnoredVertex object or a sequence of IgnoredVertex objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the IgnoredVertex object at that point.

  • If you omit the coordinates keyword argument, findAt accepts as arguments a sequence of sequence of floats in the following format:

    verts = v.findAt(((20.19686, -169.513997, 27.798593), ),
                    ((19.657627, -167.295749, 27.056402), ),
                    ((18.274129, -157.144741, 25.15218), ))
    

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

An IgnoredVertex object or a sequence of IgnoredVertex objects.

返回类型:

IgnoredVertex

getClosest(coordinates, searchTolerance='')[源代码]

This method returns a object or objects in the IgnoredVertexArray closest to the given set of points, where the given points need not lie on the vertices in the IgnoredVertexArray.

参数:
coordinates

A sequence of a sequence of floats, where each sequence of floats describes the X, Y, and Z coordinates of a point:

>>> r=e.getClosest(coordinates=((20.0, 20.0, 10.0),(-1.0, -15.0, 15), ))
>>> r.keys()
[0, 1]
>>> r[0]
(mdb.models['Model-1'].parts['Part-1'].ignoredVertices[3], (15.7090625762939, 20.0, 10.0))

searchTolerance=''

A double specifying the distance within which the closest object must lie. The default value is half of the parent part/instance size.

返回:

This method returns a dictionary object. The key to the dictionary object is the position of the input point in the tuple specified in the coordinates starting at index 0. If a closest IgnoredVertex could be found then the value is a sequence consisting of two objects. The first object in the sequence is a IgnoredVertex that is close to the input point referred to by the key. The second object in the sequence, is a sequence of floats which specify the X, Y, and Z location of the IgnoredVertex. See program listing above.

返回类型:

dict

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(
mask: str,
) IgnoredVertex[源代码]
getSequenceFromMask(
mask: Sequence[str],
) list[IgnoredVertex]
getSequenceFromMask(mask)

This method returns the object or objects in the IgnoredVertexArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When large number of objects are involved, this method is highly efficient.

参数:
mask: str
mask: Sequence[str]
mask

A String specifying the object or objects.

返回:

An IgnoredVertex object or a sequence of IgnoredVertex objects.

返回类型:

IgnoredVertex

class ModelDot[源代码]

基类:object

The ModelDot object can be used to access an actual MeshNode, ReferencePoint, or ConstrainedSketchVertex object.

Member Details:

class ReferencePoint(point, instanceName='')[源代码]

基类:object

The ReferencePoint object has no direct constructor; it is created when a Feature object is created. The ReferencePoint method creates a Feature object that creates a ReferencePoint object.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].referencePoints[i]
mdb.models[name].parts[name].allSets[name].referencePoints[i]
mdb.models[name].parts[name].referencePoints[i]
mdb.models[name].parts[name].sets[name].referencePoints[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].referencePoints[i]
mdb.models[name].rootAssembly.allInstances[name].sets[name].referencePoints[i]
mdb.models[name].rootAssembly.allInternalSets[name].referencePoints[i]
mdb.models[name].rootAssembly.allSets[name].referencePoints[i]
mdb.models[name].rootAssembly.instances[name].referencePoints[i]
mdb.models[name].rootAssembly.instances[name].sets[name].referencePoints[i]
mdb.models[name].rootAssembly.modelInstances[i].referencePoints[i]
mdb.models[name].rootAssembly.modelInstances[i].sets[name].referencePoints[i]
mdb.models[name].rootAssembly.referencePoints[i]
mdb.models[name].rootAssembly.sets[name].referencePoints[i]

Member Details:

class Vertex[源代码]

基类:object

Vertices are point regions of geometry.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].vertices[i]
mdb.models[name].parts[name].allSets[name].vertices[i]
mdb.models[name].parts[name].sets[name].vertices[i]
mdb.models[name].parts[name].vertices[i]
import assembly
mdb.models[name].rootAssembly.allInstances[name].sets[name].vertices[i]
mdb.models[name].rootAssembly.allInstances[name].vertices[i]
mdb.models[name].rootAssembly.allInternalSets[name].vertices[i]
mdb.models[name].rootAssembly.allSets[name].vertices[i]
mdb.models[name].rootAssembly.instances[name].sets[name].vertices[i]
mdb.models[name].rootAssembly.instances[name].vertices[i]
mdb.models[name].rootAssembly.modelInstances[i].sets[name].vertices[i]
mdb.models[name].rootAssembly.modelInstances[i].vertices[i]
mdb.models[name].rootAssembly.sets[name].vertices[i]
mdb.models[name].rootAssembly.vertices[i]

Member Details:

featureName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`][源代码]

A tuple of Floats specifying the name of the feature that created this vertex.

getEdges()[源代码]

This method returns a sequence consisting of the edge ids of the edges which share this vertex.

返回:

A tuple of integers.

返回类型:

tuple[int]

getElements()[源代码]

This method returns an array of element objects that are associated with the vertex.

返回:

A MeshElementArray object which is a sequence of MeshElement objects.

返回类型:

MeshElementArray

getNodes()[源代码]

This method returns an array of node objects that are associated with the vertex.

返回:

A MeshNodeArray object which is a sequence of MeshNode objects.

返回类型:

MeshNodeArray

index : --is-rst--:py:class:`int`[源代码]

An Int specifying the index of the ConstrainedSketchVertex in the VertexArray.

instanceName : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`][源代码]

A tuple of Floats specifying the name of the part instance for this vertex (if applicable).

isReferenceRep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]

A Boolean specifying whether the vertex belongs to the reference representation of the Part or Instance.

pointOn : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:class:`float`, :py:class:`float`][源代码]

A tuple of Floats specifying the X -, Y -, and Z -coordinates of the vertex.

class ReferencePoints[源代码]

基类:Dict[str, ReferencePoint]

Member Details:

class Transform[源代码]

基类:object

The MakeSketchTransform method creates a Transform object. The Transform object has no direct constructor. A Transform object is a 4x3 matrix of Floats that represents the transformation from sketch coordinates to assembly coordinates or to part coordinates.

备注

This object can be accessed by:

import part
import assembly

Member Details:

matrix()[源代码]

This method returns the transformation matrix as a tuple of 12 Floats.

返回:

A tuple of 12 Floats.

返回类型:

tuple[float, float, float, float, float, float, float, float, float, float, float, float]

class VertexArray(vertices)[源代码]

基类:List[Vertex]

The VertexArray is a sequence of ConstrainedSketchVertex objects. If the part is modified, then VertexArray must be updated for that part.

备注

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name].vertices
mdb.models[name].parts[name].allSets[name].vertices
mdb.models[name].parts[name].sets[name].vertices
mdb.models[name].parts[name].vertices
import assembly
mdb.models[name].rootAssembly.allInstances[name].sets[name].vertices
mdb.models[name].rootAssembly.allInstances[name].vertices
mdb.models[name].rootAssembly.allInternalSets[name].vertices
mdb.models[name].rootAssembly.allSets[name].vertices
mdb.models[name].rootAssembly.instances[name].sets[name].vertices
mdb.models[name].rootAssembly.instances[name].vertices
mdb.models[name].rootAssembly.modelInstances[i].sets[name].vertices
mdb.models[name].rootAssembly.modelInstances[i].vertices
mdb.models[name].rootAssembly.sets[name].vertices
mdb.models[name].rootAssembly.vertices

Member Details:

findAt(
coordinates: tuple[float, float, float],
printWarning: AbaqusBoolean | bool = True,
) ConstrainedSketchVertex[源代码]
findAt(
coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[ConstrainedSketchVertex]
findAt(
*coordinates: tuple[tuple[float, float, float]],
printWarning: AbaqusBoolean | bool = True,
) list[ConstrainedSketchVertex]
findAt(*args, **kwargs)

This method returns the object or objects in the VertexArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any ConstrainedSketchVertex object that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). findAt will always try to find objects among all the vertices in the part or assembly instance and will not restrict itself to a subset even if the VertexArray represents such subset.

参数:
coordinates: tuple[float, float, float]
coordinates: tuple[tuple[float, float, float]]
*coordinates: tuple[tuple[float, float, float]]

A sequence of Floats specifying the X, Y, and Z coordinates of the object to find.findAt returns either a ConstrainedSketchVertex object or a sequence of ConstrainedSketchVertex objects based on the type of input.

  • If coordinates is a sequence of Floats, findAt returns the ConstrainedSketchVertex object at that point.

  • If you omit the coordinates keyword argument, findAt accepts as arguments a sequence of sequence of floats in the following format:

    verts = v.findAt(((20.19686, -169.513997, 27.798593), ),
                    ((19.657627, -167.295749, 27.056402), ),
                    ((18.274129, -157.144741, 25.15218), ))
    

printWarning: AbaqusBoolean | bool = True

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

返回:

A ConstrainedSketchVertex object or a sequence of ConstrainedSketchVertex objects..

返回类型:

ConstrainedSketchVertex

getBoundingBox()[源代码]

This method returns a dictionary of two tuples representing minimum and maximum boundary values of the bounding box of the minimum size containing the vertex sequence.

返回:

A Dictionary object with the following items:

  • low: a tuple of three floats representing the minimum X -, Y -, and Z -boundary values of the bounding box.

  • high: a tuple of three floats representing the maximum X -, Y -, and Z -boundary values of the bounding box.

返回类型:

dict[str, tuple[float, float, float]]

getByBoundingBox(xMin=0, yMin=0, zMin=0, xMax=0, yMax=0, zMax=0)[源代码]

This method returns an array of vertex objects that lie within the specified bounding box.

参数:
xMin=0

A float specifying the minimum X boundary of the bounding box.

yMin=0

A float specifying the minimum Y boundary of the bounding box.

zMin=0

A float specifying the minimum Z boundary of the bounding box.

xMax=0

A float specifying the maximum X boundary of the bounding box.

yMax=0

A float specifying the maximum Y boundary of the bounding box.

zMax=0

A float specifying the maximum Z boundary of the bounding box.

返回:

A VertexArray object, which is a sequence of ConstrainedSketchVertex objects..

返回类型:

VertexArray

getByBoundingCylinder(center1, center2, radius)[源代码]

This method returns an array of vertex objects that lie within the specified bounding cylinder.

参数:
center1

A tuple of the X, Y, and Z coordinates of the center of the first end of the cylinder.

center2

A tuple of the X, Y, and Z coordinates of the center of the second end of the cylinder.

radius

A float specifying the radius of the cylinder.

返回:

A VertexArray object, which is a sequence of ConstrainedSketchVertex objects..

返回类型:

VertexArray

getByBoundingSphere(center, radius)[源代码]

This method returns an array of vertex objects that lie within the specified bounding sphere.

参数:
center

A tuple of the X, Y, and Z coordinates of the center of the sphere.

radius

A float specifying the radius of the sphere.

返回:

A VertexArray object, which is a sequence of ConstrainedSketchVertex objects..

返回类型:

VertexArray

getClosest(coordinates, searchTolerance='')[源代码]

This method returns a object or objects in the VertexArray closest to the given set of points, where the given points need not lie on ConstrainedSketchVertex objects in the VertexArray.

参数:
coordinates

A sequence of a sequence of floats, where each sequence of floats describes the X, Y, and Z coordinates of a point:

>>> r=v.getClosest(coordinates=((20.0, 20.0, 10.0),(-1.0, -15.0, 15), ))
>>> r.keys()
[0, 1]
>>> r[0]
(mdb.models['Model-1'].parts['Part-1'].vertices[0], (15.7090625762939, 29.1666641235352, 20.0))

searchTolerance=''

A double specifying the distance within which the closest object must lie. The default value is half of the parent part/instance size.

返回:

This method returns a dictionary object. The key to the dictionary object is the position of the input point in the tuple specified in the coordinates starting at index 0. If a closest vertex could be found then the value is a sequence consisting of two objects. The first object in the sequence is a ConstrainedSketchVertex that is close to the input point referred to by the key. The second object in the sequence is a sequence of floats that specifies the X, Y, and Z location of the ConstrainedSketchVertex. See program listing above.

返回类型:

dict

抛出:

Error -- The mask results in an empty sequence, An exception occurs if the resulting sequence is empty.

getMask()[源代码]

This method returns a string specifying the object or objects.

返回:

A String specifying the object or objects.

返回类型:

str

getSequenceFromMask(
mask: str,
) ConstrainedSketchVertex[源代码]
getSequenceFromMask(
mask: Sequence[str],
) list[ConstrainedSketchVertex]
getSequenceFromMask(mask)

This method returns the object or objects in the VertexArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When a large number of objects are involved, this method is highly efficient.

参数:
mask: str
mask: Sequence[str]
mask

A String specifying the object or objects.

返回:

A ConstrainedSketchVertex object or a sequence of ConstrainedSketchVertex objects..

返回类型:

ConstrainedSketchVertex | list[ConstrainedSketchVertex]