pygsti.extras.idletomography.idtcore.do_idle_tomography

pygsti.extras.idletomography.idtcore.do_idle_tomography#

do_idle_tomography(nqubits, dataset, max_lengths, pauli_basis_dicts, maxweight=2, idle_string=((),), include_hamiltonian='auto', include_stochastic='auto', include_affine='auto', advanced_options=None, verbosity=0, comm=None)#

Analyze dataset using the idle tomography protocol to characterize idle_string.

Parameters:

  • nqubits (int) – The number of qubits.

  • dataset (DataSet) – The set of data counts (observations) to use.

  • 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 ({True,False,"auto"}) – Whether to extract Hamiltonian-, Stochastic-, and Affine-type intrinsic errors. If “auto” is specified, then the corresponding error-type is extracted only if there is enough data to reliably infer them (i.e. enough data to construct “full rank” Jacobian matrices).

  • include_stochastic ({True,False,"auto"}) – Whether to extract Hamiltonian-, Stochastic-, and Affine-type intrinsic errors. If “auto” is specified, then the corresponding error-type is extracted only if there is enough data to reliably infer them (i.e. enough data to construct “full rank” Jacobian matrices).

  • include_affine ({True,False,"auto"}) – Whether to extract Hamiltonian-, Stochastic-, and Affine-type intrinsic errors. If “auto” is specified, then the corresponding error-type is extracted only if there is enough data to reliably infer them (i.e. enough data to construct “full rank” Jacobian matrices).

  • advanced_options (dict, optional) –

    A dictionary of optional advanced arguments which influence the way idle tomography is performed. Allowed keys are:

    • ”jacobian mode”: {“separate”,”together”} how to evaluate jacobians

    • ”preferred_prep_basis_signs” : 3-tuple of “+”/”-” or default=”auto”

    • ”preferred_meas_basis_signs” : 3-tuple of “+”/”-” or default=”auto”

    • ”pauli_fidpairs”: alternate list of pauli fiducial pairs to use

    • ”fit order” : integer order for polynomial fits to data

    • ”ham_tmpl” : see make_idle_tomography_list()

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

  • comm (mpi4py.MPI.Comm, optional) – When not None, an MPI communicator for distributing the computation across multiple processors.

Return type:

IdleTomographyResults