트랜스파일 기본값 및 구성 옵션

패키지 버전

이 페이지의 코드는 다음 요구 사항을 사용하여 개발되었습니다. 아래 버전 이상을 사용하길 권장합니다.

qiskit[all]~=2.5.2
qiskit-ibm-runtime~=0.47.0

추상 Circuit은 QPU가 제한된 기저 게이트(basis gate) 집합만 지원하며 임의의 연산을 실행할 수 없기 때문에 트랜스파일이 필요합니다. Transpiler의 역할은 임의의 Circuit을 지정된 QPU에서 실행할 수 있도록 변환하는 것입니다. 이는 Circuit을 지원되는 기저 Gate로 변환하고, Circuit의 연결성이 QPU의 연결성과 일치하도록 필요에 따라 SWAP Gate를 도입함으로써 이루어집니다.

패스 매니저로 트랜스파일하기에서 설명한 바와 같이, generate_preset_pass_manager 함수를 사용하여 패스 매니저를 생성하고, Circuit 또는 Circuit 목록을 해당 run 메서드에 전달하여 트랜스파일할 수 있습니다. generate_preset_pass_manager를 호출할 때 최적화 수준과 Backend만 전달하여 나머지 옵션에 대한 기본값을 사용하거나, 트랜스파일을 세밀하게 조정하기 위해 함수에 추가 인수를 전달할 수도 있습니다.

매개변수 없이 기본 사용

이 예시에서는 추가 매개변수를 지정하지 않고 Circuit과 대상 QPU를 Transpiler에 전달합니다.

Circuit을 생성하고 결과를 확인합니다:

# Added by doQumentation — required packages for this notebook
!pip install -q qiskit qiskit-ibm-runtime

from qiskit import QuantumCircuit
from qiskit.circuit.library import grover_operator, DiagonalGate
from qiskit_ibm_runtime.fake_provider import FakeSherbrooke

# Create circuit to test transpiler on
oracle = DiagonalGate([1] * 7 + [-1])
qc = QuantumCircuit(3)
qc.h([0, 1, 2])
qc = qc.compose(grover_operator(oracle))

# Add measurements to the circuit
qc.measure_all()

# View the circuit
qc.draw(output="mpl")

Circuit을 트랜스파일하고 결과를 확인합니다:

from qiskit.transpiler import generate_preset_pass_manager

# Specify the QPU to target
backend = FakeSherbrooke()

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

# View the transpiled circuit
transpiled_circ.draw(output="mpl", idle_wires=False)

사용 가능한 모든 매개변수

다음은 generate_preset_pass_manager 함수에서 사용할 수 있는 모든 매개변수입니다. 인수는 두 부류로 나뉩니다: 컴파일 대상을 설명하는 것과 Transpiler의 동작 방식에 영향을 미치는 것입니다.

optimization_level을 제외한 모든 매개변수는 선택 사항입니다. 전체 세부 정보는 Transpiler API 문서를 참조하세요.

• optimization_level (int) - Circuit에 대해 수행할 최적화의 정도입니다. 0에서 3 사이의 정수입니다. 수준이 높을수록 더 최적화된 Circuit이 생성되지만, 트랜스파일 시간이 더 오래 걸립니다. 자세한 내용은 Transpiler 최적화 수준 설정을 참조하세요.

컴파일 대상을 설명하는 데 사용되는 매개변수

이 인수들은 Circuit 실행을 위한 대상 QPU를 설명하며, QPU의 커플링 맵(Qubit의 연결성을 설명하는 정보), QPU에서 지원하는 기저 Gate, Gate의 오류율 등의 정보를 포함합니다.

이러한 매개변수 중 다수는 트랜스파일에 일반적으로 사용되는 매개변수에서 자세히 설명되어 있습니다.

QPU (`Backend`) 매개변수

Backend 매개변수 - backend를 지정하면 target이나 다른 Backend 옵션을 지정할 필요가 없습니다. 마찬가지로 target을 지정하면 backend나 다른 Backend 옵션을 지정할 필요가 없습니다.

• backend(Backend) - 이 설정이 지정되면 트랜스파일러는 입력 Circuit을 이 디바이스에 맞게 컴파일합니다. coupling_map과 같이 이러한 설정에 영향을 주는 다른 옵션이 설정되면, backend의 설정을 덮어씁니다.
• target(Target) - Backend 트랜스파일러 타겟입니다. 일반적으로 이는 backend 인수의 일부로 지정되지만, Target 객체를 수동으로 구성한 경우 여기에서 지정할 수 있습니다. 이는 backend의 타겟을 덮어씁니다.
• backend_properties(BackendProperties) - QPU가 반환하는 속성으로, Gate 오류, 판독 오류, Qubit 결맞음 시간 등에 대한 정보를 포함합니다. backend.properties()를 실행하여 이 정보를 제공하는 QPU를 찾으세요.
• timing_constraints(Dict[str, int] | None) - 명령 시간 해상도에 대한 선택적 제어 하드웨어 제한입니다. 이 정보는 QPU 구성에 의해 제공됩니다. QPU에 명령 시간 할당에 대한 제한이 없는 경우, timing_constraints는 None이며 조정이 수행되지 않습니다. QPU는 다음과 같은 제한 사항을 보고할 수 있습니다:
  • granularity: dt 단위의 최소 펄스 Gate 해상도를 나타내는 정수 값입니다. 사용자 정의 펄스 Gate의 기간은 이 세분성 값의 배수여야 합니다.
  • min_length: dt 단위의 최소 펄스 Gate 길이를 나타내는 정수 값입니다. 사용자 정의 펄스 Gate는 이 길이보다 길어야 합니다.
  • pulse_alignment: Gate 명령 시작 시간의 시간 해상도를 나타내는 정수 값입니다. Gate 명령은 이 값의 배수인 시간에 시작해야 합니다.
  • acquire_alignment: 측정 명령 시작 시간의 시간 해상도를 나타내는 정수 값입니다. 측정 명령은 이 값의 배수인 시간에 시작해야 합니다.

레이아웃 및 토폴로지 매개변수

• basis_gates (List[str] | None) - 언롤(unroll)할 기저 Gate 이름 목록입니다. 예를 들어 ['u1', 'u2', 'u3', 'cx']. None이면 언롤하지 않습니다.

• coupling_map (CouplingMap | List[List[int]]) - 매핑에서 대상으로 사용할 방향성 커플링 맵(사용자 정의 가능)입니다. 커플링 맵이 대칭인 경우 양방향을 모두 지정해야 합니다. 다음 형식이 지원됩니다:

  • CouplingMap 인스턴스

  • List - 인접 행렬로 제공해야 하며, 각 항목은 QPU에서 지원하는 모든 방향성 2-Qubit 상호작용을 지정합니다. 예: [[0, 1], [0, 3], [1, 2], [1, 5], [2, 5], [4, 1], [5, 3]]

• inst_map(List[InstructionScheduleMap] | None) - Circuit 연산을 펄스 스케줄에 매핑합니다. None인 경우 QPU의 instruction_schedule_map이 사용됩니다.

Transpiler 동작 방식에 영향을 미치는 매개변수

이 매개변수들은 특정 트랜스파일 단계에 영향을 미칩니다. 일부는 여러 단계에 영향을 미칠 수 있지만, 간결성을 위해 하나의 단계에만 나열했습니다. 사용하려는 Qubit을 지정하는 initial_layout처럼 인수를 직접 지정하면, 그 값은 이를 변경할 수 있는 모든 패스보다 우선합니다. 즉, Transpiler는 수동으로 지정한 것을 변경하지 않습니다. 특정 단계에 대한 자세한 내용은 Transpiler 단계를 참조하세요.

초기화 단계

• hls_config (HLSConfig) - HighLevelSynthesis 변환 패스에 직접 전달되는 선택적 구성 클래스 HLSConfig입니다. 이 구성 클래스를 통해 다양한 고수준 객체에 대한 합성 알고리즘 목록 및 해당 매개변수를 지정할 수 있습니다.

• init_method (str) - 초기화 단계에 사용할 플러그인 이름입니다. 기본적으로 외부 플러그인은 사용되지 않습니다. 스테이지 이름 인수에 init를 사용하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다.

• unitary_synthesis_method (str) - 사용할 유니터리 합성 방법의 이름입니다. 기본적으로 default가 사용됩니다. unitary_synthesis_plugin_names()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다.

• unitary_synthesis_plugin_config(dict) - 유니터리 합성 플러그인에 직접 전달되는 선택적 구성 딕셔너리입니다. 기본 유니터리 합성 방법은 사용자 정의 구성을 받지 않으므로 기본적으로 이 설정은 효과가 없습니다. 사용자 정의 구성을 적용하는 것은 unitary_synthesis 인수로 유니터리 합성 플러그인이 지정된 경우에만 필요합니다. 이는 각 유니터리 합성 플러그인마다 사용자 정의되므로, 이 옵션을 사용하는 방법에 대해서는 플러그인의 문서를 참조하세요.

레이아웃 단계

• initial_layout (Layout | Dict | List) - 물리적 Qubit에 대한 가상 Qubit의 초기 위치입니다. 이 레이아웃으로 Circuit이 coupling_map 제약 조건과 호환되면 사용됩니다. Transpiler가 스왑이나 다른 방법으로 Qubit을 재배열할 수 있으므로 최종 레이아웃이 동일하다는 보장은 없습니다. 전체 세부 정보는 초기 레이아웃 섹션을 참조하세요.

• layout_method(str) - 레이아웃 선택 패스의 이름입니다(default, dense, sabre, trivial). 이는 레이아웃 단계에 사용할 외부 플러그인 이름일 수도 있습니다. stage_name 인수에 layout을 지정하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다. 기본값은 sabre입니다.

라우팅 단계

• routing_method(str) - 라우팅 패스의 이름입니다(basic, lookahead, default, sabre, none). 이는 라우팅 단계에 사용할 외부 플러그인 이름일 수도 있습니다. stage_name 인수에 routing을 지정하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다. 기본값은 sabre입니다.

변환 단계

• translation_method(str) - 변환 패스의 이름입니다(default, synthesis, translator, ibm_backend, ibm_dynamic_circuits, ibm_fractional). 이는 변환 단계에 사용할 외부 플러그인 이름일 수도 있습니다. stage_name 인수에 translation을 지정하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다. 기본값은 translator입니다.

최적화 단계

• approximation_degree(float, 0-1 범위 | None) - Circuit 근사에 사용되는 휴리스틱 다이얼입니다(1.0 = 근사 없음, 0.0 = 최대 근사). 기본값은 1.0입니다. None을 지정하면 근사 정도가 보고된 오류율로 설정됩니다. 자세한 내용은 근사 정도 섹션을 참조하세요.

• optimization_method(str) - 최적화 단계에 사용할 플러그인 이름입니다. 기본적으로 외부 플러그인은 사용되지 않습니다. stage_name 인수에 optimization을 지정하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다.

스케줄링 단계

• scheduling_method(str) - 스케줄링 패스의 이름입니다. 이는 스케줄링 단계에 사용할 외부 플러그인 이름일 수도 있습니다. stage_name 인수에 scheduling을 지정하여 list_stage_plugins()를 실행하면 설치된 플러그인 목록을 볼 수 있습니다.

  • 'as_soon_as_possible': Qubit 리소스에서 가능한 한 빨리 명령을 탐욕적으로 스케줄링합니다(별칭: asap).

  • 'as_late_as_possible': 가능한 경우 Qubit을 바닥 상태로 유지하면서 명령을 늦게 스케줄링합니다(별칭: alap). 이것이 기본값입니다.

트랜스파일러 실행

• seed_transpiler(int) - 트랜스파일러의 확률적 부분에 대한 랜덤 시드를 설정합니다.

위의 매개변수를 지정하지 않으면 다음 기본값이 사용됩니다. 자세한 내용은 메서드의 API 참조 페이지를 참조하세요:

generate_preset_pass_manager(
    optimization_level=1,
    backend=None,
    target=None,
    basis_gates=None,
    coupling_map=None,
    initial_layout=None,
    layout_method=None,
    routing_method=None,
    translation_method=None,
    scheduling_method=None,
    approximation_degree=1.0,
    seed_transpiler=None,
    unitary_synthesis_method="default",
    unitary_synthesis_plugin_config=None,
    hls_config=None,
    init_method=None,
    optimization_method=None,
)

<qiskit.transpiler.passmanager.StagedPassManager at 0x7fa51ff33590>

다음 단계

권장 사항

• 최적화 수준 설정 방법을 알아보세요.
• 일반적으로 사용되는 매개변수를 더 검토하세요.
• 최적화 수준 설정 방법을 알아보세요.
• 패스 매니저로 트랜스파일하기 주제를 방문하세요.
• 예시는 양자 컴퓨터 표현을 참조하세요.
• Qiskit 패턴 워크플로의 일부로 Circuit 트랜스파일 방법을 알아보세요.
• Transpile API 문서를 검토하세요.