qilisdk.functionals.sampling

Classes

Sampling

Execute a digital circuit and collect bitstring samples.

Module Contents

class Sampling(circuit: qilisdk.digital.circuit.Circuit, nshots: int = 1000)

Bases: qilisdk.functionals.functional.PrimitiveFunctional[qilisdk.functionals.sampling_result.SamplingResult]

Execute a digital circuit and collect bitstring samples.

Exemple

from qilisdk.digital.circuit import Circuit
from qilisdk.functionals.sampling import Sampling

circuit = Circuit(nqubits=2)
circuit.h(0)
sampler = Sampling(circuit, nshots=1024)

Paràmetres:

• circuit (Circuit) – Circuit to execute for sampling.

• nshots (int, optional) – Number of repetitions used to estimate probabilities. Defaults to 1000.

result_type: ClassVar[type[qilisdk.functionals.sampling_result.SamplingResult]]

Concrete FunctionalResult subclass returned.

circuit

nshots = 1000

property nparameters: int

Return the number of parameters exposed by the underlying circuit.

set_parameters(parameters: dict[str, qilisdk.core.types.RealNumber]) → None

Assign a subset of circuit parameters provided by label.

get_parameters() → dict[str, qilisdk.core.types.RealNumber]

Return a mapping of all circuit parameters to their current value.

get_parameter_names() → list[str]

Return circuit parameter labels in deterministic order.

get_parameter_values() → list[qilisdk.core.types.RealNumber]

Return the current parameter values following get_parameter_names order.

set_parameter_values(values: list[float]) → None

Update all circuit parameters using the order defined by get_parameter_names.

get_parameter_bounds() → dict[str, tuple[float, float]]

Return lower and upper bounds registered for each circuit parameter.

set_parameter_bounds(ranges: dict[str, tuple[float, float]]) → None

Update the admissible range for selected circuit parameters.

get_constraints() → list[qilisdk.core.variables.ComparisonTerm]

Expose parameter constraints defined on the circuit. :returns: a list of constraints on the circuit parameters. :rtype: list[ComparisonTerm]