Release Notes¶

0.4.0¶

Enable new input format for the executor_expectation_values function - allow a tuple of observables and measurement bases instead of a dictionary that maps between each measurement basis and its relevant commuting observables. In case such a tuple is given as input, the mapping between the measurement bases and the relevant commuting observables is done internally in the function.

Added the qiskit_addon_utils.noise_management.bit_flip_checks sub-package for detecting samples likely corrupted by non-Markovian noise with bit-flip checks. Postselecting only samples which pass all checks can result in a higher-fidelity distribution of samples from the QPU. See the guide for more details.

Fixed bugs in qiskit_addon_utils.exp_vals.executor_expectation_values() causing indexing errors when bit_array dimensions associated with twirling randomizations were not specified in avg_axis.

Added a new sub-package, qiskit_addon_utils.exp_vals, containing functions for calculating expectation values from the outputs of Qiskit Runtime’s new Executor primitive prototype. This includes:
- qiskit_addon_utils.exp_vals.executor_expectation_values() for expectation value calculation
- qiskit_addon_utils.exp_vals.get_measurement_bases() for identifying a minimal set of measurement bases to cover all terms in the observable.
- qiskit_addon_utils.exp_vals.map_observable_isa_to_canonical(), qiskit_addon_utils.exp_vals.map_observable_virtual_to_canonical(), and qiskit_addon_utils.exp_vals.map_observable_isa_to_virtual() for transforming the qubit order of Pauli observables.

Added two new functions to the qiskit_addon_utils.noise_management sub-package:
- qiskit_addon_utils.noise_management.trex_factors() for calculating TREX readout error mitigation scaling factors
- qiskit_addon_utils.noise_management.gamma_from_noisy_boxes() for calculating the gamma factor for a given circuit and noise model.

Add the transpiler passes required to pre-process the circuits, as well as the PostSelector and PostSelectionSummary objects required to post-process the results.

Support circuits that include classical bits when slicing a circuit by gate types. See #115 <https://github.com/Qiskit/qiskit-addon-utils/issues/115> for details.

This release adds support for Python 3.13. No code changes were necessary, so older releases are expected to work on Python 3.13 too.

The keyword argument include_slice_barriers of combine_slices() has been renamed to include_barriers.