qiskit-documentation/docs/api/qiskit/0.29/qiskit.providers.aer.extens...

245 lines
7.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: SnapshotStabilizer
description: API reference for qiskit.providers.aer.extensions.SnapshotStabilizer
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.providers.aer.extensions.SnapshotStabilizer
---
# SnapshotStabilizer
<Class id="qiskit.providers.aer.extensions.SnapshotStabilizer" isDedicatedPage={true} github="https://github.com/qiskit/qiskit-aer/tree/stable/0.8/qiskit/providers/aer/extensions/snapshot_stabilizer.py" signature="SnapshotStabilizer(label, num_qubits=0)" modifiers="class">
Bases: `qiskit.providers.aer.extensions.snapshot.Snapshot`
Snapshot instruction for stabilizer method of Qasm simulator.
Create a stabilizer state snapshot instruction.
**Parameters**
* **label** (*str*) the snapshot label.
* **num\_qubits** (*int*) the instruction barrier size \[Default: 0].
**Raises**
**ExtensionError** if snapshot is invalid.
**Additional Information:**
This snapshot is always performed on all qubits in a circuit. The number of qubits parameter specifies the size of the instruction as a barrier and should be set to the number of qubits in the circuit.
<Admonition title="Note" type="note">
This instruction will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.SaveStabilizer`](qiskit.providers.aer.library.SaveStabilizer "qiskit.providers.aer.library.SaveStabilizer") instruction.
</Admonition>
## Methods
### add\_decomposition
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.add_decomposition" signature="SnapshotStabilizer.add_decomposition(decomposition)">
Add a decomposition of the instruction to the SessionEquivalenceLibrary.
</Function>
### assemble
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.assemble" signature="SnapshotStabilizer.assemble()">
Assemble a QasmQobjInstruction
</Function>
### broadcast\_arguments
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.broadcast_arguments" signature="SnapshotStabilizer.broadcast_arguments(qargs, cargs)">
Validation of the arguments.
**Parameters**
* **qargs** (*List*) List of quantum bit arguments.
* **cargs** (*List*) List of classical bit arguments.
**Yields**
*Tuple(List, List)* A tuple with single arguments.
**Raises**
**CircuitError** If the input is not valid. For example, the number of arguments does not match the gate expectation.
</Function>
### c\_if
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.c_if" signature="SnapshotStabilizer.c_if(classical, val)">
Add classical condition on register or cbit classical and value val.
</Function>
### copy
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.copy" signature="SnapshotStabilizer.copy(name=None)">
Copy of the instruction.
**Parameters**
**name** (*str*) name to be given to the copied circuit, if None then the name stays the same.
**Returns**
**a copy of the current instruction, with the name**
updated if it was provided
**Return type**
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
</Function>
### define\_snapshot\_register
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.define_snapshot_register" signature="SnapshotStabilizer.define_snapshot_register(circuit, label=None, qubits=None)" modifiers="static">
Defines qubits to snapshot for all snapshot methods
</Function>
### inverse
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.inverse" signature="SnapshotStabilizer.inverse()">
Special case. Return self.
</Function>
### is\_parameterized
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.is_parameterized" signature="SnapshotStabilizer.is_parameterized()">
Return True .IFF. instruction is parameterized else False
</Function>
### mirror
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.mirror" signature="SnapshotStabilizer.mirror()">
DEPRECATED: use instruction.reverse\_ops().
**Returns**
**a new instruction with sub-instructions**
reversed.
**Return type**
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
</Function>
### qasm
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.qasm" signature="SnapshotStabilizer.qasm()">
Return a default OpenQASM string for the instruction.
Derived instructions may override this to print in a different format (e.g. measure q\[0] -> c\[0];).
</Function>
### repeat
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.repeat" signature="SnapshotStabilizer.repeat(n)">
Creates an instruction with gate repeated n amount of times.
**Parameters**
**n** (*int*) Number of times to repeat the instruction
**Returns**
Containing the definition.
**Return type**
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
**Raises**
**CircuitError** If n \< 1.
</Function>
### reverse\_ops
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.reverse_ops" signature="SnapshotStabilizer.reverse_ops()">
For a composite instruction, reverse the order of sub-instructions.
This is done by recursively reversing all sub-instructions. It does not invert any gate.
**Returns**
**a new instruction with**
sub-instructions reversed.
**Return type**
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
</Function>
### soft\_compare
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.soft_compare" signature="SnapshotStabilizer.soft_compare(other)">
Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
**Parameters**
**other** (*instruction*) other instruction.
**Returns**
are self and other equal up to parameter expressions.
**Return type**
bool
</Function>
### validate\_parameter
<Function id="qiskit.providers.aer.extensions.SnapshotStabilizer.validate_parameter" signature="SnapshotStabilizer.validate_parameter(parameter)">
Instruction parameters has no validation or normalization.
</Function>
## Attributes
### decompositions
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.decompositions">
Get the decompositions of the instruction from the SessionEquivalenceLibrary.
</Attribute>
### definition
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.definition">
Return definition in terms of other basic gates.
</Attribute>
### duration
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.duration">
Get the duration.
</Attribute>
### label
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.label">
Return snapshot label
</Attribute>
### params
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.params">
return instruction params.
</Attribute>
### snapshot\_type
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.snapshot_type">
Return snapshot type
</Attribute>
### unit
<Attribute id="qiskit.providers.aer.extensions.SnapshotStabilizer.unit">
Get the time unit of duration.
</Attribute>
</Class>