Struct GridDoubt 

pub struct GridDoubt {
    pub thin_rows: usize,
    pub fill: f64,
    pub retried_from: usize,
    pub full_rows: usize,
    pub columns: usize,
}

What the heuristic table builder had to go on (#574).

The builder knows when it is guessing, and until now it threw that away: the fill ratio was computed and reduced to a pass, and the rest was never recorded. These are the facts it has at the moment it decides, for two consumers – a caller deciding whether to send a page to a vision model (#624), and the learned structure model of #600 deciding whether it may overrule the grid.

NOT COLLAPSED INTO A SCORE, which is why there are five numbers and not one. A weighted worst-of-five would be a hand-made value that reads as a measurement, and nobody could test which part of it was wrong. Each of these is a fact with a unit, and each consumer writes its own rule over them where the rule can be read and argued with. If a scalar is ever wanted, it can be fitted against an outcome and say what it was fitted on.

A PROPERTY OF THE TABLE, not of the cell that carries it. Every cell of one table reports the same value, because a cell is where a model looks and a consumer holding the cells has no other handle on the table they came from.

Fields

thin_rows: usize

How many rows were admitted with too few runs of ink to be a row on their own, through the rule that lets a section head stand inside a table (#576). Each is a row the builder kept on the strength of its neighbours rather than of its own shape.

fill: f64

The share of the grid’s cells the page drew ink in, between 0 and 1. MIN_FILL is the floor a table has to clear, so a grid barely above it is one the builder nearly refused.

retried_from: usize

Which attempt produced the grid: 0 for the run’s own first row, 1 or 2 where the first rows had to be trimmed. Above 0 means the first candidate was not a grid.

full_rows: usize

How many rows have ink in every column, which is what the column boundaries are derived from. A table whose bounds rest on one full row has almost no evidence for where its columns are.

columns: usize

How many columns the grid has. Every fact above means something different in a two-column table than in a nine-column one, so the scale travels with them rather than being guessed at by the consumer.

Trait Implementations

impl Clone for GridDoubt

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for GridDoubt

impl Debug for GridDoubt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GridDoubt

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for GridDoubt

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for GridDoubt