z i*jSrSSKJr SSKrSSKrSSKrSSKJr SSK J r J r SSK J r SSKJrJr SS KJr \S \S 0r\R(R*\R,R*SS j55rS r\R(R*\R,R*SSj55rSrSrg)z Visualization function for a pass manager. Passes are grouped based on their flow controller, and coloured based on the type of pass. ) annotationsN) optionals)BaseController GenericPass)FlowControllerLinear) AnalysisPassTransformationPass)VisualizationErrorredbluecSSKnU(d[nUR5nSnSn[UR 5R 5H&up[ XX'U5upnURU 5 M( [XSU5n U $)aQ Draws the pass manager. This function needs `pydot `__, which in turn needs `Graphviz `__ to be installed. Args: pass_manager (PassManager): the pass manager to be drawn filename (str): file path to save image to style (dict or OrderedDict): keys are the pass classes and the values are the colors to make them. An example can be seen in the DEFAULT_STYLE. An ordered dict can be used to ensure a priority coloring when pass falls into multiple categories. Any values not included in the provided dict will be filled in from the default dict raw (Bool) : True if you want to save the raw Dot output not an image. The default is False. Returns: PIL.Image or None: an in-memory representation of the pass manager. Or None if no image was generated or PIL is not installed. Raises: MissingOptionalLibraryError: when nxpd or pydot not installed. VisualizationError: If raw=True and filename=None. Example: .. plot:: :include-source: :nofigs: from qiskit import QuantumCircuit from qiskit.transpiler import generate_preset_pass_manager from qiskit.visualization import pass_manager_drawer pm = generate_preset_pass_manager(optimization_level=0) pass_manager_drawer(pm) rN) pydot DEFAULT_STYLEDot enumerateto_flow_controllertasks draw_subgraph add_subgraph make_output) pass_managerfilenamestylerawrgraph component_id prev_nodeindexcontroller_groupsubgraphoutputs i/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/visualization/pass_manager_visualization.pypass_manager_drawerr$ sL  IIKE LI#,\-L-L-N-T-T#U,9 Ee- )  8$ $V X .F McUR5Hup#[X5(dMUs $ [R5Hup#[X5(dMUs $ g)Nblack)items isinstancer)pssrtypcolors r#_get_node_colorr-_sPkkm  c  L$ $))+  c  L, r%c SSKn[[SUR55nU(d[nUR 5nSnSnSn UHn [ X 5n U cMUR[U 5S[U 5SS9n U R5RH)n [XX)U5upn U RU5 US- nM+ URU 5 M [XcU5nU$)a Draws the staged pass manager. This function needs `pydot `__, which in turn needs `Graphviz `__ to be installed. Args: pass_manager (StagedPassManager): the staged pass manager to be drawn filename (str): file path to save image to style (dict or OrderedDict): keys are the pass classes and the values are the colors to make them. An example can be seen in the DEFAULT_STYLE. An ordered dict can be used to ensure a priority coloring when pass falls into multiple categories. Any values not included in the provided dict will be filled in from the default dict raw (Bool) : True if you want to save the raw Dot output not an image. The default is False. Returns: PIL.Image or None: an in-memory representation of the pass manager. Or None if no image was generated or PIL is not installed. Raises: MissingOptionalLibraryError: when nxpd or pydot not installed. VisualizationError: If raw=True and filename=None. Example: .. plot:: :include-source: :nofigs: %matplotlib inline from qiskit.providers.fake_provider import GenericBackendV2 from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager pass_manager = generate_preset_pass_manager(3, GenericBackendV2(num_qubits=5)) pass_manager.draw() rNc USL$)N)ss r#,staged_pass_manager_drawer..s1D=r% helveticalfontnamelabel labeljustr )rlistfilterexpanded_stagesrrgetattrClusterstrrrrrr)rrrrrstagesrridxrststage stagegraphr r!r"s r#staged_pass_manager_drawerrEmsL&0,2N2NO PF  IIKE L CI )  s2wCPRG_bcJ$)$<$<$>$D$D 4A$Ec51 ''1q %E   z *X .F Mr%c (SSKnSUS3n[U[5(a.[U[5(dX`RR - nUR [U5SUSS9nUS- n[U[5(a[US /5nO;[U[5(aU/nO"[U[[45(aUnOXqU4$/n UHFn [U [5(aU RU R5 M5U RU 5 MH U GHon [U [5(aUR[U5S SS S S 9n OAUR[U5[!X5S[[#U 5R 5S S 9n UR%U 5 US- n[&R("U R*5n U SSSn U S(a[-U S5OSn[/U 5HhunnSnU[-U 5U- :aSnURUSSSUSUS9nUR%U5 US- nUR1UR3UU 55 Mj U(a UR1UR3X;55 U nGMr XqU4$)zDraw subgraph.rN[z] r4r5r6r rkzNested flow controller rectangle)r,r7r8shapesoliddashedr' ellipse)r,r7fontsizer8rJr)rr)rr __class____name__r>r?r=rr:tupleextendrappendNoder-typeadd_nodeinspectgetfullargspec__init__lenradd_edgeEdge)r rrrrArr8r!r flatten_taskstasknodearg_specargs num_optional arg_indexargnd_style input_nodes r#rrsuBKE"N33J.== ..7789}}S.E]`}aHAL"N33('26 $k 2 2!" $tUm 4 4 y00M d0 1 1   ,   & dN + +::L!$.! D::L!%d2$$t*--.! D $ ))$--8{12+3A;s8A;'A (oNIsHSY56#$$J   j ) A L   ejjT: ;%.*    ejj9 : qt 9 ,,r%cBU(a#U(aURUSS9 g[S5e[R(dU(aUR U5 g[RR S5 [ R"5nSSKJ n [RRUS5nUR U5 URU5n[R"U5 U(aURUS 5 UsSSS5 $!,(df  g=f) z Produce output for pass_manager.r)formatNz+if format=raw, then a filename is required.zpass manager drawerr)Imagezpass_manager.pngPNG)writer _optionalsHAS_PIL write_png require_nowtempfileTemporaryDirectoryPILrkospathjoinopenremovesave)rrr tmpdirnamerktmppathimages r#rrs  KKK /$%RS S   ( !""#89  $ $ &*'',,z+=>   7# '  JJx ' ' & &s A9D D)NNF)__doc__ __future__rrurYrr qiskit.utilsrrnqiskit.passmanager.base_tasksrr#qiskit.passmanager.flow_controllersrqiskit.transpiler.basepassesrr exceptionsr r HAS_GRAPHVIZrequire_in_call HAS_PYDOTr$r-rErrr0r%r#rs# 0EDI*u&8&A  (( %%:&):z  (( %%G&)GT`-Fr%