2857 lines
110 KiB
Plaintext
2857 lines
110 KiB
Plaintext
---
|
||
title: RawFeatureVector (v0.29)
|
||
description: API reference for qiskit.ml.circuit.library.RawFeatureVector in qiskit v0.29
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.ml.circuit.library.RawFeatureVector
|
||
---
|
||
|
||
# RawFeatureVector
|
||
|
||
<Class id="qiskit.ml.circuit.library.RawFeatureVector" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/ml/circuit/library/raw_feature_vector.py" signature="RawFeatureVector(feature_dimension)" modifiers="class">
|
||
Bases: `qiskit.circuit.library.blueprintcircuit.BlueprintCircuit`
|
||
|
||
The raw feature vector circuit.
|
||
|
||
This circuit acts as parameterized initialization for statevectors with `feature_dimension` dimensions, thus with `log2(feature_dimension)` qubits. As long as there are free parameters, this circuit holds a placeholder instruction and can not be decomposed. Once all parameters are bound, the placeholder is replaced by a state initialization and can be unrolled.
|
||
|
||
In ML, this circuit can be used to load the training data into qubit amplitudes. It does not apply an kernel transformation. (Therefore, it is a “raw” feature vector.)
|
||
|
||
Examples:
|
||
|
||
```python
|
||
from qiskit.ml.circuit.library import RawFeatureVector
|
||
circuit = RawFeatureVector(4)
|
||
print(circuit.num_qubits)
|
||
# prints: 2
|
||
|
||
print(circuit.draw(output='text'))
|
||
# prints:
|
||
# ┌──────┐
|
||
# q_0: ┤0 ├
|
||
# │ Raw │
|
||
# q_1: ┤1 ├
|
||
# └──────┘
|
||
|
||
print(circuit.ordered_parameters)
|
||
# prints: [Parameter(p[0]), Parameter(p[1]), Parameter(p[2]), Parameter(p[3])]
|
||
|
||
import numpy as np
|
||
state = np.array([1, 0, 0, 1]) / np.sqrt(2)
|
||
bound = circuit.assign_parameters(state)
|
||
print(bound.draw())
|
||
# prints:
|
||
# ┌──────────────────────────────────┐
|
||
# q_0: ┤0 ├
|
||
# │ initialize(0.70711,0,0,0.70711) │
|
||
# q_1: ┤1 ├
|
||
# └──────────────────────────────────┘
|
||
```
|
||
|
||
**Parameters**
|
||
|
||
**feature\_dimension** (`Optional`\[`int`]) – The feature dimension and number of qubits.
|
||
|
||
## Methods
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-add-bits" />
|
||
|
||
### add\_bits
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.add_bits" signature="RawFeatureVector.add_bits(bits)">
|
||
Add Bits to the circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-add-calibration" />
|
||
|
||
### add\_calibration
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.add_calibration" signature="RawFeatureVector.add_calibration(gate, qubits, schedule, params=None)">
|
||
Register a low-level, custom pulse definition for the given gate.
|
||
|
||
**Parameters**
|
||
|
||
* **gate** (*Union\[*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate")*, str]*) – Gate information.
|
||
* **qubits** (*Union\[int, Tuple\[int]]*) – List of qubits to be measured.
|
||
* **schedule** ([*Schedule*](qiskit.pulse.Schedule "qiskit.pulse.Schedule")) – Schedule information.
|
||
* **params** (*Optional\[List\[Union\[float,* [*Parameter*](qiskit.circuit.Parameter "qiskit.circuit.Parameter")*]]]*) – A list of parameters.
|
||
|
||
**Raises**
|
||
|
||
**Exception** – if the gate is of type string and params is None.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-add-register" />
|
||
|
||
### add\_register
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.add_register" signature="RawFeatureVector.add_register(*regs)">
|
||
Add registers.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-append" />
|
||
|
||
### append
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.append" signature="RawFeatureVector.append(instruction, qargs=None, cargs=None)">
|
||
Append one or more instructions to the end of the circuit, modifying the circuit in place. Expands qargs and cargs.
|
||
|
||
**Parameters**
|
||
|
||
* **instruction** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction")) – Instruction instance to append
|
||
* **qargs** (*list(argument)*) – qubits to attach instruction to
|
||
* **cargs** (*list(argument)*) – clbits to attach instruction to
|
||
|
||
**Returns**
|
||
|
||
a handle to the instruction that was just added
|
||
|
||
**Return type**
|
||
|
||
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
|
||
|
||
**Raises**
|
||
|
||
* **CircuitError** – if object passed is a subclass of Instruction
|
||
* **CircuitError** – if object passed is neither subclass nor an instance of Instruction
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-assign-parameters" />
|
||
|
||
### assign\_parameters
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.assign_parameters" signature="RawFeatureVector.assign_parameters(parameters, inplace=False)">
|
||
Call the initialize instruction.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-barrier" />
|
||
|
||
### barrier
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.barrier" signature="RawFeatureVector.barrier(*qargs)">
|
||
Apply `Barrier`. If qargs is None, applies to all.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-bind-parameters" />
|
||
|
||
### bind\_parameters
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.bind_parameters" signature="RawFeatureVector.bind_parameters(values)">
|
||
Bind parameters.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cast" />
|
||
|
||
### cast
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cast" signature="RawFeatureVector.cast(value, _type)" modifiers="static">
|
||
Best effort to cast value to type. Otherwise, returns the value.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cbit-argument-conversion" />
|
||
|
||
### cbit\_argument\_conversion
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cbit_argument_conversion" signature="RawFeatureVector.cbit_argument_conversion(clbit_representation)">
|
||
Converts several classical bit representations (such as indexes, range, etc.) into a list of classical bits.
|
||
|
||
**Parameters**
|
||
|
||
**clbit\_representation** (*Object*) – representation to expand
|
||
|
||
**Returns**
|
||
|
||
Where each tuple is a classical bit.
|
||
|
||
**Return type**
|
||
|
||
List(tuple)
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ccx" />
|
||
|
||
### ccx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ccx" signature="RawFeatureVector.ccx(control_qubit1, control_qubit2, target_qubit, ctrl_state=None)">
|
||
Apply [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ch" />
|
||
|
||
### ch
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ch" signature="RawFeatureVector.ch(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CHGate`](qiskit.circuit.library.CHGate "qiskit.circuit.library.CHGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cls-instances" />
|
||
|
||
### cls\_instances
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cls_instances" signature="RawFeatureVector.cls_instances()" modifiers="classmethod">
|
||
Return the current number of instances of this class, useful for auto naming.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cls-prefix" />
|
||
|
||
### cls\_prefix
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cls_prefix" signature="RawFeatureVector.cls_prefix()" modifiers="classmethod">
|
||
Return the prefix to use for auto naming.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cnot" />
|
||
|
||
### cnot
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cnot" signature="RawFeatureVector.cnot(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-combine" />
|
||
|
||
### combine
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.combine" signature="RawFeatureVector.combine(rhs)">
|
||
DEPRECATED - Returns rhs appended to self if self contains compatible registers.
|
||
|
||
Two circuits are compatible if they contain the same registers or if they contain different registers with unique names. The returned circuit will contain all unique registers between both circuits.
|
||
|
||
Return self + rhs as a new object.
|
||
|
||
**Parameters**
|
||
|
||
**rhs** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The quantum circuit to append to the right hand side.
|
||
|
||
**Returns**
|
||
|
||
Returns a new QuantumCircuit object
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the rhs circuit is not compatible
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-compose" />
|
||
|
||
### compose
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.compose" signature="RawFeatureVector.compose(other, qubits=None, clbits=None, front=False, inplace=False, wrap=False)">
|
||
Compose circuit with `other` circuit or instruction, optionally permuting wires.
|
||
|
||
`other` can be narrower or of equal width to `self`.
|
||
|
||
**Parameters**
|
||
|
||
* **other** ([*qiskit.circuit.Instruction*](qiskit.circuit.Instruction "qiskit.circuit.Instruction") *or*[*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") *or BaseOperator*) – (sub)circuit to compose onto self.
|
||
* **qubits** (*list\[Qubit|int]*) – qubits of self to compose onto.
|
||
* **clbits** (*list\[Clbit|int]*) – clbits of self to compose onto.
|
||
* **front** (*bool*) – If True, front composition will be performed (not implemented yet).
|
||
* **inplace** (*bool*) – If True, modify the object. Otherwise return composed circuit.
|
||
* **wrap** (*bool*) – If True, wraps the other circuit into a gate (or instruction, depending on whether it contains only unitary instructions) before composing it onto self.
|
||
|
||
**Returns**
|
||
|
||
the composed circuit (returns None if inplace==True).
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
* **CircuitError** – if composing on the front.
|
||
* **QiskitError** – if `other` is wider or there are duplicate edge mappings.
|
||
|
||
Examples:
|
||
|
||
```python
|
||
lhs.compose(rhs, qubits=[3, 2], inplace=True)
|
||
|
||
.. parsed-literal::
|
||
|
||
┌───┐ ┌─────┐ ┌───┐
|
||
lqr_1_0: ───┤ H ├─── rqr_0: ──■──┤ Tdg ├ lqr_1_0: ───┤ H ├───────────────
|
||
├───┤ ┌─┴─┐└─────┘ ├───┤
|
||
lqr_1_1: ───┤ X ├─── rqr_1: ┤ X ├─────── lqr_1_1: ───┤ X ├───────────────
|
||
┌──┴───┴──┐ └───┘ ┌──┴───┴──┐┌───┐
|
||
lqr_1_2: ┤ U1(0.1) ├ + = lqr_1_2: ┤ U1(0.1) ├┤ X ├───────
|
||
└─────────┘ └─────────┘└─┬─┘┌─────┐
|
||
lqr_2_0: ─────■───── lqr_2_0: ─────■───────■──┤ Tdg ├
|
||
┌─┴─┐ ┌─┴─┐ └─────┘
|
||
lqr_2_1: ───┤ X ├─── lqr_2_1: ───┤ X ├───────────────
|
||
└───┘ └───┘
|
||
lcr_0: 0 ═══════════ lcr_0: 0 ═══════════════════════
|
||
|
||
lcr_1: 0 ═══════════ lcr_1: 0 ═══════════════════════
|
||
```
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-control" />
|
||
|
||
### control
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.control" signature="RawFeatureVector.control(num_ctrl_qubits=1, label=None, ctrl_state=None)">
|
||
Control this circuit on `num_ctrl_qubits` qubits.
|
||
|
||
**Parameters**
|
||
|
||
* **num\_ctrl\_qubits** (*int*) – The number of control qubits.
|
||
* **label** (*str*) – An optional label to give the controlled operation for visualization.
|
||
* **ctrl\_state** (*str or int*) – The control state in decimal or as a bitstring (e.g. ‘111’). If None, use `2**num_ctrl_qubits - 1`.
|
||
|
||
**Returns**
|
||
|
||
The controlled version of this circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – If the circuit contains a non-unitary operation and cannot be controlled.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-copy" />
|
||
|
||
### copy
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.copy" signature="RawFeatureVector.copy(name=None)">
|
||
Copy the circuit.
|
||
|
||
**Parameters**
|
||
|
||
**name** (*str*) – name to be given to the copied circuit. If None, then the name stays the same
|
||
|
||
**Returns**
|
||
|
||
a deepcopy of the current circuit, with the specified name
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-count-ops" />
|
||
|
||
### count\_ops
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.count_ops" signature="RawFeatureVector.count_ops()">
|
||
Count each operation kind in the circuit.
|
||
|
||
**Returns**
|
||
|
||
a breakdown of how many operations of each kind, sorted by amount.
|
||
|
||
**Return type**
|
||
|
||
OrderedDict
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cp" />
|
||
|
||
### cp
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cp" signature="RawFeatureVector.cp(theta, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CPhaseGate`](qiskit.circuit.library.CPhaseGate "qiskit.circuit.library.CPhaseGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-crx" />
|
||
|
||
### crx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.crx" signature="RawFeatureVector.crx(theta, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CRXGate`](qiskit.circuit.library.CRXGate "qiskit.circuit.library.CRXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cry" />
|
||
|
||
### cry
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cry" signature="RawFeatureVector.cry(theta, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CRYGate`](qiskit.circuit.library.CRYGate "qiskit.circuit.library.CRYGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-crz" />
|
||
|
||
### crz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.crz" signature="RawFeatureVector.crz(theta, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CRZGate`](qiskit.circuit.library.CRZGate "qiskit.circuit.library.CRZGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cswap" />
|
||
|
||
### cswap
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cswap" signature="RawFeatureVector.cswap(control_qubit, target_qubit1, target_qubit2, label=None, ctrl_state=None)">
|
||
Apply [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-csx" />
|
||
|
||
### csx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.csx" signature="RawFeatureVector.csx(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CSXGate`](qiskit.circuit.library.CSXGate "qiskit.circuit.library.CSXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cu" />
|
||
|
||
### cu
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cu" signature="RawFeatureVector.cu(theta, phi, lam, gamma, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CUGate`](qiskit.circuit.library.CUGate "qiskit.circuit.library.CUGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cu1" />
|
||
|
||
### cu1
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cu1" signature="RawFeatureVector.cu1(theta, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CU1Gate`](qiskit.circuit.library.CU1Gate "qiskit.circuit.library.CU1Gate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cu3" />
|
||
|
||
### cu3
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cu3" signature="RawFeatureVector.cu3(theta, phi, lam, control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CU3Gate`](qiskit.circuit.library.CU3Gate "qiskit.circuit.library.CU3Gate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cx" />
|
||
|
||
### cx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cx" signature="RawFeatureVector.cx(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cy" />
|
||
|
||
### cy
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cy" signature="RawFeatureVector.cy(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CYGate`](qiskit.circuit.library.CYGate "qiskit.circuit.library.CYGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-cz" />
|
||
|
||
### cz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.cz" signature="RawFeatureVector.cz(control_qubit, target_qubit, label=None, ctrl_state=None)">
|
||
Apply [`CZGate`](qiskit.circuit.library.CZGate "qiskit.circuit.library.CZGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-dcx" />
|
||
|
||
### dcx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.dcx" signature="RawFeatureVector.dcx(qubit1, qubit2)">
|
||
Apply [`DCXGate`](qiskit.circuit.library.DCXGate "qiskit.circuit.library.DCXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-decompose" />
|
||
|
||
### decompose
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.decompose" signature="RawFeatureVector.decompose()">
|
||
Call a decomposition pass on this circuit, to decompose one level (shallow decompose).
|
||
|
||
**Returns**
|
||
|
||
a circuit one level decomposed
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-delay" />
|
||
|
||
### delay
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.delay" signature="RawFeatureVector.delay(duration, qarg=None, unit='dt')">
|
||
Apply [`Delay`](qiskit.circuit.Delay "qiskit.circuit.Delay"). If qarg is None, applies to all qubits. When applying to multiple qubits, delays with the same duration will be created.
|
||
|
||
**Parameters**
|
||
|
||
* **duration** (*int or float or* [*ParameterExpression*](qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression")) – duration of the delay.
|
||
* **qarg** (*Object*) – qubit argument to apply this delay.
|
||
* **unit** (*str*) – unit of the duration. Supported units: ‘s’, ‘ms’, ‘us’, ‘ns’, ‘ps’, ‘dt’. Default is `dt`, i.e. integer time unit depending on the target backend.
|
||
|
||
**Returns**
|
||
|
||
the attached delay instruction.
|
||
|
||
**Return type**
|
||
|
||
qiskit.Instruction
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – if arguments have bad format.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-depth" />
|
||
|
||
### depth
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.depth" signature="RawFeatureVector.depth()">
|
||
Return circuit depth (i.e., length of critical path). This does not include compiler or simulator directives such as ‘barrier’ or ‘snapshot’.
|
||
|
||
**Returns**
|
||
|
||
Depth of circuit.
|
||
|
||
**Return type**
|
||
|
||
int
|
||
|
||
**Notes**
|
||
|
||
The circuit depth and the DAG depth need not be the same.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-diagonal" />
|
||
|
||
### diagonal
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.diagonal" signature="RawFeatureVector.diagonal(diag, qubit)">
|
||
Attach a diagonal gate to a circuit.
|
||
|
||
The decomposition is based on Theorem 7 given in “Synthesis of Quantum Logic Circuits” by Shende et al. ([https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf)).
|
||
|
||
**Parameters**
|
||
|
||
* **diag** (*list*) – list of the 2^k diagonal entries (for a diagonal gate on k qubits). Must contain at least two entries
|
||
* **qubit** (*QuantumRegister|list*) – list of k qubits the diagonal is acting on (the order of the qubits specifies the computational basis in which the diagonal gate is provided: the first element in diag acts on the state where all the qubits in q are in the state 0, the second entry acts on the state where all the qubits q\[1],…,q\[k-1] are in the state zero and q\[0] is in the state 1, and so on)
|
||
|
||
**Returns**
|
||
|
||
the diagonal gate which was attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the list of the diagonal entries or the qubit list is in bad format; if the number of diagonal entries is not 2^k, where k denotes the number of qubits
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-draw" />
|
||
|
||
### draw
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.draw" signature="RawFeatureVector.draw(output=None, scale=None, filename=None, style=None, interactive=False, plot_barriers=True, reverse_bits=False, justify=None, vertical_compression='medium', idle_wires=True, with_layout=True, fold=None, ax=None, initial_state=False, cregbundle=True)">
|
||
Draw the quantum circuit. Use the output parameter to choose the drawing format:
|
||
|
||
**text**: ASCII art TextDrawing that can be printed in the console.
|
||
|
||
**matplotlib**: images with color rendered purely in Python.
|
||
|
||
**latex**: high-quality images compiled via latex.
|
||
|
||
**latex\_source**: raw uncompiled latex output.
|
||
|
||
**Parameters**
|
||
|
||
* **output** (*str*) – select the output method to use for drawing the circuit. Valid choices are `text`, `mpl`, `latex`, `latex_source`. By default the text drawer is used unless the user config file (usually `~/.qiskit/settings.conf`) has an alternative backend set as the default. For example, `circuit_drawer = latex`. If the output kwarg is set, that backend will always be used over the default in the user config file.
|
||
* **scale** (*float*) – scale of image to draw (shrink if \< 1.0). Only used by the mpl, latex and latex\_source outputs. Defaults to 1.0.
|
||
* **filename** (*str*) – file path to save image to. Defaults to None.
|
||
* **style** (*dict or str*) – dictionary of style or file name of style json file. This option is only used by the mpl or latex output type. If style is a str, it is used as the path to a json file which contains a style dict. The file will be opened, parsed, and then any style elements in the dict will replace the default values in the input dict. A file to be loaded must end in `.json`, but the name entered here can omit `.json`. For example, `style='iqx.json'` or `style='iqx'`. If style is a dict and the `'name'` key is set, that name will be used to load a json file, followed by loading the other items in the style dict. For example, `style={'name': 'iqx'}`. If style is not a str and name is not a key in the style dict, then the default value from the user config file (usually `~/.qiskit/settings.conf`) will be used, for example, `circuit_mpl_style = iqx`. If none of these are set, the default style will be used. The search path for style json files can be specified in the user config, for example, `circuit_mpl_style_path = /home/user/styles:/home/user`. See: [`DefaultStyle`](qiskit.visualization.qcstyle.DefaultStyle "qiskit.visualization.qcstyle.DefaultStyle") for more information on the contents.
|
||
* **interactive** (*bool*) – when set to true, show the circuit in a new window (for mpl this depends on the matplotlib backend being used supporting this). Note when used with either the text or the latex\_source output type this has no effect and will be silently ignored. Defaults to False.
|
||
* **reverse\_bits** (*bool*) – when set to True, reverse the bit order inside registers for the output visualization. Defaults to False.
|
||
* **plot\_barriers** (*bool*) – enable/disable drawing barriers in the output circuit. Defaults to True.
|
||
* **justify** (*string*) – options are `left`, `right` or `none`. If anything else is supplied, it defaults to left justified. It refers to where gates should be placed in the output circuit if there is an option. `none` results in each gate being placed in its own column.
|
||
* **vertical\_compression** (*string*) – `high`, `medium` or `low`. It merges the lines generated by the text output so the drawing will take less vertical room. Default is `medium`. Only used by the text output, will be silently ignored otherwise.
|
||
* **idle\_wires** (*bool*) – include idle wires (wires with no circuit elements) in output visualization. Default is True.
|
||
* **with\_layout** (*bool*) – include layout information, with labels on the physical layout. Default is True.
|
||
* **fold** (*int*) – sets pagination. It can be disabled using -1. In text, sets the length of the lines. This is useful when the drawing does not fit in the console. If None (default), it will try to guess the console width using `shutil.get_terminal_size()`. However, if running in jupyter, the default line length is set to 80 characters. In mpl, it is the number of (visual) layers before folding. Default is 25.
|
||
* **ax** (*matplotlib.axes.Axes*) – Only used by the mpl backend. An optional Axes object to be used for the visualization output. If none is specified, a new matplotlib Figure will be created and used. Additionally, if specified there will be no returned Figure since it is redundant.
|
||
* **initial\_state** (*bool*) – optional. Adds `|0>` in the beginning of the wire. Default is False.
|
||
* **cregbundle** (*bool*) – optional. If set True, bundle classical registers. Default is True.
|
||
|
||
**Returns**
|
||
|
||
`TextDrawing` or `matplotlib.figure` or `PIL.Image` or `str`:
|
||
|
||
* **TextDrawing (output=’text’)**
|
||
|
||
A drawing that can be printed as ascii art.
|
||
|
||
* **matplotlib.figure.Figure (output=’mpl’)**
|
||
|
||
A matplotlib figure object for the circuit diagram.
|
||
|
||
* **PIL.Image (output=’latex’)**
|
||
|
||
An in-memory representation of the image of the circuit diagram.
|
||
|
||
* **str (output=’latex\_source’)**
|
||
|
||
The LaTeX source code for visualizing the circuit diagram.
|
||
|
||
**Raises**
|
||
|
||
* [**VisualizationError**](qiskit.visualization.VisualizationError "qiskit.visualization.VisualizationError") – when an invalid output method is selected
|
||
* **ImportError** – when the output methods requires non-installed libraries.
|
||
|
||
**Example**
|
||
|
||
```python
|
||
from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
|
||
from qiskit.tools.visualization import circuit_drawer
|
||
q = QuantumRegister(1)
|
||
c = ClassicalRegister(1)
|
||
qc = QuantumCircuit(q, c)
|
||
qc.h(q)
|
||
qc.measure(q, c)
|
||
qc.draw(output='mpl', style={'backgroundcolor': '#EEEEEE'})
|
||
```
|
||
|
||
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ecr" />
|
||
|
||
### ecr
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ecr" signature="RawFeatureVector.ecr(qubit1, qubit2)">
|
||
Apply [`ECRGate`](qiskit.circuit.library.ECRGate "qiskit.circuit.library.ECRGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-extend" />
|
||
|
||
### extend
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.extend" signature="RawFeatureVector.extend(rhs)">
|
||
DEPRECATED - Append QuantumCircuit to the RHS if it contains compatible registers.
|
||
|
||
Two circuits are compatible if they contain the same registers or if they contain different registers with unique names. The returned circuit will contain all unique registers between both circuits.
|
||
|
||
Modify and return self.
|
||
|
||
**Parameters**
|
||
|
||
**rhs** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The quantum circuit to append to the right hand side.
|
||
|
||
**Returns**
|
||
|
||
Returns this QuantumCircuit object (which has been modified)
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the rhs circuit is not compatible
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-fredkin" />
|
||
|
||
### fredkin
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.fredkin" signature="RawFeatureVector.fredkin(control_qubit, target_qubit1, target_qubit2)">
|
||
Apply [`CSwapGate`](qiskit.circuit.library.CSwapGate "qiskit.circuit.library.CSwapGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-from-qasm-file" />
|
||
|
||
### from\_qasm\_file
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.from_qasm_file" signature="RawFeatureVector.from_qasm_file(path)" modifiers="static">
|
||
Take in a QASM file and generate a QuantumCircuit object.
|
||
|
||
**Parameters**
|
||
|
||
**path** (*str*) – Path to the file for a QASM program
|
||
|
||
**Returns**
|
||
|
||
The QuantumCircuit object for the input QASM
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-from-qasm-str" />
|
||
|
||
### from\_qasm\_str
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.from_qasm_str" signature="RawFeatureVector.from_qasm_str(qasm_str)" modifiers="static">
|
||
Take in a QASM string and generate a QuantumCircuit object.
|
||
|
||
**Parameters**
|
||
|
||
**qasm\_str** (*str*) – A QASM program string
|
||
|
||
**Returns**
|
||
|
||
The QuantumCircuit object for the input QASM
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-get-instructions" />
|
||
|
||
### get\_instructions
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.get_instructions" signature="RawFeatureVector.get_instructions(name)">
|
||
Get instructions matching name.
|
||
|
||
**Parameters**
|
||
|
||
**name** (*str*) – The name of instruction to.
|
||
|
||
**Returns**
|
||
|
||
list of (instruction, qargs, cargs).
|
||
|
||
**Return type**
|
||
|
||
list(tuple)
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-h" />
|
||
|
||
### h
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.h" signature="RawFeatureVector.h(qubit)">
|
||
Apply [`HGate`](qiskit.circuit.library.HGate "qiskit.circuit.library.HGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-hamiltonian" />
|
||
|
||
### hamiltonian
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.hamiltonian" signature="RawFeatureVector.hamiltonian(operator, time, qubits, label=None)">
|
||
Apply hamiltonian evolution to qubits.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-has-register" />
|
||
|
||
### has\_register
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.has_register" signature="RawFeatureVector.has_register(register)">
|
||
Test if this circuit has the register r.
|
||
|
||
**Parameters**
|
||
|
||
**register** (*Register*) – a quantum or classical register.
|
||
|
||
**Returns**
|
||
|
||
True if the register is contained in this circuit.
|
||
|
||
**Return type**
|
||
|
||
bool
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-i" />
|
||
|
||
### i
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.i" signature="RawFeatureVector.i(qubit)">
|
||
Apply [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-id" />
|
||
|
||
### id
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.id" signature="RawFeatureVector.id(qubit)">
|
||
Apply [`IGate`](qiskit.circuit.library.IGate "qiskit.circuit.library.IGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-initialize" />
|
||
|
||
### initialize
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.initialize" signature="RawFeatureVector.initialize(params, qubits=None)">
|
||
Initialize qubits in a specific state.
|
||
|
||
Qubit initialization is done by first resetting the qubits to $|0\rangle$ followed by an state preparing unitary. Both these steps are included in the Initialize instruction.
|
||
|
||
**Parameters**
|
||
|
||
* **params** (*str or list or int*) –
|
||
|
||
* **str: labels of basis states of the Pauli eigenstates Z, X, Y. See**
|
||
|
||
`from_label()`. Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label ‘01’ initializes the qubit zero to |1> and the qubit one to |0>.
|
||
|
||
* list: vector of complex amplitudes to initialize to.
|
||
|
||
* **int: an integer that is used as a bitmap indicating which qubits to initialize**
|
||
|
||
to |1>. Example: setting params to 5 would initialize qubit 0 and qubit 2 to |1> and qubit 1 to |0>.
|
||
|
||
* **qubits** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or int*) –
|
||
|
||
* QuantumRegister: A list of qubits to be initialized \[Default: None].
|
||
* int: Index of qubit to initialized \[Default: None].
|
||
|
||
**Returns**
|
||
|
||
a handle to the instruction that was just initialized
|
||
|
||
**Return type**
|
||
|
||
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
|
||
|
||
**Examples**
|
||
|
||
Prepare a qubit in the state $(|0\rangle - |1\rangle) / \sqrt{2}$.
|
||
|
||
```python
|
||
import numpy as np
|
||
from qiskit import QuantumCircuit
|
||
|
||
circuit = QuantumCircuit(1)
|
||
circuit.initialize([1/np.sqrt(2), -1/np.sqrt(2)], 0)
|
||
circuit.draw()
|
||
```
|
||
|
||
```python
|
||
┌──────────────────────────────┐
|
||
q_0: ┤ Initialize(0.70711,-0.70711) ├
|
||
└──────────────────────────────┘
|
||
```
|
||
|
||
#### output:
|
||
|
||
┌──────────────────────────────┐
|
||
|
||
#### q\_0: ┤ initialize(0.70711,-0.70711) ├
|
||
|
||
└──────────────────────────────┘
|
||
|
||
Initialize from a string two qubits in the state |10>. The order of the labels is reversed with respect to qubit index. More information about labels for basis states are in `from_label()`.
|
||
|
||
```python
|
||
import numpy as np
|
||
from qiskit import QuantumCircuit
|
||
|
||
circuit = QuantumCircuit(2)
|
||
circuit.initialize('01', circuit.qubits)
|
||
circuit.draw()
|
||
```
|
||
|
||
```python
|
||
┌──────────────────┐
|
||
q_0: ┤0 ├
|
||
│ Initialize(0,1) │
|
||
q_1: ┤1 ├
|
||
└──────────────────┘
|
||
```
|
||
|
||
#### output:
|
||
|
||
┌──────────────────┐
|
||
|
||
#### q\_0: ┤0 ├
|
||
|
||
│ initialize(0,1) │
|
||
|
||
#### q\_1: ┤1 ├
|
||
|
||
└──────────────────┘
|
||
|
||
Initialize two qubits from an array of complex amplitudes .. jupyter-execute:
|
||
|
||
```python
|
||
import numpy as np
|
||
from qiskit import QuantumCircuit
|
||
|
||
circuit = QuantumCircuit(2)
|
||
circuit.initialize([0, 1/np.sqrt(2), -1.j/np.sqrt(2), 0], circuit.qubits)
|
||
circuit.draw()
|
||
```
|
||
|
||
#### output:
|
||
|
||
┌────────────────────────────────────┐
|
||
|
||
#### q\_0: ┤0 ├
|
||
|
||
│ initialize(0,0.70711,-0.70711j,0) │
|
||
|
||
#### q\_1: ┤1 ├
|
||
|
||
└────────────────────────────────────┘
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-inverse" />
|
||
|
||
### inverse
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.inverse" signature="RawFeatureVector.inverse()">
|
||
Invert (take adjoint of) this circuit.
|
||
|
||
This is done by recursively inverting all gates.
|
||
|
||
**Returns**
|
||
|
||
the inverted circuit
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – if the circuit cannot be inverted.
|
||
|
||
**Examples**
|
||
|
||
#### input:
|
||
|
||
┌───┐
|
||
|
||
#### q\_0: ┤ H ├─────■──────
|
||
|
||
└───┘┌────┴─────┐
|
||
|
||
#### q\_1: ─────┤ RX(1.57) ├
|
||
|
||
└──────────┘
|
||
|
||
#### output:
|
||
|
||
┌───┐
|
||
|
||
#### q\_0: ──────■──────┤ H ├
|
||
|
||
┌─────┴─────┐└───┘
|
||
|
||
#### q\_1: ┤ RX(-1.57) ├─────
|
||
|
||
└───────────┘
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-iso" />
|
||
|
||
### iso
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.iso" signature="RawFeatureVector.iso(isometry, q_input, q_ancillas_for_output, q_ancillas_zero=None, q_ancillas_dirty=None, epsilon=1e-10)">
|
||
Attach an arbitrary isometry from m to n qubits to a circuit. In particular, this allows to attach arbitrary unitaries on n qubits (m=n) or to prepare any state on n qubits (m=0). The decomposition used here was introduced by Iten et al. in [https://arxiv.org/abs/1501.06911](https://arxiv.org/abs/1501.06911).
|
||
|
||
**Parameters**
|
||
|
||
* **isometry** (*ndarray*) – an isometry from m to n qubits, i.e., a (complex) ndarray of dimension 2^n×2^m with orthonormal columns (given in the computational basis specified by the order of the ancillas and the input qubits, where the ancillas are considered to be more significant than the input qubits.).
|
||
* **q\_input** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of m qubits where the input to the isometry is fed in (empty list for state preparation).
|
||
* **q\_ancillas\_for\_output** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of n-m ancilla qubits that are used for the output of the isometry and which are assumed to start in the zero state. The qubits are listed with increasing significance.
|
||
* **q\_ancillas\_zero** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which are assumed to start in the zero state. Default is q\_ancillas\_zero = None.
|
||
* **q\_ancillas\_dirty** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which can start in an arbitrary state. Default is q\_ancillas\_dirty = None.
|
||
* **epsilon** (*float*) – error tolerance of calculations. Default is epsilon = \_EPS.
|
||
|
||
**Returns**
|
||
|
||
the isometry is attached to the quantum circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the array is not an isometry of the correct size corresponding to the provided number of qubits.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-isometry" />
|
||
|
||
### isometry
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.isometry" signature="RawFeatureVector.isometry(isometry, q_input, q_ancillas_for_output, q_ancillas_zero=None, q_ancillas_dirty=None, epsilon=1e-10)">
|
||
Attach an arbitrary isometry from m to n qubits to a circuit. In particular, this allows to attach arbitrary unitaries on n qubits (m=n) or to prepare any state on n qubits (m=0). The decomposition used here was introduced by Iten et al. in [https://arxiv.org/abs/1501.06911](https://arxiv.org/abs/1501.06911).
|
||
|
||
**Parameters**
|
||
|
||
* **isometry** (*ndarray*) – an isometry from m to n qubits, i.e., a (complex) ndarray of dimension 2^n×2^m with orthonormal columns (given in the computational basis specified by the order of the ancillas and the input qubits, where the ancillas are considered to be more significant than the input qubits.).
|
||
* **q\_input** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of m qubits where the input to the isometry is fed in (empty list for state preparation).
|
||
* **q\_ancillas\_for\_output** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of n-m ancilla qubits that are used for the output of the isometry and which are assumed to start in the zero state. The qubits are listed with increasing significance.
|
||
* **q\_ancillas\_zero** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which are assumed to start in the zero state. Default is q\_ancillas\_zero = None.
|
||
* **q\_ancillas\_dirty** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of ancilla qubits which can start in an arbitrary state. Default is q\_ancillas\_dirty = None.
|
||
* **epsilon** (*float*) – error tolerance of calculations. Default is epsilon = \_EPS.
|
||
|
||
**Returns**
|
||
|
||
the isometry is attached to the quantum circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the array is not an isometry of the correct size corresponding to the provided number of qubits.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-iswap" />
|
||
|
||
### iswap
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.iswap" signature="RawFeatureVector.iswap(qubit1, qubit2)">
|
||
Apply [`iSwapGate`](qiskit.circuit.library.iSwapGate "qiskit.circuit.library.iSwapGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcp" />
|
||
|
||
### mcp
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcp" signature="RawFeatureVector.mcp(lam, control_qubits, target_qubit)">
|
||
Apply [`MCPhaseGate`](qiskit.circuit.library.MCPhaseGate "qiskit.circuit.library.MCPhaseGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcrx" />
|
||
|
||
### mcrx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcrx" signature="RawFeatureVector.mcrx(theta, q_controls, q_target, use_basis_gates=False)">
|
||
Apply Multiple-Controlled X rotation gate
|
||
|
||
**Parameters**
|
||
|
||
* **self** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcrx gate on.
|
||
* **theta** (*float*) – angle theta
|
||
* **q\_controls** (*list(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
|
||
* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
|
||
* **use\_basis\_gates** (*bool*) – use p, u, cx
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – parameter errors
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcry" />
|
||
|
||
### mcry
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcry" signature="RawFeatureVector.mcry(theta, q_controls, q_target, q_ancillae=None, mode=None, use_basis_gates=False)">
|
||
Apply Multiple-Controlled Y rotation gate
|
||
|
||
**Parameters**
|
||
|
||
* **self** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcry gate on.
|
||
* **theta** (*float*) – angle theta
|
||
* **q\_controls** (*list(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
|
||
* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
|
||
* **q\_ancillae** ([*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister") *or tuple(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*, int)*) – The list of ancillary qubits.
|
||
* **mode** (*string*) – The implementation mode to use
|
||
* **use\_basis\_gates** (*bool*) – use p, u, cx
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – parameter errors
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcrz" />
|
||
|
||
### mcrz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcrz" signature="RawFeatureVector.mcrz(lam, q_controls, q_target, use_basis_gates=False)">
|
||
Apply Multiple-Controlled Z rotation gate
|
||
|
||
**Parameters**
|
||
|
||
* **self** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The QuantumCircuit object to apply the mcrz gate on.
|
||
* **lam** (*float*) – angle lambda
|
||
* **q\_controls** (*list(*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*)*) – The list of control qubits
|
||
* **q\_target** ([*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")) – The target qubit
|
||
* **use\_basis\_gates** (*bool*) – use p, u, cx
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – parameter errors
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mct" />
|
||
|
||
### mct
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mct" signature="RawFeatureVector.mct(control_qubits, target_qubit, ancilla_qubits=None, mode='noancilla')">
|
||
Apply [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.MCXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcu1" />
|
||
|
||
### mcu1
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcu1" signature="RawFeatureVector.mcu1(lam, control_qubits, target_qubit)">
|
||
Apply `MCU1Gate`.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-mcx" />
|
||
|
||
### mcx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.mcx" signature="RawFeatureVector.mcx(control_qubits, target_qubit, ancilla_qubits=None, mode='noancilla')">
|
||
Apply [`MCXGate`](qiskit.circuit.library.MCXGate "qiskit.circuit.library.MCXGate").
|
||
|
||
The multi-cX gate can be implemented using different techniques, which use different numbers of ancilla qubits and have varying circuit depth. These modes are: - ‘noancilla’: Requires 0 ancilla qubits. - ‘recursion’: Requires 1 ancilla qubit if more than 4 controls are used, otherwise 0. - ‘v-chain’: Requires 2 less ancillas than the number of control qubits. - ‘v-chain-dirty’: Same as for the clean ancillas (but the circuit will be longer).
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-measure" />
|
||
|
||
### measure
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.measure" signature="RawFeatureVector.measure(qubit, cbit)">
|
||
Measure quantum bit into classical bit (tuples).
|
||
|
||
**Parameters**
|
||
|
||
* **qubit** (*QuantumRegister|list|tuple*) – quantum register
|
||
* **cbit** (*ClassicalRegister|list|tuple*) – classical register
|
||
|
||
**Returns**
|
||
|
||
the attached measure instruction.
|
||
|
||
**Return type**
|
||
|
||
qiskit.Instruction
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – if qubit is not in this circuit or bad format; if cbit is not in this circuit or not creg.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-measure-active" />
|
||
|
||
### measure\_active
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.measure_active" signature="RawFeatureVector.measure_active(inplace=True)">
|
||
Adds measurement to all non-idle qubits. Creates a new ClassicalRegister with a size equal to the number of non-idle qubits being measured.
|
||
|
||
Returns a new circuit with measurements if inplace=False.
|
||
|
||
**Parameters**
|
||
|
||
**inplace** (*bool*) – All measurements inplace or return new circuit.
|
||
|
||
**Returns**
|
||
|
||
Returns circuit with measurements when inplace = False.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-measure-all" />
|
||
|
||
### measure\_all
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.measure_all" signature="RawFeatureVector.measure_all(inplace=True)">
|
||
Adds measurement to all qubits. Creates a new ClassicalRegister with a size equal to the number of qubits being measured.
|
||
|
||
Returns a new circuit with measurements if inplace=False.
|
||
|
||
**Parameters**
|
||
|
||
**inplace** (*bool*) – All measurements inplace or return new circuit.
|
||
|
||
**Returns**
|
||
|
||
Returns circuit with measurements when inplace = False.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ms" />
|
||
|
||
### ms
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ms" signature="RawFeatureVector.ms(theta, qubits)">
|
||
Apply [`MSGate`](qiskit.circuit.library.MSGate "qiskit.circuit.library.MSGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-num-connected-components" />
|
||
|
||
### num\_connected\_components
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.num_connected_components" signature="RawFeatureVector.num_connected_components(unitary_only=False)">
|
||
How many non-entangled subcircuits can the circuit be factored to.
|
||
|
||
**Parameters**
|
||
|
||
**unitary\_only** (*bool*) – Compute only unitary part of graph.
|
||
|
||
**Returns**
|
||
|
||
Number of connected components in circuit.
|
||
|
||
**Return type**
|
||
|
||
int
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-num-nonlocal-gates" />
|
||
|
||
### num\_nonlocal\_gates
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.num_nonlocal_gates" signature="RawFeatureVector.num_nonlocal_gates()">
|
||
Return number of non-local gates (i.e. involving 2+ qubits).
|
||
|
||
Conditional nonlocal gates are also included.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-num-tensor-factors" />
|
||
|
||
### num\_tensor\_factors
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.num_tensor_factors" signature="RawFeatureVector.num_tensor_factors()">
|
||
Computes the number of tensor factors in the unitary (quantum) part of the circuit only.
|
||
|
||
**Notes**
|
||
|
||
This is here for backwards compatibility, and will be removed in a future release of Qiskit. You should call num\_unitary\_factors instead.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-num-unitary-factors" />
|
||
|
||
### num\_unitary\_factors
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.num_unitary_factors" signature="RawFeatureVector.num_unitary_factors()">
|
||
Computes the number of tensor factors in the unitary (quantum) part of the circuit only.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-p" />
|
||
|
||
### p
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.p" signature="RawFeatureVector.p(theta, qubit)">
|
||
Apply [`PhaseGate`](qiskit.circuit.library.PhaseGate "qiskit.circuit.library.PhaseGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-pauli" />
|
||
|
||
### pauli
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.pauli" signature="RawFeatureVector.pauli(pauli_string, qubits)">
|
||
Apply [`PauliGate`](qiskit.circuit.library.PauliGate "qiskit.circuit.library.PauliGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-power" />
|
||
|
||
### power
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.power" signature="RawFeatureVector.power(power, matrix_power=False)">
|
||
Raise this circuit to the power of `power`.
|
||
|
||
If `power` is a positive integer and `matrix_power` is `False`, this implementation defaults to calling `repeat`. Otherwise, if the circuit is unitary, the matrix is computed to calculate the matrix power.
|
||
|
||
**Parameters**
|
||
|
||
* **power** (*int*) – The power to raise this circuit to.
|
||
* **matrix\_power** (*bool*) – If True, the circuit is converted to a matrix and then the matrix power is computed. If False, and `power` is a positive integer, the implementation defaults to `repeat`.
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – If the circuit needs to be converted to a gate but it is not unitary.
|
||
|
||
**Returns**
|
||
|
||
A circuit implementing this circuit raised to the power of `power`.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-qasm" />
|
||
|
||
### qasm
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.qasm" signature="RawFeatureVector.qasm(formatted=False, filename=None, encoding=None)">
|
||
Return OpenQASM string.
|
||
|
||
**Parameters**
|
||
|
||
* **formatted** (*bool*) – Return formatted Qasm string.
|
||
* **filename** (*str*) – Save Qasm to file with name ‘filename’.
|
||
* **encoding** (*str*) – Optionally specify the encoding to use for the output file if `filename` is specified. By default this is set to the system’s default encoding (ie whatever `locale.getpreferredencoding()` returns) and can be set to any valid codec or alias from stdlib’s [codec module](https://docs.python.org/3/library/codecs.html#standard-encodings)
|
||
|
||
**Returns**
|
||
|
||
If formatted=False.
|
||
|
||
**Return type**
|
||
|
||
str
|
||
|
||
**Raises**
|
||
|
||
* [**MissingOptionalLibraryError**](qiskit.aqua.MissingOptionalLibraryError "qiskit.aqua.MissingOptionalLibraryError") – If pygments is not installed and `formatted` is `True`.
|
||
* [**QasmError**](qiskit.qasm.QasmError "qiskit.qasm.QasmError") – If circuit has free parameters.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-qbit-argument-conversion" />
|
||
|
||
### qbit\_argument\_conversion
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.qbit_argument_conversion" signature="RawFeatureVector.qbit_argument_conversion(qubit_representation)">
|
||
Converts several qubit representations (such as indexes, range, etc.) into a list of qubits.
|
||
|
||
**Parameters**
|
||
|
||
**qubit\_representation** (*Object*) – representation to expand
|
||
|
||
**Returns**
|
||
|
||
Where each tuple is a qubit.
|
||
|
||
**Return type**
|
||
|
||
List(tuple)
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-qubit-duration" />
|
||
|
||
### qubit\_duration
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.qubit_duration" signature="RawFeatureVector.qubit_duration(*qubits)">
|
||
Return the duration between the start and stop time of the first and last instructions, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
|
||
|
||
**Parameters**
|
||
|
||
**\*qubits** – Qubits within `self` to include.
|
||
|
||
**Return type**
|
||
|
||
`float`
|
||
|
||
**Returns**
|
||
|
||
Return the duration between the first start and last stop time of non-delay instructions
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-qubit-start-time" />
|
||
|
||
### qubit\_start\_time
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.qubit_start_time" signature="RawFeatureVector.qubit_start_time(*qubits)">
|
||
Return the start time of the first instruction, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
|
||
|
||
Return 0 if there are no instructions over qubits
|
||
|
||
**Parameters**
|
||
|
||
* **\*qubits** – Qubits within `self` to include. Integers are allowed for qubits, indicating
|
||
* **of self.qubits.** (*indices*) –
|
||
|
||
**Return type**
|
||
|
||
`float`
|
||
|
||
**Returns**
|
||
|
||
Return the start time of the first instruction, excluding delays, over the qubits
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – if `self` is a not-yet scheduled circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-qubit-stop-time" />
|
||
|
||
### qubit\_stop\_time
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.qubit_stop_time" signature="RawFeatureVector.qubit_stop_time(*qubits)">
|
||
Return the stop time of the last instruction, excluding delays, over the supplied qubits. Its time unit is `self.unit`.
|
||
|
||
Return 0 if there are no instructions over qubits
|
||
|
||
**Parameters**
|
||
|
||
* **\*qubits** – Qubits within `self` to include. Integers are allowed for qubits, indicating
|
||
* **of self.qubits.** (*indices*) –
|
||
|
||
**Return type**
|
||
|
||
`float`
|
||
|
||
**Returns**
|
||
|
||
Return the stop time of the last instruction, excluding delays, over the qubits
|
||
|
||
**Raises**
|
||
|
||
**CircuitError** – if `self` is a not-yet scheduled circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-r" />
|
||
|
||
### r
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.r" signature="RawFeatureVector.r(theta, phi, qubit)">
|
||
Apply [`RGate`](qiskit.circuit.library.RGate "qiskit.circuit.library.RGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rcccx" />
|
||
|
||
### rcccx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rcccx" signature="RawFeatureVector.rcccx(control_qubit1, control_qubit2, control_qubit3, target_qubit)">
|
||
Apply [`RC3XGate`](qiskit.circuit.library.RC3XGate "qiskit.circuit.library.RC3XGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rccx" />
|
||
|
||
### rccx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rccx" signature="RawFeatureVector.rccx(control_qubit1, control_qubit2, target_qubit)">
|
||
Apply [`RCCXGate`](qiskit.circuit.library.RCCXGate "qiskit.circuit.library.RCCXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-remove-final-measurements" />
|
||
|
||
### remove\_final\_measurements
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.remove_final_measurements" signature="RawFeatureVector.remove_final_measurements(inplace=True)">
|
||
Removes final measurement on all qubits if they are present. Deletes the ClassicalRegister that was used to store the values from these measurements if it is idle.
|
||
|
||
Returns a new circuit without measurements if inplace=False.
|
||
|
||
**Parameters**
|
||
|
||
**inplace** (*bool*) – All measurements removed inplace or return new circuit.
|
||
|
||
**Returns**
|
||
|
||
Returns circuit with measurements removed when inplace = False.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-repeat" />
|
||
|
||
### repeat
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.repeat" signature="RawFeatureVector.repeat(reps)">
|
||
Repeat this circuit `reps` times.
|
||
|
||
**Parameters**
|
||
|
||
**reps** (*int*) – How often this circuit should be repeated.
|
||
|
||
**Returns**
|
||
|
||
A circuit containing `reps` repetitions of this circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-reset" />
|
||
|
||
### reset
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.reset" signature="RawFeatureVector.reset(qubit)">
|
||
Reset q.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-reverse-bits" />
|
||
|
||
### reverse\_bits
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.reverse_bits" signature="RawFeatureVector.reverse_bits()">
|
||
Return a circuit with the opposite order of wires.
|
||
|
||
The circuit is “vertically” flipped. If a circuit is defined over multiple registers, the resulting circuit will have the same registers but with their order flipped.
|
||
|
||
This method is useful for converting a circuit written in little-endian convention to the big-endian equivalent, and vice versa.
|
||
|
||
**Returns**
|
||
|
||
the circuit with reversed bit order.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Examples**
|
||
|
||
#### input:
|
||
|
||
┌───┐
|
||
|
||
#### q\_0: ┤ H ├─────■──────
|
||
|
||
└───┘┌────┴─────┐
|
||
|
||
#### q\_1: ─────┤ RX(1.57) ├
|
||
|
||
└──────────┘
|
||
|
||
#### output:
|
||
|
||
┌──────────┐
|
||
|
||
#### q\_0: ─────┤ RX(1.57) ├
|
||
|
||
┌───┐└────┬─────┘
|
||
|
||
#### q\_1: ┤ H ├─────■──────
|
||
|
||
└───┘
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-reverse-ops" />
|
||
|
||
### reverse\_ops
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.reverse_ops" signature="RawFeatureVector.reverse_ops()">
|
||
Reverse the circuit by reversing the order of instructions.
|
||
|
||
This is done by recursively reversing all instructions. It does not invert (adjoint) any gate.
|
||
|
||
**Returns**
|
||
|
||
the reversed circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Examples**
|
||
|
||
#### input:
|
||
|
||
┌───┐
|
||
|
||
#### q\_0: ┤ H ├─────■──────
|
||
|
||
└───┘┌────┴─────┐
|
||
|
||
#### q\_1: ─────┤ RX(1.57) ├
|
||
|
||
└──────────┘
|
||
|
||
#### output:
|
||
|
||
┌───┐
|
||
|
||
#### q\_0: ─────■──────┤ H ├
|
||
|
||
┌────┴─────┐└───┘
|
||
|
||
#### q\_1: ┤ RX(1.57) ├─────
|
||
|
||
└──────────┘
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rv" />
|
||
|
||
### rv
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rv" signature="RawFeatureVector.rv(vx, vy, vz, qubit)">
|
||
Apply [`RVGate`](qiskit.circuit.library.RVGate "qiskit.circuit.library.RVGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rx" />
|
||
|
||
### rx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rx" signature="RawFeatureVector.rx(theta, qubit, label=None)">
|
||
Apply [`RXGate`](qiskit.circuit.library.RXGate "qiskit.circuit.library.RXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rxx" />
|
||
|
||
### rxx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rxx" signature="RawFeatureVector.rxx(theta, qubit1, qubit2)">
|
||
Apply [`RXXGate`](qiskit.circuit.library.RXXGate "qiskit.circuit.library.RXXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ry" />
|
||
|
||
### ry
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ry" signature="RawFeatureVector.ry(theta, qubit, label=None)">
|
||
Apply [`RYGate`](qiskit.circuit.library.RYGate "qiskit.circuit.library.RYGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ryy" />
|
||
|
||
### ryy
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ryy" signature="RawFeatureVector.ryy(theta, qubit1, qubit2)">
|
||
Apply [`RYYGate`](qiskit.circuit.library.RYYGate "qiskit.circuit.library.RYYGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rz" />
|
||
|
||
### rz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rz" signature="RawFeatureVector.rz(phi, qubit)">
|
||
Apply [`RZGate`](qiskit.circuit.library.RZGate "qiskit.circuit.library.RZGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rzx" />
|
||
|
||
### rzx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rzx" signature="RawFeatureVector.rzx(theta, qubit1, qubit2)">
|
||
Apply [`RZXGate`](qiskit.circuit.library.RZXGate "qiskit.circuit.library.RZXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-rzz" />
|
||
|
||
### rzz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.rzz" signature="RawFeatureVector.rzz(theta, qubit1, qubit2)">
|
||
Apply [`RZZGate`](qiskit.circuit.library.RZZGate "qiskit.circuit.library.RZZGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-s" />
|
||
|
||
### s
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.s" signature="RawFeatureVector.s(qubit)">
|
||
Apply [`SGate`](qiskit.circuit.library.SGate "qiskit.circuit.library.SGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-amplitudes" />
|
||
|
||
### save\_amplitudes
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_amplitudes" signature="RawFeatureVector.save_amplitudes(params, label='amplitudes', pershot=False, conditional=False)">
|
||
Save complex statevector amplitudes.
|
||
|
||
**Parameters**
|
||
|
||
* **params** (*List\[int] or List\[str]*) – the basis states to return amplitudes for.
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save a list of amplitudes vectors for each shot of the simulation rather than the a single amplitude vector \[Default: False].
|
||
* **conditional** (*bool*) – if True save the amplitudes vector conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if params is invalid for the specified number of qubits.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-amplitudes-squared" />
|
||
|
||
### save\_amplitudes\_squared
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_amplitudes_squared" signature="RawFeatureVector.save_amplitudes_squared(params, label='amplitudes_squared', unnormalized=False, pershot=False, conditional=False)">
|
||
Save squared statevector amplitudes (probabilities).
|
||
|
||
**Parameters**
|
||
|
||
* **params** (*List\[int] or List\[str]*) – the basis states to return amplitudes for.
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated probabilities over all shots \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of probability vectors for each shot of the simulation rather than the a single amplitude vector \[Default: False].
|
||
* **conditional** (*bool*) – if True save the probability vector conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if params is invalid for the specified number of qubits.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-density-matrix" />
|
||
|
||
### save\_density\_matrix
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_density_matrix" signature="RawFeatureVector.save_density_matrix(qubits=None, label='density_matrix', unnormalized=False, pershot=False, conditional=False)">
|
||
Save the current simulator quantum state as a density matrix.
|
||
|
||
**Parameters**
|
||
|
||
* **qubits** (*list or None*) – the qubits to save reduced density matrix on. If None the full density matrix of qubits will be saved \[Default: None].
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated or conditional accumulated density matrix over all shots \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of density matrices for each shot of the simulation rather than the average over all shots \[Default: False].
|
||
* **conditional** (*bool*) – if True save the average or pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-expectation-value" />
|
||
|
||
### save\_expectation\_value
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_expectation_value" signature="RawFeatureVector.save_expectation_value(operator, qubits, label='expectation_value', unnormalized=False, pershot=False, conditional=False)">
|
||
Save the expectation value of a Hermitian operator.
|
||
|
||
**Parameters**
|
||
|
||
* **operator** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *or*[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a Hermitian operator.
|
||
* **qubits** (*list*) – circuit qubits to apply instruction.
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated or conditional accumulated expectation value over all shot \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of expectation values for each shot of the simulation rather than the average over all shots \[Default: False].
|
||
* **conditional** (*bool*) – if True save the average or pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if the input operator is invalid or not Hermitian.
|
||
|
||
<Admonition title="Note" type="note">
|
||
This method appends a `SaveExpectationValue` instruction to the quantum circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-expectation-value-variance" />
|
||
|
||
### save\_expectation\_value\_variance
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_expectation_value_variance" signature="RawFeatureVector.save_expectation_value_variance(operator, qubits, label='expectation_value_variance', unnormalized=False, pershot=False, conditional=False)">
|
||
Save the expectation value of a Hermitian operator.
|
||
|
||
**Parameters**
|
||
|
||
* **operator** ([*Pauli*](qiskit.quantum_info.Pauli "qiskit.quantum_info.Pauli") *or*[*SparsePauliOp*](qiskit.quantum_info.SparsePauliOp "qiskit.quantum_info.SparsePauliOp") *or*[*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – a Hermitian operator.
|
||
* **qubits** (*list*) – circuit qubits to apply instruction.
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated or conditional accumulated expectation value and variance over all shot \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of expectation values and variances for each shot of the simulation rather than the average over all shots \[Default: False].
|
||
* **conditional** (*bool*) – if True save the data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if the input operator is invalid or not Hermitian.
|
||
|
||
<Admonition title="Note" type="note">
|
||
This method appends a `SaveExpectationValueVariance` instruction to the quantum circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-matrix-product-state" />
|
||
|
||
### save\_matrix\_product\_state
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_matrix_product_state" signature="RawFeatureVector.save_matrix_product_state(label='matrix_product_state', pershot=False, conditional=False)">
|
||
Save the current simulator quantum state as a matrix product state.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save the mps for each shot of the simulation \[Default: False].
|
||
* **conditional** (*bool*) – if True save pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-probabilities" />
|
||
|
||
### save\_probabilities
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_probabilities" signature="RawFeatureVector.save_probabilities(qubits=None, label='probabilities', unnormalized=False, pershot=False, conditional=False)">
|
||
Save measurement outcome probabilities vector.
|
||
|
||
**Parameters**
|
||
|
||
* **qubits** (*list or None*) – the qubits to apply snapshot to. If None all qubits will be snapshot \[Default: None].
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated probabilities over all shots \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of probabilities for each shot of the simulation rather than the average over all shots \[Default: False].
|
||
* **conditional** (*bool*) – if True save the probabilities data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-probabilities-dict" />
|
||
|
||
### save\_probabilities\_dict
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_probabilities_dict" signature="RawFeatureVector.save_probabilities_dict(qubits=None, label='probabilities', unnormalized=False, pershot=False, conditional=False)">
|
||
Save measurement outcome probabilities vector.
|
||
|
||
**Parameters**
|
||
|
||
* **qubits** (*list or None*) – the qubits to apply snapshot to. If None all qubits will be snapshot \[Default: None].
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **unnormalized** (*bool*) – If True return save the unnormalized accumulated probabilities over all shots \[Default: False].
|
||
* **pershot** (*bool*) – if True save a list of probabilities for each shot of the simulation rather than the average over all shots \[Default: False].
|
||
* **conditional** (*bool*) – if True save the probabilities data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-stabilizer" />
|
||
|
||
### save\_stabilizer
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_stabilizer" signature="RawFeatureVector.save_stabilizer(label='stabilizer', pershot=False, conditional=False)">
|
||
Save the current stabilizer simulator quantum state as a Clifford.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save a list of Cliffords for each shot of the simulation \[Default: False].
|
||
* **conditional** (*bool*) – if True save pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
<Admonition title="Note" type="note">
|
||
This instruction is always defined across all qubits in a circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-state" />
|
||
|
||
### save\_state
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_state" signature="RawFeatureVector.save_state(label=None, pershot=False, conditional=False)">
|
||
Save the current simulator quantum state.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str or None*) – Optional, the key for retrieving saved data from results. If None the key will be the state type of the simulator.
|
||
* **pershot** (*bool*) – if True save a list of statevectors for each shot of the simulation \[Default: False].
|
||
* **conditional** (*bool*) – if True save pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-statevector" />
|
||
|
||
### save\_statevector
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_statevector" signature="RawFeatureVector.save_statevector(label='statevector', pershot=False, conditional=False)">
|
||
Save the current simulator quantum state as a statevector.
|
||
|
||
**Parameters**
|
||
|
||
* **pershot** (*bool*) – if True save a list of statevectors for each shot of the simulation \[Default: False].
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **conditional** (*bool*) – if True save pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
<Admonition title="Note" type="note">
|
||
This instruction is always defined across all qubits in a circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-statevector-dict" />
|
||
|
||
### save\_statevector\_dict
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_statevector_dict" signature="RawFeatureVector.save_statevector_dict(label='statevector', pershot=False, conditional=False)">
|
||
Save the current simulator quantum state as a statevector as a dict.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save a list of statevectors for each shot of the simulation \[Default: False].
|
||
* **conditional** (*bool*) – if True save pershot data conditional on the current classical register values \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
<Admonition title="Note" type="note">
|
||
This instruction is always defined across all qubits in a circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-superop" />
|
||
|
||
### save\_superop
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_superop" signature="RawFeatureVector.save_superop(label='superop', pershot=False)">
|
||
Save the current state of the superop simulator.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save a list of SuperOp matrices for each shot of the simulation \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
<Admonition title="Note" type="note">
|
||
This instruction is always defined across all qubits in a circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-save-unitary" />
|
||
|
||
### save\_unitary
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.save_unitary" signature="RawFeatureVector.save_unitary(label='unitary', pershot=False)">
|
||
Save the current state of the unitary simulator.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – the key for retrieving saved data from results.
|
||
* **pershot** (*bool*) – if True save a list of unitaries for each shot of the simulation \[Default: False].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
<Admonition title="Note" type="note">
|
||
This instruction is always defined across all qubits in a circuit.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-sdg" />
|
||
|
||
### sdg
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.sdg" signature="RawFeatureVector.sdg(qubit)">
|
||
Apply [`SdgGate`](qiskit.circuit.library.SdgGate "qiskit.circuit.library.SdgGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-density-matrix" />
|
||
|
||
### set\_density\_matrix
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_density_matrix" signature="RawFeatureVector.set_density_matrix(state)">
|
||
Set the density matrix state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** ([*DensityMatrix*](qiskit.quantum_info.DensityMatrix "qiskit.quantum_info.DensityMatrix")) – a density matrix.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – If the density matrix is the incorrect size for the current circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-matrix-product-state" />
|
||
|
||
### set\_matrix\_product\_state
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_matrix_product_state" signature="RawFeatureVector.set_matrix_product_state(state)">
|
||
Set the matrix product state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** (*Tuple\[List\[Tuple\[np.array\[complex\_t]]]], List\[List\[float]]*) – A matrix\_product\_state.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – If the structure of the state is incorrect
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-stabilizer" />
|
||
|
||
### set\_stabilizer
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_stabilizer" signature="RawFeatureVector.set_stabilizer(state)">
|
||
Set the Clifford stabilizer state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** ([*Clifford*](qiskit.quantum_info.Clifford "qiskit.quantum_info.Clifford")) – A clifford operator.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – If the state is the incorrect size for the current circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-statevector" />
|
||
|
||
### set\_statevector
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_statevector" signature="RawFeatureVector.set_statevector(state)">
|
||
Set the statevector state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** ([*Statevector*](qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector")) – A state matrix.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – If the state is the incorrect size for the current circuit.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-superop" />
|
||
|
||
### set\_superop
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_superop" signature="RawFeatureVector.set_superop(state)">
|
||
Set the superop state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** (*QuantumChannel*) – A CPTP quantum channel.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
* **ExtensionError** – If the state is the incorrect size for the current circuit.
|
||
* **ExtensionError** – if the input QuantumChannel is not CPTP.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-set-unitary" />
|
||
|
||
### set\_unitary
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.set_unitary" signature="RawFeatureVector.set_unitary(state)">
|
||
Set the state state of the simulator.
|
||
|
||
**Parameters**
|
||
|
||
**state** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – A state matrix.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
* **ExtensionError** – If the state is the incorrect size for the current circuit.
|
||
* **ExtensionError** – if the input matrix is not unitary.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-size" />
|
||
|
||
### size
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.size" signature="RawFeatureVector.size()">
|
||
Returns total number of gate operations in circuit.
|
||
|
||
**Returns**
|
||
|
||
Total number of gate operations.
|
||
|
||
**Return type**
|
||
|
||
int
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot" />
|
||
|
||
### snapshot
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot" signature="RawFeatureVector.snapshot(label, snapshot_type='statevector', qubits=None, params=None)">
|
||
Take a statevector snapshot of the internal simulator representation. Works on all qubits, and prevents reordering (like barrier). :param label: a snapshot label to report the result :type label: str :param snapshot\_type: the type of the snapshot. :type snapshot\_type: str :param qubits: the qubits to apply snapshot to \[Default: None]. :type qubits: list or None :param params: the parameters for snapshot\_type \[Default: None]. :type params: list or None
|
||
|
||
**Returns**
|
||
|
||
with attached command
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – malformed command
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot-density-matrix" />
|
||
|
||
### snapshot\_density\_matrix
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot_density_matrix" signature="RawFeatureVector.snapshot_density_matrix(label, qubits=None)">
|
||
Take a density matrix snapshot of simulator state.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – a snapshot label to report the result
|
||
* **qubits** (*list or None*) – the qubits to apply snapshot to. If None all qubits will be snapshot \[Default: None].
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if snapshot is invalid.
|
||
|
||
<Admonition title="Note" type="note">
|
||
This method will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.save_density_matrix()`](qiskit.providers.aer.library.save_density_matrix "qiskit.providers.aer.library.save_density_matrix") circuit method.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot-expectation-value" />
|
||
|
||
### snapshot\_expectation\_value
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot_expectation_value" signature="RawFeatureVector.snapshot_expectation_value(label, op, qubits, single_shot=False, variance=False)">
|
||
Take a snapshot of expectation value \<O> of an Operator.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – a snapshot label to report the result
|
||
* **op** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator")) – operator to snapshot
|
||
* **qubits** (*list*) – the qubits to snapshot.
|
||
* **single\_shot** (*bool*) – return list for each shot rather than average \[Default: False]
|
||
* **variance** (*bool*) – compute variance of values \[Default: False]
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if snapshot is invalid.
|
||
|
||
<Admonition title="Note" type="note">
|
||
This method will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.save_expectation_value()`](qiskit.providers.aer.library.save_expectation_value "qiskit.providers.aer.library.save_expectation_value") and [`qiskit.providers.aer.library.save_expectation_value_variance()`](qiskit.providers.aer.library.save_expectation_value_variance "qiskit.providers.aer.library.save_expectation_value_variance") circuit methods.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot-probabilities" />
|
||
|
||
### snapshot\_probabilities
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot_probabilities" signature="RawFeatureVector.snapshot_probabilities(label, qubits, variance=False)">
|
||
Take a probability snapshot of the simulator state.
|
||
|
||
**Parameters**
|
||
|
||
* **label** (*str*) – a snapshot label to report the result
|
||
* **qubits** (*list*) – the qubits to snapshot.
|
||
* **variance** (*bool*) – compute variance of probabilities \[Default: False]
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**ExtensionError** – if snapshot is invalid.
|
||
|
||
<Admonition title="Note" type="note">
|
||
This method will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.save_probabilities()`](qiskit.providers.aer.library.save_probabilities "qiskit.providers.aer.library.save_probabilities") and [`qiskit.providers.aer.library.save_probabilities_dict()`](qiskit.providers.aer.library.save_probabilities_dict "qiskit.providers.aer.library.save_probabilities_dict") circuit methods.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot-stabilizer" />
|
||
|
||
### snapshot\_stabilizer
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot_stabilizer" signature="RawFeatureVector.snapshot_stabilizer(label)">
|
||
Take a stabilizer snapshot of the simulator state.
|
||
|
||
**Parameters**
|
||
|
||
**label** (*str*) – a snapshot label to report the result.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**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 method will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.save_stabilizer()`](qiskit.providers.aer.library.save_stabilizer "qiskit.providers.aer.library.save_stabilizer") circuit method.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-snapshot-statevector" />
|
||
|
||
### snapshot\_statevector
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.snapshot_statevector" signature="RawFeatureVector.snapshot_statevector(label)">
|
||
Take a statevector snapshot of the simulator state.
|
||
|
||
**Parameters**
|
||
|
||
**label** (*str*) – a snapshot label to report the result.
|
||
|
||
**Returns**
|
||
|
||
with attached instruction.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**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 method will be deprecated after the qiskit-aer 0.8 release. It has been superseded by the [`qiskit.providers.aer.library.save_statevector()`](qiskit.providers.aer.library.save_statevector "qiskit.providers.aer.library.save_statevector") circuit method.
|
||
</Admonition>
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-squ" />
|
||
|
||
### squ
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.squ" signature="RawFeatureVector.squ(unitary_matrix, qubit, mode='ZYZ', up_to_diagonal=False, *, u=None)">
|
||
Decompose an arbitrary 2\*2 unitary into three rotation gates.
|
||
|
||
Note that the decomposition is up to a global phase shift. (This is a well known decomposition, which can be found for example in Nielsen and Chuang’s book “Quantum computation and quantum information”.)
|
||
|
||
**Parameters**
|
||
|
||
* **unitary\_matrix** (*ndarray*) – 2\*2 unitary (given as a (complex) ndarray).
|
||
* **qubit** (*QuantumRegister | Qubit*) – The qubit which the gate is acting on.
|
||
* **mode** (*string*) – determines the used decomposition by providing the rotation axes. The allowed modes are: “ZYZ” (default)
|
||
* **up\_to\_diagonal** (*bool*) – if set to True, the single-qubit unitary is decomposed up to a diagonal matrix, i.e. a unitary u’ is implemented such that there exists a 2\*2 diagonal gate d with u = d.dot(u’)
|
||
* **u** (*ndarray*) – Deprecated, use `unitary_matrix` instead.
|
||
|
||
**Returns**
|
||
|
||
The single-qubit unitary instruction attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[InstructionSet](qiskit.circuit.InstructionSet "qiskit.circuit.InstructionSet")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the format is wrong; if the array u is not unitary
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-swap" />
|
||
|
||
### swap
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.swap" signature="RawFeatureVector.swap(qubit1, qubit2)">
|
||
Apply [`SwapGate`](qiskit.circuit.library.SwapGate "qiskit.circuit.library.SwapGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-sx" />
|
||
|
||
### sx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.sx" signature="RawFeatureVector.sx(qubit)">
|
||
Apply [`SXGate`](qiskit.circuit.library.SXGate "qiskit.circuit.library.SXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-sxdg" />
|
||
|
||
### sxdg
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.sxdg" signature="RawFeatureVector.sxdg(qubit)">
|
||
Apply [`SXdgGate`](qiskit.circuit.library.SXdgGate "qiskit.circuit.library.SXdgGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-t" />
|
||
|
||
### t
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.t" signature="RawFeatureVector.t(qubit)">
|
||
Apply [`TGate`](qiskit.circuit.library.TGate "qiskit.circuit.library.TGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-tdg" />
|
||
|
||
### tdg
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.tdg" signature="RawFeatureVector.tdg(qubit)">
|
||
Apply [`TdgGate`](qiskit.circuit.library.TdgGate "qiskit.circuit.library.TdgGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-tensor" />
|
||
|
||
### tensor
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.tensor" signature="RawFeatureVector.tensor(other, inplace=False)">
|
||
Tensor `self` with `other`.
|
||
|
||
Remember that in the little-endian convention the leftmost operation will be at the bottom of the circuit. See also [the docs](/guides/bit-ordering) for more information.
|
||
|
||
```python
|
||
┌────────┐ ┌─────┐ ┌─────┐
|
||
q_0: ┤ bottom ├ ⊗ q_0: ┤ top ├ = q_0: ─┤ top ├──
|
||
└────────┘ └─────┘ ┌┴─────┴─┐
|
||
q_1: ┤ bottom ├
|
||
└────────┘
|
||
```
|
||
|
||
**Parameters**
|
||
|
||
* **other** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")) – The other circuit to tensor this circuit with.
|
||
* **inplace** (*bool*) – If True, modify the object. Otherwise return composed circuit.
|
||
|
||
**Examples**
|
||
|
||
```python
|
||
from qiskit import QuantumCircuit
|
||
top = QuantumCircuit(1)
|
||
top.x(0);
|
||
bottom = QuantumCircuit(2)
|
||
bottom.cry(0.2, 0, 1);
|
||
tensored = bottom.tensor(top)
|
||
print(tensored.draw())
|
||
```
|
||
|
||
```
|
||
┌───┐
|
||
q_0: ───┤ X ├───
|
||
└───┘
|
||
q_1: ─────■─────
|
||
┌────┴────┐
|
||
q_2: ┤ Ry(0.2) ├
|
||
└─────────┘
|
||
```
|
||
|
||
**Returns**
|
||
|
||
The tensored circuit (returns None if inplace==True).
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-to-gate" />
|
||
|
||
### to\_gate
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.to_gate" signature="RawFeatureVector.to_gate(parameter_map=None, label=None)">
|
||
Create a Gate out of this circuit.
|
||
|
||
**Parameters**
|
||
|
||
* **parameter\_map** (*dict*) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the gate. If None, existing circuit parameters will also parameterize the gate.
|
||
* **label** (*str*) – Optional gate label.
|
||
|
||
**Returns**
|
||
|
||
a composite gate encapsulating this circuit (can be decomposed back)
|
||
|
||
**Return type**
|
||
|
||
[Gate](qiskit.circuit.Gate "qiskit.circuit.Gate")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-to-instruction" />
|
||
|
||
### to\_instruction
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.to_instruction" signature="RawFeatureVector.to_instruction(parameter_map=None, label=None)">
|
||
Create an Instruction out of this circuit.
|
||
|
||
**Parameters**
|
||
|
||
* **parameter\_map** (*dict*) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the instruction. If None, existing circuit parameters will also parameterize the instruction.
|
||
* **label** (*str*) – Optional gate label.
|
||
|
||
**Returns**
|
||
|
||
a composite instruction encapsulating this circuit (can be decomposed back)
|
||
|
||
**Return type**
|
||
|
||
[qiskit.circuit.Instruction](qiskit.circuit.Instruction "qiskit.circuit.Instruction")
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-toffoli" />
|
||
|
||
### toffoli
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.toffoli" signature="RawFeatureVector.toffoli(control_qubit1, control_qubit2, target_qubit)">
|
||
Apply [`CCXGate`](qiskit.circuit.library.CCXGate "qiskit.circuit.library.CCXGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-u" />
|
||
|
||
### u
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.u" signature="RawFeatureVector.u(theta, phi, lam, qubit)">
|
||
Apply [`UGate`](qiskit.circuit.library.UGate "qiskit.circuit.library.UGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-u1" />
|
||
|
||
### u1
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.u1" signature="RawFeatureVector.u1(theta, qubit)">
|
||
Apply [`U1Gate`](qiskit.circuit.library.U1Gate "qiskit.circuit.library.U1Gate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-u2" />
|
||
|
||
### u2
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.u2" signature="RawFeatureVector.u2(phi, lam, qubit)">
|
||
Apply [`U2Gate`](qiskit.circuit.library.U2Gate "qiskit.circuit.library.U2Gate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-u3" />
|
||
|
||
### u3
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.u3" signature="RawFeatureVector.u3(theta, phi, lam, qubit)">
|
||
Apply [`U3Gate`](qiskit.circuit.library.U3Gate "qiskit.circuit.library.U3Gate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-uc" />
|
||
|
||
### uc
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.uc" signature="RawFeatureVector.uc(gate_list, q_controls, q_target, up_to_diagonal=False)">
|
||
Attach a uniformly controlled gates (also called multiplexed gates) to a circuit.
|
||
|
||
The decomposition was introduced by Bergholm et al. in [https://arxiv.org/pdf/quant-ph/0410066.pdf](https://arxiv.org/pdf/quant-ph/0410066.pdf).
|
||
|
||
**Parameters**
|
||
|
||
* **gate\_list** (*list\[ndarray]*) – list of two qubit unitaries \[U\_0,…,U\_\{2^k-1}], where each single-qubit unitary U\_i is a given as a 2\*2 array
|
||
* **q\_controls** (*QuantumRegister|list\[(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*,int)]*) – list of k control qubits. The qubits are ordered according to their significance in the computational basis. For example if q\_controls=\[q\[1],q\[2]] (with q = QuantumRegister(2)), the unitary U\_0 is performed if q\[1] and q\[2] are in the state zero, U\_1 is performed if q\[2] is in the state zero and q\[1] is in the state one, and so on
|
||
* **q\_target** (*QuantumRegister|(*[*QuantumRegister*](qiskit.circuit.QuantumRegister "qiskit.circuit.QuantumRegister")*,int)*) – target qubit, where we act on with the single-qubit gates.
|
||
* **up\_to\_diagonal** (*bool*) – If set to True, the uniformly controlled gate is decomposed up to a diagonal gate, i.e. a unitary u’ is implemented such that there exists a diagonal gate d with u = d.dot(u’), where the unitary u describes the uniformly controlled gate
|
||
|
||
**Returns**
|
||
|
||
the uniformly controlled gate is attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ucrx" />
|
||
|
||
### ucrx
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ucrx" signature="RawFeatureVector.ucrx(angle_list, q_controls, q_target)">
|
||
Attach a uniformly controlled (also called multiplexed) Rx rotation gate to a circuit.
|
||
|
||
The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
|
||
|
||
**Parameters**
|
||
|
||
* **angle\_list** (*list*) – list of (real) rotation angles $[a_0,...,a_{2^k-1}]$
|
||
* **q\_controls** (*QuantumRegister|list*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if `q_controls=[q[0],q[1]]` (with `q = QuantumRegister(2)`), the rotation `Rx(a_0)` is performed if `q[0]` and `q[1]` are in the state zero, the rotation `Rx(a_1)` is performed if `q[0]` is in the state one and `q[1]` is in the state zero, and so on
|
||
* **q\_target** (*QuantumRegister|Qubit*) – target qubit, where we act on with the single-qubit rotation gates
|
||
|
||
**Returns**
|
||
|
||
the uniformly controlled rotation gate is attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ucry" />
|
||
|
||
### ucry
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ucry" signature="RawFeatureVector.ucry(angle_list, q_controls, q_target)">
|
||
Attach a uniformly controlled (also called multiplexed) Ry rotation gate to a circuit.
|
||
|
||
The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
|
||
|
||
**Parameters**
|
||
|
||
* **angle\_list** (*list\[numbers*) – list of (real) rotation angles $[a_0,...,a_{2^k-1}]$
|
||
* **q\_controls** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if `q_controls=[q[0],q[1]]` (with `q = QuantumRegister(2)`), the rotation `Ry(a_0)` is performed if `q[0]` and `q[1]` are in the state zero, the rotation `Ry(a_1)` is performed if `q[0]` is in the state one and `q[1]` is in the state zero, and so on
|
||
* **q\_target** (*QuantumRegister|Qubit*) – target qubit, where we act on with the single-qubit rotation gates
|
||
|
||
**Returns**
|
||
|
||
the uniformly controlled rotation gate is attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-ucrz" />
|
||
|
||
### ucrz
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.ucrz" signature="RawFeatureVector.ucrz(angle_list, q_controls, q_target)">
|
||
Attach a uniformly controlled (also called multiplexed gates) Rz rotation gate to a circuit.
|
||
|
||
The decomposition is base on [https://arxiv.org/pdf/quant-ph/0406176.pdf](https://arxiv.org/pdf/quant-ph/0406176.pdf) by Shende et al.
|
||
|
||
**Parameters**
|
||
|
||
* **angle\_list** (*list\[numbers*) – list of (real) rotation angles \[a\_0,…,a\_\{2^k-1}]
|
||
* **q\_controls** (*QuantumRegister|list\[*[*Qubit*](qiskit.circuit.Qubit "qiskit.circuit.Qubit")*]*) – list of k control qubits (or empty list if no controls). The control qubits are ordered according to their significance in increasing order: For example if q\_controls=\[q\[1],q\[2]] (with q = QuantumRegister(2)), the rotation Rz(a\_0)is performed if q\[1] and q\[2] are in the state zero, the rotation Rz(a\_1) is performed if q\[1] is in the state one and q\[2] is in the state zero, and so on
|
||
* **q\_target** (*QuantumRegister|Qubit*) – target qubit, where we act on with the single-qubit rotation gates
|
||
|
||
**Returns**
|
||
|
||
the uniformly controlled rotation gate is attached to the circuit.
|
||
|
||
**Return type**
|
||
|
||
[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
|
||
|
||
**Raises**
|
||
|
||
**QiskitError** – if the list number of control qubits does not correspond to the provided number of single-qubit unitaries; if an input is of the wrong type
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-unitary" />
|
||
|
||
### unitary
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.unitary" signature="RawFeatureVector.unitary(obj, qubits, label=None)">
|
||
Apply unitary gate to q.
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-width" />
|
||
|
||
### width
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.width" signature="RawFeatureVector.width()">
|
||
Return number of qubits plus clbits in circuit.
|
||
|
||
**Returns**
|
||
|
||
Width of circuit.
|
||
|
||
**Return type**
|
||
|
||
int
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-x" />
|
||
|
||
### x
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.x" signature="RawFeatureVector.x(qubit, label=None)">
|
||
Apply [`XGate`](qiskit.circuit.library.XGate "qiskit.circuit.library.XGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-y" />
|
||
|
||
### y
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.y" signature="RawFeatureVector.y(qubit)">
|
||
Apply [`YGate`](qiskit.circuit.library.YGate "qiskit.circuit.library.YGate").
|
||
</Function>
|
||
|
||
<span id="qiskit-ml-circuit-library-rawfeaturevector-z" />
|
||
|
||
### z
|
||
|
||
<Function id="qiskit.ml.circuit.library.RawFeatureVector.z" signature="RawFeatureVector.z(qubit)">
|
||
Apply [`ZGate`](qiskit.circuit.library.ZGate "qiskit.circuit.library.ZGate").
|
||
</Function>
|
||
|
||
## Attributes
|
||
|
||
### ancillas
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.ancillas">
|
||
Returns a list of ancilla bits in the order that the registers were added.
|
||
</Attribute>
|
||
|
||
### calibrations
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.calibrations">
|
||
Return calibration dictionary.
|
||
|
||
**The custom pulse definition of a given gate is of the form**
|
||
|
||
\{‘gate\_name’: \{(qubits, params): schedule}}
|
||
</Attribute>
|
||
|
||
### clbits
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.clbits">
|
||
Returns a list of classical bits in the order that the registers were added.
|
||
</Attribute>
|
||
|
||
### data
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.data" />
|
||
|
||
### extension\_lib
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.extension_lib" attributeValue="'include "qelib1.inc";'" />
|
||
|
||
### feature\_dimension
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.feature_dimension">
|
||
Return the feature dimension.
|
||
|
||
**Return type**
|
||
|
||
`int`
|
||
|
||
**Returns**
|
||
|
||
The feature dimension, which is `2 ** num_qubits`.
|
||
</Attribute>
|
||
|
||
### global\_phase
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.global_phase">
|
||
Return the global phase of the circuit in radians.
|
||
</Attribute>
|
||
|
||
### header
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.header" attributeValue="'OPENQASM 2.0;'" />
|
||
|
||
### instances
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.instances" attributeValue="16" />
|
||
|
||
### metadata
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.metadata">
|
||
The user provided metadata associated with the circuit
|
||
|
||
The metadata for the circuit is a user provided `dict` of metadata for the circuit. It will not be used to influence the execution or operation of the circuit, but it is expected to be passed between all transforms of the circuit (ie transpilation) and that providers will associate any circuit metadata with the results it returns from execution of that circuit.
|
||
</Attribute>
|
||
|
||
### num\_ancillas
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.num_ancillas">
|
||
Return the number of ancilla qubits.
|
||
</Attribute>
|
||
|
||
### num\_clbits
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.num_clbits">
|
||
Return number of classical bits.
|
||
</Attribute>
|
||
|
||
### num\_parameters
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.num_parameters">
|
||
**Return type**
|
||
|
||
`int`
|
||
</Attribute>
|
||
|
||
### num\_qubits
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.num_qubits">
|
||
Returns the number of qubits in this circuit.
|
||
|
||
**Return type**
|
||
|
||
`int`
|
||
|
||
**Returns**
|
||
|
||
The number of qubits.
|
||
</Attribute>
|
||
|
||
### ordered\_parameters
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.ordered_parameters">
|
||
Return the free parameters in the RawFeatureVector.
|
||
|
||
**Return type**
|
||
|
||
`List`\[`ParameterExpression`]
|
||
|
||
**Returns**
|
||
|
||
A list of the free parameters.
|
||
</Attribute>
|
||
|
||
### parameters
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.parameters">
|
||
Return the free parameters in the RawFeatureVector.
|
||
|
||
**Return type**
|
||
|
||
`Set`\[`ParameterExpression`]
|
||
|
||
**Returns**
|
||
|
||
A set of the free parameters.
|
||
</Attribute>
|
||
|
||
### prefix
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.prefix" attributeValue="'circuit'" />
|
||
|
||
### qregs
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.qregs">
|
||
A list of the quantum registers associated with the circuit.
|
||
</Attribute>
|
||
|
||
### qubits
|
||
|
||
<Attribute id="qiskit.ml.circuit.library.RawFeatureVector.qubits">
|
||
Returns a list of quantum bits in the order that the registers were added.
|
||
</Attribute>
|
||
</Class>
|
||
|