Struct DevicePackedShots 

pub struct DevicePackedShots { /* private fields */ }

Available on crate feature gpu only.

Device-resident packed shots emitted by the GPU BTS path.

The payload stays in measurement-major layout on the device until an explicit host copy via Self::to_host. Marginals and exact counts can be reduced first so higher-level workflows do not have to transfer the full shot matrix.

Implementations

impl DevicePackedShots

pub fn num_shots(&self) -> usize

pub fn num_measurements(&self) -> usize

pub fn layout(&self) -> ShotLayout

pub fn m_words(&self) -> usize

Words per shot-major row: ceil(num_measurements / 64).

pub fn s_words(&self) -> usize

Words per measurement-major row: ceil(num_shots / 64).

pub fn to_host(&self) -> Result<PackedShots>

Copy the full packed payload back to host memory.

pub fn marginal_counts(&self) -> Result<Vec<u64>>

Return per-measurement one-counts without copying the full shot matrix.

pub fn marginals(&self) -> Result<Vec<f64>>

Return per-measurement marginal probabilities.

pub fn counts(&self) -> Result<HashMap<Vec<u64>, u64>>

Return exact counts, using a GPU reduction when it reduces transfer.

Trait Implementations

impl Debug for DevicePackedShots

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.