Quantum Elements Orbit API 참조

유형: Iterable[SamplerPubLike] or Iterable[EstimatorPubLike]

선택한 기본 요소와 일치하는 하나 이상의 PUB.

• 필수: Yes
• 유효한 입력 유형: Sampler PUB 와 유사한 객체의 반복 가능 객체 또는 Estimator PUB 와 유사한 객체의 반복 가능 객체

각 PUB 는 선택된 프리미티브의 입력 계약과 일치해야 합니다.

• (circuit, parameter_values, shots)``primitive="sampler"다음과 같이, 각 PUB는 PUB 샘플러 형식을 따릅니다.
• 다음과 primitive="estimator"같이, 각 PUB 는 Estimator PUB 형식을 따릅니다. 예를 들어, (circuit, observables, parameter_values, precision).
• 기본 options.transpilation_mode="optimize" 경로에서 회로가 ISA 회로일 필요는 없습니다. Orbit이 내부적으로 이를 트랜스파일링하고 스케줄링합니다.

유형: str

Orbit이 실행에 사용할 IBM Quantum 프리미티브를 선택합니다.

• 필수: Yes
• 유효한 입력 유형: str

프라이머리타입은 각 PUB 가 포함해야 할 내용과 각가 PubResult 반환하는 결과 데이터를 결정합니다.

• 선택 사항: "sampler" / "estimator"
• 샘플링된 비트스트링 데이터에는 를 사용하십시오 "sampler" .
• 기대값과 표준오차에는 를 사용하십시오 "estimator" .

유형: str or None

기본값: None

실행할 ‘ IBM Quantum ’ 백엔드의 이름.

• 필수: 아니오

• 기본값: None

• 유효한 입력 유형: str 또는 None

• least_busy()``None생략되거나 인 경우, Orbit은 를 사용하여 적합한 비시뮬레이터 백엔드를 결정합니다.

• 예:"ibm_boston"

유형: dict or None

기본값: None

Orbit의 실행 동작을 제어하는 기능별 옵션입니다.

• 필수: 아니오
• 기본값: None
• 유효한 입력 유형: dict 또는 None

이 옵션들은 트랜스파일링, DD 삽입, 양자 연산 옵션, 미리보기 모드, 시뮬레이터 모드, 백엔드 정보 내보내기 및 측정 오차 완화를 제어합니다.

• 알 수 없는 옵션 키는 거부됩니다.
• None모든 기본값을 사용하려면, {}, 또는 생략하십시오 options .
• 예:

{
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit"},
        {
            "mode": "custom",
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "transpilation_mode": "optimize",
            "mem": True
        }
    ]
}

유형: bool

기본값: False

Orbit이 Quantum Compute 작업을 제출하지 않고도 DD 삽입 보고서를 반환하는지 여부.

• 필수: 아니오

• 기본값: False

• 유효한 입력 유형: bool

• 이 True 경우 QPU 시간이 사용되지 않으며, orbit은 단순히 내의 pubs 회로를 사전 처리한 후 삽입 보고서를 제공합니다.

• False (기본값)일 때, Orbit으로 수정된 회로가 포함된 양자 컴퓨팅 작업이 제출되고 처리됩니다.

• True와 simulator 가 모두 preview 인 경우, 미리보기 모드가 우선 적용되며 시뮬레이터 실행은 무시됩니다.

유형: bool

기본값: False

미리보기 모드에 각 PUB 에 대해 준비된 Orbit 후 회로가 메타데이터에 포함되는지 여부.

• 필수: 아니오

• 기본값: False

• 유효한 입력 유형: bool

• preview=True다음과 같은 경우에만 사용됩니다.

• debugCircuit.circuit각 PUB 보고서에는 True, debugCircuit.usedQubits, 및 작업 횟수가 포함됩니다. 또한 Qiskit이 회로를 내보낼 수 있는 경우에는 ‘최선의 노력(best-effort debugCircuit.qasm )’ 방식도 포함됩니다.

• 회로 페이로드의 크기가 클 수 있으므로, 일반적인 실행 시에는 이 기능을 비활성화된 상태로 두십시오.

유형: string

기본값: optimize

오빗(Orbit)이 DD 삽입 전에 PUB 회로를 어떻게 준비하는지.

• 필수: 아니오

• 기본값: "optimize"

• 유효한 입력 값: "optimize", "prepare", 또는 "validate"

• "optimize" Qiskit optimization_level=2 트랜스파일레이션을 반복적으로 실행하고, 정적 및 동적 회로에 대해 2-큐비트 깊이가 가장 낮은 후보를 선택합니다.

• "prepare" Qiskit optimization_level=0 준비 작업과 ALAP 스케줄링을 수행합니다. 이 physical_layout 지정되면, Orbit은 먼저 해당 물리적 와이어 인덱스에 회로를 구체화한 다음 Qiskit의 기본 레이아웃 방법을 사용합니다.

• "validate" 입력 회로가 이미 물리적으로 준비된 것으로 간주합니다. Orbit은 가능한 경우 백엔드 호환성을 검증하며, DD 삽입 전에 재매핑, 라우팅, 최적화 또는 스케줄 수정을 수행하지 않고, 해당 항목을 경고와 함께 무시합니다 physical_layout .

유형: object or null

기본값: None

선택적 논리적 큐비트-물리적 큐비트 매핑.

• 필수: 아니오
• 기본값: None
• 유효한 입력 유형: 키와 값이 0 이상의 정수인 객체, 또는 None

예: {"0": 85, "1": 89} 논리 큐비트 0을 물리적 큐비트 85에, 논리 큐비트 1을 물리적 큐비트 89에 매핑합니다. Python 호출자는 정수 키를 사용할 수 있으며, JSON 객체의 키는 문자열입니다.

• 모드에서는 "optimize" 이 값이 초기 레이아웃 시드로 전달되며, 최적화/라우팅 과정에서 최종 매핑이 변경될 수 있습니다.
• layout_method="trivial"모드에서 "prepare" Orbit은 회로를 이러한 물리적 와이어 인덱스에 구체화한 다음, 를 사용하여 level-0 준비 단계를 수행합니다. 명시적 라우팅 SWAP은 실행 중에도 양자 상태를 이동시킬 수 있다.
• 모드에서는 "validate" 제공된 회로 배선이 우선 적용되므로, physical_layout 는 경고와 함께 무시됩니다.

유형: int

기본값: 300

transpilation_mode="optimize".에서 시도된 확률적 트랜스필레이션 시드 Orbit의 개수.

• 필수: 아니오
• 기본값: 300
• 유효한 입력 유형: 양의 정수

유형: bool or None

기본값: None

Orbit이 M3 를 사용하여 샘플러 전용 측정 오차 완화 기법을 적용하는지 여부.

• 필수: 아니오

• 기본값: None

• 유효한 입력 유형: bool 또는 None

• sampler``True가 의 샷에 대해 측정 오차 완화 처리를 적용할 때.

• False이 경우, 샷에 대한 후처리를 수행하지 않습니다.

• None이 경우, 궤도(Orbit) 모드는 실행된 샘플러 PUB에 대해 MEM을 활성화하며, 원시/사용자 정의 모드는 별도로 구성되지 않은 한 MEM을 건너뜁니다.

• simulator=False``primitive="sampler"Explicit은 True , preview=False, 및 을 필요로 합니다.

• 원본 샘플러 카운트는 유지되며, 조정된 카운트는 Orbit 메타데이터에 첨부됩니다.

• 후처리 과정에서 완화 조치가 실패할 경우, Orbit은 원본 결과를 보존하고 메타데이터에 완화 조치 실패 사실을 기록합니다.

유형: list[dict] or None

기본값: None

PUB 의 각 실행 모드 및 재정의에 관하여.

• 필수: 아니오

• 기본값: None

• 유효한 입력 유형: list[dict] 또는 None

• 항목 하나를 모든 PUB에 방송하고, 그렇지 않은 경우에는 각 PUB 에 대해 항목 하나씩 전달합니다.

• {"mode": "raw"} 정적 또는 동적 회로에 대해 단일 Qiskit optimization_level=0 트랜스파일레이션 및 스케줄링 단계를 사용하며, Orbit 최적화, Orbit DD, 동적 DD 및 MEM 단계는 건너뜁니다.

• {"mode": "orbit"} Orbit의 기본 설정을 사용합니다.

• transpilation_mode``{"mode": "custom"} 해당 PUB 에 대해, physical_layout, dd_qubits, dd_strategy, dynamic_dd_seq, 및 mem 를 재정의할 수 있습니다.

• physical_layout=NoneRaw 모드는 항상 와 함께 사용되며 transpilation_mode="prepare" , Orbit DD를 건너뛰고 전역 준비 옵션을 무시합니다.

• Orbit 및 사용자 정의 PUB는 PUB 에 따라 해당 설정을 재정의하지 않는 한 전역 transpilation_mode 설정과 physical_layout 를 상속받습니다.

• duplicated PUBs를 사용하여 하나의 Quantum Compute 작업 내에서 원시 결과, Orbit 기본값 및 사용자 지정 DD 전략을 비교할 pub_options 수 있습니다. 단순한 CPMG 기준선을 사용하려면 사용자 정의 PUB 의 내부에서 {"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1} 다음을 사용하십시오 dd_strategy.

발신자가 준비한 회선의 경우, Orbit이 활성화된 PUB에는 다음을 사용하십시오 transpilation_mode="validate" :

options = {
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit", "transpilation_mode": "validate"},
        {
            "mode": "custom",
            "transpilation_mode": "validate",
            "dd_qubits": None,
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "mem": False,
        },
    ]
}

유형: list[list[dict]]

PUB 회로에 적용할 DD 전략을 정렬했습니다.

• 필수: 아니오

• 기본값: [[{"dd_sequence": "auto", "pulse_density": 0.25, "dd_reps": 1}]]

• 유효한 입력 유형: list[list[dict]]

• 선택 사항: 비어 있지 않은 전략 목록들로 구성된 비어 있지 않은 외부 목록.

• 외부 리스트는 PUB 또는 회로를 참조합니다. 전략이 하나만 제공되면, Orbit은 이를 모든 PUB에 브로드캐스트합니다.

• 각 내부 리스트는 같은 회로에 라운드별로 적용됩니다.

• 1``0.25``dd_sequence각 라운드에는 가 필요합니다. pulse_density 기본값은 이며, dd_reps 기본값은 입니다.

유형: str or dict or list or None

기본값: XY8

Orbit의 동적 회로 피드포워드 DD 삽입에 사용되는 DD 시퀀스.

• 필수: 아니오

• 기본값: "XY8"

• list유효한 입력 유형: str, dict, 사용자 정의 펄스 그룹, 또는 None

• dd_strategy[].dd_sequence선택 사항: 동적 피드포워드 삽입 단계를 비활성화하려면, 또는 None 와 같은 순서 형태를 사용합니다.

• Orbit이 조건부 논리나 제어 흐름을 감지하고 동적 회로(DD) 파이프라인을 사용할 때 적용됩니다.

• 먼저 일반 dd_strategy 패스가 실행되고, 그 다음 Orbit이 레이블이 지정된 동적 피드포워드 영역 전체에 이 시퀀스를 적용합니다.

유형: list[int] or None

기본값: None

Orbit DD 삽입 대상인 큐비트 인덱스의 글로벌 기본 허용 목록.

• 필수: 아니오

• 기본값: None

• 유효한 입력 유형: list[int] 또는 None

• 선택 사항: None 또는 0 이상인 정수 목록

• None 활성 상태이거나 터치된 큐비트만을 대상으로 합니다.

• 목록에는 유휴 전용 큐비트만 포함될 수 있으며, 목록에 포함되지 않은 큐비트는 제외됩니다.

• pub_options[i].dd_qubits 이 값은 또는 custom PUB 항목 내에서 orbit 재정의할 수 있습니다.

• "validate"명시적 허용 목록은 해결된 transpilation_mode 값이 인 Orbit 지원 PUB에 대해서만 제공될 수 있으므로, 호출자가 물리적 큐비트 인덱스를 소유하고 있어야 합니다. dd_qubitsRaw PUB는 Orbit DD 단계를 건너뛰며.를 허용하지 않습니다.

유형: bool

기본값: False

Quantum Compute 작업이 실행된 후 Orbit이 백엔드 보정 속성을 저장하는지 여부.

• 필수: 아니오

• 기본값: False

• 유효한 입력 유형: bool

• 선택 사항: True / False

• /data``service.job(job_id).properties()이 기능이 활성화되면 Orbit은 쿼리를 수행하고, 직렬화된 백엔드 속성을 에 저장하며, 저장된 경로를 Orbit 메타데이터에 기록합니다.

• 오류는 경고로 보고되며, 그 외에는 정상적으로 처리된 기본 연산 결과는 유지됩니다.

유형: int

기본값: 4096

샷을 명시적으로 지정하지 않은 샘플러 PUB에 사용되는 기본 샷입니다.

• 필수: 아니오

• 기본값: 4096

• 유효한 입력 유형: int

• 선택 사항: 0보다 큰 정수

• primitive="sampler"다음에만 적용됩니다.

유형: float

기본값: 0.015625

정밀도를 명시적으로 지정하지 않은 Estimator PUB에 사용되는 기본 대상 정밀도입니다.

• 필수: 아니오

• 기본값: 0.015625

• 유효한 입력 유형: float 또는 int

• 선택 사항: Float > 0

• primitive="estimator"다음에만 적용됩니다.

유형: dict

IBM Quantum 기본 SamplerV2 또는 EstimatorV2 함수에 전달되는 기본 옵션들.

• 필수: 아니오

• 기본값: {"resilience_level": 0, "dynamical_decoupling": {"enable": false}}

• 유효한 입력 유형: dict

• 선택한 기본 요소에 대한 고급 및 실험적 옵션을 포함하여 중첩된 옵션 사전도 허용됩니다.

• 런타임 동적 분리 기능은 기본적으로 비활성화되어 있으므로, 사용자가 직접 활성화하지 않는 한 Orbit의 DD 삽입이 유일한 DD 처리 단계입니다.

예를 들어, 숙련된 Sampler 사용자는 동적 회로 디버깅 필드를 활성화할 수 있습니다:

options = {
    "runtime_options": {
        "experimental": {
            "execution": {
                "scheduler_timing": True,
                "stretch_values": True,
            }
        }
    }
}

• 주의: 따라서 이 값을 변경할 때는 신중을 기해야 하며, DD는 계속 제외하면서 트위를링과 같은 특정 기능을 수동으로 활성화해야 합니다.

유형: int or None

기본값: None

Quantum Compute 작업의 최대 실행 시간에 대한 소프트 캡.

• 필수: 아니오
• 기본값: None
• 유효한 입력 유형: int 또는 None

값은 초 단위로 지정됩니다.

• 선택 사항: None 또는 0보다 큰 정수
• None일 경우, 런타임 기본값이 사용됩니다.

유형: bool

기본값: False

Orbit이 실제 QPU 대신 로컬 Aer 시뮬레이터에서 워크로드를 실행하는지 여부.

• 필수: 아니오
• 기본값: False
• 유효한 입력 유형: bool

시뮬레이터는 함수 컨테이너 내에서 실행됩니다.

• 선택 사항: True / False
• True일 때 preview 무시됩니다.
• Orbit 메타데이터가 첨부된 정상 PrimitiveResult 값이 반환됩니다.

유형: str

기본값: backend

True가 일 때 simulator 사용되는 잡음 모델.

• 필수: 아니오

• 기본값: "backend"

• 유효한 입력 유형: str

• 선택 사항: "backend" / "ideal"

• "backend" 가능할 때마다 사용합니다 AerSimulator.from_backend(backend) .

• AerSimulator``"ideal" 잡음이 없는 일반 파일을 사용합니다.

유형: int or None

기본값: None

하나의 DD 게이트 또는 펄스의 지속 시간.

• 필수: 아니오

• 기본값: None

• 유효한 입력 유형: int 또는 None

• 경고: 명시적 값은 통제된 테스트에서나, 백엔드별 보정이 필요한 명확한 사유가 있는 경우에만 사용하십시오.

• 이 값은 백엔드에서 지연 시간에 사용하는 것과 동일한 단위를 사용하며, 일반적으로 dt.

• 선택 사항: None 또는 0보다 큰 정수

• None이때, Orbit은 더 긴 보정된 X 또는 sqrt(X) 게이트 지속 시간을 사용하여 백엔드를 고려한 값을 에서 backend.target 계산합니다.

유형: PrimitiveResult

Orbit 메타데이터가 첨부된 표준 형식입니다 PrimitiveResult .

• primitive="sampler"각 PubResult.data 에는 클래식 레지스터 비트 배열과 같은 샘플러 결과 데이터가 포함되어 있습니다.
• primitive="estimator"각 PubResult.data 에는 기대값 및 표준오차와 같은 추정기 결과 데이터가 포함되어 있습니다.
• 미리보기 모드에서는 IBM Quantum 기본 요소가 제출되지 않았기 때문에 각 항목이 비어 있습니다 PubResult.data .