^jUdZddlmZddlZddlZddlZddlZddlZddl Z ddl m Z m Z m Z ddlmZmZmZmZmZddlmZmZmZmZmZmZmZddlZddlmZddl Z ddl!m"Z"m#Z#dd l$m%Z%dd l&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-dd l.m/Z/ddl0m1Z1m2Z2m3Z3m4Z4ddl5m6Z6m7Z7m8Z8ddl9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFddlGmHZHddlImJZJmKZKmLZLddlMmNZNddlOmPZPddlQmRZRmSZSmTZTmUZUmVZVddlWmXZXmYZYmZZZm[Z[m\Z\erddl]m^Z^m_Z_m`Z`maZaede`ZbejdjejejdZfdZgeheieegZjdZkedz Zldez Zmejdz Znenf dId Zoenf dJd!Zpd"ZqGd#d$Zreresetetfzesetetetfze etzZud%evd&< Gd'd(ewZxGd)d*ex+ZyGd,d-ZzGd.d/Z{e|ese|eteizfzeseteizeteizeteizfzeseteizeteizeteizeteizfzeizeseieifze{zeKzZ}d%evd0<Gd1d2ejZGd3d4ZGd5d6ejZGd7d8ZGd9d:eZeZeesetetetfzZd%evd;< Gd<d=eZGd>d?ZGd@dAewZGdBdCe+Zeye{eeerdDZ dK dLdEZGdFdGeZdMdHZy)Na build123d geometry name: geometry.py by: Gumyr date: March 2nd, 2023 desc: This python module contains geometric objects used by the topology.py module to form the build123d direct api. license: Copyright 2023 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)CallableIterableSequence)degreeslog10piprodradians) TYPE_CHECKINGAnyType TypeAliasTypeVarcastoverload) deprecated)Bnd_BoxBnd_OBB) BRep_Tool) BRepBndLib)BRepBuilderAPI_MakeFaceBRepBuilderAPI_Transform) BRepGPropBRepGProp_Face) BRepTools)Geom_BoundedSurfaceGeom_ElementarySurface Geom_Line Geom_Plane) GeomAPI_IntCS GeomAPI_IntSSGeomAPI_ProjectPointOnSurf) gp_Ax1gp_Ax2gp_Ax3gp_Dirgp_EulerSequencegp_GTrsfgp_Lingp_Plngp_Pnt gp_Quaterniongp_Trsfgp_Vecgp_XYZ) GProp_GProps)Quantity_ColorQuantity_ColorRGBAQuantity_TypeOfColor)TopAbs_ShapeEnum)TopLoc_Location)TopoDS TopoDS_Edge TopoDS_Face TopoDS_Shape TopoDS_Vertex)AlignAlign2DAlign3D Extrinsic Intrinsic)EdgeFaceShapeVertex_ShapeT)bound build123dgư>g{Gz?gf@c,tfd|DS)z=Return a rounded tuple key for geometry equality and hashing.c36K|]}t|ywNround).0valuedigitss K/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/geometry.py z_rounded_key..is:%uf%:s)tuple)valuesrQs `rR _rounded_keyrVes :6: ::c|j|j|j|jg}|D]+}t |t kDs|dkr|Dcgc]}| }}nt ||Scc}w)z6Return a rounded quaternion key with a canonical sign.r)XYZWabs TOLERANCErV) quaternionrQ componentsrP components rR_canonical_quaternion_keyrblsy,,.*,,.*,,.*,,.QJ u: !qy:DEYyjE E    F ++Fs A;cd\}}}}}|rt|dtr|d}nt|dtr|d}npt|dtr|d}nWt|dtt frt |d}n/t |ddr|d}ntdt|ddjt|jjgd}|rtd||jd|}|jd |}|jd |}|jd |}|jd |}|||||fS) N)NNNNNrwrappedzUnexpected argument type , )axisplanelocationvectorshapeUnexpected argument(s) rfrgrirhrj) isinstanceAxisPlaneLocationVectorrThasattr ValueErrortypejoinsetkeys differenceget)argskwargsrfrgrirhrj unknown_argss rR_parse_intersect_argsr|ysL+6(D%5 d1gt $7D Q 'GE Q *AwH Q&% 1DG_F T!Wi (GE8d1gHI I99 FKKM%%&VWL2<.ABB ::fd #D JJw &E ZZ& )Fzz*h/H JJw &E % //rWceZdZUdZded<dZedBdZedCdZedDdZedEdZedFd Zed Zd Zd Ze dGd Z e jdHdZ e dGdZ e jdHdZ e dGdZ e jdHdZ e dIdZeddJdZe dGdZdKdZdLdZdMdZdMdZdMdZdMdZdKdZdNdZdNdZdOd ZdNd!ZdPd"ZdPd#ZdPd$ZdLd%Z dQdRd'Z!dSd(Z"dTd)Z#dTd*Z$dUd+Z%dPd,Z&dGd-Z'dVd.Z(dWd/Z)dWd0Z*dWd1Z+dXd2Z,dYd3Z-dZd4Z.dQd[d5Z/dPd6Z0dPd7Z1d\d8Z2d]d9Z3d^d_d:Z4d`d;Z5edad<Z6edbd=Z6edcd>Z6eddd?Z6eded@Z6dAZ6y&)frpaCreate a 3-dimensional vector Args: x (float): x component y (float): y component z (float): z component vec (Vector | Sequence(float) | gp_Vec | gp_Pnt | gp_Dir | gp_XYZ): vector representations Note that if no z value is provided it's assumed to be zero. If no values are provided the returned Vector has the value of 0, 0, 0. Attributes: wrapped (gp_Vec): the OCP vector object r/_wrappedrcyrLselfrYrZr[s rR__init__zVector.__init__ rWcyrLr)rrYrZs rRrzVector.__init__rrWcyrLrrvs rRrzVector.__init__rrWcyrLrrs rRrzVector.__init__rrWcyrLrrs rRrzVector.__init__rrWcyrLrrs rRrzVector.__init__rrWc Rd|_d\}}}}djt|jj gd}|rt d|r[t fdttDr5t}|dgtddtz zz }|dd\}}}n|td k(sd |vrirdnd} |jd | } t| tr%t| jj!}nt#| d rSt| jt$r9t'j(| j} t| j!}nt| t*t,frH | D cgc] } t/| }} t|dkr|dgdt|z zz }t|dd}n\t| tt2t4frt| j!}n't| t6r t| }n t1d |jd|}|jd|}|jd|}| t|||n|}||_ycc} w#t0t f$r} t1d | d} ~ wwxYw)NrrrrNre)rrYrZr[rkc3PK|]}t|ttfywrLrlintfloat)rOirys rRrSz"Vector.__init__..s Ta 47S%L9Ts#&rArrdzExpected floatsz%Expected floats, OCC gp_, or iterablerYrZr[) vector_indexrtrurvrwrrallrangelenlistmaxrxrlrpr/rdXYZrqr;rPnt_srTrr TypeErrorr,r'r0r~) rryrzxyzocp_vecr{rU first_arg geom_pointrPexcs ` rRrzVector.__init__sS(1ayyV[[]!3!>!>?S!TU 6|nEF F CT5TCSTT$ZF sec!a#d)m55 5FQqkGAq! Y!^sf}#'QTI 3 2I)V, !2!2!6!6!89I.:!!=4'__Y->->?  !12Ix'89@8ABueElBFBv;?seq3v;77F &1+.I'?@ 1Iv. + GHH JJsA  JJsA  JJsA %,_&Aq/' #C!:.@#$56C?@s*JJ%JJJ& J!!J&cZt|j|j|jfSrL)iterrYrZr[rs rR__iter__zVector.__iter__s TVVTVVTVV,--rWc6|jjS)z Get x value)rdrYrs rRrYzVector.X||~~rWc:|jj|y)z Set x valueN)rdSetXrrPs rRrYzVector.X % rWc6|jjS)z Get y value)rdrZrs rRrZzVector.YrrWc:|jj|y)z Set y valueN)rdSetYrs rRrZzVector.YrrWc6|jjS)z Get z value)rdr[rs rRr[zVector.Z rrWc:|jj|y)z Set z valueN)rdSetZrs rRr[zVector.ZrrWc|jS)z OCCT objectr~rs rRrdzVector.wrapped}}rWz]to_tuple is deprecated and will be removed in a future version. Use 'tuple(Vector)' instead.cH|j|j|jfS)zReturn tuple equivalentrYrZr[rs rRto_tuplezVector.to_tuples ''rWc6|jjS)z Vector length)rd Magnituders rRlengthz Vector.length$s||%%''rWc^t|jj|jS)zMathematical cross function)rprdCrossedrvecs rRcrossz Vector.cross)s dll**3;;788rWcL|jj|jS)zMathematical dot function)rdDotrs rRdotz Vector.dot-s|| ,,rWc*t|tr0t|jj|j}|St|tr9t|jjt|j}|St d)z!Mathematical subtraction functionz5Only Vectors or tuples can be subtracted from Vectors)rlrprd SubtractedrTrrrrresults rRsubz Vector.sub1st c6 "DLL33CKK@AF  U #DLL33F3K4G4GHIF TU UrWc$|j|S)z#Mathematical subtraction operator -)rrs rR__sub__zVector.__sub__<xx}rWc*t|tr0t|jj|j}|St|tr9t|jjt|j}|St d)zMathematical addition functionz.Only Vectors or tuples can be added to Vectors)rlrprdAddedrTrrrs rRaddz Vector.add@st c6 "DLL..s{{;q!R(II||((i@7JJrWcN|j}||j|||zz zS)zReturns a new vector equal to the projection of this Vector onto the line represented by Vector Args: line (Vector): project to this line Returns: Vector: Returns the projected vector. )rr)rline line_lengths rRproject_to_linezVector.project_to_lines*kk txx~{)BCDDrWcT|jj|jS)z2Minimum unsigned distance between vector and plane)rdDistanceto_pntrrgs rRdistance_to_planezVector.distance_to_planes}}%%dkkm44rWcR||jz j|jS)z+Signed distance from plane to point vector.)originrz_dirrs rRsigned_distance_from_planez!Vector.signed_distance_from_planes u||#((55rWc|j}|j}||||z j||jdzz zz S)zVector is projected onto the plane provided as input. Args: args: Plane object Returns the projected vector. plane: Plane: Returns: )rrrr)rrgbasers rRproject_to_planezVector.project_to_planesC||f$+!2!26!:fmmQ>N NOOOrWc |dzS)z#Flip direction of vector operator -rrrs rR__neg__zVector.__neg__s byrWc|jS)zVector length operator abs())rrs rR__abs__zVector.__abs__s {{rWc$|j|Szintersect vector with other & intersectrothers rR__and__zVector.__and__~~e$$rWcJd d}|r|dnd}|dvrd|vr!t|ddjdd}n |dk(rdnd}||j|}||j|}||j|}d ||d d ||d d ||d d St t |S)z Format VectorcBt|tkDr t||SdS)Nr)r]r^rN)r precisions rR trim_floatz%Vector.__format__..trim_floats*-a&9*<5I& E# ErWrNfg.r (re))rrrrreturnr)rsplitrYrZr[strrT)rspecr last_charrrrrs rR __format__zVector.__format__s F!%DH$  "d{Sb  4R 89 !*c!1Ar 4669-A4669-A4669-Aq$pj1dV0G*Bq$pj: :5;rWc6t|j|dS)zRepresent Vectorz.13g)rs__name__rs rR__repr__zVector.__repr__st*%%&tDk22rWct|dddjd\}}}t|jd|d|d|dS) zDisplay Vectorz.6grArrez: (X=z, Y=z, Z=r!)formatr#rsr))rrrrs rR__str__zVector.__str__sPu%a+11$71at*%%&eA3d1#T!A>>rWcpt|tstS|j|jk(S)zVectors equal operator ==)rlrpNotImplemented_keyrs rR__eq__z Vector.__eq__s)%(! !yy{ejjl**rWc4t|jS)zHash of Vectorhashr0rs rR__hash__zVector.__hash__DIIK  rWcZt|j|j|jfSz,Canonical key used for equality and hashing.)rVrYrZr[rs rRr0z Vector._keys TVVTVVTVV455rWctt|j|t|j|t|j|SrL)rprNrYrZr[)rndigitss rR __round__zVector.__round__s7 $&&' "E$&&'$:E$&&'r_memos rR __deepcopy__zVector.__deepcopy__r@rWcHt|jjS)zConvert to OCCT gp_Pnt object)r,rdrrs rRrz Vector.to_pntdll&&())rWcHt|jjS)zConvert to OCCT gp_Dir object)r'rdrrs rRto_dirz Vector.to_dirrGrWcz|s]|j}|j|jj}t t |j }|S|j}|j|jj}t t |j }|S)a;Apply affine transformation Args: affine_transform (Matrix): affine transformation matrix is_direction (bool, optional): Should self be transformed as a vector or direction? Defaults to False (vector) Returns: Vector: transformed vector )r TransformedrdTrsfrpr/rrI)raffine_transform is_directionpntpnt_t return_valuegp_dirdir_ts rR transformzVector.transforms++-COO$4$<$<$A$A$CDE!&"56L [[]F&&'7'?'?'D'D'FGE!&"56LrWcrt|jj|jt|S)zRotate about axis Rotate about the given Axis by an angle in degrees Args: axis (Axis): Axis of rotation angle (float): angle in degrees Returns: Vector: rotated vector )rprdRotatedr )rrfangles rRrotatez Vector.rotates(dll**4<<HIIrWcy)z&Find intersection of vector and vectorNrrris rRrzVector.intersect*rWcy)z(Find intersection of vector and locationNrrrhs rRrzVector.intersect.r[rWcy)z$Find intersection of vector and axisNrrrfs rRrzVector.intersect2r[rWcy)z%Find intersection of vector and planeNrrs rRrzVector.intersect6r[rWcy)z%Find intersection of vector and shapeNrrrjs rRrzVector.intersect:r[rWct|i|\}}}}}||j|S||j|S|||k(r|S||j|S||j|Sy)z9Find intersection of vector and geometric object or shapeN)r|rrryrzrfrgrirhrjs rRrzVector.intersect>s/Dd/Uf/U,eVXu  >>$' '  ??4( (  $&.M  %%d+ +  ??4( (rWrYrrZrr[r)rYrrZr)rrp)rSequence[float])rz!gp_Vec | gp_Pnt | gp_Dir | gp_XYZr"r)rPrr"None)r"r/)r"tuple[float, float, float])rrpr"rp)rrpr"r)r VectorLiker"rp)rrr"rp)rrr"rpr"rprL)rrpr Vector | Noner"r)rrpr"rp)rgrnr"r)rgrnr"rp)r,Axis | Location | Plane | VectorLike | Shaper"r$robjectr"boolr"r)r"tuple[float, ...])r:z int | None)r"r,)r"r')F)rMMatrixrNrqr"rp)rfrmrWrr"rprirjr"rl)rhror"rl)rfrmr"rl)rgrnr"rlrjrDr"z Shape | None)7r) __module__ __qualname____doc____annotations___dimrrrpropertyrYsetterrZr[rdrrrrrrrrrrrrrrrrrrrrrrrr r rr'r*r-r1r5r0r;r?rErrIrTrXrrrWrRrprps, D             ) V.  XX!!  XX!!  XX!! (( (((9-   6$*$1 9K& E56P"% *3? + !6 ..**0 J5577334444rWrprrjcFeZdZdZeddZeddZeddZy)AxisMetaz*Axis meta class to enable class propertiesc|ddS)zX AxisrrrrArrrclss rRrYz AxisMeta.Xd9i((rWc|ddS)zY AxisrrrArrrs rRrZz AxisMeta.YirrWc|ddS)zZ AxisrrrrArrs rRr[z AxisMeta.ZnrrWNr"rm)r)rwrxryr|rYrZr[rrWrRrras?4 ))))))rWrcReZdZdZdZed-dZed.dZed/dZed0dZed1dZd2dZed Zed3d Z e jd4d Z ed3d Z e jd5d Z ed6dZ d7dZ d7dZd8dZd9dZd9dZd9dZd:dZd;dZd d?dZd@dAdZd@dAdZd@dAdZd@dBdZdCdZd7d Zd7d!Z dDd"Z dEd#Z!dFd$Z"dGd%Z#edFd&Z$edGd'Z$edEd(Z$edHd)Z$edId*Z$d+Z$y,)Jrma#Axis Axis defined by point and direction or by two points Args: origin (VectorLike): start point direction (VectorLike): direction end_point (VectorLike): point used with origin to define direction edge (Edge): origin & direction defined by start of edge location (Location): location to convert to axis Attributes: position (Vector): the global position of the axis origin direction (Vector): the normalized direction vector wrapped (gp_Ax1): the OCP axis object rAcyzAxis: point and directionNr)rgp_ax1s rRrz Axis.__init__r[rWcy)zAxis from locationNrr]s rRrz Axis.__init__r[rWcyrr)rr directions rRrz Axis.__init__r[rWcy)zAxis: point and end pointNr)rr end_points rRrz Axis.__init__r[rWcy)zAxis: start of EdgeNr)redges rRrz Axis.__init__r[rWc |jdd}|jdd}|jdd}|jdd}|jdd}|jdd}|r+tddj|jt |d k(r{|d } t | t r| }nvt | tr| }nct| d rt | jtr| }n:t | ttfr| }n!td | t |d k(r|\}}|$| tdt|t|z }|t|d rt |jtstd||j} tj| tt} tj | \} } t#}t%}| j'| ||t|}tt)|}|)t*j,j/|j}|V t|}t|}t |j1t)t|j3}||_yt |t std|||_y#t4$r}td|d}~wwxYw)NrrrrrrhUnexpected argument(s): rerArrdzUnrecognized single argument: rz,Axis end_point cannot be used with directionzInvalid edge argument: zInvalid Axis parameterszInvalid Axis parameter: )poprrrtrvrrlr$rorqrdr8rprTrCurve_srRange_sr,r/D1r'rmr[locatedrr Exceptionr~)rryrzrrrrrrharg topods_edgecurve param_min_ origin_pnt tangent_vec origin_vectordirection_vectorrs rRrz Axis.__init__sHd+Hd+JJ{D1 JJ{D1 zz&$'::j$/ 7 &++-8P7QRS S t9>q'C#v&C*i(Z [-QC&%1 #A#!GHH Y!^ $ FI  $ !OPPy)F6N:I  D),DLL+1V #:4&!ABB'+||K%%k57EGDE$,,[9LIqJ (K HHY K 8J'Fvk23I  VV^^H-55F > E &v #))#4 !((*E"2"="="?@A!' FF+7x@A A &  E !:;D EsA K K& K!!K&c|jSz OCP objectrrs rRrdz Axis.wrappedrrWcHt|jjS)z"The position or origin of the Axisrprdrors rRpositionz Axis.positiondll++-..rWch|jjt|jy)z&Set the position or origin of the AxisNrd SetLocationrpr)rrs rRrz Axis.positions$   !1!8!8!:;rWcHt|jjS)z$The normalized direction of the Axis)rprd Directionrs rRrzAxis.directionsdll,,.//rWch|jjt|jy)zSet the direction of the AxisN)rd SetDirectionrprI)rrs rRrzAxis.directions$ !!&"3":":"<=rWcVtt|j|jS)zReturn self as Locationrr)rornrrrs rRrhz Axis.locationsT]]$..IJJrWcBt|j|jSr=rmrrrs rRr?z Axis.__copy__DMM4>>22rWcBt|j|jSrBrrCs rRrEzAxis.__deepcopy__rrWc4t|jS)z Hash of Axisr3rs rRr5z Axis.__hash__r6rWc|r|dnd}|dvr%d|j|dd|j|ddSdt|jdt|jdS)z Format AxisrNrrr rer!)rrrTrr%r&s rRr'zAxis.__format__ so $DH$  "t}}dV0G,Bt~~tf@W.EQG G5'(5+@*ACCrWcFt|j|dtdS)zRepresent Axisrrrsr) TOL_DIGITSrs rRr*z Axis.__repr__'t*%%&tAj\?&;<>RST^S__`Q`Baab d rWcpt|tstS|j|jk(SrL)rlrmr/r0rs rRr1z Axis.__eq__s)%&! !yy{ejjl**rWcj|jj|jjfSr8)rr0rrs rRr0z Axis._key$s' ""$dnn&9&9&;<|j|r|S|j|rytjg|j}tjg|j }tjg|j}tjg|j }tj|| tj ||gj}||z }tjj||dd\}} } |||zz} t| S)z0Find intersection of this axis and another axis.N)rcondr) rrnparrayrrrTlinalglstsqrp) rrfp1d1p2d2system_of_equations origin_difft1rintersection_points rR_intersect_axiszAxis._intersect_axiss ??4 K <<  XX& & ' XX'' ( XX& & ' XX'' ( hhRC"b1A'BCEE2g 99??#6 4?PQRSAq"r'\)**rWct|}||jz }|j|j}|j|z|jz}||k(r|SdS)z+Find intersection of this axis and a point.N)rprrr)rri vec_to_pointprojected_length projected_vecs rR_intersect_vectorzAxis._intersect_vectorsX - '++DNN;)99DMMI =0v:d:rWct|j}|j|jy||jk(r|S|jS)z.Find intersection of this axis and a location.N)rnrrrr)rrh location_dirs rR_intersect_locationzAxis._intersect_locationsFX,, >>(++ , 4 4>> )O   rWcy)z$Find intersection of axis and vectorNrrZs rRrzAxis.intersectr[rWcy)z&Find intersection of axis and locationNrr]s rRrzAxis.intersectr[rWcy)z"Find intersection of axis and axisNrr_s rRrzAxis.intersectr[rWcy)z#Find intersection of axis and planeNrrs rRrzAxis.intersectr[rWcy)z#Find intersection of axis and shapeNrrbs rRrzAxis.intersectr[rWct|i|\}}}}}||j|S||j|S||j|S||j |S||j|Sy)z7Find intersection of axis and geometric object or shapeN)r|rrrrrds rRrzAxis.intersects/Dd/Uf/U,eVXu  ''- -  ??4( (  ))&1 1  ++H5 5  ??4( (rWN)rr$r"rhrhror"rh)rrjrrjr"rh)rrjrrjr"rh)rrBr"rhryr rzr r"rhrk)rrjrrjr"rorrrrnror"z+tuple[tuple[float, ...], tuple[float, ...]])rror"rn)h㈵>r )rrmrrrrr"rq)r )rrmrrr"rq)rrmrrr"rq)rrmr"r)rrmr"zVector | Location | Axis | Nonerfrmr"Vector | Axis | Nonerurhror"Vector | Location | None)rgrnr"rrv)%r)rwrxryr{rrr|rdrr}rrhr?rEr5r'r*r-r1r0rrrrrrrrrrr rrrrrrrWrRrmrmts0" D ((!!((((""D'L//__<<00>>KK33!D= + =  &A A$("&   !     . TV V %,N ;3%A% (% +&;!3355112222rWrm) metaclassceZdZdZeddZe d ddZdZeddZeddZdZ dd Z d dd Z e dd Z e d dd Zdd ZefddZddZy)BoundBoxzA BoundingBox for a Shapecy)z'Construct a bounding box from a Bnd_BoxNr)r bounding_boxs rRrzBoundBox.__init__r[rWNcy)z,Construct a bounding box from a TopoDS_ShapeNr)rrjroptimals rRrzBoundBox.__init__r[rWc(|jdd}|jdd}|jdd}|jdd}|rtddj||r|t|dtr|d}nt|dt rz|d}t |d kDr/t|d tr|d }n|d rtd |d t |d kDrGt|d tstd |d |d }ntd dj||rYtj||tn|}t }|rtj||ntj||d|jr d\}}} } } } n|j!\}}} } } } |jrdn||_t%||| |_t%| | | |_t%| |z | |z | | z |_y)NrrjrrTUnexpected keyword arguments: rerrAz-Second parameter must be a float or None not rz#Third parameter must be a bool not Invalid positional arguments: )rrrrrr)rrrtrlrr:rrrqrClean_sTOLr AddOptimal_sAdd_sIsVoidGetrdrpminrsize) rryrzrrjrrx_miny_minz_minx_maxy_maxz_maxs rRrzBoundBox.__init__szz.$7  7D)JJ{D1 **Y- ` `OCCT Color Names `_ Hexadecimal string may be RGB or RGBA format with leading "#" Args: name (str): color, e.g. "blue" or "#0000ff"" alpha (float, optional): 0.0 <= alpha <= 1.0. Defaults to 1.0 Nr)rnamealphas rRrzColor.__init__r[rWcy)a Color from sRGB and Alpha values Args: red (float): 0.0 <= red <= 1.0 green (float): 0.0 <= green <= 1.0 blue (float): 0.0 <= blue <= 1.0 alpha (float, optional): 0.0 <= alpha <= 1.0. Defaults to 1.0 Nr)rredgreenbluerSs rRrzColor.__init__r[rWcy)zColor from a hexadecimal color code with an optional alpha value Args: color_code (hexadecimal int): 0xRRGGBB alpha (hexadecimal int): 0x00 <= alpha as hex <= 0xFF Nr)r color_coderSs rRrzColor.__init__#r[rWcd|_d\}}}}}}||||f} |jdd} | | f}|rt|dtr|dn|}d} |rQt |dk\r| || \}}}}n3|dxt dx\|dj|_yxt dx\|d|_yxtdx\| |||f\}}|j}d|vrtt|dzd } t |d k(r|d d z} |dd }n5t |d k(r |dd } |dd}nt |dvrtd|d | rt| ddz }nHxtdx\| |||f\}}n+tdx\| || \}}}}n td|| l|jd|}|jd|}|jd|}|jd|}|jd|}|jd|}|r||f}n |r||f}n||||f}|x rLd k(rG\}}t|tr4t|ttfrt j|\}}}|}nx rTd k(rO\}}t|tr.fill_defaults..<s(M!SV115Ms"%)rTrr)r]r^s``rR fill_defaultsz%Color.__init__..fill_defaults;sMuSV}MM MrWrr#rr )rcrbrerd"z)" is not a valid hexadecimal color value.zInvald alpha hex string: zUnsupported color definition: rRrYrUrVrWrSrAc3HK|]}t|ttfywrLr)rOcs rRrSz!Color.__init__..s 201 1sEl+2 ")rdrxrlrTrrNr3r$stripr,rrrrr _rgb_from_str _rgb_from_intrr2r4Quantity_TOC_sRGB)rryrzrUrVrWrSrRrY default_rgbrPr_hex_aex color_formatr]hexa the_colors rRrzColor.__init__,s 4T1UD%zE4/ ZZ d3  !=D (a%847dD N 4yA~*7k*J'UD%1g '+Aw !.+-'+Aw .&3D4-&H e#zz|$;$*3us{+;S$AE"4yA~(,Q! '+BQx!$Ta(,Qq '+BQx!$T,!>&0&'v-V$W'"!"*#(,/rNT,AE%.,9$U@S,T) E2?k2R/UD%!'*H(OPP  ::fd+DL*=J**UC(CJJw.E::fd+DJJw.E  %=L &.Le4Ljs3 1ucl8S#(#6#6t#< UDjs3 1ucl8S#(#6#6t#< UD6HE  +*c2695$5N2/+"@ OPP||&UD"6"H"HI.i?DL Y$.*&0&?w$G'"')!**sL;; MMMc|jjjtj\}}}||||jj f}d|DS)Nc34K|]}t|dyw)reNrM)rOrPs rRrSz!Color.__iter__..s7EeQ7)rdGetRGBValuesr4rnAlpha)rrrr^ rgb_tuples rRrzColor.__iter__sR,,%%'../C/U/UV1a1dll0023 7Y77rWc$tt|Sr=rNrTrs rRr?zColor.__copy__eDk""rWc$tt|SrBr~rCs rRrEzColor.__deepcopy__rrWc |jjjtj} t j |Dcgc]}t|dzc}}d}t|jdtt|d|d|j!Scc}w#t$rB|jjj}tj|}d}YwxYw)zGenerate stringraisnearz:  )rdrxryr4rn webcolors rgb_to_namerNrrNamer2 StringName_srsr)r$rTupper)rrgbrirR qualifierquantity_color_enums rRr-z Color.__str__sll!!#**+?+Q+QR ((#)FQ%C.)FGDI t*%%&bU4[)9(:!I;a GWXX*G "&,,"5"5"7"<"<"> !../BCDI  s$B/ B*! B/*B//AC:9C:cXt|jtt|S)zRepresent Color)rsr)r$rTrs rRr*zColor.__repr__s&t*%%&s5;'7&899rWc nt|tr"d|cxkrdksotdtdt|tr=|dkr tdt t |dd}t j|d}n tdt|ttfrt|g|z}n$t|}t||k7r td tj||dz|d }t||Dcgc]'\}}|gt j|dzd d |)} }}| Scc}}w)u0Generate a palette of evenly spaced colors. Creates a list of visually distinct colors suitable for representing discrete categories (such as different parts, assemblies, or data series). Colors are evenly spaced around the hue circle and share consistent lightness and saturation levels, resulting in balanced perceptual contrast across all hues. Produces palettes similar in appearance to the **Tableau 10** and **D3 Category10** color sets—both widely recognized standards in data visualization for their clarity and accessibility. These values have been empirically chosen to maintain consistent perceived brightness across hues while avoiding overly vivid or dark colors. Args: color_count (int): Number of colors to generate. starting_hue (ColorLike | float): Either a Color-like object or a hue value in the range [0.0, 1.0] that defines the starting color. alpha (float | Iterable[float]): Alpha value(s) for the colors. Can be a single float or an iterable of length `color_count`. Returns: list[Color]: List of generated colors. Raises: ValueError: If starting_hue is out of range or alpha length mismatch. rru+Starting hue must be within range 0.0–1.0rz+Starting color integer must be non-negativeNrzAStarting hue must be a float in [0,1] or an integer color literalz-Number of alpha values must match color_countF)endpointg?g?)rlrrrrrTrNcolorsys rgb_to_hlsrrrrlinspacezip hls_to_rgb) r color_count starting_huerSralphashueshr]colorss rRcategorical_setzColor.categorical_setsGH lE *,-#- !NOO. !NOO  c *a !NOOl+,Ra0C#..4Q7LS  eeS\ *El^k1F%[F6{k) !PQQ{{ ,,kE  D&) 1  <$$QWdC8 .s5QW5s) r name_to_rgbrrr2ColorFromName_sRedGreenBlue hex_to_rgbrT)rRrrcolorexistss rRrlzColor._rgb_from_strs d? B#//5 **40G5eGn555 B&('77eD$("VW U[[]EJJLAA BsA B?AB:4B?:B?N)rP ColorLike)r)rRr$rSr)rUrrVrrWrrSr)ra)rYrrSr)r"rNrn)rr)rrrzColorLike | floatrSzfloat | Iterable[float]r"z list[Color])rrr"ri)rRr$r"rT)r)rwrxryrrrr?rEr-r*rLrrKrmrlrrWrRrNrNs          `@D8 ## Y:+.), AA(A' A  AAF22 66rWrNrc2eZdZdZfdZedZxZS) GeomEncodera A JSON encoder for build123d geometry objects. This class extends ``json.JSONEncoder`` to provide custom serialization for geometry objects such as Axis, Color, Location, Plane, and Vector. It converts each geometry object into a dictionary containing exactly one key that identifies the geometry type (e.g. ``"Axis"``, ``"Vector"``, etc.), paired with a tuple or list that represents the underlying data. Any other object types are handled by the standard encoder. The inverse decoding is performed by the ``geometry_hook`` static method, which expects the dictionary to have precisely one key from the known geometry types. It then uses a class registry (``CLASS_REGISTRY``) to look up and instantiate the appropriate class with the provided values. **Usage Example**:: import json # Suppose we have some geometry objects: axis = Axis(position=(0, 0, 0), direction=(1, 0, 0)) vector = Vector(0.0, 1.0, 2.0) data = { "my_axis": axis, "my_vector": vector } # Encode them to JSON: encoded_data = json.dumps(data, cls=GeomEncoder, indent=4) # Decode them back: decoded_data = json.loads(encoded_data, object_hook=GeomEncoder.geometry_hook) c t|tr,dt|jt|jfiSt|t r dt|iSt|t r)t|}dt|dt|dfiSt|tr@dt|jt|jt|jfiSt|tr dt|iSt|5|S)zEReturn a JSON-serializable representation of a known geometry object.rmrNrorrArnrp)rlrmrTrrrNrornrx_dirrrpsuperdefault)rotup __class__s rRrzGeomEncoder.default=s a U1::.akk0BCD D a U1X& & a "(Cs1vc!f >? ? a eAHHouQWW~uQWW~NO O a eAh' 'wq!!rWct|jdk7rtd||jD]\}}t||cSy)z=Convert dictionaries back into geometry objects for decoding.rAzInvalid geometry json object N)ritemsrrCLASS_REGISTRY) json_dictkeyrPs rR geometry_hookzGeomEncoder.geometry_hookMsU y !Q &ejej@ejejBejejDejejFej ejHej$ejJej(ejLej,ejNej0ejPej4ejRej8ejTiZ+e,d3dZ-e,d4dZ-e,d5d6dZ-e, d7 d8dZ-e, d9dZ-e,d:dZ-e,d;d Z-e,dd Z-d?d Z-e.d@dZ/e.dAdZ0e0jbdBdZ0e.dAdZ2e2jbdCdZ2e.dDdZ3e.dDdZ4e.dDdZ5dEdZ6dEdZ7dEdZ8e,dFdZ9e,dGdZ9e,dHdZ9 dIdZ9dJdZ:dKdZ;dLdZdEd"Z? dNd#Z@dAd$ZAdOd%ZBeCd&dDd'ZDeCd(dPd)ZEdQd*ZFdQd+ZGdQd,ZHe,dRd-ZIe,dSd.ZIe,dTd/ZIe,dUd0ZIe,dVd1ZId2ZIy)Wroa^Location in 3D space. Depending on usage can be absolute or relative. This class wraps the TopLoc_Location class from OCCT. It can be used to move Shape objects in both relative and absolute manner. It is the preferred type to locate objects in build123d. Attributes: wrapped (TopLoc_Location): the OCP location object cy)z(Location with no position or orientationNrrs rRrzLocation.__init__}r[rWcy)zLocation from LocationNrr]s rRrzLocation.__init__r[rWcy)zCLocation from position and rotation around z-axis by optional angleNr)rrrWs rRrzLocation.__init__r[rWNcy)zDLocation from position and optional orientation (see Rotation class)Nr)rr orientations rRrzLocation.__init__r[rWcy)zLocation from position and optional orientation (see Rotation class). Orientation determined by optional ordering, defaults to Intrinsic.XYZ Nr)rrrorderings rRrzLocation.__init__r[rWcy)z Location from location of Plane.Nrrs rRrzLocation.__init__r[rWcy)z:Location from location of Plane translated by plane_offsetNr)rrg plane_offsets rRrzLocation.__init__r[rWcy)z.Location from low-level TopLoc_Location objectNr)rtop_locs rRrzLocation.__init__r[rWcy)z&Location from low-level gp_Trsf objectNr)rgp_trsfs rRrzLocation.__init__r[rWcy)z=Location from position and rotation around direction by angleNr)rrrrWs rRrzLocation.__init__r[rWcld|_|jdd}|jdd}|jdd}|jdd}|jdd}|jdd}|jdd} |jd d} |jd d} |rtd d j||r|t |dt r|d}ng| t |dt tfr|d} nE| t |dtr|d} n)| t |dtr|d} n t |dttfrt|d}t|d kDrFt |d ttfrt|d }nt |d ttfr|d }t|dkDrt |d ttfr-t |dttfrt|d }|d}n>t |dtt fr|d}ntd|dtd|t} t |t rwt#|j$j'|j(j+|j,j+} | j/| | j1nt | tr| } n|Yt3t5ddd|rt|j+n t7ddd }| j9|t;|nr|p|Dcgc] }t;|}}|j<j?|t@jB}tE}|jF|g|| j9||r$| jIt|jJt | t r| jJ|_&yt | tr| |_&yt| |_&ycc}w)NrrrrrrWrgrhrrrrerArz-Third parameter must be a float or order not r)'location_indexrrrtrlrnroRotationr6r.rprrrrr@r?r&rrrrIrSetTransformationInvertr$r,r' SetRotationr _rot_order_dictrxr(gp_Intrinsic_XYZr-SetEulerAnglesSetTranslationPartrdr~)rryrzrrrrrWrgrhrrtrsfcsrfr]angles rot_orderquats rRrzLocation.__init__s ::j$/jj5 JJ{D1 ::j$/ 7D) 7D)::j$/**Y-**Y- &,T!Wo #DGc5\: $Qt9q=!$q'FH+=>:Q#uD%+47O $Q#DGi-CD#'7'KDQRG9U "@ GHHy eU # ##% ""$ ""$B  " "2 & KKM  )D  q!Q.7y!((*VAq!_D   T75> 2  $*56Qgaj6F6,,00*;;I!?D D   3F 3   T "   # #F8$4$<$< = h )$,,DM  1#DM+D1DM#7sP1c|jSrrrs rRrdzLocation.wrapped rrWc0tt|dS)zjExtract Position component of self Returns: Vector: Position part of Location rrprTrs rRrzLocation.positioneDk!n%%rWct}|jt|jt}|j |jj j t||z|_y)zpSet the position component of this Location Args: value (VectorLike): New position N) r.rrprdrr GetRotationr6r~)rrP trsf_positiontrsf_orientations rRrzLocation.positionsa (()>)>?"9$$T\\%@%@%B%N%N%PQ' 8H(HI rWc0tt|dS)zyExtract orientation/rotation component of self Returns: Vector: orientation part of Location rArrs rRrzLocation.orientation)rrWctj}|jjj }t }|j t|j|j|j|Dcgc] }t|}}t}|j|j|g|t }|j|t!||z|_ycc}w)zSet the orientation component of this Location Args: rotation (VectorLike): Intrinsic XYZ angles in degrees N)r@rrdrTranslationPartr.rr/rYrZr[r r-rrrr6r~)rrotationr position_xyzrr]r_rs rRrzLocation.orientation3s==||224DDF  (( <>>#\^^%5|~~7G H )111GAJ11"_ ! !!$"6"6x"@L8L"9$$Z0' 8H(HI 2s C:cXt|}t|j|jS)z#Default X axis when used as a plane)rnrmrrrs rRx_axiszLocation.x_axisI"d ELL%++..rWcXt|}t|j|jS)z#Default Y axis when used as a plane)rnrmry_dirrs rRy_axiszLocation.y_axisOrrWcXt|}t|j|jS)z#Default Z axis when used as a plane)rnrmrrrs rRz_axiszLocation.z_axisUrrWcHt|jjS)zInverted location)rordInvertedrs rRinversezLocation.inverse[s --/00rWcHt|jjS)zLib/copy.py shallow copyrordrrs rRr?zLocation.__copy___ 33566rWcHt|jjS)zLib/copy.py deep copyrrCs rRrEzLocation.__deepcopy__crrWcyrLrrs rRrzLocation.__mul__g25rWcyrLrrs rRrzLocation.__mul__js47rWcyrLrrs rRrzLocation.__mul__msDGrWcBt|tr"t|j|jzS t|}t d|Dr0|Dcgc]$}t|j|jz&c}S t Scc}w#t $rYt SwxYw)zCombine locationsc3<K|]}t|tywrL)rlro)rOrs rRrSz#Location.__mul__..zs;q:a*;s)rlrordrrrr/)rrotherslocs rRrzLocation.__mul__ps eX &DLL5==89 9 %[F;F;;HNO !;<OO<P   s#!B )B>B B BBcJt|jj|SrL)rordPowered)rexponents rR__pow__zLocation.__pow__s ,,X677rWcpt|tstS|j|jk(S)zCompare Locations)rlror/r0rs rRr1zLocation.__eq__s)%*! !yy{ejjl**rWc4t|jS)zHash of Locationr3rs rRr5zLocation.__hash__r6rWc|jjj}|jj t |fSr8)rdrrrr0rb)rr_s rRr0z Location._keys;\\002>>@  ""$&? &KLLrWc|jj}|j}|j}t |}t t t |jtj}t||fSrL) rdrrrrpmaprGetEulerAnglesr(rrrtransformationtransrotrv_transrv_rots rRrzLocation.__iter__sq446..0((*!%= ++,<,M,MN O Xv&''rWc,tt| S)z=Flip the orientation without changing the position operator -)rornrs rRr zLocation.__neg__st %%rWc$|j|S)zintersect axis with other &rrs rRrzLocation.__and__rrWc|jS)z2Return center of the location - useful for sorting)rrs rRrzLocation.centers }}rWc@dd}|j|jz }|j|j}|jd|z|jzz }t |}||j |}||j|}t t |||S)u Return a new Location mirrored across the given plane. This method reflects both the position and orientation of the current Location across the specified mirror_plane using affine vector mathematics. Due to the mathematical properties of reflection: - The true mirror of a right-handed coordinate system is a *left-handed* one. However, `build123d` requires all coordinate systems to be right-handed. Therefore, this implementation: - Reflects the X and Z directions across the mirror plane - Recomputes the Y direction as: `Y = X × Z` This ensures the resulting Location maintains a valid right-handed frame, while remaining as close as possible to the geometric mirror. Args: mirror_plane (Plane): The plane to mirror across. Returns: Location: A new mirrored Location that preserves right-handedness. c^|d|j|jz|jzz S)Nr)rr)rplns rR mirror_dirz#Location.mirror..mirror_dirs(qAEE#)),- 99 9rWrrrr)rrprrnr"rp)rrrrrnrro) r mirror_planerrdistancepos loc_planemx_dirmz_dirs rRmirrorzLocation.mirrors2 :==<#6#66<< 2 23mma(l\-?-???$K IOO\:IOO\:SfEFFrWz]to_axis is deprecated and will be removed in a future version. Use 'Axis(Location)' instead.c@tjj|S)z!Convert the location into an Axis)rmr[rrs rRto_axiszLocation.to_axiss vv~~d##rWz_to_tuple is deprecated and will be removed in a future version. Use 'tuple(Location)' instead.c:|jj}|j}|j}|j |j |j f}td|jtjD}||fS)z6Convert the location to a translation, rotation tuple.c32K|]}t|ywrL)r)rOr]s rRrSz$Location.to_tuple..s3 GAJ3 s) rdrrrrYrZr[rTr r(rr s rRrzLocation.to_tuples 446..0((*05 5779eggi/P-23 # 2 23C3T3T U3 . rWc|r|dnd}|dvr%d|j|dd|j|ddSdt|jdt|jdS)zFormat LocationrNrrr rer!)rrrTrs rRr'zLocation.__format__ss $DH$  "t}}dV0G,Bt/?/?`w.GqI I5'(51A1A+B*C1EErWcFt|j|dtdS)zRepresent Locationrrrrs rRr*zLocation.__repr__rrWct|jd|jdtdd|jdtddS)zDisplay Locationrrrz, orientation=r!)rsr)rrrrs rRr-zLocation.__str__sTDz""#$q Ao67++Aj\?;1 > rWcy)z(Find intersection of location and vectorNrrZs rRrzLocation.intersectr[rWcy)z*Find intersection of location and locationNrr]s rRrzLocation.intersectr[rWcy)z&Find intersection of location and axisNrr_s rRrzLocation.intersectr[rWcy)z'Find intersection of location and planeNrrs rRrzLocation.intersect r[rWcy)z'Find intersection of location and shapeNrrbs rRrzLocation.intersectr[rWc$t|i|\}}}}}||j|S||j|S||j|k(r|SdS|.||k(r|S|j|jk(r |jSdS||j|SdS)z;Find intersection of location and geometric object or shapeN)r|rrrds rRrzLocation.intersects/Dd/Uf/U,eVXu  >>$' '  ??4( (  !]]f46 >$ >  8# '+mmx7H7H&HT]] OS  ).(9ut$CtCrW)r"rhr)r)rrjrWrr"rhrL)rrjrzRotationLike | Noner"rh)rrjr RotationLikerExtrinsic | Intrinsicr"rh)rgrnr"rh)rgrnrrjr"rh)rr6r"rh)rr.r"rh)rrjrrjrWrr"rhr)r"r6rkrPrj)rrjrr rrFr"rF)rror"ro)rzIterable[Location]r"list[Location])rzLocation | Iterable[Location]r"Location | list[Location])rrr"rororrr )rrmr"r)rrnr"ro)r"z=tuple[tuple[float, float, float], tuple[float, float, float]]rnrur)rfrmr"r)rgrnr"rrv)Jr)rwrxryr@rr(rXZYgp_Intrinsic_XZYYZXgp_Intrinsic_YZXYXZgp_Intrinsic_YXZZXYgp_Intrinsic_ZXYZYXgp_Intrinsic_ZYXXYXgp_Intrinsic_XYXXZXgp_Intrinsic_XZXYZYgp_Intrinsic_YZYYXYgp_Intrinsic_YXYZXZgp_Intrinsic_ZXZZYZgp_Intrinsic_ZYZr?gp_Extrinsic_XYZgp_Extrinsic_XZYgp_Extrinsic_YZXgp_Extrinsic_YXZgp_Extrinsic_ZXYgp_Extrinsic_ZYXgp_Extrinsic_XYXgp_Extrinsic_XZXgp_Extrinsic_YZYgp_Extrinsic_YXYgp_Extrinsic_ZXZgp_Extrinsic_ZYZrrrr|rdrr}rrrrrr?rErrr1r5r0rr rrrrr rr'r*r-rrrWrRroroVs;  '88 '88  '88  '88   '88   '88   '88  '88  '88  '88  '88  '88  '88  '88  '88  '88!"  '88#$  '88 '88 '88 '88 '88 '88 '881O677%%RRGKS"S1DS SS   " (     //II==55L"L/9LBGL LL [2z&&__ J J&&JJ*// // // 17755 77 GG2 " 8+ !M (&%A% !% &GP )$ $ *    F= 7799556666DrWroc*eZdZdZddZeddZy)LocationEncoderaCustom JSON Encoder for Location values Example: .. code:: data_dict = { "part1": { "joint_one": Location((1, 2, 3), (4, 5, 6)), "joint_two": Location((7, 8, 9), (10, 11, 12)), }, "part2": { "joint_one": Location((13, 14, 15), (16, 17, 18)), "joint_two": Location((19, 20, 21), (22, 23, 24)), }, } json_object = json.dumps(data_dict, indent=4, cls=LocationEncoder) with open("sample.json", "w") as outfile: outfile.write(json_object) with open("sample.json", "r") as infile: copy_data_dict = json.load(infile, object_hook=LocationEncoder.location_hook) ctjdtdt|ts t dd|j iS)zReturn a serializable objectUse GeomEncoder insteadr stacklevelz Only applies to Location objectsro)warningswarnDeprecationWarningrlrorr)rrs rRrzLocationEncoder.defaultCs< /1CPQR!X&>? ?AJJL))rWc tjdtdd|vr2t|dDcgc]}|Dcgc] }t |c}c}}}|Scc}wcc}}w)zConvert Locations loaded from json to Location objects Example: read_json = json.load(infile, object_hook=LocationEncoder.location_hook) rWrrXro)rZr[r\ror)r7rrs rR location_hookzLocationEncoder.location_hookJsT  /1CPQR  C OLq21eAh2LMC 3Ls A A A A N)rror"dict)r"r_)r)rwrxryrrKr^rrWrRrUrU*s 0*  rWrUceZdZdZddZedZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zdd Zdd ZddZddZy)OrientedBoundBoxa} An Oriented Bounding Box This class computes the oriented bounding box for a given build123d shape. It exposes properties such as the center, principal axis directions, the extents along these axes, and the full diagonal length of the box. Note: The axes of the oriented bounding box are arbitrary and may not be consistent across platforms or time. c*t|tr |}||_ yt|drMt|jtr3t}t j |j|d||_ ytdt|j)a5 Create an oriented bounding box from either a precomputed Bnd_OBB or a build123d Shape (which wraps a TopoDS_Shape). Args: shape (Bnd_OBB | Shape): Either a precomputed Bnd_OBB or a build123d shape from which to compute the oriented bounding box. rdTzExpected Bnd_OBB or Shape, got N) rlrrqrdr:rAddOBB_srrsr)r~)rrjobbs rRrzOrientedBoundBox.__init__cs{ eW %C UI &:emm\+R)C    sD 9 =d5k>R>R=STU UrWc|jSrrrs rRrdzOrientedBoundBox.wrappedvrrWc ddgddgddggdgdgdttjdddd }|jd z}||jt k|j t k|jt kf}|Dcgc]:\}}}t||jz||j z||jz<}}}}|Dcgc]}|jj|} }| Scc}}}wcc}w) a Compute and return the unique corner points of the oriented bounding box in the coordinate system defined by the OBB's plane. For degenerate shapes (e.g. a line or a planar face), only the unique points are returned. For 2D shapes the corners are returned in an order that allows a polygon to be directly created from them. Returns: list[Vector]: The unique corner points. rArArArArArrArrArrArA)rgrh)rArrri)rgrh)rrArrj)rgri)rrrArj)rrA))TTF)TFT)FTT)TFF)FTF)FFT)FFFr-) r itertoolsproductr#rYr^rZr[rprgfrom_local_coords) rordershsordersxsysz local_cornersricornerss rRruzOrientedBoundBox.corners{s"#,Z!8"+Z!8"+Z!8"R"R"R#' (9(9'7G(T#U  YY_y("$$*:BDD9(2$ rWraczeZdZdZe ddZedddejf ddZfdZxZS)ra[Subclass of Location used only for object rotation Attributes: X (float): rotation in degrees about X axis Y (float): rotation in degrees about Y axis Z (float): rotation in degrees about Z axis optionally specify rotation ordering with Intrinsic or Extrinsic enums, defaults to Intrinsic.XYZ cyz}Subclass of Location used only for object rotation ordering is for order of rotations in Intrinsic or Extrinsic enumsNr)rrrs rRrzRotation.__init__6 r[rWrcyrr)rrYrZr[rs rRrzRotation.__init__? r[rWctd|Ds tdgdgg}}}|rttd|}ttd|}ttd|}|rt|}|rt |d}t |dkr!|j d gdt |z zttd |}ttd |}|jd |d|jd |d|jd|d|jd|r|dntj|rt|-|dyt|-d|d |d |df|dy)Nc3$K|]}|dv yw))rYrZr[rrNr)rOrs rRrSz$Rotation.__init__..K sTc3AATszInvalid key for Rotationrc.t|ttfSrLritems rRz#Rotation.__init__..O sjU|.LrWc"t|tSrL)rlrprs rRrz#Rotation.__init__..P s z$/GrWc"t|tSrL)rlrTrs rRrz#Rotation.__init__..Q s ju.ErWrrrc"t|tSrL)rlrrs rRrz#Rotation.__init__..X s D(1KrWc.t|ttfSrL)rlr?r@rs rRrz#Rotation.__init__..Z sJti5K$LrWrYrZrAr[rr) rrrfilterrTrextend setdefaultr@rrr) rryrzr rotations orderingsvectorstuplesrs rRrzRotation.__init__J sgTVTT67 7'0"b9  &!LdSTF6"GNOG&!EtLMFvwqz*6{Q seq3v;78V$KTRSILdSI #vay)#vay)#vay)*iilY]]S  G Yq\ * G F3KfSkBF:DV rW)rr,rz&Extrinsic | Intrinsic == Intrinsic.XYZ)rYrrZrr[rrr-) r)rwrxryrrr@rrrs@rRrr* s NN9NN*3-- N N N  N ( NNrWrr,cZeZdZdZeddZeddZedd dZfdZxZS) Posz%A position only sub-class of Locationcy)zPosition by VectorLikeNrrs rRrz Pos.__init__v r[rWcy)zPosition by VertexNrrs rRrz Pos.__init__z r[rWcy)zPosition by X, Y, ZNrrs rRrz Pos.__init__~ r[rWcd\}}}}|rQtd|Drt|\}}}n/t|dk(rt|d\}}}ntd||j d|}|j d|}|j d|}|j d t|||}|r+t d d j |j||\}}}t|%t|||y) Nrc3HK|]}t|ttfywrL)rlrr)rOrs rRrSzPos.__init__.. s=1:a%.=rjrArzInvalid inputs to Pos rYrZr[rrre) rrprrrrrrtrvrr)rryrzrrrrrs rRrz Pos.__init__ s" 1a === ,1aTa a/1a"8 ?@@ JJsA  JJsA  JJsA  JJsF1aO , 7 &++-8P7QRS S =GAq! 1a)rW)rrj)rrrre)r)rwrxryrrrrs@rRrrs sJ/ %%!!""**rWrceZdZdZedZeddZeddZdZddZddZeddZedd Zd Zdd Z dd Z dd Z ddZ ddZ y)rtaA 3d , 4x4 transformation matrix. Used to move geometry in space. The provided "matrix" parameter may be None, a gp_GTrsf, or a nested list of values. If given a nested list, it is expected to be of the form: [[m11, m12, m13, m14], [m21, m22, m23, m24], [m31, m32, m33, m34]] A fourth row may be given, but it is expected to be: [0.0, 0.0, 0.0, 1.0] since this is a transform matrix. Attributes: wrapped (gp_GTrsf): the OCP transformation function cyrLrrs rRrzMatrix.__init__ rrWcyrLr)rrs rRrzMatrix.__init__ rrWcyrLr)rmatrixs rRrzMatrix.__init__ rrWcJd}t}|ret|dtr|d}nLt|dtrt|d}n*t|dtr|d}nt |dd|j d|}|j d|}|r+t ddj|j|td|Dxr t|dv}|st d t|t|d k(r+t|d d k7rt d t|d t|dd D]R\}} t| D]?\} } t| ttfs t d|j!|dz| dz| AT||_y)Nrz is of an unexpected typerrrrec3\K|]$}t|txrt|dk(&yw)rcN)rlrr)rOrows rRrSz"Matrix.__init__.. s,DGC*>CA >s*,)rrcz./ s"'W,=add,C(D'WsrczMatrix([z]))rrtr)r matrix_strrs @rRr*zMatrix.__repr__* s>!002"'''WeTUh'WW *R((rWN)rzgp_GTrsf | gp_Trsf)rzSequence[Sequence[float]])rfrmrWr)r"rt)rrpr"rp)rrtr"rt)r"rf)rztuple[int, int]r"rrn)r)rwrxryrrrXrrrr?rErr*rrWrRrtrt s(      -^4 /    >@++$)rWrtceZdZdZeddZeddZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zedd Zedd ZeddZy) PlaneMetaz+Plane meta class to enable class propertiesctdddS)zXY Planerrrrnrs rRXYz PlaneMeta.XY6 Y 955rWctdddS)zYZ Planerrrrrs rRYZz PlaneMeta.YZ; rrWctdddS)zZX Planerrrrrs rRZXz PlaneMeta.ZX@ rrWctdddS)zXZ Planerrrrrrrs rRXZz PlaneMeta.XZE Y :66rWctdddS)zYX Planerrrrrrrs rRYXz PlaneMeta.YXJ rrWctdddS)zZY Planerrrrrrrs rRZYz PlaneMeta.ZYO rrWctdddS)z Front Planerrrrrs rRfrontzPlaneMeta.frontT rrWctdddS)z Back Planerrrrrs rRbackzPlaneMeta.backY sY I66rWctdddS)z Left Planerrrrrs rRleftzPlaneMeta.left^ sY J77rWctdddS)z Right Planerrrrrs rRrightzPlaneMeta.rightc rrWctdddS)z Top Planerrrrrs rRtopz PlaneMeta.toph rrWctdddS)z Bottom Planerrrrrs rRbottomzPlaneMeta.bottomm rrWctdddS)zIsometric Planer);f?rr)3Ey?g3Eyrrrs rR isometriczPlaneMeta.isometricr s  ' 1  rWNr )r)rwrxryr|rrrrrrrrrrrrrrrWrRrr3 s5 666666777777777788666677  rWrceZdZdZed@dZe dAdZedBdZedCdZe dD dEdZe dFdZedGdHd ZedId ZedGdJd ZdKd Ze dLd Z edMdZ dNdZ dOdZ dOdZdPdZdQdZdRdZdOdZedSdZedTdZedUdZ dVdZedWdZedXdZ dYdZdZdZd[dZd[dZd[d ZdOd!Ze d\d"Zej6d]d#Ze d\d$Ze d\d%Zej6d^d&Ze d\d'Zej6d^d(Zd_d)Z d` dad*Z dbd+Z!dbd,Z"e d-Z#e d.Z$e dcd/Z%ddd0Z&ded1Z' df dgd2Z(dhd3Z)did4Z*djd5Z+e,fdkd6Z-dld7Z.dmd8Z/dnd9Z0edod:Z1ednd;Z1edpd<Z1edmd=Z1edqd>Z1d?Z1y)rrna Plane A plane is positioned in space with a coordinate system such that the plane is defined by the origin, x_dir (X direction), y_dir (Y direction), and z_dir (Z direction) of this coordinate system, which is the "local coordinate system" of the plane. The z_dir is a vector normal to the plane. The coordinate system is right-handed. A plane allows the use of local 2D coordinates, which are later converted to global, 3d coordinates when the operations are complete. Planes can be created from faces as workplanes for feature creation on objects. ========= ====== ======== ======== Name x_dir y_dir z_dir ========= ====== ======== ======== XY +x +y +z YZ +y +z +x ZX +z +x +y XZ +x +z -y YX +y +x -z ZY +z +y -x front +x +z -y back -x +z +y left -y +z -x right +y +z +x top +x +y +z bottom +x -y -z isometric +x+y -x+y+z +x+y-z ========= ====== ======== ======== Args: gp_pln (gp_Pln): an OCCT plane object origin (tuple[float, float, float] | Vector): the origin in global coordinates x_dir (tuple[float, float, float] | Vector | None): an optional vector representing the X Direction. Defaults to None. y_dir (tuple[float, float, float] | Vector | None): optional Y direction. Mutually exclusive with z_dir. Requires x_dir. z_dir (tuple[float, float, float] | Vector | None): the normal direction for the plane. Defaults to (0, 0, 1). Attributes: origin (Vector): global position of local (0,0,0) point x_dir (Vector): x direction y_dir (Vector): y direction z_dir (Vector): z direction forward_transform (Matrix): forward location transformation matrix reverse_transform (Matrix): reverse location transformation matrix wrapped (gp_Pln): the OCP plane object Raises: ValueError: z_dir must be non null ValueError: y_dir must be non null ValueError: x_dir must be non null ValueError: the specified x_dir is not orthogonal to the provided normal ValueError: x_dir and y_dir must not be parallel ValueError: the specified x_dir is not orthogonal to the provided normal Returns: Plane: A plane ct}t}t|tj|}|j \}}t |j||||t|S)z.Find the normal at the center of a TopoDS_Face) r,r/r#r Surface_sLowerDistanceParametersrNormalrp)facegp_pntr projectoru_valv_vals rRget_topods_face_normalzPlane.get_topods_face_normal s^.vy7J7J47PQ  88: ut##E5&&Af~rWcZt|}td|Dr t|dfSt|dk7r t d |Dcgc] }t|}}|d|dz }|j |d|dz }|d||ffScc}w#t $r}t d|d}~wwxYw)z@Parse a single positional argument as an origin or three points.c3HK|]}t|ttfywrLr)rO coordinates rRrSz7Plane._single_arg_as_origin_and_dirs.. sT z*sEl3TrjNrz Expected three VectorLike pointsrArr)rrrprrrr)arg0 arg0_sequencerpointsrrrs rR_single_arg_as_origin_and_dirsz$Plane._single_arg_as_origin_and_dirs s T TmT T-($. . }  ">? ? I1>?fUm?F?q F1I% F1Iq 12ay5%.(( @ I>?S H Is*B B B B B* B%%B*cy)z!Return a plane from a OCCT gp_plnNr)rgp_plns rRrzPlane.__init__ r[rWcy)z&Return a plane defined by three pointsNr)rrs rRrzPlane.__init__ r[rWNcy)z1Return a new plane at origin with x_dir and z_dirNr)rrrrs rRrzPlane.__init__ r[rWcy)z1Return a new plane at origin with x_dir and y_dirNr)rrrrs rRrzPlane.__init__ r[rWcy)zoReturn a plane extending the face. Note: for non planar face this will return the underlying work planeNr)rrrs rRrzPlane.__init__ r[rWcy)z,Return a plane aligned with a given locationNrr]s rRrzPlane.__init__ r[rWcy)zPReturn a plane with the z_dir aligned with the axis and optional x_dir directionNr)rrfrs rRrzPlane.__init__ r[rWchd}d|v}d|v}|jdd}|jdd}|jdd}|jdd} |jd d} |jd d} |jdd} |jdd } |rtd d j||r?|d}|t|tr|}n$|>t |dr2t|j tr|}| t|dkDr|d} n|t|tr|}n| 0t|tr |} t|dkDr t|d} n| t|dk(r+t| | ||fs|j|\} }||\} } n t|} | *t|dkDrt|dj} t|dkDrt|dj} |r)t|tsJ|j!||_yd}d}d}|rYt%j&|j }|j(s t+dt-}t/j0|j |t|j3}t|t4r4t7}t9}t9}|j;dd|||n9t|t<sJt9|j?jA}| r t| n t|}tCt|d}tDjG|j }tCt|d}nI|rtItDjJj ddddjM}|jO|j |jP}t%j&|}t|t<sJt|j?jA}tCt|d}tDjG|}tCt|d}n]| r(| jP}| t| nd}| jR}n3| &t| }| r t| nd}t| }n t||r |r td| | t+dt|jTdk(r t+dt| jTdk(r t+dt|j}t| j}|jW|}|jTdk(r t+d|j}|jW|j}|jW|j}n|jTdk(r t+d|j}|PtY|j[|j]}t|jAj}n$>$@ 4y1}$*47O$>$>$@ i0 00 55i@DM  ))(*:*:;G%% !OPP%J  ) )(*:*:J GJ3356F'#67#X "H  3UJ B!'+ABBB#G$4$4$6$A$A$CD )2F9%z8JE&-,E001A1ABE&-,E /  $T3df  NN<// 0!**F)))4Gg'=> >>7++-88:;E&-,E00;E&-,E &&F)2)>F9%DE&&E  #J'F)2F9%E9%E./ / LEF F  } !QRRe}##s* !9::i ''3. !9::5M,,.EY'224G G,I3& !GHH((*EKK&113EKK&113E||s" !9::$$&E}V]]_elln=s~~/0;;=%=''3.$%=>>u 002V]]_ellnellnE11&+> _%E'(:;DE&! A#$67S@As1[1"B\1 \ : \\ \1 \,,\1c|jS)zThe OCP objectrrs rRrdz Plane.wrapped rrWc>|jjr|Stjddt |j |j j|jj}tt|S)z.Check for right handedness and fix if requiredz!Trying to set a left-handed planerrX) r"DirectrZr[r%rormrXAxisr+r&)rax2s rRrzPlane._ensure_right_handed sk <<> "J 9aHS\\^SXXZ%9%9%;SYY[=R=R=TUfSk""rWczt|j|j|zz|j|jS)z2Move the Plane by amount in the direction of z_dirr)rnrrr)ramounts rRoffsetz Plane.offset s0;;f!44DJJdjj  rWcZtt|jjSr=rnr+rdr"rs rRr?zPlane.__copy__ VDLL113455rWcZtt|jjSrBrArCs rRrEzPlane.__deepcopy__ rBrWcpt|tstS|j|jk(S)zAre planes equal operator ==)rlrnr/r0rs rRr1z Plane.__eq__ s)%'! !yy{ejjl**rWc4t|jS)z Hash of Planer3rs rRr5zPlane.__hash__ r6rWc|jj|jj|jjfSr8)rr0rrrs rRr0z Plane._key s2   "DJJOO$5tzz7HIIrWcZt|j|j|j S)z'Reverse z direction of plane operator -)rnrrrrs rRr z Plane.__neg__ sT[[$**tzzk::rWcyrLrrs rRrz Plane.__mul__ rrWcyrLrrs rRrz Plane.__mul__ s. sK5:eX%56Ks!#)rlrornrhrrrr/)rrrs rRrz Plane.__mul__ s eX &D>E) ) eU #D>ENN2 2 %[FKFKK"(TN)3E5)Au~~uNL    s$!B))1B$B)$B)) B:9B:cyrLrrs rRrzPlane.__rmul__ rrWcyrLrrs rRrzPlane.__rmul__ sJMrWct|ttzr|j|S t |Dcgc]}|j|c}Scc}w#t $r)}t t|jd||d}~wt $rYnwxYwt t|jdt|j)Nz cannot be multiplied by ) rlrornmovedall_location_likeNotAllLocationLikeErrorrrsr))rrres rRrzPlane.__rmul__ s eX- .::e$ $ /@/GHDJJsOH HH& YtDz2233LQCPQWX X   Dz""##O=PPQRRrWcFt|j|dtdS)zRepresent Planerrrrs rRr*zPlane.__repr__ rrWc t|jd|jdtdd|jdtdd|j dtddS)z Display Planez : (origin=rrz, x_dir=z, z_dir=r!)rsr)rrrrrs rRr-z Plane.__str__ skDz""#${{1ZL/23ZZ*Q/0ZZ*Q/q 2 rWc| S)zReverse z direction of planerrs rRrz Plane.reverse s u rWcHt|jjS)z&global position of local (0,0,0) pointrrs rRrz Plane.origin rrWch|jjt|jy)zSet the Plane originNrrs rRrz Plane.origin s#   !5!5!78rWcdt|jjjS)z&Local Z direction normal to the plane.)rprdrmrrs rRrz Plane.z_dir s%dll'')33566rWcdt|jjjS)zLocal X direction of the plane.)rprdr;rrs rRrz Plane.x_dir$ %dll((*44677rWc|j}|jt|j|jj t |y)z'Set the local X direction of the plane.N) to_gp_ax2 SetXDirectionrprIrd SetPositionr&rrr<s rRrz Plane.x_dir) Bnn &+2245   -rWcdt|jjjS)zLocal Y direction of the plane.)rprdYAxisrrs rRrz Plane.y_dir0 r]rWc|j}|jt|j|jj t |y)z'Set the local Y direction of the plane.N)r_ SetYDirectionrprIrdrar&rbs rRrz Plane.y_dir5 rcrWct|dr|j tdt|drt|jtrut j |j}t|j|j|j}|j|st|dt|ttfr*t|}|j|sgt|dt|tr2|j|}t|tst|d|}ntdt!|t#||j$|j&S)aRshift plane origin Creates a new plane with the origin moved within the plane to the point of intersection of the axis or at the given Vertex. The plane's x_dir and z_dir are unchanged. Args: locator (Axis | VectorLike | Vertex): Either Axis that intersects the new plane origin or Vertex within Plane. Raises: ValueError: Vertex isn't within plane ValueError: Point isn't within plane ValueError: Axis doesn't intersect plane Returns: Plane: plane with new origin rdz#Can't shift origin to empty locatorz is not located within planez doesn't intersect the planezInvalid locate type: r)rqrdrrrlr;rrrprYrZr[containsrTrmrrrsrnrr)rlocatorr new_origin intersections rR shift_originzPlane.shift_origin< s)& 7I &7??+BBC C 7I &:goo}+U"9J   OJ==, G9,H!IJJ % 1J==) G9,H!IJJ  &>>'2LlF3 G9,H!IJJ%J3DM?CD DJdjj KKrWc|tj}ttt |\}}}t }|j tj||||t}|j||jj|}|j|jjtt!t#|S)aReturns a copy of this plane, rotated about the specified axes The origin of the workplane is unaffected by the rotation. Rotations are done in order x, y, z. If you need a different order, specify ordering. e.g. Intrinsic.ZYX changes rotation to (z angle, y angle, x angle) and rotates in that order. Args: rotation (VectorLike, optional): (x angle, y angle, z angle). Defaults to (0, 0, 0) ordering (Intrinsic | Extrinsic, optional): order of rotations in Intrinsic or Extrinsic rotation mode. Defaults to Intrinsic.XYZ Returns: Plane: a copy of this plane rotated as requested. )r@rrr rpr-rrorr.rr_rKrrdrnr+r&) rrra1a2a3r_ trsf_rotationaxs rRrotatedz Plane.rotatedc s.   }}H&"23 B"_ !!(":":8"Db"bQ !!*- ^^  ) )- 8 t||,,./VF2J'((rWcjt|tr |j}t|j|zS)zChange the position & orientation of a copy of self by applying a relative location Args: loc (Location | Plane): relative change Returns: Plane: relocated plane )rlrnrhrrs rRrPz Plane.moved s+ c5 !,,CT]]S())rWcd|j|j|j|_|S)zChange the position & orientation of self by applying a relative location Args: loc (Location | Plane): relative change Returns: Plane: relocated self )rrPrdr~rvs rRmovez Plane.move s)11$**S/2I2IJ  rWct}|j}t}|j||t t |S)z&forward location transformation matrixr& to_gp_ax3r.rrtr))rglobal_coord_systemlocal_coord_system forward_ts rRforward_transformzPlane.forward_transform sB%h!^^-I ##$79KLhy)**rWct}|j}t}|j||t t |S)z&reverse location transformation matrixrz)rr|r} inverse_ts rRreverse_transformzPlane.reverse_transform sB%h!^^-I ##$68KLhy)**rWct|S)z7Return Location representing the origin and z direction)rors rRrhzPlane.location s~rWc6|jjS)z"Return gp_Ax3 version of the plane)rdr"rs rRr{zPlane.to_gp_ax3 s||$$&&rWcR|jjjS)z"Return gp_Ax2 version of the plane)rdr"Ax2rs rRr_zPlane.to_gp_ax2 s||$$&**,,rWc(|r |jn |j}t|ttfrt |j |St|t rt |jj|jj|jj}t |jj|jj|jj}|j |}|j |}tt|t|}t |St|dr|j t!dt|drzt|jt"r_t$j&t(j*t$j,t(j.t$j0t(j2t$j4t(j6t$j8t(j:t$j<t(j>t$j@t(jBi} |jJ | |jjE} tIjJ|d} | tM|j|jjOjQ| _| St!dtS|d#tF$r} t!d|| d} ~ wwxYw)a_to_from_local_coords Reposition the object relative to this plane Args: obj (VectorLike | Shape | BoundBox): an object to reposition. Note that type Any refers to all topological classes. to_from (bool, optional): direction of transformation. Defaults to True (to). Raises: ValueError: Unsupported object type Returns: an object of the same type, but repositioned to local coordinates rdNzCant's reposition empty objectzUnknown object type zUnable to repositioned type z" with respect to local coordinates)*rrrlrTrprTrr"rYrZr[rrr,rqrdrrr:r5 TopAbs_VERTEXr7rE TopAbs_EDGErB TopAbs_WIREWire TopAbs_FACErC TopAbs_SHELLShell TopAbs_SOLIDSolidTopAbs_COMPOUNDCompound ShapeTypeKeyError copy_moduledeepcopyrrLrDrs) rr7to_fromtransform_matrixglobal_bottom_leftglobal_top_rightlocal_bottom_leftlocal_top_right local_bbox downcast_lut f_downcastr new_shapes rR_to_from_local_coordszPlane._to_from_local_coords sS&6=411$BXBX cE6? +#;(()9: : c8 $!' 37799cggii!H %cggiiCGGIIF  2 < <=M N .889IJO )*(JJ' ' 3 "s{{':=> > 3 "z#++|'L !..  ,,fkk ,,fkk ,,fkk --v|| --v|| 00&// ;;* ** H)#++*?*?*AB  +33C>I *(KK!1!9!9!>!>!@%'!I   *49+5W X   H #7u!=>CG Hs K44 L=L  Lc&|j|dS)a1Reposition the object relative to this plane Args: obj: VectorLike | Shape | BoundBox an object to reposition. Note that type Any refers to all topological classes. Returns: an object of the same type, but repositioned to local coordinates Trrr7s rRto_local_coordszPlane.to_local_coords s))#t44rWc&|j|dS)a3Reposition the object relative from this plane Args: obj: VectorLike | Shape | BoundBox an object to reposition. Note that type Any refers to all topological classes. Returns: an object of the same type, but repositioned to world coordinates Frrs rRrmzPlane.from_local_coords s))#u55rWct}|j|jj|jjt |S)zAReturn a location representing the translation from self to other)r.rrdr"ro)rrr s rRlocation_betweenzPlane.location_between sE!(( LL ! ! #U]]%;%;%= ''rWc>t|trY|jjt |j j |jj||}|S|jjt|j |}|S)a5contains Is this point or Axis fully contained in this plane? Args: obj (VectorLike | Axis): point or Axis to evaluate tolerance (float, optional): comparison tolerance. Defaults to TOLERANCE. Returns: bool: self contains point or Axis ) rlrmrdContainsr*rrrrIrp)rr7rrQs rRrizPlane.contains$ s c4 <<00s||**,cmm.B.B.DEL <<001C1C1EyQLrWc|j|r|St|j}t|j }t ||}|j r-|jdk(rt|jdSy)z,Find intersection of this plane and an axis.rAN) rirrdr r{r!IsDoneNbPointsrpPoint)rrf geom_line geom_planeintersection_calculators rRrzPlane._intersect_axis; sw == Kdll+  01 "/ :"F " ) ) +0G0P0P0RVW0W177:; ;rWc|j|jr|j|jk(r|St|j}t|j}t ||t }|jrO|jdkDr<|jd}t|tsJt|jSy)z2Find intersection of this plane and another plane.rrAN)rirrr rdr"r^rNbLinesLinerlrrmr")rrgsurface1surface2 intersectorintersection_lines rR_intersect_planezPlane._intersect_planeH s == &4::+DKdll+emm,#Hh B    K$7$7$9A$= + 0 0 3 /; ;;)2245 5rWct|}|j|jsy|j|jk(r|S|jS)z/Find intersection of this plane and a location.N)rnrirr)rrhlocation_planes rRrzPlane._intersect_locationV sCx}}^223 ::-- -O$$$rWcy)z%Find intersection of plane and vectorNrrZs rRrzPlane.intersect_ r[rWcy)z'Find intersection of plane and locationNrr]s rRrzPlane.intersectc r[rWcy)z#Find intersection of plane and axisNrr_s rRrzPlane.intersectg r[rWcy)z$Find intersection of plane and planeNrrs rRrzPlane.intersectk r[rWcy)z$Find intersection of plane and shapeNrrbs rRrzPlane.intersecto r[rWct|i|\}}}}}||j|S||j|S||j|r|S||j |S||j |Sy)z8Find intersection of plane and geometric object or shapeN)r|rrrirrrds rRrzPlane.intersects s0Ed/Uf/U,eVXu  ''- -  ((/ /  $--"7M  ++H5 5  ??4( (rW)rr9r"rp)rr r"z+tuple[Vector, tuple[Vector, Vector] | None])rr+r"rh)rzIterable[VectorLike]r"rh)Nr)rrjrVectorLike | Nonerrjr"rh)rrjrrjrrjr"rhrL)rrCrrr"rhr)rfrmrrr"rhr)r"r+)rr+)r>rr"rnr )rrprr)r"z>tuple[tuple[float, ...], tuple[float, ...], tuple[float, ...]]r/)rLocation | Planer"ro)rIterable[Location | Plane]r"r0)r-Location | Plane | Iterable[Location | Plane]r"r1)rror"rn)rrr"z list[Plane])rrr"zPlane | list[Plane])rrnrrmrnrkr.r )rjzAxis | VectorLike | Vertexr"rn)rN)rrjrzExtrinsic | Intrinsic | Noner"rn)rrr"rnr )r"r&)r"r%)T)r7VectorLike | Any | BoundBoxrrq)r7r)r7ztuple | Vector | Any | BoundBox)rrnr"ro)r7zVectorLike | Axisrrr"rq)rfrmr"zAxis | Vector | None)rgrnr"zAxis | Plane | Nonerrurrv)2r)rwrxryrKr rrrr|rdrr?r?rEr1r5r0r rrrr'r*r-rrr}rrrrmrtrPrxrrrhr{r_rrrmrr^rirrrrrrWrRrnrn| s<~)) 4))&0055$(% @@!@ @  @@@@@  @  @@PP;;__Y?v## 66+ !J;55 ?? OOB "&55 MM  B    %S= // ]]997788 \\.. 88 \\.. %LR )15#)#)/#)  #)J * ++++'- AE? .? 9=? B 5 6(CL.  %4466223333rWrn)rmrNrornrpcg}|t|t|zdz }||tjur tdddS|tjur t| S|tjur t| S|tj ur t| St tt||||D]\}}}}|tjk(r|j| .|tj k(r|j| T|tjk(r|j| z|tjk(s|jdt|S)rFrr) rpr<NONEMINMAXCENTERrrappend) min_point max_pointrHr align_offset alignment min_coord max_coord center_coords rRrGrG s>L ~#fY&771< }+aA  y!!!  y!!!  v9< E5 : #5 9i  !    + %,, &    . %)) #    + %** $    " # <  rWc$eZdZdZdfd ZxZS)rRzRaised when an iterable contains objects that cannot be converted to Locations. The exception message lists the unique type names of the invalid objects. c tt|djtdt |Dy)Nrec34K|]}|jywrL)r))rOts rRrSz3NotAllLocationLikeError.__init__.. s)O!**)Orw)rrrtsortedru)r wrong_typesrs rRrz NotAllLocationLikeError.__init__ s) 6)Oc+>N)O#OPQrW)rzIterable[Type[Any]]r"rh)r)rwrxryrrrs@rRrRrR s RRrWrRcZt|}td|Dx}r t||S)zReturns the items as a list unless any of them is not an instance of `Location | Plane`. Otherwise raises `NotAllLocationLikeError`.c3K|];}t|ttzs"ttt t |=ywrL)rlrornrrr rs)rOrs rRrSz$all_location_like.. s6 $5 01 T#YT #sAA)rrurR)rrs rRrQrQ s@ KE{ &k22 LrW)rUzIterable[float]rQrr"rs)r_r-rQrr"rsrL) rrjrrjrHrJrrr"rp)rz Iterable[Any]r"zlist[Location | Plane])ry __future__rrcopyrrkjsonloggingrZcollections.abcrrrmathrrr r r typingr r rrrrrnumpyrtyping_extensionsrrOCP.BndrrOCP.BReprOCP.BRepBndLibrOCP.BRepBuilderAPIrr OCP.BRepGProprr OCP.BRepToolsrOCP.Geomrrrr OCP.GeomAPIr!r"r#OCP.gpr$r%r&r'r(r)r*r+r,r-r.r/r0 OCP.GPropr1 OCP.Quantityr2r3r4 OCP.TopAbsr5 OCP.TopLocr6 OCP.TopoDSr7r8r9r:r;build123d.build_enumsr<r=r>r?r@topologyrBrCrDrErF getLogger addHandler NullHandlerloggerr^r]rrrDEG2RADrGEOM_KEY_DIGITSrVrbr|rprTrrjrzrsrrmrrNr$r JSONEncoderrrorUrarRotr,rrtrrnrrGrrRrQrrWrRrs:# 8822OOO($%P3#WWPP"#QQ'&TTOO33iu-G+))*='*=*=*?@   ; '  U9%& '   u* (q.,;; ;%(;;.= , ,'* , ,0@xxx  U5%<  5u)<#==O I)t)&WXWt ^:^:BX6X6x C  ECKeck 123   US[%#+us{:    CHo    9 ;/$"";/|QDQDh*d&&*ZP P f;x;|"U5%+>%?? i?'*('*TS)S)lF F RK iK ^    !% #!#!#! #!  #!  #!LRiR rW