1 oracle.pipelines.admission_evidence

oracle.pipelines.admission_evidence

Fail-closed, presentation-free views of campaign admission audits.

The campaign writer owns the audit format. This module only validates and reduces the immutable JSON artifact; it does not re-run target matching or infer detector-quality metrics which the audit cannot support.

1.1 Classes

Name Description
AdmissionAuditRow Validated additive facts for one observed-target audit row.
AdmissionEvidenceSummary Deterministic rows suitable for plots, cards, and exports.

1.1.1 AdmissionAuditRow

oracle.pipelines.admission_evidence.AdmissionAuditRow(
    sample_key,
    scene_id,
    target_id,
    reason,
    admitted,
    oriented_iou,
    gt_match_id,
    qualified_gt_match_count,
    detected_source_row,
    row_kind='observed_target',
    observed_target_count=1,
)

Validated additive facts for one observed-target audit row.

1.1.1.1 Methods

Name Description
to_jsonable Return the validated factual row for exports and presentation.
1.1.1.1.1 to_jsonable
oracle.pipelines.admission_evidence.AdmissionAuditRow.to_jsonable()

Return the validated factual row for exports and presentation.

1.1.2 AdmissionEvidenceSummary

oracle.pipelines.admission_evidence.AdmissionEvidenceSummary(
    rows,
    reason_rows,
    iou_rows,
    scene_rows,
    duplicate_gt_rows,
    campaign_id,
    source_manifest_hash,
    admission_audit_hash,
)

Deterministic rows suitable for plots, cards, and exports.

1.1.2.1 Attributes

Name Description
sample_count Return unique audited source samples, including zero-observation sentinels.
scene_count Return unique audited source scenes.
same_class_scored_count Return targets for which a finite same-class overlap was scored.

1.1.2.2 Methods

Name Description
to_jsonable Return validated audit evidence without re-reading the artifact.
1.1.2.2.1 to_jsonable
oracle.pipelines.admission_evidence.AdmissionEvidenceSummary.to_jsonable()

Return validated audit evidence without re-reading the artifact.

1.2 Functions

Name Description
read_campaign_admission_evidence Validate and summarize one supported campaign admission audit.

1.2.1 read_campaign_admission_evidence

oracle.pipelines.admission_evidence.read_campaign_admission_evidence(
    source,
    *,
    expected_campaign_id=None,
    expected_source_manifest_hash=None,
    expected_audit_hash=None,
)

Validate and summarize one supported campaign admission audit.

The function deliberately fails closed: malformed top-level metadata, tampered rows, impossible IoU values, and inconsistent admission states raise :class:ValueError before any summary is returned. A mapping input is useful for callers that already loaded an artifact; path input remains the normal presentation-free boundary.

Back to top