Warning
As of version 1.0.0, you need to add import lovelyplots before setting the style (plt.style.use('ipynb')).
LovelyPlots is a repository containing matplotlib style sheets to nicely format figures for scientific papers, thesis and presentations while keeping them fully editable in Adobe Illustrator. Additonaly, .svg exports options allows figures to automatically adapt their font to your document’s font. For example, .svg figures imported in a .tex file will automatically be generated with the text font used in your .tex file.
# to install latest PyPI release
pip install LovelyPlots
# to install latest GitHub commit
pip install --upgrade git+https://github.com/killiansheriff/LovelyPlots.gitThe pip installation will move all of the matplotlib style files *.mplstyle into the appropriate matplotlib directory.
LovelyPlots main style is called ipynb. To use it, add the following lines to the begining of your python scripts:
import lovelyplots
import matplotlib.pyplot as plt
plt.style.use('ipynb')Styles can be combined:
import lovelyplots
import matplotlib.pyplot as plt
plt.style.use(['ipynb','colorsblind34'])In the above case, the ipynb default color cycle will be overwritten by a 34 colors colorblind safe color cycle called colorsblind34.
If you only wish to apply a style on a specific plot, this can be achieved using:
import lovelyplots
import matplotlib.pyplot as plt
with plt.style.context('ipynb'):
fig, ax = plt.subplots()
ax.plot(x, y)A few styles are presented here, please see Styles for a list of all implemented styles. The script used to generate these plots can be found here.
use_mathtext style, Adobe Illustrator might fail to nicely detect text objects. Please see here for work arounds.
The ['ipynb', 'use_mathtext'] style:
The ['ipynb', 'use_mathtext','colors10-markers'] style:
The ['ipynb', 'use_mathtext','colors5-light'] style:
The ['ipynb', 'use_mathtext', 'colors10-ls'] style:
The ['ipynb'] style:
The ['paper', 'use_mathtext'] style:
LovelyPlots main style is called ipynb. The latter by default sets the figure size to (4.5, 3.46) inches, uses the default matplotlib font, activate scientific notation and makes sure your matplotlib exports will be editable in Adobe Illustrator. Its default color cycle was set to colors10.
A multitude of color cycles were implemented:
colors5-light
colors5
colors10
colorsblind10
colorsblind34
Can be seen here.
Line styles, markers styles and combinations can be set using the following styles: ls5, marker7, colors10-ls, colors10-markers.
Default matplotlib colormaps were implemented and can be used by adding the following styles: cmap-viridis, cmap-inferno, cmap-cividis, cmap-magma, cmap-plasma.
Specific matplotlibrc parameters can be turned on/off using the following utilities styles: svg_no_fonttype, use_mathtex, use_tex.
By default the ipynb style uses the default matplotlib font. However, one can set its favorite font from a TIFF file:
import lovelyplots as lp
import matplotlib.pyplot as plt
plt.style.use('ipynb')
lp.utils.set_font('my_font.tiff')Unfortunately, mathtext (and thus nicely formated scientific notation) will mess up Adobe illustrator ability to detect text objects, and is thus not activated by default. If you wish to use it, please add the style use_mathtext.
By default, the ipynb style sets svg.fonttype: none. This allows for plots saved as .svg not to carry font information. Consequently, when opened in another environement, the plot will be generated with the default system font.
For example, this allows .svg plots imported inside a Latex file to directly be generated with the proper document font, without you having to manually edit the fonts to match your document’s font. Additonally, you can open the .svg file as text file, find the ugly 1e10 scientific notation and replace it with $10^10$ so that it is nicely formated when included in your .tex file.
An example of how to show an svg in a .tex file:
\usepackage{svg}
\begin{figure}[htbp]
\centering
\includesvg{myfig.svg}
\end{figure}For those using IPython notebooks, you can set retina display support by adding the following lines to the begining on your python script:
import lovelyplots as lp
lp.utils.set_retina()To use on Google Colab, you will need to run the following code:
!pip install lovelyplots
import lovelyplots
plt.style.reload_library()
plt.style.use('ipynb')This reprository was inspired by SciencePlots, but adds different styles and crucial functionalities for useth in .tex files and Adobe Illustrator.
If you use LovelyPlots, please cite:
@software{sheriff_lovelyplots_2022,
author = {Killian Sheriff},
title = {{LovelyPlots, a collection of matplotlib
stylesheets for scientific figures}},
month = jul,
year = 2022,
publisher = {Zenodo},
doi = {10.5281/zenodo.6903936},
}
https://github.com/killiansheriff/LovelyPlots
