o 7hp3@s$dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddlmZmZdd lmZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZddZGd d!d!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) lazypropertycseZdZdZfddZeddZeddZedd Z ed d Z e j d d Z ed dZ eddZ e j ddZ ZS) _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. cstt|||_||_dSN)superr __init___element_chart)selfxChartchart __class__W/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/chart/plot.pyrs z_BasePlot.__init__cC 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. )rrrrrr categoriess z_BasePlot.categoriescCs|jS)z: The |Chart| object containing this plot. )rrrrrr,sz_BasePlot.chartcCs |jj}|dur 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)rrrrr data_labels3sz_BasePlot.data_labelscCs |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)rrrrrrhas_data_labels>s z_BasePlot.has_data_labelscCs@t|dur |jdS|jjdur|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)rvaluerrrrrGs    cCr)z A sequence of |Series| objects representing the series in this plot, in the order they appear in the plot. )rrrrrrseriesWs z_BasePlot.seriescC|jj}|dur 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'rrrvary_by_categories_sz_BasePlot.vary_by_categoriescCst||j_dSr )rrget_or_add_varyColorsr#rr$rrrr(ls)__name__ __module__ __qualname____doc__rr rpropertyrrrsetterr%r( __classcell__rrrrr s&         r c@eZdZdZdS)AreaPlotz An area plot. Nr+r,r-r.rrrrr3qr3c@r2) Area3DPlotz$ A 3-dimensional area plot. Nr4rrrrr6wr5r6c@sDeZdZdZeddZejddZeddZejddZdS) BarPlotz! A bar chart-style plot. cCr&)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#)rr9rrr gap_widthzBarPlot.gap_widthcCs|j}||_dSr )rget_or_add_gapWidthr#)rr$r9rrrr:s  cCr&)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#)rr=rrrr=s zBarPlot.overlapcCs&|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#r*rrrr=s N)r+r,r-r.r/r:r0r=rrrrr7}s    r7c@s*eZdZdZeddZejddZdS) BubblePlotz A bubble chart plot. cCr&)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#)rrBrrr bubble_scaler;zBubblePlot.bubble_scalecCs,|j}||dur dS|}||_dSr )r_remove_bubbleScale_add_bubbleScaler#)rr$ bubbleChartrBrrrrCs  N)r+r,r-r.r/rCr0rrrrr@s   r@c@r2) DoughnutPlotz An doughnut plot. Nr4rrrrrGr5rGc@r2)LinePlotz" A line chart-style plot. Nr4rrrrrHr5rHc@r2)PiePlotz! A pie chart-style plot. Nr4rrrrrIr5rIc@r2) RadarPlotz A radar-style plot. Nr4rrrrrJr5rJc@r2)XyPlotz An XY (scatter) plot. Nr4rrrrrKr5rKcCs~z+tdttdttdttdttdttdttdttdttd t i |j }Wnt y9t d |j w|||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) rr3r6r7r@rGrHrIrJrKtagKeyErrorr)rrZPlotClsrrr PlotFactorys"   rNc@seZdZdZeddZeddZeddZedd Zed d Z ed d Z eddZ eddZ eddZ eddZdS)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 Cs\z|j|j|j|j|j|j|j|j|jd |j j }W||St y-t d|j j w)zo Return the member of :ref:`XlChartType` that corresponds to the chart type of *plot*. ) r3r6r7r@rGrHrIrJrKz#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_typerr+rMNotImplementedError)clsplotZchart_type_methodrrr chart_types&   zPlotTypeInspector.chart_typecC$tjtjtjtjtjtji|jj Sr ) r STANDARDXL THREE_D_AREASTACKEDTHREE_D_AREA_STACKEDPERCENT_STACKEDTHREE_D_AREA_STACKED_100r grouping_valrZr[rrrrQ z3PlotTypeInspector._differentiate_area_3d_chart_typecCr]r ) r r^r_AREAra AREA_STACKEDrcAREA_STACKED_100rrerfrrrrP#rgz0PlotTypeInspector._differentiate_area_chart_typecCsv|j}|jjtjkrtjtjtj tj tj tj i|j S|jjtjkr3tjtjtj tjtj tji|j Std|jj)Nz"invalid barChart.barDir value '%s')rbarDirr#rBARr CLUSTEREDr_ BAR_CLUSTEREDra BAR_STACKEDrcBAR_STACKED_100reCOLCOLUMN_CLUSTEREDCOLUMN_STACKEDCOLUMN_STACKED_100r)rZr[ZbarChartrrrrR+s z/PlotTypeInspector._differentiate_bar_chart_typecCs6dd}|j}||}|durtjS|jrtjStjS)NcSs|d}|r |dSdS)Nzc:ser/c:bubble3Drxpath)rFresultsrrrfirst_bubble3D>s zJPlotTypeInspector._differentiate_bubble_chart_type..first_bubble3D)rr_BUBBLEr#BUBBLE_THREE_D_EFFECT)rZr[rxrFbubble3DrrrrS<sz2PlotTypeInspector._differentiate_bubble_chart_typecC |j}|d}|r tjStjSNz./c:ser/c:explosion)rrvr_DOUGHNUT_EXPLODEDDOUGHNUT)rZr[Z doughnutChart explosionrrrrTK z4PlotTypeInspector._differentiate_doughnut_chart_typecs`|jfdd}|rtjtjtjtjtjtji|jj Stjtj tjtj tjtj i|jj S)Ncsd}|r dSdS)Nz$c:ser/c:marker/c:symbol[@val="none"]FTrumatchesZ lineChartrrhas_line_markersUs zJPlotTypeInspector._differentiate_line_chart_type..has_line_markers) rr r^r_ LINE_MARKERSraLINE_MARKERS_STACKEDrcLINE_MARKERS_STACKED_100reLINE LINE_STACKEDLINE_STACKED_100)rZr[rrrrrUQs z0PlotTypeInspector._differentiate_line_chart_typecCr|r})rrvr_ PIE_EXPLODEDPIE)rZr[ZpieChartrrrrrVhrz/PlotTypeInspector._differentiate_pie_chart_typecsT|jddd}fdd}|durtjS|dkr!tjS|r'tjStjS)Nz c:radarStylerr#c(d}|r|dddkrdSdSNzc:ser/c:marker/c:symbolrr#noneTFrvgetrZ radarChartrr noMarkerss zDPlotTypeInspector._differentiate_radar_chart_type..noMarkersZfilled)rrvrr_RADAR RADAR_FILLED RADAR_MARKERS)rZr[Z radar_stylerrrrrWns z1PlotTypeInspector._differentiate_radar_chart_typecsx|jfdd}fdd}ddd}|dkr,|r#tjS|r)tjStjS|d kr9|r6tjStjStjS) NcstdS)Nzc:ser/c:spPr/a:ln/a:noFill)rrvrZ scatterChartrrnoLinesz>PlotTypeInspector._differentiate_xy_chart_type..noLinecrrr)symbolsrrrrrzAPlotTypeInspector._differentiate_xy_chart_type..noMarkerszc:scatterStylerr#Z lineMarkerZ smoothMarker) rrvrr_ XY_SCATTERXY_SCATTER_LINES_NO_MARKERSXY_SCATTER_LINESXY_SCATTER_SMOOTH_NO_MARKERSXY_SCATTER_SMOOTH)rZr[rrZ scatter_stylerrrrXs  z.PlotTypeInspector._differentiate_xy_chart_typeN)r+r,r-r. classmethodr\rQrPrRrSrTrUrVrWrXrrrrrOs,         rON) r. __future__rZpptx.chart.categoryrZpptx.chart.datalabelrpptx.chart.seriesrpptx.enum.chartrr_ pptx.oxml.nsrpptx.oxml.simpletypesrr pptx.utilr objectr r3r6r7r@rGrHrIrJrKrNrOrrrrs*       _0