QuantumCircuit クラス

回路データ（命令とコンテキスト）。

例

from qiskit import QuantumCircuit

qc = QuantumCircuit(2, 2)
qc.measure([0], [1])
print(qc.data)

[CircuitInstruction(operation=Instruction(name='measure', num_qubits=1,
num_clbits=1, params=[]), qubits=(Qubit(QuantumRegister(2, 'q'), 0),),
clbits=(Clbit(ClassicalRegister(2, 'c'), 1),))]

戻り値

回路内のインスタンス CircuitInstruction を含む、リストのようなオブジェクト。

ラジアン単位の電流回路スコープのグローバル位相。

例

from qiskit import QuantumCircuit

circuit = QuantumCircuit(2)
circuit.h(0)
circuit.cx(0, 1)
print(circuit.global_phase)

0.0

from numpy import pi

circuit.global_phase = pi/4
print(circuit.global_phase)

0.7853981633974483

種類： str

人間が読める回路名。

例

from qiskit import QuantumCircuit

qc = QuantumCircuit(2, 2, name="my_circuit")
print(qc.name)

my_circuit

回路のメタデータのユーザー定義辞書。

Qiskitはこのマッピングの内容を調べませんが、トランスパイラを通過させて出力に再アタッチするので、独自のメタデータを追跡することができます。

例

from qiskit import QuantumCircuit

qc = QuantumCircuit(2, 2, metadata={'experiment_type': 'Bell state experiment'})

print(qc.metadata)

{'experiment_type': 'Bell state experiment'}

のリスト。 Qubitを追加された順に並べたもの。 変異させてはいけない。

のリスト。 Clbitを追加された順に並べたもの。 変異させてはいけない。

のリスト。 Qubitを追加された順に並べたもの。 変異させてはいけない。

のリスト。 AncillaQubitを追加された順に並べたもの。 変異させてはいけない。

のリスト。 Clbitを追加された順に並べたもの。 変異させてはいけない。

例

from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit

qr1 = QuantumRegister(2)
qr2 = QuantumRegister(1)
cr1 = ClassicalRegister(2)
cr2 = ClassicalRegister(1)
qc = QuantumCircuit(qr1, qr2, cr1, cr2)

print("List the qubits in this circuit:", qc.qubits)
print("List the classical bits in this circuit:", qc.clbits)

List the qubits in this circuit: [Qubit(QuantumRegister(2, 'q0'), 0),
Qubit(QuantumRegister(2, 'q0'), 1), Qubit(QuantumRegister(1, 'q1'), 0)]
List the classical bits in this circuit: [Clbit(ClassicalRegister(2, 'c0'), 0),
Clbit(ClassicalRegister(2, 'c0'), 1), Clbit(ClassicalRegister(1, 'c1'), 0)]

回路で定義されたパラメータ。

この属性は、回路内のオブジェクトを Parameter アルファベット順に並べ替えて返します。 なお、でインスタンス化されたパラメータも ParameterVector 、数値順にソートされることに注意してください。

例

以下のスニペットは、パラメーターの挿入順序は問題ではないことを示している。

>>> from qiskit.circuit import QuantumCircuit, Parameter
>>> a, b, elephant = Parameter("a"), Parameter("b"), Parameter("elephant")
>>> circuit = QuantumCircuit(1)
>>> circuit.rx(b, 0)
>>> circuit.rz(elephant, 0)
>>> circuit.ry(a, 0)
>>> circuit.parameters  # sorted alphabetically!
ParameterView([Parameter(a), Parameter(b), Parameter(elephant)])

アルファベット順の並べ替えは、数字に関しては直感的でない可能性があることに留意してほしい。 アルファベット順に並べると、"10 "は "2 "の前に来る。

>>> from qiskit.circuit import QuantumCircuit, Parameter
>>> angles = [Parameter("angle_1"), Parameter("angle_2"), Parameter("angle_10")]
>>> circuit = QuantumCircuit(1)
>>> circuit.u(*angles, 0)
>>> circuit.draw()
   ┌─────────────────────────────┐
q: ┤ U(angle_1,angle_2,angle_10) ├
   └─────────────────────────────┘
>>> circuit.parameters
ParameterView([Parameter(angle_1), Parameter(angle_10), Parameter(angle_2)])

数値順の並べ替えを尊重するには、a ParameterVector を使用できます。

>>> from qiskit.circuit import QuantumCircuit, Parameter, ParameterVector
>>> x = ParameterVector("x", 12)
>>> circuit = QuantumCircuit(1)
>>> for x_i in x:
...     circuit.rx(x_i, 0)
>>> circuit.parameters
ParameterView([
    ParameterVectorElement(x[0]), ParameterVectorElement(x[1]),
    ParameterVectorElement(x[2]), ParameterVectorElement(x[3]),
    ..., ParameterVectorElement(x[11])
])

戻り値

回路内のソート Parameter 済みのオブジェクト。

回路に関連するレイアウト情報を返す。

この属性には、オプション TranspileLayout のオブジェクトが含まれます。 これは通常、トランスピレーションによって入力回路に生じる置換に関する情報を保持するために、 transpile() 出力 または PassManager.run() に設定されます。

SwapGateTargetこの transpile() 関数によって生じる順列には2種類あります。1つは、で選択された物理量子ビットに基づいて量子ビットの配置を並べ替える初期配置であり、もう1つは、ルーティング中に挿入されたsによって生じる出力順列である最終配置です。

例

from qiskit import QuantumCircuit
from qiskit.providers.fake_provider import GenericBackendV2
from qiskit.transpiler import generate_preset_pass_manager

# Create circuit to test transpiler on
qc = QuantumCircuit(3, 3)
qc.h(0)
qc.cx(0, 1)
qc.swap(1, 2)
qc.cx(0, 1)

# Add measurements to the circuit
qc.measure([0, 1, 2], [0, 1, 2])

# Specify the QPU to target
backend = GenericBackendV2(3)

# Transpile the circuit
pass_manager = generate_preset_pass_manager(
optimization_level=1, backend=backend
)
transpiled = pass_manager.run(qc)

# Print the layout after transpilation
print(transpiled.layout.routing_permutation())

[0, 1, 2]

スケジューリング・トランスパイラのパスによって設定される回路の合計時間。 その単位は unit.

単位 duration で指定される。

運転開始時間のリストを返す。

この属性は、スケジューリング解析パスの1つが量子回路上で実行されると有効になる。

例

from qiskit import QuantumCircuit
from qiskit.providers.fake_provider import GenericBackendV2
from qiskit.transpiler import generate_preset_pass_manager

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

# Print the original circuit
print("Original circuit:")
print(qc)

# Transpile the circuit with a specific basis gates list and print the resulting circuit
backend = GenericBackendV2(2, basis_gates=['u1', 'u2', 'u3', 'cx'])
pm = generate_preset_pass_manager(
    optimization_level=1, backend=backend, scheduling_method="alap"
)
transpiled_qc = pm.run(qc)
print("Transpiled circuit with basis gates ['u1', 'u2', 'u3', 'cx']:")
print(transpiled_qc)

# Print the start times of each instruction in the transpiled circuit
print("Start times of instructions in the transpiled circuit:")
for instruction, start_time in zip(transpiled_qc.data, transpiled_qc.op_start_times):
    print(f"{instruction.operation.name}: {start_time}")

Original circuit:
        ┌───┐      ░ ┌─┐
q_0: ┤ H ├──■───░─┤M├───
        └───┘┌─┴─┐ ░ └╥┘┌─┐
q_1: ─────┤ X ├─░──╫─┤M├
            └───┘ ░  ║ └╥┘
meas: 2/══════════════╩══╩═
                    0  1

Transpiled circuit with basis gates ['u1', 'u2', 'u3', 'cx']:
            ┌─────────┐          ░ ┌─────────────────┐┌─┐
q_0 -> 0 ───┤ U2(0,π) ├──────■───░─┤ Delay(1255[dt]) ├┤M├
        ┌──┴─────────┴───┐┌─┴─┐ ░ └───────┬─┬───────┘└╥┘
q_1 -> 1 ┤ Delay(196[dt]) ├┤ X ├─░─────────┤M├─────────╫─
        └────────────────┘└───┘ ░         └╥┘         ║
meas: 2/═══════════════════════════════════╩══════════╩═
                                            1          0

Start times of instructions in the transpiled circuit:
u2: 0
delay: 0
cx: 196
barrier: 2098
delay: 2098
measure: 3353
measure: 2098

戻り値

命令の開始予定時刻を表す整数のリスト。 の命令のインデックスに対応する。 QuantumCircuit.data.

レイズ

AttributeError - サーキットが予定されていない場合。

アンシラ量子ビットの数を返す。

例

from qiskit import QuantumCircuit, QuantumRegister, AncillaRegister

# Create a 2-qubit quantum circuit
reg = QuantumRegister(2)
qc = QuantumCircuit(reg)

# Create an ancilla register with 1 qubit
anc = AncillaRegister(1)
qc.add_register(anc)  # Add the ancilla register to the circuit

print("Number of ancilla qubits:", qc.num_ancillas)

Number of ancilla qubits: 1

クラシックビットの数を返す。

例

from qiskit import QuantumCircuit

# Create a new circuit with two qubits and one classical bit
qc = QuantumCircuit(2, 1)
print("Number of classical bits:", qc.num_clbits)

Number of classical bits: 1

スコープからキャプチャされたものとしてマークされた回路内のリアルタイム古典変数の数。

これは iter_captured_vars() の長さである。 これがゼロでない場合 num_input_vars はゼロでなければならない。

スコープからキャプチャされたとしてマークされた回路内のストレッチの数。

これは iter_captured_stretches() の長さである。 これがゼロでない場合 num_input_vars はゼロでなければならない。

入力またはキャプチャを除く、この回路スコープで宣言されている回路内のリアルタイム・クラシック変数の数。

これは iter_declared_vars() の長さである。

キャプチャを除く、この回路スコープで宣言されている回路のストレッチの数。

これは iter_declared_stretches() の長さである。

回路入力としてマークされた回路内のリアルタイム古典変数の数。

これは iter_input_vars() の長さである。 これがゼロでない場合 num_captured_vars はゼロでなければならない。

回路内のリアルタイム古典変数とストレッチの数。

これは以下と等しい。 num_vars() + num_stretches().

回路内のパラメータオブジェクトの数。

量子ビット数を返す。

回路内のストレッチの数。

これは iter_stretches() の長さである。

回路内のリアルタイム古典変数の数。

これは iter_vars() の長さである。

__init__(*regs, name=None, global_phase=0, metadata=None, inputs=(), captures=(), declarations=())

のデフォルトコンストラクタです。 QuantumCircuit.

パラメーター

• regs (Register |int |Sequence[Bit]) –

  回路に含まれるレジスタ。

  • オブジェクトのリストが Register オブジェクトのリストは QuantumRegister または ClassicalRegister オブジェクトを表します。

    例:

    • QuantumCircuit(QuantumRegister(4))
    • QuantumCircuit(QuantumRegister(4), ClassicalRegister(3))
    • QuantumCircuit(QuantumRegister(4, 'qr0'), QuantumRegister(2, 'qr1'))

  • int のリストの場合、回路に含める量子ビットおよび/または古典ビットの量。 量子ビットの数だけを表す1つのintか、量子ビットと古典ビットの数をそれぞれ表す2つのintを指定することができる。

    例:

    • QuantumCircuit(4) # A QuantumCircuit with 4 qubits
    • QuantumCircuit(4, 3) # A QuantumCircuit with 4 qubits and 3 classical bits

  • オブジェクトを含む Bit オブジェクトのコレクション Bit のコレクションが回路に追加されます。

• name (str | None) – 量子回路の名前。 設定されていない場合は、自動生成された文字列が割り当てられる。

• global_phase (ParameterExpression |float) – 回路のグローバル位相（ラジアン単位）。

• metadata (dict | None) – 回路に関連付ける任意のキー・バリューのメタデータ。 これは、自由形式のデータとして metadata 属性に格納される。 回路に直接使用されることはない。

• inputs (Iterable[Var]) – この回路で実行時 input 変数として宣言する変数はありますか。 これらは、すでに別の場所から作成済みの expr.Var ノードであるはずです。入力も作成する必要がある場合は、. を使用してください QuantumCircuit.add_input()。 この引数で指定された変数は、直接 に渡されます add_input()。 ある回路において、とが inputs 同時に成立することは capturesない。

• captures (Iterable[Var |Stretch]) – この回路スコープが、包含するスコープから取得すべき変数。 ここで指定された変数は、直接 に渡されます add_capture()。 ある回路において、とが inputs 同時に成立することは capturesない。

• declarations (Mapping[Var, Expr] | Iterable[tuple[Var, Expr]]) –

  この回路が宣言し、すぐに初期化すべき変数。 この入力を順番に並べることで、後の宣言が前の宣言（入力やキャプチャを含む）に依存するようにできる。 実行時に後で計算される値に依存する必要がある場合は、回路実行の適切な時点で add_var() を使用します。

  この引数は、すでに作成された変数のセットを持っている場合に、回路の初期化を便利に行うためのものである。 ここで使用する変数は、直接 add_var()に直接渡される。

レイズ

• CircuitError - もし回路名が与えられていれば、それが有効でない場合。
• CircuitError - inputs と captures の両方が与えられた場合。

copy(name=None)

回路をコピーする。

パラメーター

name (str) – コピーされた回路に与えられる名前。 Noneの場合、名前はそのまま。

戻り値

現在の回路のディープコピー

戻りの型

QuantumCircuit

copy_empty_like(name=None, *, vars_mode='alike')

同じ構造を持つが空のselfのコピーを返す。

その構造には以下のようなものがある：

• 名前とその他のメタデータ
• グローバルフェーズ
• レジスタを含むすべてのqubitsとclbits
• vars キーワード引数に従って処理される。

パラメーター

• name (str | None) – コピーした回路の名前。 Noneの場合、名前はそのまま。

• vars_mode (Literal['alike', 'captures', 'drop']) –

  リアルタイム変数を扱うモード。

  同じ

  出力回路の変数は、元の回路と同じ宣言セマンティクスを持つ。 例えば、ソースの input 変数は、出力回路の input 変数になる。 ストアがコピーされないため、ローカル変数が初期化されないことに注意。 このため、ユーザーがイニシャライザー・ストアを追加し直さなければ、回路が潜在的に危険な状態になる可能性がある。

  キャプチャー

  すべての変数はキャプチャ変数に変換される。 これは、既存の回路に新しいレイヤーを追加する場合に便利である。 compose() というのも compose() はキャプチャをベース回路にインライン化できるからです（他の変数はできません）。

  ドロップ

  出力回路には変数が定義されていない。

戻り値

selfの空のコピー。

戻りの型

QuantumCircuit

static from_instructions(instructions, *, qubits=(), clbits=(), name=None, global_phase=0, metadata=None)

CircuitInstructions の反復可能オブジェクトから回路を構築する。

パラメーター

• instructions (Iterable[CircuitInstruction |tuple[qiskit.circuit.Instruction] | tuple[qiskit.circuit.Instruction, Iterable[Qubit]] | tuple[qiskit.circuit.Instruction, Iterable[Qubit], Iterable[Clbit]]]) – 回路に追加するための手順。
• qubits (Iterable[Qubit]) – 回路に追加する任意の量子ビット。 この引数は、例えば、量子ビットの特定の順序を強制するために使うことができる。
• clbits (Iterable[Clbit]) – 回路に追加する古典的なビットがあれば何でも。 この引数は、例えば、古典的なビットの特定の順序を強制するために使うことができる。
• name (str | None) – 回路の名前。
• global_phase (ParameterValueType) – ラジアン単位の回路のグローバル位相。
• metadata (dict | None) – 回路に関連付ける任意のキー・バリューのメタデータ。

戻り値

量子回路。

戻りの型

QuantumCircuit

static from_qasm_file(path)

OpenQASM 2.0 プログラムをファイルから読み込み、以下のインスタンスに変換する。 QuantumCircuit.

パラメーター

path (str |PathLike) – OpenQASM 2 プログラムのファイルへのパス

戻り値

OpenQASM 2. 入力された QuantumCircuit オブジェクト。

戻りの型

QuantumCircuit

static from_qasm_str(qasm_str)

OpenQASM 2.0 プログラムを含む文字列を、次のように変換する。 QuantumCircuit.

パラメーター

qasm_str (str) – OpenQASM 2.0 プログラムを含む文字列。

戻り値

OpenQASM 2 入力に対する QuantumCircuit オブジェクト

戻りの型

QuantumCircuit

add_bits(bits)

回路にビットを追加する。

パラメーター

bits (Iterable[Bit])

戻りの型

なし

add_register(*regs)

レジスタを追加する。

パラメーター

regs (Register |int |Sequence[Bit])

戻りの型

なし

add_var(name_or_var, /, initial)

この回路に、自動記憶とスコープを持つ古典変数を追加する。

変数は回路の最初に "宣言 "されたものとみなされるが、初期化されるのはこのメソッドを呼び出した時点なので、それ以前に定義された変数に依存することができる。

パラメーター

• name_or_var (str |Var) – 変数名の文字列、または再利用する Var 既存のインスタンスのいずれか。 変数は、回路内で既に使用されている名前を隠蔽することはできません。

• initial (Any) –

  この変数を初期化する値。 最初の引数が文字列名で与えられた場合、結果の変数の型は最初の式から推測される。 Var.new() を使って手動で希望の型を持つ新しい変数を作成するか、あるいは expr.cast() を使って初期化子を希望の型にキャストします。

  これは Expr ノードか、 expr.lift を使って1つにリフティングできる値でなければならない。

戻り値

作成された変数。 もし Var インスタンスが与えられた場合は、まったく同じオブジェクトが返される。

レイズ

CircuitError - 既存の識別子をシャドウイングするために変数を作成できない場合。

戻りの型

Var

例

名前とイニシャライザー式だけで新しい変数を定義する：

from qiskit.circuit import QuantumCircuit

qc = QuantumCircuit(2)
my_var = qc.add_var("my_var", False)

関連する回路から取り出したり、手動で構築した変数を再利用し、より複雑な式で初期化する：

from qiskit.circuit import QuantumCircuit, QuantumRegister, ClassicalRegister
from qiskit.circuit.classical import expr, types

my_var = expr.Var.new("my_var", types.Uint(8))

cr1 = ClassicalRegister(8, "cr1")
cr2 = ClassicalRegister(8, "cr2")
qc = QuantumCircuit(QuantumRegister(8), cr1, cr2)

# Get some measurement results into each register.
qc.h(0)
for i in range(1, 8):
    qc.cx(0, i)
qc.measure(range(8), cr1)

qc.reset(range(8))
qc.h(0)
for i in range(1, 8):
    qc.cx(0, i)
qc.measure(range(8), cr2)

# Now when we add the variable, it is initialized using the real-time state of the
# two classical registers we measured into above.
qc.add_var(my_var, expr.bit_and(cr1, cr2))

add_input(name_or_var: str, type_: Type, /) → Var

add_input(name_or_var: Var, type_: None = None, /) → Var

変数を回路の入力として登録する。

パラメーター

• name_or_var (str |Var) – 文字列名、または入力変数として使用する既存の Var ノードのいずれか。
• 型 - 名前が文字列で指定された場合、これは変数に使用する Type でなければならない。 変数に既存の Varとして与えられた場合、これは与えてはならず、代わりにオブジェクト自体から読み込まれる。
• type_ (Type | None)

戻り値

作成された変数、または渡された変数と同じ変数。

レイズ

CircuitError - 既存の変数をシャドウイングするために変数を作成できない場合。

戻りの型

Var

add_stretch(name_or_stretch)

この回路をスコープとする新しいストレッチを宣言する。

パラメーター

name_or_stretch (str |Stretch) – ストレッチ名の文字列、または再利用する Stretch 既存のインスタンスのいずれか。 ストレッチは、回路内で既に使用されている名前をシャドウすることはできません。

戻り値

創造されたストレッチ。 もし Stretch インスタンスが与えられた場合は、まったく同じオブジェクトが返される。

レイズ

CircuitError - 既存の識別子をシャドウイングするためにストレッチを作成できない場合。

戻りの型

ストレッチ

例

名前だけ与えられた新しいストレッチを定義し、使用する：

from qiskit.circuit import QuantumCircuit, Duration
from qiskit.circuit.classical import expr

qc = QuantumCircuit(2)
my_stretch = qc.add_stretch("my_stretch")

qc.delay(expr.add(Duration.dt(200), my_stretch), 1)

add_uninitialized_var(var, /)

イニシャライザを持たない変数を追加する。

ほとんどの場合 add_var() を使って変数を初期化する。 この関数を使うには、すでに Var というのも、この関数の使用は通常、コピーの文脈でのみ意味をなすからである。

パラメーター

var (Var) – 追加する変数。

add_capture(var: Var)

add_capture(stretch: Stretch)

スコープから取り込むべき識別子を回路に追加する。

この方法には Var または Stretch ノードが必要で、これは識別子へのハンドルを持っていることを強制する。

これは低レベルのメソッドであり、コントロール・フロー操作を手動で構築する場合にのみ真に役立つ。 with 制御フローのスコープにビルダー・インターフェースを使用している場合、このメソッドを呼び出す必要は通常ありません。 if_test() やその他のスコープ構文) を使用している場合は、このメソッドを呼び出す必要はありません。 ビルダー・インターフェイスは、スコープ内で使用されている識別子をキャプチャすることで、あなたの代わりに自動的に内部スコープをクロージャにします。

パラメーター

var (Union[expr.Var, expr.Stretch]) – スコープからキャプチャする変数またはストレッチを指定します。

レイズ

CircuitError - 既存の識別子をシャドウイングするために識別子を作成できない場合。

find_bit(bit)

ある回路を参照するために使用できる回路内の位置を見つける。 Bit.

特に、この関数は量子ビットの整数インデックスを求めることができ、これはトランスパイルド回路のハードウェアインデックスに対応する。

パラメーター

bit (Bit) – 場所を特定するビット。

戻り値

2タプル。 最初の要素(index)には、 Bit を見つけることができるインデックスが含まれます（以下のいずれか）。 qubits, clbitsのいずれか)。 番目の要素(registers)は、 (register, index) のペアのリストである。 Register を含む。 Bit と Register を含む。）

戻りの型

namedtuple (int, リスト[タプル (レジスタ, int )])

レイズ

• CircuitError - 提供された Bit が未知の型であった場合。
• CircuitError - 供給された Bit が回路上に見つからなかった。

例

回路をループし、各操作のqubitとclbitインデックスを取得する：

from qiskit.circuit import QuantumCircuit, Qubit

qc = QuantumCircuit(3, 3)
qc.h(0)
qc.cx(0, 1)
qc.cx(1, 2)
qc.measure([0, 1, 2], [0, 1, 2])

# The `.qubits` and `.clbits` fields are not integers.
assert isinstance(qc.data[0].qubits[0], Qubit)
# ... but we can use `find_bit` to retrieve them.
assert qc.find_bit(qc.data[0].qubits[0]).index == 0

simple = [
    (
        instruction.operation.name,
        [qc.find_bit(bit).index for bit in instruction.qubits],
        [qc.find_bit(bit).index for bit in instruction.clbits],
    )
    for instruction in qc.data
]

has_register(register)

この回路がレジスタrを持っているかどうかをテストする。

パラメーター

register (Register) – 量子レジスターか古典レジスターか

戻り値

レジスタがこの回路に含まれていれば真。

戻りの型

bool

assign_parameters(parameters: Mapping[Parameter, ParameterExpression | float] | Iterable[ParameterExpression | float], inplace: Literal[False] = False, *, flat_input: bool = False, strict: bool = True) → QuantumCircuit

assign_parameters(parameters: Mapping[Parameter, ParameterExpression | float] | Iterable[ParameterExpression | float], inplace: Literal[True] = False, *, flat_input: bool = False, strict: bool = True) → None

新しいパラメータや値にパラメータを割り当てる。

が辞書として渡される場合 parameters 、そのキーは現在の回路内のインスタンスである Parameter 必要があります。 辞書の値は、数値または新しいパラメータオブジェクトのいずれかになります。

がリストまたは配列として渡された場合 parameters 、その要素は、アルファベット順に並べ替えられた順序（ただし、のオブジェクト内の ParameterVector 順序は尊重される）で parameters 、現在のパラメータに割り当てられます。

値は、現在の回路オブジェクトまたはそのコピーに割り当てることができる。

パラメーター

• parameters (Mapping[Parameter, ParameterExpression |float] | Iterable[ParameterExpression |float]) – 新しいパラメータ値を指定する辞書または反復可能オブジェクト。
• inplace (bool) – Falseの場合、バインドされたパラメータを含む回路のコピーが返されます。 Trueの場合、回路インスタンス自体が変更されます。
• {parameter: value}flat_input (bool) – もし True が parameters 写像型であるならば、それは の写像であるとみなされる。 get_parameter()デフォルトでは（False）、マッピングには、対応する値のシーケンスを指すキーが含ま ParameterVector れている場合があり、これらはマッピング中に展開されます。また、文字列キーが含まれている場合は、これらは を使用して インスタンス Parameter に変換されます。
• strict (bool) – もし False、マッピングで指定されたパラメータのうち、回路で使用されないものがあれば、それらは無視されます。 （ True デフォルトの場合）、論理エラーを示すエラーが発生します。

レイズ

• CircuitError - parametersがdictで、回路に存在しないパラメータを含む場合。
• ValueError - parametersがリスト/配列で、長さが回路内のフリー・パラメーターの数と不一致の場合。

戻り値

inplace が False の場合、パラメータをバインドした回路のコピー、それ以外の場合は None。

戻りの型

QuantumCircuit | なし

例

パラメータ化された回路を作成し、パラメータをインプレースで割り当てる。

from qiskit.circuit import QuantumCircuit, Parameter

circuit = QuantumCircuit(2)
params = [Parameter('A'), Parameter('B'), Parameter('C')]
circuit.ry(params[0], 0)
circuit.crx(params[1], 0, 1)
circuit.draw('mpl')
circuit.assign_parameters({params[0]: params[2]}, inplace=True)
circuit.draw('mpl')

場違いな値をリストでバインドし、元の回路のコピーを得る。

from qiskit.circuit import QuantumCircuit, ParameterVector

circuit = QuantumCircuit(2)
params = ParameterVector('P', 2)
circuit.ry(params[0], 0)
circuit.crx(params[1], 0, 1)

bound_circuit = circuit.assign_parameters([1, 2])
bound_circuit.draw('mpl')

circuit.draw('mpl')

has_parameter(name_or_param, /)

この回路にパラメータ・オブジェクトが存在するかどうかをチェックする。

パラメーター

name_or_param (str |Parameter) – パラメータ、または確認対象のパラメータ名。 Trueこれがノード Parameter である場合、この関数がを返すためには、パラメータが指定されたものと完全に一致していなければなりません。

戻り値

この回路でマッチングパラメータが割り当て可能かどうか。

戻りの型

bool

get_parameter(name: str, default: T) → Parameter | T

get_parameter(name: str, default: builtin_types.EllipsisType = Ellipsis) → Parameter

この回路スコープでアクセス可能なコンパイル時のパラメータを名前で取得する。

パラメーター

• name (str) – 取得するパラメータの名前。
• default (Any) – 指定された場合、パラメータが存在しないときはこの値が返されます。 指定されていない場合は、 KeyError 代わりに が発生します。

戻り値

対応するパラメータ。

レイズ

KeyError - デフォルトが与えられていないが、パラメータが回路に存在しない場合。

戻りの型

パラメータ

例

回路から名前を指定してパラメータを取得する：

from qiskit.circuit import QuantumCircuit, Parameter

my_param = Parameter("my_param")

# Create a parametrized circuit.
qc = QuantumCircuit(1)
qc.rx(my_param, 0)

# We can use 'my_param' as a parameter, but let's say we've lost the Python object
# and need to retrieve it.
my_param_again = qc.get_parameter("my_param")

assert my_param == my_param_again

回路から変数を名前で取得し、それが存在しない場合はデフォルトを返す：

assert qc.get_parameter("my_param", None) == my_param
assert qc.get_parameter("unknown_param", None) is None

get_var(name: str, default: T) → Var | T

get_var(name: str, default: builtin_types.EllipsisType = Ellipsis) → Var

この回路スコープでアクセス可能な変数を名前で取得する。

パラメーター

• name (str) – 取得する変数の名前。
• default (Any) – 指定された場合、変数が存在しないときはこの値が返されます。 指定されていない場合は、 KeyError 代わりに が発生します。

戻り値

対応する変数。

レイズ

KeyError - デフォルトが与えられず、変数が存在しない場合。

例

回路から名前を指定して変数を取り出す：

from qiskit.circuit import QuantumCircuit

# Create a circuit and create a variable in it.
qc = QuantumCircuit()
my_var = qc.add_var("my_var", False)

# We can use 'my_var' as a variable, but let's say we've lost the Python object and
# need to retrieve it.
my_var_again = qc.get_var("my_var")

assert my_var == my_var_again

回路から変数を名前で取得し、それが存在しない場合はデフォルトを返す：

assert qc.get_var("my_var", None) == my_var
assert qc.get_var("unknown_variable", None) is None

get_stretch(name: str, default: T) → Stretch | T

get_stretch(name: str, default: builtin_types.EllipsisType = Ellipsis) → Stretch

この回路スコープでアクセス可能なストレッチを名前で取得する。

パラメーター

• name (str) – 取得する区間の名前。
• default (Any) – 指定された場合、変数が存在しないときはこの値が返されます。 指定されていない場合は、 KeyError 代わりに が発生します。

戻り値

対応するストレッチ。

レイズ

KeyError - デフォルトが与えられず、変数が存在しない場合。

例

回路からストレッチを名前で取り出す：

from qiskit.circuit import QuantumCircuit

# Create a circuit and create a variable in it.
qc = QuantumCircuit()
my_stretch = qc.add_stretch("my_stretch")

# We can use 'my_stretch' as a variable, but let's say we've lost the Python object and
# need to retrieve it.
my_stretch_again = qc.get_stretch("my_stretch")

assert my_stretch == my_stretch_again

回路から変数を名前で取得し、それが存在しない場合はデフォルトを返す：

assert qc.get_stretch("my_stretch", None) == my_stretch
assert qc.get_stretch("unknown_stretch", None) is None

get_identifier(name: str, default: T) → Var | Stretch | T

get_identifier(name: str, default: builtin_types.EllipsisType = Ellipsis) → Var | Stretch

この回路スコープでアクセス可能な識別子を名前で取得する。

これには現在、リアルタイムのクラシック変数とストレッチの両方が含まれている。

パラメーター

• name (str) – 取得する識別子の名前。
• default (Any) – 指定された場合、変数が存在しないときはこの値が返されます。 指定されていない場合は、 KeyError 代わりに が発生します。

戻り値

対応する変数。

レイズ

KeyError - デフォルトが与えられていないが、識別子が存在しない場合。

has_var(name_or_var, /)

変数がこのスコープでアクセス可能かどうかをチェックする。

パラメーター

name_or_var (str |Var) – 変数、または確認する変数の名前。 これが expr.Var ノードである場合、この関数がを返すためには True、変数が与えられたものと完全に一致していなければならない。

戻り値

マッチする変数にアクセスできるかどうか。

戻りの型

bool

has_stretch(name_or_stretch, /)

ストレッチがこのスコープでアクセス可能かどうかをチェックする。

パラメーター

name_or_stretch (str |Stretch) – ストレッチ、または確認すべきストレッチの名前 これが expr.Stretch ノードである場合、この関数がを返すためには True、伸長が与えられたものと正確に一致しなければならない。

戻り値

マッチするストレッチにアクセスできるかどうか。

戻りの型

bool

has_identifier(name_or_ident, /)

識別子がこのスコープでアクセス可能かどうかを調べる。

パラメーター

name_or_ident (str |Var |Stretch) – インスタンス、または確認する識別子の名前。 これが または expr.Stretch expr.Var ノードである場合、一致したインスタンスは指定されたものと完全に一致しなければ、この関数は を返す True。

戻り値

マッチする識別子がアクセス可能かどうか。

戻りの型

bool

iter_vars()

この回路のスコープ内にあるすべてのリアルタイム・クラシック変数の反復可能値を取得する。

このメソッドは、スコープ内のすべての変数を繰り返し処理する。 より細かいイテレータについては iter_declared_vars(), iter_input_vars() および iter_captured_vars().

戻りの型

イテラブル[* ヴァール］*

iter_stretches()

この回路内のすべてのストレッチを反復可能な形で取得する。

このメソッドは、スコープ内のすべてのストレッチを繰り返し処理する。 より細かいイテレータについては iter_declared_stretches() と iter_captured_stretches().

戻りの型

イテラブル[* ストレッチ］*

iter_input_vars()

この回路スコープの入力として宣言されているすべてのリアルタイム・クラシック変数を反復可能な形で取得する。 これは、ローカルで宣言された変数 ( iter_declared_vars()参照)とキャプチャされた変数( iter_captured_vars()).

戻りの型

イテラブル[* ヴァール］*

iter_captured_vars()

含むスコープから、この回路スコープでキャプチャされているすべてのリアルタイム古典変数を反復可能な形で取得します。 これは入力変数 ( iter_input_vars()参照)とローカルで宣言された変数( iter_declared_vars()).

戻りの型

イテラブル[* ヴァール］*

iter_captured_stretches()

この回路スコープでキャプチャされたストレッチを含むスコープから反復可能な形で取得します。 これは、ローカルで宣言されたストレッチを除く( iter_declared_stretches()).

戻りの型

イテラブル[* ストレッチ］*

iter_declared_vars()

このスコープで自動保存期間が宣言されているすべてのリアルタイム古典変数を反復可能な形で取得します。 これは入力変数( iter_input_vars()参照）とキャプチャされた変数 iter_captured_vars()).

戻りの型

イテラブル[* ヴァール］*

iter_declared_stretches()

このスコープで宣言されているすべてのストレッチを反復可能形式で取得します。 これは、キャプチャされたストレッチを除く( iter_captured_stretches()).

戻りの型

イテラブル[* ストレッチ］*

append(instruction, qargs=None, cargs=None, *, copy=True)

回路の末尾に1つ以上の命令を追加し、その場で回路を変更する。

Instructionおよび cargs は qargs 、指定された の規則に従って展開・展開され、非Bit 指定子（整数インデックスなど）は、それぞれ該当するインスタンスに解決されます。

a CircuitInstruction が指定された場合、それはアンラップされ、この回路のコンテキスト内で検証された後、新しいオブジェクトが回路に追加されます。 この場合、 や cargs を個別に渡す qargs ことはできません。

パラメーター

• instruction (Operation |CircuitInstruction) –Instruction 追加するインスタンス、またはそのコンテキスト全体を含むもの CircuitInstruction 。 を実装 to_instruction するオブジェクトもサポートされていますが、変換のオーバーヘッドを回避できるため、一般的には を Instruction 直接渡す方が推奨されます。
• qargs (Sequence[Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]] | None) – 命令を適用する対象の指定 Qubit子。
• cargs (Sequence[Clbit |ClassicalRegister |int |slice |Sequence[Clbit |int]] | None) – 命令を適用する対象の指定 Clbit子。
• copy (bool) – もし True （デフォルト）なら、入力された instruction がシンボリック・パラメータを含んでいる場合、回路に追加する前にコピーされるため、同じ命令が含まれるかもしれない他の回路に影響を与えることなく、安全に変異させることができる。 この命令が他の回路で使われることがないと確信できる場合は、 False 、わずかなスピードアップを図ることができる。

戻り値

CircuitInstruction実際に回路に追加されたSへのハンドル。

戻りの型

qiskit.circuit.InstructionSet

レイズ

InstructionCircuitError – 渡された操作が のインスタンスでない場合、またはその操作に対して を呼び出 to_instruction しても に変換できない場合。

_append(instruction: CircuitInstruction, *, _standard_gate: bool) → CircuitInstruction

_append(instruction: Operation, qargs: Sequence[Qubit], cargs: Sequence[Clbit]) → Operation

回路の末尾に命令を追加し、その場で回路を変更する。

パラメーター

• インストラクション

  追加する操作とそのコンテキストに関する、完全かつ形式的に CircuitInstruction 正しい記述。

  Operation後方互換性の形式では、これは単なる となる場合があり、その場合は qargs と cargs を明示的に指定する必要があります。

• qargs – ベア Operation を接続するための、量子ビット用のレガシー引数。 最初の引数が優先 CircuitInstruction 形式の場合、この引数は無視されます。

• cargs – clbits に対して、 Operation ベアをアタッチするためのレガシー引数。 最初の引数が優先 CircuitInstruction 形式の場合、この引数は無視されます。

• _standard_gate (bool)

戻り値

追加された命令へのハンドル。

戻りの型

CircuitInstruction

compose(other: QuantumCircuit | Instruction, qubits: Qubit | QuantumRegister | int | slice | Sequence[Qubit | int] | Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]] | None = None, clbits: Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int] | Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]] | None = None, front: bool = False, inplace: Literal[True] = True, wrap: bool = False, *, copy: bool = True, var_remap: Mapping[str | Var | Stretch, str | Var | Stretch] | None = None, inline_captures: bool = False) → None

compose(other: QuantumCircuit | Instruction, qubits: Qubit | QuantumRegister | int | slice | Sequence[Qubit | int] | Sequence[Qubit | QuantumRegister | int | slice | Sequence[Qubit | int]] | None = None, clbits: Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int] | Sequence[Clbit | ClassicalRegister | int | slice | Sequence[Clbit | int]] | None = None, front: bool = False, inplace: Literal[False] = False, wrap: bool = False, *, copy: bool = True, var_remap: Mapping[str | Var | Stretch, str | Var | Stretch] | None = None, inline_captures: bool = False) → QuantumCircuit

ある回路からの命令を、別の回路の指定された量子ビットや量子ビットに適用する。

リアルタイム変数 (expr.Var と expr.Stretch インスタンス) を扱う場合、次の 2 つの主要な戦略があります。 compose():

1. other 回路は、その変数も含めて完全に加法的なものとして扱われる。 other の変数は、 self の変数とは完全に区別する必要があります（ var_remap を使用すると便利です）。 other の変数はすべて、 other の変数と入力/キャプチャ/ローカル・スコープが一致するように、出力で新たに宣言されます。 これは一般的に、関係のない2つの回路を接続する場合に必要なものです。
2. other 回路は、 self の正確な拡張として作成され、 self の最後にある状態の既存の変数に作用することも含めて、 にインライン化された。 この場合、インライン化するこれらの変数をすべて "captures "として宣言した other を作成し、このメソッドで inline_captures=True を使ってリンクする。 これは一般的に、その場でレイヤーを定義して回路を構築する場合や、自分自身から取り出したレイヤーを使って回路を再構築する場合に求められるものだ。 の引数 vars_mode="captures" は、各レイヤーのベースを作成するのに便利だ。 copy_empty_like() への引数が役に立つかもしれない。

パラメーター

• other (qiskit.circuit.Instruction orQuantumCircuit) – （サブ）回路、または自身に合成するための命令。 QuantumCircuita でない場合、これは が受け入れるもの append なら何でも構いません。

• qubits (list[Qubit|int]) – 自己を構成する量子ビット。

• clbits (list[Clbit|int]) – 自己の断片を合成する。

• front (bool) – True の場合、フロントコンポジションが行われる。 これは、コントロール・フロー・ビルダー・コンテキスト・マネージャー内では不可能である。

• inplace (bool) – True の場合、オブジェクトを修正する。 そうでなければ、構成された回路を返す。

• copy (bool) – もし True （デフォルト）なら、入力は共有されたものとして扱われ、将来変更される可能性がある場合、含まれている命令はコピーされる。 不必要なコピーを避けるため、入力をベース回路が所有しているとみなす場合は、これを False 。この場合、 other を後で使用するのは無効であり、一部の命令がその場で変異している可能性がある。

• var_remap (Mapping) –

  を書き換えるために使用するマッピング expr.Var と expr.Stretchother selfノードを書き換えるために使用するマッピングである。 これは名前の衝突を避けるために使うことができる。

  キーも値も、文字列または直接識別子のインスタンスとして与えることができる。 キーが文字列の場合、任意の Var または Stretch にマッチします。 値が文字列の場合、新しいキーがそれにマッチするたびに、新しい Var または Stretch が生成される。 値が Varである場合、その type は、置き換えられる変数のそれと正確に一致しなければならない。

• inline_captures (bool) –

  もし True の場合、 other のすべての「キャプチャされた」識別子ノードは、 ですでに宣言されている識別子を参照するものとみなされる。 QuantumCircuit のすべての "キャプチャされた "識別子ノードは、 self （入力/キャプチャ/ローカル型のいずれかとして）ですでに宣言されている識別子を指すと仮定され、 other の使用法は既存の識別子に適用される。 で使用する既存の回路のレイヤーを構築したい場合は、 の引数を使用するとよい。 compose()で使用するために既存の回路のレイヤーを構築したい場合、 vars_mode="captures" の引数が役に立つかもしれない。 copy_empty_like() を使うと便利だ。 vars_remap のリマッピングは、このインライン化された変数を評価する前に行われる。

  これが False （デフォルト）の場合、 other の識別子はすべて、 self の識別子と区別される必要があり、それらのために新しい宣言が行われる。

• wrap (bool) – もしTrueなら、selfに合成する前に、もう1つの回路をゲート（または命令（それがユニタリ命令だけを含むかどうかによる）にラップする。 このオプションを使うよりも、ほとんどの場合、手動で to_instruction() または to_gate()または append().

戻り値

構成された回路（inplace==True の場合は None を返す）。

戻りの型

QuantumCircuit

レイズ

• CircuitError - other の幅が self よりも広い場合など、2つの回路間で正しいワイヤーマッピングができない場合。
• CircuitError - self 、部分的に構築されたコントロールフローコンテキストがアクティブな状態で、新しい回路を生成しようとする場合、例えばコンテキストマネージャのフォームである if_test(), for_loop() および while_loop().
• CircuitError - この動作に明確な意味はない。

例

>>> lhs.compose(rhs, qubits=[3, 2], inplace=True)

            ┌───┐                   ┌─────┐                ┌───┐
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 ═══════════════════════

tensor(other, inplace=False)

Tensor self with other.

リトルエンディアンの慣習では、左端の演算が回路の一番下に来ることを覚えておいてほしい。 詳細はドキュメントも参照のこと。

     ┌────────┐        ┌─────┐          ┌─────┐
q_0: ┤ bottom ├ ⊗ q_0: ┤ top ├  = q_0: ─┤ top ├──
     └────────┘        └─────┘         ┌┴─────┴─┐
                                  q_1: ┤ bottom ├
                                       └────────┘

パラメーター

• other (QuantumCircuit) – この回路をテンソルするもう1つの回路。
• inplace (bool) – True の場合、オブジェクトを修正する。 そうでなければ、構成された回路を返す。

戻りの型

QuantumCircuit | なし

例

from qiskit import QuantumCircuit
top = QuantumCircuit(1)
top.x(0);
bottom = QuantumCircuit(2)
bottom.cry(0.2, 0, 1);
tensored = bottom.tensor(top)
tensored.draw('mpl')

戻り値

テンサード回路（ inplace=True の場合は None を返す）。

戻りの型

QuantumCircuit

パラメーター

• other (QuantumCircuit)
• inplace (bool)

barrier(*qargs, label=None)

Barrier を適用する。 qargs が空の場合、回路内のすべての量子ビットに適用される。

パラメーター

• qargs (QubitSpecifier) – 1つ以上の量子ビット引数の指定。
• label (str) – バリアの文字列ラベル。

戻り値

を追加した。

戻りの型

qiskit.circuit.InstructionSet

ccx(control_qubit1, control_qubit2, target_qubit, ctrl_state=None)

CCXGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit1 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 最初の制御として使用される量子ビット。
• control_qubit2 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 第2の制御として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

ccz(control_qubit1, control_qubit2, target_qubit, label=None, ctrl_state=None)

CCZGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit1 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 最初の制御として使用される量子ビット。
• control_qubit2 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 第2の制御として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'10'）で表す。 デフォルトは「11」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

ch(control_qubit, target_qubit, label=None, ctrl_state=None)

CHGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cp(theta, control_qubit, target_qubit, label=None, ctrl_state=None)

CPhaseGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• theta (ParameterExpression |float) – 回転の角度。
• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

crx(theta, control_qubit, target_qubit, label=None, ctrl_state=None)

CRXGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• theta (ParameterExpression |float) – 回転の角度。
• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cry(theta, control_qubit, target_qubit, label=None, ctrl_state=None)

CRYGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• theta (ParameterExpression |float) – 回転の角度。
• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

crz(theta, control_qubit, target_qubit, label=None, ctrl_state=None)

CRZGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• theta (ParameterExpression |float) – 回転の角度。
• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cs(control_qubit, target_qubit, label=None, ctrl_state=None)

CSGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

csdg(control_qubit, target_qubit, label=None, ctrl_state=None)

CSdgGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cswap(control_qubit, target_qubit1, target_qubit2, label=None, ctrl_state=None)

CSwapGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit1 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• target_qubit2 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列で表す（例： '1' ）。 デフォルトは '1' 。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

csx(control_qubit, target_qubit, label=None, ctrl_state=None)

CSXGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cu(theta, phi, lam, gamma, control_qubit, target_qubit, label=None, ctrl_state=None)

CUGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• theta (ParameterExpression |float) – ゲートの $\theta$ 回転角度。
• phi (ParameterExpression |float) – ゲートの $\phi$ 回転角度。
• lam (ParameterExpression |float) – ゲートの $\lambda$ 回転角度。
• gamma (ParameterExpression |float) – Uゲートに印加される場合、そのグローバル位相。
• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cx(control_qubit, target_qubit, label=None, ctrl_state=None)

CXGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 制御用として使用される量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cy(control_qubit, target_qubit, label=None, ctrl_state=None)

CYGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 対照群として使用された量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

cz(control_qubit, target_qubit, label=None, ctrl_state=None)

CZGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• control_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – 対照群として使用された量子ビット。
• target_qubit (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートが作用する量子ビット。
• label (str | None) – 回路内のゲートの文字列ラベル。
• ctrl_state (str |int | None) – 制御状態を10進数、またはビット列（例：'1'）で表す。 デフォルトは「1」の状態で制御する。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

dcx(qubit1, qubit2)

DCXGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• qubit1 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートを適用する量子ビット。
• qubit2 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートを適用する量子ビット。

戻り値

作成されたインストラクションへのハンドル。

戻りの型

InstructionSet

delay(duration, qarg=None, unit=None)

適用する Delay. qarg が None の場合、すべての量子ビットに適用される。 複数の量子ビットに適用する場合、同じ持続時間のディレイが作成される。

パラメーター

• duration (Object) – 遅延時間 これが Exprの定数式でなければならない。 Duration.
• qarg (Object) – qubit引数でこの遅延を適用する。
• unit (str | None) – ただし、 duration が Expr の場合は指定してはならない。 対応ユニット： 's' 'ms'、 'us'、 'ns'、 'ps'、 'dt'。 デフォルトは 'dt'、つまりターゲットとなるバックエンドに応じた整数の時間単位である。

戻り値

を追加した。

戻りの型

qiskit.circuit.InstructionSet

レイズ

CircuitError - 引数の書式が悪い場合。

ecr(qubit1, qubit2)

ECRGate応募する。

このゲートの完全なマトリックス形式については、基礎となるゲートのドキュメントを参照のこと。

パラメーター

• qubit1 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートを適用する最初の量子ビット。
• qubit2 (Qubit |QuantumRegister |int |slice |Sequence[Qubit |int]) – ゲートを適用する2番目の量子ビット。

戻り値