JiG dZddlmZddlZddlZddlmZmZmZddl m Z m Z ddl m ZddlmZddlmZddlmZdd lmZdd lmZmZdd lmZdd lmZdd lmZddl m!Z!m"Z"ddl#m$Z$ddl%m&Z&m'Z'ddl(m)Z)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;mm?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGddlHmIZImJZJmKZKmLZLmMZMddlNmOZOdd lPmQZQmRZRdd!lSmTZTmUZUmVZVmWZWmXZXdd"lYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZadd#lbmcZcd$d%ldmeZemfZfmgZgd$d&lhmiZimjZjmkZkmlZlmmZmmnZnmoZompZpmqZqd$d'lrmsZsmtZtmuZumvZvmwZwd$d(lxmyZyerd$d)lzm{Z{d$d*l|m}Z}m~Z~mZmZGd+d,eiZGd-d.eeieJZGd/d0eeieLZd2d1Zy)3u build123d topology name: two_d.py by: Gumyr date: January 07, 2025 desc: This module provides classes and methods for two-dimensional geometric entities in the build123d CAD library, focusing on the `Face` and `Shell` classes. These entities form the building blocks for creating and manipulating complex 2D surfaces and 3D shells, enabling precise modeling for CAD applications. Key Features: - **Mixin2D**: - Adds shared functionality to `Face` and `Shell` classes, such as splitting, extrusion, and projection operations. - **Face Class**: - Represents a 3D bounded surface with advanced features like trimming, offsetting, and Boolean operations. - Provides utilities for creating faces from wires, arrays of points, Bézier surfaces, and ruled surfaces. - Enables geometry queries like normal vectors, surface centers, and planarity checks. - **Shell Class**: - Represents a collection of connected faces forming a closed surface. - Supports operations like lofting and sweeping profiles along paths. - **Utilities**: - Includes methods for sorting wires into buildable faces and creating holes within faces efficiently. The module integrates deeply with OpenCascade to leverage its powerful CAD kernel, offering robust and extensible tools for surface and shell creation, manipulation, and analysis. 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)Anyoverload TYPE_CHECKING)IterableSequence) BRep_Tool)BRepAdaptor_Surface)BRepAlgo)BRepAlgoAPI_Common)BRepBuilderAPI_MakeFaceBRepBuilderAPI_MakeShell)BRepClass3d_SolidClassifier)BRepFill)BRepFilletAPI_MakeFillet2d) BRepGPropBRepGProp_Face)BRepIntCurveSurface_Inter)BRepOffsetAPI_MakeFillingBRepOffsetAPI_MakePipeShell) BRepToolsBRepTools_ReShape) GProp_GProps)Geom_BezierSurface Geom_SurfaceGeom_RectangularTrimmedSurface)GeomAPI_PointsToBSplineSurfaceGeomAPI_ProjectPointOnSurf) GeomAbs_C0) Precision)ShapeFix_Solid)Standard_FailureStandard_NoSuchObjectStandard_ConstructionError)StdFail_NotDone)TColStd_HArray2OfReal)TColgp_HArray2OfPnt)TopExp))TopTools_IndexedDataMapOfShapeListOfShape)TopoDS TopoDS_Face TopoDS_Shape TopoDS_Shell TopoDS_Solid) gce_MakeLin)gp_Pntgp_Vec)CenterOfGeomTypeKeepSortBy Transition) TOLERANCEAxisColorLocationOrientedBoundBoxPlaneVector VectorLike)Self)Mixin1DEdgeWire) Shape ShapeList SkipCleandowncastget_top_level_topods_shapes_sew_topods_faces shapetype_topods_entities_topods_face_normal_at)_extrude_topods_shapefind_max_dimension _make_loft_make_topods_face_from_wires_topods_bool_op)Vertex)Solid)CompoundCurveSketchPartc@eZdZdZej Zej ZejZejZejZ ejZ ejZ e d dZ eddZe ddZddZddZddZef ddZdd Zdd Zdd Zy )Mixin2Dz1Additional methods to add to Face and Shell classcy)zDimension of Faces and Shellsselfs i/workspace/moltex-experiments/.pixi/envs/default/lib/python3.12/site-packages/build123d/topology/two_d.py_dimz Mixin2D._dimsc  tjttjttj t tjttjti}t|}||t|S)z6Returns the right type of wrapper, given a OCCT object) ta TopAbs_VERTEXrR TopAbs_EDGErB TopAbs_WIRErC TopAbs_FACEFace TopAbs_SHELLShellrJrG)clsobjconstructor_lut shape_types r_castz Mixin2D.casts[   f NND NND NND OOU  s^ *z*8C=99ractS)z9Unused - only here because Mixin1D is a subclass of Shape)NotImplementedrkrl directions r_extrudezMixin2D.extrudes rac|j tdtj|}t |jj |_|S)zReverse normal operator -z Invalid Shape)wrapped ValueErrorcopydeepcopyrG Complemented)r^ new_surfaces r___neg__zMixin2D.__neg__sE << _- -mmD) &t||'@'@'BC rac.tj|dS)zReturn the FacerhrDget_single_shaper]s r_facez Mixin2D.faces%%dF33rac.tj|dS)z#faces - all the faces in this ShaperhrDget_shape_listr]s r_facesz Mixin2D.facess##D&11rac F|jgSt|jj}t}|j |j||g}|j r|j }|jjt|j}|j|jt||f|j|j r|jd|Dcgc]}|d } }|Dcgc]}|d } }t| D cgc]"\}} t!| | |j#$} }} g} t%| | D]\}}| j||f| Scc}wcc}wcc} }w)a4Find point and normal at intersection Return both the point(s) and normal(s) of the intersection of the axis and the shape Args: axis (Axis): axis defining the intersection line Returns: list[tuple[Vector, Vector]]: Point and normal of intersection c |dS)Nr[r\)xs r_z2Mixin2D.find_intersection_points..s1ra)keyrr@)rvr/ValuerInitMorePntto_planeto_local_coordsr=ZappendrhNextsort enumeraterLto_pntzip)r^other toleranceintersection_lineintersect_maker intersectionsinter_ptdistanceiintersecting_facesintersecting_pointsfintersecting_normalsresultpntnormals r_find_intersection_pointsz Mixin2D.find_intersection_pointss << I' 6<<>35T\\+'Fc~tj|jt|j |zS)z6Return a copy of self moved along the normal by amount)rxrymovedr: normal_at)r^amounts r_offsetzMixin2D.offsets-}}T"(($..2BV2K)LMMrac.tj|dS)zReturn the Shellrjr~r]s r_shellz Mixin2D.shells%%dG44rac.tj|dS)z%shells - all the shells in this Shaperjrr]s r_shellszMixin2D.shellss##D'22raN)returnint)rlr,rz#Vertex | Edge | Wire | Face | Shell)rlrDrsr>rz&Edge | Face | Shell | Solid | Compound)rr?)rz Face | None)rzShapeList[Face])rr8rfloatrzlist[tuple[Vector, Vector]])rrrr?)rz Shell | None)rzShapeList[Shell])__name__ __module__ __qualname____doc__rAproject_to_viewportsplitverticesvertexedgesedgewirespropertyr` classmethodrortr|rrr7rrrrr\rar_rYrYs;!55 MMEH ^^F MME <dZe d? d@dZe dA dBdZee dCdZee dDdZedEdZedFdZeej<f dGdZe jBfdHdZ" d; dIdZ#dJdZ$dKdZ%dLdZ&dMd Z'dNdOd!Z( d; dPd"Z)dQd#Z*ed;dRd$Z+edSd%Z+dTd&Z+dUd'Z,dSd(Z- dVd)Z.dWdXd*Z/dEd+Z0dUd,Z1dYd-Z2xZ3S)ZrhaA Face in build123d represents a 3D bounded surface within the topological data structure. It encapsulates geometric information, defining a face of a 3D shape. These faces are integral components of complex structures, such as solids and shells. Face enables precise modeling and manipulation of surfaces, supporting operations like trimming, filleting, and Boolean operations.g@cy)a5Build a Face from an OCCT TopoDS_Shape/TopoDS_Face Args: obj (TopoDS_Shape, optional): OCCT Face. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Nr\)r^rllabelcolorparents r___init__z Face.__init__racy)aBuild a planar Face from a boundary Wire with optional hole Wires. Args: outer_wire (Wire): closed perimeter wire inner_wires (Iterable[Wire], optional): holes. Defaults to None. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Nr\)r^ outer_wire inner_wiresrrrs r_rz Face.__init__!rracd\}}}}}}|rYt|} t|dtr|dddd| z zz\}}}}n't|dtr|dddd| z zz\}}}}}dj t |j jgd} | rtd| |jd |}|jd |}|jd |}|jd |}|jd |}|jd|}|4||D cgc]} | jc} ng} t|j| }t |5||dn|||d|_ycc} w)N)NNNNNNrN, )rrrlrrrUnexpected argument(s) rlrrrrrrlrrr)len isinstancer,rCjoinsetkeys differencerwgetrvrPsuperr created_on)r^argskwargsrrrlrrrl_a unknown_argswinner_topods_wires __class__s r_rz Face.__init__4s=H: KeUF d)C$q'<0,0!Hw!c'7J,J)UE6DGT*@DRa7GLA= Kvyy   ) )    6|nEF Fjj$ZZ j9 jj <  7E* 7E*Hf-  !4?4KK0KqK0QS /z/A/ACUVC  "5  )-1s#E0cP|jy|jjS)a` Calculate the total surface area of the face, including the areas of any holes. This property returns the overall area of the face as if the inner boundaries (holes) were filled in. Returns: float: The total surface area, including the area of holes. Returns 0.0 if the face is empty. )rv without_holesarear]s r_area_without_holeszFace.area_without_holesgs& << !!#(((rac (!"|j td|js td|j}|j }|j }|r|Dcgc] }t |}}t j|}t||z tkDr||z jg}n@|Dcgc]#}|j|z j%}}n|jjjtjd} |jj} | rxt!|} | j"} t%t'dD cgc]$} t)j*| | | | dzdz&c} }| |zDcgc]}dD]}||z }}}n| Dcgc]}dD]}||z }}}|Dcgc]}||z j}}t-}|D]!t/|!!j1|"|j3"t4j6 \}}t9|t9|k7r]||bt%t;|t<r|n|g}t%t;|t<r|n|g}t?|t?|k7r|jAtC|!}t%"fd |DjAtC|!}tEd |D}d }tG||D]M\}}|jI|}|t;|t<rd }n#t;|t sJ||jJz }O|d k(rut||z tks|s|jM!tO!fd|D}|r|jM!|Dcgc]}tC||} }| Scc}wcc}wcc} wcc}}wcc}}wcc}wcc}w)uComputes and returns the axes of symmetry for a planar face. The method determines potential symmetry axes by analyzing the face’s geometry: - It first validates that the face is non-empty and planar. - For faces with inner wires (holes), it computes the centroid of the holes and the face's overall center (COG). If the holes' centroid significantly deviates from the COG (beyond a specified tolerance), the symmetry axis is taken along the line connecting these points; otherwise, each hole’s center is used to generate a candidate axis. - For faces without holes, candidate directions are derived by sampling midpoints along the outer wire's edges. If curved edges are present, additional candidate directions are obtained from an oriented bounding box (OBB) constructed around the face. For each candidate direction, the face is split by a plane (defined using the candidate direction and the face’s normal). The top half of the face is then mirrored across this plane, and if the area of the intersection between the mirrored half and the bottom half matches the bottom half’s area within a small tolerance, the direction is accepted as an axis of symmetry. Returns: list[Axis]: A list of Axis objects, each defined by the face's center and a direction vector, representing the symmetry axes of the face. Raises: ValueError: If the face or its underlying representation is empty. ValueError: If the face is not planar. z.Can't determine axes_of_symmetry of empty facez/axes_of_symmetry only supports for planar facesT)reverserr@)r?g?)originx_dirz_dir)keepc3@K|]}|jywr)mirror).0r split_planes r_ z(Face.axes_of_symmetry..s)/7!%xsc34K|]}|jywr)rrrs r_rz(Face.axes_of_symmetry..s:kaffksrc3TK|]}|jdtzk!yw)N)dotr7)rd cross_dirs r_rz(Face.axes_of_symmetry..s'#CPai(2 >9=s%()(rvrwis_planar_facecenterrrrhcombined_centerabsr7 normalizedrr filter_byr3LINEr;cornersrErangerB make_linerr<crossrr4BOTHtyperlistrsort_byr8sumr intersectraddany)#r^cogrshape_inner_wiresr hole_facesholes_centroid cross_dirsr curved_edges shape_edgesobbrr obb_edgesep mid_points mid_point symmetry_dirstopbottomtop_list bottom_listtop_flipped_list bottom_areaintersect_area flipped_face bottom_face intersectionoppositer symmetry_axesrrs# @@r_axes_of_symmetryzFace.axes_of_symmetryxsD << MN N""NO Okkm! ,,. +<=+C'(94-3??AB HRRz!qxxzC/;;=z R!'')33HMM43P //+113K&t,++%OTUVxXx!T^^GAJQ! 0DExX $/#:#:aOqAEOE#:.9R[/Qa!e/e[ RJTU*Y9s?668*JU%(U #Ioof-K **[tyy*AKCCyDL({fn 3(=C5IH#jd.CF&RK8}K 00%--d3 .BCK()/7) gd3 *+ :k::K N-01A;-O) k+55kB ':lD+I%)N%lD999"l&7&77N.P%>K/09<$!%%i0"#CP# H$%)))4e$h0==}!c1} =c>SYSUn>s*'O/?(O41)O9)O>PP Pcr|jdd}t||j|jS)zLocation at the center of facerr) position_atr<rlocation)r^rs r_center_locationzFace.center_locations2!!#s+V4>> :CCCrac Pd}|jrt|j|}|j}t d|Dr|j }d}t |dk(rg}|D]b}|j|Dcgc]}||j vs|c}|D cgc]!}|D cgc]} | jdc} #} }} dt d Dr/d}t |jtjdk(rd }|Scc}wcc} wcc} }w) zgeometry of planar faceNc3VK|]!}|jtjk(#ywr) geom_typer3r)rrs r_rz Face.geometry..sIA1;;(--/s')POLYGONrrc3PK|]}|dj|ddk( yw)rr@ZN) get_angle)redge_directionss r_rz Face.geometry..s2/CO(*44_Q5GHBN/Cs$& RECTANGLEr@SQUARE) is_planarr<rrallrrr tangent_atgroup_byr5LENGTH) r^r flat_faceflat_face_edgesflat_face_vertices edge_pairsrrpairredge_pair_directionss r_geometryz Face.geometrys( >>#Dk99$?I'oo/OIII%.%7%7%9""'1,35J"4"))(7R16QZZ\;QQROY0NXdDADDT__Q/DAj-0 #5/C"-77 FG1L%-F SB0s$D D * D"3D D"D"c|jS)z=Is the face planar even though its geom_type may not be PLANE)rr]s r_r8zFace.is_planars"""racd}|jrft|j|}|jj t j }|dj |dj z }|S)zlength of planar faceNrr)r8r<rrr r8Xr^rr= face_verticess r_lengthz Face.lengthf >>d 33D9I%..088@M"2&((=+;+=+==F rac|jtjtjfvr>t |j t k7r|j jSy)z9Return the radius of a cylinder or sphere, otherwise NoneN)r0r3CYLINDERSPHEREr geom_adaptorrRadiusr]s r_radiusz Face.radius*sQ NNx00(//B BT&&()-KK$$&--/ /rac|jtjk(rUt|j t k7r5t |j jj Sy)z%Get the rotational axis of a cylinderN)r0r3rLrrNrr8Cylinderr]s r_rotational_axiszFace.rotational_axis5sV NNh// /T&&()-KK))+446;;=> >racy)z6volume - the volume of this Face, which is always zerorr\r]s r_volumez Face.volume@sracd}|jrft|j|}|jj t j }|dj |dj z }|S)zwidth of planar faceNrr)r8r<rrr r8YrGs r_widthz Face.widthErJracfttjt|j|S)a/extrude Extrude an Edge into a Face. Args: direction (VectorLike): direction and magnitude of extrusion Raises: ValueError: Unsupported class RuntimeError: Generated invalid result Returns: Face: extruded shape )rhr*Face_srMrvrrs r_rtz Face.extrudeRs$ FMM"7 Y"OPQQrac t|dkst|ddkr tdt|dkDst|ddkDr td|r?t|t|k7st|dt|dk7r tdtdt|dt|d}t|D]H\}}t|D]5\}}|j |dz|dzt |j 7J|rxtdt|dt|d}t|D]:\}} t| D]'\}} |j |dz|dzt| )<t||} n t|} |t| tjjS)umake_bezier_surface Construct a Bézier surface from the provided 2d array of points. Args: points (list[list[VectorLike]]): a 2D list of control points weights (list[list[float]], optional): control point weights. Defaults to None. Raises: ValueError: Too few control points ValueError: Too many control points ValueError: A weight is required for each control point Returns: Face: a potentially non-planar face r[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@)rrwr'rSetValuer=rr&rrr r Confusion_srh) rkpointsweightspoints_r row_pointsjpointweights_ row_weightsweightbeziers r_make_bezier_surfacezFace.make_bezier_surfaceds, v;?c&)nq0K  v; s6!9~2IJ J  K3w< '3vay>S_+LOP P%aVaVAYH&v.MAz%j15  QAve}/C/C/EF2/ ,QG aWQZQH"+G"4;!*;!7IAv%%a!eQUE&MB"8#5(:F'0F*693H3H3JKPPRSSracXt|jj}||S)z/Create a unlimited size Face aligned with planer rvrh)rkplane pln_shapes r_ make_planezFace.make_planes% ,EMM:??A 9~rac|t|j| dz|dz| dz|dzj}||S)aTmake_rect Make a Rectangle centered on center with the given normal Args: width (float, optional): width (local x). height (float, optional): height (local y). plane (Plane, optional): base plane. Defaults to Plane.XY. Returns: Face: The centered rectangle rrk)rkrXheightrlrms r_ make_rectzFace.make_rectsG, MME6C<vgmVc\ $& 9~rac ~t|tr t|n|}|r|Dcgc] }t|}}nd}t dddddddd d d }t|t r|j }n9t|trtd |Dr t|}n td|D]"}|j|jt$ |jt|j} |rV|D]'} |jt+| j-) |jt|j} |rQt/| j} |D]} | j| j t| j} | j1} | j3s t)d| Scc}w#t t"t$t&f$r} t)d| d} ~ wwxYw#t"$r} t)d| d} ~ wwxYw#t"$r} t)d| d} ~ wwxYw)aPCreate Non-Planar Face Create a potentially non-planar face bounded by exterior (wire or edges), optionally refined by surface_points with optional holes defined by interior_wires. Args: exterior (Union[Wire, list[Edge]]): Perimeter of face surface_points (list[VectorLike], optional): Points on the surface that refine the shape. Defaults to None. interior_wires (list[Wire], optional): Hole(s) in the face. Defaults to None. Raises: RuntimeError: Internal error building face RuntimeError: Error building non-planar face with provided surface_points RuntimeError: Error adding interior hole RuntimeError: Generated face is invalid Returns: Face: Potentially non-planar face Nr[Fgh㈵>g-C6?{Gz?g? ) Degree NbPtsOnCurNbIter AnisotropieTol2dTol3dTolAngTolCurvMaxDeg MaxSegmentsc3<K|]}t|tywr)rrB)ros r_rz$Face.make_surface..s4 )1AJq$ sz(exterior must be a Wire or list of Edgesz5Error building non-planar face with provided exteriorz;Error building non-planar face with provided surface_pointsJError adding interior hole in non-planar face with provided interior_wiresznon planar face is invalid)rrrr=rrCrr9rErwAddrvrBuildrhrDr"r%r#r$ RuntimeErrorr0to_tupler fixis_valid)rkexteriorsurface_pointsinterior_wiresrsurface_point_vectorssurface outside_edgesr surface_faceerrrdmakeface_objectwires r_ make_surfacezFace.make_surfaces-8&0(%C4> 8F$G1VAY !$G$( !,% ( h %$NN,M ( +4 )14 1 &h/MGH H!D KK j 1"  MMO 0L !. FENN$456/  #GMMO4  5l6J6JKO&##DLL1' #O$8$8$:; $'') $$&;< <Y%HR   ! &    G   # "Q # "` sMG)G*)H H"H1 G==H H HH" H<+ H77H<c tdt|dt|d}t|D]H\}}t|D]5\} } |j|dz| dzt | j 7J|rt |g|||d} nt ||||} | js td| j} |t| tjjS)amake_surface_from_array_of_points Approximate a spline surface through the provided 2d array of points. The first dimension correspond to points on the vertical direction in the parameter space of the face. The second dimension correspond to points on the horizontal direction in the parameter space of the face. The 2 dimensions are U,V dimensions of the parameter space of the face. Args: points (list[list[VectorLike]]): a 2D list of points, first dimension is V parameters second is U parameters. tol (float, optional): tolerance of the algorithm. Defaults to 1e-2. smoothing (Tuple[float, float, float], optional): optional tuple of 3 weights use for variational smoothing. Defaults to None. min_deg (int, optional): minimum spline degree. Enforced only when smoothing is None. Defaults to 1. max_deg (int, optional): maximum spline degree. Defaults to 3. Raises: ValueError: B-spline approximation failed Returns: Face: a potentially non-planar face defined by points r@r)DegMaxTol3D)DegMinrrzB-spline approximation failed)r'rrr]r=rrIsDonerwSurfacer r r^rh) rkr_tol smoothingmin_degmax_degrar point_rowrcrdspline_builder spline_geoms r_!make_surface_from_array_of_pointsz&Face.make_surface_from_array_of_pointssB&aVaVAYH%f-LAy%i05  QAve}/C/C/EF1. ;#,33N<sN$$&<= =$,,. *; 8M8M8OPUUWXXracyrr\)rkedge1edge2s r_make_surface_from_curveszFace.make_surface_from_curvesV racyrr\)rkwire1wire2s r_rzFace.make_surface_from_curves]rracd\}}|r:t|dk7st|dt|dur td|\}}|jd|}|jd|}|jd|}|jd |}|r+t d d j |j t|ttfrt|ttfs tdt|tr;|jtj|j|j}|S|jtj|j|j}|S) armake_surface_from_curves Create a ruled surface out of two edges or two wires. If wires are used then these must have the same number of edges. Args: curve1 (Union[Edge,Wire]): side of surface curve2 (Union[Edge,Wire]): opposite side of surface Returns: Face: potentially non planar surface NNr[rr@z>Both curves must be of the same type (both Edge or both Wire).rrrrzUnexpected argument(s): r)rr TypeErrorpoprwrrrrBrCrorShell_srvrZ)rkrrcurve1curve2 return_values r_rzFace.make_surface_from_curvesdsA$ 4yA~d1gd47m!CT"NFFGV,GV,GV,GV, 7 &++-8P7QRS S&4,/z&4QU,7WP  fd #88H$4$4V^^V^^$TUL88HOOFNNFNN$STLrac t|Dcgc]}|jc}}t|}g}|D]}t|tr%|j t t|g8t|tr)|j t|jqt|tr,|j t dt|dDtdt|d|Scc}w)aGsew faces Group contiguous faces and return them in a list of ShapeList Args: faces (Iterable[Face]): Faces to sew together Raises: RuntimeError: OCCT SewedShape generated unexpected output Returns: list[ShapeList[Face]]: grouped contiguous faces c32K|]}t|ywr)rhrs r_rz!Face.sew_faces..s)RAQ)RsrhzSewedShape returned a z which was unexpected)rIrvrHrr+rrErhr-rjrr.rKrr)rkrr sewed_shapetop_level_shapes sewn_facestop_level_shapes r_ sew_faceszFace.sew_facess (E(BEqE(BC 6{C&(  0O/;7!!)T/-B,C"DEO\:!!%"8">">"@AO\:!!)9/6)R #,T/-B,CCXY 0 +)CsC;c.t|jdk7st|jdk7r tdt|j g}t|j g}t |j }|j|j dd|jtj||jt|j}tjr|j}|S)aOsweep Sweep a 1D profile along a 1D path. Both the profile and path must be composed of only 1 Edge. Args: profile (Union[Curve,Edge,Wire]): the object to sweep path (Union[Curve,Edge,Wire]): the path to follow when sweeping transition (Transition, optional): handling of profile orientation at C1 path discontinuities. Defaults to Transition.TRANSFORMED. Raises: ValueError: Only 1 Edge allowed in profile & path Returns: Face: resulting face, may be non-planar r@z&Use Shell.sweep for multi Edge objectsF)rrrwrCrrrvrSetTransitionModerD_transModeDictrrhrFcleanrkprofilepath transitionbuilderrs r_sweepz Face.sweeps: w}} 1 $DJJL(9Q(>EF F '(TYY[M"-dll; GOOUE2!!%"6"6z"BC gmmo& ??\\^F racd|tjk(s|tjk(rQ|jrEt }t j |j||j}t#|S|tjk(r)|jj}t#|S|tjk(r`|j\}}}}d||zz}d||zz} t}t} t|jj!|| || t#S)zCenter of Face Return the center based on center_of Args: center_of (CenterOf, optional): centering option. Defaults to CenterOf.GEOMETRY. Returns: Vector: center r)r2MASSGEOMETRYr8rrSurfaceProperties_srv CentreOfMass BOUNDING_BOX bounding_boxr _uv_boundsr0r1rNormalr=) r^ center_of properties center_pointu_val0u_val1v_val0v_val1u_valv_valrs r_rz Face.centers  & ** *t~~%J  ) )$,, C%224Ll##(// /,,.557Ll##(++ +-1__-> *FFFF6F?+E6F?+E!8LXF 4<< ( / /ulF Sl##rac|}t|j}t}tj|jt j t j||D]}|j|j} t| jt| jf} tj|| \} } |jtj | jtj | j|||j#|j$j'|j)j+S)aApply 2D chamfer to a face 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 Raises: ValueError: Cannot chamfer at this location ValueError: One or more vertices are not part of edge Returns: Face: face with a chamfered corner(s) )rrvr)r(MapShapesAndAncestors_srcrdre FindFromKeyrBFirstLastrCorder_chamfer_edges AddChamferr*Edge_srrrorDr) r^r distance2rrreference_edgechamfer_buildervertex_edge_mapv edge_listrrrs r_ chamfer_2dzFace.chamfer_2ds04T\\BCE&& LL"**BNNO A'33AII>I)//+,d9>>3C.DEE33NEJLE5  & & emm, emm,   ~~""?#8#8#:;??AAract|j}|D]}|j|j| |j|jj |j S)zApply 2D fillet to a face Args: radius: float: vertices: Iterable[Vertex]: Returns: )rrv AddFilletrrrorD)r^rPrfillet_builderrs r_ fillet_2dzFace.fillet_2d6s\4DLLAF  $ $V^^V < ~~"">#7#7#9::rac@tj|jS)z%Return the Geom Surface for this Face)r Surface_srvr]s r_rNzFace.geom_adaptorJs""4<<00rac|j}t|jDcgc]}|j|r|c}Scc}w)z.Extract the inner or hole wires from this Face)rrEris_same)r^outerrs r_rzFace.inner_wiresNs<!TZZ\J\59I!\JKKJs A A cH|j\}}}}t}t}t|jj |||||j t|xr7dt|jjt|z tkS)z4Is this planar face coplanar with the provided planer@) rr0r1rrvrcontainsr=rrrr7)r^rlr_u_val1r_v_val1gp_pntrs r_ is_coplanarzFace.is_coplanarTs+/??+<(t||$++FFFFK NN6&> * EC v7889D ract|j}|jtt |j ||j S)a Point inside Face Returns whether or not the point is inside a Face within the specified tolerance. Points on the edge of the Face are considered inside. Args: point(VectorLike): tuple or Vector representing 3D point to be tested tolerance(float): tolerance for inside determination. Defaults to 1.0e-6. point: VectorLike: tolerance: float: (Default value = 1.0e-6) Returns: bool: indicating whether or not point is within Face )rrvPerformr0r=r IsOnAFace)r^rdrsolid_classifiers r_ is_insidezFace.is_inside`sD 7t||D  )?)?)A!BIN))++rac|j||}|'t||j|}t |St|t||j|}t |S)z$Location at the u/v position of facer*)rr)r+r<rr=r:)r^urrrplns r_ location_atzFace.location_atxsc!!!Q' =dnnV&<=C}fUm4>>&;QRC}ract|j}|D]}|j|j t|j}|j }|S#t$r}t d|d}~wwxYw)aWMake Holes in Face Create holes in the Face 'self' from interior_wires which must be entirely interior. Note that making holes in faces is more efficient than using boolean operations with solid object. Also note that OCCT core may fail unless the orientation of the wire is correct - use `Wire(forward_wire.wrapped.Reversed())` to reverse a wire. Example: For example, make a series of slots on the curved walls of a cylinder. .. image:: slotted_cylinder.png Args: interior_wires: a list of hole outline wires interior_wires: list[Wire]: Returns: Face: 'self' with holes Raises: RuntimeError: adding interior hole in non-planar face with provided interior_wires RuntimeError: resulting face is not valid rN)r rvrrhr%rr)r^rr interior_wirerrs r_ make_holeszFace.make_holess62$,,?+M    5 5 6,  4 4 67L $'')  \  sA$$ A>- A99A>cy)anormal_at point on surface Args: surface_point (VectorLike, optional): a point that lies on the surface where the normal. Defaults to the center (None). Returns: Vector: surface normal direction Nr\)r^ surface_points r_rzFace.normal_atrracy)anormal_at u, v values on Face Args: u (float): the horizontal coordinate in the parameter space of the Face, between 0.0 and 1.0 v (float): the vertical coordinate in the parameter space of the Face, between 0.0 and 1.0 Defaults to the center (None/None) Raises: ValueError: Either neither or both u v values must be provided Returns: Vector: surface normal direction Nr\)r^rrs r_rzFace.normal_atrracd\}}}|rct|dtr|d}nt|dttfr|d}t |dk(rt|dttfr|d}dj t |jjgd}|rtd||jd|}|jd |}|jd |}||dkr |dkrd \}}n$|"td ||fDdk(r td |j}|&|j\}} } } ||| zz} || | zz} n6tt|j!|}|j#\} } t%}t'}t)|j*j-| | ||t|j/S)a0normal_at Computes the normal vector at the desired location on the face. Args: surface_point (VectorLike, optional): a point that lies on the surface where the normal. Defaults to None. Returns: Vector: surface normal direction )Nrrrr[r@r)rrrrrrr)rrc3&K|] }|dk( yw)rNr\)rrs r_rz!Face.normal_at..s*Ef19fsz#Both u & v values must be specified)rrrrrrrrrrwrr rNrrr=rLowerDistanceParametersr0r1rrvrr)r^rrrrrrrrrrrrr projectorrrs r_rzFace.normal_ats/ q! $q'8, $Q DGc5\2G4yA~*T!WsEl"CGyy   ) )*E F  6|nEF F ?MB JJsA  JJsA   QUq1uDAq  "s*Eq!f*E'E'JBC C##%  -1__-> *FFFF&)E&)E3}%,,.I%<<>LE5t||$++E5&&If~((**racRttj|jS)z)Extract the perimeter wire from this Face)rCr OuterWire_srvr]s r_rzFace.outer_wiresI))$,,788rac|j\}}}}||||z zz}||||z zz}t} t} t|jj ||| | t | S)aposition_at Computes a point on the Face given u, v coordinates. Args: u (float): the horizontal coordinate in the parameter space of the Face, between 0.0 and 1.0 v (float): the vertical coordinate in the parameter space of the Face, between 0.0 and 1.0 Returns: Vector: point on Face )rr0r1rrvrr=) r^rrrrrrrrrrs r_r+zFace.position_at st*.):&fvo..fvo..t||$++E5&&If~rac>t||g}t|jt||z}t }t |t r tdt |trLt|f|jft}|js{|jt|n`|jD]M}t|f|jft}t|D]}|jt|O|j!t#|j%|}t } |D]T} t'| j)dk(r%| j+} | 2| j| D| j| V| S)aProject Face to target Object Project a Face onto a Shape generating new Face(s) on the surfaces of the object. A projection with no taper is illustrated below: .. image:: flatProjection.png :alt: flatProjection Note that an array of faces is returned as the projection might result in faces on the "front" and "back" of the object (or even more if there are intermediate surfaces in the projection path). faces "behind" the projection are not returned. Args: target_object (Shape): Object to project onto direction (VectorLike): projection direction Returns: ShapeList[Face]: Face(s) projected on target object ordered by distance z'projection to a vertex is not supportedr@)rNrMrvr=rErrRrrhrQr IsNullrrrHrjr r8rrrr) r^ target_objectrs max_dimensionextruded_topods_selfintersected_shapes topods_shape target_shell topods_shellprojected_shapesshape shape_faces r_project_to_shapezFace.project_to_shape!ss0+D-+@A 4 LL&+m; 7@k mV ,EF F mT **%'-*?*?)ACUCWL &&("))$|*<= - 4 4 6 .)+!))+&(  %@ $ML&--eL.AB%N !7077T[[]I8VW4=K'E5;;=!Q&"ZZ\ )$++J7 ''. ( rac|j td|jjt j |j|S)zto_arcs Approximate planar face with arcs and straight line segments. Args: tolerance (float, optional): Approximation tolerance. Defaults to 1e-3. Returns: Face: approximated face z!Cannot approximate an empty shape)rvrwrror ConvertFace_s)r^rs r_to_arcsz Face.to_arcs\s@ << @A A~~""8#9#9$,, #RSSrac4|j td|jx}s|Stj|}t }|D]}|j |jt|j|j}||_|S)zwithout_holes Remove all of the holes from this face. Returns: Face: A new Face instance identical to the original but without any holes. z&Cannot remove holes from an empty face) rvrwrrxryrRemoverGApply)r^rholelessreshaper hole_wiremodified_shapes r_rzFace.without_holesls << EF F#//11 1K==&$&$I OOI-- .%!(..">?)racp|jrtjdd|jS)z?Return the outerwire, generate a warning if inner_wires presentz!Found holes, returning outer_wirer[) stacklevel)rwarningswarnrr]s r_rz Face.wires/     MM3   rac@tj|jS)z,Return the u min, u max, v min, v max values)r UVBounds_srvr]s r_rzFace._uv_boundss##DLL11ra)rNN)rlr+rstrr Color | NonerCompound | NoneNrNN) rrCrIterable[Wire] | Nonerr(rr)rr*)rrrrrr)rz list[Axis])rr:)rz None | str)rbool)rz None | float)rz None | Axis)rlrBrsr>rrhr)r_list[list[VectorLike]]r`zlist[list[float]] | Nonerrh)rlr<rrh)rXrrprrlr<rrhr)rzWire | Iterable[Edge]rzIterable[VectorLike] | Nonerr,rrh)ruNr@rs) r_r/rrrz!tuple[float, float, float] | Nonerrrrrrh)rrBrrBrrh)rrCrrCrrh)rrh)rzIterable[Face]rzlist[ShapeList[Face]])rCurve | Edge | Wirerr0rrh)rr2rr=) rrrrrIterable[Vertex]rz Edge | Nonerrh)rPrrr1rrh)rr)rzShapeList[Wire])rlr<rr.)gư>)rdr>rrrr.)rrrrrVectorLike | Nonerr:)r list[Wire]rrh)rr2rr=)rrrrrr=rr=)rrC)r rDrsr>rzShapeList[Face | Shell])gMbP?)rrrrh)rz!tuple[float, float, float, float])4rrrrorderrrrrr(r-rCr8rIrPrSrUrXrrtrir<XYrnrqrrrrr6 TRANSFORMEDrr2rrrrrNrrrrrrrr+rrrrr __classcell__rs@r_rhrhsD E""&         .2""&   +        $/-f)) |||DD 8##RR"-1.T&.T*.T  .T.T`xx CH88&7;04 j'j4j. j  jjX7; 4Y&4Y4Y5 4Y  4Y  4Y 4Y4Yl  !%     !%   ''R$$L )) ($("(  ((X,4+<+<$J! 2B2B2B# 2B  2B  2Bh;(1L  ,2>B    ):   )V      "7+r909 "9 /99 9 vT ,!2rarhceZdZdZdZ d d fd Zed dZed dZ ed ddZ ee jf ddZ ddZxZS)rjaA Shell is a fundamental component in build123d's topological data structure representing a connected set of faces forming a closed surface in 3D space. As part of a geometric model, it defines a watertight enclosure, commonly encountered in solid modeling. Shells group faces in a coherent manner, playing a crucial role in representing complex shapes with voids and surfaces. This hierarchical structure allows for efficient handling of surfaces within a model, supporting various operations and analyses.g@ct|tr t|n|}t|trtt|x}dk(r|d}t|trKt t |jjj}|j}n3t|tr#t|Dcgc]}|jc}}t|1||||ycc}w)a_Build a shell from an OCCT TopoDS_Shape/TopoDS_Shell Args: obj (TopoDS_Shape | Face | Iterable[Face], optional): OCCT Shell, Face or Faces. label (str, optional): Defaults to ''. color (Color, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. r@rrN) rrrrrhrr rvrrDrIrr) r^rlrrrobj_listrrrs r_rzShell.__init__s&c84d3i# c8 $c-BX)Cq)H1+C c4 .#CKK088:BBDG--/C X &#$<1QYY$<=C   %=sC/c|jrbtj|j}t }t j t|}||||jSy)z=volume - the volume of this Shell if manifold, otherwise zeror) is_manifoldr!SolidFromShellrvrrDshape_properties_LUTrJMass)r^ solid_shellr calc_functions r_rUz Shell.volumesZ   (*99$,,GK%J!66y7MNM +z 2??$ $racfttjt|j|S)a/extrude Extrude a Wire into a Shell. Args: direction (VectorLike): direction and magnitude of extrusion Raises: ValueError: Unsupported class RuntimeError: Generated invalid result Returns: Edge: extruded shape )rjr*rrMrvrrs r_rtz Shell.extrudes$ V^^$9#++y$QRSSrac(|t|d|S)a make loft Makes a loft from a list of wires and vertices. Vertices can appear only at the beginning or end of the list, but cannot appear consecutively within the list nor between wires. Wires may be closed or opened. Args: objs (list[Vertex, Wire]): wire perimeters or vertices ruled (bool, optional): stepped or smooth. Defaults to False (smooth). Raises: ValueError: Too few wires Returns: Shell: Lofted object F)rO)rkobjsruleds r_ make_loftzShell.make_lofts$:dE5122ract|j}tt|jj}t|j}|j |jdd|j tj||jt|j}tjr|j}|S)asweep Sweep a 1D profile along a 1D path Args: profile (Union[Curve, Edge, Wire]): the object to sweep path (Union[Curve, Edge, Wire]): the path to follow when sweeping transition (Transition, optional): handling of profile orientation at C1 path discontinuities. Defaults to Transition.TRANSFORMED. Returns: Shell: resulting Shell, may be non-planar F) rCr order_edgesrrvrrrDrrrjrFrrs r_rz Shell.sweeps(w}}'D&2245-dll; GOOUE2!!%"6"6z"BC w}}' ??\\^F ract}tj|j|t |j S)zCenter of mass of the shell)rrLinearProperties_srvr=r)r^rs r_rz Shell.centers1!^ $$T\\:>j--/00rar+)rlz+TopoDS_Shell | Face | Iterable[Face] | Nonerr(rr)rr*r-)rlrCrsr>rrj)F)rFzIterable[Vertex | Wire]rGr.rrj)rr0rr0rrjr4)rrrrr5rrrUrrtrHr6r7rrr8r9s@r_rjrjs  E <@""&  8        HTT"33& )) $"  B1rarjct|dkr|gSt|d|dd}g}|jD]3}|j|j g|j z5|S)a%Tries to determine how wires should be combined into faces. Assume: The wires make up one or more faces, which could have 'holes' Outer wires are listed ahead of inner wires there are no wires inside wires inside wires ( IE, islands -- we can deal with that later on ) none of the wires are construction wires Compute: one or more sets of wires, with the outer wire listed first, and inner ones Returns, list of lists. Args: wire_list: list[Wire]: Returns: r[rr@N)rrhrrrr) wire_listrrrs r_sort_wires_by_build_orderrOs0 9~   1y} -EL !   !  ra)rNr3rzlist[list[Wire]])r __future__rrxr$typingrrrcollections.abcrr OCP.TopAbsTopAbsrcOCP.BRepr OCP.BRepAdaptorr OCP.BRepAlgor OCP.BRepAlgoAPIr OCP.BRepBuilderAPIr rOCP.BRepClass3dr OCP.BRepFillrOCP.BRepFilletAPIr OCP.BRepGProprrOCP.BRepIntCurveSurfacerOCP.BRepOffsetAPIrr OCP.BRepToolsrr OCP.GProprOCP.Geomrrr OCP.GeomAPIrr OCP.GeomAbsr OCP.Precisionr OCP.ShapeFixr! OCP.Standardr"r#r$ OCP.StdFailr% OCP.TColStdr& OCP.TColgpr' OCP.TopExpr( OCP.TopToolsr) OCP.TopoDSr*r+r,r-r.OCP.gcer/OCP.gpr0r1build123d.build_enumsr2r3r4r5r6build123d.geometryr7r8r9r:r;r<r=r>typing_extensionsr?one_drArBrC shape_corerDrErFrGrHrIrJrKrLutilsrMrNrOrPrQzero_drRthree_drS compositerTrUrVrWrYrhrjrOr\rar_rys5n# //./!.P7!83=T6"UUR"#' (-*BTT!NN   #&&   88x3ex3vI27E+&I2X$I1GU<(I1X)ra