ht8SrSSKrSSKrSSKJr SSKJrJrJ r J r J r J rJr SSKJrJrJrJrJr SSKJr SSKJr SS KJr S rS rS rS r "SS\RB5r"S3Sjr#"SS\ RH5r%S3Sjr&S4Sjr'S4Sjr(S4Sjr)S4Sjr*"SS\5r+S3Sjr,"SS\5r-S3Sjr."SS\5r/"S S!\/5r0S"r1S3S#jr2S4S$jr3"S%S&\5r4"S'S(\5r5S5S)jr6"S*S+\5r7S3S,jr8S-r9S.r:S/r;S6S0jrg)8zx Module containing 3D artist code and functions to convert 2D artists into 3D versions which can be added to an Axes3D. N)contextmanager)_apiartistcbookcolorslinestextpath) CollectionLineCollectionPolyCollectionPatchCollectionPathCollection) Normalize)Patch)proj3dc,US-S-nUS:aUS- nU$)z?Return the given angle normalized to -180 < *a* <= 180 degrees.ihas L/var/www/html/env/lib/python3.13/site-packages/mpl_toolkits/mplot3d/art3d.py _norm_anglers$ SCA3w G Hc,US-S-nUS:aUS- nU$)z=Return the given angle normalized to -90 < *a* <= 90 degrees.rZrrs r_norm_text_angler"s$ SCA2v G HrcrUS:Xa[R"S5$US:Xa[R"S5$US:Xa[R"S5$Uc[R"S5$[R"U5(a%[U5S:Xa[R"U5$[ S 5e) a Return a direction vector. Parameters ---------- zdir : {'x', 'y', 'z', None, 3-tuple} The direction. Possible values are: - 'x': equivalent to (1, 0, 0) - 'y': equivalent to (0, 1, 0) - 'z': equivalent to (0, 0, 1) - *None*: equivalent to (0, 0, 0) - an iterable (x, y, z) is converted to an array Returns ------- x, y, z : array The direction vector. x)rrry)rrrz)rrr)rrrz2'x', 'y', 'z', None or vector of length 3 expected)nparrayiterablelen ValueError)zdirs rget_dir_vectorr**s( s{xx "" xx "" xx "" xx "" T  s4yA~xx~MNNrc  [RRXRR:XRR :XRR :XRR:X#RR:X#RR :45n[RRXS9n[RRXS9n[RRX$S9nXVU4$)a Return original points with points outside the axes view limits masked. Parameters ---------- xs, ys, zs : array-like The points to mask. axes : Axes3D The axes to use for the view limits. Returns ------- xs_masked, ys_masked, zs_masked : np.ma.array The masked points. )mask) r$ logical_orreduce xy_viewLimxminxmaxyminymax zz_viewLimmar%)xsyszsaxesr, xs_masked ys_masked zs_maskeds r _viewlim_maskr=Ls ==  oo&:&:!:!#oo&:&:!:!#oo&:&:!:!#oo&:&:!:!#oo&:&:!:!#oo&:&:!: !< =D  B *I B *I B *I  **rc~^\rSrSrSrS SjrSrS U4SjjrSrS Sjr \ RS5r S S jr S rU=r$)Text3Dha Text object with 3D position and direction. Parameters ---------- x, y, z : float The position of the text. text : str The text string to display. zdir : {'x', 'y', 'z', None, 3-tuple} The direction of the text. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide text outside the axes view limits. Other Parameters ---------------- **kwargs All other parameters are passed on to `~matplotlib.text.Text`. c l[RR"XX$40UD6 URX5U5 gN)mtextText__init__set_3d_properties)selfr r!r"r r) axlim_clipkwargss rrEText3D.__init__~s+ DQ77 q 3rcHURURUR4$)z*Return the (x, y, z) position of the text.)_x_y_zrGs rget_position_3dText3D.get_position_3dsww((rcz>[TU]USS5 URUS5 Ub[U5Ulgg)a0 Set the (*x*, *y*, *z*) position of the text. Parameters ---------- xyz : (float, float, float) The position in 3D space. zdir : {'x', 'y', 'z', None, 3-tuple} The direction of the text. If unspecified, the *zdir* will not be changed. See `.get_dir_vector` for a description of the values. N)super set_positionset_zr*_dir_vec)rGxyzr) __class__s rset_position_3dText3D.set_position_3ds? S!W% 3q6  *40DM rcXlSUlg)zD Set the *z* position of the text. Parameters ---------- z : float TN)rNstale)rGr"s rrV Text3D.set_zs rcJXl[U5UlX0lSUlg)aS Set the *z* position and direction of the text. Parameters ---------- z : float The z-position in 3D space. zdir : {'x', 'y', 'z', 3-tuple} The direction of the text. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide text outside the axes view limits. TN)rNr*rW _axlim_clipr])rGr"r)rHs rrFText3D.set_3d_propertiess"&t, % rcUR(a[URURURUR 5up#n[ RRX#U45R5R[ R5nO;URURURpCn[ R"X#U/5n[R"XUUR-/UR R 5nUSSUSS- nUSSUSS- n["R$"["R&"X55n [(R*"XSSUSS[-U 5S9 [.R0R3X5 SSS5 SUlg!,(df  N=f)Nrr)rLrM _rotationF)r`r=rLrMrNr9r$r5 row_stackravelfillednan asanyarrayr_proj_trans_pointsrWMmathdegreesatan2r _setattr_cmrrCrDdrawr]) rGrendererr6r7r8 position3dprojdxdyangles rro Text3D.drawsR   &tww$))LJBB""6<<>EEbffMJ$''477BB|4J(( dmm3 4diikkC !WQZ$q'!* $ !WQZ$q'!* $ TZZ/0   tQ tAwqz)9%)@B JJOOD +B BBs  F33 GcgrBr)rGrps r get_tightbboxText3D.get_tightbboxsr)r`rWrNr])rrrr"FrBrr"F)__name__ __module__ __qualname____firstlineno____doc__rErPrZrVrFrallow_rasterizationrorx__static_attributes__ __classcell__rYs@rr?r?hsE*4 )1" &  $rr?c>[UlURXU5 g)aL Convert a `.Text` to a `.Text3D` object. Parameters ---------- z : float The z-position in 3D space. zdir : {'x', 'y', 'z', 3-tuple} The direction of the text. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide text outside the axes view limits. N)r?rYrF)objr"r)rHs r text_2d_to_3drsCM!:.rct^\rSrSrSrSS.U4SjjrS SjrSrSr\ RU4S j5r S r U=r $) Line3Da 3D line object. .. note:: Use `get_data_3d` to obtain the data associated with the line. `~.Line2D.get_data`, `~.Line2D.get_xdata`, and `~.Line2D.get_ydata` return the x- and y-coordinates of the projected 2D-line, not the x- and y-data of the 3D-line. Similarly, use `set_data_3d` to set the data, not `~.Line2D.set_data`, `~.Line2D.set_xdata`, and `~.Line2D.set_ydata`. F)rHc`>[TU]"///UQ70UD6 URXU5 X@lg)z Parameters ---------- xs : array-like The x-data to be plotted. ys : array-like The y-data to be plotted. zs : array-like The z-data to be plotted. *args, **kwargs Additional arguments are passed to `~matplotlib.lines.Line2D`. N)rTrE set_data_3dr`)rGr6r7r8rHargsrIrYs rrELine3D.__init__s4 R1$1&1 $%rcUR5nUR5n[R"U5R 5n[ R "U[U55n[XEX5Ul X0l SUl g)a Set the *z* position and direction of the line. Parameters ---------- zs : float or array of floats The location along the *zdir* axis in 3D space to position the line. zdir : {'x', 'y', 'z'} Plane to plot line orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide lines with an endpoint outside the axes view limits. TN) get_xdata get_ydatar_to_unmasked_float_arrayrer$ broadcast_tor' juggle_axes_verts3dr`r])rGr8r)rHr6r7s rrFLine3D.set_3d_propertiessd^^  ^^   + +B / 5 5 7 __RR )#BB5 % rc[U5S:XaUSn[SU5H.up#[R"U5(aM"[ US35e XlSUlg)z Set the x, y and z data Parameters ---------- x : array-like The x-data to be plotted. y : array-like The y-data to be plotted. z : array-like The z-data to be plotted. Notes ----- Accepts x, y, z arguments or a single array-like (x, y, z) rrrXz must be a sequenceTN)r'zipr$r& RuntimeErrorrr])rGrnamerXs rrLine3D.set_data_3ds[" t9>7DUD)ID;;s##"dV+>#?@@*  rcUR$)z} Get the current data Returns ------- verts3d : length-3 tuple or array-like The current data as a tuple or array-like. )rrOs r get_data_3dLine3D.get_data_3d.s}}rcf>UR(a%[/URQURP76up#nOURup#n[R "X#UURR URR5upVpxURXV5 [T U])U5 SUl g)NF) r`r=rr9r_proj_transform_cliprj _focal_lengthset_datarTror]) rGrpxs3dys3dzs3dr6r7r8tisrYs rro Line3D.draw9s   ,GdmmGTYYG D#}} D 55d$6:iikk6:ii6M6MO b  X r)r`rr]r{)r|r}r~rrrErFrrrrrorrrs@rrrs@6;&&$.2     rrc>[UlURXU5 g)a Convert a `.Line2D` to a `.Line3D` object. Parameters ---------- zs : float The location along the *zdir* axis in 3D space to position the line. zdir : {'x', 'y', 'z'} Plane to plot line orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide lines with an endpoint outside the axes view limits. N)rrYrF)liner8r)rHs r line_2d_to_3drGsDN2Z0rc [R"U[U55nURSSS9n[ X15VVVVs/sHuuupEpgXEU4PM nnnnnUVVVs/sHupEn[ XEXr5PM n nnnU $s snnnnfs snnnf)zConvert a path to a 3D segment.Fsimplifycurves)r$rr' iter_segmentsrr) r r8r)pathsegsr r!coder"segseg3ds r_path_to_3d_segmentrZs SY 'B!!5!?H03H0A B0A,.6A4A!90AC B9< =IQ1[q 'E = L C =s B !Bc "[R"U5(d![R"U[U55nO#[U5[U5:wa [ S5e[ X5VVs/sHup4[ X4U5PM nnnU$s snnf)z6Convert paths from a collection object to 3D segments.z-Number of z-coordinates does not match paths.)r$r&rr'r(rr)pathsr8r)r pathzsegss r_paths_to_3d_segmentsrdsz ;;r?? __RU , r7c%j LM M #5~ /-  T 2-  / K /s.B c d[R"U[U55nURSSS9n[ X15VVVVs/sHuuupEpgXEU4U4PM nnnnnU(a.[ U6upU VVVs/sHupEn[ XEXr5PM n nnnO/n /n U [ U 54$s snnnnfs snnnf)z/Convert a path to a 3D segment with path codes.Fr)r$rr'rrrlist) r r8r)rr r!rr" seg_codesrcodesrs r_path_to_3d_segment_with_codesrrs SY 'B!!5!?H4; && 9sA5c\rSrSrSrSrSrg) Collection3DizA collection of 3D paths.c PURVVs/sHupUPM nnnUR(aXUVs/sHKn[RR [ /UR QURP765R PMM nnUVs/sH9n[R"/UR QURRP76PM; nn[X@R5VVVVs/sH@uupVnup'[R"[RRXV/5U5PMB snnnnUl[R "UVVs/sHu p(UPM snn5n[#U5(aUR%5$S$s snnfs snfs snfs snnnnfs snnf)z0Project the points according to renderer matrix.eA)_3dverts_codesr`r$r5rdr=Tr9rproj_transformrjrmpathPath column_stack_paths concatenater'min) rGvs_vs_list xyzs_listr6r7csr8s rdo_3d_projectionCollection3D.do_3d_projectionsG#'#6#67#6%"2#67   !(*!(2uu}'Fbdd'FDII'FGII!( *IPQ2V**>BDD>$))++> Q36yBUBU3VX3V/;BAzz"%%"4"4bX">C3VX ^^ : HAqR : ;r77rvvx++8*QX:sF AFAF*AF F" )rN)r|r}r~rrrrrrrrrs # ,rrc8[R"U[UR555n[ UR5U5VVs/sHupE[R "[ /[R "UR[R"U[UR55/5RQUP765UR4PM snnUl [R"[S5"[U55UlX0lgs snnf)z4Convert a `.Collection` to a `.Collection3D` object.z{}3DN)r$rr' get_pathsrrrverticesrrrr_make_class_factoryrtyperYr`)colr8r)rHpr"s rcollection_2d_to_3drs S1 2B  , . -DA  __ajj"//!S_*MN O Q Q    - .C --lFCDINCM O.s B DcH^\rSrSrSrSU4SjjrSrU4SjrSrSr U=r $) Line3DCollectioniz A collection of 3D lines. c 4>[TU]"U40UD6 X lgrB)rTrEr`)rGrrHrIrYs rrELine3DCollection.__init__s )&)%rcXlSUlgz&Set the position to use for z-sorting.TN _sort_zposr]rGvals r set_sort_zposLine3DCollection.set_sort_zpos rc0>Xl[TU] /5 g)z Set 3D segments. N) _segments3drT set_segments)rGrrYs rrLine3DCollection.set_segmentss$ R rc "URnUR(a[RR U5n[RR /[ /URQURP76Q5nUVs/sHn[R"U5SPM nn[R"U[R"USS55nUVs/sH-n[R"X`RR5PM/ nnUVV V s/sH&upn [RR X/5PM( n n nn [R "X 5 Sn UHupn [#U [#U 55n M U $s snfs snfs sn n nf)z2 Project the points according to renderer matrix. rNr)rr`r$r5vstackrr=rr9shapesplitcumsumrrirjr rr) rGr all_points masked_pointssegmentsegment_lengthspointsxyslistr6r7r8 segments_2dminzs rr!Line3DCollection.do_3d_projectionsP##   h/JEE..0K2J 2J?Cyy2J0KLMCKL8rxx038OLxx ryy"9M/NOH!)+!)v,,VYY[[A!) +FMNg ruu))2(3g N##D6!JBBtSW%D" M+Ns#F4F-F )r`rrr]F) r|r}r~rrrErrrrrrs@rrrs!& !rrc|[UR5X5n[UlUR U5 X0lg)z[TU]"U0UD6 URXU5 g)ai Parameters ---------- verts : zs : float The location along the *zdir* axis in 3D space to position the patch. zdir : {'x', 'y', 'z'} Plane to plot patch orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide patches with a vertex outside the axes view limits. N)rTrErF)rGr8r)rHrrIrYs rrEPatch3D.__init__s' $)&) r4rc [R"U[U55n[X5VVVs/sHuupVn[ XVXs5PM snnnUlX@lgs snnnf)a Set the *z* position and direction of the patch. Parameters ---------- verts : zs : float The location along the *zdir* axis in 3D space to position the patch. zdir : {'x', 'y', 'z'} Plane to plot patch orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide patches with a vertex outside the axes view limits. N)r$rr'rr _segment3dr`)rGvertsr8r)rHr r!r"s rrFPatch3D.set_3d_propertiessS __RU ,.1%n>.<{'qQ5.<>%>sAc[US5(d9URR5URlUR 5 UR $)N_path2d)hasattrr9get_projrjrr rOs rget_pathPatch3D.get_path s?tY'')),,.DIIK  ! ! #||rcURnUR(a![/[U6QURP76up#nO [U6up#n[ R "X#UURRURR5upVpx[R"[RRXV/55Ul[U5$rB)r r`r=rr9rrrjrrrr$r5rr r rGsr6r7r8vxsvysvzsviss rrPatch3D.do_3d_projections OO   &;Q;;JBBaJBB#889=9=9P9PR#zz"%%"4"4cZ"@A 3xr)r`r r r{) r|r}r~rrrErFrrrrrs@rrrs/"$#%55"&*  rrc:\rSrSrSrSSSS.SjrS SjrS rS rg ) PathPatch3Di z 3D PathPatch object. rr"Frc V[R"U40UD6 URXX45 g)a Parameters ---------- path : zs : float The location along the *zdir* axis in 3D space to position the path patch. zdir : {'x', 'y', 'z', 3-tuple} Plane to plot path patch orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide path patches with a point outside the axes view limits. N)rrErF)rGr r8r)rHrIs rrEPathPatch3D.__init__%s% t&v& t:rcd[RXRX#US9 URUlg)a Set the *z* position and direction of the path patch. Parameters ---------- path : zs : float The location along the *zdir* axis in 3D space to position the path patch. zdir : {'x', 'y', 'z', 3-tuple} Plane to plot path patch orthogonal to. Default: 'z'. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide path patches with a point outside the axes view limits. rN)rrFrr_code3d)rGr r8r)rHs rrFPathPatch3D.set_3d_properties7s- !!$ "-7 " 9zz rcURnUR(a![/[U6QURP76up#nO [U6up#n[ R "X#UURRURR5upVpx[R"[RRXV/5UR5Ul[!U5$rB)r r`r=rr9rrrjrrrr$r5rrr rrs rrPathPatch3D.do_3d_projectionKs OO   &;Q;;JBBaJBB#889=9=9P9PR#zz"%%"4"4cZ"@$,,O 3xr)rr Nr{) r|r}r~rrrErFrrrrrrr s$&CE;$"( rrcUR5nUR5nURU5n[U5(aUS$[R "/5$)z2Return a list of vertices for the path of a patch.r)get_patch_transformr to_polygonsr'r$r%)patchtransr polygonss r_get_patch_vertsr)XsK  % % 'E >> D&Hh--8A;9RXXb\9rcT[U5n[UlURXAX#5 g)z*Convert a `.Patch` to a `.Patch3D` object.N)r)rrYrF)r&r"r)rHr s rpatch_2d_to_3dr+`s# U #EEO Ed7rcUR5nUR5nURU5n[UlUR XQU5 g)z2Convert a `.PathPatch` to a `.PathPatch3D` object.N)rr$transform_pathrrYrF) pathpatchr"r)r r'rs rpathpatch_2d_to_3dr/gsF    D  ) ) +E   &E%I $/rc^\rSrSrSrSSSSS.U4SjjrS rS rS rSS jr U4S jr Sr U4Sjr U4Sjr SrU=r$)Patch3DCollectioniqz A collection of 3D patches. rr"TFr8r) depthshaderHcV>X0l[TU]"U0UD6 URXU5 g)aJ Create a collection of flat 3D patches with its normal vector pointed in *zdir* direction, and located at *zs* on the *zdir* axis. 'zs' can be a scalar or an array-like of the same length as the number of patches in the collection. Constructor arguments are the same as for :class:`~matplotlib.collections.PatchCollection`. In addition, keywords *zs=0* and *zdir='z'* are available. Also, the keyword argument *depthshade* is available to indicate whether to shade the patches in order to give the appearance of depth (default is *True*). This is typically desired in scatter plots. N) _depthshaderTrErFrGr8r)r3rHrrIrYs rrEPatch3DCollection.__init__vs- & $)&) r4rcUR$rBr5rOs rget_depthshade Patch3DCollection.get_depthshadercXlSUlgz Set whether depth shading is performed on collection members. Parameters ---------- depthshade : bool Whether to shade the patches in order to give the appearance of depth. TNr5r]rGr3s rset_depthshade Patch3DCollection.set_depthshade& rcXlSUlgrrrs rrPatch3DCollection.set_sort_zposrrcUR5 UR5n[U5S:aURupVO/n/n[ XV[ R "U5U5Ul[S5Ul SUl X0l SUl g)a Set the *z* positions and direction of the patches. Parameters ---------- zs : float or array of floats The location or locations to place the patches in the collection along the *zdir* axis. zdir : {'x', 'y', 'z'} Plane to plot patches orthogonal to. All patches must have the same direction. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide patches with a vertex outside the axes view limits. rrNT) update_scalarmappable get_offsetsr'rrr$ atleast_1d _offsets3dslice_z_markers_idx_vzsr`r]rGr8r)rHoffsetsr6r7s rrF#Patch3DCollection.set_3d_propertiessz$ ""$""$ wUR(a%[/URQURP76upnOURupn[R "XUURR URR5upEpgX`l[TU])[RRXE/55 URS:a [U5$[R $Nr)r`r=rJr9rrrjrrMrT set_offsetsr$r5rsizerrg) rGr6r7r8rrrrrYs rr"Patch3DCollection.do_3d_projections   &CCCJBBJBB#889=9=9P9PR#  BEE..z:; 88a<s8O66MrcURb&UR(a[XR5OUn[U5S:aXRn[ R "XR5$NrrMr5_zalphar'rLmcolors to_rgba_array_alpharG color_arrays r"_maybe_depth_shade_and_sort_colors4Patch3DCollection._maybe_depth_shade_and_sort_colors^yy$)9)9 K +  { a %&9&9:K$$[++>>rc>>UR[TU] 55$rBr_rT get_facecolorrGrYs rrdPatch3DCollection.get_facecolor66uw7L7NOOrc>[R"URS5(aUR5$UR [ TU]55$Nfacer _str_equal _edgecolorsrdr_rT get_edgecolorres rrnPatch3DCollection.get_edgecolorF   D,,f 5 5%%' '66uw7L7NOOr)r`r5rJrrMrLr]r)r|r}r~rrrEr:rArrFrr_rdrnrrrs@rr1r1qsM CDU55(   > ?PPPrr1c^\rSrSrSrSSSSS.U4SjjrU4S jrS rSS jrSU4S jjr U4S jr Sr Sr Sr \U4Sj5rSrU4SjrU4SjrSrU=r$)Path3DCollectioniz A collection of 3D paths. rr"TFr2cr>X0lSUl[TU] "U0UD6 UR XU5 SUlg)aE Create a collection of flat 3D paths with its normal vector pointed in *zdir* direction, and located at *zs* on the *zdir* axis. 'zs' can be a scalar or an array-like of the same length as the number of paths in the collection. Constructor arguments are the same as for :class:`~matplotlib.collections.PathCollection`. In addition, keywords *zs=0* and *zdir='z'* are available. Also, the keyword argument *depthshade* is available to indicate whether to shade the patches in order to give the appearance of depth (default is *True*). This is typically desired in scatter plots. FN)r5_in_drawrTrErF_offset_zorderedr6s rrEPath3DCollection.__init__s< &  $)&) r4 $rc>UR5 [R"USS9 [TU]U5 SSS5 SSS5 g!,(df  N=f!,(df  g=f)NT)rt)_use_zordered_offsetrrnrTro)rGrprYs rroPath3DCollection.drawsH  & & (""4$7 X&8) (77) (s!AA A A A A(cXlSUlgrrrs rrPath3DCollection.set_sort_zposrrcUR5 UR5n[U5S:aURupVO/n/nX l[ XV[ R"U5U5UlURUl [ R"UR5Ul URupVn[S5UlSUlX0lSUlg)a Set the *z* positions and direction of the paths. Parameters ---------- zs : float or array of floats The location or locations to place the paths in the collection along the *zdir* axis. zdir : {'x', 'y', 'z'} Plane to plot paths orthogonal to. All paths must have the same direction. See `.get_dir_vector` for a description of the values. axlim_clip : bool, default: False Whether to hide paths with a vertex outside the axes view limits. rrNT)rGrHr'r_zdirrr$rIrJ_sizes_sizes3dr% _linewidths _linewidths3drKrLrMr`r]rNs rrF"Path3DCollection.set_3d_properties s$ ""$""$ w[TU]X5 UR(dXlggrB)rT set_sizesrtr)rGsizesdpirYs rrPath3DCollection.set_sizes;s! %%}}!Mrc>[TU]U5 UR(d&[R"UR 5UlggrB)rT set_linewidthrtr$r%rr)rGlwrYs rrPath3DCollection.set_linewidth@s3 b!}}!#$*:*:!;D rcUR$rBr9rOs rr:Path3DCollection.get_depthshadeEr<rcXlSUlgr>r?r@s rrAPath3DCollection.set_depthshadeHrCrcdUR(a%[/URQURP76upnOURupn[R "XUURR URR5upEpg[RRU5SSS2=ol X`l [UR5S:aURUUl[UR 5S:aUR UUl[$R&"U[RR)XE455 XhnXHnXXn[RR)XE45UlUR,(a[R."U5$[R0$)Nrr)r`r=rJr9rrrjrr$r5argsortrLrMr'rr~rrrrSrrurTrrg) rGr6r7r8rrrr z_markers_idxs rr!Path3DCollection.do_3d_projectionUsL   &CCCJBBJBB#889=9=9P9PR# /1eemmC.@2.FF +  t}}  !-- 6DK t!! "Q &#11-@D ""4););SJ)GH   !# 2 2C: >!hhrvvc{2BFF2rc#># URcSv gURn[TU] UR5 Sv Xlg!Xlf=f7frB)ru_offsetsrTrS)rG old_offsetrYs rrx%Path3DCollection._use_zordered_offsetzsE  ( J G  5 5 6 + * s8AAAAAcURb&UR(a[XR5OUn[U5S:aXRn[ R "XR5$rWrXr]s rr_3Path3DCollection._maybe_depth_shade_and_sort_colorsrarc>>UR[TU] 55$rBrcres rrdPath3DCollection.get_facecolorrgrc>[R"URS5(aUR5$UR [ TU]55$rirkres rrnPath3DCollection.get_edgecolorrpr)r`r5rtrrrurrJr~rrrMrLr}r]r)gR@)r|r}r~rrrErorrFrrr:rArrrxr_rdrnrrrs@rrrrrsr CDU%%,'  0d" <   #3J + +?PPPrrrc[U[5(a[UlSUlO [U[ 5(a [ UlX0lSUlURXU5 g)a Convert a `.PatchCollection` into a `.Patch3DCollection` object (or a `.PathCollection` into a `.Path3DCollection` object). Parameters ---------- col : `~matplotlib.collections.PatchCollection` or `~matplotlib.collections.PathCollection` The collection to convert. zs : float or array of floats The location or locations to place the patches in the collection along the *zdir* axis. Default: 0. zdir : {'x', 'y', 'z'} The axis in which to place the patches. Default: "z". See `.get_dir_vector` for a description of the values. depthshade : bool, default: True Whether to shade the patches to give a sense of depth. axlim_clip : bool, default: False Whether to hide patches with a vertex outside the axes view limits. NF) isinstancerrrrYrurr1r5rtrF)rr8r)r3rHs rpatch_collection_2d_to_3drsP*#~&&( # C ) ))  OCL"J/rc^\rSrSrSrSSSSS.U4Sjjr\R\R\RS.r S r \ R"S 5S 5rS rSU4S jjrSrSSjrSrSrU4SjrU4SjrSrSrSrSrU=r$)Poly3DCollectionia A collection of 3D polygons. .. note:: **Filling of 3D polygons** There is no simple definition of the enclosed surface of a 3D polygon unless the polygon is planar. In practice, Matplotlib fills the 2D projection of the polygon. This gives a correct filling appearance only for planar polygons. For all other polygons, you'll find orientations in which the edges of the polygon intersect in the projection. This will lead to an incorrect visualization of the 3D area. If you need filled areas, it is recommended to create them via `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_trisurf`, which creates a triangulation and thus generates consistent surfaces. averageFN)zsortshade lightsourcerHc>U(ad[U5nURSS5n U b[XU5US'URSS5n U b[XU5US'U cU c [S5e[T U]"U/UQ70UD6 [ U[R5(aURS:wa [S5eO"[SU55(a [S5eURU5 SUl XPl g)a Parameters ---------- verts : list of (N, 3) array-like The sequence of polygons [*verts0*, *verts1*, ...] where each element *verts_i* defines the vertices of polygon *i* as a 2D array-like of shape (N, 3). zsort : {'average', 'min', 'max'}, default: 'average' The calculation method for the z-order. See `~.Poly3DCollection.set_zsort` for details. shade : bool, default: False Whether to shade *facecolors* and *edgecolors*. When activating *shade*, *facecolors* and/or *edgecolors* must be provided. .. versionadded:: 3.7 lightsource : `~matplotlib.colors.LightSource`, optional The lightsource to use when *shade* is True. .. versionadded:: 3.7 axlim_clip : bool, default: False Whether to hide polygons with a vertex outside the view limits. *args, **kwargs All other parameters are forwarded to `.PolyCollection`. Notes ----- Note that this class does a bit of magic with the _facecolors and _edgecolors properties. facecolorsN edgecolorszCYou must provide facecolors, edgecolors, or both for shade to work.r#z)verts must be a list of (N, 3) array-likec3f# UH'n[[R"U55S:gv M) g7f)rSN)r'r$r).0verts r ,Poly3DCollection.__init__.. s">3rxx~&!+s/1)_generate_normalsget _shade_colorsr(rTrErr$ndarrayndimany set_zsort_codes3dr`) rGr rrrrHrrInormalsrrrYs rrEPoly3DCollection.__init__sD '.GL$7J%'4(|$ L$7J%'4(|$!j&8 %&& 000 eRZZ ( (zzQ !LMM>>>> !LMM u %r)rrmaxcHURUUlSUlSUlg)z Set the calculation method for the z-order. Parameters ---------- zsort : {'average', 'min', 'max'} The function applied on the z-coordinates of the vertices in the viewer's coordinate system, to determine the z-order. NT)_zsort_functions _zsortfuncrr])rGrs rrPoly3DCollection.set_zsorts$//6 rz3.10c$URU5$rB) _get_vector)rGrs r get_vectorPoly3DCollection.get_vector$s ++rc [U5(a$[R"U5Rup#nO///pCn[R"[U55n[R "X#XE/5UlS/[R"UVs/sHn[U5PM sn5Qn/[[USSUSS5QUl gs snf)zOptimize points for projection.rNrr) r'r$rronesr%_vecrmaprK _segslices)rGrr6r7r8rrindicess rrPoly3DCollection._get_vector(s z??:.00JBBRBBwws2wHHbb/0 Kryyj!Ij7#g,j!IJKBCws|WQR[AB"Js C cT>URU5 [TU] /S5 X lg)af Set 3D vertices. Parameters ---------- verts : list of (N, 3) array-like The sequence of polygons [*verts0*, *verts1*, ...] where each element *verts_i* defines the vertices of polygon *i* as a 2D array-like of shape (N, 3). closed : bool, default: True Whether the polygon should be closed by adding a CLOSEPOLY connection at the end. FN)rrT set_verts_closed)rGr closedrYs rrPoly3DCollection.set_verts4s'  "e$ rc0URUSS9 X lg)z Set 3D vertices with path codes.F)rN)rr)rGr rs rset_verts_and_codes$Poly3DCollection.set_verts_and_codesGs uU+ rcUR5 SUlURS5 [R"U5Ul[R "U5Ul[R"U5Ul SUl g)NrT) rGrrr rd _facecolor3drn _edgecolor3d get_alpha_alpha3dr])rGrHs rrF"Poly3DCollection.set_3d_propertiesOsb ""$ y!*88>*88>&006  rcXlSUlgrrrs rrPoly3DCollection.set_sort_zposZrrc ^TRbTTR5 TR(aTRTlTR (aTR TlTR(a[/TRSSQTRP76upnTRRSS:XaY[RRUR TRS5n[RR#XX4/5nO.[RR#XU/5nO TRn[$R&"UTRR(5upgnTR*V s/sHoU XyX4PM n n TRn TRn [-U 5[-U 5:waU R/[-U 5SS9n [-U 5[-U 5:wa+[-U 5S:XaU n OU R/[-U 5SS9n U (aA[1U4Sj[3[5XU 555SSS9n [5U 6upTlTlnO:/n[R:"S 5Tl[R:"S 5Tl/nTR<b8UVs/sHnTR<UPM nn[>R@"TUU5 O"[>RB"TUTRD5 [-TR5[-U 5:waTRTlTRFb[[R""S/S/TRF/S //5n[$R&"UTRR(5nUS S$URHS:a[RJ"U5$[RL$s sn fs snf) z, Perform the 3D projection for this object. rr#axisc3># UHKunuup#pEnTRUR5[RR X#/5XVU4v MM g7frB)rdatar$r5r)ridxr6r7r8fcecrGs rr4Poly3DCollection.do_3d_projection..sP;91S0,>x,H"RUV9sAAc US$rRr)r s r3Poly3DCollection.do_3d_projection..sadrT)keyreverserrrrS)'_ArG_face_is_mapped _facecolorsr_edge_is_mappedrmrr`r=rr9rr$r5 masked_wherer,r%r_proj_transform_vecrjrr'repeatsorted enumerater _facecolors2d _edgecolors2demptyrr rrrrrTrrg)rGr6r7r8w_maskedvectxstystzsslxyzlistcfacecedge z_segments_2drridxsrrzvecztranss` rr!Poly3DCollection.do_3d_projection_s 77   & & (##$($4$4!##$($4$4!   &B !AB BJBByyq!Q&55--bggtyy|Deekk22"89eekk22,/))C223 D #9=I2GSWcg.I!!!! u:W %LLWAL6E u:W %5zQ S\ : ";c'%89;#D 2M]# IAD.0BDK!#&!1D !#&!1D D == $3784CT]]3'4E8  . .t[% H  $ $T; E t  !SZ /!%!2!2D  ?? &88aS1#'81#>?D//diikkBF!9Q<  XX\66#; 66McJ<9s ;O1OcZ>[TU]U5 [R"U5UlgrB)rT set_facecolorr rdrrGrrYs rrPoly3DCollection.set_facecolor# f%*88>rcZ>[TU]U5 [R"U5UlgrB)rT set_edgecolorr rnrrs rr Poly3DCollection.set_edgecolorrrc[RRX5 [R"UR UR 5Ul[R"URUR 5Ul SUl g![[[4a NPf=f![[[4a N:f=f)NT) rArtist set_alpharZr[rr\AttributeError TypeError IndexErrorrrmr])rGalphas rr Poly3DCollection.set_alphas ,  ' 5 5!!4;;!0D  &44%%t{{ 4D   :6     :6   s#0B 0B% B"!B"%B=<B=c[US5(d9URR5URlUR 5 [ R "UR5$)Nr)rr9rrjrr$asarrayrrOs rrdPoly3DCollection.get_facecolorJt_--)),,.DIIK  ! ! #zz$,,--rc[US5(d9URR5URlUR 5 [ R "UR5$)Nr)rr9rrjrr$rrrOs rrnPoly3DCollection.get_edgecolorrr)rr`rrrrmrrrrrrrr])Tr)r|r}r~rrrEr$rrrrrr deprecatedrrrrrFrrrr r rdrnrrrs@rrrs(,5E!e<&<&~::vvvv  __V,, C&  L\? ? ...rrc[UR5X5upE[UlUR XE5 UR 5 X0lg)a Convert a `.PolyCollection` into a `.Poly3DCollection` object. Parameters ---------- col : `~matplotlib.collections.PolyCollection` The collection to convert. zs : float or array of floats The location or locations to place the polygons in the collection along the *zdir* axis. Default: 0. zdir : {'x', 'y', 'z'} The axis in which to place the patches. Default: 'z'. See `.get_dir_vector` for a description of the values. N)rrrrYrrFr`)rr8r)rH segments_3drs rpoly_collection_2d_to_3drsB: MMOR'K$CMK/ Orc\US:XaX U4$US:XaXU4$USS:Xa [XX#5$XU4$)z Reorder coordinates so that 2D *xs*, *ys* can be plotted in the plane orthogonal to *zdir*. *zdir* is normally 'x', 'y' or 'z'. However, if *zdir* starts with a '-' it is interpreted as a compensation for `rotate_axes`. r r!r-) rotate_axesr6r7r8r)s rrrsH s{rz rz aC22,,rzrc2US;aXU4$US;aX U4$XU4$)z Reorder coordinates so that the axes are rotated with *zdir* along the original z axis. Prepending the axis with a '-' does the inverse transform, so *zdir* can be 'x', '-x', 'y', '-y', 'z' or '-z'. )r z-y)z-xr!rr s rrrs2  {rz  rzrzrc[U5S:Xd[U5S:Xa[R"S5$[[ U5[ U55nSU"U5S-- n[R "[R"U5[U5S45n[R"USS2SS24USS2S4U-/5$)z7Modify the alphas of the color list according to depth.rrrgffffff?rNr#) r'r$zerosrrrrrZr[r)rr8normsatsrgbas rrYrY s  6{a3r7a<xx SWc"g &D tBx#~ D ??70083r7A, GD ??DBQBKadd):; <T"T"U55$rBr)r in_normout_norms rr$_shade_colors..normsGAJ' 'rrr#)rZ LightSourcer$errstater+r$ directionr)rrinverser[r,rhcopy) colorrrrr,r$rrrIrJs @@rrrps# ))GD X &BIINN7TNJJ(() ' HHUO D xxzz##B*$$S!,44 (e %%e,ad eQ ]+e3q!t  Mu%**, M3 ' &s 0E Er{)rr")rr"TF)g:0yE>rB)?rrknumpyr$ contextlibr matplotlibrrrrrZrr rCr rmatplotlib.collectionsr r r rrmatplotlib.colorsrmatplotlib.patchesrrzrrrr*r=rDr?rLine2Drrrrrrrrrrrrr)r+r/r1rrrrrrrrYr8rrrrrrYs:   %QQ'$  OD+8dUZZdN/$cU\\cL1&   ' ,: , !(~(V!=e=@5'5p:80pPpPfwP~wPt0>W.~W.t!."  =&+R)X#r