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