z i; SrSSKrSSKJrJrJrJrJr SSKJ r J r SSK J r SSK JrJr S\R S\\\4S \\\R$\R&44S jrSS\R S\\\4S \\ S \\R$4S jjrS \lS\R S\\\4S \\R$4SjrS\R0S\\\4S \\R&4SjrSS\R0S\\\4S \\ S \\R$4SjjrS \lS\R6S\\\4S \\R84SjrS\R<S\\\4S \\R>4Sjr g)a A collection of functions that generate drawings from formatted input data. See :py:mod:`~qiskit.visualization.timeline.types` for more info on the required data. An end-user can write arbitrary functions that generate custom drawings. Generators in this module are called with the `formatter` kwarg. This data provides the stylesheet configuration. There are 4 types of generators in this module. 1. generator.gates In this stylesheet entry the input data is `types.ScheduledGate` and generates gate objects such as time buckets and gate name annotations. The function signature of the generator is restricted to: ```python def my_object_generator( gate: types.ScheduledGate, formatter: Dict[str, Any]) -> List[ElementaryData]: # your code here: create and return drawings related to the gate object. ``` If a generator object has the attribute ``accepts_program`` set to ``True``, then the generator will be called with an additional keyword argument ``program: QuantumCircuit``. 2. generator.bits In this stylesheet entry the input data is `types.Bits` and generates timeline objects such as zero line and name of bit associated with the timeline. The function signature of the generator is restricted to: ```python def my_object_generator( bit: types.Bits, formatter: Dict[str, Any]) -> List[ElementaryData]: # your code here: create and return drawings related to the bit object. ``` If a generator object has the attribute ``accepts_program`` set to ``True``, then the generator will be called with an additional keyword argument ``program: QuantumCircuit``. 3. generator.barriers In this stylesheet entry the input data is `types.Barrier` and generates barrier objects such as barrier lines. The function signature of the generator is restricted to: ```python def my_object_generator( barrier: types.Barrier, formatter: Dict[str, Any]) -> List[ElementaryData]: # your code here: create and return drawings related to the barrier object. ``` If a generator object has the attribute ``accepts_program`` set to ``True``, then the generator will be called with an additional keyword argument ``program: QuantumCircuit``. 4. generator.gate_links In this stylesheet entry the input data is `types.GateLink` and generates barrier objects such as barrier lines. The function signature of the generator is restricted to: ```python def my_object_generator( link: types.GateLink, formatter: Dict[str, Any]) -> List[ElementaryData]: # your code here: create and return drawings related to the link object. ``` If a generator object has the attribute ``accepts_program`` set to ``True``, then the generator will be called with an additional keyword argument ``program: QuantumCircuit``. Arbitrary generator function satisfying the above format can be accepted. Returned `ElementaryData` can be arbitrary subclasses that are implemented in the plotter API. N)ListUnionDictAnyOptional)QubitQuantumCircuit) CircuitError)typesdrawingsgate formatterreturnc [URR55nURR =(d SnURR UURURURUSR[[URR55S.nUSRURR US5nURS:aUSUUSUS S .nURR S :Xa[RR nO[RR"n[$R&"UURURUR-/S US -SUS -/URUR(UUS9nU/$USUUSSSS.nUSn USn [$R*"[R,R.URUR(URSU U US9nU/$![[4a SnGNf=f![a SnGNf=f)aGenerate time bucket or symbol of scheduled gate. If gate duration is zero or frame change a symbol is generated instead of time box. The face color of gates depends on the operand type. Stylesheet: - The `gate` style is applied for finite duration gate. - The `frame_change` style is applied for zero duration gate. - The `gate_face_color` style is applied for face color. Args: gate: Gate information source. formatter: Dictionary of stylesheet settings. Returns: List of `TextData` or `BoxData` drawings. zn/a, )namelabelbitst0durationunitary parameters color.gatescolor.default_gaterz layer.gatez alpha.gatezline_width.gate)zorder facecoloralpha linewidthdelayzbox_height.gate?) data_typexvalsyvalsbitmetastyleszlayer.frame_changeztext_size.frame_changecenterrcolorsizevahazunicode_symbol.frame_changezlatex_symbol.frame_change)r"r%xvalyvaltextlatexr')stroperand to_matrixAttributeErrorr rrrrrjoinmapparamsgetr BoxTypeDELAY SCHED_GATEr BoxData bit_positionTextData SymbolTypeFRAME) r rrrr&r*r'r"drawingunicode_symbol latex_symbols b/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/visualization/timeline/generators.pygen_sched_gaterFqs8*dll,,./ ""+e  !! ggMMiiC)<)< => D m $ ( ():):IFZ<[ \E }}q -|,"#45   <<   ' ++I 00I""77DGGdmm34)$566iHY>Z8Z[ $++,  < 9' 4567  ##@A !<= ##&&,, $++,  9E L ) s"#HH8H54H58 IIprogramc ^URS:aSnSnOSnUSnUSUSUSUSS.nS URRS 3nUS RURRU5nURRnUn [ UR 5S :a]Tc#S R SUR 55n O%S R U4SjUR 55n USU S3- nU SU S3- n /n URRH n U R[U 5S5 M" S R U 5n U (a,URRS:waUSU S3- nU SU S3- n URS:a&USURS3- nU SURS3- n URRS:Xa[RRnO[RRn[R "UUR"SUR--UUR UR$UU US9nU/$![a U RU 5 GM[f=f)aGenerate gate name. Parameters and associated bits are also shown. Stylesheet: - `gate_name` style is applied. - `gate_latex_repr` key is used to find the latex representation of the gate name. Args: gate: Gate information source. formatter: Dictionary of stylesheet settings. program: Optional program that the bits are a part of. Returns: List of `TextData` drawings. rr(bottomlabel_offset.frame_changelayer.gate_namecolor.gate_nametext_size.gate_namer){\rm }latex_symbol.gatesrc3P# UHn[[U55SSv M g7f)N)r2id).0r%s rE %gen_full_gate_name..s HisRWbc!2is$&c3\># UH!nTRU5Rv M# g7fN)find_bitindex)rUr%rGs rErVrWs( WYcG$4$4S$9$?$?#@!AYs),[]z.2fr()r!r"r.r/r%r0r1r')rr3rr9lenrr6r8appendfloat ValueErrorr LabelTyper; GATE_NAMEr r?rr>)r rrGv_alignv_posr' default_name latex_name label_plain label_latexbits_strr8val params_strr"rBs ` rEgen_full_gate_namerpsy& }}q56-.,-/0 FT\\../r2L/044T\\5F5F UJ\\&&'K \K 499~ ?yy Hdii HHHyy WTYY WWH8*A& 8*A& F||"" $ MMU3Z, .# 6"Jdll''72:,a(( :,a((  }}q4==/++ 4==/++  ||G#OO)) OO--  WWsT]]* *  IId'' ( G 9; $ MMSE # # $sII65I6Tc PURS:aSnSnOSnUSnUSUSUSUSS.nS URRS 3nUS RURRU5nURRnUnURRS :Xa[R R n O[R Rn [R"U URS UR--UURURUUUS9n U /$)a@Generate gate name. Only operand name is shown. Stylesheet: - `gate_name` style is applied. - `gate_latex_repr` key is used to find the latex representation of the gate name. Args: gate: Gate information source. formatter: Dictionary of stylesheet settings. Returns: List of `TextData` drawings. rr(rIrJrKrLrMr)rNrOrPrr!r`) rr3rr9r rer;rfr r?rrr>) r rrgrhr'rirjrkrlr"rBs rEgen_short_gate_namerr*s.$ }}q56-.,-/0 FT\\../r2L/044T\\5F5F UJ\\&&'KLK ||G#OO)) OO--  WWsT]]* *  IId'' ( G 9r%cUSUSUSUSS.n[R"[RR[R R [R R/SUS-SUS-/UUS 9nU/$) zGenerate time slot of associated bit. Stylesheet: - `timeslot` style is applied. Args: bit: Bit object associated to this drawing. formatter: Dictionary of stylesheet settings. Returns: List of `BoxData` drawings. zlayer.timeslotzalpha.timeslotzline_width.timeslotzcolor.timeslot)rrrrr zbox_height.timeslotr!r"r#r$r%r')r r=r r:TIMELINEAbstractCoordinateLEFTRIGHT)r%rr'rBs rE gen_timeslotrzfs,-+,45/0 F--(('',,e.F.F.L.LMi 566iH]>^8^_  G 9rsc jUSUSUSSSS.nUc5[R"SSS 9 [U[5(aS OS nS US 3nOUR U5nUR (aPUR SSR nS UR SSRSUR SSS 3nO,[U[5(aS OS nS USURS 3n[R"[RR[RRSUUUUS9nU/$)aGenerate bit label. Stylesheet: - `bit_name` style is applied. Args: bit: Bit object associated to this drawing. formatter: Dictionary of stylesheet settings. program: Optional program that the bits are a part of. Returns: List of `TextData` drawings. zlayer.bit_namezcolor.bit_nameztext_size.bit_namer(rightr)z;bits cannot be accurately named without passing a 'program') stacklevelqcrNrOrz}_{rQr`)warningswarn isinstancerrZ registersrprefixr[r r?r reBIT_NAMErwrx)r%rrGr'rkrllocrBs rE gen_bit_namers?&,-+,./ F S`ab'U33c  }B/ s# ==--+A.33K#CMM"$5a$8$?$?#@cmmTVFWXYFZE[[]^K!+C!7!7#SK#K=cii[CK//**  % % * *   G 9rsbarriercUSUSUSUSUSS.n[R"[RRUR UR /SS/UR URUS 9nU/$) zGenerate barrier line. Stylesheet: - `barrier` style is applied. Args: barrier: Barrier instruction. formatter: Dictionary of stylesheet settings. Returns: List of `LineData` drawings. z alpha.barrierz layer.barrierzline_width.barrierzline_style.barrierz color.barrierrrr linestyler*r r!ru)r LineDatar LineTypeBARRIERrrr>)rrr'rBs rE gen_barrierrs?+O,3434?+ F..((zz7::&Sk LL-- . G 9rslinkcUSRURUS5nUSUSUSUSUS.n[R"URUR US9nU/$) a4Generate gate link line. Line color depends on the operand type. Stylesheet: - `gate_link` style is applied. - The `gate_face_color` style is applied for line color. Args: link: Gate link object. formatter: Dictionary of stylesheet settings. Returns: List of `GateLinkData` drawings. rrzalpha.gate_linkzlayer.gate_linkzline_width.gate_linkzline_style.gate_linkr)rr.r')r9opnamer GateLinkDatarr)rrr*r'rBs rE gen_gate_linkrs{$ m $ ( (i@T6U VE,--.5656 F##PG 9rsrY)!__doc__rtypingrrrrrqiskit.circuitrr qiskit.circuit.exceptionsr qiskit.visualization.timeliner r ScheduledGater2r?r=rFrpaccepts_programrrBitsrzrBarrierrrGateLinkrrrsrErsZx33029Y   YCH~Y %!!8#3#33 45Yz_cW   W*.sCx.WCKNC[W (  Wt&*"9   9*.sCx.9 (  9xejjT#s(^XEUEU@VD)-1 1CH~1n %1 (   1h $ 4S>d8K\K\F]@4S>d8K`K`Fars