6DhbSrSSKrSSKJr SSKJr SSKJr SSjr \ \l "SS\5r g) z Renderer Module This module defines the PlotlyRenderer class and a single function, fig_to_plotly, which is intended to be the main way that user's will interact with the matplotlylib package. N)Renderer)mpltoolsc:U<SU<SUR<SU<S3$)N:z: z: z )__name__)msgcategoryfilenamelinenofilelines N/var/www/html/env/lib/python3.13/site-packages/plotly/matplotlylib/renderer.pywarning_on_one_liners%-vx7H7H# NNc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrg)PlotlyRendereraA renderer class inheriting from base for rendering mpl plots in plotly. A renderer class to be used with an exporter for rendering matplotlib plots in Plotly. This module defines the PlotlyRenderer class which handles the creation of the JSON structures that get sent to plotly. All class attributes available are defined in __init__(). Basic Usage: # (mpl code) # fig = gcf() renderer = PlotlyRenderer(fig) exporter = Exporter(renderer) exporter.run(fig) # ... et voila c[R"5UlSUlSUlSUl/UlSUlSUlSUl SUl SUl g)zInitialize PlotlyRenderer obj. PlotlyRenderer obj is called on by an Exporter object to draw matplotlib objects like figures, axes, text, etc. All class attributes are listed here in the __init__ method. NrF)rzInitialized PlotlyRenderer ) goFigure plotly_figmpl_figcurrent_mpl_axbar_containers current_barsaxis_ct x_is_mpl_date mpl_x_bounds mpl_y_boundsrselfs r__init__PlotlyRenderer.__init__,sV))+ "" """1rc U=RS- slXl[R"[ USUS-5[ USUS-5SSS9UR S'[ R"U5uUlUl [RR[ URS UR SS -5[ S URS - UR SS -5[ S URS - UR SS -5[ URS UR SS -5S S 9nX0R SS'g)aCreates a new figure by beginning to fill out layout dict. The 'autosize' key is set to false so that the figure will mirror sizes set by mpl. The 'hovermode' key controls what shows up when you mouse around a figure in plotly, it's set to show the 'closest' point. Positional agurments: fig -- a matplotlib.figure.Figure object. props.keys(): [ 'figwidth', 'figheight', 'dpi' ] zOpening figure figwidthdpi figheightFclosest)widthheightautosize hovermodelayoutrr*rr+)lrtbpadmarginN) rrrLayoutintrrget_axes_boundsrr r.Margin)r"figpropsr4s r open_figurePlotlyRenderer.open_figure@sO && $&IIeJ'%,67u[)E%L89 % ! 08/G/G/L,4,!!$##A&)B7)KKL1t((++tx/H/QQR1t((++tx/H/RRS$##A&)B8)LLM " /5!(+rcRSURSS'U=RS- slg)aCloses figure by cleaning up data and layout dictionaries. The PlotlyRenderer's job is to create an appropriate set of data and layout dictionaries. When the figure is closed, some cleanup and repair is necessary. This method removes inappropriate dictionary entries, freeing up Plotly to use defaults and best judgements to complete the entries. This method is called by an Exporter object. Positional arguments: fig -- a matplotlib.figure.Figure object. Fr. showlegendzClosing figure N)rr)r"r9s r close_figurePlotlyRenderer.close_figurebs&38!,/ &&rcU=RS- slXlURVs/sH!nURRS:XdMUPM# snUl/UlU=RS- sl[RRSRUR5SSS9n[RRSRUR5SSS9n[R"XURUR S 9upgUR#U5 UR#U5 [R$"US 5n[R$"US 5n [R$"US 5n [R$"US 5n [R&"X5US'[R&"X5US'XS'XS'X@R(SSRUR5'XPR(SSRUR5'S[+U5;aUSS:XaSUlgggs snf)asSetup a new axes object (subplot in plotly). Plotly stores information about subplots in different 'xaxis' and 'yaxis' objects which are numbered. These are just dictionaries included in the layout dictionary. This function takes information from the Exporter, fills in appropriate dictionary entries, and updates the layout dictionary. PlotlyRenderer keeps track of the number of plots by incrementing the axis_ct attribute. Setting the proper plot domain in plotly is a bit tricky. Refer to the documentation for mpltools.convert_x_domain and mpltools.convert_y_domain. Positional arguments: ax -- an mpl axes object. This will become a subplot in plotly. props.keys() -- [ 'axesbg', (background color for axes obj) 'axesbgalpha', (alpha, or opacity for background) 'bounds', ((x0, y0, width, height) for axes) 'dynamic', (zoom/pan-able?) 'axes', (list: [xaxis, yaxis]) 'xscale', (log, linear, or date) 'yscale', 'xlim', (range limits for x) 'ylim', 'xdomain' (xdomain=xlim, unless it's a date) 'ydomain' ] z Opening axes BarContainerry{0}Finside)anchorzerolineticksx{0})axr:x_boundsy_boundsbottomtopleftrightmirrorshowliner.xaxis{0}yaxis{0}typedateTN)rr containers __class__rrrrrr.XAxisformatYAxisr prep_xy_axisrr updateget_spine_visibleget_axis_mirrorrdirr) r"rIr:cxaxisyaxis mpl_xaxis mpl_yaxis bottom_spine top_spine left_spine right_spines r open_axesPlotlyRenderer.open_axesrs> && ]] "{{##~5 "     ==.h   ==.h   (44):):TEVEV    Y Y11"h? ..r59 //F; 00W= "22<Kh"22:Kh(j%jFK!*"3"3DLL"ABEJ!*"3"3DLL"AB SZ E&MV$;!%D %< G s I IcrURUR5 U=RS- slSUlg)aHClose the axes object and clean up. Bars from bar charts are given to PlotlyRenderer one-by-one, thus they need to be taken care of at the close of each axes object. The self.current_bars variable should be empty unless a bar chart has been created. Positional arguments: ax -- an mpl axes object, not required at this time. z Closing axes FN) draw_barsrrr)r"rIs r close_axesPlotlyRenderer.close_axess- t(() &&"rc/nURH:nURURVs/sHnUSU;dMUPM sn5 M< UHnURU5 M gs snf)Nmplobj)rappendrdraw_bar)r"bars mpl_traces container bar_propstraces rrlPlotlyRenderer.draw_barsst ,,I   &*%6%6%6  *i7%6 - E MM%  s A( A( cv ^^^SnUVs/sHn[R"S$0UD6PM nnUVs/sH o3SUS- PM snmUVs/sH o3SUS- PM snm[[U4Sj[ [ T55555U:n[[U4Sj[ [ T55555U:nU(aQU(aJUVs/sHo3SPM snm[ U4Sj[ [ TS S 5555(aS nOS nO U(aS nOS nUS :XGaU=RS - slUVs/sHo3SPM nnUHn SU SU S- sU S'U S'M UVs/sHo3SPM n n[X5H<up[X- 5U:dMSURSS'SURSS'M> UV s/sHoSU SU S- S- -PM n n UV s/sHoSPM nn [R"UV s/sHoSPM sn UV s/sHoSPM sn 5nUR(agUV s/sHoSPM n n URR5R5RR n[R""U U5n GOU=RS- slUVs/sHo3SPM nnUHn SU SU S- sU S'U S'M UVs/sHo3SPM nn[UU5H<up[X- 5U:dMSURSS'SURSS'M> UV s/sHoSPM n n UV s/sHoSU SU S- S- -PM nn [R"UV s/sHoSPM sn UV s/sHoSPM sn 5n[$R&"UU USR)UR*5SR)UR*5USS[$R,R/USS[1USSS9S9S9n [ U S5S:aGU=RS - slURR3U 54 UbXRSS!'g g U=RS"- sl[4R6"S#5 g s snfs snfs snfs snfs snfs snfs sn fs sn fs sn fs sn fs sn fs snfs snfs sn fs sn fs sn fs sn f)%aiDraw a collection of similar patches as a bar chart. After bars are sorted, an appropriate data dictionary must be created to tell plotly about this data. Just like draw_line or draw_markers, draw_bar translates patch/path information into something plotly understands. Positional arguments: patch_coll -- a collection of patches to be drawn as a bar chart. g|=x1x0y1y0c3:># UHnTSTU- v M g7frN).0iiiwidthss r *PlotlyRenderer.draw_bar..s Q>Ps6!9vc{2>Pc3:># UHnTSTU- v M g7frr)rrheightss rrrs M9L#GAJ-9Lrc3@># UHnTUS-TU:v M g7f)rNr)rrx_zeross rrrs%UPQQRUXX Ms7|9LMM NQT T   8=>9>GUE#gcrlBSC';BDOOH-i8=@DOOH-k::EJJESTc$i#d)3q88EAJ&+,esTeA,**&+,esTe,E.JES4yE.JG!!*/0%3Y%0''113((*Yxx 55aC HHI IH;@A5iD/5JA'(#d)c$i*?$D 3t9;@A5iD/5JA J7sy>C';BDOOH-i8=@DOOH-k:8',,esTeA,DIJESTc$i#d)3q88EAJ**&+,esTe,E.JES4yE.JGff#-- --- -!HW%66==Ah{+a 56!   s3x=1  HH@ @H OO % %c * +"6=)(3# HH3 3H MM: _GKL?CC K,,.J1BB -J,.Jsd S&S+ S0S5 S:=S?T?T #T7T !TTT"0T'T,7T1 T6 c URS5GHnUSSSnUSSSnUS:XGa URS5(aURSS5nURS 5nSn Sn Un Un USRS 5n U cUS :waU=RS - sl g SR [ U SU S5VVs/sHupUSUSSUS3PM snn5nUS :XaS nS nU*S- n US- n US- n XwS- -n OSn[ RR"SUSSU U U U SSUUUS. UD6nOdUS:XaGSnUSSSn USSSn [ RR"SUSSUUS-U U S-S.UD6nOU=RS- sl g URRU5 U=RS- slGM g s snnf)zCreate a shape that matches lines or markers in legends. Main issue is that path for circles do not render, so we have to use 'circle' instead of 'path'. +datarrmarkers markerstylesizesymbol markerpathNcirclez8not sure how to handle this marker without a valid path  ,rpathpaperpixel) rTxrefyrefr{r}rzr| xsizemode ysizemodexanchoryanchorrlinesr g{Gz?)rTrrr{r}rzr|z$not sure how to handle this element z! Heck yeah, I drew that shape r) splitgetpoprjoinrrr.Shaper add_shape)r"modeshaper: single_moderrrrr{r}rzr|rar1r shape_type legend_shapes rdraw_legend_shapes!PlotlyRenderer.draw_legend_shapes9sD  ::c?Kf a #Af a #Ai'EIIm,D,Dyy+8,"=155lC %&H*<HHSHxx69*Q-TU6WX6Wdas!AaD61Q4&)6WXX% D!)JBBBqB"(J!yy #  %%   '6]1%a(6]1%a(!yy   4xDy   CC OO % %l 3 HH< [R"W[US[5(a[US5OUSUS Vs/sHowSPM snUS Vs/sHowSPM snSRUR5SRUR5UUS9nUR(aYUR R#5R%5R&R(n [R*"US U 5US 'UR,R/U54 U=RS!- slg&US S":XaUR0"S'WUS#.UD6 g&U=RS$- sl[2R4"S%5 g&s snfs snf)(aCreate a data dict for a line obj. This will draw 'lines', 'markers', or 'lines+markers'. For legend elements, this will use layout.shapes, so they can be positioned with paper refs. props.keys() -- [ 'coordinates', ('data', 'axes', 'figure', or 'display') 'data', (a list of xy pairs) 'mplobj', (the matplotlib.lines.Line2D obj being rendered) 'label', (the name of the Line2D obj being rendered) 'linestyle', (linestyle dict, can be None, see below) 'markerstyle', (markerstyle dict, can be None, see below) ] props['linestyle'].keys() -- [ 'alpha', (opacity of Line2D obj) 'color', (color of the line if it exists, not the marker) 'linewidth', 'dasharray', (code for linestyle, see DASH_MAP in mpltools.py) 'zorder', (viewing precedence when stacked with other objects) ] props['markerstyle'].keys() -- [ 'alpha', (opacity of Line2D obj) 'marker', (the mpl marker symbol, see SYMBOL_MAP in mpltools.py) 'facecolor', (color of the marker face) 'edgecolor', (color of the marker edge) 'edgewidth', (width of marker edge) 'markerpath', (an SVG path for drawing the specified marker) 'zorder', (viewing precedence when stacked with other objects) ] z Attempting to draw a line linestylerz... with both lines+markers z lines+markersz... with just lines rz... with just markers rrr coordinatesr linewidth dasharray)rr*dash)r rr markersize edgecolorr)rr*)rrrrr )r fillcolorrrr labelrrrHrC)rnamerrrarbr rrz Heck yeah, I drew that line axes)rrz5 Line didn't have 'data' coordinates, not drawing zeBummer! Plotly can currently only draw Line2D objects from matplotlib that are in 'data' coordinates!Nr)rrmerge_color_and_opacityrscatterLine convert_dashrrconvert_symbolScatter isinstancestrrYrrrrrrWrrrrrrr) r"r:r rrrrxy_pair marked_liners rdraw_marked_linePlotlyRenderer.draw_marked_linesD 44 "be  % "6 HH7 7H"D ;  HH/ /HD = ! HH1 1HD  44k"7+U;-?-HE]#v-zz ,[9!..u[/A+/NO' ##K0=%2253Ek3RS  ]#v-**!-09 .{;#2253G3QR}-l;#M2;?#M2;? + !-09#M2;?#2253G3QR}-l;#M2;?#M2;?   6 )**"%.#66g'w-26];]'1:];-26];]'1:];mmDLL1mmDLL1 K!!''113((*Yxx $,#D#D$i$ C  OO % %k 2 3 HH; ;H = !V +  # # DU De D HHS SH MM /<;s N N c U=RS- slU=RS- sl[R"S5 g)z#Draw image. Not implemented yet! z Attempting to draw image z Not drawing image zoAw. Snap! You're gonna have to hold off on the selfies for now. Plotly can't import images from matplotlib yet!N)rrr)r"r:s r draw_imagePlotlyRenderer.draw_images3 44 --  * rc (U=RS- slUSS:XaI[R"U5nSUSSUSS.nU=RS- slUR"S 0UD6 gU=RS- sl[R "S 5 g) aAdd a path collection to data list as a scatter plot. Current implementation defaults such collections as scatter plots. Matplotlib supports collections that have many of the same parameters in common like color, size, path, etc. However, they needn't all be the same. Plotly does not currently support such functionality and therefore, the style for the first object is taken and used to define the remaining paths in the collection. props.keys() -- [ 'paths', (structure: [vertices, path_code]) 'path_coordinates', ('data', 'axes', 'figure', or 'display') 'path_transforms', (mpl transform, including Affine2D matrix) 'offsets', (offset from axes, helpful if in 'data') 'offset_coordinates', ('data', 'axes', 'figure', or 'display') 'offset_order', 'styles', (style dict, see below) 'mplobj' (the collection obj being drawn) ] props['styles'].keys() -- [ 'linewidth', (one or more linewidths) 'facecolor', (one or more facecolors for path) 'edgecolor', (one or more edgecolors for path) 'alpha', (one or more opacites for path) 'zorder', (precedence when stacked) ] z) Attempting to draw a path collection offset_coordinatesroffsetsN)rrrrrz' Drawing path collection as markers z6 Path collection not linked to 'data', not drawing zDang! That path collection is out of this world. I totally don't know what to do with it yet! Plotly can only import path collections linked to 'data' coordinatesr)rrget_markerstyle_from_collectionrrr)r"r:r scatter_propss rdraw_path_collection#PlotlyRenderer.draw_path_collections< @@ % && 0"BB5IK%i(*! M HHB BH  ! ! 2M 2 HHT TH MM; rc U=RS- sl[R"URR40UD6nU(aU=R U/- slgU=RS- sl[ R"S5 g)aDraw path, currently only attempts to draw bar charts. This function attempts to sort a given path into a collection of horizontal or vertical bar charts. Most of the actual code takes place in functions from mpltools.py. props.keys() -- [ 'data', (a list of verticies for the path) 'coordinates', ('data', 'axes', 'figure', or 'display') 'pathcodes', (code for the path, structure: ['M', 'L', 'Z', etc.]) 'style', (style dict, see below) 'mplobj' (the mpl path object) ] props['style'].keys() -- [ 'alpha', (opacity of path obj) 'edgecolor', 'facecolor', 'edgewidth', 'dasharray', (style for path's enclosing line) 'zorder' (precedence of obj when stacked) ] z Attempting to draw a path z' This path isn't a bar, not drawing zJI found a path object that I don't think is part of a bar chart. Ignoring.N)rris_barrrVrrr)r"r:rs r draw_pathPlotlyRenderer.draw_pathCsh2 55!4!4!?!?I5I    % (  HHB BH MM, rc U=RS- sl[R"USUR5(d[R "S5 USR nU(dUSSnSURS;a/URSS'USS :Xa(U=RS - slUR"S(0UD6 g'USS :Xa(U=RS - slUR"S(0UD6 g'USS :Xa(U=RS- slUR"S(0UD6 g'U=RS- slUSS:waU=RS- slUSR5RUS5up4[R"X4URS5upVSnSnUSSn [R"USS5n GOcU=RS- slUSupVURn URSSR!U 5n URSSR!U 5n U SSUs=:a U SS:aVO OSU SSUs=:a U SS:a:O O7SR!UR5nSR!UR5nOfU=RS- slUSR5RUS5up4[R"X4URS5upVSnSnUSSn [R"USS5n ["R$R'[)US[*5(a[+US5OUSUSS UUUUUU U S!["R$R,R/USS"USS#S$9S%9 nURSS==U4- ss'U=RS&- slg'))aCreate an annotation dict for a text obj. Currently, plotly uses either 'page' or 'data' to reference annotation locations. These refer to 'display' and 'data', respectively for the 'coordinates' key used in the Exporter. Appropriate measures are taken to transform text locations to reference one of these two options. props.keys() -- [ 'text', (actual content string, not the text obj) 'position', (an x, y pair, not an mpl Bbox) 'coordinates', ('data', 'axes', 'figure', 'display') 'text_type', ('title', 'xlabel', or 'ylabel') 'style', (style dict, see below) 'mplobj' (actual mpl text object) ] props['style'].keys() -- [ 'alpha', (opacity of text) 'fontsize', (size in points of text) 'color', (hex color) 'halign', (horizontal alignment, 'left', 'center', or 'right') 'valign', (vertical alignment, 'baseline', 'center', or 'top') 'rotation', 'zorder', (precedence of text when stacked with other objs) ] z* Attempting to draw an mpl text object rpaULooks like the annotation(s) you are trying to draw lies/lay outside the given figure size. Therefore, the resulting Plotly figure may not be large enough to view the full text. To adjust the size of the figure, use the 'width' and 'height' keys in the Layout object. Alternatively, use the Margin object to adjust the figure's margins.stylehalign annotationsr. text_typexlabelz Text object is an xlabel ylabelz Text object is a ylabel titlez Text object is a title z) Text object is a normal annotation rrz7 Text object isn't linked to 'data' coordinates positionrvalignz4 Text object is linked to 'data' coordinates rRrSrrrrHrCzL Text object is outside plotting area, making 'paper' reference. textrFrfontsizerr) rrrrrralignrr showarrowfontz& Heck, yeah I drew that annotation Nr)rr check_cornersrrr_multialignmentr draw_xlabel draw_ylabel draw_title get_transform transformdisplay_to_paper convert_varrYrr. Annotationrr annotationFont)r"r:rx_pxy_pxrrrrrrrrarbrs r draw_textPlotlyRenderer.draw_textgs: AA%%eHot||DD MMH h//'N8,E  9 979DOOH %m 4   ) HH: :H    %u % ; 8 + HH9 9H    %u % ; 7 * HH8 8H OO $e $ HHD DH]#v-Q(O113==eJ>OP 00T__X=VW.2"--eGnX.FGVVZ(,,1*2C2CG2LM1*2C2CG2LM'N1%=E'N1,==gq)AAgq0AA!==6D!==6DHHEH h557AA% BSTD$44DOOH$=DA#D"D.2"--eGnX.FG--"%-55f &vgw/YY))...1gz8R/.J& OOH %m 4 E 4 HHA AHrc U=RS- sl[URR5S:aU=RS- slUSR 5R US5up#[ R"X#URS5upE[RRUS[RRRUSS USS S 9S S UUS SSS9 nURSS==U4- ss'gU=RS- slUSURSS'[USS USS S9nXpRSS'g)a6Add a title to the current subplot in layout dictionary. If there exists more than a single plot in the figure, titles revert to 'page'-referenced annotations. props.keys() -- [ 'text', (actual content string, not the text obj) 'position', (an x, y pair, not an mpl Bbox) 'coordinates', ('data', 'axes', 'figure', 'display') 'text_type', ('title', 'xlabel', or 'ylabel') 'style', (style dict, see below) 'mplobj' (actual mpl text object) ] props['style'].keys() -- [ 'alpha', (opacity of text) 'fontsize', (size in points of text) 'color', (hex color) 'halign', (horizontal alignment, 'left', 'center', or 'right') 'valign', (vertical alignment, 'baseline', 'center', or 'top') 'rotation', 'zorder', (precedence of text when stacked with other objs) ] z# Attempting to draw a title rz< More than one subplot, adding title as annotation rpr r.rrrrrrcenterrLF) rrrrrrrrrrz; Only one subplot found, adding as a plotly title r rr title_fontN)rrrrrrrrrrr.rrrr)r"r:r r!rrrr's rrPlotlyRenderer.draw_titlese4 :: t||  !A % HHR Hx668BB5CTUJD,,T9RSDA--6]YY))...1gz8R/  . J OOH %m 4 E 4 HHQ H27vDOOH %g .7^J/uW~g7NJ7AOOH %l 3rc U=RS- slSRUR5n[US5URSUS'[ USSUSSS 9nX0RSUS 'g ) aAdd an xaxis label to the current subplot in layout dictionary. props.keys() -- [ 'text', (actual content string, not the text obj) 'position', (an x, y pair, not an mpl Bbox) 'coordinates', ('data', 'axes', 'figure', 'display') 'text_type', ('title', 'xlabel', or 'ylabel') 'style', (style dict, see below) 'mplobj' (actual mpl text object) ] props['style'].keys() -- [ 'alpha', (opacity of text) 'fontsize', (size in points of text) 'color', (hex color) 'halign', (horizontal alignment, 'left', 'center', or 'right') 'valign', (vertical alignment, 'baseline', 'center', or 'top') 'rotation', 'zorder', (precedence of text when stacked with other objs) ] z Adding xlabel rRrr.r rrrr&r'N)rrYrrrrr"r:axis_keyr's rrPlotlyRenderer.draw_xlabels. --$$T\\27:5=7I!(+G4w +5>'3J =G!(+L9rc U=RS- slSRUR5nUSURSUS'[ USSUSSS 9nX0RSUS 'g ) aAdd a yaxis label to the current subplot in layout dictionary. props.keys() -- [ 'text', (actual content string, not the text obj) 'position', (an x, y pair, not an mpl Bbox) 'coordinates', ('data', 'axes', 'figure', 'display') 'text_type', ('title', 'xlabel', or 'ylabel') 'style', (style dict, see below) 'mplobj' (actual mpl text object) ] props['style'].keys() -- [ 'alpha', (opacity of text) 'fontsize', (size in points of text) 'color', (hex color) 'halign', (horizontal alignment, 'left', 'center', or 'right') 'valign', (vertical alignment, 'baseline', 'center', or 'top') 'rotation', 'zorder', (precedence of text when stacked with other objs) ] z Adding ylabel rSrr.r rrrr&r'N)rrYrrrr*s rrPlotlyRenderer.draw_ylabel4s}. --$$T\\27'3J =G!(+L9rcU=RS- slSHnURSU M g![[4a M,f=f)a!Revert figure layout to allow plotly to resize. By default, PlotlyRenderer tries its hardest to precisely mimic an mpl figure. However, plotly is pretty good with aesthetics. By running PlotlyRenderer.resize(), layout parameters are deleted. This lets plotly choose them instead of mpl. z+Resizing figure, deleting keys from layout )r*r+r,r4r.N)rrKeyErrorAttributeError)r"keys rresizePlotlyRenderer.resizeSsL BBG> Crr)NN) r;rplotly.graph_objs graph_objsrplotly.matplotlylib.mplexporterrplotly.matplotlylibrr formatwarningrrrrrBs84(O-K CXK Cr