pygsti.algorithms.core.run_iterative_gst

pygsti.algorithms.core.run_iterative_gst#

run_iterative_gst(dataset, start_model, circuit_lists, optimizer, iteration_objfn_builders, final_objfn_builders, resource_alloc, verbosity=0)#

Performs Iterative Gate Set Tomography on the dataset.

Parameters:

  • dataset (DataSet) – The data used to generate MLGST gate estimates

  • start_model (Model) – The Model used as a starting point for the least-squares optimization.

  • circuit_lists (list of lists of (tuples or Circuits)) – The i-th element is a list of the circuits to be used in the i-th iteration of the optimization. Each element of these lists is a circuit, specified as either a Circuit object or as a tuple of operation labels (but all must be specified using the same type). e.g. [ [ (), (‘Gx’,) ], [ (), (‘Gx’,), (‘Gy’,) ], [ (), (‘Gx’,), (‘Gy’,), (‘Gx’,’Gy’) ] ]

  • optimizer (Optimizer or dict) – The optimizer to use, or a dictionary of optimizer parameters from which a default optimizer can be built.

  • iteration_objfn_builders (list) – List of ObjectiveFunctionBuilder objects defining which objective functions should be optimizized (successively) on each iteration.

  • final_objfn_builders (list) – List of ObjectiveFunctionBuilder objects defining which objective functions should be optimizized (successively) on the final iteration.

  • resource_alloc (ResourceAllocation) – A resource allocation object containing information about how to divide computation amongst multiple processors and any memory limits that should be imposed.

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

Returns:

  • models (list of Models) – list whose i-th element is the model corresponding to the results of the i-th iteration.

  • optimums (list of OptimizerResults) – list whose i-th element is the final optimizer result from that iteration.

  • final_objfn (MDSObjectiveFunction) – The final iteration’s objective function / store, which encapsulated the final objective function evaluated at the best-fit point (an “evaluated” model-dataSet-circuits store).