Skip to main content

A figure pager class

Project description

Code style: black GitHub Workflow Status PyPI version PyPI pyversions License: MIT


Python's Matplotlib can save plots with various backends and single or multiple pages. FigPager is a wrapper class for those backends.

FigPager is similar to other third party Matplotlib packages that allow figure elements to be added such as a title block, border and logo. One example package is mpl-template.

The FigPager class reads layout specifications from an .ini file. FigPager handles drawing boxes, text, images and lines referenced in .ini files on a figure canvas. The class handles adding subplots, adding new pages in multipage backends and closing the figure.


Install using pip. figpager has been tested for Python 2.7, Python 3.6 and Python 3.7. See requirements.txt for dependencies.

pip install figpager


After install FigPager can be imported from figpager.

from figpager import FigPager

A FigPager instance is initialized with a paper size of A0-A10, B0-B10, letter, legal or ledger, the number of plot panels in a row as an integer and the number of plot panels as columns as an integer. 3 rows and 3 columns of panels for a figure of 3x3 is depicted below.

fp = FigPager(

Additional keywords provide further functionality. See the code for all keywords.

fp = FigPager(
        height_ratios=[1, 1, 2],

with blocks are also supported with no need for fp.close()

with FigPager("letter", 3, 2, layout="Report", outfile=.\out.pdf,
        orientation="portrait", height_ratios=[1, 1, 2],
        overwrite=True, transparent=True) as fp:

Example layout .ini files can be found in the package under page_layout.

FigPager has options to add subplots. See the code for all keywords.

ax0 = fp.add_subplot()

FigPager also has add page options. In backends that don't support multipage a zero padded number is added as a suffix to the file name.

The example below specifies the number of rows and columns, the orientation and height ratios. See the code for all keywords.

                nrows=3, ncols=2, orientation="portrait", height_ratios=[1, 1, 2]

The FigPager instance can be be closed following the example below.


See the test code under tests for example code.

Development / Testing

Submit issues and PRs through GitHub. Testing is done with tox. pytest, black and isort are run against code.


figpager is released under the MIT license. See for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

figpager-0.17.tar.gz (15.0 kB view hashes)

Uploaded Source

Built Distribution

figpager-0.17-py2.py3-none-any.whl (16.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page