Create canonical ancestry three-backend release evidence — new_canonical_ancestry_three_backend

Binds one approved canonical dataset, an exact sample order, per-backend K-sweep evidence for ADMIXTURE, fastStructure, and sNMF, cross-backend Q-matrix comparisons at one selected K, and the cross-backend K-selection consensus, under the same proposed/approved review contract used by the `production_baseline` and `external_concordance` gates.

Usage

new_canonical_ancestry_three_backend_evidence(
  dataset_id,
  dataset_version,
  sample_ids,
  region,
  backend_evidence,
  cross_backend_comparisons,
  k_selection,
  selected_k,
  generated_by,
  generated_at,
  source_commit,
  approval = c("proposed", "approved"),
  approved_by = NULL,
  approved_at = NULL,
  notes = NULL
)

Arguments

dataset_id: Canonical dataset identifier.
dataset_version: Canonical dataset version.
sample_ids: Sample identifiers in exact Q-matrix row order.
region: Description of the genomic interval or scope analyzed.
backend_evidence: List of exactly three `PopgenVCFAncestryBackendEvidence` objects, one each for `admixture`, `faststructure`, and `snmf`.
cross_backend_comparisons: List of exactly three `PopgenVCFAncestryCrossBackendComparison` objects (one per backend pair) all at `selected_k`.
k_selection: A validated `PopgenVCFKSelection` object.
selected_k: K value the cross-backend comparisons were computed at.
generated_by: Non-empty description of the generating workflow.
generated_at: ISO-8601 UTC timestamp.
source_commit: Full 40-character Git commit SHA.
approval: One of `proposed` or `approved`.
approved_by: Reviewer identity; required when approved.
approved_at: ISO-8601 date; required when approved.
notes: Optional review notes.

Value

A validated `PopgenVCFCanonicalAncestryThreeBackendEvidence`.