iqm.benchmarks.utils_shadows.get_local_shadow

iqm.benchmarks.utils_shadows.get_local_shadow#

iqm.benchmarks.utils_shadows.get_local_shadow(counts: Dict[str, int], unitary_arg: ndarray | Sequence[str], subsystem_bit_indices: Sequence[int], clifford_or_haar: Literal['clifford', 'haar'] = 'clifford', cliffords_1q: Dict[str, QuantumCircuit] | None = None) → ndarray#

Constructs shadows for each individual initialisation.

Parameters:

  • counts (Dict[str, int]) – a dictionary of bit-string counts.

  • unitary_arg (np.ndarray | Sequence[str]) – local random unitaries used for a given initialisation, either specified as - a numpy array, or - a Sequence of Clifford labels.

  • subsystem_bit_indices (Sequence[int]) – Bit indices in the counts of the subsystem to construct the shadow of.

  • clifford_or_haar (Literal["clifford", "haar"]) – Whether to use Clifford or Haar random 1Q gates. * Default is “clifford”.

  • cliffords_1q (Optional[Dict[str, QuantumCircuit]]) – dictionary of 1-qubit Cliffords in terms of IQM-native r and CZ gates * Default is None.

Returns:

shadow of considered subsystem.

Return type:

np.ndarray