g fdZddlmZmZddlmZddlmZddlm Z ddl m Z Gdde Z d S) zA simulator instruction to capture output within a simulation. The types of snapshot instructions available are determined by the simulator being used. )OptionalTuple)SnapshotChannel) PulseError) Instruction)deprecate_pulse_funcc eZdZdZeddededeeffd ZdZe d efd Z e d efd Z e d e fd Z e d ee fd Ze d efdZd efdZxZS)SnapshotzNAn instruction targeted for simulators, to capture a moment in the simulation. statevectorNlabel snapshot_typenamect|_||}t||f|dS)uCreate new snapshot. Args: label: Snapshot label which is used to identify the snapshot in the output. snapshot_type: Type of snapshot, e.g., “state” (take a snapshot of the quantum state). The types of snapshots offered are defined by the simulator used. name: Snapshot name which defaults to ``label``. This parameter is only for display purposes and is not taken into account during comparison. N)operandsr)r_channelsuper__init__)selfr r r __class__s X/granary/edev/quantum/lib/python3.11/site-packages/qiskit/pulse/instructions/snapshot.pyrzSnapshot.__init__sD()) <D 5-"8tDDDDDcXt|jtstddS)zCalled after initialization to validate instruction data. Raises: PulseError: If snapshot label is invalid. z Snapshot label must be a string.N) isinstancer strrrs r _validatezSnapshot._validate,s4 $*c** A?@@ @ A Arreturnc|jdS)zLabel of snapshot.rrrs rr zSnapshot.label5}Qrc|jdS)zType of snapshot.rrs rtypez Snapshot.type:r rc|jS)zReturn the :py:class:`~qiskit.pulse.channels.Channel` that this instruction is scheduled on; trivially, a ``SnapshotChannel``. )rrs rchannelzSnapshot.channel?s }rc|jfS)z-Returns the channels that this schedule uses.)r%rs rchannelszSnapshot.channelsFs rcdS)zDuration of this instruction.rrs rdurationzSnapshot.durationKs qrcdS)z1Return True iff the instruction is parameterized.Fr)rs ris_parameterizedzSnapshot.is_parameterizedPsur)r N)__name__ __module__ __qualname____doc__rrrrrpropertyr r#rr%rr'intr*boolr, __classcell__)rs@rr r slXXEEcE#EXVY]EEEEEE AAA s   X  c   X X %0X#X$rr N) r0typingrrqiskit.pulse.channelsrqiskit.pulse.exceptionsr%qiskit.pulse.instructions.instructionrqiskit.utils.deprecate_pulserr r)rrr:s#"""""""111111......============:::::{:::::r