maidr reads the charts of a PowerPoint presentation and of a Word document. Pass a .pptx file to maidr.read_powerpoint_charts(), or a .docx file to maidr.read_word_charts(), and hand any chart either returns to maidr.show(), maidr.render() or maidr.save_html(): the chart can then be read from the keyboard, as sound, as text and in braille. None of PowerPoint, Word or Excel needs to be installed. For the charts of a workbook, see the Excel page.
PowerPoint and Word support is experimental. What it reads, and how, may change without a deprecation period, whichever chart type is read: see Plot Type Stability.
A chart on a slide or in a document is the chart Excel draws: the same chart part, with the same copy of the values it shows, and its data in a workbook embedded in the file beside it. So it is read just as the Excel page describes, every chart type Excel draws included, from column charts to waterfalls and treemaps. The embedded workbook is read only for what the copy leaves out: an axis with no title is named after the header cell above its categories in the chart’s data sheet. Each chart is drawn again with matplotlib, in the colors of its slide’s or its document’s theme.
The examples read slides.pptx, a presentation of quarterly sales with a chart on each of three slides, the last of them hidden, and report.docx, a short report with two charts.
maidr.read_powerpoint_charts() returns the charts slide by slide, in slide show order, each with the number of its slide, whether that slide is hidden, its name and its title. The charts of hidden slides are read too.
2 | False | Revenue chart | Revenue by region
3 | False | Margin chart | Margin by quarter
4 | True | Share chart | Share of revenueSave every chart of a presentation as its own page with a loop:
Both functions also take an open binary file, such as the one a Streamlit or Shiny upload control hands you.
Each region is a series and each quarter a category: the left and right arrow keys move between quarters, and up and down between the regions. The category axis has no title on the slide, so it is named after the header above the quarters in the chart’s data sheet, Quarter.
The margin is read as a percentage, because its data sheet formats it as one.
maidr.read_word_charts() returns the charts of the document’s body in reading order, inline and floating ones and those in tables and text boxes, each with its place among the document’s charts, its name and its title.
The teams are named after the header above them in the chart’s data sheet, Team.