z iLSrSSKJr SSKrSSKJr SSKJr SSKJ r SSK J r SSK r SSKJr SS KJr SS KJr SS KJrJr SS KJr "S S5rg)aC Core module of the timeline drawer. This module provides the `DrawerCanvas` which is a collection of drawings. The canvas instance is not just a container of drawing objects, as it also performs data processing like binding abstract coordinates. Initialization ~~~~~~~~~~~~~~ The `DataCanvas` is not exposed to users as they are implicitly initialized in the interface function. It is noteworthy that the data canvas is agnostic to plotters. This means once the canvas instance is initialized we can reuse this data among multiple plotters. The canvas is initialized with a stylesheet. ```python canvas = DrawerCanvas(stylesheet=stylesheet) canvas.load_program(sched) canvas.update() ``` Once all properties are set, `.update` method is called to apply changes to drawings. Update ~~~~~~ To update the image, a user can set new values to canvas and then call the `.update` method. ```python canvas.set_time_range(2000, 3000) canvas.update() ``` All stored drawings are updated accordingly. The plotter API can access to drawings with `.collections` property of the canvas instance. This returns an iterator of drawings with the unique data key. If a plotter provides object handler for plotted shapes, the plotter API can manage the lookup table of the handler and the drawings by using this data key. ) annotationsN)Iterator)deepcopy)partial)Enum)circuit)Target)VisualizationError)drawingstypes)QiskitTimelineStylec\rSrSrSrSSjr\SSj5r\RSSj5r\SSj5r SSjr SSS jjr SS jr SSS jjr SSS jjrS rSSjrSSjrS SjrS!SjrSrg)" DrawerCanvasCzData container for drawings.cURUlURUlURUl0Ul0Ul/Ul0Ul[5Ul[5Ul SUl SUl SUl g)zCreate new data container.)rrrN) formatter generatorlayout _collections_output_datasetbitsassigned_coordinatesset disable_bits disable_types _time_rangevmaxvmin)self stylesheets \/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/visualization/timeline/core.py__init__DrawerCanvas.__init__Fs$--#-- '' ACCE') =?!.1U'*u"  c|URupX!- nXURS-- nX#URS--nXE4$)zReturn current time range to draw. Calculate net duration and add side margin to edge location. Returns: Time window considering side margin. zmargin.left_percentzmargin.right_percent)rr)rt0t1durationnew_t0new_t1s r! time_rangeDrawerCanvas.time_range`sN!!70E!FFF0F!GGG~r$cXlg)zUpdate time range to draw.N)r)r new_ranges r!r+r,qs %r$c#T# URR5ShvN gN7f)zReturn currently active entries from drawing data collection. The object is returned with unique name as a key of an object handler. When the horizontal coordinate contains `AbstractCoordinate`, the value is substituted by current time range preference. N)ritems)rs r! collectionsDrawerCanvas.collectionsvs''--///s (&(cURS(dCURVs/sH&n[U[R5(aM$UPM( snUlXR UR 'gs snf)zAdd drawing to collections. If the given object already exists in the collections, this interface replaces the old object instead of adding new entry. Args: data: New drawing to add. control.show_clbitsN)rr isinstancerClbitrdata_key)rdatabs r!add_dataDrawerCanvas.add_datasP~~34$(IIRIqZ7==5QIRDI+/$--(Ss #A1 A1Nc  ^[R4n[TS5c0SSKJn SSKJn [R"S[SS9 U"TS USS 9m[TRTR5GHupx[UR 5[UR"5-n [%U 5GHup['UR(U5(GdUbSn UR+UR(R5n U bQU R+[-U4S jUR 555nUb [US5n U bUR/U 5n URS:XaUR(R0n U c&[SUR(RSU S35eO2URS:XaUR(R0n O [S5e[2R4"UUR(U U U S9nUR6SHGn[USS5(a [9UTS9nU"XR:S9HnUR=U5 M MI [?U 5S:aU S:XaUSU --n[2R@"UUR(RU S9nUR6SHHn[USS5(a [9UTS9nU"UUR:S9HnUR=U5 M MJ ['UR([R5(dGMl[2R"XyU S9nUR6SHHn[USS5(a [9UTS9nU"UUR:S9HnUR=U5 M MJ GM GM [TR 5[TR"5-Ul!URBH]n UR6S HGn[USS5(a [9UTS9nU"XR:S9HnUR=U5 M MI M_ [ETRFUR:S!5nURISUS"9 g!Uan[S TRS 35UeSnAff=f)#aLoad quantum circuit and create drawing.. .. deprecated:: 1.3 Visualization of unscheduled circuits with the timeline drawer has been deprecated in Qiskit 1.3. This circuit should be transpiled with a scheduler, despite having instructions with explicit durations. .. deprecated:: 1.3 Targets with duration-less operations are going to error in Qiskit 2.0. Args: program: Scheduled circuit object to draw. target: The target the circuit is scheduled for. This contains backend information including the instruction durations used in scheduling. Raises: VisualizationError: When circuit is not scheduled. _op_start_timesNr) transpile)TranspilerErrorzVisualizing un-scheduled circuit with timeline drawer has been deprecated. This circuit should be transpiled with scheduler though it consists of instructions with explicit durations.) stacklevelalap)scheduling_methodtargetoptimization_levelzInput circuit z\ is not scheduled and it contains operations with unknown delays. This cannot be visualized.c3Z># UH nTRU5Rv M" g7fN)find_bitindex).0xprograms r! ,DrawerCanvas.load_program..s$%\I[Ag&6&6q&9&?&?I[s(+r(delayz&Target doesn't contain a duration for z on .zCTarget not specified this is required to provide instruction timing)r&operandr(r bit_positiongatesaccepts_programF)rL)r?)r&opnamer gate_links)r&rrRbarriersrzmargin.minimum_duration)t_startt_end)%rBarriergetattrqiskitr>qiskit.transpilerr?warningswarnDeprecationWarningr namezipop_start_timesr8listqubitsclbits enumerater5 operationgettuple seconds_to_dtr(r ScheduledGaterrrr:lenGateLinkrmax _durationset_time_range)rrLrD not_gate_liker>r?exr& instructionrbit_posbitr(op_props inst_props gate_sourcegendatumline_pos link_sourcebarrier_sourcer[s ` r! load_programDrawerCanvas.load_programs4(!* 7- . 6 ( 9 MM8#   #&,!'(  #7#9#97<<HOB **+d;3E3E.FFD )$ !+"7"7GG)#'#)::k.C.C.H.H#I#/)1 %%\I[I[%\ \*J *5+2:z+J#+#7/5/C/CH/MH&++w6'2'<'<'E'EH#+"4 H#.#8#8#=#=">d7)1!N#, %))W4#.#8#8#A#A0a#("5"5 + 5 5!)!%, #K $~~g6"3(95AA")#w"?C%(%OE MM%0&P 7 4y1}A#%h#6&+nn' 0E0E0J0JQU' $(>>,#?C&s,=uEE&-c7&C),[DNN)S $ e 4*T$@ k33W__EE%*]]bRY%ZN#~~j9"3(95AA")#w"?C%(4>>%RE MM%0&S :o!0 I~(4+?? 99C~~f-3 1599!#w7C ?EMM%(@ .G%%t~~6O'PQ AU3a# ($W\\N3QQ s Q##R)RRcX4Ulg)zSet time range to draw. Args: t_start: Left boundary of drawing in units of cycle time. t_end: Right boundary of drawing in units of cycle time. N)r+)rrZr[s r!rsDrawerCanvas.set_time_range s#*r$cU(aURRU5 gURRU5 g)zInterface method to control visibility of bits. Specified object in the blocked list will not be shown. Args: bit: A qubit or classical bit object to disable. remove: Set `True` to disable, set `False` to enable. N)radddiscard)rrxremoves r!set_disable_bitsDrawerCanvas.set_disable_bitss/     ! !# &    % %c *r$c[U[5(a[UR5nOUnU(aURR U5 gURR U5 g)zInterface method to control visibility of data types. Specified object in the blocked list will not be shown. Args: data_type: A drawing data type to disable. remove: Set `True` to disable, set `False` to enable. N)r5rstrvaluerrr)r data_typer data_type_strs r!set_disable_typeDrawerCanvas.set_disable_type!sO i & & 0M%M     " "= 1    & &} 5r$cURR5 URR5 URS*nURS"UR 5Hhn[ U[R5(aURS(dM8URU5(dMPUS- nX0RU'US- nMj SUl XRS- Ul 0n0nURR5Hupg[U5nURUR 5UlURUR"5UlUR$['[(R*R,R.5:XaXU'MXU'M UR1UR3U55 UR5H+upgUR5U5(dMXpRU'M- g)zbUpdate all collections. This method should be called before the canvas is passed to the plotter. z margin.top bit_arranger4rVrz margin.bottomN)rclearrrrrr5rr6_check_bit_visiblerrrr0r_bind_coordinatexvalsyvalsrrr LineType GATE_LINKrupdate_check_link_overlap_check_data_visible) ry0rxoffsettemp_gate_links temp_datar7r8new_datas r!rDrawerCanvas.update4s ""$ !!'')nn\* *;;}-dii8C#w}}--dnnEZ6[**3//#XF-3 % %c *#B9 88  "//557NH~H!224::>HN!224::>HN~~U^^%=%=%C%C!DD,4)&.(#8 11/BC(oo/NH''--15$$X.0r$c^^^^[[RRR5/m[[R R R5[[RR R5/mU4SjnU4SjnUUU4SjnX#U/n[U4SjU55(agg)zA helper function to check if the data is visible. Args: data: Drawing object to test. Returns: Return `True` if the data is visible. c>TRup[R"UR5U:d$[R"UR5U:agg)z2If data is located outside the current time range.FT)r+nprqrmin)_datar&r'rs r!_time_range_check;DrawerCanvas._check_data_visible.._time_range_checkms=__FBvvekk"R'266%+++>+Cr$cP>[U4SjUR55(agg)z#If any associated bit is not shown.c3@># UHoTR;v M g7frG)r)rJrxrs r!rMRDrawerCanvas._check_data_visible.._associated_bit_check..vsN:Cd777:sFT)allr)rrs r!_associated_bit_check?DrawerCanvas._check_data_visible.._associated_bit_checktsN5::NNNr$c>UR[[RRR 5:Xa?UR Vs/sHoTR;dMUPM nn[U5S:aggURT;aTRS(dgURT;aTRS(dggs snf)zIf data is valid.Fzcontrol.show_barrierszcontrol.show_delaysT) rrr rrrrrror)rrx active_bits _barriers_delaysrs r! _data_check5DrawerCanvas._check_data_visible.._data_checkzs#enn&>&>&D&D"EE.3jjYjstGXGX# UH o"T5v M g7frG)rJcheckr8s r!rM3DrawerCanvas._check_data_visible..s/uuT{{sTF) rr rBARRIERrBoxTypeDELAY LabelTyper)rr8rrrchecksrrs`` @@r!r DrawerCanvas._check_data_visible`s//5567 u}}**0013u7L7L7R7R3ST   $KH // / /r$c[[RRR5[[R R R5/nXR;agURS(agURR5H&nXR;dMURU;dM& g g)zA helper function to check if the bit is visible. Args: bit: Bit object to test. Returns: Return `True` if the bit is visible. Fzcontrol.show_idleT) rr r SCHED_GATEr SymbolTypeFRAMErrrvaluesrr)rrx_gatesr8s r!rDrawerCanvas._check_bit_visiblesemm..445s5;K;K;Q;Q;W;W7XY ## # >>- .%%,,.DiiDNNf$</r$c ^SU4Sjjn[R"U[S9$![a. [R"[ [ X!55[S9s$f=f)zA helper function to bind actual coordinates to an `AbstractCoordinate`. Args: vals: Sequence of coordinate objects associated with a drawing. Returns: Numpy data array with substituted values. c~>U[RR:XaTRS$U[RR:XaTRS$U[RR :Xa TR $U[RR:Xa TR$[SUS35e)NrrUz Coordinate z is not supported.) r AbstractCoordinateLEFTr+RIGHTTOPrBOTTOMrr )valrs r! substitute1DrawerCanvas._bind_coordinate..substitutese..333q))e..444q))e..222yy e..555yy ${3%7I%JK Kr$)dtype)rztypes.Coordinate)rasarrayfloat TypeErrorrfmap)rvalsrs` r!rDrawerCanvas._bind_coordinatesL L H::d%0 0 H::d3z#89G G Hs$5AAc^^^TRSTRS- nTRSU-nS U4Sjjm/n[TR55n[ U5S:GaUR 5n[ 5nURU5 USSS2GHOn[R"TURSTURS- 5U:dMCT"TU5n T"TU5n [R"U 5[R"U 5- n [R"U 5[R"U 5- n [R"U 5[R"U 5- n [R"U 5[R"U 5- nX-S:a X-S:aGM URUR URU555 GMR UR[U55 [ U5S:aGM0nUHn[ U5S:a[R"UVs/sHnTURSPM sn5n[!UUU4SjS9nUS U-[ U5S- -- n[#U5HunnTUnUUU--/Ul UX'M MUSnTUX'M TR5Vs0sHoX_M sn$s snfs snf) zHelper method to check overlap of bit links. This method dynamically shifts horizontal position of links if they are overlapped. rUrzmargin.link_interval_percentc >[R"URVs/sH-nTRR U[R 5PM/ sn5$s snfrG)rarrayrrrknan)linkrxrs r!y_coords2DrawerCanvas._check_link_overlap..y_coordssD88SWS\S\]S\CT66::3GS\]^ ^]s4ANcB>[R"T"TU55$rG)rnanmax)rKlinksrs r!2DrawerCanvas._check_link_overlap..sRYYxPUVWPXGY=Zr$)keyrV)rzdrawings.GateLinkData)r+rrfkeysropoprrrabsrnanminrrIappendmeansortedri)rrr(allowed_overlapoverlapped_group data_keysref_keyoverlapsry0sy1sv1v2v3v4 new_links xpos_mean sorted_keysx0indr8rs`` @r!r DrawerCanvas._check_link_overlaps??1%(::..)GH8S _-/& )nq mmoGuH LL ! 266%...q1E#J4D4DQ4GGH?Z"5>2C"5:.C3"))C.8B3"))C.8B3"))C.8B3"))C.8BGaKBGaK Y]]9??33G%HI'  # #DN 3!)nq & (H8}q GGH$MHSU3Z%5%5a%8H$MN $X3Z[ !6#h-!:K!LL )+ 6HC :D"$s_'<"rs=%L#$+>9Hl=l=r$