부분 표본 추출
qiskit_addon_sqd.subsampling
비트 문자열 매트릭스에서 샘플 배치를 생성하는 함수입니다.
subsample
subsample(bitstring_matrix, probabilities, samples_per_batch, num_batches, rand_seed=None)
입력에서 비트 배열의 하위 샘플 배치 bitstring_matrix.
각 개별 배치는 입력된 bitstring_matrix 에서 교체하지 않고 샘플링됩니다. 샘플은 각 배치가 생성된 후 교체되므로 다른 배치에 동일한 샘플이 포함될 수 있습니다.
매개변수
- bitstring_matrix (ndarray) – 각 행이 단일 비트 문자열을 나타내는 비트 값의
bool표현의 2D 배열입니다. - probabilities (ndarray) – 비트 문자열에 대한 확률 분포를 지정하는 1D 배열
- samples_per_batch (int) – 각 배치에 대해 추출할 샘플 수
- num_batches (int) – 생성할 배치 수
- rand_seed (Generator |int | None) – 무작위 동작을 제어하는 시드
리턴
입력 비트스트링 행렬에서 서브샘플링된 비트스트링 행렬의 목록입니다.
레이즈
- ValueError -
probabilities의 요소 수는bitstring_matrix의 행 수와 같아야 합니다. - ValueError - 배치당 샘플 및 배치 수는 양의 정수여야 합니다.
리턴 유형
postselect_and_subsample
postselect_and_subsample(bitstring_matrix, probabilities, *, hamming_right, hamming_left, samples_per_batch, num_batches, rand_seed=None)
입력에서 정확한 해밍 가중치를 사용하여 비트 배열의 하위 샘플 배치 bitstring_matrix.
왼쪽 또는 오른쪽 절반에 잘못된 해머 무게가 있는 비트 스트링 샘플은 샘플링되지 않습니다.
각 개별 배치는 입력된 bitstring_matrix 에서 교체하지 않고 샘플링됩니다. 샘플은 각 배치가 생성된 후 교체되므로 다른 배치에 동일한 샘플이 포함될 수 있습니다.
qiskit_addon_sqd.subsampling.postselect_and_subsample() 함수는 qiskit-addon-sqd 0.12.0 에서 더 이상 사용되지 않는다. v0.13.0 이전에는 제거되지 않습니다. 대신 postselect_by_hamming_right_and_left 및 subsample 기능을 사용하세요.
매개변수
- bitstring_matrix (ndarray) – 각 행이 단일 비트 문자열을 나타내는 비트 값의
bool표현의 2D 배열입니다. - probabilities (ndarray) – 비트 문자열에 대한 확률 분포를 지정하는 1D 배열
- hamming_right (int) – 샘플링된 비트 스트링의 오른쪽 절반에 대한 목표 해밍 가중치
- hamming_left (int) – 샘플링된 비트 스트링의 왼쪽 절반에 대한 목표 해밍 웨이트입니다
- samples_per_batch (int) – 각 배치에 대해 추출할 샘플 수
- num_batches (int) – 생성할 배치 수
- rand_seed (Generator |int | None) – 무작위 동작을 제어하는 시드
리턴
입력 비트스트링 행렬에서 서브샘플링된 정확한 해밍 가중치가 있는 비트스트링 행렬 목록입니다
레이즈
- ValueError -
probabilities의 요소 수는bitstring_matrix의 행 수와 같아야 합니다. - ValueError - 해밍 가중치는 음수가 아닌 정수여야 합니다.
- ValueError - 배치당 샘플 및 배치 수는 양의 정수여야 합니다.
리턴 유형
postselect_by_hamming_right_and_left
postselect_by_hamming_right_and_left(bitstring_matrix, probabilities, *, hamming_right, hamming_left)
오른쪽과 왼쪽 절반에 원하는 해밍 가중치를 기준으로 비트 문자열을 선택합니다.
매개변수
- bitstring_matrix (ndarray) – 각 행이 단일 비트 문자열을 나타내는 비트 값의
bool표현의 2D 배열입니다. - probabilities (ndarray) – 비트 문자열에 대한 확률 분포를 지정하는 1D 배열
- hamming_right (int) – 샘플링된 비트 스트링의 오른쪽 절반에 대한 목표 해밍 가중치
- hamming_left (int) – 샘플링된 비트 스트링의 왼쪽 절반에 대한 목표 해밍 웨이트입니다
리턴
사후 선택된 비트 문자열 행렬과 확률. 새 비트 문자열 행렬은 원래 행렬에서 오른쪽과 왼쪽 절반에 원하는 해밍 가중치가 있는 비트 문자열만 포함하며, 새 확률은 사후 선택된 비트 문자열에 해당하는 원래 확률을 가져와 합이 1이 되도록 재조정하여 구성됩니다.
레이즈
- ValueError - 해밍 가중치는 음수가 아닌 정수여야 합니다.
- ValueError -
bitstring_matrix의 열 수는 짝수여야 합니다. - ValueError -
probabilities의 요소 수는bitstring_matrix의 행 수와 같아야 합니다.
리턴 유형