workflow_contract_validation Namespace Reference

Functions
def	_contract_sections_complete (artifact)
def	_get_package_version
def	_load_reference_validation_bundle
def	build_artifact_bundle (reference_bundle)
def	build_boundary_classification ()
def	build_hamiltonian_metadata ()
def	build_input_contract ()
def	build_open_chain_topology
def	build_optimizer_config ()
def	build_output_contract ()
def	build_reference_artifacts (reference_bundle)
def	build_reference_noise ()
def	build_requirement_metadata (reference_bundle)
def	build_software_metadata ()
def	build_threshold_metadata ()
def	get_git_revision ()
def	main ()
def	parse_args ()
def	run_validation
def	validate_artifact_bundle (artifact)
def	write_artifact_bundle

Variables
tuple	ARTIFACT_CORE_FIELDS
string	ARTIFACT_FILENAME = "workflow_contract_bundle.json"
tuple	BOUNDARY_CLASS_NAMES = ("supported", "optional", "deferred", "unsupported")
string	CONTRACT_VERSION = "v1"
string	DEFAULT_ANSATZ = "HEA"
int	DEFAULT_INNER_BLOCKS = 1
int	DEFAULT_LAYERS = 1
tuple	DEFAULT_OUTPUT_DIR
int	EXACT_REGIME_PARAMETER_SET_COUNT = 10
tuple	EXACT_REGIME_WORKFLOW_QUBITS = (4, 6, 8, 10)
tuple	FIXED_PARAMETER_QUBITS = (4, 6)
int	OBSERVABLE_IMAG_TOL = 1e-10
string	PRIMARY_BACKEND = "density_matrix"
string	REFERENCE_BACKEND = "qiskit_aer_density_matrix"
	REPO_ROOT = Path(__file__).resolve().parents[3]
float	REQUIRED_PASS_RATE = 1.0
tuple	STATUS_VOCABULARY = ("pass", "fail", "incomplete", "completed", "unsupported")
string	SUITE_NAME = "workflow_contract_validation"
tuple	THRESHOLD_CORE_FIELDS
int	TRACE_TOL = 1e-10
tuple	VALIDATION_EVIDENCE_REFERENCE_BUNDLE_PATH
int	VALIDITY_TOL = 1e-10
int	WORKFLOW_ERROR_TOL = 1e-8
string	WORKFLOW_ID = "phase2_xxz_hea_density_matrix_anchor_workflow"

Detailed Description

Validation: canonical workflow contract.

Builds a machine-readable contract artifact for the canonical Phase 2 noisy
workflow. This is intentionally a thin contract layer:
- it freezes one stable workflow ID and contract version,
- it defines explicit input and output contract sections,
- it records supported / optional / deferred / unsupported workflow boundaries,
- and it links those contract sections back to the delivered validation-evidence
  inventory without re-running the full validation stack.

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

Function Documentation

_contract_sections_complete()

def workflow_contract_validation._contract_sections_complete (   artifact )

private

Definition at line 447 of file workflow_contract_validation.py.

Here is the caller graph for this function:

_get_package_version()

def workflow_contract_validation._get_package_version (   name )

private

Definition at line 138 of file workflow_contract_validation.py.

Here is the caller graph for this function:

_load_reference_validation_bundle()

def workflow_contract_validation._load_reference_validation_bundle (   reference_path )

private

Definition at line 169 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_artifact_bundle()

def workflow_contract_validation.build_artifact_bundle

(

reference_bundle

)

Definition at line 465 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_boundary_classification()

def workflow_contract_validation.build_boundary_classification

(

)

Definition at line 372 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_hamiltonian_metadata()

def workflow_contract_validation.build_hamiltonian_metadata

(

)

Definition at line 129 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_input_contract()

def workflow_contract_validation.build_input_contract

(

)

Definition at line 244 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_open_chain_topology()

def workflow_contract_validation.build_open_chain_topology

(

qbit_num

)

Definition at line 117 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_optimizer_config()

def workflow_contract_validation.build_optimizer_config

(

)

Definition at line 121 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_output_contract()

def workflow_contract_validation.build_output_contract

(

)

Definition at line 306 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_reference_artifacts()

def workflow_contract_validation.build_reference_artifacts

(

reference_bundle

)

Definition at line 429 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_reference_noise()

def workflow_contract_validation.build_reference_noise

(

)

Definition at line 94 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_requirement_metadata()

def workflow_contract_validation.build_requirement_metadata

(

reference_bundle

)

Definition at line 183 of file workflow_contract_validation.py.

Here is the caller graph for this function:

build_software_metadata()

def workflow_contract_validation.build_software_metadata

(

)

Definition at line 145 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_threshold_metadata()

def workflow_contract_validation.build_threshold_metadata

(

)

Definition at line 230 of file workflow_contract_validation.py.

Here is the caller graph for this function:

get_git_revision()

def workflow_contract_validation.get_git_revision

(

)

Definition at line 154 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

main()

def workflow_contract_validation.main

(

)

Definition at line 666 of file workflow_contract_validation.py.

Here is the call graph for this function:

parse_args()

def workflow_contract_validation.parse_args

(

)

Definition at line 644 of file workflow_contract_validation.py.

Here is the caller graph for this function:

run_validation()

def workflow_contract_validation.run_validation	(		verbose = False,
			reference_bundle_path
	)

Definition at line 628 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

validate_artifact_bundle()

def workflow_contract_validation.validate_artifact_bundle

(

artifact

)

Definition at line 518 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

write_artifact_bundle()

def workflow_contract_validation.write_artifact_bundle

(

output_path

)

Definition at line 617 of file workflow_contract_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

ARTIFACT_CORE_FIELDS

tuple workflow_contract_validation.ARTIFACT_CORE_FIELDS

Initial value:

=  (
    "suite_name",
    "status",
    "workflow_id",
    "contract_version",
    "backend",
    "reference_backend",
    "requirements",
    "thresholds",
    "input_contract",
    "output_contract",
    "boundary_classification",
    "reference_artifacts",
    "software",
    "provenance",
    "summary",
)

Definition at line 64 of file workflow_contract_validation.py.

ARTIFACT_FILENAME

string workflow_contract_validation.ARTIFACT_FILENAME = "workflow_contract_bundle.json"

Definition at line 48 of file workflow_contract_validation.py.

BOUNDARY_CLASS_NAMES

tuple workflow_contract_validation.BOUNDARY_CLASS_NAMES = ("supported", "optional", "deferred", "unsupported")

Definition at line 63 of file workflow_contract_validation.py.

CONTRACT_VERSION

string workflow_contract_validation.CONTRACT_VERSION = "v1"

Definition at line 61 of file workflow_contract_validation.py.

DEFAULT_ANSATZ

string workflow_contract_validation.DEFAULT_ANSATZ = "HEA"

Definition at line 35 of file workflow_contract_validation.py.

DEFAULT_INNER_BLOCKS

int workflow_contract_validation.DEFAULT_INNER_BLOCKS = 1

Definition at line 37 of file workflow_contract_validation.py.

DEFAULT_LAYERS

int workflow_contract_validation.DEFAULT_LAYERS = 1

Definition at line 36 of file workflow_contract_validation.py.

DEFAULT_OUTPUT_DIR

tuple workflow_contract_validation.DEFAULT_OUTPUT_DIR

Initial value:

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

Definition at line 49 of file workflow_contract_validation.py.

EXACT_REGIME_PARAMETER_SET_COUNT

int workflow_contract_validation.EXACT_REGIME_PARAMETER_SET_COUNT = 10

Definition at line 40 of file workflow_contract_validation.py.

EXACT_REGIME_WORKFLOW_QUBITS

tuple workflow_contract_validation.EXACT_REGIME_WORKFLOW_QUBITS = (4, 6, 8, 10)

Definition at line 39 of file workflow_contract_validation.py.

FIXED_PARAMETER_QUBITS

tuple workflow_contract_validation.FIXED_PARAMETER_QUBITS = (4, 6)

Definition at line 38 of file workflow_contract_validation.py.

OBSERVABLE_IMAG_TOL

int workflow_contract_validation.OBSERVABLE_IMAG_TOL = 1e-10

Definition at line 44 of file workflow_contract_validation.py.

PRIMARY_BACKEND

string workflow_contract_validation.PRIMARY_BACKEND = "density_matrix"

Definition at line 33 of file workflow_contract_validation.py.

REFERENCE_BACKEND

string workflow_contract_validation.REFERENCE_BACKEND = "qiskit_aer_density_matrix"

Definition at line 34 of file workflow_contract_validation.py.

REPO_ROOT

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

Definition at line 27 of file workflow_contract_validation.py.

REQUIRED_PASS_RATE

float workflow_contract_validation.REQUIRED_PASS_RATE = 1.0

Definition at line 45 of file workflow_contract_validation.py.

STATUS_VOCABULARY

tuple workflow_contract_validation.STATUS_VOCABULARY = ("pass", "fail", "incomplete", "completed", "unsupported")

Definition at line 62 of file workflow_contract_validation.py.

SUITE_NAME

string workflow_contract_validation.SUITE_NAME = "workflow_contract_validation"

Definition at line 47 of file workflow_contract_validation.py.

THRESHOLD_CORE_FIELDS

tuple workflow_contract_validation.THRESHOLD_CORE_FIELDS

Initial value:

=  (
    "absolute_energy_error",
    "rho_is_valid_tol",
    "trace_deviation",
    "observable_imag_abs",
    "required_pass_rate",
    "required_end_to_end_qubits",
    "required_workflow_qubits",
    "fixed_parameter_sets_per_size",
    "documented_anchor_qubit",
)

Definition at line 81 of file workflow_contract_validation.py.

TRACE_TOL

int workflow_contract_validation.TRACE_TOL = 1e-10

Definition at line 43 of file workflow_contract_validation.py.

VALIDATION_EVIDENCE_REFERENCE_BUNDLE_PATH

tuple workflow_contract_validation.VALIDATION_EVIDENCE_REFERENCE_BUNDLE_PATH

Initial value:

=  (
    REPO_ROOT
    / "benchmarks"
    / "density_matrix"
    / "artifacts"
    / "validation_evidence"
    / "validation_evidence_publication_bundle.json"
)

Definition at line 52 of file workflow_contract_validation.py.

VALIDITY_TOL

int workflow_contract_validation.VALIDITY_TOL = 1e-10

Definition at line 42 of file workflow_contract_validation.py.

WORKFLOW_ERROR_TOL

int workflow_contract_validation.WORKFLOW_ERROR_TOL = 1e-8

Definition at line 41 of file workflow_contract_validation.py.

WORKFLOW_ID

string workflow_contract_validation.WORKFLOW_ID = "phase2_xxz_hea_density_matrix_anchor_workflow"

Definition at line 60 of file workflow_contract_validation.py.