quri_parts.core.sampling package¶

MeasurementCounts¶

MeasurementCounts represents count statistics of repeated measurements of a quantum circuit. Keys are observed bit patterns encoded in integers and values are counts of observation of the corresponding bit patterns.

alias of Mapping[int, int | float]

Sampler¶

Sampler represents a function that samples a specified (non-parametric) circuit by a specified times and returns the count statistics. In the case of an ideal Sampler, the return value corresponds to probabilities multiplied by shot count. Implementations should name the shot count parameter shots so it can be passed as a keyword argument.

alias of Callable[[ImmutableQuantumCircuit, int], Mapping[int, int | float]]

ConcurrentSampler¶

ConcurrentSampler represents a function that samples specified (non-parametric) circuits concurrently.

alias of Callable[[Iterable[tuple[ImmutableQuantumCircuit, int]]], Iterable[Mapping[int, int | float]]]

ParametricSampler¶

ParametricSampler represents a sampler that samples from a parametric circuit with a fixed set of circuit parameters.

alias of Callable[[ParametricQuantumCircuitProtocol, int, Sequence[float]], Mapping[int, int | float]]

ConcurrentParametricSampler¶

ConcurrentParametricSampler represents a sampler that samples from a parametric circuit with a (shot, circuit parameter) pairs.

alias of Callable[[ParametricQuantumCircuitProtocol, Iterable[tuple[int, Sequence[float]]]], Iterable[Mapping[int, int | float]]]

StateSampler¶

StateSampler representes a function that samples a specific (non-parametric) state by specified times and returns the count statistics. In the case of an ideal StateSampler, the return value corresponds to probabilities multiplied by shot count. Implementations should name the shot count parameter shots so it can be passed as a keyword argument.

alias of Callable[[_StateT, int], Mapping[int, int | float]]

ConcurrentStateSampler¶

ConcurrentSampler represents a function that samples specified (non-parametric) state by specified times and returns the count statistics concurrently.

alias of Callable[[Iterable[tuple[_StateT, int]]], Iterable[Mapping[int, int | float]]]

ParametricStateSampler¶

ParametricStateSampler represents a state sampler that samples from a parametric state with a fixed set of circuit parameters.

alias of Callable[[_ParametricStateT, int, Sequence[float]], Mapping[int, int | float]]

ConcurrentParametricStateSampler¶

ConcurrentParametricStateSampler represents a state sampler that samples from a parametric state with a sequence of (shot, circuit parameter) pairs.

alias of Callable[[_ParametricStateT, Iterable[tuple[int, Sequence[float]]]], Iterable[Mapping[int, int | float]]]

class GeneralSampler(sampler: 'Sampler', state_sampler: 'StateSampler[_StateT]')¶

Bases: Generic[_StateT, _ParametricStateT]

Parameters:

sampler (Sampler)
state_sampler (StateSampler[_StateT])

sampler: Sampler¶

state_sampler: StateSampler[_StateT]¶

parametric_sampler: ParametricSampler¶

parametric_state_sampler: ParametricStateSampler[_ParametricStateT]¶

create_parametric_sampler_from_sampler(sampler)¶

Create a ParametricSampler from a Sampler.

Parameters:: sampler (core.sampling.Sampler)
Return type:: core.sampling.ParametricSampler

create_concurrent_parametric_sampler_from_concurrent_sampler(concurrent_sampler)¶

Create a ConcurrentParametricSampler from a ConcurrentSampler.

Parameters:: concurrent_sampler (core.sampling.ConcurrentSampler)
Return type:: core.sampling.ConcurrentParametricSampler

create_parametric_state_sampler_from_state_sampler(state_sampler)¶

Create a ParametricStateSampler from a StateSampler.

Parameters:: state_sampler (StateSampler[_StateT])
Return type:: ParametricStateSampler[_ParametricStateT]

create_concurrent_parametric_state_sampler_from_concurrent_state_sampler(concurrent_state_sampler)¶

Create a ConcurrentParametricStateSampler from a ConcurrentStateSampler.

Parameters:: concurrent_state_sampler (ConcurrentStateSampler[_StateT])
Return type:: ConcurrentParametricStateSampler[_ParametricStateT]

sample_from_probability_distribution(n_sample, probability_distribution, seed=None)¶

Sample from a probibility distribution.

Parameters:

n_sample (int)
probability_distribution (Sequence[float] | ndarray[tuple[int, ...], dtype[float64]])
seed (int | None)

Return type: