g"dZddlmZddlmZmZddlmZddlm Z m Z ddl m Z ddl mZddlmZGd d eZd S) aH ``Instruction`` s are single operations within a :py:class:`~qiskit.pulse.Schedule`, and can be used the same way as :py:class:`~qiskit.pulse.Schedule` s. For example:: duration = 10 channel = DriveChannel(0) sched = Schedule() sched += Delay(duration, channel) # Delay is a specific subclass of Instruction ) annotations)ABCabstractmethod)Iterable) ParameterParameterExpression)Channel) PulseError)deprecate_pulse_funcceZdZdZe d2d3dZdZed4d Zed5d Z ed6dZ ee d7dZ ed5dZ ed5dZed8dZed9dZed:dZd;dZd;dZd;dZdd"Zd2d?d$Zd2d@d%ZedAd'ZdBd)ZdCd,Zd5d-Zd.Zd/ZdDd0Zd4d1Z dS)E InstructionzmThe smallest schedulable unit: a single instruction. It has a fixed duration and specified channels. Noperandstuplename str | NonecJ||_||_|dS)zInstruction initializer. Args: operands: The argument list. name: Optional display name for this instruction. N) _operands_name _validate)selfrrs [/granary/edev/quantum/lib/python3.11/site-packages/qiskit/pulse/instructions/instruction.py__init__zInstruction.__init__*s("  cj|jD]*}t|tstd|d+dS)zCalled after initialization to validate instruction data. Raises: PulseError: If the input ``channels`` are not all of type :class:`Channel`. zExpected a channel, got z instead.N)channels isinstancer r )rchannels rrzInstruction._validate:sV } P PGgw// P !NG!N!N!NOOO P P Prreturnstrc|jS)zName of this instruction.)rrs rrzInstruction.nameDs zrintc t|S)z'Unique identifier for this instruction.)idr!s rr$zInstruction.idIs$xxrc|jS)zReturn instruction operands.)rr!s rrzInstruction.operandsNs ~rtuple[Channel, ...]ct)z-Returns the channels that this schedule uses.NotImplementedErrorr!s rrzInstruction.channelsSs "!rcdS)z(Relative begin time of this instruction.rr!s r start_timezInstruction.start_timeYs qrc|jS)z&Relative end time of this instruction.)durationr!s r stop_timezInstruction.stop_time^s }rint | ParameterExpressionct)zDuration of this instruction.r(r!s rr.zInstruction.durationcs "!rtuple['Instruction', ...]cdS)zInstruction has no child nodes.r+r+r!s r _childrenzInstruction._childrenhs rr%tuple[tuple[int, 'Instruction'], ...]cDt|S)z5Iterable for getting instructions from Schedule tree.)r _instructionsr!s r instructionszInstruction.instructionsmsT''))***rrr c|j|S)z~Return duration of the supplied channels in this Instruction. Args: *channels: Supplied channels ) ch_stop_timerrs r ch_durationzInstruction.ch_durationrs !t (++rcdS)zqReturn minimum start time for supplied channels. Args: *channels: Supplied channels rr+r;s r ch_start_timezInstruction.ch_start_timezs qrcLtfd|DrjSdS)zqReturn maximum start time for supplied channels. Args: *channels: Supplied channels c3*K|] }|jvVdSN)r).0chanrs r z+Instruction.ch_stop_time..s*::tt}$::::::rr)anyr.r;s` rr:zInstruction.ch_stop_times7 ::::::: : : != qrrtime#Iterable[tuple[int, 'Instruction']]c#K||fVdS)zIterable for flattening Schedule tree. Args: time: Shifted time of this node due to parent Yields: Tuple[int, Union['Schedule, 'Instruction']]: Tuple of the form (start_time, instruction). Nr+rrFs rr7zInstruction._instructionssTlrc>ddlm}||j}|||f|S)zReturn a new schedule shifted forward by `time`. Args: time: Time to shift by name: Name of the new schedule. Defaults to name of self Returns: Schedule: The shifted schedule. rScheduleNrqiskit.pulse.schedulerLr)rrFrrLs rshiftzInstruction.shifts; 322222 <9Dxt 40000rr,c@ddlm}||j}||||f|S)aReturn a new :class:`~qiskit.pulse.Schedule` with ``schedule`` inserted within ``self`` at ``start_time``. Args: start_time: Time to insert the schedule schedule schedule (Union['Schedule', 'Instruction']): Schedule or instruction to insert name: Name of the new schedule. Defaults to name of self Returns: Schedule: A new schedule with ``schedule`` inserted with this instruction at t=0. rrKNrMrN)rr,schedulerrLs rinsertzInstruction.inserts> 322222 <9Dxz844@@@@rct|jt|jz}|j|}||||S)aReturn a new :class:`~qiskit.pulse.Schedule` with ``schedule`` inserted at the maximum time over all channels shared between ``self`` and ``schedule``. Args: schedule (Union['Schedule', 'Instruction']): Schedule or instruction to be appended name: Name of the new schedule. Defaults to name of self Returns: Schedule: A new schedule with ``schedule`` a this instruction at t=0. rM)setrr:rS)rrRrcommon_channelsrFs rappendzInstruction.appendsJdm,,s83D/E/EE t /2{{4{555rrUc^fdt}|jD]}||z}|S)z4Parameters which determine the instruction behavior.ct}t|drC|jD];}t|tr||-||z}<|S)N parameters)rUhasattrrZrradd)objparamsparam_get_parameters_recursives rr`z9Instruction.parameters.._get_parameters_recursiveswUUFsL)) C ^CCE!%33C 5))))";";E"B"BBMr)rUr)rrZopr`s @rrZzInstruction.parameterssV     UU - 8 8B 33B77 7JJrboolc*t|jS)z1Return True iff the instruction is parameterized.)rErZr!s ris_parameterizedzInstruction.is_parameterizeds4?###rotherobjectct|tstSt|t|o|j|jkS)zCheck if this Instruction is equal to the `other` instruction. Equality is determined by the instruction sharing the same operands and channels. )rr NotImplementedtyperrres r__eq__zInstruction.__eq__s@ %-- "! !%d,,P%.1PPrcTtt||j|jfSrA)hashrirrr!s r__hash__zInstruction.__hash__s!T$ZZ :;;;rc,||S)a0Return a new schedule with `other` inserted within `self` at `start_time`. Args: other (Union['Schedule', 'Instruction']): Schedule or instruction to be appended Returns: Schedule: A new schedule with ``schedule`` appended after this instruction at t=0. )rWrjs r__add__zInstruction.__add__s{{5!!!rc.|d|S)a"Return a new schedule which is the union of `self` and `other`. Args: other (Union['Schedule', 'Instruction']): Schedule or instruction to union with Returns: Schedule: A new schedule with ``schedule`` inserted with this instruction at t=0 r)rSrjs r__or__zInstruction.__or__s{{1e$$$rc,||S)zReturn a new schedule which is shifted forward by `time`. Returns: Schedule: The shifted schedule )rPrIs r __lshift__zInstruction.__lshift__s zz$rcdd|jD}|jr d|jdnd}|jjd||dS)Nz, c34K|]}t|VdSrA)r)rBras rrDz'Instruction.__repr__.. s(==SWW======rz, name=''())joinrr __class____name__)rr name_reprs r__repr__zInstruction.__repr__ sd99==t}=====/3y@+ty++++b .)BBHBiBBBBrrA)rrrr)rr)rr")rr)rr&)rr0)rr2)rr5)rr rr")r)rFr"rrG)rFr"rr)r,r"rr)rr)rrU)rrb)rerfrrb)rFr")!r} __module__ __qualname____doc__r rrpropertyrr$rrrr,r/r.r4r8r<r>r:r7rPrSrWrZrdrkrnrprrrtrr+rrr r %s      PPPXXX"""^X"XX"""X"X+++X+,,,,     11111 AAAAA$ 6 6 6 6 6X$$$$$QQQQ<<<< " " " % % %    CCCCCCrr N)r __future__rabcrrcollections.abcrqiskit.circuitrrqiskit.pulse.channelsr qiskit.pulse.exceptionsr qiskit.utils.deprecate_pulser r r+rrrs  #"""""########$$$$$$99999999))))))......====== iCiCiCiCiC#iCiCiCiCiCr