pygsti.extras.idletomography.idtcore.make_idle_tomography_list

pygsti.extras.idletomography.idtcore.make_idle_tomography_list#

make_idle_tomography_list(nqubits, max_lengths, pauli_basis_dicts, maxweight=2, idle_string=((),), include_hamiltonian=True, include_stochastic=True, include_affine=True, ham_tmpl='auto', preferred_prep_basis_signs='auto', preferred_meas_basis_signs='auto')#

Construct the list of experiments needed to perform idle tomography.

Parameters:

  • nqubits (int) – The number of qubits.

  • max_lengths (list) – A list of maximum germ-power lengths. Each specifies a number many times to repeat the idle gate, and typically this is a list of the powers of 2 preceded by zero, e.g. [0,1,2,4,16]. The largest value in this list should be chosen to be the maximum number of idle gates you want to perform in a row (typically limited by performance or time constraints).

  • pauli_basis_dicts (tuple) – A (prepPauliBasisDict,measPauliBasisDict) tuple of dictionaries specifying the way to prepare and measure in Pauli bases. See preferred_signs_from_paulidict() for details on each dictionary’s format.

  • maxweight (int, optional) – The maximum weight of errors to consider.

  • idle_string (Circuit-like, optional) – A Circuit or tuple of operation labels that represents the idle gate being characterized by idle tomography.

  • include_hamiltonian (bool, optional) – Whether to include fiducial pairs for finding Hamiltonian-, Stochastic-, and Affine-type errors.

  • include_stochastic (bool, optional) – Whether to include fiducial pairs for finding Hamiltonian-, Stochastic-, and Affine-type errors.

  • include_affine (bool, optional) – Whether to include fiducial pairs for finding Hamiltonian-, Stochastic-, and Affine-type errors.

  • ham_tmpl (tuple, optional) – A tuple of length-maxweight Pauli strings (i.e. string w/letters “X”, “Y”, or “Z”), describing how to construct the fiducial pairs used to detect Hamiltonian errors. The special (and default) value “auto” uses (“X”,”Y”,”Z”) and (“ZY”,”ZX”,”XZ”,”YZ”,”YX”,”XY”) for maxweight equal to 1 and 2, repectively, and will generate an error if maxweight > 2.

  • preferred_prep_basis_signs (tuple, optional) – A 3-tuple of “+” or “-” strings indicating which sign for preparing or measuring in the X, Y, and Z bases is preferable. Usually one orientation if preferred because it’s easier to achieve using the native model. Additionally, the special (and default) value “auto” may be used, in which case preferred_signs_from_paulidict() is used to choose preferred signs based on pauli_basis_dicts.

  • preferred_meas_basis_signs (tuple, optional) – A 3-tuple of “+” or “-” strings indicating which sign for preparing or measuring in the X, Y, and Z bases is preferable. Usually one orientation if preferred because it’s easier to achieve using the native model. Additionally, the special (and default) value “auto” may be used, in which case preferred_signs_from_paulidict() is used to choose preferred signs based on pauli_basis_dicts.

Returns:

A list of Circuit objects.

Return type:

list