,h3ldZddlmZmZmZddlmZddlmZddl m Z ddl m Z dd lmZmZdd lmZdd lmZGd d eZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZd Z Gd!d"eZ!y#)$z Plot-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. )absolute_importprint_functionunicode_literals) Categories) DataLabels) XL_CHART_TYPE)qn) ST_BarDir ST_Grouping)SeriesCollection) lazypropertyceZdZdZfdZedZedZedZ edZ e jdZ edZ ed Z e jd 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. cFtt| ||_||_yN)superr__init___element_chart)selfxChartchart __class__s Q/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/chart/plot.pyrz_BasePlot.__init__s 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.categories s$--((rc|jS)z: The |Chart| object containing this plot. )rrs rrz_BasePlot.chart.s {{rc^|jj}| tdt|S)z |DataLabels| instance providing properties and methods on the collection of data labels associated with this plot. z9plot has no data labels, set has_data_labels = True first)rdLbls ValueErrorr)rr#s r data_labelsz_BasePlot.data_labels5s5  ## =K %  rc2|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)rr#rs rhas_data_labelsz_BasePlot.has_data_labelsBs}}""$..rct|dur|jjy|jj,|jj }d|j _yy)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)rvaluer#s rr'z_BasePlot.has_data_labelsKsS ;%  MM ' ' )}}""* 002$( !+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.series[s   ..rcL|jj}|y|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. T)r varyColorsr-)rr2s rvary_by_categoriesz_BasePlot.vary_by_categoriescs&]]--  ~~rcTt||jj_yr)r)rget_or_add_varyColorsr-rr.s rr3z_BasePlot.vary_by_categoriesps48K ++-1r)__name__ __module__ __qualname____doc__rrr propertyrr%r'setterr0r3 __classcell__)rs@rrrs   ) )  ! !// ) )//  @@rrceZdZdZy)AreaPlotz An area plot. Nr7r8r9r:rrr?r?urr?ceZdZdZy) Area3DPlotz$ A 3-dimensional area plot. Nr@rArrrDrD{rBrrDcxeZdZdZedZej dZedZej dZy)BarPlotz! A bar chart-style plot. cL|jj}|y|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. )rgapWidthr-)rrIs r gap_widthzBarPlot.gap_widths&==))  ||rcF|jj}||_yr)rget_or_add_gapWidthr-)rr.rIs rrJzBarPlot.gap_widths==446 rcL|jj}|y|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. r)roverlapr-)rrNs rrNzBarPlot.overlaps%--'' ?{{rc|dk(r|jjy||jj_y)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-r6s rrNzBarPlot.overlaps3 A: MM ) ) + 16 ((*.rN)r7r8r9r:r;rJr<rNrArrrFrFsa     ^^77rrFcDeZdZdZedZej dZy) BubblePlotz A bubble chart plot. cL|jj}|y|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`. d)r bubbleScaler-)rrVs r bubble_scalezBubblePlot.bubble_scales&mm//  rcp|j}|j|y|j}||_yr)r_remove_bubbleScale_add_bubbleScaler-)rr. bubbleChartrVs rrWzBubblePlot.bubble_scales4mm '') = !224  rN)r7r8r9r:r;rWr<rArrrSrSs5    rrSceZdZdZy) DoughnutPlotz An doughnut plot. Nr@rArrr]r]rBrr]ceZdZdZy)LinePlotz" A line chart-style plot. Nr@rArrr_r_rBrr_ceZdZdZy)PiePlotz! A pie chart-style plot. Nr@rArrrararBrraceZdZdZy) RadarPlotz A radar-style plot. Nr@rArrrcrcrBrrcceZdZdZy)XyPlotz An XY (scatter) plot. Nr@rArrrererBrrec tdttdttdttdttdt tdt tdttdttd ti |j}|||S#t$rtd |jzwxYw) 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) r r?rDrFrSr]r_rarcretagKeyErrorr$)rrPlotClss r PlotFactoryrjs B } x   | g    !< } x | g ~   &   **  65 !! B3fjj@AABs BB!!"CceZdZdZedZedZedZedZedZ edZ edZ ed Z ed Z ed Zy ) 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 l |j|j|j|j|j|j |j |j|jd |jj}||S#t$r#td|jjzwxYw)zo Return the member of :ref:`XlChartType` that corresponds to the chart type of *plot*. ) r?rDrFrSr]r_rarcrez#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_typerr7rhNotImplementedError)clsplotchart_type_methods r chart_typezPlotTypeInspector.chart_types  >>!CC<<!BB # F F>><< @@:: !nn%% !' !&&  %58O8OO  s A=B,B3ctjtjtjtj tj tji|jjSr) r STANDARDXL THREE_D_AREASTACKEDTHREE_D_AREA_STACKEDPERCENT_STACKEDTHREE_D_AREA_STACKED_100r grouping_valrxrys rroz3PlotTypeInspector._differentiate_area_3d_chart_typesS  "//   !8!8  ' ')D)D  -- $ $ & &rctjtjtjtj tj tji|jjSr) r r}r~AREAr AREA_STACKEDrAREA_STACKED_100rrrs rrnz0PlotTypeInspector._differentiate_area_chart_type'sQ  "''     ' ')<)<  -- $ $ & &rc|j}|jjtjk(rit j tjt jtjt jtji|jS|jjtjk(rit j tjt jtj t jtj"i|jSt%d|jjz)Nz"invalid barChart.barDir value '%s')rbarDirr-r BARr CLUSTEREDr~ BAR_CLUSTEREDr BAR_STACKEDrBAR_STACKED_100rCOLCOLUMN_CLUSTEREDCOLUMN_STACKEDCOLUMN_STACKED_100r$)rxrybarCharts rrpz/PlotTypeInspector._differentiate_bar_chart_type/s== ??  )-- /%%r'7'7##R^^++R-?-?## % % ??  )-- /%%r':':##R%6%6++R-B-B## % % =@S@SSTTrcd}|j}||}|tjS|jrtjStjS)Nc6|jd}|r|dSdS)Nzc:ser/c:bubble3Drxpath)r[resultss rfirst_bubble3DzJPlotTypeInspector._differentiate_bubble_chart_type..first_bubble3DBs$!''(:;G!(71: 2d 2r)rr~BUBBLEr-BUBBLE_THREE_D_EFFECT)rxryrr[bubble3Ds rrqz2PlotTypeInspector._differentiate_bubble_chart_type@sI 3mm !+.  99  <<++ +yyrc|j}|jd}|rtjStjSNz./c:ser/c:explosion)rrr~DOUGHNUT_EXPLODEDDOUGHNUT)rxry doughnutChart explosions rrrz4PlotTypeInspector._differentiate_doughnut_chart_typeOs3 !''(=> '0r##AbkkArc|jfd}|rstjtjtj tj tjtji|jjStjtjtj tjtjtji|jjS)Nc.jd}|ryy)Nz$c:ser/c:marker/c:symbol[@val="none"]FTr)matches lineCharts rhas_line_markerszJPlotTypeInspector._differentiate_line_chart_type..has_line_markersYsoo&LMGr) rr r}r~ LINE_MARKERSrLINE_MARKERS_STACKEDrLINE_MARKERS_STACKED_100rLINE LINE_STACKEDLINE_STACKED_100)rxryrrs @rrsz0PlotTypeInspector._differentiate_line_chart_typeUsMM    $$boo##R%<%<++R-H-Hmm(( * *$$bgg##R__++R-@-@mm(( * *rc|j}|jd}|rtjStjSr)rrr~ PIE_EXPLODEDPIE)rxrypieChartrs rrtz/PlotTypeInspector._differentiate_pie_chart_typels/==NN#89 "+r77rc|jjddjd}fd}|tjS|dk(rtj S|rtjStj S)Nz c:radarStylerr-c\jd}|r|djddk(ryyNzc:ser/c:marker/c:symbolrr-noneTFrget)r radarCharts r noMarkerszDPlotTypeInspector._differentiate_radar_chart_type..noMarkersws1 &&'@AG71:>>%0F:rfilled)rrrr~RADAR RADAR_FILLED RADAR_MARKERS)rxry radar_stylerrs @rruz1PlotTypeInspector._differentiate_radar_chart_typersn]]  &&~6q9==eD    88O ( "?? " ;88Orct|jfd}fd}jddjd}|dk(r>|rtjS|rtj Stj S|dk(r'|rtjStjStjS)Nc8tjdS)Nzc:ser/c:spPr/a:ln/a:noFill)r)r) scatterChartsrnoLinez>PlotTypeInspector._differentiate_xy_chart_type..noLines **+GHI Irc\jd}|r|djddk(ryyrr)symbolsrs rrzAPlotTypeInspector._differentiate_xy_chart_type..noMarkerss1"(()BCG71:>>%0F:rzc:scatterStylerr- lineMarker smoothMarker) rrrr~ XY_SCATTERXY_SCATTER_LINES_NO_MARKERSXY_SCATTER_LINESXY_SCATTER_SMOOTH_NO_MARKERSXY_SCATTER_SMOOTH)rxryrr scatter_stylers @rrvz.PlotTypeInspector._differentiate_xy_chart_types}}  J  %**+;rs IH !,5$^@^@By  -7i-7`  69 y i   Y ".__r