GridOccupancy#

Flag groups whose grid occupancy (filled cells / expected) is low.

Parameters and usage: GridOccupancy.

  • Written to: the frame analyze() returns; a CLI run stores it as one table in deliverables/qc/qc.duckdb

  • Columns: 6

QUALITY_OCCUPANCY#

Metric family: QC_Occupancy#

Column

Description

Type

QC_Occupancy_Filled

Distinct grid cells holding at least one colony (doublets count once).

Quality

QC_Occupancy_Expected

Expected grid-cell count from the metadata frame (rows per group).

Quality

QC_Occupancy_Vacant

Expected - Filled; empty/missing grid cells in the group.

Quality

QUALITY_CHECK#

Every quality check writes these columns; see Shared columns.

Metric family: QC#

Column

Description

Type

QC_Occupancy_Flag

True when the metric crosses fail_threshold in the bad direction; eligible for curation.

Quality

QC_Occupancy_Metric

Headline metric in the check’s own units; the bad direction is set by the check’s _HIGHER_IS_BAD flag. Drives Status.

Quality

QC_Occupancy_Status

Categorical: pass | warn | fail.

Quality