ProPlot registers several new fonts and includes tools for adding your own fonts. These features are described below.
Matplotlib provides a ~matplotlib.font_manager module for working with
system fonts and classifies fonts into five font families:
rc[‘font.fantasy’]. The default font family
is sans-serif, because sans-serif fonts are generally more suitable for
figures than serif fonts, and the default font name belonging to this family
is DejaVu Sans, which comes packaged with
Matplotlib uses DejaVu Sans in part because it includes glyphs for a very wide range of symbols, especially mathematical symbols. However DejaVu Sans is seldom used outside of matplotlib and (in our opinion) is not very aesthetically pleasing. To improve the font selection while keeping things consistent across different workstations, ProPlot comes packaged with the open-source TeX Gyre font series and adds them as the default entries for all of matplotlib’s font famlies:
The Century lookalike
'TeX Gyre Schola'.
The Helvetica lookalike
'TeX Gyre Heros'.
The Courier lookalike
'TeX Gyre Cursor'.
The Chancery lookalike
'TeX Gyre Chorus'.
The Avant Garde lookalike
'TeX Gyre Adventor'.
Thus after importing ProPlot, the default font will be the more conventional and aesthetically pleasing Helvetica lookalike TeX Gyre Heros. The new font priority lists for each font family are shown in the default proplotrc file.
To compare different fonts, use the ~proplot.demos.show_fonts command. By
default, this displays the sans serif fonts available on your system and
packaged with ProPlot. The sans serif table on the RTD server is shown
below. The “¤” symbol appears where characters for a particular font are
unavailable (when making plots, “¤” is replaced with the character from
a fallback font). Since most TeX Gyre fonts have limited
character sets, if your plots contain lots of mathematical symbols,
you may want to set
rc[‘font.family’] to DejaVu Sans or
Fira Math, which is packaged
Try to avoid
.ttf files with
Thin in the file name. Matplotlib
interprets fonts with the “thin” style having normal weight (see
this matplotlib issue),
causing them to override the correct normal weight versions. While ProPlot
tries to filter out these files, this cannot be done systematically. In the
below example, the “Roboto” font may be overridden by its “thin” version
because the RTD server includes this style.
import proplot as plot fig, axs = plot.show_fonts()
Using your own fonts¶
You can register your own fonts by adding files to the
directory and calling ~proplot.config.register_fonts. This command is
also called on import. To change the default font, use the
~proplot.config.rc object or modify your
the configuration section for details.
Sometimes the font you would like to use is installed, but the font file
is not stored under the matplotlib-compatible
formats. For example, several macOS fonts are unavailable because they are
.dfont collections. Also, while matplotlib nominally supports
.ttc collections, ProPlot ignores them because figures with
cannot be saved as PDFs.
You can get matplotlib to use
.ttc collections by
expanding them into individual
.ttf files with the
then saving the files in-place or in the
To find font collections, check the paths listed in
under the matplotlib.font_manager module.