Plotting#

For the full technical reference see Plotting

More examples of the plots with the code snippets can be found in the Bravais lattices guide.

Note

The plotting is written for the Lattice and consequently available for it's child: Crystal class.

Import#

>>> # Exact import
>>> from wulfric.lattice_plotter import MatplotlibBackend, PlotlyBackend
>>> # Recommended import
>>> from wulfric import MatplotlibBackend, PlotlyBackend

For the examples in this page we need additional import and some predefined variables:

>>> from wulfric import HEX
>>> lattice = HEX(2, 1)

Creation#

Each backend is created as any other object in Python:

>>> mb = MatplotlibBackend() 
>>> pb = PlotlyBackend() 

Plotting with Plotly#

Plotly is considered to be the main plotting backend.

The creation of the plotly backend can take one optional argument: fig:

>>> from plotly import graph_objects as go 
>>> fig = go.Figure() 
>>> pb = PlotlyBackend(fig=fig) 

The typical workflow consist in plotting one or several lattices and then showing or saving the figure:

>>> pb.plot(lattice, kind="brillouin", label="Brillouin zone", color="red") 
>>> pb.plot(lattice, kind="kpath", label="K-path", color="black") 
>>> pb.save('hex_lattice.html') 
>>> pb.show() 

Plotting with Matplotlib#

matplotlib is considered to be the secondary plotting backend.

The creation of the matplotlib backend can take one optional arguments: fig and ax:

>>> import matplotlib.pyplot as plt 
>>> fig = plt.figure(figsize=(6, 6)) 
>>> ax = fig.add_subplot(projection="3d") 
>>> mb = MatplotlibBackend(fig=fig, ax=ax) 