JiհdZddlmZddlZddlZddlZddlmZddlmZddl m Z m Z m Z m Z mZmZmZddlmZmZmZddlmZdd lmZdd lmZdd lmZddlmZdd l m!Z!dd l"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6m7Z7ddl8m9Z9m:Z:ddl;mZ>ddl?m@Z@ddlAmBZBddlCmDZDddlEmFZFmGZGddlHmIZIddlJmKZKddlLmMZMmNZNmOZOmPZPmQZQmRZRmSZSddlTmUZUmVZVmWZWddlXmYZYddlZm[Z[m\Z\m]Z]m^Z^dd l_m`Z`dd!lambZbdd"lcmdZdmeZemfZfdd#lgmhZhdd$limjZjmkZkdd%llmmZmdd&lnmoZompZpdd'lqmrZrmsZsdd(ltmuZumvZvmwZwdd)lxmyZymzZzm{Z{dd*lm|Z|m}Z}dd+l~mZmZdd,lmZdd-lmZmZmZdd.lmZmZmZmZmZmZmZdd/lmZmZmZmZmZmZmZmZmZmZmZdd0lmZmZmZmZmZmZmZmZdd1lmZmZmZmZmZmZmZmZmZd2d3lmZmZmZmZmZmZmZmZmZd2d4lmZmZmZmZd2d5lmZmZerd2d6lmZmZd2d7lmZd2d8lmZmZmZmZGd9d:eZGd;deeeZdCdDd?ZdEd@Z dF dGdAZ dF dHdBZy)Ias build123d topology name: one_d.py by: Gumyr date: January 07, 2025 desc: This module defines the classes and methods for one-dimensional geometric entities in the build123d CAD library. It focuses on `Edge` and `Wire`, representing essential topological elements like curves and connected sequences of curves within a 3D model. These entities are pivotal for constructing complex shapes, boundaries, and paths in CAD applications. Key Features: - **Edge Class**: - Represents curves such as lines, arcs, splines, and circles. - Supports advanced operations like trimming, offsetting, splitting, and projecting onto shapes. - Includes methods for geometric queries like finding tangent angles, normals, and intersection points. - **Wire Class**: - Represents a connected sequence of edges forming a continuous path. - Supports operations such as closure, projection, and edge manipulation. - **Mixin1D**: - Shared functionality for both `Edge` and `Wire` classes, enabling splitting, extrusion, and 1D-specific operations. This module integrates deeply with OpenCascade, leveraging its robust geometric and topological operations. It provides utility functions to create, manipulate, and query 1D geometric entities, ensuring precise and efficient workflows in 3D modeling tasks. license: Copyright 2025 Gumyr Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ) annotationsN)Iterable) combinations)radiansinfpicoscopysignceilfloor)Literaloverload TYPE_CHECKING)Self)ndarray)minimize) ConvexHull) BRep_Tool)BRepAdaptor_CompCurveBRepAdaptor_Curve)BRepAlgoAPI_CommonBRepAlgoAPI_SectionBRepAlgoAPI_Splitter)BRepBuilderAPI_DisconnectedWireBRepBuilderAPI_EmptyWireBRepBuilderAPI_MakeEdgeBRepBuilderAPI_MakeFaceBRepBuilderAPI_MakePolygonBRepBuilderAPI_MakeWireBRepBuilderAPI_NonManifoldWire)BRepExtrema_DistShapeShape)BRepFilletAPI_MakeFillet2d) BRepGPropBRepGProp_Face)BRepLibBRepLib_FindSurface)BRepOffset_MakeOffset)BRepOffsetAPI_MakeOffset)BRepPrimAPI_MakeHalfSpace)BRepProj_Projection) BRepTools)GC_MakeArcOfCircleGC_MakeArcOfEllipse)GCPnts_AbscissaPoint) GProp_GProps)Geom_BezierCurveGeom_ConicalSurfaceGeom_CylindricalSurface Geom_Plane Geom_SurfaceGeom_TrimmedCurve Geom_Line) Geom2d_Curve Geom2d_LineGeom2d_TrimmedCurve)Geom2dAPI_InterCurveCurve) GeomAPI_IntCSGeomAPI_InterpolateGeomAPI_PointsToBSplineGeomAPI_ProjectPointOnCurve)GeomAbs_JoinType)GeomAdaptor_Curve)GeomFill_CorrectedFrenetGeomFill_FrenetGeomFill_TrihedronLaw)HLRAlgo_Projector) HLRBRep_AlgoHLRBRep_HLRToShape)ShapeAnalysis_FreeBounds)ShapeFix_ShapeShapeFix_Wireframe)Standard_FailureStandard_NoSuchObject)TColStd_Array1OfRealTColStd_HArray1OfBooleanTColStd_HArray1OfReal)TColgp_Array1OfPntTColgp_Array1OfVecTColgp_HArray1OfPnt)TopAbs_OrientationTopAbs_ShapeEnum)TopExpTopExp_Explorer)TopLoc_Location)TopTools_HSequenceOfShape)TopTools_IndexedDataMapOfShapeListOfShapeTopTools_ListOfShape)TopoDSTopoDS_Compound TopoDS_Edge TopoDS_Face TopoDS_Shape TopoDS_Shell TopoDS_Wire) gp_Ax1gp_Ax2gp_Ax3gp_Circgp_Dirgp_Dir2dgp_Elipsgp_Pntgp_Pnt2dgp_Trsfgp_Vec)AngularDirectionCenterOf FrameMethodGeomTypeKeepKind PositionModeSide) DEG2RAD TOLERANCEAxisColorLocationPlaneVector VectorLikelogger) Shape ShapeList SkipClean TrimmingTooldowncastget_top_level_topods_shapes shapetype topods_dimunwrap_topods_compound)_extrude_topods_shape isclose_b_make_topods_face_from_wires_topods_bool_op)topo_explore_common_vertexVertex)FaceShell)Solid)CompoundCurveSketchPartceZdZdZed.dZed/dZed/dZed/dZed0dZ ed0dZ ed0dZ e d1d Z e d2d Z d3d Zd4d Zd4d Zd5dZej(fd6dZd7dZd8dZd9dZd:dZej6ej:df d;dZej6ej:df ddZ&e'jPf d?dZ)ej6f d@dZ*ej6f dAdZ+ dB dCdZ, dD dEd Z-e. dFd!Z/e.dGd"Z/e.dHd#Z/e.dId$Z/e0jbfdJd%Z/d:d&Z2d'ej6e'jPf dKd(Z3d'ej6f dLd)Z4dMd*Z5dNd+Z6dOd,Z7dPd-Z8y)QMixin1Dz+Methods to add to the Edge and Wire classescy)zDimension of Edges and Wiresr}selfs i/workspace/moltex-experiments/.pixi/envs/default/lib/python3.12/site-packages/build123d/topology/one_d.py_dimz Mixin1D._dimscn|j tdtj|jS)z#Are the start and end points equal?z/Can't determine if empty Edge or Wire is closed)wrapped ValueErrorr IsClosed_srs r is_closedzMixin1D.is_closeds/ << NO O##DLL11rc|j td|jjtjk(S)z*Does the Edge/Wire loop forward or reversez/Can't determine direction of empty Edge or Wire)rr OrientationrRTopAbs_FORWARDrs r is_forwardzMixin1D.is_forwards9 << NO O||'')-?-N-NNNrc*t|}|Dcgc]}t||jdz }}t|d|dd}|j |j }t |tj}|jScc}w)a1 Check if the edge is an interior edge. An interior edge lies between surfaces that are part of the body (internal to the geometry) and does not form part of the exterior boundary. Returns: bool: True if the edge is an interior edge, False otherwise. drr}F) PerformNow) topo_explore_connected_facesoffset_topods_facelengthrBuildr~rUta TopAbs_EDGEMore)rtopods_face_pairfoffset_face_pair sectionorface_intersection_resultexplorers r is_interiorzMixin1D.is_interiors8=>N >N q$++"3 4>N  ( Q !1!!4  #,??#4 ##;R^^L}} s BcHtj|jS)zEdge or Wire length)r.Length_s geom_adaptorrs rrzMixin1D.lengths$,,T->->-@AArc|j} |j}|j S#ttf$r}t d|d}~wwxYw)a Calculate the radius. Note that when applied to a Wire, the radius is simply the radius of the first edge. Args: Returns: radius Raises: ValueError: if kernel can not reduce the shape to a circular edge z&Shape could not be reduced to a circleN)rCirclerKrJrRadius)rgeomcircerrs rradiuszMixin1D.radius sY  " P;;=D{{}&'78 PEFC O Ps2A A  Acy)z>volume - the volume of this Edge or Wire, which is always zerorrs rvolumezMixin1D.volumesrctjttjttj t i}t|}||t|S)z6Returns the right type of wrapper, given a OCCT object) r TopAbs_VERTEXrrEdge TopAbs_WIREWirerr)clsobjconstructor_lut shape_types rcastz Mixin1D.cast&sI   f NND NND  s^ *z*8C=99rctS)z9Unused - only here because Mixin1D is a subclass of Shape)NotImplementedrr directions rextrudezMixin1D.extrude5s rc|g}n@t|tr|gn|Dcgc] }|t|jD]}|"}}}|s|St d|Ds t d|Dcgc]}t j|}}|Dcgc]}|jD]}|}}}|j!t|dk(r|d} n3 t|} n& t|jt|z} t j"r t| t$s| j#} t| jdk(r| j'} | S| } | Scc}}wcc}wcc}}w#t$rA|dj|dd} t|jdk(rt|| } YwxYw#t$r|j|} YwxYw)z"fuse shape to wire/edge operator +Nc38K|]}t|dk(yw)r}N)r).0summands r z"Mixin1D.__add__..RsD8:g&!+8sz0Only shapes with the same dimension can be addedr}r) isinstancer~rrallrrredgeslenr Exceptionfusetypeorderrrcleanlistedge) rothersummandsoshapesre summand_edges sum_shapes r__add__zMixin1D.__add__>s =H &0u%=5'5HIA=8CE D H KD8DDOP P.66XGLLOX6*2L(wGMMOqO( L << 8}!$QK : $] 3I  1  -0H!HI  ??:i#>!)I),IOO,=(>!(CINN$ JS Q7L!: 0 0 0(12, ?IDz''1,$.DJy$9 : 1%DIIx0  1s6%E$+E*E/ E5%G5AF?>F?GGc$|j|S)zPosition on wire operator @ position_atrpositions r __matmul__zMixin1D.__matmul__q))rc$|j|S)zTangent on wire operator %) tangent_atrs r__mod__zMixin1D.__mod__usx((rc$|j|S)zLocation on wire operator ^ location_atrs r__xor__zMixin1D.__xor__yrrcd|tjk(r|jd}|S|tjk(rEt }t j |j|t|j}|S|tjk(r|jj}S)zCenter of object Return the center based on center_of Args: center_of (CenterOf, optional): centering option. Defaults to CenterOf.GEOMETRY. Returns: Vector: center ?) rmGEOMETRYrMASSr/r#LinearProperties_srrz CentreOfMass BOUNDING_BOX bounding_boxcenter)r center_ofmiddle propertiess rrzMixin1D.center}s )) )%%c*F (-- '%J  ( (z BJ3356F (// /&&(//1F rc g}|g|Dcgc]}|| }}td|Dr tdd}|Dcgc]}|jD]}|}}}td|Dr|Dcgc]}t |dz|dz} }tdt | dDrY| dj } | dj} | djj} t| | jd }|ttd |} td |}|Dcgc]}|jd d }}| |z}|D]`}|jt j"k(rdnd}|j%t'|Dcgc]}|j)||dz z c}btt+|}i}t |dD];}|d|dz }|d|dz }d |j-|j.z}|||<=|t1t|j3d}|d|dz j5} |d|dz j-| } tt7|t9ddddz | jd tfd|D}|r}|Sd}|S|Scc}wcc}}wcc}wcc}wcc}w#t$rd}Y|SwxYw)acommon_plane Find the plane containing all the edges/wires (including self). If there is no common plane return None. If the edges are coaxial, select one of the infinite number of valid planes. Args: lines (sequence of Edge | Wire): edges in common with self Returns: None | Plane: Either the common plane or None Nc3JK|]}t|ttf ywN)rrr)rlines rrz'Mixin1D.common_plane..sHid:dT4L11is!#zOnly Edges or Wires are validc3VK|]!}|jtjk(#ywr ) geom_typeroLINErrs rrz'Mixin1D.common_plane..s?Yq{{hmm+Ys')rc3DK|]\}}|j|ywr ) is_coaxial)ra0a1s rrz'Mixin1D.common_plane..s L3KR2==$3Ks )z_dir)rrc |jdkSNgd~QJrr s rz&Mixin1D.common_plane..s DKK44Grc |jdkDSrrrs rrz&Mixin1D.common_plane..s t1Crr r})originrc3@K|]}j|ywr contains)rpc_planes rrz'Mixin1D.common_plane..sA&QW--a0&)anyrrrrvrrrto_planex_dirry shift_originrfiltertrim_to_lengthr ror extendrangersetcrossrsortedkeys normalizedsumrz)rlinespointsr  all_linesresultlr all_edgesas_axisrr(r normal_linesinfinite_linesshortened_lines num_pointsi extreme_areassubsetvector1vector2areaextremescommonr$s @r common_planezMixin1D.common_planes ""^U^( +Tt/?D^ (  HiH H<= =,5 IIqqwwy!yI I ?Y? ?3<=9atAE1q5)9G=L<3KLL ,, ,, ++-33e4 --f5 >'G STL#$CYONBPQ.Qq//R8.OQ$6I!"&..HMM"AQq  EJ:EVWEVT%%a:>&:;EVW" #f+&FM&vq1 )fQi/ )fQi/gmmG4;;<&, d# 2 %VD1C1C1E,F%G%KLHa[8A;.::u"..v6 A&AA$* 15 v q( !J=R X(    s3KKK 4K.K K /6K K.-K.c.tj|dS)zReturn the Edgerr~get_single_shapers rrz Mixin1D.edge%%dF33rcVtj|d}|jddS)z#edges - all the edges in this Shaperc@tj|jSr )r Degenerated_sr)rs rrzMixin1D.edges..si--aii8rT)reverse)r~get_shape_list filter_by)r edge_lists rrz Mixin1D.edgess1((v6 "" 8$#  rcv|j}|j}t|j|S)zhThe end point of this edge. Note that circles may have identical start and end points. )r LastParameterrzValue)rcurveumaxs r end_pointzMixin1D.end_points4 !!#""$ekk$'((rFc |j}|tjk(r|j|}n|j||jz }|t j k(r t}n t}|j|ttt} } }|j||| | |j|} t} |rH| jt| t!dddt!| j#tnS| jt| t!|j#t!| j#tt%t'| S)auLocations along curve Generate a location along the underlying curve. Args: distance (float): distance or parameter value position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. frame_method (FrameMethod, optional): moving frame calculation method. Defaults to FrameMethod.FRENET. planar (bool, optional): planar mode. Defaults to False. Returns: Location: A Location object representing local coordinate system at the specified distance. rr})rrr PARAMETERparam_atrrnFRENETrBrASetCurverkD0rUrjSetTransformationrcreXYZrxrV) rdistance position_mode frame_methodplanarrVparamlawtangentnormalbinormalpnttransformations rrzMixin1D.location_ats'.!!# L22 2MM(+EMM(T[["89E ;-- -!#C*,C U$*Hfh ugvx0kk%     , ,sF1aOVFJJL-ABFH   , ,sF7;;=16&**,3GH&( 788rc P|Dcgc]}|j||||c}Scc}w)aLocations along curve Generate location along the curve Args: distances (Iterable[float]): distance or parameter values position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. frame_method (FrameMethod, optional): moving frame calculation method. Defaults to FrameMethod.FRENET. planar (bool, optional): planar mode. Defaults to False. Returns: list[Location]: A list of Location objects representing local coordinate systems at the specified distances. r)r distancesrbrcrdds r locationszMixin1D.locations)s80OX NWD  Q |V Di   s#c`|j}|j}|tjk(r9|j }t |j j}|S|tjk(r9|j}t |j j}|St|jd}|j}t|tr9|j}t |j j}|St!d)zCalculate the normal Vector. Only possible for planar curves. :return: normal vector Args: Returns: T) OnlyPlanezNormal not defined)rr roCIRCLErrzrv DirectionELLIPSEEllipser&rSurfacerr3Plnr) rrVgtyper return_valueell find_surfacesurfplns rrhzMixin1D.normalDs!!# HOO #<<>D!$))+"7"7"9:Lh&& &--/C!#((*"6"6"89L/t||tLL'')D$ +hhj%chhj&:&:&<= !!566rTc Rtjtjtjtj tj tji}t|tr|n t|g}t|jdk(rM|jd}|jdd|jddg}t|j} n |j} t} | j||| j!| | j#|t%| j'} t| t(r t+| d} t| t,r t| } n t/d|t0j2k7rT| j} gggg}d}| D]u}|j4t6j8k(rB|j:|j=dk(s|j:|j=dk(r|dz }b||j?|w|dxx|d z cc<|dd Dcgc] }t|}}|Dcgc]}|j=d}}|Dcgc]4}|jAdjC||j=dz 6}}|t0jDk(r|tG|d|dkD} n|tG|d|dk} |r|j=d}|j=d}| j=d}| j=d}||z jHtK|z tLkr-tNjQ||}tNjQ||}n,tNjQ||}tNjQ||}t|j| jztS||gz} | j} t| dk(r| dS| Scc}wcc}wcc}w) aB2d Offset Offsets a planar edge/wire Args: distance (float): distance from edge/wire to offset kind (Kind, optional): offset corner transition. Defaults to Kind.ARC. side (Side, optional): side to place offset. Defaults to Side.BOTH. closed (bool, optional): if Side!=BOTH, close the LEFT or RIGHT offset. Defaults to True. Raises: RuntimeError: Multiple Wires generated RuntimeError: Unexpected result type Returns: Wire: offset wire r}rrr?T)fullyzUnexpected result typer)*rqARCr? GeomAbs_Arc INTERSECTIONGeomAbs_IntersectionTANGENTGeomAbs_Tangentrrrrtrimrr(InitAddWirePerformrr~r[rr` RuntimeErrorrsBOTHr rorr arc_centerrappendrget_signed_angleLEFTintrabsrur make_liner)rrakindsideclosed kind_dictr rr topods_wireoffset_builderr offset_wire offset_edges edges_to_keepr?wireswcenterscanglesself0self1end0end1edge0edge1s r offset_2dzMixin1D.offset_2dcs4 HH&22   /DD LL*:: "$-t4< tzz|  !::<?DYYsC($))C*=>Eu+--K,,K13IdO,{+x(~++-. c? +(D9C c; 's)K78 8 499 &,,.L.0"b\MA$>>X__4OOt'7'7'::$*:*:1*==FA!!$++D1% !  a 0 0 .;Aa.@A.@UT%[.@EA3895aq}}S)5G9! A"33A8H8H8K4KL  tyy #Cq F1I(=$>? #Cq VAY(>$?@ ((+((+"..q1"..q1DL((3x=8IE NN5$7E NN5$7E NN5$7E NN5$7E"JJL;#4#4#66E5>9RR #((* "%l"3q"8|AIkI7B9s P!P?9P$c|j}tj|}t|||z|jj S)zParameter along a curve Compute parameter value at the specified normalized distance. Args: d (float): normalized distance (0.0 >= d >= 1.0) Returns: float: parameter value )rr.rFirstParameter Parameter)rrarVrs rr[zMixin1D.param_atsK!!#%..u5# 6H$e&:&:&< )+ rc|j|}t||j||j}tj ||j |zdz z||j |zdz z }|S)aperpendicular_line Create a line on the given plane perpendicular to and centered on beginning of self Args: length (float): line length u_value (float): position along line between 0.0 and 1.0 plane (Plane, optional): plane containing perpendicular line. Defaults to Plane.XY. Returns: Edge: perpendicular line )rr(rr)rryrrrry_dir)rru_valueplanestart local_planer s rperpendicular_linezMixin1D.perpendicular_linesy  ) 8  ~~ K%%.2 2 K%%.2 2  rc|j}|tjk(r|j|}n|j||jz }t |j |S)a`Position At Generate a position along the underlying curve. Args: distance (float): distance or parameter value position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. Returns: Vector: position on the underlying curve )rrrrZr[rrzrU)rrarbrVres rrzMixin1D.position_atsY!!# L22 2MM(+EMM(T[["89Eekk%())rcL|Dcgc]}|j||c}Scc}w)aoPositions along curve Generate positions along the underlying curve Args: distances (Iterable[float]): distance or parameter values position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. Returns: list[Vector]: positions along curve r)rrmrbrns r positionszMixin1D.positionss*"=FFIq  M2IFFFs!c|j tdt|j|jt|j }|j }|rt }|j|jt}t|D]P}|j||j|j} | |ks:| }tj|} R Stdt|D} | S)zProject onto a face along the specified direction Args: face: Face: direction: VectorLike: closest: bool: (Default value = True) Returns: z#Can't project an empty Edge or Wirec3FK|]}tj|ywr )rr)rrs rrz"Mixin1D.project..Cs%1T U#1Ts!)rrr*rzto_dirr~r!LoadS1rrLoadS2rrUrrr) rfacerclosestbldrshapes dist_calcmin_distrdistrys rprojectzMixin1D.projects << BC C" LL$,,y(9(@(@(B #'**, 24I   T\\ *H5V<  '!!# ((?#H#*<<#6L= %%1LV1T%LrNcd}t}|j|jt|}|r t|n|j }||z j }t|j }t }|jt|j|j|j|jt|}|j||j|jt!|} g} | j#| j%| j'fD]3} | j)r| j+|t-| 5g} | j/| j1| j3fD]3} | j)r| j+|t-| 5| D]} t5j6| t8| D]} t5j6| t8t;d| D} t;d| D} | | fS)aproject_to_viewport Project a shape onto a viewport returning visible and hidden Edges. Args: viewport_origin (VectorLike): location of viewport viewport_up (VectorLike, optional): direction of the viewport y axis. Defaults to (0, 0, 1). look_at (VectorLike, optional): point to look at. Defaults to None (center of shape). Returns: tuple[ShapeList[Edge],ShapeList[Edge]]: visible & hidden Edges cg}t|tj}|jrKt |j }|j ||j|jrK|Sr )rUrSrrrCurrentrNext)compoundrrrs r extract_edgesz2Mixin1D.project_to_viewport..extract_edges^saE'x1A1M1MNH--/ 0 0 23 T" --/ Lrc32K|]}t|ywr rrs rrz.Mixin1D.project_to_viewport..s!A=a$q'=c32K|]}t|ywr rrs rrz.Mixin1D.project_to_viewport..s ?,Qa,r)rEAddrrzrr2rbSetAxisrato_pntr SetYDirectionrD ProjectorUpdateHiderF VCompoundRg1LineVCompoundOutLineVCompoundIsNullr,r HCompoundOutLineHCompoundRg1LineHCompoundr%BuildCurves3d_srur)rviewport_origin viewport_uplook_atrhidden_line_removalprojection_dircamera_coordinate_system projector hlr_shapes visible_edgesr hidden_edgesrs rproject_to_viewportzMixin1D.project_to_viewportIs* +n - 1%,&/$++-"1G";!G!G!I[)446 #)8  (( ?))+^-B-B-D E  !..{/A/A/CD%&>? %%i0""$  "'(;<   "  ' ' )  ' ' ) E <<>$$]8E?%CD    "  ' ' )  ' ' ) E <<>##M(5/$BC  "D  # #D) 4" D  # #D) 4!"!A=!AA  ?, ?? |,,rcy)z split and keep inside or outsideNrrtoolkeeps rsplitz Mixin1D.splitrcy)z%split and return the unordered piecesNrrs rrz Mixin1D.splitrrcy)z!split and keep inside and outsideNrrs rrz Mixin1D.splitrrcy)zsplit and keep inside (default)Nr)rrs rrz Mixin1D.splitrrc8t}|jjt|tr#t |jj n |j}t}|j|t}|j||j||jt|j}t|tr t|d}|tj k(rt#fdt%|DSt|ts&t|t&r>t)|t*j,}t/j0|j3} n|} t5} t7} t9j:| \} } }}t=| j?| | zdz ||zdz | | tA| jC| jE| jGjI}tA| } | |z}tK||jM}|jO}g}g}tQ}t%|D]}jRjU|}t|tr-|jW|jYjFdk\}nDt[|fft]}t_j`|||jctdk\}|r|n|jg||sdnti|dk(r|dn|}|sdnti|dk(r|dn|}|tjjk(r||fS|tjlk(r|S|tjnk(r|Sy)aHsplit Split this shape by the provided plane or face. Args: surface (Plane | Face): surface to segment shape keep (Keep, optional): which object(s) to save. Defaults to Keep.TOP. Returns: Shape: result of split Returns: Self | list[Self] | None, Tuple[Self | list[Self] | None]: The result of the split operation. - **Keep.TOP**: Returns the top as a `Self` or `list[Self]`, or `None` if no top is found. - **Keep.BOTTOM**: Returns the bottom as a `Self` or `list[Self]`, or `None` if no bottom is found. - **Keep.BOTH**: Returns a tuple `(inside, outside)` where each element is either a `Self` or `list[Self]`, or `None` if no corresponding part is found. Tc3TK|]}jj|!ywr ) __class__r)rpartrs rrz Mixin1D.split..s(ED##D)Es%(rrNr})8rYAppendrrryrrr SetArgumentsSetToolsrrr~r[rrpALLrrr_rUr TopAbs_FACErZFace_srrhrkr+ UVBounds_sr$NormalrzXYZr2r)rrr/rrto_local_coordsrrrr#rMassrurrrTOPBOTTOM)rrr shape_list trim_tool tool_listsplitter split_result faceExplorer tool_face surface_pointsurface_normalu_minu_maxv_minv_maxnormalized_surface_normal ref_pointhalfSpaceMaker tool_solidtopsbottomsrr sub_shapeis_up is_up_objtopbottoms` rrz Mixin1D.splits,*+ $,,' $& $DLL 1 6 6 8  )* #() j))$  01 lO 41,EL 488 7 E  $&)\2.y"..I "MM,*>*>*@A % #HM#XN)2)=)=i)H &E5% 9 % , ,!#eemq%8- )/  "N$4$4$68H8H8J)jl &#=1M%(AAI7y)BRBRBTUN'--/J!!^ / =D++D1I$&,,Y7>>@BBaG,Gj],>,@ ,,Y C")Y6T / / :>ds4yA~DG4$G 8I'!*w 499 = 488 J 4;; Mrcv|j}|j}t|j|S)ziThe start point of this edge Note that circles may have identical start and end points. )rrrzrU)rrVumins r start_pointzMixin1D.start_point%s4 !!###%ekk$'((rrc|j||}|jj||jdzdz}|S)atangent_angle_at Compute the tangent angle at the specified location Args: location_param (float, optional): distance or parameter value. Defaults to 0.5. position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. plane (Plane, optional): plane line was constructed on. Defaults to Plane.XY. Returns: float: angle in degrees between 0 and 360 hv@)rr(rr)rlocation_paramrbr tan_vectorangles rtangent_angle_atzMixin1D.tangent_angle_at/s>&__^]C --j%++FLPUU rc2t|ttfrT|j}|tj k(r|j |}n|j ||jz }n t|}|j}t|D cgc]\}} | j||f} }} t| d} || dd} | j d} | j d}tj | j"| |}t%|j'|}|j)}t+}t-}|j/|||tt1|S#t$r}td|d}~wwxYwcc} }w)a/tangent_at Find the tangent at a given position on the 1D shape where the position is either a float (or int) parameter or a point that lies on the shape. Args: position (float | VectorLike): distance, parameter value, or point on shape. Defaults to 0.5. position_mode (PositionMode, optional): position calculation mode. Defaults to PositionMode.PARAMETER. Raises: ValueError: invalid position Returns: Vector: tangent value z#position must be a float or a pointNc |dSNrrxs rrz$Mixin1D.tangent_at..ksqtrkeyrr})rfloatrrrrrZr[rrzrrr enumerate distance_tor0rCurve_srr>rLowerDistanceParameterrhrkD1re)rrrbrV parameterrjexcmy_edgesr?rrmsorted_distances closest_edgefirstlastrtmpress rrzMixin1D.tangent_atFsm, h -%%'E 6 66 MM(3  MM(T[[*@A  QX& $(::rs rrz Mixin1D.wiress##D&11r)returnr)rCbool)rCr,)rr^rCzVertex | Edge | Wire)rr~rr{rCz&Edge | Face | Shell | Solid | Compound)rzNone | Shape | Iterable[Shape]rCzEdge | Wire | ShapeList[Edge])rr,rCrz)rr,rCrx)rrmrCrz)r4zEdge | Wire | NonerCz None | Plane)rC Edge | NonerCShapeList[Edge]rCrz) rar,rbrrrcrnrdrDrCrx) rmIterable[float]rbrrrcrnrdrDrClist[Location]) rar,rrqrrsrrDrC Edge | Wire)rar,rCr,)rr,rr,rryrCr)rar,rbrrrCrz)rmrIrbrrrCz list[Vector]T)rrrr{rrDrCz$Edge | Wire | ShapeList[Edge | Wire])rrr}N)rr{rr{rVectorLike | NonerCz'tuple[ShapeList[Edge], ShapeList[Edge]])rrrzLiteral[Keep.TOP, Keep.BOTTOM]rCSelf | list[Self] | None)rrrzLiteral[Keep.ALL]rCz list[Self])rrrzLiteral[Keep.BOTH]rCz9tuple[Self | list[Self] | None, Self | list[Self] | None])rrrCrO)rrrrp)r!r,rbrrrryrCr,)rzfloat | VectorLikerbrrrCrz)rCz Vertex | None)rCzShapeList[Vertex])rCz Wire | None)rCShapeList[Wire])9__name__ __module__ __qualname____doc__propertyrrrrrrr classmethodrrrrrrrmrrrGrrrXrrrZrnr\rrorhrqrrsrrr[ryXYrrrrrrrrprrr$rr<r?rArrrrrrs522 OO 6BB*  : :$. /131 &1f*)*,4+<+<*IV4 )'3&<&<$/$6$6 5959$59" 59  59  59t'3&<&<$/$6$6  " $ "      6DXXYY _J_J_J _J  _J  _JB&=BHH&+49 4>J=S=S**.:* *6'3&<&<G"G$G  G(BF--%/-:>- --d#,%) V-#V- V-# V- 1 V-p/ /(F/ !// 4400 ..6:XXm^)!$&2&<&<xx $   2(+&2&<&<3#$3#$3#  3#j6442rrceZdZdZdZ d! d"fd Zed#dZed$dZ edd d%dZ ee jd d e jf d&d Zee jd d e jf d'd Ze d( d)d Zed*dZed+d,dZe d- d.dZe d/ d0dZe d1dZe d2dZd3dZ d4 d5dZdef d6dZ d7dZd8dZ d9dZd:dZ d; ddZ"d?dZ#d@dZ$dAd Z%xZ&S)BraAn Edge in build123d is a fundamental element in the topological data structure representing a one-dimensional geometric entity within a 3D model. It encapsulates information about a curve, which could be a line, arc, or other parametrically defined shape. Edge is crucial in for precise modeling and manipulation of curves, facilitating operations like filleting, chamfering, and Boolean operations. It serves as a building block for constructing complex structures, such as wires and faces.rNct|trStt|jj |j jj}t|)||||y)aDBuild an Edge from an OCCT TopoDS_Shape/TopoDS_Edge Args: obj (TopoDS_Edge | Axis, optional): OCCT Edge or Axis. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. rlabelcolorparentN) rrvrr6rrrrrsuper__init__)rrr[r\r]rs rr_z Edge.__init__sm c4 )LL'')MM((* df    rc~|j}|j}|tjk(r7t |j j j}|S|tjk(r7t |jj j}|St|d)z3center of an underlying circle or ellipse geometry.z has no arc center) r rrorrrzrPositionrxrtrur)rr rrys rrzEdge.arc_centersNN ((*  '!,"5"5"7"@"@"B"K"K"MNL  (** *!,"6"6"8"A"A"C"L"L"NOL {*<=> >rcfttjt|j|S)a1extrude Extrude a Vertex into an Edge. Args: direction (VectorLike): direction and magnitude of extrusion Raises: ValueError: Unsupported class RuntimeError: Generated invalid result Returns: Edge: extruded shape )rrZEdge_srrrs rrz Edge.extrudes$ FMM"7 Y"OPQQr)weightsc|t|dkr tdt|dkDr td|r"t|t|k7r td|Dcgc]}t|j}}t dt|}t |D]\}}|j |dz||rStdt|}t |D]#\}} |j |dzt| %t||} n t|} |t| jScc}w)amake_bezier Create a rational (with weights) or non-rational bezier curve. The first and last control points represent the start and end of the curve respectively. If weights are provided, there must be one provided for each control point. Args: cntl_pnts (sequence[VectorLike]): points defining the curve weights (list[float], optional): control point weights list. Defaults to None. Raises: ValueError: Too few control points ValueError: Too many control points ValueError: A weight is required for each control point Returns: Edge: bezier curve rz9At least two control points must be provided (start, end)z*The maximum number of control points is 25z0A weight must be provided for each control pointr}) rrrzrrOr-SetValuerLr,r0rr) rrd cntl_pntscntl_pnt cntl_gp_pntspolesr? cntl_gp_pnt pole_weightsweight bezier_curves r make_bezierzEdge.make_beziers), y>A K  y>B IJ J 9~W- !STTBKL)hx(//1) L#1c,&78' 5NA{ NN1q5+ .6 /3w<@L&w/ 6%%a!eU6];0+E<@L+E2L*<8==?@@Ms D9r rct|j|}||k(r!|t|j}|S|tj k(}|rt |} t |} nt |} t |} t|| | |j} |t| j}|S)a1make circle Create a circle centered on the origin of plane Args: radius (float): circle radius plane (Plane, optional): base plane. Defaults to Plane.XY. start_angle (float, optional): start of arc angle. Defaults to 360.0. end_angle (float, optional): end of arc angle. Defaults to 360. angular_direction (AngularDirection, optional): arc direction. Defaults to AngularDirection.COUNTER_CLOCKWISE. Returns: Edge: full or partial circle ) rd to_gp_ax2rrrlCOUNTER_CLOCKWISErr,rU) rrr start_angle end_angleangular_direction circle_gpryccwrend circle_geoms r make_circlezEdge.make_circles0EOO-v6 ) #6yAFFHIL$'7'I'IIC ,i( *k*,YsCHNNPK6{CHHJKLrc8t|jj|jj }||kDr5dt z}t |j||j||} nd}t |j||} ||k(r!|t| j} | St| |t z|z |t z|z |tjk(j} |t| j} | S)amake ellipse Makes an ellipse centered at the origin of plane. Args: x_radius (float): x radius of the ellipse (along the x-axis of plane) y_radius (float): y radius of the ellipse (along the y-axis of plane) plane (Plane, optional): base plane. Defaults to Plane.XY. start_angle (float, optional): Defaults to 360.0. end_angle (float, optional): Defaults to 360.0. angular_direction (AngularDirection, optional): arc direction. Defaults to AngularDirection.COUNTER_CLOCKWISE. Returns: Edge: full or partial ellipse gV@r)rarrrrrtrgrrRotatedrrr-rlrsrU) rx_radiusy_radiusrrtrurvax1correction_angle ellipse_gpellipse ellipse_geoms r make_ellipsezEdge.make_ellipse8s4U\\((*EKK,>,>,@A h  $g~ !%//"3XxHPP%J # !%//"3XxHJ ) #1*=BBDEG/g%(88G#&66!%5%G%GG  eg  1,?DDFGGrc|dk(rEttt|jt|j |}nLt tt|jt|j |t z|}|rdnd} t| dztz|j} || jz tt|z } ttddt| j| j} t!| d| d} t#| |}|j%}t'j(|dd ||S) amake_helix Make a helix with a given pitch, height and radius. By default a cylindrical surface is used to create the helix. If the :angle: is set (the apex given in degree) a conical surface is used instead. Args: pitch (float): distance per revolution along normal height (float): total height radius (float): center (VectorLike, optional): Defaults to (0, 0, 0). normal (VectorLike, optional): Defaults to (0, 0, 1). angle (float, optional): conical angle. Defaults to 0.0. lefthand (bool, optional): Defaults to False. Returns: Wire: helix rrr}rrT)theAdjustPeriodic& .>i) MaxSegment)r2rcrzrrr1rtrr2rr rr8rirfrr9rrr%r)rpitchheightrrrhr#lefthand geom_surf line_signline_dirline_len helix_line helix_curve edge_builder topods_edges r make_helixzEdge.make_helixms+> C<&=vf~,,.v0E0E0GH&'I,vf~,,.v0E0E0GHI#B )a-",e4??AXZZ'3wu~+>>!!Q(**hjj1QR ) 8t /{IF "'')   TdC;rc|tt|jt|jjS)aCreate a line between two points Args: point1: VectorLike: that represents the first point point2: VectorLike: that represents the second point Returns: A linear edge between the two provided points )rrzrr)rpoint1point2s rrzEdge.make_lines? #v%%')>)>)@ df  rc 8|jj|j}dDcgc]L}tj|j ||j |rd|z n|j |N}}tj|Scc}w)amake line between edges Create a new linear Edge between the two provided Edges. If the Edges are parallel but in the opposite directions one Edge is flipped such that the mid way Edge isn't truncated. Args: first (Edge): first reference Edge second (Edge): second reference Edge middle (float, optional): factional distance between Edges. Defaults to 0.5. Returns: Edge: linear Edge between two Edges )rr}r})to_axis is_oppositerrr)rr7secondrflipr?pntss r make_mid_wayzEdge.make_mid_ways }}**6>>+;<    NN!!!$f&8&8$QA&N k&! "  ~~t$$  sABc|Dcgc] }t|}}|rtd|D} tdt|} t |D](\} }| j | dz|j *|t| ||} nt|t||zk7r#tdt|dt|tdt|} t |D]\}}| j |dz|t| | ||} |rt dk(r.s#@x!F1Ixrr}NzuThere must be one parameter for each interpolation point (plus one if periodic), or none specified. Parameter count: z, point count: rrzgThere must be one tangent for each interpolation point, or just two end point tangents. Tangent count: zB-spline interpolation failed)rztuplerQrr-rgrr<rrNLoadrrPrMrIsDonerrr)rr5tangentsperiodic parametersscaletolpoint point_vectorstangent_vectorsrr?spline_builderparameters_arrayp_indexp_valuetangents_arraytangent_enabled_arrayt_indext_value tangent_vec spline_geoms r make_splinezEdge.make_splinesV5;;F5F ; ##@x#@@O"1c-&89!-0HAu MM!a% 01  0xEN:3}#5#@A S:'s=7I6JL 5QJH $-j$9  ))'A+w?%:17GSVWN ?#q(S-?1-D###A&..0B0J0JE'3}+==$J/0M@R?SU"4As?7K!L(@s?+)%)2/(B$GW)227Q;t@ST-4-@'fhK"++GaK9L9LM)C ##N4I5Q $$&<= =$**, *;7<<>??m??rctt|jt|jt|jj }|t |j S)a4Tangent Arc Makes a tangent arc from point start, in the direction of tangent and ends at end. Args: start (VectorLike): start point tangent (VectorLike): start tangent end (VectorLike): end point Returns: Edge: circular arc )r,rzrrrUrr)rrrgryrzs rmake_tangent_arczEdge.make_tangent_arcls_ ) 5M "F7O$;$;VC[=O=O=Q %' *;7<<>??rctt|jt|jt|jj}|t |j S)a6Three Point Arc Makes a three point arc through the provided points Args: point1 (VectorLike): start point point2 (VectorLike): middle point point3 (VectorLike): end point Returns: Edge: a circular arc through the three points )r,rzrrUrr)rrrpoint3rzs rmake_three_point_arczEdge.make_three_point_arcsb ) 6N ! ! #VF^%:%:%S>S>U %' *;7<<>??rcZ|jst|gj}|S|}|S)z Close an Edge)rrclose)rrys rrz Edge.closes2~~<--/L Lrc|dkr tdt|Dcgc]}||||z z|dz z z}}|j|}|r|D]}tddd|_|Scc}w)a6Distribute Locations Distribute locations along edge or wire. Args: self: Wire:Edge: count(int): Number of locations to generate start(float): position along Edge|Wire to start. Defaults to 0.0. stop(float): position along Edge|Wire to end. Defaults to 1.0. positions_only(bool): only generate position not orientation. Defaults to False. Returns: list[Location]: locations distributed along Edge|Wire Raises: ValueError: count must be two or greater rzcount must be two or greaterr}r)rr-rorz orientation) rcountrstoppositions_onlyr?t_valuesrolocs rdistribute_locationszEdge.distribute_locationss~2 19;< &> LL    MM!  MM!  '   *3*B*B !q!q! +M4}iK4M9MK;//12 2 ;$$QU+--/1B1B1q51I1K1K1M N2  8??w!5**1-w? C $((-:!--c2i?%,,S1'', 9%,,S1''1 @   s AK*K  A-K KKcd|dz}|jtjk(r|jd|k(rdg}|Sg}|St |j }g}d}d}t d|z D]^}|j|dz |dzz}|(t||z dkDrtd||z }|d|zz }|}|j|dz |f`tj|} | j} dt| jjdz z} dt!| j"jdz z} g} t | | d zdD]D}tj%d||zdfd||zdf}| j'| j)|F| Dcgc]}|j*}}|Scc}w) zfind_tangent Find the parameter values of self where the tangent is equal to angle. Args: angle (float): target angle in degrees Returns: list[float]: u values between 0.0 and 1.0 rrNreri,rr})r ror r$rrr-rr rrrrr minrr maxrr,rr)rr#u_valuesrtan_pntsprevious_tangentdiscontinuitiesr?rg tan_curvetan_curve_bbox min_range max_rangeintercept_pntsr r#s r find_tangentzEdge.find_tangents  >>X]] *$$Q'503NKJE4>>*H)+H# "O3>*//C8?S;PP$0,w67#=&.s4Dw4N&OOs_44G#* S' 23+((2I'335Nu^%7%7%9%9C%?@AItN$6$6$8$83$>?@I,.N9i!mS9~~q%!)Q&7#uqy!9LM%%i&H&H&NO:&44^^H45sF-c,t|jS)z$Return the Geom Curve from this Edge)rrrs rrzEdge.geom_adaptorSs ..rc Xg}g}g}|D]}|xtdx\|jt|,xtdx\|j|Ltdx\|j|j t dt |g}t |g|zdD]3}|dj|d}|jt|5td|jD} td|D} tj| | } tj|g|z|D]\} tj| j| j!d| j!d} t#j$}t'| |}g}|j)rAt+|j-Dcgc]}t/|j1|dz!}}|jt|t3fd | j5d t+d DDs |j| |j7|tj|}|j9| Dcgc] }t;|}}g}|r*|j=|f|t?jA}|s|rPtC|dk(rtC|dk(r|dStC|dk(rtC|dk(r|dStE||zSycc}wcc}w) zintersect Edge with Edge or Axis Args: other (Edge | Axis): other object Returns: Shape | None: Compound of vertices and/or edges rNzUnknown object type: rrr}c32K|]}t|ywr rrs rrz!Edge.intersect..ysAAfQirc3\K|]$}|jD]}t|&ywr )r?rz)rrrs rrz!Edge.intersect..zs#SED4==?afQi?iEs*,c3@K|]}j|ywr r!)rrrs rrz!Edge.intersect..s+Raq!+Rr%c3&K|] }|dz  yw)Nr)rr?s rrz!Edge.intersect..s9RA!a%sr)#rvrrryrrrrr.r? intersection itertoolsproductrr/rr[r3local_coord_systemr;rr-rrzrrrr,unionr_bool_oprrrr)r to_intersectrplanesedges_common_to_planesr points_sets edge_pairintersection_pointsself_end_pointsedge_end_pointscommon_end_pointsr geom_line geom_planeintersection_calculatorplane_intersection_pointsr? common_pointsrjcommon_vertices common_edgesrs @r intersectzEdge.intersectWs -/CTVLLc+TVLL%WMM#&$'+/>>9Rq9R+R'--d3'E*  +,((+6 #0#6#67H#I #ICF3K#I  $& ==$%9K9MNTTVL l?#q(S->!-C&q))?#q(S->!-C#A&_|;< <A-  s $L" L'c fttjdtst ddd fd }t dt djdz jjz }t||dd gt }t|jd}|S) z(Normalized parameter at point along Edger)abs_tolzpoint (z) is not on edgecFj|dz jSr')rr)rerrs rfuncz!Edge.param_at_point..funcs#$$U1X.6>> >rrrz Nelder-Mead)rr)x0methodboundsr)rerrCr,) rzrr.rurrrrrrr,r))rrr initial_guessr7rs`` rparam_at_pointzEdge.param_at_points u ))%0!YGwug-=>? ? ? S54#3#3A#66>>LM   <   $rct|g}|j|||}|Dcgc]}|jd}}|Scc}w)aProject Edge Project an Edge onto a Shape generating new wires on the surfaces of the object one and only one of `direction` or `center` must be provided. Note that one or more wires may be generated depending on the topology of the target object and location/direction of projection. To avoid flipping the normal of a face built with the projected wire the orientation of the output wires are forced to be the same as self. Args: target_object: Object to project onto direction: Parallel projection direction. Defaults to None. center: Conical center of projection. Defaults to None. target_object: Shape: direction: VectorLike: (Default value = None) center: VectorLike: (Default value = None) Returns: : Projected Edge(s) Raises: ValueError: Only one of direction or center must be provided r)rproject_to_shaper)r target_objectrrrAprojected_wiresrprojected_edgess rrzEdge.project_to_shapesM>TF|// y&Q1@AA1779Q<ABsAcZtj|}|jd}|jd}tj|j ||}|j |}|j |}t|j||j}||_|S)z3Return a copy of self with the opposite orientationrr}) copydeepcopyr[rr/rReversedParameterrReversedr)r reversed_edger7r8rVrs rreversedz Edge.reverseds d+ }}Q'mmA&!!$,,t<''.&&t,-enn.>eLQQS + rc|jtjk7rtd|jt |j d|j d|j dz S)z"Translate a linear Edge to an Axisz+to_axis is only valid for linear Edges not rr})r ror rrvrrs rrz Edge.to_axissd >>X]] *=dnn=MN D$$Q')9)9!)= end Returns: Edge: trimmed edge zstart (z) must be less than end ()rr}) rrr/rr rr[r5rr)rrry new_curve parm_startparm_end trimmed_curvenew_edges rrz Edge.trim s C<wug-Fse1MN N%% MM$  ' 'q)94==;K ]]5) ==%)    +=9>>@H~rcztjtj|j|j d|j d}t |}|j |}t|||}|j}t|||}t|j} t| S)atrim_to_length Create a new edge starting at the given normalized parameter of a given length. Args: start (float): 0.0 <= start < 1.0 length (float): target length Returns: Edge: trimmed edge rr}) rr/rr rr[r@r.rr5rr) rrrr* adaptor_curver+abscissa_pointr,r-r.s rr+zEdge.trim_to_length+s%% MM$  ' 'q)94==;K *)4 ]]5) -mVZP"++-*)ZJ *=9>>@H~r)NNN)rz TopoDS_Edge | Axis | None | Noner[strr\ Color | Noner]Compound | NonerH)rrrr{rCr)rhr{rdlist[float] | NonerCr) rr,rryrtr,rur,rvrlrCr)r~r,rr,rryrtr,rur,rvrlrCr))rrrrMrF)rr,rr,rr,rr{rhr{r#r,rrDrCr)rr{rr{rCr)r)r7rrrrr,rCr)NFNTư>)r5list[VectorLike]rzlist[VectorLike] | NonerrDrr6rrDrr,rCr)MbP?Nr}) r5r8rr,rz!tuple[float, float, float] | NonerrrrrCr)rr{rgr{ryr{rCr)rr{rr{rr{rCr)rCrK)rrF) rz Wire | Edgerrrr,rr,rrDrCrJ)rzAxis | Edge | Nonerr,rCzShapeList[Vector])r#r,rCz list[float])rCr)rzEdge | Axis | PlanerCz/None | Vertex | Edge | ShapeList[Vertex | Edge]rr{rCr,NN)rr~rrNrrNrC list[Edge])rCr)rCrvrCr)rr,ryr,rCr)rr,rr,rCr)'rQrRrSrTrr_rUrrVrrpryrWrlrsr{rrrrrrrrrrrurrrrrrr$rr'rr+ __classcell__rs@rrrso E 15""&  -      B  "RR"CG.A#.A.@.A .A.A`xx".>.P.P %%% %  % , % %%N xx" .>.P.P222 2  2  2,2 22h '&> > >  >  >  > > >  > > @  "%%0-1)-`@ `@*`@ `@ ' `@  `@`@ `@`@D7; -@ -@-@5 -@  -@  -@ -@-@^@@)3@:D@ @@*@@)3@=G@ @@.$ #### #  #  #L+/9M('M(;@M( M(^:: :x/P0P 8Pd%T(,$( ""%"" "  "H T>rrceZdZdZdZe d d dZe d d!dZe d d"dZe d d#dZe d$ d%dZfdZed&d'd Ze d( d)d Z ed*d Z ee jfd+d Z ed,d-d Zee jddej df d.dZed/d0dZee jf d1dZe d2dZ d3 d4dZd5dZd6dZd7dZd8dZd9dZd:dZ d; ddZ xZ!S)?raxA Wire in build123d is a topological entity representing a connected sequence of edges forming a continuous curve or path in 3D space. Wires are essential components in modeling complex objects, defining boundaries for surfaces or solids. They store information about the connectivity and order of edges, allowing precise definition of paths within a 3D model.g?cy)a'Build a wire from an OCCT TopoDS_Wire Args: obj (TopoDS_Wire, optional): OCCT Wire. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Nr)rrr[r\r]s rr_z Wire.__init__Wrrcy)aBuild a Wire from an Edge Args: edge (Edge): Edge to convert to Wire label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Nr)rrr[r\r]s rr_z Wire.__init__hrrcy)aPBuild a Wire from an Wire - used when the input could be an Edge or Wire. Args: wire (Wire): Wire to convert to another Wire label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. NrrrAr[r\r]s rr_z Wire.__init__yrrcy)aBuild a Wire from an Curve. Args: curve (Curve): Curve to convert to a Wire label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. NrrEs rr_z Wire.__init__rrcy)awBuild a wire from Edges Build a Wire from the provided unsorted Edges. If sequenced is True the Edges are placed in such that the end of the nth Edge is coincident with the n+1th Edge forming an unbroken sequence. Note that sequencing a list is relatively slow. Args: edges (Iterable[Edge]): Edges to assemble sequenced (bool, optional): arrange in order. Defaults to False. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Nr)rr sequencedr[r\r]s rr_z Wire.__init__rrc d\ }}}}}}} } } |rt|} t|dtr|dddd| z zz\}} } } nt|dtr|dddd| z zz\}} } } nt|dtr|dddd| z zz\}} } } nt |ddrLt|dj tr/t|dj dk(r|dddd| z zz\}} } } n't|dtr|dddd| z zz\}}} } } djt|jjgd } | rtd | |jd |}|jd |}|jd |}|jd|}|jd| } |jd| } |jd| } |jd|}|jd|}||g}n||j!}| |j }n|rtj#||dn|}t$|M|| dn| | | y)N) NNNNNNNNNrrr rr}z, ) rVrArrrHrr[r\r]zUnexpected argument(s) rrrrHr[r\r]rArVFr2rZ)rrr`rrhasattrrr[rrjoinr.r1 differencergetr _make_wirer^r_)rargskwargsrVrrrArHrr[r\r]l_a unknown_argsrs rr_z Wire.__init__sITFtUD)S% d)C$q';/,0!Hw!c'7J,J)UE6DGT*-1"1X1s78K-K*eUFDGT*-1"1X1s78K-K*eUFQ+tAw@tAw/14.22AhAG9L.L+ueVDGX.9=bqGqSVwDW9W6y%yy   ) )    6|nEF Fjj$zz&$' 7E*JJ{I6  7E* 7E*Hf-zz&$' 7E*  FE  KKME  ,,C //%)2CSC  "5  rcdd}t|}|r^|jdg}|}|rF|t||}|j|}|j |j||rF|}t }t } |D]} | j| j|j| |j|js|jtk(r'tjdd|jS|jt k(r t#d|jt$k(r t'd|jS) ah_make_wire Build a Wire from the provided unsorted Edges. If sequenced is True the Edges are placed in such that the end of the nth Edge is coincident with the n+1th Edge forming an unbroken sequence. Note that sequencing a list is relatively slow. Args: edges (Iterable[Edge]): Edges to assemble sequenced (bool, optional): arrange in order. Defaults to False. Raises: ValueError: Edges are disconnected and can't be sequenced. RuntimeError: Wire is empty Returns: Wire: assembled edges cP|jdt|fd}|dS)z/Return the Edge closest to the end of last_edger}ct|jdz j|jdz jS)Nrr})rrr)r target_points rrz9Wire._make_wire..closest_to_end.. s8c!AMM!$44<<!AMM!$44<<rr*r)rr0)currentunplaced_edges sorted_edgesrWs @rclosest_to_endz'Wire._make_wire..closest_to_end s1"..q1L!L ? "rrz8Wire is non manifold (e.g. branching, self intersecting)r) stacklevelz Wire is emptyzEdges are disconnected)rXrrYr=rCr)rpoprindexrrrYrrrrrErrorr warningswarnrrrr) rrrHr[ placed_edgesrY next_edgenext_edge_index wire_buildercombined_edgesrs rrOzWire._make_wiresE* #U  !IIaL>L"N *4 +=~N "0"6"6y"A##N$6$6$GH! !E.0 -/D  ! !$,, /(""$!!#'EE N   "" ##%)AA"?33##%)HH !9::  ""rc t}t}|Dcgc]}|jD]}|c}}D]}|j|jt j ||d|t }t|jD]7}|jtt|j|dz9|Scc}}w)a combine Combine a list of wires and edges into a list of Wires. Args: wires (Iterable[Wire | Edge]): unsorted tol (float, optional): tolerance. Defaults to 1e-9. Returns: ShapeList[Wire]: Wires Fr}) rWrrrrGConnectEdgesToWires_srr-LengthrrrrU) rrredges_in wires_outrrrr?s rcombinez Wire.combine8 s -.-/ %91qwwy!QyQ9D OODLL ): !66xeYW y'')*A LLhyq1u'=>? @+ :sCctd)z$extrude - invalid operation for Wirez#Wires can't be created by extrusion)NotImplementedErrorrs rrz Wire.extrudeV s""GHHrcHtj||}t|gS)zmake_circle Makes a circle centered at the origin of plane Args: radius (float): circle radius plane (Plane): base plane. Defaults to Plane.XY Returns: Wire: a circle )r)rr{r)rrr circle_edges rr{zWire.make_circle[ s&&&vU&; [M""rc t|}td|z }i}g}t|D][\}}t|D]H}||dz z } |j |j | j dd|| f|||z|z<J]t|} g} i} | jD]+} || dd}|| dd}||k7r||| vr | dg| |<n| |j | d|| vr | dg| |<n| |j | d| j ||| dd| df||| dd| dfft| d| dz dk7st| j}t| j}|| vr||g| |<n| |j||g| j |||d|f|||d|ff.i}| jD]d\}}t|}g}tdt!|dz dD]1}||||dzk7s|j t#|||dz3|||<f| Dcgc]<}t$j'||dd|ddz||dd|ddz>}}|jDcgc]3\}}|D])}||j)||dd||dd+5}}}}t+||zd}|Scc}wcc}}}w)amake_convex_hull Create a wire of minimum length enclosing all of the provided edges. Note that edges can't overlap each other. Args: edges (Iterable[Edge]): edges defining the convex hull tolerance (float): allowable error as a fraction of each edge length. Defaults to 1e-3. Raises: ValueError: edges overlap Returns: Wire: convex hull perimeter rr}NrT)rH)rrr-r-rrto_tupler simplicesrrtolistrr,itemsr0rrrrrr)rrrfragments_per_edge points_lookupr5 edge_indexrr?re convex_hullconnecting_edge_data trim_pointssimplicerr start_pntend_pnt trim_datastart_end_pntss_pointsf_pointsr connecting_edges trim_pairs trim_pair trimmed_edges hull_wires rmake_convex_hullzWire.make_convex_hullk sTU  Y/ !*% 0 J-./!34 d..u5>>@!DEFPRWEX j+==AB/!1 !(  ",. #--H!(1+.q1E!(1+.q1E~ +*21+K&&--hqk: +*21+K&&--hqk:$++ hqk :1 =x{K hqk :1 =x{KXa[8A;./14 12 hoo/0 +*3W)=K&&--y'.BC$++ i 8 ;YG g 6q 97C7.D *5*;*;*= &Jn-HH1c(ma/3A;(1q5/1OOE(1q1u*=$>?4%-Ij ! +>-  - NNd1gaj!DGAJ.d1gaj0ADGAJ0N -  +4//*;  +<& J' *  " "il+A. il0KA0N (  +<  )M9TJ   s AK3%8K8r Tctj||||||}||k7rC|rAtj|j|j } t || g} | St |g} | S)amake ellipse Makes an ellipse centered at the origin of plane. Args: x_radius (float): x radius of the ellipse (along the x-axis of plane) y_radius (float): y radius of the ellipse (along the y-axis of plane) plane (Plane, optional): base plane. Defaults to Plane.XY. start_angle (float, optional): _description_. Defaults to 360.0. end_angle (float, optional): _description_. Defaults to 360.0. angular_direction (AngularDirection, optional): arc direction. Defaults to AngularDirection.COUNTER_CLOCKWISE. closed (bool, optional): close the arc. Defaults to True. Returns: Wire: an ellipse )rrrrXrr) rr~rrrtrurvr ellipse_edger rAs rrzWire.make_ellipse sy8(( h{I?P  ) #>>,"8"8":LKK]003] K  d ;;LsAcN|r"|\}}||k(r||fS||k(r||fStd|S)z9Order the edges of a chamfer relative to a reference Edgezreference edge not in edges)r)reference_edgerredge2s rorder_chamfer_edgeszWire.order_chamfer_edges> sE  LE5&e|#&e|#:; ; rc|}t|j}t|}t}t j |t jt j||D]} |j| j} t| jt| jf} tj|| \} } |jt!j"| jt!j"| j|||j%|j'}t)|}|j+t-|j'}tt/j0|S)achamfer_2d Apply 2D chamfer to a wire Args: distance (float): chamfer length distance2 (float): chamfer length vertices (Iterable[Vertex]): vertices to chamfer edge (Edge): identifies the side where length is measured. The vertices must be part of the edge Returns: Wire: chamfered wire )rrr"rXrTMapShapesAndAncestors_srrr FindFromKeyrFirstLastrr AddChamferrZrcrr~rHrrr+ OuterWire_s)rra distance2r?rrunchamfered_facechamfer_buildervertex_edge_maprrRrrrchamfered_face shape_fixs r chamfer_2dzWire.chamfer_2dN s5*8 E45EFCE&& b.. A'33AII>I)//+,d9>>3C.DEE33NEJLE5  & & emm, emm,   (..0">2 !)//"34I)).9::rc|jsNtj|j|j }t j ||fd}|S|}|S)z Close a Wirer)rrrrXrrrl)rrrys rrz Wire.close sU~~>>$.."2D4D4D4FGD<<t 5a8L Lrct|j}t|}|D]}|j|j| |j t |j }ttj|S)zfillet_2d Apply 2D fillet to a wire Args: radius (float): vertices (Iterable[Vertex]): vertices to fillet Returns: Wire: filleted wire ) rrr" AddFilletrrr~rr+r)rrr?unfilleted_facefillet_builderr< filleted_faces r fillet_2dzWire.fillet_2d so7t||D3ODF  $ $V^^V < !5!5!78 I))-899rct|j}|j||jd|j |j t t|jS)zfix_degenerate_edges Fix a Wire that contains degenerate (very small) edges Args: precision (float): minimum value edge length Returns: Wire: fixed wire r7) rIr SetPrecisionSetMaxTolerance FixSmallEdges FixWireGapsrrr~)r precisionsf_ws rfix_degenerate_edgeszWire.fix_degenerate_edges s\"$,,/ )$ T"  HTZZ\*++rc,t|jS)z(Return the Geom Comp Curve for this Wire)rrrs rrzWire.geom_adaptor s$T\\22rc|jj|Dcgc] }|jr|n|j"}}t |Scc}w)zBReturn the edges in self ordered by wire direction and orientation)rsort_byrr$r)rr ordered_edgess r order_edgeszWire.order_edges sU:>9M9Md9S 9SAA1::< /9S  '' s%AcX |j}|j}|jd d}d}|rt| fdd}|j |j ||jd}|jd} |z j |z jkD} | r|n| |j |tkr>d}|j|} | r|d| z |jzz }n|| |jzz }n||jz }|r|st|d||z S) zParameter at point on WirerrFc&|jSr )r.)rtargets rrz%Wire.param_at_point.. s1==3Hrr*r}Tz not on wire) rrrr0r]r^r.rurr) rr wire_lengthrRrafoundredge_p0edge_p1flippedrrs @rrzWire.param_at_point s9kk JJL !!!$))HI!LD MM)//$/ 0&&q)G&&q)G'//6G3C2K2KKG!(WWF&)3--e4W ;;H$++ 55H  #H-0wl34 4+%%rc.|j |j td|du|duz s td|$t|j}t}n d}t|}|6t |j|jt |j }n5t |j|jt|j }g}|jj}|jr|j} || jk(r|jt| n(|jt| j|j|jrtj dt#|t#|dkDrg} |j%} |D]}} | j%} |I| | z j}|j'|dk\s=| j| | | z j(f^| j| | |z j(f| j+dtj d t#| | Dcgc]}|d }}|Scc}w) aProject Wire Project a Wire onto a Shape generating new wires on the surfaces of the object one and only one of `direction` or `center` must be provided. Note that one or more wires may be generated depending on the topology of the target object and location/direction of projection. To avoid flipping the normal of a face built with the projected wire the orientation of the output wires are forced to be the same as self. Args: target_object: Object to project onto direction: Parallel projection direction. Defaults to None. center: Conical center of projection. Defaults to None. target_object: Shape: direction: VectorLike: (Default value = None) center: VectorLike: (Default value = None) Returns: : Projected wire(s) Raises: ValueError: Only one of direction or center must be provided Nz,Can't project empty Wires or to empty Shapesz2One of either direction or center must be providedz!wire generated %d projected wiresr}rc |dS)Nr}rr(s rrz'Wire.project_to_shape..Q sadrr*z8projected, filtered and sorted wire list is of length %d)rrrzr2r*rerrrhrrrrrr"rr|debugrrdotrsort)rrrrdirection_vector center_pointprojection_object output_wirestarget_orientationprojected_wireoutput_wires_distancesplanar_wire_center output_wireoutput_wire_centeroutput_wire_directionrs rrzWire.project_to_shape s@ << =#8#8#@KL LT!fn5QR R  %i0;;= !8L# !&>L  ' 3 %%(1134!  !4 %% --/0!  !\\557$$&.668N!^%?%?%AA##D$89##D)@)@)B$CD  " " $  $$&  8#l:KL | q %' "!% + %0%7%7%9"#/*-?? jl*-001ABaG.55 +!36H!H P P+11'/,>FF ,* # ' 'N ' ; LLJ*+ +AA*@QAaD*@LABs Jc@t}|jtj|j|jtj|j|j |j j|jS)zXAttempt to stich wires Args: other: Wire: Returns: ) rrrZWire_srrrrr)rrres rstitchz Wire.stitchZ sl/0 t||45u}}56~~""<#4#4#677rc|S)zGReturn Wire - used as a pair with Edge.to_wire when self is Wire | Edgerrs rr'z Wire.to_wirek s rc.||k\r td|j}t|dk(rt|dj ||gSg}d}|D]}|j |j d}|j |j d}|jr||rt|ds t|drd|z n|}|rt|ds t|drd|z n|}t|dxs,t|dxst|dxst|dxs|}||kDr||fn||f\}}|j|||fg} |D]?\}}}||ks||kDr||kr||kr| j|/||k\rw||krr|j |j |} |j |j |} | | kDr| | fn| | f\} } | j|j | | ||krH|j |j |} | dk7s| j|j d| |j |j |} | dk7s| j|j | dBt| S)a)trim Create a new wire by keeping only the section between start and end. Args: start (float): 0.0 <= start < 1.0 end (float): 0.0 < end <= 1.0 Raises: ValueError: start >= end Returns: Wire: trimmed wire zstart must be less than endr}rF) rrrrrrrrrr) rrryredges_uv_valuesfound_end_of_wirerurru_edgev_edges rrz Wire.trimo s" C<:; ;  u:?quc234 4<>!D##D$4$4Q$78A##D$4$4Q$78A~~)i1o1aE)i1o1aE aO) A) A)!A)) "UAq6ADAq  " "Aq$< 036 )JAq$5yAGza3h$$T*!q,,T-=-=e-DE,,T-=-=c-BC(.VV$ff=M$$TYYvv%>?!,,T-=-=c-BCQ;!((1f)=>,,T-=-=e-DEQ;!((61)=>/*2M""r)r2NN)rr`r[r3r\r4r]r5)rrr[r3r\r4r]r5)rArr[r3r\r4r]r5)rArr[r3r\r4r]r5)Fr2NN) rIterable[Edge]rHrDr[r3r\r4r]r5)F)rrrHrDrCr`)r)rzIterable[Wire | Edge]rr,rCrP)rr~rr{rCr)rr,rryrCr)r9)rrrr,rCr)r~r,rr,rryrtr,rur,rvrlrrDrCrrL)r?zIterable[VectorLike]rrDrCr)rr,rr,rryrCr)rrErtuple[Edge, Edge]rCrr ) rar,rr,r?Iterable[Vertex]rrErCrr>)rr,r?rrCr)rr,rCr)rCrrFr;r<)rr~rrNrrNrCz list[Wire])rrrCr)rrrr,ryr,rCr)"rQrRrSrTrrr_rVrOrlrryrWr{rrlrsrrr staticmethodrrrrrrrrrrr'rr?r@s@rrrMs? E""&         ""&         ""&         ""&          ""&           .? F?#?#B8<)05 :II7.P.P%%% %  %  %,%% %%N((, xx <<< <  <<: # ,=    (! 7;7;7;# 7;  7;  7;r:.,$3((&Z(,$( ii%i" i  iV8"T#rrc t}t}|D]*}|j|j|j,tj||d|t }t |jD]A}|jttj|j|dzC|S)zConvert edges to a list of wires. Args: edges: Iterable[Edge]: tol: float: (Default value = 1e-6) Returns: Fr}) rWrrrGrhrr-rirrrZrrU)rrrjrkrrr?s redges_to_wiresr s)*H)+I << # OODLL )228S%S&[E 9##% & T&-- A(>?@A' Lrct}|j||t|j|j S)zOffset a topods_face)OffsetTol)r' InitializeruMakeOffsetShaper~)ramountoffsetors rrr s8$&H V;  >> rc||n |j}| td|j}| tdt}|j Dcgc]}|j|j}}|D]2}|j |rt ||"|j|4td|DScc}w)zFGiven an edge extracted from a Shape, return the edges connected to itedge has no valid parentz edge is emptyc32K|]}t|ywr rrs rrz/topo_explore_connected_edges.. s6oT!Wor) topo_parentrrr.rIsSamerrr)rr]given_topods_edgeconnected_edgesr topods_edgesrs rtopo_explore_connected_edgesr s )Vt/?/?F ~344  ))eO(.||~O~!9NAII~LO#  # #K 0  %&7 E Q    , $ 6o6 66Ps B>%B>c||n |j}| tdt}tj|j t jt j|g}|j|j rF|j|j }|D]&}|jtj|(t|dk7r td|S)zMGiven an edge extracted from a Shape, return the topods_faces connected to itrrz)Invalid # of faces connected to this edge)rrrXrTrrrrrContainsrrrZrrr)rr] edge_face_mapfaces face_listrs rrr s )Vt/?/?F ~344>?M ""  Edll+!--dll; D LLt, - 5zQFGG Lr)r7)rrrr,rCrP)rr]rr,rCr^r )rrr] Shape | NonerCrG)rrr]rrCzlist[TopoDS_Face])rT __future__rrrr`collections.abcrrmathrrrr r r r typingr rrtyping_extensionsrnumpyrscipy.optimizer scipy.spatialr OCP.TopAbsTopAbsrOCP.BReprOCP.BRepAdaptorrrOCP.BRepAlgoAPIrrrOCP.BRepBuilderAPIrrrrrrr OCP.BRepExtremar!OCP.BRepFilletAPIr" OCP.BRepGPropr#r$ OCP.BRepLibr%r&OCP.BRepOffsetr'OCP.BRepOffsetAPIr(OCP.BRepPrimAPIr) OCP.BRepProjr* OCP.BRepToolsr+OCP.GCr,r- OCP.GCPntsr. OCP.GPropr/OCP.Geomr0r1r2r3r4r5r6 OCP.Geom2dr7r8r9 OCP.Geom2dAPIr: OCP.GeomAPIr;r<r=r> OCP.GeomAbsr?OCP.GeomAdaptorr@ OCP.GeomFillrArBrC OCP.HLRAlgorD OCP.HLRBReprErFOCP.ShapeAnalysisrG OCP.ShapeFixrHrI OCP.StandardrJrK OCP.TColStdrLrMrN OCP.TColgprOrPrQrRrS OCP.TopExprTrU OCP.TopLocrV OCP.TopToolsrWrXrY OCP.TopoDSrZr[r\r]r^r_r`OCP.gprarbrcrdrerfrgrhrirjrkbuild123d.build_enumsrlrmrnrorprqrrrsbuild123d.geometryrtrurvrwrxryrzr{r| shape_corer~rrrrrrrrutilsrrrrzero_drrtwo_drrthree_dr compositerrrrrrrrrrrrrrr-s1f# $"===33"#$D 7834065,#:+"FE3 )- *86;@ SR;.&               7"88y2ey2x~7E+&~Bv #7E+&v #r6(,7 7$778(, $r