hip3dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddlmZmZdd lmZGd d eZGd d eZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZdZGdd eZd!S)"zPlot-related objects. A plot is known as a chart group in the MS API. A chart can have more than one plot overlayed on each other, such as a line plot layered over a bar plot. ) annotations) Categories) DataLabels)SeriesCollection) XL_CHART_TYPE)qn) ST_BarDir ST_Grouping) lazypropertyceZdZdZfdZedZedZedZ edZ e j dZ edZ ed Z e j d Z xZS) _BasePlotz A distinct plot that appears in the plot area of a chart. A chart may have more than one plot, in which case they appear as superimposed layers, such as a line plot appearing on top of a bar chart. crtt|||_||_dSN)superr __init___element_chart)selfxChartchart __class__s g/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/chart/plot.pyrz_BasePlot.__init__s1 i'')))  c*t|jS)a Returns a |category.Categories| sequence object containing a |category.Category| object for each of the category labels associated with this plot. The |category.Category| class derives from ``str``, so the returned value can be treated as a simple sequence of strings for the common case where all you need is the labels in the order they appear on the chart. |category.Categories| provides additional properties for dealing with hierarchical categories when required. )rrrs r categoriesz_BasePlot.categoriess$-(((rc|jS)z: The |Chart| object containing this plot. )rrs rrz_BasePlot.chart,s {rcZ|jj}|tdt|S)z |DataLabels| instance providing properties and methods on the collection of data labels associated with this plot. Nz9plot has no data labels, set has_data_labels = True first)rdLbls ValueErrorr)rrs r data_labelsz_BasePlot.data_labels3s0  # =XYY Y%   rc|jjduS)z Read/write boolean, |True| if the series has data labels. Assigning |True| causes data labels to be added to the plot. Assigning False removes any existing data labels. N)rrrs rhas_data_labelsz_BasePlot.has_data_labels>s}"$..rct|dur|jdS|jj'|j}d|j_dSdS)aZ Add, remove, or leave alone the ```` child element depending on current state and assigned *value*. If *value* is |True| and no ```` element is present, a new default element is added with default child elements and settings. When |False|, any existing dLbls element is removed. FNT)boolr _remove_dLblsr _add_dLblsshowValval)rvaluers rr#z_BasePlot.has_data_labelsGse ;;%   M ' ' ) ) ) ) )}"* 0022$( !!!+*rc*t|jS)z A sequence of |Series| objects representing the series in this plot, in the order they appear in the plot. )rrrs rseriesz_BasePlot.seriesWs   ...rc0|jj}|dS|jS)a Read/write boolean value specifying whether to use a different color for each of the points in this plot. Only effective when there is a single series; PowerPoint automatically varies color by series when more than one series is present. NT)r varyColorsr))rr.s rvary_by_categoriesz_BasePlot.vary_by_categories_s!]-  4~rc\t||j_dSr)r%rget_or_add_varyColorsr)rr*s rr/z_BasePlot.vary_by_categoriesls$48KK ++--111r)__name__ __module__ __qualname____doc__rr rpropertyrr!r#setterr,r/ __classcell__)rs@rr r s)   ) )\ )X !!X!//X/ ) ) )//\/  X @@@@@@@rr ceZdZdZdS)AreaPlotz An area plot. Nr3r4r5r6rrr;r;qrr;ceZdZdZdS) Area3DPlotz$ A 3-dimensional area plot. Nr<r=rrr@r@wr>rr@c~eZdZdZedZejdZedZejdZdS)BarPlotz! A bar chart-style plot. c0|jj}|dS|jS)z Width of gap between bar(s) of each category, as an integer percentage of the bar width. The default value for a new bar chart is 150, representing 150% or 1.5 times the width of a single bar. N)rgapWidthr))rrEs r gap_widthzBarPlot.gap_widths!=)  3|rcF|j}||_dSr)rget_or_add_gapWidthr))rr*rEs rrFzBarPlot.gap_widths =4466 rc0|jj}|dS|jS)a Read/write int value in range -100..100 specifying a percentage of the bar width by which to overlap adjacent bars in a multi-series bar chart. Default is 0. A setting of -100 creates a gap of a full bar width and a setting of 100 causes all the bars in a category to be superimposed. A stacked bar plot has overlap of 100 by default. Nr)roverlapr))rrJs rrJzBarPlot.overlaps -' ?1{rc|dkr|jdS||j_dS)z Set the value of the ```` child element to *int_value*, or remove the overlap element if *int_value* is 0. rN)r_remove_overlapget_or_add_overlapr)r2s rrJzBarPlot.overlapsB A:: M ) ) + + + F16 ((**...rN)r3r4r5r6r7rFr8rJr=rrrBrB}s  X   X  ^77^777rrBcHeZdZdZedZejdZdS) BubblePlotz A bubble chart plot. c0|jj}|dS|jS)z An integer between 0 and 300 inclusive indicating the percentage of the default size at which bubbles should be displayed. Assigning |None| produces the same behavior as assigning `100`. Nd)r bubbleScaler))rrRs r bubble_scalezBubblePlot.bubble_scales!m/  3rcz|j}||dS|}||_dSr)r_remove_bubbleScale_add_bubbleScaler))rr* bubbleChartrRs rrSzBubblePlot.bubble_scalesAm ''))) = F!2244  rN)r3r4r5r6r7rSr8r=rrrOrOsX  X      rrOceZdZdZdS) DoughnutPlotz An doughnut plot. Nr<r=rrrYrYr>rrYceZdZdZdS)LinePlotz" A line chart-style plot. Nr<r=rrr[r[r>rr[ceZdZdZdS)PiePlotz! A pie chart-style plot. Nr<r=rrr]r]r>rr]ceZdZdZdS) RadarPlotz A radar-style plot. Nr<r=rrr_r_r>rr_ceZdZdZdS)XyPlotz An XY (scatter) plot. Nr<r=rrrarar>rrac tdttdttdttdttdt tdt tdttdttd ti |j }n%#t$rtd |j zwxYw|||S) zk Return an instance of the appropriate subclass of _BasePlot based on the tagname of *xChart*. z c:areaChartz c:area3DChartz c:barChartz c:bubbleChartzc:doughnutChartz c:lineChartz c:pieChartz c:radarChartzc:scatterChartzunsupported plot type %s) rr;r@rBrOrYr[r]r_ratagKeyErrorr )rrPlotClss r PlotFactoryrfs B }  x    |  g     ! !< }  x |  g ~    &   *  BBB3fj@AAAB 765 ! !!s CC"C&ceZdZdZedZedZedZedZedZ edZ edZ ed Z ed Z ed Zd S) PlotTypeInspectorz "One-shot" service object that knows how to identify the type of a plot as a member of the XL_CHART_TYPE enumeration. c  |j|j|j|j|j|j|j|j|jd |j j }n*#t$rtd|j j zwxYw||S)zo Return the member of :ref:`XlChartType` that corresponds to the chart type of *plot*. ) r;r@rBrOrYr[r]r_raz#chart_type() not implemented for %s) _differentiate_area_chart_type!_differentiate_area_3d_chart_type_differentiate_bar_chart_type _differentiate_bubble_chart_type"_differentiate_doughnut_chart_type_differentiate_line_chart_type_differentiate_pie_chart_type_differentiate_radar_chart_type_differentiate_xy_chart_typerr3rdNotImplementedError)clsplotchart_type_methods r chart_typezPlotTypeInspector.chart_types  >!C<!B # F>< @: ! !n% !'     %58OO  ! &&&s A A 'A3ctjtjtjtjtjtji|jj Sr) r STANDARDXL THREE_D_AREASTACKEDTHREE_D_AREA_STACKEDPERCENT_STACKEDTHREE_D_AREA_STACKED_100r grouping_valrtrus rrkz3PlotTypeInspector._differentiate_area_3d_chart_types=  "/  !8  ')D  - $ & &rctjtjtjtjtjtji|jj Sr) r ryrzAREAr| AREA_STACKEDr~AREA_STACKED_100rrrs rrjz0PlotTypeInspector._differentiate_area_chart_type#s<  "'    ')<  - $ & &rc|j}|jjtjkrOt jtjt j tj t j tj i|j S|jjtjkrOt jtjt j tjt j tji|j St%d|jjz)Nz"invalid barChart.barDir value '%s')rbarDirr)r BARr CLUSTEREDrz BAR_CLUSTEREDr| BAR_STACKEDr~BAR_STACKED_100rCOLCOLUMN_CLUSTEREDCOLUMN_STACKEDCOLUMN_STACKED_100r )rtrubarCharts rrlz/PlotTypeInspector._differentiate_bar_chart_type+s= ? )- / /%r'7#R^+R-?# % % ? )- / /%r':#R%6+R-B# % % =@SSTTTrcd}|j}||}| tjS|jr tjStjS)NcD|d}|r|dndS)Nzc:ser/c:bubble3Drxpath)rWresultss rfirst_bubble3DzJPlotTypeInspector._differentiate_bubble_chart_type..first_bubble3D>s)!''(:;;G!(271::d 2r)rrzBUBBLEr)BUBBLE_THREE_D_EFFECT)rtrurrWbubble3Ds rrmz2PlotTypeInspector._differentiate_bubble_chart_type<sR 3 3 3m !>+..  9  < ,+ +yrcn|j}|d}|r tjn tjSNz./c:ser/c:explosion)rrrzDOUGHNUT_EXPLODEDDOUGHNUT)rtru doughnutChart explosions rrnz4PlotTypeInspector._differentiate_doughnut_chart_typeKs2 !''(=>> '0Ar##bkArc|jfd}|rTtjtjtjtjtjtji|jj Stjtj tjtj tjtj i|jj S)Nc:d}|rdSdS)Nz$c:ser/c:marker/c:symbol[@val="none"]FTr)matches lineCharts rhas_line_markerszJPlotTypeInspector._differentiate_line_chart_type..has_line_markersUs'oo&LMMG u4r) rr ryrz LINE_MARKERSr|LINE_MARKERS_STACKEDr~LINE_MARKERS_STACKED_100rLINE LINE_STACKEDLINE_STACKED_100)rtrurrs @rroz0PlotTypeInspector._differentiate_line_chart_typeQsM           *$bo#R%<+R-Hm( * *$bg#R_+R-@m( * *rcn|j}|d}|r tjn tjSr)rrrz PIE_EXPLODEDPIE)rtrupieChartrs rrpz/PlotTypeInspector._differentiate_pie_chart_typehs.=NN#899 "+7r7rc|jddd}fd}| tjS|dkr tjS|r tjStjS)Nz c:radarStylerr)cxd}|r!|dddkrdSdSNzc:ser/c:marker/c:symbolrr)noneTFrget)r radarCharts r noMarkerszDPlotTypeInspector._differentiate_radar_chart_type..noMarkersssC &&'@AAG 71:>>%00F::t5rfilled)rrrrzRADAR RADAR_FILLED RADAR_MARKERS)rtru radar_stylerrs @rrqz1PlotTypeInspector._differentiate_radar_chart_typens]  &&~66q9==eDD        8O ( " "? " 9;; 8Orcf|jfd}fd}ddd}|dkr8|r tjS|r tjStjS|dkr"|r tjStjStjS)NcHtdS)Nzc:ser/c:spPr/a:ln/a:noFill)r%r) scatterChartsrnoLinez>PlotTypeInspector._differentiate_xy_chart_type..noLines  **+GHHII Ircxd}|r!|dddkrdSdSrr)symbolsrs rrzAPlotTypeInspector._differentiate_xy_chart_type..noMarkerssC"(()BCCG 71:>>%00F::t5rzc:scatterStylerr) lineMarker smoothMarker) rrrrz XY_SCATTERXY_SCATTER_LINES_NO_MARKERSXY_SCATTER_LINESXY_SCATTER_SMOOTH_NO_MARKERSXY_SCATTER_SMOOTH)rtrurr scatter_stylers @rrrz.PlotTypeInspector._differentiate_xy_chart_types}  J J J J J      %**+;<rs #"""""******++++++......//////88888888""""""\@\@\@\@\@\@\@\@~y  -7-7-7-7-7i-7-7-7`        69 y i   Y """.__________r