, value, colorbar=True, cmap=None, vmin=None, vmax=None, a=None, method='nearest', oversampling=3, num_lead_cells=0, file=None, show=True, dpi=None, fig_size=None, ax=None, pos_transform=None, background='#e0e0e0')

Show interpolated map of a function defined for the sites of a system.

Create a pixmap representation of a function of the sites of a system by calling mask_interpolate and show this pixmap using matplotlib.


sys : kwant.system.FiniteSystem or kwant.builder.Builder

The system for whose sites value is to be plotted.

value : function or list

Function which takes a site and returns a value if the system is a builder, or a list of function values for each system site of the finalized system.

colorbar : bool, optional

Whether to show a color bar if numerical data has to be plotted. Defaults to True. If ax is provided, the colorbar is never plotted.

cmap : matplotlib color map or None

The color map used for sites and optionally hoppings, if None, matplotlib default is used.

vmin : float, optional

The lower saturation limit for the colormap; values returned by value which are smaller than this will saturate

vmax : float, optional

The upper saturation limit for the colormap; valued returned by value which are larger than this will saturate

a : float, optional

Reference length. If not given, it is determined as a typical nearest neighbor distance.

method : string, optional

Passed to scipy.interpolate.griddata: “nearest” (default), “linear”, or “cubic”

oversampling : integer, optional

Number of pixels per reference length. Defaults to 3.

num_lead_cells : integer, optional

number of lead unit cells that should be plotted to indicate the position of leads. Defaults to 0.

file : string or file object or None

The output file. If None, output will be shown instead.

show : bool

Whether is to be called, and the output is to be shown immediately. Defaults to True.

ax : matplotlib.axes.Axes instance or None

If ax is not None, no new figure is created, but the plot is done within the existing Axes ax. in this case, file, show, dpi and fig_size are ignored.

pos_transform : function or None

Transformation to be applied to the site position.

background : matplotlib color spec

Areas without sites are filled with this color.


fig : matplotlib figure

A figure with the output if ax is not set, else None.


  • When plotting a system on a square lattice and method is “nearest”, it makes sense to set oversampling to 1. Then, each site will correspond to exactly one pixel.

Previous topic


Next topic


This Page