Sequential Quantum Gate Decomposer  v1.9.6
Powerful decomposition of general unitarias into one- and two-qubit gates gates
Functions | Variables
matrix_baseline_validation Namespace Reference

Functions

def _enrich_case (case, workflow_contract)
 
def _load_end_to_end_trace_bundle
 
def _load_json
 
def _load_workflow_contract
 
def build_artifact_bundle (workflow_contract, end_to_end_trace_bundle, validation_workflow_baseline_bundle)
 
def build_case_identity_summary (cases, requirements)
 
def build_requirement_metadata (validation_workflow_baseline_bundle, workflow_contract)
 
def build_threshold_metadata (workflow_contract, validation_workflow_baseline_bundle)
 
def get_documented_anchor_qubit (workflow_contract)
 
def get_required_parameter_set_count (workflow_contract)
 
def get_required_workflow_qubits (workflow_contract)
 
def main ()
 
def parse_args ()
 
def run_validation
 
def validate_artifact_bundle (bundle)
 
def validate_case_payload (case)
 
def write_artifact_bundle
 

Variables

tuple ARTIFACT_CORE_FIELDS
 
string ARTIFACT_FILENAME = "matrix_baseline_bundle.json"
 
 DEFAULT_OUTPUT_DIR = WORKFLOW_EVIDENCE_OUTPUT_DIR
 
 END_TO_END_TRACE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / END_TO_END_TRACE_ARTIFACT_FILENAME
 
tuple MANDATORY_WORKFLOW_QUBITS = (4, 6, 8, 10)
 
int PARAMETER_SET_COUNT = 10
 
 REPO_ROOT = Path(__file__).resolve().parents[3]
 
string SUITE_NAME = "matrix_baseline_validation"
 
tuple VALIDATION_WORKFLOW_BASELINE_PATH
 
 WORKFLOW_CONTRACT_PATH = DEFAULT_OUTPUT_DIR / WORKFLOW_CONTRACT_ARTIFACT_FILENAME
 

Detailed Description

Validation: fixed-parameter matrix baseline.

Builds the fixed-parameter matrix gate from:
- the emitted canonical workflow contract,
- the emitted end-to-end trace bundle,
- and the committed validation workflow baseline bundle, which already contains
  the rich 4/6/8/10 fixed-parameter matrix evidence.

This layer is intentionally thin:
- it preserves one stable exact-regime matrix identity,
- it rebinds matrix cases to the canonical workflow ID and version,
- and it fails explicitly when required matrix identity or 10-qubit anchor
  evidence is incomplete.

Run with:
python benchmarks/density_matrix/workflow_evidence/matrix_baseline_validation.py

Function Documentation

◆ _enrich_case()

def matrix_baseline_validation._enrich_case (   case,
  workflow_contract 
)
private

Definition at line 246 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ _load_end_to_end_trace_bundle()

def matrix_baseline_validation._load_end_to_end_trace_bundle (   path)
private

Definition at line 94 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ _load_json()

def matrix_baseline_validation._load_json (   path)
private

Definition at line 81 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ _load_workflow_contract()

def matrix_baseline_validation._load_workflow_contract (   path)
private

Definition at line 85 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ build_artifact_bundle()

def matrix_baseline_validation.build_artifact_bundle (   workflow_contract,
  end_to_end_trace_bundle,
  validation_workflow_baseline_bundle 
)

Definition at line 259 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ build_case_identity_summary()

def matrix_baseline_validation.build_case_identity_summary (   cases,
  requirements 
)

Definition at line 189 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ build_requirement_metadata()

def matrix_baseline_validation.build_requirement_metadata (   validation_workflow_baseline_bundle,
  workflow_contract 
)

Definition at line 115 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ build_threshold_metadata()

def matrix_baseline_validation.build_threshold_metadata (   workflow_contract,
  validation_workflow_baseline_bundle 
)

Definition at line 135 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ get_documented_anchor_qubit()

def matrix_baseline_validation.get_documented_anchor_qubit (   workflow_contract)

Definition at line 111 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ get_required_parameter_set_count()

def matrix_baseline_validation.get_required_parameter_set_count (   workflow_contract)

Definition at line 107 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ get_required_workflow_qubits()

def matrix_baseline_validation.get_required_workflow_qubits (   workflow_contract)

Definition at line 103 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ main()

def matrix_baseline_validation.main ( )

Definition at line 543 of file matrix_baseline_validation.py.

Here is the call graph for this function:

◆ parse_args()

def matrix_baseline_validation.parse_args ( )

Definition at line 509 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ run_validation()

def matrix_baseline_validation.run_validation (   workflow_contract_path)

Definition at line 474 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ validate_artifact_bundle()

def matrix_baseline_validation.validate_artifact_bundle (   bundle)

Definition at line 384 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ validate_case_payload()

def matrix_baseline_validation.validate_case_payload (   case)

Definition at line 157 of file matrix_baseline_validation.py.

Here is the caller graph for this function:

◆ write_artifact_bundle()

def matrix_baseline_validation.write_artifact_bundle (   output_path)

Definition at line 464 of file matrix_baseline_validation.py.

Here is the call graph for this function:
Here is the caller graph for this function:

Variable Documentation

◆ ARTIFACT_CORE_FIELDS

tuple matrix_baseline_validation.ARTIFACT_CORE_FIELDS
Initial value:
1 = (
2  "suite_name",
3  "status",
4  "workflow_id",
5  "contract_version",
6  "backend",
7  "reference_backend",
8  "requirements",
9  "thresholds",
10  "software",
11  "provenance",
12  "summary",
13  "required_artifacts",
14  "cases",
15 )

Definition at line 64 of file matrix_baseline_validation.py.

◆ ARTIFACT_FILENAME

string matrix_baseline_validation.ARTIFACT_FILENAME = "matrix_baseline_bundle.json"

Definition at line 50 of file matrix_baseline_validation.py.

◆ DEFAULT_OUTPUT_DIR

matrix_baseline_validation.DEFAULT_OUTPUT_DIR = WORKFLOW_EVIDENCE_OUTPUT_DIR

Definition at line 51 of file matrix_baseline_validation.py.

◆ END_TO_END_TRACE_BUNDLE_PATH

matrix_baseline_validation.END_TO_END_TRACE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / END_TO_END_TRACE_ARTIFACT_FILENAME

Definition at line 53 of file matrix_baseline_validation.py.

◆ MANDATORY_WORKFLOW_QUBITS

tuple matrix_baseline_validation.MANDATORY_WORKFLOW_QUBITS = (4, 6, 8, 10)

Definition at line 62 of file matrix_baseline_validation.py.

◆ PARAMETER_SET_COUNT

int matrix_baseline_validation.PARAMETER_SET_COUNT = 10

Definition at line 63 of file matrix_baseline_validation.py.

◆ REPO_ROOT

matrix_baseline_validation.REPO_ROOT = Path(__file__).resolve().parents[3]

Definition at line 28 of file matrix_baseline_validation.py.

◆ SUITE_NAME

string matrix_baseline_validation.SUITE_NAME = "matrix_baseline_validation"

Definition at line 49 of file matrix_baseline_validation.py.

◆ VALIDATION_WORKFLOW_BASELINE_PATH

tuple matrix_baseline_validation.VALIDATION_WORKFLOW_BASELINE_PATH
Initial value:
1 = (
2  REPO_ROOT
3  / "benchmarks"
4  / "density_matrix"
5  / "artifacts"
6  / "validation_evidence"
7  / "workflow_baseline_bundle.json"
8 )

Definition at line 54 of file matrix_baseline_validation.py.

◆ WORKFLOW_CONTRACT_PATH

matrix_baseline_validation.WORKFLOW_CONTRACT_PATH = DEFAULT_OUTPUT_DIR / WORKFLOW_CONTRACT_ARTIFACT_FILENAME

Definition at line 52 of file matrix_baseline_validation.py.