gcdZddlmZddlmZddlmZddlZddl m Z ddl m Z ddl mZdd lmZGd d e ZGd dee ZGddee ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZdS)a4 .. _pulse-channels: ======================================= Channels (:mod:`qiskit.pulse.channels`) ======================================= Pulse is meant to be agnostic to the underlying hardware implementation, while still allowing low-level control. Therefore, our signal channels are *virtual* hardware channels. The backend which executes our programs is responsible for mapping these virtual channels to the proper physical channel within the quantum control hardware. Channels are characterized by their type and their index. Channels include: * transmit channels, which should subclass ``PulseChannel`` * receive channels, such as :class:`AcquireChannel` * non-signal "channels" such as :class:`SnapshotChannel`, :class:`MemorySlot` and :class:`RegisterChannel`. Novel channel types can often utilize the :class:`ControlChannel`, but if this is not sufficient, new channel types can be created. Then, they must be supported in the PulseQobj schema and the assembler. Channels are characterized by their type and their index. See each channel type below to learn more. .. autosummary:: :toctree: ../stubs/ DriveChannel MeasureChannel AcquireChannel ControlChannel RegisterSlot MemorySlot SnapshotChannel All channels are children of the same abstract base class: .. autoclass:: Channel ) annotations)ABCMeta)AnyN) Parameter)ParameterExpression) PulseError)deprecate_pulse_funcceZdZUdZdZded< fdZeddZe dd Z ddZ e ddZ ddZ e ddZdZd dZdZxZS)!ChannelaBase class of channels. Channels provide a Qiskit-side label for typical quantum control hardware signal channels. The final label -> physical channel mapping is the responsibility of the hardware backend. For instance, ``DriveChannel(0)`` holds instructions which the backend should map to the signal line driving gate operations on the qubit labeled (indexed) 0. When serialized channels are identified by their serialized name ````. The type of the channel is interpreted from the prefix, and the index often (but not always) maps to the qubit index. All concrete channel classes must have a ``prefix`` class attribute (and instances of that class have an index attribute). Base classes which have ``prefix`` set to ``None`` are prevented from being instantiated. To implement a new channel inherit from :class:`Channel` and provide a unique string identifier for the ``prefix`` class attribute. Nz str | Noneprefixcr|jtdt|S)NzTCannot instantiate abstract channel. See Channel documentation for more information.)r NotImplementedErrorsuper__new__)clsargskwargs __class__s K/granary/edev/quantum/lib/python3.11/site-packages/qiskit/pulse/channels.pyrzChannel.__new__Us; : %B  wws###indexintc>||||_dS)zKChannel class. Args: index: Index of channel. N)_validate_index_indexselfrs r__init__zChannel.__init__^s# U### rreturnint | ParameterExpressionc|jS)zReturn the index of this channel. The index is a label for a control signal line typically mapped trivially to a qubit index. For instance, ``DriveChannel(0)`` labels the signal line driving the qubit labeled with index 0. )rrs rrz Channel.indexhs {rrNonec<t|tr |jrdSt|tr2t|}|rt |}t|t t jfr|dkrtddS)zRaise a PulseError if the channel index is invalid, namely, if it's not a positive integer. Raises: PulseError: If ``index`` is not a nonnegative integer. Nrz+Channel index must be a nonnegative integer) isinstancer parametersfloat is_integerrnpintegerrrs rrzChannel._validate_indexps e0 1 1 #e6F # F 2 3 3 #%LLE!! #E %#rz!233 LuqyyJKK K8Ayrset[Parameter]cjt|jtr |jjSt S)z-Parameters which determine the channel index.)r%rrr&setr"s rr&zChannel.parameterss- dj"5 6 6 ):( (uu rboolc6t|jtS)z-Return True iff the channel is parameterized.)r%rrr"s ris_parameterizedzChannel.is_parameterizeds$*&9:::rstrc,|jj|jS)zRReturn the shorthand alias for this channel, which is based on its type and index.)rr rr"s rnamez Channel.names.'6666rc0|jjd|jdS)N())r__name__rr"s r__repr__zChannel.__repr__s .)::DK::::rotherobjectct|tstSt|t|uo|j|jkS)zReturn True iff self and other are equal, specifically, iff they have the same type and the same index. Args: other: The channel to compare to this channel. Returns: True iff equal. )r%r NotImplementedtyper)rr9s r__eq__zChannel.__eq__sA%)) "! !DzzT%[[(HT[EL-HHrcHtt||jfS)N)hashr=rr"s r__hash__zChannel.__hash__sT$ZZ-...r)rr)rr )rrrr#)rr+)rr.)rr1)r9r:rr.)r7 __module__ __qualname____doc__r __annotations__rr rpropertyrrr&r0r3r8r>rA __classcell__rs@rr r @s= FH$$$$$XLLLL$X ;;;;777X7;;; I I I I///////rr ) metaclassceZdZdZdS) PulseChannelzHBase class of transmit Channels. Pulses can be played on these channels.Nr7rBrCrDrrrKrKsRRDrrKceZdZdZdS)ClassicalIOChannelzVBase class of classical IO channels. These cannot have instructions scheduled on them.NrLrMrrrOrOs``DrrOceZdZdZdZdS) DriveChannelzFDrive channels transmit signals to qubits which enact gate operations.dNr7rBrCrDr rMrrrQrQsPP FFFrrQceZdZdZdZdS)MeasureChannelzBMeasure channels transmit measurement stimulus pulses for readout.mNrSrMrrrUrUsLL FFFrrUceZdZdZdZdS)ControlChannelzControl channels provide supplementary control over the qubit to the drive channel. These are often associated with multi-qubit gate operations. They may not map trivially to a particular qubit index. uNrSrMrrrXrXs FFFrrXceZdZdZdZdS)AcquireChannelz*Acquire channels are used to collect data.aNrSrMrrr[r[s44 FFFrr[c&eZdZdZdZfdZxZS)SnapshotChannelzBSnapshot channels are used to specify instructions for simulators.scJtddS)zCreate new snapshot channel.rN)rr)rrs rrzSnapshotChannel.__init__s! r)r7rBrCrDr rrGrHs@rr^r^sCLL Frr^ceZdZdZdZdS) MemorySlotz8Memory slot channels represent classical memory storage.rVNrSrMrrrbrbsBB FFFrrbceZdZdZdZdS) RegisterSlotzgClassical resister slot channels represent classical registers (low-latency classical memory). cNrSrMrrrdrdsFFFrrd)rD __future__rabcrtypingrnumpyr)qiskit.circuitr"qiskit.circuit.parameterexpressionrqiskit.pulse.exceptionsrqiskit.utils.deprecate_pulser r rKrOrQrUrXr[r^rbrdrMrrrnsj&&N#"""""$$$$$$BBBBBB......======d/d/d/d/d/d/d/d/d/N     7g         G    < \ \W (# %r