JIJ SQOA 솔버 API 참조

유형: str or dict[str, float]

다음 형식 중 하나로 주어진 최적화 문제. 자세한 내용은 ‘허용되는 문제 형식’을 참조하십시오.

• 시리얼화된 OMMX 인스턴스. 를 ommx.v1.Instance 로 직렬화하고 to_bytes() , 해당 바이트를 표준 패딩 방식의 Base64 (RFC 4648)로 인코딩합니다.
  • URL 호환 Base64, 패딩이 누락된 경우, 그리고 공백이 포함된 경우 모두 허용되지 않습니다.
  • 인스턴스는 이미 QUBO 형식이어야 합니다.
  • 예: base64.b64encode(instance.to_bytes()).decode(), 이는 두 변수를 가진 QUBO의 경우 다음과 같은 결과를 나타냅니다:

  EiYQARoJEQAAAAAAAPA/IgF4KgEAMhEKCnN1YnNjcmlwdHMSA1swXRIoCAEQARoJEQAAAAAAAPA/IgF4KgEBMhEKCnN1YnNjcmlwdHMSA1sxXRosGioKAQASAQEaCAAAAAAAAADAIhgKCwgBEQAAAAAAAPA/CgkRAAAAAAAA8D8oAjoA
• 키가 변수 ID의 튜플을 문자열로 변환한 것이며, 값이 계수인 계수 사전:
  • "()" 상수
  • "(i,)" 선형 항의 경우
  • "(i, j)" 2차 항의 경우
  • 예:{"()": 2.5, "(7,)": -1, "(11,)": 2, "(7, 11)": 3}
• 필수: Yes

유형: str

결정 변수의 정의역: 에 "binary" 속하는 변수의 경우, 또는 {0, 1} 에 "spin" 속하는 변수의 경우 {-1, +1}.

• OMMX 인스턴스는 반드시 "binary".와 함께 제출해야 합니다.
• "spin" 계수 사전에서만 허용됩니다.
• 결과에는 동일한 정의역에 속하는 변수 값들이 보고됩니다.
• 필수: Yes
• 예:"binary"

유형: str or None

기본값: None

샘플링 작업을 실행하는 IBM Quantum® 백엔드의 이름. 이 매개변수가 전달될 경우, 그 값은 앞뒤에 공백이 없고 비어 있지 않은 문자열이어야 하며, 함수를 실행하는 데 사용되는 인스턴스에서 접근 가능한 백엔드의 이름을 지정해야 합니다.

• 해결할 수 없는 이름은 오류를 발생시킵니다. 이 함수는 자동 선택으로 전환되지 않습니다.
• 생략되거나 인 경우 None, 이 함수는 해당 인스턴스가 접근할 수 있는 QPU 중 부하가 가장 적은 QPU를 선택하며, 이는 와 동일하며 QiskitRuntimeService.least_busy(operational=True, simulator=False), 선택된 백엔드를 작업 로그에 기록합니다.
• 필수: 아니오
• 예:"ibm_fez"

유형: dict[str, Any]

샘플링 예산, 재현성, 세션 사용, 기존 후처리 및 작업 태그를 제어하는 옵션들. 옵션을 딕셔너리 형식으로 지정합니다. 이 함수는 알 수 없는 키를 거부합니다. 사용 가능한 옵션과 해당 기본값에 대한 다음 목록을 참조하십시오.

• 필수: 아니오

예:

{
    "shots": 4096,
    "seed": 42,
    "session": True,
    "postprocessing_level": 1,
    "job_tags": ["mis"]
}

사용 가능한 옵션:

shots

seed

session

postprocessing_level

job_tags

유형: `dict[str, Any]`

해결책 및 메타데이터. job.result() 'Result' 사전 항목에 설명된 대로, 정확히 네 개의 키( solution, objective_value, feasible, 및 metadata)를 가진 사전을 반환합니다.

예:

{
    'solution': {'x_0': 1.0, 'x_1': 0.0},
    'objective_value': 1.0,
    'feasible': True,
    'metadata': {
        'solver_info': {
            'seed': 42,
            'solution_before_postprocessing': {'x_0': 0.0, 'x_1': 0.0},
            'ommx_solution': 'Cg8KCREAAAAAAADwPwoCCAER...'
        },
        'resource_usage': {
            'RUNNING: MAPPING': {'CPU_TIME': 0.9},
            'RUNNING: OPTIMIZING_FOR_HARDWARE': {'CPU_TIME': 2.1},
            'RUNNING: WAITING_FOR_QPU': {'CPU_TIME': 41.7},
            'RUNNING: EXECUTING_QPU': {'QPU_TIME': 4.8},
            'RUNNING: POST_PROCESSING': {'CPU_TIME': 1.3}
        }
    }
}

유형: `dict[str, float]`

모든 후처리 과정을 거친 후 변수를 기준으로 선별된 가장 우수한 결과물 하나. 여러 후보가 가장 높은 객관적 점수를 기록할 경우, 그중 한 명이 선정됩니다.

각 키는 변수 이름 뒤에 밑줄(_)과 10진수 결정 변수 ID가 이어지는 형식입니다 name_ID. 예를 들어, x_17. 키들은 ID 순서대로 오름차순으로 나열되므로, 이름이 중복되더라도 각 키는 고유하게 유지됩니다.

• OMMX 인스턴스의 경우, 이름과 ID는 해당 인스턴스에서 가져옵니다. 이름이 없는 변수는 를 사용하며 x, 첨자는 키의 일부가 아닙니다.
• 사전 문제의 경우, 키는 제출된 사전에 사용된 ID들로 x_ID 구성됩니다.

과제가 완료되었습니다. OMMX 인스턴스의 경우, 여기에는 전처리 과정에서 고정된 변수, OMMX 변환 메타데이터를 통해 재구성된 종속 변수 및 여유 변수, 그리고 목적 함수가 사용하지 않는 변수가 포함됩니다.

값은 일 1 때 0 이거나 이며 "binary" , 일 +1 때 -1 이거나 입니다 "spin".

유형: `float`

내부 양자 이완이 아닌, 제출된 문제에 대해 평가된 반환된 할당식의 객관적 값.

• OMMX 인스턴스의 경우, 이는 인스턴스 자체의 관점에서 볼 때 그 인스턴스의 목적입니다.
• 사전 문제의 경우, 이는 상수항을 포함하여 원래 변수 영역에서 계수 사전의 값입니다.

유형: `bool`

OMMX SDK에 의해 평가된 바와 같이, 해당 할당이 제출된 인스턴스에 기록된 제약 조건(OMMX QUBO 변환 과정에서 제거된 제약 조건 포함)을 충족하는지 여부. 사전 문제는 제약 조건이 없으므로, 그 실행 가능성은 변수의 정의역에만 국한됩니다.

유형: `dict[str, Any]`

정확히 두 개의 키, solver_info 와 가 포함되어 있습니다 resource_usage.

solver_info

resource_usage