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)])

数値ソートを尊重するには 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() の出力に設定され、転置によって入力回路に生じた順列に関する情報を保持する。

によって引き起こされる順列には2種類あります。 transpile() 関数によって引き起こされる順列には2種類あります。 Targetで選択された物理量子ビットに基づいて量子ビットを並べ替える初期レイアウトと SwapGateによって引き起こされる出力順列です。

例

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 がリストまたは配列として渡された場合、その要素は、アルファベット順に並べられた parameters の順序で現在のパラメータに割り当てられる。 ParameterVector オブジェクトの順序を尊重する)。

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

パラメーター

• parameters (Mapping[Parameter, ParameterExpression |float] | Iterable[ParameterExpression |float]) – 新しいパラメータ値を指定する辞書または反復可能オブジェクト。
• inplace (bool) – Falseの場合、バインドされたパラメータを含む回路のコピーが返されます。 Trueの場合、回路インスタンス自体が変更されます。
• flat_input (bool) – もし True が parameters 写像型であるならば、それは の写像 {parameter: value}であるとみなされる。 デフォルトでは（False）、マッピングには、対応する値のシーケンスを指すキー ParameterVector が含まれている場合があり、これらはマッピング処理中に展開されます。また、文字列キーが含まれている場合は、convertTo を使用してインスタンス Parameterget_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) – パラメータ、またはチェックするパラメータ名。 これが Parameter ノードである場合、この関数が True を返すためには、パラメータは指定されたものとまったく同じでなければならない。

戻り値

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

戻りの型

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つ以上の命令を追加し、その場で回路を変更する。

qargs と cargs は、所定のルールに従って展開され、放送される。 Instructionの規則に従って展開され放送される。Bit 非指定子（整数インデックスなど）は、関連するインスタンスに解決される。

もし CircuitInstruction が与えられると、それがアンラップされ、この回路のコンテキストで検証され、新しいオブジェクトが回路に追加される。 この場合、 qargs 、 cargs 。

パラメーター

• instruction (Operation |CircuitInstruction) –Instruction インスタンスを追加するか CircuitInstruction を追加する。
• 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実際に回路に追加された

戻りの型

qiskit.circuit.InstructionSet

レイズ

CircuitError - のインスタンスでない場合は 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) – (サブ)回路、または自己に合成するための指示。 でない場合は QuantumCircuitでない場合は 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]) – ゲートを適用する量子ビット。

戻り値

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

戻りの型

InstructionSet