.. _measurement-op-gridoccupancy: GridOccupancy ============= Flag groups whose grid occupancy (filled cells / expected) is low. Parameters and usage: :py:class:`GridOccupancy `. - **Written to:** the frame ``analyze()`` returns; a CLI run stores it as one table in ``deliverables/qc/qc.duckdb`` - **Columns:** 6 .. _measurement-info-quality-occupancy: :doc:`QUALITY_OCCUPANCY ` --------------------------------------------------------------------------------- .. list-table:: Metric family: **QC_Occupancy** :header-rows: 1 :class: phenotypic-measurement-table * - Column - Description - Type * - ``QC_Occupancy_Filled`` - Distinct grid cells holding at least one colony (doublets count once). - :bdg-ref-secondary:`Quality ` * - ``QC_Occupancy_Expected`` - Expected grid-cell count from the metadata frame (rows per group). - :bdg-ref-secondary:`Quality ` * - ``QC_Occupancy_Vacant`` - Expected - Filled; empty/missing grid cells in the group. - :bdg-ref-secondary:`Quality ` :doc:`QUALITY_CHECK ` ------------------------------------------------------------------------- Every quality check writes these columns; see :ref:`measurement-shared-columns`. .. list-table:: Metric family: **QC** :header-rows: 1 :class: phenotypic-measurement-table * - Column - Description - Type * - ``QC_Occupancy_Flag`` - True when the metric crosses fail_threshold in the bad direction; eligible for curation. - :bdg-ref-secondary:`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. - :bdg-ref-secondary:`Quality ` * - ``QC_Occupancy_Status`` - Categorical: pass \| warn \| fail. - :bdg-ref-secondary:`Quality `