Skip to main content

pgfutils

The Portable Graphics Format (PGF) is a language for producing vector graphics within TeX documents. There is also a higher-level language TikZ (TikZ ist kein Zeichenprogramm -- TikZ is not a drawing program) which uses PGF.

Since version 1.2, the Python plotting library Matplotlib has included a PGF backend to generate figures ready for inclusion in a TeX document. In order to get consistent figures that fit with the style of the document, this requires some configuration. The aim of pgfutils is to simplify this configuration and allow figures to be easily generated from a Python script.

The module provides two functions which set up and then save the figure. The actual plotting is performed by standard Matplotlib functions. For example, to generate a plot showing the 1st, 3rd, 5th, 7th, 9th and 11th harmonics of an ideal square wave and the resulting sum:

# Set up the figure environment.
from pgfutils import setup_figure, save
setup_figure(width=0.9, height=0.4)

import numpy as np
from matplotlib import pyplot as plt

# Generate square wave from a few terms of its Fourier series.
f = 3
t = np.linspace(0, 1, 501)
square = np.zeros(t.shape)
for n in range(1, 12, 2):
    # Create this harmonic and plot it as a dashed
    # partially-transparent line.
    component = np.sin(2 * n * np.pi * f * t) / n
    plt.plot(t, component, '--', alpha=0.4)

    # Add it to the overall signal.
    square += component

# Scale the final sum.
square *= 4 / np.pi

# Plot and label the figure.
plt.plot(t, square, 'C0')
plt.xlim(0, 1)
plt.ylim(-1.2, 1.2)
plt.xlabel("Time (s)")
plt.ylabel("Amplitude (V)")

# Save as a PGF image.
save()

Requirements

Using pgfutils requires Python 3. Each commit is currently tested with release versions of Python 3.5, 3.6, and 3.7, as well as a development version of Python 3.8.

The only external dependency is matplotlib. All the other dependencies are part of the standard Python library.

Examples

pgfutils comes with some examples which demonstrate its usage and integration into a build system. Depending on your installation method, these may be present somewhere in your filesystem (e.g., on a Linux system, they might be at /usr/share/matplotlib-pgfutils/examples). They can also be found in the extras/examples directory.

Documentation

Documentation for pgfutils can be found online at https://matplotlib-pgfutils.readthedocs.io/

Alternatively, you can find the source of this documentation in Markdown format in the doc/ directory of the source:

An example configuration file showing the default settings is given in extras/pgfutils.cfg.

Unit testing

Build Status codecov

Extensive unit tests are included in the tests/ directory of the source. Each commit to the source repository is automatically tested thanks to Travis CI. The test coverage (that is, how many of the lines of code in the source were executed during the tests) is monitored by Codecov. The badges above show the status of the last commit made to the source.

You can also run the tests on a local copy of the code. They are designed to be run with the pytest framework and employ the Coverage.py package via the pytest-cov plugin to measure the coverage. If you have these packages installed, run pytest from the top-level directory to execute the tests. A basic test coverage report will be printed on the terminal, and the full report can be viewed by opening the htmlcov/index.html file in your web browser.

License

pgfutils is released under the three-clause BSD license. The terms of this license can be found in the LICENSE file in the source, or online at https://opensource.org/licenses/BSD-3-Clause

The Cotham Sans font used in some unit tests is copyright (c) 2015 Sebastien Sanfilippo and is licensed under the SIL Open Font License, Version 1.1. The license can be found in the source at tests/sources/fonts/Cotham/OFL.txt or online at https://scripts.sil.org/OFL and the font itself can be found at https://github.com/sebsan/Cotham

Metadata

Release files for matplotlib-pgfutils 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for matplotlib-pgfutils 1.2.0
File Size Uploaded Provenance Actions
matplotlib-pgfutils-1.2.0.tar.gz 20.6 kB Without provenance Details for matplotlib-pgfutils-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for matplotlib-pgfutils 1.2.0
File Interpreter ABI Platform Actions
matplotlib_pgfutils-1.2.0-py3-none-any.whl Python 3 none any Details for matplotlib_pgfutils-1.2.0-py3-none-any.whl

Total release size: 46.1 kB

Release files / matplotlib-pgfutils-1.2.0.tar.gz

Download URL matplotlib-pgfutils-1.2.0.tar.gz
Size 20.6 kB
Tags Source
SHA-256 checksum
How to use checksums
77559ce1984c087bd13ec50114bf6e55e22f88b2206a87dcfe032fcfc8b7c42b
BLAKE2b-256 checksum
How to use checksums
04a40479fa138219eaf8aed822f8ccbdb9683b4fcf0a92390f5ae0ea2a05cf8c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.4

Release files / matplotlib_pgfutils-1.2.0-py3-none-any.whl

Download URL matplotlib_pgfutils-1.2.0-py3-none-any.whl
Size 25.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fc6dd984c55b00cace1e3d8d19762f7d22d91d4afd508bc210acecbe5ff83803
BLAKE2b-256 checksum
How to use checksums
f52b3bc9038a2aa25548e26214cb6ccbb65f32d2abd9f5d0623715a6ac3eed1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.4

Security for matplotlib-pgfutils 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page