File size: 6,418 Bytes
ff95cf8
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
#!/usr/bin/env python3
"""Check a LiteRT GLiNER2 port against the original checkpoint on the bundled parity corpus.

    pip install gliner2==2.0.0 torch numpy ai-edge-litert
    python runtime/verify_parity.py --bundle .            # from the repository folder

Runs every corpus request twice, through gliner2 with the original weights (downloaded from Fastino at the pinned
revision) and through this repository's LiteRT runtime, and prints per call type how many structured results are
identical, the lowest span F1 and the largest confidence difference. The corpus (runtime/parity_corpus.json) is short
synthetic texts with schema templates for every call type gliner2 2.0.0 offers; it has no gold labels.
"""
from __future__ import annotations

import argparse
import collections
import json
import pathlib
import sys

HERE = pathlib.Path(__file__).resolve().parent
SOURCES = {"boundary": ("fastino/gliner2.5-base-v1", "1a8bc24e00dc7300b9017c81d63e3dcdabb26596"),
           "span": ("fastino/GLiNER2.5-Decide", "bbe10ff77ebb238777c17d3a8ac9260e30929057")}


def build_schema(t: dict):
    from gliner2 import AttributeGroup, Schema
    s = Schema()
    if "entities" in t:
        s.entities(t["entities"], dtype=t.get("dtype", "list"))
    if "attributes" in t:
        s.entity_attributes({k: AttributeGroup(labels=v["labels"], multi_label=v.get("multi_label", False)) for k, v in t["attributes"].items()})
    if "relations" in t:
        s.relations(t["relations"])
    for c in t.get("classifications", []):
        s.classification(c["task"], c["labels"], multi_label=c.get("multi_label", False))
    for st in t.get("structures", []):
        builder = s.structure(st["name"], mode=st.get("mode"), anchor=st.get("anchor"))
        for f in st["fields"]:
            builder.field(f["name"], dtype=f.get("dtype", "list"), choices=f.get("choices"))
    return s


def without_confidence(value):
    if isinstance(value, dict):
        return {k: without_confidence(v) for k, v in value.items() if k != "confidence"}
    if isinstance(value, list):
        return [without_confidence(v) for v in value]
    return value


def confidence_errors(reference, actual):
    if isinstance(reference, dict) and isinstance(actual, dict):
        out = []
        for key, value in reference.items():
            if key == "confidence" and key in actual:
                out.append(abs(float(value) - float(actual[key])))
            elif key in actual:
                out.extend(confidence_errors(value, actual[key]))
        return out
    if isinstance(reference, (list, tuple)) and isinstance(actual, (list, tuple)):
        return [e for a, b in zip(reference, actual) for e in confidence_errors(a, b)]
    return []


def answers(value, path: str = "") -> list[str]:
    out = []
    if isinstance(value, dict):
        if {"text", "start", "end"} <= set(value):
            return [f"{path}|{value['text']}|{value['start']}|{value['end']}"]
        if "head" in value and "tail" in value:
            return [f"{path}|H:{'/'.join(answers(value['head']))}|T:{'/'.join(answers(value['tail']))}"]
        if "label" in value:
            return [f"{path}|{value['label']}"]
        for key, item in value.items():
            if key != "confidence":
                out += answers(item, f"{path}.{key}" if path else key)
    elif isinstance(value, (list, tuple)):
        if len(value) == 2 and isinstance(value[0], str) and isinstance(value[1], float):
            return [f"{path}|{value[0]}"]
        for item in value:
            out += answers(item, path)
    elif value is not None:
        out.append(f"{path}|{value}")
    return out


def f1(reference: list[str], actual: list[str]) -> float:
    a, b = collections.Counter(reference), collections.Counter(actual)
    if not a and not b:
        return 1.0
    return 2 * sum((a & b).values()) / (sum(a.values()) + sum(b.values()))


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    parser.add_argument("--bundle", default=str(HERE.parent))
    parser.add_argument("--corpus", default=str(HERE / "parity_corpus.json"))
    args = parser.parse_args()
    sys.path.insert(0, str(HERE))
    import torch
    from gliner2 import AutoExtractor
    from huggingface_hub import snapshot_download
    config = json.loads((pathlib.Path(args.bundle) / "source" / "config.json").read_text())
    architecture = config.get("architecture", "span")
    if architecture == "boundary":
        from litert_boundary_runtime import LiteRTBoundaryExtractor as Runtime
    else:
        from litert_span_runtime import LiteRTSpanExtractor as Runtime
    repo, revision = SOURCES[architecture]
    native = AutoExtractor.from_pretrained(snapshot_download(repo, revision=revision), map_location="cpu").eval()
    torch.set_num_threads(4)
    runtime = Runtime(args.bundle)
    corpus = json.loads(pathlib.Path(args.corpus).read_text())
    by_kind = {}
    for group in corpus["groups"].values():
        for text in group["texts"]:
            for kind in group["templates"]:
                schema = build_schema(corpus["templates"][kind])
                expected = native.extract(text, schema, include_confidence=True, include_spans=True)
                k = by_kind.setdefault(kind, {"calls": 0, "identical": 0, "refused": 0, "minSpanF1": 1.0, "maxConfidenceDifference": 0.0})
                k["calls"] += 1
                try:
                    actual = runtime.extract(text, schema, include_confidence=True, include_spans=True)
                except ValueError:  # larger than the graphs' fixed sizes: refused, never truncated
                    k["refused"] += 1
                    continue
                k["identical"] += without_confidence(expected) == without_confidence(actual)
                k["minSpanF1"] = round(min(k["minSpanF1"], f1(answers(expected), answers(actual))), 4)
                k["maxConfidenceDifference"] = round(max([k["maxConfidenceDifference"], *confidence_errors(expected, actual)]), 6)
    for kind, k in by_kind.items():
        print(f"{kind:26s} {json.dumps(k)}")
    total = sum(k["calls"] - k["refused"] for k in by_kind.values())
    same = sum(k["identical"] for k in by_kind.values())
    print(f"identical structured results: {same} / {total}")
    return 0 if same == total else 1


if __name__ == "__main__":
    sys.exit(main())