Basic Geometry¶

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

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

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

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 –

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

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

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

返回:¶

A tuple of integers.

返回类型:¶

tuple[int]

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

This method returns the radius of circular edges.

返回:¶

A Float specifying the radius.

返回类型:¶

float

抛出:¶

The given edges is not circular –

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

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]

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

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

This method returns an array of CAD attribute strings associated with the cell when the part was created from CAD data.

返回:¶

An array of String.

返回类型:¶

list[str]

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

返回:¶

A tuple of integers.

返回类型:¶

Sequence[int]

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

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

返回:¶

A tuple of integers.

返回类型:¶

Sequence[int]

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

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

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

返回:¶

A tuple of integers.

返回类型:¶

Sequence[int]

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

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]]

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

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

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

This method returns the cell faces on the exterior of the CellArray. That is, it returns the faces that are referenced by exactly one of the cells in the sequence.

返回:¶

A FaceArray object representing the faces on the exterior of the cells.

返回类型:¶

FaceArray

This method returns a string specifying the object or objects.

返回:¶

A String specifying the object or objects.

返回类型:¶

str

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: str¶

mask: Sequence[str]

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.

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

This method returns an array of CAD attribute strings associated with the Face when the part was created from CAD data.

返回:¶

An array of String.

返回类型:¶

list[str]

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

返回:¶

A tuple of integers.

返回类型:¶

Sequence[int]

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]

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]

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

返回:¶

• Sequence[int]

• A tuple of integers.

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

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

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

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

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

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. –

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

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

返回:¶

A tuple of integers.

返回类型:¶

Sequence[int]

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

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

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]]

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

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

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

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.

This method returns the edges on the exterior of the faces in the FaceArray. That is, it returns the edges that are referenced by exactly one of the faces in the sequence.

返回:¶

An EdgeArray object specifying the exterior edges.

返回类型:¶

EdgeArray

This method returns a string specifying the object or objects.

返回:¶

A String specifying the object or objects.

返回类型:¶

str

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: str¶

mask: Sequence[str]

mask

A String specifying the object or objects.

返回:¶

A Face object or a sequence of Face objects.

返回类型:¶

Face

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

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]]

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

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

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

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

This method returns a string specifying the object or objects.

返回:¶

A String specifying the object or objects.

返回类型:¶

str

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.

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 –

This method returns the radius of a circular IgnoredEdge object.

返回:¶

A Float specifying the radius.

返回类型:¶

float

抛出:¶

The given IgnoredEdge object is not circular –

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

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

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.

This method returns a string specifying the object or objects.

返回:¶

A String specifying the object or objects.

返回类型:¶

str