kwant.plotter.spectrum

kwant.plotter.spectrum(syst, x, y=None, params=None, mask=None, file=None, show=True, dpi=None, fig_size=None, ax=None)[source]

Plot the spectrum of a Hamiltonian as a function of 1 or 2 parameters.

This function requires either matplotlib or plotly to be installed. The default engine uses matplotlib for plotting.

Parameters
systkwant.system.FiniteSystem or callable

If a function, then it must take named parameters and return the Hamiltonian as a dense matrix.

xpair (name, values)

Parameter to ham that will be varied. Consists of the parameter name, and a sequence of parameter values.

ypair (name, values), optional

Used for 3D plots (same as x). If provided, then the cartesian product of the x values and these values will be used as a grid over which to evaluate the spectrum.

paramsdict, optional

The rest of the parameters to ham, which will be kept constant.

maskcallable, optional

Takes the parameters specified by x and y and returns True if the spectrum should not be calculated for the given parameter values.

filestring or file object or None

The output file. If None, output will be shown instead. If plotly is selected as the engine, the filename has to end with a html extension.

showbool

For matplotlib engine, whether matplotlib.pyplot.show() is to be called, and the output is to be shown immediately. For the plotly engine, a call to iplot(fig) is made if show is True. Defaults to True for both engines.

dpifloat

Number of pixels per inch. If not set the matplotlib default is used. Only for matplotlib engine. If the plotly engine is selected and this argument is not None, then a RuntimeError will be triggered.

fig_sizetuple

Figure size (width, height) in inches. If not set, the default matplotlib value is used. Only for matplotlib engine. If the plotly engine is selected and this argument is not None, then a RuntimeError will be triggered.

axmatplotlib.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. Only for matplotlib engine. If the plotly engine is selected and this argument is not None, then a RuntimeError will be triggered.

Returns
figmatplotlib figure or plotly Figure object

Previous topic

kwant.plotter.bands

Next topic

kwant.plotter.streamplot

This Page