From 739f723ebede2d6abb4c2a6fea5683d764b5463e Mon Sep 17 00:00:00 2001 From: Erik Nielsen Date: Tue, 14 Nov 2023 13:02:16 -0500 Subject: [PATCH 1/3] Erik adds some tagging during meeting with Riley. The ball is rolling!! --- pygsti/algorithms/compilers.py | 1 + pygsti/algorithms/contract.py | 1 + pygsti/algorithms/core.py | 1 + pygsti/algorithms/directx.py | 1 + pygsti/algorithms/fiducialpairreduction.py | 1 + 5 files changed, 5 insertions(+) diff --git a/pygsti/algorithms/compilers.py b/pygsti/algorithms/compilers.py index ac0c79331..c7ca7cac7 100644 --- a/pygsti/algorithms/compilers.py +++ b/pygsti/algorithms/compilers.py @@ -1,3 +1,4 @@ +## user-exposure: low (EGN) """ Clifford circuit, CNOT circuit, and stabilizer state/measurement generation compilation routines """ diff --git a/pygsti/algorithms/contract.py b/pygsti/algorithms/contract.py index c24f4f204..a358ab01c 100644 --- a/pygsti/algorithms/contract.py +++ b/pygsti/algorithms/contract.py @@ -1,3 +1,4 @@ +## user-exposure: minimal, forsaken (EGN) """ GST contraction algorithms """ diff --git a/pygsti/algorithms/core.py b/pygsti/algorithms/core.py index 44ecd95da..a607c6bc1 100644 --- a/pygsti/algorithms/core.py +++ b/pygsti/algorithms/core.py @@ -1,3 +1,4 @@ +## user-exposure: high (EGN - for "old"-style GST API e.g. run_gst_fit) """ Core GST algorithms """ diff --git a/pygsti/algorithms/directx.py b/pygsti/algorithms/directx.py index 13fd0fb09..a107d78df 100644 --- a/pygsti/algorithms/directx.py +++ b/pygsti/algorithms/directx.py @@ -1,3 +1,4 @@ +## user-exposure: minimal, forsaken (EGN - we don't use this anymore and never really did) """ Functions for generating Direct-(LGST, MC2GST, MLGST) models """ diff --git a/pygsti/algorithms/fiducialpairreduction.py b/pygsti/algorithms/fiducialpairreduction.py index 438e82ee8..c34310119 100644 --- a/pygsti/algorithms/fiducialpairreduction.py +++ b/pygsti/algorithms/fiducialpairreduction.py @@ -1,3 +1,4 @@ +## user-exposure: high (EGN - users use these functions for building GST experiment designs) """ Functions for reducing the number of required fiducial pairs for analysis. """ From 6565ad70bf846abc6f23d87783ec938c84b089e2 Mon Sep 17 00:00:00 2001 From: Corey Ostrove Date: Tue, 28 Nov 2023 14:15:34 -0700 Subject: [PATCH 2/3] Tag more of the algorithms module Add tagging to the top-levels of the rest of algorithms module. --- pygsti/algorithms/fiducialselection.py | 1 + pygsti/algorithms/gaugeopt.py | 1 + pygsti/algorithms/germselection.py | 1 + pygsti/algorithms/grammatrix.py | 1 + pygsti/algorithms/grasp.py | 1 + pygsti/algorithms/mirroring.py | 1 + pygsti/algorithms/randomcircuit.py | 1 + pygsti/algorithms/rbfit.py | 1 + pygsti/algorithms/robust_phase_estimation.py | 1 + pygsti/algorithms/scoring.py | 1 + 10 files changed, 10 insertions(+) diff --git a/pygsti/algorithms/fiducialselection.py b/pygsti/algorithms/fiducialselection.py index 39ff8d6de..ba84af086 100644 --- a/pygsti/algorithms/fiducialselection.py +++ b/pygsti/algorithms/fiducialselection.py @@ -1,3 +1,4 @@ +## user-exposure: high (CIO - users use these functions for building GST experiment designs) """ Functions for selecting a complete set of fiducials for a GST analysis. """ diff --git a/pygsti/algorithms/gaugeopt.py b/pygsti/algorithms/gaugeopt.py index fcd52d267..f5f2ddab3 100644 --- a/pygsti/algorithms/gaugeopt.py +++ b/pygsti/algorithms/gaugeopt.py @@ -1,3 +1,4 @@ +## user-exposure: low (CIO - manually gauge optimizing models is typically an advanced use case) """ GST gauge optimization algorithms """ diff --git a/pygsti/algorithms/germselection.py b/pygsti/algorithms/germselection.py index c2885690a..8c9e7b86b 100644 --- a/pygsti/algorithms/germselection.py +++ b/pygsti/algorithms/germselection.py @@ -1,3 +1,4 @@ +## user-exposure: high (CIO - users use these functions for building GST experiment designs) """ Functions for selecting a complete set of germs for a GST analysis. """ diff --git a/pygsti/algorithms/grammatrix.py b/pygsti/algorithms/grammatrix.py index d834cc546..675a112ff 100644 --- a/pygsti/algorithms/grammatrix.py +++ b/pygsti/algorithms/grammatrix.py @@ -1,3 +1,4 @@ +## user-exposure: minimal (CIO - Only presently utilized in creation of gram matrix spectrum plots in reports) """ Utility functions related to Gram matrix construction. """ diff --git a/pygsti/algorithms/grasp.py b/pygsti/algorithms/grasp.py index 5d70402c0..7f4a1f94f 100644 --- a/pygsti/algorithms/grasp.py +++ b/pygsti/algorithms/grasp.py @@ -1,3 +1,4 @@ +## user-exposure : minimal (Used internally in certain combinatorial optimization problems, but also less frequently nowadays) """ Functions to facilitate using GRASP. """ diff --git a/pygsti/algorithms/mirroring.py b/pygsti/algorithms/mirroring.py index 74dc2bcec..cde8a0138 100644 --- a/pygsti/algorithms/mirroring.py +++ b/pygsti/algorithms/mirroring.py @@ -1,3 +1,4 @@ +## user-exposure: low (Tentative, probably only used in RB internals, but check with Timothy or Jordan) """ circuit mirroring functions. """ diff --git a/pygsti/algorithms/randomcircuit.py b/pygsti/algorithms/randomcircuit.py index da4a42a8d..400bc681a 100644 --- a/pygsti/algorithms/randomcircuit.py +++ b/pygsti/algorithms/randomcircuit.py @@ -1,3 +1,4 @@ +## user-exposure: low (Tentative, probably only used in RB internals, but check with Jordan) """ Random circuit sampling functions. """ diff --git a/pygsti/algorithms/rbfit.py b/pygsti/algorithms/rbfit.py index ba54b3706..799788272 100644 --- a/pygsti/algorithms/rbfit.py +++ b/pygsti/algorithms/rbfit.py @@ -1,3 +1,4 @@ +## user-exposure: low (Tentative, probably only used in RB internals, but check with Jordan) """ Functions for analyzing RB data """ diff --git a/pygsti/algorithms/robust_phase_estimation.py b/pygsti/algorithms/robust_phase_estimation.py index c5ec90a86..e61f56d9b 100644 --- a/pygsti/algorithms/robust_phase_estimation.py +++ b/pygsti/algorithms/robust_phase_estimation.py @@ -1,3 +1,4 @@ +## user-exposure: low (Tentative, probably only used in RPE internals, but check with Kenny) """ Robust Phase Estimation platform agnostic portion """ diff --git a/pygsti/algorithms/scoring.py b/pygsti/algorithms/scoring.py index 7879088c2..a79591920 100644 --- a/pygsti/algorithms/scoring.py +++ b/pygsti/algorithms/scoring.py @@ -1,3 +1,4 @@ +## user-exposure: minimal (CIO- used internally in a number of experiment design related combinatorial optimization routines) """ Common functions used in scoring germ and fiducial sets. """ From 30bdf40594050a15184091ebf7abd2d08c522670 Mon Sep 17 00:00:00 2001 From: Corey Ostrove Date: Tue, 28 Nov 2023 19:46:59 -0700 Subject: [PATCH 3/3] Temporarily disable testing Temporarily disable the on-push unit testing in anticipation for many comment-only commits getting pushed to this branch. --- .github/workflows/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index fa5a4ba94..9d51b1a18 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -5,7 +5,7 @@ name: Build and run tests on: push: - branches-ignore: [ "beta" ] + branches-ignore: [ "beta", "user-exposure-tagging" ] # Hacky way to only run pull requests from forked repositories (assumes : is not used in branch names unless forked) # https://github.community/t/how-to-trigger-an-action-on-push-or-pull-request-but-not-both/16662/10 pull_request: