DataBin

class qiskit.primitives.DataBin(*, shape=(), **data)

베이스: ShapedMixin

단일 펍에서 반환되는 주요 PubResult 데이터는.

이 객체 내의 데이터는 속성 접근(data_bin.my_field) 또는 -like dict문자열 키(data_bin["my_field"])를 통해 접근할 수 있습니다. 이 클래스는 불변 매핑( Python )으로 동작하므로, 예를 들어 사용 가능한 키를 로 쿼리하고 키와 값 모두를 로 keys() 반복 처리할 items()수 있습니다.

이 클래스는 사용된 기본형과 제출된 pub에 따라 서로 다른 속성과 키를 갖게 됩니다. 이러한 “특별한” 속성들의 이름은 키와 일치합니다. 예를 들어, 작업(job)을 SamplerV2 제출한 경우, 일반적으로 속성과 키는 이 퍼블을 정의하는 회로에 포함되어 있던 객체들의 ClassicalRegister 이름입니다.

모든 속성과 키에는 동일한 형상이 연관되어 있으며, 이는 해당 펍의 n차원 형상이다. 속성과 키는 일반적으로 사용된 기본 데이터 유형과 입력 퍼블에 따라 또는 numpy.ndarray BitArray 인스턴스가 됩니다.

사용자는 일반적으로 이 클래스를 직접 생성하지 않습니다. 대신, 전체 실행 결과 중 단일 퍼블릭의 결과에 대한 필드로 PubResult.data 이를 수신합니다.

예:

import numpy as np
from qiskit.primitives import DataBin, BitArray

data = DataBin(
    alpha=BitArray.from_samples(["0010"]),
    beta=np.array([1.2])
)

print("alpha data:", data.alpha)
print("beta data:", data.beta)

alpha data: BitArray(<shape=(), num_shots=1, num_bits=2>)
beta data: [1.2]

매개변수

• 데이터 - 데이터 빈에 넣을 이름/값 데이터입니다.
• shape (ShapeInput) – 데이터 빈의 모든 항목에 공통적으로 적용되는 선행 모양입니다. 기본값은 모든 객체와 호환되는 사소한 선행 모양인 () 입니다.

레이즈

• ValueError - 이름이 이 클래스의 메서드 이름과 겹치는 경우.
• ValueError - 일부 값이 제공된 모양과 일치하지 않는 경우.

속성

ndim

shape

size

메소드

items

keys

values