Skip to content

compare_numeric

elegua.compare_numeric

L4 numeric comparison — sample-point agreement within tolerance.

Factory function that creates a LayerFn closure capturing tolerance and minimum sample count configuration. Register the returned function as Layer 4 in a ComparisonPipeline.

make_numeric_comparator(tol=1e-06, min_samples=1)

Create an L4 numeric comparison function.

The returned function compares numeric_samples from both tokens: matching sample points (by variable values) must agree within tol. Returns MATH_MISMATCH if fewer than min_samples common points exist.

Parameters:

Name Type Description Default
tol float

Absolute tolerance for value comparison.

 1e-06
min_samples int

Minimum number of common sample points required.

 1
Source code in src/elegua/compare_numeric.py 
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
def make_numeric_comparator(tol: float = 1e-6, min_samples: int = 1) -> LayerFn:
    """Create an L4 numeric comparison function.

    The returned function compares ``numeric_samples`` from both tokens:
    matching sample points (by variable values) must agree within ``tol``.
    Returns MATH_MISMATCH if fewer than ``min_samples`` common points exist.

    Parameters:
        tol: Absolute tolerance for value comparison.
        min_samples: Minimum number of common sample points required.
    """

    def compare(token_a: ValidationToken, token_b: ValidationToken) -> TaskStatus:
        samples_a = _extract_samples(token_a.result)
        samples_b = _extract_samples(token_b.result)

        # Index samples by their variable-value key (skip non-numeric values)
        index_a = {
            _sample_key(s): s["value"]
            for s in samples_a
            if "value" in s and isinstance(s["value"], (int, float))
        }
        index_b = {
            _sample_key(s): s["value"]
            for s in samples_b
            if "value" in s and isinstance(s["value"], (int, float))
        }

        # Find common sample points
        common_keys = set(index_a) & set(index_b)

        if len(common_keys) < min_samples:
            return TaskStatus.MATH_MISMATCH

        # Check all common points agree within tolerance
        for key in common_keys:
            if abs(index_a[key] - index_b[key]) > tol:
                return TaskStatus.MATH_MISMATCH

        return TaskStatus.OK

    return compare