pygsti.report.gateset_with_lgst_gatestring_estimates¶
-
pygsti.report.
gateset_with_lgst_gatestring_estimates
(gateStringsToEstimate, dataset, specs, targetGateset=None, includeTargetGates=True, spamDict=None, guessGatesetForGauge=None, gateStringLabels=None, svdTruncateTo=0, verbosity=0)¶ Constructs a gateset that contains LGST estimates for gateStringsToEstimate.
For each gate string s in gateStringsToEstimate, the constructed gateset contains the LGST estimate for s as separate gate, labeled either by the corresponding element of gateStringLabels or by the tuple of s itself.
Parameters: - gateStringsToEstimate (list of GateStrings or tuples) – The gate strings to estimate using LGST
- dataset (DataSet) – The data to use for LGST
- specs (2-tuple) – A (prepSpecs,effectSpecs) tuple usually generated by calling build_spam_specs(...)
- targetGateset (GateSet, optional) – The target gate set used by LGST to extract gate labels and an initial gauge
- includeTargetGates (bool, optional) – If True, the gate labels in targetGateset will be included in the returned gate set.
- spamDict (dict, optional) – Dictionary mapping (rhoVec_index,EVec_index) integer tuples to string spam labels. Defaults to the spam dictionary of targetGateset
- guessGatesetForGauge (GateSet, optional) – A gateset used to compute a gauge transformation that is applied to the LGST estimates. This gauge transformation is computed such that if the estimated gates matched the gateset given, then the gate matrices would match, i.e. the gauge would be the same as the gateset supplied. Defaults to the targetGateset.
- gateStringLabels (list of strings, optional) – A list of labels in one-to-one correspondence with the gate string in gateStringsToEstimate. These labels are the keys to access the gate matrices in the returned GateSet, i.e. gate_matrix = returned_gateset[gate_label]
- svdTruncateTo (int, optional) – The Hilbert space dimension to truncate the gate matrices to using a SVD to keep only the largest svdToTruncateTo singular values of the I_tildle LGST matrix. Defaults to no truncation.
- verbosity (int, optional) – Verbosity value to send to do_lgst(...) call.
Returns: A gateset containing LGST estimates for all the requested gate strings and possibly the gates in targetGateset.
Return type: Gateset