~Zi9tSrSSKJr SSKrSSKJr SSKJr SSKJ r J r J r SSK J r SSKJr "S S \5r"S S \5r"S S\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS \5r"S!S"\5r"S#S$\5r"S%S&\5rg)'zChartData and related objects.) annotationsN)Sequence)Number)BubbleWorkbookWriterCategoryWorkbookWriterXyWorkbookWriter)ChartXmlWriter) lazypropertyc^\rSrSrSrSU4SjjrSrSrSrSr \ S5r S r S r S r\ S 5rS rSr\ S5rSrSrU=r$)_BaseChartDataaBase class providing common members for chart data objects. A chart data object serves as a proxy for the chart data table that will be written to an Excel worksheet; operating as a sequence of series as well as providing access to chart-level attributes. A chart data object is used as a parameter in :meth:`shapes.add_chart` and :meth:`Chart.replace_data`. The data structure varies between major chart categories such as category charts and XY charts. cD>[[U] 5 Xl/UlgN)superr __init___number_format_series)self number_format __class__s i/var/www/eduai.edurigo.com/question_generate/ques_gen_env/lib/python3.13/site-packages/pptx/chart/data.pyr_BaseChartData.__init__s nd,.+ c8URRU5$r)r __getitem__rindexs rr_BaseChartData.__getitem__!s||''..rc6URR5$r)r__len__rs rr _BaseChartData.__len__$s||##%%rc8URRU5$r)rappendrseriess rr$_BaseChartData.append's||""6**rcZSnUHnXLaUs $U[U5- nM [S5e)z| The total integer number of data points appearing in the series of this chart that are prior to *series* in this sequence. rseries not in chart data object)len ValueError)rr&count this_seriess rdata_point_offset _BaseChartData.data_point_offset*s; K$ S% %E :;;rcUR$)a? The formatting template string, e.g. '#,##0.0', that determines how X and Y values are formatted in this chart and in the Excel spreadsheet. A number format specified on a series will override this value for that series. Likewise, a distinct number format can be specified for a particular data point within a series. rr!s rr_BaseChartData.number_format6s"""rcP[U5H up#XLdM Us $ [S5e)z8 Return the integer index of *series* in this sequence. r)) enumerater+)rr&idxss r series_index_BaseChartData.series_indexAs, oFC{ &:;;rc8URRU5$)zT Return the Excel worksheet reference to the cell containing the name for *series*. )_workbook_writerseries_name_refr%s rr;_BaseChartData.series_name_refJs $$44V<_BaseChartData.x_values_refQ $$11&99rc.URR$)zh Return a blob containing an Excel workbook file populated with the contents of this chart data object. )r: xlsx_blobr!s rrB_BaseChartData.xlsx_blobXs $$...rcBURU5RS5$)z Return a blob containing the XML for a chart of *chart_type* containing the series in this chart data object, as bytes suitable for writing directly to a file. zutf-8)_xmlencoder chart_types r xml_bytes_BaseChartData.xml_bytes`s yy$++G44rc8URRU5$)z^ The Excel worksheet reference to the Y values for *series* (not including the column label). )r: y_values_refr%s rrL_BaseChartData.y_values_refhr@rc[S5e)r The worksheet writer object to which layout and writing of the Excel worksheet for this chart will be delegated. z%must be implemented by all subclasses)NotImplementedErrorr!s rr:_BaseChartData._workbook_writeros ""IJJrc,[X5R$)z Return (as unicode text) the XML for a chart of *chart_type* populated with the values in this chart data object. The XML is a complete XML document, including an XML declaration specifying UTF-8 encoding. )r xmlrGs rrE_BaseChartData._xmlwsj/333r)rr)General)__name__ __module__ __qualname____firstlineno____doc__rrr r$r.propertyrr7r;r>rBrIrLr:rE__static_attributes__ __classcell__rs@rr r s /&+ <##<=://5:KK44rr c\rSrSrSrSrSrSrSr\ S5r \ S5r \ S 5r \ S 5r \ S 5r\ S 5r\ S 5r\ S5r\ S5rSrg)_BaseSeriesDataa  Base class providing common members for series data objects. A series data object serves as proxy for a series data column in the Excel worksheet. It operates as a sequence of data points, as well as providing access to series-level attributes like the series label. c6XlX lX0l/Ulgr) _chart_data_namer _data_points)r chart_datanamers rr_BaseSeriesData.__init__s% +rc8URRU5$r)rerrs rr_BaseSeriesData.__getitem__s  ,,U33rc6URR5$r)rer r!s rr _BaseSeriesData.__len__s  ((**rc8URRU5$r)rer$)r data_points rr$_BaseSeriesData.appends  '' 33rc8URRU5$)zU The integer count of data points that appear in all chart series prior to this one. )rcr.r!s rr.!_BaseSeriesData.data_point_offsets 11$77rc8URRU5$)z Zero-based integer indicating the sequence position of this series in its chart. For example, the second of three series would return `1`. )rcr7r!s rr_BaseSeriesData.index ,,T22rc8URb UR$S$)z The name of this series, e.g. 'Series 1'. This name is used as the column heading for the y-values of this series and may also appear in the chart legend and perhaps other chart locations. )rdr!s rrg_BaseSeriesData.names"ZZ3tzz;;rc8URRU5$)zP The Excel worksheet reference to the cell containing the name for this series. )rcr;r!s rname_ref_BaseSeriesData.name_refs //55rcPURnUcURR$U$)z The formatting template string that determines how a number in this series is formatted, both in the chart and in the Excel spreadsheet; for example '#,##0.0'. If not specified for this series, it is inherited from the parent chart data object. )rrcrrrs rr_BaseSeriesData.number_formats-++  ##11 1rcXURVs/sHoRPM sn$s snf)zZ A sequence containing the X value of each datapoint in this series, in data point order. )rexrdps rx_values_BaseSeriesData.x_values& $00100111'c8URRU5$)zb The Excel worksheet reference to the X values for this chart (not including the column heading). )rcr>r!s rr>_BaseSeriesData.x_values_refrtrcXURVs/sHoRPM sn$s snf)zZ A sequence containing the Y value of each datapoint in this series, in data point order. )reyrs ry_values_BaseSeriesData.y_valuesrrc8URRU5$)zb The Excel worksheet reference to the Y values for this chart (not including the column heading). )rcrLr!s rrL_BaseSeriesData.y_values_refrtr)rcrerdrN)rVrWrXrYrZrrr r$r[r.rrgryrrr>rrLr\rrr`r`s 4+48833<<66  22332233rr`c<^\rSrSrSrU4Sjr\S5rSrU=r $)_BaseDataPointz= Base class providing common members for data point objects. cB>[[U] 5 XlX lgr)rrr _series_datar)r series_datarrs rr_BaseDataPoint.__init__s nd,.'+rcPURnUcURR$U$)a The formatting template string that determines how the value of this data point is formatted, both in the chart and in the Excel spreadsheet; for example '#,##0.0'. If not specified for this data point, it is inherited from the parent series data object. )rrrr|s rr_BaseDataPoint.number_formats-++  $$22 2r)rr) rVrWrXrYrZrr[rr\r]r^s@rrrs!,   rrc\rSrSrSrSrS Sjr\S5r\RS5r\S5r S r \ S 5r S rg) CategoryChartDataa Accumulates data specifying the categories and series values for a chart and acts as a proxy for the chart data table that will be written to an Excel worksheet. Used as a parameter in :meth:`shapes.add_chart` and :meth:`Chart.replace_data`. This object is suitable for use with category charts, i.e. all those having a discrete set of label values (categories) as the range of their independent variable (X-axis) values. Unlike the ChartData types for charts supporting a continuous range of independent variable values (such as XyChartData), CategoryChartData has a single collection of category (X) values and each data point in its series specifies only the Y value. The corresponding X value is inferred by its position in the sequence. c8URRU5$)aV Return a newly created |data.Category| object having *label* and appended to the end of the category collection for this chart. *label* can be a string, a number, a datetime.date, or datetime.datetime object. All category labels in a chart must be the same type. All category labels in a chart having multi-level categories must be strings. ) categories add_category)rlabels rrCategoryChartData.add_categorys++E22rNct[XU5nURU5 UHnURU5 M U$)a Add a series to this data set entitled *name* and having the data points specified by *values*, an iterable of numeric values. *number_format* specifies how the series values will be displayed, and may be a string, e.g. '#,##0' corresponding to an Excel number format. )CategorySeriesDatar$add_data_point)rrgvaluesrrvalues r add_seriesCategoryChartData.add_seriess:)]C  K E  & &u -rc\[USS5(d[5UlUR$)at|data.Categories| object providing access to category-object hierarchy. Assigning an iterable of category labels (strings, numbers, or dates) replaces the |data.Categories| object with a new one containing a category for each label in the sequence. Creating a chart from chart data having date categories will cause the chart to have a |DateAxis| for its category axis. _categoriesF)getattr Categoriesrr!s rrCategoryChartData.categories(s)t]E22)|D rcX[5nUHnURU5 M X lgr)rrr)rcategory_labelsrrs rrr7s'\ $E  # #E *%%rc.URR$zd The Excel worksheet reference to the categories for this chart (not including the column heading). )r:categories_refr!s rr CategoryChartData.categories_ref>s $$333rc8URRU5$)z^ The Excel worksheet reference to the values for *series* (not including the column heading). )r: values_refr%s rrCategoryChartData.values_refFs $$//77rc[U5$rO)rr!s rr:"CategoryChartData._workbook_writerMs &d++r)r)rN)rVrWrXrYrZrrr[rsetterrrr r:r\rrrrrsl  3     && 448,,rrc^\rSrSrSrU4SjrSrSrSr\ S5r \ S5r \ S 5r S r \ S 5r\ S 5r\ S 5r\R"S5rSrU=r$)riVz A sequence of |data.Category| objects, also having certain hierarchical graph behaviors for support of multi-level (nested) categories. cF>[[U] 5 /UlSUlgr)rrrrr)rrs rrCategories.__init__\s  j$(*"rc8URRU5$r)rr)rr5s rrCategories.__getitem__as++C00rc6URR5$)z Return the count of the highest level of category in this sequence. If it contains hierarchical (multi-level) categories, this number will differ from :attr:`category_count`, which is the number of leaf nodes. )rr r!s rr Categories.__len__ds''))rcR[X5nURRU5 U$)a Return a newly created |data.Category| object having *label* and appended to the end of this category sequence. *label* can be a string, a number, a datetime.date, or datetime.datetime object. All category labels in a chart must be the same type. All category labels in a chart having multi-level categories must be strings. Creating a chart from chart data having date categories will cause the chart to have a |DateAxis| for its category axis. )Categoryrr$rrcategorys rrCategories.add_categoryms'E( )rcURS:wagUSRn[R[R4n[ X5(agg)a Return |True| if the first category in this collection has a date label (as opposed to str or numeric). A date label is one of type datetime.date or datetime.datetime. Returns |False| otherwise, including when this category collection is empty. It also returns False when this category collection is hierarchical, because hierarchical categories can only be written as string labels. FrT)depthrdatetimedate isinstance)rfirst_cat_label date_typess r are_datesCategories.are_dates|sD ::?q'--mmX%6%67 o 2 2rcURS:wagUSRn[[R[R4n[ X5(agg)a Return |True| if the first category in this collection has a numeric label (as opposed to a string label), including if that value is a datetime.date or datetime.datetime object (as those are converted to integers for storage in Excel). Returns |False| otherwise, including when this category collection is empty. It also returns False when this category collection is hierarchical, because hierarchical categories can only be written as string labels. rFrT)rrrrrr)rr numeric_typess r are_numericCategories.are_numericsH ::? q'--0A0AB o 5 5rcURnU(dgUSRnUSSHnURU:wdM[S5e U$)z` The number of hierarchy levels in this category graph. Returns 0 if it contains no categories. rrNcategory depth not uniform)rrr+)rr first_depthrs rrCategories.depthsT %%  m)) "12H~~, !=>>'rcnSnURHnXLaUs $X#R- nM [S5e)z The offset of *category* in the overall sequence of leaf categories. A non-leaf category gets the index of its first sub-category. rz$category not in top-level categories)r leaf_countr+)rrr this_categorys rrCategories.indexs@ !--M( -- -E.?@@rc:[SUR55$)z The number of leaf-level categories in this hierarchy. The return value is the same as that of `len()` only when the hierarchy is single level. c38# UHoRv M g7frr).0cs r (Categories.leaf_count..s:)9A<<)9)sumrr!s rrCategories.leaf_counts:)9)9:::rc#@^# U4SjmT"U5HnUv M g7f)z A generator of (idx, label) sequences representing the category hierarchy from the bottom up. The first level contains all leaf categories, and each subsequent is the next level up. c3># UVVs/sHoRHo"PM M nnnU(aT"U5HnUv M UVs/sHoURUR4PM snv gs snnfs snf7fr)sub_categoriesr5r)rrscrlevelcatlevelss rr!Categories.levels..levelssk*4P*Q?O?Ob?Ob*NP#N3EK44>>:CGGSYY':> > Q ?sA:A/!A:!A5)A:Nr)rrrs @rrCategories.levelss  ?D\EK"scSnURb UR$URS:waU$USRn[U[R [R45(agU$)a Read/write. Return a string representing the number format used in Excel to format these category values, e.g. '0.0' or 'mm/dd/yyyy'. This string is only relevant when the categories are numeric or date type, although it returns 'General' without error when the categories are string labels. Assigning |None| causes the default number format to be used, based on the type of the category labels. rUrrz yyyy\-mm\-dd)rrrrrr)rGENERALrs rrCategories.number_formatsh    *&& & ::?Nq'-- o x7H7H'I J J"rcXlgrr1)rrs rrrs#r)rr)rVrWrXrYrZrrr rr[rrrrrrrrr\r]r^s@rrrVs # 1* ",   A;;&4$$rrc^\rSrSrSrU4SjrSr\S5r\S5r Sr \S5r \S 5r SS jr \S 5rS rS rU=r$)riz A chart category, primarily having a label to be displayed on the category axis, but also able to be configured in a hierarchy for support of multi-level category charts. cP>[[U] 5 XlX l/Ulgr)rrr_label_parent_sub_categories)rrparentrs rrCategory.__init__s" h&(  !rcR[X5nURRU5 U$)z Return a newly created |data.Category| object having *label* and appended to the end of the sub-category sequence for this category. )rrr$rs radd_sub_categoryCategory.add_sub_category s' E( ##H-rcURnU(dgUSRnUSSHnURU:wdM[S5e US-$)zp The number of hierarchy levels rooted at this category node. Returns 1 if this category has no sub-categories. rrNr)rrr+)rrrrs rrCategory.depthsZ --$Q'-- &qr*H~~, !=>>+Qrc8URRU5$)z The offset of this category in the overall sequence of leaf categories. A non-leaf category gets the index of its first sub-category. )rrr!s rr5 Category.idx"s||!!$''rcURRU5nURHnXLaUs $X#R- nM [ S5e)zJ The offset of *sub_category* in the overall sequence of leaf categories. z!sub_category not in this category)rrrrr+)r sub_categoryrthis_sub_categorys rrCategory.index+sP  ""4(!%!5!5 0 11 1E"6<==rc^UR(dg[SUR55$)zj The number of leaf category nodes under this category. Returns 1 if this category has no sub-categories. rc38# UHoRv M g7frr)rrs rr&Category.leaf_count..?sL7K8&&7Kr)rrr!s rrCategory.leaf_count7s' ##Lt7K7KLLLrc8URb UR$S$)z The value that appears on the axis for this category. The label can be a string, a number, or a datetime.date or datetime.datetime object. rv)rr!s rrCategory.labelAs#kk5t{{=2=rcURn[U[R[R45(aSUR U5-$[ UR5$)z The string representation of the numeric (or date) label of this category, suitable for use in the XML `c:pt` element for this category. The optional *date_1904* parameter specifies the epoch used for calculating Excel date numbers. z%.1f)rrrr_excel_date_numberstr)r date_1904rs rnumeric_str_valCategory.numeric_str_valJsN  ehmmX->->? @ @D33I>> >4;;rcUR$)z5 The sequence of child categories for this category. )rr!s rrCategory.sub_categoriesVs ###rc[RURp2U"URURUR 5nU(a U"SSS5O U"SSS5nXE- nUR nU(d US:aUS- nU$)z Return an integer representing the date label of this category as the number of days since January 1, 1900 (or 1904 if date_1904 is |True|). iprik ;)rrryearmonthdaydays)rr rrdate_epochdeltaexcel_day_numbers rr Category._excel_date_number]sw mmT[[eUZZeii8$-T1a 4b"3E  ::-2  ! r)rrr)F)rVrWrXrYrZrrr[rr5rrrrrr r\r]r^s@rrrs "   (( >MM>>  $$   rrc\rSrSrSrSrg) ChartDataiqz |ChartData| is simply an alias for |CategoryChartData| and may be removed in a future release. All new development should use |CategoryChartData| for creating or replacing the data in chart types other than XY and Bubble. rN)rVrWrXrYrZr\rrrr r qsrr cb\rSrSrSrS Sjr\S5r\S5r\S5r \S5r S r g) rizz The data specific to a particular category chart series. It provides access to the series label, the series data points, and an optional number format to be applied to each data point not having a specified number format. Nc@[XU5nURU5 U$)z Return a CategoryDataPoint object newly created with value *value*, an optional *number_format*, and appended to this sequence. )CategoryDataPointr$)rrrrns rr!CategorySeriesData.add_data_points" 'tMB  Jrc.URR$)z\ The |data.Categories| object that provides access to the category objects for this series. )rcrr!s rrCategorySeriesData.categoriess ***rc.URR$r)rcrr!s rr!CategorySeriesData.categories_refs ...rcXURVs/sHoRPM sn$s snf)z\ A sequence containing the (Y) value of each datapoint in this series, in data point order. )rerrs rrCategorySeriesData.valuess& $(#4#45#4R#4555rc8URRU5$)ze The Excel worksheet reference to the (Y) values for this series (not including the column heading). )rcrr!s rrCategorySeriesData.values_refs **400rrr) rVrWrXrYrZrr[rrrrr\rrrrrzs\++//6611rrc2\rSrSrSrSSjr\S5rSrg) XyChartDataiz A specialized ChartData object suitable for use with an XY (aka. scatter) chart. Unlike ChartData, it has no category sequence. Rather, each data point of each series specifies both an X and a Y value. Nc@[XU5nURU5 U$)z Return an |XySeriesData| object newly created and added at the end of this sequence, identified by *name* and values formatted with *number_format*. ) XySeriesDatar$rrgrrs rrXyChartData.add_seriess" #4}=  K rc[U5$r)rr!s rr:XyChartData._workbook_writers  %%rrr) rVrWrXrYrZrr r:r\rrrr.r.s  &&rr.c8\rSrSrSrSSjrSr\S5rSr g) BubbleChartDataiz A specialized ChartData object suitable for use with a bubble chart. A bubble chart is essentially an XY chart where the markers are scaled to provide a third quantitative dimension to the exhibit. Nc@[XU5nURU5 U$)z Return a |BubbleSeriesData| object newly created and added at the end of this sequence, and having series named *name* and values formatted with *number_format*. )BubbleSeriesDatar$r1s rrBubbleChartData.add_seriess" 't=A  K rc8URRU5$)zW The Excel worksheet reference for the range containing the bubble sizes for *series*. )r:bubble_sizes_refr%s rr; BubbleChartData.bubble_sizes_refs $$55f==rc[U5$r)rr!s rr: BubbleChartData._workbook_writers $D))rrr) rVrWrXrYrZrr;r r:r\rrrr6r6s% >**rr6c"\rSrSrSrSSjrSrg)r0ia The data specific to a particular XY chart series. It provides access to the series label, the series data points, and an optional number format to be applied to each data point not having a specified number format. The sequence of data points in an XY series is significant; lines are plotted following the sequence of points, even if that causes a line segment to "travel backward" (implying a multi-valued function). The data points are not automatically sorted into increasing order by X value. Nc@[XX#5nURU5 U$)zd Return an XyDataPoint object newly created with values *x* and *y*, and appended to this sequence. ) XyDataPointr$)rrrrrns rrXySeriesData.add_data_points" !!;  Jrrr)rVrWrXrYrZrr\rrrr0r0s  rr0cB\rSrSrSrSSjr\S5r\S5rSr g) r8ia The data specific to a particular Bubble chart series. It provides access to the series label, the series data points, and an optional number format to be applied to each data point not having a specified number format. The sequence of data points in a bubble chart series is maintained throughout the chart building process because a data point has no unique identifier and can only be retrieved by index. NcB[XX#U5nURU5 U$)z Append a new BubbleDataPoint object having the values *x*, *y*, and *size*. The optional *number_format* is used to format the Y value. If not provided, the number format is inherited from the series data. )BubbleDataPointr$)rrrsizerrns rrBubbleSeriesData.add_data_point s$ %Ta}E  JrcXURVs/sHoRPM sn$s snf)z_ A sequence containing the bubble size for each datapoint in this series, in data point order. )re bubble_sizers r bubble_sizesBubbleSeriesData.bubble_sizess& *.):):;):2):;;;rc8URRU5$)zZ The Excel worksheet reference for the range containing the bubble sizes for this series. )rcr;r!s rr;!BubbleSeriesData.bubble_sizes_refs 0066rrr) rVrWrXrYrZrr[rJr;r\rrrr8r8s4 <<77rr8c<^\rSrSrSrU4Sjr\S5rSrU=r $)r#i$z A data point in a category chart series. Provides access to the value of the datapoint and the number format with which it should appear in the Excel file. c8>[[U] X5 X lgr)rr#r_value)rrrrrs rrCategoryDataPoint.__init__+s / K rcUR$)z- The (Y) value for this category data point. rPr!s rrCategoryDataPoint.value/s {{rrS) rVrWrXrYrZrr[rr\r]r^s@rr#r#$s! rr#cL^\rSrSrSrU4Sjr\S5r\S5rSr U=r $)rAi7z] A data point in an XY chart series. Provides access to the x and y values of the datapoint. cD>[[U] X5 X lX0lgr)rrAr_x_y)rrrrrrs rrXyDataPoint.__init__=s k4)+ErcUR$)z% The X value for this XY data point. )rWr!s rr XyDataPoint.xB wwrcUR$)z% The Y value for this XY data point. )rXr!s rr XyDataPoint.yIr\r)rWrX) rVrWrXrYrZrr[rrr\r]r^s@rrArA7s5   rrAc<^\rSrSrSrU4Sjr\S5rSrU=r $)rEiQzg A data point in a bubble chart series. Provides access to the x, y, and size values of the datapoint. c:>[[U] XX55 X@lgr)rrEr_size)rrrrrFrrs rrBubbleDataPoint.__init__Ws ot-kaO rcUR$)zD The value representing the size of the bubble for this data point. rar!s rrIBubbleDataPoint.bubble_size[s zzrrd) rVrWrXrYrZrr[rIr\r]r^s@rrErEQs! rrE) rZ __future__rrcollections.abcrnumbersrpptx.chart.xlsxrrrpptx.chart.xmlwriterr pptx.utilr r r`objectrrrrr rr.r6r0r8r#rArErrrrms$"$ 0"l4Xl4^c3hc3LV0T,T,nd$d$Nq vq h!/1/1d&.&4*k*B?,$7|$7N&.4kr