^jvdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z mZddlmZddlmZdd lmZmZmZmZmZmZmZmZmZmZdd lmZdd lm Z ddl!m"Z#ddl$m%Z&dd l'm(Z(m)Z)dd l*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3m4Z4ddl5m6Z6m7Z7ddl8m9Z9m:Z:m;Z;mZ>ddl?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHddlImJZJddlKmLZLddlMmNZNddlOmPZPmQZQddlRmSZSddlTmUZUddlVmWZWddlXmYZYddlZm[Z[ddl\m]Z]ddl^m_Z_ddl`maZambZbmcZcmdZdmeZemfZfmgZgmhZhdd limjZjdd!lkmlZldd"lmmnZnmoZodd#lpmqZqdd$lrmsZsdd%l$mtZtmuZudd&lvmwZwmxZxdd'lymzZzdd(l{m|Z|m}Z}m~Z~mZmZmZmZmZmZmZmZdd)lmZmZmZmZdd*lmZmZdd+lmZmZmZmZmZdd,lmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZer(dd-lmZd.d/lmZd.d0lmZmZd.d1lmZd.d2lmZmZd.d3lmZed4Zeed5d6fZed7e8Ze eejgdfZe e d9gd9fZGd:d9e(eeZGd;deZed?eeef8Zed@e8ZGdAdBeeefZ dUdCZGdDdEeeZGdFdGeZGdHdIZdVdJZ dWdKZdXdLZdYdMZdZdNZdZdOZ d[dPZd\dQZd]dRZ d^ d_dSZ d`dTZy)aa build123d topology name: shape_core.py by: Gumyr date: January 07, 2025 desc: This module defines the foundational classes and methods for the build123d CAD library, enabling detailed geometric operations and 3D modeling capabilities. It provides a hierarchy of classes representing various geometric entities like vertices, edges, wires, faces, shells, solids, and compounds. These classes are designed to work seamlessly with the OpenCascade Python bindings, leveraging its robust CAD kernel. Key Features: - **Shape Base Class:** Implements core functionalities such as transformations (rotation, translation, scaling), geometric queries, and boolean operations (cut, fuse, intersect). - **Custom Utilities:** Includes helper classes like `ShapeList` for advanced filtering, sorting, and grouping of shapes, and `GroupBy` for organizing shapes by specific criteria. - **Type Safety:** Extensive use of Python typing features ensures clarity and correctness in type handling. - **Advanced Geometry:** Supports operations like finding intersections, computing bounding boxes, projecting faces, and generating triangulated meshes. The module is designed for extensibility, enabling developers to build complex 3D assemblies and perform detailed CAD operations programmatically while maintaining a clean and structured API. 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)ABCabstractmethod)deque)CallableIterableIterator)reduce)inf) TYPE_CHECKINGAnyClassVarGenericLiteralOptionalProtocol SupportsIndexTypeVarUnioncast)overload) NodeMixin RenderTree)RepresentationPrinterpretty)Bnd_BoxBnd_OBB)BOPAlgo_GlueEnum) BRep_TEdge BRep_Tool)BRepAdaptor_CurveBRepAdaptor_Surface)BRepAlgoAPI_BooleanOperationBRepAlgoAPI_CommonBRepAlgoAPI_CutBRepAlgoAPI_FuseBRepAlgoAPI_SectionBRepAlgoAPI_Splitter) BRepBuilderAPI_CopyBRepBuilderAPI_GTransformBRepBuilderAPI_MakeFaceBRepBuilderAPI_MakeVertexBRepBuilderAPI_RightCornerBRepBuilderAPI_RoundCornerBRepBuilderAPI_SewingBRepBuilderAPI_TransformBRepBuilderAPI_Transformed)BRepCheck_Analyzer)BRepExtrema_DistShapeShape)BRepFeat_SplitShape) BRepGPropBRepGProp_Face)BRepIntCurveSurface_Inter)BRepMesh_IncrementalMesh)BRepPrimAPI_MakeHalfSpace) BRepTools) gce_MakeLin)GeomAPI_ProjectPointOnSurf)GeomLib_IsPlanarSurface)gp_Ax1gp_Ax2gp_Ax3gp_Dirgp_Pntgp_Trsfgp_Vecgp_XYZ) GProp_GProps)ShapeAnalysis_Curve) ShapeCustom!ShapeCustom_RestrictionParameters)ShapeFix_Shape)ShapeUpgrade_UnifySameDomain)TopAbs_OrientationTopAbs_ShapeEnum)TopExpTopExp_Explorer)TopLoc_Location) TopoDSTopoDS_BuilderTopoDS_Compound TopoDS_Edge TopoDS_FaceTopoDS_Iterator TopoDS_Shape TopoDS_Shell TopoDS_Solid TopoDS_Vertex TopoDS_Wire))TopTools_IndexedDataMapOfShapeListOfShapeTopTools_ListOfShapeTopTools_SequenceOfShapeTopTools_ShapeMapHasher)Self deprecated)CenterOfGeomTypeKeepSortBy Transition)DEG2RAD TOLERANCEAxisBoundBoxColor ColorLikeLocationMatrixNotAllLocationLikeErrorOrientedBoundBoxPlaneVector VectorLikeall_location_likelogger) BuildPart)Compound)EdgeWire)Solid)FaceShell)Vertex)rrzr{r}r~r|ryr~r}TOPODS)boundShapeceZdZUdZiZded<ejdejdejdejdejdejd ejd ejd iZejd ejej"ejej"ejej$ejej$ejej&ejej&ejej&iZd ed<ej+Dcic]\}}|| c}}}Zejej0ejej2ejej4ejej6ejej8ejej:ejej<ejej>iZ e!jDe#jHe!jJe#jLe!jNe#jPe!jRe#jTe!jVe#jXe!jZe#j\e!j^e#j`e!jbe#jde!jfe#jhi Z5ded<e!jle#jne!jpe#jre!jte#jve!jxe#jze!j|e#j~e!je#j\e!je#j`e!je#je!je#je!je#jde!je#jhi ZHded<eIjeKeIjeMeIjeOiZPded<GddeQZReSjeSjeSjeSjeSjeSjeSjeSjgZT d ddZUeVdZWeWjddZWdZYeVeZddZ[eVddZ\eVddZ]e]jddZ]eVddZ^eVdd Z_eVdd!Z`eVead"dd#ZbeVdd$ZceVdd%ZdeVdd&Zeeejdd'ZeeVdd(ZfeVdd)Zgegjdd*ZgeVdd+Zhehjdd,ZheVdd-ZieVdd.ZjeVdd/ZkeleZdd0ZmeleZ dd1Zneod eSjd2f dd3Zpeodd4Zqeoerjf dd5Zteodd6Zueveo dd7Zweveo dd8Zweveo dd9Zweveo dd:Zweveo dd;Zweveo dd<Zweveo dd=Zweo dd>Zweveodd?Zxeveodd@ZxeveoddAZxeveoddBZxeveoddCZxeveoddDZxeveo ddEZxeo ddFZxel ddGZyel d ddHZzevddIZ{evddJZ{dKZ{ddLZ|ddMZ}ddNZ~ddOZddPZevddQZevddRZddSZevddTZevddUZdVZ d ddWZddXZddYZddZZdd[Z d dd\Zdd]Zdd^Zdd_Z dd`ZddaZddbZddcZdddZddeZddfZ d ddgZddhZdid dj ddkZddlZdmdidn ddoZ d ddpZdddqZddrZddsZddtZdduZdddvZdddwZddxZddyZddzZ d dd{Zdd|Zdd}Zddd~Z d ddZddZddZ d ddZddZddZev ddZevddZevddZev ddZevddZej^fddZev ddZev ddZevejbf ddZeadejbfddZ d d dZ d d dZd dZd dZ d ddZdddZddZddZddZ ddZ ddZ ddZdZddZddZy cc}}}w(raShape Base class for all CAD objects such as Edge, Face, Solid, etc. Args: obj (TopoDS_Shape, optional): OCCT object. Defaults to None. label (str, optional): Defaults to ''. color (ColorLike, optional): Defaults to None. parent (Compound, optional): assembly parent. Defaults to None. Attributes: wrapped (TopoDS_Shape): the OCP object label (str): user assigned label color (Color): object color joints (dict[str:Joint]): dictionary of joints bound to this object (Solid only) children (Shape): list of assembly children of this object (Compound only) topo_parent (Shape): assembly parent of this object z,ClassVar[dict[int | None, CompositeFactory]]composite_factoriesrrzr{r}r~r|ry CompSolidNz%dict[TopAbs_ShapeEnum, CalcFn | None]shape_properties_LUTz$dict[ga.GeomAbs_CurveType, GeomType] geom_LUT_EDGEz&dict[ga.GeomAbs_SurfaceType, GeomType] geom_LUT_FACEz Color | None_colorc0eZdZdZ d ddZy)Shape._DisplayNodez4Used to create anytree structures from TopoDS_ShapesNcJ||_||_||_||_g|_yN)labeladdresspositionparentchildren)selfrrrrs V/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/topology/shape_core.py__init__zShape._DisplayNode.__init__ s'DJ"DL$DM DK)+DM)NNN)rstrr int | NonerzVector | Location | NonerzShape._DisplayNode | None)__name__ __module__ __qualname____doc__rrr _DisplayNoder s>B"&1504 , ,  ,/ , . ,rrc| tttt|nd|_d|_||_||_||_d|_ yNF) tcastrrdowncast_wrappedfor_constructionrcolorr topo_parent)robjrrrs rrzShape.__init__%sO7:oE(6"HSM 24 !&   *.rc6|jsJ|jS)zOCP TopoDS objectrrs rwrappedz Shape.wrapped=s}}}}}rc||_yrrrshapes rrz Shape.wrappedCs  rc|jduSrrrs r__bool__zShape.__bool__Gs}}D((rcy)zDimension of the objectNrrs r_dimz Shape._dimJrc|jyt}tj|j||j S)z1area -the surface area of all faces in this Shape)rrGr6SurfaceProperties_srMassr propertiess rareaz Shape.areaOs9 == !^ %%dllJ?  rc|j%|}||j}|n|j}|}n |j}||_|S)zGet the shape's color. If it's None, get the color of the nearest ancestor, assign it to this Shape and return this value.)rr)r current_node parent_color node_colors rrz Shape.colorYs] ;; 48L*+22 ++22 * &JJ  rc8|t||_yd|_y)zSet the shape's colorN)rlrrvalues rrz Shape.colorls',&7eEl T rc|j tdt|j}|tj k(rDt jttt|jj}|S|tjk(rDt jttt|jj}|St j"}|S)zsGets the underlying geometry type. Returns: GeomType: The geometry type of the shape z0Cannot determine geometry type of an empty shape)r ValueError shapetyperta TopAbs_EDGErrr"rrUGetType TopAbs_FACErr#rVrdOTHER)rrgeoms r geom_typezShape.geom_typeqs == OP P"+DLL"9 BNN "&&!% T\\"BCKKMD bnn $&&#E+t||$DEMMOD  >>D rc|jyt|j}|r|jd}t }t j |tjtj|t|jD]}tj|j|dz}t}t}t j ||||j#r"|j#r|j%|r|j'|dzjdk7sy|ry)zis_manifold Check if each edge in the given Shape has exactly two faces associated with it (skipping degenerate edges). If so, the shape is manifold. Returns: bool: is the shape manifold or water tight FrrxT)rget_top_level_topods_shapesrpopr]rOMapShapesAndAncestors_srrrrangeExtentrRrzFindKeyr[ Vertices_sIsNullIsSame FindFromIndex)r shape_stackr shape_mapiedgevertex0vertex1s r is_manifoldzShape.is_manifolds == 1$,,? OOA&EBCI  * *  9++-. !{{9#4#4QU#;<'/'/!!$9>>#(8W^^G=T **1q5188:a? ' !%NrcV|jduxs|jjS)zReturns true if this shape is null. In other words, it references no underlying shape with the potential to be given a location and an orientation. N)rrrrs ris_nullz Shape.is_nulls% }}$= (;(;(==rzqThe 'is_planar_face' property is deprecated and will be removed in a future version. Use 'Face.is_planar' insteadc|jt|jtsyt j |j}t |t}|jS)zEIs the shape a planar face even though its geom_type may not be PLANEF) r isinstancerrVr! Surface_sr>riIsPlanar)rsurfaceis_face_planars ris_planar_facezShape.is_planar_facesM == 4<<(M%%dll30)D&&((rc|jyt|j}|jd|j S)zReturns True if no defect is detected on the shape S or any of its subshapes. See the OCCT docs on BRepCheck_Analyzer::IsValid for a full description of what is checked. T)rr3r SetParallelIsValid)rchks ris_validzShape.is_valids7 ==  . {{}rcBtd|jtS)aS The location of this Shape relative to the global coordinate system. This property computes the composite transformation by traversing the hierarchy from the root of the assembly to this node, combining the location of each ancestor. It reflects the absolute position and orientation of the shape in world space, even when the shape is deeply nested within an assembly. Note: This is only meaningful when the Shape is part of an assembly tree where parent-child relationships define relative placements. c ||jzSr)location)locns rz'Shape.global_location..sS1::%5r)r pathrnrs rglobal_locationzShape.global_locations5tyy(*MMrcv|j tdt|jjS)zGet this Shape's Locationz)Can't find the location of an empty shape)rrrnrrs rrzShape.locations2 == HI I --/00rch|j&|jj|jyy)zSet Shape's Location to valueN)rrnrs rrzShape.locations) << # LL ! !%-- 0 $rc R|j tdt}tj|j ||j }g}tdD]@}|jtdDcgc]}|j|dz|dzc}B|Scc}w)u Compute the inertia matrix (moment of inertia tensor) of the shape. The inertia matrix represents how the mass of the shape is distributed with respect to its reference frame. It is a 3×3 symmetric tensor that describes the resistance of the shape to rotational motion around different axes. Returns: list[list[float]]: A 3×3 nested list representing the inertia matrix. The elements of the matrix are given as: | Ixx Ixy Ixz | | Ixy Iyy Iyz | | Ixz Iyz Izz | where: - Ixx, Iyy, Izz are the moments of inertia about the X, Y, and Z axes. - Ixy, Ixz, Iyz are the products of inertia. Example: >>> obj = MyShape() >>> obj.matrix_of_inertia [[1000.0, 50.0, 0.0], [50.0, 1200.0, 0.0], [0.0, 0.0, 300.0]] Notes: - The inertia matrix is computed relative to the shape's center of mass. - It is commonly used in structural analysis, mechanical simulations, and physics-based motion calculations. z&Can't calculate matrix for empty shaperx) rrrGr6VolumeProperties_srMatrixOfInertiarappendValue)rrinertia_matrixmatrixrjs rmatrix_of_inertiazShape.matrix_of_inertiasD == EF F!^ $$T\\:>#335q RA MMuQxP!>//Aq1u=P Q R Qs:B$ c\|j td|jjS)z6Get the orientation component of this Shape's Locationz,Can't find the orientation of an empty shape)rr orientationrs rrzShape.orientation.s* == KL L}}(((rcP|j}|t||_||_yy)zCSet the orientation component of this Shape's Location to rotationsN)rrsr)r rotationsrs rrzShape.orientation5s*mm ?$Y/CODM rct|j |j td|jjS)z3Get the position component of this Shape's Locationz)Can't find the position of an empty shape)rrrrrs rrzShape.position=s3 == DMM$9HI I}}%%%rcP|j}|t||_||_yy)z>> obj = MyShape() >>> obj.principal_properties [(Vector(1, 0, 0), 1200.0), (Vector(0, 1, 0), 1000.0), (Vector(0, 0, 1), 300.0)] z*Can't calculate properties for empty shaperrxr) rrrGr6rrPrincipalPropertiesMomentsrsFirstAxisOfInertiaSecondAxisOfInertiaThirdAxisOfInertia)rrprincipal_propsprincipal_momentss rprincipal_propertieszShape.principal_propertiesLs" == IJ J!^ $$T\\:>$88:+335 O668 9;LQ;O P O779 :>> obj = MyShape() >>> obj.static_moments (150.0, 200.0, 50.0) z'Can't calculate moments for empty shape)rrrGr6rr StaticMomentsrs rstatic_momentszShape.static_momentsosD, == FG G!^ $$T\\:>''))rcy)z6Returns the right type of wrapper, given a OCCT objectNr)clsrs rrz Shape.castrrcy)aextrude Extrude a Shape in the provided direction. * Vertices generate Edges * Edges generate Faces * Wires generate Shells * Faces generate Solids * Shells generate Compounds Args: direction (VectorLike): direction and magnitude of extrusion Raises: ValueError: Unsupported class RuntimeError: Generated invalid result Returns: Edge | Face | Shell | Solid | Compound: extruded shape Nr)rr directions rextrudez Shape.extruderrTctj|j}|r(t|jj }nt |j }|j tj|t|||t}|j||d}|jr|j} tjj| jtjj|krtj| ||||j!|jr|S)z4Create an anytree copy of the TopoDS_Shape structure)rr ShapeType bounding_boxcenterrnrridrW InitializeMorer_ordered_shapesindex _build_treeNext) rtreerlimit show_centerobj_typeriterator parent_nodechilds rr'zShape._build_trees??5??#45 ,++-446C5>>+,C E&&xECHI"$E"2h mmoNN$E$$**!&&,,U34!!%{EB MMO mmo rc |jDcgc]#}|jt|jf%}}|j |jt|jft |jdzDcgc]t tfd|}}|Dcgc]}tdtd|D }}tt|Dcgc] \}}||dzz} }}t| dz} d} t|D]\} } }| |jj| }t|dr1|j}d}|rd|jdnd |jd}n[t!|}|j"j$jd }|rd|j'dnt)|j*}| ||d |d d |dz } | Scc}wcc}wcc}wcc}}w)z5Display an assembly or TopoDS_Shape anytree structurerxc|dk(SNrr)llls rrz"Shape._show_tree..s2a5A:rc3&K|] }|d yw)rxNr).0r4s r z#Shape._show_tree..s+qt+srrCenterz.6gPosition zat z#xz,  ) descendantsheightlenrrrlistfiltermax enumeratereversedrljusthasattrrrr" __class__rr!reprr) root_noder+node size_tuplesr4size_tuples_per_levellevelmax_sizes_per_levelrlevel_sizes_per_leveltree_label_widthresultpre_filltreestrrnamers ` r _show_treezShape._show_trees CLBWBWX$ S_5X XI,,c)//.BCD9++a/0!  -{; <! ! ;P 16C3+U++ ,  #,H5H,I"J! !QAAI! ! 459 *9 5 A Cdjj\*001ABGy),,,#T]]3/0#DMM##67 T(~~..44Q74?fT[[]3/0T$--EX  $s72,bR@ @F! A" EY!  ! s(G)G.*#G3&G8ct|}|tjk(rtd|D}|Dcgc]C}|j tjj t j|E}}|d}|ddD]}|j|}t|j d|z }|S|tjk(rtt|}g}|D]/}|j|jj 1|d}|ddD]}|j|}t|j d|z }|Stdcc}w)aycombined center Calculates the center of a multiple objects. Args: objects (Iterable[Shape]): list of objects center_of (CenterOf, optional): centering option. Defaults to CenterOf.MASS. Raises: ValueError: CenterOf.GEOMETRY not implemented Returns: Vector: center of multiple objects c3FK|]}tj|ywr)r compute_massr7os rr8z(Shape.combined_center..sDqU//2Ds!rrxN?z!CenterOf.GEOMETRY not implemented)r@rcMASSsumr!multiplyrrYaddrs BOUNDING_BOXr?rr r) objects center_of total_massr[weighted_centerssum_wcweighted_centermiddlers rcombined_centerzShape.combined_centerso$w-  %DGDDJQX LM'001C1CA1FG   &a(F#3AB#7 5O4 5FOOC*,<=>F  (// /T']+J!  E ''(8(8(:(A(A(CD E&a(F#3AB#7 5O4 5FOOC*,<=>F @A A+ sAE%c|syt}tjt|j}|t ||j||j S)zCalculates the 'mass' of an object. Args: obj: Compute the mass of this object obj: Shape: Returns: r)rGrrrrNotImplementedErrorr)rr calc_functions rrYzShape.compute_mass"sQ!^ 229S[[3IJ  % %ckk:.  rcyrrr entity_types rget_shape_listzShape.get_shape_list9s rcyrrrns rrpzShape.get_shape_list?rcyrrrns rrpzShape.get_shape_listErrrcyrrrns rrpzShape.get_shape_listKrrrcyrrrns rrpzShape.get_shape_listQrcyrrrns rrpzShape.get_shape_listWrvrcyrrrns rrpzShape.get_shape_list]s"rc|s tSt|j|Dcgc]}|jj|c}}|D]!}|j|n |j|_#|Scc}w)z;Helper to extract entities of a specific type from a shape.) ShapeListentitiesrGrr)rror shape_listitems rrpzShape.get_shape_listcsy; .3nn[.I JU__ ! !! $ J  YD(-(9(9(AuuGXGXD  Y Ks"A6cyrrrns rget_single_shapezShape.get_single_shapetsRUrcyrrrns rrzShape.get_single_shapexNQrcyrrrns rrzShape.get_single_shape|rrcyrrrns rrzShape.get_single_shaperrcyrrrns rrzShape.get_single_shapePSrcyrrrns rrzShape.get_single_shaperrcyrrrns rrzShape.get_single_shapesrctj||}t|}|dk7rtd|j d||dS)zReturn the single entity of the requested type. Raises: ValueError: if the number of matching entities is not exactly one. rxzExpected exactly one z, found r)rrpr?rlower)rror| entity_counts rrzShape.get_single_shapesZ))%= : 1 ' (9(9(;'sBcyrrrothers r__add__z Shape.__add__,/rcyrrrs rrz Shape.__add__JMrc|g}n;t|tr|gn|Dcgc]}||jD]}|}}}|s|S|j t dt fd|Ds t d|j ,t|dk(r|d}|S|dj|dd}|S|j|}|Scc}}w)zfuse shape to self operator +Nz0Dimensions of objects to add to are inconsistentc3<K|]}|jk(ywrr)r7summand addend_dims rr8z Shape.__add__..sF'7<<:-Fz0Only shapes with the same dimension can be addedrxr) rrget_top_level_shapesrrallrr?fuse)rrsummandsr[r sum_shapers @rrz Shape.__add__s  =H &0u%=5'5=335   HKYY  OP PFXFFOP P == 8}!$QK  -HQK,,hqrl; " 8,I7s Ccft|ttfr|n|g}|rt|tr |s t d|j |}t|tr)t |dk(r|d}ntj|}|,|j tjr|j}|S)z$intersect shape with self operator &z*Cannot intersect shape with empty compoundrxr) rr@tuplerr intersectr?rr SkipCleanclean)rrothers new_shapes r__and__z Shape.__and__s$UT5M: 5%0IJ J"DNNF+ i &9~"%aL !00;  Y%6%6%By!)Irctj|}|jA|jJ|jj|jj|S)aReturn shallow copy or reference of self Create an copy of this Shape that shares the underlying TopoDS_TShape. Used when there is a need for many objects with the same CAD structure but at different Locations, etc. - for examples fasteners in a larger assembly. By sharing the TopoDS_TShape, the memory size of such assemblies can be greatly reduced. Changes to the CAD structure of the base object will be reflected in all instances. )copydeepcopyrTShape)r references r__copy__zShape.__copy__sWMM$' << #!!- -    $ $T\\%8%8%: ;rc |j}|j|}||t|<|jBt t |jj |t|j<|jjD]_\}}|dk(r||_ n!t||tj|||dk(s:|jjD] }||_ a|S)zReturn deepcopy of selfrjoints)rG__new__r"rrr*r__dict__itemsrsetattrrrrvaluesr)rmemorrQkeyrjoints r __deepcopy__zShape.__deepcopy__ s nnS!RX << #%-.A$,,.O.U.U.W%XDDLL! "----/ *JCm#%*"T]]5$%?@h#]]113*E#)EL*  * rcPt|tr|j|StS)aCheck if two shapes are the same. This method checks if the current shape is the same as the other shape. Two shapes are considered the same if they share the same TShape with the same Locations. Orientations may differ. Args: other (Shape): The shape to compare with. Returns: bool: True if the shapes are the same, False otherwise. )rris_sameNotImplementedrs r__eq__z Shape.__eq__!s# eU #<<& &rcF|jyt|jS)zReturn hash coder)rhashrrs r__hash__zShape.__hash__2s == DLL!!rcyrrrs r__rmul__zShape.__rmul__8s9.es%Jaffn%Jsz7Dimensions of objects to subtract from are inconsistentc3(K|] }|k ywrr)r7d minuend_dims rr8z Shape.__sub__..js81q;8szCOnly shapes with equal or greater dimension can be subtracted: not z (zD) and zD)) rrrrrranyrrmincut) rr subtrahendsr[rrsubtrahend_dims differencers @rrz Shape.__sub__NsM == HI I =K &0u%=5'5=335   KKii  #%Jk%J"JVW W,7Ma!&&:L166MM 88 8Dz**+2k]';''(3+?*@D TXX{+ 9"Ns D D D c|jttS|tn|}tj|j ||S)zCreate a bounding box for this Shape. Args: tolerance (float, optional): Defaults to None. Returns: BoundBox: A box sized to contain this Shape ) toleranceoptimal)rrkrri from_topo_dsr)rrrs rr zShape.bounding_boxvsA == GI& &!*!2I $$T\\YPWXXrcB|j|St|jddd}|jd |j t t t|j|_|S#t$rtjd|dY|SwxYw)zclean Remove internal edges Returns: Shape: Original object with extraneous internal edges removed TFzUnable to clean r stacklevel) rrLrAllowInternalEdgesBuildrrrr Exceptionwarningswarn)rupgraders rrz Shape.cleans == K/ dD$O##E* C NN  (..2B)CDDL  C MM,TF3 B  CsFM#]]113*E#)EL*VT*gdD&9: ;rc>t}|j|f||S)zRemove the positional arguments from this Shape. Args: *to_cut: Shape: Returns: Self | Compound: Resulting object may be of a different class than self )r&_bool_op)rto_cutcut_ops rrz Shape.cuts!!"}}dWff55rc|j|s tdt|j|jj S)zfMinimal distance between two shapes Args: other: Shape: Returns: 3Cannot calculate distance to or from an empty shape)rrr4rrrs rdistancezShape.distances: == RS S)$,, FLLNNrc*|j|dS)z#Minimal distance between two shapesrrrs r distance_tozShape.distance_tos33E:1==rcV|jt|tr |s tdt|trt t |j }nMt|}tt|j|j|jj}t}|j|j |j!||j#|j%t|j'dt|j)dfS)z@Minimal distance between two shapes and the points on each shaperrx)rrrrrrXrrsr-rCXYZrr4LoadS1LoadS2Performr PointOnShape1 PointOnShape2)rr topods_shapevec dist_calcs rrz%Shape.distance_to_with_closest_pointss == Zu%=eRS S eU # u}}=L-C4suuceeSUU+fh /0 && OO  9**1- . 9**1- .  rc'&K|j tdt}|j|j|D]L}|s td|j |j|j |jNyw)zwMinimal distances to between self and other shapes Args: *others: Shape: Returns: Nr)rrr4rrrrr)rrr other_shapes r distanceszShape.distancess == RS S.0 &! $K !VWW   [00 1    //# #  $sBBc.tj|dS)Return the Edgerzrrs rrz Shape.edge%%dF33rcVtj|d}|jddS)z=edges - all the edges in this Shape - subclasses may overriderzc@tj|jSr)r! Degenerated_sr)rs rrzShape.edges..#si--aii8rTreverse)rrp filter_by)r edge_lists redgesz Shape.edgess1((v6 "" 8$#  rcJ|jgSt|j|S)z7Return all of the TopoDS sub entities of the given type)r_topods_entitiesr)r topo_types rr{zShape.entities&s" == I i88rc.tj|dS)Return the Facer}rrs rfacez Shape.face,rrc.tj|dS)z#faces - all the faces in this Shaper}rrprs rfacesz Shape.faces0##D&11rc|j tSt|jj }t }|j |j||g}|jr|j}|jjj|}|j|jt|f|j|jr|j!d|Dcgc]}|d } }t| Dcgc]}|j"j%|c}Scc}wcc}w)aLine Intersection Computes the intersections between the provided axis and the faces of this Shape Args: axis (Axis): Axis on which the intersection line rests tol (float, optional): Intersection tolerance. Defaults to 1e-4. Returns: list[Face]: A list of intersected faces sorted by distance from axis.position c |dSNrxr)xs rrz1Shape.faces_intersected_by_axis..[s adrrr)rrzr<rrr8Initr$Pntrto_pntSquareDistancerr}absr(sortrGr) raxistollineintersect_maker faces_distinter_ptrr)r,s rfaces_intersected_by_axiszShape.faces_intersected_by_axis4s == ; 4<<(..035T\\45 ""$&**,H}}++-<> ?   ! !# &}}dWgw? rc~j tStfdtjDS)a2 Retrieve the first level of child shapes from the shape. This method collects all the non-compound shapes directly contained in the current shape. If the wrapped shape is a `TopoDS_Compound`, it traverses its immediate children and collects all shapes that are not further nested compounds. Nested compounds are traversed to gather their non-compound elements without returning the nested compound itself. Returns: ShapeList[Shape]: A list of all first-level non-compound child shapes. Example: If the current shape is a compound containing both simple shapes (e.g., edges, vertices) and other compounds, the method returns a list of only the simple shapes directly contained at the top level. c3TK|]}jj|!ywrrGr)r7rrs rr8z-Shape.get_top_level_shapes..s% '(DNN   " %()rrzrrrs`rrzShape.get_top_level_shapess:$ == ;  ,G ,U   rư>)rinclude_touchedc ||sy|D]>}t|ttttt fr)t dt|t|g}|D]`}t}|D]7}|j|||}|s|j|j9|sytt|}b|r|SdS)u[Find where bodies/interiors meet (overlap or crossing geometry). This is the main entry point for intersection operations. Handles geometry conversion and delegates to subclass _intersect() implementations. Semantics: - Multiple arguments use AND (chaining): c.intersect(s1, s2) = c ∩ s1 ∩ s2 - Compound arguments use OR (distribution): c.intersect(Compound([s1, s2])) = (c ∩ s1) ∪ (c ∩ s2) Args: to_intersect: Shape(s) or geometry objects to intersect with tolerance: tolerance for intersection detection include_touched: if True, include boundary contacts without interior overlap (only relevant when Solids are involved) Returns: ShapeList of intersection results, or None if no intersection Nz Unsupported type for intersect: ) rrrsrnrjrrrrrz _intersectextendexpandr) rrrP to_intersectr common_setrnext_setrQs rrzShape.intersects4  QCcE68T5#IJ #CDI;!OPP Q v& ! 2E"++H! 5y/JOOFMMO4 5"3x=1J 2(z1T1rcy)aSingle-object intersection implementation. Base implementation returns None. Subclasses (Vertex, Mixin1D, Mixin2D, Mixin3D, Compound) override this to provide actual intersection logic. Args: other: Shape or geometry object to intersect with tolerance: tolerance for intersection detection include_touched: if True, include boundary contacts Returns: ShapeList of intersection shapes, or None if no intersection Nr)rrrrPs rrRzShape._intersects&rctS)aFind boundary contacts between this shape and another. Base implementation returns empty ShapeList. Subclasses (Mixin2D, Mixin3D, Compound) override this to provide actual touch detection. Args: other: Shape to find contacts with tolerance: tolerance for contact detection Returns: ShapeList of contact shapes (empty for base implementation) r)rrrs rtouchz Shape.touchs {rcj|j|sy|jj|jS)zReturns True if two shapes are equal, i.e. if they share the same TShape with the same Locations and Orientations. Also see :py:meth:`is_same`. Args: other: Shape: Returns: F)rrIsEqualrs ris_equalzShape.is_equals, == ||##EMM22rcj|j|sy|jj|jS)zReturns True if other and this shape are same, i.e. if they share the same TShape with the same Locations. Orientations may differ. Also see :py:meth:`is_equal` Args: other: Shape: Returns: F)rrrrs rrz Shape.is_sames, == ||""5==11rc~|j td|jj|j|S)znApply a location in absolute sense to self Args: loc: Location: Returns: Cannot locate an empty shape)rrrrnrrs rlocatez Shape.locate,s5 == ;< < ckk* rc|j tdtj|d}|jj |j|S)zlocated Apply a location in absolute sense to a copy of self Args: loc (Location): new absolute location Returns: Shape: copy of Shape at location Nr`)rrrrrrnrrrBs rlocatedz Shape.located;sH == ;< <]]4. ##CKK0rc|j tdtj|j|st |j|d|dyy)zGenerate triangulation if none exists. Args: tolerance: float: angular_tolerance: float: (Default value = 0.1) Returns: NzCannot mesh an empty shapeT)rrr;Triangulation_srr9)rrangular_tolerances rmeshz Shape.meshLsL == 9: :((yA $ i/@$ Brc|stj}|j|St}|j t |j j|jj|j|S)z Applies a mirror transform to this Shape. Does not duplicate objects about the plane. Args: mirror_plane (Plane): The plane to mirror about. Defaults to Plane.XY Returns: The mirrored shape ) rrXYrrD SetMirrorr@originr5z_dirto_dir_apply_transform)r mirror_planetransformations rmirrorz Shape.mirror^so 88L == K   <&&--/1C1C1J1J1L M $$^44rc~|j td|jj|j|S)zApply a location in relative sense (i.e. update current location) to self Args: loc: Location: Returns: Cannot move an empty shape)rrrMoveras rmovez Shape.movets5 == 9: : #++& rct|tr |j}|j t dt j |d}ttt|jj|j|_ |S)amoved Apply a location in relative sense (i.e. update current location) to a copy of self Args: loc (Location | Plane): new location relative to current location Returns: Shape: copy of Shape moved to relative location Nru) rrrrrrrrrrrrMovedrds rrz Shape.movedsj c5 !,,C == 9: : MM$5 "68DLL4F4Fs{{4S+TU rcV|jttSt|S)zCreate an oriented bounding box for this Shape. Returns: OrientedBoundBox: A box oriented and sized to contain this Shape )rrqrrs roriented_bounding_boxzShape.oriented_bounding_boxs& == #GI. .%%rc |j}|j}t|ttfs6|j *t|j t r|j}|djjj}tjdt|g}|D]}|j} | jj| jjzdz } || |z |z z} |j| } |j!| } t#| || z }|j%|d\}}t'|| |}|j)|j+t-| ddf}tjd| |j/|j1||dzdtjdt|t3|S)aFProjected Faces following the given path on Shape Project by positioning each face of to the shape along the path and projecting onto the surface. Note that projection may result in distortion depending on the shape at a position along the path. .. image:: projectText.png Args: faces (Union[list[Face], Compound]): faces to project path: Path on the Shape to follow start: Relative location on path to start the faces. Defaults to 0. Returns: The projected faces rzprojecting %d face(s)r)rmx_dirrnzprojecting face at %0.2frzfinished projecting '%d' faces)lengthr!rr@rrrTr,r rr rvdebugr?rB position_at tangent_atrjfind_intersection_pointsrrfrom_local_coordsrrnrproject_to_shaperz)rr,rstart path_length shape_centerfirst_face_min_xprojected_facesr)bbox face_center_xrelative_position_on_wire path_position path_tangentprojection_axis surface_pointsurface_normalsurface_normal_planeprojection_faces r project_faceszShape.project_facess4kk {{} 54-0 )5==/:KKME 80026688 ,c%j9 D$$&D!XXZZ$((**49M)99[HH &!,,-FGM??+DEL"=,2NOO,0,I,I-- )M>$)$L$ %9$J$J 8m^Q$:;<%O LL35N O  " "00~7JKAN ) 0  5s5zB))rc|j tdt}tj|j ||j |j S)uT Compute the radius of gyration of the shape about a given axis. The radius of gyration represents the distance from the axis at which the entire mass of the shape could be concentrated without changing its moment of inertia. It provides insight into how mass is distributed relative to the axis and is useful in structural analysis, rotational dynamics, and mechanical simulations. Args: axis (Axis): The axis about which the radius of gyration is computed. The axis should be defined in the same coordinate system as the shape. Returns: float: The radius of gyration in the same units as the shape's dimensions. Example: >>> obj = MyShape() >>> axis = Axis((0, 0, 0), (0, 0, 1)) >>> obj.radius_of_gyration(axis) 5.47 Notes: - The radius of gyration is computed based on the shape’s mass properties. - It is useful for evaluating structural stability and rotational behavior. z2Can't calculate radius of gyration for empty shape)rrrGr6rrRadiusOfGyration)rr9rs rradius_of_gyrationzShape.radius_of_gyrationsJ6 == QR R!^ $$T\\:>**4<<88rcttjdtd|j t d|j |k7rt }|j|j jjt }|j|jjt}|j||t|j|dd}ttt|j!|_|jj#|jyy)zChange the location of self while keeping it geometrically similar Args: loc (Location): new location to set for self zwThe 'relocate' method is deprecated and will be removed in a future version.Use move, moved, locate, or located insteadrrNzCannot relocate an empty shapeT)rrDeprecationWarningrrrrA TransformrTransformationrDSetDisplacementr1rrrrrn)rrold_axnew_axtrsfbuilders rrelocatezShape.relocate s   :   == => > ==C XF   T]]22AAC DXF   S[[779 :9D   0.t||T4NG '--/)BCDL LL ! !#++ . rc|j|St}|j|j|tz|r|j |}|S|j tt|}|S)adrotate a copy Rotates a shape around an axis. Args: axis (Axis): rotation Axis angle (float): angle to rotate, in degrees transform (bool): regenerate the shape instead of just changing its location. Defaults to False. Returns: a copy of the shape, rotated ) rrD SetRotationrrhrprrnrQ)rr9angle transformrr rotated_selfs rrotatez Shape.rotate'sm == K ""4<<A 00@L ::h~/N&OPLrc |j}|J| |jn t|}t|tt frDt }|j|jt ||j|St|trt|dk(rtd|Drt|}t|jdd|jd|jz zgd|jd|jd|jz zgdd|j |j d|j z zggdg}|j#|St%d)a'Scale this shape about a point. Non-uniform scaling may change the underlying geometry type to splines. When ``about`` isn't provided, the shape is scaled about its location. Args: factor (float | tuple[float, float, float]): uniform scale factor or three scale factors for the X, Y and Z directions. about (VectorLike, optional): point to scale about. Defaults to the shape's location position. Returns: Shape: a copy of the scaled shape. rc3HK|]}t|ttfywr)rintfloat)r7scales rr8zShape.scale..`sHJusEl3H "rrx)rrrr\z0factor must be a float or a three tuple of float)rrrsrrrrDSetScaler5rprr?rror r r transform_geometryr)rfactoraboutcurrent_location about_pointrr scale_vector scale_matrixs rrz Shape.scaleAsN( ==+++38=&//fUm fsEl +$YN  # #K$6$6$8%- H((8 8 vu %F q HHH!&>L!%# \^^);< $# \^^);< $# \^^);<  )'L.**<8 8OP Prc.tj|dS)Return the Shellr~rrs rshellz Shape.shell~%%dG44rc.tj|dS)z%shells - all the shells in this Shaper~r+rs rshellsz Shape.shells##D'22rcf|jDt|jtr*|jr|dn|}tj ||}|Stj tt|jgtj|}|dn|}tj |d|}|S)uDisplay internal topology Display the internal structure of a Compound 'assembly' or Shape. Example: .. code:: >>> c1.show_topology() c1 is the root Compound at 0x7f4a4cafafa0, Location(...)) ├── Solid at 0x7f4a4cafafd0, Location(...)) ├── c2 is 1st compound Compound at 0x7f4a4cafaee0, Location(...)) │ ├── Solid at 0x7f4a4cafad00, Location(...)) │ └── Solid at 0x7f4a11a52790, Location(...)) └── c3 is 2nd Compound at 0x7f4a4cafad60, Location(...)) ├── Solid at 0x7f4a11a52700, Location(...)) └── Solid at 0x7f4a11a58550, Location(...)) Args: limit_class: type of displayed leaf node. Defaults to 'Vertex'. show_center (bool, optional): If None, shows the Location of Compound 'assemblies' and the bounding box center of Shapes. True or False forces the display. Defaults to None. Returns: str: tree representation of internal structure F)r)r*Tr) rrrTrrrVr'rrXinverse_shape_LUT)r limit_classr+rQr)s r show_topologyzShape.show_topologysD LL $4<<9 #.#6%KK%%dK8F $$lDLL1--k:%D #."5$;K%%d1g{;F rc.tj|dS)Return the Solidr|rrs rsolidz Shape.solidrrc.tj|dS)z%solids - all the solids in this Shaper|r+rs rsolidsz Shape.solidsrrcy)z split and keep inside or outsideNrrtoolkeeps rsplitz Shape.splitrrcy)z%split and return the unordered piecesNrrs rrz Shape.splitrrcy)z!split and keep inside and outsideNrrs rrz Shape.splitrrcy)z invalid splitNrrs rrz Shape.splitrrcy)zsplit and keep inside (default)Nr)rrs rrz Shape.splitrrcj|s td|tjtjfvrt|dt }|j jt|tr#t|jjn |j}t }|j |t}|j||j||jt!|j#}t|t$r t'|d}|tj(k(rt+fdt-|DSt|ts&t|t.r>t1|t2j4}t7j|j9} n|} t;} t=} t?j@| \} } }}tC| jE| | zdz ||zdz | | tG| jI| jK| jMjO}tG| }||z}tQ||jS}|jU}g}g}tW}t-|D]}jXj[|}t|tr-|j]|j_jLdk\}nDta|fftc}tejf|||jitjk\}|r|n|jm||sdnto|dk(r|dn|}|sdnto|dk(r|dn|}|tjpk(r||fS|tjrk(r|S|tjtk(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. Nz#Can't split an empty edge/wire/toolz is invalidTc3TK|]}jj|!ywrrM)r7partrs rr8zShape.split..s(##D)rNrrrx);rrreINSIDEOUTSIDEr^Appendrrrrr,r}r) SetArgumentsSetToolsrrrrTunwrap_topods_compoundALLrzrrYrPrrrRCurrentrCrEr; UVBounds_sr7Normalrsr r r  normalizedr:r5r|rGrGrto_local_coordsr!_topods_bool_opr%r6LinearProperties_srrirr?BOTHTOPBOTTOM)rrrr| trim_tool tool_listsplitter split_result face_explorer tool_face surface_gppntru_minu_maxv_minv_maxnormalized_surface_normalr ref_pointhalf_space_maker tool_solidtopsbottomsrr sub_shapeis_up is_up_objtopbottoms` rrz Shape.splitsd, == BC C DKK. .v[12 2)+ $,,' $& $DLL 1 6 6 8  )* #() j))$  01 lO 41,EL 488 7 E  $&)\2 / 2>> J "KK (=(=(?@ % #HM#XN)2)=)=i)H &E5% 9 % , ,!#eemq%8- )/  "N$4$4$68H8H8J)jl &#=1M%(AAI 9IDTDTDVW )//1J!!^ / = ;D++D1I$&,,Y7>>@BBaG,Gj],>,@ ,,Y C")Y6T / / : ;ds4yA~DG4$G 8I'!*w 499 = 488 J 4;; M rcy)z-split_by_perimeter and keep inside or outsideNrr perimeterrs rsplit_by_perimeterzShape.split_by_perimeterRrrcy)z.split_by_perimeter and keep inside and outsideNrrs rrzShape.split_by_perimeterXrrcy)z,split_by_perimeter and keep inside (default)Nrrs rrzShape.split_by_perimeterarrzhShape.split_by_perimeter is deprecated; use Face.split_by_perimeter or Shell.split_by_perimeter instead.cBd fd }fd}|tjtjtjhvr t dj t d|j s t dt}|jD] }|s|j|j"g}g}j} | sj} | D]} | st| j} | j|| j|j!|| j#|j!|| j%||} ||} |j&}| r t)d| jDnd}| r t)d| jDnd}t+||z t+||z k}|tjk(r |r| | fS| | fS|tjk(r|r| S| S|r| S| S) aasplit_by_perimeter Divide the faces of this object into those within the perimeter and those outside the perimeter. Note: this method may fail if the perimeter intersects shape edges. Args: perimeter (Union[Edge,Wire]): closed perimeter keep (Keep, optional): which object(s) to return. Defaults to Keep.INSIDE. Raises: ValueError: perimeter must be closed ValueError: keep must be one of Keep.INSIDE|OUTSIDE|BOTH Returns: Union[Face | Shell | ShapeList[Face] | None, Tuple[Face | Shell | ShapeList[Face] | None]: The result of the split operation. - **Keep.INSIDE**: Returns the inside part as a `Shell` or `Face`, or `None` if no inside part is found. - **Keep.OUTSIDE**: Returns the outside part as a `Shell` or `Face`, or `None` if no outside part is found. - **Keep.BOTH**: Returns a tuple `(inside, outside)` where each element is either a `Shell`, `Face`, or `None` if no corresponding part is found. cg}t|jD]\}|j}|js*|j j j ||j^|S)z0Return objects from TopTools_ListOfShape as list)rSizeFirstrrrGr RemoveFirst)losr_firstrs rrz%Shape.split_by_perimeter..getsbF388:& " ||~MM$.."5"5e"<=!  " Mrc|syt|dk(r|dSt|Dcgc]}|jc}}t|trj j |St|Scc}w)zgProcess sides to determine if it should be None, a single element, a Shell, or a ShapeList.Nrxr)r?_sew_topods_facesrrrYrGrrz)sidesrpotential_shellrs r process_sidesz/Shape.split_by_perimeter..process_sidessh5zQQx/E0Jq0JKO/<8~~**?;;U# #1KsA1z;keep must be one of Keep.INSIDE, Keep.OUTSIDE, or Keep.BOTHzCannot split an empty shapez'perimeter must be a closed Wire or Edgec34K|]}|jywrr~r7rs rr8z+Shape.split_by_perimeter..s#CAHH#Crc34K|]}|jywrr rs rr8z+Shape.split_by_perimeter..s$E!QXX$Er)rr^returnr@)rerrrrr is_closedr_r#rrrr,r5AddrrSLeftRightr~r^r7)rrrrr perimeter_edgesperimeter_edgeleftsrights target_shapes target_shape constructorleftrightperimeter_lengthleft_perimeter_lengthright_perimeter_length left_insides` rrzShape.split_by_perimetergsB  $  T\\499= =M  == :; ;""FG G24'oo/ ;N!  " ">#9#9 : ; %'%'  JJLM) 4L-l.B.BCK OOO ,     LL[--/0 1 MM#k//12 3 4U#f%%++GK#Cdjjl#C CQRIN$Eu{{}$E!ETU*-BBCc 5 5G   499 $/D%= BeT] B 4;; &4 1E 1#u--rc  |j td|j||g}g}d}|jD]}|jJt }t j|j| |j |jjtjk(}| fdtd jdzDD cgc]9} t| j| j!| j#;c} z }| j%D cgc]} |rD| j'd|zdz | j'd|zdz | j'd|zdz fnC| j'd|zdz | j'd|zdz | j'd|zdz fc} z }| jz }||fScc} wcc} w)z"General triangulated approximationz Cannot tessellate an empty shaperc3^K|]$}j|j&ywr)Node Transformed)r7rpolyrs rr8z#Shape.tessellate..s)78DIIaL,,T2s*-rxrr)rrrir,rrQr!rgr OrientationrMTopAbs_REVERSEDrNbNodesrsr r r  Trianglesr) rrrhvertices trianglesoffsetr)rr vtr'rs @@r tessellatezShape.tessellates == ?@ @ )./!#02 JJL %D<<+ ++!#C,,T\\3?D%%'Dll..04F4V4VVG G)9BG.c |j tdt}tj|j |||dt jt jd| | }|jj|S)aUto_splines A shape-processing utility that forces all geometry in a shape to be converted into BSplines. It's useful when working with tools or export formats that require uniform geometry, or for downstream processing that only understands BSpline representations. Args: degree (int, optional): Maximum degree. Defaults to 3. tolerance (float, optional): Approximation tolerance. Defaults to 1e-3. nurbs (bool, optional): Use rational splines. Defaults to False. Returns: Self: Approximated shape z!Cannot approximate an empty shaperxT) rrrJrIBSplineRestriction_srga GeomAbs_C0rGr)rdegreernurbsparamsrQs r to_splineszShape.to_splines su" == @A A2411 LL    MM MM I   ~~""6**rc|j|Stj|d}tt |j |j dj }tt||_|S)a[Apply affine transform WARNING: transform_geometry will sometimes convert lines and circles to splines, but it also has the ability to handle skew and stretching transformations. If your transformation is only translation and rotation, it is safer to use :py:meth:`transform_shape`, which doesn't change the underlying type of the geometry, but cannot handle skew transformations. Args: t_matrix (Matrix): affine transformation matrix Returns: Shape: a copy of the object, but with geometry transformed NT) rrrrr+rrrrrt_matrixr transformeds rrzShape.transform_geometry& sc" == KMM$-  %dllH4D4Dd K Q Q S "&+6 rc|j|Stj|d}tt |j |j j j}tt||_|S)aApply affine transform without changing type Transforms a copy of this Shape by the provided 3D affine transformation matrix. Note that not all transformation are supported - primarily designed for translation and rotation. See :transform_geometry: for more comprehensive transformations. Args: t_matrix (Matrix): affine transformation matrix Returns: Shape: copy of transformed shape with all objects keeping their type N) rrrrr1rTrsfrrrr;s rtransform_shapezShape.transform_shapeA sj == KMM$-  $T\\83C3C3H3H3J K Q Q S "&+6 rc rt|jt}t}|j t t dddtddd|jt}|j t t dddtddd|jt}|j t t dddtddd|jt}|jt|j|j||z|z|zS)aTransform Shape Rotate and translate the Shape by the three angles (in degrees) and offset. Args: rotate (VectorLike, optional): 3-tuple of angles to rotate, in degrees. Defaults to (0, 0, 0). offset (VectorLike, optional): 3-tuple to offset. Defaults to (0, 0, 0). Returns: Shape: transformed object rrx)rsr_rhrDrr?rCrBr r r SetTranslationrrp)rrr. rotate_vectort_rxt_ryt_rzt_os rr=zShape.transformedX s"v//8 y q!Q1aA=??Sy q!Q1aA=??Sy q!Q1aA=??Si 6&>112$$S4Z$%6%=>>rc|j|St}|jt|j|r|j |}|S|j tt|}|S)a?Translates this shape through a transformation. Args: vector (VectorLike): relative movement vector transform (bool): regenerate the shape instead of just changing its location Defaults to False. Returns: object with a relative move applied ) rrDrBrsrrprrnrQ)rvectorrrrself_translateds r translatezShape.translateu sm == K %%fVn&<&<= "33NCO#jj/.2Q)RSOrc.tj|dS)Return the Wirer{rrs rwirez Shape.wire rrc.tj|dS)z#wires - all the wires in this Shaper{r+rs rwiresz Shape.wires r-rc|j|Stj|d}t|j|dj }t tt||_|S)zPrivate Apply Transform Apply the provided transformation matrix to a copy of Shape Args: transformation (gp_Trsf): transformation matrix Returns: Shape: copy of transformed Shape NT) rrrr1rrrrr)rrrrBtransformed_shapes rrpzShape._apply_transform sc == K MM$5 4 LL    %'  #684E+FG rct|}t|}|g|z|zDcic]6}tt|drt|t|j8}}t |j ddt |ttfr|dn|}t}|D]*}|j|j|j,t} |D]*}|j| j|j,d} t |trA| jr|jdk(r|j} nt|} nt |t r| jr0|jdk(r|j} nt|} n|jrp| jdk(r| j} nLt| } n@t |t"r0| js|jr|j%S| \|j'||j)| |j+d|j-t/|j1} t2j4rIt7| ddd} | j9d  | j-t/| j1} t | t@r tC| d} t | t@rodd k7rgtEfdtG| D} | D]} |jI| ddgt0jK| d} |jI| ddg| SdjM| } |jI| ddg| Scc}w#t:$rt=j>d d YwxYw)aGeneric boolean operation Args: args: Iterable[Shape]: tools: Iterable[Shape]: operation: Union[BRepAlgoAPI_BooleanOperation: BRepAlgoAPI_Splitter]: Returns: Shape or Compound result orderc |dSr0r)r}s rrz Shape._bool_op.. s DGrr2rrNrxTFz!Boolean operation unable to cleanrrr5c3FK|]}dj|yw)rNr)r7r highest_orders rr8z!Shape._bool_op.. s) a %%a( s!r_NodeMixin__children)'r@rFrrTsortedrrrr^rrr&IsEmptyrr!_make_topods_compound_from_shapesr'r%rGrrSetRunParallelrrrrrrLrrrrrTrrzrrrr)rargstools operationr order_dictbaseargrr topo_resultrresultsrQrWs @rrzShape._bool_op sU$DzU Vd]U* tAw( GT!W]] "  z//17KLRP %TD%=9tAwt"$ )C||' 3<<( )$% *C||' CLL) *  i 1||~::<1$"%))+K"CC"HK  #3 4||~::<1$"%))+K"CC"HK;;=A%"&**,K"CD"IK  #5 6||~~~''    " "3 '   t $  $ $T * OO "9??#45K ??3KtTRH  ' ' . Q &x~~'78 k? 30dCK k? 3 a8HA8M 4[A G" U''>;  fnno 6..0 0&""rc|j|sttfSt|j|j}|j d|j d|j d|jd|j|j}g}t|tj}|jrb|j|jj!t#|j%|j'|jrbt}t|tj(}|jrb|j|jj!t#|j%|j'|jrbtt+||fS)a_ocp_section Create a BRepAlgoAPI_Section object The algorithm is to build a Section operation between arguments and tools. The result of Section operation consists of vertices and edges. The result of Section operation contains: - new vertices that are subjects of V/V, E/E, E/F, F/F interferences - vertices that are subjects of V/E, V/F interferences - new edges that are subjects of F/F interferences - edges that are Common Blocks Args: other (Union[Vertex, Edge, Wire, Face]): shape to section with Returns: tuple[ShapeList[Vertex], ShapeList[Edge]]: section results T)rrzr(rr\ ApproximationComputePCurveOn1ComputePCurveOn2rrrPrN TopAbs_VERTEXr$rrGrrrr(rr)rrsectionintersection_shaper,explorerr#s r _ocp_sectionzShape._ocp_section, sZ, == K- -%dllEMMBt$d#  &  & ,3==?!#"#57G7U7UVmmo OODNN//9I9I9K0LM N MMOmmo"+"#57G7S7STmmo LL,,Xh6F6F6H-IJ K MMOmmo#h-(%00rcXddlm}m}|r||jSt |S)z!Jupyter 3D representation supportr) shape_to_htmlhas_vtk)build123d.jupyter_toolsrqrr _repr_html_rH)rrqrrs rrtzShape._repr_html_] s) C  &224 4Dzrc.tj|dS)Return the Vertexrrrs rvertexz Shape.vertexf s%%dH55rc.tj|dS)z)vertices - all the vertices in this Shaperr+rs rr,zShape.verticesj s##D(33r)NrNN)rTopoDS_Shape | NonerrrColorLike | NonerzCompound | None)rr)rrrr)rz None | Color)rrzrNone)rrd)rboolrrn)rrn)rzlist[list[float]]rrs)rrt)rrt)rzlist[tuple[Vector, float]])rr)rztuple[float, float, float])rz type[Self]rrXrra)rrrrtrz&Edge | Face | Shell | Solid | Compound) rrXr)list[_DisplayNode]rz_DisplayNode | Noner*rNr+r}rr)r+r}rr)rbIterable[Shape]rcrcrrs)rrrr)rrroLiteral['Vertex']rShapeList[Vertex])rrroLiteral['Edge']rShapeList[Edge])rrroLiteral['Wire']rShapeList[Wire])rrroLiteral['Face']rShapeList[Face])rrroLiteral['Shell']rShapeList[Shell])rrroLiteral['Solid']rShapeList[Solid])rrroLiteral['Compound']rShapeList[Compound])rrroGLiteral['Vertex', 'Edge', 'Wire', 'Face', 'Shell', 'Solid', 'Compound']rrz)rrrorrr)rrrorrrz)rrrorrr{)rrrorrr})rrrorrr~)rrrorrr|)rrrorrry)rrrorrr)rrrCompositeFactoryrr|r)rrrrrr)rr|rra)rShape | Iterable[Shape]rSelf | Compound)rrrzNone | Self | Compound)rra)rr)rzPlane | Locationrra)rzIterable[Plane | Location]r list[Self])rz-Plane | Location | Iterable[Plane | Location]NT)r float | Nonerr}rrk)rShape | VectorLikerztuple[Vector, Vector]rryrr)rrrzIterable[str] | None)rrrr)rrrr)rrrr)rrrztuple[float, Vector, Vector])rrrzIterator[float]rrzrr)r&rrlist[TopoDS_Shape]rr}rr)g-C6?)r9rjr:rrr)rHrrCr}r:rrr)rzShapeList[Shape])rU(Shape | Vector | Location | Axis | PlanerrrPr}rShapeList | None)rOF)rrrrrPr}rr)rO)rrrrrrz)rrrr})rrnrra)g?)rrrhr)rqz Plane | Nonerra)rzLocation | Planerra)rrq)r)r,zlist[Face] | Compoundrz Wire | Edgerrrr)r9rjrr)rrnF)r9rjrrrr}rra)rz"float | tuple[float, float, float]rzVectorLike | Nonerrarr~rr)rN)rzGLiteral['Compound', 'Edge', 'Face', 'Shell', 'Solid', 'Vertex', 'Wire']r+z bool | Nonerrrr|rr)r TrimmingToolrzLiteral[Keep.TOP, Keep.BOTTOM]rSelf | list[Self] | None)rrrzLiteral[Keep.ALL]rr)rrrLiteral[Keep.BOTH]rz9tuple[Self | list[Self] | None, Self | list[Self] | None])rrr"Literal[Keep.INSIDE, Keep.OUTSIDE]rr|)rrrr)rrrre)r Edge | Wirerrr%Face | Shell | ShapeList[Face] | None)rrrrrzStuple[Face | Shell | ShapeList[Face] | None, Face | Shell | ShapeList[Face] | None])rrrzLiteral[Keep.INSIDE]rr)rrrre)rrrhrrz/tuple[list[Vector], list[tuple[int, int, int]]])rgMbP?F)r6rrrr7r}rra)r<rorra)rrrr)rrtr.rtrra)rIrtrr}rrarr{rr)rrrDrra)r]rr^rr_3BRepAlgoAPI_BooleanOperation | BRepAlgoAPI_Splitterrr)r]rr^rr_rrrz)rrrzVertex | Edge | Wire | Facerz)tuple[ShapeList[Vertex], ShapeList[Edge]]rrrr)rrrrr__annotations__rrkr TopAbs_WIREr TopAbs_SHELL TopAbs_SOLIDTopAbs_COMPOUNDTopAbs_COMPSOLIDrr6rrrrrrrRrrzr{r}r~r|ryr downcast_LUTr4 GeomAbs_LinerdLINEGeomAbs_CircleCIRCLEGeomAbs_EllipseELLIPSEGeomAbs_Hyperbola HYPERBOLAGeomAbs_ParabolaPARABOLAGeomAbs_BezierCurveBEZIERGeomAbs_BSplineCurveBSPLINEGeomAbs_OffsetCurveOFFSETGeomAbs_OtherCurverr GeomAbs_PlanePLANEGeomAbs_CylinderCYLINDER GeomAbs_ConeCONEGeomAbs_SphereSPHERE GeomAbs_TorusTORUSGeomAbs_BezierSurfaceGeomAbs_BSplineSurfaceGeomAbs_SurfaceOfRevolution REVOLUTIONGeomAbs_SurfaceOfExtrusion EXTRUSIONGeomAbs_OffsetSurfaceGeomAbs_OtherSurfacerrg TRANSFORMEDr2ROUNDr/RIGHTr._transModeDictrrrNr%rpropertyrsetterrrrrrrrrrbrrrrrrrrrr classmethodrr staticmethodr'rVrcr]rirYrrprrrrrrrrrrrr rrrrrrrr rrrr#r{r)r,r?rArrrrRrZr]rrbrerirsrwrr{rrrrrrrrrrrrerrrr1r9rr@r=rKrNrPrprrfrortrwr,)r7kr/s000rrrs(IKEJ (      J [ I $  44  44  55 66 55 I88 Y99 C? +4//*;<<$!QA< &--         FOO V-- L  8?? H,, h00 X..  !1!1  x~~ ;M7  (.. X..  8?? (..   (// !!8#3#3 &&(;(; %%x'9'9   (//  =M9   :44N ,y," (())%%%%$$$$$$&& O$("&"& . .. .  .0  ^^)&&!!$ \\BB255n>> ()  )  NN 11 __11 ))V))   && __    :GG**<EE  $. /  2'+"2"@"@  $     8&&P8@ + +-5+ ++Z!!,  #4   #2 #2 #2 #3 #3 ""#6" ""    UU QQ QQ QQ SS SS #6    *5"5-=5 55>B#$#1;# ## // MM!F$&("" << LL  // MM&R?CY%Y7;Y Y,(@8 AE;;)=;> 6 O> ' % 2$.4 9 42*H*H*H  *HX -2t%)8D f 6 % .2?.2.2 .2  .2h % 7   * " 3 2 "$5, && E*$E*E* E*  E*N 9D/::$(;Q2;Q!;Q  ;Qz53 #' 0 0 ! 0 0d53/ /(F/ !// 4400  (J  ..6:XXun<$<,N< .<< =$=,>= ==CG;;;$;,@; .;;  /GKkkc. c.L----rrceZdZdZddZy)SupportsLessThanzShapeList comparison criteriacyrrrs rrzSupportsLessThan.__lt__~ rrNr)rrrrrrrrrr{ s'-rrTKcneZdZdZdd ddZddZdZdZdZd Z dd Z dd Z d dd Z y )GroupByzKResult of a Shape.groupby operation. Groups can be accessed by index or keyFrc g|_g|_||_tt j t ||||D]I\}\}}|jjt||jj||fKy)Nrr r2) key_to_group_indexgroupskey_frC itertoolsgroupbyrYrrz)rr shapelistr rr shapegroups rrzGroupBy.__init__ s8:*,  $-   fYE7KQV W%  5 A Z KK  y4 5  # # * *C8 4  5rc |j|Sr)rrrs r __getitem__zGroupBy.__getitem__ s{{3rc,t|jSr)iterrrs r__iter__zGroupBy.__iter__ sDKK  rc,t|jSr)r?rrs r__len__zGroupBy.__len__ s4;;rc*tt|Sr)rHrzrs r__repr__zGroupBy.__repr__ sIdO$$rct|Sr)rrs r__str__zGroupBy.__str__ s d|rcl|jD]\}}||k(s |j|cSt|)zSelect group by key)rrKeyError)rrrrs rgroupz GroupBy.group s<++ &DAqax{{1~% &smrcB|j|j|S)zSelect group by shape)r rrs r group_forzGroupBy.group_for szz$**U+,,rc |r|jdy|jddd5t|D]9\}}|r!|jd|j|j |; dddy#1swYyxYw)aS Render a formatted representation of the object for pretty-printing in interactive environments. Args: printer (PrettyPrinter): The pretty printer instance handling the output. cycle (bool): Indicates if a reference cycle is detected to prevent infinite recursion. z(...)rx[],N)textr rC breakabler)rprintercycleidxr}s r _repr_pretty_zGroupBy._repr_pretty_ sv  LL !q#s+ )!*4)IC S)))+NN4( ) ) ) )s AA::BN)rzCallable[[T], K]rz Iterable[T]r r})rr)rr)rrr)rrrr}rr|) rrrrrrrrrrr r rrrrrr sqU 555  5( ! %- =B),)59) )rrc v !"#t|tr t|gn t|}|s tdt d|Ds td|dj #t #fd|Dr tdddd d d d d }tjtjtjtjtjd}#|vrtd#|Dcgc]}|j}}t d|Dr tdttt|}|d"t "fd|ddDr tdtttt"|#}t}|D cic]"} | j || j | $} } #dk(rS|D cic] } | t#} } t%} t'j("j tjtj| t+| j-D]} t/j0| j3| dz}| j5||}|D| j7|D]}t/j8|}t;}t;}t'j<|||||fD]6}| j5||}|||k7s#| |j?|8nt%}t'j("j |#tj@#||D cic]} | g}} i}t+|j-D]r} |j3| dz}g}|j7|D]A}| j5||} | |jC| || jC|C|||<ti!tE}|D]"}||vs|!vs d!|<|jC|$|ri|jG}#dk(r |}n#|D chc]}|D] } | |k7r|  }}} |D]#}|!vr!|dz!|<|jC|%|rid!"#fd } | Scc}wcc} wcc} wcc} wcc} }w)aReturn a key function that yields topological distance to ``other``. The returned callable is intended for use with :meth:`ShapeList.sort_by` and :meth:`ShapeList.group_by`. Distances are measured on the full topology of the shared ``topo_parent`` of the reference shape(s), not only within the ``ShapeList`` being sorted or grouped. The first-pass implementation supports homogeneous collections of: ``Vertex``, ``Edge``, ``Wire``, ``Face``, ``Shell``, and ``Solid``. Adjacency is defined by shared lower-order topology: - ``Face`` via shared ``Edge`` - ``Edge``/``Wire`` via shared ``Vertex`` - ``Shell``/``Solid`` via shared ``Face`` - ``Vertex`` via shared ``Edge`` Reference shapes have distance ``0``. Directly connected shapes have distance ``1``. Each additional intervening peer increases the distance by ``1``. Unreachable shapes return ``inf``. Args: other: reference shape or shapes Raises: ValueError: empty reference set, mixed shape types, unsupported shape type, missing ``topo_parent``, or multiple parents Returns: Callable[[Shape], int | float]: key function for sorting/grouping z6Cannot measure topological distance to an empty objectc3<K|]}t|tywr)rr)r7rs rr8z#topo_distance_to.. s=Ez%'=+Topological distance requires Shape objectsrc3<K|]}|jk7ywr)r)r7r peer_types rr8z#topo_distance_to.. s >U5  y ( >r5Topological distance requires shapes of the same typer,r#rPr,rr)rrzr{r}r~r|)rzr{r}r~r|z*Topological distance is not supported for c3$K|]}|du ywrr)r7rs rr8z#topo_distance_to.. s 0f6T> 0s7Topological distance requires shapes with a topo_parentc3BK|]}j| ywr)r)r7 candidaters rr8z#topo_distance_to.. s LYv~~i( ( LsrxN2Topological distance requires a shared topo_parentrct|ts td|jk7r td|j tdj |js tdj |t}|S)Nrrrr")rrrrrrrr )rgraph_distancerrrs rrztopo_distance_to..key_fj sy#u%JK K >>Y &TU U ?? "VW W~~coo.QR R"sC0r)rrrz int | float)$rrrzrrrrrrkrrrrr@rr`rrr]rOrrrrRrrr FindFromKeyrzr[rr`rrrpopleft)$rsources plural_lutconnector_enum_lutrparents valid_parentspeers shape_hasherpeer peer_lookupvertex_neighborsvertex_edge_mapr&vertex_wrapped vertex_peer edge_wrappedrrrneighbor_wrappedneighborconnector_peer_mappeer_connectorsconnector_to_peers connectorconnected_peers peer_wrappedfrontiersourcecurrent neighborsrrrrs$ @@@rtopo_distance_torA sB%/ue$g >>PQQ J      "Ei[QRR.56Uu  6G6 0 00RSS$u+w/M 1 F L-:K LLMNN )E"$JGFJy4I$J$L ME*,L5:-1dll>V T\\"D(KHMR4STT35[4S4SCE&& NN    NN   ?1134 DE#]]?+B+B519+MNN%//,~*FGK" / ; ;N K D {{<0'/'/!!$9)0'(:D$*|@-4467 >y I 8 "|L'AB<&&t,%,,Y7  8 -< y ) <#%I"WH$ U?vY6 !If  OOF #$ ""$  (1I"1!9.y97?I" &H9$"+G"4q"8Ih  OOH %  & $  LK7 5TD d?dZ d@ dAdZe jddf dBdZ dCdZ!dDd Z"dEd!Z#dFd"Z$e jdf dGd#Z% dH dId$Z&dJd%Z'dKd&Z(dLd'Z)dMd(Z*y))NrzzGSubclass of list with custom filter and sort methods appropriate to CADc |dS)zFirst element in the ShapeListrrrs rrzShapeList.first s Awrc |dS)zLast element in the ShapeListrrrs rlastzShapeList.last s Bxrc<t|ttfr-tt t t t ||gzSt|tr2td|Dr tt |t |zStdt|d)z*Return a new ShapeList that includes otherc3HK|]}t|ttfywrrrrsrZs rr8z$ShapeList.__add__.. s / /0Jq5&/ */ rCannot add object of type to ShapeList) rrsrrzrr@rrrrrrs rrzShapeList.__add__ s efe_ -U47DJ%,@AB B eX &3/ 49/ , T$Z$u+56 64T%[MOPPrc t|ttfr!|jt t ||St|t r%td|Dr|j||Stdt|d)z#In-place addition to this ShapeListc3HK|]}t|ttfywrrHrZs rr8z%ShapeList.__iadd__.. s 1 /0Jq5&/ *1 rrIrJ) rrsrrrrrrrSrrrs r__iadd__zShapeList.__iadd__ sy efe_ - KKa ( x (S1 491 .  KK  8e ]ST TrcBtt|t|zS)z#Intersect two ShapeLists operator &rzrrs rrzShapeList.__and__ TSZ/00rc\t|trt|t|k(StS)zShapeLists equality operator ==rrzrrrs rrzShapeList.__eq__ s/%+ IU #   rcyrrrs rrzShapeList.__getitem__ s47rcyrrrs rrzShapeList.__getitem__ s7:rct|tr#tt|j |St|j |S)z'Return slices of ShapeList as ShapeList)rslicerzr@rrs rrzShapeList.__getitem__ s; c5 !T$Z33C89 9Dz%%c**rc$|j|S)zSort operator >sort_byrrYs r__gt__zShapeList.__gt__ s||G$$rc*|j|dS)z+Group and select smallest group operator <>rr]r_s r __rshift__zShapeList.__rshift__ s}}X&r**rcBtt|t|z S)z-Differences between two ShapeLists operator -rOrs rrzShapeList.__sub__ rPrcHt}|D]}t|tr|j|&t |ds3t|j t r2|jtt|jt|j tr |j|jt|j tr |j|j|jr|j||S)zExpand by dissolving compounds, wires, and shells, filtering nulls. Returns: ShapeList with compounds dissolved to children, wires to edges, shells to faces, and nulls filtered out r)rzrrsrrFrrTrSr@rTrYr,r\r#r)rexpandedrs rrTzShapeList.expand s(k +E%(& *emm_=OOId5k$:$A$A$CD |<OOEKKM2 {;OOEKKM2OOE* +rcx|s tdddStd|Dtddd}|t|z S)z9The average of the center of objects within the ShapeListrc3<K|]}|jywr)r!rZs rr8z#ShapeList.center.. s51AHHJ5r)rsr^r?)r total_centers rr!zShapeList.center s<!Q? "55vaAG c$i''rch|j}t|}|dk7rtd||dS)rrxz%Expected exactly one compound, found r)rr?r)rrcompound_counts rrzShapeList.compound s=NN$ Y Q D^DTUV V|rcnt|Dcgc]}|jD]}|c}}Scc}}w)z/compounds - all the compounds in this ShapeList)rzr)rrcs rrzShapeList.compounds s.Iu7HI!!I!IJJI1 ch|j}t|}|dk7rtd||dS)rrxz!Expected exactly one edge, found r)r#r?r)rr# edge_counts rrzShapeList.edge 9 Z ?@ MN NQxrcnt|Dcgc]}|jD]}|c}}Scc}}w)z'edges - all the edges in this ShapeList)rzr#)rrrs rr#zShapeList.edges -Eu{{}E!!E!EFFErrch|j}t|}|dk7rtd||dS)r(rxz!Expected exactly one face, found r)r,r?r)rr, face_counts rr)zShapeList.face rurcnt|Dcgc]}|jD]}|c}}Scc}}w)z'faces - all the faces in this ShapeList)rzr,)rrfs rr,zShapeList.faces rwrrFcPdd}d d}trnpttrfdnZttr ||n?ttr ||n$tt rfdnt d|rfd}n}tt||S) aPfilter by Either: - filter objects of type planar Face or linear Edge by their normal or tangent (respectively) and sort the results by the given axis, or - filter the objects by the provided type. Note that not all types apply to all objects. Args: filter_by (Callable[[T], bool] | Axis | Plane | GeomType): function, axis, plane, or geom type to filter and possibly sort by. Filtering by a plane returns faces/edges parallel to that plane. reverse (bool, optional): invert the geom type filter. Defaults to False. tolerance (float, optional): maximum deviation from axis. Defaults to 1e-5. Raises: ValueError: Invalid filter_by type Returns: ShapeList: filtered list of objects cdfd }|S)Nct|jtrtt j |jt jrt}t}tj|j\}}}}t|jj||||t|j|j!|j#j%}t'|j)|}nt|jt*r|j,t.j0k(rs|j3}|j5} t} t} |j7| | | t| } tt9| } t'| | }nyj;|Sr)rrrVr>r!rrirrCrEr;rr7rrsr r r rrjr!rUrrdr geom_adaptorFirstParameterD1rB is_parallel)rgp_pntru_valrv_valr shape_axiscurveumintmpres start_pos start_dirr9rs rpredzBShapeList.filter_by..axis_parallel_predicate..pred< sdu}}k:/!++EMM:Ihj!$XF%+XN)2)=)=emm)L&E1eQ"5==188ufn17&((*N,<,<,>@P@P@R1 jl."&elln6O!PJu}}k:8==8!..0E //1D (C (CHHT3, &s I &vc{ 3I!%i!;J '' I>>rrrr)r9rrs`` raxis_parallel_predicatez4ShapeList.filter_by..axis_parallel_predicate; s ?BKrc`tjjdfd S)Nc pt|jtrtt j |jt jrt}t}tj|j\}}}}t|jj||||t|j}t!|j#|} j%|St|jt&r"t) fd|j+DSt|jt,r|j.yt1t2t1t4t7|j.j9 zj:jj=}t1t>|jjA} | jCD]9} | jEstGjH| jK|cSyy)Nc3.K|] }|ywrr)r7rrs rr8zVShapeList.filter_by..plane_parallel_predicate..pred..t s>1tAw>sF)&rrrVr>r!rrirrCrEr;rr7rrsrrjr!rr\rr#rUrrrFrrrninversernXYZr rCurves IsCurve3DrH IsPlanar_sCurve3D)rrrrrrrr plane_xyzt_edgerplane plane_axisrrs rrzCShapeList.filter_by..plane_parallel_predicate..predb su}}k:/!++EMM:Ihj!&,XF-3XN)2)=)=emm)L&E1eQ"5==188ufn17~0F0Q0Q0S-!%elln6O!PJ%11*iHHemm[9> >>>emm[9~~-$ %!%%..)A)I)I)Ke)ST% !I #:u}}/C/C/EFF!' ??,#6#A#A % I$ !rr)rjrmrn)rrrrs``@@rplane_parallel_predicatez5ShapeList.filter_by..plane_parallel_predicate_ s)ellEKK8J# # JKrc&j|Sr)__get__rr!s r predicatez&ShapeList.filter_by..predicate s ((--r)rc"|jk(Sr)rrs rrz&ShapeList.filter_by..predicate s}} 11rz!Unsupported filter_by predicate: c| Srr)rrs ractual_predicatez-ShapeList.filter_by..actual_predicate s$U+++r)r9rjrr)rrrrr) callablerrrjrrrdrrzrA)rr!r rrrrrs ` @rr!zShapeList.filter_by s:" H( V I !I  8 , . 4 (/ YOI  5 )0iPI  8 , 2@ LM M  , )  0$788rc|dk(rtfd|}n?|dk(rtfd|}n(|dk(rtfd|}ntfd|}t|jS)a filter by position Filter and sort objects by the position of their centers along given axis. min and max values can be inclusive or exclusive depending on the inclusive tuple. Args: axis (Axis): axis to sort by minimum (float): minimum value maximum (float): maximum value inclusive (tuple[bool, bool], optional): include min,max values. Defaults to (True, True). Returns: ShapeList: filtered object list TTctj|jjcxkxrkScSrrrrr!r r[r9maximumminimums rrz.ShapeList.filter_by_position.. s<';..q188:<<r)TFctj|jjcxkxrkScSrrrs rrz.ShapeList.filter_by_position.. s<';..q188:<<r)FTctj|jjcxkxrkScSrrrs rrz.ShapeList.filter_by_position.. s<'+--a0779;;rctj|jjcxkxrkScSrrrs rrz.ShapeList.filter_by_position.. s5'E$K$?$?$B$I$I$K$M$MWPWWWr)rArzrY)rr9rr inclusiverbs ``` rfilter_by_positionzShapeList.filter_by_position s,  $ G - ' G - ' GWG !))$//rcttrGj tdjJjj fd}ns tdt dr'tjttfrfd}nttr}tjk(rfd}ntjk(rfd}ntjk(rfd}nitjk(rfd }nPtjk(r=fd }n7trfd }n%tt rfd }ntd t#||S)aigroup by Group objects by provided criteria and then sort the groups according to the criteria. Note that not all group_by criteria apply to all objects. Args: group_by (Callable[[T], K] | Axis | Edge | Wire | SortBy | property, optional): group and sort criteria. Defaults to Axis.Z. reverse (bool, optional): flip order of sort. Defaults to False. tol_digits (int, optional): Tolerance for building the group keys by round(key, tol_digits) Returns: GroupBy[T, K]: sorted groups of ShapeLists zCannot group by an empty axiscxtt|jzjjSr)roundrnr!rr )raxis_as_location tol_digitss rrz!ShapeList.group_by..key_f s2%(>>HHJJrzCannot group by an empty objectrc~j|j\}}tj|Sr)rr!rparam_at_point)rpnt1_pnt2r^rs rrz!ShapeList.group_by..key_f s5&55cjjlC eX44T:JGGrc0t|jSr)rr~rrs rrz!ShapeList.group_by..key_f  Z88rc0t|jSr)rradiusrs rrz!ShapeList.group_by..key_f rrcLt|jjSr)rr!r~rs rrz!ShapeList.group_by..key_f s !4!4jAArc0t|jSr)rrrs rrz!ShapeList.group_by..key_f s :66rc0t|jSr)rvolumers rrz!ShapeList.group_by..key_f rrcP|} t|S#t$r|cYSwxYwr)rrrvalr^rs rrz!ShapeList.group_by..key_f$ s2sm j11 Js  %%cbj|} t|S#t$r|cYSwxYwr)rrrrs rrz!ShapeList.group_by..key_f- s9&&s+ j11 Js ..zUnsupported group_by function: r)rrjrrrrrFrUr\rfLENGTHRADIUSDISTANCEAREAVOLUMErrr)rr^r rrrs ` ` @rr^zShapeList.group_by s;, h %' !@AA$$0 00'0088:   >? ? Xy )j   {K8/  H& )6==(9V]]*9V__,BV[[(7V]]*9h  ( + >xjIJ JudG44rch|j}t|}|dk7rtd||dS)rrxz"Expected exactly one shell, found r)rr?r)rr shell_counts rrzShapeList.shell: ;&k ! A+OP Payrcnt|Dcgc]}|jD]}|c}}Scc}}w)z)shells - all the shells in this ShapeList)rzrrrrs rrzShapeList.shellsB -Fu||~F!!F!FGGFrrch|j}t|}|dk7rtd||dS)rrxz"Expected exactly one solid, found r)rr?r)rr solid_counts rrzShapeList.solidF rrcnt|Dcgc]}|jD]}|c}}Scc}}w)z)solids - all the solids in this ShapeList)rzrrs rrzShapeList.solidsN rrrc trt||}t'|Sttr#t|j|}t'|Stt r[j tdjJjjt|fd|}t'|Ss tdtdrBtj ttfr"dfd t| fd|}t'|Sttr5tjk(rt|d|}t'|Stjk(r6|Dcgc]}t|d s|}}t|d |}t'|Stj k(rt|d |}t'|Stj"k(r6|Dcgc]}t|d s|}}t|d |}t'|Stj$k(rA|Dcgc]}t|ds|}}t|d|}t'|Stdt'Scc}wcc}wcc}w)a^sort by Sort objects by provided criteria. Note that not all sort_by criteria apply to all objects. Args: sort_by (Callable[[T], K] | Axis | Edge | Wire | SortBy | property, optional): sort criteria. Defaults to Axis.Z. reverse (bool, optional): flip order of sort. Defaults to False. Raises: ValueError: Cannot sort by an empty axis ValueError: Cannot sort by an empty object ValueError: Invalid sort_by criteria provided Returns: ShapeList: sorted list of objects rzCannot sort by an empty axiscttt|jzjjSr)rrnr!rr )r[rs rrz#ShapeList.sort_by..x s.e/(188:2FF(11rzCannot sort by an empty objectrcttrJj|j\}}j |S)z:u-value of closest point between object center and sort_by)rrfrr!r)rrrrYs ru_of_closest_centerz.ShapeList.sort_by..u_of_closest_center s>%gv666%44SZZ\B e--d33rc|Srr)r[rs rrz#ShapeList.sort_by.. s $7$:rc|jSrr rs rrz#ShapeList.sort_by.. CJJrrc|jSr)rrs rrz#ShapeList.sort_by.. rrc6|jjSr)r!r~rs rrz#ShapeList.sort_by.. sCJJL$7$7rrc|jSr)rrs rrz#ShapeList.sort_by.. s CHHrrc|jSr)rrs rrz#ShapeList.sort_by.. rrz!Invalid sort_by criteria providedr{)rrYrrrrjrrrrrFrUr\rfrrrrrrz) rrYr rbr with_radius with_area with_volumerrs ` @@rrYzShapeList.sort_byR s0 G Tw@GN!!K *TwHGH!!E && !?@@##/ //&//779  Gz!!m=> > Wi (Z OOk;7.  4:GGR!!K (&--' .#F!!=FMM).2Msgc86LsM M .#8!!/FOO+ 7#,!!#FKK',0ISGC4HSI I ,#!!FMM).2Msgc86LsM M .#!!@A A!!;NJNs$6I=I=,J>J5JJct|Dcgc]}|j||fc}d|}t|Dcgc]}|d c}Scc}wcc}w)a&Sort by distance Sort by minimal distance between objects and other Args: other (Union[Shape,VectorLike]): reference object reverse (bool, optional): flip order of sort. Defaults to False. Returns: ShapeList: Sorted shapes c |dSr2rrs rrz,ShapeList.sort_by_distance.. s CFrrrx)rYr rz)rrr rrs rsort_by_distancezShapeList.sort_by_distance sV6: ;scooe$c * ;" I6S#a&677 <7s A  Ach|j}t|}|dk7rtd||dS)rvrxz#Expected exactly one vertex, found r)r,r?r)rr, vertex_counts rrwzShapeList.vertex s;==?8} 1 B<.QR R{rcnt|Dcgc]}|jD]}|c}}Scc}}w)z-vertices - all the vertices in this ShapeList)rzr,)rrr/s rr,zShapeList.vertices s.Hu~~7GH!!H!HIIHrrch|j}t|}|dk7rtd||dS)rMrxz!Expected exactly one wire, found r)rPr?r)rrP wire_counts rrNzShapeList.wire rurcnt|Dcgc]}|jD]}|c}}Scc}}w)z'wires - all the wires in this ShapeList)rzrP)rrws rrPzShapeList.wires rwrrN)rr)rrr ShapeList[T])rrrra)rrzrr)robjectrr})rrrr)rrVrr)rzSupportsIndex | slicerzT | ShapeList[T])rY Axis | SortByrr)r^rrr)rrzrr})r!zAxis | GeomTyperr)rrzrrrrrrr)Fgh㈵>)r!z8Callable[[T], bool] | Axis | Plane | GeomType | propertyr r}rrrr)r) r9rjrrrrrztuple[bool, bool]rr)r^9Callable[[T], K] | Axis | Edge | Wire | SortBy | propertyr r}rrrz GroupBy[T, K]rrrr)rYrr r}rrr)rrr r}rrrrrr)+rrrrrrrErrMrrrrrjr r[r`rrcrergrrTr!rrrr#r)r,r!rr^rrrrrYrrwr,rNrPrrrrzrzz sQ  Q 1 77 ::+ /3ff%4866*/3ff3  37&&)4866+1.(KGG H9KH9H9 H9  H9^(4 101010 10 % 10  10jOSff ]5K]5]5 ]5  ]5~HH NRVVa"Ja"a"  a"H:?8'8268 8*JGrrzczeZdZdZd dZeed dZeed dZedZ ed dZ d dZ y) JointaPJoint Abstract Base Joint class - used to join two components together Args: parent (Union[Solid, Compound]): object that joint to bound to Attributes: label (str): user assigned label parent (Shape): object joint is bound to connected_to (Joint): joint that is connect to this joint c.||_||_d|_yr)rr connected_to)rrrs rrzJoint.__init__ s  *.rcy)zLocation of jointNrrs rrzJoint.location rrcy)z?A CAD object positioned in global space to illustrate the jointNrrs rsymbolz Joint.symbolrrcy)z4All derived classes must provide a connect_to methodNrrr]kwargss r connect_tozJoint.connect_torrcy)z)Return relative location to another jointNrrs r relative_tozJoint.relative_to rrc Ht|tstdt||jj t d|j|fi|}|jjtt|jj |z||_ y)z)Connect Joint self by repositioning otherzother must of type Joint not NzParent location is not set) rrrrrrrrrbrrnr)rrrrelative_locations r _connect_tozJoint._connect_tos%';DK=IJ J ;;   '9: :,D,,U=f= E(DKK,@,@CT,TUV!rN)rrrzBuildPart | Solid | Compoundr~r)rr) rrrrrrrrrrrrrrrrr su  /  NN CC88 "rrc eZdZdZdZdZdZy)rzRSkip clean context for use in operator driven code where clean=False wouldn't workTcdt_yrrrrs r __enter__zSkipClean.__enter__!s  rcdt_yrr)rexception_typeexception_value tracebacks r__exit__zSkipClean.__exit__$s  rN)rrrrrrr rrrrrs\ E rrct}|D]}|j||jt|j S)z"Sew faces into a shell if possible)r0rrr SewedShape)r, shell_builderr)s rrr(sG)+M $  M,,. //rct|}t|}t}|D]}|j|t}|D]}|j||j||j ||j d|j t|j}t|tr t|d}|S)zGeneric boolean operation for TopoDS_Shapes Args: args: Iterable[TopoDS_Shape]: tools: Iterable[TopoDS_Shape]: operation: BRepAlgoAPI_BooleanOperation | BRepAlgoAPI_Splitter: Returns: TopoDS_Shape T) r@r^rrrr\rrrrrTr)r]r^r_rbrrrQs rrr1s :D KE  C 3 !D C3 t T" OO ioo' (F&/*'5 Mrci}t|tj|}|jr?|j }||t |<|j |jr?t|jS)zOCP.gpr?r@rArBrCrDrErF OCP.GProprGOCP.ShapeAnalysisrHOCP.ShapeCustomrIrJ OCP.ShapeFixrKOCP.ShapeUpgraderLrMrN OCP.TopExprOrP OCP.TopLocrQ OCP.TopoDSrRrSrTrUrVrWrXrYrZr[r\ OCP.TopToolsr]r^r_r`typing_extensionsrarbbuild123d.build_enumsrcrdrerfrgbuild123d.geometryrhrirjrkrlrmrnrorprqrrrsrtrurvbuild123d.build_partrw compositeryone_drzr{three_dr|two_dr}r~zero_drrrrCalcFnrrrrrrrrAr@rzrrrrr%rrrArrr#rr[rrrres,\# #88   !)<$(*B   -6,3=15#2/RRR"1J'9;.&     /NN$.#!" O PUGV+,  . <.4 5Xg./89}&4Iwv}&4@N . ..x. CuUF]+, C'(G)gadmG)Tf "f#fRf GQf GR5"C5"p  0$ $ !$C$ $N  '  ' +%++\*.2&*#6.r