File size: 7,028 Bytes
003fe57
 
 
 
 
e845a2b
003fe57
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e845a2b
 
003fe57
 
 
 
 
 
 
 
 
 
 
 
 
 
e845a2b
 
 
003fe57
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
141
142
143
144
145
#!/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
    python runtime/verify_parity.py --bundle . --span gliner25_decide_span_wfp16.tflite --count gliner25_decide_count_wfp16.tflite

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"))
    parser.add_argument("--span", help="span architecture: the span file in place of the heads file's span_rep, count and classifier")
    parser.add_argument("--count", help="span architecture: the count file in place of the heads file's count_embed")
    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)
    if (args.span or args.count) and architecture != "span":
        parser.error("--span and --count apply to the span architecture only")
    runtime = Runtime(args.bundle, span=args.span, count=args.count) if architecture == "span" else 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())