pubplot allows you to create publication quality plots that fit elegantly in your LaTeX document.
- Make plots that match the LaTeX style you are using. Automatically adjust
plot sizes to fit in a column (or in a page) of the document. Detect text
sizes in the LaTeX document and ensures that texts inside plots use the same
size as captions or other predefined text size (e.g.,
\footnotesize
). - Document-level styles. Apply styles to a document -- instead of a global configuration. This allows you to use multiple documents with different styles at the same time. Moreover, you can easily reuse your style across different documents.
Start creating a document matching your LaTeX documentclass:
>>> from pubplot import Document
>>> from pubplot.document_classes import acm_sigconf
>>> doc = Document(acm_sigconf)
Now you can use your newly created doc
to make plots that fit well in an
ACM conference paper.
>>> fig, ax = doc.subfigures()
>>> ax.plot(range(11), range(11))
>>> fig.save('plot_name')
This will create two files plot_name.pdf
and plot_name.pgf
.
To include the generated pgf plot in your LaTeX document, make sure to include the folowing line your document preamble:
\usepackage{pgf}
Then, include the image using the following line (usually inside a figure environment):
\input{plot_name.pgf}
If you are familiar with matplotlib you will have no problem using pubplot. In
the example above, fig
should support all methods from matplotlib's Figure
class. The same is true for ax
, which works like Axes
.
For further help, check the examples and the rest of the documentation.
Make sure you have an updated LaTeX installation:
sudo apt update sudo apt install texlive-base texlive-latex-recommended texlive-fonts-recommended texlive-publishers texlive-latex-extra
Now install pubplot
using pip
:
pip install pubplot
You need a basic LaTeX installation. An easy way of getting LaTeX on a mac is through homebrew cask (although any other form of getting mactex should be fine):
brew cask install mactex
Now install pubplot
using pip
:
pip install pubplot
Optional but recommended. Matplotlib works better if you install some dependencies, if you use homebrew that can be accomplished with:
brew install libpng freetype pkg-config fontconfig