Module ibm_runtime_v2 

IBM Qiskit Runtime v2 Primitives

This module provides the v2 API for IBM Runtime primitives, which includes:

• SamplerV2: Non-session batch sampling with PUBs
• EstimatorV2: Enhanced estimation with advanced error mitigation
• PUBs (Primitive Unified Blocks): Bundled circuit/parameter/observable specifications

Key Differences from v1

• No mandatory session: Can run without a session context
• PUBs: Structured input format for batching
• Enhanced error mitigation: ZNE, PEC, twirling options
• Cost estimation: Pre-execution cost estimation

Example

use quantrs2_device::ibm_runtime_v2::{SamplerV2, EstimatorV2, PUB, ResilienceOptions};

// Create a PUB (Primitive Unified Block)
let pub1 = PUB::new(circuit)
    .with_parameter_values(vec![0.5, 1.0])
    .with_shots(4096);

// Use SamplerV2 without session
let sampler = SamplerV2::new(client, "ibm_brisbane")?;
let result = sampler.run(&[pub1]).await?;

// Use EstimatorV2 with enhanced error mitigation
let options = ResilienceOptions::default()
    .with_zne(ZNEConfig::default())
    .with_twirling(TwirlingConfig::default());

let estimator = EstimatorV2::new(client, "ibm_brisbane")?
    .with_resilience(options);
let expectation = estimator.run(&pubs, &observables).await?;

Structs

CostEstimate

Cost estimate for a job

DynamicalDecouplingConfig

Dynamical decoupling configuration

EstimatorPUBResult

Result for a single PUB (EstimatorV2)

EstimatorV2

EstimatorV2 primitive for v2 API

EstimatorV2Metadata

Metadata for EstimatorV2 execution

EstimatorV2Options

Options for EstimatorV2

EstimatorV2Result

Result from EstimatorV2 execution

MeasurementMitigationConfig

Measurement error mitigation configuration

ObservableV2

Observable specification for EstimatorV2

PECConfig

Probabilistic error cancellation configuration

PUB

Primitive Unified Block (PUB) for v2 primitives

ResilienceData

Resilience processing data

ResilienceOptions

Resilience options for error mitigation

SamplerPUBResult

Result for a single PUB

SamplerV2

SamplerV2 primitive for v2 API

SamplerV2Metadata

Metadata for SamplerV2 execution

SamplerV2Options

Options for SamplerV2

SamplerV2Result

Result from SamplerV2 execution

TwirlingConfig

Twirling configuration for error mitigation

ZNEConfig

Zero-noise extrapolation configuration

ZNEData

ZNE extrapolation data

Enums

DDSequence

Dynamical decoupling sequence types

ExtrapolationMethod

Extrapolation method for ZNE