Skip to main contentIBM Quantum Documentation

TwirledSliceSpan

class TwirledSliceSpan(start, stop, data_slices)

GitHub

Bases: ExecutionSpan

An ExecutionSpan for data stored in a sliceable format when twirling.

This type of execution span references pub result data that came from a twirled sampler experiment which was executed by either prepending or appending an axis to paramater values to account for twirling. Concretely, data_slices is a map from pub slices to tuples (twirled_shape, at_front, shape_slice, shots_slice) where

  • twirled_shape is the shape tuple including a twirling axis, and where the last axis is shots per randomization,
  • at_front is whether num_randomizations is at the front of the tuple, as opposed to right before the shots axis at the end,
  • shape_slice is a slice of an array of shape twirled_shape[:-1], flattened,
  • and shots_slice is a slice of twirled_shape[-1].

Parameters

  • start (datetime) – The start time of the span, in UTC.
  • stop (datetime) – The stop time of the span, in UTC.
  • data_slices (dict[int, tuple[ShapeType, bool, slice, slice]]) – A map from pub indices to length-4 tuples described above.

Attributes

duration

The duration of this span, in seconds.

pub_idxs

size

start

The start time of the span, in UTC.

stop

The stop time of the span, in UTC.


Methods

contains_pub

contains_pub(pub_idx)

GitHub

Return whether the pub with the given index has data with dependence on this span.

Parameters

pub_idx (int | Iterable[int]) – One or more pub indices from the original primitive call.

Returns

Whether there is dependence on this span.

Return type

bool

filter_by_pub

filter_by_pub(pub_idx)

GitHub

Return a new span whose slices are filtered to the provided pub indices.

For example, if this span contains slice information for pubs with indices 1, 3, 4 and [1, 4] is provided, then the span returned by this method will contain slice information for only those two indices, but be identical otherwise.

Parameters

pub_idx (int | Iterable[int]) – One or more pub indices from the original primitive call.

Returns

A new filtered span.

Return type

TwirledSliceSpan

mask

mask(pub_idx)

GitHub

Return an array-valued mask specifying which parts of a pub result depend on this span.

Parameters

pub_idx (int) – The index of the pub to return a mask for.

Returns

An array with the same shape as the pub data.

Return type

ndarray[Any, dtype[bool]]

Was this page helpful?
Report a bug or request content on GitHub.