pygsti.algorithms.fiducialpairreduction.test_fiducial_pairs

pygsti.algorithms.fiducialpairreduction.test_fiducial_pairs#

test_fiducial_pairs(fid_pairs, target_model, prep_fiducials, meas_fiducials, germs, test_lengths=(256, 2048), prep_povm_tuples='first', tol=0.75, verbosity=0, mem_limit=None)#

Tests a set of global or per-germ fiducial pairs.

Determines how many model parameters (of target_model) are amplified by the fiducial pairs given by fid_pairs, which can be either a list of 2-tuples (for global-FPR) or a dictionary (for per-germ FPR).

Parameters:
  • fid_pairs (list or dict) – Either a single list of fiducial-index pairs (2-tuples) that is applied to every germ (global FPR) OR a per-germ dictionary of lists, each containing the fiducial-index pairs (2-tuples) for that germ (for per-germ FPR).

  • target_model (Model) – The target model used to determine amplificational completeness.

  • prep_fiducials (list of Circuits) – Fiducial circuits used to construct an informationally complete effective preparation.

  • meas_fiducials (list of Circuits) – Fiducial circuits used to construct an informationally complete effective measurement.

  • germs (list of Circuits) – The germ circuits that are repeated to amplify errors.

  • test_lengths ((L1,L2) tuple of ints, optional) – A tuple of integers specifying the germ-power lengths to use when checking for amplificational completeness.

  • prep_povm_tuples (list or "first", optional) – A list of (prepLabel, povmLabel) tuples to consider when checking for completeness. Usually this should be left as the special (and default) value “first”, which considers the first prep and POVM contained in target_model.

  • tol (float, optional) – The tolerance for the fraction of the expected amplification that must be observed to call a parameter “amplified”.

  • verbosity (int, optional) – How much detail to print to stdout.

  • mem_limit (int, optional) – A memory limit in bytes.

Returns:

numAmplified

Return type:

int