NLocal

class qiskit.circuit.library.NLocal(num_qubits=None, rotation_blocks=None, entanglement_blocks=None, entanglement=None, reps=1, insert_barriers=False, parameter_prefix='θ', overwrite_block_parameters=True, skip_final_rotation_layer=False, skip_unentangled_qubits=False, initial_state=None, name='nlocal', flatten=None)

베이스: BlueprintCircuit

N-로컬 서킷 클래스입니다.

N-로컬 회로의 구조는 회전과 얽힘 층을 번갈아 가며 구성합니다. 두 계층 모두에서 매개변수화된 회로 블록은 정의된 방식으로 회로에 작용합니다. 회전 레이어에서는 블록이 서로 겹쳐서 적용되고, 얽힘 레이어에서는 entanglement 전략에 따라 블록이 겹쳐서 적용됩니다. 회로 블록은 임의의 크기(회로의 큐비트 수만큼 작음)를 가질 수 있습니다. 각 레이어는 reps 번 반복되며 기본적으로 최종 회전 레이어가 추가됩니다.

예를 들어, 2 큐비트의 회전 블록과 'linear' 얽힘을 사용하는 4 큐비트의 얽힘 블록은 다음과 같은 회로를 생성합니다.

┌──────┐ ░ ┌──────┐                      ░ ┌──────┐
┤0     ├─░─┤0     ├──────────────── ... ─░─┤0     ├
│  Rot │ ░ │      │┌──────┐              ░ │  Rot │
┤1     ├─░─┤1     ├┤0     ├──────── ... ─░─┤1     ├
├──────┤ ░ │  Ent ││      │┌──────┐      ░ ├──────┤
┤0     ├─░─┤2     ├┤1     ├┤0     ├ ... ─░─┤0     ├
│  Rot │ ░ │      ││  Ent ││      │      ░ │  Rot │
┤1     ├─░─┤3     ├┤2     ├┤1     ├ ... ─░─┤1     ├
├──────┤ ░ └──────┘│      ││  Ent │      ░ ├──────┤
┤0     ├─░─────────┤3     ├┤2     ├ ... ─░─┤0     ├
│  Rot │ ░         └──────┘│      │      ░ │  Rot │
┤1     ├─░─────────────────┤3     ├ ... ─░─┤1     ├
└──────┘ ░                 └──────┘      ░ └──────┘

|                                 |
+---------------------------------+
       repeated reps times

지정한 경우 모든 블록 사이에 배리어를 삽입할 수 있습니다. 초기 상태 객체가 제공되면 NLocal 앞에 추가됩니다.

매개변수

• num_qubits (int | None) – 회로의 큐비트 수입니다.
• rotation_blocks (QuantumCircuit |list[QuantumCircuit] | qiskit.circuit.Instruction |list[qiskit.circuit.Instruction] | None) – 회전 레이어에 사용되는 블록들. 여러 개가 전달된 경우, 이들은 차례대로 적용됩니다(새로운 하위 레이어처럼).
• entanglement_blocks (QuantumCircuit |list[QuantumCircuit] | qiskit.circuit.Instruction |list[qiskit.circuit.Instruction] | None) – 얽힘 계층에 사용되는 블록들. 여러 개가 전달된 경우, 이들은 차례대로 적용됩니다. get_entangler_map()하위 레이어에 서로 다른 얽힘을 사용하려면 다음을 참조하십시오.
• entanglement (list[int] | list[list[int]] | None) – 입력 블록이 작동하는 큐비트를 지정하는 인덱스입니다. None 인 경우 얽힘 블록이 회로의 상단에 적용됩니다.
• reps (int) – 회전 블록과 얽힘 블록을 반복하는 빈도를 지정합니다.
• insert_barriers (bool) – True 인 경우 각 레이어 사이에 장벽이 삽입됩니다. False 인 경우 장벽이 삽입되지 않습니다.
• parameter_prefix (str) – 기본 매개변수가 생성되는 경우 사용되는 접두사입니다.
• overwrite_block_parameters (bool |list[list[Parameter]]) – 추가된 블록의 매개변수를 덮어써야 하는 경우. False 인 경우 블록의 매개변수는 변경되지 않습니다.
• skip_final_rotation_layer (bool) – 회로에 최종 회전 레이어를 추가할지 여부입니다.
• skip_unentangled_qubits (bool) – True 이면 회전 게이트는 얽혀 있는 큐비트에만 작동합니다. False 이면 회전 게이트가 모든 큐비트에 작용합니다.
• initial_state (QuantumCircuit | None) – NLocal 회로 앞에 추가되는 초기 상태를 설명하는 데 사용할 수 있는 객체입니다 QuantumCircuit .
• name (str) – 회로의 이름.
• flatten (bool | None) – 여러 개의 게이트 오브젝트 레이어 안에 중첩하는 대신 평면 회로를 출력하려면 True 로 설정합니다. 현재 기본적으로 출력 회로의 내용은 보다 깔끔한 시각화를 위해 중첩된 객체로 래핑됩니다. 그러나 시각화 이외의 다른 용도로 이 회로를 사용하는 경우 매개변수 바인딩으로 인한 성능 오버헤드가 크지 않도록 이 플래그를 True 로 설정하는 것이 좋습니다.

레이즈

• ValueError - reps 매개변수가 0보다 작거나 같을 경우.
• TypeError - reps 매개변수가 int 값이 아닌 경우.

속성

entanglement

entanglement_blocks

flatten

initial_state

insert_barriers

num_layers

num_parameters_settable

num_qubits

ordered_parameters

>>> # prepare circuit ...
>>> print(nlocal)
     ┌───────┐┌──────────┐┌──────────┐┌──────────┐
q_0: ┤ Ry(1) ├┤ Ry(θ[1]) ├┤ Ry(θ[1]) ├┤ Ry(θ[3]) ├
     └───────┘└──────────┘└──────────┘└──────────┘
>>> nlocal.parameters
{Parameter(θ[1]), Parameter(θ[3])}
>>> nlocal.ordered_parameters
[1, Parameter(θ[1]), Parameter(θ[1]), Parameter(θ[3])]

parameter_bounds

preferred_init_points

reps

rotation_blocks

name

from qiskit import QuantumCircuit

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

my_circuit

메소드

add_layer

assign_parameters

get_entangler_map

get_unentangled_qubits

print_settings