pygsti.report.gate_matrix_errgen_boxplot

pygsti.report.gate_matrix_errgen_boxplot(gateMatrix, targetMatrix, size=None, save_to=None, fontSize=20, mxBasis=None, mxBasisDims=None, xlabel=None, ylabel=None, title=None, boxLabels=False, prec=0)

Creates a color box plot of a the error generator of a gate matrix.

The error generator is given by log( inv(targetMatrix) * gateMatrix ). This can be a useful way to display large matrices which have so many entries that their entries cannot easily fit within the width of a page.

Parameters:
  • gateMatrix (ndarray) – The gate matrix data used when constructing the generator.
  • targetMatrix (ndarray) – The target gate matrix data to use when constructing the the generator.
  • size (tuple, optional) – The (width,height) figure size in inches. None enables automatic calculation based on gateMatrix size.
  • save_to (str, optional) – save figure as this filename (usually ending in .pdf)
  • fontSize (int, optional) – size of font for title
  • mxBasis (str, optional) – The name abbreviation for the basis. Typically in {“pp”,”gm”,”std”}. Used to label the rows & columns. If you don’t want labels, leave as None.
  • mxBasisDims (int or list, optional) – The dimension of the density matrix space this basis spans, or a list specifying the dimensions of terms in a direct-sum decomposition of the density matrix space. Used to label the rows & columns. If you don’t want labels, leave as None.
  • xlabel (str, optional) – An x-axis label for the plot.
  • ylabel (str, optional) – A y-axis label for the plot.
  • title (str, optional) – A title for the plot.
  • boxLabels (bool, optional) – Whether box labels are displayed. If False, then a colorbar is displayed to the right of the box plot.
  • prec (int or {‘compact’,’compacthp’}, optional) –

    Precision for box labels. Only relevant when boxLabels == True. Allowed values are:

    • ‘compact’ = round to nearest whole number using at most 3 characters
    • ‘compacthp’ = show as much precision as possible using at most 3 characters
    • int >= 0 = fixed precision given by int
    • int < 0 = number of significant figures given by -int
Returns:

Return type:

ReportFigure