Source code for abaqus.Part.Feature

from abaqusConstants import *
from ..BasicGeometry.Cell import Cell
from ..BasicGeometry.Edge import Edge
from ..BasicGeometry.Face import Face
from ..BasicGeometry.Vertex import Vertex
from ..Feature.Feature import Feature as BaseFeature
from ..Region.Region import Region
from ..Sketcher.ConstrainedSketch import ConstrainedSketch


[docs]class Feature(BaseFeature): """The following commands operate on Feature objects. For more information about the Feature object, see Feature object. Notes ----- This object can be accessed by: .. code-block:: python import part """
[docs] def AutoRepair(self): """This method carries out a sequence of geometry repair operations if it contains invalid entities. It is expected to improve the geometry, but it does not guarantee that the number of invalid entities will decrease. In some cases, it can also increase the number of invalid entities. Since a number of geometry repair operations and validity checks are performed, it could be a slow operation depending on the complexity of the geometry. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Returns ------- feature: Feature A Feature object """ pass
[docs] def AddCells(self, faceList: tuple[Face], flipped: Boolean = OFF): """This method tries to convert a shell entity to a solid entity. The conversion is not always successful. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects specifying the faces bounding the cell to add. flipped A Boolean specifying the direction of feature creation. The possible values are True and False. The default is True indicating that the direction is opposite to the face normal. When multiple faces are selected, Abaqus attempts to create cells on both sides of the selected faces and ignores the *flipped* argument. Returns ------- feature: Feature A Feature object """ pass
[docs] def AnalyticRigidSurf2DPlanar(self, sketch: ConstrainedSketch): """This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the planar wire. Returns ------- feature: Feature A Feature object """ pass
[docs] def AnalyticRigidSurfExtrude(self, sketch: ConstrainedSketch, depth: float = 1): """This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the planar wire. depth A Float specifying the extrusion depth. The default value is 1.0. Returns ------- feature: Feature A Feature object """ pass
[docs] def AnalyticRigidSurfRevolve(self, sketch: ConstrainedSketch): """This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the *Y*-axis. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the surface to be revolved. Returns ------- feature: Feature A Feature object """ pass
[docs] def AssignMidsurfaceRegion(self, cellList: tuple[Cell]): """This method assign a mid-surface property to sequence of Cell objects. If a reference representation of the part does not exist, it creates one. It also copies the *cells* to the reference representation and deletes the *cells* from the active representation of the part. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- cellList A sequence of Cell objects specifying the regions that will be used for mid-surface construction. These regions will be copied to the reference representation of the part. Returns ------- feature: Feature A Feature object """ pass
[docs] def BaseSolidExtrude(self, sketch: ConstrainedSketch, depth: float, draftAngle: float = None, pitch: float = None): """This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid. The ConstrainedSketch object must define a closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the plane shape to be extruded. depth A Float specifying the extrusion depth. Possible values are 10–5 ≤≤ *depth* ≤≤ 105. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. Returns ------- A Feature object. """ pass
[docs] def BaseSolidRevolve(self, sketch: ConstrainedSketch, angle: float, pitch: float = None, flipRevolveDirection: Boolean = OFF, flipPitchDirection: Boolean = OFF, moveSketchNormalToPath: Boolean = OFF): """This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the shape to be revolved. angle A Float specifying the revolve angle in degrees. Possible values are 10–4 ≤≤ *angle* ≤≤ 360.Note:If *pitch* >>0, there is no upper limit for *angle*. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤≤ *pitch* ≤≤ 105. The default value, 0, implies a normal revolve. flipRevolveDirection A Boolean specifying whether to override the direction of feature creation. If *flipRevolveDirection*=OFF, the default direction of revolution is used. If *flipRevolveDirection*=ON, the revolve direction is reversed. The default value is OFF. flipPitchDirection A Boolean specifying whether to override the direction of translation. If *flipPitchDirection*=OFF, the direction of translation is given by the direction of the revolve axis. If *flipPitchDirection*=ON, the translation direction is reversed. The default value is OFF. moveSketchNormalToPath A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the *pitch* option. If *moveSketchNormalToPath*=OFF, the sketch plane remains parallel to the revolve axis. If *moveSketchNormalToPath*=ON, the sketch is moved to match the angle created by the *pitch* before being revolved. The default value is OFF. Returns ------- A Feature object. Raises ------ RangeError """ pass
[docs] def BaseSolidSweep(self, sketch: ConstrainedSketch, path: ConstrainedSketch): """This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid. The profile ConstrainedSketch object must define a closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the profile to be swept. path A ConstrainedSketch object specifying the path of the sweep. Returns ------- feature: Feature A Feature object """ pass
[docs] def BaseShell(self, sketch: ConstrainedSketch): """This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the planar shell. Returns ------- feature: Feature A Feature object """ pass
[docs] def BaseShellExtrude(self, sketch: ConstrainedSketch, depth: float, draftAngle: float = None, pitch: float = None): """This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell. The ConstrainedSketch object can define either an open or closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the shape to be extruded. depth A Float specifying the extrusion depth. Possible values are Floats > 0. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. Returns ------- A Feature object. Raises ------ RangeError """ pass
[docs] def BaseShellRevolve(self, sketch: ConstrainedSketch, angle: float, pitch: float = None, flipRevolveDirection: Boolean = OFF, flipPitchDirection: Boolean = OFF, moveSketchNormalToPath: Boolean = OFF): """This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the shape to be revolved. angle A Float specifying the revolve angle in degrees. Possible values are 0 ≤≤ *angle* ≤≤ 360.Note:If *pitch* >> 0, there is no upper limit for *angle*. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤≤ *pitch* ≤≤ 105. The default value, 0, implies a normal revolve. flipRevolveDirection A Boolean specifying whether to override the direction of feature creation. If *flipRevolveDirection*=OFF, the default direction of revolution is used. If *flipRevolveDirection*=ON, the revolve direction is reversed. The default value is OFF. flipPitchDirection A Boolean specifying whether to override the direction of translation. If *flipPitchDirection*=OFF, the direction of translation is given by the direction of the revolve axis. If *flipPitchDirection*=ON, the translation direction is reversed. The default value is OFF. moveSketchNormalToPath A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the *pitch* option. If *moveSketchNormalToPath*=OFF, the sketch plane remains parallel to the revolve axis. If *moveSketchNormalToPath*=ON, the sketch is moved to match the angle created by the *pitch* before being revolved. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def BaseShellSweep(self, sketch: ConstrainedSketch, path: ConstrainedSketch): """This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell. The ConstrainedSketch object can define either an open or closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the section to be swept. path A ConstrainedSketch object specifying the path of the sweep. Returns ------- feature: Feature A Feature object """ pass
[docs] def BaseWire(self, sketch: ConstrainedSketch): """This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketch A ConstrainedSketch object specifying the planar wire. Returns ------- feature: Feature A Feature object """ pass
[docs] def BlendFaces(self, side1: tuple[Edge], side2: tuple, method: SymbolicConstant = None, path: Edge = Edge()): """This method creates a Feature object by creating new faces that blends two sets of faces. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- side1 A sequence of Edge objects specifying one side of the blend. The edges must form a continuous chain without branches. side2 A sequence of Edge or Face objects specifying the second side of the blend. If *side2* contains Edge objects then they must form a continuous chain without branches. method A SymbolicConstant indicating a method for creating blends. This argument is a required argument if *side2* contains Edge object and it is ignored if *side2* contains Faceobjects. It can have one of the following values:TANGENT: The blend is tangent to the sides.SHORTEST_PATH: The blend connects the two sides based on linear interpolation between the two sides.SPECIFY_PATH: The blend connects the two sides along a specified path. path An Edge object that connects *side1* to *side2* and specifies the path for creating the blend. This argument is required if *method*=SPECIFY_PATH; otherwise, it is ignored. Returns ------- feature: Feature A Feature object """ pass
[docs] def Chamfer(self, length: float, edgeList: tuple[Edge]): """This method creates an additional Feature object by chamfering the given list of edges with a given length. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- length A Float specifying the length of the chamfer. edgeList A sequence of Edge objects specifying the edges to chamfer. Returns ------- feature: Feature A Feature object """ pass
[docs] def Mirror(self, mirrorPlane: str, keepOriginal: Boolean, keepInternalBoundaries: Boolean = OFF): """This method mirrors existing part geometry across a plane to create new geometry. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- mirrorPlane A Datum plane object or a planar Face object. keepOriginal A boolean specifying whether or not the original part geometry should be retained. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def ConvertToAnalytical(self): """This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Returns ------- feature: Feature A Feature object """ pass
[docs] def ConvertToPrecise(self, method: SymbolicConstant = RECOMPUTE_GEOMETRY): """This method attempts to change imprecise entities so that the geometry becomes precise. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- method A SymbolicConstant specifying the method to be used to convert the part to precise. Possible values are RECOMPUTE_GEOMETRY and TIGHTEN_GAPS. The default value is RECOMPUTE_GEOMETRY. Returns ------- feature: Feature A Feature object """ pass
[docs] def CoverEdges(self, edgeList: tuple[Edge], tryAnalytical: Boolean = False): """This method generates a face using the given edges as the face's boundaries. The CoverEdges method generates a face by creating the geometry consisting of the underlying surface, associated edges, and vertices. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A sequence of Edge objects specifying the edges that bound the new face. tryAnalytical A Boolean specifying whether the newly created face should be analytical or not. The default is False. Returns ------- A Feature object. Raises ------ - If the given boundary is not a closed loop: Parterror: Cannot find a closed loop - If the given boundary contains a zero length component: Parterror: Cannot find a closed loop - If the underlying surface is too difficult to fit: Parterror: Cannot construct face geometry """ pass
[docs] def Cut(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, sketchOrientation: SymbolicConstant = None): """This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar cut. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Returns ------- feature: Feature A Feature object """ pass
[docs] def CutExtrude(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketchOrientation: SymbolicConstant, sketch: ConstrainedSketch, depth: float = None, upToFace: str = '', draftAngle: float = None, pitch: float = None, flipExtrudeDirection: Boolean = OFF): """This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part. The ConstrainedSketch object must define a closed profile. The CutExtrude method creates a blind cut (using *depth*), an up-to-face cut (using *upToFace*), or a through-all cut (if *depth* and *upToFace* are not specified). Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. sketch A ConstrainedSketch object specifying the planar sketch to be extruded. depth A Float specifying the extrusion depth. If *depth* is specified, the cut will be a blind cut. The default is to not specify a depth. upToFace A Face specifying the face up to which to cut. If *upToFace* is specified, the cut will be an up-to-face cut. The default is to not specify a face.Note:If neither *depth* nor *upToFace* is specified, the cut will be a through-all cut. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. flipExtrudeDirection A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the *sketchPlaneSide*; if the value is ON, it means use the opposite direction to the one defined by *sketchPlaneSide*. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def CutLoft(self, loftsections: tuple, startCondition: SymbolicConstant = None, endCondition: SymbolicConstant = None, startTangent: float = None, startMagnitude: float = None, endTangent: float = None, endMagnitude: float = None, globalSmoothing: Boolean = OFF): """This method creates an additional Feature object by lofting between the given sections and cutting away material from the part. You define the sections using a sequence of edges from the part or an EdgeArray. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- loftsections A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops. startCondition A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *startCondition* argument in conjunction with the *endCondition* argument. endCondition A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *endCondition* argument in conjunction with the *startCondition* argument. startTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the *startTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *startTangent* ≤≤ 180.0. startMagnitude A Float specifying the magnitude of the *startTangent*. You must specify the *startMagnitude* argument if *startCondition*=SPECIFIED. Possible values are 0.0 << *startMagnitude* << 100.0. endTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the *endTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *endTangent* ≤≤ 180.0. endMagnitude A Float specifying the magnitude of the *endTangent*. This argument is to be used when the *endCondition* argument has the value SPECIFIED. Possible values are 0.0 << *endMagnitude* << 100.0. globalSmoothing A Boolean specifying whether each path defined in the *paths* argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the *loftSections* through which the *paths* pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally). Returns ------- feature: Feature A Feature object """ pass
[docs] def CutRevolve(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketchOrientation: SymbolicConstant, sketch: ConstrainedSketch, angle: float, pitch: float = None, flipRevolveDirection: Boolean = OFF, flipPitchDirection: Boolean = OFF, moveSketchNormalToPath: Boolean = OFF): """This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part. The ConstrainedSketch object must define a closed profile and an axis of revolution. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. sketch A ConstrainedSketch object specifying the planar sketch to be revolved. angle A Float specifying the angle in degrees to be revolved. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤≤ *pitch* ≤≤ 105. The default value, 0, implies a normal revolve. flipRevolveDirection A Boolean specifying whether to override the direction of feature creation. If *flipRevolveDirection*=OFF, the default direction of revolution is used. If *flipRevolveDirection*=ON, the revolve direction is reversed. The default value is OFF. flipPitchDirection A Boolean specifying whether to override the direction of translation. If *flipPitchDirection*=OFF, the direction of translation is given by the direction of the revolve axis. If *flipPitchDirection*=ON, the translation direction is reversed. The default value is OFF. moveSketchNormalToPath A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the *pitch* option. If *moveSketchNormalToPath*=OFF, the sketch plane remains parallel to the revolve axis. If *moveSketchNormalToPath*=ON, the sketch is moved to match the angle created by the *pitch* before being revolved. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def CutSweep(self, path: str, profile: str, pathPlane: str = '', pathUpEdge: Edge = Edge(), pathOrientation: SymbolicConstant = None, sketchPlane: str = '', sketchUpEdge: Edge = Edge(), sketchOrientation: SymbolicConstant = None, draftAngle: float = None, pitch: float = None, profileNormal: Boolean = OFF, flipSweepDirection: Boolean = OFF): """This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- path Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep. profile Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept. pathPlane A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object. pathUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the path sketch. Only required when path is a ConstrainedSketch object. pathOrientation A SymbolicConstant specifying the orientation of *pathUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object. sketchPlane A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as a ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the profile sketch. Only required when profile is a ConstrainedSketch object. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when profile is a ConstrainedSketch object. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. profileNormal A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When *profileNormal*=OFF, the profile normal will vary through out the sweep path. When *profileNormal*=ON, the profile normal will be same as original through out the sweep path. The default value is OFF. flipSweepDirection A Boolean specifying whether to flip the direction in which sweep operation will be performed. When *flipSweepDirection*=OFF, sweep operation will be performed in the direction of path direction. When *flipSweepDirection*=ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def ExtendFaces(self, faces: tuple[Face] = (), extendAlong: tuple[Edge] = (), distance: float = None, upToFaces: tuple[Face] = (), trimToExtendedTargetSurfaces: Boolean = True, upToReferenceRep: Boolean = OFF): """This method extends faces along its free edges by offsetting the external edges along the surfaces. One of *distance*, *upToReferenceRep*, or *upToFaces* must be used to specify how far the faces need to be extended. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faces A sequence of Face objects specifying the faces to be extended. The faces cannot belong to the reference representation. The *faces* and *extendAlong* arguments are mutually exclusive. One of them must be specified. extendAlong A sequence of Edge objects specifying the edges where to extend the faces. Only free edges are considered. The interior edges will be ignored. The *faces* and *extendAlong* arguments are mutually exclusive. One of them must be specified. distance A Float indicating the distance to extend the faces along the edges. Either *distance*, *upToReferenceRep*, or *upToFaces* must be specified. upToFaces A sequence of Face objects specifying the faces that the selected faces should be extended up to. trimToExtendedTargetSurfaces A Boolean indicating that the surfaces of up to target faces should be extended before extending and trimming the selected faces. The default value is True. upToReferenceRep A Boolean indicating that the selected faces should be extended along the selected edges and be trimmed along their intersection with the reference representation. Returns ------- feature: Feature A Feature object """ pass
[docs] def FaceFromElementFaces(self, elementFaces: Region, stitch: Boolean = OFF, stitchTolerance: float = None, analyticFitTolerance: float = None, associateFace: Boolean = OFF): """This method creates a geometry face from a collection of orphan element faces. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- elementFaces A Region object specifying the collection of orphan element faces. stitch A Boolean specifying whether the created geometry face should be stitched with existing geometry faces. Default value is TRUE. stitchTolerance A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. If stitch tolerance is not provided then default value of 0.001 will be used for stitching. analyticFitTolerance A Float indicating the analytical surface fitting tolerance. If analytical tolerance is not provided then default value of 0.015 will be used for analytical surface fitting. associateFace A Boolean specifying whether the created geometry face should be associated with the mesh. Default value is TRUE. Returns ------- feature: Feature A Feature object """ pass
[docs] def HoleBlindFromEdges(self, plane: str, planeSide: SymbolicConstant, diameter: float, edge1: Edge, distance1: float, edge2: Edge, distance2: float, depth: float): """This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- plane A Datum plane object or a planar Face object. planeSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. diameter A Float specifying the diameter of the hole. edge1 An Edge object specifying the edge from which *distance1* is measured. distance1 A Float specifying the offset from *edge1*. edge2 An Edge object specifying the edge from which *distance2* is measured. distance2 A Float specifying the offset from *edge2*. depth A Float specifying the depth of the hole. Returns ------- feature: Feature A Feature object """ pass
[docs] def HoleFromEdges(self, diameter: float, edge1: Edge, distance1: float, edge2: Edge, distance2: float): """This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- diameter A Float specifying the diameter of the hole. edge1 An Edge object specifying the edge from which *distance1* is measured. distance1 A Float specifying the offset from *edge1*. edge2 An Edge object specifying the edge from which *distance2* is measured. distance2 A Float specifying the offset from *edge2*. Returns ------- feature: Feature A Feature object """ pass
[docs] def HoleThruAllFromEdges(self, plane: str, planeSide: SymbolicConstant, diameter: float, edge1: Edge, distance1: float, edge2: Edge, distance2: float): """This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- plane A Datum plane object or a planar Face object. planeSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. diameter A Float specifying the diameter of the hole. edge1 An Edge object specifying the edge from which *distance1* is measured. distance1 A Float specifying the offset from *edge1*. edge2 An Edge object specifying the edge from which *distance2* is measured. distance2 A Float specifying the offset from *edge2*. Returns ------- feature: Feature A Feature object """ pass
[docs] def MergeEdges(self, edgeList: tuple[Edge] = (), extendSelection: Boolean = OFF): """This method merges edges either by extending the user selection or using only the selected edges. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A sequence of Edge objects specifying the edges to be merged. extendSelection A Boolean specifying whether the user selection needs to be extended to include edges till branching occurs. Branching is said to occur when the vertex of an edge is shared by more than two edges. Returns ------- feature: Feature A Feature object """ pass
[docs] def OffsetFaces(self, faceList: tuple[Face], distance: float = None, targetFaces: tuple[Face] = (), targetFacesMethod: SymbolicConstant = None, fractionDistance: float = None, trimToReferenceRep: Boolean = OFF): """This method creates new faces by offsetting existing faces. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects specifying the faces that will be offset. The faces may belong to the part or to the reference representation associated with the part. distance A Float indicating the distance to offset the faces. Either *distance* or *targetFaces* must be specified. targetFaces A sequence of Face objects whose distance to the faces argument together with the *targetFacesMethod* determines the distance to offset the faces. Either *distance* or *targetFaces* must be specified. targetFacesMethod A SymbolicConstant indicating how to calculate the distance to offset. It can have one of the following values:HALF_OF_AVERAGE: Offset the faces by a distance equals to half the average distance to target faces.CLOSEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate closest point on the selected target faces.FARTHEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate farthest point on the selected target faces. fractionDistance A Float indicating the fraction of the distance to the closest or the farthest point on the target faces. Its default value is 0.5. trimToReferenceRep A Boolean indicating whether to extend the offset faces and trim them along their intersection with the reference representation. Returns ------- feature: Feature A Feature object """ pass
[docs] def RemoveCells(self, cellList: tuple[Cell]): """This method converts a solid entity to a shell entity. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- cellList A sequence of Cell objects specifying the cells to remove. Returns ------- A Boolean value. Raises ------ - If the intended volume to be turned into a shell entity is not three-dimensional. Parterror: ConstrainedSketchGeometry that is not 3-dimensional does not contain cells. """ pass
[docs] def RemoveFaces(self, faceList: tuple[Face], deleteCells: Boolean = False): """This method removes faces from a solid entity or from a shell entity. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects specifying the faces to remove. deleteCells A Boolean specifying whether all cells are to be deleted when the faces are removed. The default value is False. Returns ------- feature: Feature A Feature object """ pass
[docs] def RemoveFacesAndStitch(self, faceList: tuple[Face]): """This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects specifying the faces to remove. Returns ------- feature: Feature A Feature object """ pass
[docs] def RemoveRedundantEntities(self, vertexList: tuple[Vertex] = (), edgeList: tuple[Edge] = (), removeEdgeVertices: Boolean = True): """This method removes redundant edges and vertices from a solid or a shell entity. One of the two arguments is required. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- vertexList A sequence of ConstrainedSketchVertex objects specifying the vertices to be removed. edgeList A sequence of Edge objects specifying the edges to be removed. removeEdgeVertices A Boolean specifying whether the vertices of the redundant edges need to be removed. The default is True. Returns ------- A Feature object. Raises ------ - If the selected entity is not a redundant entity. Parterror: None of the selected entities are redundant. """ pass
[docs] def RepairFaceNormals(self, faceList: tuple[Face] = ()): """This method works on the entire part or a sequence of shell faces. When the entire part is selected, it aligns all the shell face normals, and inverts all of the solid faces' normals if the solid was originally inside out. When a few shell faces are selected, it inverts the normals of the selected faces. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects. Returns ------- feature: Feature A Feature object """ pass
[docs] def RepairInvalidEdges(self, edgeList: tuple[Edge]): """This method repairs invalid edges. It will always attempt to improve edges even if none of selected edges are initially invalid and may leave behind invalid edges that could not be repaired. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A sequence of Edge objects. Returns ------- feature: Feature A Feature object """ pass
[docs] def RepairSliver(self, face: Face, point1: int, point2: int, toleranceChecks: Boolean = True): """This method repairs the selected sliver from the selected face. The sliver area is specified using two points. A face partition is carried out at the specified points and the smaller of the two faces is removed. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- face A Face object specifying the face on which the sliver is located. point1 A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the *face*. point2 A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the *face*. toleranceChecks A Boolean specifying whether to use internal tolerance checks to restrict the size of the sliver face being removed. The default is True. Returns ------- feature: Feature A Feature object """ pass
[docs] def RepairSmallEdges(self, edgeList: tuple[Edge], toleranceChecks: Boolean = True): """This method repairs small edges. This method will attempt to replace selected small edges with vertices and extend the adjacent faces and edges. This method might leave behind some small edges that cannot be removed. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A sequence of Edge objects. toleranceChecks A Boolean specifying whether to use internal tolerance checks to restrict the size of the edges being removed. The default is True. Returns ------- feature: Feature A Feature object """ pass
[docs] def RepairSmallFaces(self, faceList: tuple[Face], toleranceChecks: Boolean = True): """This method repairs small faces. It will attempt to replace the selected small faces with edges or vertices and extend the adjacent faces. This method might leave behind some small faces that cannot be removed. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects. toleranceChecks A Boolean specifying whether to use internal tolerance checks to restrict the size of the faces being removed. The default is True. Returns ------- feature: Feature A Feature object """ pass
[docs] def ReplaceFaces(self, faceList: tuple[Face], stitch: Boolean = True): """This method replaces the selected faces with a single face. If one single face is selected, that alone is replaced with a new face. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- faceList A sequence of Face objects to be replaced. stitch A Boolean specifying whether the newly created face needs to be stitched to the existing geometry. The default is True. Returns ------- feature: Feature A Feature object """ pass
[docs] def Round(self, radius: float, edgeList: tuple[Edge], vertexList: tuple[Vertex]): """This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- radius A Float specifying the radius of the fillets. edgeList A sequence of Edge objects. Solid and Shell edges of a part can be rounded. The operation will fail for non-manifold edges. The *edgeList* and *vertexList* arguments are mutually exclusive. One of them must be specified. vertexList A sequence of ConstrainedSketchVertex objects. Vertices that are connected to two wire edges can be rounded. The operation will fail for a vertex connected to a face. The *edgeList* and *vertexList* arguments are mutually exclusive. One of them must be specified. Returns ------- feature: Feature A Feature object """ pass
[docs] def Shell(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, sketchOrientation: SymbolicConstant = RIGHT): """This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar shell. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. Returns ------- feature: Feature A Feature object """ pass
[docs] def ShellExtrude(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, depth: float = None, upToFace: str = '', sketchOrientation: SymbolicConstant = RIGHT, draftAngle: float = None, pitch: float = None, flipExtrudeDirection: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar sketch to be extruded. depth A Float specifying the extrusion depth. The default is to not specify a depth. Either *depth* or *upToFace* must be used to define the extrusion depth. upToFace A Face specifying the face up to which to extrude. If *upToFace* is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either *depth* or *upToFace* must be used to define the extrusion depth. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. flipExtrudeDirection A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the *sketchPlaneSide*; if the value is ON, it means use the opposite direction to the one defined by *sketchPlaneSide*. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def ShellLoft(self, loftsections: tuple, startCondition: SymbolicConstant = None, endCondition: SymbolicConstant = None, startTangent: float = None, startMagnitude: float = None, endTangent: float = None, endMagnitude: float = None, paths: tuple = (), globalSmoothing: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part. You define the sections using a sequence of edges from the part or an EdgeArray. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- loftsections A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops. startCondition A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *startCondition* argument in conjunction with the *endCondition* argument. endCondition A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *endCondition* argument in conjunction with the *startCondition* argument. startTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the *startTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *startTangent* ≤≤ 180.0. startMagnitude A Float specifying the magnitude of the *startTangent*. You must specify the *startMagnitude* argument if *startCondition*=SPECIFIED. Possible values are 0.0 << *startMagnitude* << 100.0. endTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the *endTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *endTangent* ≤≤ 180.0. endMagnitude A Float specifying the magnitude of the *endTangent*. This argument is to be used when the *endCondition* argument has the value SPECIFIED. Possible values are 0.0 << *endMagnitude* << 100.0. paths A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the *loftsections* argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the *paths* argument in conjunction with the *startCondition* and *endCondition* arguments. globalSmoothing A Boolean specifying whether each path defined in the *paths* argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the *loftsections* through which the *paths* pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally). keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def ShellRevolve(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, angle: float, sketchOrientation: SymbolicConstant = RIGHT, pitch: float = None, flipRevolveDirection: Boolean = OFF, flipPitchDirection: Boolean = OFF, moveSketchNormalToPath: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line. For a description of the plane positioning arguments, see SolidExtrude. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar sketch to be revolved. angle A Float specifying the angle in degrees to be revolved. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤≤ *pitch* ≤≤ 105. The default value, 0, implies a normal revolve. flipRevolveDirection A Boolean specifying whether to override the direction of feature creation. If *flipRevolveDirection*=OFF, the default direction of revolution is used. If *flipRevolveDirection*=ON, the revolve direction is reversed. The default value is OFF. flipPitchDirection A Boolean specifying whether to override the direction of translation. If *flipPitchDirection*=OFF, the direction of translation is given by the direction of the revolve axis. If *flipPitchDirection*=ON, the translation direction is reversed. The default value is OFF. moveSketchNormalToPath A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the *pitch* option. If *moveSketchNormalToPath*=OFF, the sketch plane remains parallel to the revolve axis. If *moveSketchNormalToPath*=ON, the sketch is moved to match the angle created by the *pitch* before being revolved. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def ShellSweep(self, path: str, profile: str, pathPlane: str = '', pathUpEdge: Edge = Edge(), pathOrientation: SymbolicConstant = None, sketchPlane: str = '', sketchUpEdge: Edge = Edge(), sketchOrientation: SymbolicConstant = None, draftAngle: float = None, pitch: float = None, profileNormal: Boolean = OFF, flipSweepDirection: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion. The section can be an open or a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- path Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep. profile Profile may either be a ConstrainedSketch object or a sequence of Edge objects specifying the section to be swept. pathPlane A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object. pathUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the path sketch. Only required when path is a ConstrainedSketch object. pathOrientation A SymbolicConstant specifying the orientation of *pathUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object. sketchPlane A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the profile sketch. Only required when profile is a ConstrainedSketch object. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when profile is a ConstrainedSketch object. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. profileNormal A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When *profileNormal*=OFF, the profile normal will vary through out the sweep path. When *profileNormal*=ON, the profile normal will be same as original through out the sweep path. The default value is OFF. flipSweepDirection A Boolean specifying whether to flip the direction in which sweep operation will be performed. When *flipSweepDirection*=OFF, sweep operation will be performed in the direction of path direction. When *flipSweepDirection*=ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def SolidExtrude(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, depth: float = None, upToFace: str = '', sketchOrientation: SymbolicConstant = RIGHT, draftAngle: float = None, pitch: float = None, flipExtrudeDirection: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion. The ConstrainedSketch object must define a closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar sketch to be extruded. depth A Float specifying the extrusion depth. The default is to not specify a depth. Either *depth* or *upToFace* must be used to define the extrusion depth. upToFace A Face specifying the face up to which to extrude. If *upToFace* is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either *depth* or *upToFace* must be used to define the extrusion depth. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. flipExtrudeDirection A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the *sketchPlaneSide*; if the value is ON, it means use the opposite direction to the one defined by *sketchPlaneSide*. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def SolidLoft(self, loftsections: tuple, startCondition: SymbolicConstant = None, endCondition: SymbolicConstant = None, startTangent: float = None, startMagnitude: float = None, endTangent: float = None, endMagnitude: float = None, paths: tuple = (), globalSmoothing: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by lofting between the given sections and adding material to the part. You define the sections using a sequence of edges from the part or an EdgeArray. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- loftsections A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which Abaqus will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops. startCondition A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *startCondition* argument in conjunction with the *endCondition* argument. endCondition A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the *path* argument. You must use the *endCondition* argument in conjunction with the *startCondition* argument. startTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the *startTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *startTangent* ≤≤ 180.0. startMagnitude A Float specifying the magnitude of the *startTangent*. You must specify the *startMagnitude* argument if *startCondition*=SPECIFIED. Possible values are 0.0 << *startMagnitude* << 100.0. endTangent A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the *endTangent* argument if *startCondition*=SPECIFIED. Possible values are 0.0 ≤≤ *endTangent* ≤≤ 180.0. endMagnitude A Float specifying the magnitude of the *endTangent*. This argument is to be used when the *endCondition* argument has the value SPECIFIED. Possible values are 0.0 << *endMagnitude* << 100.0. paths A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the *loftsections* argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the *paths* argument in conjunction with the *startCondition* and *endCondition* arguments. globalSmoothing A Boolean specifying whether each path defined in the *paths* argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the *loftsections* through which the *paths* pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally). keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def SolidRevolve(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, angle: float, sketchOrientation: SymbolicConstant = RIGHT, pitch: float = None, flipRevolveDirection: Boolean = OFF, flipPitchDirection: Boolean = OFF, moveSketchNormalToPath: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar sketch to be revolved. angle A Float specifying the angle in degrees to be revolved. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤≤ *pitch* ≤≤ 105. The default value, 0, implies a normal revolve. flipRevolveDirection A Boolean specifying whether to override the direction of feature creation. If *flipRevolveDirection*=OFF, the default direction of revolution is used. If *flipRevolveDirection*=ON, the revolve direction is reversed. The default value is OFF. flipPitchDirection A Boolean specifying whether to override the direction of translation. If *flipPitchDirection*=OFF, the direction of translation is given by the direction of the revolve axis. If *flipPitchDirection*=ON, the translation direction is reversed. The default value is OFF. moveSketchNormalToPath A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the *pitch* option. If *moveSketchNormalToPath*=OFF, the sketch plane remains parallel to the revolve axis. If *moveSketchNormalToPath*=ON, the sketch is moved to match the angle created by the *pitch* before being revolved. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def SolidSweep(self, path: str, profile: str, pathPlane: str = '', pathUpEdge: Edge = Edge(), pathOrientation: SymbolicConstant = None, sketchPlane: str = '', sketchUpEdge: Edge = Edge(), sketchOrientation: SymbolicConstant = None, draftAngle: float = None, pitch: float = None, profileNormal: Boolean = OFF, flipSweepDirection: Boolean = OFF, keepInternalBoundaries: Boolean = OFF): """This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- path Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep. profile Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept. pathPlane A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object. pathUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the path sketch. Only required when path is a ConstrainedSketch object. pathOrientation A SymbolicConstant specifying the orientation of *pathUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object. sketchPlane A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the profile sketch. Only required when profile is a ConstrainedSketch object. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when profile is a ConstrainedSketch object. draftAngle A Float specifying the draft angle in degrees. Possible values are -90.0 ≤≤ *draftAngle* ≤≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments *draftAngle* and *pitch* are mutually exclusive. pitch A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are –105 ≤≤ *pitch* ≤≤ 105. The arguments *draftAngle* and *pitch* are mutually exclusive. profileNormal A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When *profileNormal*=OFF, the profile normal will vary through out the sweep path. When *profileNormal*=ON, the profile normal will be same as original through out the sweep path. The default value is OFF. flipSweepDirection A Boolean specifying whether to flip the direction in which sweep operation will be performed. When *flipSweepDirection*=OFF, sweep operation will be performed in the direction of path direction. When *flipSweepDirection*=ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF. keepInternalBoundaries A Boolean specifying whether internal boundaries will be retained. The default value is OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def Stitch(self, edgeList: tuple[Edge] = (), stitchTolerance: float = None): """This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part. If *edgeList* is not given, a global stitch will be performed. If *stitchTolerance* is not specified, a value of 1.0 will be used. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A sequence of Edge objects specifying the edges that need to be stitched. stitchTolerance A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. Returns ------- feature: Feature A Feature object """ pass
[docs] def Wire(self, sketchPlane: str, sketchPlaneSide: SymbolicConstant, sketchUpEdge: Edge, sketch: ConstrainedSketch, sketchOrientation: SymbolicConstant = RIGHT): """This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- sketchPlane A Datum plane object or a planar Face object specifying the plane on which to sketch. sketchPlaneSide A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2. sketchUpEdge An Edge object or a Datum axis object specifying the vertical (*Y*) direction of the sketch. sketch A ConstrainedSketch object specifying the planar sketch to be revolved. sketchOrientation A SymbolicConstant specifying the orientation of *sketchUpEdge* on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT. Returns ------- feature: Feature A Feature object """ pass
[docs] def WireSpline(self, points: tuple, mergeType: SymbolicConstant = IMPRINT, smoothClosedSpline: Boolean = OFF): """This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- points A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the spline wire will pass. *points* can also be a sequence of tuples of Floats. You must specify at least two values in the sequence. mergeType A SymbolicConstant specifying the merge behavior of the wire with existing geometry. If *mergeType* is MERGE, Abaqus merges the wire into solid regions of the part if the wire passes through them. If *mergeType* is IMPRINT, Abaqus imprints the spline wire on existing geometry as edges. If *mergeType* is SEPARATE, Abaqus neither merges nor imprints the spline wire with existing geometry. It creates the wire separately. The default value is IMPRINT. smoothClosedSpline A Boolean specifying the behavior of Abaqus when the points defining a spline wire form a closed loop (the start and end points are the same). If *smoothClosedSpline*=ON, Abaqus creates a smooth spline wire where the tangencies at the end point meet smoothly. If *smoothClosedSpline*=OFF, Abaqus does not automatically create a smooth end condition. The default value in OFF. Returns ------- feature: Feature A Feature object """ pass
[docs] def WirePolyLine(self, points: tuple, mergeType: SymbolicConstant = IMPRINT, meshable: Boolean = ON): """This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- points A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the polyline wire will pass. *points* can also be a sequence of tuples of Floats. You must specify at least two values in the sequence. mergeType A SymbolicConstant specifying the merge behavior of the wire with existing geometry. If *mergeType* is MERGE, Abaqus merges the wire into solid regions of the part if the wire passes through them. If *mergeType* is IMPRINT, Abaqus imprints the wire on existing geometry as edges. If *mergeType* is SEPARATE, Abaqus neither merges nor imprints the spline wire with existing geometry. It creates the wire separately. The default value is IMPRINT. meshable A Boolean specifying whether the wire should be available for selection in meshing operations. If *meshable*=OFF, the wire can be used for connector section assignment. The default value is ON. Returns ------- feature: Feature A Feature object """ pass
[docs] def WireFromEdge(self, edgeList: str): """This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part. Notes ----- This function can be accessed by: .. code-block:: python mdb.models[name].parts[*name*].AutoRepair Parameters ---------- edgeList A list of Edge objects specifying the edges from which the wire is to be created. Returns ------- feature: Feature A Feature object """ pass