z i9ySrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSK JrJr SSKJr SS KJr SS KJr S S KJr S S KJr S SKJr S SKJr \R@(a SSKJ!r! SSK J"r" \RF"\$5r%SSSjjr&SSjr'\RPRSS5\RTRSS5\RVRSS5SSj555r,SSjr-SSjr.g)a8 Module for the primary interface to the circuit drawers. This module contains the end user facing API for drawing quantum circuits. There are 3 available drawer backends: 0. ASCII art 1. LaTeX 2. Matplotlib This provides a single function entry point to drawing a circuit object with any of the backends. ) annotationsN)warn) user_config) ControlFlowOpMeasure) optionals)VisualizationError)_trim)_utils)latex) matplotlib)text)Any)QuantumCircuitc^Sn[US5n[R"5nSnSnURSS5nURSS5nU(aGURS S5nUS:Xa[R (aS nOSnUcURS S5nUcUnUcUnU cUn [ U [5(a7U S:Xa"[US 5=(a URSLn O[S U S35eUcUnUbU(a [S5eUnUb[U5nURUR-nUURU4;a[SUSURSUS35e[[U55[U5:wa [S5eUUR:Xa"U[[!URU55-nUR"(ahU(dUb^[U=(d /5R%[[!UR555(dU(a['S[(S5 SnU4SjmT"X5nUS:Xa[+UUUUUU U U U UUUUUS9$US:Xa[-UUUUUUUU U UUUS9 nOJUS:Xa[/UUUUUUUU U UUUS9 $US :Xa4UUUUUUU U U U UUUUUS.6nO[SUS35eU(aU(aUR35 U$)a<Draw the quantum circuit. Use the output parameter to choose the drawing format: **text**: ASCII art TextDrawing that can be printed in the console. **mpl**: images with color rendered purely in Python using matplotlib. **latex**: high-quality images compiled via latex. **latex_source**: raw uncompiled latex output. .. warning:: Support for :class:`~.expr.Expr` nodes in conditions and :attr:`.SwitchCaseOp.target` fields is preliminary and incomplete. The ``text`` and ``mpl`` drawers will make a best-effort attempt to show data dependencies, but the LaTeX-based drawers will skip these completely. Args: circuit: The circuit to visualize. scale: Scale of image to draw (shrink if ``< 1.0``). Only used by the ``mpl``, ``latex`` and ``latex_source`` outputs. Defaults to ``1.0``. filename: File path to save image to. Defaults to ``None`` (result not saved in a file). style: Style name, file name of style JSON file, or a dictionary specifying the style. * The supported style names are ``"iqp"`` (default), ``"iqp-dark"``, ``"clifford"``, ``"textbook"`` and ``"bw"``. * If given a JSON file, e.g. ``my_style.json`` or ``my_style`` (the ``.json`` extension may be omitted), this function attempts to load the style dictionary from that location. Note, that the JSON file must completely specify the visualization specifications. The file is searched for in ``qiskit/visualization/circuit/styles``, the current working directory, and the location specified in ``~/.qiskit/settings.conf``. * If a dictionary, every entry overrides the default configuration. If the ``"name"`` key is given, the default configuration is given by that style. For example, ``{"name": "textbook", "subfontsize": 5}`` loads the ``"texbook"`` style and sets the subfontsize (e.g. the gate angles) to ``5``. * If ``None`` the default style ``"iqp"`` is used or, if given, the default style specified in ``~/.qiskit/settings.conf``. output: Select the output method to use for drawing the circuit. Valid choices are ``text``, ``mpl``, ``latex``, ``latex_source``. By default, the ``text`` drawer is used unless the user config file (usually ``~/.qiskit/settings.conf``) has an alternative backend set as the default. For example, ``circuit_drawer = latex``. If the output kwarg is set, that backend will always be used over the default in the user config file. interactive: When set to ``True``, show the circuit in a new window (for ``mpl`` this depends on the matplotlib backend being used supporting this). Note when used with either the `text` or the ``latex_source`` output type this has no effect and will be silently ignored. Defaults to ``False``. reverse_bits: When set to ``True``, reverse the bit order inside registers for the output visualization. Defaults to ``False`` unless the user config file (usually ``~/.qiskit/settings.conf``) has an alternative value set. For example, ``circuit_reverse_bits = True``. plot_barriers: Enable/disable drawing barriers in the output circuit. Defaults to ``True``. justify: Options are ``"left"``, ``"right"`` or ``"none"`` (str). If anything else is supplied, left justified will be used instead. It refers to where gates should be placed in the output circuit if there is an option. ``none`` results in each gate being placed in its own column. Defaults to ``left``. vertical_compression: ``high``, ``medium`` or ``low``. It merges the lines generated by the `text` output so the drawing will take less vertical room. Default is ``medium``. Only used by the ``text`` output, will be silently ignored otherwise. idle_wires: Include (or not) idle wires (wires with no circuit elements) in output visualization. The string ``"auto"`` is also possible, in which case idle wires are show except that the circuit has a layout attached. Default is ``"auto"`` unless the user config file (usually ``~/.qiskit/settings.conf``) has an alternative value set. For example, ``circuit_idle_wires = False``. with_layout: Include layout information, with labels on the physical layout. Default is ``True``. fold: Sets pagination. It can be disabled using -1. In ``text``, sets the length of the lines. This is useful when the drawing does not fit in the console. If None (default), it will try to guess the console width using ``shutil.get_terminal_size()``. However, if running in jupyter, the default line length is set to 80 characters. In ``mpl``, it is the number of (visual) layers before folding. Default is 25. ax: Only used by the `mpl` backend. An optional ``matplotlib.axes.Axes`` object to be used for the visualization output. If none is specified, a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant. initial_state: Adds :math:`|0\rangle` in the beginning of the qubit wires and :math:`0` to classical wires. Default is ``False``. cregbundle: If set to ``True``, bundle classical registers. Default is ``True``, except for when ``output`` is set to ``"text"``. wire_order: A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (``num_qubits`` + ``num_clbits``). expr_len: The number of characters to display if an :class:`~.expr.Expr` is used for the condition in a :class:`.ControlFlowOp`. If this number is exceeded, the string will be truncated at that number and '...' added to the end. measure_arrows: If True, draw an arrow from each measure box down the the classical bit or register where the measure value is placed. If False, do not draw arrow, but instead place the name of the bit or register in the measure box. Default is ``True`` unless the user config file (usually ``~/.qiskit/settings.conf``) has an alternative value set. For example, ``circuit_measure_arrows = False``. Returns: :class:`.TextDrawing` or :class:`matplotlib.figure` or :class:`PIL.Image` or :class:`str`: * ``TextDrawing`` (if ``output='text'``) A drawing that can be printed as ascii art. * ``matplotlib.figure.Figure`` (if ``output='mpl'``) A matplotlib figure object for the circuit diagram. * ``PIL.Image`` (if ``output='latex``') An in-memory representation of the image of the circuit diagram. * ``str`` (if ``output='latex_source'``) The LaTeX source code for visualizing the circuit diagram. Raises: VisualizationError: when an invalid output method is selected ImportError: when the output methods requires non-installed libraries. Example: .. plot:: :alt: Circuit diagram output by the previous code. :include-source: from qiskit import QuantumCircuit from qiskit.visualization import circuit_drawer qc = QuantumCircuit(1, 1) qc.h(0) qc.measure(0, 0) circuit_drawer(qc, output="mpl", style={"backgroundcolor": "#EEEEEE"}) NrrFcircuit_idle_wiresautocircuit_measure_arrowsTcircuit_drawermplcircuit_reverse_bits_layoutzParameter idle_wires=z unrecognized.zIThe wire_order option cannot be set when the reverse_bits option is True.zThe wire_order list (length z*) should as long as the number of qubits (z4) or the total numbers of qubits and classical bits .z6The wire_order list should not have repeated elements.zbcregbundle set to False since either reverse_bits or wire_order (over classical bit) has been set.r cd>USLagURHn[UR[5(a-URRHnT"X15SLdM g MOUR (dMb[UR[ 5(aMUSLa[S[S5 g g)NFzXCregbundle set to False since an instruction needs to refer to individual classical wireT) data isinstance operationrblocksclbitsrrRuntimeWarning)circuit cregbundleinstblockcheck_clbit_in_insts l/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/visualization/circuit/circuit_visualization.pyr(+circuit_drawer..check_clbit_in_insts  LLD$..-88!^^22E*5=F$3Z%H%HU*8&  !) filename reverse_bits plot_barriersjustifyvertical_compression idle_wires with_layoutfold initial_stater% wire_orderexpr_lenmeasure_arrowsr r,scalestyler.r-r/r1r2r4r%r5 latex_source)r9r,r:r.r-r/r1r2r3axr4r%r5r6r7zInvalid output type zH selected. The only valid choices are text, latex, latex_source, and mpl)maxr get_configget _optionalsHAS_MATPLOTLIBrstrhasattrrr len num_qubits num_clbitssetlistranger"issubsetrr#_text_circuit_drawer_latex_circuit_drawer_generate_latex_source_matplotlib_circuit_drawershow)r$r9r,r:output interactiver.r-r/r0r1r2r3r<r4r%r5r6r7imageconfigdefault_outputdefault_reverse_bitsdefault_idle_wiresdefault_measure_arrowscomplete_wire_orderwire_order_lentotal_wire_lenr(s @r)rr8st E8QH  # # %FN $8&A#ZZ(@$G $4f= V #((!&!'  #)::.De#L  ~+ ' *c""   )4PD9PJ$'?))0););(<=>>L=MQP  s: 3z? 2$%]^ ^ W// /",tE':L:Ln4]/^"^   Z3J$"%..s59K9K3L/MNN  5    (%W9J # %'!5!#'!*)  7 % '%!#'!*   > !% '%!#'!*   5*  '%!#'!*)! &!"6(+5 5    Lr+c[R"UUUUU US9unnn[R"UUUUUU U U UU US9 nUUlUUlUUlU(aURXS9 U$)aDraws a circuit using ascii art. Args: circuit (QuantumCircuit): Input circuit filename (str): Optional filename to write the result reverse_bits (bool): Rearrange the bits in reverse order. plot_barriers (bool): Draws the barriers when they are there. justify (str) : `left`, `right` or `none`. Defaults to `left`. Says how the circuit should be justified. vertical_compression (string): `high`, `medium`, or `low`. It merges the lines so the drawing will take less vertical room. Default is `high`. idle_wires (bool): Include idle wires. Default is True. with_layout (bool): Include layout information with labels on the physical layout. Default: True fold (int): Optional. Breaks the circuit drawing to this length. This is useful when the drawing does not fit in the console. If None (default), it will try to guess the console width using `shutil.get_terminal_size()`. If you don't want pagination at all, set `fold=-1`. initial_state (bool): Optional. Adds |0> in the beginning of the line. Default: `False`. cregbundle (bool): Optional. If set True, bundle classical registers. Default: ``True``. encoding (str): Optional. Sets the encoding preference of the output. Default: ``sys.stdout.encoding``. wire_order (list): Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (num_qubits + num_clbits). expr_len (int): Optional. The number of characters to display if an :class:`~.expr.Expr` is used for the condition in a :class:`.ControlFlowOp`. If this number is exceeded, the string will be truncated at that number and '...' added to the end. measure_arrows: If True, draw an arrow from each measure box down the the classical bit or register where the measure value is placed. If False, do not draw arrow, but instead place the name of the bit or register in the measure box. Returns: TextDrawing: An instance that, when printed, draws the circuit in ascii art. Raises: VisualizationError: When the filename extension is not .txt. r-r/r1r5r7)r-r4r%encodingr2r6r7)r])r _get_layered_instructions_text TextDrawing plotbarriers line_lengthr0dump)r$r,r-r.r/r0r1r2r3r4r%r]r5r6r7qubitsr"nodes text_drawings r)rKrKst#<<!% FFE$$ !#% L!.L#L(=2.6.0 of the qcircuit LaTeX package. Args: circuit (QuantumCircuit): a quantum circuit scale (float): scaling factor style (dict or str): dictionary of style or file name of style file filename (str): file path to save image to reverse_bits (bool): When set to True reverse the bit order inside registers for the output visualization. plot_barriers (bool): Enable/disable drawing barriers in the output circuit. Defaults to True. justify (str) : `left`, `right` or `none`. Defaults to `left`. Says how the circuit should be justified. idle_wires (bool): Include idle wires. Default is True. with_layout (bool): Include layout information, with labels on the physical layout. Default: True initial_state (bool): Optional. Adds |0> in the beginning of the line. Default: `False`. cregbundle (bool): Optional. If set True, bundle classical registers. On by default, if this is possible for the given circuit, otherwise off. wire_order (list): Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (num_qubits + num_clbits). Returns: PIL.Image: an in-memory representation of the circuit diagram Raises: MissingOptionalLibraryError: if pillow, pdflatex, or poppler are not installed VisualizationError: if one of the conversion utilities failed for some internal or file-access reason. r)Imager$z.texr8pdflatexz-halt-on-errorz-output-directory=T)stdoutstderrcheckz$`pdflatex` command could not be run.Nzlatex_error.logwbzUnable to compile LaTeX. Perhaps you are missing the `qcircuit` package. The output from the `pdflatex` command is in `latex_error.log`.z7`pdflatex` call did not succeed: see `latex_error.log`. pdftocairoz -singlefilez-pngz-qz.pdf)rlz(`pdftocairo` failed to produce an image.z.pngz'Pillow could not write the image file 'z'.)PILrhtempfileTemporaryDirectoryospathjoinrM subprocessrunPIPEDEVNULLOSErrorr CalledProcessErroropenwriterjloggerwarning trim_imageendswithshutilmovesave ValueError)r$r9r:r,r.r-r/r1r2r4r%r5rh tmpfilename tmpdirnametmppathexc error_filebasemessagerRs r)rLrLs>fK  $ $ &*'',,z+?@ '%!#'!!   NN$( 5"V+,  "!)) 2ww||J4 7 NN}fdD6M4P  4&=)5!   (( D6M84JJx( C ' &: V%%KLRU U,, '.*  ,/.. NNS %I   667 7@G NN7 #$W-3 6 7#G,,A(2N{ ' &s7I >EI 4GAI *H#;I  G EG3 G?F$ G$ F2 .(GGI H 8#HH  I #I3III  Ic [R"UUUUU S9upn[R"U U UUUUUU U UUS9 nUR 5nU(a([ US5nUR U5 SSS5 U$U$!,(df  U$=f)aConvert QuantumCircuit to LaTeX string. Args: circuit (QuantumCircuit): a quantum circuit scale (float): scaling factor style (dict or str): dictionary of style or file name of style file filename (str): optional filename to write latex reverse_bits (bool): When set to True reverse the bit order inside registers for the output visualization. plot_barriers (bool): Enable/disable drawing barriers in the output circuit. Defaults to True. justify (str) : `left`, `right` or `none`. Defaults to `left`. Says how the circuit should be justified. idle_wires (bool): Include idle wires. Default is True. with_layout (bool): Include layout information, with labels on the physical layout. Default: True initial_state (bool): Optional. Adds |0> in the beginning of the line. Default: `False`. cregbundle (bool): Optional. If set True, bundle classical registers. wire_order (list): Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (num_qubits + num_clbits). Returns: str: Latex string appropriate for writing to file. )r-r/r1r5)r:r-r.r4r%r2r$wN)r r^_latex QCircuitImagerr{r|)r$r,r9r:r-r.r/r1r2r4r%r5rdr"reqcimgr latex_files r)rMrMVsP#<<! FE    !## E KKME (C J   U #! L5L!  Ls A;; B c[R"UUUUU US9unnnU cSn [R"UUUUUUUUU U U U UUUS9nUR U5$)a3 Draw a quantum circuit based on matplotlib. If `%matplotlib inline` is invoked in a Jupyter notebook, it visualizes a circuit inline. We recommend `%config InlineBackend.figure_format = 'svg'` for the inline visualization. Args: circuit (QuantumCircuit): a quantum circuit scale (float): scaling factor filename (str): file path to save image to style (dict or str): dictionary of style or file name of style file reverse_bits (bool): When set to True, reverse the bit order inside registers for the output visualization. plot_barriers (bool): Enable/disable drawing barriers in the output circuit. Defaults to True. justify (str): `left`, `right` or `none`. Defaults to `left`. Says how the circuit should be justified. idle_wires (bool): Include idle wires. Default is True. with_layout (bool): Include layout information, with labels on the physical layout. Default: True. fold (int): Number of vertical layers allowed before folding. Default is 25. ax (matplotlib.axes.Axes): An optional Axes object to be used for the visualization output. If none is specified, a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant. initial_state (bool): Optional. Adds |0> in the beginning of the line. Default: `False`. cregbundle (bool): Optional. If set True bundle classical registers. Default: ``True``. wire_order (list): Optional. A list of integers used to reorder the display of the bits. The list must have an entry for every bit with the bits in the range 0 to (num_qubits + num_clbits). expr_len (int): Optional. The number of characters to display if an :class:`~.expr.Expr` is used for the condition in a :class:`.ControlFlowOp`. If this number is exceeded, the string will be truncated at that number and '...' added to the end. measure_arrows: If True, draw an arrow from each measure box down the the classical bit or register where the measure value is placed. If False, do not draw arrow, but instead place the name of the bit or register in the measure box. Returns: matplotlib.figure: a matplotlib figure object for the circuit diagram if the ``ax`` kwarg is not set. r\) r9r:r-r.r3r<r4r%r2r6r7)r r^ _matplotlibMatplotlibDrawerdraw)r$r9r,r:r.r-r/r1r2r3r<r4r%r5r6r7rdr"reqcds r)rNrNsx#<<!% FFE |  & & !#  #% C" 88H r+)NNNNFTNNmediumNTNNFNNN)&r$rr9z float | Noner, str | Noner:zdict | str | NonerPrrQboolr.rr- bool | Noner/rr0rr1zbool | str | Noner2rr3z int | Noner<z Any | Noner4rr%rr5zlist[int] | Noner6intr7r)NFTNhighTTNTNNNrT) ffffff?NNTFNTTFNN) NrNFTNTTFNN)NNNTFNTTNNFNNrN)/__doc__ __future__rloggingrrrrurptypingwarningsrqiskitrqiskit.circuitrr qiskit.utilsrr@ exceptionsr utilsr rr rrrrrr_ TYPE_CHECKINGrr getLogger__name__r}rrK HAS_PDFLATEXrequire_in_callHAS_PDFTOCAIROHAS_PILrLrMrNr+r)rs #  10+'' -   8 $ # $'/$("#'"&+        %"  !"#$%&!'()* +R     Uz (()@A **+BC ##$;<    t=DBtr  AV       !Xr+