Return the ``<c:numRef>`` element specified by the parameters as unicode text.

Return short-form prefixed tag from fully qualified (Clark notation) tagname.

Save this package to `pkg_file`. `file` can be either a path to a file (a string) or a file-like object.

Return the number of rows preceding the data table for *series* in the Excel worksheet.

The SHA1 hash digest for the binary "file" of this video. Example: `'1be010ea47803b00e140b852765cdf84f491da47'`

XML value of this enum member, generally an XML attribute value.

Return a "loose" lxml element having the tag specified by `nsptag_str`. `nsptag_str` must contain the standard namespace prefix, e.g. 'a:tbl'. Th

Return an instance of the appropriate subclass of _BasePlot based on the tagname of *xChart*.

Return self after removing any <a:lumMod> and <a:lumOff> child elements.

Return `(image_part, rId)` pair corresponding to `image_file`. The returned |ImagePart| object contains the image in `image_file` and is

Return `c:tx/c:rich`, newly created if not present. Return the `c:rich` grandchild at `c:tx/c:rich`. Both the `c:tx` and `c:rich` ele

Return definition element with name *defname*

Insert a new node containing *value* into this tree such that its structure as a binary search tree is preserved.

Return a `c:txPr` element tree. Suitable for use in a chart object like data labels or tick labels.

Return appropriate shape object for `shape_elm` on a slide.

Add an ``_add_x()`` method to the element class for this child element.

Add a `_new_{prop_name}()` method to the element class. This method creates a new, empty element of the correct type, having no attributes.

Add an ``_insert_x()`` method to the element class for this child element.

Return a newly created |NotesSlidePart| object related to this slide part. Caller is responsible for ensuring this slide doesn't alre

Return str rId of |_Relationship| newly added to spec.

The effective value of *attr_name* on this placeholder shape; its directly-applied value if it has one, otherwise the value on the

Return an |ImagePart| object belonging to this package or |None| if no matching image part is found. The image part is identified by

Generalized method to get margin values.

Return optional str rId of rel of `reltype`, `target`, and `is_external`. Returns `None` on no matching relationship

The ``CT_DLbl`` instance referring specifically to this individual data label, newly created if not yet present in the XML.

Generate each child of the `p:spTree` element that corresponds to a shape. Items appear in XML document order.

Return the package after loading all parts and relationships.

Write chart data contents to *worksheet* in the standard XY chart layout. Write the data for each series to a separate two-column

Substitute *element* for this placeholder element in the shapetree. This placeholder's `._element` attribute is set to |None| and its

Add attribute with default value to element if it doesn't already exist.

Set value of marX attribute on `a:tcPr` child element. If `marX` is |None|, the marX attribute is removed. `marX` is a string, one of `('marL

Value of `p:blipFill/a:srcRect/@{attr_name}` or 0.0 if not present.

Raise ValueError if `margin_value` is not a positive integer value or |None|.

Return a newly created |data.Category| object having *label* and appended to the end of the category collection for this chart.

Add a child `<Override>` element with attributes set to parameter values.

Add picture shape displaying image in `image_file`. `image_file` can be either a path to a file (a string) or a file-like object. The picture

Add a child `<Relationship>` element with attributes set as specified.

Return new |Shape| object appended to this shape tree. `autoshape_type_id` is a member of :ref:`MsoAutoShapeType` e.g. `MSO_SHAPE.RECTANGLE`

Add a |GraphicFrame| object containing a table. The table has the specified number of `rows` and `cols` and the specified position and

Return newly added text box shape appended to this shape tree. The text box is of the specified size, located at the specified position on th

Add `a:close` element to `path`.

Return the root of a balanced binary search tree populated with the values in iterable *iseq*.

Construct an absolute pack URI formed by translating `relative_ref` onto `baseURI`.

Return SlideLayout object having `name`, or `default` if not found.

Return the `c:title` grandchild, newly created if not present.

The offset of *sub_category* in the overall sequence of leaf categories.

Generate each placeholder shape child element in document order.

Generate exactly one reference to each relationship in package. Performs a depth-first traversal of the rels graph.

Generate each child of this `p:spTree` element that corresponds to a shape. Items appear in XML document order.

Generate each `a:tc` element in this range. Cell elements are generated left-to-right, top-to-bottom.

Return a new _Close object.

Return a new `p:notesMaster` element based on the built-in default template.

Return newly-created "loose" default gradient subtree.

Return target part of relationship with matching `reltype`. Raises |KeyError| if not found and |ValueError| if more than one matching relatio

Return |_Relationship| identified by `rId` after removing it from collection. The caller is responsible for ensuring it is no longer required

Use the categories and series values in the |ChartData| object *chart_data* to replace those in the XML and Excel worksheet for this

Return bytes read from snippet file having `snippet_file_name`.

Sets the fill type to solid, i.e. a solid color. Note that calling this method does not set a color or by itself cause the shape to

Replace the Excel spreadsheet in the related |EmbeddedXlsxPart| with the Excel binary in *xlsx_blob*, adding a new |EmbeddedXlsxPart|

Return appropriate shape object for `shape_elm` on a slide layout.

Return appropriate shape object for `shape_elm` on a slide master.

Return appropriate shape object for `shape_elm` on a notes slide.

Add a close |_Close| operation to the drawing sequence.

Add a read-only `{prop_name}` property to the parent element class. The property locates and returns this child element or `None` if not pres

Return font-size in points that best fits text in this text-frame. The best-fit font size is the largest integer point size not greater than

Return bytes of `file`, which is either a str path or a file-like object.

Return str Excel column reference like 'BQ' for *column_number*. *column_number* is an int in the range 1-16384 inclusive, where 1 ma

Return the ``<a:ln>`` element containing the line format properties in the XML.

Rewrite the ``<c:tx>``, ``<c:xVal>`` and ``<c:yVal>`` child elements of *ser* based on the values in *series_data*.

Set date/time value of child element having `prop_name` to `value`.

Return an instance of the appropriate shape proxy class for `shape_elm`.