metric_completeness_validation Namespace Reference

Functions
def	_build_missing_field_map (cases, required_fields)
def	_missing_fields (payload, required_fields)
def	build_artifact_bundle (local_correctness_bundle, workflow_baseline_bundle, trace_anchor_bundle)
def	build_requirement_metadata ()
def	main ()
def	parse_args ()
def	run_validation
def	validate_artifact_bundle (bundle)
def	write_artifact_bundle

Variables
tuple	ARTIFACT_CORE_FIELDS
string	ARTIFACT_FILENAME = "metric_completeness_bundle.json"
tuple	DEFAULT_OUTPUT_DIR
	REPO_ROOT = Path(__file__).resolve().parents[3]
tuple	REQUIRED_MICRO_FIELDS
tuple	REQUIRED_TRACE_FIELDS
tuple	REQUIRED_WORKFLOW_FIELDS
string	SUITE_NAME = "metric_completeness_validation"

Detailed Description

Validation: metric-completeness gate.

Builds the phase-level metric-completeness gate from the delivered validation
evidence layers:
- local correctness bundle,
- workflow baseline bundle,
- trace-and-anchor bundle plus raw trace artifact.

The resulting bundle is intentionally a thin validation-evidence layer:
- it checks required internal-consistency fields on mandatory microcases,
- it checks required execution and performance fields on mandatory workflow
  cases,
- it checks the delivered trace artifact for required runtime and stability
  metadata,
- and it fails explicitly when required metrics are missing.

Run with:
python benchmarks/density_matrix/validation_evidence/metric_completeness_validation.py

Function Documentation

_build_missing_field_map()

def metric_completeness_validation._build_missing_field_map (   cases,   required_fields  )

private

Definition at line 107 of file metric_completeness_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

_missing_fields()

def metric_completeness_validation._missing_fields (   payload,   required_fields  )

private

Definition at line 103 of file metric_completeness_validation.py.

Here is the caller graph for this function:

build_artifact_bundle()

def metric_completeness_validation.build_artifact_bundle	(		local_correctness_bundle,
			workflow_baseline_bundle,
			trace_anchor_bundle
	)

Definition at line 120 of file metric_completeness_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_requirement_metadata()

def metric_completeness_validation.build_requirement_metadata

(

)

Definition at line 90 of file metric_completeness_validation.py.

Here is the caller graph for this function:

main()

def metric_completeness_validation.main

(

)

Definition at line 292 of file metric_completeness_validation.py.

Here is the call graph for this function:

parse_args()

def metric_completeness_validation.parse_args

(

)

Definition at line 263 of file metric_completeness_validation.py.

Here is the caller graph for this function:

run_validation()

def metric_completeness_validation.run_validation	(		qubit_sizes = EXACT_REGIME_WORKFLOW_QUBITS,
			parameter_set_count
	)

Definition at line 231 of file metric_completeness_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

validate_artifact_bundle()

def metric_completeness_validation.validate_artifact_bundle

(

bundle

)

Definition at line 210 of file metric_completeness_validation.py.

Here is the caller graph for this function:

write_artifact_bundle()

def metric_completeness_validation.write_artifact_bundle

(

output_path

)

Definition at line 220 of file metric_completeness_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

ARTIFACT_CORE_FIELDS

tuple metric_completeness_validation.ARTIFACT_CORE_FIELDS

Initial value:

=  (
    "suite_name",
    "status",
    "backend",
    "reference_backend",
    "requirements",
    "thresholds",
    "software",
    "summary",
    "required_artifacts",
)

Definition at line 51 of file metric_completeness_validation.py.

ARTIFACT_FILENAME

string metric_completeness_validation.ARTIFACT_FILENAME = "metric_completeness_bundle.json"

Definition at line 47 of file metric_completeness_validation.py.

DEFAULT_OUTPUT_DIR

tuple metric_completeness_validation.DEFAULT_OUTPUT_DIR

Initial value:

=  (
    REPO_ROOT / "benchmarks" / "density_matrix" / "artifacts" / "validation_evidence"
)

Definition at line 48 of file metric_completeness_validation.py.

REPO_ROOT

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

Definition at line 29 of file metric_completeness_validation.py.

REQUIRED_MICRO_FIELDS

tuple metric_completeness_validation.REQUIRED_MICRO_FIELDS

Initial value:

=  (
    "status",
    "energy_pass",
    "density_valid_pass",
    "trace_pass",
    "observable_pass",
)

Definition at line 62 of file metric_completeness_validation.py.

REQUIRED_TRACE_FIELDS

tuple metric_completeness_validation.REQUIRED_TRACE_FIELDS

Initial value:

=  (
    "status",
    "workflow_completed",
    "bridge_supported_pass",
    "total_trace_runtime_ms",
    "process_peak_rss_kb",
    "required_validation_trace",
)

Definition at line 80 of file metric_completeness_validation.py.

REQUIRED_WORKFLOW_FIELDS

tuple metric_completeness_validation.REQUIRED_WORKFLOW_FIELDS

Initial value:

=  (
    "status",
    "workflow_completed",
    "energy_pass",
    "density_valid_pass",
    "trace_pass",
    "observable_pass",
    "bridge_supported_pass",
    "total_case_runtime_ms",
    "process_peak_rss_kb",
)

Definition at line 69 of file metric_completeness_validation.py.

SUITE_NAME

string metric_completeness_validation.SUITE_NAME = "metric_completeness_validation"

Definition at line 46 of file metric_completeness_validation.py.