pygsti.construction.make_lsgst_experiment_list

pygsti.construction.make_lsgst_experiment_list(gateLabels, prepStrs, effectStrs, germList, maxLengthList, fidPairs=None, truncScheme='whole germ powers')

Create a list of all the gate strings (i.e. the experiments) required for long-sequence GST (LSGST) algorithms.

Returns a single list containing, without duplicates, all the gate strings required throughout all the iterations of LSGST given by maxLengthList. Thus, the returned list is equivalently the list of the experiments required to run LSGST using the supplied parameters, and so commonly used when construting data set templates or simulated data sets. The breakdown of which gate strings are used for which iteration(s) of LSGST is given by make_lsgst_lists(...).

Parameters:
  • gateLabels (list or tuple) – List of gate labels to determine needed LGST strings. Only relevant when maxLengthList[0] == 0.
  • prepStrs (list of GateStrings) – List of the preparation fiducial gate strings, which follow state preparation.
  • effectStrs (list of GateStrings) – List of the measurement fiducial gate strings, which precede measurement.
  • germList (list of GateStrings) – List of the germ gate strings.
  • maxLengthList (list of ints) – List of maximum lengths. If maxLengthList[0] == 0 this results in special behavior where LGST strings are included as the first returned list.
  • fidPairs (list of 2-tuples, optional) – Specifies a subset of all fiducial string pairs (prepStr, effectStr) to be used in the gate string lists. Each element of fidPairs is a (iPrepStr, iEffectStr) 2-tuple of integers, each indexing a string within prepStrs and effectStrs, respectively, so that prepStr = prepStrs[iPrepStr] and effectStr = effectStrs[iEffectStr].
  • truncScheme (str, optional) –

    Truncation scheme used to interpret what the list of maximum lengths means. If unsure, leave as default. Allowed values are:

    • ‘whole germ powers’ – germs are repeated an integer number of times such that the length is less than or equal to the max.
    • ‘truncated germ powers’ – repeated germ string is truncated to be exactly equal to the max (partial germ at end is ok).
    • ‘length as exponent’ – max. length is instead interpreted as the germ exponent (the number of germ repetitions).
Returns:

Return type:

list of GateStrings