From c489c4cb8d0b60942fc9933d9cecef479623b5b1 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 1 Oct 2026 18:35:05 +0200 Subject: [PATCH 01/39] ci: install dependencies on Python 3.11-3.13 Select NumPy 2 on Python 3.13, pin the docdata wheel that the index intermittently fails to serve, check installed requirements, run mypy for each matrix version, and let the matrix finish after a failure. --- .github/ci-constraints.txt | 2 ++ .github/workflows/github-actions-python-package.yml | 11 ++++++++--- dicee/evaluation/_filtering.py | 4 ++-- requirements.txt | 5 +++-- setup.py | 3 ++- 5 files changed, 17 insertions(+), 8 deletions(-) create mode 100644 .github/ci-constraints.txt diff --git a/.github/ci-constraints.txt b/.github/ci-constraints.txt new file mode 100644 index 000000000..240dd8aa7 --- /dev/null +++ b/.github/ci-constraints.txt @@ -0,0 +1,2 @@ +# Official wheel bypasses intermittent HTTP 503 responses from the docdata index. +docdata @ https://files.pythonhosted.org/packages/20/d6/ffc73563941fea7bc2bc5c0afe425d5b24a2a4c2348693125cb061fe4425/docdata-0.0.5-py3-none-any.whl#sha256=7e54713b4fe8d87b6483cafa83a6f119344a4f3163799de08b8cb97436a215be diff --git a/.github/workflows/github-actions-python-package.yml b/.github/workflows/github-actions-python-package.yml index cbab436b8..f63d15a1c 100644 --- a/.github/workflows/github-actions-python-package.yml +++ b/.github/workflows/github-actions-python-package.yml @@ -6,6 +6,7 @@ jobs: runs-on: ubuntu-latest strategy: + fail-fast: false matrix: python-version: ["3.11", "3.12", "3.13"] @@ -18,8 +19,8 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install -e .["dev"] --extra-index-url https://download.pytorch.org/whl/cpu - pip install mypy + python -m pip install -e ".[dev]" -c .github/ci-constraints.txt --extra-index-url https://download.pytorch.org/whl/cpu + python -m pip check - name: Lint with ruff run: | @@ -34,8 +35,12 @@ jobs: # add fresh type errors while existing debt is paid down gradually. # If you fix errors, lower .github/mypy-baseline.txt to lock in the # improvement; only raise it if a change unavoidably adds errors. - mypy dicee/ --config-file=pyproject.toml > mypy_output.txt 2>&1 || true + MYPY_EXIT=0 + mypy dicee/ --config-file=pyproject.toml --python-version "${{ matrix.python-version }}" > mypy_output.txt 2>&1 || MYPY_EXIT=$? cat mypy_output.txt + if [ "$MYPY_EXIT" -gt 1 ]; then + exit "$MYPY_EXIT" + fi CURRENT_ERRORS=$(grep -oP 'Found \K[0-9]+(?= errors?)' mypy_output.txt || echo 0) BASELINE_ERRORS=$(cat .github/mypy-baseline.txt) echo "mypy errors: $CURRENT_ERRORS (baseline: $BASELINE_ERRORS)" diff --git a/dicee/evaluation/_filtering.py b/dicee/evaluation/_filtering.py index ee13c6cb0..283b21b12 100644 --- a/dicee/evaluation/_filtering.py +++ b/dicee/evaluation/_filtering.py @@ -52,7 +52,7 @@ def rank(self, predictions: torch.Tensor, target_idx: SupportsInt, if exclude_target: filters.discard(target_idx) if filters: - filtered[list(filters)] = -np.Inf + filtered[list(filters)] = -np.inf if self.tie_policy == "sort": # Preserve DICE's original per-vector torch.sort ordering. @@ -90,7 +90,7 @@ def rank_batch(self, predictions: torch.Tensor, target_indices: Iterable[Support for i, (target, filters) in enumerate(zip(target_indices, filter_indices_list)): target = int(target) if len(filters): - filtered[i, list(filters)] = -np.Inf + filtered[i, list(filters)] = -np.inf filtered[i, target] = predictions[i, target] order = torch.sort(filtered, dim=1, descending=True).indices return [int(torch.where(row == int(target))[0].item()) + 1 diff --git a/requirements.txt b/requirements.txt index 4dcf3061a..5c985d4df 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,7 +1,8 @@ # Core dependencies # NOTE: For CPU-only installation (no NVIDIA CUDA dependencies), use: # pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cpu -numpy==1.26.4 +numpy==1.26.4; python_version < '3.13' +numpy>=2.1,<3; python_version >= '3.13' torch>=2.5.1 lightning>=2.5.0.post0 pandas>=2.1.0 @@ -28,4 +29,4 @@ myst-parser>=2.0.0 sphinx_rtd_theme>=2.0.0 sphinx-theme>=1.0 sphinxcontrib-plantuml>=0.27 -plantuml-local-client>=1.2022.6 \ No newline at end of file +plantuml-local-client>=1.2022.6 diff --git a/setup.py b/setup.py index 05c0572fa..4bef16b25 100644 --- a/setup.py +++ b/setup.py @@ -13,7 +13,8 @@ # Core dependencies (includes torch and lightning) # Use --extra-index-url https://download.pytorch.org/whl/cpu for CPU-only installation _core_deps = [ - "numpy==1.26.4", + "numpy==1.26.4; python_version < '3.13'", + "numpy>=2.1,<3; python_version >= '3.13'", "torch>=2.5.1", "lightning>=2.5.0.post0", "pandas>=2.1.0", From 45f7932c3288d78d0f6a1369579624359244554c Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 1 Oct 2026 18:35:35 +0200 Subject: [PATCH 02/39] feat(query_answering): complex query answering with score adapters Answer path, intersection, union and negated queries over KGEs and the ULTRA, TRIX and Flock foundation models with CQD beam search, optionally calibrated by score adapters fitted on source graphs with frozen backbones. Native UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE and CLMPT load the released checkpoints and are tested against fixtures exported from the pinned upstream code. Evaluation reads the released UltraQuery and +H files, filters easy and hard answers, scores ties by sort order and by their exact expectation, and resumes from verified checkpoints. Deterministic message passing splits hub nodes into order-preserving partial sums, ordered reductions prefetch edges, and device-side checks replace per-query host synchronization; predictions are bitwise unchanged. --- .github/mypy-baseline.txt | 2 +- CHANGELOG.md | 3 + README.md | 84 ++- dicee/knowledge_graph_embeddings.py | 634 ++--------------- dicee/models/_fused_message.py | 22 +- dicee/models/_inference.py | 59 +- dicee/models/_triton_message.py | 114 +-- dicee/models/flock.py | 54 ++ dicee/models/graph_model.py | 24 +- dicee/models/trix.py | 12 +- dicee/models/ultra.py | 10 +- dicee/query_answering/__init__.py | 14 + dicee/query_answering/__main__.py | 103 +++ dicee/query_answering/_adapter_cache.py | 219 ++++++ dicee/query_answering/_checkpoint.py | 112 +++ dicee/query_answering/_deferred.py | 52 ++ dicee/query_answering/_query.py | 229 ++++++ dicee/query_answering/_rank_trace.py | 46 ++ dicee/query_answering/adapter_training.py | 576 +++++++++++++++ dicee/query_answering/benchmark.py | 665 ++++++++++++++++++ dicee/query_answering/catalog.py | 143 ++++ dicee/query_answering/context.py | 168 +++++ dicee/query_answering/datasets.py | 327 +++++++++ dicee/query_answering/engine.py | 352 +++++++++ dicee/query_answering/method_evaluation.py | 359 ++++++++++ dicee/query_answering/methods/NOTICE.md | 77 ++ dicee/query_answering/methods/__init__.py | 12 + .../methods/_bounded_attention.py | 36 + dicee/query_answering/methods/_common.py | 176 +++++ .../methods/_ordered_aggregation.py | 52 ++ .../methods/_ordered_aggregation_cpu.py | 116 +++ .../methods/_ordered_aggregation_cuda.py | 106 +++ dicee/query_answering/methods/checkpoints.py | 216 ++++++ dicee/query_answering/methods/clmpt.py | 183 +++++ dicee/query_answering/methods/cone.py | 130 ++++ dicee/query_answering/methods/cqd.py | 191 +++++ dicee/query_answering/methods/gnnqe.py | 119 ++++ dicee/query_answering/methods/heuristic.py | 58 ++ dicee/query_answering/methods/qto.py | 69 ++ dicee/query_answering/methods/ultraquery.py | 66 ++ dicee/query_answering/score_adapter.py | 227 ++++++ dicee/query_generator.py | 77 +- dicee/scripts/evaluate_query_methods.py | 42 ++ dicee/scripts/run.py | 2 +- dicee/trainer/torch_trainer_ddp.py | 3 +- docs/guides/multi_hop_queries.md | 65 +- tests/fixtures/query_baselines/README.md | 66 ++ tests/fixtures/query_baselines/clmpt.pt | Bin 0 -> 45693 bytes tests/fixtures/query_baselines/cone.pt | Bin 0 -> 16569 bytes .../fixtures/query_baselines/cqd-negation.pt | Bin 0 -> 11577 bytes tests/fixtures/query_baselines/cqd.pt | Bin 0 -> 18755 bytes .../generate_negation_reference.py | 74 ++ .../query_baselines/generate_reference.py | 301 ++++++++ tests/fixtures/query_baselines/gnnqe.pt | Bin 0 -> 35341 bytes tests/fixtures/query_baselines/qto.pt | Bin 0 -> 7814 bytes tests/fixtures/query_baselines/ultra.pt | Bin 0 -> 1434475 bytes tests/test_inference_kernels.py | 312 ++++++++ tests/test_query_baselines.py | 316 +++++++++ tests/test_query_benchmark.py | 384 ++++++++++ tests/test_query_engine.py | 516 ++++++++++++++ tests/test_unit_kge_inference.py | 36 +- 61 files changed, 7671 insertions(+), 740 deletions(-) create mode 100644 dicee/query_answering/__init__.py create mode 100644 dicee/query_answering/__main__.py create mode 100644 dicee/query_answering/_adapter_cache.py create mode 100644 dicee/query_answering/_checkpoint.py create mode 100644 dicee/query_answering/_deferred.py create mode 100644 dicee/query_answering/_query.py create mode 100644 dicee/query_answering/_rank_trace.py create mode 100644 dicee/query_answering/adapter_training.py create mode 100644 dicee/query_answering/benchmark.py create mode 100644 dicee/query_answering/catalog.py create mode 100644 dicee/query_answering/context.py create mode 100644 dicee/query_answering/datasets.py create mode 100644 dicee/query_answering/engine.py create mode 100644 dicee/query_answering/method_evaluation.py create mode 100644 dicee/query_answering/methods/NOTICE.md create mode 100644 dicee/query_answering/methods/__init__.py create mode 100644 dicee/query_answering/methods/_bounded_attention.py create mode 100644 dicee/query_answering/methods/_common.py create mode 100644 dicee/query_answering/methods/_ordered_aggregation.py create mode 100644 dicee/query_answering/methods/_ordered_aggregation_cpu.py create mode 100644 dicee/query_answering/methods/_ordered_aggregation_cuda.py create mode 100644 dicee/query_answering/methods/checkpoints.py create mode 100644 dicee/query_answering/methods/clmpt.py create mode 100644 dicee/query_answering/methods/cone.py create mode 100644 dicee/query_answering/methods/cqd.py create mode 100644 dicee/query_answering/methods/gnnqe.py create mode 100644 dicee/query_answering/methods/heuristic.py create mode 100644 dicee/query_answering/methods/qto.py create mode 100644 dicee/query_answering/methods/ultraquery.py create mode 100644 dicee/query_answering/score_adapter.py create mode 100644 dicee/scripts/evaluate_query_methods.py create mode 100644 tests/fixtures/query_baselines/README.md create mode 100644 tests/fixtures/query_baselines/clmpt.pt create mode 100644 tests/fixtures/query_baselines/cone.pt create mode 100644 tests/fixtures/query_baselines/cqd-negation.pt create mode 100644 tests/fixtures/query_baselines/cqd.pt create mode 100644 tests/fixtures/query_baselines/generate_negation_reference.py create mode 100644 tests/fixtures/query_baselines/generate_reference.py create mode 100644 tests/fixtures/query_baselines/gnnqe.pt create mode 100644 tests/fixtures/query_baselines/qto.pt create mode 100644 tests/fixtures/query_baselines/ultra.pt create mode 100644 tests/test_inference_kernels.py create mode 100644 tests/test_query_baselines.py create mode 100644 tests/test_query_benchmark.py create mode 100644 tests/test_query_engine.py diff --git a/.github/mypy-baseline.txt b/.github/mypy-baseline.txt index 15c1c7c63..7fdcfb8c0 100644 --- a/.github/mypy-baseline.txt +++ b/.github/mypy-baseline.txt @@ -1 +1 @@ -1172 +1131 diff --git a/CHANGELOG.md b/CHANGELOG.md index b0d5a3e55..33ede325f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,9 +17,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Sharded checkpoint save/resume for the `torchFSDP` trainer - Adaptive Momentum Weight Averaging and soft-label support - `--log_level` CLI flag; TriX model +- Complex query answering (`dicee.query_answering`): CQD beam search over KGEs and KGFMs with learned score adapters, negated query types, native UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE and CLMPT checked against their upstream implementations, and resumable filtered evaluation with exact expected ranks under ties ### Changed - KGFM inference accelerated (fused kernels, query reuse, Flock execution) +- Deterministic KGFM message passing splits hub nodes into balanced, order-preserving partial sums and avoids per-query host synchronization; predictions are bitwise unchanged +- `KGE.answer_multi_hop_query` uses the shared query engine and accepts score adapters - Regression bounds updated for the new embedding initialization (AConEx, CoKE) - DeCaL initialization delegates embedding setup to dedicated methods (part of #427) - CI ratchets the mypy error count instead of `continue-on-error` diff --git a/README.md b/README.md index ceda3fdfe..008d65eda 100644 --- a/README.md +++ b/README.md @@ -351,7 +351,7 @@ The run reuses configuration and serialized artifacts from the existing experime ```bash dicee --continual_learning "KeciFamilyRun" --path_single_kg "KGs/Family/family-benchmark_rich_background.owl" --model Keci --backend rdflib --eval_model None ``` -The continual directory should contain the stored configuration and serialized training data (for example `configuration.json`, `memory_map_train_set.npy`, and mapping files `entity_to_idx`/`relation_to_idx` in `.csv` or legacy `.p` format). +The continual directory should contain the stored configuration and serialized training data (for example `configuration.json`, `memory_map_train_set.npy`, and mapping files `entity_to_idx`/`relation_to_idx` in `.csv` or `.p` format). If `--eval_model` is set, evaluation runs after training using stored indexed artifacts. If `--eval_model None`, no evaluation is executed. Periodic evaluation and weight-averaging callbacks are also supported in continual training. @@ -491,54 +491,100 @@ predictions = model.predict_topk(h=["Mongolia"], t=["Asia"], topk=5) -## Multi-Hop Query Answering -
EPFO Queries (1p, 2p, 3p, 2i, 3i, ip, pi, 2u, up) +## Complex Query Answering (CQA) + +Answer path, intersection, union, and negated queries with [CQD](https://arxiv.org/abs/2011.03459) +over KGEs or [ULTRA](https://arxiv.org/abs/2310.04562)/[TRIX](https://arxiv.org/abs/2502.19512)/[Flock](https://arxiv.org/abs/2510.01510), +with optional learned score adapters. [ConE](https://arxiv.org/abs/2110.13715), +[CLMPT](https://arxiv.org/abs/2402.12954), [CQD-Hybrid](https://arxiv.org/abs/2410.12537), +[GNN-QE](https://proceedings.mlr.press/v162/zhu22c.html), [QTO](https://proceedings.mlr.press/v202/bai23b.html), +and [UltraQuery](https://arxiv.org/abs/2404.07198) are available as native DICE implementations through `dicee.query_answering.methods`. + +
+Examples: 1-hop, 2-hop, and 3-hop queries + +`KGE` loads both ordinary KGEs and saved KGFM experiments. Keep the KGFM's saved +graph and vocabulary files alongside its weights. Save an adapter fitted for the +chosen backbone and t-norm as `adapter.json` in that experiment folder. +Adapter training defaults to linear `context_scores` (16 parameters); the shipped +recipes use it with the product t-norm. ```python +import numpy as np + from dicee import KGE +from dicee.models.graph_model import GraphKGE +from dicee.query_answering import QueryContext, QueryScoreAdapter -# Load pre-trained model -model = KGE(path="...") +# Choose one saved DICE experiment for the family graph. +model = KGE(path="Experiments/complex-family") # KGE: ComplEx +# model = KGE(path="Experiments/ultra-family") # KGFM: ULTRA +# model = KGE(path="Experiments/trix-family") # KGFM: TRIX +# model = KGE(path="Experiments/flock-family") # KGFM: Flock + +adapter = QueryScoreAdapter.load(f"{model.path}/adapter.json", model=model.model) + +# KGFMs reuse their saved graph; context-aware KGE adapters need observed facts. +context = None +if not isinstance(model.model, GraphKGE): + context = QueryContext( + np.load(f"{model.path}/train_set.npy"), model.num_entities, model.num_relations, + ) # 1-hop: Who are the siblings of F9M167? -# Query: ?E : ∃E.hasSibling(E, F9M167) +# Query: hasSibling(F9M167, E) predictions = model.answer_multi_hop_query( query_type="1p", - query=('http://www.benchmark.org/family#F9M167', - ('http://www.benchmark.org/family#hasSibling',)), - tnorm="min", k=3 + query=("http://www.benchmark.org/family#F9M167", + ("http://www.benchmark.org/family#hasSibling",)), + adapter=adapter, context=context, tnorm="prod", k=3, ) -# => [('F9F141', 0.99), ('F9M157', 0.98), ...] # 2-hop: To whom is a sibling of F9M167 married? -# Query: ?D : ∃E.Married(D,E) ∧ hasSibling(E, F9M167) +# Query: ∃E. hasSibling(F9M167, E) ∧ married(E, D) predictions = model.answer_multi_hop_query( query_type="2p", query=("http://www.benchmark.org/family#F9M167", ("http://www.benchmark.org/family#hasSibling", "http://www.benchmark.org/family#married")), - tnorm="min", k=3 + adapter=adapter, context=context, tnorm="prod", beam_size=64, k=3, ) -# => [('F9F158', 0.95), ('F9M142', 0.93), ...] -# 3-hop: What type of people are married to a sibling of F9M167? -# Query: ?T : ∃D.type(D,T) ∧ Married(D,E) ∧ hasSibling(E, F9M167) +# 3-hop: What types do those spouses have? +# Query: ∃E,D. hasSibling(F9M167, E) ∧ married(E, D) ∧ type(D, T) predictions = model.answer_multi_hop_query( query_type="3p", query=("http://www.benchmark.org/family#F9M167", ("http://www.benchmark.org/family#hasSibling", "http://www.benchmark.org/family#married", "http://www.w3.org/1999/02/22-rdf-syntax-ns#type")), - tnorm="min", k=5 + adapter=adapter, context=context, tnorm="prod", beam_size=64, k=5, ) -# => [('Person', 0.99), ('Male', 0.99), ('Father', 0.98), ...] +# Each call returns a list of (entity, score) pairs. ``` -**📖 [See multi-hop query examples →](tests/test_answer_multi_hop_query.py)** -**Supported query types:** `1p` (1-hop projection), `2p` (2-hop), `3p` (3-hop), `2i` (2-way intersection), `3i` (3-way intersection), `ip` (intersection-projection), `pi` (projection-intersection), `2u` (2-way union), `up` (union-projection) +`beam_size` limits intermediate candidates; `k` limits returned answers. +Set `adapter = None` to use unadapted sigmoid scores.
+See the [CQA guide](docs/guides/multi_hop_queries.md) for adapters and method evaluation. + +**Benchmarks.** [`benchmarks/cqa`](benchmarks/cqa/README.md) evaluates these methods on the +23 UltraQuery datasets and on **+H**: FB15k237+H, NELL995+H and ICEWS18+H from +[Gregucci et al.](https://arxiv.org/abs/2410.12537), built so that complex queries cannot be +reduced to simpler link prediction. Select any methods, datasets and query types: + +```bash +python -m benchmarks.cqa plus_h evaluate --output results/plus-h-subset \ + --methods cqd cqd-hybrid qto --datasets FB15k237+H NELL995+H --query-types 2p 3p +``` + +The verified workflow freezes inputs and query batches, checks validation predictions against +the pinned upstream implementations, runs in a pinned Docker image, and reports sort-based and +expected random-tie metrics with paired adapter controls. The [protocol](benchmarks/cqa/PROTOCOL.md) +records every known deviation from the publications. + ## Literal Prediction
Predicting Numeric/Literal Values diff --git a/dicee/knowledge_graph_embeddings.py b/dicee/knowledge_graph_embeddings.py index 0fb9b6538..f9c51f762 100644 --- a/dicee/knowledge_graph_embeddings.py +++ b/dicee/knowledge_graph_embeddings.py @@ -33,8 +33,14 @@ def __str__(self): def to(self, device: str) -> None: if "cpu" not in device and "cuda" not in device: raise ValueError(f"Device must be either cpu or cuda, got {device!r}") + self.clear_query_cache() self.model.to(device) + def clear_query_cache(self): + """Release retained CQD rows and their model references.""" + self._query_engine = None + self._query_engine_key = None + def get_transductive_entity_embeddings(self, indices: Union[torch.LongTensor, List[str]], as_pytorch=False, @@ -722,582 +728,70 @@ def triple_score(self, h: Optional[Union[List[str], str]] = None, r: Optional[Un else: return torch.sigmoid(self.model(x)) - def return_multi_hop_query_results(self, aggregated_query_for_all_entities, k: int, only_scores): - # @TODO: refactor by torchargmax(aggregated_query_for_all_entities) - if only_scores: - return aggregated_query_for_all_entities - # from idx obtain entity str - return sorted([(ei, s) for ei, s in zip(self.entity_to_idx.keys(), aggregated_query_for_all_entities)], - key=lambda x: x[1], reverse=True)[:k] - - def single_hop_query_answering(self, query: tuple, only_scores: bool = True, k: Optional[int] = None, - use_logits: bool = True): - h, r = query - result = self.predict(h=h, r=r[0], logits=use_logits).squeeze() + def return_multi_hop_query_results(self, scores, k: int, only_scores): if only_scores: - """ do nothing""" - else: - query_score_of_all_entities = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), result)] - result = sorted(query_score_of_all_entities, key=lambda x: x[1], reverse=True)[:k] - return result - - def answer_multi_hop_query( - self, - query_type: Optional[str] = None, - query: Optional[Tuple[Union[str, Tuple[str, str]], ...]] = None, - queries: Optional[List[Tuple[Union[str, Tuple[str, str]], ...]]] = None, - tnorm: str = "prod", - neg_norm: str = "standard", - lambda_: float = 0.0, - k: int = 10, - only_scores: bool = False, - use_logits: bool = True - ) -> Union[List[Tuple[str, torch.Tensor]], List[List[Tuple[str, torch.Tensor]]]]: - """ - Answer multi-hop EPFO (Existential Positive First-Order) queries. - - Supports 9 query types: 1p, 2p, 3p, 2i, 3i, ip, pi, 2u, up. - See docs/guides/multi_hop_queries.md for detailed query patterns. - - Args: - query_type: Query pattern name. One of: - - 1p: (e, (r,)) # One-hop - - 2p: (e, (r1, r2)) # Two-hop - - 3p: (e, (r1, r2, r3)) # Three-hop - - 2i: ((e1, (r1,)), (e2, (r2,))) # Two-way intersection - - 3i: ((e1, (r1,)), (e2, (r2,)), (e3, (r3,))) # Three-way intersection - - ip: (((e1, (r1,)), (e2, (r2,))), (r3,)) # Intersection + projection - - pi: ((e, (r1, r2)), (r3,)) # Projection + intersection (2i meets 2p) - - 2u: ((e1, (r1,)), (e2, (r2,))) # Two-way union - - up: ((e, (r1, r2)), (e, (r3,))) # Union + projection - query: Single query tuple matching the query_type pattern. - queries: Batch of queries. If provided, query must be None. - tnorm: T-norm for intersection/union. Options: "prod", "min". - neg_norm: Negation norm. Options: "standard", "sugeno", "yager". - lambda_: Parameter for sugeno and yager negation (0.0-1.0). - k: Number of top answer entities to return. - only_scores: If True, return only scores tensor. If False, return (entity, score) tuples. - use_logits: If True, use raw model logits. If False, use sigmoid probabilities. + return scores + order = torch.argsort(scores, descending=True, stable=True)[:k] + names = {index: name for name, index in self.entity_to_idx.items()} + return [(names[int(index)], scores[index]) for index in order] - Returns: - For single query: List[(entity, score), ...] of top-k answers. - For batch queries: List of such lists, one per query. + def single_hop_query_answering(self, query: tuple, only_scores: bool = True, + k: Optional[int] = None, use_logits: bool = False): + return self.answer_multi_hop_query('1p', query, k=len(self.entity_to_idx) if k is None else k, + only_scores=only_scores, use_logits=use_logits) - Raises: - ValueError: If query_type is not in {1p, 2p, 3p, 2i, 3i, ip, pi, 2u, up}. - AssertionError: If query structure doesn't match query_type pattern. - - Examples: - >>> # 1p: Find entities located in Asia - >>> model.answer_multi_hop_query( - ... query_type="1p", - ... query=("Asia", ("isLocatedIn",)), - ... k=5 - ... ) - [("Mongolia", 0.92), ("China", 0.89), ...] - - >>> # 2p: Two-hop query (e.g., "capital of countries in Europe") - >>> model.answer_multi_hop_query( - ... query_type="2p", - ... query=("Europe", ("isLocatedIn", "hasCapital")), - ... k=3 - ... ) - [("Paris", 0.85), ("Berlin", 0.82), ...] - - >>> # 2i: Intersection query - >>> model.answer_multi_hop_query( - ... query_type="2i", - ... query=(("Asia", ("isLocatedIn",)), ("Mountains", ("hasGeography",))), - ... k=5 - ... ) - [("Nepal", 0.78), ("Tibet", 0.65), ...] - - See Also: - - docs/guides/multi_hop_queries.md: Complete guide with all query patterns - - tests/test_answer_multi_hop_query.py: Usage examples + def answer_multi_hop_query( + self, query_type=None, query=None, queries=None, tnorm="prod", + neg_norm="standard", lambda_=0.0, k=10, only_scores=False, + use_logits=False, *, beam_size=None, context=None, adapter=None, + observed_mix=None, row_batch_size=8, cache_bytes=64 * 1024 * 1024, + seed=0, samples=None, executor='cqd', + ): + """Answer the 14 standard query shapes and the +H four-step 4p/4i shapes. + + All entity-prediction models use one evaluator, including ULTRA, TRIX, + and Flock. Scores default to sigmoid memberships; ``use_logits=True`` + explicitly requests legacy raw-score algebra (without an adapter). + ``k`` limits returned answers; ``beam_size`` controls existential search + independently and defaults to max(1, k). ``only_scores`` returns all + entity scores in numeric ID order. Ties use entity ID order. + ``executor='qto'`` uses exact projections without a beam limit. + + Pass QueryContext for transductive observed-edge/feature support; graph + models use their attached context. Pass QueryScoreAdapter for a learned + transform. Context must never contain held-out evaluation answers. """ - - if queries is not None: - if query is not None: - raise ValueError("Provide either 'query' or 'queries', not both") - results = [] - for i in queries: - results.append( - self.answer_multi_hop_query(query_type=query_type, query=i, tnorm=tnorm, neg_norm=neg_norm, - lambda_=lambda_, k=k, only_scores=only_scores, - use_logits=use_logits)) - return results - - if not (len(self.entity_to_idx) >= k >= 0): - raise ValueError(f"k must satisfy 0 <= k <= {len(self.entity_to_idx)}, got {k}") - - query_name_dict = { - ("e", ("r",)): "1p", - ("e", ("r", "r")): "2p", - ("e", ("r", "r", "r",),): "3p", - (("e", ("r",)), ("e", ("r",))): "2i", - (("e", ("r",)), ("e", ("r",)), ("e", ("r",))): "3i", - ((("e", ("r",)), ("e", ("r",))), ("r",)): "ip", - (("e", ("r", "r")), ("e", ("r",))): "pi", - # negation - (("e", ("r",)), ("e", ("r", "n"))): "2in", - (("e", ("r",)), ("e", ("r",)), ("e", ("r", "n"))): "3in", - ((("e", ("r",)), ("e", ("r", "n"))), ("r",)): "inp", - (("e", ("r", "r")), ("e", ("r", "n"))): "pin", - (("e", ("r", "r", "n")), ("e", ("r",))): "pni", - - # union - (("e", ("r",)), ("e", ("r",)), ("u",)): "2u", - ((("e", ("r",)), ("e", ("r",)), ("u",)), ("r",)): "up", - - } - - # Create an inverse mapping - inverse_query_name_dict = {v: k for k, v in query_name_dict.items()} - - # Look up the corresponding query_structure - if query_type in inverse_query_name_dict: - query_structure = inverse_query_name_dict[query_type] - else: - supported_queries = sorted([k for k in inverse_query_name_dict.keys() if 'n' not in k]) - raise ValueError( - f"Invalid query type: '{query_type}'\\n" - f"\\nSupported query types:\\n" - f" - Basic: {', '.join(supported_queries[:7])}\\n" - f" - Negation: {', '.join([k for k in sorted(inverse_query_name_dict.keys()) if 'n' in k])}\\n" - f"\\nExamples:\\n" - f" - 1p: (e, (r,))\\n" - f" - 2p: (e, (r1, r2))\\n" - f" - 2i: ((e1, (r1,)), (e2, (r2,)))\\n" - f" - 2u: ((e1, (r1,)), (e2, (r2,)), ('u',))\\n" - f"\\nSee docs/guides/multi_hop_queries.md for complete guide\\n" - f"See tests/test_answer_multi_hop_query.py for usage examples\\n" - ) - - # 1p - if query_structure == ("e", ("r",)): - return self.single_hop_query_answering(query, only_scores, k, use_logits=use_logits) - # 2p - elif query_structure == ("e", ("r", "r",)): - # ?M : \exist A. r1(e,A) \land r2(A,M) - e, (r1, r2) = query - top_k_scores1 = [] - atom2_scores = [] - # (1) Iterate over top k substitutes of A in the first hop query: r1(e,A) s.t. A<-a - for top_k_entity, score_of_e_r1_a in self.answer_multi_hop_query(query_type="1p", query=(e, (r1,)), - only_scores=False, tnorm=tnorm, k=k, - use_logits=use_logits): - # (1.1) Store scores of (e, r1, a) s.t. a is a substitute of A and a is a top ranked entity. - top_k_scores1.append(score_of_e_r1_a) - # (1.2) Compute scores for (a, r2, M): Replace predict with answer_multi_hop_query. - atom2_scores.append(self.predict(h=top_k_entity, r=r2, logits=use_logits)) - # (2) k by E tensor - atom2_scores = torch.vstack(atom2_scores) - kk, E = atom2_scores.shape - # Sanity checking - assert k == kk - # Top k scores for all replacement of A. torch.Size([k,1]) - top_k_scores1 = torch.FloatTensor(top_k_scores1).reshape(k, 1) - # k x E - top_k_scores1 = top_k_scores1.repeat(1, E) - # E scores - aggregated_query_for_all_entities, _ = torch.max(self.t_norm(top_k_scores1, atom2_scores, tnorm), dim=0) - return self.return_multi_hop_query_results(aggregated_query_for_all_entities, k, only_scores) - # 3p - elif query_structure == ("e", ("r", "r", "r",)): - head1, (relation1, relation2, relation3) = query - top_k_scores1 = [] - atom_scores = [] - # (1) Iterate over top k substitutes of A in the first hop query: r1(e,A) s.t. A<-a - for top_k_entity, score_of_e_r1_a in self.answer_multi_hop_query(query_type="2p", - query=(head1, (relation1, relation2)), - tnorm=tnorm, - k=k, - use_logits=use_logits): - top_k_scores1.append(score_of_e_r1_a) - # () Scores for all entities E - atom_scores.append(self.predict(h=[top_k_entity], r=[relation3], logits=use_logits)) - - # (2) k by E tensor - atom_scores = torch.vstack(atom_scores) - kk, E = atom_scores.shape - # Sanity checking - assert k == kk - # Top k scores for all replacement of A. torch.Size([k,1]) - top_k_scores1 = torch.FloatTensor(top_k_scores1).reshape(k, 1) - # k x E - top_k_scores1 = top_k_scores1.repeat(1, E) - # E scores - aggregated_query_for_all_entities, _ = torch.max(self.t_norm(top_k_scores1, atom_scores, tnorm), dim=0) - return self.return_multi_hop_query_results(aggregated_query_for_all_entities, k, only_scores) - - # 2in - elif query_structure == (("e", ("r",)), ("e", ("r", "n"))): - # entity_scores = scores_2in(query, tnorm, neg_norm, lambda_) - head1, relation1 = query[0] - head2, relation2 = query[1] - - # Calculate entity scores for each query - # Get scores for the first atom (positive) - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom (negative) - # if neg_norm == "standard": - predictions = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - atom2_scores = self.negnorm(predictions, lambda_, neg_norm) - - assert len(atom1_scores) == len(self.entity_to_idx) - - combined_scores = self.t_norm(atom1_scores, atom2_scores, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # 3in - elif query_structure == (("e", ("r",)), ("e", ("r",)), ("e", ("r", "n"))): - # entity_scores = scores_3in(model, query, tnorm, neg_norm, lambda_) - head1, relation1 = query[0] - head2, relation2 = query[1] - head3, relation3 = query[2] - - # Calculate entity scores for each query - # Get scores for the first atom (positive) - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom (negative) - # modelling standard negation (1-x) - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - # Get scores for the third atom - # if neg_norm == "standard": - predictions = self.predict(h=[head3], r=[relation3[0]], logits=use_logits).squeeze() - atom3_scores = self.negnorm(predictions, lambda_, neg_norm) - - assert len(atom1_scores) == len(self.entity_to_idx) - - inter_scores = self.t_norm(atom1_scores, atom2_scores, tnorm) - combined_scores = self.t_norm(inter_scores, atom3_scores, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # pni - elif query_structure == (("e", ("r", "r", "n")), ("e", ("r",))): - # entity_scores = scores_pni(model, query, tnorm, neg_norm, lambda_, k_) - head1, (relation1, relation2, _) = query[0] - head3, relation3 = query[1] - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - # sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(atom1_scores, k) - - # using model.entity_to_idx.keys() take the name of entities from topk heads 2 - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Get scores for the second atom - # Initialize an empty tensor - atom2_scores = torch.empty(0, len(self.entity_to_idx)).to(atom1_scores.device) - - # Get scores for the second atom - for head2 in top_k_heads: - # The score tensor for the current head2 - atom2_score = self.predict(h=[head2], r=[relation2], logits=use_logits) - neg_atom2_score = self.negnorm(atom2_score, lambda_, neg_norm) - # Concatenate the score tensor for the current head2 with the previous scores - atom2_scores = torch.cat([atom2_scores, neg_atom2_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom2_scores.shape[1]) - - inter_scores = self.t_norm(topk_scores1_expanded, atom2_scores, tnorm) - - scores_2pn_query, _ = torch.max(inter_scores, dim=0) - scores_1p_query = self.predict(h=[head3], r=[relation3[0]], logits=use_logits).squeeze() - - combined_scores = self.t_norm(scores_2pn_query, scores_1p_query, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # pin - elif query_structure == (("e", ("r", "r")), ("e", ("r", "n"))): - # entity_scores = scores_pin(model, query, tnorm, neg_norm, lambda_, k_) - head1, (relation1, relation2) = query[0] - head3, relation3 = query[1] - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - # sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(atom1_scores, k) - - # using model.entity_to_idx.keys() take the name of entities from topk heads 2 - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Initialize an empty tensor - atom2_scores = torch.empty(0, len(self.entity_to_idx)).to(atom1_scores.device) - - # Get scores for the second atom - for head2 in top_k_heads: - # The score tensor for the current head2 - atom2_score = self.predict(h=[head2], r=[relation2], logits=use_logits) - # Concatenate the score tensor for the current head2 with the previous scores - atom2_scores = torch.cat([atom2_scores, atom2_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom2_scores.shape[1]) - - inter_scores = self.t_norm(topk_scores1_expanded, atom2_scores, tnorm) - - scores_2p_query, _ = torch.max(inter_scores, dim=0) - - scores_1p_query = self.predict(h=[head3], r=[relation3[0]], logits=use_logits).squeeze() - # taking negation for the e,(r,n) part of query - neg_scores_1p_query = self.negnorm(scores_1p_query, lambda_, neg_norm) - combined_scores = self.t_norm(scores_2p_query, neg_scores_1p_query, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # inp - elif query_structure == ((("e", ("r",)), ("e", ("r", "n"))), ("r",)): - # entity_scores = scores_inp(model, query, tnorm, neg_norm, lambda_, k_) - head1, relation1 = query[0][0] - head2, relation2 = query[0][1] - relation_1p = query[1] - - # Calculate entity scores for each query - # Get scores for the first atom (positive) - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom (negative) - # if neg_norm == "standard": - predictions = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - atom2_scores = self.negnorm(predictions, lambda_, neg_norm) - - assert len(atom1_scores) == len(self.entity_to_idx) - - scores_2in_query = self.t_norm(atom1_scores, atom2_scores, tnorm) - - # sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(scores_2in_query, k) - - # using model.entity_to_idx.keys() take the name of entities from topk heads 2 - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Get scores for the second atom - # Initialize an empty tensor - atom3_scores = torch.empty(0, len(self.entity_to_idx)).to(scores_2in_query.device) - - # Get scores for the second atom - for head3 in top_k_heads: - # The score tensor for the current head2 - atom3_score = self.predict(h=[head3], r=[relation_1p[0]], logits=use_logits) - # Concatenate the score tensor for the current head2 with the previous scores - atom3_scores = torch.cat([atom3_scores, atom3_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom3_scores.shape[1]) - - combined_scores = self.t_norm(topk_scores1_expanded, atom3_scores, tnorm) - - res, _ = torch.max(combined_scores, dim=0) - if only_scores: - return res - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), res)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # 2i - elif query_structure == (("e", ("r",)), ("e", ("r",))): - # entity_scores = scores_2i(model, query, tnorm) - head1, relation1 = query[0] - head2, relation2 = query[1] - - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - combined_scores = self.t_norm(atom1_scores, atom2_scores, tnorm) + from .query_answering import QueryAnswerer + from .query_answering._query import index_query + + if (query is None) == (queries is None): + raise ValueError("Provide exactly one of 'query' or 'queries'") + if type(k) is not int or k < 0: + raise ValueError('k must be a nonnegative integer') + key = (id(self.model), id(context), id(adapter), observed_mix, row_batch_size, seed, samples) + if key != getattr(self, '_query_engine_key', None): + self._query_engine = QueryAnswerer(self.model, context=context, adapter=adapter, observed_mix=observed_mix, + row_batch_size=row_batch_size, cache_bytes=cache_bytes, seed=seed, samples=samples) + self._query_engine_key = key + engine = self._query_engine + if cache_bytes < 0: + raise ValueError('Cache size must be nonnegative') + engine.cache_bytes = cache_bytes + beam = max(1, k) if beam_size is None else beam_size + names = {index: name for name, index in self.entity_to_idx.items()} if not only_scores else None + + def answer(item): + indexed = index_query(query_type, item, self.entity_to_idx, self.relation_to_idx) + scores = engine.predict(indexed, beam_size=beam, tnorm=tnorm, neg_norm=neg_norm, + lambda_=lambda_, use_logits=use_logits, return_log_scores=not use_logits, executor=executor) if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # 3i - elif query_structure == (("e", ("r",)), ("e", ("r",)), ("e", ("r",))): - # entity_scores = scores_3i(model, query, tnorm) - head1, relation1 = query[0] - head2, relation2 = query[1] - head3, relation3 = query[2] - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - # Get scores for the third atom - atom3_scores = self.predict(h=[head3], r=[relation3[0]], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - inter_scores = self.t_norm(atom1_scores, atom2_scores, tnorm) - combined_scores = self.t_norm(inter_scores, atom3_scores, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # pi - elif query_structure == (("e", ("r", "r")), ("e", ("r",))): - # entity_scores = scores_pi(model, query, tnorm, k_) - head1, (relation1, relation2) = query[0] - head3, relation3 = query[1] - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - # sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(atom1_scores, k) - - # using model.entity_to_idx.keys() take the name of entities from topk heads 2 - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Initialize an empty tensor - atom2_scores = torch.empty(0, len(self.entity_to_idx)).to(atom1_scores.device) - - # Get scores for the second atom - for head2 in top_k_heads: - # The score tensor for the current head2 - atom2_score = self.predict(h=[head2], r=[relation2], logits=use_logits).unsqueeze(0) - # Concatenate the score tensor for the current head2 with the previous scores - atom2_scores = torch.cat([atom2_scores, atom2_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom2_scores.shape[1]) - - inter_scores = self.t_norm(topk_scores1_expanded, atom2_scores, tnorm) - - scores_2p_query, _ = torch.max(inter_scores, dim=0) - - scores_1p_query = self.predict(h=[head3], r=[relation3[0]], logits=use_logits).squeeze() - - combined_scores = self.t_norm(scores_2p_query, scores_1p_query, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # ip - elif query_structure == ((("e", ("r",)), ("e", ("r",))), ("r",)): - # entity_scores = scores_ip(model, query, tnorm, k_) - head1, relation1 = query[0][0] - head2, relation2 = query[0][1] - relation_1p = query[1] - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - scores_2i_query = self.t_norm(atom1_scores, atom2_scores, tnorm) - # Get the top k entities from the 2i query - - # sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(scores_2i_query, k) - - # using model.entity_to_idx.keys() take the name of entities from topk heads - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Get scores for the second atom - # Initialize an empty tensor - atom3_scores = torch.empty(0, len(self.entity_to_idx)).to(scores_2i_query.device) - - # Get scores for the second atom - for head3 in top_k_heads: - # The score tensor for the current head2 - atom3_score = self.predict(h=[head3], r=[relation_1p[0]], logits=use_logits).unsqueeze(0) - - # Concatenate the score tensor for the current head2 with the previous scores - atom3_scores = torch.cat([atom3_scores, atom3_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom3_scores.shape[1]) - - combined_scores = self.t_norm(topk_scores1_expanded, atom3_scores, tnorm) - res, _ = torch.max(combined_scores, dim=0) - if only_scores: - return res - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), res)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - # disjunction - # 2u - elif query_structure == (("e", ("r",)), ("e", ("r",)), ("u",)): - # entity_scores = scores_2u(model, query, tnorm) - head1, relation1 = query[0] - head2, relation2 = query[1] - - # Calculate entity scores for each query - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - # Get scores for the second atom - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - combined_scores = self.t_conorm(atom1_scores, atom2_scores, tnorm) - if only_scores: - return combined_scores - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), combined_scores)] - entity_scores = sorted(entity_scores, key=lambda x: x[1], reverse=True) + return scores if use_logits else scores.exp() + # Rank in log space before converting to memberships, avoiding underflow ties. + order = torch.argsort(scores, descending=True, stable=True)[:k] + values = scores if use_logits else scores.exp() + return [(names[int(index)], values[index]) for index in order] - return entity_scores - # up - # here the second tnorm is for t-conorm (used in pairs) - elif query_structure == ((("e", ("r",)), ("e", ("r",)), ("u",)), ("r",)): - # entity_scores = scores_up(model, query, tnorm, tnorm, k_) - head1, relation1 = query[0][0] - head2, relation2 = query[0][1] - relation_1p = query[1] - - # Get scores for the first atom - atom1_scores = self.predict(h=[head1], r=[relation1[0]], logits=use_logits).squeeze() - - # Get scores for the second atom - atom2_scores = self.predict(h=[head2], r=[relation2[0]], logits=use_logits).squeeze() - - assert len(atom1_scores) == len(self.entity_to_idx) - - scores_2u_query = self.t_conorm(atom1_scores, atom2_scores, tnorm) - - # Sort atom1_scores in descending order and get the top k entities indices - top_k_scores1, top_k_indices = torch.topk(scores_2u_query, k) - - # Using model.entity_to_idx.keys() take the name of entities from topk heads - entity_to_idx_keys = list(self.entity_to_idx.keys()) - top_k_heads = [entity_to_idx_keys[idx.item()] for idx in top_k_indices] - - # Initialize an empty tensor - atom3_scores = torch.empty(0, len(self.entity_to_idx)).to(scores_2u_query.device) - - for head3 in top_k_heads: - # The score tensor for the current head3 - atom3_score = self.predict(h=[head3], r=[relation_1p[0]], logits=use_logits).unsqueeze(0) - - # Concatenate the score tensor for the current head3 with the previous scores - atom3_scores = torch.cat([atom3_scores, atom3_score], dim=0) - - topk_scores1_expanded = top_k_scores1.view(-1, 1).repeat(1, atom3_scores.shape[1]) - combined_scores = self.t_norm(topk_scores1_expanded, atom3_scores, tnorm) - res, _ = torch.max(combined_scores, dim=0) - if only_scores: - return res - entity_scores = [(ei, s) for ei, s in zip(self.entity_to_idx.keys(), res)] - return sorted(entity_scores, key=lambda x: x[1], reverse=True) - else: - raise RuntimeError(f"Incorrect query_structure {query_structure}") + return [answer(item) for item in queries] if queries is not None else answer(query) def find_missing_triples(self, confidence: float, entities: Optional[List[str]] = None, relations: Optional[List[str]] = None, topk: int = 10, diff --git a/dicee/models/_fused_message.py b/dicee/models/_fused_message.py index ff145477c..a44052229 100644 --- a/dicee/models/_fused_message.py +++ b/dicee/models/_fused_message.py @@ -5,9 +5,25 @@ kernel is included in a checkpoint. Triton is imported only on the CUDA path. """ import weakref +from typing import NamedTuple import torch +# Rows with more 32-edge tiles than this are hubs: balanced programs sum their tiles. +HUB_TILES = 8 + + +class CSRLayout(NamedTuple): + """Edges grouped by output row, cut into 32-edge tiles.""" + offsets: torch.Tensor # [N + 1] row pointers + sources: torch.Tensor # input node of each edge, grouped by row + types: torch.Tensor # relation of each edge + tile_rows: torch.Tensor # row of each tile + tile_starts: torch.Tensor # first edge of each tile + hub_rows: torch.Tensor # tile rows/starts restricted to hub rows + hub_starts: torch.Tensor + hub_first: torch.Tensor # [N] index of a hub row's first tile, else -1 + def tensor_version(tensor): return None if tensor.is_inference() else tensor._version @@ -25,7 +41,11 @@ def csr_layout(edge_index, edge_type, num_nodes): tile_offsets = tile_counts.cumsum(0) - tile_counts rows = torch.arange(num_nodes, device=counts.device).repeat_interleave(tile_counts) starts = offsets[rows] + (torch.arange(len(rows), device=rows.device) - tile_offsets[rows]) * 32 - layout = (offsets, edge_index[1, order].contiguous(), edge_type[order].contiguous(), rows, starts) + hub = tile_counts > HUB_TILES + hub_counts = torch.where(hub, tile_counts, 0) + layout = CSRLayout(offsets, edge_index[1, order].contiguous(), edge_type[order].contiguous(), rows, starts, + rows[hub[rows]].contiguous(), starts[hub[rows]].contiguous(), + torch.where(hub, hub_counts.cumsum(0) - hub_counts, -1)) # Inference tensors lack mutation counters. Do not retain a potentially # stale layout for graphs constructed inside inference_mode(). if not edge_index.is_inference() and not edge_type.is_inference(): diff --git a/dicee/models/_inference.py b/dicee/models/_inference.py index 4fa625520..e7feefdab 100644 --- a/dicee/models/_inference.py +++ b/dicee/models/_inference.py @@ -5,19 +5,49 @@ from torch.nn import functional as F +def float32_precision_backends(): + """Precision controls of this PyTorch build, even after cuDNN's RNN module is imported. + + Some PyTorch releases expose ``fp32_precision`` on only a subset of these backends. + """ + if not hasattr(torch.backends.cuda.matmul, 'fp32_precision'): + return () + cudnn, mkldnn = torch.backends.cudnn, torch.backends.mkldnn + # Importing cudnn.rnn shadows the precision object on the module instance. + rnn = getattr(type(cudnn), 'rnn', None) + if rnn is None: + rnn = getattr(cudnn, 'rnn', None) + candidates = (torch.backends, torch.backends.cuda.matmul, cudnn, mkldnn, + getattr(type(cudnn), 'conv', None), rnn, getattr(mkldnn, 'matmul', None)) + return tuple(backend for backend in candidates if hasattr(backend, 'fp32_precision')) + + def float32_precision_token(): """Read precision without mixing PyTorch's legacy and per-backend APIs.""" - if hasattr(torch.backends.cuda.matmul, 'fp32_precision'): - # Include parent settings as well as operator overrides. The legacy - # getters can raise when backends (or cuDNN conv/RNN) use different modes. - cudnn, mkldnn = torch.backends.cudnn, torch.backends.mkldnn - backends = (torch.backends, torch.backends.cuda.matmul, cudnn, mkldnn, - getattr(cudnn, 'conv', None), getattr(cudnn, 'rnn', None), getattr(mkldnn, 'matmul', None)) - # Some PyTorch releases expose fp32_precision on only a subset of these backends. - return tuple(getattr(backend, 'fp32_precision', None) for backend in backends) + backends = float32_precision_backends() + if backends: + return tuple(backend.fp32_precision for backend in backends) return torch.get_float32_matmul_precision(), torch.backends.cudnn.allow_tf32 +def to_device(tensor, device): + """Copy a host tensor to CUDA without a stream synchronization. + + Blocking host-to-device copies wait for all queued GPU work. Staging small + index tensors in pinned memory lets the host continue issuing kernels. + """ + device = torch.device(device) + if device.type != 'cuda' or tensor.device.type != 'cpu': + return tensor.to(device) + return tensor.pin_memory().to(device, non_blocking=True) + + +def host_ids(values): + """Integer IDs as a list, using a host copy attached by the caller when present.""" + ids = getattr(values, '_dicee_ids', None) + return values.tolist() if ids is None else ids + + def inference_only(module): return (not module.training and not torch.is_autocast_enabled(next(module.parameters()).device.type) and (not torch.is_grad_enabled() or not any(p.requires_grad for p in module.parameters()))) @@ -50,6 +80,19 @@ def candidate_slice(candidates, sl): return result +def cached_relation_batch(values, ids): + """Broadcast one cached relation across a same-relation inference batch. + + Beam expansions commonly share a relation. A zero-stride view avoids + copying its full graph representation for every head; consumers must not + mutate this view. Mixed-relation batches retain their original order. + """ + first = values[ids[0]] + if all(key == ids[0] for key in ids): + return first.unsqueeze(0).expand(len(ids), *first.shape) + return torch.stack([values[key] for key in ids]) + + def conditioned_linear(linear, hidden, query): """Apply W[h,q]+b while projecting the shared query only once.""" dim = hidden.shape[-1] diff --git a/dicee/models/_triton_message.py b/dicee/models/_triton_message.py index 9feab735c..0b3530775 100644 --- a/dicee/models/_triton_message.py +++ b/dicee/models/_triton_message.py @@ -5,70 +5,96 @@ @triton.jit -def _distmult_sum(S, R, B, O, PTR, SRC, TYPE, +def _chunk_sum(S, R, SRC, TYPE, edge, end, batch, feature, + SB: tl.constexpr, SN: tl.constexpr, SD: tl.constexpr, + RB: tl.constexpr, RN: tl.constexpr, RD: tl.constexpr, D: tl.constexpr): + # One 32-edge chunk; the tile shape and warps fix its reduction tree. + source = tl.load(SRC + edge, edge < end, other=0) + relation = tl.load(TYPE + edge, edge < end, other=0) + mask = (edge[:, None] < end) & (feature[None, :] < D) + state = tl.load(S + batch * SB + source[:, None] * SN + feature[None, :] * SD, mask, other=0) + rel = tl.load(R + batch * RB + relation[:, None] * RN + feature[None, :] * RD, mask, other=0) + return tl.sum(state.to(tl.float32) * rel.to(tl.float32), axis=0) + + +@triton.jit +def _tile_sums(S, R, OUT, PTR, SRC, TYPE, ROWS, STARTS, TILES, + SB: tl.constexpr, SN: tl.constexpr, SD: tl.constexpr, + RB: tl.constexpr, RN: tl.constexpr, RD: tl.constexpr, + N: tl.constexpr, D: tl.constexpr, FEATURES: tl.constexpr, EDGES: tl.constexpr, ATOMIC: tl.constexpr): + # One balanced program per tile: add it to its row atomically, or keep it + # for the row program to accumulate in order. + tile, batch = tl.program_id(0), tl.program_id(1) + row = tl.load(ROWS + tile) + end = tl.load(PTR + row + 1) + edge = tl.load(STARTS + tile) + tl.arange(0, EDGES) + feature = tl.arange(0, FEATURES) + total = _chunk_sum(S, R, SRC, TYPE, edge, end, batch, feature, SB, SN, SD, RB, RN, RD, D) + if ATOMIC: + tl.atomic_add(OUT + (batch * N + row) * D + feature, total, feature < D, sem='relaxed') + else: + tl.store(OUT + (batch * TILES + tile) * D + feature, total, feature < D) + + +@triton.jit +def _distmult_sum(S, R, B, O, PTR, SRC, TYPE, FIRST, P, TILES, SB: tl.constexpr, SN: tl.constexpr, SD: tl.constexpr, RB: tl.constexpr, RN: tl.constexpr, RD: tl.constexpr, BB: tl.constexpr, BN: tl.constexpr, BD: tl.constexpr, N: tl.constexpr, D: tl.constexpr, FEATURES: tl.constexpr, - EDGES: tl.constexpr): + EDGES: tl.constexpr, UNROLL: tl.constexpr): row, batch = tl.program_id(0), tl.program_id(1) feature = tl.arange(0, FEATURES) start, end = tl.load(PTR + row), tl.load(PTR + row + 1) + first = tl.load(FIRST + row) total = tl.full((FEATURES,), 0, tl.float32) - for first in range(start, end, EDGES): - edge = first + tl.arange(0, EDGES) - source = tl.load(SRC + edge, edge < end, other=0) - relation = tl.load(TYPE + edge, edge < end, other=0) - mask = (edge[:, None] < end) & (feature[None, :] < D) - state = tl.load(S + batch * SB + source[:, None] * SN + feature[None, :] * SD, mask, other=0) - rel = tl.load(R + batch * RB + relation[:, None] * RN + feature[None, :] * RD, mask, other=0) - total += tl.sum(state.to(tl.float32) * rel.to(tl.float32), axis=0) + if first < 0: + for chunk in range(start, end, EDGES): + edge = chunk + tl.arange(0, EDGES) + total += _chunk_sum(S, R, SRC, TYPE, edge, end, batch, feature, SB, SN, SD, RB, RN, RD, D) + else: + # Same chunk sums, accumulated in the same order as the inline loop. + count = (end - start + EDGES - 1) // EDGES + partial = P + (batch * TILES + first) * D + feature + for block in range(0, count, UNROLL): + for offset in tl.static_range(UNROLL): + valid = block + offset < count + value = tl.load(partial + (block + offset) * D, (feature < D) & valid, other=0) + total = tl.where(valid, total + value, total) boundary = tl.load(B + batch * BB + row * BN + feature * BD, feature < D, other=0) tl.store(O + (batch * N + row) * D + feature, total + boundary, feature < D) -@triton.jit -def _distmult_tiles(S, R, O, PTR, SRC, TYPE, ROWS, STARTS, - SB: tl.constexpr, SN: tl.constexpr, SD: tl.constexpr, - RB: tl.constexpr, RN: tl.constexpr, RD: tl.constexpr, - N: tl.constexpr, D: tl.constexpr, FEATURES: tl.constexpr): - tile, batch = tl.program_id(0), tl.program_id(1) - row = tl.load(ROWS + tile) - edge = tl.load(STARTS + tile) + tl.arange(0, 32) - end = tl.load(PTR + row + 1) - feature = tl.arange(0, FEATURES) - source = tl.load(SRC + edge, edge < end, other=0) - relation = tl.load(TYPE + edge, edge < end, other=0) - mask = (edge[:, None] < end) & (feature[None, :] < D) - state = tl.load(S + batch * SB + source[:, None] * SN + feature[None, :] * SD, mask, other=0) - rel = tl.load(R + batch * RB + relation[:, None] * RN + feature[None, :] * RD, mask, other=0) - total = tl.sum(state.to(tl.float32) * rel.to(tl.float32), axis=0) - tl.atomic_add(O + (batch * N + row) * D + feature, total, feature < D, sem='relaxed') - - def distmult_sum(states, boundary, relations, layout): batch, nodes, dim = states.shape + edges = (layout.offsets, layout.sources, layout.types) + shape = (*states.stride(), *relations.stride()) + width = triton.next_power_of_2(dim) # Split high-degree rows into independent tiles. This avoids serial hub # loops and retains O(B*N*D) activation memory. Deterministic mode instead - # assigns each output row to one program, without floating-point atomics. - if len(layout[1]) > 16 * nodes and not torch.are_deterministic_algorithms_enabled(): + # keeps each row's sequential tile order, without floating-point atomics. + if len(layout.sources) > 16 * nodes and not torch.are_deterministic_algorithms_enabled(): # Tile atomics always accumulate in float32, including FP16/BF16 input. output = boundary.to(torch.float32).clone(memory_format=torch.contiguous_format) - if batch and len(layout[3]): - _distmult_tiles[(len(layout[3]), batch)]( - states, relations, output, *layout, - *states.stride(), *relations.stride(), nodes, dim, - triton.next_power_of_2(dim), num_warps=4, enable_fp_fusion=False, - ) + if batch and len(layout.tile_rows): + _tile_sums[(len(layout.tile_rows), batch)]( + states, relations, output, *edges, layout.tile_rows, layout.tile_starts, 0, + *shape, nodes, dim, width, 32, True, num_warps=4, enable_fp_fusion=False) return output.to(states.dtype) output = torch.empty_like(states, memory_format=torch.contiguous_format) - if batch and nodes: - _distmult_sum[(nodes, batch)]( - states, relations, boundary, output, *layout[:3], - *states.stride(), *relations.stride(), *boundary.stride(), - nodes, dim, triton.next_power_of_2(dim), 32, - num_warps=4, enable_fp_fusion=False, - ) + if not batch or not nodes: + return output + # Hub rows read their tile sums from balanced programs instead of looping + # serially; adding them in order is bitwise equal to the single-pass loop. + hubs = len(layout.hub_rows) + partials = torch.empty((batch, max(hubs, 1), dim), device=states.device, dtype=torch.float32) + if hubs: + _tile_sums[(hubs, batch)]( + states, relations, partials, *edges, layout.hub_rows, layout.hub_starts, hubs, + *shape, nodes, dim, width, 32, False, num_warps=4, enable_fp_fusion=False) + _distmult_sum[(nodes, batch)]( + states, relations, boundary, output, *edges, layout.hub_first, partials, max(hubs, 1), + *shape, *boundary.stride(), nodes, dim, width, 32, 8, num_warps=4, enable_fp_fusion=False) return output diff --git a/dicee/models/flock.py b/dicee/models/flock.py index a1e1b25a9..d6d1cdcf3 100644 --- a/dicee/models/flock.py +++ b/dicee/models/flock.py @@ -316,6 +316,60 @@ class Flock(FlockBase): """Entity-prediction Flock with official ``flock_entity.pth`` parameters.""" name = "Flock" + @torch.no_grad() + def forward_k_vs_all_seeded(self, queries, seeds, *, samples=None): + """Batch inference with independent, batch-invariant sampling seeds.""" + if self.training: + raise ValueError('Seeded scoring requires evaluation mode') + n, _ = self._require_graph() + samples = self.test_samples if samples is None else samples + if type(samples) is not int or samples < 1 or len(seeds) != len(queries): + raise ValueError('Provide a seed per query and a positive sample count') + if any(type(seed) is not int or not 0 <= seed < 2**63 for seed in seeds): + raise ValueError('Seeds must be integers in [0, 2**63)') + queries = torch.as_tensor(queries, device=self.device, dtype=torch.long) + if queries.ndim != 2 or queries.shape[1] != 2: + raise ValueError('Expected [batch, 2] head/relation queries') + if not len(queries): + return self.node_init.new_empty((0, n)) + if ((queries[:, 0] < 0) | (queries[:, 0] >= n) | (queries[:, 1] < 0) | (queries[:, 1] >= self.num_relations)).any(): + raise ValueError('Query outside the public vocabulary') + heads = queries[:, 0].repeat_interleave(samples) + relations = self.relation_id_map[queries[:, 1]].repeat_interleave(samples) + cpu_heads = heads.cpu() + generators = {} + + def draw(start): + records = [] + for index in range(start, min(start + self.query_batch_size, len(heads))): + row = index // samples + if row not in generators: + generators[row] = torch.Generator().manual_seed(seeds[row]) + records.append(self._draw_walks(self._walk_graph, cpu_heads[index:index + 1], None, generators[row])) + if index % samples == samples - 1: + del generators[row] + packed = tuple(torch.cat(parts, dim=1) for parts in zip(*records)) + return self._transfer_records(packed) if self.device.type == 'cuda' else packed + + def score(start, records): + stop = min(start + self.query_batch_size, len(heads)) + candidates = torch.arange(n, device=self.device).expand(stop - start, -1) + return self.score_walks(heads[start:stop], relations[start:stop], candidates, records) + + starts = range(0, len(heads), self.query_batch_size) + if self.prefetch_walks and self.device.type == 'cuda' and len(heads) > self.query_batch_size: + with ThreadPoolExecutor(max_workers=1) as pool: + future = pool.submit(draw, 0) + output = [] + for start in starts: + records = future.result() + if start + self.query_batch_size < len(heads): + future = pool.submit(draw, start + self.query_batch_size) + output.append(score(start, records)) + else: + output = [score(start, draw(start)) for start in starts] + return torch.cat(output).view(len(queries), samples, n).mean(1) + def _score(self, heads, relations, candidates, query_relations, edges): # Unlike ULTRA/TRIX, query conditioning occurs after head-to-tail # conversion, using the actual (possibly inverse) relation ID. diff --git a/dicee/models/graph_model.py b/dicee/models/graph_model.py index 16aa817b3..56956e7ed 100644 --- a/dicee/models/graph_model.py +++ b/dicee/models/graph_model.py @@ -34,7 +34,7 @@ from torch import nn from ._fused_message import tensor_version -from ._inference import float32_precision_token +from ._inference import float32_precision_token, to_device from .base_model import BaseKGE @@ -254,7 +254,12 @@ def forward_k_vs_sample(self, x, target_entity_idx): raise ValueError('Tail queries must have shape [B, 2] in (head, relation) order') if x.numel() and (x.min() < 0 or x[:, 0].max() >= self.num_entities or x[:, 1].max() >= self.num_relations): raise ValueError('Query IDs are outside the graph vocabulary') - x = x.to(device=self.device) + # Host queries were validated without a device read; keep their relation + # IDs on the host so inference caches need no device-to-host copy. + host_ids = None + if x.device.type == 'cpu' and self.device.type != 'cpu': + host_ids = (self._host_relation_map()[x[:, 1]] % self.num_direct_relations).tolist() + x = to_device(x, self.device) queries = torch.stack((x[:, 0], self.relation_id_map[x[:, 1]]), dim=1) candidates = target_entity_idx.to(dtype=torch.long) if candidates.ndim == 1: @@ -267,7 +272,20 @@ def forward_k_vs_sample(self, x, target_entity_idx): candidates = candidates.to(device=self.device) if all_entities: candidates._dicee_all_entities = True - return self._score(queries[:, 0], queries[:, 1], candidates, queries[:, 1] % self.num_direct_relations, self._training_edges(queries=queries)) + query_relations = queries[:, 1] % self.num_direct_relations + if host_ids is not None: + query_relations._dicee_ids = host_ids + return self._score(queries[:, 0], queries[:, 1], candidates, query_relations, self._training_edges(queries=queries)) + + def _host_relation_map(self): + """Host copy of the internal relation map, reused while the buffer is unchanged.""" + mapping = self.relation_id_map + version = tensor_version(mapping) + cached = getattr(self, '_host_relation_cache', None) + if cached is None or cached[0] is not mapping or cached[1] != version or version is None: + cached = mapping, version, mapping.cpu() + self._host_relation_cache = cached + return cached[2] def forward_k_vs_all(self, x): num_entities, _ = self._require_graph() diff --git a/dicee/models/trix.py b/dicee/models/trix.py index d44041f88..709d61dd5 100644 --- a/dicee/models/trix.py +++ b/dicee/models/trix.py @@ -11,7 +11,7 @@ import torch from torch import nn -from ._inference import candidate_features, candidate_slice, conditioned_linear, conditioned_score, inference_only +from ._inference import candidate_features, candidate_slice, conditioned_linear, conditioned_score, host_ids, inference_only, to_device from .graph_model import GraphKGE, RelationGraphKGE from .ultra import RelationalConv @@ -141,7 +141,9 @@ def clear_inference_cache(self): def _first_relation_step(self, query_relations): weight = next(self.parameters()) boundary = weight.new_zeros(len(query_relations), 2 * self.num_direct_relations, self.dim) - boundary[torch.arange(len(query_relations), device=query_relations.device), query_relations] = 1 + # A device scalar avoids a host copy (and stream synchronization) per call. + boundary.index_put_((torch.arange(len(query_relations), device=query_relations.device), query_relations), + boundary.new_ones(())) # All entities initially have the same label. Project a single label # per query and broadcast it *after* the MLP, retaining the graph layout. entities = weight.new_ones(len(query_relations), 1, self.dim) @@ -160,12 +162,12 @@ def _cached_initial_relations(self, query_relations): if token != self._initial_cache_token: self._initial_cache.clear() self._initial_cache_token = token - ids = query_relations.tolist() + ids = host_ids(query_relations) missing = list(dict.fromkeys(q for q in ids if q not in self._initial_cache)) values = {q: self._initial_cache[q] for q in set(ids) if q in self._initial_cache} for start in range(0, len(missing), self.query_batch_size): keys = missing[start:start + self.query_batch_size] - hidden = self._first_relation_step(query_relations.new_tensor(keys)) + hidden = self._first_relation_step(to_device(torch.tensor(keys), query_relations.device)) values.update((key, value.clone()) for key, value in zip(keys, hidden)) for key in dict.fromkeys(ids): self._initial_cache[key] = values[key] @@ -182,7 +184,7 @@ def _reason(self, heads, relations, query_relations, edges, initial=None): features, query = self.entity_model_1.features(edges, num_entities, hidden, heads, relations, split=True) entities = conditioned_linear(self.relation_model.node_mlp, features, query) boundary = weight.new_zeros(len(heads), 2 * self.num_direct_relations, self.dim) - boundary[torch.arange(len(heads), device=heads.device), query_relations] = 1 + boundary.index_put_((torch.arange(len(heads), device=heads.device), query_relations), boundary.new_ones(())) for i in (1, 2): hidden = self.relation_model.step(i, hidden, boundary, self.relation_graph, entities) return hidden diff --git a/dicee/models/ultra.py b/dicee/models/ultra.py index a80685107..922e06376 100644 --- a/dicee/models/ultra.py +++ b/dicee/models/ultra.py @@ -35,7 +35,7 @@ from torch import nn from ._fused_message import fused_distmult_sum, fused_norm_relu -from ._inference import candidate_features, candidate_slice, compiled_conv_update, conditioned_score, inference_only +from ._inference import cached_relation_batch, candidate_features, candidate_slice, compiled_conv_update, conditioned_score, host_ids, inference_only, to_device from .graph_model import GraphKGE UPSTREAM_COMMIT = "427966ad8ed60420eef034063d44f3153addff90" @@ -198,14 +198,14 @@ def _cached_relations(self, query_relations): if token != self._relation_cache_token: self.clear_inference_cache() self._relation_cache_token = token - ids = query_relations.tolist() + ids = host_ids(query_relations) missing = list(dict.fromkeys(q for q in ids if q not in self._relation_cache)) # Keep current-call values alive even when they exceed the LRU capacity. values = {q: self._relation_cache[q] for q in set(ids) if q in self._relation_cache} for start in range(0, len(missing), self.query_batch_size): keys = missing[start:start + self.query_batch_size] rels = self.relation_model(self.rel_edge_index, self.rel_edge_type, 2 * self.num_direct_relations, - query_relations.new_tensor(keys)) + to_device(torch.tensor(keys), query_relations.device)) for key, value in zip(keys, rels): values[key] = value.clone() for key in dict.fromkeys(ids): @@ -228,7 +228,7 @@ def _cached_projections(self, rels, ids, token): missing = list(dict.fromkeys(q for q in ids if q not in self._projection_cache)) values = {q: self._projection_cache[q] for q in set(ids) if q in self._projection_cache} if missing: - indices = rels.new_tensor([ids.index(q) for q in missing], dtype=torch.long) + indices = to_device(torch.tensor([ids.index(q) for q in missing], dtype=torch.long), rels.device) source = rels.index_select(0, indices) projected = [layer.relation_projection(source) for layer in self.entity_model.layers] for i, key in enumerate(missing): @@ -238,7 +238,7 @@ def _cached_projections(self, rels, ids, token): self._projection_cache.move_to_end(key) while len(self._projection_cache) > capacity: self._projection_cache.popitem(last=False) - return tuple(torch.stack([values[q][i] for q in ids]) for i in range(self.num_layers)) + return tuple(cached_relation_batch({q: value[i] for q, value in values.items()}, ids) for i in range(self.num_layers)) def _score(self, heads, relations, candidates, query_relations, edges): output = [] diff --git a/dicee/query_answering/__init__.py b/dicee/query_answering/__init__.py new file mode 100644 index 000000000..b02b671e0 --- /dev/null +++ b/dicee/query_answering/__init__.py @@ -0,0 +1,14 @@ +"""Shared complex-query inference and trainable score adapters.""" + +from .adapter_training import AdapterFitResult, AdapterQuery, AdapterTrainingData, fit_query_adapter, prepare_adapter_data +from .benchmark import benchmark_model, evaluate_benchmark, summarize_benchmarks +from .context import QueryContext +from .datasets import BENCHMARK_DATASETS, PLUS_H_DATASETS, BenchmarkQuery, QueryBenchmark, load_benchmark +from .engine import QueryAnswerer +from .method_evaluation import evaluate_method +from .score_adapter import QueryScoreAdapter + +__all__ = ['QueryAnswerer', 'QueryContext', 'QueryScoreAdapter', 'evaluate_method', 'AdapterQuery', 'AdapterTrainingData', + 'AdapterFitResult', 'prepare_adapter_data', 'fit_query_adapter', + 'BENCHMARK_DATASETS', 'PLUS_H_DATASETS', 'BenchmarkQuery', 'QueryBenchmark', 'load_benchmark', + 'benchmark_model', 'evaluate_benchmark', 'summarize_benchmarks'] diff --git a/dicee/query_answering/__main__.py b/dicee/query_answering/__main__.py new file mode 100644 index 000000000..448fba832 --- /dev/null +++ b/dicee/query_answering/__main__.py @@ -0,0 +1,103 @@ +"""Fit query adapters and run benchmarks: python -m dicee.query_answering --help.""" + +import argparse +import json +from pathlib import Path + +from .adapter_training import TRAINING_SHAPES, AdapterTrainingData, fit_query_adapter, prepare_adapter_data +from .benchmark import add_benchmark_parser, run_benchmark_cli +from .context import QueryContext +from .score_adapter import FEATURE_COUNTS, QueryScoreAdapter, canonical_feature_mode + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + commands = parser.add_subparsers(dest='command', required=True) + add_benchmark_parser(commands) + prepare = commands.add_parser('prepare', help='Mask source facts and generate disjoint logical queries') + prepare.add_argument('--source', type=Path, required=True, help='QueryContext JSON: triples, num_entities, num_relations, inverse_relations') + prepare.add_argument('--name', default='source') + prepare.add_argument('--output', type=Path, required=True) + prepare.add_argument('--mask-fraction', type=float, default=.3) + prepare.add_argument('--train-per-shape', type=int, default=96) + prepare.add_argument('--validation-per-shape', type=int, default=32) + prepare.add_argument('--seed', type=int, default=2026090851) + prepare.add_argument('--shapes', nargs='+', choices=TRAINING_SHAPES, default=['2i', '3i']) + fit = commands.add_parser('fit', help='Fit adapters for a frozen DICE experiment') + fit.add_argument('--experiment', required=True) + fit.add_argument('--data', type=Path, nargs='+', required=True) + fit.add_argument('--output', type=Path, required=True, help='Output directory for adapter, report, and score banks') + fit.add_argument('--feature-mode', type=canonical_feature_mode, choices=FEATURE_COUNTS, + default='context_scores', help='Adapter features (default: context_scores, linear head)') + fit.add_argument('--epochs', type=int, default=20) + fit.add_argument('--batch-size', type=int, default=8) + fit.add_argument('--row-batch-size', type=int, default=8) + fit.add_argument('--learning-rate', type=float, default=.02) + fit.add_argument('--observed-mix', type=float, default=1.) + fit.add_argument('--bias-bound', type=float, default=4.) + fit.add_argument('--scale-bound', type=lambda v: None if v == 'none' else float(v), default=2.) + fit.add_argument('--beam-size', type=int, default=64) + fit.add_argument('--tnorm', choices=['prod', 'min'], default='prod') + fit.add_argument('--normalization', choices=['none', 'standard'], default='none') + fit.add_argument('--hidden-dim', type=int, default=0) + fit.add_argument('--validation-every', type=int) + fit.add_argument('--early-stopping-patience', type=int, help='Epochs without source-validation MRR improvement') + fit.add_argument('--seed', type=int, default=2026090851) + fit.add_argument('--samples', type=int) + fit.add_argument('--device', default='cpu') + fit.add_argument('--training-device', choices=['cpu', 'cuda'], default='cpu') + fit.add_argument('--validation-device', choices=['cpu', 'cuda']) + fit.add_argument('--cpu-threads', type=int) + fit.add_argument('--training-cache-mb', type=int, default=1536) + fit.add_argument('--device-cache-mb', type=int, default=512) + fit.add_argument('--compare-global', action='store_true', help='Also fit a two-parameter baseline, reusing frozen score banks') + args = parser.parse_args() + if args.command == 'benchmark': + run_benchmark_cli(args) + return + if args.command == 'prepare': + data = prepare_adapter_data(QueryContext(**json.loads(args.source.read_text())), name=args.name, + mask_fraction=args.mask_fraction, train_per_shape=args.train_per_shape, + validation_per_shape=args.validation_per_shape, seed=args.seed, shapes=args.shapes) + args.output.parent.mkdir(parents=True, exist_ok=True) + data.save(args.output) + print(f'Saved {len(data.train)} training and {len(data.validation)} validation queries to {args.output}') + return + from ..knowledge_graph_embeddings import KGE + if args.cpu_threads is not None: + if args.cpu_threads < 1: + parser.error('--cpu-threads must be positive') + import torch + torch.set_num_threads(args.cpu_threads) + kge = KGE(path=args.experiment) + kge.to(args.device) + sources = [AdapterTrainingData.load(path) for path in args.data] + args.output.mkdir(parents=True, exist_ok=True) + modes = [args.feature_mode] + if args.compare_global and args.feature_mode != 'global': + modes.append('global') + reports = {} + for mode in modes: + result = fit_query_adapter(kge.model, sources, feature_mode=mode, observed_mix=args.observed_mix, + epochs=args.epochs, batch_size=args.batch_size, learning_rate=args.learning_rate, + row_batch_size=args.row_batch_size, seed=args.seed, samples=args.samples, + cache_dir=args.output / 'score-banks', bias_bound=args.bias_bound, + scale_bound=args.scale_bound, beam_size=args.beam_size, tnorm=args.tnorm, + normalization=args.normalization, hidden_dim=args.hidden_dim, + validation_every=args.validation_every, + early_stopping_patience=args.early_stopping_patience, + training_device=args.training_device, training_cache_bytes=args.training_cache_mb * 2**20, + validation_device=args.validation_device, + device_cache_bytes=args.device_cache_mb * 2**20, + checkpoint_path=args.output / f'{mode or "default"}-fit-state.pt') + name = result.adapter.feature_mode + path = args.output / f'{name}.json' + result.adapter.save(path) + QueryScoreAdapter.load(path, model=kge.model) + reports[name] = dict(history=result.history, validation=result.validation, metadata=result.adapter.metadata) + print(f'Saved {name} adapter to {path}') + (args.output / 'report.json').write_text(json.dumps(reports, indent=2, allow_nan=False) + '\n') + + +if __name__ == '__main__': + main() diff --git a/dicee/query_answering/_adapter_cache.py b/dicee/query_answering/_adapter_cache.py new file mode 100644 index 000000000..6cf7b82d2 --- /dev/null +++ b/dicee/query_answering/_adapter_cache.py @@ -0,0 +1,219 @@ +"""Bounded host/device caches for frozen scores and parameter-independent features.""" + +import hashlib +import json +import sqlite3 +import time +from collections import OrderedDict +from pathlib import Path + +import numpy as np +import torch + +from ._checkpoint import scoring_fingerprint +from .context import attached_context, fingerprint, state_fingerprint +from .engine import AtomicScorer + + +class TrainingRows: + def __init__(self, model, context, *, cache_dir, row_batch_size, seed, samples, + cache_bytes=128 * 1024**2, disk_bytes=8 * 1024**3, + device='cpu', device_cache_bytes=0): + from ..models._inference import float32_precision_token + + self.model, self.context = model, context + self.device = torch.device(device) + if self.device.type == 'cuda' and self.device.index is None: + self.device = torch.device('cuda', torch.cuda.current_device()) + if min(cache_bytes, disk_bytes, device_cache_bytes) < 0: + raise ValueError('Cache budgets must be nonnegative') + self.row_batch_size, self.seed, self.samples = row_batch_size, seed, samples + self.cache_bytes, self.cache_used, self.cache = cache_bytes, 0, OrderedDict() + self.device_cache_bytes, self.device_cache_used, self.device_cache = device_cache_bytes, 0, OrderedDict() + self.device_rows, self.next_block = {}, 0 + self.feature_cache = OrderedDict() + self.stats = dict(host_hits=0, device_hits=0, disk_rows=0, scored_rows=0, feature_preparations=0, seconds=0.) + self.disk_limit = disk_bytes if cache_dir is not None else min(disk_bytes, cache_bytes) + settings = dict(version=2, backbone=state_fingerprint(model), context=context.identity, + scoring_code=scoring_fingerprint(), architecture=str(model), + args={k: str(v) for k, v in getattr(model, 'args', {}).items()}, + row_batch_size=row_batch_size, seed=seed, samples=samples, + precision=float32_precision_token(), torch=str(torch.__version__), + deterministic=torch.are_deterministic_algorithms_enabled(), + autocast=torch.is_autocast_enabled(next(model.parameters()).device.type), + device=str(next(model.parameters()).device)) + self.identity = fingerprint(settings) + path = ':memory:' + if cache_dir is not None: + Path(cache_dir).mkdir(parents=True, exist_ok=True) + path = str(Path(cache_dir) / f'{self.identity}.sqlite3') + self.connection = sqlite3.connect(path) + self.connection.execute('PRAGMA cache_size=-8192') + self.connection.execute('CREATE TABLE IF NOT EXISTS metadata (identity TEXT PRIMARY KEY, settings TEXT)') + existing = self.connection.execute('SELECT identity, settings FROM metadata').fetchall() + expected = (self.identity, json.dumps(settings, sort_keys=True)) + if existing and existing != [expected]: + raise ValueError('Training row cache identity mismatch') + self.connection.execute('INSERT OR IGNORE INTO metadata VALUES (?, ?)', expected) + self.connection.execute('CREATE TABLE IF NOT EXISTS rows (head INTEGER, relation INTEGER, dtype TEXT, value BLOB, sha256 TEXT, PRIMARY KEY(head, relation))') + self.connection.execute('CREATE TABLE IF NOT EXISTS features (mode TEXT, head INTEGER, relation INTEGER, value BLOB, sha256 TEXT, PRIMARY KEY(mode, head, relation))') + self.feature_code = fingerprint({name: hashlib.sha256(Path(__file__).with_name(name).read_bytes()).hexdigest() + for name in ('score_adapter.py', '_adapter_cache.py')}) + self.connection.commit() + self.disk_used = self.connection.execute('SELECT COALESCE(SUM(LENGTH(value)), 0) FROM rows').fetchone()[0] + + def prepared(self, adapter, conditions, *, device=None): + start = time.perf_counter() + target = self.device if device is None else torch.device(device) + if target.type == 'cuda' and target.index is None: + target = torch.device('cuda', torch.cuda.current_device()) + if target.type != 'cpu' and target != self.device: + raise ValueError('Prepared rows require CPU or the configured cache device') + mode = json.dumps((self.feature_code, adapter.feature_mode, adapter.normalization)) + ready, pending = {}, [] + for pair in dict.fromkeys(conditions): + key = (mode, pair) + if target.type != 'cpu' and key in self.device_rows: + block, index = self.device_rows[key] + ready[pair] = tuple(v[index] for v in self.device_cache[block][1]) + self.device_cache.move_to_end(block) + self.stats['device_hits'] += 1 + elif key in self.cache: + ready[pair] = self.cache[key] + self.cache.move_to_end(key) + self.stats['host_hits'] += 1 + else: + pending.append(pair) + records, features = {}, {} + for offset in range(0, len(pending), 256): + batch = pending[offset:offset + 256] + where = ','.join('(?,?)' for _ in batch) + args = [v for pair in batch for v in pair] + records.update({(h, r): (dtype, value, digest) for h, r, dtype, value, digest in self.connection.execute( + f'WITH wanted(head,relation) AS (VALUES {where}) ' + 'SELECT r.head,r.relation,r.dtype,r.value,r.sha256 FROM wanted w ' + 'JOIN rows r ON r.head=w.head AND r.relation=w.relation', args)}) + features.update({(h, r): (value, digest) for h, r, value, digest in self.connection.execute( + f'WITH wanted(head,relation) AS (VALUES {where}) ' + 'SELECT f.head,f.relation,f.value,f.sha256 FROM wanted w ' + 'JOIN features f ON f.head=w.head AND f.relation=w.relation WHERE f.mode=?', [*args, mode])}) + missing = [] + for pair in pending: + if pair in records: + dtype, value, digest = records[pair] + if hashlib.sha256(value).hexdigest() != digest: + raise ValueError('Corrupt training score row') + raw = torch.from_numpy(np.frombuffer(value, dtype=dtype).copy()) + self.stats['disk_rows'] += 1 + self._prepare(adapter, pair, raw, mode, ready, features.get(pair)) + else: + missing.append(pair) + if missing: + # Leave transient backbone activations room on a shared GPU. + self.device_cache.clear() + self.device_rows.clear() + self.device_cache_used = 0 + with attached_context(self.model, self.context): + scorer = AtomicScorer(self.model, self.context, row_batch_size=self.row_batch_size, + seed=self.seed, samples=self.samples) + raw = scorer.rows(missing).cpu() + self.stats['scored_rows'] += len(missing) + for pair, row in zip(missing, raw): + array = row.numpy() + value = array.tobytes() + self.connection.execute('INSERT INTO rows VALUES (?, ?, ?, ?, ?)', + (*pair, array.dtype.str, value, hashlib.sha256(value).hexdigest())) + self.disk_used += len(value) + self._prepare(adapter, pair, row, mode, ready) + while self.disk_used > self.disk_limit: + oldest = self.connection.execute('SELECT rowid, LENGTH(value) FROM rows ORDER BY rowid LIMIT 128').fetchall() + self.connection.executemany('DELETE FROM rows WHERE rowid=?', [(row,) for row, _ in oldest]) + self.disk_used -= sum(size for _, size in oldest) + if self.connection.in_transaction: + self.connection.commit() + if target.type != 'cpu': + pairs = [pair for pair, values in ready.items() if values[0].device != target] + if pairs: + block = tuple(torch.stack([ready[pair][i] for pair in pairs]).to(target) for i in range(3)) + self._remember_device([(mode, pair) for pair in pairs], block) + for index, pair in enumerate(pairs): + ready[pair] = tuple(v[index] for v in block) + self.stats['seconds'] += time.perf_counter() - start + values = tuple(torch.stack([ready[pair][i] for pair in conditions]) for i in range(3)) + return values[0].to(torch.float64), values[1], values[2] + + def _prepare(self, adapter, pair, raw, mode, ready, saved=None): + if raw.shape != (self.context.num_entities,) or not torch.isfinite(raw).all(): + raise ValueError('Invalid training score row') + stored = raw.clone() if raw._base is not None else raw + raw = raw.to(torch.float64) + key = (mode, pair) + fixed = self.feature_cache.get(key) + if fixed is None and saved is not None: + value, digest = saved + if hashlib.sha256(value).hexdigest() != digest: + raise ValueError('Corrupt training features') + fixed = torch.from_numpy(np.frombuffer(value, dtype=np.float64).copy()) + if fixed is None: + observed, base = self.context.features([pair], device='cpu') + _, _, features = adapter.prepare(raw[None], observed, base) + mean, std = raw.new_zeros(1), raw.new_ones(1) + if adapter.normalization == 'standard': + mean = raw[None].mean(1) + std = raw[None].std(1, correction=0).clamp_min(1e-6) + fixed = torch.cat((features[0], mean, std)).detach() + value = fixed.numpy().tobytes() + self.connection.execute('INSERT OR REPLACE INTO features VALUES (?, ?, ?, ?, ?)', + (mode, *pair, value, hashlib.sha256(value).hexdigest())) + self.stats['feature_preparations'] += 1 + self.feature_cache[key] = fixed + self.feature_cache.move_to_end(key) + while len(self.feature_cache) > 4096: + self.feature_cache.popitem(last=False) + observed = torch.zeros(self.context.num_entities, dtype=torch.bool) + observed[sorted(self.context.outgoing.get(pair[0], {}).get(pair[1], set()))] = True + if adapter.normalization == 'standard': + raw = (raw - fixed[-2]) / fixed[-1] + else: + raw = stored + values = raw, observed, fixed[:-2] + ready[pair] = values + self._remember('', key, values) + + def _remember(self, prefix, key, values): + cache = getattr(self, prefix + 'cache') + used, limit = getattr(self, prefix + 'cache_used'), getattr(self, prefix + 'cache_bytes') + size = sum(v.numel() * v.element_size() for v in values) + if size <= limit: + old = cache.pop(key, ()) + used -= sum(v.numel() * v.element_size() for v in old) + while cache and used + size > limit: + _, old = cache.popitem(last=False) + used -= sum(v.numel() * v.element_size() for v in old) + cache[key] = values + setattr(self, prefix + 'cache_used', used + size) + + def _remember_device(self, keys, values): + # Charge whole allocations: evicted row views must not hide live blocks. + size = sum(v.numel() * v.element_size() for v in values) + if size > self.device_cache_bytes: + return + while self.device_cache and self.device_cache_used + size > self.device_cache_bytes: + block, (old_keys, old) = self.device_cache.popitem(last=False) + self.device_cache_used -= sum(v.numel() * v.element_size() for v in old) + for key in old_keys: + if self.device_rows.get(key, (None,))[0] == block: + del self.device_rows[key] + block = self.next_block + self.next_block += 1 + self.device_cache[block] = (keys, values) + self.device_cache_used += size + for index, key in enumerate(keys): + self.device_rows[key] = block, index + + def close(self): + self.connection.close() + self.cache.clear() + self.device_cache.clear() + self.device_rows.clear() + self.feature_cache.clear() diff --git a/dicee/query_answering/_checkpoint.py b/dicee/query_answering/_checkpoint.py new file mode 100644 index 000000000..9e7b6e855 --- /dev/null +++ b/dicee/query_answering/_checkpoint.py @@ -0,0 +1,112 @@ +"""Atomic, single-writer benchmark checkpoints.""" + +import hashlib +import json +import os +from pathlib import Path + +from .context import fingerprint + + +def write_json(path, value): + path = Path(path) + path.parent.mkdir(parents=True, exist_ok=True) + temporary = path.with_suffix(path.suffix + '.tmp') + with temporary.open('w') as stream: + json.dump(value, stream, indent=2, allow_nan=False) + stream.write('\n') + stream.flush() + os.fsync(stream.fileno()) + temporary.replace(path) + + +class BenchmarkCheckpoint: + def __init__(self, directory, identity): + self.directory = Path(directory) + self.identity = fingerprint(identity) + self.lock = None + + def __enter__(self): + self.directory.mkdir(parents=True, exist_ok=True) + self.lock = (self.directory / '.lock').open('a+b') + try: + if os.name == 'nt': + import msvcrt + self.lock.write(b'0') + self.lock.flush() + self.lock.seek(0) + msvcrt.locking(self.lock.fileno(), msvcrt.LK_NBLCK, 1) + else: + import fcntl + fcntl.flock(self.lock.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB) + except OSError as error: + self.lock.close() + raise RuntimeError(f'Benchmark already running: {self.directory}') from error + try: + manifest = self.directory / 'manifest.json' + expected = dict(version=1, identity=self.identity) + if manifest.exists(): + if json.loads(manifest.read_text()) != expected: + raise ValueError('Benchmark inputs/settings changed; use a new checkpoint directory') + else: + write_json(manifest, expected) + except BaseException: + self.__exit__(None, None, None) + raise + return self + + def load(self): + path = self.directory / 'state.json' + if not path.exists(): + return None + record = json.loads(path.read_text()) + if record.get('identity') != self.identity or record.get('sha256') != fingerprint(record['state']): + raise ValueError('Corrupt benchmark checkpoint') + return record['state'] + + def save(self, state): + write_json(self.directory / 'state.json', dict(identity=self.identity, sha256=fingerprint(state), state=state)) + + def __exit__(self, *_): + if self.lock is not None: + if os.name == 'nt': + import msvcrt + self.lock.seek(0) + msvcrt.locking(self.lock.fileno(), msvcrt.LK_UNLCK, 1) + self.lock.close() + + +def checksum(path): + with Path(path).open('rb') as stream: + return hashlib.file_digest(stream, 'sha256').hexdigest() + + +def source_fingerprint(paths, root): + """Identity of source files, keyed by their path relative to ``root``.""" + return fingerprint({str(Path(path).relative_to(root)): checksum(path) for path in paths}) + + +def implementation_fingerprint(package=None): + """Code that scores and evaluates queries: query answering, models and filtering.""" + package = Path(package) if package is not None else Path(__file__).parents[1] + paths = [*(package / 'query_answering').rglob('*.py'), *(package / 'models').glob('*.py'), + package / 'evaluation' / '_filtering.py'] + return source_fingerprint(paths, package) + + +def scoring_fingerprint(package=None): + """Code that produces atomic query rows: models, engine and context.""" + package = Path(package) if package is not None else Path(__file__).parents[1] + paths = [*(package / 'models').glob('*.py'), *(package / 'query_answering' / name for name in ('context.py', 'engine.py'))] + return source_fingerprint(paths, package) + + +def read(path): + return json.loads(Path(path).read_text()) + + +def input_path(root, relative): + path = (Path(root) / relative).resolve() + if not path.is_relative_to(Path(root).resolve()): + raise ValueError(f'Input path escapes the mounted input root: {relative}') + return path diff --git a/dicee/query_answering/_deferred.py b/dicee/query_answering/_deferred.py new file mode 100644 index 000000000..39d8d2569 --- /dev/null +++ b/dicee/query_answering/_deferred.py @@ -0,0 +1,52 @@ +"""Validity checks that share one host synchronization per query. + +Reading a CUDA boolean on the host waits for every queued kernel. Inside +``deferred_checks`` such conditions are collected and read together when the +block exits; the first failing check raises its original error. Outside the +block, ``require`` checks immediately, so other callers keep eager errors. +""" + +from contextlib import contextmanager +from contextvars import ContextVar + +import torch + +_PENDING = ContextVar('dicee_pending_checks', default=None) + + +def require(condition, error): + """Raise ``error`` unless the scalar ``condition`` holds.""" + pending = _PENDING.get() + if pending is None or not isinstance(condition, torch.Tensor) or condition.device.type == 'cpu': + if not bool(condition): + raise error + else: + pending.append((condition.reshape(()), error)) + + +def _raise_first(pending): + if pending: + device = pending[0][0].device + flags = torch.stack([condition.to(device) for condition, _ in pending]).tolist() + for passed, (_, error) in zip(flags, pending): + if not passed: + raise error + + +@contextmanager +def deferred_checks(): + """Collect device conditions; an earlier failed check takes precedence over later errors.""" + pending = [] + token = _PENDING.set(pending) + try: + yield + except Exception: + # Interrupts and exits propagate unchanged. + _PENDING.reset(token) + token = None + _raise_first(pending) + raise + finally: + if token is not None: + _PENDING.reset(token) + _raise_first(pending) diff --git a/dicee/query_answering/_query.py b/dicee/query_answering/_query.py new file mode 100644 index 000000000..c5344b72c --- /dev/null +++ b/dicee/query_answering/_query.py @@ -0,0 +1,229 @@ +"""One query grammar and composition algebra for inference and supervision.""" + +import torch + +from .catalog import PLUS_H_SHAPES, QUERY_SHAPES, ULTRAQUERY_SHAPES # noqa: F401 (re-exported) + + +def nested(value): + return tuple(nested(v) for v in value) if isinstance(value, (tuple, list)) else value + + +def index_query(query_type, query, entities, relations): + """Translate named queries by structure, so operator-like names remain valid IDs.""" + if query_type not in QUERY_SHAPES: + raise ValueError(f'Unknown query type {query_type!r}; choose from {sorted(QUERY_SHAPES)}') + + def visit(pattern, value): + if pattern in ('e', 'r'): + mapping = entities if pattern == 'e' else relations + if value not in mapping: + raise ValueError(f'Unknown {"entity" if pattern == "e" else "relation"}: {value!r}') + return mapping[value] + if pattern == 'n': + if value not in ('n', 'not', -2): + raise ValueError('Expected a negation marker (not, n, or -2)') + return -2 + if pattern == 'u': + if value not in ('u', 'union', 'or', -1): + raise ValueError('Expected a union marker (union, u, or -1)') + return -1 + # The named API can infer union from query_type alone. + if isinstance(value, (tuple, list)) and pattern[-1] == ('u',) and len(value) == len(pattern) - 1: + value = (*value, ('union',)) + if not isinstance(value, (tuple, list)) or len(pattern) != len(value): + raise ValueError(f'Query does not match {query_type}: expected {pattern!r}') + return tuple(visit(p, v) for p, v in zip(pattern, value)) + + return visit(QUERY_SHAPES[query_type], query) + + +def compile_query(query): + query = nested(query) + if type(query) is int and query >= 0: + return ('anchor', query) + if not isinstance(query, tuple) or not query: + raise ValueError('Expected an indexed structured query') + if len(query) == 2 and isinstance(query[1], tuple) and query[1] and all(type(r) is int for r in query[1]) and query[1] != (-1,): + node = compile_query(query[0]) + for relation in query[1]: + if relation == -2: + node = ('not', node) + elif relation >= 0: + node = ('project', relation, node) + else: + raise ValueError('Unknown relation/negation marker') + return node + union = query[-1] == (-1,) + branches = query[:-1] if union else query + if len(branches) < 2: + raise ValueError('Composition requires at least two branches') + return ('or' if union else 'and', *(compile_query(q) for q in branches)) + + +def validate_tree(node, n, nr): + if node[0] == 'anchor': + if not 0 <= node[1] < n: + raise ValueError('Anchor outside the entity vocabulary') + elif node[0] == 'project': + if not 0 <= node[1] < nr: + raise ValueError('Relation outside the relation vocabulary') + validate_tree(node[2], n, nr) + else: + for child in node[1:]: + validate_tree(child, n, nr) + + +def positive(node): + if node[0] == 'not': + return False + return all(positive(child) for child in node[1:] if isinstance(child, tuple)) + + +def atomic_conditions(node): + if node[0] == 'project': + if node[2][0] == 'anchor': + yield node[2][1], node[1] + else: + yield from atomic_conditions(node[2]) + elif node[0] != 'anchor': + for child in node[1:]: + yield from atomic_conditions(child) + + +def relation_signature(node): + if node[0] == 'anchor': + return ('anchor',) + if node[0] == 'project': + return ('project', node[1], relation_signature(node[2])) + return (node[0], *(relation_signature(child) for child in node[1:])) + + +def stable_topk(values, k): + """Select descending scores with entity-ID ties and a CPU partial sort.""" + k = min(k, len(values)) + if values.is_cuda or k == len(values): + return values.argsort(descending=True, stable=True)[:k] + threshold = values.topk(k, sorted=False).values.min() + better = (values > threshold).nonzero().flatten() + tied = (values == threshold).nonzero().flatten()[:k - len(better)] + selected = torch.cat((better, tied)).sort().values + return selected[values[selected].argsort(descending=True, stable=True)] + + +def exact_answers(node, outgoing, num_entities): + """Finite-domain set semantics shared by observed proofs and query generation.""" + op = node[0] + if op == 'anchor': + return {node[1]} + if op == 'project': + return set().union(*(outgoing.get(h, {}).get(node[1], set()) for h in exact_answers(node[2], outgoing, num_entities))) + if op == 'not': + return set(range(num_entities)) - exact_answers(node[1], outgoing, num_entities) + if op == 'and' and any(c[0] != 'not' for c in node[1:]): + included = [exact_answers(c, outgoing, num_entities) for c in node[1:] if c[0] != 'not'] + result = set.intersection(*included) + for child in node[1:]: + if child[0] == 'not': + result.difference_update(exact_answers(child[1], outgoing, num_entities)) + return result + branches = [exact_answers(c, outgoing, num_entities) for c in node[1:]] + return set.intersection(*branches) if op == 'and' else set.union(*branches) + + +def log_complement(value): + """Stable log(1-exp(value)), including exact zero/one memberships. + + Masked evaluation avoids undefined derivatives in inactive torch.where branches. + Without gradients on CUDA, selection applies the same per-element operations + without the host synchronization required by boolean indexing. (CPU kernels + may finish array tails with scalar code, so CPU keeps the masked subsets.) + """ + if value.is_cuda and not (torch.is_grad_enabled() and value.requires_grad): + interior = (value < 0) & torch.isfinite(value) + result = torch.where(value < -0.6931471805599453, torch.log1p(-value.exp()), torch.log(-torch.expm1(value))) + result = torch.where(interior, result, torch.nan) + result = torch.where(value == 0, -torch.inf, result) + return torch.where(torch.isneginf(value), 0., result) + result = torch.empty_like(value) + result[value == 0] = -torch.inf + result[torch.isneginf(value)] = 0. + interior = (value < 0) & torch.isfinite(value) + low = interior & (value < -0.6931471805599453) + result[low] = torch.log1p(-value[low].exp()) + high = interior & ~low + result[high] = torch.log(-torch.expm1(value[high])) + result[~(interior | (value == 0) | torch.isneginf(value))] = torch.nan + return result + + +def combine(values, operator, tnorm='prod', *, logits=False): + values = torch.stack(values) + if logits: + if operator == 'and': + return values.prod(0) if tnorm == 'prod' else values.min(0).values + return 1 - (1 - values).prod(0) if tnorm == 'prod' else values.max(0).values + if operator == 'and': + return values.sum(0) if tnorm == 'prod' else values.min(0).values + return log_complement(log_complement(values).sum(0)) if tnorm == 'prod' else values.max(0).values + + +def negate(value, norm='standard', parameter=0., *, logits=False): + if not logits and norm == 'standard': + return log_complement(value) + p = value if logits else value.exp() + if norm == 'standard': + result = 1 - p + elif norm == 'sugeno': + result = (1 - p) / (1 + parameter * p) + else: + result = (1 - p.pow(parameter)).clamp_min(0).pow(1 / parameter) + return result if logits else result.log() + + +def execute_query(tree, row_batches, *, n, device, row_batch_size, beam_size=64, + tnorm="prod", neg_norm="standard", lambda_=0., use_logits=False, executor="cqd", stats=None, skip_zero_prefix=False): + """Compose rows with live beam selection; gradients flow through retained scores.""" + if stats is None: + stats = dict(negated_pruning=False, bound_skipped=0) + def execute(node): + op = node[0] + if op == 'anchor': + result = torch.full((n,), 0. if use_logits else -torch.inf, dtype=torch.float64, device=device) + result[node[1]] = 1. if use_logits else 0. + return result, False + if op == 'project' and node[2][0] == 'anchor': + return next(row_batches([node[2][1]], node[1]))[1][0], False + if op in ('and', 'or'): + branches = [execute(child) for child in node[1:]] + return combine([v for v, _ in branches], op, tnorm, logits=use_logits), any(p for _, p in branches) + if op == 'not': + values, pruned = execute(node[1]) + stats['negated_pruning'] |= pruned + return negate(values, neg_norm, lambda_, logits=use_logits), pruned + prefix, pruned = execute(node[2]) + top = stable_topk(prefix, n if executor == 'qto' else beam_size) + skip = skip_zero_prefix and executor == 'cqd' and not use_logits and not torch.is_grad_enabled() + # One host copy provides the beam and, when needed, its zero-membership flags. + heads, empty = torch.stack((top, torch.isneginf(prefix[top]).long())).tolist() if skip else (top.tolist(), None) + result = torch.full_like(prefix, -torch.inf) + for start in range(0, len(heads), row_batch_size): + # Edge memberships are at most one: remaining prefixes bound every tail. + if executor == 'qto' and (result >= prefix[heads[start]]).all().item(): + stats['bound_skipped'] += len(heads) - start + break + selected = heads[start:start + row_batch_size] + # Keep mixed batches intact: neural scores can depend on batch geometry. + if skip and all(empty[start:start + row_batch_size]): + stats['zero_prefix_skipped'] = stats.get('zero_prefix_skipped', 0) + len(selected) + continue + batch, edges = next(row_batches(selected, node[1])) + # The device beam indexes the same rows without a host-to-device copy. + values = prefix[top[start:start + len(batch)] if batch == selected else batch, None] + if tnorm == 'min': + joined = torch.minimum(values, edges) + else: + joined = values * edges if use_logits else values + edges + result = torch.maximum(result, joined.amax(dim=0)) + return result, pruned or (executor == 'cqd' and beam_size < n) + return execute(tree) diff --git a/dicee/query_answering/_rank_trace.py b/dicee/query_answering/_rank_trace.py new file mode 100644 index 000000000..88ca257ed --- /dev/null +++ b/dicee/query_answering/_rank_trace.py @@ -0,0 +1,46 @@ +"""Transactional rank records for inference-free tie-policy analysis.""" + +import json +import sqlite3 +from pathlib import Path + +from .context import fingerprint + + +class RankTrace: + """One row per query; answer records are [entity, rank, greater, tie_size].""" + + def __init__(self, path, identity, completed): + path = Path(path) + path.parent.mkdir(parents=True, exist_ok=True) + self.connection = sqlite3.connect(path) + try: + self.connection.execute('PRAGMA synchronous=FULL') + self.connection.execute('CREATE TABLE IF NOT EXISTS metadata (identity TEXT NOT NULL)') + self.connection.execute('CREATE TABLE IF NOT EXISTS queries (position INTEGER PRIMARY KEY, query_id TEXT UNIQUE, shape TEXT, answers TEXT)') + rows = self.connection.execute('SELECT identity FROM metadata').fetchall() + if rows and rows != [(fingerprint(identity),)]: + raise ValueError('Rank trace identity changed') + if not rows: + self.connection.execute('INSERT INTO metadata VALUES (?)', (fingerprint(identity),)) + count, last = self.connection.execute('SELECT COUNT(*), MAX(position) FROM queries WHERE position < ?', (completed,)).fetchone() + if count != completed or (completed and last != completed - 1): + raise ValueError('Rank trace is missing checkpointed queries') + self.connection.execute('DELETE FROM queries WHERE position >= ?', (completed,)) + self.connection.commit() + except BaseException: + self.connection.close() + raise + + def add(self, position, query, answers): + self.connection.execute('INSERT INTO queries VALUES (?, ?, ?, ?)', + (position, query.identity, query.shape, json.dumps(answers, separators=(',', ':')))) + + def commit(self): + self.connection.commit() + + def __enter__(self): + return self + + def __exit__(self, *_): + self.connection.close() diff --git a/dicee/query_answering/adapter_training.py b/dicee/query_answering/adapter_training.py new file mode 100644 index 000000000..6a572638d --- /dev/null +++ b/dicee/query_answering/adapter_training.py @@ -0,0 +1,576 @@ +"""Source-only adapter fitting with frozen backbone score banks. + +Fits the shared inference transform using a filtered-softmax loss. +""" + +import copy +import json +import math +import os +import random +import time +from contextlib import ExitStack +from dataclasses import dataclass, field +from pathlib import Path + +import torch + +from ._checkpoint import implementation_fingerprint, scoring_fingerprint +from ._query import QUERY_SHAPES, ULTRAQUERY_SHAPES, atomic_conditions, compile_query, execute_query, nested, positive, validate_tree +from .context import QueryContext, attached_context, fingerprint, state_fingerprint +from .engine import AtomicScorer +from .score_adapter import QueryScoreAdapter + +FLAT_SHAPES = ('2i', '3i', '2in', '3in') +TRAINING_SHAPES = ULTRAQUERY_SHAPES +STANDARD_TRAINING_SHAPES = ('1p', '2p', '3p', '2i', '3i', '2in', '3in', 'inp', 'pin', 'pni') + + +def _canonical_query(query): + if isinstance(query, (int, str)): + return query + if len(query) == 2 and all(isinstance(v, int) or v in ('r', 'n') for v in query[1]) and query[1] not in ((-1,), ('u',)): + return _canonical_query(query[0]), tuple(query[1]) + union = query[-1] in ((-1,), ('u',)) + branches = [_canonical_query(q) for q in (query[:-1] if union else query)] + if all(len(q) == 2 and isinstance(q[0], int) for q in branches): + branches.sort(key=lambda q: (len(q[1]), q)) + else: + branches.sort(key=repr) + return (*branches, query[-1]) if union else tuple(branches) + + +def _structure(query): + if isinstance(query, int): + return 'e' + if len(query) == 2 and all(isinstance(v, int) for v in query[1]) and query[1] != (-1,): + return _structure(query[0]), tuple('n' if r == -2 else 'r' for r in query[1]) + union = query[-1] == (-1,) + branches = tuple(sorted((_structure(q) for q in (query[:-1] if union else query)), key=repr)) + return (*branches, ('u',)) if union else branches + + +_SHAPE_NAMES = {_canonical_query(QUERY_SHAPES[s]): s for s in TRAINING_SHAPES} + + +@dataclass(frozen=True) +class AdapterQuery: + query: tuple + answers: frozenset + + def __post_init__(self): + query = _canonical_query(nested(self.query)) + tree = compile_query(query) + shape = _SHAPE_NAMES.get(_structure(query)) + if shape is None: + raise ValueError('Unsupported adapter training query structure') + conditions = list(atomic_conditions(tree)) + if shape in FLAT_SHAPES and len(set(conditions)) != len(conditions): + raise ValueError('Training intersections require distinct atoms') + object.__setattr__(self, 'query', query) + object.__setattr__(self, 'answers', frozenset(self.answers)) + + @property + def shape(self): + return _SHAPE_NAMES[_structure(self.query)] + + @property + def conditions(self): + return list(atomic_conditions(compile_query(self.query))) + + +@dataclass(frozen=True) +class AdapterTrainingData: + """Prepared context and complete source answer sets, with disjoint query splits.""" + + name: str + context: QueryContext + train: tuple + validation: tuple = () + metadata: dict = field(default_factory=dict) + + def __post_init__(self): + if not self.name or not self.train: + raise ValueError('A named source and nonempty training split are required') + seen = set() + for item in (*self.train, *self.validation): + tree = compile_query(item.query) + validate_tree(tree, self.context.num_entities, self.context.num_relations) + if item.query in seen: + raise ValueError('Training/validation queries must be distinct, including branch permutations') + seen.add(item.query) + if any(type(a) is not int or not 0 <= a < self.context.num_entities for a in item.answers): + raise ValueError('Answer outside the source vocabulary') + easy = self.context.answers(tree) + if ('n' not in item.shape and not easy <= item.answers) or not item.answers - easy: + raise ValueError('Source answers must contain hard answers and all positive context proofs') + if len(item.answers) == self.context.num_entities: + raise ValueError('Training queries need at least one negative candidate') + + def to_dict(self): + def records(items): + return [dict(query=q.query, answers=sorted(q.answers)) for q in items] + return dict(version=1, name=self.name, context=self.context.to_dict(), train=records(self.train), + validation=records(self.validation), metadata=self.metadata) + + def save(self, path): + Path(path).write_text(json.dumps(self.to_dict(), indent=2) + '\n') + + @classmethod + def load(cls, path): + data = json.loads(Path(path).read_text()) + if data.get('version') != 1: + raise ValueError('Unsupported adapter data version') + return cls(data['name'], QueryContext(**data['context']), + tuple(AdapterQuery(**q) for q in data['train']), + tuple(AdapterQuery(**q) for q in data.get('validation', [])), data.get('metadata', {})) + + +def prepare_adapter_data(source, *, name='source', mask_fraction=.3, train_per_shape=96, + validation_per_shape=32, seed=2026090851, max_attempts=100_000, shapes=('2i', '3i'), + extend=None, train_counts=None): + """Mask reciprocal pairs and reuse QueryGenerator's grounding on source facts. + + ``source`` must contain source-training facts only. Never pass target test + facts here. Answer supervision uses the source; scoring sees only the mask. + """ + from ..query_generator import QueryGenerator + if not 0 < mask_fraction < 1 or train_per_shape < 1 or validation_per_shape < 0 or max_attempts < 1: + raise ValueError('Require 0 < mask_fraction < 1 and positive training/attempt counts') + shapes = tuple(shapes) + if not shapes or len(set(shapes)) != len(shapes) or any(s not in TRAINING_SHAPES for s in shapes): + raise ValueError(f'Choose distinct training shapes from {TRAINING_SHAPES}') + counts = {s: train_per_shape for s in shapes} if train_counts is None else dict(train_counts) + if set(counts) != set(shapes) or any(type(n) is not int or n < 1 for n in counts.values()): + raise ValueError('Positive training counts required for every prepared shape') + rng = random.Random(seed) + inverse = {a: b for h, t in source.inverse_relations for a, b in ((h, t), (t, h))} + def canonical(edge): + h, r, t = edge + return min(edge, (t, inverse[r], h)) if r in inverse else edge + pairs = sorted({canonical(edge) for edge in source.triples}) + count = max(1, round(len(pairs) * mask_fraction)) + if count >= len(pairs): + raise ValueError('Source is too small to retain a nonempty masked graph') + hidden = set(rng.sample(pairs, count)) + context = QueryContext([edge for edge in source.triples if canonical(edge) not in hidden], + source.num_entities, source.num_relations, source.inverse_relations) + if extend is not None: + if (extend.name != name or extend.context.identity != context.identity + or extend.metadata.get('source_sha256') != source.identity + or set(q.shape for q in (*extend.train, *extend.validation)) - set(shapes)): + raise ValueError('Extension requires the same source, mask, name, and shapes') + for shape in shapes: + if (sum(q.shape == shape for q in extend.train) > counts[shape] + or sum(q.shape == shape for q in extend.validation) != validation_per_shape): + raise ValueError('Extension must retain all training and validation queries') + generator = QueryGenerator.from_context(source, seed=seed) + training = list(extend.train) if extend is not None else [] + validation = list(extend.validation) if extend is not None else [] + seen = {q.query for q in (*training, *validation)} + for shape in shapes: + width = int(shape[0]) if shape in FLAT_SHAPES else 1 + targets = sorted(t for t, rs in generator.ent_in.items() if sum(map(len, rs.values())) >= width) + examples = [] + required = (counts[shape] - sum(q.shape == shape for q in training) if extend is not None + else counts[shape] + validation_per_shape) + for _ in range(max_attempts): + if len(examples) == required or not targets: + break + query = generator.tuple2list(QUERY_SHAPES[shape]) + if generator.fill_query(query, generator.ent_in, generator.ent_out, rng.choice(targets)): + continue + query = _canonical_query(nested(query)) + if query in seen: + continue + tree = compile_query(query) + answers = source.answers(tree) + context_answers = context.answers(tree) + if not answers - context_answers or len(answers) == source.num_entities: + continue + if 'n' in shape and not context_answers - answers: + continue + seen.add(query) + examples.append(AdapterQuery(query, answers)) + if len(examples) != required: + raise ValueError(f'Only generated {len(examples)} distinct {shape} queries; reduce counts or supply prepared data') + rng.shuffle(examples) + if extend is None: + training.extend(examples[:counts[shape]]) + validation.extend(examples[counts[shape]:]) + else: + training.extend(examples) + return AdapterTrainingData(name, context, tuple(training), tuple(validation), + dict(extend.metadata if extend is not None else {}, + source_sha256=source.identity, seed=seed, mask_fraction=mask_fraction, + masked_fact_pairs=count, train_per_shape=train_per_shape, + train_counts=counts, + validation_per_shape=validation_per_shape, shapes=list(shapes))) + + +def _bank(model, data, *, cache_dir, row_batch_size, seed, samples, device='cpu', + cache_bytes=128 * 1024**2, device_cache_bytes=0): + if any(q.shape not in FLAT_SHAPES for q in (*data.train, *data.validation)): + from ._adapter_cache import TrainingRows + provider = TrainingRows(model, data.context, cache_dir=cache_dir, row_batch_size=row_batch_size, + seed=seed, samples=samples, device=device, + cache_bytes=cache_bytes, device_cache_bytes=device_cache_bytes) + return dict(provider=provider, identity=provider.identity, context=data.context) + from ..models._inference import float32_precision_token + conditions = sorted({pair for q in (*data.train, *data.validation) for pair in q.conditions}) + settings = {name: getattr(model, name, None) for name in ( + 'query_batch_size', 'test_samples', 'walk_num', 'walk_len', 'refinements', + 'compact_state', 'compile_sampler', 'pack_walks', 'prefetch_walks', '_inference_backend')} + identity = dict(version=1, backbone=state_fingerprint(model), context=data.context.identity, + conditions=conditions, seed=seed, samples=samples, row_batch_size=row_batch_size, + settings=settings, torch=str(torch.__version__), device=str(next(model.parameters()).device), + precision=float32_precision_token(), deterministic=torch.are_deterministic_algorithms_enabled(), + autocast=torch.is_autocast_enabled(next(model.parameters()).device.type), + scoring_code=scoring_fingerprint(), architecture=str(model), + configuration={k: str(v) for k, v in getattr(model, 'args', {}).items()}) + key = fingerprint(identity) + path = Path(cache_dir) / f'{key}.pt' if cache_dir is not None else None + if path is not None and path.exists(): + bank = torch.load(path, map_location='cpu', weights_only=True) + if bank['identity'] != identity or bank['rows_sha256'] != state_fingerprint({'rows': bank['rows']}): + raise ValueError('Corrupt or mismatched adapter score bank') + raw = bank['rows'] + else: + with attached_context(model, data.context): + scorer = AtomicScorer(model, data.context, row_batch_size=row_batch_size, seed=seed, samples=samples) + # Copy each scored batch off the device immediately. + raw = torch.cat([scorer.rows(conditions[i:i + row_batch_size]).cpu() for i in range(0, len(conditions), row_batch_size)]) + if path is not None: + path.parent.mkdir(parents=True, exist_ok=True) + torch.save(dict(identity=identity, rows=raw, rows_sha256=state_fingerprint({'rows': raw})), path) + if raw.shape != (len(conditions), data.context.num_entities) or not torch.isfinite(raw).all(): + raise ValueError('Invalid complete score bank') + observed, base = data.context.features(conditions, device='cpu') + return dict(raw=raw.to(torch.float64), observed=observed, base=base, + indices={pair: i for i, pair in enumerate(conditions)}, identity=key, context=data.context) + + +def _prepared_bank(adapter, bank): + if 'provider' in bank: + return bank + device = adapter.weights.device + if bank.get('prepared_configuration') == adapter.configuration and bank.get('prepared_device') == str(device): + return bank + raw, observed, features = [], [], [] + for start in range(0, len(bank['raw']), 32): + end = start + 32 + r, o, f = adapter.prepare(bank['raw'][start:end], bank['observed'][start:end], bank['base'][start:end]) + raw.append(r) + observed.append(o) + features.append(f) + return dict(bank, prepared_raw=torch.cat(raw).to(device), prepared_observed=torch.cat(observed).to(device), + features=torch.cat(features).to(device), + prepared_configuration=adapter.configuration, prepared_device=str(device)) + + +def _context_answers(bank, query): + cache = bank.setdefault('context_answers', {}) + if query.query not in cache: + cache[query.query] = bank['context'].answers(compile_query(query.query)) + return cache[query.query] + + +def _query_logs(adapter, bank, query): + context = bank['context'] + provider = bank.get('provider') + batch_size = 32 if provider is not None else 8 + + def rows(heads, relation): + for start in range(0, len(heads), batch_size): + batch = heads[start:start + batch_size] + conditions = [(head, relation) for head in batch] + if provider is not None: + raw, observed, features = provider.prepared(adapter, conditions, device=adapter.weights.device) + else: + indices = [bank['indices'][pair] for pair in conditions] + raw, observed, features = (bank[k][indices] for k in ('prepared_raw', 'prepared_observed', 'features')) + yield batch, adapter.transform(raw, observed, features) + + trees = bank.setdefault('trees', {}) + if query.query not in trees: + trees[query.query] = compile_query(query.query) + tree = trees[query.query] + result, _ = execute_query(tree, rows, n=context.num_entities, device=adapter.weights.device, row_batch_size=batch_size, + beam_size=bank.get('beam_size', 64), tnorm=bank.get('tnorm', 'prod')) + if adapter.observed_mix == 1 and positive(tree): + result = result.clone() + result[sorted(_context_answers(bank, query))] = 0. + return result + + +def filtered_softmax_loss(logs, answers, hard_answers): + """Mean log(1 + sum_negative exp(score_negative - score_hard)).""" + negative = torch.ones_like(logs, dtype=torch.bool) + negative[sorted(answers)] = False + if not negative.any() or not hard_answers: + raise ValueError('Loss requires hard answers and negative candidates') + positives = logs[sorted(hard_answers)] + negative_scores = logs[negative] + if torch.isneginf(negative_scores).all(): + # Exact negation can rule out every negative. The loss is then zero; + # logsumexp of all -inf values would introduce undefined gradients. + return positives.sum() * 0. + negative_mass = torch.logsumexp(negative_scores, 0) + return (torch.logaddexp(positives, negative_mass) - positives).mean() + + +def _filtered_ranks(scores, answers, hard): + eligible = torch.ones_like(scores, dtype=torch.bool) + eligible[sorted(answers)] = False + negatives, targets = scores[eligible], scores[sorted(hard)] + if targets.isnan().any() or negatives.isnan().any(): + raise ValueError('Cannot rank NaN prediction scores') + if len(hard) < 8: + better = (negatives[None] > targets[:, None]).sum(1) + tied = (negatives[None] == targets[:, None]).sum(1) + else: + ordered = negatives.sort().values + left = torch.searchsorted(ordered, targets) + right = torch.searchsorted(ordered, targets, right=True) + better, tied = len(ordered) - right, right - left + return (1 + better + tied.to(torch.float64) / 2).tolist() + + +def _validation(adapter, sources, banks): + result = {} + device = banks[0].get('validation_device', adapter.weights.device) if banks else adapter.weights.device + if torch.device(device) != adapter.weights.device: + adapter = copy.deepcopy(adapter).to(device) + with torch.no_grad(): + for source, bank in zip(sources, banks): + bank = _prepared_bank(adapter, bank) + for shape in bank.get('validation_shapes', TRAINING_SHAPES): + metrics = [] + for query in source.validation: + if query.shape != shape: + continue + scores = _query_logs(adapter, bank, query) + hard = query.answers - _context_answers(bank, query) + ranks = _filtered_ranks(scores, query.answers, hard) + metrics.append([sum(1 / rank for rank in ranks) / len(ranks), + *(sum(rank <= k for rank in ranks) / len(ranks) for k in (1, 3, 10))]) + if metrics: + average = torch.tensor(metrics, dtype=torch.float64).mean(0).tolist() + result[f'{source.name}/{shape}'] = dict(zip(('mrr', 'hits1', 'hits3', 'hits10'), average), queries=len(metrics)) + return result + + +def _baseline_validation(adapter, sources, banks, cache_dir): + from ._checkpoint import write_json + if cache_dir is None: + return _validation(adapter, sources, banks) + identity = fingerprint(dict(adapter=adapter.to_dict(), implementation=implementation_fingerprint(), + cpu_threads=torch.get_num_threads(), + sources=[fingerprint(s.to_dict()) for s in sources], + banks=[b['identity'] for b in banks], + execution=[dict(beam=b.get('beam_size', 64), tnorm=b.get('tnorm', 'prod'), shapes=b.get('validation_shapes', TRAINING_SHAPES), + device=str(b.get('validation_device', b.get('device', 'cpu')))) for b in banks])) + path = Path(cache_dir)/f'validation-{identity}.json' + if path.exists(): + saved = json.loads(path.read_text()) + if saved['identity'] != identity or saved['sha256'] != fingerprint(saved['metrics']): + raise ValueError('Corrupt baseline validation cache') + return saved['metrics'] + metrics = _validation(adapter, sources, banks) + write_json(path, dict(identity=identity, metrics=metrics, sha256=fingerprint(metrics))) + return metrics + + +@dataclass +class AdapterFitResult: + adapter: QueryScoreAdapter + history: list + validation: dict + + +def _save_fit(path, state): + path = Path(path) + path.parent.mkdir(parents=True, exist_ok=True) + temporary = path.with_suffix(path.suffix + '.tmp') + with temporary.open('wb') as stream: + torch.save(state, stream) + stream.flush() + os.fsync(stream.fileno()) + temporary.replace(path) + + +def fit_query_adapter(model, sources, *, feature_mode='context_scores', observed_mix=1., epochs=20, batch_size=8, + learning_rate=.02, identity_penalty=.001, gradient_clip=1., seed=2026090851, + cache_dir=None, row_batch_size=8, samples=None, bias_bound=4., normalization='none', + hidden_dim=0, scale_bound=2., beam_size=64, validation_every=None, validation_sources=None, on_epoch=None, + train_shapes=None, training_sources=None, train_per_shape=None, + early_stopping_patience=None, validation_shapes=None, training_device='cpu', + training_cache_bytes=1536 * 1024**2, device_cache_bytes=512 * 1024**2, + checkpoint_path=None, validation_device=None, tnorm='prod'): + """Fit a frozen-backbone adapter; optionally select epochs on source validation.""" + sources = list(sources) + if tnorm not in ('prod', 'min'): + raise ValueError('Choose prod or min t-norm') + device = torch.device(training_device) + validation_device = torch.device(validation_device or device) + cache_device = device if device.type == 'cuda' else validation_device + if any(d.type not in ('cpu', 'cuda') for d in (device, validation_device)) or min(training_cache_bytes, device_cache_bytes) < 0: + raise ValueError('Choose CPU/CUDA training and nonnegative cache budgets') + if not sources or len({d.name for d in sources}) != len(sources): + raise ValueError('Provide nonempty, uniquely named sources') + if min(epochs, batch_size, row_batch_size) < 1 or not all(math.isfinite(v) for v in (learning_rate, identity_penalty, gradient_clip)): + raise ValueError('Positive epoch/batch counts and finite optimizer settings required') + if learning_rate <= 0 or identity_penalty < 0 or gradient_clip <= 0: + raise ValueError('Invalid optimizer settings') + if validation_every is not None and (type(validation_every) is not int or validation_every < 1): + raise ValueError('validation_every must be a positive integer') + if early_stopping_patience is not None: + if type(early_stopping_patience) is not int or early_stopping_patience < 1: + raise ValueError('early_stopping_patience must be a positive number of epochs') + if validation_every is None: + raise ValueError('Early stopping requires source validation checkpoint selection') + train_shapes = tuple(train_shapes or TRAINING_SHAPES) + if any(s not in TRAINING_SHAPES for s in train_shapes): + raise ValueError('Unsupported training shape') + validation_shapes = tuple(validation_shapes or TRAINING_SHAPES) + if not validation_shapes or any(s not in TRAINING_SHAPES for s in validation_shapes): + raise ValueError('Unsupported validation shape') + if type(beam_size) is not int or beam_size < 1: + raise ValueError('Positive beam_size required') + training_names = set(training_sources) if training_sources is not None else {s.name for s in sources} + if not training_names or training_names - {s.name for s in sources}: + raise ValueError('Choose existing training sources') + if train_per_shape is not None and (type(train_per_shape) is not int or train_per_shape < 1): + raise ValueError('train_per_shape must be a positive integer') + feature_mode = feature_mode or 'context_scores' + with ExitStack() as resources: + backbone = state_fingerprint(model) + banks = [] + total_entities = sum(data.context.num_entities for data in sources) + for data in sources: + bank = _bank(model, data, cache_dir=cache_dir, row_batch_size=row_batch_size, seed=seed, samples=samples, + device=cache_device, cache_bytes=training_cache_bytes * data.context.num_entities // total_entities, + device_cache_bytes=device_cache_bytes * data.context.num_entities // total_entities) + banks.append(bank) + if 'provider' in bank: + resources.callback(bank['provider'].close) + for bank in banks: + bank.update(beam_size=beam_size, tnorm=tnorm, validation_shapes=validation_shapes, device=device, validation_device=validation_device) + selection_names = set(validation_sources) if validation_sources is not None else {s.name for s in sources} + validation_indices = [i for i, s in enumerate(sources) if s.name in selection_names and s.validation] + if validation_every is not None and (not validation_indices or selection_names - {s.name for s in sources}): + raise ValueError('Checkpoint selection requires reserved source validation queries') + settings = dict(objective='filtered_softmax_v1', epochs=epochs, batch_size=batch_size, learning_rate=learning_rate, + identity_penalty=identity_penalty, gradient_clip=gradient_clip, seed=seed, + weighting='equal_source_shape', selection='source_validation_mrr' if validation_every else 'final_epoch', + shapes=sorted({q.shape for s in sources for q in s.train if q.shape in train_shapes}), + validation_sources=sorted(selection_names), validation_every=validation_every, + training_sources=sorted(training_names), train_per_shape=train_per_shape, + early_stopping_patience=early_stopping_patience, beam_size=beam_size, tnorm=tnorm, validation_shapes=list(validation_shapes), + device=str(device), validation_device=str(validation_device), cpu_threads=torch.get_num_threads(), training_cache_bytes=training_cache_bytes, + device_cache_bytes=device_cache_bytes) + adapter = QueryScoreAdapter(feature_mode, observed_mix, metadata=dict( + backbone_state_sha256=backbone, training=settings, score_banks=[bank['identity'] for bank in banks], + sources={source.name: fingerprint(source.to_dict()) for source in sources}), bias_bound=bias_bound, scale_bound=scale_bound, + normalization=normalization, hidden_dim=hidden_dim, seed=seed).to(device) + prepared = [_prepared_bank(adapter, bank) for bank in banks] + optimizer = torch.optim.Adam(adapter.parameters(), lr=learning_rate) + examples = [] + selected_counts: dict[tuple[int, str], int] = {} + for i, source in enumerate(sources): + if source.name not in training_names: + continue + for query in source.train: + cell = (i, query.shape) + if query.shape in train_shapes and (train_per_shape is None or selected_counts.get(cell, 0) < train_per_shape): + examples.append((i, query)) + selected_counts[cell] = selected_counts.get(cell, 0) + 1 + if not examples: + raise ValueError('No queries for the selected training shapes') + hard_answers = [q.answers - sources[i].context.answers(compile_query(q.query)) for i, q in examples] + cells = {(i, q.shape) for i, q in examples} + counts = {cell: sum((i, q.shape) == cell for i, q in examples) for cell in cells} + rng, history, best = random.Random(seed), [], None + stopped_early = False + resume_identity = fingerprint(dict(adapter=adapter.to_dict(), implementation=implementation_fingerprint(), + learning_rate=learning_rate, identity_penalty=identity_penalty, + gradient_clip=gradient_clip, seed=seed)) + if checkpoint_path is not None and Path(checkpoint_path).exists(): + saved = torch.load(checkpoint_path, map_location='cpu', weights_only=True) + if saved['identity'] != resume_identity: + raise ValueError('Adapter checkpoint inputs/settings changed') + adapter.load_state_dict(saved['adapter']) + optimizer.load_state_dict(saved['optimizer']) + rng.setstate(saved['rng']) + history, best = saved['history'], saved['best'] + stopped_early = history[-1].get('early_stopped', False) if history else False + for epoch in range(epochs if stopped_early else len(history), epochs): + if device.type == 'cuda': + torch.cuda.synchronize(device) + started = time.perf_counter() + order = list(range(len(examples))) + rng.shuffle(order) + epoch_loss = 0. + for start in range(0, len(order), batch_size): + optimizer.zero_grad() + batch = order[start:start + batch_size] + batch_terms = [] + for index in batch: + i, query = examples[index] + hard = hard_answers[index] + logs = _query_logs(adapter, prepared[i], query) + weight = len(examples) / (len(cells) * counts[i, query.shape]) + term = weight * filtered_softmax_loss(logs, query.answers, hard) / len(batch) + term.backward() + batch_terms.append(term.detach()) + terms = torch.stack(batch_terms).tolist() + if not all(math.isfinite(term) for term in terms): + raise FloatingPointError('Nonfinite adapter training objective') + batch_loss = sum(terms) + penalty = torch.cat([p.reshape(-1) for p in adapter.parameters()]).square().mean() + loss = identity_penalty * penalty + if not torch.isfinite(loss): + raise FloatingPointError('Nonfinite adapter training objective') + loss.backward() + torch.nn.utils.clip_grad_norm_(adapter.parameters(), gradient_clip, error_if_nonfinite=True) + optimizer.step() + epoch_loss += batch_loss + float(loss.detach()) + if device.type == 'cuda': + torch.cuda.synchronize(device) + record = dict(epoch=epoch + 1, loss=epoch_loss / math.ceil(len(examples) / batch_size), + train_seconds=time.perf_counter() - started) + if validation_every and ((epoch + 1) % validation_every == 0 or epoch + 1 == epochs): + started = time.perf_counter() + metrics = _validation(adapter, [sources[i] for i in validation_indices], [prepared[i] for i in validation_indices]) + record['validation_seconds'] = time.perf_counter() - started + record['validation_mrr'] = sum(v['mrr'] for v in metrics.values()) / len(metrics) + if not math.isfinite(record['validation_mrr']): + raise FloatingPointError('Nonfinite source-validation MRR') + if best is None or record['validation_mrr'] > best[0]: + best = (record['validation_mrr'], epoch + 1, + {k: v.detach().clone() for k, v in adapter.state_dict().items()}, metrics) + if early_stopping_patience is not None: + record.update(best_epoch=best[1], epochs_without_improvement=epoch + 1 - best[1]) + stopped_early = epoch + 1 < epochs and epoch + 1 - best[1] >= early_stopping_patience + record['early_stopped'] = stopped_early + history.append(record) + if checkpoint_path is not None and ((epoch + 1) % (validation_every or 1) == 0 or epoch + 1 == epochs): + _save_fit(checkpoint_path, dict(identity=resume_identity, adapter=adapter.state_dict(), + optimizer=optimizer.state_dict(), rng=rng.getstate(), history=history, best=best)) + if on_epoch is not None: + on_epoch(record) + if stopped_early: + break + if best is not None: + adapter.load_state_dict(best[2]) + settings.update(selected_epoch=best[1], selected_validation_mrr=best[0]) + settings.update(epochs_completed=len(history), stopped_early=stopped_early, + stop_reason='validation_patience' if stopped_early else 'epoch_ceiling', + training_queries=len(examples), optimizer_steps=len(history) * math.ceil(len(examples) / batch_size)) + if state_fingerprint(model) != backbone: + raise RuntimeError('Backbone changed during adapter fitting') + settings['row_cache'] = {source.name: dict(bank['provider'].stats) for source, bank in zip(sources, banks) if 'provider' in bank} + variants = {'sigmoid': QueryScoreAdapter('global').to(device), 'observed': QueryScoreAdapter('global', 1.).to(device)} + validation = {name: _baseline_validation(value, sources, banks, cache_dir) for name, value in variants.items()} + validation['fitted'] = best[3] if best is not None and len(validation_indices) == len(sources) else _validation(adapter, sources, banks) + return AdapterFitResult(adapter, history, validation) diff --git a/dicee/query_answering/benchmark.py b/dicee/query_answering/benchmark.py new file mode 100644 index 000000000..5508707b5 --- /dev/null +++ b/dicee/query_answering/benchmark.py @@ -0,0 +1,665 @@ +"""Streaming, full-candidate evaluation of published logical queries. + +The default sort/filter/query/type averaging protocol follows UltraQuery's +query_utils.py at 427966ad8ed60420eef034063d44f3153addff90. Predictions are +provided independently of labels so any query executor can use this evaluator. +""" + +import hashlib +import heapq +import json +import time +from bisect import bisect_right +from collections import Counter, defaultdict +from collections.abc import Callable, Mapping, Sequence +from contextlib import ExitStack, nullcontext +from pathlib import Path +from typing import Any + +import torch + +from ..models._inference import to_device +from ._checkpoint import BenchmarkCheckpoint, implementation_fingerprint, write_json +from ._query import QUERY_SHAPES, ULTRAQUERY_SHAPES, compile_query, relation_signature +from ._rank_trace import RankTrace +from .context import attached_context, evaluation_mode, fingerprint, state_fingerprint +from .datasets import BENCHMARK_DATASETS, PLUS_H_DATASETS, BenchmarkQuery, QueryBenchmark, load_benchmark +from .engine import QueryAnswerer +from .score_adapter import QueryScoreAdapter + +METRICS = ('mrr', 'hits1', 'hits3', 'hits10') + + +def _accumulate_inference_statistics(stats, info, engines): + """Persist event counts and the combined calibrated-row cache occupancy.""" + for key in ('raw_rows', 'cache_hits', 'pruned', 'negated_pruning', 'bound_skipped', 'zero_prefix_skipped'): + stats[key] += int(info.get(key, 0)) + stats['cache_bytes'] = sum(engine._cache_used for engine in engines) + stats['cache_peak_bytes'] = max(stats.get('cache_peak_bytes', 0), stats['cache_bytes']) + + +class QueryMetrics: + """Reuse a validated candidate domain and device masks across a dataset.""" + + def __init__(self, num_entities, *, candidates=None, tie_policy='sort'): + if tie_policy not in ('sort', 'average', 'optimistic', 'pessimistic', 'expected'): + raise ValueError('Unknown benchmark tie policy') + self.n, self.tie_policy = num_entities, tie_policy + domain = range(num_entities) if candidates is None else frozenset(candidates) + if not domain or min(domain) < 0 or max(domain) >= num_entities: + raise ValueError('Invalid candidate domain') + self.full_domain = len(domain) == num_entities + self.domain = range(num_entities) if self.full_domain else domain + self.outside = frozenset() if self.full_domain else frozenset(range(num_entities)) - domain + self._device = None + self._harmonic = None + + def __call__(self, scores, easy, hard): + return self.evaluate(scores, easy, hard, (self.tie_policy,))[0][self.tie_policy] + + def evaluate(self, scores, easy, hard, policies=('sort', 'expected'), *, records=False): + """Share one argsort across tie policies and optional answer-rank records.""" + if not policies or set(policies) - {'sort', 'expected', 'average', 'optimistic', 'pessimistic'}: + raise ValueError('Unknown benchmark tie policy') + if scores.ndim != 1 or len(scores) != self.n: + raise ValueError('Expected one complete higher-is-better score vector') + # Read with the metrics below: one device-to-host copy per evaluation. + invalid = (torch.isnan(scores) | torch.isposinf(scores)).any() + easy, hard = frozenset(easy), frozenset(hard) + answers = easy | hard + if not hard or easy & hard or any(t not in self.domain for t in answers): + if invalid.item(): + raise ValueError('Expected one complete higher-is-better score vector') + raise ValueError('Need disjoint easy/hard answers and nonempty hard answers inside the candidate domain') + targets = sorted(hard) + device = scores.device + target_index = to_device(torch.tensor(targets), device) + ranks = None + if 'sort' in policies or records: + if self._device != device: + self._negative_template = torch.ones(self.n, dtype=torch.long, device=device) + self._outside_index = torch.tensor(sorted(self.outside), dtype=torch.long, device=device) + self._negative_template[self._outside_index] = 0 + self._positions = torch.arange(self.n, device=device) + self._device = device + # Sort before filtering, including outside-domain -inf entries, to + # preserve the reference evaluator's tie ordering exactly. + values = scores if scores.is_contiguous() else scores.clone() + if not self.full_domain: + values = scores.clone() + values[self._outside_index] = -torch.inf + order = values.argsort(descending=True) + negatives = self._negative_template.clone() + negatives.index_fill_(0, to_device(torch.tensor(sorted(answers), dtype=torch.long), device), 0) + positions = torch.empty_like(order) + positions[order] = self._positions + ranks = 1 + negatives[order].cumsum(0)[positions[target_index]] + if set(policies) != {'sort'} or records: + excluded = sorted(self.outside | answers) + eligible = torch.ones(self.n, dtype=torch.bool, device=device) + eligible.index_fill_(0, to_device(torch.tensor(excluded, dtype=torch.long), device), False) + # Eligible scores in ascending order; valid scores sort before +inf. + count = self.n - len(excluded) + negatives = torch.where(eligible, scores, torch.inf).sort().values[:count] + values = scores[target_index].contiguous() + lower = torch.searchsorted(negatives, values, right=False) + upper = torch.searchsorted(negatives, values, right=True) + starts, tied = count - upper + 1, upper - lower + packed = [invalid.double()[None]] + for policy in policies: + if policy == 'expected': + # Each position in the exact tie block is equally likely. + sizes = tied + 1 + last = starts + sizes - 1 + if self._harmonic is None or self._harmonic.device != scores.device: + self._harmonic = torch.cat((torch.zeros(1, dtype=torch.float64, device=scores.device), + torch.arange(1, self.n + 1, dtype=torch.float64, device=scores.device).reciprocal().cumsum(0))) + rr = (self._harmonic[last] - self._harmonic[starts - 1]) / sizes + hits = [((k - starts + 1).clamp_min(0).minimum(sizes).double() / sizes).mean() for k in (1, 3, 10)] + metrics = torch.stack([rr.mean(), *hits]) + else: + policy_ranks = (ranks.double() if policy == 'sort' else starts.double() + + {'average': .5, 'optimistic': 0., 'pessimistic': 1.}[policy] * tied) + metrics = torch.stack([policy_ranks.reciprocal().mean(), *((policy_ranks <= k).double().mean() for k in (1, 3, 10))]) + packed.append(metrics) + if records: + # Integer ranks are exact in float64 for any feasible vocabulary. + packed.append(torch.stack([target_index, ranks, starts - 1, tied + 1], dim=1).double().flatten()) + invalid, *host = torch.cat(packed).tolist() + if invalid: + raise ValueError('Expected one complete higher-is-better score vector') + result = {policy: dict(zip(METRICS, host[4 * i:4 * i + 4])) for i, policy in enumerate(policies)} + values = [int(value) for value in host[4 * len(policies):]] + detail = [values[i:i + 4] for i in range(0, len(values), 4)] if records else None + return result, detail + + +def filtered_query_metrics(scores, easy, hard, *, candidates=None, tie_policy='sort'): + """Filter other true answers and average over hard answers for one query. + + ``sort`` preserves PyTorch's descending argsort tie ordering, as in the + reference evaluator. Reuse QueryMetrics when evaluating a whole dataset. + """ + if scores.ndim != 1: + raise ValueError('Expected one complete higher-is-better score vector') + return QueryMetrics(len(scores), candidates=candidates, tie_policy=tie_policy)(scores, easy, hard) + + +def _averages(per_shape): + result = {} + for name, shapes in (('all', list(per_shape)), ('epfo', [s for s in per_shape if 'n' not in s]), + ('negation', [s for s in per_shape if 'n' in s])): + result[name] = ({metric: sum(per_shape[s][metric] for s in shapes) / len(shapes) for metric in METRICS} + | {'shapes': len(shapes)}) if shapes else None + return result + + +def _query_plan(data, limit, order, *, sampling='prefix', seed=0): + if limit is not None and (type(limit) is not int or limit < 1): + raise ValueError('Query limit must be a positive integer') + if order not in ('published', 'relation'): + raise ValueError('Unknown query order') + if sampling not in ('prefix', 'uniform') or type(seed) is not int: + raise ValueError('Choose prefix/uniform sampling and an integer sampling seed') + counts, selected = Counter(), [] + if sampling == 'uniform' and limit is not None: + groups = defaultdict(list) + for query in data.queries: + groups[query.shape].append(query) + for shape, queries in groups.items(): + def priority(query): + return fingerprint(('query-sample-v1', seed, data.name, data.split, shape, query.query)), query.query + selected.extend(heapq.nsmallest(limit, queries, key=priority)) + selected.sort(key=lambda q: (q.shape, q.query)) + else: + for query in data.queries: + if limit is None or counts[query.shape] < limit: + selected.append(query) + counts[query.shape] += 1 + if order == 'relation': + selected.sort(key=lambda q: (q.shape, relation_signature(compile_query(q.query)), q.query)) + return selected + + +def _plan_fingerprint(queries): + digest = hashlib.sha256() + for query in queries: + digest.update(query.identity.encode()) + return digest.hexdigest() + + +@torch.no_grad() +def evaluate_benchmark(data: QueryBenchmark, predict: Callable[[tuple], torch.Tensor], *, tie_policy: str = 'sort', + max_queries_per_shape: int | None = None, progress: Callable[[int, int], None] | None = None, + prepare: Callable[[list[tuple]], None] | None = None, query_batch_size: int = 1, + query_order: str = 'published', checkpoint_dir: str | Path | None = None, + checkpoint_identity: Any = None, checkpoint_every: int = 500, + on_checkpoint: Callable[[dict[str, Any]], None] | None = None, statistics: Counter | None = None, + query_sampling: str = 'prefix', sampling_seed: int = 0, + on_query: Callable[[tuple, str, dict[str, float]], None] | None = None, + additional_tie_policies: Sequence[str] = (), query_plan: Sequence[BenchmarkQuery] | None = None, + batch_ends: Sequence[int] | None = None, rank_trace_path: str | Path | None = None, + comparison_predictors: Mapping[str, Callable[[tuple], torch.Tensor]] | None = None, + filter_corrections: Mapping[tuple, frozenset | set] | None = None) -> dict[str, Any]: + """Stream filtered ranking metrics over a benchmark, resuming a verified query prefix. + + Each query's scores over all entities rank its hard answers after filtering + every other easy and hard answer. Metrics average answers per query, queries + per query type, and query types equally. + + Args: + data: Benchmark queries, inference graph and candidates. + predict: Scores of every entity for one query. + tie_policy: ``'sort'`` (stable descending order) or ``'expected'`` (exact + expectation under random order within ties). + max_queries_per_shape: Sample at most this many queries per type. + progress: Called with completed and total query counts. + prepare: Called with each batch of queries before they are predicted. + query_batch_size: Queries per prepared batch. + query_order: Order of the query plan: ``'published'``, ``'canonical'`` or ``'relation'``. + checkpoint_dir: Directory for resumable progress. + checkpoint_identity: Everything that determines predictions; resuming requires equality. + checkpoint_every: Queries between saved checkpoints. + on_checkpoint: Called with the partial report at each checkpoint. + statistics: Counter of inference statistics to update and report. + query_sampling: ``'prefix'`` or ``'uniform'`` sampling of limited query plans. + sampling_seed: Seed of uniform sampling. + on_query: Called with each query, its type and its metrics. + additional_tie_policies: Further tie policies computed from the same scores. + query_plan: Explicit ordered queries instead of a sampled plan. + batch_ends: Explicit batch boundaries in ``query_plan``. + rank_trace_path: SQLite file recording every hard answer's ranks. + comparison_predictors: Named predictors scored on the same queries, such + as identity-adapter controls. + filter_corrections: Corrected easy answers by query; released filters are + then reported as a control. + + Returns: + The report: per-type and averaged metrics, coverage, protocol and timings. + + Raises: + ValueError: For inconsistent settings, or a checkpoint of different inputs. + """ + if type(query_batch_size) is not int or query_batch_size < 1 or type(checkpoint_every) is not int or checkpoint_every < 1: + raise ValueError('Batch and checkpoint intervals must be positive integers') + if query_plan is not None: + if max_queries_per_shape is not None: + raise ValueError('An explicit query plan cannot also specify a sampling limit') + selected = list(query_plan) + if not selected or len(set(selected)) != len(selected) or not set(selected) <= set(data.queries): + raise ValueError('Explicit query plan must contain distinct benchmark queries with unchanged answers') + else: + selected = _query_plan(data, max_queries_per_shape, query_order, sampling=query_sampling, seed=sampling_seed) + if batch_ends is not None: + batch_ends = list(batch_ends) + if (not batch_ends or any(type(end) is not int for end in batch_ends) + or batch_ends != sorted(set(batch_ends)) or batch_ends[0] < 1 or batch_ends[-1] != len(selected)): + raise ValueError('Explicit batch boundaries must cover the entire query plan') + if rank_trace_path is not None and checkpoint_dir is None: + raise ValueError('Rank traces require a resumable checkpoint directory') + comparisons: dict[str, Any] = dict(comparison_predictors or {}) + if any(not isinstance(name, str) or not name or name in ('.', '..') or Path(name).name != name + or not callable(predictor) for name, predictor in comparisons.items()): + raise ValueError('Comparisons require named predictors with safe directory names') + predictors: dict[str | None, Any] = {None: predict, **comparisons} + controls = {} + if filter_corrections is not None: + known = {query.query: query for query in data.queries} + candidate_set = set(data.candidates) + if set(filter_corrections) - known.keys(): + raise ValueError('Filter corrections reference unknown queries') + for query, easy in filter_corrections.items(): + if set(easy) & known[query].hard or not set(easy) <= candidate_set: + raise ValueError('Corrected filters must be valid non-target candidates') + controls = {name: (name + '-' if name else '') + 'released-filters' for name in predictors} + if set(controls.values()) & comparisons.keys(): + raise ValueError('Released-filter comparison names collide with predictors') + comparisons.update(dict.fromkeys(controls.values())) + metrics_for_query = QueryMetrics(data.context.num_entities, candidates=data.candidates, tie_policy=tie_policy) + if len(set(additional_tie_policies)) != len(additional_tie_policies) or tie_policy in additional_tie_policies: + raise ValueError('Tie policies must be distinct') + additional = {policy: QueryMetrics(data.context.num_entities, candidates=data.candidates, tie_policy=policy) + for policy in additional_tie_policies} + if checkpoint_dir is not None and checkpoint_identity is None: + raise ValueError('Checkpointing requires an explicit predictor identity') + identity = dict(predictor=checkpoint_identity, implementation=implementation_fingerprint(), + dataset=data.name, split=data.split, context=data.context.identity, metadata=data.metadata, + candidates=fingerprint(data.candidates), plan=_plan_fingerprint(selected), + tie_policy=tie_policy, limit=max_queries_per_shape, order=query_order, + additional_tie_policies=list(additional_tie_policies), + sampling=query_sampling, sampling_seed=sampling_seed, + batch=query_batch_size, checkpoint_every=checkpoint_every) if checkpoint_dir is not None else None + if identity is not None: + identity.update(explicit_batches=batch_ends, rank_trace=rank_trace_path is not None) + if comparisons: + identity['comparisons'] = list(comparisons) + if filter_corrections is not None: + identity['filter_corrections'] = fingerprint(sorted((fingerprint(query), sorted(easy)) for query, easy in filter_corrections.items())) + store = BenchmarkCheckpoint(checkpoint_dir, identity) if checkpoint_dir is not None else nullcontext(None) + available = Counter(q.shape for q in data.queries) + stats = Counter() if statistics is None else statistics + with ExitStack() as stack: + checkpoint = stack.enter_context(store) + saved = checkpoint.load() if checkpoint else None + counts, hard_counts = Counter(), Counter() + completed, elapsed = 0, 0. + policies = (tie_policy, *additional) + # Metric sums per (predictor, tie policy) and query type; predictor None is ``predict``. + totals = {(name, policy): defaultdict(Counter) for name in (None, *comparisons) for policy in policies} + if saved is not None: + completed, elapsed = saved['completed'], saved['seconds'] + if not 0 <= completed <= len(selected): + raise ValueError('Invalid checkpoint query count') + counts.update(saved['counts']) + hard_counts.update(saved['hard_counts']) + for name, policy, values in saved['totals']: + totals[name, policy].update({shape: Counter(sums) for shape, sums in values.items()}) + stats.update({key: value for key, value in saved['statistics'].items() + if key not in ('cache_bytes', 'cache_peak_bytes')}) + stats['cache_peak_bytes'] = max(stats.get('cache_peak_bytes', 0), + saved['statistics'].get('cache_peak_bytes', 0)) + if completed == len(selected): + # A completed checkpoint replays the last evaluation's report. + stats['cache_bytes'] = saved['statistics'].get('cache_bytes', 0) + else: + # Continuing inference starts with fresh process-local caches. + stats.setdefault('cache_bytes', 0) + if sum(counts.values()) != completed: + raise ValueError('Invalid checkpoint shape counts') + if batch_ends is not None and completed and completed not in batch_ends: + raise ValueError('Checkpoint cuts through a reference batch') + trace, comparison_traces = None, {} + if rank_trace_path is not None and identity is not None: + trace = stack.enter_context(RankTrace(rank_trace_path, identity, completed)) + comparison_traces = {name: stack.enter_context(RankTrace(Path(rank_trace_path).parent / name / 'ranks.sqlite3', + dict(identity, comparison=name), completed)) + for name in comparisons} + timings = Counter(saved.get('timings', {}) if saved else {}) + started = time.monotonic() + + def report(variant: str | None = None) -> dict[str, Any]: + def means(policy): + return {shape: {metric: totals[variant, policy][shape][metric] / counts[shape] for metric in METRICS} + | dict(queries=counts[shape], hard_answers=hard_counts[shape], available_queries=available[shape]) + for shape in sorted(counts)} + + per_shape, extra = means(tie_policy), {} + for policy in additional: + values = means(policy) + extra[policy] = dict(per_shape=values, averages=_averages(values)) + result = dict(dataset=data.name, group=data.group, split=data.split, per_shape=per_shape, averages=_averages(per_shape), + queries=completed, seconds=elapsed + time.monotonic() - started, + protocol=dict(tie_policy=tie_policy, filtering='all other easy and hard answers', + averaging='answers per query, queries per shape, equal shapes per group', + max_queries_per_shape=max_queries_per_shape, query_order=query_order, + query_sampling=query_sampling, sampling_seed=sampling_seed, + full_split=completed == len(data.queries), + all_14_shapes=set(counts) == set(ULTRAQUERY_SHAPES), + all_benchmark_shapes=set(counts) == set(data.metadata.get('expected_query_types', ULTRAQUERY_SHAPES))), + dataset_metadata=data.metadata, context_sha256=data.context.identity, + candidate_sha256=fingerprint(data.candidates), num_candidates=len(data.candidates), + timings=dict(timings), + **({'additional_tie_metrics': extra} if extra else {})) + if filter_corrections is not None: + released = variant in controls.values() + result['protocol']['answer_filter'] = 'released' if released else 'corrected' + result['dataset_metadata'] = dict(data.metadata, answer_filter=result['protocol']['answer_filter']) + if released: + result['filter_control_of'] = next(name or '' for name, control in controls.items() if control == variant) + if variant is None and comparisons: + result['comparisons'] = {name: report(name) for name in comparisons} + return result + + if progress and completed: + progress(completed, len(selected)) + while completed < len(selected): + end = (batch_ends[bisect_right(batch_ends, completed)] if batch_ends is not None else + min(completed + query_batch_size, len(selected), (completed // checkpoint_every + 1) * checkpoint_every)) + batch = selected[completed:end] + step_started = time.monotonic() + if prepare: + prepare([q.query for q in batch]) + timings['prepare_wall_seconds'] += time.monotonic() - step_started + checkpoint_due = False + for q in batch: + for name, predictor in predictors.items(): + step_started = time.monotonic() + scores = predictor(q.query) + timings['predict_dispatch_wall_seconds'] += time.monotonic() - step_started + if scores.shape != (data.context.num_entities,): + raise ValueError('Predictor must score the complete public entity vocabulary') + step_started = time.monotonic() + easy = q.easy if filter_corrections is None else filter_corrections.get(q.query, q.easy) + all_metrics, details = metrics_for_query.evaluate(scores, easy, q.hard, (tie_policy, *additional), records=trace is not None) + main_metrics = all_metrics[tie_policy] + variants = [(name, all_metrics, details)] + if controls: + released = ((all_metrics, details) if easy == q.easy else + metrics_for_query.evaluate(scores, q.easy, q.hard, (tie_policy, *additional), records=trace is not None)) + variants.append((controls[name], *released)) + for variant, values, records in variants: + for policy in policies: + totals[variant, policy][q.shape].update(values[policy]) + current_trace = trace if variant is None else comparison_traces.get(variant) + if current_trace is not None: + current_trace.add(completed, q, records) + timings['metrics_and_trace_wall_seconds'] += time.monotonic() - step_started + if on_query and name is None: + on_query(q.query, q.shape, dict(main_metrics)) + counts[q.shape] += 1 + hard_counts[q.shape] += len(q.hard) + completed += 1 + checkpoint_due |= completed % checkpoint_every == 0 or completed == len(selected) + if progress and completed < end: + progress(completed, len(selected)) + if checkpoint_due: + current = report() + if trace is not None: + trace.commit() + for comparison_trace in comparison_traces.values(): + comparison_trace.commit() + if checkpoint: + checkpoint.save(dict(completed=completed, seconds=current['seconds'], counts=dict(counts), + hard_counts=dict(hard_counts), statistics=dict(stats), timings=dict(timings), + totals=[[name, policy, dict(values)] for (name, policy), values in totals.items()])) + if on_checkpoint: + on_checkpoint(current) + if progress: + progress(completed, len(selected)) + return report() + + +def benchmark_model(model: torch.nn.Module, data: QueryBenchmark, *, adapter: QueryScoreAdapter | None = None, + observed_mix: float | None = None, beam_size: int = 64, tnorm: str = 'prod', row_batch_size: int = 8, + backend_batch_size: int | None = None, cache_bytes: int = 512 * 1024 * 1024, seed: int = 0, + samples: int | None = None, tie_policy: str = 'sort', max_queries_per_shape: int | None = None, + progress: Callable[[int, int], None] | None = None, query_batch_size: int = 32, + query_order: str = 'relation', checkpoint_dir: str | Path | None = None, checkpoint_every: int = 500, + on_checkpoint: Callable[[dict[str, Any]], None] | None = None, query_sampling: str = 'prefix', + sampling_seed: int = 0, on_query: Callable[[tuple, str, dict[str, float]], None] | None = None, + executor: str = 'cqd') -> dict[str, Any]: + """Evaluate a KGE or KGFM with CQD beam search, shared atomic caches and durable progress. + + Arguments not listed here are those of ``evaluate_benchmark``. + + Args: + model: Link predictor scoring ``(head, relation)`` rows over all entities. + data: Benchmark to evaluate. + adapter: Score adapter; None uses sigmoid scores. + observed_mix: Overrides the adapter's weight of observed facts. + beam_size: Intermediate candidates kept per variable. + tnorm: ``'prod'`` or ``'min'``. + row_batch_size: Atomic rows scored per backbone call. + backend_batch_size: Query batch of graph backbones. + cache_bytes: Budget of the calibrated-row cache. + seed: Seed of sampled scoring. + samples: Number of sampled scoring passes, if any. + executor: Query executor, ``'cqd'``. + + Returns: + The ``evaluate_benchmark`` report with inference settings and cache statistics. + """ + from ..models._inference import float32_precision_token + from ..models.flock import Flock + if executor not in ('cqd', 'qto'): + raise ValueError('Choose cqd or qto executor') + previous_batch = getattr(model, 'query_batch_size', None) + effective_batch = backend_batch_size + if effective_batch is None: + effective_batch = previous_batch if isinstance(model, Flock) else row_batch_size + if type(effective_batch) is not int or effective_batch < 1: + raise ValueError('Backend batch size must be a positive integer') + stats = Counter() + try: + if previous_batch is not None: + setattr(model, 'query_batch_size', effective_batch) + with attached_context(model, data.context), evaluation_mode(model): + engine = QueryAnswerer(model, context=data.context, adapter=adapter, observed_mix=observed_mix, + row_batch_size=row_batch_size, cache_bytes=cache_bytes, seed=seed, samples=samples) + transform = engine.adapter + inference = dict(method='cqd-global-prefix' if executor == 'cqd' else 'qto-exact', executor=executor, + model=model.name, beam_size=beam_size if executor == 'cqd' else None, tnorm=tnorm, + negation='standard', score_space='float64-log-memberships', + row_batch_size=row_batch_size, backend_batch_size=effective_batch if previous_batch is not None else None, + query_batch_size=query_batch_size, cache_bytes=cache_bytes, cache_scope='evaluation-session', + seed=seed, samples=samples, + effective_samples=getattr(model, 'test_samples', None) if samples is None else samples, + sampling='independent-row-single-sample-v1' if isinstance(model, Flock) else None, + adapter=transform.to_dict(), + backbone_state_sha256=state_fingerprint(model), device=str(engine.scorer.device), + cuda=torch.version.cuda, + gpu=torch.cuda.get_device_name(engine.scorer.device) if engine.scorer.device.type == 'cuda' else None, + torch=str(torch.__version__), float32_precision=str(float32_precision_token()), + cpu_threads=torch.get_num_threads(), + deterministic=torch.are_deterministic_algorithms_enabled(), + model_configuration={k: str(v) for k, v in getattr(model, 'args', {}).items()}, + runtime_configuration={k: getattr(model, k, None) for k in ( + '_inference_backend', 'query_batch_size', 'relation_cache_mb', 'projection_cache_mb', + 'walk_num', 'walk_len', 'refinements', 'compact_state', 'pack_walks', 'compile_sampler', 'prefetch_walks')}, + module_configuration={name: {k: getattr(module, k, None) for k in ('inference_backend', 'inference_compile')} + for name, module in model.named_modules() if hasattr(module, 'inference_backend')}, + implementation_sha256=implementation_fingerprint()) + + def predict(query): + result = engine.predict(query, beam_size=beam_size, tnorm=tnorm, return_log_scores=True, executor=executor) + _accumulate_inference_statistics(stats, engine.last_info, (engine,)) + return result + + def prepare(queries): + _accumulate_inference_statistics(stats, engine.prefetch(queries), (engine,)) + + def annotate(report: dict[str, Any]) -> dict[str, Any]: + return dict(report, inference=dict(inference, statistics=dict(stats))) + + report = evaluate_benchmark(data, predict, tie_policy=tie_policy, + max_queries_per_shape=max_queries_per_shape, progress=progress, + prepare=prepare, query_batch_size=query_batch_size, query_order=query_order, + query_sampling=query_sampling, sampling_seed=sampling_seed, on_query=on_query, + checkpoint_dir=checkpoint_dir, checkpoint_identity=inference, checkpoint_every=checkpoint_every, + on_checkpoint=(lambda report: on_checkpoint(annotate(report))) if on_checkpoint else None, + statistics=stats) + return annotate(report) + finally: + if previous_batch is not None: + setattr(model, 'query_batch_size', previous_batch) + + +def summarize_benchmarks(reports): + """Equal dataset averages; partial selections are labeled, never padded with zeros.""" + if len({(r['dataset'], r['split']) for r in reports}) != len(reports): + raise ValueError('Duplicate dataset/split results cannot be averaged') + if len({r['split'] for r in reports}) > 1: + raise ValueError('Do not aggregate validation and test splits together') + if len({r['dataset_metadata'].get('suite', 'ultraquery') for r in reports}) > 1: + raise ValueError('Do not aggregate UltraQuery and +H benchmark suites together') + if len({r['dataset_metadata'].get('evaluation', 'hard-answers') for r in reports}) > 1: + raise ValueError('Do not aggregate faithfulness and hard-answer evaluations together') + result = {} + for group in ('all', 'transductive', 'inductive-e', 'inductive-er'): + selected = [r for r in reports if group == 'all' or r['group'] == group] + if not selected: + continue + result[group] = {'datasets': len(selected)} + for category in ('all', 'epfo', 'negation'): + values = [r['averages'][category] for r in selected if r['averages'][category] is not None] + result[group][category] = ({metric: sum(v[metric] for v in values) / len(values) for metric in METRICS} + | {'datasets': len(values)}) if values else None + return dict(groups=result, complete_23_dataset_test_suite=(len(reports) == 23 and + {r['dataset'] for r in reports} == set(BENCHMARK_DATASETS) and + all(r['split'] == 'test' and r['protocol']['full_split'] and r['protocol']['all_14_shapes'] for r in reports)), + complete_plus_h_test_suite=({r['dataset'] for r in reports} == set(PLUS_H_DATASETS) and + all(r['split'] == 'test' and r['protocol']['full_split'] and r['protocol'].get('all_benchmark_shapes', False) + for r in reports))) + + +def add_benchmark_parser(commands): + parser = commands.add_parser('benchmark', help='Evaluate CQD/QTO on published UltraQuery or +H datasets') + parser.add_argument('--data-root', type=Path, required=True) + parser.add_argument('--datasets', nargs='+', default=['FB15k237LogicalQuery'], help='Dataset names, all for UltraQuery, or +h for the three harder datasets') + parser.add_argument('--split', choices=['valid', 'test'], default='test') + parser.add_argument('--query-types', nargs='+', choices=list(QUERY_SHAPES)) + parser.add_argument('--download', action='store_true', help='Download official archives if missing') + source = parser.add_mutually_exclusive_group(required=True) + source.add_argument('--experiment', help='Saved DICE experiment') + source.add_argument('--checkpoint', type=Path, help='Pretrained graph-model checkpoint') + parser.add_argument('--model', choices=['ULTRA', 'TRIX', 'Flock'], default='ULTRA') + parser.add_argument('--model-config', type=Path, help='Optional model constructor arguments as JSON') + parser.add_argument('--adapter', type=Path, help='Fitted DICE adapter JSON') + parser.add_argument('--observed-mix', type=float) + parser.add_argument('--beam-size', type=int, default=64) + parser.add_argument('--executor', choices=['cqd', 'qto'], default='cqd', help='Beam search or exact QTO-style projection') + parser.add_argument('--tnorm', choices=['prod', 'min'], default='prod') + parser.add_argument('--row-batch-size', type=int, default=8) + parser.add_argument('--backend-batch-size', type=int, help='Neural microbatch; defaults to row batch size for ULTRA/TRIX') + parser.add_argument('--query-batch-size', type=int, default=32, help='Queries whose anchor rows are prefetched together') + parser.add_argument('--query-order', choices=['published', 'relation'], default='relation') + parser.add_argument('--cache-mb', type=int, default=512) + parser.add_argument('--checkpoint-every', type=int, default=500) + parser.add_argument('--tie-policy', choices=['sort', 'average', 'optimistic', 'pessimistic'], default='sort') + parser.add_argument('--max-queries-per-shape', type=int, help='Deterministic smoke-test subset; omitted means full evaluation') + parser.add_argument('--query-sampling', choices=['prefix', 'uniform'], default='prefix', help='Uniform sampling is nested across query limits') + parser.add_argument('--sampling-seed', type=int, default=0, help='Query selection seed, independent of backbone sampling') + parser.add_argument('--seed', type=int, default=0) + parser.add_argument('--samples', type=int) + parser.add_argument('--device', default='cpu') + parser.add_argument('--threads', type=int, default=2) + parser.add_argument('--precision', choices=['ieee', 'tf32'], default='ieee') + parser.add_argument('--output', type=Path, required=True, help='JSON report with automatic checkpoint/resume') + + +def run_benchmark_cli(args): + from ..models import TRIX, ULTRA, Flock + from ..models._inference import float32_precision_backends + from ..models.graph_model import GraphKGE + if args.threads < 1: + raise ValueError('Thread count must be positive') + torch.set_num_threads(args.threads) + backends = float32_precision_backends() + if backends: + for backend in backends: + backend.fp32_precision = args.precision + else: + torch.set_float32_matmul_precision('highest' if args.precision == 'ieee' else 'high') + torch.backends.cudnn.allow_tf32 = args.precision == 'tf32' + names = (list(BENCHMARK_DATASETS) if args.datasets == ['all'] else + list(PLUS_H_DATASETS) if args.datasets in (['+h'], ['+H']) else args.datasets) + if len(set(names)) != len(names): + raise ValueError('Choose each dataset once') + if any(name in PLUS_H_DATASETS for name in names) and not all(name in PLUS_H_DATASETS for name in names): + raise ValueError('Run UltraQuery and +H benchmark suites with separate output paths') + kge = None + if args.experiment: + from ..knowledge_graph_embeddings import KGE + kge = KGE(path=args.experiment) + model = kge.model + else: + configuration = json.loads(args.model_config.read_text()) if args.model_config else {} + model = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[args.model](dict(configuration, num_entities=1, num_relations=1)) + model.load_pretrained(args.checkpoint) + model.to(args.device) + adapter = QueryScoreAdapter.load(args.adapter, model=model) if args.adapter else None + request = dict(arguments={key: str(value) for key, value in vars(args).items()}, + implementation=implementation_fingerprint(), backbone=state_fingerprint(model), + adapter=json.loads(args.adapter.read_text()) if args.adapter else None) + directory = args.output.with_suffix(args.output.suffix + '.checkpoints') + with BenchmarkCheckpoint(directory, request): + try: + _run_datasets(args, names, model, adapter, kge, directory, GraphKGE) + except BaseException as error: + if args.output.exists(): + payload = json.loads(args.output.read_text()) + write_json(args.output, dict(payload, state='failed', error=str(error))) + raise + + +def _run_datasets(args, names, model, adapter, kge, directory, graph_type): + reports = [] + args.output.parent.mkdir(parents=True, exist_ok=True) + for name in names: + print(f'Loading {name} ({args.split})', flush=True) + data = load_benchmark(args.data_root, name, split=args.split, query_types=args.query_types, download=args.download) + if not isinstance(model, graph_type): + if data.entity_to_idx is None or kge.entity_to_idx != data.entity_to_idx or kge.relation_to_idx != data.relation_to_idx: + raise ValueError('Transductive experiment IDs must exactly match the published benchmark vocabulary') + + def progress(done, total): + if done == 1 or done % 100 == 0 or done == total: + print(f'{name}: {done}/{total} queries', flush=True) + + def checkpoint(report): + write_json(args.output, dict(version=2, state='running', results=reports, current_result=report, + summary=summarize_benchmarks(reports))) + + report = benchmark_model(model, data, adapter=adapter, observed_mix=args.observed_mix, + beam_size=args.beam_size, executor=args.executor, tnorm=args.tnorm, row_batch_size=args.row_batch_size, + backend_batch_size=args.backend_batch_size, query_batch_size=args.query_batch_size, + query_order=args.query_order, checkpoint_dir=directory / name.replace(':', '-'), + query_sampling=args.query_sampling, sampling_seed=args.sampling_seed, + checkpoint_every=args.checkpoint_every, on_checkpoint=checkpoint, + cache_bytes=args.cache_mb * 2**20, seed=args.seed, samples=args.samples, + tie_policy=args.tie_policy, max_queries_per_shape=args.max_queries_per_shape, progress=progress) + reports.append(report) + write_json(args.output, dict(version=2, state='complete' if len(reports) == len(names) else 'running', + results=reports, current_result=None, summary=summarize_benchmarks(reports))) + print(f'{name}: {json.dumps(report["averages"])}', flush=True) + print(f'Saved {args.output}', flush=True) diff --git a/dicee/query_answering/catalog.py b/dicee/query_answering/catalog.py new file mode 100644 index 000000000..291ccb396 --- /dev/null +++ b/dicee/query_answering/catalog.py @@ -0,0 +1,143 @@ +"""Published complex-query benchmarks, the upstream code they reproduce, and recipe rules. + +The benchmark launcher loads this file without PyTorch, so it imports nothing. +""" + +# Query structures in the released grammar: 'e' anchor, 'r' relation, 'n' negation, 'u' union. +_ONE = ('e', ('r',)) +QUERY_SHAPES = { + '1p': _ONE, '2p': ('e', ('r', 'r')), '3p': ('e', ('r', 'r', 'r')), + '2i': (_ONE, _ONE), '3i': (_ONE, _ONE, _ONE), + 'ip': ((_ONE, _ONE), ('r',)), 'pi': (('e', ('r', 'r')), _ONE), + '2u': (_ONE, _ONE, ('u',)), 'up': ((_ONE, _ONE, ('u',)), ('r',)), + '2in': (_ONE, ('e', ('r', 'n'))), '3in': (_ONE, _ONE, ('e', ('r', 'n'))), + 'inp': ((_ONE, ('e', ('r', 'n'))), ('r',)), + 'pin': (('e', ('r', 'r')), ('e', ('r', 'n'))), + 'pni': (('e', ('r', 'r', 'n')), _ONE), + '4p': ('e', ('r', 'r', 'r', 'r')), '4i': (_ONE, _ONE, _ONE, _ONE), +} +ULTRAQUERY_SHAPES = ('1p', '2p', '3p', '2i', '3i', 'ip', 'pi', '2u', 'up', '2in', '3in', 'inp', 'pin', 'pni') +PLUS_H_SHAPES = (*ULTRAQUERY_SHAPES, '4p', '4i') + +# Released datasets of the UltraQuery suite, by public name. +TRANSDUCTIVE = {'FB15k237LogicalQuery': 'FB15k-237-betae', 'FB15kLogicalQuery': 'FB15k-betae', 'NELL995LogicalQuery': 'NELL-betae'} +INDUCTIVE_VERSIONS = ('106', '113', '122', '134', '150', '175', '217', '300', '550') +WIKITOPICS = ('art', 'award', 'edu', 'health', 'infra', 'loc', 'org', 'people', 'sci', 'sport', 'tax') +BENCHMARK_DATASETS = (*TRANSDUCTIVE, *(f'InductiveFB15k237Query:{v}' for v in INDUCTIVE_VERSIONS), + *(f'WikiTopicsQuery:{v}' for v in WIKITOPICS)) + +# The harder +H suite and its single release archive. +PLUS_H_FOLDERS = {'FB15k237+H': 'FB15k-237+H', 'NELL995+H': 'NELL995+H', 'ICEWS18+H': 'ICEWS18+H'} +PLUS_H_DATASETS = tuple(PLUS_H_FOLDERS) +PLUS_H_ARCHIVE = 'https://github.com/april-tools/is-cqa-complex/releases/download/benchs-1.0/iscqa-compl-benchmarks.zip' +PLUS_H_PREFIX = 'iscqa-compl-benchmarks/new_benchmarks' + +# Pinned upstream implementations: method -> (repository, commit). +ULTRA = ('DeepGraphLearning/ULTRA', '427966ad8ed60420eef034063d44f3153addff90') +TRIX = ('yuchengz99/TRIX', '7596e14eefefe89e61396205a0550172cadeddb0') +INDUCTIVE_QE = ('DeepGraphLearning/InductiveQE', 'ab49a0e64e3449e687e484a42269d9898e1d1325') +IS_CQA = ('april-tools/is-cqa-complex', 'd1ce74164936a7c09d9147e83190da047cb39429') +REFERENCES = { + 'ultraquery': ULTRA, + 'ultraquery-lp': ULTRA, + 'inductive-gnnqe': INDUCTIVE_QE, + 'incoming-relation': INDUCTIVE_QE, + 'gnnqe': ('DeepGraphLearning/GNN-QE', '6620fe3d8d77ceed019f36541e84d67599d4f259'), + 'cqd': IS_CQA, + 'cqd-hybrid': IS_CQA, + 'qto': ('bys0318/QTO', '31f46b970d0f075e6b2be9c733cc11b41365d5fe'), + 'cone': ('MIRALab-USTC/QE-ConE', 'cc45b90e3cdce0f609670a257e6f756d28495a93'), + 'clmpt': ('qianlima-lab/CLMPT', '6c4f3b8a5e052e8bc1c0c93eaed18ef869a1bcd7'), +} +KGFM_ADAPTERS = ('ultra-adapter', 'trix-adapter') +METHODS = (*REFERENCES, *KGFM_ADAPTERS) +# Methods whose checkpoints score queries without the inference graph. +GRAPH_INDEPENDENT_METHODS = ('cone', 'clmpt', 'cqd') + + +def dataset_spec(name: str) -> tuple[str, str, str]: + """Locate a released benchmark. + + Args: + name: A name from ``BENCHMARK_DATASETS`` or ``PLUS_H_DATASETS``. + + Returns: + The setting (``'transductive'``, ``'inductive-e'`` or ``'inductive-er'``), + the dataset folder below the data root, and the release archive URL. + + Raises: + ValueError: If ``name`` is not a released benchmark. + """ + if name in PLUS_H_FOLDERS: + return 'transductive', f'{PLUS_H_PREFIX}/{PLUS_H_FOLDERS[name]}', PLUS_H_ARCHIVE + if name in TRANSDUCTIVE: + return 'transductive', TRANSDUCTIVE[name], 'https://snap.stanford.edu/betae/KG_data.zip' + family, _, version = name.partition(':') + if family in ('InductiveFB15k237Query', 'InductiveFB15k237QueryExtendedEval') and version in INDUCTIVE_VERSIONS: + return 'inductive-e', version, f'https://zenodo.org/records/7306046/files/{version}.zip' + if family == 'WikiTopicsQuery' and version in WIKITOPICS: + return 'inductive-er', f'WikiTopics_QE/{version}', 'https://reltrans.s3.us-east-2.amazonaws.com/WikiTopics_QE.zip' + raise ValueError(f'Unknown benchmark {name!r}; choose from BENCHMARK_DATASETS or PLUS_H_DATASETS') + + +def query_types_for_dataset(name: str) -> tuple[str, ...]: + """The query types released for benchmark ``name``: 16 for +H, 14 otherwise.""" + dataset_spec(name) + return PLUS_H_SHAPES if name in PLUS_H_DATASETS else ULTRAQUERY_SHAPES + + +def inference_graph_for_split(name: str, split: str, inference_graph: str | None = None) -> str | None: + """The facts that answer +H queries of ``split``; None for datasets with released inference graphs. + + Args: + name: Benchmark name. + split: ``'valid'`` or ``'test'``. + inference_graph: ``'train'`` or ``'train+valid'`` for +H test queries + (default: train+valid). Validation always uses training facts. + + Raises: + ValueError: For an unknown graph, or an override outside +H. + """ + if inference_graph not in (None, 'train', 'train+valid'): + raise ValueError('Inference graph must be train or train+valid') + if name not in PLUS_H_DATASETS: + if inference_graph is not None: + raise ValueError('Inference graph overrides are only supported for +H') + return None + return (inference_graph or 'train+valid') if split == 'test' else 'train' + + +def check_recipe(entry: dict, shapes: list[str] | tuple[str, ...]) -> None: + """Check the method rules of an evaluation recipe. + + Shared by the evaluator and the benchmark manifests, so both reject the + same recipes before any data or checkpoint is opened. + + Args: + entry: Recipe with ``method`` and optional ``options``, ``query_batch_size`` + and, for KGFM adapters, ``operators``, ``adapters``, ``selection_protocol`` + and ``adapter_ablation``. + shapes: Query types the recipe evaluates. + + Raises: + ValueError: If the recipe breaks a rule of its method. + """ + method, options = entry['method'], entry.get('options', {}) + if method not in METHODS: + raise ValueError(f'Choose a supported query method: {", ".join(METHODS)}') + if method in ('cqd', 'cqd-hybrid') and any('n' in shape for shape in shapes) and not options.get('atomic_negation'): + raise ValueError('CQD negated query types require atomic_negation=true; otherwise select positive query types') + size = entry.get('query_batch_size', 1) + if type(size) is not int or size < 1: + raise ValueError('Query batch size must be positive') + if method not in KGFM_ADAPTERS: + return + if options.get('observed_facts', 'none') not in ('none', 'atomic', 'both'): + raise ValueError('Observed facts must be none, atomic, or both') + if type(entry.get('adapter_ablation', False)) is not bool: + raise ValueError('Adapter ablation must be a boolean') + if entry.get('selection_protocol') not in ('source-validation', 'target-validation'): + raise ValueError('Declare the operator selection protocol') + operators = entry.get('operators', {}) + if set(operators) != set(shapes) or set(operators.values()) - {'product', 'min'} or set(operators.values()) - entry.get('adapters', {}).keys(): + raise ValueError('Each query type needs one operator, product or min, with its matching adapter') diff --git a/dicee/query_answering/context.py b/dicee/query_answering/context.py new file mode 100644 index 000000000..075665d40 --- /dev/null +++ b/dicee/query_answering/context.py @@ -0,0 +1,168 @@ +"""Public-ID graph context; answers and evaluation labels never enter this object.""" + +import hashlib +import json +import math +from collections import Counter, defaultdict +from contextlib import contextmanager +from dataclasses import dataclass + +import torch + +from ..models._inference import to_device +from ._query import exact_answers + + +def fingerprint(value): + return hashlib.sha256(json.dumps(value, sort_keys=True, separators=(',', ':')).encode()).hexdigest() + + +def state_fingerprint(model_or_state): + state = model_or_state.state_dict() if hasattr(model_or_state, 'state_dict') else model_or_state + digest = hashlib.sha256() + for name, tensor in sorted(state.items()): + tensor = tensor.detach().cpu().contiguous() + digest.update(json.dumps([name, str(tensor.dtype), list(tensor.shape)]).encode()) + digest.update(tensor.reshape(-1).view(torch.uint8).numpy().tobytes()) + return digest.hexdigest() + + +def state_token(model): + """Cheap mutation token; inference tensors cannot safely be retained in caches. + + Use normal PyTorch parameter/buffer updates (copy_, load_state_dict, optimizers), + not writes through .data, which bypass PyTorch's mutation counters. + """ + tensors = (*model.named_parameters(), *model.named_buffers()) + if any(t.is_inference() for _, t in tensors): + return None + return (id(model), tuple((name, id(t), t._version, t.device, t.dtype, tuple(t.shape)) + for name, t in tensors)) + + +@dataclass(frozen=True) +class QueryContext: + """A complete public vocabulary and a deduplicated set of observed triples. + + Explicit inverse pairs use public direct/inverse IDs, never an assumed ID parity. + Supplied inverse pairs add reciprocal facts to the context. + """ + + triples: tuple + num_entities: int + num_relations: int + inverse_relations: tuple = () + + def __post_init__(self): + if type(self.num_entities) is not int or type(self.num_relations) is not int or min(self.num_entities, self.num_relations) < 1: + raise ValueError('Positive integer vocabulary sizes are required') + pairs = dict(self.inverse_relations) + ids = [r for pair in pairs.items() for r in pair] + if len(set(ids)) != len(ids) or any(type(r) is not int or not 0 <= r < self.num_relations for r in ids): + raise ValueError('Inverse pairs must be disjoint public relation IDs') + triples = self.triples.tolist() if hasattr(self.triples, 'tolist') else self.triples + edges = set() + inverse = {a: b for h, t in pairs.items() for a, b in ((h, t), (t, h))} + for triple in triples: + if len(triple) != 3 or any(type(v) is not int for v in triple): + raise ValueError('Context triples must contain three integer IDs') + h, r, t = triple + if not (0 <= h < self.num_entities and 0 <= t < self.num_entities and 0 <= r < self.num_relations): + raise ValueError('Context triple outside the public vocabulary') + edges.add((h, r, t)) + if r in inverse: + edges.add((t, inverse[r], h)) + object.__setattr__(self, 'triples', tuple(sorted(edges))) + object.__setattr__(self, 'inverse_relations', tuple(sorted(pairs.items()))) + out = defaultdict(lambda: defaultdict(set)) + for h, r, t in edges: + out[h][r].add(t) + object.__setattr__(self, 'outgoing', {h: dict(rs) for h, rs in out.items()}) + object.__setattr__(self, 'heads', Counter(h for h, _, _ in edges)) + object.__setattr__(self, 'relations', Counter(r for _, r, _ in edges)) + object.__setattr__(self, '_identity', fingerprint(self.to_dict())) + + @classmethod + def from_model(cls, model): + """Translate GraphKGE's internal reciprocal IDs back into its public IDs.""" + model._require_graph() + mapping = model.relation_id_map.detach().cpu().tolist() + public = {internal: external for external, internal in enumerate(mapping)} + direct_count = model.num_direct_relations + pairs = {external: public[internal + direct_count] for internal, external in public.items() + if internal < direct_count and internal + direct_count in public} + triples = [(h, public[r], t) for h, r, t in model.graph_triples.detach().cpu().tolist() if r in public] + return cls(triples, model.num_entities, model.num_relations, tuple(pairs.items())) + + @property + def identity(self): + return self._identity + + def to_dict(self): + return dict(triples=self.triples, num_entities=self.num_entities, num_relations=self.num_relations, + inverse_relations=self.inverse_relations) + + def answers(self, tree): + return exact_answers(tree, self.outgoing, self.num_entities) + + def features(self, conditions, *, device): + # Build on the host, then copy once: per-row device indexing waits for queued kernels. + observed = torch.zeros((len(conditions), self.num_entities), dtype=torch.bool) + rows, columns, base = [], [], [] + n, nr = self.num_entities, self.num_relations + for i, (h, r) in enumerate(conditions): + tails = self.outgoing.get(h, {}).get(r, ()) + rows.extend([i] * len(tails)) + columns.extend(tails) + base.append([1., math.log1p(len(tails)) / math.log1p(n), + math.log1p(self.heads[h]) / math.log1p(n * nr), + math.log1p(self.relations[r]) / math.log1p(n * n)]) + if columns: + observed[rows, columns] = True + return to_device(observed, device), to_device(torch.tensor(base, dtype=torch.float64), device) + + +@contextmanager +def attached_context(model, context): + """Attach an inference context temporarily and restore the caller's graph.""" + from ..models.graph_model import GraphKGE + if not isinstance(model, GraphKGE): + if (model.num_entities, model.num_relations) != (context.num_entities, context.num_relations): + raise ValueError('Transductive source must use the fixed backbone vocabulary') + yield + return + old = QueryContext.from_model(model) if model.graph_triples is not None else None + buffers = dict(model._buffers) + walk_graph = getattr(model, '_walk_graph', None) + sizes = model.num_entities, model.num_relations, model.num_direct_relations + try: + model.set_graph(context.triples, num_entities=context.num_entities, num_relations=context.num_relations, + inverse_relations=dict(context.inverse_relations)) + yield + finally: + if old is not None: + model.set_graph(old.triples, num_entities=old.num_entities, num_relations=old.num_relations, + inverse_relations=dict(old.inverse_relations)) + else: + for name, value in buffers.items(): + setattr(model, name, value) + if hasattr(model, '_walk_graph'): + model._walk_graph = walk_graph + model.num_entities, model.num_relations, model.num_direct_relations = sizes + model.clear_inference_cache() + + +@contextmanager +def evaluation_mode(model): + """Restore all module modes, including mixed train/eval configurations.""" + modes = [(module, module.training) for module in model.modules()] + if not any(training for _, training in modes): + yield + return + model.eval() + try: + yield + finally: + model.train(modes[0][1]) + for module, training in modes: + module.training = training diff --git a/dicee/query_answering/datasets.py b/dicee/query_answering/datasets.py new file mode 100644 index 000000000..95bef4ca1 --- /dev/null +++ b/dicee/query_answering/datasets.py @@ -0,0 +1,327 @@ +"""Load published UltraQuery and Is-CQA-Complex +H files without PyG. + +Graph splits and public inverse IDs follow DeepGraphLearning/ULTRA's +ultra/datasets_query.py at 427966ad8ed60420eef034063d44f3153addff90. +""" + +import hashlib +import pickle +import shutil +import tempfile +import urllib.request +import zipfile +from collections import Counter, defaultdict +from collections.abc import Sequence +from dataclasses import dataclass, field +from pathlib import Path + +import torch + +from ._query import QUERY_SHAPES, compile_query, index_query, nested +from .catalog import ( # noqa: F401 + BENCHMARK_DATASETS, + INDUCTIVE_VERSIONS, + IS_CQA, + PLUS_H_ARCHIVE, + PLUS_H_DATASETS, + PLUS_H_FOLDERS, + PLUS_H_PREFIX, + TRANSDUCTIVE, + ULTRA, + WIKITOPICS, + dataset_spec, + inference_graph_for_split, + query_types_for_dataset, +) +from .context import QueryContext, fingerprint + +REFERENCE_COMMIT = ULTRA[1] +PLUS_H_REFERENCE_COMMIT = IS_CQA[1] + + +def audit_plus_h_filters(root, data): + """Verify the authors' corrected filters; retain every root hard target. + + The complete graph is label-generation input only. It never leaves this + function or becomes the benchmark's inference context. + """ + if data.name not in PLUS_H_DATASETS or data.split != 'test': + raise ValueError('Filter correction is only defined for +H test labels') + folder = Path(root) / dataset_spec(data.name)[1] + graph = folder / 'KG_splits' if data.name == 'ICEWS18+H' else folder + files, triples = {}, [] + for split in ('train', 'valid', 'test'): + path = graph / f'{split}.txt' + payload = path.read_bytes() + files[path.relative_to(folder).as_posix()] = hashlib.sha256(payload).hexdigest() + triples.extend(tuple(map(int, line.split())) for line in payload.splitlines() if line.strip()) + full = QueryContext(triples, data.context.num_entities, data.context.num_relations, data.context.inverse_relations) + author_filters = {} + if data.name != 'ICEWS18+H': + for shape in ('2in', 'pni'): + selected = {q.query: q for q in data.queries if q.shape == shape} + if not selected: + continue + source = {} + for kind in ('queries', 'easy-answers', 'hard-answers'): + path = folder / 'test-query-reduction' / shape / 'all' / f'test-{kind}.pkl' + payload = path.read_bytes() + files[path.relative_to(folder).as_posix()] = hashlib.sha256(payload).hexdigest() + source[kind] = pickle.loads(payload) + queries = {q for group in source['queries'].values() for q in group} + if queries != selected.keys() or set(source['easy-answers']) != queries or set(source['hard-answers']) != queries: + raise ValueError('Author all/ files must contain exactly the selected query type') + for query, record in selected.items(): + if source['hard-answers'][query] != record.hard: + raise ValueError('Author all/ files changed the released hard targets') + author_filters[query] = frozenset(source['easy-answers'][query]) + changes, counts = {}, defaultdict(Counter) + for query in data.queries: + if 'n' not in query.shape: + continue + truth = full.answers(compile_query(query.query)) + if query.hard - truth: + raise ValueError(f'Released hard targets are not true in the complete graph: {data.name} {query.query}') + corrected = author_filters.get(query.query, query.easy) + if corrected != truth - query.hard: + raise ValueError(f'Author filters disagree with full-graph truth: {data.name} {query.query}') + remove, add = query.easy - corrected, corrected - query.easy + counts[query.shape].update(queries=1, hard_answers=len(query.hard), removed=len(remove), added=len(add), + changed_queries=int(bool(remove or add))) + if remove or add: + key = query.identity + changes[key] = dict(remove=sorted(remove), add=sorted(add)) + return dict(version=1, dataset=data.name, source_files=files, per_shape=dict(counts), changes=changes, + policy='Use author 2in/all and pni/all filters for FB/NELL; retain all root hard targets and other filters.') + + +def corrected_answer_filters(data, audit): + lookup = {q.identity: q for q in data.queries} + if set(audit['changes']) - lookup.keys(): + raise ValueError('Answer-filter audit does not match the benchmark queries') + return {lookup[key].query: (lookup[key].easy - set(change['remove'])) | set(change['add']) + for key, change in audit['changes'].items()} + + +@dataclass(frozen=True) +class BenchmarkQuery: + shape: str + query: tuple + easy: frozenset + hard: frozenset + + @property + def identity(self) -> str: + """Stable ID of the query and its released answers, used by plans, traces and audits.""" + return fingerprint((self.shape, self.query, sorted(self.easy), sorted(self.hard))) + + +@dataclass +class QueryBenchmark: + name: str + group: str + split: str + context: QueryContext + queries: tuple + candidates: tuple + metadata: dict = field(default_factory=dict) + entity_to_idx: dict | None = None + relation_to_idx: dict | None = None + + def __post_init__(self): + n, nr = self.context.num_entities, self.context.num_relations + candidates = set(self.candidates) + if not candidates or len(candidates) != len(self.candidates) or any(type(i) is not int or not 0 <= i < n for i in candidates): + raise ValueError('Benchmark candidates must be distinct valid entity IDs') + if not self.queries: + raise ValueError('Benchmark has no queries for the selected shapes') + seen = set() + for q in self.queries: + index_query(q.shape, q.query, range(n), range(nr)) + if q.query in seen: + raise ValueError('Duplicate benchmark query') + seen.add(q.query) + if not q.hard or q.easy & q.hard or not (q.easy | q.hard) <= candidates: + raise ValueError('Answers must be disjoint, include hard answers, and belong to the candidate domain') + + +def source_query_groups(data, root, shapes): + """Recover original per-type order for methods whose batches affect scores.""" + files = [name for name in data.metadata['files'] if name.endswith('queries.pkl')] + if len(files) != 1: + raise ValueError('Expected one source query file for upstream ordering') + with (Path(root) / dataset_spec(data.name)[1] / files[0]).open('rb') as stream: + structured = pickle.load(stream) + lookup = {query.query: query for query in data.queries} + return [[lookup[nested(query)] for query in structured[QUERY_SHAPES[shape]]] for shape in shapes] + + +def download_benchmark(name, root): + """Download an official archive once and extract its data under root.""" + _, folder, url = dataset_spec(name) + root = Path(root).expanduser().resolve() + root.mkdir(parents=True, exist_ok=True) + with tempfile.TemporaryDirectory(dir=root, prefix='.download-') as temporary: + archive = Path(temporary) / 'data.zip' + with urllib.request.urlopen(url, timeout=120) as response, archive.open('wb') as stream: + shutil.copyfileobj(response, stream) + with zipfile.ZipFile(archive) as zipped: + # Validate the complete archive before writing any member. + for member in zipped.infolist(): + target = (root / member.filename).resolve() + if not target.is_relative_to(root) or (member.external_attr >> 16) & 0o170000 == 0o120000: + raise ValueError('Unsafe path in dataset archive') + members = zipped.infolist() + if name in PLUS_H_DATASETS: + # This release also contains old benchmarks, training queries, + # and large stratified analyses. Extract only evaluation inputs + # for all three +H datasets, so the suite downloads only once. + prefixes = [f'{PLUS_H_PREFIX}/{folder}/' for folder in PLUS_H_FOLDERS.values()] + inputs = {'id2ent.pkl', 'id2rel.pkl', 'train.txt', 'valid.txt', 'test.txt', 'stats.txt', + *(f'{split}-{kind}.pkl' for split in ('valid', 'test') + for kind in ('queries', 'easy-answers', 'hard-answers')), + *(f'test-query-reduction/{shape}/all/test-{kind}.pkl' for shape in ('2in', 'pni') + for kind in ('queries', 'easy-answers', 'hard-answers'))} + members = [m for m in members for prefix in prefixes if m.filename.startswith(prefix) + and (m.filename[len(prefix):] in inputs or + m.filename[len(prefix):] in {'KG_splits/train.txt', 'KG_splits/valid.txt', 'KG_splits/test.txt'})] + zipped.extractall(root, members=members) + return root / folder + + +def load_benchmark(root: str | Path, name: str, *, split: str = 'test', query_types: Sequence[str] | None = None, + download: bool = False, inference_graph: str | None = None) -> QueryBenchmark: + """Load a released benchmark split from its official, trusted pickle files. + + Entity and relation IDs and answer labels are kept unchanged. Edges of the + evaluated split never enter the inference graph: +H test queries use + train+valid facts unless ``inference_graph='train'``, and validation queries + always use training facts. + + Args: + root: Directory into which the official archives are extracted. + name: A name from ``BENCHMARK_DATASETS`` or ``PLUS_H_DATASETS``. + split: ``'valid'`` or ``'test'``. + query_types: Query types to load (default: every type of the dataset). + download: Download and extract a missing archive into ``root``. + inference_graph: Facts for +H test queries, ``'train'`` or ``'train+valid'``. + + Returns: + The queries with their easy and hard answers, inference graph and candidates. + + Raises: + FileNotFoundError: If the dataset is missing and ``download`` is false. + ValueError: For an invalid split or query types, or inconsistent released files. + """ + if split not in ('valid', 'test'): + raise ValueError('Benchmark split must be valid or test') + group, folder, url = dataset_spec(name) + plus_h = name in PLUS_H_DATASETS + inference_graph = inference_graph_for_split(name, split, inference_graph) + expected_shapes = query_types_for_dataset(name) + shapes = tuple(expected_shapes if query_types is None else query_types) + if not shapes or len(set(shapes)) != len(shapes) or set(shapes) - set(expected_shapes): + raise ValueError('Select distinct supported query types for this benchmark (use 2u/up for DNF unions)') + path = Path(root).expanduser() / folder + if not path.is_dir(): + if not download: + raise FileNotFoundError(f'{path}: extract {url} under {root}, or pass download=True') + download_benchmark(name, root) + checksums = {} + + def source(filename): + file = path / filename + with file.open('rb') as stream: + checksums[filename] = hashlib.file_digest(stream, 'sha256').hexdigest() + return file + + def unpickle(filename): + with source(filename).open('rb') as stream: + return pickle.load(stream) + + def triples(stem): + if (path / f'{stem}.txt').is_file(): + with source(f'{stem}.txt').open() as stream: + return [tuple(map(int, line.split())) for line in stream if line.strip()] + return [tuple(row) for row in torch.load(source(f'{stem}.pt'), map_location='cpu', weights_only=True).tolist()] + + def nodes(edges): + return sorted({v for h, _, t in edges for v in (h, t)}) + + entities = relations = None + extended = name.startswith('InductiveFB15k237QueryExtendedEval:') + if group == 'transductive': + entities, relations = unpickle('id2ent.pkl'), unpickle('id2rel.pkl') + n, nr = len(entities), len(relations) + if set(entities) != set(range(n)) or set(relations) != set(range(nr)): + raise ValueError('Expected contiguous public vocabulary IDs') + graph_prefix = 'KG_splits/' if name == 'ICEWS18+H' else '' + edges = triples(graph_prefix + 'train') + if plus_h and split == 'test' and inference_graph == 'train+valid': + edges += triples(graph_prefix + 'valid') + candidates = list(range(n)) + pairs = tuple((r, r + 1) for r in range(0, nr, 2)) + structured = unpickle(f'{split}-queries.pkl') + easy, hard = unpickle(f'{split}-easy-answers.pkl'), unpickle(f'{split}-hard-answers.pkl') + else: + train = triples('train_graph') + if group == 'inductive-e': + valid, test = triples('val_inference'), triples('test_inference') + vocabulary = train + valid + test + n = max(nodes(vocabulary)) + 1 + nr = max(r for _, r, _ in vocabulary) + 1 + edges = train + (valid if split == 'valid' else test) + else: + edges = train if split == 'valid' else triples('test_inference') + n = max(nodes(edges)) + 1 + nr = max(r for _, r, _ in edges) + 1 + if nodes(edges) != list(range(n)): + raise ValueError('WikiTopics requires contiguous entity IDs') + candidates = nodes(edges) + pairs = tuple((r, r + nr // 2) for r in range(nr // 2)) + if group == 'inductive-er' and (path / 'og_mappings.pkl').is_file(): + # The full relation vocabulary can contain trailing unused IDs; + # max(observed ID) + 1 need not be twice the inverse offset. + mapping = unpickle('og_mappings.pkl')['r2id'] + pairs = tuple((r, mapping[label + '_inv']) for label, r in mapping.items() + if label + '_inv' in mapping and r < nr and mapping[label + '_inv'] < nr) + elif nr % 2: + raise ValueError('A relation mapping is required for an incomplete reciprocal vocabulary') + structured = unpickle('train_queries.pkl' if extended else f'{split}_queries.pkl') + easy = None if extended else unpickle(f'{split}_answers_easy.pkl') + hard = unpickle(f'train_answers_{split}.pkl' if extended else f'{split}_answers_hard.pkl') + if group == 'transductive' and nr % 2: + raise ValueError('Official benchmarks require paired direct/inverse relations') + # These archives already contain reciprocals. Fail rather than silently + # changing the inference graph if their documented convention does not hold. + context = QueryContext(edges, n, nr, pairs) + if set(context.triples) != set(edges): + raise ValueError('Dataset graph is missing reciprocal edges or uses unexpected inverse IDs') + records, available = [], set() + for structure, queries in structured.items(): + shape = next((key for key, value in QUERY_SHAPES.items() if value == nested(structure)), None) + if shape not in shapes: + continue + available.add(shape) + for i, query in enumerate(queries): + if group == 'transductive': + e, h = easy[query], hard[query] + elif extended: + e, h = (), hard[structure][i] + else: + e, h = easy[structure][query], hard[structure][query] + records.append(BenchmarkQuery(shape, nested(query), frozenset(e), frozenset(h))) + if set(shapes) - available: + raise ValueError(f'Missing requested query types: {sorted(set(shapes) - available)}') + records.sort(key=lambda q: (q.shape, q.query)) + metadata = dict(reference_commit=PLUS_H_REFERENCE_COMMIT if plus_h else REFERENCE_COMMIT, + suite='plus-h' if plus_h else 'ultraquery', files=checksums, url=url, + query_types=list(shapes), expected_query_types=list(expected_shapes), + evaluation='hardness-balanced-answers' if plus_h else 'faithfulness' if extended else 'hard-answers') + if plus_h: + metadata.update(paper='https://arxiv.org/abs/2410.12537', release='benchs-1.0', + inference_graph='train+valid' if split == 'test' and inference_graph == 'train+valid' else 'train', + answer_filter='published easy answers, including non-selected inference answers') + return QueryBenchmark(name, group, split, context, tuple(records), tuple(candidates), metadata, + {v: k for k, v in entities.items()} if entities else None, + {v: k for k, v in relations.items()} if relations else None) diff --git a/dicee/query_answering/engine.py b/dicee/query_answering/engine.py new file mode 100644 index 000000000..823096bd5 --- /dev/null +++ b/dicee/query_answering/engine.py @@ -0,0 +1,352 @@ +"""Shared beam and exact query execution over complete atomic rows.""" + +import math +import weakref +from collections import OrderedDict +from contextlib import contextmanager + +import torch + +from ..models._inference import to_device +from ._deferred import deferred_checks, require +from ._query import atomic_conditions, compile_query, execute_query, positive, validate_tree +from .context import QueryContext, evaluation_mode, fingerprint, state_token +from .score_adapter import QueryScoreAdapter + +# Public contexts derived from graph models, released with the model. +_MODEL_CONTEXTS = weakref.WeakKeyDictionary() + + +def _model_context(model, token, tensors): + """Share one derived context among all scorers of a model (e.g. adapter controls). + + The entry holds the graph tensors themselves, so a reused object ID cannot match. + """ + shared = _MODEL_CONTEXTS.get(model) + if shared is None or shared[0] != token or any(a is not b for a, b in zip(shared[1], tensors)): + shared = _MODEL_CONTEXTS[model] = token, tensors, QueryContext.from_model(model) + return shared[2] + + +class AtomicBatchCache: + """Share bounded logits across adapters without changing batch geometry. + + ``model`` keeps scores on their producing device, avoiding host round trips + when GPU memory is available. CPU storage remains the portable default. + """ + + def __init__(self, max_bytes, *, device='cpu'): + if type(max_bytes) is not int or max_bytes < 0: + raise ValueError('Atomic cache size must be a nonnegative integer') + if device not in ('cpu', 'model'): + raise ValueError('Atomic cache device must be cpu or model') + self.max_bytes = max_bytes + self.device = device + self.rows, self.token, self.used = OrderedDict(), None, 0 + self.hits, self.computed, self.peak = 0, 0, 0 + + def clear(self): + self.rows.clear() + self.used, self.token = 0, None + + def get(self, token, conditions): + if token is None or token != self.token: + self.clear() + self.token = token + key = tuple(conditions) + if token is not None and key in self.rows: + self.rows.move_to_end(key) + self.hits += len(conditions) + return self.rows[key] + return None + + def put(self, conditions, values): + self.computed += len(conditions) + size = values.numel() * values.element_size() + if self.token is None or size > self.max_bytes: + return + key = tuple(conditions) + if key in self.rows: + old = self.rows.pop(key) + self.used -= old.numel() * old.element_size() + while self.rows and self.used + size > self.max_bytes: + _, old = self.rows.popitem(last=False) + self.used -= old.numel() * old.element_size() + target = values.device if self.device == 'model' else 'cpu' + self.rows[key] = values.detach().to(target, copy=True) + self.used += size + self.peak = max(self.peak, self.used) + + +class AtomicScorer: + """Use DICE's existing all-tail API; only stochastic scoring needs special care.""" + + def __init__(self, model, context=None, *, row_batch_size=8, seed=0, samples=None, raw_cache=None): + from ..models.graph_model import GraphKGE, RelationGraphKGE + if isinstance(model, RelationGraphKGE) or getattr(model, 'relation_prediction', False) or getattr(model, 'name', None) == 'Shallom': + raise ValueError('Entity query answering requires an entity-prediction model') + if type(row_batch_size) is not int or row_batch_size < 1 or (samples is not None and (type(samples) is not int or samples < 1)) or type(seed) is not int: + raise ValueError('Positive row/sample counts and an integer seed are required') + self.model, self.explicit_context = model, context + self.graph_model = isinstance(model, GraphKGE) + self.row_batch_size, self.seed, self.samples = row_batch_size, seed, samples + self.raw_cache = raw_cache + self.refresh() + + def refresh(self): + self.n, self.nr = self.model.num_entities, self.model.num_relations + if not isinstance(self.n, int) or not isinstance(self.nr, int) or min(self.n, self.nr) < 1: + raise ValueError('Query answering requires a complete, positive entity/relation vocabulary') + attached = None + if self.graph_model: + from ..models._fused_message import tensor_version + self.model._require_graph() + tensors = (self.model.graph_triples, self.model.relation_id_map) + token = (self.n, self.nr, self.model.num_direct_relations, + *((id(t), tensor_version(t)) for t in tensors)) + cacheable = all(not t.is_inference() for t in tensors) + if not cacheable or token != getattr(self, '_context_token', None): + self._attached_context = (_model_context(self.model, token, tensors) if cacheable + else QueryContext.from_model(self.model)) + self._context_token = token + attached = self._attached_context + if attached is not None and self.explicit_context is not None and attached.identity != self.explicit_context.identity: + raise ValueError('Observed context must match the graph attached to the model') + self.context = attached if self.explicit_context is None else self.explicit_context + if self.context is not None and (self.context.num_entities, self.context.num_relations) != (self.n, self.nr): + raise ValueError('Context and model vocabularies disagree') + + @property + def device(self): + return next(self.model.parameters(), torch.empty(0)).device + + @contextmanager + def evaluation(self): + """Enter evaluation mode once for a query, including all scoring batches.""" + if getattr(self, '_evaluating', False): + yield + return + with evaluation_mode(self.model): + self._evaluating = True + try: + yield + finally: + self._evaluating = False + + def cache_token(self): + from ..models._inference import float32_precision_token + from ..models.flock import Flock + # Training callers can still reuse rows within a query, but never carry + # them across predictions. Autocast and unversioned tensors also opt out. + if any(m.training for m in self.model.modules()) or torch.is_autocast_enabled(self.device.type): + return None + token = self.model.inference_token() if self.graph_model else state_token(self.model) + if token is None: + return None + sampling = None + if isinstance(self.model, Flock): + sampling = (self.seed, self.model.test_samples if self.samples is None else self.samples, + self.model.walk_num, self.model.walk_len, self.model.refinements, + self.model.compact_state, self.model.pack_walks, self.model.compile_sampler) + return (id(self.model), token, self.n, self.nr, self.context.identity if self.context else None, + self.row_batch_size, getattr(self.model, 'query_batch_size', None), sampling, + float32_precision_token(), torch.are_deterministic_algorithms_enabled()) + + @torch.no_grad() + def rows(self, conditions): + from ..models.flock import Flock + from ..models.graph_model import GraphKGE + conditions = [tuple(map(int, pair)) for pair in conditions] + if not conditions: + return torch.empty((0, self.n), device=self.device) + if any(not (0 <= h < self.n and 0 <= r < self.nr) for h, r in conditions): + raise ValueError('Atomic query outside the public vocabulary') + token = self.cache_token() if self.raw_cache is not None else None + with self.evaluation(): + cached = self.raw_cache.get(token, conditions) if self.raw_cache is not None else None + if cached is not None: + return cached.to(self.device, copy=True) + if isinstance(self.model, Flock): + samples = self.model.test_samples if self.samples is None else self.samples + seeds = [int(fingerprint([self.context.identity, self.seed, samples, h, r])[:15], 16) for h, r in conditions] + result = self.model.forward_k_vs_all_seeded(torch.tensor(conditions, device=self.device), seeds, samples=samples) + else: + # Graph models validate and map host queries before an asynchronous copy. + host = self.graph_model and type(self.model).forward_k_vs_sample is GraphKGE.forward_k_vs_sample + batches = (torch.tensor(conditions[start:start + self.row_batch_size]) + for start in range(0, len(conditions), self.row_batch_size)) + result = torch.cat([self.model.forward_k_vs_all(batch if host else to_device(batch, self.device)) + for batch in batches]) + if result.shape != (len(conditions), self.n): + raise ValueError('Atomic scorer must return finite complete [rows, entities] logits') + require(torch.isfinite(result).all(), ValueError('Atomic scorer must return finite complete [rows, entities] logits')) + if self.raw_cache is not None: + self.raw_cache.put(conditions, result) + return result.detach() + + +class QueryAnswerer: + """Answer indexed query tuples with the same evaluator for KGEs and KGFMs. + + Graph models supply their attached context automatically. For a transductive + model, pass QueryContext to use context features or observed memberships. + ``predict`` returns memberships (or log-memberships with ``return_log_scores``). + Evaluation-mode predictions share a bounded row cache, invalidated by graph, + weight, adapter or inference-setting changes. Training callers cache only + within a prediction. ``last_info`` reports reuse and whether a beam pruned. + ``restore_observed=False`` disables final proof restoration while retaining + the adapter's atomic observed-fact setting. + """ + + def __init__(self, model, *, context=None, adapter=None, observed_mix=None, + row_batch_size=8, cache_bytes=64 * 1024 * 1024, seed=0, samples=None, raw_cache=None, + restore_observed=True): + if cache_bytes < 0: + raise ValueError('Cache size must be nonnegative') + if type(restore_observed) is not bool: + raise ValueError('Observed-answer restoration must be a boolean') + self.scorer = AtomicScorer(model, context, row_batch_size=row_batch_size, seed=seed, samples=samples, raw_cache=raw_cache) + if adapter is not None and observed_mix is not None and observed_mix != adapter.observed_mix: + raise ValueError('Set observed_mix on the adapter instead of overriding it') + self.adapter = adapter if adapter is not None else QueryScoreAdapter('global', observed_mix or 0.) + self.custom_adapter = adapter is not None + self.restore_observed = restore_observed + self.cache_bytes = cache_bytes + self.last_info = {} + self.clear_cache() + + def clear_cache(self): + """Release rows, also required after custom non-tensor scoring changes.""" + self._cache, self._cache_used, self._cache_token = OrderedDict(), 0, None + + def _prepare_cache(self, use_logits): + token, adapter_token = self.scorer.cache_token(), state_token(self.adapter) + if token is None and self.scorer.raw_cache is not None: + self.scorer.raw_cache.clear() + token = ((token, adapter_token, tuple(self.adapter.configuration.items()), use_logits) + if token is not None and adapter_token is not None else None) + if token is None or token != self._cache_token: + self.clear_cache() + self._cache_token = token + while self._cache and self._cache_used > self.cache_bytes: + _, old = self._cache.popitem(last=False) + self._cache_used -= old.numel() * old.element_size() + + def _condition_batches(self, conditions, use_logits, stats): + cache = self._cache + for start in range(0, len(conditions), self.scorer.row_batch_size): + batch = conditions[start:start + self.scorer.row_batch_size] + ready, missing = {}, [] + for key in dict.fromkeys(batch): + if key in cache: + ready[key] = cache[key] + cache.move_to_end(key) + stats['cache_hits'] += 1 + else: + missing.append(key) + if missing: + raw = self.scorer.rows(missing).to(torch.float64) + stats['raw_rows'] += len(missing) + if use_logits: + transformed = raw + else: + context = self.scorer.context + needs_context = self.adapter.feature_mode != 'global' or self.adapter.observed_mix + obs, base = context.features(missing, device=raw.device) if context and needs_context else (None, None) + transformed = self.adapter(raw, obs, base) + for key, value in zip(missing, transformed): + # Copies keep evicted batches from being retained by one row. + value = value.clone() + ready[key] = value + size = value.numel() * value.element_size() + if size <= self.cache_bytes: + while self._cache_used + size > self.cache_bytes: + _, old = cache.popitem(last=False) + self._cache_used -= old.numel() * old.element_size() + cache[key] = value + self._cache_used += size + # Stacking also isolates returned scores from mutable cache storage. + yield batch, torch.stack([ready[key] for key in batch]) + + def _row_batches(self, heads, relation, use_logits, stats): + for batch, values in self._condition_batches([(head, relation) for head in heads], use_logits, stats): + yield [head for head, _ in batch], values + + @torch.no_grad() + def prefetch(self, queries, *, use_logits=False): + """Warm reusable anchor rows without inspecting answer labels.""" + self.scorer.refresh() + self.adapter.verify_model(self.scorer.model) + self._prepare_cache(use_logits) + stats = dict(raw_rows=0, cache_hits=0) + if self._cache_token is None or self.cache_bytes < self.scorer.n * 8: + return stats + conditions = [] + for query in queries: + tree = compile_query(query) + validate_tree(tree, self.scorer.n, self.scorer.nr) + conditions.extend(atomic_conditions(tree)) + missing = [key for key in dict.fromkeys(conditions) if key not in self._cache] + missing = missing[:self.cache_bytes // (self.scorer.n * 8)] + with self.scorer.evaluation(), self._checked(): + for _ in self._condition_batches(missing, use_logits, stats): + pass + return stats + + @contextmanager + def _checked(self): + """Read device-side validity checks once; drop rows cached before a failure.""" + try: + with deferred_checks(): + yield + except BaseException: + self.clear_cache() + if self.scorer.raw_cache is not None: + self.scorer.raw_cache.clear() + raise + + @torch.no_grad() + def predict(self, query, *, beam_size=64, tnorm='prod', neg_norm='standard', lambda_=0., + use_logits=False, return_log_scores=False, executor='cqd'): + """QTO evaluates every potentially improving head without a beam limit.""" + if executor not in ('cqd', 'qto'): + raise ValueError('Choose cqd or qto executor') + if executor == 'qto' and use_logits: + raise ValueError('QTO requires bounded memberships, not raw logits') + if type(beam_size) is not int or beam_size < 1: + raise ValueError('beam_size must be a positive integer') + if tnorm not in ('prod', 'min') or neg_norm not in ('standard', 'sugeno', 'yager'): + raise ValueError('Unknown conjunction or negation norm') + if not math.isfinite(lambda_) or (neg_norm == 'sugeno' and lambda_ <= -1) or (neg_norm == 'yager' and lambda_ <= 0): + raise ValueError('Sugeno requires lambda_ > -1; Yager requires lambda_ > 0') + if use_logits and (self.custom_adapter or self.adapter.observed_mix or return_log_scores): + raise ValueError('Raw logits cannot be combined with adapters, observed overrides, or log-membership output') + self.scorer.refresh() + self.adapter.verify_model(self.scorer.model) + n, nr = self.scorer.n, self.scorer.nr + context = self.scorer.context + if context is None and (self.adapter.feature_mode != 'global' or self.adapter.observed_mix): + raise ValueError('Adapter features and observed overrides require a context graph') + tree = compile_query(query) + validate_tree(tree, n, nr) + self._prepare_cache(use_logits) + stats = dict(raw_rows=0, cache_hits=0, pruned=False, negated_pruning=False, bound_skipped=0) + + # Skipped cache writes can change future miss batches; require scalar backend rows. + skip_zero_prefix = (not self.scorer.model.training and + getattr(self.scorer.model, 'query_batch_size', self.scorer.row_batch_size) == 1) + with self.scorer.evaluation(), self._checked(): + result, stats['pruned'] = execute_query( + tree, lambda heads, relation: self._row_batches(heads, relation, use_logits, stats), + n=n, device=self.scorer.device, row_batch_size=self.scorer.row_batch_size, + beam_size=beam_size, tnorm=tnorm, neg_norm=neg_norm, lambda_=lambda_, + use_logits=use_logits, executor=executor, stats=stats, skip_zero_prefix=skip_zero_prefix) + if self.restore_observed and not use_logits and self.adapter.observed_mix == 1 and positive(tree): + result = result.clone() + answers = sorted(context.answers(tree)) + if answers: + result.index_fill_(0, to_device(torch.tensor(answers), result.device), 0.) + require(~(torch.isnan(result) | torch.isposinf(result)).any(), + FloatingPointError('Query composition produced invalid scores')) + self.last_info = dict(stats, search='global-prefix' if executor == 'cqd' else 'exact', cache_bytes=self._cache_used) + return result if use_logits or return_log_scores else result.exp() diff --git a/dicee/query_answering/method_evaluation.py b/dicee/query_answering/method_evaluation.py new file mode 100644 index 000000000..2ee1beb0d --- /dev/null +++ b/dicee/query_answering/method_evaluation.py @@ -0,0 +1,359 @@ +"""Shared evaluation of checkpoint-compatible CQA methods and KGFM adapters.""" + +import time +from collections import Counter, defaultdict +from collections.abc import Callable, Mapping +from contextlib import ExitStack, contextmanager +from pathlib import Path +from typing import Any, cast + +import torch + +from ._checkpoint import checksum, write_json +from ._query import QUERY_SHAPES, compile_query +from .benchmark import _accumulate_inference_statistics, _query_plan, evaluate_benchmark +from .catalog import GRAPH_INDEPENDENT_METHODS, METHODS, check_recipe, query_types_for_dataset # noqa: F401 +from .context import attached_context, evaluation_mode, fingerprint +from .datasets import QueryBenchmark, load_benchmark, source_query_groups +from .engine import AtomicBatchCache, QueryAnswerer +from .methods import CLMPT, REFERENCES, ConE, load_method +from .methods._common import FuzzyGNN +from .score_adapter import QueryScoreAdapter + + +def save_results(report: dict[str, Any], output: str | Path, *, run: dict[str, Any], metadata: dict[str, Any], + rank_trace_path: str | Path | None = None) -> dict[str, Any]: + """Finalize shared provenance, paired results, and rank checksums together.""" + output = Path(output) + trace = Path(rank_trace_path) if rank_trace_path is not None else output / 'ranks.sqlite3' + for name, comparison in report.pop('comparisons', {}).items(): + filter_control = comparison.pop('filter_control_of', None) + if filter_control is None: + comparison['paired_with'] = run['entry'] + else: + comparison['filter_paired_with'] = run['entry'] + ('-' + filter_control if filter_control else '') + if filter_control: + comparison['paired_with'] = run['entry'] + '-released-filters' + comparison.update(metadata, benchmark_run=dict(run, entry=f'{run["entry"]}-{name}'), + rank_trace_sha256=checksum(trace.parent / name / 'ranks.sqlite3')) + write_json(output / name / 'result.json', comparison) + report.setdefault('comparison_results', {})[name] = checksum(output / name / 'result.json') + report.update(metadata, benchmark_run=run, rank_trace_sha256=checksum(trace)) + write_json(output / 'result.json', report) + return report + + +def evaluate_method(entry: Mapping[str, Any], *, output: str | Path, device: str = 'cpu', split: str = 'test', + limit: int | None = None, seed: int = 0, threads: int | None = None, data: QueryBenchmark | None = None, + query_plan: list | None = None, batch_ends: list[int] | None = None, + rank_trace_path: str | Path | None = None, provenance: dict | None = None, + query_order: str = 'relation', write_result: bool = True, + on_prediction: Callable[[tuple, Any], None] | None = None, reference_batches: dict | None = None, + on_control_prediction: Callable[[tuple, Any], None] | None = None, + filter_corrections: Mapping[tuple, frozenset | set] | None = None) -> dict[str, Any]: + """Evaluate a published method or a KGFM adapter recipe with shared metrics and resumable progress. + + Args: + entry: Recipe with ``method``, ``checkpoint``, ``dataset``, ``root`` and + optional ``options``, ``query_types``, ``query_batch_size`` and + ``inference_graph``. Transductive embedding methods also bind + ``vocabulary_dataset``; KGFM adapters specify ``adapters``, + per-type ``operators`` and ``selection_protocol``. + output: Directory for ``result.json``, rank traces and progress. + device: Inference device. + split: ``'valid'`` or ``'test'``. + limit: Uniform sample of at most this many queries per type. + seed: Sampling seed. + threads: CPU threads for PyTorch. + data: Preloaded benchmark matching ``entry`` and ``split``. + query_plan: Explicit ordered queries. + batch_ends: Explicit batch boundaries in ``query_plan``. + rank_trace_path: Rank trace file (default: ``output/ranks.sqlite3``). + provenance: Identity of a frozen study, replacing the direct-run identity. + query_order: ``'relation'``, ``'canonical'`` or ``'upstream-pickle'``. + write_result: Write ``result.json`` with run metadata. + on_prediction: Called with each query and its scores. + reference_batches: Upstream batch of each query's first member. + on_control_prediction: Called for identity-adapter control predictions. + filter_corrections: Corrected easy answers by query. + + Returns: + The evaluation report. + + Raises: + ValueError: If the recipe or supplied data are invalid. + """ + if entry.get('method') not in METHODS: + raise ValueError(f'Choose a supported query method: {METHODS}') + if data is not None and (data.name != entry.get('dataset') or data.split != split): + raise ValueError('Loaded benchmark does not match the requested dataset and split') + if data is not None and entry.get('inference_graph') is not None: + expected_graph = entry['inference_graph'] if split == 'test' else 'train' + if data.metadata.get('inference_graph') != expected_graph: + raise ValueError('Loaded benchmark does not match the requested inference graph') + kgfm = entry['method'] not in REFERENCES + required = {'method', 'checkpoint', 'dataset', 'root', *(('adapters', 'operators', 'selection_protocol') if kgfm else ())} + allowed = required | {'options', 'query_types', 'query_batch_size', 'id', 'inference_graph', + *(('adapter_ablation',) if kgfm else ('vocabulary_dataset', 'per_shape'))} + if required - entry.keys() or entry.keys() - allowed: + raise ValueError(f'Expected fields {sorted(required)}; unexpected fields {sorted(entry.keys() - allowed)}') + types = entry.get('query_types') + if types is not None and (not types or set(types) - QUERY_SHAPES.keys() or len(types) != len(set(types))): + raise ValueError('Invalid query type selection') + check_recipe(dict(entry), types or query_types_for_dataset(entry['dataset'])) + output = Path(output) + rank_trace_path = Path(rank_trace_path) if rank_trace_path is not None else output / 'ranks.sqlite3' + if query_plan is None and query_order == 'canonical': + query_order = 'published' + if query_plan is None and query_order == 'upstream-pickle': + data = data if data is not None else load_benchmark(entry['root'], entry['dataset'], split=split, + query_types=entry.get('query_types'), inference_graph=entry.get('inference_graph')) + selected = set(_query_plan(data, limit, 'published', sampling='uniform', seed=seed)) + shapes = entry.get('query_types') or list(dict.fromkeys(query.shape for query in data.queries)) + size = entry.get('query_batch_size', 1) + query_plan, batch_ends, reference_batches = [], [], dict(reference_batches or {}) + for group in source_query_groups(data, entry['root'], shapes): + for start in range(0, len(group), size): + batch = group[start:start + size] + probes = [query for query in batch if query in selected] + if probes: + reference_batches[probes[0].query] = [query.query for query in batch] + query_plan.extend(probes) + batch_ends.append(len(query_plan)) + limit = None + direct_run = dict(entry=entry.get('id', f'{entry["method"]}-{entry["dataset"]}'), + phase='test' if split == 'test' else 'pilot', mode='direct') + direct_metadata = {'reference': {'status': 'direct evaluation; no frozen-study verification'}} + if entry['method'] in REFERENCES: + if on_control_prediction is not None: + raise ValueError('Identity calibration controls require a KGFM adapter method') + report = _evaluate_checkpoint_method( + entry, output=output, device=device, split=split, limit=limit, seed=seed, threads=threads, + data=data, query_plan=query_plan, batch_ends=batch_ends, rank_trace_path=rank_trace_path, + provenance=provenance, query_order=query_order, + on_prediction=on_prediction, reference_batches=reference_batches, filter_corrections=filter_corrections) + return save_results(report, output, run=direct_run, metadata=direct_metadata, + rank_trace_path=rank_trace_path) if write_result else report + options = entry.get('options', {}) + if threads is not None: + if threads < 1: + raise ValueError('Thread count must be positive') + torch.set_num_threads(threads) + from ..models._inference import float32_precision_backends + for backend in float32_precision_backends(): + backend.fp32_precision = 'ieee' + started = time.monotonic() + data = data if data is not None else load_benchmark(entry['root'], entry['dataset'], split=split, + query_types=entry.get('query_types'), inference_graph=entry.get('inference_graph')) + identity = provenance if provenance is not None else dict( + manifest=entry, checkpoint_sha256=checksum(entry['checkpoint']), + adapters={name: checksum(path) for name, path in entry['adapters'].items()}, + device=str(device), torch=str(torch.__version__), threads=torch.get_num_threads(), seed=seed) + report: dict[str, Any] = _evaluate_kgfm( + dict(entry, options=options), data, query_plan, batch_ends, output, device, identity, on_prediction, reference_batches, + on_control_prediction, limit=limit, seed=seed, query_order=query_order, rank_trace_path=rank_trace_path, + filter_corrections=filter_corrections) + report['total_wall_seconds'] = time.monotonic() - started + report['manifest_sha256'] = fingerprint(entry) + if write_result: + save_results(report, output, run=direct_run, metadata=direct_metadata, rank_trace_path=rank_trace_path) + return report + + +def _evaluate_checkpoint_method(entry, *, output, device='cpu', split='test', limit=None, seed=0, threads=None, + data=None, query_plan=None, batch_ends=None, rank_trace_path=None, provenance=None, query_order='relation', + on_prediction=None, reference_batches=None, filter_corrections=None): + """One dataset/model at a time; both tie protocols share every prediction.""" + method, dataset, types = entry['method'], entry['dataset'], entry.get('query_types') + if method not in ('ultraquery', 'ultraquery-lp', 'incoming-relation') and entry.get('vocabulary_dataset') != dataset: + raise ValueError('Bind transductive checkpoint IDs explicitly with vocabulary_dataset equal to dataset') + if threads is not None: + if threads < 1: + raise ValueError('Thread count must be positive') + torch.set_num_threads(threads) + torch.set_float32_matmul_precision('highest') + load_started = time.monotonic() + data = data if data is not None else load_benchmark(entry['root'], dataset, split=split, query_types=types, + inference_graph=entry.get('inference_graph')) + options = dict(entry.get('options', {})) + if method == 'incoming-relation': + options.setdefault('seed', seed) + model = load_method(method, entry['checkpoint'], data.context, device=device, **options) + shape_by_query = {item.query: item.shape for item in data.queries} + overrides = entry.get('per_shape', {}) + if set(overrides) - set(shape_by_query.values()): + raise ValueError('Per-shape configuration names must occur in the selected benchmark') + permitted = {'beam_size', 'tnorm', 'max_k'} if method in ('cqd', 'cqd-hybrid') else set() + if any(set(value) - permitted for value in overrides.values()): + raise ValueError('Only CQD beam_size, tnorm and max_k permit per-shape overrides') + defaults = {key: getattr(model, key) for key in permitted} + for value in overrides.values(): + if ('tnorm' in value and value['tnorm'] not in ('prod', 'min') or + any(key in value and (type(value[key]) is not int or value[key] < 1) for key in ('beam_size', 'max_k'))): + raise ValueError('Invalid per-shape CQD configuration') + batch_size = entry.get('query_batch_size', 1) + prepared = {} + + def prepare(queries): + prepared.clear() + if isinstance(model, (CLMPT, ConE, FuzzyGNN)): + requested = set(queries) + queries = (reference_batches or {}).get(queries[0], queries) + groups = defaultdict(list) + for query in queries: + groups[shape_by_query[query]].append(query) + for group in groups.values(): + if isinstance(model, FuzzyGNN): + scores = model.predict_batch(group) + prepared.update({query: scores[i] for i, query in enumerate(group) if query in requested}) + else: + branches = model.encode_trees([compile_query(query) for query in group]) + prepared.update({query: [branch[i:i + 1] for branch in branches] + for i, query in enumerate(group) if query in requested}) + + def predict(query): + if query in prepared: + value = prepared.pop(query) + scores = value if isinstance(model, FuzzyGNN) else cast(CLMPT | ConE, model).score_embeddings(value)[0] + else: + for key, value in (defaults | overrides.get(shape_by_query[query], {})).items(): + setattr(model, key, value) + scores = model.predict(query) + if on_prediction: + on_prediction(query, scores) + return scores + + identity = dict(**model.provenance, manifest=entry, torch=torch.__version__, device=device, + cuda=torch.version.cuda, threads=torch.get_num_threads(), matmul_precision='highest', + batch_size=batch_size) + if provenance is not None: + identity['paper_protocol'] = provenance + load_seconds = time.monotonic() - load_started + destination = Path(output) + destination.mkdir(parents=True, exist_ok=True) + report = evaluate_benchmark(data, predict, tie_policy='sort', additional_tie_policies=('expected',), + max_queries_per_shape=limit, query_sampling='uniform', sampling_seed=seed, + query_order=query_order, query_batch_size=batch_size, prepare=prepare, + query_plan=query_plan, batch_ends=batch_ends, rank_trace_path=rank_trace_path, + checkpoint_dir=destination / 'progress', checkpoint_identity=identity, + filter_corrections=filter_corrections, + checkpoint_every=100, on_checkpoint=lambda report: write_json(destination / 'partial.json', report)) + report['inference'] = identity + for comparison in report.get('comparisons', {}).values(): + comparison['inference'] = identity + report['load_seconds'] = load_seconds + report['manifest_sha256'] = fingerprint(entry) + return report + + +@contextmanager +def deterministic_kgfm(): + previous = torch.are_deterministic_algorithms_enabled() + warn_only = torch.is_deterministic_algorithms_warn_only_enabled() + torch.use_deterministic_algorithms(True) + try: + yield + finally: + torch.use_deterministic_algorithms(previous, warn_only=warn_only) + + +def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_prediction=None, reference_batches=None, + on_control_prediction=None, *, limit=None, seed=0, query_order='relation', rank_trace_path=None, + filter_corrections=None): + from ..models import TRIX, ULTRA + backbone = entry['method'].split('-')[0] + options = entry['options'] + allowed = {'beam_size', 'row_batch_size', 'backend_batch_size', 'cache_bytes', 'raw_cache_bytes', 'observed_facts', + 'raw_cache_device', 'relation_cache_mb', 'projection_cache_mb'} + if options.keys() - allowed: + raise ValueError('Unknown KGFM execution option') + if options.get('raw_cache_device', 'cpu') not in ('cpu', 'model'): + raise ValueError('Atomic cache device must be cpu or model') + model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict( + num_entities=1, num_relations=1, graph_inference_backend='auto', + graph_relation_cache_mb=options.get('relation_cache_mb', 64), + graph_projection_cache_mb=options.get('projection_cache_mb', 64), + **{f'{backbone}_query_batch_size': options.get('backend_batch_size', 1)})).load_pretrained( + entry['checkpoint']).to(device).eval().requires_grad_(False) + adapters = {name: QueryScoreAdapter.load(path, model=model) for name, path in entry['adapters'].items()} + for operator, adapter in adapters.items(): + expected = 'prod' if operator == 'product' else 'min' + if adapter.metadata.get('training', {}).get('tnorm', 'prod') != expected: + raise ValueError('Operator must use an adapter fitted with the matching t-norm') + observed_facts = options.get('observed_facts') + if observed_facts is not None: + for adapter in adapters.values(): + adapter.observed_mix = float(observed_facts != 'none') + restore_observed = observed_facts in (None, 'both') + shape_by_query = {query.query: query.shape for query in data.queries} + stats = Counter() + paired = entry.get('adapter_ablation', False) + raw_cache = AtomicBatchCache(options.get('raw_cache_bytes', 2 * 1024**3), + device=options.get('raw_cache_device', 'cpu')) if paired else None + with ExitStack() as stack: + stack.enter_context(deterministic_kgfm()) + stack.enter_context(attached_context(model, data.context)) + stack.enter_context(evaluation_mode(model)) + recipes = {'learned': adapters} + if paired: + recipes['without-adapter'] = {name: QueryScoreAdapter('global', adapter.observed_mix, + normalization=adapter.normalization, metadata={'calibration': 'identity'}) for name, adapter in adapters.items()} + engines = {variant: {name: QueryAnswerer(model, context=data.context, adapter=adapter, + restore_observed=restore_observed, + row_batch_size=options.get('row_batch_size', 1), + raw_cache=raw_cache, + cache_bytes=options.get('cache_bytes', 512 * 1024**2) // (len(adapters) * len(recipes))) + for name, adapter in recipe.items()} for variant, recipe in recipes.items()} + all_engines = [engine for group in engines.values() for engine in group.values()] + + def record(info): + _accumulate_inference_statistics(stats, info, all_engines) + if raw_cache is not None: + stats['backbone_computed_rows'] = initial_raw['computed'] + raw_cache.computed + stats['backbone_reused_rows'] = initial_raw['reused'] + raw_cache.hits + stats['raw_cache_peak_bytes'] = max(stats.get('raw_cache_peak_bytes', 0), raw_cache.peak) + + initial_raw = {} + + def initialize_raw_counts(): + if not initial_raw: + initial_raw.update(computed=stats.get('backbone_computed_rows', 0), reused=stats.get('backbone_reused_rows', 0)) + + def prepare(queries): + initialize_raw_counts() + queries = (reference_batches or {}).get(queries[0], queries) + for group in engines.values(): + for operator, engine in group.items(): + selected = [query for query in queries if entry['operators'][shape_by_query[query]] == operator] + if selected: + record(engine.prefetch(selected)) + + def predict(query, variant='learned'): + operator = entry['operators'][shape_by_query[query]] + engine = engines[variant][operator] + result = engine.predict(query, beam_size=options.get('beam_size', 64), + tnorm='prod' if operator == 'product' else 'min', return_log_scores=True) + record(engine.last_info) + callback = on_prediction if variant == 'learned' else on_control_prediction + if callback: + callback(query, result) + return result + + report = evaluate_benchmark(data, predict, additional_tie_policies=('expected',), query_plan=plan, + prepare=prepare, statistics=stats, query_order=query_order, + query_batch_size=entry.get('query_batch_size', 1), max_queries_per_shape=limit, + query_sampling='uniform', sampling_seed=seed, + batch_ends=ends, checkpoint_dir=output / 'progress', checkpoint_identity=identity, + checkpoint_every=100, rank_trace_path=rank_trace_path, + filter_corrections=filter_corrections, + on_checkpoint=lambda report: write_json(output / 'partial.json', report), + comparison_predictors={'without-adapter': lambda query: predict(query, 'without-adapter')} if paired else None) + for variant, result in [('learned', report), *report.get('comparisons', {}).items()]: + calibration = result.get('filter_control_of', variant) or 'learned' + result['inference'] = dict(method=entry['method'], options=options, operators=entry['operators'], deterministic_algorithms=True, + calibration=calibration, selection_protocol=entry['selection_protocol'], cache_statistics=dict(stats), + observed_facts=dict(mode=observed_facts or 'checkpoint-default', + atomic_mix={name: adapter.observed_mix for name, adapter in adapters.items()}, + restore_answers=restore_observed), + runtime_scope='paired adapter evaluation' if paired else 'single configuration') + return report diff --git a/dicee/query_answering/methods/NOTICE.md b/dicee/query_answering/methods/NOTICE.md new file mode 100644 index 000000000..00aea2795 --- /dev/null +++ b/dicee/query_answering/methods/NOTICE.md @@ -0,0 +1,77 @@ +# Method sources + +Upstream revisions are pinned in [checkpoints.py](checkpoints.py). + + +## ConE + +MIT License + +Copyright (c) 2021 ConE (Cone Embeddings for Multi-Hop Reasoning over Knowledge Graphs) Authors (https://arxiv.org/abs/2110.13715) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + + +## GNN-QE + +MIT License + +Copyright (c) 2022 MilaGraph + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +## ULTRA / UltraQuery + +MIT License + +Copyright (c) 2023 MilaGraph + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/dicee/query_answering/methods/__init__.py b/dicee/query_answering/methods/__init__.py new file mode 100644 index 000000000..16ae0c124 --- /dev/null +++ b/dicee/query_answering/methods/__init__.py @@ -0,0 +1,12 @@ +"""Native inference methods with independent, published model semantics.""" + +from .checkpoints import REFERENCES, load_method +from .clmpt import CLMPT +from .cone import ConE +from .cqd import CQD +from .gnnqe import GNNQE +from .heuristic import IncomingRelationHeuristic +from .qto import QTO +from .ultraquery import UltraQuery + +__all__ = ['CLMPT', 'CQD', 'ConE', 'GNNQE', 'IncomingRelationHeuristic', 'QTO', 'UltraQuery', 'REFERENCES', 'load_method'] diff --git a/dicee/query_answering/methods/_bounded_attention.py b/dicee/query_answering/methods/_bounded_attention.py new file mode 100644 index 000000000..a67019755 --- /dev/null +++ b/dicee/query_answering/methods/_bounded_attention.py @@ -0,0 +1,36 @@ +"""Bound attention workspace without splitting coupled query sequences.""" + +from types import FunctionType + +import torch +from torch.nn import functional as F +from torch.overrides import TorchFunctionMode + + +def _attention_forward(mode): + function = F.multi_head_attention_forward + scope = function.__globals__ | { + 'scaled_dot_product_attention': lambda *args, **kwargs: mode.__torch_function__( + F.scaled_dot_product_attention, (), args, kwargs)} + return FunctionType(function.__code__, scope, function.__name__, function.__defaults__, function.__closure__) + + +class BoundedAttention(TorchFunctionMode): + def __init__(self, max_pairs=1024**2): + self.max_pairs = max_pairs + + def __torch_function__(self, func, types, args=(), kwargs=None): + kwargs = kwargs or {} + if func is F.multi_head_attention_forward: + # The outer functional call suspends this mode inside its Python body. + return _attention_forward(self)(*args, **kwargs) + if func is F.scaled_dot_product_attention: + query, key, value = args[:3] + if query.is_cuda and query.shape[-3] > 1 and query.shape[-2] * key.shape[-2] > self.max_pairs: + mask = args[3] if len(args) > 3 else kwargs.get('attn_mask') + dropout = args[4] if len(args) > 4 else kwargs.get('dropout_p', 0) + if mask is not None or dropout != 0 or kwargs.get('enable_gqa', False): + raise ValueError('Bounded inference attention requires no mask or dropout') + return torch.cat([func(query[..., i:i+1, :, :], key[..., i:i+1, :, :], value[..., i:i+1, :, :], *args[3:], **kwargs) + for i in range(query.shape[-3])], dim=-3) + return func(*args, **kwargs) diff --git a/dicee/query_answering/methods/_common.py b/dicee/query_answering/methods/_common.py new file mode 100644 index 000000000..7232864b4 --- /dev/null +++ b/dicee/query_answering/methods/_common.py @@ -0,0 +1,176 @@ +"""Shared inference contracts for native, checkpoint-compatible methods.""" + +from collections import OrderedDict +from functools import reduce +from typing import Any + +import torch +from torch import nn + +from ...models._inference import float32_precision_token +from .._query import compile_query, validate_tree +from ..context import evaluation_mode, state_token + + +class QueryMethod(nn.Module): + provenance: dict[str, Any] # Checkpoint identity, set by ``load_method``. + + def __init__(self, context): + super().__init__() + self.context = context + + @property + def device(self): + return next(self.parameters()).device + + @torch.no_grad() + def predict(self, query): + tree = compile_query(query) + validate_tree(tree, self.context.num_entities, self.context.num_relations) + with evaluation_mode(self): + scores = self.score_tree(tree) + if scores.shape != (self.context.num_entities,) or not torch.isfinite(scores).all(): + raise ValueError('QueryMethod returned invalid scores') + return scores.clone() + + +class TensorCache: + """Bounded inference cache, invalidated by parameter and device changes.""" + + def __init__(self, capacity): + if type(capacity) is not int or capacity < 0: + raise ValueError('Cache capacity must be a nonnegative byte count') + self.capacity, self.bytes, self.token = capacity, 0, None + self.values = OrderedDict() + self.optional = OrderedDict() + + def refresh(self, model): + token = state_token(model) + device_type = next(model.parameters()).device.type + if torch.is_autocast_enabled(device_type): + token = None + elif token is not None: + token = token, float32_precision_token() + if token is None or token != self.token: + self.values.clear() + self.optional.clear() + self.bytes, self.token = 0, token + + def get(self, key): + value = self.values.get(key) + if value is not None: + self.values.move_to_end(key) + if key in self.optional: + self.optional.move_to_end(key) + return value + + def put(self, key, value, *, optional=False): + """Optional entries use spare bytes and are evicted before primary entries.""" + size = value.numel() * value.element_size() + if self.token is None or size > self.capacity: + return + previous = self.values.get(key) + previous_size = 0 if previous is None else previous.numel() * previous.element_size() + if optional and self.bytes - previous_size + size > self.capacity: + return + previous = self.values.pop(key, None) + self.optional.pop(key, None) + if previous is not None: + self.bytes -= previous.numel() * previous.element_size() + while self.bytes + size > self.capacity: + if self.optional: + victim, _ = self.optional.popitem(last=False) + old = self.values.pop(victim) + else: + _, old = self.values.popitem(last=False) + self.bytes -= old.numel() * old.element_size() + self.values[key] = value.detach().clone() + self.bytes += size + if optional: + self.optional[key] = None + + +def fuzzy_combine(values, op, logic): + if logic == 'product': + fn = (lambda a, b: a * b) if op == 'and' else (lambda a, b: a + b - a * b) + elif logic == 'godel': + fn = torch.minimum if op == 'and' else torch.maximum + elif logic == 'lukasiewicz': + fn = (lambda a, b: (a + b - 1).clamp_min(0)) if op == 'and' else (lambda a, b: (a + b).clamp_max(1)) + else: + raise ValueError('Choose product, godel or lukasiewicz logic') + return reduce(fn, values) + + +class FuzzyGNN(QueryMethod): + def __init__(self, context, logic='product'): + super().__init__(context) + fuzzy_combine([torch.tensor(0.)], 'and', logic) + self.logic = logic + + def membership(self, tree): + return self.membership_batch([tree])[0] + + def score_tree(self, tree): + probability = self.membership(tree) + return ((probability + 1e-10) / (1 - probability + 1e-10)).log() + + def membership_batch(self, trees): + op = trees[0][0] + if any(tree[0] != op or len(tree) != len(trees[0]) for tree in trees): + raise ValueError('GNN batches must share a query structure') + if op == 'anchor': + heads = torch.tensor([tree[1] for tree in trees], device=self.device) + return torch.nn.functional.one_hot(heads, self.context.num_entities).float() + if op == 'project': + relation_ids = tuple(tree[1] for tree in trees) + relations = torch.tensor(relation_ids, device=self.device) + return self.project_batch(self.membership_batch([tree[2] for tree in trees]), relations, relation_ids=relation_ids) + if op == 'not': + return 1 - self.membership_batch([tree[1] for tree in trees]) + return fuzzy_combine([self.membership_batch(children) for children in zip(*(tree[1:] for tree in trees))], op, self.logic) + + @torch.no_grad() + def predict_batch(self, queries): + trees = [compile_query(query) for query in queries] + if not trees: + return next(self.parameters()).new_empty((0, self.context.num_entities)) + for tree in trees: + validate_tree(tree, self.context.num_entities, self.context.num_relations) + with evaluation_mode(self): + probability = self.membership_batch(trees) + scores = ((probability + 1e-10) / (1 - probability + 1e-10)).log() + if not torch.isfinite(scores).all(): + raise ValueError('GNN returned invalid scores') + return scores + + +def union_branches(tree): + """Distribute projection over DNF unions for embedding query models.""" + if tree[0] == 'or': + return [branch for child in tree[1:] for branch in union_branches(child)] + if tree[0] == 'project': + return [('project', tree[1], child) for child in union_branches(tree[2])] + if any(child[0] == 'or' for child in tree[1:] if isinstance(child, tuple)): + raise ValueError('Only benchmark DNF unions are supported') + return [tree] + + +def complex_rows(model, heads, relations): + """ComplEx with the released CQD/QTO two-matmul evaluation order.""" + heads = torch.as_tensor(heads, device=model.entity_embeddings.weight.device, dtype=torch.long) + relations = torch.as_tensor(relations, device=heads.device, dtype=torch.long) + hr, hi = model.entity_embeddings(heads).chunk(2, -1) + rr, ri = model.relation_embeddings(relations).chunk(2, -1) + tr, ti = model.entity_embeddings.weight.chunk(2, -1) + return (hr * rr - hi * ri) @ tr.T + (hi * rr + hr * ri) @ ti.T + + +def require_complex(model, context): + from ...models.complex import ComplEx + if not isinstance(model, ComplEx): + raise TypeError('The released method requires a ComplEx backbone') + if (model.num_entities, model.num_relations) != (context.num_entities, context.num_relations): + raise ValueError('Checkpoint and graph vocabularies must match') + if model.embedding_dim % 2: + raise ValueError('ComplEx needs equal real and imaginary dimensions') diff --git a/dicee/query_answering/methods/_ordered_aggregation.py b/dicee/query_answering/methods/_ordered_aggregation.py new file mode 100644 index 000000000..34b1f8af1 --- /dev/null +++ b/dicee/query_answering/methods/_ordered_aggregation.py @@ -0,0 +1,52 @@ +"""Reference-order sparse reductions for checkpoint reproduction.""" + +import torch + + +def cached_layout(cache, name, edges, types, nodes, *, relation_order=False): + # Inference tensors have no version counter, so their layout cannot be cached safely. + if edges.is_inference() or types.is_inference(): + return layout(edges, types, nodes, relation_order=relation_order) + token = edges.device, edges.data_ptr(), edges._version, types.data_ptr(), types._version + previous = cache.get(name) + if previous is None or previous[0] != token: + cache[name] = token, layout(edges, types, nodes, relation_order=relation_order) + return cache[name][1] + + +def layout(edges, types, nodes, *, relation_order=False): + key = edges[0] * (edges[1].max() + 1) + edges[1] if types.numel() else types + if relation_order and types.numel(): + key = key * (types.max() + 1) + types + order = key.argsort() + rows, sources = edges[:, order] + pointers = torch.cat((rows.new_zeros(1), rows.bincount(minlength=nodes).cumsum(0))) + return pointers, sources, types[order] + + +def aggregate(states, relations, edges, reduction='sum', *, num_warps=1): + """Reduce neighbours sequentially, matching the upstream CUDA RSPMM loop. + + ``pna`` returns (sum, sum of squares, max, min) from one pass over the edges; + squares equal separate reductions of ``states.square()`` and ``relations.square()``. + Warps only change scheduling: each feature is still accumulated by one lane. + """ + if states.is_cuda: + from ._ordered_aggregation_cuda import ordered_reduce + return ordered_reduce(states, relations, edges, reduction, num_warps=num_warps) + if reduction == 'pna': + return (aggregate(states, relations, edges), aggregate(states.square(), relations.square(), edges), + aggregate(states, relations, edges, 'max'), aggregate(states, relations, edges, 'min')) + from ._ordered_aggregation_cpu import ordered_reduce + result = ordered_reduce(states, relations, edges, reduction) + if result is not None: + return result + pointers, sources, types = edges + fill = 0 if reduction == 'sum' else -torch.finfo(states.dtype).max if reduction == 'max' else torch.finfo(states.dtype).max + output = torch.full_like(states, fill) + for row in range(len(states)): + for edge in range(int(pointers[row]), int(pointers[row + 1])): + value = states[sources[edge]] * relations[types[edge]] + output[row] = (output[row] + value if reduction == 'sum' else + torch.maximum(output[row], value) if reduction == 'max' else torch.minimum(output[row], value)) + return output diff --git a/dicee/query_answering/methods/_ordered_aggregation_cpu.py b/dicee/query_answering/methods/_ordered_aggregation_cpu.py new file mode 100644 index 000000000..a210c2ae5 --- /dev/null +++ b/dicee/query_answering/methods/_ordered_aggregation_cpu.py @@ -0,0 +1,116 @@ +"""Small optional native CPU inference loop (no PyTorch extension build). + +Compile lazily with the system C compiler, without fast math or contraction. The +loop is single threaded and releases the GIL. Missing compilers use the literal +PyTorch implementation; training and unsupported shapes/dtypes do so as well. +The private temporary library lives for this process only. +""" + +import ctypes +import os +import shutil +import subprocess +import tempfile +import threading +from functools import lru_cache + +import torch + +_SOURCE = r''' +#include +#include +#include +#define DEFINE(NAME, TYPE, LIMIT) \ +void NAME(const TYPE *s, const TYPE *r, TYPE *o, \ + const int64_t *p, const int64_t *src, const int64_t *rel, \ + int64_t n, int64_t b, int64_t d, \ + int64_t sn, int64_t sb, int64_t sd, \ + int64_t rn, int64_t rb, int64_t rd, int kind) { \ + for (int64_t row = 0; row < n; ++row) { \ + for (int64_t batch = 0; batch < b; ++batch) { \ + TYPE *out = o + (row * b + batch) * d; \ + for (int64_t f = 0; f < d; ++f) \ + out[f] = kind == 0 ? 0 : kind == 1 ? -LIMIT : LIMIT; \ + for (int64_t e = p[row]; e < p[row + 1]; ++e) { \ + const TYPE *state = s + src[e] * sn + batch * sb; \ + const TYPE *relation = r + rel[e] * rn + batch * rb; \ + for (int64_t f = 0; f < d; ++f) { \ + TYPE value = state[f * sd] * relation[f * rd]; \ + TYPE old = out[f]; \ + out[f] = kind == 0 ? old + value : \ + kind == 1 ? (isnan(old) || old >= value ? old : value) : \ + (isnan(old) || old <= value ? old : value); \ + } \ + } \ + } \ + } \ +} +DEFINE(reduce_float, float, FLT_MAX) +DEFINE(reduce_double, double, DBL_MAX) +''' +_BUILD_LOCK = threading.Lock() + + +@lru_cache(maxsize=1) +def _library(): + compiler = shutil.which('cc') + if compiler is None or os.name != 'posix': + return None + directory = tempfile.TemporaryDirectory(prefix='dicee-ordered-') + try: + source = os.path.join(directory.name, 'ordered.c') + binary = os.path.join(directory.name, 'ordered.so') + with open(source, 'w') as stream: + stream.write(_SOURCE) + subprocess.run([compiler, '-std=c11', '-O3', '-shared', '-fPIC', + '-fno-fast-math', '-ffp-contract=off', source, '-o', binary], + check=True, capture_output=True, timeout=30) + library = ctypes.CDLL(binary) + library._directory = directory + for name in ('reduce_float', 'reduce_double'): + function = getattr(library, name) + function.argtypes = [ctypes.c_void_p] * 6 + [ctypes.c_int64] * 9 + [ctypes.c_int] + function.restype = None + return library + except (OSError, subprocess.SubprocessError): + directory.cleanup() + return None + + +def ordered_reduce(states, relations, edges, reduction): + """Return a native result, or None when the literal implementation is needed.""" + if (states.device.type != 'cpu' or relations.device.type != 'cpu' + or states.dtype not in (torch.float32, torch.float64) + or relations.dtype != states.dtype or states.ndim != 3 or relations.ndim != 3 + or states.shape[1:] != relations.shape[1:] + or states.layout != torch.strided or relations.layout != torch.strided + or states.is_neg() or relations.is_neg() + or (torch.is_grad_enabled() and (states.requires_grad or relations.requires_grad)) + or reduction not in ('sum', 'max', 'min')): + return None + pointers, sources, types = edges + if any(t.device.type != 'cpu' or t.dtype != torch.int64 or t.ndim != 1 + or not t.is_contiguous() for t in edges): + return None + nodes, batch, dim = states.shape + # Native memory accesses require validated CSR bounds. Keep malformed inputs + # on the Python path so they retain PyTorch's indexing/error semantics. + if (len(pointers) != nodes + 1 or len(sources) != len(types) + or int(pointers[0]) != 0 or int(pointers[-1]) != len(sources) + or bool((pointers[1:] < pointers[:-1]).any()) + or (sources.numel() and (int(sources.min()) < 0 or int(sources.max()) >= nodes + or int(types.min()) < 0 or int(types.max()) >= len(relations)))): + return None + if not states.numel(): + return torch.empty(states.shape, dtype=states.dtype, device=states.device) + with _BUILD_LOCK: + library = _library() + if library is None: + return None + output = torch.empty(states.shape, dtype=states.dtype, device=states.device) + function = library.reduce_float if states.dtype == torch.float32 else library.reduce_double + function(states.data_ptr(), relations.data_ptr(), output.data_ptr(), + pointers.data_ptr(), sources.data_ptr(), types.data_ptr(), + nodes, batch, dim, *states.stride(), *relations.stride(), + ('sum', 'max', 'min').index(reduction)) + return output diff --git a/dicee/query_answering/methods/_ordered_aggregation_cuda.py b/dicee/query_answering/methods/_ordered_aggregation_cuda.py new file mode 100644 index 000000000..cebc47fae --- /dev/null +++ b/dicee/query_answering/methods/_ordered_aggregation_cuda.py @@ -0,0 +1,106 @@ +"""CSR inference kernel preserving upstream neighbour accumulation order.""" + +import torch +import triton +import triton.language as tl +from triton.language.extra.cuda import libdevice + +# Rows above this multiple of the mean degree launch first, so their long serial +# chains overlap the remaining rows instead of trailing the launch. +HUB_FACTOR = 8 +# Independent edge loads issued ahead of the strictly sequential accumulation. +UNROLL = 8 + + +@triton.jit +def _reduce(S, R, O, O2, O3, O4, PTR, SRC, REL, ORDER, HUBS, ROWS, + SN: tl.constexpr, SB: tl.constexpr, SD: tl.constexpr, + RN: tl.constexpr, RB: tl.constexpr, RD: tl.constexpr, + B: tl.constexpr, D: tl.constexpr, WIDTH: tl.constexpr, KIND: tl.constexpr, UNROLL: tl.constexpr): + # Hubs for every batch element first; the remaining rows stay batch-major + # so concurrently running programs share one batch element's states in L2. + program = tl.program_id(0) + if program < HUBS * B: + rank = program // B + batch = program % B + else: + rest = program - HUBS * B + batch = rest // tl.maximum(ROWS - HUBS, 1) + rank = HUBS + rest % tl.maximum(ROWS - HUBS, 1) + row = tl.load(ORDER + rank) + feature = tl.arange(0, WIDTH) + present = feature < D + start, end = tl.load(PTR + row), tl.load(PTR + row + 1) + value = tl.full((WIDTH,), 0. if KIND == 'sum' or KIND == 'pna' else + -3.4028234663852886e38 if KIND == 'max' else 3.4028234663852886e38, tl.float32) + squares = tl.full((WIDTH,), 0., tl.float32) + high = tl.full((WIDTH,), -3.4028234663852886e38, tl.float32) + low = tl.full((WIDTH,), 3.4028234663852886e38, tl.float32) + for block in range(start, end, UNROLL): + # Loads do not depend on the running value, so they overlap; updates + # remain one edge at a time in CSR order, as in the upstream loop. + for offset in tl.static_range(UNROLL): + edge = block + offset + valid = edge < end + source = tl.load(SRC + edge, valid, other=0) + relation = tl.load(REL + edge, valid, other=0) + state = tl.load(S + source * SN + batch * SB + feature * SD, present & valid, other=0) + rel = tl.load(R + relation * RN + batch * RB + feature * RD, present & valid, other=0) + # Explicit round-to-nearest operations also prevent packed-instruction + # contraction when a lane owns multiple features on newer GPUs. + message = libdevice.mul_rn(state, rel) + if KIND == 'sum': + value = tl.where(valid, libdevice.add_rn(value, message), value) + elif KIND == 'max': + value = tl.where(valid, tl.maximum(value, message), value) + elif KIND == 'min': + value = tl.where(valid, tl.minimum(value, message), value) + else: + # PNA reads each edge once; squares match separate h*h and r*r inputs. + square = libdevice.mul_rn(libdevice.mul_rn(state, state), libdevice.mul_rn(rel, rel)) + value = tl.where(valid, libdevice.add_rn(value, message), value) + squares = tl.where(valid, libdevice.add_rn(squares, square), squares) + high = tl.where(valid, tl.maximum(high, message), high) + low = tl.where(valid, tl.minimum(low, message), low) + offset = (row * B + batch) * D + feature + tl.store(O + offset, value, present) + if KIND == 'pna': + tl.store(O2 + offset, squares, present) + tl.store(O3 + offset, high, present) + tl.store(O4 + offset, low, present) + + +def _schedule(pointers): + """Rows by launch rank, hubs first, cached on the CSR pointer tensor.""" + version = None if pointers.is_inference() else pointers._version + cached = getattr(pointers, '_dicee_schedule', None) + if cached is not None and version is not None and cached[0] == version: + return cached[1:] + degree = pointers[1:] - pointers[:-1] + hubs = degree > HUB_FACTOR * degree.double().mean() + rows = torch.arange(len(degree), device=pointers.device) + order = torch.cat((rows[hubs][degree[hubs].argsort(descending=True, stable=True)], rows[~hubs])).contiguous() + result = order, int(hubs.sum()) + if version is not None: + pointers._dicee_schedule = (version, *result) + return result + + +def ordered_reduce(states, relations, edges, reduction, *, num_warps=1): + """Return one reduction, or (sum, sum of squares, max, min) for ``pna``.""" + if states.dtype != torch.float32 or relations.dtype != torch.float32: + raise ValueError('Reference sparse inference requires float32') + if num_warps not in (1, 2, 4, 8): + raise ValueError('Ordered aggregation warps must be 1, 2, 4 or 8') + nodes, batch, dim = states.shape + outputs = [torch.empty((nodes, batch, dim), device=states.device, dtype=states.dtype) + for _ in range(4 if reduction == 'pna' else 1)] + if nodes and batch: + order, hubs = _schedule(edges[0]) + targets = outputs + [outputs[0]] * (4 - len(outputs)) + with torch.cuda.device(states.device): + _reduce[(nodes * batch,)](states, relations, *targets, *edges, order, hubs, nodes, + *states.stride(), *relations.stride(), + batch, dim, triton.next_power_of_2(dim), reduction, UNROLL, + num_warps=num_warps, enable_fp_fusion=False) + return tuple(outputs) if reduction == 'pna' else outputs[0] diff --git a/dicee/query_answering/methods/checkpoints.py b/dicee/query_answering/methods/checkpoints.py new file mode 100644 index 000000000..7f6124349 --- /dev/null +++ b/dicee/query_answering/methods/checkpoints.py @@ -0,0 +1,216 @@ +"""Strict conversion of published inference checkpoints into native modules.""" + +import hashlib +import json +from pathlib import Path +from typing import Any + +import torch + +from ...models.complex import ComplEx +from ..catalog import REFERENCES +from ..context import QueryContext, state_fingerprint +from ._common import QueryMethod +from .clmpt import CLMPT +from .cone import ConE +from .cqd import CQD +from .gnnqe import GNNQE +from .heuristic import IncomingRelationHeuristic +from .qto import QTO +from .ultraquery import UltraQuery + + +class _GraphPayload: + """Data-only receiver for the graph buffers in released TorchDrug weights.""" + + +def read_state(path, *, graph_context=None, graph_metadata=None, inductive=False): + allowed = [(_GraphPayload, 'torchdrug.data.graph.Graph')] if graph_context is not None else [] + with torch.serialization.safe_globals(allowed): + value = torch.load(path, map_location='cpu', weights_only=True) + while isinstance(value, dict) and not all(isinstance(tensor, (torch.Tensor, _GraphPayload)) for tensor in value.values()): + keys = [key for key in ('model', 'model_state_dict', 'state_dict') if key in value] + if len(keys) != 1: + raise ValueError('Expected an unambiguous tensor state dictionary') + value = value[keys[0]] + if isinstance(value, dict): + value = dict(value) + if inductive and any(not isinstance(value.get(key), _GraphPayload) + for key in ('train_graph', 'valid_graph', 'test_graph')): + raise ValueError('Missing inductive checkpoint graph buffers') + for key, graph in list(value.items()): + if not isinstance(graph, _GraphPayload): + continue + if key not in (('train_graph', 'valid_graph', 'test_graph') if inductive else ('fact_graph', 'graph')): + raise ValueError(f'Unexpected TorchDrug graph buffer {key}') + _validate_graph_buffer(key, graph, graph_context, graph_metadata, inductive=inductive) + del value[key] + if inductive: + for key in ('valid_nodes', 'test_nodes'): + nodes = value.pop(key, None) + if (not isinstance(nodes, torch.Tensor) or nodes.dtype != torch.long or nodes.ndim != 1 + or (nodes < 0).any() or (nodes >= graph_context.num_entities).any() + or len(nodes.unique()) != len(nodes)): + raise ValueError(f'Invalid inductive checkpoint node buffer {key}') + if graph_metadata is not None: + graph_metadata[key] = dict(sha256=state_fingerprint({'nodes': nodes}), used_for_inference=False) + if not isinstance(value, dict) or not value or not all(isinstance(k, str) and isinstance(v, torch.Tensor) for k, v in value.items()): + raise ValueError('Expected a nonempty tensor state dictionary') + if all(key.startswith('module.') for key in value): + value = {key.removeprefix('module.'): tensor for key, tensor in value.items()} + if any(not torch.isfinite(tensor).all() for tensor in value.values()): + raise ValueError('Checkpoint contains nonfinite values') + return value + + +def _validate_graph_buffer(name, graph, context, metadata, *, inductive=False): + edges, weights = graph._edge_list, graph._edge_weight + if (not isinstance(edges, torch.Tensor) or not isinstance(weights, torch.Tensor) + or not 0 < int(graph.num_node) <= context.num_entities + or (not inductive and int(graph.num_node) != context.num_entities) + or int(graph.num_relation) != context.num_relations + or edges.ndim != 2 or edges.shape[1] != 3 or edges.dtype != torch.long + or weights.shape != (len(edges),) or not (weights == 1).all()): + raise ValueError('TorchDrug graph buffer does not match the public vocabulary / unit-edge protocol') + if (edges < 0).any() or (edges[:, :2] >= int(graph.num_node)).any() or (edges[:, 2] >= context.num_relations).any(): + raise ValueError('TorchDrug graph buffer contains out-of-vocabulary IDs') + if name in ('fact_graph', 'train_graph'): + observed = torch.tensor(context.triples, dtype=torch.long).reshape(-1, 3) + keys = ((observed[:, 0] * context.num_relations + observed[:, 1]) * context.num_entities + observed[:, 2]).sort().values + requested = (edges[:, 0] * context.num_relations + edges[:, 2]) * context.num_entities + edges[:, 1] + positions = torch.searchsorted(keys, requested) + if not len(keys) or (positions >= len(keys)).any() or not torch.equal(keys[positions], requested): + raise ValueError('Checkpoint training facts are absent from the supplied graph; verify entity/relation ID maps') + if metadata is not None: + metadata[name] = dict(edges=len(edges), sha256=state_fingerprint({'edges': edges}), + used_for_inference=False, training_facts_verified=name in ('fact_graph', 'train_graph')) + + +def _strip(state, prefixes, sentinel): + for prefix in prefixes: + if prefix + sentinel in state and all(key.startswith(prefix) for key in state): + return {key[len(prefix):]: tensor for key, tensor in state.items()} + raise ValueError(f'Unrecognized checkpoint layout: expected {sentinel}') + + +def _complex(state, context): + layouts = [('entity_embeddings.weight', 'relation_embeddings.weight'), + ('embeddings.0.weight', 'embeddings.1.weight'), + ('_entity_embedding.weight', '_relation_embedding.weight')] + for entity_key, relation_key in layouts: + if set(state) == {entity_key, relation_key}: + entities, relations = state[entity_key], state[relation_key] + if (entities.ndim != 2 or relations.ndim != 2 or entities.shape[1] != relations.shape[1] + or entities.shape[1] % 2 or entities.shape[0] != context.num_entities + or relations.shape[0] != context.num_relations): + raise ValueError('ComplEx checkpoint dimensions do not match the public vocabulary') + model = ComplEx(dict(model='ComplEx', num_entities=context.num_entities, num_relations=context.num_relations, + embedding_dim=entities.shape[1], normalization=None)).to(dtype=entities.dtype) + model.load_state_dict({'entity_embeddings.weight': entities, 'relation_embeddings.weight': relations}, strict=True) + return model + raise ValueError('Unsupported ComplEx checkpoint keys') + + +def load_method(method: str, path: str | Path, context: QueryContext, *, device: str | torch.device = 'cpu', + **config: Any) -> QueryMethod: + """Load a published method's released checkpoint into its native implementation. + + Every learned tensor loads strictly with ``weights_only=True``; entity and + relation IDs are never inferred or permuted. + + Args: + method: A name from ``REFERENCES``. + path: Released checkpoint, or the heuristic's specification file. + context: Inference graph whose IDs match the checkpoint. + device: Inference device. + **config: Method options, such as CQD's ``beam_size`` or QTO's ``threshold``. + + Returns: + The method in evaluation mode, with checkpoint provenance in ``provenance``. + + Raises: + ValueError: For unknown methods, or checkpoints that do not match. + """ + if method not in REFERENCES: + raise ValueError(f'Unknown method {method}') + path = Path(path) + graph_metadata = {} + if method == 'incoming-relation': + expected = dict(version=1, method=method, reference_commit=REFERENCES[method][1], + ranking='query-seeded random shuffle within Boolean classes') + if json.loads(path.read_text()) != expected: + raise ValueError('Invalid untrained heuristic specification') + model = IncomingRelationHeuristic(context, **config) + state = None + else: + state = read_state(path, graph_context=context if method in ('gnnqe', 'inductive-gnnqe') else None, + graph_metadata=graph_metadata, inductive=method == 'inductive-gnnqe') + if method == 'incoming-relation': + pass + elif method in ('cqd', 'cqd-hybrid', 'qto'): + backbone = _complex(state, context) + model = (QTO(backbone, context, **config) if method == 'qto' else + CQD(backbone, context, hybrid=method == 'cqd-hybrid', **config)) + elif method in ('ultraquery', 'ultraquery-lp'): + state = _strip(state, ('', 'model.model.', 'model.'), 'relation_model.layers.0.linear.weight') + dim = state['relation_model.layers.0.linear.weight'].shape[0] + layers = len({key.split('.')[2] for key in state if key.startswith('relation_model.layers.')}) + model = UltraQuery(context, dim=dim, num_layers=layers, **config) + model.load_state_dict(state, strict=True) + elif method == 'cone': + dim = state['entity_embedding'].shape[1] + projection_dim = state['cone_proj.layer1.weight'].shape[0] + projection_layers = len([key for key in state if key.startswith('cone_proj.layer') and key.endswith('.weight')]) - 1 + model = ConE(context, dim=dim, gamma=state['gamma'].item(), projection_dim=projection_dim, + projection_layers=projection_layers, **config) + model.load_state_dict(state, strict=True) + elif method == 'clmpt': + nbp = {key.removeprefix('nbp.'): tensor for key, tensor in state.items() if key.startswith('nbp.')} + backbone = _complex(nbp, context) + pre_norm = any(key.startswith('transformer.encoder.') for key in state) + prefix = 'transformer.encoder.layers.' if pre_norm else 'transformer.layers.' + hidden_key = prefix + ('0.ffn.layer1.weight' if pre_norm else '0.linear1.weight') + layers = len({key[len(prefix):].split('.')[0] for key in state if key.startswith(prefix)}) + model = CLMPT(backbone, context, pre_norm=pre_norm, layers=layers, hidden_dim=state[hidden_key].shape[0], **config) + translated = {key: tensor for key, tensor in state.items() if not key.startswith('nbp.')} + translated.update({'model.' + key: tensor for key, tensor in backbone.state_dict().items()}) + model.load_state_dict(translated, strict=True) + else: + state = _strip(state, ('', 'model.'), 'model.query.weight') + translated = {} + for key, tensor in state.items(): + if key.startswith('model.model.layers.'): + target = key.removeprefix('model.model.') + elif key.startswith(('model.query.', 'model.mlp.')): + target = key.removeprefix('model.') + else: + raise ValueError(f'Unexpected GNN-QE parameter {key}') + translated[target] = tensor + dim = translated['query.weight'].shape[1] + layers = len({key.split('.')[1] for key in translated if key.startswith('layers.')}) + mlp_layers = len({key.split('.')[2] for key in translated if key.startswith('mlp.layers.')}) + config.setdefault('concat_hidden', translated['mlp.layers.0.weight'].shape[1] != 2 * dim) + config.setdefault('layer_norm', 'layers.0.layer_norm.weight' in translated) + config.setdefault('dependent', 'layers.0.relation_linear.weight' in translated) + if translated['layers.0.linear.weight'].shape[1] == 13 * dim: + config.setdefault('aggregate', 'pna') + model = GNNQE(context, dim=dim, num_layers=layers, mlp_layers=mlp_layers, **config) + model.load_state_dict(translated, strict=True) + model.to(device).eval().requires_grad_(False) + repo, commit = REFERENCES[method] + with path.open('rb') as stream: + checksum = hashlib.file_digest(stream, 'sha256').hexdigest() + model.provenance = dict(method=method, reference=f'https://github.com/{repo}/tree/{commit}', + reference_commit=commit, checkpoint=str(path.resolve()), + checkpoint_sha256=checksum, + model_state_sha256=state_fingerprint(model), configuration=config, + public_ids='unchanged; checkpoint must use the dataset ID maps', + context_sha256=context.identity, checkpoint_graph_buffers=graph_metadata) + if isinstance(model, CLMPT): + model.provenance.update(post_norm_batch_coupling=not model.pre_norm, + dnf_up='separate grounded branches matching the released evaluation helper') + if isinstance(model, CQD) and model.atomic_negation: + model.provenance.update( + negation_reference='https://github.com/EdinburghNLP/adaptive-cqd/tree/642ce042708be6247087c09c780b9deb47e941d3', + negation_scope='CQD-A signed-atom negation with +H scoring') + return model diff --git a/dicee/query_answering/methods/clmpt.py b/dicee/query_answering/methods/clmpt.py new file mode 100644 index 000000000..e95c1bb1b --- /dev/null +++ b/dicee/query_answering/methods/clmpt.py @@ -0,0 +1,183 @@ +"""CLMPT inference with released transformer and ComplEx checkpoint layouts.""" + +from collections import defaultdict + +import torch +from torch import nn + +from .._query import compile_query, validate_tree +from ..context import evaluation_mode +from ._bounded_attention import BoundedAttention +from ._common import QueryMethod, require_complex, union_branches + + +class Attention(nn.Module): + def __init__(self, dim, heads=8): + super().__init__() + self.heads = heads + self.size = dim // heads + for name in ('linear_q', 'linear_k', 'linear_v', 'output_layer'): + setattr(self, name, nn.Linear(dim, dim, bias=False)) + + def forward(self, value): + batch, length, dim = value.shape + q, k, v = [getattr(self, name)(value).view(batch, length, self.heads, self.size).transpose(1, 2) + for name in ('linear_q', 'linear_k', 'linear_v')] + weights = ((q * self.size ** -.5) @ k.transpose(2, 3)).softmax(-1) + result = (weights @ v).transpose(1, 2).contiguous().view(batch, length, dim) + return self.output_layer(result) + + +class FeedForward(nn.Module): + def __init__(self, dim, hidden): + super().__init__() + self.layer1, self.layer2 = nn.Linear(dim, hidden), nn.Linear(hidden, dim) + + def forward(self, value): + return self.layer2(self.layer1(value).relu()) + + +class EncoderLayer(nn.Module): + def __init__(self, dim, hidden): + super().__init__() + self.self_attention_norm, self.ffn_norm = nn.LayerNorm(dim, eps=1e-6), nn.LayerNorm(dim, eps=1e-6) + self.self_attention, self.ffn = Attention(dim), FeedForward(dim, hidden) + + def forward(self, value): + value = value + self.self_attention(self.self_attention_norm(value)) + return value + self.ffn(self.ffn_norm(value)) + + +class Transformer(nn.Module): + def __init__(self, dim, hidden, layers): + super().__init__() + self.scale = dim ** .5 + self.encoder = nn.Module() + self.encoder.layers = nn.ModuleList([EncoderLayer(dim, hidden) for _ in range(layers)]) + self.encoder.last_norm = nn.LayerNorm(dim, eps=1e-6) + + def forward(self, value): + value = value * self.scale + for layer in self.encoder.layers: + value = layer(value) + return self.encoder.last_norm(value) + + +def query_graph(tree): + """Compile a DNF branch into ordered signed relation atoms.""" + atoms, anchors, variables = [], {}, ['f'] + + def visit(node, target): + op = node[0] + if op == 'and': + for child in node[1:]: + visit(child, target) + return + sign = 1 + if op == 'not': + node, sign = node[1], -1 + if node[0] != 'project': + raise ValueError('CLMPT requires signed relation atoms') + child = node[2] + if child[0] == 'anchor': + source = f's{len(anchors) + 1}' + anchors[source] = child[1] + else: + source = f'e{len(variables)}' + variables.append(source) + visit(child, source) + atoms.append((source, node[1], target, sign)) + + visit(tree, 'f') + return atoms, anchors, variables + + +class CLMPT(QueryMethod): + def __init__(self, model, context, *, hidden_dim=8192, layers=2, pre_norm=True, aggregation='mean', + depth_shift=0, candidate_batch_size=4096): + super().__init__(context) + require_complex(model, context) + dim = model.embedding_dim + if dim % 8 or min(hidden_dim, layers, candidate_batch_size) < 1: + raise ValueError('CLMPT needs dimensions divisible by eight and positive batch/layer sizes') + if aggregation not in ('mean', 'sum', 'max'): + raise ValueError('Unknown CLMPT aggregation') + self.model, self.pre_norm, self.aggregation = model, pre_norm, aggregation + self.depth_shift, self.candidate_batch_size = depth_shift, candidate_batch_size + if pre_norm: + self.transformer = Transformer(dim, hidden_dim, layers) + else: + layer = nn.TransformerEncoderLayer(dim, 8, hidden_dim, .1, 'relu') + self.transformer = nn.TransformerEncoder(layer, layers, nn.LayerNorm(dim), enable_nested_tensor=False) + for name in ('existential_embedding', 'universal_embedding', 'free_embedding'): + self.register_parameter(name, nn.Parameter(torch.rand(1, dim))) + + @staticmethod + def message(entity, relation, inverse=False): + real, imag = entity.chunk(2, -1) + rr, ri = relation.chunk(2, -1) + if inverse: + ri = -ri + return torch.cat((real * rr - imag * ri, real * ri + imag * rr), -1) + + def embed_batch(self, trees): + graphs = [query_graph(tree) for tree in trees] + atoms, anchors, variables = graphs[0] + def signature(graph): + return [(a, c, d) for a, _, c, d in graph[0]], list(graph[1]), graph[2] + if any(signature(graph) != signature(graphs[0]) for graph in graphs[1:]): + raise ValueError('CLMPT batches must share a query structure') + terms = {name: self.model.entity_embeddings(torch.tensor([graph[1][name] for graph in graphs], device=self.device)) + for name in anchors} + terms.update({name: self.free_embedding if name == 'f' else self.existential_embedding for name in variables}) + relations = [self.model.relation_embeddings(torch.tensor([graph[0][index][1] for graph in graphs], device=self.device)) + for index in range(len(atoms))] + for _ in range(max(1, len(variables) + self.depth_shift)): + messages = defaultdict(list) + for index, (source, _, target, sign) in enumerate(atoms): + embedding = relations[index] + messages[target].append(sign * self.message(terms[source], embedding)) + if source in variables: + messages[source].append(sign * self.message(terms[target], embedding, inverse=True)) + updated = dict(terms) + for name in variables: + # Keep the release's tensor layout, including post-norm batch coupling. + with BoundedAttention(): + value = self.transformer(torch.stack([*messages[name], terms[name].expand(len(trees), -1)], 1)) + updated[name] = (value.max(1).values if self.aggregation == 'max' else + value.sum(1) if self.aggregation == 'sum' else value.mean(1)) + terms = updated + return terms['f'] + + def embed(self, tree): + return self.embed_batch([tree]) + + def encode_trees(self, trees): + expanded = [union_branches(tree) for tree in trees] + if len({len(branches) for branches in expanded}) != 1: + raise ValueError('CLMPT batches must share a query structure') + return [self.embed_batch(trees) for trees in zip(*expanded)] + + def score_embeddings(self, branches): + return torch.cat([torch.stack([torch.cosine_similarity(branch[:, None], entities, dim=-1) + for branch in branches]).max(0).values + for entities in self.model.entity_embeddings.weight.split(self.candidate_batch_size)], dim=-1) + + def score_trees(self, trees): + return self.score_embeddings(self.encode_trees(trees)) + + @torch.no_grad() + def predict_batch(self, queries): + trees = [compile_query(query) for query in queries] + if not trees: + return self.model.entity_embeddings.weight.new_empty((0, self.context.num_entities)) + for tree in trees: + validate_tree(tree, self.context.num_entities, self.context.num_relations) + with evaluation_mode(self): + result = self.score_trees(trees) + if not torch.isfinite(result).all(): + raise ValueError('CLMPT returned invalid scores') + return result + + def score_tree(self, tree): + return self.score_trees([tree])[0] diff --git a/dicee/query_answering/methods/cone.py b/dicee/query_answering/methods/cone.py new file mode 100644 index 000000000..c21fd1d26 --- /dev/null +++ b/dicee/query_answering/methods/cone.py @@ -0,0 +1,130 @@ +"""ConE inference. Architecture: MIRALab-USTC/QE-ConE (see NOTICE.md).""" + +import math + +import torch +from torch import nn + +from ._common import QueryMethod, TensorCache, union_branches + + +class ConeProjection(nn.Module): + def __init__(self, dim, hidden_dim=1600, num_layers=2): + super().__init__() + self.num_layers = num_layers + self.layer0 = nn.Linear(hidden_dim, 2 * dim) + self.layer1 = nn.Linear(2 * dim, hidden_dim) + for index in range(2, num_layers + 1): + setattr(self, f'layer{index}', nn.Linear(hidden_dim, hidden_dim)) + + def forward(self, axis, aperture, relation_axis, relation_aperture): + value = torch.cat((axis + relation_axis, aperture + relation_aperture), -1) + for index in range(1, self.num_layers + 1): + value = getattr(self, f'layer{index}')(value).relu() + axis, aperture = self.layer0(value).chunk(2, -1) + return axis.tanh() * math.pi, (2 * aperture).tanh() * math.pi / 2 + math.pi / 2 + + +class ConeIntersection(nn.Module): + def __init__(self, dim): + super().__init__() + self.layer_axis1, self.layer_axis2 = nn.Linear(2 * dim, dim), nn.Linear(dim, dim) + self.layer_arg1, self.layer_arg2 = nn.Linear(2 * dim, dim), nn.Linear(dim, dim) + + def forward(self, axes, apertures): + endpoints = torch.cat((axes - apertures, axes + apertures), -1) + attention = self.layer_axis2(self.layer_axis1(endpoints).relu()).softmax(0) + x, y = (attention * axes.cos()).sum(0), (attention * axes.sin()).sum(0) + x = x.masked_fill(x.abs() < 1e-3, 1e-3) + axis = (y / x).atan() + axis = torch.where((x < 0) & (y >= 0), axis + math.pi, axis) + axis = torch.where((x < 0) & (y < 0), axis - math.pi, axis) + gate = self.layer_arg2(self.layer_arg1(endpoints).relu().mean(0)).sigmoid() + return axis, apertures.min(0).values * gate + + +class ConE(QueryMethod): + def __init__(self, context, *, dim, gamma, center_reg, projection_dim=1600, projection_layers=2, candidate_batch_size=4096, cache_bytes=16 * 2**20): + super().__init__(context) + if dim < 1 or candidate_batch_size < 1 or center_reg < 0: + raise ValueError('Invalid ConE dimensions or center regularization') + self.angle_cache = TensorCache(cache_bytes) + self._range_token = None + self.cen, self.candidate_batch_size = center_reg, candidate_batch_size + self.gamma = nn.Parameter(torch.tensor([float(gamma)]), requires_grad=False) + self.embedding_range = nn.Parameter(torch.tensor([(gamma + 2) / dim]), requires_grad=False) + self.modulus = nn.Parameter(self.embedding_range.detach().clone() / 2) + self.entity_embedding = nn.Parameter(torch.empty(context.num_entities, dim)) + self.axis_embedding = nn.Parameter(torch.empty(context.num_relations, dim)) + self.arg_embedding = nn.Parameter(torch.empty(context.num_relations, dim)) + self.cone_proj = ConeProjection(dim, projection_dim, projection_layers) + self.cone_intersection = ConeIntersection(dim) + for parameter in (self.entity_embedding, self.axis_embedding, self.arg_embedding): + nn.init.uniform_(parameter, -self.embedding_range.item(), self.embedding_range.item()) + + def angle(self, value): + parameter = self.embedding_range + token = None if parameter.is_inference() else (id(parameter), parameter._version, parameter.device, parameter.dtype) + if token is None or token != self._range_token: + self._range_value = parameter.item() + self._range_token = token + return (value / self._range_value).tanh() * math.pi + + def embed(self, tree): + axis, aperture = self.embed_batch([tree]) + return axis[0], aperture[0] + + def embed_batch(self, trees): + op = trees[0][0] + if any(tree[0] != op or len(tree) != len(trees[0]) for tree in trees): + raise ValueError('ConE batches must share a query structure') + if op == 'anchor': + axis = self.angle(self.entity_embedding[[tree[1] for tree in trees]]) + return axis, torch.zeros_like(axis) + if op == 'project': + relations = [tree[1] for tree in trees] + return self.cone_proj(*self.embed_batch([tree[2] for tree in trees]), self.angle(self.axis_embedding[relations]), + self.angle(self.arg_embedding[relations])) + if op == 'not': + axis, aperture = self.embed_batch([tree[1] for tree in trees]) + return torch.where(axis >= 0, axis - math.pi, axis + math.pi), math.pi - aperture + if op == 'and': + axes, apertures = zip(*(self.embed_batch([tree[index] for tree in trees]) for index in range(1, len(trees[0])))) + return self.cone_intersection(torch.stack(axes), torch.stack(apertures)) + raise ValueError('ConE unions must be executed as DNF branches') + + def encode_trees(self, trees): + branches = [union_branches(tree) for tree in trees] + if len({len(group) for group in branches}) != 1: + raise ValueError('ConE batches must share a query structure') + axes, apertures = self.embed_batch([branch for group in branches for branch in group]) + return [values.reshape(len(trees), len(branches[0]), -1) for values in (axes, apertures)] + + def score_embeddings(self, embeddings): + return torch.stack([self._score_branches(list(zip(axes, apertures))) for axes, apertures in zip(*embeddings)]) + + def _score_branches(self, branches): + chunks = [] + geometry = [(axis, (aperture / 2).sin().abs(), axis - aperture, axis + aperture) + for axis, aperture in branches] + self.angle_cache.refresh(self) + for index, raw in enumerate(self.entity_embedding.split(self.candidate_batch_size)): + key = (self.candidate_batch_size, index) + entities = self.angle_cache.get(key) if not torch.is_grad_enabled() else None + if entities is None: + entities = self.angle(raw) + if not torch.is_grad_enabled(): + self.angle_cache.put(key, entities, optional=True) + scores = [] + for axis, radius, lower, upper in geometry: + center = ((entities - axis) / 2).sin().abs() + outside = torch.minimum(((entities - lower) / 2).sin().abs(), + ((entities - upper) / 2).sin().abs()) + outside = outside.masked_fill(center < radius, 0) + distance = outside.norm(p=1, dim=-1) + self.cen * torch.minimum(center, radius).norm(p=1, dim=-1) + scores.append(self.gamma - distance * self.modulus) + chunks.append(torch.stack(scores).max(0).values) + return torch.cat(chunks) + + def score_tree(self, tree): + return self.score_embeddings(self.encode_trees([tree]))[0] diff --git a/dicee/query_answering/methods/cqd.py b/dicee/query_answering/methods/cqd.py new file mode 100644 index 000000000..878d1dd4e --- /dev/null +++ b/dicee/query_answering/methods/cqd.py @@ -0,0 +1,191 @@ +"""Released +H CQD semantics with bounded intermediate score matrices.""" + +import torch + +from ._common import QueryMethod, TensorCache, complex_rows, require_complex + + +class CQD(QueryMethod): + def __init__(self, model, context, *, beam_size=64, tnorm='prod', hybrid=False, max_norm=None, + max_k=512, normalize=True, sigmoid=False, reference_quirks=True, row_batch_size=100, cache_bytes=64 * 2**20, + reference_batching=False, atomic_negation=False, final_batch_size=None): + super().__init__(context) + require_complex(model, context) + if min(beam_size, row_batch_size) < 1 or (max_k is not None and max_k < 1): + raise ValueError('Beam and batch sizes must be positive') + if tnorm not in ('prod', 'min'): + raise ValueError('Choose prod or min') + self.model, self.beam_size, self.tnorm = model, beam_size, tnorm + self.max_norm = (.9 if hybrid else 1.) if max_norm is None else max_norm + if not 0 < self.max_norm <= 1 or hybrid != (self.max_norm != 1): + raise ValueError('Hybrid requires max_norm < 1; plain CQD requires max_norm = 1') + self.hybrid, self.max_k = hybrid, max_k + self.normalize, self.sigmoid = normalize, sigmoid + self.reference_quirks, self.row_batch_size = reference_quirks, row_batch_size + self.reference_batching = reference_batching + self.atomic_negation = atomic_negation + if final_batch_size is not None and (type(final_batch_size) is not int or final_batch_size < 1): + raise ValueError('Final projection batch size must be positive') + self.final_batch_size = final_batch_size + self.cache = TensorCache(cache_bytes) + self._tails = ({h: {r: tuple(sorted(ts)) for r, ts in rels.items()} for h, rels in context.outgoing.items()} + if hybrid else {}) + + def conjunction(self, left, right): + return left * right if self.tnorm == 'prod' else torch.minimum(left, right) + + def _raw(self, heads, relation): + self.cache.refresh(self.model) + key = relation, tuple(heads.tolist()) + scores = self.cache.get(key) + if scores is None: + if heads.is_cuda: + # Keep reference matrix geometry; fail before a predictable OOM. + element = self.model.entity_embeddings.weight.element_size() + dim = self.model.entity_embeddings.weight.shape[1] + scratch = len(heads) * (3 * self.context.num_entities + 6 * dim) * element + free, _ = torch.cuda.mem_get_info(heads.device) + reusable = torch.cuda.memory_reserved(heads.device) - torch.cuda.memory_allocated(heads.device) + if scratch + 256 * 2**20 > free + reusable: + raise MemoryError( + f'CQD reference stage with {len(heads)} heads needs approximately ' + f'{scratch / 2**30:.2f} GiB scratch plus 0.25 GiB reserve; ' + f'{(free + reusable) / 2**30:.2f} GiB is available. ' + 'Use more VRAM or explicitly re-verify a bounded batching configuration.') + scores = complex_rows(self.model, heads, torch.full_like(heads, relation)) + self.cache.put(key, scores) + return scores.sigmoid() * self.max_norm if self.sigmoid else scores + + def _rows(self, heads, relation, observed_relation=None, batch_size=None): + # The release normalizes the entire stage, rather than each atomic row. + low, high = None, None + batch_size = batch_size or (len(heads) if self.reference_batching else self.row_batch_size) + single = len(heads) <= batch_size + raw = None + if self.normalize: + for chunk in heads.split(batch_size): + raw = self._raw(chunk, relation) + lo, hi = raw.min(), raw.max() + low = lo if low is None else torch.minimum(low, lo) + high = hi if high is None else torch.maximum(high, hi) + if not single: + raw = None + if high == low: + raise ValueError('Released CQD min-max normalization is undefined for constant scores') + for start in range(0, len(heads), batch_size): + chunk = heads[start:start + batch_size] + scores = raw if raw is not None else self._raw(chunk, relation) + raw = None + if self.normalize: + scores = self.max_norm * (scores - low) / (high - low) + if self.hybrid: + if not self.normalize: + scores = scores.clone() + rel = relation if observed_relation is None else observed_relation + self._restore_facts(scores, chunk, rel) + yield start, scores + + def _restore_facts(self, scores, heads, relation): + rows, tails = [], [] + for row, head in enumerate(heads.tolist()): + facts = self._tails.get(head, {}).get(relation, ()) + for start in range(0, len(facts), 65536): + part = facts[start:start + 65536] + if len(rows) + len(part) > 65536: + scores[rows, tails] = 1 + rows, tails = [], [] + rows.extend([row] * len(part)) + tails.extend(part) + if rows: + scores[rows, tails] = 1 + + def _width(self, observed): + width = min(self.beam_size + (observed if self.hybrid else 0), self.context.num_entities) + return min(width, self.max_k) if self.hybrid and self.max_k is not None else width + + def _select_atomic(self, heads, relation): + widths = ([self._width(len(self._tails.get(h, {}).get(relation, ()))) for h in heads.tolist()] + if self.hybrid else [self._width(0)] * len(heads)) + width = max(widths) + values, indices = [], [] + for start, rows in self._rows(heads, relation): + if self.reference_batching and not self.hybrid: + return rows.topk(width, dim=1) + for offset, row in enumerate(rows): + count = widths[start + offset] + score, index = row.unsqueeze(0).topk(count, dim=1) + score, index = score[0], index[0] + # The upstream hybrid pads shorter branches with entity 0 / score 0. + values.append(torch.nn.functional.pad(score, (0, width - count))) + indices.append(torch.nn.functional.pad(index, (0, width - count))) + return torch.stack(values), torch.stack(indices) + + def _last_projection(self, heads, relation, prefix, observed_relation=None, negate=False, batch_size=None): + result = None + for start, rows in self._rows(heads, relation, observed_relation, batch_size): + if negate: + rows = 1 - rows + scores = self.conjunction(prefix[start:start + len(rows), None], rows).max(0).values + result = scores if result is None else torch.maximum(result, scores) + return result + + def _path(self, head, relations, negate_last=False): + heads = torch.tensor([head], device=self.device) + if len(relations) == 1: + scores = next(self._rows(heads, relations[0]))[1][0] + return 1 - scores if negate_last else scores + scores = [] + for relation in relations[:-1]: + values, tails = self._select_atomic(heads, relation) + scores.append(values) + heads = tails.flatten() + last_relation = relations[-1] + if self.reference_quirks and len(relations) == 4: + prefix, last_relation = scores[-1].flatten(), relations[-2] + else: + prefix = scores[0].flatten() + for index, values in enumerate(scores[1:], 1): + expanded = (prefix.repeat(values.shape[1]) if self.reference_quirks and len(relations) == 3 and index == 1 + else prefix.repeat_interleave(values.shape[1])) + prefix = self.conjunction(expanded, values.flatten()) + del expanded + del scores + return self._last_projection(heads, last_relation, prefix, relations[-1], negate=negate_last, + batch_size=self.final_batch_size if len(relations) == 4 else None) + + def score_tree(self, tree): + op = tree[0] + if op == 'not': + if not self.atomic_negation: + raise ValueError('CQD negated queries require atomic_negation=true') + child, relations = tree[1], [] + while child[0] == 'project': + relations.append(child[1]) + child = child[2] + if child[0] != 'anchor' or not relations or len(relations) > 2: + raise ValueError('Atomic negation supports anchored one- and two-edge paths') + return self._path(child[1], list(reversed(relations)), negate_last=True) + if op in ('and', 'or'): + values = [self.score_tree(child) for child in tree[1:]] + result = values[0] + for value in values[1:]: + result = (self.conjunction(result, value) if op == 'and' else + 1 - (1 - result) * (1 - value) if self.tnorm == 'prod' else torch.maximum(result, value)) + return result + if op != 'project': + raise ValueError('CQD needs anchored relation projections') + relations, child = [], tree + while child[0] == 'project': + relations.append(child[1]) + child = child[2] + relations.reverse() + if child[0] == 'anchor': + return self._path(child[1], relations) + if len(relations) != 1: + raise ValueError('Only published CQD structures are supported') + values = self.score_tree(child) + count = self._width(int((values == 1).sum()) if self.hybrid else 0) + if self.max_k is not None: + count = min(count, self.max_k) + prefix, heads = values.topk(count) + return self._last_projection(heads, relations[0], prefix) diff --git a/dicee/query_answering/methods/gnnqe.py b/dicee/query_answering/methods/gnnqe.py new file mode 100644 index 000000000..d5b94ca6b --- /dev/null +++ b/dicee/query_answering/methods/gnnqe.py @@ -0,0 +1,119 @@ +"""GNN-QE's NBFNet inference without TorchDrug runtime dependencies.""" + +import torch +from torch import nn + +from ._common import FuzzyGNN +from ._ordered_aggregation import aggregate, cached_layout + + +def degree_statistics(degree, pna): + """Prepare graph-only values on their original device without reassociation.""" + count = degree[:, None, None] + 1 + scales = None + if pna: + scale = count.log() + scale = scale / scale.mean() + scales = torch.cat((torch.ones_like(scale), scale, 1 / scale.clamp_min(1e-2)), -1) + return count, scales + + +class GNNQELayer(nn.Module): + def __init__(self, dim, num_relations, *, aggregate='pna', layer_norm=True, dependent=True): + super().__init__() + if aggregate not in ('pna', 'sum', 'mean', 'max'): + raise ValueError('Unsupported GNN-QE aggregation') + self.dim, self.num_relations, self.aggregate = dim, num_relations, aggregate + self.linear = nn.Linear(dim * (13 if aggregate == 'pna' else 2), dim) + self.layer_norm = nn.LayerNorm(dim) if layer_norm else None + if dependent: + self.relation_linear = nn.Linear(dim, num_relations * dim) + else: + self.relation = nn.Embedding(num_relations, dim) + + def forward(self, hidden, boundary, query, edges, degree, statistics=None): + relations = (self.relation_linear(query).reshape(len(query), self.num_relations, self.dim).transpose(0, 1) + if hasattr(self, 'relation_linear') else self.relation.weight[:, None].expand(-1, len(query), -1)) + if self.aggregate == 'pna': + total, squares, high, low = aggregate(hidden, relations, edges, 'pna') + else: + total = aggregate(hidden, relations, edges) if self.aggregate != 'max' else None + high = aggregate(hidden, relations, edges, 'max') if self.aggregate == 'max' else None + + if self.aggregate in ('mean', 'pna'): + count, scales = statistics if statistics is not None else degree_statistics(degree, self.aggregate == 'pna') + if self.aggregate == 'sum': + update = total + boundary + elif self.aggregate == 'mean': + update = (total + boundary) / count + elif self.aggregate == 'max': + update = torch.maximum(high, boundary) + else: + mean = (total + boundary) / count + variance = (squares + boundary.square()) / count - mean.square() + features = torch.stack((mean, torch.maximum(high, boundary), torch.minimum(low, boundary), + variance.clamp_min(1e-6).sqrt()), -1).flatten(-2) + update = (features[..., None] * scales[:, :, None]).flatten(-2) + value = self.linear(torch.cat((hidden, update), -1)) + if self.layer_norm is not None: + value = self.layer_norm(value) + return value.relu() + + +class GNNQEMLP(nn.Module): + def __init__(self, dim, num_layers): + super().__init__() + self.layers = nn.ModuleList([nn.Linear(dim, dim if index + 1 < num_layers else 1) for index in range(num_layers)]) + + def forward(self, value): + for index, layer in enumerate(self.layers): + value = layer(value) + if index + 1 < len(self.layers): + value = value.relu() + return value + + +class GNNQE(FuzzyGNN): + """Full-graph inference with ordered sparse reductions. + + edge_batch_size and candidate_batch_size describe manifest metadata; + they do not chunk execution or bound memory. Query batch size controls the + dense state size. + """ + def __init__(self, context, *, dim=32, num_layers=4, aggregate='pna', short_cut=True, + layer_norm=True, dependent=True, concat_hidden=False, mlp_layers=2, logic='product', + edge_batch_size=65536, candidate_batch_size=4096): + super().__init__(context, logic) + if min(dim, num_layers, mlp_layers, edge_batch_size, candidate_batch_size) < 1: + raise ValueError('GNN-QE dimensions and batch sizes must be positive') + self.short_cut, self.concat_hidden = short_cut, concat_hidden + self.edge_batch_size, self.candidate_batch_size = edge_batch_size, candidate_batch_size + self.query = nn.Embedding(context.num_relations, dim) + self.layers = nn.ModuleList([GNNQELayer(dim, context.num_relations, aggregate=aggregate, + layer_norm=layer_norm, dependent=dependent) for _ in range(num_layers)]) + self.mlp = GNNQEMLP(dim * (num_layers + 1 if concat_hidden else 2), mlp_layers) + triples = torch.tensor(context.triples, dtype=torch.long).reshape(-1, 3) + self.register_buffer('edge_index', triples[:, [2, 0]].T, persistent=False) + self.register_buffer('edge_type', triples[:, 1], persistent=False) + self.register_buffer('degree', torch.bincount(triples[:, 2], minlength=context.num_entities).float(), persistent=False) + self._layouts = {} + + def project(self, membership, relation): + return self.project_batch(membership[None], torch.tensor([relation], device=self.device))[0] + + def project_batch(self, membership, relation, *, relation_ids=None): + edges = cached_layout(self._layouts, 'entity', self.edge_index, self.edge_type, + self.context.num_entities, relation_order=True) + query = self.query(relation) + boundary = torch.einsum('bn,bd->nbd', membership, query) + hidden, hiddens = boundary, [] + statistics = (degree_statistics(self.degree, any(layer.aggregate == 'pna' for layer in self.layers)) + if any(layer.aggregate in ('mean', 'pna') for layer in self.layers) else None) + for layer in self.layers: + update = layer(hidden, boundary, query, edges, self.degree, statistics) + hidden = update + hidden if self.short_cut else update + if self.concat_hidden: + hiddens.append(hidden) + values = hiddens if self.concat_hidden else [hidden] + features = torch.cat([*values, query.expand(self.context.num_entities, -1, -1)], -1) + return self.mlp(features).squeeze(-1).sigmoid().t() diff --git a/dicee/query_answering/methods/heuristic.py b/dicee/query_answering/methods/heuristic.py new file mode 100644 index 000000000..e9119d9be --- /dev/null +++ b/dicee/query_answering/methods/heuristic.py @@ -0,0 +1,58 @@ +"""Released incoming-relation heuristic with reproducible random rankings.""" + +import hashlib +import json + +import torch +from torch import nn + +from .._query import compile_query, validate_tree +from ._common import FuzzyGNN + + +def query_seed(query, seed): + def flatten(value): + return [i for part in value for i in flatten(part)] if isinstance(value, tuple) else [value] + payload = json.dumps([seed, flatten(query)], separators=(',', ':')).encode() + return int.from_bytes(hashlib.sha256(payload).digest()[:8], 'little') % (2**63) + + +class IncomingRelationHeuristic(FuzzyGNN): + """Ignore projection heads; use Boolean logic and shuffle within two classes. + + Each query has its own seeded random stream, making subsets, batching and + interrupted/resumed runs reproduce the same ranking. + """ + + def __init__(self, context, *, seed=0): + super().__init__(context, logic='godel') + if type(seed) is not int: + raise ValueError('Heuristic seed must be an integer') + self.seed = seed + self.dummy_param = nn.Parameter(torch.zeros(1)) + triples = torch.tensor(context.triples, dtype=torch.long).reshape(-1, 3) + self.register_buffer('relations', triples[:, 1], persistent=False) + self.register_buffer('tails', triples[:, 2], persistent=False) + + def project_batch(self, membership, relation, *, relation_ids=None): + result = membership.new_zeros(membership.shape) + for i, r in enumerate(relation): + result[i, self.tails[self.relations == r]] = 1 + return result + + @torch.no_grad() + def predict_batch(self, queries): + if not queries: + return self.dummy_param.new_empty((0, self.context.num_entities)) + trees = [compile_query(q) for q in queries] + for tree in trees: + validate_tree(tree, self.context.num_entities, self.context.num_relations) + probability = self.membership_batch(trees) + noise = torch.stack([torch.rand(self.context.num_entities, device=self.device, + generator=torch.Generator(device=self.device).manual_seed(query_seed(q, self.seed))) + for q in queries]) + probability = (2 * probability + noise) / 3 + return ((probability + 1e-10) / (1 - probability + 1e-10)).log() + + def predict(self, query): + return self.predict_batch([query])[0] diff --git a/dicee/query_answering/methods/qto.py b/dicee/query_answering/methods/qto.py new file mode 100644 index 000000000..b9f4a4955 --- /dev/null +++ b/dicee/query_answering/methods/qto.py @@ -0,0 +1,69 @@ +"""QTO's calibrated neural adjacency and max-product query execution.""" + +import torch + +from ._common import QueryMethod, TensorCache, complex_rows, require_complex + + +class QTO(QueryMethod): + def __init__(self, model, context, *, threshold, negation_scale, row_batch_size=100, cache_bytes=512 * 2**20, + reference_batching=False): + super().__init__(context) + require_complex(model, context) + if not 0 <= threshold <= 1 or negation_scale <= 0 or row_batch_size < 1: + raise ValueError('Invalid QTO calibration or batch size') + self.model, self.threshold, self.negation_scale = model, threshold, negation_scale + self.row_batch_size = row_batch_size + self.reference_batching = reference_batching + self.cache = TensorCache(cache_bytes) + + def rows(self, heads, relation): + self.cache.refresh(self.model) + requested = heads.tolist() + values = {head: self.cache.get((head, relation)) for head in requested} + missing = [head for head, value in values.items() if value is None] + groups = ([list(range(start, min(start + 100, self.context.num_entities))) for start in sorted({head // 100 * 100 for head in missing})] + if self.reference_batching else [missing] if missing else []) + for group in groups: + raw = complex_rows(self.model, group, [relation] * len(group)) + degrees = raw.new_tensor([max(1, len(self.context.outgoing.get(head, {}).get(relation, ()))) for head in group]) + calibrated = raw.softmax(-1) * degrees[:, None] + calibrated = calibrated * (calibrated >= self.threshold) + calibrated = torch.where(calibrated >= 1, .9999, calibrated) + for head, row in zip(group, calibrated): + row[sorted(self.context.outgoing.get(head, {}).get(relation, ()))] = 1 + if head in values: + values[head] = row.clone() if self.reference_batching else row + self.cache.put((head, relation), row) + # Keep requested rows ahead of opportunistic canonical-block prefetches. + if groups: + for head, row in values.items(): + if self.cache.get((head, relation)) is None: + self.cache.put((head, relation), row) + return torch.stack([values[head] for head in requested]) + + def projection(self, prefix, relation, negate=False): + result = torch.zeros_like(prefix) + heads = prefix.nonzero().flatten() + if not len(heads): + return result + for chunk in heads.split(self.row_batch_size): + rows = self.rows(chunk, relation) + if negate: + rows = 1 - torch.minimum(torch.ones_like(rows), self.negation_scale * rows) + result = torch.maximum(result, (prefix[chunk, None] * rows).max(0).values) + return result + + def score_tree(self, tree): + op = tree[0] + if op == 'anchor': + return torch.nn.functional.one_hot(torch.tensor(tree[1], device=self.device), self.context.num_entities).float() + if op == 'project': + return self.projection(self.score_tree(tree[2]), tree[1]) + if op == 'not': + child = tree[1] + if child[0] != 'project': + raise ValueError('Official QTO supports negation of relation atoms only') + return self.projection(self.score_tree(child[2]), child[1], negate=True) + values = torch.stack([self.score_tree(child) for child in tree[1:]]) + return values.prod(0) if op == 'and' else 1 - (1 - values).prod(0) diff --git a/dicee/query_answering/methods/ultraquery.py b/dicee/query_answering/methods/ultraquery.py new file mode 100644 index 000000000..8791a77e2 --- /dev/null +++ b/dicee/query_answering/methods/ultraquery.py @@ -0,0 +1,66 @@ +"""Native UltraQuery using DICE's checkpoint-compatible ULTRA layers.""" + +import torch + +from ...models.ultra import EntityNBFNet, RelNBFNet, build_relation_graph +from ._common import FuzzyGNN, TensorCache +from ._ordered_aggregation import aggregate, cached_layout + + +class UltraQuery(FuzzyGNN): + def __init__(self, context, *, dim=64, num_layers=6, threshold=0., logic='product', cache_bytes=64 * 2**20): + super().__init__(context, logic) + if not 0 <= threshold <= 1: + raise ValueError('Threshold must be between zero and one') + self.threshold = threshold + self.relation_model = RelNBFNet(dim, num_layers) + self.entity_model = EntityNBFNet(dim, num_layers) + triples = torch.tensor(context.triples, dtype=torch.long).reshape(-1, 3) + edges, types = triples[:, [0, 2]].T, triples[:, 1] + redges, rtypes = build_relation_graph(edges, types, context.num_entities, context.num_relations) + for name, value in (('edge_index', edges), ('edge_type', types), ('rel_edge_index', redges), ('rel_edge_type', rtypes)): + self.register_buffer(name, value, persistent=False) + self.cache = TensorCache(cache_bytes) + self._layouts = {} + + def project(self, membership, relation): + return self.project_batch(membership[None], torch.tensor([relation], device=self.device), relation_ids=(relation,))[0] + + @staticmethod + def _layer(layer, hidden, boundary, relations, edges): + update = aggregate(hidden.transpose(0, 1), relations.transpose(0, 1), edges).transpose(0, 1) + boundary + value = layer.linear(torch.cat((hidden, update), -1)) + return layer.layer_norm(value).relu() + hidden + + def project_batch(self, membership, relation, *, relation_ids=None): + rel_edges = cached_layout(self._layouts, 'relation', self.rel_edge_index, self.rel_edge_type, + self.context.num_relations) + ent_edges = cached_layout(self._layouts, 'entity', self.edge_index, self.edge_type, self.context.num_entities) + self.cache.refresh(self) + key = tuple(relation.tolist()) if relation_ids is None else tuple(relation_ids) + relations = self.cache.get(key) + if relations is None: + boundary = membership.new_zeros(len(relation), self.context.num_relations, self.relation_model.dim) + boundary[torch.arange(len(relation), device=self.device), relation] = 1 + relations = boundary + for layer in self.relation_model.layers: + rel = layer.relation.weight.expand(len(relation), -1, -1) + relations = self._layer(layer, relations, boundary, rel, rel_edges) + self.cache.put(key, relations) + query = relations[torch.arange(len(relation), device=self.device), relation] + if self.threshold > 0: + membership = membership.masked_fill(membership <= self.threshold, 0) + boundary = torch.einsum('bn,bd->bnd', membership, query) + hidden = boundary + for index, layer in enumerate(self.entity_model.layers): + projection_key = ('projection', key, index) + projected = self.cache.get(projection_key) + if projected is None: + projected = layer.relation_projection(relations) + # Optional projections use spare capacity; reasoner outputs have priority. + if key in self.cache.values: + self.cache.put(projection_key, projected, optional=True) + hidden = self._layer(layer, hidden, boundary, projected, ent_edges) + # Preserve the reference MLP arithmetic, including saturated probability ties. + features = torch.cat((hidden, query[:, None].expand_as(hidden)), -1) + return self.entity_model.mlp(features).squeeze(-1).sigmoid() diff --git a/dicee/query_answering/score_adapter.py b/dicee/query_answering/score_adapter.py new file mode 100644 index 000000000..bdb5a71c4 --- /dev/null +++ b/dicee/query_answering/score_adapter.py @@ -0,0 +1,227 @@ +"""Small monotone row transforms shared by adapter fitting and query inference. + +Memberships are fuzzy scores, not a claim of probability calibration. +""" + +import hashlib +import json +import math +import weakref +from pathlib import Path +from typing import Any + +import torch +from torch import nn +from torch.nn import functional as F + +from ._deferred import require +from .context import state_fingerprint, state_token + +FEATURE_COUNTS = {'global': 1, 'context': 4, 'context_scores': 8} + + +def canonical_feature_mode(mode): + """Resolve supported feature-mode names to their canonical spelling.""" + mode = 'context_scores' if mode == 'context_scores_v1' else mode + if mode not in FEATURE_COUNTS: + raise ValueError(f'Unknown feature mode: {mode}') + return mode + + +def score_features(raw, observed, base, mode): + mode = canonical_feature_mode(mode) + raw = raw.to(torch.float64) + if raw.ndim != 2 or not raw.shape[1] or observed.shape != raw.shape or base.shape != (len(raw), 4): + raise ValueError('Features require complete [rows, entities] scores and four context features') + require(torch.isfinite(raw).all() & torch.isfinite(base).all(), ValueError('Atomic rows and features must be finite')) + if mode == 'global': + return base[:, :1] + if mode == 'context': + return base + n = raw.shape[1] + mean = raw.mean(1) + centered = raw - raw.max(1, keepdim=True).values + exp = centered.exp() + normalizer = exp.sum(1) + entropy = normalizer.log() - (exp * centered).sum(1) / normalizer + if n > 1: + entropy = entropy / math.log(n) + top = raw.topk(2, dim=1).values + gap = ((top[:, 0] - top[:, 1]) / 4).tanh() + else: + entropy, gap = torch.zeros_like(mean), torch.zeros_like(mean) + count = observed.sum(1) + obs_mean = (raw * observed).sum(1) / count.clamp_min(1) + contrast = torch.where(count > 0, ((obs_mean - mean) / 4).tanh(), 0.) + return torch.cat((base, torch.stack(((mean / 4).tanh(), entropy, gap, contrast), dim=1)), dim=1) + + +class QueryScoreAdapter(nn.Module): + """Positive row scale and bias; zero weights give the sigmoid baseline. + + ``global`` learns only two parameters. ``context`` and ``context_scores`` + learn eight and sixteen with a linear head. Context observations can override or + interpolate memberships. Newly fitted adapters bind to a backbone state hash. + """ + + def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=None, metadata=None, + bias_bound=4., scale_bound=2., normalization='none', hidden_dim=0, hidden_weights=None, seed=0): + super().__init__() + feature_mode = canonical_feature_mode(feature_mode) + if not math.isfinite(observed_mix) or not 0 <= observed_mix <= 1: + raise ValueError('observed_mix must be in [0, 1]') + if not math.isfinite(bias_bound) or bias_bound <= 0: + raise ValueError('bias_bound must be finite and positive') + if scale_bound is not None and (not math.isfinite(scale_bound) or scale_bound <= 1): + raise ValueError('scale_bound must exceed one, or be None for unrestricted scaling') + if normalization not in ('none', 'standard'): + raise ValueError('Choose none or standard row normalization') + if type(hidden_dim) is not int or hidden_dim < 0: + raise ValueError('hidden_dim must be a nonnegative integer') + self.feature_mode, self.observed_mix = feature_mode, float(observed_mix) + self.bias_bound, self.normalization, self.hidden_dim = float(bias_bound), normalization, hidden_dim + self.scale_bound = None if scale_bound is None else float(scale_bound) + features = FEATURE_COUNTS[feature_mode] + size = (2, hidden_dim or features) + value = torch.zeros(size, dtype=torch.float64) if weights is None else torch.as_tensor(weights, dtype=torch.float64) + if value.shape != size or not torch.isfinite(value).all(): + raise ValueError(f'Expected finite adapter weights of shape {size}') + self.weights = nn.Parameter(value.clone()) + if hidden_dim: + value = (torch.randn(hidden_dim, features, dtype=torch.float64, + generator=torch.Generator().manual_seed(seed)) / math.sqrt(features) + if hidden_weights is None else torch.as_tensor(hidden_weights, dtype=torch.float64)) + if value.shape != (hidden_dim, features) or not torch.isfinite(value).all(): + raise ValueError('Invalid hidden adapter weights') + self.hidden_weights = nn.Parameter(value.clone()) + else: + if hidden_weights is not None: + raise ValueError('Hidden weights require hidden_dim') + self.register_parameter('hidden_weights', None) + self.metadata = dict(metadata or {}) + + @property + def configuration(self): + return dict(feature_mode=self.feature_mode, observed_mix=self.observed_mix, bias_bound=self.bias_bound, + scale_bound=self.scale_bound, normalization=self.normalization, hidden_dim=self.hidden_dim) + + def prepare(self, raw, observed=None, base=None): + """Prepare parameter-independent inputs once for frozen training banks.""" + raw = raw.to(dtype=torch.float64) + if raw.ndim != 2: + raise ValueError('Adapter requires [rows, entities] logits') + if observed is None or base is None: + if self.feature_mode != 'global' or self.observed_mix: + raise ValueError('Context features/observations require an explicit context graph') + observed = torch.zeros_like(raw, dtype=torch.bool) + base = raw.new_zeros((len(raw), 4)) + base[:, 0] = 1 + features = score_features(raw, observed, base, self.feature_mode) + if self.normalization == 'standard': + raw = (raw - raw.mean(1, keepdim=True)) / raw.std(1, correction=0, keepdim=True).clamp_min(1e-6) + return raw, observed, features + + def _on(self, name, device): + """Parameter on ``device``; inference reuses one copy until the parameter changes.""" + value = getattr(self, name) + if value.device == device or (torch.is_grad_enabled() and value.requires_grad) or value.is_inference(): + return value.to(device=device) + key = (device, id(value), value._version) + copies = self.__dict__.setdefault('_device_copies', {}) + if copies.get(name, (None,))[0] != key: + copies[name] = key, value.detach().to(device=device) + return copies[name][1] + + def transform(self, raw, observed, features): + weights = self._on('weights', raw.device) + if self.hidden_weights is not None: + features = (features @ self._on('hidden_weights', raw.device).T).tanh() + u, v = (features @ weights.T).unbind(1) + # Match the derivative at initialization across scale bounds. + log_scale = math.log(2) * u + if self.scale_bound is not None: + limit = math.log(self.scale_bound) + log_scale = limit * (u * (math.log(2) / limit)).tanh() + scale = log_scale.exp() + require(torch.isfinite(scale).all() & ~(scale <= 0).any(), FloatingPointError('Nonfinite or zero adapter scale')) + logits = scale[:, None] * raw + self.bias_bound * v.tanh()[:, None] + logs = F.logsigmoid(logits) + if self.observed_mix == 1: + logs = logs.masked_fill(observed, 0.) + elif self.observed_mix: + mixed = torch.logaddexp(logs.new_tensor(math.log(self.observed_mix)), math.log1p(-self.observed_mix) + logs) + logs = torch.where(observed, mixed, logs) + return logs + + def forward(self, raw, observed=None, base=None): + return self.transform(*self.prepare(raw, observed, base)) + + def verify_model(self, model): + expected = self.metadata.get('backbone_state_sha256') + if not expected: + return + token = state_token(model) + previous = getattr(self, '_verified_model', None) + if (token is not None and previous is not None and previous() is model + and getattr(self, '_verified_state', None) == (expected, token)): + return + if state_fingerprint(model) != expected: + raise ValueError('Adapter belongs to different or modified backbone weights') + self._verified_model = weakref.ref(model) + self._verified_state = (expected, token) if token is not None else None + + def to_dict(self): + return dict(self.metadata, version=3, **self.configuration, weights=self.weights.detach().cpu().tolist(), + hidden_weights=None if self.hidden_weights is None else self.hidden_weights.detach().cpu().tolist()) + + def save(self, path: str | Path) -> None: + """Write the adapter and its metadata as JSON.""" + Path(path).write_text(json.dumps(self.to_dict(), indent=2, allow_nan=False) + '\n') + + @classmethod + def load(cls, path: str | Path, *, model: Any, key: str | None = None, + checkpoint: str | Path | None = None) -> 'QueryScoreAdapter': + """Load an adapter artifact, or one entry of an adapter catalog. + + Args: + path: Adapter or catalog JSON file. + model: Backbone the adapter was fitted for; its state must match the recorded fingerprint. + key: Catalog entry to load. + checkpoint: Original backbone checkpoint, for adapters that record its file hash; + both its bytes and its tensor state are checked. + + Returns: + The adapter. + + Raises: + ValueError: If the file is not a supported adapter, or the backbone differs. + """ + payload = json.loads(Path(path).read_text()) + if key is not None: + if key not in payload: + raise ValueError(f'Adapter catalog has no entry {key!r}') + payload = payload[key] + if 'weights' not in payload: + raise ValueError('Select a catalog entry with key=...') + if payload.get('version', 1) not in (1, 2, 3): + raise ValueError('Unsupported adapter artifact version') + fields = ('weights', 'feature_mode', 'observed_mix', 'version', 'bias_bound', 'scale_bound', 'normalization', 'hidden_dim', 'hidden_weights') + metadata = {k: v for k, v in payload.items() if k not in fields} + if 'backbone_state_sha256' not in metadata: + if checkpoint is None or 'backbone_checkpoint_sha256' not in metadata: + raise ValueError('Adapter needs verified backbone state or its original checkpoint') + checkpoint = Path(checkpoint) + with checkpoint.open('rb') as stream: + checksum = hashlib.file_digest(stream, 'sha256').hexdigest() + if checksum != metadata['backbone_checkpoint_sha256']: + raise ValueError('Adapter checkpoint checksum mismatch') + state = torch.load(checkpoint, map_location='cpu', weights_only=True) + state = state.get('model', state) + metadata['backbone_state_sha256'] = state_fingerprint(state) + adapter = cls(payload.get('feature_mode', 'context'), payload.get('observed_mix', 0.), + weights=payload['weights'], metadata=metadata, bias_bound=payload.get('bias_bound', 4.), + scale_bound=payload.get('scale_bound', 2.), + normalization=payload.get('normalization', 'none'), hidden_dim=payload.get('hidden_dim', 0), + hidden_weights=payload.get('hidden_weights')) + adapter.verify_model(model) + return adapter diff --git a/dicee/query_generator.py b/dicee/query_generator.py index 8ed3c6c1c..23dbbe555 100644 --- a/dicee/query_generator.py +++ b/dicee/query_generator.py @@ -8,6 +8,7 @@ import numpy as np +from .query_answering._query import QUERY_SHAPES, compile_query, exact_answers from .static_funcs import load_pickle, save_pickle logger = logging.getLogger(__name__) @@ -34,27 +35,28 @@ def __init__(self, train_path, val_path: str, test_path: str, ent2id: Optional[D self.rel2id: Dict = rel2id self.ent_in: Dict = {} self.ent_out: Dict = {} - self.query_name_to_struct = {"1p": ['e', ['r']], - "2p": ['e', ['r', 'r']], - "3p": ['e', ['r', 'r', 'r']], - "2i": [['e', ['r']], ['e', ['r']]], # @TODO: double check the evaluation - "3i": [['e', ['r']], ['e', ['r']], ['e', ['r']]], - "pi": [['e', ['r', 'r']], ['e', ['r']]], - "ip": [[['e', ['r']], ['e', ['r']]], ['r']], - "2in": [['e', ['r']], ['e', ['r', 'n']]], - "3in": [['e', ['r']], ['e', ['r']], ['e', ['r', 'n']]], - "pin": [['e', ['r', 'r']], ['e', ['r', 'n']]], - "pni": [['e', ['r', 'r', 'n']], ['e', ['r']]], - "inp": [[['e', ['r']], ['e', ['r', 'n']]], ['r']], - # union - "2u": [['e', ['r']], ['e', ['r']], ['u']], - "up": [[['e', ['r']], ['e', ['r']], ['u']], ['r']]} + self.query_name_to_struct = {name: self.tuple2list(shape) for name, shape in QUERY_SHAPES.items()} self.set_global_seed(seed) # Sanity checking assert isinstance(self.ent2id, dict) or self.ent2id is None assert isinstance(self.rel2id, dict) or self.rel2id is None + @classmethod + def from_context(cls, context, *, seed=1): + """Ground queries from an in-memory context without files or global RNG changes.""" + instance = cls.__new__(cls) + instance.num_entities = context.num_entities + instance.ent2id = {str(i): i for i in range(context.num_entities)} + instance.rng = random.Random(seed) + instance.inverse_relations = {a: b for h, t in context.inverse_relations for a, b in ((h, t), (t, h))} + instance.ent_in = defaultdict(lambda: defaultdict(set)) + instance.ent_out = defaultdict(lambda: defaultdict(set)) + for h, r, t in context.triples: + instance.ent_in[t][r].add(h) + instance.ent_out[h][r].add(t) + return instance + def list2tuple(self, list_data): # @TODO: add description return tuple(self.list2tuple(x) if isinstance(x, list) else x for x in list_data) @@ -70,6 +72,7 @@ def tuple2list(self, x: Union[List, Tuple]) -> Union[List, Tuple]: def set_global_seed(self, seed: int): """Set seed""" + self.rng = random.Random(seed) np.random.seed(seed) random.seed(seed) @@ -117,15 +120,15 @@ def fill_query(self, query_structure: List[Union[str, List]], for j in range(40): if len(ent_in[answer].keys()) < 1: return True # not enough relations, return True to indicate broken flag - r_tmp = random.sample(list(ent_in[answer].keys()), 1)[0] - if r_tmp // 2 != r // 2 or r_tmp == r: + r_tmp = self.rng.sample(sorted(ent_in[answer]), 1)[0] + if (r_tmp != self.inverse_relations.get(r) if hasattr(self, 'inverse_relations') else r_tmp // 2 != r // 2 or r_tmp == r): r = r_tmp found = True break if not found: return True query_structure[-1][i] = r - answer = random.sample(list(ent_in[answer][r]), 1)[0] + answer = self.rng.sample(sorted(ent_in[answer][r]), 1)[0] if query_structure[0] == 'e': query_structure[0] = answer else: @@ -156,40 +159,10 @@ def achieve_answer(self, query: List[Union[str, List]], Private method for achieve_answer logic. @TODO: Document the code """ - assert isinstance(query[-1], list) - all_relation_flag = True - for ele in query[-1]: - # @TODO: unclear - if not isinstance(ele, int) or (ele == -1): - all_relation_flag = False - break - if all_relation_flag: - if isinstance(query[0], int): - # @TODO: unclear - ent_set = set([query[0]]) - else: - ent_set = self.achieve_answer(query[0], ent_in, ent_out) - for i in range(len(query[-1])): - if query[-1][i] == -2: - ent_set = set(range(len(ent_in))) - ent_set - else: - ent_set_traverse = set() - for ent in ent_set: - ent_set_traverse = ent_set_traverse.union(ent_out[ent][query[-1][i]]) - ent_set = ent_set_traverse - else: - ent_set = self.achieve_answer(query[0], ent_in, ent_out) - union_flag = False - if len(query[-1]) == 1 and query[-1][0] == -1: - union_flag = True - for i in range(1, len(query)): - if not union_flag: - ent_set = ent_set.intersection(self.achieve_answer(query[i], ent_in, ent_out)) - else: - if i == len(query) - 1: - continue - ent_set = ent_set.union(self.achieve_answer(query[i], ent_in, ent_out)) - return ent_set + num_entities = getattr(self, 'num_entities', None) + if num_entities is None: + num_entities = len(self.ent2id) if self.ent2id is not None else max(set(ent_in) | set(ent_out), default=-1) + 1 + return exact_answers(compile_query(query), ent_out, num_entities) def write_links(self, ent_out, small_ent_out): # @TODO: Explain why this is needed diff --git a/dicee/scripts/evaluate_query_methods.py b/dicee/scripts/evaluate_query_methods.py new file mode 100644 index 000000000..077c9cf7a --- /dev/null +++ b/dicee/scripts/evaluate_query_methods.py @@ -0,0 +1,42 @@ +"""Evaluate complex-query answering methods from JSON recipes. + + python -m dicee.scripts.evaluate_query_methods --manifest recipe.json --output DIR + +A manifest holds one recipe or a list of recipes with unique ``id`` fields; +results go to ``DIR/ID``. The reproducible benchmark suites, with frozen inputs +and verification, run through ``python -m benchmarks.cqa``. +""" + +import argparse +import json +from pathlib import Path + +from dicee.query_answering.method_evaluation import evaluate_method + + +def main(argv: list[str] | None = None) -> None: + """Evaluate each recipe of ``--manifest`` into ``--output/ID``.""" + parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('--manifest', type=Path, required=True, help='JSON recipe or list of recipes') + parser.add_argument('--output', type=Path, required=True) + parser.add_argument('--device', default='cpu') + parser.add_argument('--split', choices=('valid', 'test'), default='test') + parser.add_argument('--max-queries-per-shape', type=int, help='Uniform sample of each query type') + parser.add_argument('--seed', type=int, default=0) + parser.add_argument('--threads', type=int) + args = parser.parse_args(argv) + recipes = json.loads(args.manifest.read_text()) + recipes = recipes if isinstance(recipes, list) else [recipes] + names = [recipe.get('id', f'{recipe["method"]}-{recipe["dataset"]}') for recipe in recipes] + if len(set(names)) != len(names) or any(Path(name).name != name or name in ('.', '..') for name in names): + parser.error('Recipe IDs must be unique, plain directory names') + for name, recipe in zip(names, recipes): + recipe = dict(recipe) + query_order = recipe.pop('query_order', 'relation') + report = evaluate_method(recipe, output=args.output / name, device=args.device, split=args.split, + limit=args.max_queries_per_shape, seed=args.seed, threads=args.threads, query_order=query_order) + print(json.dumps(dict(id=name, queries=report['queries'], seconds=report['seconds'], averages=report['averages'])), flush=True) + + +if __name__ == '__main__': + main() diff --git a/dicee/scripts/run.py b/dicee/scripts/run.py index c37429e40..e38dc4268 100755 --- a/dicee/scripts/run.py +++ b/dicee/scripts/run.py @@ -148,7 +148,7 @@ def get_default_arguments(description=None): choices=["None", "train", "train_val", "train_val_test", "test", "val_test", "val", "train_test"], help='Evaluating link prediction performance on data splits. ') parser.add_argument("--eval_tie_policy", choices=TIE_POLICIES, default="sort", - help="Prediction ties: legacy sort ordering, best rank (optimistic), " + help="Prediction ties: sort ordering, best rank (optimistic), " "uniform random tied rank, or worst rank (pessimistic).") parser.add_argument("--eval_tie_seed", type=int, default=None, help="Seed for independent random tie-breaking; defaults to random_seed.") diff --git a/dicee/trainer/torch_trainer_ddp.py b/dicee/trainer/torch_trainer_ddp.py index 86b959164..46680f7d5 100644 --- a/dicee/trainer/torch_trainer_ddp.py +++ b/dicee/trainer/torch_trainer_ddp.py @@ -12,8 +12,6 @@ logger = logging.getLogger(__name__) -torch.set_float32_matmul_precision('high') - def make_iterable_verbose(iterable_object, verbose, desc="Default", position=None, leave=True) -> Iterable: if verbose: @@ -27,6 +25,7 @@ def __init__(self, args, callbacks): super().__init__(args, callbacks) def fit(self, *args, **kwargs): + torch.set_float32_matmul_precision('high') assert len(args) == 1 model, = args diff --git a/docs/guides/multi_hop_queries.md b/docs/guides/multi_hop_queries.md index 60bb5f856..69d0ed2e3 100644 --- a/docs/guides/multi_hop_queries.md +++ b/docs/guides/multi_hop_queries.md @@ -1,6 +1,10 @@ -# Multi-Hop Query Answering +# Complex Query Answering (CQA) -This guide explains how to use DICE Embeddings for complex multi-hop query answering using EPFO (Existential Positive First-Order) queries. +This guide explains how to use DICE Embeddings for complex multi-hop query answering using EPFO (Existential Positive First-Order) queries and their supported negated forms. + +Ordinary KGEs and ULTRA/TRIX/Flock share the same evaluator. Scores default to +sigmoid memberships (`use_logits=False`), and every query respects the answer +limit `k`. Use `beam_size` to control intermediate search independently. ## Table of Contents @@ -9,12 +13,13 @@ This guide explains how to use DICE Embeddings for complex multi-hop query answe - [Usage Examples](#usage-examples) - [Advanced Patterns](#advanced-patterns) - [Performance Tips](#performance-tips) +- [Training and evaluating query methods](#training-and-evaluating-query-methods) --- ## Overview -Multi-hop query answering allows you to ask complex questions that require reasoning over multiple relationships in a knowledge graph. DICE Embeddings supports **9 query types** covering projections, intersections, and unions. +Multi-hop query answering combines relationships in a knowledge graph. DICE supports the **14 UltraQuery query types**, including `2in`, `3in`, `inp`, `pin`, and `pni` for negation, and the additional `4p` and `4i` types used by +H. ### Supported Query Types @@ -396,15 +401,15 @@ for query_id, preds in results.items(): The `tnorm` parameter controls how conjunctions are computed: ```python -# Minimum t-norm (default, most commonly used) +# Minimum t-norm model.answer_multi_hop_query(..., tnorm="min") -# Product t-norm (multiplicative semantics) +# Product t-norm (default, multiplicative semantics) model.answer_multi_hop_query(..., tnorm="prod") ``` **When to use:** -- **`min`**: Standard choice, preserves highest score in conjunction +- **`min`**: Takes the lower membership in a conjunction - **`prod`**: More strict, all conditions must have high scores ### Filtering Results @@ -580,7 +585,7 @@ candidate_drugs = model.answer_multi_hop_query( ### Limitations -1. **Negation not supported** — Cannot express "NOT" queries +1. **Fixed query structures** — Only the 16 types above; negation is available through `2in`, `3in`, `inp`, `pin`, and `pni` 2. **Numerical constraints not supported** — Cannot express "> 5" or "between X and Y" 3. **Recursive queries not supported** — Cannot express "transitive closure" 4. **Performance degrades with query complexity** — 3-hop queries slower than 1-hop @@ -621,7 +626,7 @@ candidate_drugs = model.answer_multi_hop_query( **Problem:** Queries take too long **Solutions:** -1. Reduce `k` parameter +1. Reduce `beam_size` to limit intermediate candidates; `k` controls only the returned answers 2. Use simpler query types when possible 3. Ensure model is on GPU: `model.to("cuda")` 4. Cache repeated query patterns @@ -632,7 +637,7 @@ candidate_drugs = model.answer_multi_hop_query( - **Tests:** [test_answer_multi_hop_query.py](../../tests/test_answer_multi_hop_query.py) — Complete examples - **Research:** [Query2Box paper](https://arxiv.org/abs/2002.05969) — Theoretical foundation -- **Benchmarks:** [examples/multi_hop_query_answering/](../../examples/multi_hop_query_answering/) — Performance evaluation +- **Benchmarks:** [benchmarks/cqa](../../benchmarks/cqa/README.md) — Reproducible UltraQuery and +H evaluation --- @@ -646,12 +651,50 @@ candidate_drugs = model.answer_multi_hop_query( | Follow chain of relations | `2p`, `3p` | | Find entities satisfying AND conditions | `2i`, `3i` | | Find entities satisfying OR conditions | `2u` | -| Complex patterns | `ip`, `pi`, `up` | +| Exclude entities (NOT) | `2in`, `3in`, `inp`, `pin`, `pni` | +| Complex patterns | `ip`, `pi`, `up`, `4p`, `4i` | **Best Practices:** - ✅ Start with simple queries (1p, 2p) -- ✅ Use `tnorm="min"` as default +- ✅ Compare `tnorm="prod"` and `tnorm="min"` on validation queries - ✅ Train with `AllvsAll` for best reasoning - ✅ Use high `embedding_dim` (≥ 256) - ✅ Validate query syntax carefully - ✅ Benchmark on known ground truth first + +## Training and evaluating query methods + +Fit adapters with `python -m dicee.query_answering fit --help`; prepare source +queries with `python -m dicee.query_answering prepare --help`. The backbone stays +frozen, and the saved adapter records its configuration and backbone fingerprint. +The default is linear `context_scores` (16 parameters) for every backbone; +`--feature-mode context` or `global` selects simpler alternatives. + +The `dicee.query_answering.methods` package exposes ConE, CLMPT, CQD/CQD-Hybrid, +GNN-QE, QTO, UltraQuery, and `load_method()` for their released checkpoints. +`dicee.query_answering.evaluate_method()` evaluates these methods and our +ULTRA/TRIX adapters through the same filtered ranking and checkpoint machinery. +It accepts a recipe with `method`, `checkpoint`, `dataset`, and `root`; KGFM recipes +also specify `adapters`, per-type `operators`, and `selection_protocol`. + +The CLI evaluates a JSON recipe, or a list of recipes with unique `id` fields: + +```bash +python -m dicee.scripts.evaluate_query_methods \ + --manifest recipe.json --output results/cqa-pilot \ + --split valid --max-queries-per-shape 2 --device cuda +``` + +It supports every loaded dataset family, including UltraQuery and +H. The +[benchmark harness](../../benchmarks/cqa/README.md) selects methods, datasets and +query types from the public recipes, freezes query batches, verifies upstream +parity: + +```bash +python -m benchmarks.cqa plus_h evaluate --methods ultra-adapter --datasets FB15k237+H \ + --query-types 2p 3p --output results/cqa-pilot --split valid --max-queries-per-shape 2 +``` + +Query groups are `all`, `epfo`, and `negation`. Shipped +H CQD/CQD-Hybrid recipes +default to all 16 types with atomic negation enabled. Adapter definitions are in +`score_adapter.py`; fitting and source-query preparation are in `adapter_training.py`. diff --git a/tests/fixtures/query_baselines/README.md b/tests/fixtures/query_baselines/README.md new file mode 100644 index 000000000..bbd9dd901 --- /dev/null +++ b/tests/fixtures/query_baselines/README.md @@ -0,0 +1,66 @@ +# Upstream inference fixtures + +Generated on CPU with PyTorch 2.9.1. No DICE imports occur in the generator. +Each file records its upstream git commit, graph, queries, checkpoint state, +options, and expected complete score vectors. `ultra.pt` also records hashes of +the public `ultraquery.pth` and `ultra_3g.pth` weights. The random seed is 20260926. + +The repositories and immutable commits are listed in `REFERENCES` in +`dicee/query_answering/catalog.py`. +Clone each repository and check out that commit before regenerating a fixture. + +```bash +PYTHONPATH=/path/to/upstream \ +python tests/fixtures/query_baselines/generate_reference.py \ + cone /path/to/upstream tests/fixtures/query_baselines/cone.pt +``` + +Use `cqd`, `clmpt`, `ultra`, `gnnqe`, or `qto` for the other fixtures. For QTO, +put its `kbc` directory on `PYTHONPATH`. Use separate processes to avoid upstream +package-name collisions. Generating ULTRA/GNN-QE requires their reference-only +dependencies; these are not DICE runtime dependencies. + +The verification environment used torch-geometric 2.6.1, torch-scatter 2.1.2, +torch-cluster 1.6.3, TorchDrug 0.2.1, and Ninja. GPU visibility was disabled and +`MAX_JOBS=1` bounded reference extension compilation. For current Python/RDKit, +the generator aliases `collections.Sequence` and supplies the unused drawing +base class removed from RDKit. TorchDrug requires these two build-only changes +with PyTorch 2.9: + +1. In `layers/functional/extension/{spmm,rspmm}.h`, change + `ATen/SparseTensorUtils.h` to `ATen/native/SparseTensorUtils.h`. +2. In `utils/torch.py`, pass `extra_ldflags`, `extra_include_paths`, + `build_directory`, and `verbose` to `cpp_extension.load` by keyword. + +The original sparse kernels and neural computations are unchanged. GNN-QE +fixtures execute those compiled kernels, including symbolic traversal. + +CLMPT fixtures evaluate DNF branches through the released reasoner with the +original relation groundings. Both pre/post-norm variants are covered. The +metadata's earlier incorrect `up` repair note has been corrected by regenerating +the fixture; all tensors remain bit-identical. +CQD fixtures intentionally retain the released 3p/4p quirks. +An additional plain CQD case verifies the `ip`/`up` cap with beam 6 and max_k 1. +CLMPT also records paired-query batches to test the post-norm layout directly. + +The fixtures cover all 16 shapes for ConE, QTO, CLMPT, UltraQuery and GNN-QE; +CQD/CQD-Hybrid cover 11 positive shapes with product and min in `cqd.pt`, plus +the five negated shapes in `cqd-negation.pt`. + +`cqd-negation.pt` covers the five negated types. +Its executor is official CQD-A at commit +`642ce042708be6247087c09c780b9deb47e941d3`, with +H min-max atomic scoring. +Both operators are covered. Hybrid checks use a full-width beam and observed +fact overrides; its dynamic beam is covered separately by the positive fixtures. + +```bash +python tests/fixtures/query_baselines/generate_negation_reference.py \ + /path/to/adaptive-cqd tests/fixtures/query_baselines/cqd-negation.pt +``` + +For ConE, CLMPT, GNN-QE, CQD or QTO, `--checkpoint /path/to/released-weights` generates +an additional reference using those learned parameters. Vocabulary tensors +are cropped to this seven-entity, four-relation graph; other learned parameters +remain unchanged. The output records the original checkpoint hash. Verify full +checkpoint loading against its original dataset separately. Store these large +references under `Experiments/`, outside the checked-in fixtures. diff --git a/tests/fixtures/query_baselines/clmpt.pt b/tests/fixtures/query_baselines/clmpt.pt new file mode 100644 index 0000000000000000000000000000000000000000..f3a95688c8253756045eaf55e1506060f2a812a3 GIT binary patch literal 45693 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 YKTEju&lCAgxijg4UgRHFURCyg00Di7D*ylh literal 0 HcmV?d00001 diff --git a/tests/fixtures/query_baselines/cqd-negation.pt b/tests/fixtures/query_baselines/cqd-negation.pt new file mode 100644 index 0000000000000000000000000000000000000000..d73c7e9f8d9d3a7d93ec00cb5476da3fa5bedd4d GIT binary patch literal 11577 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 literal 0 HcmV?d00001 diff --git a/tests/fixtures/query_baselines/cqd.pt b/tests/fixtures/query_baselines/cqd.pt new file mode 100644 index 0000000000000000000000000000000000000000..b19e967acaaab4bfc1e598f56865e8083aa54e3c GIT binary patch literal 18755 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 Ca(dAK literal 0 HcmV?d00001 diff --git a/tests/fixtures/query_baselines/generate_negation_reference.py b/tests/fixtures/query_baselines/generate_negation_reference.py new file mode 100644 index 000000000..f30274522 --- /dev/null +++ b/tests/fixtures/query_baselines/generate_negation_reference.py @@ -0,0 +1,74 @@ +"""CQD-A negation oracles with +H atomic scoring; no DICE imports.""" + +import argparse +import hashlib +import subprocess +from pathlib import Path + +import torch +from generate_reference import flatten, module + +COMMIT = '642ce042708be6247087c09c780b9deb47e941d3' + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('upstream', type=Path) + parser.add_argument('output', type=Path) + args = parser.parse_args() + commit = subprocess.check_output(['git', '-C', str(args.upstream), 'rev-parse', 'HEAD'], text=True).strip() + if commit != COMMIT: + raise ValueError('Unexpected CQD-A source revision') + source = module(args.upstream / 'cqda/cqd/discrete.py', 'cqda_reference') + base = Path(__file__).with_name('cqd.pt') + fixture = torch.load(base, weights_only=True) + queries = {name: value for name, value in fixture['queries'].items() if 'n' in name} + cases = [] + torch.set_num_threads(2) + with torch.no_grad(): + for parent in fixture['cases']: + if '1p' not in parent['scores']: + continue + state, hybrid = parent['state'], parent['name'] == 'cqd-hybrid' + entity = torch.nn.Embedding.from_pretrained(state['embeddings.0.weight']) + relation = torch.nn.Embedding.from_pretrained(state['embeddings.1.weight']) + norm = parent['config']['tnorm'] + k = fixture['num_entities'] if hybrid else 2 + + def scoring(lhs, rel, rhs): + hr, hi = lhs.chunk(2, -1) + rr, ri = rel.chunk(2, -1) + tr, ti = rhs.chunk(2, -1) + raw = (hr * rr - hi * ri) @ tr.T + (hr * ri + hi * rr) @ ti.T + result = (.9 if hybrid else 1.) * (raw - raw.min()) / (raw.max() - raw.min()) + if hybrid: + heads = (lhs[:, None] == entity.weight[None]).all(-1).int().argmax(-1) + rels = (rel[:, None] == relation.weight[None]).all(-1).int().argmax(-1) + for row, (h, r) in enumerate(zip(heads.tolist(), rels.tolist())): + for a, b, t in fixture['triples']: + if (a, b) == (h, r): + result[row, t] = 1 + return result + + def negation(value, **kwargs): + return 1 - value + + scores = {} + for name, query in queries.items(): + options = {'aim_run': None} if name in ('2in', '3in') else {'k': k} + scores[name] = getattr(source, f'query_{name}')( + entity, relation, torch.tensor([flatten(query)]), scoring, + t_norm=torch.mul if norm == 'prod' else torch.minimum, negation=negation, **options)[0] + cases.append(dict(name=parent['name'], state=state, scores=scores, + config=dict(atomic_negation=True, beam_size=k, max_k=k, tnorm=norm))) + output = {key: fixture[key] for key in ('triples', 'num_entities', 'num_relations')} + output.update(queries=queries, cases=cases, upstream_commit=commit, + source='https://github.com/EdinburghNLP/adaptive-cqd', + parent_sha256=hashlib.sha256(base.read_bytes()).hexdigest(), + scope='CQD-A signed-atom executor with +H calibration; hybrid full-width observed override.') + torch.save(output, args.output) + print(f'{len(cases)} cases, {sum(len(c["scores"]) for c in cases)} negation vectors') + + +if __name__ == '__main__': + main() diff --git a/tests/fixtures/query_baselines/generate_reference.py b/tests/fixtures/query_baselines/generate_reference.py new file mode 100644 index 000000000..8c44626a5 --- /dev/null +++ b/tests/fixtures/query_baselines/generate_reference.py @@ -0,0 +1,301 @@ +"""Generate CPU oracles from pinned upstream code; never import DICE here. + +Run each method in its own process with its repository on PYTHONPATH. +Optional reference dependencies belong in an isolated environment. +""" + +import argparse +import hashlib +import importlib.util +import subprocess +from pathlib import Path + +import torch + +A, B, C, D = (0, (0,)), (1, (2,)), (2, (1,)), (3, (3,)) +QUERIES = { + '1p': A, '2p': (0, (0, 2)), '3p': (0, (0, 2, 1)), '4p': (0, (0, 2, 1, 3)), + '2i': (A, B), '3i': (A, B, C), '4i': (A, B, C, D), + 'ip': ((A, B), (2,)), 'pi': ((0, (0, 2)), B), + '2u': (A, B, (-1,)), 'up': ((A, B, (-1,)), (2,)), + '2in': (A, (1, (2, -2))), '3in': (A, C, (1, (2, -2))), + 'inp': ((A, (1, (2, -2))), (2,)), 'pin': ((0, (0, 2)), (1, (2, -2))), + 'pni': ((0, (0, 2, -2)), B), +} +DIRECT = [(0, 0, 1), (0, 0, 2), (1, 2, 3), (2, 2, 4), (3, 0, 5), (5, 2, 6), (4, 0, 0)] +TRIPLES = sorted({*DIRECT, *((t, r ^ 1, h) for h, r, t in DIRECT)}) +N, R = 7, 4 + + +def flatten(query): + return [value for child in query for value in flatten(child)] if isinstance(query, tuple) else [query] + + +def shape(query): + if isinstance(query[0], int) and len(query) == 2: + return 'e', tuple('n' if r == -2 else 'r' for r in query[1]) + if len(query) == 2 and all(isinstance(x, int) for x in query[1]): + return shape(query[0]), tuple('n' if r == -2 else 'r' for r in query[1]) + return tuple(('u',) if child == (-1,) else shape(child) for child in query) + + +def module(path, name): + spec = importlib.util.spec_from_file_location(name, path) + result = importlib.util.module_from_spec(spec) + spec.loader.exec_module(result) + return result + + +def complex_checkpoint(path): + if path is None: + return None + state = torch.load(path, map_location='cpu', weights_only=True) + while any(key in state for key in ('model', 'model_state_dict', 'state_dict')): + state = next(state[key] for key in ('model', 'model_state_dict', 'state_dict') if key in state) + if set(state) != {'embeddings.0.weight', 'embeddings.1.weight'}: + raise ValueError('Expected the released ComplEx embedding tensors') + return {key: value[:N if key == 'embeddings.0.weight' else R].clone() for key, value in state.items()} + + +def cone(root, checkpoint=None): + source = module(root / 'models.py', 'cone_reference') + names = {shape(q): name + '-DNF' if name in ('2u', 'up') else name for name, q in QUERIES.items()} + state = None + if checkpoint: + state = torch.load(checkpoint, map_location='cpu', weights_only=True)['model_state_dict'] + for key, count in (('entity_embedding', N), ('axis_embedding', R), ('arg_embedding', R)): + state[key] = state[key][:count].clone() + dim, gamma = (state['entity_embedding'].shape[1], state['gamma'].item()) if state else (8, 12.) + model = source.KGReasoning(N, R, dim, gamma, query_name_dict=names, center_reg=.02) + model.cone_proj = source.ConeProjection(dim, state['cone_proj.layer1.weight'].shape[0] if state else 16, 2) + if state: + model.load_state_dict(state, strict=True) + model.eval() + scores = {name: model(None, torch.arange(N)[None], None, + {shape(q): torch.tensor([flatten(q)])}, {shape(q): [0]})[1][0] + for name, q in QUERIES.items()} + return [dict(name='cone', state=model.state_dict(), config={'center_reg': .02}, scores=scores)] + + +def cqd(root, checkpoint=None): + from cqd.base import CQD + state = complex_checkpoint(checkpoint) + rank = state['embeddings.0.weight'].shape[1] // 2 if state else 4 + names = {shape(q): name + '-DNF' if name in ('2u', 'up') else name for name, q in QUERIES.items() if 'n' not in name} + filters = {} + for h, r, t in TRIPLES: + filters.setdefault((h, r), []).append(t) + result = [] + for hybrid in (False, True): + for norm in ('prod', 'min'): + model = CQD(N, R, rank, k=2, max_k=4, max_norm=.9 if hybrid else 1., filters=filters, + do_normalize=True, t_norm_name=norm, query_name_dict=names).eval() + if state: + model.load_state_dict(state, strict=True) + else: + for parameter in model.parameters(): + parameter.normal_() + scores = {name: model(None, None, None, {shape(q): torch.tensor([flatten(q)])}, {shape(q): [0]})[1][0] + for name, q in QUERIES.items() if 'n' not in name} + result.append(dict(name='cqd-hybrid' if hybrid else 'cqd', state=model.state_dict(), + config=dict(beam_size=2, max_k=4, tnorm=norm), scores=scores)) + model = CQD(N, R, rank, k=6, max_k=1, max_norm=1., filters=filters, + do_normalize=True, t_norm_name='prod', query_name_dict=names).eval() + model.load_state_dict(result[0]['state'], strict=True) + scores = {name: model(None, None, None, {shape(QUERIES[name]): torch.tensor([flatten(QUERIES[name])])}, + {shape(QUERIES[name]): [0]})[1][0] for name in ('ip', 'up')} + result.append(dict(name='cqd', state=model.state_dict(), + config=dict(beam_size=6, max_k=1, tnorm='prod'), scores=scores)) + return result + + +def qto(root, checkpoint=None): + source = module(root / 'model.py', 'qto_reference') + from src.models import ComplEx + state = complex_checkpoint(checkpoint) + rank = state['embeddings.0.weight'].shape[1] // 2 if state else 4 + backbone = ComplEx([N, R, N], rank=rank, init_size=1.) + if state: + backbone.load_state_dict(state, strict=True) + rows = [] + for relation in range(R): + edges = [(h, t) for h, r, t in TRIPLES if r == relation] + value = source.neural_adj_matrix(backbone, relation, N, 'cpu', .08, edges) + value = (value >= 1).float() * .9999 + (value < 1).float() * value + for h, t in edges: + value[h, t] = 1 + rows.append(value) + model = source.KGReasoning.__new__(source.KGReasoning) + torch.nn.Module.__init__(model) + model.nentity, model.device, model.fraction, model.neg_scale = N, 'cpu', 2, 3. + model.relation_embeddings = [[row[:N // 2].to_sparse(), row[N // 2:].to_sparse()] for row in rows] + scores = {name: model.embed_query(torch.tensor([flatten(q)]), shape(q), 0)[0][0] for name, q in QUERIES.items()} + return [dict(name='qto', state=backbone.state_dict(), config=dict(threshold=.08, negation_scale=3.), scores=scores, + adjacency=torch.stack(rows))] + + +def ultra(root, checkpoint=None): + from torch_geometric.data import Data + from ultra import datasets_query, tasks # noqa: F401 - initialize the upstream circular import + from ultra.models import Ultra + from ultra.query_utils import Query + from ultra.ultraquery import UltraQuery + triples = torch.tensor(TRIPLES) + graph = Data(edge_index=triples[:, [0, 2]].T, edge_type=triples[:, 1], num_nodes=N, num_relations=R) + tasks.build_relation_graph(graph) + result = [] + for checkpoint, threshold in ((None, 0.), ('ultraquery.pth', 0.), ('ultra_3g.pth', .8)): + dim, layers = (8, 2) if checkpoint is None else (64, 6) + config = dict(input_dim=dim, hidden_dims=[dim] * layers, message_func='distmult', aggregate_func='sum', + short_cut=True, layer_norm=True) + backbone = Ultra(dict(config, **{'class': 'RelNBFNet'}), dict(config, **{'class': 'QueryNBFNet'})) + model = UltraQuery(backbone, threshold=threshold).eval() + if checkpoint: + state = torch.load(root / 'ckpts' / checkpoint, weights_only=True, map_location='cpu')['model'] + if checkpoint == 'ultraquery.pth': + model.load_state_dict(state, strict=True) + else: + backbone.load_state_dict(state, strict=True) + scores = {name: model(graph, Query.from_nested(q)[None], symbolic_traversal=False)[0] for name, q in QUERIES.items()} + item = dict(name='ultraquery', state=model.state_dict(), config=dict(threshold=threshold), scores=scores) + if checkpoint: + item['checkpoint'] = checkpoint + item['checkpoint_sha256'] = hashlib.sha256((root / 'ckpts' / checkpoint).read_bytes()).hexdigest() + result.append(item) + return result + + +def clmpt(root, checkpoint=None): + from src.language.foq import EFO1Query + from src.language.grammar import parse_lstr_to_lformula + from src.pipeline.clmpt import CLMPTLayer, CLMPTReasoner + from src.structure.nbp_complex import ComplEx + # Independent literal formulas in the author's query language. + formulas = { + '1p': 'r1(s1,f)', '2p': '(r1(s1,e1))&(r2(e1,f))', + '3p': '((r1(s1,e1))&(r2(e1,e2)))&(r3(e2,f))', + '4p': '(((r1(s1,e1))&(r2(e1,e2)))&(r3(e2,e3)))&(r4(e3,f))', + '2i': '(r1(s1,f))&(r2(s2,f))', '3i': '((r1(s1,f))&(r2(s2,f)))&(r3(s3,f))', + '4i': '(((r1(s1,f))&(r2(s2,f)))&(r3(s3,f)))&(r4(s4,f))', + 'ip': '((r1(s1,e1))&(r2(s2,e1)))&(r3(e1,f))', + 'pi': '((r1(s1,e1))&(r2(e1,f)))&(r3(s2,f))', + '2in': '(r1(s1,f))&(!(r2(s2,f)))', '3in': '((r1(s1,f))&(r2(s2,f)))&(!(r3(s3,f)))', + 'inp': '((r1(s1,e1))&(!(r2(s2,e1))))&(r3(e1,f))', + 'pin': '((r1(s1,e1))&(r2(e1,f)))&(!(r3(s2,f)))', + 'pni': '((r1(s1,e1))&(!(r2(e1,f))))&(r3(s2,f))', + } + values = {'1p': [0, 0], '2p': [0, 0, 2], '3p': [0, 0, 2, 1], '4p': [0, 0, 2, 1, 3], + '2i': [0, 0, 1, 2], '3i': [0, 0, 1, 2, 2, 1], '4i': [0, 0, 1, 2, 2, 1, 3, 3], + 'ip': [0, 0, 1, 2, 2], 'pi': [0, 0, 2, 1, 2], '2in': [0, 0, 1, 2], + '3in': [0, 0, 2, 1, 1, 2], 'inp': [0, 0, 1, 2, 2], 'pin': [0, 0, 2, 1, 2], + 'pni': [0, 0, 2, 1, 2]} + # Grounding order is the atom traversal's first occurrence of each symbol/relation. + import re + state = torch.load(checkpoint, map_location='cpu', weights_only=True) if checkpoint else None + if state: + for key, count in (('nbp._entity_embedding.weight', N), ('nbp._relation_embedding.weight', R)): + state[key] = state[key][:count].clone() + result = [] + modes = [any(key.startswith('transformer.encoder.') for key in state)] if state else (True, False) + for pre_norm in modes: + rank = state['nbp._entity_embedding.weight'].shape[1] // 2 if state else 4 + backbone = ComplEx(N, R, rank, init_size=1.) + hidden_key = 'transformer.encoder.layers.0.ffn.layer1.weight' if pre_norm else 'transformer.layers.0.linear1.weight' + hidden = state[hidden_key].shape[0] if state else 16 + layer = CLMPTLayer(hidden, backbone, layers=2, pre_norm=pre_norm).eval() + if state: + layer.load_state_dict(state, strict=True) + reasoner = CLMPTReasoner(backbone, layer) + + def score(name, override=None, batch_overrides=None): + formula = formulas[name] + symbols = [] + for relation, source, target in re.findall(r'(r\d+)\((\w+),(\w+)\)', formula): + for key in (source, relation): + if key.startswith(('s', 'r')) and key not in symbols: + symbols.append(key) + query = EFO1Query(parse_lstr_to_lformula(formula)) + rows = batch_overrides if batch_overrides is not None else [values[name] if override is None else override] + for row in rows: + query.append_qa_instances(dict(zip(symbols, row)), {'f': []}, {'f': []}) + reasoner.initialize_with_query(query) + reasoner.estimate_variable_embeddings() + scores = torch.cosine_similarity(reasoner.get_ent_emb('f')[:, None], backbone.entity_embedding, dim=-1) + return scores if batch_overrides is not None else scores[0] + + scores = {name: score(name) for name in formulas} + scores['2u'] = torch.maximum(score('1p'), score('1p', [1, 2])) + scores['up'] = torch.maximum(score('2p'), score('2p', [1, 2, 2])) + batches = {'2p': dict(queries=[QUERIES['2p'], (1, (2, 3))], scores=score('2p', batch_overrides=[[0, 0, 2], [1, 2, 3]])), + '2i': dict(queries=[QUERIES['2i'], ((2, (1,)), (3, (3,)))], + scores=score('2i', batch_overrides=[[0, 0, 1, 2], [2, 1, 3, 3]]))} + result.append(dict(name='clmpt', state=layer.state_dict(), config={}, scores=scores, batches=batches, + oracle_note='DNF branches evaluated separately with the released relation groundings')) + return result + + +def gnnqe(root, checkpoint=None): + # Import compatibility only; the neural and sparse inference code is unchanged. + import collections + import collections.abc + import sys + import types + collections.Sequence = collections.abc.Sequence + drawing = types.ModuleType('rdkit.Chem.Draw.mplCanvas') + drawing.Canvas = object + sys.modules[drawing.__name__] = drawing + from gnnqe.data import Query + from gnnqe.gnn import NeuralBellmanFordNetwork + from gnnqe.model import QueryExecutor + from torchdrug import data + triples = torch.tensor(TRIPLES)[:, [0, 2, 1]] + graph = data.Graph(triples, num_node=N, num_relation=R) + state = None + if checkpoint: + with torch.serialization.safe_globals([data.Graph]): + state = torch.load(checkpoint, map_location='cpu', weights_only=True)['model'] + state = {key.removeprefix('model.'): value for key, value in state.items() if key not in ('fact_graph', 'graph')} + dim = state['model.query.weight'].shape[1] + count = len({key.split('.')[3] for key in state if key.startswith('model.model.layers.')}) + state['model.query.weight'] = state['model.query.weight'][:R].clone() + for key in state: + if '.relation_linear.' in key: + state[key] = state[key][:R * dim].clone() + else: + dim, count = 8, 2 + result = [] + for aggregate in (['pna'] if checkpoint else ['sum', 'pna']): + concat_hidden = state is not None and state['model.mlp.layers.0.weight'].shape[1] != 2 * dim + backbone = NeuralBellmanFordNetwork(dim, [dim] * count, R, aggregate_func=aggregate, + short_cut=True, layer_norm=True, concat_hidden=concat_hidden) + model = QueryExecutor(backbone).eval() + if state: + model.load_state_dict(state, strict=True) + scores = {name: model(graph, Query.from_nested(q)[None])[0] for name, q in QUERIES.items()} + result.append(dict(name='gnnqe', state=model.state_dict(), config=dict(aggregate=aggregate), scores=scores)) + return result + + +if __name__ == '__main__': + parser = argparse.ArgumentParser() + parser.add_argument('method', choices=['cone', 'cqd', 'qto', 'ultra', 'clmpt', 'gnnqe']) + parser.add_argument('upstream', type=Path) + parser.add_argument('output', type=Path) + parser.add_argument('--checkpoint', type=Path) + args = parser.parse_args() + torch.set_num_threads(2) + torch.manual_seed(20260926) + with torch.no_grad(): + if args.checkpoint and args.method == 'ultra': + parser.error('ULTRA generation uses the named public checkpoints under upstream/ckpts') + cases = globals()[args.method](args.upstream, args.checkpoint) + commit = subprocess.check_output(['git', '-C', str(args.upstream), 'rev-parse', 'HEAD'], text=True).strip() + args.output.parent.mkdir(parents=True, exist_ok=True) + fixture = dict(upstream_commit=commit, queries=QUERIES, triples=TRIPLES, num_entities=N, num_relations=R, cases=cases) + if args.checkpoint: + with args.checkpoint.open('rb') as stream: + checksum = hashlib.file_digest(stream, 'sha256').hexdigest() + fixture.update(checkpoint_sha256=checksum, checkpoint=str(args.checkpoint), + vocabulary='first 7 entities and 4 relations; learned non-vocabulary parameters unchanged') + torch.save(fixture, args.output) + print(f'{args.method}: {len(cases)} cases, {sum(len(case["scores"]) for case in cases)} score vectors', flush=True) diff --git a/tests/fixtures/query_baselines/gnnqe.pt b/tests/fixtures/query_baselines/gnnqe.pt new file mode 100644 index 0000000000000000000000000000000000000000..ff7f4dd4a3623116a0741dc0014aad2b63834e65 GIT binary patch literal 35341 zcmcG$30zIx`!;@PCKVY%6p@HDtIl4lK@y1^Q^ty-NVRuI#)u|T6q=|+sZc~AweM9j zg)+-b=6Rkn|JOdJ=lMN7->>KAdEftgKA(NB>)d$=z8Yp=cTwNH7tDJY6Ws;Z*@ z_-KgQi)IA{v3>)6eWX4nA#(yXz^Fl(UoS)BJuNlE}=LSgG z7M@1bYi(_AI@8a>*T#3ypc#ICzNTijGcByGEY19EEPbs9S=rk9TFx}LvSnL(s?h4} zJU=eLFO*dXXBCY+TT+i%2&?2KauY?f$}y~p%w-ZhKhdl~EZa-wpBKXRmJw5rp>TK~PX*d`^MD|h3JNg}|3Qz4 zVf)6g{bE>S*p6oJ6xqy&BdKm^yWo?9WClb!7t^9~s)=v2DrWnhLY0<(>6w5L~ zh;9n8ERvmO>cJGW6zbU1Qzdd!ie(*yb0+XOx+w}wv8)pX3T`c9*}-l~lz<-YOhHRG z~ezaVLVROlQ--Bdi=G&woHKp$y9a8M}g>Za(aM7=Y7 zLTR00Q`zB0;jEjHC+**&AfLH@>8(=j+G$ z`8o&8khWq+^_8$5MxKV0Vs5anU!aNH2Kp@Y<3deLO=Q3;D43gTGT$#?mcNu8JwqDI z&G0wznkNki3~lAb`Awe}5a{bA^$Q9O=DfnpTd@)&BiTs~r8RwK`LScbr8qInNopa(Ue<8w2Qg*V0o#NT+H^Q7A z;1kMD^`|lTkMWmln6cCRW!zp(+};AWkDPnDl${}AeLZ{rk~<*C&xiY?`F_oq&Doih zIYP?Lk}1vU$RUNZ?xHq3v#yQqbfoiAwUyQ#*o3*1zN_!r7`7D?H~5_XAa z-`~}dH6*;5iWR$*Hbh^_E|ZBwvk^i=mdgcJNZCjU8}+LmX!c)vV01HfYc@uHnqr$y z(@KGTm7G0J%C45M@xSUg&Ddp;Cp6<8#IBKZuWjN^6u6V*-0P(5dI`JXR~?6PH#_sm z&6sW26v|9HPO6Mq=s0Qej*~8D-za4_N!W~Eb(}xhWl?7~SgkP56bDvrEG`k+5m_gXXLjENMCql>)7na3QPY7xIvtwpz*_ zmas=WJN~R@qG+QII`h=YCq?A1+VQc?;m}Y;3S=XG=iajl7 zJR>l+5TZOQkMf+H^}Lk5AYm{5_bAOwWKmvf&S}loQ%*W|T$XW0vsZ*DugdwZN!jZX z_Qt$$_NJ#AZMoN6KdFx}&th-MM)cc8p42O18^YN;vS&pYecsTg9DCQTMX2o2C3_ID z_rlrx{xVu|=t3uoW| zW3+z^A?$~6_TxWB`yclz`zf4llppdxmqm8-v7f`)FY-OYWpA2O1ctC*!`W|gzt&&< zP1l0`9?t%d@BYix{LAgf{tV|tbiVKpbPVa zDvEzpnHM_UQ<>J95gar#U>2t&+pA2itke3;n#K9eqBAH?MQ{ld*3fx#IaT^4RCZYC zj9|_$lv9%(){0sqf2HO($sn#Zb<_JqMarpDB-|=0(Oeq}>D|I<&{B58aGDfJIW1}> zTw7}WRhtvpaP0)Ij7XcJCZhHf3Pc@fDJSYkk(BF1t%TE|*1vUgB3rJr;FS?|p{R+d zD}@4)E-mFm-6)cB-Kmvuder)BG$S%M<@5!wjHm}iO+-B@6o?FHDJSYhk(BFAt%NhA z*1v6YA~UX!;FS>>QPf1#mqLN4A1&oX#uQ1p{?tmi0o3|;Xij9#nFwAP(Ljoth)gLI zh|FjyCo-o<%2`k=;Vh~3@7$cog0m95G9qh=nurEbC=l7uQch$`k(9HeR>Fy?_3zf4 z$dY3OuZ##$)I@|S6o~9;DJOEENXj`%Z~ zi=rkXe+mVn09wk4W>X~P=1?o)0;%;kYffaw%@w>dq9BTzh=M5;h(c&7Ct@j*avZf1 zE|gk-i{?b;oK*12h~`n$L=;A$Ks2A0a-szkNx6m8O1MST&YKs`EvBWB{|J9~|B=G8 zms=uy|J8*1zodLzI6a_wJQmzi!6zhD+%k%UcvPdg2nvOGmeW!m&kBm9TqLy;E{fV; z&BU9@3bPF^n$~VEYRSb2KAC7NMNOhBDHKFk(NZoNN0F3UO|68Br}kGo%9P;?@Yh@$L=^Qf@7UGEF!C7%q{1ar38{5|>1gTz4HsQf@u95^e*vznZ-NsVi$} zGOgKM)tXBYe6oh7QqJ7sE>ioe{`{W-$eMnM z9@1RilB*Ydvi^LTBAI$LcZEWs=~rnfSH4D(l)Fx?gu6lQFS1(hCf(Ou!iu{k_+%2d zDH0@v^ptgKDGZnjr=3q<&@kLisW)nDUx!}sFiTfsr~QyrKv2x31W<=#;%;oejG-<$PEcFcXCRhlc=a32MqOz9Ivf|8IXbB*+iyj7nmlB<28 zNXmVsR>FOw_P@7Eo;7pdX@%xmw%iZFC*;oDPl{w((VU1btO%`YK})$#ONykN0<{uO zky`pJSE7Z#EQRKjDKzqL2DIePVLV<|C6T4^PpC;{jLAp|Cg*wwhSy^ z0Or(X)!O`7?N^yJry;AT`Dex7$fr3i*)eVZJm!DNs=0Qu`r3ci|J~f0YcD&n!=DHK zq7`ObM_I*Ae^&fOEB-pTb2_qPI{$ghFIw@(7|C^!)$jUe{a>`=KSmf%S9V~xKM(w$ zODfB}x$d(4dVlV3mVa~lvb{b2-230MaIUAUlEI&q{?aS{l8bY_WYv2Ab2T&0P*$za zpVj_LI&LJZ()W)lG##IGNREGH4#ZD6o|&qQcg6MA}KeHS_wCv+P|gRR@U4E!7C#Y-V`JvG z`?plv%7*h3yfUJh6g3geqEI06r=^@IfFdb3n_3AshuXiT+E%t)px~7e&84V`D2PIV zD43RVq7aIt980Z)q`g$iC7k(8n)qInbwL}9d)6V0bc$}ON)!Y!osZ>hGm z8MjFA%7_+I)I_v|LV+lpmU5z{6w%C%S_v0H?cY*uYjbY7;FS@rps0x`l0tzfik5Ps zXo{p<47Cz2mfF9i+SV4_O2I25T18P4Q5=N=(P~=CiQ*}eatYK*xHZ)NE!DQRE{O~GwJJ9AE{T<61a;~tH1mT z!AxL0@al$;LW_j$*Ni$M+dmka-n@GG1P06snoHj+yEs|>h4gQ~armdN)|Ns5_Vd{% zw22~N`*i@CBFClxrZ1HG1q<()U7XPWneHDk1qMi^fqp^^(db@hVXao!ejS6l$l))) z>KJJ1;>7%41t1bd*#FZeM0V(H_D6jhm9YI&WQKo@%*@59=Wj$tDgW^!=ogJ^)mfj` z61LygH~&3-{cgt?QDD8@vFlxM*m(n7vp^g5y1Nd%Ey7Vh9eZMuE5&C6x9}l-i($Wx zG5PUGjp)}#@>*mTL@XVIwQ^T54wY)mqK=(#`zT%9eRl{JotM~+IO&M9=e0y1SGbdg zdy!1`B|XBl{(`QImf~sSM5J+O5T4Z48yjt7k-zsKh>ubu9_r7SmfO0Ln(uAFXl4iG zdT26n^*9QTV}}#vC-ceubUWN2?nibUP{NjdQsG8GG#aaz3sp0N`R)xK*kqzV7R42p zN1Z#3rjPK(BL129{@T9SS_auyO`=ExrRahh1^Yc|A#Ey$&AxqySkik3#j| zr{V_Hp`fuj5bNjdgW}^|NJBw1U##_>H#L0%qW5bKHh3OH5sxobl%C6nnh8$G+I}|P z(BS~`=w8d$)Sp6c%Ua;GcA7*#mhjV)gK$+{YyL}H8^ZHPpnR+&NsNDq%BqUdx_;fT z{*bT0Pf{lLk47PnBigt@SB*EykAf(_2sqg@9Q%fqAWzM^sAfe^WV7T5#9y=_W6je* zq&JIseKdrK_KxL44%?u+Hy4rD%M*~$zsf%r4wv2f^!ER!{-yla{%zqx=PZ*ZiFR^g zji($=3mt^x9Y2HjN-17Y9)cJATuh2puE_Y8EE)UoU-w_j-|N43J=ftYC+85OS}P)6 z*n@mgD*hIg}%3zE~OPqE(m8?PLP`!O6ew^AC zmwsD|Zub*mlV=uK<%m65Y|#z-dHE2uUW0^;RmW)#o}{E#Ai1?jgTH^0B{!{|@xC?& zWKVr8#8tTy#o!F&5_A(BcZ|ks`wd5@?;GMD8FTT&+p*-efje$-vVbrvt;y~0k8R(S z>>(zflkj#eO_FXFhxZKI&O2=}C6grH#DiT8opoE{Z`NCgPNF9MymJTHXKaPsA5S9d z6HCaZV}ZqOq} z>I>dGNAQYfJ+OCq74t0eBpSTd0nfb?i__a{lPQu%@IX6)ls=k+UuYL*~yB_m!^@t<0HsW@*a`{`e8kDb?jo~!S|iDg`B%M5kH%n zgJS!JqBeOCP+j}w==Ib|L~&px`gtb-pWK;%L*^~V>%=Q?jP8D>b|!*`r)zMOh_`d@ zkx((;au}Jo;tc9F%nP+|ABEc3>VSE2G+sZqFa9Yyh^F^@#56vn*M|d8+_{C!@7VwW z2_CphL@1oS)sE>{_68m(Z9|`5ufi=aEa1<4?n$~aO4uiVIv!#eiRK@E1Nrx-pyX8= z@G7ST-afq;8Db`!J8ef~7OP*$w z;6oXir0pwLyjf`+_V_xBOx?0dJY?BA(&2h3_EWWj@8>r$uA4mZ=1C$_)g=msp6)>W zPzm3myE8G)h#=1=CZJb017OtRj%dR7Z6sv_gYWpZ!n59Gkoxop!t1O;PmCtus~)-d zq=FfF)-js&dzeb_fev`-`K?44zizIY?;uj74@bKF_V{HbAHRN#YDr#o7LlbR>``*4 z2hP{YC(kZQ$<(hek>#FJu<`3a_UVqt@B1ErAF3|U&S?QLRGdPt`DhWtBc9Cr4=Kd- z!#+lJ{1IMn&JB28-4bn6A41P|*g09{qVtV2g zvboyR?W1^3s|!%Vd*v2+@Ub?=VGqR3el+2gYLE8_PsqHH^?Ibnfo`}`eGa$>m81(o?qr4GJ4ohTaOg%yY)=luXGjdu3AW(jWKVpiP`-j>PS~1Bu~N zeeATWKar+>gvMKCDABl(Dc?2-yVezhbQK_ztsK6gYCy_{XaaL}0dZLSnJIYLjyRRi zBxI}?F`eR%bYnBYzhDuvNeY5pFVt}Vd?)e_e)-_wa1V*f=9HJ7--og~F2%zqkHFT8 z24YjLJtje|@WbJL*t=#sD&IYp#EZ{^Xi<3ijlstFJe^~#Y@tC^U#>(qo_i4e>n^b2 zX07c088+fTpMO1nv6bIHF6$>@%Z?pM$aHs9*sTv4`)LWuwbLT6FI@r8SHUv=hbwxo z(x<&#*nWL~wh{II>-@-!rY1f9_XJ?G|9Y|@b2I)tA(}jUzm3o7pNJDz48j>LQ{l~r zt@uZBDzUJ8!ryX;RWj5?kE_tAK_z{WNhpofX{YSgbJHF z*yLM{xY#eCV=*69ZZt#V47%VUmc4M!r2U}m^$E?-V^HFS99(+ZiAXG2l=ql}Ha<(p zJ;kB;^#&8t*0F*&v~7=lo(;ldmk+^(+cJpz3w_e>xqicHzGBQt{~_+sK*k+K@47KkD530+V**7{764GTAWDlDur6iY^%L zgNFJAWbZN^au-{Yb%XZ9qA4wb8*>YJU))T__uqpL=d~lN>&HX4-Rdawcslko=!knh zU4(~guOYqsCXtubA_z4t!X1L9;r4+m_`nhRBi3k4kGVQ z6#-|hMC?wlCf`pM;`5205qZoKFZ&f_X5wM68LtENqc)OEmvlTz)d*WIuq1H-1-$iv zRb-4f4JUOQL6)^iB9~rn!0)%U!k<_5!jliT7bmP=LFa?1T-Po;%I*FIOfVdPt*fD~`K3bk6 zJ8}ql;9mf4h7<9Vc9EpVtr`^jc?D6LnhqQ8B82!Aci zB6<%BuyyEjIB`54U;T>l{I2n2Kuk+4mApjrCjNvwp^oHjrWPJ-n~zR?uqG3>9f9Go zV%hv9K6~-p|9$?_Mx@kie4z^rEku)Un|2`5N^A15=OpCiTnP1&IMVs~F3@Z@4Grj? z1XUsqYnncXZvmt5v!A)x`;rE~WLF;Un=zIA+_Q?L^;RGa*{iXhRx0+4yMdzM2pTwD zhn)Ntj=$}SA@3*EqmCwygpcWnABr0ox80-2-85w~E^roBx>;8tJm1~Uc=w5*W23PB z)A-mte!4(G<6m!mhaa(M3}Z3i5jJ0@Qe_e2S1IvvtbF2l5btYu6Hg6aVc+8JcCzHV zi~YM^lPibXU#=|ZZ~=X`I*BLO#$eOitL(@1U1`5)!E@5SXKrPIe=Y8;*tyb%Gpjsv zG>TY1++V4)$DquW8)|D!9;UHllW96SUSpEf`bS9;?5ne&PM(KMu5SdY{X>0$4N zIOhG>&)`wlnjG6rk6&qmYhEaku(=HJ=sp>Xo+gO1A1*{o?{&pGgSUgt@{4H1_V3^y zmxqeGJmpgyhT;sX1$cOw3C=LoAS>SKkf-xq@mbF|C@pya>XNHW$~GsVo;lXoy59&= z9ifJG4IV;JVLx26dI83R`;q$N4!B`!E_89xz%dS%BzyW4yp+b^(54;i{n(v29iD;B zeL3Q5^c>Bc+Krf=-_NwVK8jqqvlyK60&%@qsH*!l`Z`J961)7GQM(brM;UW0Ii zWqYP)ydG93`b7WBDB|q;3jAa0p|D3fih5B5z7=}J^r#=sR`JEE>Vrr_m@4caJ%ng= z{J`W*9zbID+Y^nR8hEU>6DcS!hlcfeeEiRPm|i&^_gplKymXk3-_JOQJfbI}z)~f0 z<@RWt##^9^K?%^{wSl*JKNUFr@gzGX8P2Z#!9RB$jYER2q4wjteI8vYdh~XN@9>L!*#? zPFpa!H4^vlHja#CZOD7gje|^JaQ_oDvDtuYqo25ZGMX4=$&Bih!F~;Nf%pxM>jn3=okfliuIHF%NS~<`TiOdWuL;+9AXSbP! zbr0u3)as9@cH9ais@ElHYCBOcLwZjrj>GpewFsx{Na9;aalbHaY`1GR&GW)Z%sm}! zY7ot=yEgzYnQe}%Bx{i65d%{AtPK{%kI6x*r~du;O&7T6_>mpcnZKoIg1zg!`PYpL z@oN<+JicCwRDX8Bc6|q8qmtLKpvIs0K3@*E5GG8UFA$L~f~xiHc#py@vh}rlllyFN zpkuGF{r>n%6JV;ZpUN_2nypEDQyr}Mz7kY>6`^YrwMax(l30I>JFZSK!By_5;*fzs z;GNPH@n^ac&w+R0M<)?(d8~`<`K8(T=Ec9)rwJ_8Z}jt)&9T)+f4qSZ z{?=fi8BJ3EFW*1ZSS}@vn{$Y3-(w_BfhUDC-N^Q%+2mtozN~FodToyD((@{8|8#Eq zHhVVHify7R%hZ&2j_-m`H`C`{w0LC}q(amZ;q9IXsUP4dyO8NKtG`aar z{X3&qknUHOkvomc$flR6WQhAZ;xsLSIMl|=+8>j0_vpXYH>bJJZ|dt`swIbFj*$Er zN66je8>Hu*>m*%TMO^9|Wcqjdttk2T`gCseoBC~@S61?(yh=BX>dJOIk5t+P?W^qd zqr5V94XG6FZRyX^1^-^3&TW2Ef8n^!RoR!ds)jw#uiBa2y(&JaQ`OIUovIV#x>gDL z`tSAW+~ha)vtD^tee`m#x>r4|DzR}|)gBmMb&q2`m1+J{{YB zQ~$vAx#Y6iNa*!33_5HMCUN8Z$Pe9lfD4Re*Z=GFP5S>{pN?(6sefTZNhLdQb!9vC zt(6^Wiz-(p7gZMQ*-{y#QXsqjW+~(T{rzW7$F|?pzkOwpy|eCI`)(&K?KemU+JAUI z+`i(WgZ;7*cCxu?&WFXF{(bxDxcHm;Th-UYoov&JkDoqQeE7Z*wtX#vYqMEi>OM&} z{@`snMgLy^_s2g4er4s}?83^fhq5X&x};ZTyjoeQ_cFEe+ptvG`A>OuIQ8G_|Ni** zbV`e=F$cA)$|BoVol0q4wSSmm)wo2pst2~MWc|NYO^M~d*0=cm@$YP@Es2gD4EZ7U z@TQYHnHw>LM1C3ubI#EBq4fUW^LF+0f3N@h<6oI=Sf!}vy2`*23oFe7BPyeUA}WtO zTUc3*m&(rnm+qzY|6c$1$3NvATPv^hj;-uykX5;}T}Gv|az^E>W0{p312bg$8P|Q? z{=NS1kAF04{r~Cx|KHaCEa({6?mXAntwbq z{>35~_`?Mf8kNzQsizr_n4u`Z)d!}3XQzpmE};SV+DKWY(Nh$>cFy^L#Y3SV)zpHM0`eZHQJQDg?I5jCSJbPQ(S%N zve@ENp}1$kCi?DeHX6oxfmE@MUw*0$=)EsN663MpsB8!Qhd*UPRxO0$2QL`|b%Jst zZ!pnH$KcZ#9rU2%GhX}6JT#_uAzHWM7~elt2TsBj#^G=citd_*$dEXck(7us*S+F@ z^l(L=`{gj17e}Ki%gf@uIgy}QHw*@TUyZbqCNWbpTOpNe){Mf`+zQ<(1T>?2GHZMI z!pp0XVA*yL>c7wu27C#I@D9sh&eagul$;8ZiYl0BMSdqH^2T%CAS9CCI`9B5;n$+lbC3B= zKbFIcYqboM>d4<~odcE;MQCtwTlk^a7kaGxz@OY{jK0u!K9+S8Aj4IeS09kZEKIsr zu5scVb7A^n)NmpNM$|h(NkL8d;vP!yU_>-1>GVcx_=k?U8N%y^mqJweH@?NoQn+ZK zh$fOaA-lTY<3uY74pG3IGu03e=Dk);D%;&Uk)iM>p;a|H{_q-;M2X` zF!t0frq2>1vpR&&{ZS={=#v0!=g_<$?IoH(jyY)g@^5 zS4X(@;UGV~|5R8(lK3_Qvtg3*WQ2w+LC4gBnZ4z9sAbnYP#EfiR%sD5@B0d7cHU;B zbEO2Wn{rDGPcxXXb+zR)-_8fcIh~*$hcPwN(hz4+U(sz_4xD+P4Q-zmq6N{lyt_gJ zGYa`4gT0&K%ZuS~$6J}{Gc6T9EZWMfaXSckA;%ckEh)(Nb1Rf}a|1$QU3u`8qWL9T zP)cwi@1jaM)&z_18fEfh-W`R-*IUBsZx8v^@oP}v@FVD&&1^92+Y61hDdY8Yukvnh z_A`^CBEf0LI^;o0VcCUGe8{dtXz1$@a1h<&Pq%R8r#e@mbKMT3r)7gc^}R9gQh1Pg zs-ukVP2a<~Db0u6b{X(>Fw0yp7zn`$x~P6w74Q9YKf0H>A4;BOqSI4$BeLcpU)v%N zwSUtKD%z=`Bd05o^@+lYw-RG0yKx*ojMxa$hdJQcmAWfx-Pg+r!_xj{~XjkWdYM?(2a`W zc6q4UB?t0G68O0+3|TMS0(ba@Fg~@6KefD=soeIFIS_jQJqdWhCyrICaI-=1b$u#R zkE_t-ep+C3q?jMpu^9X=9fFr%R#!|fUI{6cE^zSWQJ$m^6rWgJ%XjbE7uxIYMhdRi z`N_Lf;Y?XDT4rH~PLwR?EBuZi&84&9#!z6UX~e>4pEy+XtUqJuTnQgSGtdX+d?q4! z1n=e1$PBolg>HHFg>j--6m8PTkB`|6Jwgr8w@J#NG9ee%xbaN5O*$%i)tR4ujPT;6 zZb+-{0`v7-BjYk;DSG4Wg|_X!$vo8chpas<(1y)5pfr9Hx@+7Q4A@8f#OXC)K6?y0 zBbka`_Kt$&vyo_lhaxICb{K-P--=C^rqg@$0UzBekk>kKhnc10fWCjb$@IF{1w{50 zyz0-csBPUc*tj4EPDJ$M?;nhVbA!9X_q-p>nD#4}n=WqXNJt7&Yjj{7R_uTPGz%&d z+9I_{aZGlj80Ku~4u!R&P_LSNSY#Z)Y>Zrr@;(-WLgX<%`i^4xq3J28Z)pXpzq1(? za^at3-*SBg%SEMxjCPD2ke(@`J#Y@IP_2gKf(z_hFJ;O}n!!e5zV3jK6S z&>?*hI`7;GomZ+tBQCe&x3ZDEjr}wJ-HNTKg=;Vj8cLskx9EEyZ5H}|o`KqqPG?3% zrSP@BDPW!4N<6;P1!nYOj=2kfh^yPaO+Iwrb$^TonM@ey#Ds$YAdo2&Z3oZ!}IrJ5U*-(L*R4$S8vXbrMxtY;?nvqY<_BcPA_LHJNM z6RBLj&%~o0$f25t?`p@HD~_w7>y;EVdz@;;>D*!9I3NJ(KPZ6Z@(s}2@3pw#ln!IJ zEEm-dYXi8&A?R9L#qYOJM5ck+;=8TwVPB3RoV*o-x{QA;K2V&1mV}+^f$y^H${2jX|A8YN3D`Inbwf50tUQ5$^s>=IizxfY)9HNIl*I64vcRJF|cC z;VGNYLC@`IY1$xg(lJCmRjbf@;|w(1VM|5)o`bOeZ4^>p8;*uuHAf~_t6-18GrsbU zJ+tA|Hok|-N*G$3gT5aZ+bKQHgsZ12kdR-U>(kjrB>X=%y8Y7{Z?pH87V`D$H7>cx z@WouDIxNZd;HIT$@|HAoJI(-ZSGkwJToobX*FD>El0KyuwtwPp_WKbFx`y)``P=b6 zv1GCTbT}McfagEm3)gqAC+`!+;;#!b_%9iIN&4d5#QXLJRJXm1zuh_yJ0Bf|C)5ok zrV){NQPCE%)lvtKdKy6XscmM4cFMxrU$iG94*DSHGsDQ-oOal=)o#*}KZE*=3nTlg zCz7M@eaO`-ZD3bG9KO8vEez`T72SM$1tgF6Le`WLy!J&7zBa@h?=RX6d7~dq19n zhV+ZA2nln*+a7NtH?DOd76sLCu_THRuTru!#RC;Omy+3O2^9@?>wugth9mD{advGh z@_oig{Id2vA2|97ZyA)2C%+y-GT)S7_V{L895xLXEZTv`1+7KLJFX?GGL*32w?dTM zDTW+`PDG?Hl8 z3FRuR!_&9u;Jj|##L30c#Aaqmti@eH2i)=u16t} zs*l7=CT=GaPVXV7H1f!ZZqLzXuHVno8n$6D6Ex*q`(;zX)w>ClmkL-EeVm z6bbI#k36zeW(u8h@g)Nv*t1`mQ+!Q?PAAHUTf zNF)V)u>P$fsE1K18dI?q_uMg%6u553jm0eXS}++e3@RnV3-&QBt1RK$-1d0M7+aEe z*aBNC?jr70u4rGaHYs0cggyk7q0&C<$?GN8(SsK%Wa;-)NbhM&Sa9n;dN+0l?v}5L z9~V2JvrY$4iuOh{_3~c)_`nh}wc41hy0s2(3V9A{y`^Zx>~tbAEF!6)ain!)Dw)R> zlOL}=NQibfTsP+}I$$sg`**v5+AP_QvpV-6*{^ys;{aysA!w4@Ft%lkRM?ebQDkWu^^2ac3Nf zCPmOTbRDm~zXA4)Rm5e=-ykn;H8G*T!CGFl150B%VPX8bs(D2BU%!8}plh`B{oB@! zUC2|D^H4H)6yxINioU;C&u5N}z>~aVN#uBK68QZGOz(OWMCyQUU8&=ZvZCRze=}GOJ=>>Bv{DnurLrg{ zvugwjTQMA*yIch8l)bVw=97y1ydvn>C~W^UJ~khJ=^8JM|Nq(go#pTSevgLykDveJ z^*c+thWi`i|7as)c$;p6=8IBM7v1BGI6ay%nV*ZI^d>`x5*5C;;uh3VLmdi-TosRx zzb;lUPGz=gF9(HWK(B-EF;RR5Y}#4|cKt^|0DW(Nssn+n>|8LrVu1FJ%LnC8#Z2R& z(fp_K2z0%;1zoc;<{e%iMv{H)P%XnVM%@R)XM+qFo0EpgNtmdSiy7>h4#J+gJiOVHf(o={TDHco*#5zaO=@`BiN7C`fEn zvj^IRon^#c>c}tZINJ27HR|~=0>#Z;4}IF{iU<5KKu$$H&@Quj{^!{oI7H`58gueM zYj6^zA9~9;)P;h{Tb2i-O=wGI4a$%C z{H3Fr&en_3NAVW8*l{;Fd<}$mA_C!^jxlFz*CNM{7VuPW391iMV~QnZpirADKH>hH zxjVIz>Fi+24_-H496a0uuKaL>=;ceGk5V|`p9fHq)f#kc$987M z|J=v?OsQpBPF^DZFtLWYuuYXYrD*~+lV9^w2DOLpEz_CA&T(L-o?S7xt2SDky&2}d zUIimu7lV6!enq49113K-U%Y3J7X+~_A?s2!guosMy|EIA-#w<+m2?;~XbYcmd=)?P z*(_wAwgm;8pugXK<-=%%m!s5_C=j_8XQHCxcZCk;-Yr6xTYUu@=!W59->avQRpPw)W71L1rcXf8(+WVr1 z%f~k!arJm1bJPg^MWB5bzZ#}`Po{)`>ENG994~M z>e_+M%?ox~kLY^$`^E5Tcop>D&Y=t(je4IB1(Ve=sNIetDDBh^xi$0#&$DJ|;w(34 ztaU}v>fKHviIsOT9y2KJlLI0r3-i=W{BTt{+O#wu zF1?)yK5xumj(Qj99v=*g9*%;D&TY|h(>-X&eI2p2@oaGm$E|jkx@DjhQ@X*4X}Wy( zHJ9vMS9_t3R-Nx2^<5aqZPFO>wGE)wYYRXD{%#i-MghCTlFDx$EXY*CgwA7Up64)xM0+N z%R(6E7=*I#?}myQnK0*kIbD-(3mNKT&?v3;$o9k>q&Q_Q%IzJ5b~&u#SDWcVkLqM5 zj;^l{GdzfRw|!{S*8>pUW(}|WRSLS^v1p2KIy@O42M^l^pj!|0!QxmFdM7D|Sr1}i z+0VsLrM49&?AiiFpXS1ZNyixENb`I@F5c3+pJB$>A4hfzd%;7^ zD8Q|A;pLb(J~OWbwcR2?X`UB&x7RulX_&*@8$1kEIy>>9dkO4%HV;bGa}hXImoF_2 zMOSvNX8N-=Op6b@n7Qc{D7ecE&>DG-Ntqc2s-bD{!Db$coLB?VpH}nrqF5l?9x)=< zBj{an=ZaA!sf=#<9{$-)4HSD~4a`rT#Xp+NL)C#%P;zT1b9v_sl=oEu<=>r+l2ek= z{f!8Dj!TE&cta+@-5K3mppT5Kqu|8g1LDGus?3_xKbXZyV)SEqH&iz@2_5pTMB~0? zqFsx1P(g?NY`s?g(Lm_E>+)@Nn z8jaESoimxP-4F2nb$cT3nrWaFV*~w5%+M*$k7=h=fqo>lgO4#W5Swm~@{*6D11k-f zY1=pO*DF)_!G8P1;(0j`^n4(MbPh)fgSMe~Cr30<8Uv@fH@y1+DQbM2hLnbdqKxC4 zQ6^;a5l-PS{oX-wC#xOEV`wA_J=>DG;kgt#)#$;7hi#Dkxdvv_s|`r+ZXCKBAVSVl zH^I)M^x4rqnD4b9pRs?S47nj=(C9XsDo$t|;+Le|66-bWL|-NVIA^qjz{W}x)Iycd zQ314G(O6tV=#D|&sy{4cSu7!GbBeY<^x~9?kyD=#QC$ zRFjkGvo;CpJUM7|KZXKE(C4(m4<_m7Mqsx|;oFw93KdidN%yQlS9KG*_qiA?jLv{_ zts;5l;C?7|*HD;sZ89*tC%k^!4pLg{!G7E2$o=RXc-2q>`6@eLbxR4Kvn+xcJRR9> zo46DfcQ}f!eq03S=Ek6p3suUERdmIlzioizx&!>AaUxjMJ6()__Cxpc_M!7Va*&^5 zAJpPy82!5hF;ZEq4bt0t(74U@yymVbm~-ts-|3kR5>IpxcRT39R8;JTZ9{fJyY<js7sFIH1%6)d4t$I;hi(QhfF&wkE8vxMQ!0-j=UMoi3WAP5YKH8Jnfzg)cYo7u3Vi2+~mTs#hrLy>As{ zM~>q+Cmo{WQ#W)$Qv>RDWTAOos!-C?a@dz03RM?NU^l%co3vjs>XoMs?sMM@Q>-SU zh2FgxGlsyIp;sBj*TeW_V>D3Ifklv@un$x|xI?*GAuM~E3(5*fXuC_Qox$+!==t@{ zJgVL%9$s#R>c@IRQnEMP+I-ut!aIcDw>PG|$a@q@j&_A>Bp*^6^iXj7$#5ZbEl(D8 zg0D_I^m+A;S6n@t_ifyUj-H%~?qrLg)k#;ev;Q%uID42Mvv;;Ee~faY|6=anuHRY8 z|NbDS`(YTm?huSh&V>iZbNSJ6Tfun37Bn^IB)_E7Os^uaE8e>GH?sW)X?eMjSVEAl{QVm|)vd64jVZhB~fi8ddY~ z5H&AStFRvbbWSGQThudbZ5FxXw*&T@6ftx5v_wuO7@wGDjAq46AS=h};^jt0xa8~> zF!aqNbN|26&IK-}^#9}C6|o~laxbi(+m7y+^E}OlE-vYUVv~|wYEmR(v%iq&rlC+S zZIUD{so2y!-!sv&Yc1uPC0mwt8@HCUelEY6aXZhPzyH5^{g2l%US9J)pEGAZJ?Hd& z&i8Y!6{1aEbD`&$e_@@2fk^yk1bKMsc(24mS53u*ik|I9I`L4qa|TWror{aL^Pr$#C|-6h8&~;0Mn#+V<0B(> zgUyQd*gNwDT6xeHakJgXdlkY6=biA)iZrH4 zCke96yP+)=Zn$cCf9WZ$L-?S56N;Jo6S?<$CEN-8Te>*c6SvB$iL|)@M?RH+v^F1C zdu@V?@I7w5z6(y87Q=Pta;dRJ99i?c9G}e}izgaxgOd~XGUjy?aak`PIQ$mF!hz3G z8XBU<=`D{2IT0hG_r1D89sCHzVz6* z0{F}7A-Xht1x$Ik6jyWKfRne9+wTr;(cM#&TcTi?oLhL2Uke&?Y?-=i(tHN z#4boGPQm@}E`Z*SsrdAsnK(DIFL+#Cj}N;Qqhk++HQS5*;BDD7EH}9+E&azC1}OTa zyL5VpmL}&CV}EA|9^0EFB^Qu4@?s>aU4~4SZ^SOartq(VFo<7kNFw#uDZJgnTo)Ws zTw9euy~RLm+Or3IxuY*Wp5p=|BEN#{#!76sc^3&gYzBIMd$EU4K05kr9u8PG4i&K4 zHEYM1!9T?ou(kOOX*gDb@83;>H`51UgY=D1BPs%8k7#IY4Ir7<%E-h?ClGF`Qh2rt z&LWk-Og)RUcU;odu&(5Mfq}ElYL4xek~6mg&NoIY~S?{3_Y6< zca{WTz2qTSD0Ro8sCC%?)%UO_KM11Ja^M?d4@I5M9~YS)hX0Ha;~q=(VP?iE+<49o z`T7Px?DbW!&wD@qqo)nNql0mMvpeo#!!UES>uaL&LYdTSUQ)k7M~Kel3TTP2!q>w_ zqKsSz935uPnB6K>)gP;7I6X;JjE&0me;XgE`kn2&{)2_CPORy&R^;#8hDgd8>^8v{ z&p-Zxc^q~GJI?6CYCn7d6)=Rg@=JETaVwW46}8f%jX$z+VgF%`71w5$H|z!PU7Oj+ z9=q5;i=SNU?ybXr7L>Xc-HT>Niz-~5PZM@YKS%c7-RG{Yv7=mjKT2hrLQ6@P8AYt9 zrNLD>zSq9EovQi%znlLtG&w{(V|~#xqaL_?jRi!k?gojvP0~sA<6-ICuc6NCF7noQ z#y)?XM@db;Aw#QLbpM6`%i~9b-1jXyI4A~e_a`B(xCCLUM>n92SY(Oc)TpbcXn$he!ew2#sBgas82p z(!ki8B=OWb(r9o8CEjcy!tg#Qd(;%r=`{`7e;$qoho=#(;}MLZw;8-T*+%3)uf%?5 zzr~4rENgu1{$zsi4kFA+L^-3v6@6`rzO=J5L6E5ECnOJR7Hsba!+O6#5<_F`n7a~0 zx>ZcPR2%z@`;nZE4Z@xhdz`3$&ZV1~9%xNPh_Er`-YO2k+ug;(5^ogFX-ul zsy*~@UFShq6y7Fn&I*RDavP9-k&FaCegTFJFHu>LE%wRCB7HM15Xqq1jHH{4^l#9` z60IfVSwI%KyJrDu&OXmnT`?oVVcVGYgu%%2%~Z(#y*oB|U;*tl3HbWf3UXbMSyHmK zA5Kjh4?b7kB4N@^5}(qDeiyod)^}KHnCT250tY0h83~0tCsCkSfG;lFOp=X4z;n14 z3@-W(-!~r#IoAEKrGF5_uWUhD%mre&tviWdw}Ke&Jd4bqUM9u~v*2WMECe03f(=Eb zs5vEy$o!g!p=pBRHGq-0H>1oFyfV^F%m5pcZMlRx+}7f2q!uAT0V~Ig#a?!}-OY(CFxgONwLQ z{)|;nS$>7o&nQGM_2c1sbR`j)W=cf~MKw2F6R`1Dc|`m)pO}g&&;&)jf8@3EXxO$| zRGA$H_2)$-Ke9wB34csl`}Bdjmb*lNJW)QLit8VQW06rabIZySHk_y?RR(>qxTgcQ zc)CcD<77!3Z^tV7AstcDFn8<|UMn3rtBGvDgGs_wcU=7Z8#q&WjFkT{3POy|k#Q$Z zpaqvZp|%5oASfI{WQ7l;mF4!(ti|BU1;(&sl`fPeMxl_lEoj(k9gv-fm71@biC!+A zfP?q-!a1vlz{q<>AS<$CZq4uq=G$8+e@-?sjPpl#+Y^a!CPR)p38DT)6EoL&9%RQY zhxqFGI50|&cuvjxo6l1S)?fCfnZvH1|L6?V*PS#w%rY;&)?B~i_uspBc3^xny@-{U7b$L-!njpvF+&W;k(1VsRQilb z>LkteJKld(+VUG~s(p<8)m9Nx4Otq z_O_9Yt8$WEWw1(r`lJ)Vn(KGG|LD6n1kUZqgT;D^b@paRROE&rlO0e}n5*(X*&d>K z|C3$E`;X4dzQDdNCv5s1mepG#W2*{Iu<<3eY}y7^_5EjVk!frG`4wYZ2m7xEAMWp( zYCX=?r9tEx>dm-54^sqD<+`}Kt#DCYo8GvR-mI~{eaHKcF6}=Dw@VUXqAU?!zuXF1 zBo~e~t%iKh^{V5)@$%Ppn(KFb{2O>Uovr&Noel1u%8vC+XAfRVU?+Fmz^=DTR~`SM zKV|%>xqipTznd2yv!OAM*!?CiS>2S!tnli2_D1`C*3;*)N`JuY63zRs>^naG`7Nx4 zbHjH78u2}3bjpH7zS|*Y=N5RJvrTpUdkKHKqxt9W`1lumYBL+rxQR_%naLIxXR?NZ zjjXY4I_ukeqw4eL_Bb1EtgOo>_LA-Z%62)=#)I%bTmP-t!M=;Y|+WN$yl-oe4aNhq{&vbME%u(q>x5Zc+>Ix1G> zUat79`mFMi#LCrYqPB8}KR)?*HYb!=8N^O6^mCBaS#JEW83q1(pw@>^Oote&Z-N^j zY));W;nOB~sm1DB;YI)}pUC`a@f-AEN9KHp9#)6BDZR=k?tWS>e}q+En^2wP_Sey5 zjO7Q}cXiH=c3e$(FzH-CsmB{nq5vk^CXghqXAX_V(9ZfXdPN*rmFXC!Xm2aO7x zXq4w9Zq5gdO4LxEmAFwHGQG%8m^d2Zt7G|;FR(W*Q*aU&LJRIY~d+{8^s zpiwcVRe5gW1{=_*Tn**9iJM74qhdub`KNR3SJpf?apMGNRIY~d+{8@+pi!}iQnlf^ ziQB|aqjEKr=O%9dJ&lULrd4@v;+`~URIY~d+{8U=&}fVst;%x~x0!=RpQxccH*xzk zXw=7tR^_>gdkZ#=mZ_mUH*xQNrcuE(T9xOf&mZA>HI(P3&mUpobV}8h=O*rSJH5kY zYADZ5+?jM570jhod2ZrPlF?|48p?AMcYcaS>le_fJU4NthGkVbiK;#P%e)F*;Q zd2ZqsbZJzwh(>vC;?`nmR1i(0JU4Mmurw-BLwRoER!M2}B8}Sd+{7(#(x^Cw+F?7M zo4B<}8kMV|JU4O6iZm)-Osn$T#H|R@s9X)@xrtlMqfzk^T9xM}ZXJ$BJU4Oc9W*Nch`z6+sQ{a{Iw@Zdq$vOX@RTHd R<#U3xJQaVG?|=8+{{pT8fPnx2 literal 0 HcmV?d00001 diff --git a/tests/fixtures/query_baselines/qto.pt b/tests/fixtures/query_baselines/qto.pt new file mode 100644 index 0000000000000000000000000000000000000000..f228a4ca8bd8c95d1990e4835611c80438e922ac GIT binary patch literal 7814 zcmbuE3w#qr9>=#2+L8jI2((xpB1(`_vPqh>LbFhy1y-d5fgDu(Bt&vBmu=k1@S<|C!Q#GidInW{M?;-aP!~EV>cBfxcTg7cW37N z|NZB`GqW?3IzA_tVG0VEZbvU>00WY5tkW*p%lr%6HPsg}^ST{v*{#56Z5I$c>CEMVsZrl3R65KCgTukHjYigBDtDGQ36O2e zC&eKo1YAN8a#|r*Ys)4ntRH&t49~PfUKsM_B)uOBFp19&L(ed1#GAfLnMw8Nk==w`B_$$o6+ZL15g11&}$*f?tWd|U5$VnA@) zC6~_|gsFV4tp`bU*n_0Zw0fA{3cS`vnm6OMdjz;zt~zPbaE)9pDA^?eu5~zkZnxl& zZD?i$oI*fwPIfsY4a^v2g*vURA2A?!8U?4*B<%fu4Yk!nGVSpaEN6MA<5+q zY8nDUW60%pHb{au=nFI~)N8=1)ym-vl9Kjj0cKG|Q{(p8rCBsl1J~KIh=dMi%MLpH zA(+EgNHBLMiBdja5C$7xz-NWwS1UzyX`TevTj7Ruzu1Id^&*iKXNlA-3-iS}{4fa` z&|EH>yOEl+Q*(_HIIQ3dwSr*lN&IN=2$CH;Jv7O3%~~5tWk75Nmt2{JLLf*24lR6E z(54|-so=nZR&a}Q2EMdZMwt#gt>FF1EEasN;Fq&P!A4si0UbVXldBn^6#`n>DM<_n zLDA=SLa>(Gw&Y0d=8JE(^&us_LbLq(8-fnITL7tcLVPF-$%cXs9|3_>ZlPA}p$d#1 z7LmZ@OR!jub35FG-F*oS%FPn|+6t{=feJCeQi|LXN7@j%l_JX|SZ;+CVxbB#LOVsm zaU_DsZ4_B4!R=O9CH7Gv8?vh}Q748-Vt*B4hV>M=KaTtkkq0QUL4u7|cu*`>Ar}*Tu!S;P@WIm$IVF^CA!rw%LnlZyClsOV-K1Jp;${dy8?^gInNbZ4lXN%n-cpW#v=V}ub z@C7lkTY_U~BA1L<`4RY%XUPp2>%XF=x+M783dckCP+1+HU%*~JJfbHZ70gP(06UZU8fmnv0Ld4R*Jy+3O)+m6~dE z%3`-E&RG*oMs$E%1jn%L;(2BVdNY$`2O4jZ1Rs8AYO1;O)lE3%c1e<3Kp)zxJ}btt z6VEgIpkb<$v%0amnrh20binY|My~dayJNdg*kZd_A9r}qrItCjE{J`-HWFjr-DKI} zFhq|A@3A;r_Hz3>_i_hPi?lI;g&e*ucvZ-Ir&WSCHEZ=*U zS+0FE91Bl*jWfP|TeNBY$sPSlk5|n(R>TcyYq#{ztLHik@8mGDB~OnU{|SjIo@a}! zHWgX6rh3FVMYf=K(S#|!A7iykr*WDrZ|ul7GcDQHPhww;*%~`FeOlCbC>$I7#fI<{L(K@DeJ`z+VFd`I-#kF%@H2d}qWdbB>aTKgFH`SGDU&AB1& z<0GP!=w{CnleHc~e{&sM*J zRQ>cd)wy#02ttlF4$qbi+b#5&VFLfXMYjFnRAWsENyPJPwo6mC4K>x;bBZ1I0n|JE zei1igTprP;e#~iUA^xCVe!<-@J+v-EePbs2s6Dm%5^lwkS(YzPEag1gf2>+oSZ^u1 z>i#O!pIh?wqzv`TGttL-qOR}A$CjQ$wvB&e{eDYJ$8c`s>1+$?|7)N5XomWxO!d(R zJe2PrpHY9!rsAhF)Hk26{={!es!%s^pnm(HEt50UuQ*@*gl^)B`o|Xe+cMOz%v67) z?qSOt3r~+v=q9eH@6D}R@$>qH%;;4AW65V>%fM(@p3pA3K*>eK$G9RIQXCA?~}R&&-@waK|bB7LiW zbCr&zz9!P}dV{8alEvpMZhk%9x9}+yUwrzx~y~?d4i7niJbd3-ledMsZ@K<;UX?(!TB1)?6N0f ziBIaIEoTfjf?1`qaWH01`i7;qpPH-6PgoeeUm5e%d&2y0CtsGd(X+OM@NL|G0;Z&$ z-6vm6*7uTprJaQJpSn^F?DM&IY`(fL*}lc|%yZsC#w>qxldD?8xqfpKYd^diG^luB zL-XvPUw;l_OtNAb?(U5Zl8tt<0$xJ5&s@%$YW;aQ!0L6CdL3)jRhZaHW2K2TvnJMH zU@OdeqtR?EHyQL520d#)FC()@y^nth;919Kp~K049+W!*xOJ#Ll>bAdlghS#w7zcm)%TUMX<(0@Go6v#1Q&Sw`Y6c1|?HWepsHC{Xe?C@+klS literal 0 HcmV?d00001 diff --git a/tests/fixtures/query_baselines/ultra.pt b/tests/fixtures/query_baselines/ultra.pt new file mode 100644 index 0000000000000000000000000000000000000000..776436b234e1c14ff59bd7eeaef06bf805faa195 GIT binary patch literal 1434475 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

#$7AAW8r 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

Eo(- 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 x0T4}OA+Fx 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 Mq7yn?%F3rqyWj3C#t7BIER`JkZ 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%0A0!I4?Zmqo@s`A7;Fd+OAXiPe7tT_854}NBI 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

Y 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

?=txt>Du+JYZnf-=8X49F5ml05|e2HT&*1=wp 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

K-?nDFI|7fd^ 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

INm!>WpLe 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 LpFjU!Kl^_G_Qj?C literal 0 HcmV?d00001 diff --git a/tests/test_inference_kernels.py b/tests/test_inference_kernels.py new file mode 100644 index 000000000..d445d3232 --- /dev/null +++ b/tests/test_inference_kernels.py @@ -0,0 +1,312 @@ +"""Device-cache isolation, exact kernel scheduling and host-synchronization checks for H100 settings.""" + +import importlib + +import pytest +import torch + +from dicee.models import ULTRA +from dicee.models._inference import cached_relation_batch, float32_precision_backends +from dicee.query_answering.engine import AtomicBatchCache, AtomicScorer + +CUDA = pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA unavailable') +DEVICES = ['cpu', pytest.param('cuda', marks=CUDA)] + + +class TableModel(torch.nn.Module): + def __init__(self, values): + super().__init__() + self.table = torch.nn.Parameter(values.clone()) + self.num_entities, self.num_relations = values.shape[:2] + + def forward_k_vs_all(self, pairs): + return self.table[pairs[:, 0], pairs[:, 1]] + + +@pytest.fixture(autouse=True) +def execution_settings(monkeypatch): + previous = torch.get_num_threads() + torch.set_num_threads(2) + for backend in float32_precision_backends(): + monkeypatch.setattr(backend, 'fp32_precision', 'ieee') + yield + torch.set_num_threads(previous) + + +@pytest.mark.parametrize('device', DEVICES) +@pytest.mark.parametrize('storage', ['cpu', 'model']) +def test_atomic_cache_placement_isolation_eviction_and_invalidation(device, storage): + values = torch.arange(50., dtype=torch.float64).reshape(5, 2, 5).to(device) + model = TableModel(values).eval() + cache = AtomicBatchCache(80, device=storage) + scorer = AtomicScorer(model, row_batch_size=2, raw_cache=cache) + pair = [(0, 0), (1, 1)] + expected = scorer.rows(pair) + saved = next(iter(cache.rows.values())) + assert saved.device.type == (device if storage == 'model' else 'cpu') + assert saved.data_ptr() != expected.data_ptr() + expected.zero_() + reused = scorer.rows(pair) + assert torch.equal(reused, values[[0, 1], [0, 1]]) + reused.zero_() + assert torch.equal(scorer.rows(pair), saved.to(device)) + scorer.rows([(2, 0)]) + assert tuple(pair) not in cache.rows and cache.used == 40 and cache.peak == 80 + with torch.no_grad(): + model.table.add_(1) + assert torch.equal(scorer.rows(pair), values[[0, 1], [0, 1]] + 1) + assert list(cache.rows) == [tuple(pair)] + + +def test_zero_budget_and_invalid_cache_device(): + cache = AtomicBatchCache(0, device='model') + cache.get('token', [(0, 0)]) + cache.put([(0, 0)], torch.ones(1, 5)) + assert cache.used == 0 and not cache.rows + with pytest.raises(ValueError, match='device'): + AtomicBatchCache(100, device='cuda') + + +def test_same_relation_batch_shares_storage_and_mixed_batch_preserves_order(): + values = {0: torch.randn(6, 8), 1: torch.randn(6, 8)} + batch = cached_relation_batch(values, [1] * 32) + assert batch.stride(0) == 0 and batch.data_ptr() == values[1].data_ptr() + assert batch.untyped_storage().nbytes() == values[1].numel() * values[1].element_size() + ids = [1, 0, 1, 0] + assert torch.equal(cached_relation_batch(values, ids), torch.stack([values[key] for key in ids])) + + +@pytest.mark.parametrize('device', DEVICES) +def test_broadcast_cached_relations_preserve_scores_order_and_cache(device, monkeypatch): + cls = ULTRA + torch.manual_seed(11) + facts = torch.tensor([[0, 0, 1], [1, 1, 2], [2, 0, 3], [3, 1, 0]]) + prefix = cls.name.lower() + model = cls(dict(num_entities=6, num_relations=2, **{prefix + '_dim': 8}, + ultra_num_layers=2, **{prefix + '_query_batch_size': 4})).set_graph(facts).to(device).eval().requires_grad_(False) + queries = torch.tensor([[0, 0], [1, 0], [2, 0], [4, 0], [1, 1], [3, 0]], device=device) + module = importlib.import_module('dicee.models.' + prefix) + with torch.no_grad(), monkeypatch.context() as patch: + patch.setattr(module, 'cached_relation_batch', lambda values, ids: torch.stack([values[key] for key in ids])) + expected = model(queries) + cached = model._relation_cache if cls is ULTRA else model._initial_cache + before = {key: value.clone() for key, value in cached.items()} + with torch.no_grad(): + actual = model(queries) + torch.testing.assert_close(actual, expected, atol=2e-5, rtol=2e-5) + assert torch.equal(actual.argsort(-1), expected.argsort(-1)) + assert all(torch.equal(cached[key], value) for key, value in before.items()) + + +@CUDA +@pytest.mark.parametrize('dim', [7, 64, 128]) +@pytest.mark.parametrize('reduction', ['sum', 'min', 'max']) +def test_one_warp_ordered_aggregation_is_bitwise_equal_to_four_warps(dim, reduction): + pytest.importorskip('triton') + from dicee.query_answering.methods._ordered_aggregation import layout + from dicee.query_answering.methods._ordered_aggregation_cuda import ordered_reduce + + generator = torch.Generator().manual_seed(17) + # Hub, empty row, repeated edges, non-contiguous states and broadcast relations. + edges = torch.randint(10, (2, 157), generator=generator) + edges[0, :100] = 0 + types = torch.randint(3, (157,), generator=generator) + csr = layout(edges.cuda(), types.cuda(), 11) + states = torch.randn(5, 11, dim * 2, generator=generator).cuda()[..., ::2].transpose(0, 1) + relations = torch.randn(3, 1, dim, generator=generator).cuda().expand(-1, 5, -1) + expected = ordered_reduce(states, relations, csr, reduction, num_warps=4) + actual = ordered_reduce(states, relations, csr, reduction, num_warps=1) + assert torch.equal(actual, expected) + +def _single_pass_rows(): + """The previous one-program-per-row kernel, retained as the bitwise oracle.""" + import triton + import triton.language as tl + + @triton.jit + def rows(S, R, B, O, PTR, SRC, TYPE, + SB: tl.constexpr, SN: tl.constexpr, SD: tl.constexpr, + RB: tl.constexpr, RN: tl.constexpr, RD: tl.constexpr, + BB: tl.constexpr, BN: tl.constexpr, BD: tl.constexpr, + N: tl.constexpr, D: tl.constexpr, FEATURES: tl.constexpr, EDGES: tl.constexpr): + row, batch = tl.program_id(0), tl.program_id(1) + feature = tl.arange(0, FEATURES) + start, end = tl.load(PTR + row), tl.load(PTR + row + 1) + total = tl.full((FEATURES,), 0, tl.float32) + for first in range(start, end, EDGES): + edge = first + tl.arange(0, EDGES) + source = tl.load(SRC + edge, edge < end, other=0) + relation = tl.load(TYPE + edge, edge < end, other=0) + mask = (edge[:, None] < end) & (feature[None, :] < D) + state = tl.load(S + batch * SB + source[:, None] * SN + feature[None, :] * SD, mask, other=0) + rel = tl.load(R + batch * RB + relation[:, None] * RN + feature[None, :] * RD, mask, other=0) + total += tl.sum(state.to(tl.float32) * rel.to(tl.float32), axis=0) + boundary = tl.load(B + batch * BB + row * BN + feature * BD, feature < D, other=0) + tl.store(O + (batch * N + row) * D + feature, total + boundary, feature < D) + + def launch(states, boundary, relations, layout): + batch, nodes, dim = states.shape + output = torch.empty_like(states, memory_format=torch.contiguous_format) + rows[(nodes, batch)](states, relations, boundary, output, layout.offsets, layout.sources, layout.types, + *states.stride(), *relations.stride(), *boundary.stride(), + nodes, dim, triton.next_power_of_2(dim), 32, num_warps=4, enable_fp_fusion=False) + return output + return launch + + +def _hub_graph(nodes, edges, types, generator, device): + index = torch.randint(nodes, (2, edges), generator=generator) + index[0, :edges // 3] = 1 # one hub with hundreds of chunks + index[0, edges // 3:edges // 2] = nodes - 1 # a second hub at the last row + index[0, index[0] == 2] = 3 # an empty row + return index.to(device), torch.randint(types, (edges,), generator=generator).to(device) + + +@CUDA +@pytest.mark.parametrize('batch', [1, 3, 5, 16]) +@pytest.mark.parametrize('dim', [7, 32, 64]) +@pytest.mark.parametrize('dtype', [torch.float32, torch.bfloat16]) +def test_hub_split_rows_are_bitwise_equal_to_single_pass_rows(batch, dim, dtype): + pytest.importorskip('triton') + from dicee.models._fused_message import HUB_TILES, csr_layout + from dicee.models._triton_message import distmult_sum + generator = torch.Generator().manual_seed(batch * 1000 + dim) + nodes, types = 97, 11 + edges, edge_types = _hub_graph(nodes, 20000, types, generator, 'cuda') + layout = csr_layout(edges, edge_types, nodes) + assert len(layout.hub_rows) and (layout.hub_first >= 0).sum() == 2 and 32 * HUB_TILES < 20000 // 6 + # Strided states and a batch-broadcast relation table exercise stride handling. + states = torch.randn(batch, nodes, 2 * dim, generator=generator)[..., ::2].to('cuda', dtype) + relations = torch.randn(1, types, dim, generator=generator).to('cuda', dtype).expand(batch, -1, -1) + boundary = torch.randn(batch, nodes, dim, generator=generator).to('cuda', dtype) + previous = torch.are_deterministic_algorithms_enabled() + try: + torch.use_deterministic_algorithms(True) + actual = distmult_sum(states, boundary, relations, layout) + finally: + torch.use_deterministic_algorithms(previous) + expected = _single_pass_rows()(states, boundary, relations, layout) + assert torch.equal(actual.view(torch.int16 if dtype != torch.float32 else torch.int32), + expected.view(torch.int16 if dtype != torch.float32 else torch.int32)) + + +def _sequential_ordered(): + """The previous one-edge-per-iteration ordered kernel, retained as the bitwise oracle.""" + import triton + import triton.language as tl + from triton.language.extra.cuda import libdevice + + @triton.jit + def reduce(S, R, O, PTR, SRC, REL, + SN: tl.constexpr, SB: tl.constexpr, SD: tl.constexpr, + RN: tl.constexpr, RB: tl.constexpr, RD: tl.constexpr, + B: tl.constexpr, D: tl.constexpr, WIDTH: tl.constexpr, KIND: tl.constexpr): + row, batch = tl.program_id(0), tl.program_id(1) + feature = tl.arange(0, WIDTH) + start, end = tl.load(PTR + row), tl.load(PTR + row + 1) + value = tl.full((WIDTH,), 0. if KIND == 'sum' else -3.4028234663852886e38 if KIND == 'max' else 3.4028234663852886e38, tl.float32) + for edge in range(start, end): + source, relation = tl.load(SRC + edge), tl.load(REL + edge) + state = tl.load(S + source * SN + batch * SB + feature * SD, feature < D, other=0) + rel = tl.load(R + relation * RN + batch * RB + feature * RD, feature < D, other=0) + message = libdevice.mul_rn(state, rel) + if KIND == 'sum': + value = libdevice.add_rn(value, message) + elif KIND == 'max': + value = tl.maximum(value, message) + else: + value = tl.minimum(value, message) + tl.store(O + (row * B + batch) * D + feature, value, feature < D) + + def launch(states, relations, edges, kind): + nodes, batch, dim = states.shape + output = torch.empty((nodes, batch, dim), device=states.device) + reduce[(nodes, batch)](states, relations, output, *edges, *states.stride(), *relations.stride(), + batch, dim, triton.next_power_of_2(dim), kind, num_warps=4, enable_fp_fusion=False) + return output + return launch + + +@CUDA +@pytest.mark.parametrize('batch', [1, 6]) +@pytest.mark.parametrize('dim', [7, 32, 64]) +@pytest.mark.parametrize('warps', [1, 4]) +def test_scheduled_unrolled_ordered_reductions_are_bitwise_equal(batch, dim, warps): + pytest.importorskip('triton') + from dicee.query_answering.methods._ordered_aggregation import aggregate, layout + from dicee.query_answering.methods._ordered_aggregation_cuda import _schedule + generator = torch.Generator().manual_seed(batch * 100 + dim) + nodes, types = 61, 5 + edges, edge_types = _hub_graph(nodes, 3001, types, generator, 'cuda') + csr = layout(edges, edge_types, nodes, relation_order=dim == 32) + order, hubs = _schedule(csr[0]) + assert hubs == 2 and order[:2].tolist() == [1, nodes - 1] and sorted(order.tolist()) == list(range(nodes)) + # (N, B, D) views of batch-major storage, as used by UltraQuery, and broadcast relations. + states = torch.randn(batch, nodes, dim, generator=generator).cuda().transpose(0, 1) + states[3, 0, 0] = 1e30 # cancellation is order sensitive + relations = torch.randn(types, 1, dim, generator=generator).cuda().expand(-1, batch, -1) + oracle = _sequential_ordered() + for kind in ('sum', 'max', 'min'): + assert torch.equal(aggregate(states, relations, csr, kind, num_warps=warps), oracle(states, relations, csr, kind)) + fused = aggregate(states, relations, csr, 'pna', num_warps=warps) + separate = (oracle(states, relations, csr, 'sum'), oracle(states.square(), relations.square(), csr, 'sum'), + oracle(states, relations, csr, 'max'), oracle(states, relations, csr, 'min')) + assert all(torch.equal(a, b) for a, b in zip(fused, separate)) + cpu = aggregate(states.cpu(), relations.cpu(), tuple(x.cpu() for x in csr), 'pna') + for actual, expected in zip(fused, cpu): + torch.testing.assert_close(actual.cpu(), expected, rtol=0, atol=0) + + +@CUDA +def test_hub_split_handles_graphs_without_hubs_and_empty_batches(): + pytest.importorskip('triton') + from dicee.models._fused_message import csr_layout + from dicee.models._triton_message import distmult_sum + edges = torch.tensor([[0, 0, 1, 3], [1, 2, 0, 1]], device='cuda') + types = torch.tensor([0, 1, 0, 1], device='cuda') + layout = csr_layout(edges, types, 4) + assert not len(layout.hub_rows) and (layout.hub_first < 0).all() + states, boundary = torch.randn(2, 4, 5, device='cuda'), torch.randn(2, 4, 5, device='cuda') + relations = torch.randn(2, 2, 5, device='cuda') + previous = torch.are_deterministic_algorithms_enabled() + try: + torch.use_deterministic_algorithms(True) + actual = distmult_sum(states, boundary, relations, layout) + assert distmult_sum(states[:0], boundary[:0], relations[:0], layout).shape == (0, 4, 5) + finally: + torch.use_deterministic_algorithms(previous) + assert torch.equal(actual, _single_pass_rows()(states, boundary, relations, layout)) + + +@pytest.mark.parametrize('bad', [float('nan'), float('inf')]) +@CUDA +def test_deferred_device_checks_raise_and_drop_rejected_rows(bad): + from dicee.query_answering import QueryAnswerer + values = torch.randn(4, 2, 4, generator=torch.Generator().manual_seed(3), dtype=torch.float64) + model = TableModel(values).cuda().eval() + with torch.no_grad(): + model.table[1, 1, 2] = bad + engine = QueryAnswerer(model) + with pytest.raises(ValueError, match='finite complete'): + engine.predict((0, (0, 1))) + assert not engine._cache and not model.training + with torch.no_grad(): + model.table[1, 1, 2] = 0. + # A fresh engine shows that no rejected row survived in either cache. + expected = QueryAnswerer(TableModel(model.table.detach()).cuda().eval()).predict((0, (0, 1))) + assert torch.equal(engine.predict((0, (0, 1))), expected) + + +def test_scorers_share_model_context_until_the_graph_changes(monkeypatch): + from dicee.query_answering import QueryAnswerer, QueryContext + model = ULTRA(dict(num_entities=3, num_relations=2, ultra_dim=8, ultra_num_layers=2)) + model.set_graph([(0, 0, 1)], inverse_relations={0: 1}).eval() + calls, original = [], QueryContext.from_model + monkeypatch.setattr(QueryContext, 'from_model', classmethod(lambda cls, m: calls.append(m) or original(m))) + first, second = QueryAnswerer(model), QueryAnswerer(model) + assert len(calls) == 1 and first.scorer.context is second.scorer.context + model.set_graph([(0, 0, 2)], inverse_relations={0: 1}) + first.predict((0, (0,))) + second.predict((0, (0,))) + assert len(calls) == 2 and first.scorer.context is second.scorer.context + assert (0, 0, 2) in first.scorer.context.triples diff --git a/tests/test_query_baselines.py b/tests/test_query_baselines.py new file mode 100644 index 000000000..5aa5aee9a --- /dev/null +++ b/tests/test_query_baselines.py @@ -0,0 +1,316 @@ +"""Native baselines against independently generated, pinned upstream outputs.""" + +import itertools +import json +from pathlib import Path +from types import SimpleNamespace + +import pytest +import torch + +from dicee.query_answering import BenchmarkQuery, QueryBenchmark, QueryContext, evaluate_benchmark +from dicee.query_answering.benchmark import QueryMetrics +from dicee.query_answering.methods import REFERENCES, load_method + +ROOT = Path(__file__).parent / 'fixtures' / 'query_baselines' + + +def cases(): + result = [] + for method in ('cone', 'cqd', 'qto', 'clmpt', 'ultra', 'gnnqe'): + path = ROOT / f'{method}.pt' + if not path.exists(): + continue + fixture = torch.load(path, weights_only=True, map_location='cpu') + for index, case in enumerate(fixture['cases']): + result.append(pytest.param(fixture, case, id=f'{method}-{index}')) + return result + + +@pytest.fixture(autouse=True) +def cpu_threads(): + previous = torch.get_num_threads() + torch.set_num_threads(2) + yield + torch.set_num_threads(previous) + + +@pytest.mark.parametrize('fixture,case', cases()) +def test_checkpoint_scores_ranks_ties_and_metrics(tmp_path, fixture, case): + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'checkpoint.pt' + torch.save({'model_state_dict': case['state']}, path) + model = load_method(case['name'], path, context, **case['config']) + assert fixture['upstream_commit'] == REFERENCES[case['name']][1] + assert not model.training + assert not any(parameter.requires_grad for parameter in model.parameters()) + for shape, expected in case['scores'].items(): + actual = model.predict(fixture['queries'][shape]) + torch.testing.assert_close(actual, expected, atol=3e-5, rtol=3e-5, msg=shape) + if case['name'] == 'cone' and shape in ('2u', 'up'): + torch.testing.assert_close(actual, expected, atol=0, rtol=0, msg='ConE union branches must use the reference joint projection batch') + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)), shape + assert torch.equal(actual[:, None] == actual[None], expected[:, None] == expected[None]), shape + for policy in ('sort', 'expected'): + evaluator = QueryMetrics(context.num_entities, candidates=range(context.num_entities - 1), tie_policy=policy) + assert evaluator(actual, {1}, {0, 3}) == evaluator(expected, {1}, {0, 3}), (shape, policy) + if 'adjacency' in case: + with torch.no_grad(): + for relation, expected in enumerate(case['adjacency']): + torch.testing.assert_close(model.rows(torch.arange(context.num_entities), relation), expected) + for batch in case.get('batches', {}).values(): + actual = model.predict_batch(batch['queries']) + torch.testing.assert_close(actual, batch['scores'], atol=3e-5, rtol=3e-5) + assert torch.equal(actual.argsort(-1), batch['scores'].argsort(-1)) + if not model.pre_norm: + assert not torch.allclose(actual[0], model.predict(batch['queries'][0])) + + +def test_all_reference_methods_present(): + for method in ('cone', 'cqd', 'qto', 'clmpt', 'ultra', 'gnnqe'): + assert (ROOT / f'{method}.pt').exists(), f'Missing upstream fixture for {method}' + + +def test_expected_ties_match_all_permutations(): + scores = torch.tensor([1., 1., .4, .4, .4, 0.]) + evaluator = QueryMetrics(len(scores), candidates=[0, 1, 2, 3, 4], tie_policy='expected') + result = evaluator(scores, {1}, {2, 4}) + # After filtering: one higher negative, one tied negative, and the target. + ranks = [2, 3] + assert result['mrr'] == pytest.approx(sum(1 / rank for rank in ranks) / 2) + assert result['hits1'] == 0 + assert result['hits3'] == 1 + scores = torch.ones(4) + values = [] + for order in itertools.permutations(range(4)): + values.append(1 / (order.index(0) + 1)) + result = QueryMetrics(4, tie_policy='expected')(scores, set(), {0}) + assert result['mrr'] == pytest.approx(sum(values) / len(values)) + assert result['hits1'] == .25 + assert result['hits3'] == .75 + assert result['mrr'] != QueryMetrics(4, tie_policy='average')(scores, set(), {0})['mrr'] + + +@pytest.mark.parametrize('policy', ['expected', 'average', 'optimistic', 'pessimistic']) +def test_tie_bounds_match_filtered_candidate_enumeration(policy): + generator = torch.Generator().manual_seed(42) + for _ in range(30): + scores = torch.randint(0, 5, (20,), generator=generator).float() + scores[0] = -torch.inf + candidates = set(torch.randperm(20, generator=generator)[:15].tolist()) + easy, hard = set(sorted(candidates)[:3]), set(sorted(candidates)[3:8]) + expected = [] + for target in hard: + negatives = candidates - easy - hard + start = 1 + sum(bool(scores[node] > scores[target]) for node in negatives) + ties = sum(bool(scores[node] == scores[target]) for node in negatives) + ranks = (range(start, start + ties + 1) if policy == 'expected' else + [start + {'average': .5, 'optimistic': 0., 'pessimistic': 1.}[policy] * ties]) + expected.append([sum(1 / r for r in ranks) / len(ranks), + *(sum(r <= k for r in ranks) / len(ranks) for k in (1, 3, 10))]) + result = QueryMetrics(20, candidates=candidates, tie_policy=policy)(scores, easy, hard) + assert list(result.values()) == pytest.approx(torch.tensor(expected, dtype=torch.float64).mean(0).tolist()) + + +def test_strict_checkpoint_and_vocabulary_validation(tmp_path): + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'] | {'unexpected': torch.tensor(0.)}, path) + with pytest.raises(ValueError, match='keys'): + load_method('qto', path, context, **case['config']) + torch.save(case['state'], path) + wrong = QueryContext([], context.num_entities + 1, context.num_relations) + with pytest.raises(ValueError, match='vocabulary'): + load_method('qto', path, wrong, **case['config']) + + +@pytest.mark.parametrize('reference_batching', [False, True]) +def test_qto_cache_invalidation_and_chunking(tmp_path, reference_batching): + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'], path) + model = load_method('qto', path, context, row_batch_size=2, cache_bytes=160, + reference_batching=reference_batching, **case['config']) + query = fixture['queries']['3p'] + torch.testing.assert_close(model.predict(query), case['scores']['3p']) + assert model.cache.bytes <= 160 + with torch.no_grad(): + model.model.entity_embeddings.weight.mul_(2) + cached = model.predict(query) + model.cache.capacity = 0 + model.cache.values.clear() + model.cache.bytes = 0 + torch.testing.assert_close(cached, model.predict(query), rtol=0, atol=0) + + +def test_cqd_negation_is_not_silently_reinterpreted(tmp_path): + fixture = torch.load(ROOT / 'cqd.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'], path) + model = load_method('cqd', path, context, **case['config']) + with pytest.raises(ValueError, match='negated'): + model.predict(fixture['queries']['2in']) + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA allocation guard') +def test_cqd_memory_guard_precedes_dense_scoring(tmp_path, monkeypatch): + from dicee.query_answering.methods import cqd + fixture = torch.load(ROOT / 'cqd.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'], path) + model = load_method('cqd', path, context, device='cuda', **case['config']) + monkeypatch.setattr(torch.cuda, 'mem_get_info', lambda device: (0, 2**30)) + monkeypatch.setattr(torch.cuda, 'memory_reserved', lambda device: 0) + monkeypatch.setattr(torch.cuda, 'memory_allocated', lambda device: 0) + monkeypatch.setattr(cqd, 'complex_rows', lambda *args: pytest.fail('Attempted dense allocation')) + with pytest.raises(MemoryError, match='reference stage.*scratch'): + model.predict(fixture['queries']['1p']) + + +@pytest.mark.parametrize('chunk', [1, 100]) +def test_opt_in_cqd_negation_matches_cqda(tmp_path, chunk): + fixture = torch.load(ROOT / 'cqd-negation.pt', weights_only=True) + assert fixture['upstream_commit'] == '642ce042708be6247087c09c780b9deb47e941d3' + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + for case in fixture['cases']: + torch.save(case['state'], path) + model = load_method(case['name'], path, context, row_batch_size=chunk, **case['config']) + for shape, expected in case['scores'].items(): + actual = model.predict(fixture['queries'][shape]) + torch.testing.assert_close(actual, expected, atol=3e-6, rtol=3e-6, msg=shape) + assert torch.equal(actual.argsort(), expected.argsort()), shape + assert torch.equal(actual[:, None] == actual[None], expected[:, None] == expected[None]), shape + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA reference attention') +def test_bounded_attention_preserves_full_transformer_sequence(): + from dicee.query_answering.methods._bounded_attention import BoundedAttention + torch.manual_seed(5) + model = torch.nn.TransformerEncoderLayer(2000, 8, 256, .1).cuda().eval() + inputs = torch.randn(1100, 2, 2000, device='cuda') + with torch.no_grad(): + expected = model(inputs) + with BoundedAttention(): + actual = model(inputs) + torch.testing.assert_close(actual, expected, atol=0, rtol=0) + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA ordered reduction') +@pytest.mark.parametrize('reduction', ['sum', 'max', 'min']) +def test_ordered_sparse_kernel_preserves_sequential_rounding(reduction): + from dicee.query_answering.methods._ordered_aggregation import aggregate, layout + torch.manual_seed(7) + edges = torch.tensor([[0, 0, 0, 2, 2], [1, 2, 3, 1, 4]]) + types = torch.tensor([2, 1, 0, 0, 2]) + states = torch.randn(5, 3, 17) + relations = torch.randn(4, 3, 17) + states[:3, 0, 0] = torch.tensor([1e20, -1e20, 1.]) + indices = layout(edges, types, len(states)) + expected = aggregate(states, relations, indices, reduction) + actual = aggregate(states.cuda(), relations.cuda(), tuple(x.cuda() for x in indices), reduction) + torch.testing.assert_close(actual.cpu(), expected, atol=0, rtol=0) + + +def test_qto_empty_intermediate_stays_empty(tmp_path): + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext([], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'], path) + model = load_method('qto', path, context, threshold=1., negation_scale=1.) + assert torch.equal(model.predict(fixture['queries']['2p']), torch.zeros(context.num_entities)) + assert torch.equal(model.projection(torch.zeros(context.num_entities), 0, negate=True), torch.zeros(context.num_entities)) + + +def test_dual_tie_protocol_resume_uses_one_prediction(tmp_path): + data = QueryBenchmark('toy', 'transductive', 'test', QueryContext([], 5, 2), + tuple(BenchmarkQuery('1p', (head, (0,)), frozenset({1}), frozenset({3})) for head in range(3)), + tuple(range(5))) + scores = torch.tensor([.5, .5, .4, .5, .1]) + calls = [] + + def predict(query): + calls.append(query) + return scores + + def interrupt(done, total): + if done == 2: + raise InterruptedError + + options = dict(checkpoint_dir=tmp_path, checkpoint_identity={'model': 'toy'}, checkpoint_every=1, + additional_tie_policies=('expected',)) + with pytest.raises(InterruptedError): + evaluate_benchmark(data, predict, progress=interrupt, **options) + report = evaluate_benchmark(data, predict, **options) + assert len(calls) == len(set(calls)) == 3 + for policy, values in [('sort', report), ('expected', report['additional_tie_metrics']['expected'])]: + assert values['per_shape']['1p']['mrr'] == QueryMetrics(5, tie_policy=policy)(scores, {1}, {3})['mrr'] + + +def test_baseline_runner_end_to_end_and_resume(tmp_path, monkeypatch): + from dicee.query_answering.methods.cone import ConE + from dicee.scripts.evaluate_query_methods import main + from tests.test_query_benchmark import fixture_dataset + fixture_dataset(tmp_path / 'data', 'FB15k237LogicalQuery') + fixture = torch.load(ROOT / 'cone.pt', weights_only=True) + state = fixture['cases'][0]['state'] + state['entity_embedding'] = torch.cat((state['entity_embedding'], state['entity_embedding'][:1])) + path = tmp_path / 'weights.pt' + torch.save(state, path) + entry = dict(method='cone', checkpoint=str(path), dataset='FB15k237LogicalQuery', root=str(tmp_path / 'data'), + vocabulary_dataset='FB15k237LogicalQuery', options={'center_reg': .02}) + manifest = tmp_path / 'manifest.json' + manifest.write_text(json.dumps(entry)) + args = ['--manifest', str(manifest), '--output', str(tmp_path / 'results'), '--max-queries-per-shape', '1'] + main(args) + path = tmp_path / 'results' / 'cone-FB15k237LogicalQuery' / 'result.json' + report = json.loads(path.read_text()) + assert report['queries'] == 14 + assert report['additional_tie_metrics']['expected']['averages']['all']['shapes'] == 14 + monkeypatch.setattr(ConE, 'predict', lambda *args: pytest.fail('Resumed evaluation recomputed a query')) + main(args) + assert json.loads(path.read_text())['per_shape'] == report['per_shape'] + + +@pytest.mark.parametrize('chunk,reference_batching,final_batch', [(1, False, None), (3, False, None), (100, False, None), + (3, True, None), (3, True, 1)]) +def test_cqd_chunking_preserves_stage_normalization(tmp_path, chunk, reference_batching, final_batch): + fixture = torch.load(ROOT / 'cqd.pt', weights_only=True) + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + for case in fixture['cases']: + torch.save(case['state'], path) + model = load_method(case['name'], path, context, row_batch_size=chunk, cache_bytes=160, + reference_batching=reference_batching, final_batch_size=final_batch, **case['config']) + for shape, expected in case['scores'].items(): + actual = model.predict(fixture['queries'][shape]) + torch.testing.assert_close(actual, expected, atol=2e-6, rtol=2e-6) + assert torch.equal(actual.argsort(), expected.argsort()) + assert model.cache.bytes <= 160 + + +def test_checkpoint_graphs_validate_ids_without_using_held_out_edges(): + from dicee.query_answering.methods.checkpoints import _validate_graph_buffer + context = QueryContext([(0, 0, 1), (1, 1, 2)], 3, 2) + graph = SimpleNamespace(_edge_list=torch.tensor([[0, 1, 0]]), _edge_weight=torch.ones(1), num_node=3, num_relation=2) + metadata = {} + _validate_graph_buffer('fact_graph', graph, context, metadata) + assert not metadata['fact_graph']['used_for_inference'] + graph._edge_list = torch.tensor([[0, 2, 0]]) + with pytest.raises(ValueError, match='training facts'): + _validate_graph_buffer('fact_graph', graph, context, metadata) + _validate_graph_buffer('graph', graph, context, metadata) + assert not metadata['graph']['used_for_inference'] + assert context.triples == ((0, 0, 1), (1, 1, 2)) + graph._edge_list = torch.tensor([[0, 2, 2]]) + with pytest.raises(ValueError, match='out-of-vocabulary'): + _validate_graph_buffer('graph', graph, context, metadata) diff --git a/tests/test_query_benchmark.py b/tests/test_query_benchmark.py new file mode 100644 index 000000000..dbcf5daa0 --- /dev/null +++ b/tests/test_query_benchmark.py @@ -0,0 +1,384 @@ +"""Published graph layouts, hard-answer ranking, and shared benchmark execution.""" + +import io +import json +import os +import pickle +import zipfile +from dataclasses import replace +from pathlib import Path + +import numpy as np +import pytest +import torch + +from dicee.query_answering import ( + BENCHMARK_DATASETS, + BenchmarkQuery, + QueryBenchmark, + QueryContext, + benchmark_model, + evaluate_benchmark, + load_benchmark, + summarize_benchmarks, +) +from dicee.query_answering._query import QUERY_SHAPES, ULTRAQUERY_SHAPES +from dicee.query_answering.benchmark import filtered_query_metrics +from dicee.query_answering.datasets import dataset_spec, download_benchmark +from tests.test_query_engine import TableModel, programs + + +def dump(path, name, value): + with (path / name).open('wb') as stream: + pickle.dump(value, stream) + + +def graph(path, name, direct, pairs, binary=False): + triples = list(QueryContext(direct, 8, 4, pairs).triples) + if binary: + torch.save(torch.tensor(triples), path / f'{name}.pt') + else: + (path / f'{name}.txt').write_text(''.join(f'{h}\t{r}\t{t}\n' for h, r, t in triples)) + return set(triples) + + +def fixture_dataset(root, name, binary=False): + group, folder, _ = dataset_spec(name) + path = root / folder + path.mkdir(parents=True) + pairs = ((0, 1), (2, 3)) if group == 'transductive' else ((0, 2), (1, 3)) + train = graph(path, 'train' if group == 'transductive' else 'train_graph', [(0, 0, 1), (1, 1 if group != 'transductive' else 2, 2)], pairs, binary) + test = None + if group == 'transductive': + dump(path, 'id2ent.pkl', {i: str(i) for i in range(8)}) + dump(path, 'id2rel.pkl', {i: str(i) for i in range(4)}) + (path / 'valid.txt').write_text('0\t0\t6\n') + (path / 'test.txt').write_text('0\t0\t7\n') + else: + graph(path, 'val_inference', [(2, 1, 5)], pairs, binary) + direct = [(2, 1, 3)] if group == 'inductive-e' else [(0, 1, 3), (1, 0, 2)] + test = graph(path, 'test_inference', direct, pairs, binary) + structured = {QUERY_SHAPES[shape]: [value[0]] for shape, value in programs(np.ones((4, 2, 4)) * .5, 2).items() + if shape in ULTRAQUERY_SHAPES} + for split in ('valid', 'test'): + hard_id = (5 if split == 'valid' else 3) if group == 'inductive-e' else (2 if split == 'valid' and group == 'inductive-er' else 3) + if group == 'transductive': + dump(path, f'{split}-queries.pkl', structured) + dump(path, f'{split}-easy-answers.pkl', {q: {1} for qs in structured.values() for q in qs}) + dump(path, f'{split}-hard-answers.pkl', {q: {hard_id} for qs in structured.values() for q in qs}) + else: + dump(path, f'{split}_queries.pkl', structured) + dump(path, f'{split}_answers_easy.pkl', {s: {q: {1} for q in qs} for s, qs in structured.items()}) + dump(path, f'{split}_answers_hard.pkl', {s: {q: {hard_id} for q in qs} for s, qs in structured.items()}) + return path, train, test + + +@pytest.mark.parametrize('name', ['FB15k237LogicalQuery', 'InductiveFB15k237Query:106', 'WikiTopicsQuery:art']) +@pytest.mark.parametrize('split', ['valid', 'test']) +@pytest.mark.parametrize('binary', [False, True]) +def test_official_layouts_no_target_leakage(tmp_path, name, split, binary): + path, train, test = fixture_dataset(tmp_path, name, binary) + data = load_benchmark(tmp_path, name, split=split) + assert len(data.queries) == 14 + assert {q.shape for q in data.queries} == set(ULTRAQUERY_SHAPES) + assert len(data.metadata['files']) >= 4 + edges = set(data.context.triples) + if data.group == 'transductive': + assert edges == train and data.candidates == tuple(range(8)) + assert not {'valid.txt', 'test.txt'} & data.metadata['files'].keys() + elif data.group == 'inductive-e': + assert data.context.num_entities == 6 + assert data.candidates == ((0, 1, 2, 5) if split == 'valid' else (0, 1, 2, 3)) + assert edges == (train | test) if split == 'test' else all(3 not in (h, t) for h, _, t in edges) + else: + assert edges == (train if split == 'valid' else test) + assert all(q.hard <= set(data.candidates) for q in data.queries) + selected = load_benchmark(tmp_path, name, split=split, query_types=['2u', 'pni']) + assert {q.shape for q in selected.queries} == {'2u', 'pni'} + + +def test_all_23_names_and_invalid_data(tmp_path): + assert len(BENCHMARK_DATASETS) == 23 + for name in BENCHMARK_DATASETS: + assert dataset_spec(name)[2].startswith('https://') + with pytest.raises(ValueError, match='Unknown benchmark'): + dataset_spec('WikiTopicsQuery:missing') + with pytest.raises(FileNotFoundError, match='extract'): + load_benchmark(tmp_path, 'FB15kLogicalQuery') + path, _, _ = fixture_dataset(tmp_path, 'FB15kLogicalQuery') + with pytest.raises(ValueError, match='distinct supported'): + load_benchmark(tmp_path, 'FB15kLogicalQuery', query_types=['2u-DNF']) + (path / 'train.txt').write_text('0\t0\t1\n') + with pytest.raises(ValueError, match='reciprocal'): + load_benchmark(tmp_path, 'FB15kLogicalQuery') + + +def test_extended_answers_keep_original_query_order(tmp_path): + path, _, _ = fixture_dataset(tmp_path, 'InductiveFB15k237Query:106') + shape = QUERY_SHAPES['1p'] + queries = [(2, (0,)), (0, (0,))] + dump(path, 'train_queries.pkl', {shape: queries}) + dump(path, 'train_answers_test.pkl', {shape: [{3}, {2}]}) + data = load_benchmark(tmp_path, 'InductiveFB15k237QueryExtendedEval:106', query_types=['1p']) + assert [q.hard for q in data.queries] == [frozenset({2}), frozenset({3})] + assert all(not q.easy for q in data.queries) + assert data.metadata['evaluation'] == 'faithfulness' + + +@pytest.mark.parametrize('tied', [False, True]) +def test_reference_sort_filter_protocol(tied): + # Independent implementation of the published positional rank adjustment. + scores = torch.tensor([.9, .8, .7, .6, .5, .4], dtype=torch.float64) + if tied: + scores[:] = .5 + easy, hard, candidates = {0}, {2, 4}, {0, 1, 2, 4, 5} + masked = scores.clone() + masked[3] = -torch.inf + order = masked.argsort(descending=True).tolist() + answer_order = [i for i in order if i in easy | hard] + ranks = [order.index(h) - answer_order.index(h) + 1 for h in sorted(hard)] + result = filtered_query_metrics(scores, easy, hard, candidates=candidates) + assert result['mrr'] == pytest.approx(np.mean([1 / r for r in ranks])) + assert result['hits1'] == pytest.approx(np.mean([r == 1 for r in ranks])) + + +def test_sort_excludes_outside_candidates_tied_at_negative_infinity(): + # The released UltraQuery evaluator assigns rank 3 here because node 1, + # outside the inductive candidate domain, ties with the hard answer. + scores = torch.full((6,), -torch.inf) + result = filtered_query_metrics(scores, set(), {2}, candidates=[0, 2, 4]) + assert result['mrr'] == .5 + assert result['hits1'] == 0 + + +@pytest.mark.parametrize('policy,rank', [('average', 2.), ('optimistic', 1.), ('pessimistic', 3.)]) +def test_ties_and_negative_infinity_exclude_other_answers(policy, rank): + scores = torch.full((6,), -torch.inf) + result = filtered_query_metrics(scores, {0}, {1, 2}, candidates=[0, 1, 2, 3, 4], tie_policy=policy) + assert result['mrr'] == pytest.approx(1 / rank) + with pytest.raises(ValueError, match='disjoint'): + filtered_query_metrics(scores, {0}, {0}) + with pytest.raises(ValueError, match='score vector'): + filtered_query_metrics(torch.tensor([float('nan')]), set(), {0}) + + +def test_query_then_shape_then_dataset_averaging_and_partial_flags(): + context = QueryContext([(0, 0, 1)], 4, 1) + queries = (BenchmarkQuery('1p', (0, (0,)), frozenset({0}), frozenset({1, 2})), + BenchmarkQuery('1p', (1, (0,)), frozenset(), frozenset({3})), + BenchmarkQuery('2p', (0, (0, 0)), frozenset(), frozenset({0}))) + data = QueryBenchmark('fixture', 'transductive', 'test', context, queries, tuple(range(4))) + scores = torch.tensor([4., 3., 2., 1.]) + report = evaluate_benchmark(data, lambda q: scores) + assert report['per_shape']['1p']['mrr'] == pytest.approx((1 + .25) / 2) + assert report['averages']['epfo']['mrr'] == pytest.approx(((1 + .25) / 2 + 1) / 2) + subset = evaluate_benchmark(data, lambda q: scores, max_queries_per_shape=1) + assert subset['queries'] == 2 and not subset['protocol']['full_split'] + assert not subset['protocol']['all_14_shapes'] + other = dict(subset, dataset='other') + summary = summarize_benchmarks([report, other]) + assert summary['groups']['all']['epfo']['mrr'] == pytest.approx((report['averages']['epfo']['mrr'] + 1) / 2) + assert not summary['complete_23_dataset_test_suite'] + with pytest.raises(ValueError, match='Duplicate'): + summarize_benchmarks([report, report]) + with pytest.raises(ValueError, match='complete public'): + evaluate_benchmark(data, lambda q: scores[:2]) + + +@pytest.mark.parametrize('name', ['ULTRA', 'TRIX', 'Flock']) +@pytest.mark.parametrize('attached', [False, True]) +def test_real_models_restore_graph_modes_and_failure(tmp_path, name, attached): + from dicee.models import TRIX, ULTRA, Flock + fixture_dataset(tmp_path, 'WikiTopicsQuery:art') + data = load_benchmark(tmp_path, 'WikiTopicsQuery:art') + settings = dict(num_entities=3, num_relations=2, ultra_dim=8, ultra_num_layers=2, trix_dim=8, + flock_dim=8, flock_walk_num=2, flock_walk_len=8, flock_refinements=2, flock_seed=77) + model = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[name](settings) + if attached: + model.set_graph(torch.tensor([[0, 0, 1]]), inverse_relations={0: 1}) + original = QueryContext.from_model(model) if attached else None + states = {k: v.clone() for k, v in model.state_dict().items()} + report = benchmark_model(model, data, beam_size=2, seed=42) + assert report['queries'] == 14 and report['protocol']['all_14_shapes'] + assert report['inference']['method'] == 'cqd-global-prefix' + assert model.training and (model.num_entities, model.num_relations) == (3, 2) + for key, value in model.state_dict().items(): + torch.testing.assert_close(value, states[key], rtol=0, atol=0) + assert QueryContext.from_model(model) == original if attached else model.graph_triples is None + with pytest.raises(ValueError, match='positive integer'): + benchmark_model(model, data, beam_size=0) + assert QueryContext.from_model(model) == original if attached else model.graph_triples is None + second = benchmark_model(model, data, beam_size=2, seed=42) + assert second['per_shape'] == report['per_shape'] + + +@pytest.mark.parametrize('executor', ['cqd', 'qto']) +def test_cli_checkpoint_reports_and_preserves_commit_work(tmp_path, monkeypatch, executor): + from dicee.models import ULTRA + from dicee.query_answering.__main__ import main + fixture_dataset(tmp_path, 'FB15k237LogicalQuery') + fixture_dataset(tmp_path, 'WikiTopicsQuery:art') + config = dict(ultra_dim=8, ultra_num_layers=2) + model = ULTRA(dict(config, num_entities=1, num_relations=1)) + checkpoint, config_path, output = tmp_path / 'model.pt', tmp_path / 'config.json', tmp_path / 'report.json' + torch.save({'model': model.state_dict()}, checkpoint) + config_path.write_text(json.dumps(config)) + monkeypatch.setattr('sys.argv', ['query_answering', 'benchmark', '--data-root', str(tmp_path), + '--datasets', 'FB15k237LogicalQuery', 'WikiTopicsQuery:art', + '--checkpoint', str(checkpoint), '--model-config', str(config_path), + '--output', str(output), '--beam-size', '2', '--max-queries-per-shape', '1', + '--query-sampling', 'uniform', '--sampling-seed', '83', '--executor', executor]) + main() + report = json.loads(output.read_text()) + assert len(report['results']) == 2 + assert all(r['inference']['executor'] == executor for r in report['results']) + assert all(r['protocol']['query_sampling'] == 'uniform' and r['protocol']['sampling_seed'] == 83 for r in report['results']) + assert report['summary']['groups']['all']['datasets'] == 2 + assert not report['summary']['complete_23_dataset_test_suite'] + assert report['results'][0]['inference']['backbone_state_sha256'] == report['results'][1]['inference']['backbone_state_sha256'] + monkeypatch.setattr('dicee.query_answering.engine.QueryAnswerer.predict', lambda *a, **k: pytest.fail('Completed run was rescored')) + main() + resumed = json.loads(output.read_text()) + assert resumed['state'] == 'complete' + assert [r['per_shape'] for r in resumed['results']] == [r['per_shape'] for r in report['results']] + + +def test_download_archive_paths(tmp_path, monkeypatch): + memory = io.BytesIO() + with zipfile.ZipFile(memory, 'w') as archive: + archive.writestr('../escape.txt', 'bad') + monkeypatch.setattr('urllib.request.urlopen', lambda *a, **k: io.BytesIO(memory.getvalue())) + with pytest.raises(ValueError, match='Unsafe path'): + download_benchmark('WikiTopicsQuery:art', tmp_path) + assert not (tmp_path.parent / 'escape.txt').exists() + + +def test_prediction_receives_only_query_and_candidate_filtering_is_final(tmp_path): + fixture_dataset(tmp_path, 'InductiveFB15k237Query:106') + data = load_benchmark(tmp_path, 'InductiveFB15k237Query:106', query_types=['2p']) + # Entity 5 is outside the final candidate domain but remains a valid + # intermediate entity in the complete public vocabulary. + raw = torch.full((6, 4, 6), -20., dtype=torch.float64) + raw[0, 0, 5] = 10 + raw[5, 1, 3] = 10 + query = replace(data.queries[0], query=(0, (0, 1)), easy=frozenset(), hard=frozenset({3})) + data.queries = (query,) + result = benchmark_model(TableModel(raw), data, beam_size=1) + assert result['per_shape']['2p']['mrr'] == 1. + + +def test_wikitopics_unused_relations_use_original_mapping(tmp_path): + path, _, _ = fixture_dataset(tmp_path, 'WikiTopicsQuery:art') + # Full vocabulary has six relation IDs, but the last inverse never appears. + edges = QueryContext([(0, 0, 1), (2, 1, 3)], 4, 5, ((0, 3), (1, 4))).triples + (path / 'test_inference.txt').write_text(''.join(f'{h}\t{r}\t{t}\n' for h, r, t in edges)) + dump(path, 'og_mappings.pkl', {'r2id': {'a': 0, 'b': 1, 'unused': 2, 'a_inv': 3, 'b_inv': 4, 'unused_inv': 5}}) + data = load_benchmark(tmp_path, 'WikiTopicsQuery:art') + assert data.context.num_relations == 5 + assert data.context.inverse_relations == ((0, 3), (1, 4)) + assert data.context.triples == edges + assert 'og_mappings.pkl' in data.metadata['files'] + + +def test_cli_rejects_mismatched_transductive_vocabulary(tmp_path, monkeypatch): + from dicee.models import DistMult + from dicee.query_answering.__main__ import main + from tests.test_query_engine import save_experiment + path, _, _ = fixture_dataset(tmp_path, 'FB15k237LogicalQuery') + settings = dict(model='DistMult', num_entities=8, num_relations=4, embedding_dim=8) + model = DistMult(settings) + experiment = tmp_path / 'experiment' + save_experiment(model, settings, experiment) + output = tmp_path / 'results.json' + monkeypatch.setattr('sys.argv', ['query_answering', 'benchmark', '--data-root', str(tmp_path), + '--experiment', str(experiment), '--output', str(output), '--query-types', '1p']) + main() + assert output.is_file() + dump(path, 'id2ent.pkl', {i: str((i + 1) % 8) for i in range(8)}) + with pytest.raises(ValueError, match='exactly match'): + main() + + +def test_suite_complete_only_with_all_datasets_shapes_queries(): + base = dict(split='test', protocol=dict(full_split=True, all_14_shapes=True), + dataset_metadata={'evaluation': 'hard-answers'}, + averages={category: dict.fromkeys(('mrr', 'hits1', 'hits3', 'hits10'), .5) + for category in ('all', 'epfo', 'negation')}) + reports = [dict(base, dataset=name, group=dataset_spec(name)[0]) for name in BENCHMARK_DATASETS] + assert summarize_benchmarks(reports)['complete_23_dataset_test_suite'] + assert not summarize_benchmarks(reports[:-1])['complete_23_dataset_test_suite'] + reports[0] = dict(reports[0], dataset_metadata={'evaluation': 'faithfulness'}) + with pytest.raises(ValueError, match='faithfulness'): + summarize_benchmarks(reports) + + +@pytest.mark.parametrize('device', ['cpu', pytest.param('cuda', marks=pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA unavailable'))]) +@pytest.mark.parametrize('restricted', [False, True]) +def test_reused_ranking_masks_match_independent_sort_oracle(device, restricted): + from dicee.query_answering.benchmark import QueryMetrics + n = 29 + candidates = set(range(n)) - ({0, 11, 24} if restricted else set()) + evaluator = QueryMetrics(n, candidates=candidates) + rng = np.random.default_rng(13) + for tied in (False, True): + for _ in range(20): + scores = torch.tensor(rng.integers(0, 4, n) if tied else rng.normal(size=n), device=device, dtype=torch.float64) + if tied: + scores[scores == 0] = -torch.inf + unchanged = scores.clone() + labels = rng.choice(sorted(candidates), 6, replace=False).tolist() + easy, hard = set(labels[:3]), set(labels[3:]) + masked = scores.clone() + masked[list(set(range(n)) - candidates)] = -torch.inf + order = masked.argsort(descending=True).tolist() + ranks = [1 + sum(e in candidates and e not in easy | hard for e in order[:order.index(t)]) for t in hard] + expected = dict(mrr=np.mean([1/r for r in ranks]), hits1=np.mean([r <= 1 for r in ranks]), + hits3=np.mean([r <= 3 for r in ranks]), hits10=np.mean([r <= 10 for r in ranks])) + assert evaluator(scores, easy, hard) == pytest.approx(expected) + assert torch.equal(scores, unchanged) + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_ULTRAQUERY_DATA_ROOT'), reason='Set DICEE_ULTRAQUERY_DATA_ROOT to the official extracted data') +@pytest.mark.parametrize('name', ['FB15k237LogicalQuery', 'InductiveFB15k237Query:106', 'WikiTopicsQuery:art']) +@pytest.mark.parametrize('split', ['valid', 'test']) +def test_official_ultraquery_data_graphs_and_reference_ranks(name, split): + """Real-data conformance for each of the three pinned UltraQuery loaders.""" + root = Path(os.environ['DICEE_ULTRAQUERY_DATA_ROOT']) + data = load_benchmark(root, name, split=split) + path = root / dataset_spec(name)[1] + + def triples(stem): + file = path / f'{stem}.txt' + if file.is_file(): + return {tuple(map(int, row.split())) for row in file.read_text().splitlines() if row.strip()} + return {tuple(row) for row in torch.load(path / f'{stem}.pt', weights_only=True).tolist()} + + if data.group == 'transductive': + observed = triples('train') + assert data.candidates == tuple(range(data.context.num_entities)) + elif data.group == 'inductive-e': + observed = triples('train_graph') | triples('val_inference' if split == 'valid' else 'test_inference') + else: + observed = triples('train_graph' if split == 'valid' else 'test_inference') + assert set(data.context.triples) == observed + if data.group != 'transductive': + assert set(data.candidates) == {entity for h, _, t in observed for entity in (h, t)} + scores = torch.sin(torch.arange(data.context.num_entities, dtype=torch.float64)) + report = evaluate_benchmark(data, lambda q: scores, max_queries_per_shape=1) + first = {} + for query in data.queries: + first.setdefault(query.shape, query) + masked = scores.clone() + masked[list(set(range(len(scores))) - set(data.candidates))] = -torch.inf + order = masked.argsort(descending=True).tolist() + positions = {entity: i for i, entity in enumerate(order)} + for shape, query in first.items(): + true_answers = sorted(query.easy | query.hard, key=positions.__getitem__) + ranks = [positions[entity] - offset + 1 for offset, entity in enumerate(true_answers) if entity in query.hard] + expected = dict(mrr=np.mean([1 / r for r in ranks]), + **{f'hits{k}': np.mean([r <= k for r in ranks]) for k in (1, 3, 10)}) + assert {key: report['per_shape'][shape][key] for key in expected} == pytest.approx(expected) + assert report['queries'] == 14 and report['protocol']['all_14_shapes'] + assert not report['protocol']['full_split'] + diff --git a/tests/test_query_engine.py b/tests/test_query_engine.py new file mode 100644 index 000000000..370d9ba5f --- /dev/null +++ b/tests/test_query_engine.py @@ -0,0 +1,516 @@ +"""Independent fuzzy-logic examples and common KGE/KGFM query contracts.""" + +import hashlib +import json + +import numpy as np +import pytest +import torch +from torch import nn + +from dicee import KGE +from dicee.query_answering import QueryAnswerer, QueryContext, QueryScoreAdapter +from dicee.query_answering._query import QUERY_SHAPES, compile_query, index_query +from dicee.query_answering.context import state_fingerprint +from dicee.query_answering.score_adapter import score_features + + +class TableModel(nn.Module): + name = 'Table' + + def __init__(self, raw): + super().__init__() + self.table = nn.Parameter(torch.as_tensor(raw, dtype=torch.float64).clone()) + self.num_entities, self.num_relations = self.table.shape[:2] + self.calls = [] + + def forward_k_vs_all(self, pairs): + self.calls.append(pairs.detach().cpu().tolist()) + return self.table[pairs[:, 0], pairs[:, 1]] + + +def programs(m, beam, tnorm='prod'): + """Literal formulas, independent of the parser and recursive evaluator.""" + n = len(m) + a, b, c = (0, (0,)), (1, (1,)), (2, (0,)) + pa, pb, pc = m[0, 0], m[1, 1], m[2, 0] + conjunction = np.multiply if tnorm == 'prod' else np.minimum + union = (lambda x, y: x + y - x*y) if tnorm == 'prod' else np.maximum + + def project(prefix, r): + heads = sorted(range(n), key=lambda h: (-prefix[h], h))[:beam] + return np.array([max(conjunction(prefix[h], m[h, r, t]) for h in heads) for t in range(n)]) + + two = project(pa, 1) + intersection, disjunction = (a, b), (a, b, (-1,)) + return { + '1p': (a, pa), '2p': ((0, (0, 1)), two), '3p': ((0, (0, 1, 0)), project(two, 0)), + '2i': (intersection, conjunction(pa, pb)), '3i': ((a, b, c), conjunction(conjunction(pa, pb), pc)), + 'pi': (((0, (0, 1)), b), conjunction(two, pb)), + 'ip': ((intersection, (1,)), project(conjunction(pa, pb), 1)), + '2u': (disjunction, union(pa, pb)), 'up': ((disjunction, (1,)), project(union(pa, pb), 1)), + '2in': ((a, (1, (1, -2))), conjunction(pa, 1-pb)), + '3in': ((a, c, (1, (1, -2))), conjunction(conjunction(pa, pc), 1-pb)), + 'inp': (((a, (1, (1, -2))), (1,)), project(conjunction(pa, 1-pb), 1)), + 'pin': (((0, (0, 1)), (1, (1, -2))), conjunction(two, 1-pb)), + 'pni': (((0, (0, 1, -2)), b), conjunction(1-two, pb)), + '4p': ((0, (0, 1, 0, 1)), project(project(two, 0), 1)), + '4i': ((a, b, c, (3, (1,))), conjunction(conjunction(conjunction(pa, pb), pc), m[3, 1])), + } + + +@pytest.fixture +def raw(): + return np.random.default_rng(17).normal(size=(4, 2, 4)) + + +@pytest.mark.parametrize('shape', QUERY_SHAPES) +@pytest.mark.parametrize('beam', [1, 2, 4]) +@pytest.mark.parametrize('tnorm', ['prod', 'min']) +def test_all_shapes_against_literal_formulas(raw, shape, beam, tnorm): + query, expected = programs(1/(1+np.exp(-raw)), beam, tnorm)[shape] + model = TableModel(raw) + result = QueryAnswerer(model).predict(query, beam_size=beam, tnorm=tnorm) + np.testing.assert_allclose(result.numpy(), expected, atol=2e-15, rtol=2e-14) + assert model.training # prediction restores its caller's mode + assert model.table.grad is None + + +def named(query): + if isinstance(query, tuple): + return tuple(named(x) for x in query) + return 'not' if query == -2 else 'union' if query == -1 else str(query) + + +def wrapper(model): + kge = object.__new__(KGE) + kge.model = model + # Insertion order deliberately differs from ID order. + kge.entity_to_idx = {str(i): i for i in reversed(range(model.num_entities))} + kge.relation_to_idx = {str(i): i for i in range(model.num_relations)} + return kge + + +@pytest.mark.parametrize('shape', QUERY_SHAPES) +def test_named_api_limits_batches_and_numeric_ids(raw, shape): + query, expected = programs(1/(1+np.exp(-raw)), 2)[shape] + kge = wrapper(TableModel(raw)) + kwargs = dict(query_type=shape, beam_size=2, k=1) + result = kge.answer_multi_hop_query(query=named(query), **kwargs) + assert len(result) == 1 and result[0][0] == str(int(np.argmax(expected))) + scores = kge.answer_multi_hop_query(query=named(query), only_scores=True, **kwargs) + np.testing.assert_allclose(scores.numpy(), expected, atol=2e-15, rtol=2e-14) + batch = kge.answer_multi_hop_query(queries=[named(query)] * 2, **kwargs) + assert batch == [result, result] + assert kge.answer_multi_hop_query(query=named(query), query_type=shape, k=0) == [] + + +def test_singleton_ties_invalid_queries_and_logits(raw): + kge = wrapper(TableModel(np.zeros((1, 1, 1)))) + assert kge.answer_multi_hop_query('2p', ('0', ('0', '0')))[0][0] == '0' + engine = QueryAnswerer(TableModel(np.zeros_like(raw))) + scores = engine.predict((0, (0, 1)), beam_size=1) + assert torch.equal(scores, torch.full_like(scores, .25)) + assert engine.scorer.model.calls[1] == [[0, 1]] + with pytest.raises(ValueError, match='Anchor'): + engine.predict((4, (0,))) + with pytest.raises(ValueError, match='Relation'): + engine.predict((0, (2,))) + with pytest.raises(ValueError, match='lambda'): + engine.predict((0, (0, -2)), neg_norm='yager') + with pytest.raises(ValueError, match='beam_size'): + engine.predict((0, (0,)), beam_size=0) + with pytest.raises(ValueError, match='marker'): + index_query('2in', (('0', ('0',)), ('1', ('1', 'wrong'))), {'0': 0, '1': 1}, {'0': 0, '1': 1}) + raw_engine = QueryAnswerer(TableModel(raw)) + actual = raw_engine.predict(((0, (0,)), (1, (1,))), use_logits=True) + np.testing.assert_allclose(actual.numpy(), raw[0, 0] * raw[1, 1]) + with pytest.raises(ValueError, match='Raw logits'): + QueryAnswerer(TableModel(raw), adapter=QueryScoreAdapter('global')).predict((0, (0,)), use_logits=True) + + +@pytest.mark.parametrize('shape', ['2u', 'up']) +def test_named_unions_accept_marker_omission(raw, shape): + query = (('0', ('0',)), ('1', ('1',))) + marked = (*query, ('union',)) + if shape == 'up': + query, marked = (query, ('0',)), (marked, ('0',)) + kge = wrapper(TableModel(raw)) + torch.testing.assert_close(kge.answer_multi_hop_query(shape, query, only_scores=True), + kge.answer_multi_hop_query(shape, marked, only_scores=True)) + + +@pytest.mark.parametrize('norm,parameter', [('standard', 0.), ('sugeno', .5), ('yager', 2.)]) +def test_negation_norms(raw, norm, parameter): + p = 1 / (1 + np.exp(-raw[0, 0])) + expected = 1-p if norm == 'standard' else (1-p)/(1+parameter*p) if norm == 'sugeno' else (1-p**parameter)**(1/parameter) + actual = QueryAnswerer(TableModel(raw)).predict((0, (0, -2)), neg_norm=norm, lambda_=parameter) + np.testing.assert_allclose(actual.numpy(), expected) + + +def test_observed_proofs_survive_pruning_and_do_not_shortcut_negation(): + raw = np.full((4, 2, 4), -8.) + raw[0, 0, 0] = 8 + context = QueryContext([(0, 0, 1), (0, 0, 2), (2, 1, 3)], 4, 2) + engine = QueryAnswerer(TableModel(raw), context=context, observed_mix=1) + result = engine.predict((0, (0, 1)), beam_size=1) + # Stable top-1 visits entity 1; the proof via entity 2 is restored separately. + assert result[3] == 1 and engine.last_info['pruned'] + negated = engine.predict((0, (0, 1, -2)), beam_size=1) + assert negated[3] > .99 and engine.last_info['negated_pruning'] + exact = engine.predict((0, (0, 1, -2)), beam_size=4) + assert exact[3] == 0 + + +def test_cache_bounded_reused_and_invalidated(raw): + model = TableModel(raw) + engine = QueryAnswerer(model, cache_bytes=4*8) + a = (0, (0,)) + before = engine.predict((a, a)) + assert engine.last_info['raw_rows'] == 1 and engine.last_info['cache_hits'] == 1 + assert engine.last_info['cache_bytes'] <= 32 + with torch.no_grad(): + model.table.add_(1) + after = engine.predict((a, a)) + assert (after > before).all() + engine.predict((0, (0, 1)), beam_size=4) + assert engine.last_info['cache_bytes'] <= 32 + + +@pytest.mark.parametrize('name', ['DistMult', 'ULTRA', 'TRIX', 'Flock']) +def test_saved_experiment_query_reload(name, tmp_path): + from dicee.models import TRIX, ULTRA, DistMult, Flock + cls = {'DistMult': DistMult, 'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[name] + settings = dict(model=name, num_entities=4, num_relations=2, embedding_dim=8, + ultra_dim=8, ultra_num_layers=2, trix_dim=8, flock_dim=8, + flock_walk_num=2, flock_walk_len=8, flock_refinements=2, flock_seed=17) + model = cls(settings) + if name != 'DistMult': + model.set_graph(torch.tensor([[0, 0, 1], [1, 1, 2], [2, 0, 3]])) + save_experiment(model, settings, tmp_path) + restored = KGE(path=str(tmp_path)) + actual = restored.answer_multi_hop_query('3p', ('0', ('0', '1', '0')), k=2, only_scores=True) + expected = QueryAnswerer(model).predict((0, (0, 1, 0)), beam_size=2) + torch.testing.assert_close(actual, expected) + + +def save_experiment(model, settings, path): + path.mkdir(parents=True, exist_ok=True) + if hasattr(model, 'save_graph'): + model.save_graph(path/model.graph_filename) + torch.save(model.state_dict(), path/'model.pt') + (path/'configuration.json').write_text(json.dumps(settings)) + (path/'report.json').write_text(json.dumps(dict(num_entities=model.num_entities, num_relations=model.num_relations))) + for name, count in [('entity', model.num_entities), ('relation', model.num_relations)]: + (path/f'{name}_to_idx.csv').write_text(f',{name}\n' + ''.join(f'{i},{i}\n' for i in range(count))) + + +def test_generator_and_context_truth_against_boolean_oracle(raw): + from dicee.query_generator import QueryGenerator + facts = [(h, r, t) for h, r, t in np.ndindex(raw.shape) if raw[h, r, t] > 0] + context = QueryContext(facts, 4, 2) + generator = QueryGenerator.from_context(context) + for query, expected in programs((raw > 0).astype(float), 4).values(): + answers = set(np.flatnonzero(expected).tolist()) + assert context.answers(compile_query(query)) == answers + assert generator.achieve_answer(generator.tuple2list(query), generator.ent_in, generator.ent_out) == answers + + +def test_mixed_module_modes_and_scoring_failure_are_restored(raw, monkeypatch): + model = TableModel(raw) + model.add_module('dropout', nn.Dropout()) + model.train() + model.dropout.eval() + engine = QueryAnswerer(model) + engine.predict((0, (0,))) + assert model.training and not model.dropout.training + + def fail(_): + raise RuntimeError('scoring failed') + monkeypatch.setattr(model, 'forward_k_vs_all', fail) + with pytest.raises(RuntimeError, match='scoring failed'): + engine.predict((0, (0,))) + assert model.training and not model.dropout.training + + +@pytest.mark.parametrize('mode', ['global', 'context', 'context_scores_v1']) +@pytest.mark.parametrize('gamma', [0., .4, 1.]) +def test_adapter_against_independent_numpy_formulas(raw, mode, gamma): + context = QueryContext([(0, 0, 1), (0, 0, 2), (1, 1, 3)], 4, 2) + conditions = [(0, 0), (1, 1)] + z = np.stack([raw[h, r] for h, r in conditions]) + observed = np.zeros_like(z, dtype=bool) + observed[0, [1, 2]], observed[1, 3] = True, True + base = np.array([[1, np.log1p(2)/np.log1p(4), np.log1p(2)/np.log1p(8), np.log1p(2)/np.log1p(16)], + [1, np.log1p(1)/np.log1p(4), np.log1p(1)/np.log1p(8), np.log1p(1)/np.log1p(16)]]) + features = base[:, :1] if mode == 'global' else base + if mode == 'context_scores_v1': + prob = np.exp(z - z.max(1, keepdims=True)) + prob /= prob.sum(1, keepdims=True) + top = np.sort(z, axis=1)[:, -2:] + features = np.column_stack((base, np.tanh(z.mean(1)/4), -(prob*np.log(prob)).sum(1)/np.log(4), + np.tanh((top[:, 1]-top[:, 0])/4), + np.tanh(((z*observed).sum(1)/observed.sum(1)-z.mean(1))/4))) + weights = np.random.default_rng(33).normal(size=(2, features.shape[1])) + logits = 2**np.tanh(features @ weights[0])[:, None]*z + 4*np.tanh(features @ weights[1])[:, None] + expected = 1/(1+np.exp(-logits)) + expected[observed] = gamma + (1-gamma)*expected[observed] + obs, actual_base = context.features(conditions, device='cpu') + np.testing.assert_allclose(actual_base.numpy(), base) + np.testing.assert_allclose(score_features(torch.tensor(z), obs, actual_base, mode).numpy(), features, atol=2e-15) + actual = QueryScoreAdapter(mode, gamma, weights=weights)(torch.tensor(z), obs, actual_base) + np.testing.assert_allclose(actual.detach().exp().numpy(), expected, atol=2e-15) + + +def test_adapter_artifacts_bind_actual_weights(raw, tmp_path): + model = TableModel(raw) + adapter = QueryScoreAdapter('global', metadata={'backbone_state_sha256': state_fingerprint(model)}) + path = tmp_path/'adapter.json' + adapter.save(path) + loaded = QueryScoreAdapter.load(path, model=model) + torch.testing.assert_close(adapter.weights, loaded.weights) + checkpoint = tmp_path/'model.pt' + torch.save({'model': model.state_dict()}, checkpoint) + catalog = {'all_sources': dict(weights=[[0.]*4]*2, feature_mode='context', observed_mix=1., + backbone_checkpoint_sha256=hashlib.sha256(checkpoint.read_bytes()).hexdigest())} + path.write_text(json.dumps(catalog)) + QueryScoreAdapter.load(path, model=model, key='all_sources', checkpoint=checkpoint) + with pytest.raises(ValueError, match='original checkpoint'): + QueryScoreAdapter.load(path, model=model, key='all_sources') + with torch.no_grad(): + model.table[0, 0, 0] += 1 + with pytest.raises(ValueError, match='modified backbone'): + QueryAnswerer(model, adapter=loaded).predict((0, (0,))) + with pytest.raises(ValueError, match='modified backbone'): + QueryScoreAdapter.load(path, model=model, key='all_sources', checkpoint=checkpoint) + + +@pytest.mark.parametrize('name', ['ULTRA', 'TRIX', 'Flock']) +def test_actual_kgfms_share_the_api_and_restore_context(name): + from dicee.models import TRIX, ULTRA, Flock + cls = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[name] + settings = dict(num_entities=4, num_relations=4, ultra_dim=8, ultra_num_layers=2, trix_dim=8, + flock_dim=8, flock_walk_num=2, flock_walk_len=8, flock_refinements=2, flock_seed=77) + facts = torch.tensor([[0, 2, 1], [1, 0, 2], [2, 2, 3]]) + model = cls(settings).set_graph(facts, inverse_relations={2: 1, 0: 3}).eval() + context = QueryContext.from_model(model) + assert context.inverse_relations == ((0, 3), (2, 1)) + assert (1, 1, 0) in context.triples and (2, 3, 1) in context.triples + engine = QueryAnswerer(model, observed_mix=1, seed=19) + first = engine.predict((0, (2, 0)), beam_size=2) + assert first[2] == 1 and first.shape == (4,) + kge = wrapper(model) + for shape in QUERY_SHAPES: + query = programs(np.full((4, 2, 4), .5), 2)[shape][0] + result = kge.answer_multi_hop_query(shape, named(query), only_scores=True, k=2) + assert result.shape == (4,) and torch.isfinite(result).all() + if name == 'Flock': + from dicee.query_answering.engine import AtomicScorer + state = torch.random.get_rng_state().clone() + scorer = AtomicScorer(model, seed=9) + batched = scorer.rows([(0, 2), (1, 0)]) + serial = torch.cat([scorer.rows([(h, r)]) for h, r in [(1, 0), (0, 2)]]) + torch.testing.assert_close(batched, serial.flip(0), rtol=0, atol=0) + assert torch.equal(state, torch.random.get_rng_state()) and model.seed == 77 + model.set_graph(torch.tensor([[0, 2, 3]]), inverse_relations={2: 1, 0: 3}) + with pytest.raises(ValueError, match='must match'): + QueryAnswerer(model, context=context) + after = engine.predict((0, (2,)), beam_size=2) + assert after[3] == 1 and engine.scorer.context != context + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA unavailable') +def test_cuda_scores_stay_on_device(raw): + model = TableModel(raw).cuda() + engine = QueryAnswerer(model) + result = engine.predict((0, (0, 1))) + assert result.is_cuda + expected = QueryAnswerer(TableModel(raw)).predict((0, (0, 1))) + torch.testing.assert_close(result.cpu(), expected) + + +@pytest.mark.parametrize('shape', QUERY_SHAPES) +@pytest.mark.parametrize('tnorm', ['prod', 'min']) +def test_persistent_cache_matches_formulas_and_owns_returned_scores(raw, shape, tnorm): + query, expected = programs(1/(1+np.exp(-raw)), 2, tnorm)[shape] + model = TableModel(raw).eval() + engine = QueryAnswerer(model, row_batch_size=2) + first = engine.predict(query, beam_size=2, tnorm=tnorm, return_log_scores=True) + np.testing.assert_allclose(first.exp().numpy(), expected, atol=2e-15, rtol=2e-14) + calls = len(model.calls) + first.fill_(123.) + second = engine.predict(query, beam_size=2, tnorm=tnorm) + np.testing.assert_allclose(second.numpy(), expected, atol=2e-15, rtol=2e-14) + assert len(model.calls) == calls and engine.last_info['raw_rows'] == 0 + assert engine.last_info['cache_hits'] > 0 + + +def test_persistent_lru_eviction_resize_and_disable(raw): + model = TableModel(raw).eval() + engine = QueryAnswerer(model, cache_bytes=64) + for head in (0, 1, 0, 2, 0): + engine.predict((head, (0,))) + assert len(model.calls) == 3 + engine.predict((1, (0,))) + assert engine.last_info['raw_rows'] == 1 + engine.cache_bytes = 32 + engine.predict((1, (0,))) + assert engine.last_info['raw_rows'] == 0 and engine.last_info['cache_bytes'] == 32 + engine.cache_bytes = 0 + engine.predict((1, (0,))) + assert engine.last_info['raw_rows'] == 1 and engine.last_info['cache_bytes'] == 0 + # Eviction during a beam batch must not invalidate its in-flight rows. + engine.cache_bytes = 32 + actual = engine.predict((0, (0, 1)), beam_size=4) + torch.testing.assert_close(actual, QueryAnswerer(TableModel(raw), cache_bytes=0).predict((0, (0, 1)), beam_size=4)) + engine.clear_cache() + assert not engine._cache and engine._cache_used == 0 + + +@pytest.mark.parametrize('change', ['inplace', 'parameter', 'buffer', 'load', 'dtype', 'adapter', 'observed', 'context', 'precision']) +def test_persistent_cache_invalidates_changed_inputs(raw, change, monkeypatch): + model = TableModel(raw).eval() + model.register_buffer('extra', torch.tensor(0.)) + context = QueryContext([(0, 0, 1)], 4, 2) + adapter = QueryScoreAdapter('context', observed_mix=.5) + engine = QueryAnswerer(model, adapter=adapter, context=context) + query = (0, (0,)) + engine.predict(query) + engine.predict(query) + assert engine.last_info['raw_rows'] == 0 + with torch.no_grad(): + if change == 'inplace': + model.table.add_(1) + elif change == 'parameter': + model.table = nn.Parameter(model.table.clone() + 1) + elif change == 'buffer': + model.extra.add_(1) + elif change == 'load': + model.load_state_dict(dict(table=model.table + 1, extra=model.extra)) + elif change == 'dtype': + model.float() + elif change == 'adapter': + adapter.weights.add_(.1) + elif change == 'observed': + adapter.observed_mix = 1. + elif change == 'context': + engine.scorer.explicit_context = QueryContext([(0, 0, 2)], 4, 2) + elif change == 'precision': + monkeypatch.setattr('dicee.models._inference.float32_precision_token', lambda: ('changed',)) + actual = engine.predict(query) + assert engine.last_info['raw_rows'] == 1 + expected = QueryAnswerer(model, adapter=adapter, context=engine.scorer.context, cache_bytes=0).predict(query) + torch.testing.assert_close(actual, expected) + + +def test_cached_adapter_verification_still_rejects_mutations(raw, monkeypatch): + import dicee.query_answering.score_adapter as module + model = TableModel(raw).eval() + digest = state_fingerprint(model) + adapter = QueryScoreAdapter('global', metadata={'backbone_state_sha256': digest}) + real_hash, calls = module.state_fingerprint, [] + def counted(value): + calls.append(value) + return real_hash(value) + monkeypatch.setattr(module, 'state_fingerprint', counted) + engine = QueryAnswerer(model, adapter=adapter) + engine.predict((0, (0,))) + engine.predict((0, (0,))) + assert len(calls) == 1 + with torch.no_grad(): + model.table.add_(1) + with pytest.raises(ValueError, match='modified backbone'): + engine.predict((0, (0,))) + assert len(calls) == 2 + + +def test_inference_tensors_and_training_callers_do_not_persist_rows(raw): + for inference in (False, True): + with torch.inference_mode(inference): + model = TableModel(raw) + if inference: + model.eval() + engine = QueryAnswerer(model) + engine.predict((0, (0,))) + engine.predict((0, (0,))) + assert engine.last_info['raw_rows'] == 1 + + +def test_graph_context_validation_uses_identity_and_detects_changes(monkeypatch): + from dicee.models import ULTRA + model = ULTRA(dict(num_entities=3, num_relations=2, ultra_dim=8, ultra_num_layers=2)) + model.set_graph([(0, 0, 1)], inverse_relations={0: 1}).eval() + context = QueryContext.from_model(model) + def no_deep_comparison(*args): + raise AssertionError('must not walk the triples for equality') + monkeypatch.setattr(QueryContext, '__eq__', no_deep_comparison) + engine = QueryAnswerer(model, context=context) + engine.predict((0, (0,))) + engine.predict((0, (0,))) + assert engine.last_info['raw_rows'] == 0 + model.set_graph([(0, 0, 2)], inverse_relations={0: 1}) + with pytest.raises(ValueError, match='must match'): + engine.predict((0, (0,))) + + +def test_flock_persistent_cache_tracks_sampling(): + from dicee.models import Flock + model = Flock(dict(num_entities=4, num_relations=2, flock_dim=8, flock_walk_num=2, + flock_walk_len=8, flock_refinements=2)).set_graph([(0, 0, 1), (1, 1, 2)]).eval() + engine = QueryAnswerer(model, seed=13) + query = (0, (0,)) + engine.predict(query) + engine.predict(query) + assert engine.last_info['raw_rows'] == 0 + for attr, value in [('seed', 14), ('samples', 2)]: + setattr(engine.scorer, attr, value) + actual = engine.predict(query) + assert engine.last_info['raw_rows'] == 1 + expected = QueryAnswerer(model, seed=engine.scorer.seed, samples=engine.scorer.samples, cache_bytes=0).predict(query) + torch.testing.assert_close(actual, expected, rtol=0, atol=0) + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA unavailable') +def test_adapter_device_copy_refresh_and_training_gradients(raw): + adapter = QueryScoreAdapter('global') + logits = torch.tensor(raw[0, 0][None], device='cuda', dtype=torch.float64) + with torch.no_grad(): + before = adapter(logits) + adapter.weights[1, 0].add_(.2) + after = adapter(logits) + assert (after > before).all() + torch.testing.assert_close(after, QueryScoreAdapter('global', weights=adapter.weights).cuda()(logits)) + adapter(logits).sum().backward() + assert adapter.weights.grad is not None and torch.isfinite(adapter.weights.grad).all() + + +def test_eval_failure_restores_modes_and_does_not_poison_cache(raw, monkeypatch): + model = TableModel(raw).eval() + engine = QueryAnswerer(model) + original = model.forward_k_vs_all + def fail(_): + raise RuntimeError('scoring failed') + monkeypatch.setattr(model, 'forward_k_vs_all', fail) + with pytest.raises(RuntimeError, match='scoring failed'): + engine.predict((0, (0,))) + assert not model.training and not engine.scorer._evaluating + monkeypatch.setattr(model, 'forward_k_vs_all', original) + actual = engine.predict((0, (0,))) + torch.testing.assert_close(actual, model.table[0, 0].sigmoid()) + + +def test_cache_separates_raw_logits_and_bypasses_autocast(raw): + model = TableModel(raw).eval() + engine = QueryAnswerer(model) + query = (0, (0,)) + engine.predict(query) + logits = engine.predict(query, use_logits=True) + torch.testing.assert_close(logits, model.table[0, 0]) + assert engine.last_info['raw_rows'] == 1 + scores = engine.predict(query) + torch.testing.assert_close(scores, model.table[0, 0].sigmoid()) + assert engine.last_info['raw_rows'] == 1 + with torch.autocast('cpu', dtype=torch.bfloat16): + for _ in range(2): + engine.predict(query) + assert engine.last_info['raw_rows'] == 1 diff --git a/tests/test_unit_kge_inference.py b/tests/test_unit_kge_inference.py index 626096710..f96b6c0cb 100644 --- a/tests/test_unit_kge_inference.py +++ b/tests/test_unit_kge_inference.py @@ -12,6 +12,8 @@ import pytest import torch +from dicee.knowledge_graph_embeddings import KGE + # --------------------------------------------------------------------------- # Fixtures: Mock Model and KGE Instance # --------------------------------------------------------------------------- @@ -53,13 +55,8 @@ def mock_forward(x): @pytest.fixture def mock_kge_instance(tmp_path): - """Create a minimal real KGE-like instance for validation testing. - - This uses a real object (not MagicMock) so that real validation - logic in methods like predict_topk, predict, etc. actually executes. - """ - # Create a simple object that has the required attributes - class MinimalKGE: + """Use real KGE methods with a mock model, without loading a checkpoint.""" + class MinimalKGE(KGE): def __init__(self): self.entity_to_idx = {f"e{i}": i for i in range(100)} self.idx_to_entity = {i: f"e{i}" for i in range(100)} @@ -79,17 +76,7 @@ def __init__(self): self.model.to = MagicMock(return_value=self.model) self.model.entity_embeddings = MagicMock(return_value=torch.randn(100, 64)) - kge = MinimalKGE() - - # Attach real validation methods from KGE - from dicee.knowledge_graph_embeddings import KGE as RealKGE - kge.to = RealKGE.to.__get__(kge, type(kge)) - kge.predict_topk = RealKGE.predict_topk.__get__(kge, type(kge)) - kge.predict = RealKGE.predict.__get__(kge, type(kge)) - kge.get_transductive_entity_embeddings = RealKGE.get_transductive_entity_embeddings.__get__(kge, type(kge)) - kge.__str__ = RealKGE.__str__.__get__(kge, type(kge)) - - return kge + return MinimalKGE() # --------------------------------------------------------------------------- @@ -110,6 +97,19 @@ def test_to_device_cuda_valid(self, mock_kge_instance): mock_kge_instance.to("cuda") mock_kge_instance.model.to.assert_called_with("cuda") + @pytest.mark.parametrize("device", ["cpu", "cuda"]) + def test_to_clears_query_cache_before_transfer(self, mock_kge_instance, device): + mock_kge_instance._query_engine = object() + mock_kge_instance._query_engine_key = object() + + def transfer(target): + assert mock_kge_instance._query_engine is None + assert mock_kge_instance._query_engine_key is None + + mock_kge_instance.model.to.side_effect = transfer + mock_kge_instance.to(device) + mock_kge_instance.model.to.assert_called_once_with(device) + def test_to_device_invalid_raises_valueerror(self, mock_kge_instance): """to() with invalid device should raise ValueError (not AssertionError).""" with pytest.raises(ValueError, match="Device must be either cpu or cuda"): From 8f34f49c0a29b419752a57a066123233df2e1fc3 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 1 Oct 2026 18:35:47 +0200 Subject: [PATCH 03/39] feat(benchmarks): reproducible UltraQuery and +H benchmarks `python -m benchmarks.cqa {plus_h,ultraquery} COMMAND` selects any methods, datasets and query types from compact public recipes, freezes inputs, query batches and source in a study, verifies validation predictions against oracles exported from the pinned upstream code, and runs and reports the test split. With --image, commands run in a pinned, network-free Docker runtime; the host needs only Python and Docker. Paired controls measure learned adapters, the corrected +H answer filters and inference graphs. The evaluation protocol and every known deviation from the publications are documented in benchmarks/cqa/PROTOCOL.md. --- .../github-actions-python-package.yml | 2 +- .gitignore | 10 +- CHANGELOG.md | 1 + benchmarks/__init__.py | 1 + benchmarks/adapters/trix_product_14types.json | 134 ++++ .../adapters/trix_product_intersections.json | 122 ++++ .../adapters/ultra_product_14types.json | 134 ++++ .../adapters/ultra_product_intersections.json | 91 +++ benchmarks/cqa/Dockerfile | 37 + benchmarks/cqa/PROTOCOL.md | 143 ++++ benchmarks/cqa/README.md | 206 ++++++ benchmarks/cqa/__init__.py | 4 + benchmarks/cqa/__main__.py | 3 + benchmarks/cqa/cli.py | 485 +++++++++++++ benchmarks/cqa/difficulty.py | 474 +++++++++++++ benchmarks/cqa/docker.py | 91 +++ benchmarks/cqa/evaluate.py | 44 ++ benchmarks/cqa/inputs.py | 326 +++++++++ benchmarks/cqa/manifests.py | 271 ++++++++ benchmarks/cqa/oracles.py | 112 +++ benchmarks/cqa/provenance.py | 60 ++ benchmarks/cqa/reports.py | 262 ++++++++ benchmarks/cqa/requirements.lock | 68 ++ benchmarks/cqa/study.py | 332 +++++++++ benchmarks/cqa/tests/__init__.py | 0 benchmarks/cqa/tests/recipe_fingerprints.json | 179 +++++ benchmarks/cqa/tests/test_adapter_pairs.py | 227 +++++++ .../cqa/tests/test_comparison_baselines.py | 279 ++++++++ benchmarks/cqa/tests/test_cqd_reference.py | 74 ++ benchmarks/cqa/tests/test_download_inputs.py | 213 ++++++ .../cqa/tests/test_inference_difficulty.py | 201 ++++++ benchmarks/cqa/tests/test_kgfm_reference.py | 124 ++++ benchmarks/cqa/tests/test_launcher.py | 467 +++++++++++++ benchmarks/cqa/tests/test_manifests.py | 36 + benchmarks/cqa/tests/test_protocol.py | 617 +++++++++++++++++ .../cqa/tests/test_ultraquery_launcher.py | 240 +++++++ .../cqa/tests/test_ultraquery_protocol.py | 164 +++++ benchmarks/cqa/train.py | 293 ++++++++ benchmarks/cqa/training/Dockerfile | 17 + benchmarks/cqa/training/requirements.lock | 22 + benchmarks/cqa/training/torchdrug_compat.py | 49 ++ benchmarks/cqa/verification/__init__.py | 1 + .../cqa/verification/export_reference.py | 460 +++++++++++++ benchmarks/cqa/verification/reference_cqd.py | 183 +++++ benchmarks/cqa/verification/reference_kgfm.py | 112 +++ benchmarks/cqa/verification/reference_qto.py | 70 ++ benchmarks/cqa/verification/verify_kgfm.py | 98 +++ benchmarks/plus_h/baselines.json | 359 ++++++++++ benchmarks/plus_h/kgfm_adapters.json | 108 +++ benchmarks/plus_h/published_results.json | 390 +++++++++++ benchmarks/ultraquery/baselines.json | 55 ++ benchmarks/ultraquery/comparisons.json | 229 +++++++ benchmarks/ultraquery/heuristic.json | 6 + benchmarks/ultraquery/inductive-v2-files.json | 636 ++++++++++++++++++ benchmarks/ultraquery/kgfm_adapters.json | 147 ++++ benchmarks/ultraquery/trained_baselines.json | 96 +++ pyproject.toml | 5 +- 57 files changed, 9566 insertions(+), 4 deletions(-) create mode 100644 benchmarks/__init__.py create mode 100644 benchmarks/adapters/trix_product_14types.json create mode 100644 benchmarks/adapters/trix_product_intersections.json create mode 100644 benchmarks/adapters/ultra_product_14types.json create mode 100644 benchmarks/adapters/ultra_product_intersections.json create mode 100644 benchmarks/cqa/Dockerfile create mode 100644 benchmarks/cqa/PROTOCOL.md create mode 100644 benchmarks/cqa/README.md create mode 100644 benchmarks/cqa/__init__.py create mode 100644 benchmarks/cqa/__main__.py create mode 100644 benchmarks/cqa/cli.py create mode 100644 benchmarks/cqa/difficulty.py create mode 100644 benchmarks/cqa/docker.py create mode 100644 benchmarks/cqa/evaluate.py create mode 100644 benchmarks/cqa/inputs.py create mode 100644 benchmarks/cqa/manifests.py create mode 100644 benchmarks/cqa/oracles.py create mode 100644 benchmarks/cqa/provenance.py create mode 100644 benchmarks/cqa/reports.py create mode 100644 benchmarks/cqa/requirements.lock create mode 100644 benchmarks/cqa/study.py create mode 100644 benchmarks/cqa/tests/__init__.py create mode 100644 benchmarks/cqa/tests/recipe_fingerprints.json create mode 100644 benchmarks/cqa/tests/test_adapter_pairs.py create mode 100644 benchmarks/cqa/tests/test_comparison_baselines.py create mode 100644 benchmarks/cqa/tests/test_cqd_reference.py create mode 100644 benchmarks/cqa/tests/test_download_inputs.py create mode 100644 benchmarks/cqa/tests/test_inference_difficulty.py create mode 100644 benchmarks/cqa/tests/test_kgfm_reference.py create mode 100644 benchmarks/cqa/tests/test_launcher.py create mode 100644 benchmarks/cqa/tests/test_manifests.py create mode 100644 benchmarks/cqa/tests/test_protocol.py create mode 100644 benchmarks/cqa/tests/test_ultraquery_launcher.py create mode 100644 benchmarks/cqa/tests/test_ultraquery_protocol.py create mode 100644 benchmarks/cqa/train.py create mode 100644 benchmarks/cqa/training/Dockerfile create mode 100644 benchmarks/cqa/training/requirements.lock create mode 100644 benchmarks/cqa/training/torchdrug_compat.py create mode 100644 benchmarks/cqa/verification/__init__.py create mode 100644 benchmarks/cqa/verification/export_reference.py create mode 100644 benchmarks/cqa/verification/reference_cqd.py create mode 100644 benchmarks/cqa/verification/reference_kgfm.py create mode 100644 benchmarks/cqa/verification/reference_qto.py create mode 100644 benchmarks/cqa/verification/verify_kgfm.py create mode 100644 benchmarks/plus_h/baselines.json create mode 100644 benchmarks/plus_h/kgfm_adapters.json create mode 100644 benchmarks/plus_h/published_results.json create mode 100644 benchmarks/ultraquery/baselines.json create mode 100644 benchmarks/ultraquery/comparisons.json create mode 100644 benchmarks/ultraquery/heuristic.json create mode 100644 benchmarks/ultraquery/inductive-v2-files.json create mode 100644 benchmarks/ultraquery/kgfm_adapters.json create mode 100644 benchmarks/ultraquery/trained_baselines.json diff --git a/.github/workflows/github-actions-python-package.yml b/.github/workflows/github-actions-python-package.yml index f63d15a1c..b35db27f1 100644 --- a/.github/workflows/github-actions-python-package.yml +++ b/.github/workflows/github-actions-python-package.yml @@ -24,7 +24,7 @@ jobs: - name: Lint with ruff run: | - ruff check dicee/ --line-length=200 + ruff check dicee/ benchmarks/ --line-length=200 - name: "Type check with mypy (ratchet: error count must not increase)" run: | diff --git a/.gitignore b/.gitignore index 2607f72c5..40ecfec25 100644 --- a/.gitignore +++ b/.gitignore @@ -181,8 +181,16 @@ cython_debug/ .cursorindexingignore KGs/ Experiments/ -# Benchmark reports are local artifacts, not repository content. +# Benchmark reports are local artifacts; recipes, adapters and published scores are tracked. /benchmarks/**/*.json +!/benchmarks/adapters/*.json +!/benchmarks/plus_h/*.json +!/benchmarks/ultraquery/*.json +!/benchmarks/cqa/tests/*.json +/results/ +.benchmark-downloads/ +.fetch-*/ +.models-*/ checkpoints/ *.zip Literal_KGs/ diff --git a/CHANGELOG.md b/CHANGELOG.md index 33ede325f..61d8316e1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Adaptive Momentum Weight Averaging and soft-label support - `--log_level` CLI flag; TriX model - Complex query answering (`dicee.query_answering`): CQD beam search over KGEs and KGFMs with learned score adapters, negated query types, native UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE and CLMPT checked against their upstream implementations, and resumable filtered evaluation with exact expected ranks under ties +- Reproducible UltraQuery and +H benchmarks (`python -m benchmarks.cqa`): frozen studies verified against the pinned upstream implementations, a pinned Docker runtime, paired adapter, answer-filter and inference-graph ablations ### Changed - KGFM inference accelerated (fused kernels, query reuse, Flock execution) diff --git a/benchmarks/__init__.py b/benchmarks/__init__.py new file mode 100644 index 000000000..233aa6387 --- /dev/null +++ b/benchmarks/__init__.py @@ -0,0 +1 @@ +"""Benchmark harnesses; see cqa/ for complex query answering.""" diff --git a/benchmarks/adapters/trix_product_14types.json b/benchmarks/adapters/trix_product_14types.json new file mode 100644 index 000000000..1af43d796 --- /dev/null +++ b/benchmarks/adapters/trix_product_14types.json @@ -0,0 +1,134 @@ +{ + "backbone_state_sha256": "4a2e050130570df0964fc84cf14e6fcaec8672e30afb44f2b0aaf358864d95f7", + "training": { + "objective": "filtered_softmax_v1", + "epochs": 500, + "batch_size": 8, + "learning_rate": 0.02, + "identity_penalty": 0.001, + "gradient_clip": 1.0, + "seed": 2026090851, + "weighting": "equal_source_shape", + "selection": "source_validation_mrr", + "shapes": [ + "1p", + "2i", + "2in", + "2p", + "2u", + "3i", + "3in", + "3p", + "inp", + "ip", + "pi", + "pin", + "pni", + "up" + ], + "validation_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "validation_every": 5, + "training_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "train_per_shape": 20, + "early_stopping_patience": 100, + "beam_size": 64, + "validation_shapes": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "device": "cuda", + "validation_device": "cpu", + "cpu_threads": 4, + "training_cache_bytes": 6442450944, + "device_cache_bytes": 536870912, + "selected_epoch": 15, + "selected_validation_mrr": 0.2160742403142149, + "epochs_completed": 115, + "stopped_early": true, + "stop_reason": "validation_patience", + "training_queries": 840, + "optimizer_steps": 12075, + "row_cache": { + "FB15k237": { + "host_hits": 1466481, + "device_hits": 52637, + "disk_rows": 12913, + "scored_rows": 3173, + "feature_preparations": 3177, + "seconds": 1113.5889300499111 + }, + "WN18RR": { + "host_hits": 1393241, + "device_hits": 126645, + "disk_rows": 12583, + "scored_rows": 2735, + "feature_preparations": 2760, + "seconds": 492.1543016753276 + }, + "CoDExMedium": { + "host_hits": 1138753, + "device_hits": 385423, + "disk_rows": 9294, + "scored_rows": 1734, + "feature_preparations": 1761, + "seconds": 476.73713415215025 + } + } + }, + "score_banks": [ + "8d06f4ecca4f7c446ed706644f784b789c48cc7c0797df173915ea99b158379b", + "6e8c83f950fb39daae2e43f662e3384727b42dfc69250b851bdadf64f396021b", + "1981e87027c19d29146a1ed70c9c9ecbb47382d45cb73aef8b326bf7b4cc1fd6" + ], + "sources": { + "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", + "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", + "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" + }, + "version": 3, + "feature_mode": "context_scores_v1", + "observed_mix": 1.0, + "bias_bound": 8.0, + "scale_bound": 2.0, + "normalization": "none", + "hidden_dim": 0, + "weights": [ + [ + -0.4206266978568604, + 1.8175990925134906, + -0.20239740750133875, + -0.10149383004454994, + -0.10618729432335908, + 0.8947173515160507, + 2.372061080351603, + 0.8125137228828666 + ], + [ + -0.97435279237582, + 1.5779700697689738, + -0.31425804123937096, + 0.2372066367521474, + -0.7893614994120073, + -0.48732115928976905, + -1.1798536343618, + -0.2108354323830918 + ] + ], + "hidden_weights": null +} diff --git a/benchmarks/adapters/trix_product_intersections.json b/benchmarks/adapters/trix_product_intersections.json new file mode 100644 index 000000000..1e13c6c23 --- /dev/null +++ b/benchmarks/adapters/trix_product_intersections.json @@ -0,0 +1,122 @@ +{ + "backbone_state_sha256": "4a2e050130570df0964fc84cf14e6fcaec8672e30afb44f2b0aaf358864d95f7", + "training": { + "objective": "filtered_softmax_v1", + "epochs": 500, + "batch_size": 8, + "learning_rate": 0.02, + "identity_penalty": 0.001, + "gradient_clip": 1.0, + "seed": 2026090851, + "weighting": "equal_source_shape", + "selection": "source_validation_mrr", + "shapes": [ + "2i", + "3i" + ], + "validation_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "validation_every": 5, + "training_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "train_per_shape": 140, + "early_stopping_patience": 100, + "beam_size": 64, + "validation_shapes": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "device": "cuda", + "validation_device": "cpu", + "cpu_threads": 4, + "training_cache_bytes": 6442450944, + "device_cache_bytes": 536870912, + "selected_epoch": 20, + "selected_validation_mrr": 0.21164792298119686, + "epochs_completed": 120, + "stopped_early": true, + "stop_reason": "validation_patience", + "training_queries": 840, + "optimizer_steps": 12600, + "row_cache": { + "FB15k237": { + "host_hits": 160251, + "device_hits": 72148, + "disk_rows": 0, + "scored_rows": 6353, + "feature_preparations": 6353, + "seconds": 3510.926437651331 + }, + "WN18RR": { + "host_hits": 156886, + "device_hits": 75333, + "disk_rows": 0, + "scored_rows": 6533, + "feature_preparations": 6533, + "seconds": 1340.7423292564345 + }, + "CoDExMedium": { + "host_hits": 157168, + "device_hits": 76657, + "disk_rows": 0, + "scored_rows": 4927, + "feature_preparations": 4927, + "seconds": 1591.4698363094358 + } + } + }, + "score_banks": [ + "8d06f4ecca4f7c446ed706644f784b789c48cc7c0797df173915ea99b158379b", + "6e8c83f950fb39daae2e43f662e3384727b42dfc69250b851bdadf64f396021b", + "1981e87027c19d29146a1ed70c9c9ecbb47382d45cb73aef8b326bf7b4cc1fd6" + ], + "sources": { + "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", + "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", + "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" + }, + "version": 3, + "feature_mode": "context_scores_v1", + "observed_mix": 1.0, + "bias_bound": 8.0, + "scale_bound": 2.0, + "normalization": "none", + "hidden_dim": 0, + "weights": [ + [ + -0.8248981279689328, + 1.3857730002558575, + 1.2953982008249219, + -0.4644471807543671, + 0.10034981678214763, + 1.0685651164671832, + -0.9667501449968788, + 0.5089790944483673 + ], + [ + -1.0692246624707495, + 1.853212091799282, + 0.38918544229708163, + -0.13628156778504116, + -0.8493974313750033, + -0.8462766593623741, + -1.072134991578466, + -0.28842092871795827 + ] + ], + "hidden_weights": null +} diff --git a/benchmarks/adapters/ultra_product_14types.json b/benchmarks/adapters/ultra_product_14types.json new file mode 100644 index 000000000..186bcc393 --- /dev/null +++ b/benchmarks/adapters/ultra_product_14types.json @@ -0,0 +1,134 @@ +{ + "backbone_state_sha256": "5524f131f909918c40daa0c6169eaf8ebb7ca344ccf9e96e1d81154cd5097e5b", + "training": { + "objective": "filtered_softmax_v1", + "epochs": 500, + "batch_size": 8, + "learning_rate": 0.02, + "identity_penalty": 0.001, + "gradient_clip": 1.0, + "seed": 2026090851, + "weighting": "equal_source_shape", + "selection": "source_validation_mrr", + "shapes": [ + "1p", + "2i", + "2in", + "2p", + "2u", + "3i", + "3in", + "3p", + "inp", + "ip", + "pi", + "pin", + "pni", + "up" + ], + "validation_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "validation_every": 5, + "training_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "train_per_shape": 20, + "early_stopping_patience": 100, + "beam_size": 64, + "validation_shapes": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "device": "cuda", + "validation_device": "cpu", + "cpu_threads": 4, + "training_cache_bytes": 6442450944, + "device_cache_bytes": 536870912, + "selected_epoch": 110, + "selected_validation_mrr": 0.21033703261698602, + "epochs_completed": 210, + "stopped_early": true, + "stop_reason": "validation_patience", + "training_queries": 840, + "optimizer_steps": 22050, + "row_cache": { + "FB15k237": { + "host_hits": 2691269, + "device_hits": 95863, + "disk_rows": 13107, + "scored_rows": 3177, + "feature_preparations": 3429, + "seconds": 654.5506004370982 + }, + "WN18RR": { + "host_hits": 2501664, + "device_hits": 286752, + "disk_rows": 12399, + "scored_rows": 2601, + "feature_preparations": 2843, + "seconds": 353.80072834936436 + }, + "CoDExMedium": { + "host_hits": 2121753, + "device_hits": 670378, + "disk_rows": 9481, + "scored_rows": 1804, + "feature_preparations": 6516, + "seconds": 351.37388774967985 + } + } + }, + "score_banks": [ + "234956d0ff36b7c9b617eaccf08f5b90cdfcf767bf0ea7cd16370b89d5796d73", + "bde8017c40d3b147437e164de2de075ed6ffd46beeeadcc869ba68127ceb19dd", + "fb5f99029aedca2a5d177da53b2ad24fa04f477a223fa5de82dc3e7910893a0e" + ], + "sources": { + "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", + "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", + "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" + }, + "version": 3, + "feature_mode": "context_scores_v1", + "observed_mix": 1.0, + "bias_bound": 8.0, + "scale_bound": 2.0, + "normalization": "none", + "hidden_dim": 0, + "weights": [ + [ + -2.0626464576086057, + 2.5843856571497836, + -0.8894196831163416, + 1.0546347147429727, + -0.8845241302531646, + 1.555732410649971, + 1.8981372913377885, + 0.7030732760071264 + ], + [ + -0.8441497931973995, + 1.1414811216674428, + 0.11921445306291666, + 0.7004416344087456, + -0.5180700160343036, + -0.7152943095341088, + -0.5694389475806457, + -0.1457005467138816 + ] + ], + "hidden_weights": null +} diff --git a/benchmarks/adapters/ultra_product_intersections.json b/benchmarks/adapters/ultra_product_intersections.json new file mode 100644 index 000000000..14b2cdd3b --- /dev/null +++ b/benchmarks/adapters/ultra_product_intersections.json @@ -0,0 +1,91 @@ +{ + "backbone_state_sha256": "5524f131f909918c40daa0c6169eaf8ebb7ca344ccf9e96e1d81154cd5097e5b", + "training": { + "objective": "filtered_softmax_v1", + "epochs": 500, + "batch_size": 8, + "learning_rate": 0.02, + "identity_penalty": 0.001, + "gradient_clip": 1.0, + "seed": 2026090851, + "weighting": "equal_source_shape", + "selection": "source_validation_mrr", + "shapes": [ + "2i", + "3i" + ], + "validation_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "validation_every": 5, + "training_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "train_per_shape": 140, + "early_stopping_patience": 100, + "beam_size": 64, + "validation_shapes": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "selected_epoch": 20, + "selected_validation_mrr": 0.2080190892168318, + "epochs_completed": 120, + "stopped_early": true, + "stop_reason": "validation_patience", + "training_queries": 840, + "optimizer_steps": 12600 + }, + "score_banks": [ + "7f7701967dc5e2a9c11c0283d4cc73bd14bf4dc07472c10550d3ceb57e49e39f", + "4e888aacfb61da3e6dd95f6e81d51bf4de064873ec9e09986d3ed22a153907ce", + "19712b80292de03ff8ed1fda781c4f6691b4b05817b8c7e74a0075d1de78aa9b" + ], + "sources": { + "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", + "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", + "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" + }, + "version": 3, + "feature_mode": "context_scores_v1", + "observed_mix": 1.0, + "bias_bound": 8.0, + "scale_bound": 2.0, + "normalization": "none", + "hidden_dim": 0, + "weights": [ + [ + -0.9610871975006661, + 1.6151930713458116, + 1.506114487842482, + -0.24227659844007385, + 0.7539009660458432, + 1.241735976991373, + 0.6837330334025685, + 0.6785526796481871 + ], + [ + -0.6606956373109719, + 1.7630503354217026, + 0.31905344378446204, + -0.061247942677854626, + -0.46463820640491177, + -1.14732100440598, + -0.6411935744153302, + -0.09846041230646553 + ] + ], + "hidden_weights": null +} diff --git a/benchmarks/cqa/Dockerfile b/benchmarks/cqa/Dockerfile new file mode 100644 index 000000000..84da3ac70 --- /dev/null +++ b/benchmarks/cqa/Dockerfile @@ -0,0 +1,37 @@ +FROM python:3.11.14-slim-bookworm@sha256:65a93d69fa75478d554f4ad27c85c1e69fa184956261b4301ebaf6dbb0a3543d AS runtime +RUN rm /etc/apt/sources.list.d/debian.sources \ + && echo 'deb [check-valid-until=no] https://snapshot.debian.org/archive/debian/20260901T000000Z bookworm main' > /etc/apt/sources.list \ + && apt-get -o Acquire::Retries=5 update \ + && apt-get install -y --no-install-recommends g++ \ + && rm -rf /var/lib/apt/lists/* + +FROM runtime AS dependencies + +COPY benchmarks/cqa/requirements.lock /tmp/requirements.lock +COPY wheels /wheels +RUN sed 's|torch @ https://[^ ]*|torch==2.9.1+cu128|' /tmp/requirements.lock > /tmp/offline.lock \ + && pip install --no-cache-dir --no-index --find-links=/wheels --require-hashes -r /tmp/offline.lock \ + && pip check + +FROM runtime +COPY --from=dependencies /usr/local /usr/local +WORKDIR /opt/dicee +COPY dicee dicee +COPY pyproject.toml pyproject.toml +COPY benchmarks/__init__.py benchmarks/__init__.py +COPY benchmarks/cqa benchmarks/cqa +COPY benchmarks/adapters benchmarks/adapters +COPY benchmarks/plus_h benchmarks/plus_h +COPY benchmarks/ultraquery benchmarks/ultraquery +ARG SOURCE_COMMIT=unknown +ARG SOURCE_DIRTY=unknown +LABEL org.opencontainers.image.revision=$SOURCE_COMMIT +ENV DICEE_SOURCE_COMMIT=$SOURCE_COMMIT \ + DICEE_SOURCE_DIRTY=$SOURCE_DIRTY \ + PYTHONPATH=/opt/dicee \ + PYTHONHASHSEED=0 \ + PYTHONDONTWRITEBYTECODE=1 \ + PYTHONUNBUFFERED=1 \ + CUBLAS_WORKSPACE_CONFIG=:4096:8 \ + PYTORCH_ALLOC_CONF=expandable_segments:True +ENTRYPOINT ["python", "-m", "benchmarks.cqa"] diff --git a/benchmarks/cqa/PROTOCOL.md b/benchmarks/cqa/PROTOCOL.md new file mode 100644 index 000000000..b112d6e9a --- /dev/null +++ b/benchmarks/cqa/PROTOCOL.md @@ -0,0 +1,143 @@ +# Evaluation protocol + +This document fixes how the [benchmark suites](README.md) score methods, what +verification establishes, and where this reproduction knowingly differs from a +publication. Where the evidence for a published number is uncertain, the +difference is recorded rather than resolved by tuning. + +## Metrics + +Each query has easy answers, which follow from the observed graph, and hard +answers, which need at least one missing link. MRR and Hits@k rank every hard +answer against all candidate entities after filtering every other easy and hard +answer. Scores average hard answers per query, queries per query type, and +query types equally within a dataset group; suite means weight datasets +equally. Reports state whether a run covers the full split and every query +type of its dataset, and partial runs are never presented as full-suite scores. + +Ties are scored twice from the same predictions: `sort` follows the order of a +stable descending sort, and `expected` is the exact expectation of each rank +under uniformly random ordering within a tied block. `expected` is not the +midpoint rank. Rank traces store every hard answer's ranks under both policies, +so later analyses never rerun inference. + +Each suite keeps its released candidates and inference graphs. UltraQuery +evaluates its 14 query types on the published inference graphs: the training +graph for transductive datasets and the released inference graphs for the +inductive ones. Test triples never enter inference in either suite. + +## +H answer filters + +The `benchs-1.0` archive has two sets of test answers for the same queries: the +root `test-{easy,hard}-answers.pkl` files and the `test-query-reduction//all/` +files, which the pinned +[analysis script](https://github.com/april-tools/is-cqa-complex/blob/d1ce74164936a7c09d9147e83190da047cb39429/read_queries_pair.py) +recomputes from the graph: + +| Dataset | Type | Root hard answers | Reduction `all` hard answers | +|---|---|---:|---:| +| FB15k-237+H | 3in | 20,000 | 192,617 | +| FB15k-237+H | pin | 20,000 | 197,728 | +| FB15k-237+H | inp | 20,000 | 201,328 | +| NELL995+H | 3in | 20,000 | 126,893 | +| NELL995+H | pin | 20,000 | 133,156 | +| NELL995+H | inp | 20,000 | 128,812 | + +For `2in` and `pni` the hard answers agree, but the root easy-answer filters +are wrong for every FB15k-237+H and NELL995+H query: 18,000 queries with 149,691 +false filtered answers in total. All hard answers are true, and the other +negated types and ICEWS18+H agree with full-graph truth. The pinned authors' +`achieve_answer` gives the same result on all 52,413 checked queries. + +The **corrected** filter, the +H default, takes the easy answers of `2in` and +`pni` on FB15k-237+H and NELL995+H from the authors' `2in/all` and `pni/all` +files and keeps every root hard answer. Preparation checks those files against +the complete graph and pins them in the study. Every prediction is also scored +with the **released** filters as a control. Test facts are used only for this +offline audit. On all FB15k-237+H `2in` queries, a CPU QTO diagnostic with +train+valid facts scores 16.11 MRR with released and 10.59 with corrected +filters, against the published 10.6; with training facts only, 13.16 and 9.62. + +## +H inference graphs + +Graph-based methods (GNN-QE, UltraQuery, QTO, CQD-Hybrid, ULTRA and TRIX) +answer test queries over train+valid facts by default, the observed graph from +which the released test difficulty groups were built. Validation always uses +training facts. The released GNN-QE, UltraQuery and QTO loaders use training +facts for these transductive graphs, and the +H CQD-Hybrid loader uses +train+valid for FB15k-237+H and NELL995+H but skips observed filters for +ICEWS18+H. Both graph conditions can be compared directly (see the README's +ablations); reference metadata records each upstream loader's own setting. + +## Operators + +[Appendix F](https://arxiv.org/html/2410.12537v3#A6) of the +H paper specifies +the minimum t-norm for FB15k-237+H `2u`. With it, full-query CPU diagnostics +give CQD 27.77 and CQD-Hybrid 27.77 MRR; with the product t-norm, 40.05 and +42.17, against the published 40.1 and 42.2. The recipes therefore use product +for this query type. This is an inferred documentation mismatch, not proof of +the original command. The substitution does not explain `up`: product gives +7.88 (CQD) and 9.33 (CQD-Hybrid), below the minimum t-norm's 9.15 and 11.06 and +the published 10.6 and 12.0, so `up` keeps the documented minimum and remains +unreproduced. + +## Verification + +Every published method is a native port. Verification runs the frozen +validation batches through the pinned upstream code and the port with identical +inputs, and requires scores within tolerance (absolute and relative 3e-5) and +identical candidate order and ties for every query type. Reference graph hashes +must match both validation and test graphs. Upstream batch composition is +preserved: methods whose released code batches queries (ConE, CLMPT, GNN-QE, +UltraQuery) receive the same reference batches. + +Verification establishes the port under the declared inputs. It does not +establish the unpublished command behind every paper score; small remaining +differences, such as NELL995+H CLMPT, are not attributed to the authors without +evidence. For ULTRA and TRIX, an independent implementation recomputes context +features, calibration, pruning, composition and identity controls from captured +backbone logits; backbone checkpoint parity is tested separately. + +The bounded CQD profile is verified against an equally bounded reference and +can differ numerically from dense upstream execution. + +## Reproducibility + +Inference is float32 with IEEE matrix products, no autocast and deterministic +algorithms. Message passing in ULTRA, TRIX, UltraQuery and GNN-QE reduces each +node's edges in a fixed order, so scores do not depend on thread scheduling. +Studies pin the input files, query batches, source code, runtime image and GPU +model, and refuse to run when any of them changes. Resuming a study requires +the same identity; completed entries are never recomputed. + +Matrix products in the backbones are not batch-invariant: the same query can +receive different last bits in a different atomic batch. The KGFM adapters +reuse backbone rows through caches, so cache budgets, batch sizes and the +point at which an interrupted run resumes with empty caches can change the +last bits of later scores. Batch and cache settings are therefore frozen with +each study, verified with exact tie checks, and changed only in a new study. +A batch-invariant backbone would remove this dependence. + +## Answer-level difficulty + +`difficulty-report` assigns each +H hard answer its minimum number of missing +positive links over full-graph witnesses, relative to train+valid facts for +every method. Intersections add costs, unions take the cheapest branch, and +negated branches restrict truth without adding cost, following the paper's +positive reasoning trees; negative-edge difficulty is not measured. Scores +average answers within participating queries, then queries within the parent +type; no average mixes parent types. + +The authors' released reductions are relative to train+valid, as their pinned +[generator](https://github.com/april-tools/is-cqa-complex/blob/d1ce74164936a7c09d9147e83190da047cb39429/create_queries.py) +shows. They are reported separately, and their union reductions are not +translated into link counts. + +## Upstream evaluation edge case + +UltraQuery's `batch_evaluate` masks excluded candidates with `-inf`, yet can +still count them ahead of a hard answer whose score is also `-inf`: with six +`-inf` scores, candidates `[0, 2, 4]` and hard answer 2, it returns rank 3 +where the candidate-only rank is 2. The shared evaluator ranks candidates only. +Native UltraQuery returns finite logits, so this does not affect its published +results, and finite-score parity remains required. diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md new file mode 100644 index 000000000..f80c9a53a --- /dev/null +++ b/benchmarks/cqa/README.md @@ -0,0 +1,206 @@ +# Complex query answering benchmarks + +Reproducible evaluation of complex query answering (CQA) on two suites: + +| Suite | Datasets | Query types | Answer filters | +|---|---|---|---| +| `ultraquery` | The 23 released UltraQuery datasets: 3 transductive, 9 inductive with new entities, 11 WikiTopics with new entities and relations | 14 (9 positive, 5 negated) | released | +| `plus_h` | **+H**: FB15k237+H, NELL995+H and ICEWS18+H from [Gregucci et al.](https://arxiv.org/abs/2410.12537), built so that complex queries cannot be reduced to simpler link prediction | 16 (adds `4p`, `4i`) | corrected, with released controls | + +Each suite evaluates published methods (UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, +ConE, CLMPT) through native DICE ports and the ULTRA and TRIX foundation models +with learned score adapters, each paired with an identity-adapter control. Every +prediction is scored under two tie policies: sort order, and the exact +expectation under random ordering of tied scores. + +A study freezes its inputs, query batches and source code, checks validation +predictions against the pinned upstream implementations, and only then runs +the test split. [PROTOCOL.md](PROTOCOL.md) states the evaluation protocol and +every known deviation from the publications. + +## Quick start + +Everything runs through one command line from the repository root: + +```bash +python -m benchmarks.cqa {plus_h,ultraquery} COMMAND [options] +``` + +Commands run in the current environment, which needs DICE and PyTorch. With +`--image IMAGE` they run in the pinned Docker runtime instead; the host then +needs only Python 3, Docker and, for GPUs, the NVIDIA Container Toolkit. +Containers have no network access, read inputs from `--input-root` (default: +the repository) read-only, and write only below `--output`; `--gpu cdi` +selects CDI device access and `--gpu none` runs on CPU. + +Exploratory evaluation of any subset needs no preparation: + +```bash +python -m benchmarks.cqa plus_h evaluate --output results/cqd-negation \ + --methods cqd cqd-hybrid --datasets FB15k237+H --query-types negation +``` + +The full verified workflow for one suite: + +```bash +export IMAGE=dicee/cqa:local STUDY="$PWD/results/plus-h" +python -m benchmarks.cqa plus_h build --image "$IMAGE" # one image serves both suites +python -m benchmarks.cqa plus_h prepare --image "$IMAGE" --output "$STUDY" +# Export one validation oracle per published-method entry (see Verification). +python -m benchmarks.cqa plus_h verify --image "$IMAGE" --output "$STUDY" --references "$PWD/references" +python -m benchmarks.cqa plus_h run --image "$IMAGE" --output "$STUDY" +python -m benchmarks.cqa plus_h report --image "$IMAGE" --results "$STUDY/test" --output "$STUDY/reports" +``` + +| Command | Purpose | +|---|---| +| `setup` | Download the selected datasets and released checkpoints and install the shipped adapters; `--check` only reports missing files and checksum mismatches | +| `evaluate` | Direct evaluation of recipe subsets, without a frozen study | +| `prepare` | Resolve recipes and freeze inputs, query batches and source in `STUDY/bundle` | +| `verify` | Check every entry against its oracle in a fresh process and pin the evidence in `STUDY/verified-bundle` | +| `run` | Run the test split of a verified study into `STUDY/test`, or a validation pilot into `STUDY/pilot` with `--phase pilot` | +| `report` | Tables, paired adapter/filter/graph effects and comparisons with published scores, from completed results | +| `difficulty-report` | Answer-level difficulty of completed +H results, on CPU | +| `train` | Train the UltraQuery comparison baselines with pinned author code | +| `build` | Build the runtime image, or with `--training BASE_IMAGE` the CPU author-training image | + +`setup` runs on the host with only the standard library. `evaluate`, `prepare` +and `run` call it first; `--no-setup` instead requires existing inputs. +Downloads are streamed with bounded buffers and disk-space checks, released +checkpoints are checked by SHA-256, and existing files are never replaced. If +the +H authors' model host rejects automated downloads, pass +`--models-archive iscqa-compl-models.zip`. `--dry-run` prints resolved recipes, +input sources or the Docker command without reading inputs or writing files. + +## Recipes and selection + +A recipe fixes method, checkpoint, dataset, query types, query batches and +execution options. Each suite directory holds its public recipes: + +| File | Contents | +|---|---| +| `plus_h/baselines.json` | The seven published methods on the three +H datasets (21 entries) | +| `plus_h/kgfm_adapters.json` | ULTRA and TRIX with 14-type adapters (6 entries, each with an identity control) | +| `plus_h/published_results.json` | Scores reported by the +H authors, for `report` | +| `ultraquery/baselines.json` | Native UltraQuery on all 23 datasets | +| `ultraquery/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters on all 23 datasets | +| `ultraquery/comparisons.json` | ULTRA link-prediction weights, an incoming-relation heuristic and QTO | +| `ultraquery/trained_baselines.json` | QTO on FB15k and inductive GNN-QE, after `train` | + +Defaults are `baselines.json` and `kgfm_adapters.json`; `--manifests FILE ...` +replaces them. Adapter weights shared by both suites are in +[`benchmarks/adapters`](../adapters). Recipe files list shared `defaults` once +per method, and each entry only what differs; `{dataset}` in an ID is filled in. +[`tests/recipe_fingerprints.json`](tests/recipe_fingerprints.json) pins every +resolved entry, so a recipe change is always visible in review. + +Selectors combine freely and apply to every command that reads recipes: + +- `--methods`, `--datasets`, `--entries`: omit them or pass `all` for every recipe. +- `--query-types`: individual types and the groups `epfo`, `negation` and `all`, + for example `--query-types epfo 2in`. Omit it to keep each recipe's coverage. +- `--split valid` and `--max-queries-per-shape N` give reproducible samples. + +The +H CQD and CQD-Hybrid recipes cover all 16 types, using signed-atom (CQD-A) +negation with +H scoring; `--atomic-negation` enables it for custom recipes. +Query types and execution options are chosen when a study is prepared and +cannot change on `run`; `run` accepts method, dataset and entry selectors +within the frozen study. Repeating a command resumes completed work. + +## Verification + +`verify` compares each published method's validation predictions with an +oracle exported from its pinned upstream checkout (`REFERENCES` in +[`dicee/query_answering/catalog.py`](../../dicee/query_answering/catalog.py)). +Export one oracle per entry in an environment with the authors' dependencies, +matching Python, PyTorch, CUDA, GPU, driver, precision and threads: + +```bash +python benchmarks/cqa/verification/export_reference.py \ + --bundle "$STUDY/bundle" --input-root "$PWD" --entry cqd-FB15k237+H \ + --upstream "$UPSTREAM_CQD" --device cuda --output references/cqd-FB15k237+H.pt +``` + +The exporter imports no DICE code. Acceptance needs scores within tolerance and +identical candidate order and ties for every query. ULTRA/TRIX entries need no +oracle: an independent implementation checks calibration, pruning, composition +and identity controls on captured backbone logits; the backbones' own parity is +tested separately. Evidence binds inputs, query batches, source, image and +hardware; a change to any of them needs a new study. For the bounded profile, +`--comparison-references` additionally compares CQD with dense oracles. + +The default `bounded` profile runs CQD and CQD-Hybrid in 8 GB of GPU memory +(`row_batch_size` and `final_batch_size` 32, no reference batching) with +unchanged beams; `--profile reference` keeps dense upstream batching. Oracles +must come from a study prepared with the same profile. + +## Ablations + +Each ablation is a separate study with its own verification. + +- **Inference graph** (+H): `prepare --inference-graphs train train+valid`. + Graph-based methods use train+valid facts by default; ConE, CLMPT and CQD do + not read the graph and run once. IDs gain `-graph-train` or `-graph-train-valid`. +- **Observed facts** (ULTRA/TRIX): `prepare --observed-facts none atomic` or + `all`, with unchanged adapter weights. IDs gain `-facts-MODE`. +- **Answer filters** (+H): every prediction is also scored with the released + filters (`-released-filters`); `--answer-filter released` prepares a study + with released filters only. +- **Adapters**: every ULTRA/TRIX entry has a `without-adapter` control scored + from the same backbone batches. + +`report` writes paired effects with query-bootstrap confidence intervals +conditional on the frozen weights: `adapter-effects`, `filter-effects` and +`graph-effects`. + +## Hardware and parallelism + +`--hardware-profile h100` (on `prepare` or `evaluate`) is a starting point for +H100 80 GB and H100 NVL GPUs: ULTRA/TRIX use atomic batches of 16, a 4 GiB +budget for calibrated scores, 2 GiB of raw scores on the GPU, and 256/512 MiB +relation/projection caches. `--kgfm-batch-size N` overrides the batch. Other +methods keep their settings. These settings can change floating-point results, +so they are frozen with the study and verified on the target GPU. + +`run` and `evaluate` accept `--gpus 0 1 2 3`: each entry runs in a fresh worker +that sees one GPU, longest methods first, with results identical to a +sequential run. `--workers-per-gpu 2` overlaps one worker's host work with +another's GPU work; with the H100 profile a KGFM worker needs about 6 GiB. Keep +one worker per GPU on GPUs shared with other jobs. + +## UltraQuery comparison baselines + +`trained_baselines.json` needs weights trained locally with pinned author code +(QTO and InductiveQE checkouts below `Experiments/query-baselines/upstream` in +the input root). Training defaults to CPU and the authors' hyperparameters, +selects checkpoints on validation MRR only, and records code revisions, inputs, +environment and checkpoint hashes in `training.json`: + +```bash +python -m benchmarks.cqa ultraquery build --image "$IMAGE-training" --training "$IMAGE" +python -m benchmarks.cqa ultraquery train --image "$IMAGE-training" \ + --output "$PWD/checkpoints/ultraquery_benchmark-trained" --methods qto inductive-gnnqe +``` + +Each job also writes a `manifest.json` for its checkpoint; at the default +output path above, `trained_baselines.json` finds the checkpoints directly. + +Inductive GNN-QE requires the complete corrected v2.0 InductiveQE archives +([Zenodo 7306046](https://zenodo.org/records/7306046)); every file is checked +against [`inductive-v2-files.json`](../ultraquery/inductive-v2-files.json). +`--smoke` trains a tiny model for one update, and final runs reject it. The +author runtime applies three mechanical TorchDrug build fixes +([`training/torchdrug_compat.py`](training/torchdrug_compat.py)) without +changing kernel arithmetic. + +## Tests + +```bash +python -m pytest benchmarks +``` + +runs the harness and protocol tests on CPU without datasets. Tests that +need upstream checkouts or released data are skipped unless configured: +`DICEE_CQD_REFERENCE`, `DICEE_ULTRAQUERY_REFERENCE_ROOT`, +`DICEE_INDUCTIVE_REFERENCE_ROOT` and `DICEE_ULTRAQUERY_DATA_ROOT` point to the +pinned checkouts and the extracted UltraQuery data. diff --git a/benchmarks/cqa/__init__.py b/benchmarks/cqa/__init__.py new file mode 100644 index 000000000..b647dec1b --- /dev/null +++ b/benchmarks/cqa/__init__.py @@ -0,0 +1,4 @@ +"""Reproducible complex-query benchmarks: +H and UltraQuery. + +Run ``python -m benchmarks.cqa --help``. +""" diff --git a/benchmarks/cqa/__main__.py b/benchmarks/cqa/__main__.py new file mode 100644 index 000000000..4e28416e1 --- /dev/null +++ b/benchmarks/cqa/__main__.py @@ -0,0 +1,3 @@ +from .cli import main + +main() diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py new file mode 100644 index 000000000..0b8f87b67 --- /dev/null +++ b/benchmarks/cqa/cli.py @@ -0,0 +1,485 @@ +"""Prepare, verify, run and report the reproducible complex-query benchmarks. + + python -m benchmarks.cqa {plus_h,ultraquery} COMMAND [options] + +Commands run in this process, which needs dicee and PyTorch, or with ``--image`` +inside the pinned Docker runtime; the host then needs only Python 3 and Docker. +""" + +import argparse +import json +import os +import shutil +import subprocess +import sys +import time +from pathlib import Path + +from . import docker, inputs +from .manifests import REPO, SUITES, default_recipes, prepare_manifest, read_manifest, select_entries, suite_directory + +# Longest expected runtimes start first, so short entries fill the remaining slots. +RUNTIME_ORDER = ('trix-adapter', 'ultra-adapter', 'gnnqe', 'cqd-hybrid', 'cqd', 'qto') +# Container GPU access per command; other commands always run on the host. +CONTAINER_GPU = {'evaluate': 'runtime', 'prepare': 'none', 'verify': 'runtime', 'run': 'runtime', + 'report': 'none', 'difficulty-report': 'none', 'train': 'none'} +HOST_OPTIONS = {'image', 'gpu', 'dry_run', 'models_archive', 'input_root', 'output', 'no_setup'} + + +def write_json(path, value): + path = Path(path) + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text(json.dumps(value, indent=2) + '\n') + + +def build_parser(): + parser = argparse.ArgumentParser(prog='python -m benchmarks.cqa', description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('suite', choices=SUITES) + commands = parser.add_subparsers(dest='command', required=True) + add = {} + + def command(name, help, *, hidden=False): + add[name] = commands.add_parser(name, help=argparse.SUPPRESS if hidden else help, description=help) + add[name].add_argument('--input-root', type=Path, default=REPO, help='Root of datasets and checkpoints (default: repository)') + return add[name] + + def selection(p, *, query_types=True): + p.add_argument('--entries', nargs='+', action='extend', help='Entry IDs') + p.add_argument('--methods', nargs='+', action='extend', help='Methods; omit or use all for every recipe') + p.add_argument('--datasets', nargs='+', action='extend', help='Datasets; omit or use all for every recipe') + if query_types: + p.add_argument('--query-types', nargs='+', action='extend', help='Query types or groups: all, epfo, negation') + p.add_argument('--atomic-negation', action='store_true', help='CQD/CQD-Hybrid signed-atom negation for custom recipes') + + def recipes(p, *, ablations=False): + p.add_argument('--manifests', type=Path, nargs='+', action='extend', help='Recipe manifests (default: public recipes)') + p.add_argument('--profile', choices=('bounded', 'reference'), default='bounded', + help='CQD batching: bounded (8 GB GPUs) or dense reference batches') + p.add_argument('--hardware-profile', choices=('default', 'h100'), default='default', + help='KGFM batch/cache starting point; requires fresh verification') + p.add_argument('--kgfm-batch-size', type=int, help='Atomic row and backbone batch of KGFM adapters') + p.add_argument('--answer-filter', choices=('released', 'corrected'), + help='+H default: corrected with released controls; UltraQuery: released only') + if ablations: + p.add_argument('--observed-facts', nargs='+', action='extend', choices=('none', 'atomic', 'both', 'all'), + help='KGFM observed-fact ablations with unchanged adapter weights') + p.add_argument('--inference-graphs', nargs='+', action='extend', choices=('train', 'train+valid'), + help='+H only: test inference graphs (default: train+valid)') + + def inputs_options(p): + p.add_argument('--no-setup', action='store_true', help='Require existing inputs instead of downloading them') + p.add_argument('--models-archive', type=Path, help="Official +H weights ZIP if the authors' host is unavailable") + + def container(p): + p.add_argument('--image', help='Run inside this pinned Docker image (tag or image ID)') + p.add_argument('--gpu', choices=('runtime', 'cdi', 'none'), help='Docker GPU access') + p.add_argument('--dry-run', action='store_true', help='Print the command without running it') + + def parallel(p): + p.add_argument('--gpus', nargs='+', help='Run entries concurrently, one listed GPU (index or UUID) per worker') + p.add_argument('--workers-per-gpu', type=int, default=1, help='Concurrent entries per GPU (default: 1)') + + p = command('setup', 'Download missing datasets and checkpoints and install shipped adapters; no inference') + recipes(p, ablations=True) + selection(p) + p.add_argument('--models-archive', type=Path, help="Official +H weights ZIP if the authors' host is unavailable") + p.add_argument('--check', action='store_true', help='Only report missing inputs and checksum mismatches') + p.add_argument('--dry-run', action='store_true', help='Print sources without downloading') + + p = command('evaluate', 'Evaluate recipe subsets directly, without frozen-study verification') + recipes(p) + selection(p) + p.add_argument('--output', type=Path, required=True) + p.add_argument('--device', default='cuda') + p.add_argument('--split', choices=('valid', 'test'), default='test') + p.add_argument('--max-queries-per-shape', type=int, help='Uniform sample of each query type') + p.add_argument('--seed', type=int) + p.add_argument('--threads', type=int) + inputs_options(p) + parallel(p) + container(p) + + p = command('prepare', 'Resolve recipes and freeze inputs, query batches and source in OUTPUT/bundle') + recipes(p, ablations=True) + selection(p) + p.add_argument('--output', type=Path, required=True, help='Study directory, below the input root for Docker') + inputs_options(p) + container(p) + + p = command('verify', 'Check validation parity and pin the evidence in OUTPUT/verified-bundle') + p.add_argument('--output', type=Path, required=True, help='Study directory containing bundle/') + p.add_argument('--references', type=Path, help='Directory of exported baseline oracles, REFERENCES/ENTRY.pt') + p.add_argument('--comparison-references', type=Path, help='Optional dense CQD oracles for comparison reporting') + p.add_argument('--device', default='cuda') + p.add_argument('--study-path', help=argparse.SUPPRESS) + container(p) + + p = command('run', 'Run frozen entries: a validation pilot, or the test after verification') + p.add_argument('--output', type=Path, required=True, help='Study directory; results go to OUTPUT/PHASE') + selection(p, query_types=False) + p.add_argument('--phase', choices=('pilot', 'test'), default='test', help='pilot uses bundle/, test verified-bundle/') + p.add_argument('--device', default='cuda') + p.add_argument('--pilot-queries', type=int, default=2, help='Minimum queries per type, rounded up to whole reference batches') + p.add_argument('--worker', action='store_true', help=argparse.SUPPRESS) + inputs_options(p) + parallel(p) + container(p) + + p = command('report', 'Recompute tables and paired deltas from completed results; no inference') + p.add_argument('--results', type=Path, required=True) + p.add_argument('--output', type=Path, required=True) + p.add_argument('--published', type=Path, help="Published scores (default: the suite's published_results.json)") + p.add_argument('--bootstrap-samples', type=int, default=2000) + p.add_argument('--seed', type=int, default=0) + container(p) + + p = command('difficulty-report', 'Answer-level difficulty from completed frozen rank traces; CPU only') + p.add_argument('--results', type=Path, required=True) + p.add_argument('--bundle', type=Path, required=True) + p.add_argument('--output', type=Path, required=True, help='New directory outside frozen results and bundles') + p.add_argument('--labels-root', type=Path, help='Separate extraction root for released reduction labels') + p.add_argument('--entries', nargs='+', action='extend', help='Completed result IDs, including control suffixes') + p.add_argument('--query-types', nargs='+', action='extend', help='Report-only query-type subset') + container(p) + + p = command('train', 'Train UltraQuery baselines in the author runtime (UltraQuery suite)') + from .train import add_arguments + add_arguments(p) + container(p) + + p = command('build', 'Build the pinned Docker runtime, or the CPU author-training runtime with --training') + p.add_argument('--image', required=True, help='Tag for the new image') + p.add_argument('--training', metavar='BASE_IMAGE', help='Build the training runtime on top of this benchmark image') + p.add_argument('--cache', type=Path, help='Wheel cache (default: ~/.cache/dicee/cqa)') + p.add_argument('--network', default='default', help='Use host if Docker bridge DNS is unavailable') + + p = command('parity', 'Verify one baseline against its exported oracle', hidden=True) + p.add_argument('--bundle', type=Path, required=True) + p.add_argument('--entry', required=True) + p.add_argument('--reference', type=Path, required=True) + p.add_argument('--comparison-reference', type=Path) + p.add_argument('--output', type=Path, required=True) + p.add_argument('--device', default='cuda') + + p = command('integration', 'Verify one KGFM adapter pipeline against the independent reference', hidden=True) + p.add_argument('--bundle', type=Path, required=True) + p.add_argument('--entry', required=True) + p.add_argument('--output', type=Path, required=True) + p.add_argument('--device', default='cuda') + p.add_argument('--probes', type=int, default=2, help='Reference-checked queries per type') + return parser, add + + +def arguments(parser, args, *, translate=None, skip=()): + """Command-line options that reproduce the non-default values of ``args``.""" + def text(value): + return translate(value) if translate is not None and isinstance(value, Path) else str(value) + + argv = [] + for action in parser._actions: + if not action.option_strings or action.dest in skip: + continue + value = getattr(args, action.dest, action.default) + if value is None or value == action.default: + continue + flag = action.option_strings[-1] + if action.nargs == 0: + argv.append(flag) + elif isinstance(value, list): + argv += [flag, *map(text, value)] + else: + argv += [flag, text(value)] + return argv + + +def resolve(args): + """Recipes selected by ``args``, with the suite's default manifests and answer filter.""" + return prepare_manifest(args.manifests or default_recipes(args.suite), profile=args.profile, + entries=args.entries, methods=args.methods, datasets=args.datasets, + query_types=getattr(args, 'query_types', None), atomic_negation=getattr(args, 'atomic_negation', False), + observed_facts=getattr(args, 'observed_facts', None), inference_graphs=getattr(args, 'inference_graphs', None), + answer_filter=args.answer_filter or SUITES[args.suite]['answer_filter'], suite=args.suite, + hardware_profile=args.hardware_profile, kgfm_batch_size=args.kgfm_batch_size) + + +def ensure_inputs(args, manifest): + if not args.no_setup: + inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, models_archive=args.models_archive) + else: + inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, download_missing=False) + + +def in_container(parser, args): + """Run the same command in Docker: inputs read-only at /inputs, OUTPUT writable at /results.""" + root, output = args.input_root.resolve(), args.output.resolve() + if not root.is_dir() or output == root or not output.is_relative_to(root): + raise ValueError('--output must be a directory strictly below an existing --input-root') + + def mapped(value): + path = Path(value).resolve() + if path.is_relative_to(output): + return Path('/results', path.relative_to(output)).as_posix() + if path.is_relative_to(root): + return Path('/inputs', path.relative_to(root)).as_posix() + raise ValueError(f'{value} must be below --input-root') + + argv = [args.suite, args.command, '--input-root', '/inputs', '--output', '/results', + *arguments(parser, args, translate=mapped, skip=HOST_OPTIONS | {'manifest_output_root', 'study_path'})] + if args.command == 'train': + # Generated manifests refer to checkpoints by their path below the input root. + argv += ['--manifest-output-root', Path('/inputs', output.relative_to(root)).as_posix()] + if args.command == 'verify': + argv += ['--study-path', output.relative_to(root).as_posix()] + if any(action.dest == 'no_setup' for action in parser._actions): + argv.append('--no-setup') + if not args.dry_run and not args.no_setup: + manifest = (read_manifest(output / ('verified-bundle' if args.phase == 'test' else 'bundle') / 'bundle.json') + if args.command == 'run' else resolve(args)) + inputs.ensure_inputs(manifest, root, suite=args.suite, models_archive=args.models_archive) + gpu = args.gpu or CONTAINER_GPU[args.command] + if gpu == 'none' and getattr(args, 'device', 'cpu') != 'cpu': + raise ValueError('Without container GPU access (--gpu none), use --device cpu') + if not args.dry_run: + output.mkdir(parents=True, exist_ok=True) + docker.run(args.image, argv, inputs=root, results=output, gpu=gpu, dry_run=args.dry_run) + + +def run_workers(jobs, *, status, gpus=None, workers_per_gpu=1): + """Run (entry, method, command, log) jobs in fresh processes, optionally one GPU per worker. + + Results do not depend on scheduling: each worker has its own checkpoint and + output. After a failure no new entry starts; running workers finish. + Returns the failed (entry, exit code) pairs. + """ + slots = [gpu for gpu in gpus for _ in range(workers_per_gpu)] if gpus else [None] + pending = sorted(jobs, key=lambda job: RUNTIME_ORDER.index(job[1]) if job[1] in RUNTIME_ORDER else len(RUNTIME_ORDER)) + running, failed = {}, [] + + def report(): + write_json(status, dict(state='running', running={entry: dict(pid=process.pid, gpu=gpu) + for process, (entry, gpu, _) in running.items()}, + pending=[job[0] for job in pending], failed=[entry for entry, _ in failed])) + + while running or (pending and not failed): + while pending and slots and not failed: + entry, _, command, log = pending.pop(0) + gpu = slots.pop(0) + print(json.dumps(dict(entry=entry, state='starting', gpu=gpu)), flush=True) + stream = log.open('ab', buffering=0) + environment = os.environ if gpu is None else dict(os.environ, CUDA_VISIBLE_DEVICES=str(gpu)) + process = subprocess.Popen(command, stdin=subprocess.DEVNULL, stdout=stream, stderr=subprocess.STDOUT, env=environment) + running[process] = entry, gpu, stream + report() + finished = [process for process in running if process.poll() is not None] + if not finished: + time.sleep(0.5) + continue + for process in finished: + entry, gpu, stream = running.pop(process) + stream.close() + slots.append(gpu) + if process.returncode: + failed.append((entry, process.returncode)) + print(json.dumps(dict(entry=entry, state='failed' if process.returncode else 'complete', + exit_code=process.returncode)), flush=True) + report() + return failed + + +def entry_jobs(parser, args, entries, output, *flags): + """One fresh worker process per entry, repeating this command for that entry alone.""" + common = arguments(parser, args, skip={'entries', 'methods', 'datasets', 'gpus', 'workers_per_gpu', 'no_setup', 'dry_run'}) + jobs = [] + for entry in entries: + (output / entry['id']).mkdir(parents=True, exist_ok=True) + jobs.append((entry['id'], entry['method'], + [sys.executable, '-u', '-m', 'benchmarks.cqa', args.suite, args.command, *common, + '--entries', entry['id'], '--no-setup', *flags], + output / entry['id'] / 'worker.log')) + return jobs + + +def finish(jobs, args, output, ids): + failed = run_workers(jobs, status=output / 'status.json', gpus=args.gpus, workers_per_gpu=args.workers_per_gpu) + if failed: + write_json(output / 'status.json', dict(state='failed', exit_codes=dict(failed))) + raise SystemExit('Failed entries (see worker.log): ' + ', '.join(entry for entry, _ in failed)) + write_json(output / 'status.json', dict(state='complete', entries=ids)) + + +def setup(parser, args): + manifest = resolve(args) + if args.dry_run: + inputs.describe(manifest, args.input_root.resolve(), suite=args.suite) + elif args.check: + if inputs.check(manifest, args.input_root.resolve(), suite=args.suite): + raise SystemExit(1) + else: + inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, models_archive=args.models_archive) + print('Inputs ready. No model was loaded and no benchmark was started.') + + +def evaluate(parser, args): + manifest = resolve(args) + if args.dry_run: + print(json.dumps(manifest, indent=2)) + return + ensure_inputs(args, manifest) + if args.gpus: + finish(entry_jobs(parser, args, manifest['entries'], args.output), args, args.output, + [entry['id'] for entry in manifest['entries']]) + return + from .evaluate import evaluate_manifest + evaluate_manifest(manifest, input_root=args.input_root, output=args.output, device=args.device, split=args.split, + limit=args.max_queries_per_shape, seed=args.seed, threads=args.threads) + + +def prepare(parser, args): + if (args.output / 'bundle' / 'bundle.json').exists(): + raise ValueError('Use a new output directory to change a frozen profile') + manifest = resolve(args) + if args.dry_run: + print(json.dumps(manifest, indent=2)) + return + ensure_inputs(args, manifest) + from .study import freeze + bundle = freeze(manifest, args.output / 'bundle', args.input_root) + write_json(args.output / 'manifest.json', manifest) + print(json.dumps(dict(profile=args.profile, entries=len(manifest['entries']), source=bundle['source_sha256']))) + + +def verify(parser, args): + """Run every entry's parity check in a fresh process, then freeze the passing evidence.""" + from .study import freeze, verify_bundle + study, root = args.output.resolve(), args.input_root.resolve() + if (study / 'verified-bundle' / 'bundle.json').exists(): + raise ValueError('A verified bundle already exists; use a new output directory for new evidence') + # Evidence is pinned by its path below the input root, valid on the host and in containers. + if args.study_path is None and not study.is_relative_to(root): + raise ValueError('The study directory must be below --input-root, where evidence paths are recorded') + relative = Path(args.study_path) if args.study_path is not None else study.relative_to(root) + manifest = verify_bundle(study / 'bundle', root)['manifest'] + jobs = [] + for entry in manifest['entries']: + common = [sys.executable, '-u', '-m', 'benchmarks.cqa', args.suite] + options = ['--bundle', str(study / 'bundle'), '--input-root', str(root), '--entry', entry['id'], '--device', args.device] + if entry['method'].endswith('-adapter'): + target = study / 'verification' / entry['id'] + if (target / 'pilot').exists(): + raise ValueError(f'KGFM verification requires a fresh directory: {target}') + jobs.append((entry['id'], [*common, 'integration', *options, '--output', str(target)])) + continue + reference = args.references / f'{entry["id"]}.pt' if args.references else None + if reference is None or not reference.is_file(): + raise ValueError(f'Missing baseline oracle {entry["id"]}.pt; pass --references') + command = [*common, 'parity', *options, '--reference', str(reference), '--output', str(study / 'evidence' / f'{entry["id"]}.json')] + if args.comparison_references and entry['method'] in ('cqd', 'cqd-hybrid'): + comparison = args.comparison_references / f'{entry["id"]}.pt' + if not comparison.is_file(): + raise ValueError(f'Missing comparison oracle: {comparison}') + command += ['--comparison-reference', str(comparison)] + jobs.append((entry['id'], command)) + for entry, command in jobs: + print(json.dumps(dict(entry=entry, state='verifying')), flush=True) + if subprocess.run(command).returncode: + raise SystemExit(f'Verification of {entry} failed; see its output above') + for entry in manifest['entries']: + evidence = study / 'evidence' / f'{entry["id"]}.json' + if entry['method'].endswith('-adapter'): + evidence.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(study / 'verification' / entry['id'] / 'integration.json', evidence) + if not json.loads(evidence.read_text()).get('passed'): + raise ValueError(f'Verification failed: {entry["id"]}') + entry['verification'] = (relative / 'evidence' / evidence.name).as_posix() + write_json(study / 'verified-manifest.json', manifest) + freeze(manifest, study / 'verified-bundle', root) + print(json.dumps(dict(verified=len(manifest['entries']), bundle=str(study / 'verified-bundle')))) + + +def run(parser, args): + from dicee.query_answering._checkpoint import BenchmarkCheckpoint, checksum + + from .study import run_job, verify_bundle + bundle_dir = args.output / ('verified-bundle' if args.phase == 'test' else 'bundle') + results = args.output / args.phase + if not args.worker: + ensure_inputs(args, read_manifest(bundle_dir / 'bundle.json')) + bundle = verify_bundle(bundle_dir, args.input_root) + entries = select_entries(bundle['manifest']['entries'], entry_ids=args.entries, methods=args.methods, datasets=args.datasets) + if args.worker: + if len(entries) != 1: + raise ValueError('A worker takes one entry') + result = run_job(bundle_dir, entries[0]['id'], args.input_root, results / entries[0]['id'], + device=args.device, phase=args.phase, pilot_queries=args.pilot_queries) + print(json.dumps(dict(entry=entries[0]['id'], queries=result['queries'], averages=result['averages'])), flush=True) + return + # Parallelism is excluded from the suite identity: it cannot change results. + identity = dict(bundle=checksum(bundle_dir / 'bundle.json'), phase=args.phase, device=args.device, pilot_queries=args.pilot_queries) + with BenchmarkCheckpoint(results / 'suite', identity): + finish(entry_jobs(parser, args, entries, results, '--worker'), args, results, [entry['id'] for entry in entries]) + + +def report(parser, args): + from .reports import export_reports + published = args.published or suite_directory(args.suite) / 'published_results.json' + rows = export_reports(args.results, published if published.is_file() else None, args.output, + bootstrap_samples=args.bootstrap_samples, seed=args.seed, title=SUITES[args.suite]['title']) + print(json.dumps(dict(results=len(rows), output=str(args.output)))) + + +def difficulty_report(parser, args): + from .difficulty import export_difficulty_reports + result = export_difficulty_reports(args.results, args.bundle, args.input_root, args.output, + labels_root=args.labels_root, entries=args.entries, query_types=args.query_types) + print(json.dumps(dict(rows=len(result['rows']), pending_main_entries=len(result['pending_main_entries']), output=str(args.output)))) + + +def train(parser, args): + if args.suite != 'ultraquery': + raise ValueError('Baseline training belongs to the UltraQuery suite') + from .train import run as run_training + run_training(args) + + +def build(parser, args): + docker.build(args.image, cache=args.cache, network=args.network, training_base=args.training) + + +def parity(parser, args): + from .oracles import verify_predictions + result = verify_predictions(args.bundle, args.entry, args.input_root, args.reference, args.output, + device=args.device, comparison_reference=args.comparison_reference) + print(json.dumps(dict(passed=result['passed'], queries=len(result['queries'])))) + if not result['passed']: + raise SystemExit(1) + + +def integration(parser, args): + from .verification.verify_kgfm import verify as verify_kgfm + verify_kgfm(args.bundle, args.entry, args.input_root, args.output, device=args.device, probes=args.probes) + + +HANDLERS = {'setup': setup, 'evaluate': evaluate, 'prepare': prepare, 'verify': verify, 'run': run, 'report': report, + 'difficulty-report': difficulty_report, 'train': train, 'build': build, 'parity': parity, + 'integration': integration} + + +def main(argv=None): + parser, commands = build_parser() + args = parser.parse_args(argv) + command = commands[args.command] + if getattr(args, 'gpus', None) is not None or getattr(args, 'workers_per_gpu', 1) != 1: + if args.workers_per_gpu < 1 or not args.gpus or len(set(args.gpus)) != len(args.gpus): + command.error('--gpus needs distinct devices and --workers-per-gpu a positive count') + if args.device not in ('cuda', 'cuda:0'): + command.error('With --gpus, use --device cuda; each worker sees only its assigned GPU') + for name in ('kgfm_batch_size', 'max_queries_per_shape', 'pilot_queries', 'bootstrap_samples', 'probes'): + if getattr(args, name, None) is not None and getattr(args, name) < (0 if name == 'bootstrap_samples' else 1): + command.error(f'--{name.replace("_", "-")} must be positive') + try: + if getattr(args, 'image', None) and args.command in CONTAINER_GPU: + return in_container(command, args) + return HANDLERS[args.command](command, args) + except ValueError as error: + command.error(str(error)) diff --git a/benchmarks/cqa/difficulty.py b/benchmarks/cqa/difficulty.py new file mode 100644 index 000000000..047ea0f17 --- /dev/null +++ b/benchmarks/cqa/difficulty.py @@ -0,0 +1,474 @@ +"""CPU-only answer-level difficulty analysis of immutable +H rank traces. + +Truth edges are label-generation input, never inputs to a predictor. Released +reduction names and minimum missing-positive-edge counts are distinct analyses: +the authors' test reduction files use train+valid (despite the paper's shorthand +"train"); in particular their union reductions are not min-plus edge counts. +""" + +import csv +import json +import math +import pickle +import sqlite3 +from collections import Counter, OrderedDict, defaultdict +from pathlib import Path + +import numpy as np + +import dicee.query_answering +from dicee.query_answering._checkpoint import checksum, read, write_json +from dicee.query_answering._query import PLUS_H_SHAPES, QUERY_SHAPES, compile_query, exact_answers +from dicee.query_answering.benchmark import METRICS +from dicee.query_answering.datasets import PLUS_H_REFERENCE_COMMIT, BenchmarkQuery, dataset_spec + +# This postprocessor and the library code that loads queries and computes metrics. +POSTPROCESSOR = (Path(__file__), *(Path(dicee.query_answering.__file__).with_name(name) for name in ( + '_query.py', 'context.py', '_checkpoint.py', 'datasets.py', 'benchmark.py', 'method_evaluation.py'))) + + +def postprocessor_files(): + return {f'{path.parent.name}/{path.name}': checksum(path) for path in POSTPROCESSOR} + + +# Explicit allowlist from the pinned author release; never treat all/ as a bin. +REDUCTIONS = { + '2p': ('1p', '2p'), '3p': ('1p', '2p', '3p'), '4p': ('1p', '2p', '3p', '4p'), + '2i': ('1p', '2i'), '3i': ('1p', '2i', '3i'), '4i': ('1p', '2i', '3i', '4i'), + 'ip': ('1p', '2i', '2p', 'ip'), 'pi': ('1p', '2i', '2p', 'pi'), + 'up': ('1p', '2u', 'up'), + **{s: ('pos-exist', 'pos-only-miss') for s in ('3in', 'pin', 'inp')}, +} + + +class DifficultyClassifier: + """Min-plus evaluation on valid full-truth witnesses of anchored trees. + + Cache size is bounded by the total number of entity records, not just keys. + Negative branches restrict truth and contribute no positive-edge cost. + """ + + def __init__(self, full_outgoing, observed_outgoing, num_entities, *, cache_answers=100000): + self.full = full_outgoing + self.observed = observed_outgoing + self.num_entities = num_entities + self.cache_answers = cache_answers + self.cache = OrderedDict() + self.cached_answers = 0 + + def costs(self, node): + if node in self.cache: + self.cache.move_to_end(node) + return self.cache[node] + op = node[0] + if op == 'anchor': + result = {node[1]: 0} + elif op == 'project': + result = {} + for head, cost in self.costs(node[2]).items(): + seen = self.observed.get(head, {}).get(node[1], ()) + for tail in self.full.get(head, {}).get(node[1], ()): + value = cost + int(tail not in seen) + if tail not in result or value < result[tail]: + result[tail] = value + elif op == 'and': + positives = [self.costs(c) for c in node[1:] if c[0] != 'not'] + if not positives: + raise ValueError('Difficulty requires a positive anchored branch') + smallest = min(positives, key=len) + result = {a: sum(part[a] for part in positives) for a in smallest if all(a in part for part in positives)} + for child in node[1:]: + if child[0] == 'not': + # Includes negated paths (pni), and restricts intermediate + # witnesses before the final projection in inp. + for answer in exact_answers(child[1], self.full, self.num_entities): + result.pop(answer, None) + elif op == 'or': + result = {} + for child in node[1:]: + for answer, value in self.costs(child).items(): + result[answer] = min(result.get(answer, value), value) + else: + raise ValueError(f'Unsupported difficulty operator: {op}') + size = max(1, len(result)) + if size <= self.cache_answers: + while self.cache and self.cached_answers + size > self.cache_answers: + _, evicted = self.cache.popitem(last=False) + self.cached_answers -= max(1, len(evicted)) + self.cache[node] = result + self.cached_answers += size + return result + + def classify(self, shape, query, hard): + if shape not in PLUS_H_SHAPES: + raise ValueError(f'Unsupported difficulty shape: {shape}') + tree = compile_query(query) + maximum = positive_edges(tree) + costs = self.costs(tree) + if set(hard) - costs.keys(): + raise ValueError(f'Hard targets are not true on the full graph: {shape} {query}') + result = {a: costs[a] for a in hard} + if any(not 0 <= cost <= maximum for cost in result.values()): + raise ValueError('Missing-positive-edge count outside tree bounds') + return result, maximum + + +def positive_edges(node): + if node[0] in ('anchor', 'not'): + return 0 + if node[0] == 'project': + return 1 + positive_edges(node[2]) + counts = [positive_edges(child) for child in node[1:]] + if node[0] == 'or': + if len(set(counts)) != 1: + raise ValueError('Unequal-size union branches have no single full-inference threshold') + return counts[0] + if node[0] == 'and': + return sum(counts) + raise ValueError('Unsupported difficulty tree') + + +def difficulty_name(cost, maximum): + return 'observed' if cost == 0 else 'full' if cost == maximum else 'partial' + + +def load_graphs(folder): + """Read public-ID truth/observed adjacencies once per dataset, CPU only.""" + folder = Path(folder) + graph = folder / 'KG_splits' if (folder / 'KG_splits').exists() else folder + full, train, extended = (defaultdict(lambda: defaultdict(set)) for _ in range(3)) + files = {} + for split in ('train', 'valid', 'test'): + path = graph / f'{split}.txt' + files[path.relative_to(folder).as_posix()] = checksum(path) + with path.open() as stream: + for line in stream: + if not line.strip(): + continue + h, r, t = map(int, line.split()) + # Same public reciprocal pairing as load_benchmark. + for head, relation, tail in ((h, r, t), (t, r ^ 1, h)): + full[head][relation].add(tail) + if split == 'train': + train[head][relation].add(tail) + if split != 'test': + extended[head][relation].add(tail) + with (folder / 'id2ent.pkl').open('rb') as stream: + n = len(pickle.load(stream)) + return full, {'train': train, 'train+valid': extended}, n, files + + +def root_queries(folder, shapes): + """Recover trace identity from root labels, including original easy filters. + + Corrected filters do not change RankTrace's identity or its hard targets. + Loading the raw pickles separately avoids retaining their many unused keys. + """ + folder = Path(folder) + with (folder / 'test-queries.pkl').open('rb') as stream: + structured = pickle.load(stream) + selected = {q: shape for shape in shapes for q in structured[QUERY_SHAPES[shape]]} + values = {} + for kind in ('easy', 'hard'): + with (folder / f'test-{kind}-answers.pkl').open('rb') as stream: + raw = pickle.load(stream) + if selected.keys() - raw.keys(): + raise ValueError(f'Missing root {kind} answers') + values[kind] = {q: frozenset(raw[q]) for q in selected} + del raw + records = {} + for q, shape in selected.items(): + easy, hard = values['easy'][q], values['hard'][q] + if not hard or easy & hard: + raise ValueError('Root hard answers must be nonempty and disjoint from easy answers') + key = BenchmarkQuery(shape, q, easy, hard).identity + records[key] = dict(shape=shape, query=q, hard=hard) + if len(records) != len(selected): + raise ValueError('Duplicate root query identities') + return records + + +def released_labels(folder, records, *, dataset, required=False): + """Join released hard-answer partitions to the retained root hard subset. + + A wholly absent family is explicitly unavailable unless required. A present + family must be complete, disjoint and cover every retained hard answer. + Extra released answers are counted and excluded, never added to evaluation. + """ + folder = Path(folder) + by_shape = defaultdict(dict) + for key, record in records.items(): + by_shape[record['shape']][record['query']] = (key, record['hard']) + labels, provenance = {}, {} + for shape, selected in by_shape.items(): + bins = REDUCTIONS.get(shape) + if bins is None or dataset == 'ICEWS18+H': + provenance[shape] = dict(status='unavailable', reason='No released reduction partition for this dataset/type') + continue + paths = {label: folder / 'test-query-reduction' / shape / label / 'test-hard-answers.pkl' for label in bins} + present = [p.exists() for p in paths.values()] + if not any(present) and not required: + provenance[shape] = dict(status='unavailable', reason='Released reduction files not supplied') + continue + if not all(present): + raise FileNotFoundError(f'Missing released reduction files: {[str(p) for p in paths.values() if not p.exists()]}') + assignments = {q: {} for q in selected} + extra = 0 + for label, path in paths.items(): + with path.open('rb') as stream: + raw = pickle.load(stream) + for q, answers in raw.items(): + if q not in selected: + extra += len(answers) + continue + _, hard = selected[q] + extra += len(set(answers) - hard) + for answer in set(answers) & hard: + if answer in assignments[q]: + raise ValueError(f'Overlapping released reduction labels: {shape} {q} {answer}') + assignments[q][answer] = label + for q, (key, hard) in selected.items(): + if assignments[q].keys() != hard: + raise ValueError(f'Missing released reduction labels for root hard targets: {shape} {q}') + labels[key] = assignments[q] + provenance[shape] = dict(status='available', label_reference_graph='train+valid', excluded_extra_answers=extra, + files={str(p): checksum(p) for p in paths.values()}) + return labels, provenance + + +def summarize_difficulty(path, records, classifier, *, author_labels=None, shapes=None): + """Conditional answer→query means plus additive original-query contributions.""" + totals = defaultdict(lambda: dict(queries=0, hard_answers=0, sums=np.zeros((2, 4)), + contribution=np.zeros((2, 4)), query_mass=0.)) + counts = defaultdict(Counter) + seen = set() + harmonic = np.zeros(1) + with sqlite3.connect(f'{Path(path).resolve().as_uri()}?mode=ro', uri=True) as connection: + for key, shape, payload in connection.execute('SELECT query_id, shape, answers FROM queries ORDER BY position'): + if shapes is not None and shape not in shapes: + continue + if key in seen or key not in records or records[key]['shape'] != shape: + raise ValueError('Trace query identity/shape does not match root labels') + seen.add(key) + record = records[key] + rows = json.loads(payload) + if not rows or any(len(row) != 4 or any(type(x) is not int for x in row) for row in rows): + raise ValueError('Malformed answer-rank records') + arr = np.asarray(rows, dtype=np.int64) + answers, ranks, greater, sizes = arr.T + if len(set(answers)) != len(answers) or set(answers) != record['hard']: + raise ValueError('Trace answer identities differ from the exact root hard targets') + if (greater < 0).any() or (sizes < 1).any() or (ranks <= greater).any() or (ranks > greater + sizes).any(): + raise ValueError('Inconsistent filtered rank / tie block') + last = greater + sizes + if last.max() >= len(harmonic): + harmonic = np.concatenate(([0.], np.cumsum(1. / np.arange(1, last.max() + 1)))) + values = np.stack((np.stack((1. / ranks, *(ranks <= k for k in (1, 3, 10))), axis=1), + np.stack(((harmonic[last] - harmonic[greater]) / sizes, + *(np.clip(k - greater, 0, sizes) / sizes for k in (1, 3, 10))), axis=1))) + costs, maximum = classifier.classify(shape, record['query'], record['hard']) + groups = defaultdict(list) + released = (author_labels or {}).get(key) + for index, answer in enumerate(answers): + cost = costs[answer] + groups['difficulty', difficulty_name(cost, maximum)].append(index) + groups['inferred_positive_edges', str(cost)].append(index) + groups['released_reduction', released[answer] if released else 'unavailable'].append(index) + groups['overall', 'all'] = list(range(len(answers))) + counts[shape].update(queries=1, hard_answers=len(answers), + labeled_author_answers=len(answers) if released else 0) + for (level, label), indices in groups.items(): + row = totals[shape, level, label, maximum] + selected = values[:, indices, :] + row['queries'] += 1 + row['hard_answers'] += len(indices) + row['sums'] += selected.mean(axis=1) + row['contribution'] += selected.sum(axis=1) / len(answers) + row['query_mass'] += len(indices) / len(answers) + if not seen: + raise ValueError('No completed trace queries for the requested types') + result = [] + for (shape, level, label, maximum), values in sorted(totals.items()): + count = counts[shape]['queries'] + result.append(dict(shape=shape, grouping=level, label=label, positive_edges=maximum, + one_positive_edge=maximum == 1, queries=values['queries'], hard_answers=values['hard_answers'], + parent_queries=count, parent_hard_answers=counts[shape]['hard_answers'], + query_weight=values['query_mass'] / count, + **{policy: dict(zip(METRICS, values['sums'][i] / values['queries'])) for i, policy in enumerate(('sort', 'expected'))}, + original_weight_contribution={policy: dict(zip(METRICS, values['contribution'][i] / count)) + for i, policy in enumerate(('sort', 'expected'))})) + return dict(rows=result, counts=dict(counts), seen=seen) + + +def export_difficulty_reports(results, bundle, input_root, output, *, labels_root=None, entries=None, query_types=None): + """Postprocess completed jobs from a frozen inference bundle. + + No frozen-source verification, model loading, checkpoint locks or writes to + inference artifacts. A new output directory is required. In-progress traces + without result.json are never opened. + """ + from dicee.query_answering.method_evaluation import GRAPH_INDEPENDENT_METHODS + + results, bundle, input_root, output = map(lambda p: Path(p).resolve(), (results, bundle, input_root, output)) + if output.exists() or any(output.is_relative_to(p) for p in (results, bundle)): + raise ValueError('Use a new report directory outside the frozen bundle and inference results') + source_files = postprocessor_files() + frozen = read(bundle / 'bundle.json') + bundle_hash = checksum(bundle / 'bundle.json') + shapes = set(PLUS_H_SHAPES if query_types is None else query_types) + if not shapes or shapes - set(PLUS_H_SHAPES): + raise ValueError('Select supported +H query types') + selected_entries = set(entries) if entries is not None else None + jobs = [] + completed = set() + for path in sorted(results.rglob('result.json')): + report = read(path) + run = report.get('benchmark_run', report.get('paper_run')) + if run is None: + continue + if run.get('bundle') == bundle_hash: + completed.add(run['entry']) + if selected_entries is not None and run['entry'] not in selected_entries: + continue + if run['bundle'] != bundle_hash: + raise ValueError(f'Result was not produced by this frozen bundle: {path}') + if report['split'] != 'test': + raise ValueError('Inference difficulty currently supports test traces only') + jobs.append((path, report, run)) + if not jobs: + raise ValueError('No completed matching benchmark results') + if selected_entries is not None and selected_entries - completed: + raise ValueError(f'Requested entries are not completed: {sorted(selected_entries - completed)}') + expected_jobs = {entry['id'] for entry in frozen['manifest']['entries']} + dataset_jobs = defaultdict(list) + for job in jobs: + dataset_jobs[job[1]['dataset']].append(job) + all_rows, details, sources = [], [], {} + for dataset, jobs in sorted(dataset_jobs.items()): + folder = input_root / frozen['manifest']['data_root'] / dataset_spec(dataset)[1] + available_shapes = shapes & {s for _, r, _ in jobs for s in r['per_shape']} + if not available_shapes: + continue + # Check consumed root labels and all label-generation graph files against + # the bundle's pins. This intentionally does not compare current code or + # load/checksum frozen model weights. + graph_prefix = 'KG_splits/' if dataset == 'ICEWS18+H' else '' + names = ['test-queries.pkl', 'test-easy-answers.pkl', 'test-hard-answers.pkl', 'id2ent.pkl', + *(graph_prefix + s + '.txt' for s in ('train', 'valid', 'test'))] + pins = {} + for name in names: + path = folder / name + key = str(path.relative_to(input_root)) + digest = checksum(path) + if frozen['files'].get(key) != digest: + raise ValueError(f'Consumed label-generation input is not pinned by bundle: {path}') + pins[name] = digest + records = root_queries(folder, available_shapes) + label_folder = (Path(labels_root).resolve() / dataset_spec(dataset)[1]) if labels_root else folder + author, author_source = released_labels(label_folder, records, dataset=dataset, required=labels_root is not None) + full, observed, n, graph_files = load_graphs(folder) + graph = 'train+valid' + classifier = DifficultyClassifier(full, observed[graph], n) + # Retain only classifications of root hard targets (not all reachable + # entities) across model/filter/adapter rows, bounded by this dataset. + target_labels = {} + + class SharedClassifier: + def __init__(self, classifier, cache): + self.classifier = classifier + self.cache = cache + + def classify(self, shape, query, hard): + key = (shape, query) + if key not in self.cache: + self.cache[key] = self.classifier.classify(shape, query, hard) + return self.cache[key] + + sources[dataset] = dict(root_files=pins, truth_graph_files=graph_files, released=author_source) + available = Counter(record['shape'] for record in records.values()) + for path, report, run in jobs: + if not (available_shapes & report['per_shape'].keys()): + continue + trace = path.parent / 'ranks.sqlite3' + if checksum(trace) != report['rank_trace_sha256']: + raise ValueError(f'Rank trace checksum mismatch: {trace}') + filter_policy = report['protocol'].get('answer_filter', 'released') + if filter_policy == 'corrected': + correction = frozen.get('filter_corrections', {}).get(dataset) + if not correction or checksum(bundle / correction['path']) != correction['sha256']: + raise ValueError('Corrected-filter result lacks a pinned correction audit') + method = report['inference']['method'] + inference_graph = report['dataset_metadata']['inference_graph'] + summary = summarize_difficulty(trace, records, SharedClassifier(classifier, target_labels), + author_labels=author, shapes=available_shapes) + for row in summary['rows']: + shape = row['shape'] + if row['grouping'] == 'overall': + online_counts = report['per_shape'][shape] + if (row['queries'] != online_counts['queries'] or row['hard_answers'] != online_counts['hard_answers'] + or (report['protocol']['full_split'] and row['queries'] != available[shape])): + raise ValueError('Completed trace coverage differs from evaluation/root query coverage') + for policy in ('sort', 'expected'): + online = (report['per_shape'][shape] if policy == 'sort' else + report['additional_tie_metrics'][policy]['per_shape'][shape]) + if any(not math.isclose(row[policy][m], online[m], abs_tol=1e-11) for m in METRICS): + raise ValueError(f'Offline rank metrics differ from completed evaluation: {path}') + row.update(entry=run['entry'], dataset=dataset, method=method, + calibration=report['inference'].get('calibration'), answer_filter=filter_policy, + inference_graph=inference_graph, comparison_graph=graph, + graph_independent=method in GRAPH_INDEPENDENT_METHODS, + label_reference_graph=graph, label_graph_matches_comparison=True, + available_queries=available[shape], + complete_shape=row['parent_queries'] == available[shape]) + all_rows.append(row) + details.append(dict(entry=run['entry'], dataset=dataset, comparison_graph=graph, + result=str(path), result_sha256=checksum(path), rank_trace_sha256=report['rank_trace_sha256'], + coverage=summary['counts'], available_queries=dict(available), + full_selected_types=all(c['queries'] == available[s] for s, c in summary['counts'].items()), + complete_benchmark_types=set(summary['counts']) == set(PLUS_H_SHAPES), + protocol_full_split=report['protocol']['full_split'])) + del records, full, observed, classifier, target_labels, author + if not all_rows: + raise ValueError('No completed results contain selected query types') + if postprocessor_files() != source_files: + raise ValueError('Postprocessor source changed during reporting; rerun with stable source') + payload = dict(version=1, bundle_sha256=bundle_hash, frozen_inference_source_sha256=frozen['source_sha256'], + postprocessor_files=source_files, + author_commit=PLUS_H_REFERENCE_COMMIT, author_release='benchs-1.0', + author_label_reference_graph='train+valid', + hardness_reference_graph='train+valid', + semantics='Minimum missing positive atoms on full-truth witnesses; negation restricts truth at zero cost; union selects a branch.', + averaging='Within each group: answers per query, then participating queries per parent type. No cross-type difficulty macro.', + contribution='original_weight_contribution sums to the parent metric within each grouping; query_weight is its original answer-per-query mass.', + pending_main_entries=sorted(expected_jobs - completed), selected_types=sorted(shapes), + sources=sources, details=details, rows=all_rows) + write_json(output / 'inference-difficulty.json', payload) + fields = ['entry', 'dataset', 'method', 'calibration', 'answer_filter', 'inference_graph', 'comparison_graph', + 'graph_independent', 'label_reference_graph', 'label_graph_matches_comparison', 'shape', 'grouping', 'label', + 'positive_edges', 'one_positive_edge', 'queries', 'hard_answers', 'parent_queries', 'parent_hard_answers', + 'available_queries', 'complete_shape', 'query_weight'] + with (output / 'inference-difficulty.csv').open('w', newline='') as stream: + metric_fields = [f'{p}_{m}' for p in ('sort', 'expected') for m in METRICS] + writer = csv.DictWriter(stream, fieldnames=fields + metric_fields) + writer.writeheader() + for row in all_rows: + writer.writerow({k: row[k] for k in fields} | {f'{p}_{m}': row[p][m] for p in ('sort', 'expected') for m in METRICS}) + lines = ['# Answer-level inference difficulty', '', + 'Metrics in the CSV/JSON are fractions. The table reports MRR ×100. Each row retains its original query type.', '', + 'All hardness categories use train+valid facts as their fixed reference, independently of the predictor\'s inference graph. ' + 'Full means all positive atoms in a chosen proof are missing. One-positive-edge types ' + '(including 1p and 2u) are identified explicitly and are not evidence of multi-hop reasoning.', '', + 'Only released hard targets are scored. Negated branches constrain full-graph truth but add no positive-edge cost. ' + 'Author union reductions need not equal minimum-edge groups.', '', + 'Group scores average answers within each participating query, then queries. JSON includes additive contributions ' + 'under the original query weights. No difficulty macro averages mix parent types.', '', + f'Pending main jobs: {len(payload["pending_main_entries"])}. Only completed result files were read.', '', + '| Entry | Filters | Type | Difficulty | Positive atoms | Queries | Answers | Sort | Expected |', + '|---|---|---|---|---:|---:|---:|---:|---:|'] + for row in all_rows: + if row['grouping'] == 'difficulty': + lines.append(f'| {row["entry"]} | {row["answer_filter"]} | {row["shape"]} | {row["label"]} | ' + f'{row["positive_edges"]} | {row["queries"]} | {row["hard_answers"]} | ' + f'{100 * row["sort"]["mrr"]:.2f} | {100 * row["expected"]["mrr"]:.2f} |') + (output / 'inference-difficulty.md').write_text('\n'.join(lines) + '\n') + return payload diff --git a/benchmarks/cqa/docker.py b/benchmarks/cqa/docker.py new file mode 100644 index 000000000..4f479983d --- /dev/null +++ b/benchmarks/cqa/docker.py @@ -0,0 +1,91 @@ +"""Build the benchmark image and run commands in it with immutable inputs. + +Containers have no network, mount the input root read-only at ``/inputs`` and +one results directory at ``/results``, and record the image ID they used. +""" + +import json +import os +import shlex +import shutil +import subprocess +import tempfile +from pathlib import Path + +from .manifests import REPO + +HERE = Path(__file__).parent +# Tracked sources copied into the image: the library, this harness, and suite data. +SOURCES = ('dicee', 'pyproject.toml', 'benchmarks/__init__.py', 'benchmarks/cqa', 'benchmarks/adapters', + 'benchmarks/plus_h', 'benchmarks/ultraquery') + + +def inspect(image): + return json.loads(subprocess.check_output(['docker', 'image', 'inspect', image], text=True))[0] + + +def build(image, *, cache=None, network='default', training_base=None): + """Build the pinned runtime, or the CPU author-training runtime on top of ``training_base``.""" + if training_base is not None: + subprocess.run(['docker', 'build', '--network', network, '-t', image, + '--build-arg', f'BENCHMARK_IMAGE={inspect(training_base)["Id"]}', str(HERE / 'training')], check=True) + return + + def git(*arguments): + return subprocess.check_output(['git', '-C', str(REPO), *arguments], text=True) + + commit = git('rev-parse', 'HEAD').strip() + dirty = bool(git('status', '--porcelain', '--untracked-files=no', '--', *SOURCES).strip()) + cache = Path(cache or Path.home() / '.cache' / 'dicee' / 'cqa').resolve() + wheels, pip_cache = cache / 'wheels', Path.home() / '.cache' / 'pip' + wheels.mkdir(parents=True, exist_ok=True) + pip_cache.mkdir(parents=True, exist_ok=True) + base = (HERE / 'Dockerfile').read_text().splitlines()[0].split()[1] + # Resolve hash-pinned wheels once, in the image's own Python, then build offline. + subprocess.run(['docker', 'run', '--rm', '--network', network, '--user', f'{os.getuid()}:{os.getgid()}', + '--env', 'PIP_CACHE_DIR=/pip-cache', + '--mount', f'type=bind,source={wheels},target=/wheels', + '--mount', f'type=bind,source={pip_cache},target=/pip-cache', + '--mount', f'type=bind,source={HERE / "requirements.lock"},target=/requirements.lock,readonly', + base, 'python', '-m', 'pip', 'download', '--require-hashes', '--only-binary=:all:', + '--timeout', '180', '--retries', '10', '--dest', '/wheels', '-r', '/requirements.lock'], check=True) + with tempfile.TemporaryDirectory(prefix='build-', dir=cache) as directory: + shutil.copytree(wheels, Path(directory) / 'wheels', copy_function=os.link) + for relative in git('ls-files', '-z', '--', *SOURCES).split('\0'): + source, target = REPO / relative, Path(directory) / relative + if relative and source.is_file(): + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(source, target) + subprocess.run(['docker', 'build', '--network', network, '-t', image, '-f', 'benchmarks/cqa/Dockerfile', + '--build-arg', f'SOURCE_COMMIT={commit}', '--build-arg', f'SOURCE_DIRTY={str(dirty).lower()}', + directory], check=True) + + +def run(image, arguments, *, inputs, results, gpu='runtime', dry_run=False): + """Run ``python -m benchmarks.cqa ARGUMENTS`` in ``image``. + + Every container of a results directory must use the same image ID; the + first launch records it in ``container-image.json``. + """ + inputs, results = Path(inputs).resolve(), Path(results).resolve() + mounts = ['--mount', f'type=bind,source={inputs},target=/inputs,readonly', + '--mount', f'type=bind,source={results},target=/results', + '--mount', f'type=bind,source={results / "cache"},target=/cache'] + devices = {'runtime': ['--gpus', 'all'], 'cdi': ['--device', 'nvidia.com/gpu=all'], 'none': []}[gpu] + command = ['docker', 'run', '--rm', '--network', 'none', '--read-only', '--shm-size', '2g', + '--tmpfs', '/tmp:rw,exec,nosuid,size=4g', '--user', f'{os.getuid()}:{os.getgid()}', + '--env', 'HOME=/tmp', '--env', 'XDG_CACHE_HOME=/cache', '--env', 'TORCHINDUCTOR_CACHE_DIR=/cache/inductor', + '--env', 'TRITON_CACHE_DIR=/cache/triton', *mounts, *devices] + if dry_run: + print(shlex.join([*command, image, *arguments])) + return + identity = inspect(image) + pin = results / 'container-image.json' + if pin.exists() and json.loads(pin.read_text())['image_id'] != identity['Id']: + raise ValueError('Image differs from this study; use the original image ID or a new output directory') + (results / 'cache').mkdir(parents=True, exist_ok=True) + if not pin.exists(): + pin.write_text(json.dumps(dict(image_id=identity['Id'], repo_digests=identity.get('RepoDigests', [])), indent=2) + '\n') + command += ['--env', f'DICEE_IMAGE_ID={identity["Id"]}', identity['Id'], *arguments] + (results / 'container-launch.json').write_text(json.dumps(dict(image_id=identity['Id'], command=command), indent=2) + '\n') + subprocess.run(command, check=True) diff --git a/benchmarks/cqa/evaluate.py b/benchmarks/cqa/evaluate.py new file mode 100644 index 000000000..39ba7ab7d --- /dev/null +++ b/benchmarks/cqa/evaluate.py @@ -0,0 +1,44 @@ +"""Evaluate selected entries of a portable study manifest directly, without a frozen bundle.""" + +import json +from pathlib import Path + +from dicee.query_answering._checkpoint import checksum, input_path +from dicee.query_answering.method_evaluation import evaluate_method +from dicee.query_answering.methods import REFERENCES + +from .provenance import validate_training + + +def evaluate_manifest(manifest, *, input_root, output, device='cpu', split='test', limit=None, seed=None, threads=None): + """Evaluate each entry into ``output/ID``, resolving its inputs below ``input_root``.""" + seed = manifest.get('seed', 0) if seed is None else seed + threads = manifest.get('threads') if threads is None else threads + for entry in manifest['entries']: + entry = dict(entry) + name, query_order = entry['id'], entry.pop('query_order', 'relation') + record, _ = validate_training(entry, input_root, manifest['data_root']) + for key in ('reference', 'finalized', 'blockers', 'verification', 'graph_ablation'): + entry.pop(key, None) + entry['root'] = str(input_path(input_root, manifest['data_root'])) + entry['checkpoint'] = str(input_path(input_root, entry['checkpoint'])) + provenance = None + if entry.get('training'): + provenance = dict(training=record, training_sha256=checksum(input_path(input_root, entry.pop('training')))) + entry['options'] = dict(entry.get('options', {})) + if entry['method'] in REFERENCES: + entry['vocabulary_dataset'] = entry['dataset'] + if 'per_shape' in entry['options']: + entry['per_shape'] = entry['options'].pop('per_shape') + else: + entry['adapters'] = {key: str(input_path(input_root, path)) for key, path in entry['adapters'].items()} + data = filter_corrections = None + if manifest.get('answer_filter') == 'corrected' and split == 'test': + from dicee.query_answering.datasets import audit_plus_h_filters, corrected_answer_filters, load_benchmark + data = load_benchmark(entry['root'], entry['dataset'], split='test', query_types=entry.get('query_types'), + inference_graph=entry.get('inference_graph')) + filter_corrections = corrected_answer_filters(data, audit_plus_h_filters(entry['root'], data)) + report = evaluate_method(entry, output=Path(output) / name, device=device, split=split, limit=limit, seed=seed, + threads=threads, query_order=query_order, data=data, filter_corrections=filter_corrections, + provenance=provenance) + print(json.dumps(dict(id=name, queries=report['queries'], seconds=report['seconds'], averages=report['averages'])), flush=True) diff --git a/benchmarks/cqa/inputs.py b/benchmarks/cqa/inputs.py new file mode 100644 index 000000000..acfb42fa5 --- /dev/null +++ b/benchmarks/cqa/inputs.py @@ -0,0 +1,326 @@ +"""Fetch official benchmark inputs with the standard library; never load models. + +Downloads and extraction use 1 MiB buffers. Existing inputs are checked and +never replaced silently. +""" + +import hashlib +import json +import os +import shutil +import stat +import tempfile +import urllib.error +import urllib.request +import zipfile +from pathlib import Path, PurePosixPath + +from .manifests import REPO, catalog + +CHUNK = 1024 * 1024 +RESERVE = 1024 * 1024 * 1024 +MODEL_URL = ('https://rssiste-my.sharepoint.com/:u:/g/personal/' + 'cosimo_gregucci_ms_informatik_uni-stuttgart_de/' + 'EccKx4K6sZ1Nhy_fJTL8L44BFtpNRZwmI43-ffPRSmb28g?e=kO5dYk&download=1') +MODEL_PREFIX = 'checkpoints/query-baselines/' +# SHA-256 of the released files, extracted from the archive pinned in the +H +# manifests. The three standalone weights are from the pinned ULTRA/TRIX trees. +WEIGHT_HASHES = { + 'Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth': '9b6dc20801c35e7c9ebe65764acb4ed9cb5bffc6b0a0a727bd48935589e9388d', + 'checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-fb15k237.ckpt': '4ce1e2abeda74199970c9350e3da10d928d34f974f3c1f42ead553a9c13799b9', + 'checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-icews18.ckpt': '1a450d5cd0c726eec10ff302249143894f2fb3329370204b453ec09d447c227d', + 'checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-nell995.ckpt': 'c61fa9089e6233faf38cabe8e2e0ef066eed5d4123871108de3226e21cafcd18', + 'checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/ICEWS18/checkpoint': 'ba873863eeec2abeeb70e9ae484171fbc56a1f5cfd194cb8a7fac24cae03f9f7', + 'checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/fb15k237checkpoint': '631bd1fd3c5d8095eb2c99b78052c3ea4c9c2dd88f7ab044cbb2c610ed547c18', + 'checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint': '42b46696588918dba83262dd88b4884d9b6a27c8975f2c6d5a6bc7c65764168f', + 'checkpoints/query-baselines/iscqa-compl-models/models/ConE/FB15k237/checkpoint': 'c576cd8cf55bebc642b6007e079650ccdfd4f627f1c6a4780f5680ba001ef829', + 'checkpoints/query-baselines/iscqa-compl-models/models/ConE/ICEWS18/checkpoint': '44f0f0178e099206ad8ce0dca39815d57df6eed44992698eb6fd9e73ff92f144', + 'checkpoints/query-baselines/iscqa-compl-models/models/ConE/NELL995/checkpoint': 'f0ac18ae0bf3eacff15207d9320e19d010cd4a494e3bae96e8475b891e886787', + 'checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_FB15k237.pth': 'cb45202f9aa68da61a59b88721c76b5883274db309d4cf14037b8fc2c72a93b2', + 'checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_ICEWS18.pth': '6b8c1fd64cc7ba96fe2e4834634a2721c4d3914658c1d81f61fdd5526d1b5a13', + 'checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_NELL995.pth': '086619b977d7b45658c11b4804b6e0e1c92a356cd4f427b4bf5b8ea1ee7016b3', + 'checkpoints/trix/entity_prediction.pth': '8f6e7266093c2d15ad88d41e9825e4b327171143543cf060cfee907d9a890342', + 'checkpoints/ultra_3g.pth': 'fdedc01b0045fc089d2ad5da08569466b7b221691fe978a18e91082bbb133c18', +} + + +def weight_urls(): + ultra, trix = (f'https://raw.githubusercontent.com/{repository}/{commit}' + for repository, commit in (catalog().ULTRA, catalog().TRIX)) + return {'Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth': f'{ultra}/ckpts/ultraquery.pth', + 'checkpoints/ultra_3g.pth': f'{ultra}/ckpts/ultra_3g.pth', + 'checkpoints/trix/entity_prediction.pth': f'{trix}/entity_prediction.pth'} + + +def digest(path): + result = hashlib.sha256() + with Path(path).open('rb') as stream: + while block := stream.read(CHUNK): + result.update(block) + return result.hexdigest() + + +def target(root, relative): + name = PurePosixPath(relative) + if name.is_absolute() or '..' in name.parts or '\\' in relative: + raise ValueError(f'Unsafe input path: {relative}') + result = root / relative + if not result.resolve().is_relative_to(root.resolve()) or result.is_symlink(): + raise ValueError(f'Unsafe input path: {relative}') + return result + + +def space(root, required): + available = shutil.disk_usage(root).free + if available < required + RESERVE: + raise OSError(f'Need {required / 2**30:.2f} GiB plus 1 GiB reserve; ' + f'only {available / 2**30:.2f} GiB free at {root}') + + +def install(stream, path, expected=None): + """Write atomically, rejecting a different existing file or bad checksum.""" + path.parent.mkdir(parents=True, exist_ok=True) + handle, temporary = tempfile.mkstemp(prefix='.input-', dir=path.parent) + temporary = Path(temporary) + result = hashlib.sha256() + try: + with os.fdopen(handle, 'wb') as output: + while block := stream.read(CHUNK): + result.update(block) + output.write(block) + checksum = result.hexdigest() + if expected is not None and checksum != expected: + raise ValueError(f'SHA-256 mismatch for {path}') + if path.exists(): + if digest(path) != checksum: + raise ValueError(f'Existing input differs; refusing to replace {path}') + else: + os.replace(temporary, path) + return checksum + finally: + temporary.unlink(missing_ok=True) + + +def download(url, path, expected=None, size=None): + print(f'Downloading {url}', flush=True) + request = urllib.request.Request(url, headers={'User-Agent': 'dicee-benchmark-inputs/1'}) + with urllib.request.urlopen(request, timeout=120) as response: + length = size or int(response.headers.get('Content-Length') or 0) + if length: + space(path.parent, length) + return install(response, path, expected) + + +def transductive_files(): + return {'id2ent.pkl', 'id2rel.pkl', 'train.txt', 'valid.txt', 'test.txt', + *(f'{split}-{kind}.pkl' for split in ('valid', 'test') + for kind in ('queries', 'easy-answers', 'hard-answers'))} + + +def plus_h_files(icews=False): + files = transductive_files() + if icews: + files -= {'train.txt', 'valid.txt', 'test.txt'} + files |= {f'KG_splits/{split}.txt' for split in ('train', 'valid', 'test')} + else: + files |= {f'test-query-reduction/{shape}/all/test-{kind}.pkl' + for shape in ('2in', 'pni') for kind in ('queries', 'easy-answers', 'hard-answers')} + reductions = {'ip': ('1p', '2i', '2p', 'ip'), 'pi': ('1p', '2i', '2p', 'pi'), + 'up': ('1p', '2u', 'up')} + reductions.update({f'{n}{op}': ('1p', *(f'{i}{op}' for i in range(2, n + 1))) + for op in ('p', 'i') for n in (2, 3, 4)}) + reductions.update({s: ('pos-exist', 'pos-only-miss') for s in ('3in', 'pin', 'inp')}) + files |= {f'test-query-reduction/{shape}/{label}/test-hard-answers.pkl' + for shape, labels in reductions.items() for label in labels} + return files + + +def plan(manifest, suite): + """Dataset archives and checkpoints that a resolved manifest needs.""" + c = catalog() + names = {entry['dataset'] for entry in manifest['entries']} + weights = sorted({entry['checkpoint'] for entry in manifest['entries']}) + root = manifest['data_root'] + if suite == 'plus_h': + archive = json.loads((REPO / 'benchmarks/plus_h/baselines.json').read_text())['archives']['datasets'] + folders = {f'{c.PLUS_H_PREFIX}/{folder}': plus_h_files(name == 'ICEWS18+H') + for name, folder in c.PLUS_H_FOLDERS.items() if name in names} + return [dict(id='plus-h-datasets', url=c.PLUS_H_ARCHIVE, root=root, folders=folders, + sha256=archive['sha256'], size=archive['bytes'], selective=True)], weights + jobs = [] + folders = {folder: transductive_files() for name, folder in c.TRANSDUCTIVE.items() if name in names} + if folders: + jobs.append(dict(id='ultra-transductive', url='https://snap.stanford.edu/betae/KG_data.zip', root=root, folders=folders)) + required = {f'{split}_{kind}.pkl' for split in ('valid', 'test') for kind in ('queries', 'answers_easy', 'answers_hard')} + for version in c.INDUCTIVE_VERSIONS: + if f'InductiveFB15k237Query:{version}' in names: + jobs.append(dict(id=f'ultra-inductive-{version}', url=f'https://zenodo.org/records/7306046/files/{version}.zip', root=root, + folders={version: required | {'train_graph.txt', 'val_inference.txt', 'test_inference.txt'}})) + folders = {f'WikiTopics_QE/{topic}': required | {'train_graph.txt', 'test_inference.txt', 'og_mappings.pkl'} + for topic in c.WIKITOPICS if f'WikiTopicsQuery:{topic}' in names} + if folders: + jobs.append(dict(id='ultra-wikitopics', url='https://reltrans.s3.us-east-2.amazonaws.com/WikiTopics_QE.zip', + root=root, folders=folders)) + return jobs, weights + + +def missing_files(root, job): + return [f"{job['root']}/{folder}/{name}" for folder, names in job['folders'].items() + for name in sorted(names) if not target(root, f"{job['root']}/{folder}/{name}").is_file()] + + +def extract(archive, root, select): + with zipfile.ZipFile(archive) as zipped: + members = zipped.infolist() + # Validate the entire archive before installing any input. + for member in members: + target(root, member.filename) + if stat.S_ISLNK(member.external_attr >> 16): + raise ValueError(f'Symlink in archive: {member.filename}') + chosen = [(m, select(m.filename)) for m in members if not m.is_dir()] + chosen = [(m, target(root, name)) for m, name in chosen if name is not None] + space(root, sum(m.file_size for m, _ in chosen)) + checksums = {} + for member, path in chosen: + with zipped.open(member) as stream: + checksums[path.relative_to(root).as_posix()] = install(stream, path) + return checksums + + +def fetch_dataset(root, job): + state = root / '.benchmark-downloads' + state.mkdir(parents=True, exist_ok=True) + receipt = state / f"{job['id']}.json" + if not missing_files(root, job): + if not receipt.is_file(): + print(f"Dataset inputs already present: {job['id']} (freeze pins their hashes)", flush=True) + return + saved = json.loads(receipt.read_text()) + if saved['url'] == job['url'] and all(target(root, p).is_file() and digest(target(root, p)) == h + for p, h in saved['files'].items()): + print(f"Verified dataset {job['id']}", flush=True) + return + raise ValueError(f"Dataset receipt mismatch: {receipt}") + with tempfile.TemporaryDirectory(prefix='.fetch-', dir=root) as temporary: + archive = Path(temporary) / 'data.zip' + checksum = download(job['url'], archive, job.get('sha256'), job.get('size')) + + def select(name): + for folder, required in job['folders'].items(): + if name.startswith(folder + '/'): + relative = name[len(folder) + 1:] + if not job.get('selective') or relative in required or relative == 'stats.txt': + return f"{job['root']}/{name}" + return None + + files = extract(archive, root, select) + missing = missing_files(root, job) + if missing: + raise ValueError(f"Archive lacks required inputs: {missing}") + payload = json.dumps(dict(url=job['url'], archive_sha256=checksum, files=files), indent=2).encode() + # A receipt is metadata, not an immutable benchmark input. + temp = receipt.with_suffix('.tmp') + temp.write_bytes(payload) + os.replace(temp, receipt) + print(f"Installed {len(files)} files for {job['id']}", flush=True) + + +def fetch_weights(root, weights, models_archive=None): + urls = weight_urls() + pending = [] + for name in weights: + path = target(root, name) + if path.is_file(): + if name in WEIGHT_HASHES and digest(path) != WEIGHT_HASHES[name]: + raise ValueError(f'Existing checkpoint checksum mismatch: {path}') + else: + if name not in WEIGHT_HASHES: + raise ValueError(f'No public download is configured for {path}; provide this custom checkpoint first') + pending.append(name) + author = [name for name in pending if name not in urls] + if author: + meta = json.loads((REPO / 'benchmarks/plus_h/baselines.json').read_text())['archives']['models'] + with tempfile.TemporaryDirectory(prefix='.models-', dir=root) as temporary: + archive = models_archive or Path(temporary) / 'models.zip' + if models_archive: + if digest(archive) != meta['sha256']: + raise ValueError(f'Official model archive checksum mismatch: {archive}') + else: + try: + download(MODEL_URL, archive, meta['sha256'], meta['bytes']) + except urllib.error.HTTPError as error: + raise RuntimeError('The authors\' model host rejected the download. ' + 'Use --models-archive /path/to/iscqa-compl-models.zip, ' + 'or copy the released checkpoints into the manifest paths and retry.') from error + wanted = {name[len(MODEL_PREFIX):]: name for name in author} + extract(archive, root, wanted.get) + for name in pending: + path = target(root, name) + if name in urls: + download(urls[name], path, WEIGHT_HASHES[name]) + if not path.is_file() or digest(path) != WEIGHT_HASHES[name]: + raise ValueError(f'Released checkpoint missing or checksum mismatch: {path}') + print(f'Checkpoint inputs present: {len(weights)}; released files checked by SHA-256', flush=True) + + +def ensure_inputs(manifest, input_root, *, suite, models_archive=None, download_missing=True): + """Set up only requested public inputs; custom data/checkpoints stay explicit.""" + root = Path(input_root).expanduser().resolve() + root.mkdir(parents=True, exist_ok=True) + jobs, weights = plan(manifest, suite) + missing = [p for p in weights if not target(root, p).is_file()] + public = json.loads((REPO / 'benchmarks' / suite / 'baselines.json').read_text()) + official = manifest.get('archives', {}).get('datasets') == public['archives']['datasets'] + if official: + missing += [p for job in jobs for p in missing_files(root, job)] + extras = {p for e in manifest['entries'] for p in e.get('adapters', {}).values()} + extras |= {e['checkpoint'] for e in manifest['entries'] if e['checkpoint'].endswith('.json')} + for name in sorted(extras): + path = target(root, name) + if not path.is_file(): + source = target(REPO, name) + if not source.is_file() or not download_missing: + missing.append(name) + continue + space(root, source.stat().st_size) + with source.open('rb') as stream: + install(stream, path) + weights = [name for name in weights if name not in extras] + missing = [p for p in missing if not target(root, p).is_file()] + if not download_missing: + if missing: + raise FileNotFoundError(f'Inputs missing with --no-setup: {missing}') + return + if weights: + fetch_weights(root, weights, models_archive) + if official: + for job in jobs: + if missing_files(root, job): + fetch_dataset(root, job) + + +def describe(manifest, root, *, suite): + """Print where each input of ``manifest`` comes from; no downloads or writes.""" + jobs, weights = plan(manifest, suite) + urls = weight_urls() + for job in jobs: + print(f"{job['id']}: {job['url']} -> {root / job['root']}") + for name in weights: + source = urls.get(name, MODEL_URL if name in WEIGHT_HASHES else 'User-provided input') + print(f'{source} -> {root / name}') + + +def check(manifest, root, *, suite): + """Print missing inputs and checksum mismatches; return whether there were any.""" + jobs, weights = plan(manifest, suite) + adapters = {path for entry in manifest['entries'] for path in entry.get('adapters', {}).values()} + missing = [path for job in jobs for path in missing_files(root, job)] + missing += [path for path in [*weights, *sorted(adapters)] if not target(root, path).is_file()] + bad = [path for path in weights if path in WEIGHT_HASHES and target(root, path).is_file() + and digest(target(root, path)) != WEIGHT_HASHES[path]] + for name in missing: + print(f'Missing: {name}') + for name in bad: + print(f'Checksum mismatch: {name}') + print(f'{len(jobs)} dataset archives; {len(weights)} checkpoints; {len(missing)} missing files; {len(bad)} bad checkpoints.') + return bool(missing or bad) diff --git a/benchmarks/cqa/manifests.py b/benchmarks/cqa/manifests.py new file mode 100644 index 000000000..88d79b1e7 --- /dev/null +++ b/benchmarks/cqa/manifests.py @@ -0,0 +1,271 @@ +"""Benchmark suites and their public recipes, resolved without PyTorch. + +A recipe (manifest entry) fixes a method, checkpoint, dataset, query types and +execution options. Resolution only selects and annotates entries; it never +opens datasets or models, so the host launcher can run it before Docker. + +Public manifests group entries into ``recipes``: each entry is the recipe's +``defaults`` updated by the entry's own fields, recursively for objects, and +``{dataset}`` in an ID is replaced by the entry's dataset. Manifests may also +list resolved ``entries`` directly. +""" + +import copy +import importlib.util +import json +from functools import cache +from pathlib import Path + +REPO = Path(__file__).resolve().parents[2] +SUITES = { + 'plus_h': dict(title='+H benchmark', answer_filter='corrected'), + 'ultraquery': dict(title='UltraQuery benchmark (released PyG)', answer_filter='released'), +} +KGFM_EXECUTION = { + # H100 / H100 NVL starting point for ULTRA/TRIX adapters: larger atomic + # batches and bounded GPU caches. Native methods need no profile. + 'h100': dict(row_batch_size=16, backend_batch_size=16, cache_bytes=4 * 2**30, raw_cache_bytes=2 * 2**30, + raw_cache_device='model', relation_cache_mb=256, projection_cache_mb=512), +} + + +@cache +def catalog(): + """The library's benchmark catalog, loaded without importing dicee or PyTorch.""" + spec = importlib.util.spec_from_file_location('_dicee_cqa_catalog', REPO / 'dicee/query_answering/catalog.py') + module = importlib.util.module_from_spec(spec) + spec.loader.exec_module(module) + return module + + +def suite_directory(suite): + if suite not in SUITES: + raise ValueError(f'Choose a suite: {", ".join(SUITES)}') + return REPO / 'benchmarks' / suite + + +def default_recipes(suite): + """Public recipe files of a suite: native baselines, then KGFM adapters.""" + directory = suite_directory(suite) + return [path for path in (directory / 'baselines.json', directory / 'kgfm_adapters.json') if path.is_file()] + + +def merge(defaults, override): + """``defaults`` updated by ``override``; objects merge recursively, other values are replaced.""" + result = copy.deepcopy(defaults) + for key, value in override.items(): + nested = isinstance(value, dict) and isinstance(result.get(key), dict) + result[key] = merge(result[key], value) if nested else copy.deepcopy(value) + return result + + +def expand(recipes): + """Resolved entries of recipe groups, in order.""" + entries = [] + for recipe in recipes: + for override in recipe['entries']: + entry = merge(recipe['defaults'], override) + entry['id'] = entry['id'].replace('{dataset}', entry['dataset']) + entries.append(entry) + return entries + + +def read_manifest(path): + """A recipe manifest with resolved entries, or the manifest pinned in a frozen bundle.""" + value = json.loads(Path(path).read_text()) + value = value.get('manifest', value) + if 'recipes' in value: + value = {key: item for key, item in value.items() if key != 'recipes'} | {'entries': expand(value['recipes'])} + return value + + +def select_entries(entries, *, entry_ids=None, methods=None, datasets=None, query_types=None, atomic_negation=False): + """Resolve recipe subsets before opening datasets or model checkpoints.""" + shapes_by_dataset = catalog().query_types_for_dataset + all_shapes = catalog().PLUS_H_SHAPES + identifiers = [entry.get('id', f'{entry["method"]}-{entry["dataset"]}') for entry in entries] + if len(set(identifiers)) != len(identifiers) or any(Path(name).name != name or name in ('', '.', '..') for name in identifiers): + raise ValueError('Manifest entry IDs must be unique, plain directory names') + + def selection(values, available, label, allow_all=True): + if values is None or (allow_all and values == ['all']): + return None + if not values or len(set(values)) != len(values): + raise ValueError(f'Select distinct {label}') + missing = set(values) - set(available) + if missing: + raise ValueError(f'Select distinct {label}; unknown: {", ".join(sorted(missing))}. Available: {", ".join(sorted(available))}') + return set(values) + + ids = selection(entry_ids, identifiers, 'entry IDs', allow_all=False) + wanted_methods = selection(methods, {e['method'] for e in entries}, 'methods') + wanted_datasets = selection(datasets, {e['dataset'] for e in entries}, 'datasets') + selected = [copy.deepcopy(entry) for name, entry in zip(identifiers, entries) + if (ids is None or name in ids) and (wanted_methods is None or entry['method'] in wanted_methods) + and (wanted_datasets is None or entry['dataset'] in wanted_datasets)] + if not selected: + raise ValueError('No manifest entries match the selected methods, datasets, and entry IDs') + groups = {'all', 'epfo', 'negation'} + if query_types is not None: + if not query_types or len(set(query_types)) != len(query_types): + raise ValueError('Select distinct query types or groups: all, epfo, negation') + unknown = set(query_types) - set(all_shapes) - groups + if unknown or ('all' in query_types and len(query_types) != 1): + raise ValueError('Select supported query types or groups: all, epfo, negation; use all alone. ' + f'Available types: {", ".join(all_shapes)}') + for entry in selected: + changed = False + if query_types is not None: + available = shapes_by_dataset(entry['dataset']) + expanded_groups = {'all': available, 'epfo': [s for s in available if 'n' not in s], + 'negation': [s for s in available if 'n' in s]} + shapes = [] + for shape in query_types: + shapes.extend(expanded_groups.get(shape, [shape])) + shapes = list(dict.fromkeys(shapes)) + if set(shapes) - set(available): + raise ValueError(f'Query types {shapes} are not supported by {entry["dataset"]}') + changed = shapes != entry.get('query_types') + entry['query_types'] = shapes + for owner in (entry, entry.get('options', {})): + if 'per_shape' in owner: + owner['per_shape'] = {s: value for s, value in owner['per_shape'].items() if s in shapes} + if 'operators' in entry: + missing = set(shapes) - entry['operators'].keys() + if missing: + raise ValueError(f'{entry.get("id", entry["method"])} has no operator/adapter recipe for {sorted(missing)}') + entry['operators'] = {s: entry['operators'][s] for s in shapes} + if entry['method'] in ('cqd', 'cqd-hybrid'): + options = entry.setdefault('options', {}) + if atomic_negation and not options.get('atomic_negation'): + options['atomic_negation'] = True + changed = True + if any('n' in s for s in entry.get('query_types', [])) and not options.get('atomic_negation'): + raise ValueError('CQD negated query types require atomic_negation=true or --atomic-negation') + if changed and options.get('atomic_negation') and 'reference' in entry: + entry['reference'].setdefault('notes', []).append( + 'CQD-A signed-atom negation with +H scoring.') + if changed: + entry.pop('verification', None) + if 'reference' in entry: + entry['reference']['status'] = 'custom query selection or executor; independent validation required' + return selected + + +def validate_entry(entry): + required = {'id', 'method', 'dataset', 'checkpoint', 'options', 'query_types', 'query_batch_size', 'query_order', 'reference'} + optional = {'adapters', 'operators', 'selection_protocol', 'finalized', 'blockers', 'verification', 'adapter_ablation', + 'inference_graph', 'graph_ablation', 'training'} + if required - entry.keys() or entry.keys() - required - optional: + raise ValueError(f'Invalid benchmark entry fields: {entry.get("id")}') + if (entry['method'] not in catalog().METHODS + or Path(entry['id']).name != entry['id'] or entry['id'] in ('', '.', '..')): + raise ValueError('Invalid benchmark method, dataset, or entry ID') + shapes = entry['query_types'] + if not shapes or len(set(shapes)) != len(shapes) or set(shapes) - set(catalog().query_types_for_dataset(entry['dataset'])): + raise ValueError('Invalid query types for the selected dataset') + catalog().check_recipe(entry, shapes) + if entry['query_order'] not in ('canonical', 'relation', 'upstream-pickle'): + raise ValueError('Choose canonical, relation, or upstream-pickle query ordering') + if entry.get('inference_graph') not in (None, 'train', 'train+valid'): + raise ValueError('Inference graph must be train or train+valid') + if entry.get('graph_ablation') is not None and not isinstance(entry['graph_ablation'], str): + raise ValueError('Graph ablation must identify the shared frozen recipe') + if entry['method'] == 'clmpt' and entry['query_order'] != 'upstream-pickle': + raise ValueError('CLMPT requires frozen reference conversion order') + + +def prepare_manifest(paths, *, profile='bounded', entries=None, methods=None, datasets=None, query_types=None, + atomic_negation=False, observed_facts=None, inference_graphs=None, answer_filter='corrected', suite='plus_h', + hardware_profile='default', kgfm_batch_size=None): + """Merge public recipes without changing beams or per-shape operator settings.""" + manifests = [read_manifest(path) for path in paths] + if not manifests or profile not in ('bounded', 'reference'): + raise ValueError('Choose a bounded or reference profile and at least one manifest') + if hardware_profile not in ('default', *KGFM_EXECUTION): + raise ValueError('Choose a default or h100 hardware profile') + if kgfm_batch_size is not None and (type(kgfm_batch_size) is not int or kgfm_batch_size < 1): + raise ValueError('KGFM batch size must be a positive integer') + if answer_filter not in ('released', 'corrected'): + raise ValueError('Answer filter must be released or corrected') + if suite not in SUITES: + raise ValueError(f'Choose a suite: {", ".join(SUITES)}') + if suite == 'ultraquery' and (answer_filter != 'released' or inference_graphs is not None): + raise ValueError('UltraQuery uses released answer filters and dataset-defined inference graphs') + manifest = {key: value for key, value in manifests[0].items() if key != 'entries'} + combined = [] + for source in manifests: + if {key: value for key, value in source.items() if key != 'entries'} != manifest: + raise ValueError('Source manifests disagree on dataset, seed, threads, or archive metadata') + combined.extend(source['entries']) + if observed_facts is not None: + modes = ('none', 'atomic', 'both') if observed_facts == ['all'] else observed_facts + if not modes or len(modes) != len(set(modes)) or set(modes) - {'none', 'atomic', 'both'}: + raise ValueError('Select distinct observed-fact modes, or all') + variants = [] + for entry in combined: + if not entry['method'].endswith('-adapter'): + continue + for mode in modes: + variant = copy.deepcopy(entry) + variant['id'] += f'-facts-{mode}' + variant['options']['observed_facts'] = mode + variant['reference']['status'] = 'observed-fact ablation; verification pending' + variant['reference'].setdefault('notes', []).append( + f'Inference observed-fact mode: {mode}. Keep the trained weights and graph inputs fixed; ' + 'apply this mode to both learned and identity calibration. No adapter refitting.') + variants.append(variant) + if not variants: + raise ValueError('Observed-fact ablation requires KGFM entries') + combined = variants + if inference_graphs is not None: + if (not inference_graphs or len(set(inference_graphs)) != len(inference_graphs) + or set(inference_graphs) - {'train', 'train+valid'}): + raise ValueError('Select distinct inference graphs: train, train+valid') + variants = [] + for entry in combined: + if entry['method'] in catalog().GRAPH_INDEPENDENT_METHODS: + entry['inference_graph'] = 'train' + entry['reference']['graph_independent'] = True + variants.append(entry) + continue + for graph in inference_graphs: + variant = copy.deepcopy(entry) + variant['graph_ablation'] = entry['id'] + variant['inference_graph'] = graph + variant['id'] += '-graph-' + graph.replace('+', '-') + variants.append(variant) + combined = variants + ids = [entry['id'] for entry in combined] + if len(ids) != len(set(ids)): + raise ValueError('Source manifests contain duplicate entry IDs') + manifest['entries'] = select_entries(combined, entry_ids=entries, methods=methods, datasets=datasets, + query_types=query_types, atomic_negation=atomic_negation) + allowed_datasets = catalog().PLUS_H_DATASETS if suite == 'plus_h' else catalog().BENCHMARK_DATASETS + if any(entry['dataset'] not in allowed_datasets for entry in manifest['entries']): + raise ValueError(f'Selected entries must belong to the {suite} dataset suite') + manifest['answer_filter'] = answer_filter + kgfm_methods = catalog().KGFM_ADAPTERS + if kgfm_batch_size is not None and not any(e['method'] in kgfm_methods for e in manifest['entries']): + raise ValueError('KGFM batch size requires at least one selected KGFM adapter') + for entry in manifest['entries']: + entry.pop('verification', None) + if profile == 'bounded' and entry['method'] in ('cqd', 'cqd-hybrid'): + entry['options'].update(reference_batching=False, row_batch_size=32, final_batch_size=32) + entry['reference']['status'] = 'bounded execution profile; independent validation required' + entry['reference'].setdefault('notes', []).append( + 'Bounded profile: reference_batching=false, row_batch_size=32, and final_batch_size=32; beams and per-shape ' + 'recipes retained. Requires independent bounded-profile validation scores, orders, and ties.') + kgfm = entry['method'] in kgfm_methods + if hardware_profile != 'default' and kgfm: + entry['options'].update(KGFM_EXECUTION[hardware_profile]) + entry['reference']['status'] = 'H100 execution profile; independent validation required' + entry['reference'].setdefault('notes', []).append( + 'H100 / H100 NVL starting configuration, not a measured optimum. Float32 IEEE, query batches, beams, ' + 'operators and observed facts retained. Validate memory, scores, orders and ties on the target GPU.') + if kgfm and kgfm_batch_size is not None: + entry['options'].update(row_batch_size=kgfm_batch_size, backend_batch_size=kgfm_batch_size) + entry['reference']['status'] = 'custom KGFM atomic batch; independent validation required' + entry['reference'].setdefault('notes', []).append( + f'Atomic row and backbone batch size {kgfm_batch_size}; frozen before verification.') + return manifest diff --git a/benchmarks/cqa/oracles.py b/benchmarks/cqa/oracles.py new file mode 100644 index 000000000..b397eaaa1 --- /dev/null +++ b/benchmarks/cqa/oracles.py @@ -0,0 +1,112 @@ +"""Validate independently exported reference scores on the intended hardware.""" + +import tempfile +from collections import defaultdict + +import torch + +from dicee.query_answering._checkpoint import write_json +from dicee.query_answering.benchmark import METRICS, QueryMetrics +from dicee.query_answering.context import fingerprint +from dicee.query_answering.datasets import BENCHMARK_DATASETS +from dicee.query_answering.methods import REFERENCES + +from .study import bundle_entry, checksum, dataset_key, entry_inputs_identity, run_job, verify_bundle + + +def verify_predictions(bundle_dir, entry_id, input_root, reference, output, *, device='cpu', atol=3e-5, rtol=3e-5, + comparison_reference=None): + bundle = verify_bundle(bundle_dir, input_root) + entry = bundle_entry(bundle, entry_id) + oracle = torch.load(reference, map_location='cpu', weights_only=True) + expected = dict(version=1, entry_sha256=fingerprint({key: value for key, value in entry.items() if key != 'verification'}), + inputs_sha256=entry_inputs_identity(bundle, entry), + validation_plan_sha256=bundle['plans'][f'{entry_id}/valid']['sha256']) + if any(oracle.get(key) != value for key, value in expected.items()): + raise ValueError('Reference does not match the frozen entry, inputs, and validation batches') + if entry['method'] in REFERENCES and oracle.get('reference_commit') != REFERENCES[entry['method']][1]: + raise ValueError('Reference commit mismatch') + graphs = {split: bundle['datasets'][dataset_key(entry, split)]['context'] for split in ('valid', 'test')} + if (entry['method'] in REFERENCES and ('inference_graph' in entry or entry['dataset'] in BENCHMARK_DATASETS) + and oracle.get('graphs') != graphs): + raise ValueError('Reference inference graphs differ from the frozen validation/test protocol') + control = None + comparisons = {} + if comparison_reference is not None: + control = torch.load(comparison_reference, map_location='cpu', weights_only=True) + fields = ('inputs_sha256', 'validation_plan_sha256', 'reference_commit', 'environment') + if any(control.get(key) != oracle.get(key) for key in fields): + raise ValueError('Comparison reference uses different inputs, query batches, upstream code, or hardware') + if set(control['scores']) != set(oracle['scores']) or set(control['orders']) != set(oracle['orders']): + raise ValueError('Comparison reference query coverage differs') + results = {} + + def compare(query, actual): + key = query.identity + gold = oracle['scores'][key].to(actual.device) + order = oracle['orders'][key].to(actual.device) + if gold.shape != actual.shape or order.shape != actual.shape: + raise ValueError('Reference must score and rank every candidate') + if not torch.equal(order.sort().values, torch.arange(len(order), device=order.device)): + raise ValueError('Reference order is not a candidate permutation') + if not bool((gold[order][:-1] >= gold[order][1:]).all()): + raise ValueError('Reference order contradicts its scores') + scores_match = torch.allclose(actual, gold, atol=atol, rtol=rtol) + ranks_match = torch.equal(actual.argsort(descending=True), order) + ties_match = torch.equal(actual[order][1:] == actual[order][:-1], gold[order][1:] == gold[order][:-1]) + finite = torch.isfinite(actual) & torch.isfinite(gold) + errors = (actual[finite] - gold[finite]).abs() + results[key] = dict(shape=query.shape, max_error=float(errors.max()) if errors.numel() else 0., + scores_match=scores_match, ranks_match=ranks_match, ties_match=ties_match, + passed=scores_match and ranks_match and ties_match) + if control is not None: + previous = control['scores'][key].to(actual.device) + previous_order = control['orders'][key].to(actual.device) + if previous.shape != actual.shape or not torch.equal(previous.argsort(descending=True), previous_order): + raise ValueError('Comparison reference has invalid candidate scores or order') + finite = torch.isfinite(actual) & torch.isfinite(previous) + errors = (actual[finite] - previous[finite]).abs() + metric = QueryMetrics(len(actual)) + current_metrics = metric.evaluate(actual, query.easy, query.hard)[0] + previous_metrics = metric.evaluate(previous, query.easy, query.hard)[0] + comparisons[key] = dict(shape=query.shape, max_error=float(errors.max()) if errors.numel() else 0., + ranks_match=torch.equal(actual.argsort(descending=True), previous_order), + ties_match=torch.equal(actual[previous_order][1:] == actual[previous_order][:-1], + previous[previous_order][1:] == previous[previous_order][:-1]), + current=current_metrics, comparison=previous_metrics) + + with tempfile.TemporaryDirectory(prefix='dicee-cqa-parity-') as temporary: + report = run_job(bundle_dir, entry_id, input_root, temporary, device=device, phase='pilot', + pilot_queries=oracle['pilot_queries'], on_prediction=compare, + probe_only=oracle.get('probe_only', False)) + env = report['benchmark_run']['environment'] + hardware_keys = ('python', 'torch', 'cuda', 'gpu', 'driver', 'precision', 'threads') + if any(oracle.get('environment', {}).get(key) != env[key] for key in hardware_keys): + raise ValueError('Reference was produced with different hardware, precision, or runtime versions') + if set(results) != set(oracle['scores']) or set(results) != set(oracle['orders']): + raise ValueError('Reference query coverage differs from the frozen pilot batches') + if {row['shape'] for row in results.values()} != set(entry['query_types']): + raise ValueError('Reference omits a requested query type') + evidence = dict(entry_sha256=expected['entry_sha256'], inputs_sha256=expected['inputs_sha256'], + source_sha256=bundle['source_sha256'], environment=env, reference_sha256=checksum(reference), + reference_commit=oracle.get('reference_commit'), queries=results, + graphs=graphs, + reference_adjustments=oracle.get('runtime_adjustments', []), + probe_only=oracle.get('probe_only', False), + scope='paired full-candidate validation predictions, exact frozen batch membership', + atol=atol, rtol=rtol, passed=all(value['passed'] for value in results.values())) + if control is not None: + groups = defaultdict(list) + for row in comparisons.values(): + groups[row['shape']].append(row) + differences = {shape: {policy: {metric: sum(row['current'][policy][metric] - row['comparison'][policy][metric] + for row in rows) / len(rows) for metric in METRICS} for policy in ('sort', 'expected')} + for shape, rows in groups.items()} + evidence['upstream_comparison'] = dict(reference_sha256=checksum(comparison_reference), + comparison_entry_sha256=control.get('entry_sha256'), queries=comparisons, + delta_per_type=differences, + delta_macro={policy: {metric: sum(row[policy][metric] for row in differences.values()) / len(differences) + for metric in METRICS} for policy in ('sort', 'expected')}, + scope='Diagnostic comparison only; declared reference scores, ranks and ties remain the verification gate.') + write_json(output, evidence) + return evidence diff --git a/benchmarks/cqa/provenance.py b/benchmarks/cqa/provenance.py new file mode 100644 index 000000000..e13e224a1 --- /dev/null +++ b/benchmarks/cqa/provenance.py @@ -0,0 +1,60 @@ +"""Bind locally trained checkpoints to their recorded dataset and run profile.""" + +from pathlib import Path + +from dicee.query_answering._checkpoint import checksum, input_path, read +from dicee.query_answering.datasets import dataset_spec + +REQUIRED_INPUTS = { + 'qto': {'id2ent.pkl', 'id2rel.pkl', 'train.txt', 'valid.txt', 'test.txt'}, + 'inductive-gnnqe': {'train_graph.txt', 'val_inference.txt', 'test_inference.txt', + 'train_queries.pkl', 'train_answers_hard.pkl'} + | {f'{split}_{kind}.pkl' for split in ('valid', 'test') + for kind in ('queries', 'answers_easy', 'answers_hard')}, +} + + +def validate_training(entry, input_root, data_root, *, final=False, file_hashes=None): + """Return the validated record and dataset pins; allow smoke only outside final runs.""" + path = entry.get('training') + if not path: + if (entry['method'] == 'inductive-gnnqe' + or (entry['method'] == 'qto' and entry['dataset'] == 'FB15kLogicalQuery')): + raise ValueError('Training provenance is required for this locally trained baseline') + return None, {} + + def digest(relative): + if file_hashes is not None and str(relative) in file_hashes: + return file_hashes[str(relative)] + return checksum(input_path(input_root, relative)) + + record = read(input_path(input_root, path)) + if (not isinstance(record, dict) or record.get('version') != 1 or record.get('status') != 'complete' + or record.get('method') != entry['method'] or record.get('dataset') != entry['dataset'] + or record.get('checkpoint_sha256') != digest(entry['checkpoint'])): + raise ValueError('Training provenance does not match the completed checkpoint') + if record.get('profile') not in ('author-recipe', 'custom', 'smoke', 'fixture'): + raise ValueError('Training provenance requires a recognized training profile') + releases = {'qto': ('BetaE', 'fixture'), 'inductive-gnnqe': ('InductiveQE v2.0', 'fixture')} + if record.get('dataset_release') not in releases.get(entry['method'], ()): + raise ValueError('Training provenance requires the supported dataset release') + if final and (record['profile'] in ('smoke', 'fixture') or record.get('dataset_release') == 'fixture'): + raise ValueError('Entry is not ready for final testing: smoke/fixture training checkpoint') + inputs = record.get('inputs') + required = REQUIRED_INPUTS.get(entry['method']) + if not required or not isinstance(inputs, dict) or required - inputs.keys(): + raise ValueError('Training provenance is missing required dataset input bindings') + prefix = Path(data_root) / dataset_spec(entry['dataset'])[1] + pins = {} + for name, expected in inputs.items(): + if not isinstance(name, str) or Path(name).name != name or name in ('', '.', '..'): + raise ValueError('Training inputs must name files within the dataset folder') + relative = str(prefix / name) + try: + actual = digest(relative) + except FileNotFoundError as error: + raise ValueError(f'Training input is missing: {relative}') from error + if actual != expected: + raise ValueError(f'Training input differs from the evaluation dataset: {relative}') + pins[relative] = actual + return record, pins diff --git a/benchmarks/cqa/reports.py b/benchmarks/cqa/reports.py new file mode 100644 index 000000000..00cf7f0bd --- /dev/null +++ b/benchmarks/cqa/reports.py @@ -0,0 +1,262 @@ +"""Rebuild paired tie-policy tables from compact answer ranks.""" + +import csv +import json +import math +import sqlite3 +from collections import defaultdict +from pathlib import Path + +import numpy as np + +from dicee.query_answering._checkpoint import write_json +from dicee.query_answering._query import PLUS_H_SHAPES +from dicee.query_answering.benchmark import METRICS, _averages +from dicee.query_answering.datasets import query_types_for_dataset +from dicee.query_answering.method_evaluation import GRAPH_INDEPENDENT_METHODS + + +def trace_queries(path): + with sqlite3.connect(f'{Path(path).resolve().as_uri()}?mode=ro', uri=True) as connection: + harmonic = np.zeros(1, dtype=np.float64) + for query_id, shape, payload in connection.execute('SELECT query_id, shape, answers FROM queries ORDER BY position'): + records = np.asarray(json.loads(payload), dtype=np.int64) + if records.ndim != 2 or records.shape[1] != 4 or not len(records): + raise ValueError('Malformed answer-rank records') + ranks, greater, sizes = records[:, 1:].T + if (greater < 0).any() or (sizes < 1).any() or (ranks <= greater).any() or (ranks > greater + sizes).any(): + raise ValueError('Inconsistent filtered rank / tie block') + last = greater + sizes + if last.max() >= len(harmonic): + harmonic = np.concatenate(([0.], np.cumsum(1. / np.arange(1, last.max() + 1)))) + sort_metrics = dict(zip(METRICS, [np.mean(1. / ranks), *(np.mean(ranks <= k) for k in (1, 3, 10))])) + expected = dict(zip(METRICS, [np.mean((harmonic[last] - harmonic[greater]) / sizes), + *(np.mean(np.minimum(np.maximum(k - greater, 0), sizes) / sizes) for k in (1, 3, 10))])) + yield dict(query_id=query_id, shape=shape, sort=sort_metrics, expected=expected, + hard_answers=len(records), tied_answers=int((sizes > 1).sum()), max_tie_size=int(sizes.max())) + + +def summarize_trace(path, *, bootstrap_samples=2000, seed=0, expected_types=None): + groups = defaultdict(list) + for query in trace_queries(path): + groups[query['shape']].append(query) + if not groups: + raise ValueError('Empty rank trace') + rng = np.random.default_rng(seed) + per_shape, delta_draws = {}, np.zeros(bootstrap_samples) + for shape, queries in sorted(groups.items()): + policies = {policy: {metric: float(np.mean([query[policy][metric] for query in queries])) for metric in METRICS} + for policy in ('sort', 'expected')} + deltas = np.array([query['expected']['mrr'] - query['sort']['mrr'] for query in queries]) + draws = (np.full(bootstrap_samples, deltas[0]) if np.ptp(deltas) == 0 else + np.array([rng.choice(deltas, size=len(deltas), replace=True).mean() for _ in range(bootstrap_samples)])) + delta_draws += draws / len(groups) + hard = sum(query['hard_answers'] for query in queries) + per_shape[shape] = dict(**policies, queries=len(queries), hard_answers=hard, + tied_answer_fraction=sum(query['tied_answers'] for query in queries) / hard, + max_tie_size=max(query['max_tie_size'] for query in queries), + delta_mrr=float(deltas.mean()), + delta_mrr_ci95=np.quantile(draws, [.025, .975]).tolist() if bootstrap_samples else None) + averages = {policy: _averages({shape: values[policy] for shape, values in per_shape.items()}) for policy in ('sort', 'expected')} + return dict(per_shape=per_shape, averages=averages, all_16_types=set(groups) == set(PLUS_H_SHAPES), + all_benchmark_types=set(groups) == set(expected_types) if expected_types is not None else None, + delta_macro_mrr_ci95=np.quantile(delta_draws, [.025, .975]).tolist() if bootstrap_samples else None, + uncertainty=dict(unit='paired query', stratification='query type', resamples=bootstrap_samples, seed=seed)) + + +def adapter_effects(learned_trace, control_trace, *, bootstrap_samples=2000, seed=0): + """Paired learned-minus-identity differences, conditional on frozen weights.""" + learned = {query['query_id']: query for query in trace_queries(learned_trace)} + groups = defaultdict(list) + for control in trace_queries(control_trace): + current = learned.pop(control['query_id'], None) + if current is None or current['shape'] != control['shape'] or current['hard_answers'] != control['hard_answers']: + raise ValueError('Adapter comparison queries or answer counts differ') + groups[control['shape']].append({policy: {metric: current[policy][metric] - control[policy][metric] + for metric in METRICS} for policy in ('sort', 'expected')}) + if learned or not groups: + raise ValueError('Adapter comparison requires identical nonempty query coverage') + rng = np.random.default_rng(seed) + per_shape, draws = {}, {policy: np.zeros(bootstrap_samples) for policy in ('sort', 'expected')} + for shape, queries in sorted(groups.items()): + row = dict(queries=len(queries)) + for policy in draws: + values = np.array([query[policy]['mrr'] for query in queries]) + samples = (np.full(bootstrap_samples, values[0]) if np.ptp(values) == 0 else + np.array([rng.choice(values, size=len(values), replace=True).mean() for _ in range(bootstrap_samples)])) + draws[policy] += samples / len(groups) + row[policy] = {metric: float(np.mean([query[policy][metric] for query in queries])) for metric in METRICS} + row[policy]['mrr_ci95'] = np.quantile(samples, [.025, .975]).tolist() if bootstrap_samples else None + per_shape[shape] = row + macro = {policy: {metric: float(np.mean([row[policy][metric] for row in per_shape.values()])) for metric in METRICS} + | {'mrr_ci95': np.quantile(samples, [.025, .975]).tolist() if bootstrap_samples else None} + for policy, samples in draws.items()} + return dict(per_shape=per_shape, macro=macro, uncertainty=dict(unit='paired query', stratification='query type', + resamples=bootstrap_samples, seed=seed, scope='Conditional on frozen models and adapters; not training-seed uncertainty.')) + + +def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0, title='CQA benchmark'): + """Compare matching coverage only; partial means never become full-suite means.""" + from dicee.query_answering._checkpoint import checksum, read + published = read(published) if published is not None else {'source': None, 'datasets': {}} + rows, details = [], [] + for path in sorted(Path(results).rglob('result.json')): + report = read(path) + run = report.get('benchmark_run', report.get('paper_run')) + if run is None: + continue + trace = path.parent / 'ranks.sqlite3' + if checksum(trace) != report['rank_trace_sha256']: + raise ValueError(f'Rank trace checksum mismatch: {trace}') + expected_types = report.get('dataset_metadata', {}).get('expected_query_types') + if expected_types is None: + expected_types = query_types_for_dataset(report['dataset']) + summary = summarize_trace(trace, bootstrap_samples=bootstrap_samples, seed=seed, expected_types=expected_types) + for shape, values in summary['per_shape'].items(): + for policy in ('sort', 'expected'): + online = report['per_shape'][shape] if policy == 'sort' else report['additional_tie_metrics'][policy]['per_shape'][shape] + if any(not math.isclose(online[metric], values[policy][metric], abs_tol=1e-11) for metric in METRICS): + raise ValueError(f'Offline rank metrics differ from evaluation: {path}') + method = report['inference']['method'] + scores = published['datasets'].get(report['dataset'], {}).get(method, {}) + coverage = summary['all_benchmark_types'] and report['protocol']['full_split'] and report['split'] == 'test' + sort_mrr = summary['averages']['sort']['all']['mrr'] * 100 + expected = summary['averages']['expected']['all']['mrr'] * 100 + paper = sum(scores.values()) / len(expected_types) if set(scores) == set(expected_types) and coverage else None + graph = report.get('dataset_metadata', {}).get('inference_graph', 'dataset-defined') + answer_filter = report['protocol'].get('answer_filter', 'released') + independent = method in GRAPH_INDEPENDENT_METHODS + native_graph = report['reference'].get('inference_graph') + rows.append(dict(id=run['entry'], dataset=report['dataset'], method=method, + inference_graph=graph, answer_filter=answer_filter, + applicable_graphs=['train', 'train+valid'] if independent else [graph], + reference_graph=native_graph, + reference_graph_matches=True if independent else graph == native_graph if native_graph else None, + calibration=report['inference'].get('calibration'), + observed_facts=report['inference'].get('observed_facts'), + execution_profile=report.get('execution_profile', 'unspecified'), + phase=run['phase'], complete_test=coverage, expected_types=list(expected_types), + complete_16_type_test=coverage and summary['all_16_types'], types=len(summary['per_shape']), + published_mrr=paper, sort_mrr=sort_mrr, expected_random_mrr=expected, + tie_delta=expected-sort_mrr, published_delta=sort_mrr-paper if paper is not None else None, + reference=report['reference'])) + details.append(dict(id=run['entry'], dataset=report['dataset'], **summary, + inference_graph=graph, graph_ablation=report.get('graph_ablation') if run['phase'] == 'test' else None, + graph_recipe_sha256=report.get('graph_recipe_sha256'), + calibration=report['inference'].get('calibration'), answer_filter=answer_filter, + filter_paired_with=report.get('filter_paired_with'), + paired_with=report.get('paired_with'), published_per_shape=scores if coverage else {}, result=str(path))) + output = Path(output) + write_json(output / 'comparison.json', dict(rows=rows, details=details, published_source=published['source'])) + with (output / 'per-query-type.csv').open('w', newline='') as stream: + writer = csv.writer(stream) + writer.writerow(['entry', 'dataset', 'inference_graph', 'answer_filter', 'type', 'queries', 'published_mrr', 'sort_mrr', 'expected_random_mrr', 'tie_delta', 'tied_answer_fraction']) + for detail in details: + for shape, values in detail['per_shape'].items(): + writer.writerow([detail['id'], detail['dataset'], detail['inference_graph'], detail['answer_filter'], shape, values['queries'], detail['published_per_shape'].get(shape, ''), + values['sort']['mrr'] * 100, values['expected']['mrr'] * 100, values['delta_mrr'] * 100, values['tied_answer_fraction']]) + lines = [f'# {title}', '', 'MRR ×100. Published comparisons require complete test coverage of the dataset’s query types.', '', + 'Graph-independent methods apply to both graph conditions. Published values may use different graph or answer protocols.', '', + '| Entry | Dataset | Inference facts | Filters | Execution | Scope | Types | Published | Sort | Expected random | Tie Δ |', + '|---|---|---|---|---|---|---:|---:|---:|---:|---:|'] + for row in rows: + paper = f'{row["published_mrr"]:.2f}' if row['published_mrr'] is not None else '—' + scope = 'full test' if row['complete_test'] else row['phase'] + ' / partial' + graph = 'independent' if len(row['applicable_graphs']) > 1 else row['inference_graph'] + lines.append(f'| {row["id"]} | {row["dataset"]} | {graph} | {row["answer_filter"]} | {row["execution_profile"]} | {scope} | {row["types"]} | {paper} | ' + f'{row["sort_mrr"]:.2f} | {row["expected_random_mrr"]:.2f} | {row["tie_delta"]:+.2f} |') + (output / 'comparison.md').write_text('\n'.join(lines) + '\n') + lookup = {row['id']: row for row in details} + pairs = [] + for control in details: + if control['paired_with'] not in lookup: + continue + learned = lookup[control['paired_with']] + effect = adapter_effects(Path(learned['result']).parent / 'ranks.sqlite3', + Path(control['result']).parent / 'ranks.sqlite3', + bootstrap_samples=bootstrap_samples, seed=seed) + if learned['answer_filter'] != control['answer_filter']: + raise ValueError('Adapter comparison changed answer filters') + pairs.append(dict(learned=learned['id'], control=control['id'], dataset=control['dataset'], answer_filter=control['answer_filter'], **effect)) + write_json(output / 'adapter-effects.json', pairs) + lines = ['# Learned adapter effect', '', + 'Learned minus identity calibration, MRR ×100. Observed facts, query plans, operators and beams are held fixed.', '', + '| Entry | Dataset | Sort Δ | Expected random Δ | Expected random 95% CI |', + '|---|---|---:|---:|---|'] + with (output / 'adapter-effects.csv').open('w', newline='') as stream: + writer = csv.writer(stream) + writer.writerow(['entry', 'dataset', 'type', 'queries', 'sort_delta_mrr', 'expected_delta_mrr']) + for pair in pairs: + ci = pair['macro']['expected']['mrr_ci95'] + interval = f'[{ci[0] * 100:+.2f}, {ci[1] * 100:+.2f}]' if ci is not None else '—' + lines.append(f'| {pair["learned"]} | {pair["dataset"]} | {pair["macro"]["sort"]["mrr"] * 100:+.2f} | ' + f'{pair["macro"]["expected"]["mrr"] * 100:+.2f} | {interval} |') + for shape, row in pair['per_shape'].items(): + writer.writerow([pair['learned'], pair['dataset'], shape, row['queries'], + row['sort']['mrr'] * 100, row['expected']['mrr'] * 100]) + (output / 'adapter-effects.md').write_text('\n'.join(lines) + '\n') + groups = defaultdict(dict) + for detail in details: + if detail['graph_ablation']: + group = groups[detail['graph_ablation'], detail['calibration'], detail['answer_filter']] + if detail['inference_graph'] in group: + raise ValueError('Duplicate graph-ablation condition') + group[detail['inference_graph']] = detail + graph_pairs = [] + for group in groups.values(): + if set(group) != {'train', 'train+valid'}: + continue + train, extended = group['train'], group['train+valid'] + if not train['graph_recipe_sha256'] or train['graph_recipe_sha256'] != extended['graph_recipe_sha256']: + raise ValueError('Graph ablation changed model, adapter, operators, beam, or query settings') + effect = adapter_effects(Path(extended['result']).parent / 'ranks.sqlite3', + Path(train['result']).parent / 'ranks.sqlite3', + bootstrap_samples=bootstrap_samples, seed=seed) + graph_pairs.append(dict(train=train['id'], train_valid=extended['id'], dataset=train['dataset'], + calibration=train['calibration'], answer_filter=train['answer_filter'], **effect)) + write_json(output / 'graph-effects.json', graph_pairs) + lines = ['# Inference graph effect', '', + 'Train+valid minus train, MRR ×100. Checkpoints, operators, queries and answer-filter policy are fixed.', '', + '| Train entry | Dataset | Sort Δ | Expected random Δ | Expected random 95% CI |', + '|---|---|---:|---:|---|'] + with (output / 'graph-effects.csv').open('w', newline='') as stream: + writer = csv.writer(stream) + writer.writerow(['train_entry', 'train_valid_entry', 'dataset', 'type', 'queries', 'sort_delta_mrr', 'expected_delta_mrr']) + for pair in graph_pairs: + ci = pair['macro']['expected']['mrr_ci95'] + interval = f'[{ci[0] * 100:+.2f}, {ci[1] * 100:+.2f}]' if ci is not None else '—' + lines.append(f'| {pair["train"]} | {pair["dataset"]} | {pair["macro"]["sort"]["mrr"] * 100:+.2f} | ' + f'{pair["macro"]["expected"]["mrr"] * 100:+.2f} | {interval} |') + for shape, row in pair['per_shape'].items(): + writer.writerow([pair['train'], pair['train_valid'], pair['dataset'], shape, row['queries'], + row['sort']['mrr'] * 100, row['expected']['mrr'] * 100]) + (output / 'graph-effects.md').write_text('\n'.join(lines) + '\n') + filter_pairs = [] + for control in details: + if control['filter_paired_with'] not in lookup: + continue + corrected = lookup[control['filter_paired_with']] + if (corrected['answer_filter'], control['answer_filter']) != ('corrected', 'released'): + raise ValueError('Invalid corrected/released filter comparison') + effect = adapter_effects(Path(corrected['result']).parent / 'ranks.sqlite3', + Path(control['result']).parent / 'ranks.sqlite3', + bootstrap_samples=bootstrap_samples, seed=seed) + filter_pairs.append(dict(corrected=corrected['id'], released=control['id'], dataset=control['dataset'], **effect)) + write_json(output / 'filter-effects.json', filter_pairs) + lines = ['# Answer-filter effect', '', + 'Corrected minus released filters, MRR ×100. Predictions and released hard targets are identical.', '', + '| Entry | Dataset | Sort Δ | Expected random Δ | Expected random 95% CI |', + '|---|---|---:|---:|---|'] + with (output / 'filter-effects.csv').open('w', newline='') as stream: + writer = csv.writer(stream) + writer.writerow(['entry', 'dataset', 'type', 'queries', 'sort_delta_mrr', 'expected_delta_mrr']) + for pair in filter_pairs: + ci = pair['macro']['expected']['mrr_ci95'] + interval = f'[{ci[0] * 100:+.2f}, {ci[1] * 100:+.2f}]' if ci is not None else '—' + lines.append(f'| {pair["corrected"]} | {pair["dataset"]} | {pair["macro"]["sort"]["mrr"] * 100:+.2f} | ' + f'{pair["macro"]["expected"]["mrr"] * 100:+.2f} | {interval} |') + for shape, row in pair['per_shape'].items(): + writer.writerow([pair['corrected'], pair['dataset'], shape, row['queries'], + row['sort']['mrr'] * 100, row['expected']['mrr'] * 100]) + (output / 'filter-effects.md').write_text('\n'.join(lines) + '\n') + return rows diff --git a/benchmarks/cqa/requirements.lock b/benchmarks/cqa/requirements.lock new file mode 100644 index 000000000..999dafc9f --- /dev/null +++ b/benchmarks/cqa/requirements.lock @@ -0,0 +1,68 @@ +# Python 3.11 / Linux; exact installed versions and approved distribution hashes. +aiohappyeyeballs==2.6.1 --hash=sha256:c3f9d0113123803ccadfdf3f0faa505bc78e6a72d1cc4806cbd719826e943558 --hash=sha256:f349ba8f4b75cb25c99c5c2d84e997e485204d2902a9597802b0371f09331fb8 +aiohttp==3.13.3 --hash=sha256:01ad2529d4b5035578f5081606a465f3b814c542882804e2e8cda61adf5c71bf --hash=sha256:042e9e0bcb5fba81886c8b4fbb9a09d6b8a00245fd8d88e4d989c1f96c74164c --hash=sha256:05861afbbec40650d8a07ea324367cb93e9e8cc7762e04dd4405df99fa65159c --hash=sha256:084911a532763e9d3dd95adf78a78f4096cd5f58cdc18e6fdbc1b58417a45423 --hash=sha256:0add0900ff220d1d5c5ebbf99ed88b0c1bbf87aa7e4262300ed1376a6b13414f --hash=sha256:0db318f7a6f065d84cb1e02662c526294450b314a02bd9e2a8e67f0d8564ce40 --hash=sha256:10b47b7ba335d2e9b1239fa571131a87e2d8ec96b333e68b2a305e7a98b0bae2 --hash=sha256:1449ceddcdbcf2e0446957863af03ebaaa03f94c090f945411b61269e2cb5daf --hash=sha256:147e422fd1223005c22b4fe080f5d93ced44460f5f9c105406b753612b587821 --hash=sha256:1cb93e166e6c28716c8c6aeb5f99dfb6d5ccf482d29fe9bf9a794110e6d0ab64 --hash=sha256:215a685b6fbbfcf71dfe96e3eba7a6f58f10da1dfdf4889c7dd856abe430dca7 --hash=sha256:2712039939ec963c237286113c68dbad80a82a4281543f3abf766d9d73228998 --hash=sha256:27234ef6d85c914f9efeb77ff616dbf4ad2380be0cda40b4db086ffc7ddd1b7d --hash=sha256:28e027cf2f6b641693a09f631759b4d9ce9165099d2b5d92af9bd4e197690eea --hash=sha256:2b8d8ddba8f95ba17582226f80e2de99c7a7948e66490ef8d947e272a93e9463 --hash=sha256:2ba0eea45eb5cc3172dbfc497c066f19c41bac70963ea1a67d51fc92e4cf9a80 --hash=sha256:2be0e9ccf23e8a94f6f0650ce06042cefc6ac703d0d7ab6c7a917289f2539ad4 --hash=sha256:2e41b18a58da1e474a057b3d35248d8320029f61d70a37629535b16a0c8f3767 --hash=sha256:2eb752b102b12a76ca02dff751a801f028b4ffbbc478840b473597fc91a9ed43 --hash=sha256:2fc82186fadc4a8316768d61f3722c230e2c1dcab4200d52d2ebdf2482e47592 --hash=sha256:2fff83cfc93f18f215896e3a190e8e5cb413ce01553901aca925176e7568963a --hash=sha256:31a83ea4aead760dfcb6962efb1d861db48c34379f2ff72db9ddddd4cda9ea2e --hash=sha256:34749271508078b261c4abb1767d42b8d0c0cc9449c73a4df494777dc55f0687 --hash=sha256:34bac00a67a812570d4a460447e1e9e06fae622946955f939051e7cc895cfab8 --hash=sha256:37239e9f9a7ea9ac5bf6b92b0260b01f8a22281996da609206a84df860bc1261 --hash=sha256:37da61e244d1749798c151421602884db5270faf479cf0ef03af0ff68954c9dd --hash=sha256:3b61b7169ababd7802f9568ed96142616a9118dd2be0d1866e920e77ec8fa92a --hash=sha256:3d9908a48eb7416dc1f4524e69f1d32e5d90e3981e4e37eb0aa1cd18f9cfa2a4 --hash=sha256:3dd4dce1c718e38081c8f35f323209d4c1df7d4db4bab1b5c88a6b4d12b74587 --hash=sha256:4021b51936308aeea0367b8f006dc999ca02bc118a0cc78c303f50a2ff6afb91 --hash=sha256:40c5e40ecc29ba010656c18052b877a1c28f84344825efa106705e835c28530f --hash=sha256:425c126c0dc43861e22cb1c14ba4c8e45d09516d0a3ae0a3f7494b79f5f233a3 --hash=sha256:44531a36aa2264a1860089ffd4dce7baf875ee5a6079d5fb42e261c704ef7344 --hash=sha256:48e377758516d262bde50c2584fc6c578af272559c409eecbdd2bae1601184d6 --hash=sha256:49a03727c1bba9a97d3e93c9f93ca03a57300f484b6e935463099841261195d3 --hash=sha256:4ae5b5a0e1926e504c81c5b84353e7a5516d8778fbbff00429fe7b05bb25cbce --hash=sha256:4e239d501f73d6db1522599e14b9b321a7e3b1de66ce33d53a765d975e9f4808 --hash=sha256:56339a36b9f1fc708260c76c87e593e2afb30d26de9ae1eb445b5e051b98a7a1 --hash=sha256:568f416a4072fbfae453dcf9a99194bbb8bdeab718e08ee13dfa2ba0e4bebf29 --hash=sha256:5b179331a481cb5529fca8b432d8d3c7001cb217513c94cd72d668d1248688a3 --hash=sha256:5b6073099fb654e0a068ae678b10feff95c5cae95bbfcbfa7af669d361a8aa6b --hash=sha256:5d2d94f1f5fcbe40838ac51a6ab5704a6f9ea42e72ceda48de5e6b898521da51 --hash=sha256:5dff64413671b0d3e7d5918ea490bdccb97a4ad29b3f311ed423200b2203e01c --hash=sha256:5e1d8c8b8f1d91cd08d8f4a3c2b067bfca6ec043d3ff36de0f3a715feeedf926 --hash=sha256:5f8ca7f2bb6ba8348a3614c7918cc4bb73268c5ac2a207576b7afea19d3d9f64 --hash=sha256:642f752c3eb117b105acbd87e2c143de710987e09860d674e068c4c2c441034f --hash=sha256:65d2ccb7eabee90ce0503c17716fc77226be026dcc3e65cce859a30db715025b --hash=sha256:693781c45a4033d31d4187d2436f5ac701e7bbfe5df40d917736108c1cc7436e --hash=sha256:694976222c711d1d00ba131904beb60534f93966562f64440d0c9d41b8cdb440 --hash=sha256:697753042d57f4bf7122cab985bf15d0cef23c770864580f5af4f52023a56bd6 --hash=sha256:69c56fbc1993fa17043e24a546959c0178fe2b5782405ad4559e6c13975c15e3 --hash=sha256:6de499a1a44e7de70735d0b39f67c8f25eb3d91eb3103be99ca0fa882cdd987d --hash=sha256:6fc0e2337d1a4c3e6acafda6a78a39d4c14caea625124817420abceed36e2415 --hash=sha256:75ca857eba4e20ce9f546cd59c7007b33906a4cd48f2ff6ccf1ccfc3b646f279 --hash=sha256:7a4a94eb787e606d0a09404b9c38c113d3b099d508021faa615d70a0131907ce --hash=sha256:7b5e8fe4de30df199155baaf64f2fcd604f4c678ed20910db8e2c66dc4b11603 --hash=sha256:7bfdc049127717581866fa4708791220970ce291c23e28ccf3922c700740fdc0 --hash=sha256:7e63f210bc1b57ef699035f2b4b6d9ce096b5914414a49b0997c839b2bd2223c --hash=sha256:7f9120f7093c2a32d9647abcaf21e6ad275b4fbec5b55969f978b1a97c7c86bf --hash=sha256:8057c98e0c8472d8846b9c79f56766bcc57e3e8ac7bfd510482332366c56c591 --hash=sha256:80dd4c21b0f6237676449c6baaa1039abae86b91636b6c91a7f8e61c87f89540 --hash=sha256:81e97251d9298386c2b7dbeb490d3d1badbdc69107fb8c9299dd04eb39bddc0e --hash=sha256:82611aeec80eb144416956ec85b6ca45a64d76429c1ed46ae1b5f86c6e0c9a26 --hash=sha256:8542f41a62bcc58fc7f11cf7c90e0ec324ce44950003feb70640fc2a9092c32a --hash=sha256:859bd3f2156e81dd01432f5849fc73e2243d4a487c4fd26609b1299534ee1845 --hash=sha256:87797e645d9d8e222e04160ee32aa06bc5c163e8499f24db719e7852ec23093a --hash=sha256:87b9aab6d6ed88235aa2970294f496ff1a1f9adcd724d800e9b952395a80ffd9 --hash=sha256:8a60e60746623925eab7d25823329941aee7242d559baa119ca2b253c88a7bd6 --hash=sha256:90455115e5da1c3c51ab619ac57f877da8fd6d73c05aacd125c5ae9819582aba --hash=sha256:90751b8eed69435bac9ff4e3d2f6b3af1f57e37ecb0fbeee59c0174c9e2d41df --hash=sha256:947c26539750deeaee933b000fb6517cc770bbd064bad6033f1cff4803881e43 --hash=sha256:96d604498a7c782cb15a51c406acaea70d8c027ee6b90c569baa6e7b93073679 --hash=sha256:988a8c5e317544fdf0d39871559e67b6341065b87fceac641108c2096d5506b7 --hash=sha256:9a9dc347e5a3dc7dfdbc1f82da0ef29e388ddb2ed281bfce9dd8248a313e62b7 --hash=sha256:9ae8dd55c8e6c4257eae3a20fd2c8f41edaea5992ed67156642493b8daf3cecc --hash=sha256:9af5e68ee47d6534d36791bbe9b646d2a7c7deb6fc24d7943628edfbb3581f29 --hash=sha256:9b174f267b5cfb9a7dba9ee6859cecd234e9a681841eb85068059bc867fb8f02 --hash=sha256:9bf9f7a65e7aa20dd764151fb3d616c81088f91f8df39c3893a536e279b4b984 --hash=sha256:9d4c940f02f49483b18b079d1c27ab948721852b281f8b015c058100e9421dd1 --hash=sha256:9ebf57d09e131f5323464bd347135a88622d1c0976e88ce15b670e7ad57e4bd6 --hash=sha256:a19884d2ee70b06d9204b2727a7b9f983d0c684c650254679e716b0b77920632 --hash=sha256:a1e53262fd202e4b40b70c3aff944a8155059beedc8a89bba9dc1f9ef06a1b56 --hash=sha256:a2212ad43c0833a873d0fb3c63fa1bacedd4cf6af2fee62bf4b739ceec3ab239 --hash=sha256:a45530014d7a1e09f4a55f4f43097ba0fd155089372e105e4bff4ca76cb1b168 --hash=sha256:a949eee43d3782f2daae4f4a2819b2cb9b0c5d3b7f7a927067cc84dafdbb9f88 --hash=sha256:add1da70de90a2569c5e15249ff76a631ccacfe198375eead4aadf3b8dc849dc --hash=sha256:af71fff7bac6bb7508956696dce8f6eec2bbb045eceb40343944b1ae62b5ef11 --hash=sha256:b04be762396457bef43f3597c991e192ee7da460a4953d7e647ee4b1c28e7046 --hash=sha256:b0d95340658b9d2f11d9697f59b3814a9d3bb4b7a7c20b131df4bcef464037c0 --hash=sha256:b1a6102b4d3ebc07dad44fbf07b45bb600300f15b552ddf1851b5390202ea2e3 --hash=sha256:b46020d11d23fe16551466c77823df9cc2f2c1e63cc965daf67fa5eec6ca1877 --hash=sha256:b556c85915d8efaed322bf1bdae9486aa0f3f764195a0fb6ee962e5c71ef5ce1 --hash=sha256:b903a4dfee7d347e2d87697d0713be59e0b87925be030c9178c5faa58ea58d5c --hash=sha256:b928f30fe49574253644b1ca44b1b8adbd903aa0da4b9054a6c20fc7f4092a25 --hash=sha256:b99281b0704c103d4e11e72a76f1b543d4946fea7dd10767e7e1b5f00d4e5704 --hash=sha256:bae5c2ed2eae26cc382020edad80d01f36cb8e746da40b292e68fec40421dc6a --hash=sha256:bb4f7475e359992b580559e008c598091c45b5088f28614e855e42d39c2f1033 --hash=sha256:bbe7d4cecacb439e2e2a8a1a7b935c25b812af7a5fd26503a66dadf428e79ec1 --hash=sha256:bfc1cc2fe31a6026a8a88e4ecfb98d7f6b1fec150cfd708adbfd1d2f42257c29 --hash=sha256:c014c7ea7fb775dd015b2d3137378b7be0249a448a1612268b5a90c2d81de04d --hash=sha256:c048058117fd649334d81b4b526e94bde3ccaddb20463a815ced6ecbb7d11160 --hash=sha256:c0e2d366af265797506f0283487223146af57815b388623f0357ef7eac9b209d --hash=sha256:c19b90316ad3b24c69cd78d5c9b4f3aa4497643685901185b65166293d36a00f --hash=sha256:c685f2d80bb67ca8c3837823ad76196b3694b0159d232206d1e461d3d434666f --hash=sha256:c6b8568a3bb5819a0ad087f16d40e5a3fb6099f39ea1d5625a3edc1e923fc538 --hash=sha256:d32764c6c9aafb7fb55366a224756387cd50bfa720f32b88e0e6fa45b27dcf29 --hash=sha256:d5a372fd5afd301b3a89582817fdcdb6c34124787c70dbcc616f259013e7eef7 --hash=sha256:d60ac9663f44168038586cab2157e122e46bdef09e9368b37f2d82d354c23f72 --hash=sha256:dca68018bf48c251ba17c72ed479f4dafe9dbd5a73707ad8d28a38d11f3d42af --hash=sha256:de2c184bb1fe2cbd2cefba613e9db29a5ab559323f994b6737e370d3da0ac455 --hash=sha256:e3531d63d3bdfa7e3ac5e9b27b2dd7ec9df3206a98e0b3445fa906f233264c57 --hash=sha256:e50a2e1404f063427c9d027378472316201a2290959a295169bcf25992d04558 --hash=sha256:e636b3c5f61da31a92bf0d91da83e58fdfa96f178ba682f11d24f31944cdd28c --hash=sha256:ea37047c6b367fd4bd632bff8077449b8fa034b69e812a18e0132a00fae6e808 --hash=sha256:f33ed1a2bf1997a36661874b017f5c4b760f41266341af36febaf271d179f6d7 --hash=sha256:f76c1e3fe7d7c8afad7ed193f89a292e1999608170dcc9751a7462a87dfd5bc0 --hash=sha256:f9444f105664c4ce47a2a7171a2418bce5b7bae45fb610f4e2c36045d85911d3 --hash=sha256:fc290605db2a917f6e81b0e1e0796469871f5af381ce15c604a3c5c7e51cb730 --hash=sha256:fc353029f176fd2b3ec6cfc71be166aba1936fe5d73dd1992ce289ca6647a9aa --hash=sha256:fee0c6bc7db1de362252affec009707a17478a00ec69f797d23ca256e36d5940 +aiosignal==1.4.0 --hash=sha256:053243f8b92b990551949e63930a839ff0cf0b0ebbe0597b0f3fb19e1a0fe82e --hash=sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7 +attrs==25.4.0 --hash=sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11 --hash=sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373 +certifi==2026.1.4 --hash=sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c --hash=sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120 +charset-normalizer==3.4.4 --hash=sha256:027f6de494925c0ab2a55eab46ae5129951638a49a34d87f4c3eda90f696b4ad --hash=sha256:077fbb858e903c73f6c9db43374fd213b0b6a778106bc7032446a8e8b5b38b93 --hash=sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394 --hash=sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89 --hash=sha256:0f04b14ffe5fdc8c4933862d8306109a2c51e0704acfa35d51598eb45a1e89fc --hash=sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86 --hash=sha256:194f08cbb32dc406d6e1aea671a68be0823673db2832b38405deba2fb0d88f63 --hash=sha256:1bee1e43c28aa63cb16e5c14e582580546b08e535299b8b6158a7c9c768a1f3d --hash=sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f --hash=sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8 --hash=sha256:244bfb999c71b35de57821b8ea746b24e863398194a4014e4c76adc2bbdfeff0 --hash=sha256:2677acec1a2f8ef614c6888b5b4ae4060cc184174a938ed4e8ef690e15d3e505 --hash=sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161 --hash=sha256:2aaba3b0819274cc41757a1da876f810a3e4d7b6eb25699253a4effef9e8e4af --hash=sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152 --hash=sha256:2c9d3c380143a1fedbff95a312aa798578371eb29da42106a29019368a475318 --hash=sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72 --hash=sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4 --hash=sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e --hash=sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3 --hash=sha256:44c2a8734b333e0578090c4cd6b16f275e07aa6614ca8715e6c038e865e70576 --hash=sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c --hash=sha256:4902828217069c3c5c71094537a8e623f5d097858ac6ca8252f7b4d10b7560f1 --hash=sha256:4bd5d4137d500351a30687c2d3971758aac9a19208fc110ccb9d7188fbe709e8 --hash=sha256:4fe7859a4e3e8457458e2ff592f15ccb02f3da787fcd31e0183879c3ad4692a1 --hash=sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2 --hash=sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44 --hash=sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26 --hash=sha256:5947809c8a2417be3267efc979c47d76a079758166f7d43ef5ae8e9f92751f88 --hash=sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016 --hash=sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede --hash=sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf --hash=sha256:5cb4d72eea50c8868f5288b7f7f33ed276118325c1dfd3957089f6b519e1382a --hash=sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc --hash=sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0 --hash=sha256:64b55f9dce520635f018f907ff1b0df1fdc31f2795a922fb49dd14fbcdf48c84 --hash=sha256:6515f3182dbe4ea06ced2d9e8666d97b46ef4c75e326b79bb624110f122551db --hash=sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1 --hash=sha256:6aee717dcfead04c6eb1ce3bd29ac1e22663cdea57f943c87d1eab9a025438d7 --hash=sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed --hash=sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8 --hash=sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133 --hash=sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e --hash=sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef --hash=sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14 --hash=sha256:778d2e08eda00f4256d7f672ca9fef386071c9202f5e4607920b86d7803387f2 --hash=sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0 --hash=sha256:798d75d81754988d2565bff1b97ba5a44411867c0cf32b77a7e8f8d84796b10d --hash=sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828 --hash=sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f --hash=sha256:7c308f7e26e4363d79df40ca5b2be1c6ba9f02bdbccfed5abddb7859a6ce72cf --hash=sha256:7fa17817dc5625de8a027cb8b26d9fefa3ea28c8253929b8d6649e705d2835b6 --hash=sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328 --hash=sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090 --hash=sha256:837c2ce8c5a65a2035be9b3569c684358dfbf109fd3b6969630a87535495ceaa --hash=sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381 --hash=sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c --hash=sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb --hash=sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc --hash=sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a --hash=sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec --hash=sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc --hash=sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac --hash=sha256:9cd98cdc06614a2f768d2b7286d66805f94c48cde050acdbbb7db2600ab3197e --hash=sha256:9d1bb833febdff5c8927f922386db610b49db6e0d4f4ee29601d71e7c2694313 --hash=sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569 --hash=sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3 --hash=sha256:a61900df84c667873b292c3de315a786dd8dac506704dea57bc957bd31e22c7d --hash=sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525 --hash=sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894 --hash=sha256:a8bf8d0f749c5757af2142fe7903a9df1d2e8aa3841559b2bad34b08d0e2bcf3 --hash=sha256:a9768c477b9d7bd54bc0c86dbaebdec6f03306675526c9927c0e8a04e8f94af9 --hash=sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a --hash=sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9 --hash=sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14 --hash=sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25 --hash=sha256:b5d84d37db046c5ca74ee7bb47dd6cbc13f80665fdde3e8040bdd3fb015ecb50 --hash=sha256:b7cf1017d601aa35e6bb650b6ad28652c9cd78ee6caff19f3c28d03e1c80acbf --hash=sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1 --hash=sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3 --hash=sha256:c4ef880e27901b6cc782f1b95f82da9313c0eb95c3af699103088fa0ac3ce9ac --hash=sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e --hash=sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815 --hash=sha256:cb01158d8b88ee68f15949894ccc6712278243d95f344770fa7593fa2d94410c --hash=sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6 --hash=sha256:cc00f04ed596e9dc0da42ed17ac5e596c6ccba999ba6bd92b0e0aef2f170f2d6 --hash=sha256:cd09d08005f958f370f539f186d10aec3377d55b9eeb0d796025d4886119d76e --hash=sha256:cd4b7ca9984e5e7985c12bc60a6f173f3c958eae74f3ef6624bb6b26e2abbae4 --hash=sha256:ce8a0633f41a967713a59c4139d29110c07e826d131a316b50ce11b1d79b4f84 --hash=sha256:cead0978fc57397645f12578bfd2d5ea9138ea0fac82b2f63f7f7c6877986a69 --hash=sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15 --hash=sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191 --hash=sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0 --hash=sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897 --hash=sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd --hash=sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2 --hash=sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794 --hash=sha256:e824f1492727fa856dd6eda4f7cee25f8518a12f3c4a56a74e8095695089cf6d --hash=sha256:e912091979546adf63357d7e2ccff9b44f026c075aeaf25a52d0e95ad2281074 --hash=sha256:eaabd426fe94daf8fd157c32e571c85cb12e66692f15516a83a03264b08d06c3 --hash=sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224 --hash=sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838 --hash=sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a --hash=sha256:f155a433c2ec037d4e8df17d18922c3a0d9b3232a396690f17175d2946f0218d --hash=sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d --hash=sha256:f34be2938726fc13801220747472850852fe6b1ea75869a048d6f896838c896f --hash=sha256:f820802628d2694cb7e56db99213f930856014862f3fd943d290ea8438d07ca8 --hash=sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490 --hash=sha256:f8e160feb2aed042cd657a72acc0b481212ed28b1b9a95c0cee1621b524e1966 --hash=sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9 --hash=sha256:fa09f53c465e532f4d3db095e0c55b615f010ad81803d383195b6b5ca6cbf5f3 --hash=sha256:faa3a41b2b66b6e50f84ae4a68c64fcd0c44355741c6374813a800cd6695db9e --hash=sha256:fd44c878ea55ba351104cb93cc85e74916eb8fa440ca7903e57575e97394f608 +filelock==3.20.2 --hash=sha256:a2241ff4ddde2a7cebddf78e39832509cb045d18ec1a09d7248d6bfc6bfbbe64 --hash=sha256:fbba7237d6ea277175a32c54bb71ef814a8546d8601269e1bfc388de333974e8 +frozenlist==1.8.0 --hash=sha256:0325024fe97f94c41c08872db482cf8ac4800d80e79222c6b0b7b162d5b13686 --hash=sha256:032efa2674356903cd0261c4317a561a6850f3ac864a63fc1583147fb05a79b0 --hash=sha256:03ae967b4e297f58f8c774c7eabcce57fe3c2434817d4385c50661845a058121 --hash=sha256:06be8f67f39c8b1dc671f5d83aaefd3358ae5cdcf8314552c57e7ed3e6475bdd --hash=sha256:073f8bf8becba60aa931eb3bc420b217bb7d5b8f4750e6f8b3be7f3da85d38b7 --hash=sha256:07cdca25a91a4386d2e76ad992916a85038a9b97561bf7a3fd12d5d9ce31870c --hash=sha256:09474e9831bc2b2199fad6da3c14c7b0fbdd377cce9d3d77131be28906cb7d84 --hash=sha256:0c18a16eab41e82c295618a77502e17b195883241c563b00f0aa5106fc4eaa0d --hash=sha256:0f96534f8bfebc1a394209427d0f8a63d343c9779cda6fc25e8e121b5fd8555b --hash=sha256:102e6314ca4da683dca92e3b1355490fed5f313b768500084fbe6371fddfdb79 --hash=sha256:11847b53d722050808926e785df837353bd4d75f1d494377e59b23594d834967 --hash=sha256:119fb2a1bd47307e899c2fac7f28e85b9a543864df47aa7ec9d3c1b4545f096f --hash=sha256:13d23a45c4cebade99340c4165bd90eeb4a56c6d8a9d8aa49568cac19a6d0dc4 --hash=sha256:154e55ec0655291b5dd1b8731c637ecdb50975a2ae70c606d100750a540082f7 --hash=sha256:168c0969a329b416119507ba30b9ea13688fafffac1b7822802537569a1cb0ef --hash=sha256:17c883ab0ab67200b5f964d2b9ed6b00971917d5d8a92df149dc2c9779208ee9 --hash=sha256:1a7607e17ad33361677adcd1443edf6f5da0ce5e5377b798fba20fae194825f3 --hash=sha256:1a7fa382a4a223773ed64242dbe1c9c326ec09457e6b8428efb4118c685c3dfd --hash=sha256:1aa77cb5697069af47472e39612976ed05343ff2e84a3dcf15437b232cbfd087 --hash=sha256:1b9290cf81e95e93fdf90548ce9d3c1211cf574b8e3f4b3b7cb0537cf2227068 --hash=sha256:20e63c9493d33ee48536600d1a5c95eefc870cd71e7ab037763d1fbb89cc51e7 --hash=sha256:21900c48ae04d13d416f0e1e0c4d81f7931f73a9dfa0b7a8746fb2fe7dd970ed --hash=sha256:229bf37d2e4acdaf808fd3f06e854a4a7a3661e871b10dc1f8f1896a3b05f18b --hash=sha256:2552f44204b744fba866e573be4c1f9048d6a324dfe14475103fd51613eb1d1f --hash=sha256:27c6e8077956cf73eadd514be8fb04d77fc946a7fe9f7fe167648b0b9085cc25 --hash=sha256:28bd570e8e189d7f7b001966435f9dac6718324b5be2990ac496cf1ea9ddb7fe --hash=sha256:294e487f9ec720bd8ffcebc99d575f7eff3568a08a253d1ee1a0378754b74143 --hash=sha256:29548f9b5b5e3460ce7378144c3010363d8035cea44bc0bf02d57f5a685e084e --hash=sha256:2c5dcbbc55383e5883246d11fd179782a9d07a986c40f49abe89ddf865913930 --hash=sha256:2dc43a022e555de94c3b68a4ef0b11c4f747d12c024a520c7101709a2144fb37 --hash=sha256:2f05983daecab868a31e1da44462873306d3cbfd76d1f0b5b69c473d21dbb128 --hash=sha256:33139dc858c580ea50e7e60a1b0ea003efa1fd42e6ec7fdbad78fff65fad2fd2 --hash=sha256:332db6b2563333c5671fecacd085141b5800cb866be16d5e3eb15a2086476675 --hash=sha256:33f48f51a446114bc5d251fb2954ab0164d5be02ad3382abcbfe07e2531d650f --hash=sha256:34187385b08f866104f0c0617404c8eb08165ab1272e884abc89c112e9c00746 --hash=sha256:342c97bf697ac5480c0a7ec73cd700ecfa5a8a40ac923bd035484616efecc2df --hash=sha256:3462dd9475af2025c31cc61be6652dfa25cbfb56cbbf52f4ccfe029f38decaf8 --hash=sha256:39ecbc32f1390387d2aa4f5a995e465e9e2f79ba3adcac92d68e3e0afae6657c --hash=sha256:3e0761f4d1a44f1d1a47996511752cf3dcec5bbdd9cc2b4fe595caf97754b7a0 --hash=sha256:3ede829ed8d842f6cd48fc7081d7a41001a56f1f38603f9d49bf3020d59a31ad --hash=sha256:3ef2d026f16a2b1866e1d86fc4e1291e1ed8a387b2c333809419a2f8b3a77b82 --hash=sha256:405e8fe955c2280ce66428b3ca55e12b3c4e9c336fb2103a4937e891c69a4a29 --hash=sha256:42145cd2748ca39f32801dad54aeea10039da6f86e303659db90db1c4b614c8c --hash=sha256:4314debad13beb564b708b4a496020e5306c7333fa9a3ab90374169a20ffab30 --hash=sha256:433403ae80709741ce34038da08511d4a77062aa924baf411ef73d1146e74faf --hash=sha256:44389d135b3ff43ba8cc89ff7f51f5a0bb6b63d829c8300f79a2fe4fe61bcc62 --hash=sha256:48e6d3f4ec5c7273dfe83ff27c91083c6c9065af655dc2684d2c200c94308bb5 --hash=sha256:494a5952b1c597ba44e0e78113a7266e656b9794eec897b19ead706bd7074383 --hash=sha256:4970ece02dbc8c3a92fcc5228e36a3e933a01a999f7094ff7c23fbd2beeaa67c --hash=sha256:4e0c11f2cc6717e0a741f84a527c52616140741cd812a50422f83dc31749fb52 --hash=sha256:50066c3997d0091c411a66e710f4e11752251e6d2d73d70d8d5d4c76442a199d --hash=sha256:517279f58009d0b1f2e7c1b130b377a349405da3f7621ed6bfae50b10adf20c1 --hash=sha256:54b2077180eb7f83dd52c40b2750d0a9f175e06a42e3213ce047219de902717a --hash=sha256:5500ef82073f599ac84d888e3a8c1f77ac831183244bfd7f11eaa0289fb30714 --hash=sha256:581ef5194c48035a7de2aefc72ac6539823bb71508189e5de01d60c9dcd5fa65 --hash=sha256:59a6a5876ca59d1b63af8cd5e7ffffb024c3dc1e9cf9301b21a2e76286505c95 --hash=sha256:5a3a935c3a4e89c733303a2d5a7c257ea44af3a56c8202df486b7f5de40f37e1 --hash=sha256:5c1c8e78426e59b3f8005e9b19f6ff46e5845895adbde20ece9218319eca6506 --hash=sha256:5d63a068f978fc69421fb0e6eb91a9603187527c86b7cd3f534a5b77a592b888 --hash=sha256:667c3777ca571e5dbeb76f331562ff98b957431df140b54c85fd4d52eea8d8f6 --hash=sha256:6da155091429aeba16851ecb10a9104a108bcd32f6c1642867eadaee401c1c41 --hash=sha256:6dc4126390929823e2d2d9dc79ab4046ed74680360fc5f38b585c12c66cdf459 --hash=sha256:7398c222d1d405e796970320036b1b563892b65809d9e5261487bb2c7f7b5c6a --hash=sha256:74c51543498289c0c43656701be6b077f4b265868fa7f8a8859c197006efb608 --hash=sha256:776f352e8329135506a1d6bf16ac3f87bc25b28e765949282dcc627af36123aa --hash=sha256:778a11b15673f6f1df23d9586f83c4846c471a8af693a22e066508b77d201ec8 --hash=sha256:78f7b9e5d6f2fdb88cdde9440dc147259b62b9d3b019924def9f6478be254ac1 --hash=sha256:799345ab092bee59f01a915620b5d014698547afd011e691a208637312db9186 --hash=sha256:7bf6cdf8e07c8151fba6fe85735441240ec7f619f935a5205953d58009aef8c6 --hash=sha256:8009897cdef112072f93a0efdce29cd819e717fd2f649ee3016efd3cd885a7ed --hash=sha256:80f85f0a7cc86e7a54c46d99c9e1318ff01f4687c172ede30fd52d19d1da1c8e --hash=sha256:8585e3bb2cdea02fc88ffa245069c36555557ad3609e83be0ec71f54fd4abb52 --hash=sha256:878be833caa6a3821caf85eb39c5ba92d28e85df26d57afb06b35b2efd937231 --hash=sha256:8a76ea0f0b9dfa06f254ee06053d93a600865b3274358ca48a352ce4f0798450 --hash=sha256:8b7b94a067d1c504ee0b16def57ad5738701e4ba10cec90529f13fa03c833496 --hash=sha256:8d92f1a84bb12d9e56f818b3a746f3efba93c1b63c8387a73dde655e1e42282a --hash=sha256:908bd3f6439f2fef9e85031b59fd4f1297af54415fb60e4254a95f75b3cab3f3 --hash=sha256:92db2bf818d5cc8d9c1f1fc56b897662e24ea5adb36ad1f1d82875bd64e03c24 --hash=sha256:940d4a017dbfed9daf46a3b086e1d2167e7012ee297fef9e1c545c4d022f5178 --hash=sha256:957e7c38f250991e48a9a73e6423db1bb9dd14e722a10f6b8bb8e16a0f55f695 --hash=sha256:96153e77a591c8adc2ee805756c61f59fef4cf4073a9275ee86fe8cba41241f7 --hash=sha256:96f423a119f4777a4a056b66ce11527366a8bb92f54e541ade21f2374433f6d4 --hash=sha256:97260ff46b207a82a7567b581ab4190bd4dfa09f4db8a8b49d1a958f6aa4940e --hash=sha256:974b28cf63cc99dfb2188d8d222bc6843656188164848c4f679e63dae4b0708e --hash=sha256:9ff15928d62a0b80bb875655c39bf517938c7d589554cbd2669be42d97c2cb61 --hash=sha256:a6483e309ca809f1efd154b4d37dc6d9f61037d6c6a81c2dc7a15cb22c8c5dca --hash=sha256:a88f062f072d1589b7b46e951698950e7da00442fc1cacbe17e19e025dc327ad --hash=sha256:ac913f8403b36a2c8610bbfd25b8013488533e71e62b4b4adce9c86c8cea905b --hash=sha256:adbeebaebae3526afc3c96fad434367cafbfd1b25d72369a9e5858453b1bb71a --hash=sha256:b2a095d45c5d46e5e79ba1e5b9cb787f541a8dee0433836cea4b96a2c439dcd8 --hash=sha256:b3210649ee28062ea6099cfda39e147fa1bc039583c8ee4481cb7811e2448c51 --hash=sha256:b37f6d31b3dcea7deb5e9696e529a6aa4a898adc33db82da12e4c60a7c4d2011 --hash=sha256:b4dec9482a65c54a5044486847b8a66bf10c9cb4926d42927ec4e8fd5db7fed8 --hash=sha256:b4f3b365f31c6cd4af24545ca0a244a53688cad8834e32f56831c4923b50a103 --hash=sha256:b6db2185db9be0a04fecf2f241c70b63b1a242e2805be291855078f2b404dd6b --hash=sha256:b9be22a69a014bc47e78072d0ecae716f5eb56c15238acca0f43d6eb8e4a5bda --hash=sha256:bac9c42ba2ac65ddc115d930c78d24ab8d4f465fd3fc473cdedfccadb9429806 --hash=sha256:bf0a7e10b077bf5fb9380ad3ae8ce20ef919a6ad93b4552896419ac7e1d8e042 --hash=sha256:c23c3ff005322a6e16f71bf8692fcf4d5a304aaafe1e262c98c6d4adc7be863e --hash=sha256:c4c800524c9cd9bac5166cd6f55285957fcfc907db323e193f2afcd4d9abd69b --hash=sha256:c7366fe1418a6133d5aa824ee53d406550110984de7637d65a178010f759c6ef --hash=sha256:c8d1634419f39ea6f5c427ea2f90ca85126b54b50837f31497f3bf38266e853d --hash=sha256:c9a63152fe95756b85f31186bddf42e4c02c6321207fd6601a1c89ebac4fe567 --hash=sha256:cb89a7f2de3602cfed448095bab3f178399646ab7c61454315089787df07733a --hash=sha256:cba69cb73723c3f329622e34bdbf5ce1f80c21c290ff04256cff1cd3c2036ed2 --hash=sha256:cee686f1f4cadeb2136007ddedd0aaf928ab95216e7691c63e50a8ec066336d0 --hash=sha256:cf253e0e1c3ceb4aaff6df637ce033ff6535fb8c70a764a8f46aafd3d6ab798e --hash=sha256:d1eaff1d00c7751b7c6662e9c5ba6eb2c17a2306ba5e2a37f24ddf3cc953402b --hash=sha256:d3bb933317c52d7ea5004a1c442eef86f426886fba134ef8cf4226ea6ee1821d --hash=sha256:d4d3214a0f8394edfa3e303136d0575eece0745ff2b47bd2cb2e66dd92d4351a --hash=sha256:d6a5df73acd3399d893dafc71663ad22534b5aa4f94e8a2fabfe856c3c1b6a52 --hash=sha256:d8b7138e5cd0647e4523d6685b0eac5d4be9a184ae9634492f25c6eb38c12a47 --hash=sha256:db1e72ede2d0d7ccb213f218df6a078a9c09a7de257c2fe8fcef16d5925230b1 --hash=sha256:e25ac20a2ef37e91c1b39938b591457666a0fa835c7783c3a8f33ea42870db94 --hash=sha256:e2de870d16a7a53901e41b64ffdf26f2fbb8917b3e6ebf398098d72c5b20bd7f --hash=sha256:e4a3408834f65da56c83528fb52ce7911484f0d1eaf7b761fc66001db1646eff --hash=sha256:eaa352d7047a31d87dafcacbabe89df0aa506abb5b1b85a2fb91bc3faa02d822 --hash=sha256:eab8145831a0d56ec9c4139b6c3e594c7a83c2c8be25d5bcf2d86136a532287a --hash=sha256:ec3cc8c5d4084591b4237c0a272cc4f50a5b03396a47d9caaf76f5d7b38a4f11 --hash=sha256:edee74874ce20a373d62dc28b0b18b93f645633c2943fd90ee9d898550770581 --hash=sha256:eefdba20de0d938cec6a89bd4d70f346a03108a19b9df4248d3cf0d88f1b0f51 --hash=sha256:ef2b7b394f208233e471abc541cc6991f907ffd47dc72584acee3147899d6565 --hash=sha256:f21f00a91358803399890ab167098c131ec2ddd5f8f5fd5fe9c9f2c6fcd91e40 --hash=sha256:f4be2e3d8bc8aabd566f8d5b8ba7ecc09249d74ba3c9ed52e54dc23a293f0b92 --hash=sha256:f57fb59d9f385710aa7060e89410aeb5058b99e62f4d16b08b91986b9a2140c2 --hash=sha256:f6292f1de555ffcc675941d65fffffb0a5bcd992905015f85d0592201793e0e5 --hash=sha256:f833670942247a14eafbb675458b4e61c82e002a148f49e68257b79296e865c4 --hash=sha256:fa47e444b8ba08fffd1c18e8cdb9a75db1b6a27f17507522834ad13ed5922b93 --hash=sha256:fb30f9626572a76dfe4293c7194a09fb1fe93ba94c7d4f720dfae3b646b45027 --hash=sha256:fe3c58d2f5db5fbd18c2987cba06d51b0529f52bc3a6cdc33d3f4eab725104bd +fsspec==2025.12.0 --hash=sha256:8bf1fe301b7d8acfa6e8571e3b1c3d158f909666642431cc78a1b7b4dbc5ec5b --hash=sha256:c505de011584597b1060ff778bb664c1bc022e87921b0e4f10cc9c44f9635973 +idna==3.11 --hash=sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea --hash=sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902 +iniconfig==2.3.0 --hash=sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730 --hash=sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12 +jinja2==3.1.6 --hash=sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d --hash=sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67 +joblib==1.5.3 --hash=sha256:5fc3c5039fc5ca8c0276333a188bbd59d6b7ab37fe6632daa76bc7f9ec18e713 --hash=sha256:8561a3269e6801106863fd0d6d84bb737be9e7631e33aaed3fb9ce5953688da3 +lightning==2.6.0 --hash=sha256:881841716b59c1837ae0c562c2e64fea9bcf49ef9de3867bd1f868557ec23d04 --hash=sha256:f1a13a48909960a3454518486f113fae4fadb2db0e28e9c50d8d38d46c9dc3d6 +lightning-utilities==0.15.2 --hash=sha256:ad3ab1703775044bbf880dbf7ddaaac899396c96315f3aa1779cec9d618a9841 --hash=sha256:cdf12f530214a63dacefd713f180d1ecf5d165338101617b4742e8f22c032e24 +markupsafe==3.0.3 --hash=sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f --hash=sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a --hash=sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf --hash=sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19 --hash=sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf --hash=sha256:0f4b68347f8c5eab4a13419215bdfd7f8c9b19f2b25520968adfad23eb0ce60c --hash=sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175 --hash=sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219 --hash=sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb --hash=sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6 --hash=sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab --hash=sha256:15d939a21d546304880945ca1ecb8a039db6b4dc49b2c5a400387cdae6a62e26 --hash=sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1 --hash=sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce --hash=sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218 --hash=sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634 --hash=sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695 --hash=sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad --hash=sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73 --hash=sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c --hash=sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe --hash=sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa --hash=sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559 --hash=sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa --hash=sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37 --hash=sha256:3537e01efc9d4dccdf77221fb1cb3b8e1a38d5428920e0657ce299b20324d758 --hash=sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f --hash=sha256:38664109c14ffc9e7437e86b4dceb442b0096dfe3541d7864d9cbe1da4cf36c8 --hash=sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d --hash=sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c --hash=sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97 --hash=sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a --hash=sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19 --hash=sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9 --hash=sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9 --hash=sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc --hash=sha256:591ae9f2a647529ca990bc681daebdd52c8791ff06c2bfa05b65163e28102ef2 --hash=sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4 --hash=sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354 --hash=sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50 --hash=sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698 --hash=sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9 --hash=sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b --hash=sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc --hash=sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115 --hash=sha256:7c3fb7d25180895632e5d3148dbdc29ea38ccb7fd210aa27acbd1201a1902c6e --hash=sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485 --hash=sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f --hash=sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12 --hash=sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025 --hash=sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009 --hash=sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d --hash=sha256:949b8d66bc381ee8b007cd945914c721d9aba8e27f71959d750a46f7c282b20b --hash=sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a --hash=sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5 --hash=sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f --hash=sha256:a320721ab5a1aba0a233739394eb907f8c8da5c98c9181d1161e77a0c8e36f2d --hash=sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1 --hash=sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287 --hash=sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6 --hash=sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f --hash=sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581 --hash=sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed --hash=sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b --hash=sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c --hash=sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026 --hash=sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8 --hash=sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676 --hash=sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6 --hash=sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e --hash=sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d --hash=sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d --hash=sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01 --hash=sha256:df2449253ef108a379b8b5d6b43f4b1a8e81a061d6537becd5582fba5f9196d7 --hash=sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419 --hash=sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795 --hash=sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1 --hash=sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5 --hash=sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d --hash=sha256:e8fc20152abba6b83724d7ff268c249fa196d8259ff481f3b1476383f8f24e42 --hash=sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe --hash=sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda --hash=sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e --hash=sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737 --hash=sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523 --hash=sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591 --hash=sha256:f71a396b3bf33ecaa1626c255855702aca4d3d9fea5e051b41ac59a9c1c41edc --hash=sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a --hash=sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50 +mpmath==1.3.0 --hash=sha256:7a28eb2a9774d00c7bc92411c19a89209d5da7c4c9a9e227be8330a23a25b91f --hash=sha256:a0b2b9fe80bbcd81a6647ff13108738cfb482d481d826cc0e02f5b35e5c88d2c +multidict==6.7.0 --hash=sha256:03ca744319864e92721195fa28c7a3b2bc7b686246b35e4078c1e4d0eb5466d3 --hash=sha256:040f393368e63fb0f3330e70c26bfd336656bed925e5cbe17c9da839a6ab13ec --hash=sha256:05047ada7a2fde2631a0ed706f1fd68b169a681dfe5e4cf0f8e4cb6618bbc2cd --hash=sha256:0591b48acf279821a579282444814a2d8d0af624ae0bc600aa4d1b920b6e924b --hash=sha256:07f5594ac6d084cbb5de2df218d78baf55ef150b91f0ff8a21cc7a2e3a5a58eb --hash=sha256:08325c9e5367aa379a3496aa9a022fe8837ff22e00b94db256d3a1378c76ab32 --hash=sha256:08d4379f9744d8f78d98c8673c06e202ffa88296f009c71bbafe8a6bf847d01f --hash=sha256:0934f3843a1860dd465d38895c17fce1f1cb37295149ab05cd1b9a03afacb2a7 --hash=sha256:096f52730c3fb8ed419db2d44391932b63891b2c5ed14850a7e215c0ba9ade36 --hash=sha256:09929cab6fcb68122776d575e03c6cc64ee0b8fca48d17e135474b042ce515cd --hash=sha256:0a13fb8e748dfc94749f622de065dd5c1def7e0d2216dba72b1d8069a389c6ff --hash=sha256:0db4956f82723cc1c270de9c6e799b4c341d327762ec78ef82bb962f79cc07d8 --hash=sha256:123e2a72e20537add2f33a79e605f6191fba2afda4cbb876e35c1a7074298a7d --hash=sha256:14c9e076eede3b54c636f8ce1c9c252b5f057c62131211f0ceeec273810c9721 --hash=sha256:171b73bd4ee683d307599b66793ac80981b06f069b62eea1c9e29c9241aa66b0 --hash=sha256:18706cc31dbf402a7945916dd5cddf160251b6dab8a2c5f3d6d5a55949f676b3 --hash=sha256:19a1d55338ec1be74ef62440ca9e04a2f001a04d0cc49a4983dc320ff0f3212d --hash=sha256:2049be98fb57a31b4ccf870bf377af2504d4ae35646a19037ec271e4c07998aa --hash=sha256:2090d3718829d1e484706a2f525e50c892237b2bf9b17a79b059cb98cddc2f10 --hash=sha256:2397ab4daaf2698eb51a76721e98db21ce4f52339e535725de03ea962b5a3202 --hash=sha256:23bfeee5316266e5ee2d625df2d2c602b829435fc3a235c2ba2131495706e4a0 --hash=sha256:27e0b36c2d388dc7b6ced3406671b401e84ad7eb0656b8f3a2f46ed0ce483718 --hash=sha256:28b37063541b897fd6a318007373930a75ca6d6ac7c940dbe14731ffdd8d498e --hash=sha256:295a92a76188917c7f99cda95858c822f9e4aae5824246bba9b6b44004ddd0a6 --hash=sha256:29fe6740ebccba4175af1b9b87bf553e9c15cd5868ee967e010efcf94e4fd0f1 --hash=sha256:2a7baa46a22e77f0988e3b23d4ede5513ebec1929e34ee9495be535662c0dfe2 --hash=sha256:2d2cfeec3f6f45651b3d408c4acec0ebf3daa9bc8a112a084206f5db5d05b754 --hash=sha256:2f67396ec0310764b9222a1728ced1ab638f61aadc6226f17a71dd9324f9a99c --hash=sha256:30d193c6cc6d559db42b6bcec8a5d395d34d60c9877a0b71ecd7c204fcf15390 --hash=sha256:31bae522710064b5cbeddaf2e9f32b1abab70ac6ac91d42572502299e9953128 --hash=sha256:329aa225b085b6f004a4955271a7ba9f1087e39dcb7e65f6284a988264a63912 --hash=sha256:363eb68a0a59bd2303216d2346e6c441ba10d36d1f9969fcb6f1ba700de7bb5c --hash=sha256:394fc5c42a333c9ffc3e421a4c85e08580d990e08b99f6bf35b4132114c5dcb3 --hash=sha256:3996b50c3237c4aec17459217c1e7bbdead9a22a0fcd3c365564fbd16439dde6 --hash=sha256:39f1719f57adbb767ef592a50ae5ebb794220d1188f9ca93de471336401c34d2 --hash=sha256:3b29b980d0ddbecb736735ee5bef69bb2ddca56eff603c86f3f29a1128299b4f --hash=sha256:3ba3ef510467abb0667421a286dc906e30eb08569365f5cdb131d7aff7c2dd84 --hash=sha256:3bab1e4aff7adaa34410f93b1f8e57c4b36b9af0426a76003f441ee1d3c7e842 --hash=sha256:3d7b6ccce016e29df4b7ca819659f516f0bc7a4b3efa3bb2012ba06431b044f9 --hash=sha256:3da4fb467498df97e986af166b12d01f05d2e04f978a9c1c680ea1988e0bc4b6 --hash=sha256:3e56d780c238f9e1ae66a22d2adf8d16f485381878250db8d496623cd38b22bd --hash=sha256:3e8bfdd0e487acf992407a140d2589fe598238eaeffa3da8448d63a63cd363f8 --hash=sha256:44b546bd3eb645fd26fb949e43c02a25a2e632e2ca21a35e2e132c8105dc8599 --hash=sha256:478cc36476687bac1514d651cbbaa94b86b0732fb6855c60c673794c7dd2da62 --hash=sha256:490dab541a6a642ce1a9d61a4781656b346a55c13038f0b1244653828e3a83ec --hash=sha256:4a0df7ff02397bb63e2fd22af2c87dfa39e8c7f12947bc524dbdc528282c7e34 --hash=sha256:4b73189894398d59131a66ff157837b1fafea9974be486d036bb3d32331fdbf0 --hash=sha256:4b7a9db5a870f780220e931d0002bbfd88fb53aceb6293251e2c839415c1b20e --hash=sha256:4c09703000a9d0fa3c3404b27041e574cc7f4df4c6563873246d0e11812a94b6 --hash=sha256:4d409aa42a94c0b3fa617708ef5276dfe81012ba6753a0370fcc9d0195d0a1fc --hash=sha256:4d72a9a2d885f5c208b0cb91ff2ed43636bb7e345ec839ff64708e04f69a13cc --hash=sha256:4ef089f985b8c194d341eb2c24ae6e7408c9a0e2e5658699c92f497437d88c3c --hash=sha256:51cb455de290ae462593e5b1cb1118c5c22ea7f0d3620d9940bf695cea5a4bd7 --hash=sha256:521f33e377ff64b96c4c556b81c55d0cfffb96a11c194fd0c3f1e56f3d8dd5a4 --hash=sha256:53a42d364f323275126aff81fb67c5ca1b7a04fda0546245730a55c8c5f24bc4 --hash=sha256:5aa873cbc8e593d361ae65c68f85faadd755c3295ea2c12040ee146802f23b38 --hash=sha256:654030da3197d927f05a536a66186070e98765aa5142794c9904555d3a9d8fb5 --hash=sha256:661709cdcd919a2ece2234f9bae7174e5220c80b034585d7d8a755632d3e2111 --hash=sha256:680878b9f3d45c31e1f730eef731f9b0bc1da456155688c6745ee84eb818e90e --hash=sha256:6843b28b0364dc605f21481c90fadb5f60d9123b442eb8a726bb74feef588a84 --hash=sha256:68af405971779d8b37198726f2b6fe3955db846fee42db7a4286fc542203934c --hash=sha256:6b4c3d199f953acd5b446bf7c0de1fe25d94e09e79086f8dc2f48a11a129cdf1 --hash=sha256:6bdce131e14b04fd34a809b6380dbfd826065c3e2fe8a50dbae659fa0c390546 --hash=sha256:716133f7d1d946a4e1b91b1756b23c088881e70ff180c24e864c26192ad7534a --hash=sha256:749a72584761531d2b9467cfbdfd29487ee21124c304c4b6cb760d8777b27f9c --hash=sha256:7516c579652f6a6be0e266aec0acd0db80829ca305c3d771ed898538804c2036 --hash=sha256:79dcf9e477bc65414ebfea98ffd013cb39552b5ecd62908752e0e413d6d06e38 --hash=sha256:7a0222514e8e4c514660e182d5156a415c13ef0aabbd71682fc714e327b95e99 --hash=sha256:7b022717c748dd1992a83e219587aabe45980d88969f01b316e78683e6285f64 --hash=sha256:7bf77f54997a9166a2f5675d1201520586439424c2511723a7312bdb4bcc034e --hash=sha256:7e73299c99939f089dd9b2120a04a516b95cdf8c1cd2b18c53ebf0de80b1f18f --hash=sha256:7ef6b61cad77091056ce0e7ce69814ef72afacb150b7ac6a3e9470def2198159 --hash=sha256:7f5170993a0dd3ab871c74f45c0a21a4e2c37a2f2b01b5f722a2ad9c6650469e --hash=sha256:803d685de7be4303b5a657b76e2f6d1240e7e0a8aa2968ad5811fa2285553a12 --hash=sha256:8891681594162635948a636c9fe0ff21746aeb3dd5463f6e25d9bea3a8a39ca1 --hash=sha256:8a19cdb57cd3df4cd865849d93ee14920fb97224300c88501f16ecfa2604b4e0 --hash=sha256:8a3862568a36d26e650a19bb5cbbba14b71789032aebc0423f8cc5f150730184 --hash=sha256:8b55d5497b51afdfde55925e04a022f1de14d4f4f25cdfd4f5d9b0aa96166851 --hash=sha256:8cfc12a8630a29d601f48d47787bd7eb730e475e83edb5d6c5084317463373eb --hash=sha256:9281bf5b34f59afbc6b1e477a372e9526b66ca446f4bf62592839c195a718b32 --hash=sha256:92abb658ef2d7ef22ac9f8bb88e8b6c3e571671534e029359b6d9e845923eb1b --hash=sha256:94218fcec4d72bc61df51c198d098ce2b378e0ccbac41ddbed5ef44092913288 --hash=sha256:95b5ffa4349df2887518bb839409bcf22caa72d82beec453216802f475b23c81 --hash=sha256:9600082733859f00d79dee64effc7aef1beb26adb297416a4ad2116fd61374bd --hash=sha256:960c60b5849b9b4f9dcc9bea6e3626143c252c74113df2c1540aebce70209b45 --hash=sha256:9b2fd74c52accced7e75de26023b7dccee62511a600e62311b918ec5c168fc2a --hash=sha256:9c0359b1ec12b1d6849c59f9d319610b7f20ef990a6d454ab151aa0e3b9f78ca --hash=sha256:9cf41880c991716f3c7cec48e2f19ae4045fc9db5fc9cff27347ada24d710bb5 --hash=sha256:9d14baca2ee12c1a64740d4531356ba50b82543017f3ad6de0deb943c5979abb --hash=sha256:9f474ad5acda359c8758c8accc22032c6abe6dc87a8be2440d097785e27a9349 --hash=sha256:9fb0211dfc3b51efea2f349ec92c114d7754dd62c01f81c3e32b765b70c45c9b --hash=sha256:9fe04da3f79387f450fd0061d4dd2e45a72749d31bf634aecc9e27f24fdc4b3f --hash=sha256:9ff96e8815eecacc6645da76c413eb3b3d34cfca256c70b16b286a687d013c32 --hash=sha256:a027ec240fe73a8d6281872690b988eed307cd7d91b23998ff35ff577ca688b5 --hash=sha256:a048ce45dcdaaf1defb76b2e684f997fb5abf74437b6cb7b22ddad934a964e34 --hash=sha256:a265acbb7bb33a3a2d626afbe756371dce0279e7b17f4f4eda406459c2b5ff1c --hash=sha256:a35c5fc61d4f51eb045061e7967cfe3123d622cd500e8868e7c0c592a09fedc4 --hash=sha256:a37bd74c3fa9d00be2d7b8eca074dc56bd8077ddd2917a839bd989612671ed17 --hash=sha256:a60a4d75718a5efa473ebd5ab685786ba0c67b8381f781d1be14da49f1a2dc60 --hash=sha256:a6ef16328011d3f468e7ebc326f24c1445f001ca1dec335b2f8e66bed3006394 --hash=sha256:a90af66facec4cebe4181b9e62a68be65e45ac9b52b67de9eec118701856e7ff --hash=sha256:ad9ce259f50abd98a1ca0aa6e490b58c316a0fce0617f609723e40804add2c00 --hash=sha256:afa8a2978ec65d2336305550535c9c4ff50ee527914328c8677b3973ade52b85 --hash=sha256:b15b3afff74f707b9275d5ba6a91ae8f6429c3ffb29bbfd216b0b375a56f13d7 --hash=sha256:b284e319754366c1aee2267a2036248b24eeb17ecd5dc16022095e747f2f4304 --hash=sha256:b2d7f80c4e1fd010b07cb26820aae86b7e73b681ee4889684fb8d2d4537aab13 --hash=sha256:b3bc26a951007b1057a1c543af845f1c7e3e71cc240ed1ace7bf4484aa99196e --hash=sha256:b3e34f3a1b8131ba06f1a73adab24f30934d148afcd5f5de9a73565a4404384e --hash=sha256:b4121773c49a0776461f4a904cdf6264c88e42218aaa8407e803ca8025872792 --hash=sha256:b61189b29081a20c7e4e0b49b44d5d44bb0dc92be3c6d06a11cc043f81bf9329 --hash=sha256:b6234e14f9314731ec45c42fc4554b88133ad53a09092cc48a88e771c125dadb --hash=sha256:b8512bac933afc3e45fb2b18da8e59b78d4f408399a960339598374d4ae3b56b --hash=sha256:ba672b26069957ee369cfa7fc180dde1fc6f176eaf1e6beaf61fbebbd3d9c000 --hash=sha256:bee7c0588aa0076ce77c0ea5d19a68d76ad81fcd9fe8501003b9a24f9d4000f6 --hash=sha256:c04a328260dfd5db8c39538f999f02779012268f54614902d0afc775d44e0a62 --hash=sha256:c1dcc7524066fa918c6a27d61444d4ee7900ec635779058571f70d042d86ed63 --hash=sha256:c6e99d9a65ca282e578dfea819cfa9c0a62b2499d8677392e09feaf305e9e6f5 --hash=sha256:ca43bdfa5d37bd6aee89d85e1d0831fb86e25541be7e9d376ead1b28974f8e5e --hash=sha256:caf53b15b1b7df9fbd0709aa01409000a2b4dd03a5f6f5cc548183c7c8f8b63c --hash=sha256:cc41db090ed742f32bd2d2c721861725e6109681eddf835d0a82bd3a5c382827 --hash=sha256:cd240939f71c64bd658f186330603aac1a9a81bf6273f523fca63673cb7378a8 --hash=sha256:ce8fdc2dca699f8dbf055a61d73eaa10482569ad20ee3c36ef9641f69afa8c91 --hash=sha256:d1bed1b467ef657f2a0ae62844a607909ef1c6889562de5e1d505f74457d0b96 --hash=sha256:d1d964afecdf3a8288789df2f5751dc0a8261138c3768d9af117ed384e538fad --hash=sha256:d4393e3581e84e5645506923816b9cc81f5609a778c7e7534054091acc64d1c6 --hash=sha256:d874eb056410ca05fed180b6642e680373688efafc7f077b2a2f61811e873a40 --hash=sha256:db99677b4457c7a5c5a949353e125ba72d62b35f74e26da141530fbb012218a7 --hash=sha256:dd32a49400a2c3d52088e120ee00c1e3576cbff7e10b98467962c74fdb762ed4 --hash=sha256:df0e3bf7993bdbeca5ac25aa859cf40d39019e015c9c91809ba7093967f7a648 --hash=sha256:e011555abada53f1578d63389610ac8a5400fc70ce71156b0aa30d326f1a5064 --hash=sha256:e2862408c99f84aa571ab462d25236ef9cb12a602ea959ba9c9009a54902fc73 --hash=sha256:e3aa16de190d29a0ea1b48253c57d99a68492c8dd8948638073ab9e74dc9410b --hash=sha256:e93a0617cd16998784bf4414c7e40f17a35d2350e5c6f0bd900d3a8e02bd3762 --hash=sha256:ea3334cabe4d41b7ccd01e4d349828678794edbc2d3ae97fc162a3312095092e --hash=sha256:eb866162ef2f45063acc7a53a88ef6fe8bf121d45c30ea3c9cd87ce7e191a8d4 --hash=sha256:ec81878ddf0e98817def1e77d4f50dae5ef5b0e4fe796fae3bd674304172416e --hash=sha256:efbb54e98446892590dc2458c19c10344ee9a883a79b5cec4bc34d6656e8d546 --hash=sha256:f0e77e3c0008bc9316e662624535b88d360c3a5d3f81e15cf12c139a75250046 --hash=sha256:f0feece2ef8ebc42ed9e2e8c78fc4aa3cf455733b507c09ef7406364c94376c6 --hash=sha256:f470f68adc395e0183b92a2f4689264d1ea4b40504a24d9882c27375e6662bb9 --hash=sha256:f844a1bbf1d207dd311a56f383f7eda2d0e134921d45751842d8235e7778965d --hash=sha256:f8a93b1c0ed2d04b97a5e9336fd2d33371b9a6e29ab7dd6503d63407c20ffbaf --hash=sha256:f8e5c0031b90ca9ce555e2e8fd5c3b02a25f14989cbc310701823832c99eb687 --hash=sha256:fb287618b9c7aa3bf8d825f02d9201b2f13078a5ed3b293c8f4d953917d84d5e --hash=sha256:fbafe31d191dfa7c4c51f7a6149c9fb7e914dcf9ffead27dcfd9f1ae382b3885 --hash=sha256:fbd18dc82d7bf274b37aa48d664534330af744e03bccf696d6f4c6042e7d19e7 +networkx==3.6.1 --hash=sha256:26b7c357accc0c8cde558ad486283728b65b6a95d85ee1cd66bafab4c8168509 --hash=sha256:d47fbf302e7d9cbbb9e2555a0d267983d2aa476bac30e90dfbe5669bd57f3762 +numpy==1.26.4 --hash=sha256:03a8c78d01d9781b28a6989f6fa1bb2c4f2d51201cf99d3dd875df6fbd96b23b --hash=sha256:08beddf13648eb95f8d867350f6a018a4be2e5ad54c8d8caed89ebca558b2818 --hash=sha256:1af303d6b2210eb850fcf03064d364652b7120803a0b872f5211f5234b399f20 --hash=sha256:1dda2e7b4ec9dd512f84935c5f126c8bd8b9f2fc001e9f54af255e8c5f16b0e0 --hash=sha256:2a02aba9ed12e4ac4eb3ea9421c420301a0c6460d9830d74a9df87efa4912010 --hash=sha256:2e4ee3380d6de9c9ec04745830fd9e2eccb3e6cf790d39d7b98ffd19b0dd754a --hash=sha256:3373d5d70a5fe74a2c1bb6d2cfd9609ecf686d47a2d7b1d37a8f3b6bf6003aea --hash=sha256:47711010ad8555514b434df65f7d7b076bb8261df1ca9bb78f53d3b2db02e95c --hash=sha256:4c66707fabe114439db9068ee468c26bbdf909cac0fb58686a42a24de1760c71 --hash=sha256:50193e430acfc1346175fcbdaa28ffec49947a06918b7b92130744e81e640110 --hash=sha256:52b8b60467cd7dd1e9ed082188b4e6bb35aa5cdd01777621a1658910745b90be --hash=sha256:60dedbb91afcbfdc9bc0b1f3f402804070deed7392c23eb7a7f07fa857868e8a --hash=sha256:62b8e4b1e28009ef2846b4c7852046736bab361f7aeadeb6a5b89ebec3c7055a --hash=sha256:666dbfb6ec68962c033a450943ded891bed2d54e6755e35e5835d63f4f6931d5 --hash=sha256:675d61ffbfa78604709862923189bad94014bef562cc35cf61d3a07bba02a7ed --hash=sha256:679b0076f67ecc0138fd2ede3a8fd196dddc2ad3254069bcb9faf9a79b1cebcd --hash=sha256:7349ab0fa0c429c82442a27a9673fc802ffdb7c7775fad780226cb234965e53c --hash=sha256:7ab55401287bfec946ced39700c053796e7cc0e3acbef09993a9ad2adba6ca6e --hash=sha256:7e50d0a0cc3189f9cb0aeb3a6a6af18c16f59f004b866cd2be1c14b36134a4a0 --hash=sha256:95a7476c59002f2f6c590b9b7b998306fba6a5aa646b1e22ddfeaf8f78c3a29c --hash=sha256:96ff0b2ad353d8f990b63294c8986f1ec3cb19d749234014f4e7eb0112ceba5a --hash=sha256:9fad7dcb1aac3c7f0584a5a8133e3a43eeb2fe127f47e3632d43d677c66c102b --hash=sha256:9ff0f4f29c51e2803569d7a51c2304de5554655a60c5d776e35b4a41413830d0 --hash=sha256:a354325ee03388678242a4d7ebcd08b5c727033fcff3b2f536aea978e15ee9e6 --hash=sha256:a4abb4f9001ad2858e7ac189089c42178fcce737e4169dc61321660f1a96c7d2 --hash=sha256:ab47dbe5cc8210f55aa58e4805fe224dac469cde56b9f731a4c098b91917159a --hash=sha256:afedb719a9dcfc7eaf2287b839d8198e06dcd4cb5d276a3df279231138e83d30 --hash=sha256:b3ce300f3644fb06443ee2222c2201dd3a89ea6040541412b8fa189341847218 --hash=sha256:b97fe8060236edf3662adfc2c633f56a08ae30560c56310562cb4f95500022d5 --hash=sha256:bfe25acf8b437eb2a8b2d49d443800a5f18508cd811fea3181723922a8a82b07 --hash=sha256:cd25bcecc4974d09257ffcd1f098ee778f7834c3ad767fe5db785be9a4aa9cb2 --hash=sha256:d209d8969599b27ad20994c8e41936ee0964e6da07478d6c35016bc386b66ad4 --hash=sha256:d5241e0a80d808d70546c697135da2c613f30e28251ff8307eb72ba696945764 --hash=sha256:edd8b5fe47dab091176d21bb6de568acdd906d1887a4584a15a9a96a1dca06ef --hash=sha256:f870204a840a60da0b12273ef34f7051e98c3b5961b61b0c2c1be6dfd64fbcd3 --hash=sha256:ffa75af20b44f8dba823498024771d5ac50620e6915abac414251bd971b4529f +nvidia-cublas-cu12==12.8.4.1 --hash=sha256:47e9b82132fa8d2b4944e708049229601448aaad7e6f296f630f2d1a32de35af --hash=sha256:8ac4e771d5a348c551b2a426eda6193c19aa630236b418086020df5ba9667142 --hash=sha256:b86f6dd8935884615a0683b663891d43781b819ac4f2ba2b0c9604676af346d0 +nvidia-cuda-cupti-cu12==12.8.90 --hash=sha256:4412396548808ddfed3f17a467b104ba7751e6b58678a4b840675c56d21cf7ed --hash=sha256:bb479dcdf7e6d4f8b0b01b115260399bf34154a1a2e9fe11c85c517d87efd98e --hash=sha256:ea0cb07ebda26bb9b29ba82cda34849e73c166c18162d3913575b0c9db9a6182 +nvidia-cuda-nvrtc-cu12==12.8.93 --hash=sha256:7a4b6b2904850fe78e0bd179c4b655c404d4bb799ef03ddc60804247099ae909 --hash=sha256:a7756528852ef889772a84c6cd89d41dfa74667e24cca16bb31f8f061e3e9994 --hash=sha256:fc1fec1e1637854b4c0a65fb9a8346b51dd9ee69e61ebaccc82058441f15bce8 +nvidia-cuda-runtime-cu12==12.8.90 --hash=sha256:52bf7bbee900262ffefe5e9d5a2a69a30d97e2bc5bb6cc866688caa976966e3d --hash=sha256:adade8dcbd0edf427b7204d480d6066d33902cab2a4707dcfc48a2d0fd44ab90 --hash=sha256:c0c6027f01505bfed6c3b21ec546f69c687689aad5f1a377554bc6ca4aa993a8 +nvidia-cudnn-cu12==9.10.2.21 --hash=sha256:949452be657fa16687d0930933f032835951ef0892b37d2d53824d1a84dc97a8 --hash=sha256:c6288de7d63e6cf62988f0923f96dc339cea362decb1bf5b3141883392a7d65e --hash=sha256:c9132cc3f8958447b4910a1720036d9eff5928cc3179b0a51fb6d167c6cc87d8 +nvidia-cufft-cu12==11.3.3.83 --hash=sha256:4d2dd21ec0b88cf61b62e6b43564355e5222e4a3fb394cac0db101f2dd0d4f74 --hash=sha256:7a64a98ef2a7c47f905aaf8931b69a3a43f27c55530c698bb2ed7c75c0b42cb7 --hash=sha256:848ef7224d6305cdb2a4df928759dca7b1201874787083b6e7550dd6765ce69a +nvidia-cufile-cu12==1.13.1.3 --hash=sha256:1d069003be650e131b21c932ec3d8969c1715379251f8d23a1860554b1cb24fc --hash=sha256:4beb6d4cce47c1a0f1013d72e02b0994730359e17801d395bdcbf20cfb3bb00a +nvidia-curand-cu12==10.3.9.90 --hash=sha256:b32331d4f4df5d6eefa0554c565b626c7216f87a06a4f56fab27c3b68a830ec9 --hash=sha256:dfab99248034673b779bc6decafdc3404a8a6f502462201f2f31f11354204acd --hash=sha256:f149a8ca457277da854f89cf282d6ef43176861926c7ac85b2a0fbd237c587ec +nvidia-cusolver-cu12==11.7.3.90 --hash=sha256:4376c11ad263152bd50ea295c05370360776f8c3427b30991df774f9fb26c450 --hash=sha256:4a550db115fcabc4d495eb7d39ac8b58d4ab5d8e63274d3754df1c0ad6a22d34 --hash=sha256:db9ed69dbef9715071232caa9b69c52ac7de3a95773c2db65bdba85916e4e5c0 +nvidia-cusparse-cu12==12.5.8.93 --hash=sha256:1ec05d76bbbd8b61b06a80e1eaf8cf4959c3d4ce8e711b65ebd0443bb0ebb13b --hash=sha256:9a33604331cb2cac199f2e7f5104dfbb8a5a898c367a53dfda9ff2acb6b6b4dd --hash=sha256:9b6c161cb130be1a07a27ea6923df8141f3c295852f4b260c65f18f3e0a091dc +nvidia-cusparselt-cu12==0.7.1 --hash=sha256:8878dce784d0fac90131b6817b607e803c36e629ba34dc5b433471382196b6a5 --hash=sha256:f1bb701d6b930d5a7cea44c19ceb973311500847f81b634d802b7b539dc55623 --hash=sha256:f67fbb5831940ec829c9117b7f33807db9f9678dc2a617fbe781cac17b4e1075 +nvidia-nccl-cu12==2.27.5 --hash=sha256:31432ad4d1fb1004eb0c56203dc9bc2178a1ba69d1d9e02d64a6938ab5e40e7a --hash=sha256:ad730cf15cb5d25fe849c6e6ca9eb5b76db16a80f13f425ac68d8e2e55624457 +nvidia-nvjitlink-cu12==12.8.93 --hash=sha256:81ff63371a7ebd6e6451970684f916be2eab07321b73c9d244dc2b4da7f73b88 --hash=sha256:adccd7161ace7261e01bb91e44e88da350895c270d23f744f0820c818b7229e7 --hash=sha256:bd93fbeeee850917903583587f4fc3a4eafa022e34572251368238ab5e6bd67f +nvidia-nvshmem-cu12==3.3.20 --hash=sha256:0b0b960da3842212758e4fa4696b94f129090b30e5122fea3c5345916545cff0 --hash=sha256:d00f26d3f9b2e3c3065be895e3059d6479ea5c638a3f38c9fec49b1b9dd7c1e5 +nvidia-nvtx-cu12==12.8.90 --hash=sha256:5b17e2001cc0d751a5bc2c6ec6d26ad95913324a4adb86788c944f8ce9ba441f --hash=sha256:619c8304aedc69f02ea82dd244541a83c3d9d40993381b3b590f1adaed3db41e --hash=sha256:d7ad891da111ebafbf7e015d34879f7112832fc239ff0d7d776b6cb685274615 +packaging==25.0 --hash=sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484 --hash=sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f +pandas==2.3.3 --hash=sha256:0242fe9a49aa8b4d78a4fa03acb397a58833ef6199e9aa40a95f027bb3a1b6e7 --hash=sha256:1611aedd912e1ff81ff41c745822980c49ce4a7907537be8692c8dbc31924593 --hash=sha256:1b07204a219b3b7350abaae088f451860223a52cfb8a6c53358e7948735158e5 --hash=sha256:1d37b5848ba49824e5c30bedb9c830ab9b7751fd049bc7914533e01c65f79791 --hash=sha256:23ebd657a4d38268c7dfbdf089fbc31ea709d82e4923c5ffd4fbd5747133ce73 --hash=sha256:2462b1a365b6109d275250baaae7b760fd25c726aaca0054649286bcfbb3e8ec --hash=sha256:28083c648d9a99a5dd035ec125d42439c6c1c525098c58af0fc38dd1a7a1b3d4 --hash=sha256:2e3ebdb170b5ef78f19bfb71b0dc5dc58775032361fa188e814959b74d726dd5 --hash=sha256:318d77e0e42a628c04dc56bcef4b40de67918f7041c2b061af1da41dcff670ac --hash=sha256:371a4ab48e950033bcf52b6527eccb564f52dc826c02afd9a1bc0ab731bba084 --hash=sha256:376c6446ae31770764215a6c937f72d917f214b43560603cd60da6408f183b6c --hash=sha256:3869faf4bd07b3b66a9f462417d0ca3a9df29a9f6abd5d0d0dbab15dac7abe87 --hash=sha256:3fd2f887589c7aa868e02632612ba39acb0b8948faf5cc58f0850e165bd46f35 --hash=sha256:4793891684806ae50d1288c9bae9330293ab4e083ccd1c5e383c34549c6e4250 --hash=sha256:4e0a175408804d566144e170d0476b15d78458795bb18f1304fb94160cabf40c --hash=sha256:503cf027cf9940d2ceaa1a93cfb5f8c8c7e6e90720a2850378f0b3f3b1e06826 --hash=sha256:5554c929ccc317d41a5e3d1234f3be588248e61f08a74dd17c9eabb535777dc9 --hash=sha256:56851a737e3470de7fa88e6131f41281ed440d29a9268dcbf0002da5ac366713 --hash=sha256:5caf26f64126b6c7aec964f74266f435afef1c1b13da3b0636c7518a1fa3e2b1 --hash=sha256:602b8615ebcc4a0c1751e71840428ddebeb142ec02c786e8ad6b1ce3c8dec523 --hash=sha256:6253c72c6a1d990a410bc7de641d34053364ef8bcd3126f7e7450125887dffe3 --hash=sha256:6435cb949cb34ec11cc9860246ccb2fdc9ecd742c12d3304989017d53f039a78 --hash=sha256:6d21f6d74eb1725c2efaa71a2bfc661a0689579b58e9c0ca58a739ff0b002b53 --hash=sha256:6d2cefc361461662ac48810cb14365a365ce864afe85ef1f447ff5a1e99ea81c --hash=sha256:74ecdf1d301e812db96a465a525952f4dde225fdb6d8e5a521d47e1f42041e21 --hash=sha256:75ea25f9529fdec2d2e93a42c523962261e567d250b0013b16210e1d40d7c2e5 --hash=sha256:854d00d556406bffe66a4c0802f334c9ad5a96b4f1f868adf036a21b11ef13ff --hash=sha256:8fe25fc7b623b0ef6b5009149627e34d2a4657e880948ec3c840e9402e5c1b45 --hash=sha256:900f47d8f20860de523a1ac881c4c36d65efcb2eb850e6948140fa781736e110 --hash=sha256:93c2d9ab0fc11822b5eece72ec9587e172f63cff87c00b062f6e37448ced4493 --hash=sha256:a16dcec078a01eeef8ee61bf64074b4e524a2a3f4b3be9326420cabe59c4778b --hash=sha256:a21d830e78df0a515db2b3d2f5570610f5e6bd2e27749770e8bb7b524b89b450 --hash=sha256:a45c765238e2ed7d7c608fc5bc4a6f88b642f2f01e70c0c23d2224dd21829d86 --hash=sha256:a637c5cdfa04b6d6e2ecedcb81fc52ffb0fd78ce2ebccc9ea964df9f658de8c8 --hash=sha256:a68e15f780eddf2b07d242e17a04aa187a7ee12b40b930bfdd78070556550e98 --hash=sha256:b3d11d2fda7eb164ef27ffc14b4fcab16a80e1ce67e9f57e19ec0afaf715ba89 --hash=sha256:b468d3dad6ff947df92dcb32ede5b7bd41a9b3cceef0a30ed925f6d01fb8fa66 --hash=sha256:b98560e98cb334799c0b07ca7967ac361a47326e9b4e5a7dfb5ab2b1c9d35a1b --hash=sha256:bdcd9d1167f4885211e401b3036c0c8d9e274eee67ea8d0758a256d60704cfe8 --hash=sha256:bf1f8a81d04ca90e32a0aceb819d34dbd378a98bf923b6398b9a3ec0bf44de29 --hash=sha256:c46467899aaa4da076d5abc11084634e2d197e9460643dd455ac3db5856b24d6 --hash=sha256:c4fc4c21971a1a9f4bdb4c73978c7f7256caa3e62b323f70d6cb80db583350bc --hash=sha256:c503ba5216814e295f40711470446bc3fd00f0faea8a086cbc688808e26f92a2 --hash=sha256:d051c0e065b94b7a3cea50eb1ec32e912cd96dba41647eb24104b6c6c14c5788 --hash=sha256:d3e28b3e83862ccf4d85ff19cf8c20b2ae7e503881711ff2d534dc8f761131aa --hash=sha256:db4301b2d1f926ae677a751eb2bd0e8c5f5319c9cb3f88b0becbbb0b07b34151 --hash=sha256:dd7478f1463441ae4ca7308a70e90b33470fa593429f9d4c578dd00d1fa78838 --hash=sha256:e05e1af93b977f7eafa636d043f9f94c7ee3ac81af99c13508215942e64c993b --hash=sha256:e19d192383eab2f4ceb30b412b22ea30690c9e618f78870357ae1d682912015a --hash=sha256:e32e7cc9af0f1cc15548288a51a3b681cc2a219faa838e995f7dc53dbab1062d --hash=sha256:ecaf1e12bdc03c86ad4a7ea848d66c685cb6851d807a26aa245ca3d2017a1908 --hash=sha256:ee15f284898e7b246df8087fc82b87b01686f98ee67d85a17b7ab44143a3a9a0 --hash=sha256:ee67acbbf05014ea6c763beb097e03cd629961c8a632075eeb34247120abcb4b --hash=sha256:f086f6fe114e19d92014a1966f43a3e62285109afe874f067f5abbdcbb10e59c --hash=sha256:f8bfc0e12dc78f777f323f55c58649591b2cd0c43534e8355c51d3fede5f4dee +pluggy==1.6.0 --hash=sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3 --hash=sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746 +polars==1.36.1 --hash=sha256:12c7616a2305559144711ab73eaa18814f7aa898c522e7645014b68f1432d54c --hash=sha256:853c1bbb237add6a5f6d133c15094a9b727d66dd6a4eb91dbb07cdb056b2b8ef +polars-runtime-32==1.36.1 --hash=sha256:201c2cfd80ceb5d5cd7b63085b5fd08d6ae6554f922bcb941035e39638528a09 --hash=sha256:327b621ca82594f277751f7e23d4b939ebd1be18d54b4cdf7a2f8406cecc18b2 --hash=sha256:809e73857be71250141225ddd5d2b30c97e6340aeaa0d445f930e01bef6888dc --hash=sha256:899b9ad2e47ceb31eb157f27a09dbc2047efbf4969a923a6b1ba7f0412c3e64c --hash=sha256:ab0d1f23084afee2b97de8c37aa3e02ec3569749ae39571bd89e7a8b11ae9e83 --hash=sha256:cc17101f28c9a169ff8b5b8d4977a3683cd403621841623825525f440b564cf0 --hash=sha256:d9d077bb9df711bc635a86540df48242bb91975b353e53ef261c6fae6cb0948f +propcache==0.4.1 --hash=sha256:0002004213ee1f36cfb3f9a42b5066100c44276b9b72b4e1504cddd3d692e86e --hash=sha256:0013cb6f8dde4b2a2f66903b8ba740bdfe378c943c4377a200551ceb27f379e4 --hash=sha256:005f08e6a0529984491e37d8dbc3dd86f84bd78a8ceb5fa9a021f4c48d4984be --hash=sha256:031dce78b9dc099f4c29785d9cf5577a3faf9ebf74ecbd3c856a7b92768c3df3 --hash=sha256:05674a162469f31358c30bcaa8883cb7829fa3110bf9c0991fe27d7896c42d85 --hash=sha256:060b16ae65bc098da7f6d25bf359f1f31f688384858204fe5d652979e0015e5b --hash=sha256:120c964da3fdc75e3731aa392527136d4ad35868cc556fd09bb6d09172d9a367 --hash=sha256:15932ab57837c3368b024473a525e25d316d8353016e7cc0e5ba9eb343fbb1cf --hash=sha256:17612831fda0138059cc5546f4d12a2aacfb9e47068c06af35c400ba58ba7393 --hash=sha256:182b51b421f0501952d938dc0b0eb45246a5b5153c50d42b495ad5fb7517c888 --hash=sha256:1cdb7988c4e5ac7f6d175a28a9aa0c94cb6f2ebe52756a3c0cda98d2809a9e37 --hash=sha256:1eb2994229cc8ce7fe9b3db88f5465f5fd8651672840b2e426b88cdb1a30aac8 --hash=sha256:1f0978529a418ebd1f49dad413a2b68af33f85d5c5ca5c6ca2a3bed375a7ac60 --hash=sha256:204483131fb222bdaaeeea9f9e6c6ed0cac32731f75dfc1d4a567fc1926477c1 --hash=sha256:296f4c8ed03ca7476813fe666c9ea97869a8d7aec972618671b33a38a5182ef4 --hash=sha256:2ad890caa1d928c7c2965b48f3a3815c853180831d0e5503d35cf00c472f4717 --hash=sha256:2b16ec437a8c8a965ecf95739448dd938b5c7f56e67ea009f4300d8df05f32b7 --hash=sha256:2bb07ffd7eaad486576430c89f9b215f9e4be68c4866a96e97db9e97fead85dc --hash=sha256:333ddb9031d2704a301ee3e506dc46b1fe5f294ec198ed6435ad5b6a085facfe --hash=sha256:357f5bb5c377a82e105e44bd3d52ba22b616f7b9773714bff93573988ef0a5fb --hash=sha256:35c3277624a080cc6ec6f847cbbbb5b49affa3598c4535a0a4682a697aaa5c75 --hash=sha256:364426a62660f3f699949ac8c621aad6977be7126c5807ce48c0aeb8e7333ea6 --hash=sha256:381914df18634f5494334d201e98245c0596067504b9372d8cf93f4bb23e025e --hash=sha256:3d233076ccf9e450c8b3bc6720af226b898ef5d051a2d145f7d765e6e9f9bcff --hash=sha256:3d902a36df4e5989763425a8ab9e98cd8ad5c52c823b34ee7ef307fd50582566 --hash=sha256:3f7124c9d820ba5548d431afb4632301acf965db49e666aa21c305cbe8c6de12 --hash=sha256:405aac25c6394ef275dee4c709be43745d36674b223ba4eb7144bf4d691b7367 --hash=sha256:41a89040cb10bd345b3c1a873b2bf36413d48da1def52f268a055f7398514874 --hash=sha256:43eedf29202c08550aac1d14e0ee619b0430aaef78f85864c1a892294fbc28cf --hash=sha256:473c61b39e1460d386479b9b2f337da492042447c9b685f28be4f74d3529e566 --hash=sha256:49a2dc67c154db2c1463013594c458881a069fcf98940e61a0569016a583020a --hash=sha256:4b536b39c5199b96fc6245eb5fb796c497381d3942f169e44e8e392b29c9ebcc --hash=sha256:4c3c70630930447f9ef1caac7728c8ad1c56bc5015338b20fed0d08ea2480b3a --hash=sha256:4d3df5fa7e36b3225954fba85589da77a0fe6a53e3976de39caf04a0db4c36f1 --hash=sha256:4d7af63f9f93fe593afbf104c21b3b15868efb2c21d07d8732c0c4287e66b6a6 --hash=sha256:501d20b891688eb8e7aa903021f0b72d5a55db40ffaab27edefd1027caaafa61 --hash=sha256:521a463429ef54143092c11a77e04056dd00636f72e8c45b70aaa3140d639726 --hash=sha256:5558992a00dfd54ccbc64a32726a3357ec93825a418a401f5cc67df0ac5d9e49 --hash=sha256:55c72fd6ea2da4c318e74ffdf93c4fe4e926051133657459131a95c846d16d44 --hash=sha256:564d9f0d4d9509e1a870c920a89b2fec951b44bf5ba7d537a9e7c1ccec2c18af --hash=sha256:580e97762b950f993ae618e167e7be9256b8353c2dcd8b99ec100eb50f5286aa --hash=sha256:5a103c3eb905fcea0ab98be99c3a9a5ab2de60228aa5aceedc614c0281cf6153 --hash=sha256:5c3310452e0d31390da9035c348633b43d7e7feb2e37be252be6da45abd1abcc --hash=sha256:5d4e2366a9c7b837555cf02fb9be2e3167d333aff716332ef1b7c3a142ec40c5 --hash=sha256:5fd37c406dd6dc85aa743e214cef35dc54bbdd1419baac4f6ae5e5b1a2976938 --hash=sha256:60a8fda9644b7dfd5dece8c61d8a85e271cb958075bfc4e01083c148b61a7caf --hash=sha256:66c1f011f45a3b33d7bcb22daed4b29c0c9e2224758b6be00686731e1b46f925 --hash=sha256:671538c2262dadb5ba6395e26c1731e1d52534bfe9ae56d0b5573ce539266aa8 --hash=sha256:678ae89ebc632c5c204c794f8dab2837c5f159aeb59e6ed0539500400577298c --hash=sha256:67fad6162281e80e882fb3ec355398cf72864a54069d060321f6cd0ade95fe85 --hash=sha256:6918ecbd897443087a3b7cd978d56546a812517dcaaca51b49526720571fa93e --hash=sha256:6f6ff873ed40292cd4969ef5310179afd5db59fdf055897e282485043fc80ad0 --hash=sha256:6f8b465489f927b0df505cbe26ffbeed4d6d8a2bbc61ce90eb074ff129ef0ab1 --hash=sha256:71b749281b816793678ae7f3d0d84bd36e694953822eaad408d682efc5ca18e0 --hash=sha256:74c1fb26515153e482e00177a1ad654721bf9207da8a494a0c05e797ad27b992 --hash=sha256:7c2d1fa3201efaf55d730400d945b5b3ab6e672e100ba0f9a409d950ab25d7db --hash=sha256:824e908bce90fb2743bd6b59db36eb4f45cd350a39637c9f73b1c1ea66f5b75f --hash=sha256:8326e144341460402713f91df60ade3c999d601e7eb5ff8f6f7862d54de0610d --hash=sha256:8873eb4460fd55333ea49b7d189749ecf6e55bf85080f11b1c4530ed3034cba1 --hash=sha256:89eb3fa9524f7bec9de6e83cf3faed9d79bffa560672c118a96a171a6f55831e --hash=sha256:8c9b3cbe4584636d72ff556d9036e0c9317fa27b3ac1f0f558e7e84d1c9c5900 --hash=sha256:8e57061305815dfc910a3634dcf584f08168a8836e6999983569f51a8544cd89 --hash=sha256:929d7cbe1f01bb7baffb33dc14eb5691c95831450a26354cd210a8155170c93a --hash=sha256:92d1935ee1f8d7442da9c0c4fa7ac20d07e94064184811b685f5c4fada64553b --hash=sha256:948dab269721ae9a87fd16c514a0a2c2a1bdb23a9a61b969b0f9d9ee2968546f --hash=sha256:981333cb2f4c1896a12f4ab92a9cc8f09ea664e9b7dbdc4eff74627af3a11c0f --hash=sha256:990f6b3e2a27d683cb7602ed6c86f15ee6b43b1194736f9baaeb93d0016633b1 --hash=sha256:99d43339c83aaf4d32bda60928231848eee470c6bda8d02599cc4cebe872d183 --hash=sha256:9a0bd56e5b100aef69bd8562b74b46254e7c8812918d3baa700c8a8009b0af66 --hash=sha256:9a52009f2adffe195d0b605c25ec929d26b36ef986ba85244891dee3b294df21 --hash=sha256:9d2b6caef873b4f09e26ea7e33d65f42b944837563a47a94719cc3544319a0db --hash=sha256:9f302f4783709a78240ebc311b793f123328716a60911d667e0c036bc5dcbded --hash=sha256:a0ee98db9c5f80785b266eb805016e36058ac72c51a064040f2bc43b61101cdb --hash=sha256:a129e76735bc792794d5177069691c3217898b9f5cee2b2661471e52ffe13f19 --hash=sha256:a78372c932c90ee474559c5ddfffd718238e8673c340dc21fe45c5b8b54559a0 --hash=sha256:a9695397f85973bb40427dedddf70d8dc4a44b22f1650dd4af9eedf443d45165 --hash=sha256:ab08df6c9a035bee56e31af99be621526bd237bea9f32def431c656b29e41778 --hash=sha256:ab2943be7c652f09638800905ee1bab2c544e537edb57d527997a24c13dc1455 --hash=sha256:ab4c29b49d560fe48b696cdcb127dd36e0bc2472548f3bf56cc5cb3da2b2984f --hash=sha256:af223b406d6d000830c6f65f1e6431783fc3f713ba3e6cc8c024d5ee96170a4b --hash=sha256:af2a6052aeb6cf17d3e46ee169099044fd8224cbaf75c76a2ef596e8163e2237 --hash=sha256:bcc9aaa5d80322bc2fb24bb7accb4a30f81e90ab8d6ba187aec0744bc302ad81 --hash=sha256:c07fda85708bc48578467e85099645167a955ba093be0a2dcba962195676e859 --hash=sha256:c0d4b719b7da33599dfe3b22d3db1ef789210a0597bc650b7cee9c77c2be8c5c --hash=sha256:c0ef0aaafc66fbd87842a3fe3902fd889825646bc21149eafe47be6072725835 --hash=sha256:c2b5e7db5328427c57c8e8831abda175421b709672f6cfc3d630c3b7e2146393 --hash=sha256:c30b53e7e6bda1d547cabb47c825f3843a0a1a42b0496087bb58d8fedf9f41b5 --hash=sha256:c80ee5802e3fb9ea37938e7eecc307fb984837091d5fd262bb37238b1ae97641 --hash=sha256:c9b822a577f560fbd9554812526831712c1436d2c046cedee4c3796d3543b144 --hash=sha256:cae65ad55793da34db5f54e4029b89d3b9b9490d8abe1b4c7ab5d4b8ec7ebf74 --hash=sha256:cb2d222e72399fcf5890d1d5cc1060857b9b236adff2792ff48ca2dfd46c81db --hash=sha256:cbc3b6dfc728105b2a57c06791eb07a94229202ea75c59db644d7d496b698cac --hash=sha256:cd547953428f7abb73c5ad82cbb32109566204260d98e41e5dfdc682eb7f8403 --hash=sha256:cfc27c945f422e8b5071b6e93169679e4eb5bf73bbcbf1ba3ae3a83d2f78ebd9 --hash=sha256:d472aeb4fbf9865e0c6d622d7f4d54a4e101a89715d8904282bb5f9a2f476c3f --hash=sha256:d62cdfcfd89ccb8de04e0eda998535c406bf5e060ffd56be6c586cbcc05b3311 --hash=sha256:d82ad62b19645419fe79dd63b3f9253e15b30e955c0170e5cebc350c1844e581 --hash=sha256:d8f353eb14ee3441ee844ade4277d560cdd68288838673273b978e3d6d2c8f36 --hash=sha256:daede9cd44e0f8bdd9e6cc9a607fc81feb80fae7a5fc6cecaff0e0bb32e42d00 --hash=sha256:db65d2af507bbfbdcedb254a11149f894169d90488dd3e7190f7cdcb2d6cd57a --hash=sha256:dee69d7015dc235f526fe80a9c90d65eb0039103fe565776250881731f06349f --hash=sha256:e153e9cd40cc8945138822807139367f256f89c6810c2634a4f6902b52d3b4e2 --hash=sha256:e35b88984e7fa64aacecea39236cee32dd9bd8c55f57ba8a75cf2399553f9bd7 --hash=sha256:e53f3a38d3510c11953f3e6a33f205c6d1b001129f972805ca9b42fc308bc239 --hash=sha256:e9b0d8d0845bbc4cfcdcbcdbf5086886bc8157aa963c31c777ceff7846c77757 --hash=sha256:ec17c65562a827bba85e3872ead335f95405ea1674860d96483a02f5c698fa72 --hash=sha256:ecef2343af4cc68e05131e45024ba34f6095821988a9d0a02aa7c73fcc448aa9 --hash=sha256:ed5a841e8bb29a55fb8159ed526b26adc5bdd7e8bd7bf793ce647cb08656cdf4 --hash=sha256:ee17f18d2498f2673e432faaa71698032b0127ebf23ae5974eeaf806c279df24 --hash=sha256:f048da1b4f243fc44f205dfd320933a951b8d89e0afd4c7cacc762a8b9165207 --hash=sha256:f10207adf04d08bec185bae14d9606a1444715bc99180f9331c9c02093e1959e --hash=sha256:f1d2f90aeec838a52f1c1a32fe9a619fefd5e411721a9117fbf82aea638fe8a1 --hash=sha256:f48107a8c637e80362555f37ecf49abe20370e557cc4ab374f04ec4423c97c3d --hash=sha256:f7ee0e597f495cf415bcbd3da3caa3bd7e816b74d0d52b8145954c5e6fd3ff37 --hash=sha256:f93243fdc5657247533273ac4f86ae106cc6445a0efacb9a1bfe982fcfefd90c --hash=sha256:f95393b4d66bfae908c3ca8d169d5f79cd65636ae15b5e7a4f6e67af675adb0e --hash=sha256:fc38cba02d1acba4e2869eef1a57a43dfbd3d49a59bf90dda7444ec2be6a5570 --hash=sha256:fd0858c20f078a32cf55f7e81473d96dcf3b93fd2ccdb3d40fdf54b8573df3af --hash=sha256:fd138803047fb4c062b1c1dd95462f5209456bfab55c734458f15d11da288f8f --hash=sha256:fd2dbc472da1f772a4dae4fa24be938a6c544671a912e30529984dd80400cd88 --hash=sha256:fd6f30fdcf9ae2a70abd34da54f18da086160e4d7d9251f81f3da0ff84fc5a48 --hash=sha256:fe49d0a85038f36ba9e3ffafa1103e61170b28e95b16622e11be0a0ea07c6781 +psutil==7.2.1 --hash=sha256:05cc68dbb8c174828624062e73078e7e35406f4ca2d0866c272c2410d8ef06d1 --hash=sha256:08a2f175e48a898c8eb8eace45ce01777f4785bc744c90aa2cc7f2fa5462a266 --hash=sha256:0d67c1822c355aa6f7314d92018fb4268a76668a536f133599b91edd48759442 --hash=sha256:2ceae842a78d1603753561132d5ad1b2f8a7979cb0c283f5b52fb4e6e14b1a79 --hash=sha256:35630d5af80d5d0d49cfc4d64c1c13838baf6717a13effb35869a5919b854cdf --hash=sha256:3fce5f92c22b00cdefd1645aa58ab4877a01679e901555067b1bd77039aa589f --hash=sha256:494c513ccc53225ae23eec7fe6e1482f1b8a44674241b54561f755a898650679 --hash=sha256:5e38404ca2bb30ed7267a46c02f06ff842e92da3bb8c5bfdadbd35a5722314d8 --hash=sha256:81442dac7abfc2f4f4385ea9e12ddf5a796721c0f6133260687fec5c3780fa49 --hash=sha256:923f8653416604e356073e6e0bccbe7c09990acef442def2f5640dd0faa9689f --hash=sha256:93f3f7b0bb07711b49626e7940d6fe52aa9940ad86e8f7e74842e73189712129 --hash=sha256:99a4cd17a5fdd1f3d014396502daa70b5ec21bf4ffe38393e152f8e449757d67 --hash=sha256:ab2b98c9fc19f13f59628d94df5cc4cc4844bc572467d113a8b517d634e362c6 --hash=sha256:b1b0671619343aa71c20ff9767eced0483e4fc9e1f489d50923738caf6a03c17 --hash=sha256:b2e953fcfaedcfbc952b44744f22d16575d3aa78eb4f51ae74165b4e96e55f42 --hash=sha256:ba9f33bb525b14c3ea563b2fd521a84d2fa214ec59e3e6a2858f78d0844dd60d --hash=sha256:cfbe6b40ca48019a51827f20d830887b3107a74a79b01ceb8cc8de4ccb17b672 --hash=sha256:d34d2ca888208eea2b5c68186841336a7f5e0b990edec929be909353a202768a --hash=sha256:ea46c0d060491051d39f0d2cff4f98d5c72b288289f57a21556cc7d504db37fc --hash=sha256:f7583aec590485b43ca601dd9cea0dcd65bd7bb21d30ef4ddbf4ea6b5ed1bdd3 --hash=sha256:f78baafb38436d5a128f837fab2d92c276dfb48af01a240b861ae02b2413ada8 +pyarrow==22.0.0 --hash=sha256:001ea83a58024818826a9e3f89bf9310a114f7e26dfe404a4c32686f97bd7901 --hash=sha256:00626d9dc0f5ef3a75fe63fd68b9c7c8302d2b5bbc7f74ecaedba83447a24f84 --hash=sha256:0c34fe18094686194f204a3b1787a27456897d8a2d62caf84b61e8dfbc0252ae --hash=sha256:12fe549c9b10ac98c91cf791d2945e878875d95508e1a5d14091a7aaa66d9cf8 --hash=sha256:1a812a5b727bc09c3d7ea072c4eebf657c2f7066155506ba31ebf4792f88f016 --hash=sha256:252be4a05f9d9185bb8c18e83764ebcfea7185076c07a7a662253af3a8c07941 --hash=sha256:334f900ff08ce0423407af97e6c26ad5d4e3b0763645559ece6fbf3747d6a8f5 --hash=sha256:35ad0f0378c9359b3f297299c3309778bb03b8612f987399a0333a560b43862d --hash=sha256:3d600dc583260d845c7d8a6db540339dd883081925da2bd1c5cb808f720b3cd9 --hash=sha256:3e294c5eadfb93d78b0763e859a0c16d4051fc1c5231ae8956d61cb0b5666f5a --hash=sha256:3e739edd001b04f654b166204fc7a9de896cf6007eaff33409ee9e50ceaff754 --hash=sha256:44729980b6c50a5f2bfcc2668d36c569ce17f8b17bccaf470c4313dcbbf13c9d --hash=sha256:44d2d26cda26d18f7af7db71453b7b783788322d756e81730acb98f24eb90ace --hash=sha256:4c19236ae2402a8663a2c8f21f1870a03cc57f0bef7e4b6eb3238cc82944de80 --hash=sha256:69763ab2445f632d90b504a815a2a033f74332997052b721002298ed6de40f2e --hash=sha256:6dda1ddac033d27421c20d7a7943eec60be44e0db4e079f33cc5af3b8280ccde --hash=sha256:6f9762274496c244d951c819348afbcf212714902742225f649cf02823a6a10f --hash=sha256:710624ab925dc2b05a6229d47f6f0dac1c1155e6ed559be7109f684eba048a48 --hash=sha256:7388ac685cab5b279a41dfe0a6ccd99e4dbf322edfb63e02fc0443bf24134e91 --hash=sha256:77718810bd3066158db1e95a63c160ad7ce08c6b0710bc656055033e39cdad88 --hash=sha256:7a820d8ae11facf32585507c11f04e3f38343c1e784c9b5a8b1da5c930547fe2 --hash=sha256:8382ad21458075c2e66a82a29d650f963ce51c7708c7c0ff313a8c206c4fd5e8 --hash=sha256:84378110dd9a6c06323b41b56e129c504d157d1a983ce8f5443761eb5256bafc --hash=sha256:854794239111d2b88b40b6ef92aa478024d1e5074f364033e73e21e3f76b25e0 --hash=sha256:92843c305330aa94a36e706c16209cd4df274693e777ca47112617db7d0ef3d7 --hash=sha256:9bddc2cade6561f6820d4cd73f99a0243532ad506bc510a75a5a65a522b2d74d --hash=sha256:a4893d31e5ef780b6edcaf63122df0f8d321088bb0dee4c8c06eccb1ca28d145 --hash=sha256:a9d9ffdc2ab696f6b15b4d1f7cec6658e1d788124418cb30030afbae31c64746 --hash=sha256:ac93252226cf288753d8b46280f4edf3433bf9508b6977f8dd8526b521a1bbb9 --hash=sha256:b41f37cabfe2463232684de44bad753d6be08a7a072f6a83447eeaf0e4d2a215 --hash=sha256:b883fe6fd85adad7932b3271c38ac289c65b7337c2c132e9569f9d3940620730 --hash=sha256:b9d71701ce97c95480fecb0039ec5bb889e75f110da72005743451339262f4ce --hash=sha256:ba95112d15fd4f1105fb2402c4eab9068f0554435e9b7085924bcfaac2cc306f --hash=sha256:bba208d9c7decf9961998edf5c65e3ea4355d5818dd6cd0f6809bec1afb951cc --hash=sha256:bd0d42297ace400d8febe55f13fdf46e86754842b860c978dfec16f081e5c653 --hash=sha256:bea79263d55c24a32b0d79c00a1c58bb2ee5f0757ed95656b01c0fb310c5af3d --hash=sha256:c064e28361c05d72eed8e744c9605cbd6d2bb7481a511c74071fd9b24bc65d7d --hash=sha256:c3200cb41cdbc65156e5f8c908d739b0dfed57e890329413da2748d1a2cd1a4e --hash=sha256:c6c791b09c57ed76a18b03f2631753a4960eefbbca80f846da8baefc6491fcfe --hash=sha256:c6ec3675d98915bf1ec8b3c7986422682f7232ea76cad276f4c8abd5b7319b70 --hash=sha256:ce20fe000754f477c8a9125543f1936ea5b8867c5406757c224d745ed033e691 --hash=sha256:cedb9dd9358e4ea1d9bce3665ce0797f6adf97ff142c8e25b46ba9cdd508e9b6 --hash=sha256:e0a15757fccb38c410947df156f9749ae4a3c89b2393741a50521f39a8cf202a --hash=sha256:e6e95176209257803a8b3d0394f21604e796dadb643d2f7ca21b66c9c0b30c9a --hash=sha256:e70ff90c64419709d38c8932ea9fe1cc98415c4f87ea8da81719e43f02534bc9 --hash=sha256:ec1a15968a9d80da01e1d30349b2b0d7cc91e96588ee324ce1b5228175043e95 --hash=sha256:ec5d40dd494882704fb876c16fa7261a69791e784ae34e6b5992e977bd2e238c --hash=sha256:f633074f36dbc33d5c05b5dc75371e5660f1dbf9c8b1d95669def05e5425989c --hash=sha256:f7fe3dbe871294ba70d789be16b6e7e52b418311e166e0e3cba9522f0f437fb1 --hash=sha256:f963ba8c3b0199f9d6b794c90ec77545e05eadc83973897a4523c9e8d84e9340 +pygments==2.19.2 --hash=sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887 --hash=sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b +pytest==9.0.2 --hash=sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b --hash=sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11 +python-dateutil==2.9.0.post0 --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 --hash=sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427 +pytorch-lightning==2.6.0 --hash=sha256:25b0d4f05e1f33b72be0920c34d0465777fe5f623228f9d6252b4b0f685d7037 --hash=sha256:ee72cff4b8c983ecfaae8599382544bd5236d9eb300adc7dd305f359195f4e79 +pytz==2025.2 --hash=sha256:360b9e3dbb49a209c21ad61809c7fb453643e048b38924c765813546746e81c3 --hash=sha256:5ddf76296dd8c44c26eb8f4b6f35488f3ccbf6fbbd7adee0b7262d43f0ec2f00 +pyyaml==6.0.3 --hash=sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c --hash=sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a --hash=sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3 --hash=sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956 --hash=sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6 --hash=sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c --hash=sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65 --hash=sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a --hash=sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0 --hash=sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b --hash=sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1 --hash=sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6 --hash=sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7 --hash=sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e --hash=sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007 --hash=sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310 --hash=sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4 --hash=sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9 --hash=sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295 --hash=sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea --hash=sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0 --hash=sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e --hash=sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac --hash=sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9 --hash=sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7 --hash=sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35 --hash=sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb --hash=sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b --hash=sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69 --hash=sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5 --hash=sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b --hash=sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c --hash=sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369 --hash=sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd --hash=sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824 --hash=sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198 --hash=sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065 --hash=sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c --hash=sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c --hash=sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764 --hash=sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196 --hash=sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b --hash=sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00 --hash=sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac --hash=sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8 --hash=sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e --hash=sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28 --hash=sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3 --hash=sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5 --hash=sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4 --hash=sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b --hash=sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf --hash=sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5 --hash=sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702 --hash=sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8 --hash=sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788 --hash=sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da --hash=sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d --hash=sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc --hash=sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c --hash=sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba --hash=sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f --hash=sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917 --hash=sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5 --hash=sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26 --hash=sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f --hash=sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b --hash=sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be --hash=sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c --hash=sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3 --hash=sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6 --hash=sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926 --hash=sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0 +regex==2025.11.3 --hash=sha256:04d2765516395cf7dda331a244a3282c0f5ae96075f728629287dfa6f76ba70a --hash=sha256:087511f5c8b7dfbe3a03f5d5ad0c2a33861b1fc387f21f6f60825a44865a385a --hash=sha256:08b884f4226602ad40c5d55f52bf91a9df30f513864e0054bad40c0e9cf1afb7 --hash=sha256:0d31e08426ff4b5b650f68839f5af51a92a5b51abd8554a60c2fbc7c71f25d0b --hash=sha256:0f9397d561a4c16829d4e6ff75202c1c08b68a3bdbfe29dbfcdb31c9830907c6 --hash=sha256:10483eefbfb0adb18ee9474498c9a32fcf4e594fbca0543bb94c48bac6183e2e --hash=sha256:149eb0bba95231fb4f6d37c8f760ec9fa6fabf65bab555e128dde5f2475193ec --hash=sha256:1e00ec2970aab10dc5db34af535f21fcf32b4a31d99e34963419636e2f85ae39 --hash=sha256:1eb1ebf6822b756c723e09f5186473d93236c06c579d2cc0671a722d2ab14281 --hash=sha256:1fedc720f9bb2494ce31a58a1631f9c82df6a09b49c19517ea5cc280b4541e01 --hash=sha256:1ff0d190c7f68ae7769cd0313fe45820ba07ffebfddfaa89cc1eb70827ba0ddc --hash=sha256:2292cd5a90dab247f9abe892ac584cb24f0f54680c73fcb4a7493c66c2bf2467 --hash=sha256:22b29dda7e1f7062a52359fca6e58e548e28c6686f205e780b02ad8ef710de36 --hash=sha256:22c12d837298651e5550ac1d964e4ff57c3f56965fc1812c90c9fb2028eaf267 --hash=sha256:22dd622a402aad4558277305350699b2be14bc59f64d64ae1d928ce7d072dced --hash=sha256:22e7d1cdfa88ef33a2ae6aa0d707f9255eb286ffbd90045f1088246833223aee --hash=sha256:28ba4d69171fc6e9896337d4fc63a43660002b7da53fc15ac992abcf3410917c --hash=sha256:2ab815eb8a96379a27c3b6157fcb127c8f59c36f043c1678110cea492868f1d5 --hash=sha256:2b441a4ae2c8049106e8b39973bfbddfb25a179dda2bdb99b0eeb60c40a6a3af --hash=sha256:2fa2eed3f76677777345d2f81ee89f5de2f5745910e805f7af7386a920fa7313 --hash=sha256:32f74f35ff0f25a5021373ac61442edcb150731fbaa28286bbc8bb1582c89d02 --hash=sha256:3809988f0a8b8c9dcc0f92478d6501fac7200b9ec56aecf0ec21f4a2ec4b6009 --hash=sha256:3839967cf4dc4b985e1570fd8d91078f0c519f30491c60f9ac42a8db039be204 --hash=sha256:38af559ad934a7b35147716655d4a2f79fcef2d695ddfe06a06ba40ae631fa7e --hash=sha256:3a91e4a29938bc1a082cc28fdea44be420bf2bebe2665343029723892eb073e1 --hash=sha256:3b30bc921d50365775c09a7ed446359e5c0179e9e2512beec4a60cbcef6ddd50 --hash=sha256:3b3a5f320136873cc5561098dfab677eea139521cb9a9e8db98b7e64aef44cbc --hash=sha256:3bf28b1873a8af8bbb58c26cc56ea6e534d80053b41fb511a35795b6de507e6a --hash=sha256:3e0b11b2b2433d1c39c7c7a30e3f3d0aeeea44c2a8d0bae28f6b95f639927a69 --hash=sha256:3e816cc9aac1cd3cc9a4ec4d860f06d40f994b5c7b4d03b93345f44e08cc68bf --hash=sha256:3f8bf11a4827cc7ce5a53d4ef6cddd5ad25595d3c1435ef08f76825851343154 --hash=sha256:435bbad13e57eb5606a68443af62bed3556de2f46deb9f7d4237bc2f1c9fb3a0 --hash=sha256:43b4fb020e779ca81c1b5255015fe2b82816c76ec982354534ad9ec09ad7c9e3 --hash=sha256:442d86cf1cfe4faabf97db7d901ef58347efd004934da045c745e7b5bd57ac49 --hash=sha256:44f264d4bf02f3176467d90b294d59bf1db9fe53c141ff772f27a8b456b2a9ed --hash=sha256:454d9b4ae7881afbc25015b8627c16d88a597479b9dea82b8c6e7e2e07240dc7 --hash=sha256:4aecb6f461316adf9f1f0f6a4a1a3d79e045f9b71ec76055a791affa3b285850 --hash=sha256:4bf146dca15cdd53224a1bf46d628bd7590e4a07fbb69e720d561aea43a32b38 --hash=sha256:4c5238d32f3c5269d9e87be0cf096437b7622b6920f5eac4fd202468aaeb34d2 --hash=sha256:4e1e592789704459900728d88d41a46fe3969b82ab62945560a31732ffc19a6d --hash=sha256:509dc827f89c15c66a0c216331260d777dd6c81e9a4e4f830e662b0bb296c313 --hash=sha256:51c1c1847128238f54930edb8805b660305dca164645a9fd29243f5610beea34 --hash=sha256:5cf77eac15bd264986c4a2c63353212c095b40f3affb2bc6b4ef80c4776c1a28 --hash=sha256:5d9903ca42bfeec4cebedba8022a7c97ad2aab22e09573ce9976ba01b65e4361 --hash=sha256:61a08bcb0ec14ff4e0ed2044aad948d0659604f824cbd50b55e30b0ec6f09c73 --hash=sha256:62ba394a3dda9ad41c7c780f60f6e4a70988741415ae96f6d1bf6c239cf01379 --hash=sha256:639431bdc89d6429f6721625e8129413980ccd62e9d3f496be618a41d205f160 --hash=sha256:64350685ff08b1d3a6fff33f45a9ca183dc1d58bbfe4981604e70ec9801bbc26 --hash=sha256:6538241f45eb5a25aa575dbba1069ad786f68a4f2773a29a2bd3dd1f9de787be --hash=sha256:669dcfb2e38f9e8c69507bace46f4889e3abbfd9b0c29719202883c0a603598f --hash=sha256:66d559b21d3640203ab9075797a55165d79017520685fb407b9234d72ab63c62 --hash=sha256:6dd329a1b61c0ee95ba95385fb0c07ea0d3fe1a21e1349fa2bec272636217118 --hash=sha256:728a9d2d173a65b62bdc380b7932dd8e74ed4295279a8fe1021204ce210803e7 --hash=sha256:732aea6de26051af97b94bc98ed86448821f839d058e5d259c72bf6d73ad0fc0 --hash=sha256:74d04244852ff73b32eeede4f76f51c5bcf44bc3c207bc3e6cf1c5c45b890708 --hash=sha256:7521684c8c7c4f6e88e35ec89680ee1aa8358d3f09d27dfbdf62c446f5d4c695 --hash=sha256:75fa6f0056e7efb1f42a1c34e58be24072cb9e61a601340cc1196ae92326a4f9 --hash=sha256:78c2d02bb6e1da0720eedc0bad578049cad3f71050ef8cd065ecc87691bed2b0 --hash=sha256:795ea137b1d809eb6836b43748b12634291c0ed55ad50a7d72d21edf1cd565c4 --hash=sha256:7a50cd39f73faa34ec18d6720ee25ef10c4c1839514186fcda658a06c06057a2 --hash=sha256:7a7c7fdf755032ffdd72c77e3d8096bdcb0eb92e89e17571a196f03d88b11b3c --hash=sha256:7be0277469bf3bd7a34a9c57c1b6a724532a0d235cd0dc4e7f4316f982c28b19 --hash=sha256:7eb542fd347ce61e1321b0a6b945d5701528dca0cd9759c2e3bb8bd57e47964d --hash=sha256:7fe6e5440584e94cc4b3f5f4d98a25e29ca12dccf8873679a635638349831b98 --hash=sha256:81519e25707fc076978c6143b81ea3dc853f176895af05bf7ec51effe818aeec --hash=sha256:838441333bc90b829406d4a03cb4b8bf7656231b84358628b0406d803931ef32 --hash=sha256:849202cd789e5f3cf5dcc7822c34b502181b4824a65ff20ce82da5524e45e8e9 --hash=sha256:856a25c73b697f2ce2a24e7968285579e62577a048526161a2c0f53090bea9f9 --hash=sha256:87eb52a81ef58c7ba4d45c3ca74e12aa4b4e77816f72ca25258a85b3ea96cb48 --hash=sha256:885b26aa3ee56433b630502dc3d36ba78d186a00cc535d3806e6bfd9ed3c70ab --hash=sha256:8a3d571bd95fade53c86c0517f859477ff3a93c3fde10c9e669086f038e0f207 --hash=sha256:8e026094aa12b43f4fd74576714e987803a315c76edb6b098b9809db5de58f74 --hash=sha256:9697a52e57576c83139d7c6f213d64485d3df5bf84807c35fa409e6c970801c6 --hash=sha256:9b5aca4d5dfd7fbfbfbdaf44850fcc7709a01146a797536a8f84952e940cca76 --hash=sha256:9ddc42e68114e161e51e272f667d640f97e84a2b9ef14b7477c53aac20c2d59a --hash=sha256:9f95fbaa0ee1610ec0fc6b26668e9917a582ba80c52cc6d9ada15e30aa9ab9ad --hash=sha256:a12ab1f5c29b4e93db518f5e3872116b7e9b1646c9f9f426f777b50d44a09e8c --hash=sha256:a295ca2bba5c1c885826ce3125fa0b9f702a1be547d821c01d65f199e10c01e2 --hash=sha256:a4cb042b615245d5ff9b3794f56be4138b5adc35a4166014d31d1814744148c7 --hash=sha256:adad1a1bcf1c9e76346e091d22d23ac54ef28e1365117d99521631078dfec9de --hash=sha256:b4774ff32f18e0504bfc4e59a3e71e18d83bc1e171a3c8ed75013958a03b2f14 --hash=sha256:b6f78f98741dcc89607c16b1e9426ee46ce4bf31ac5e6b0d40e81c89f3481ea5 --hash=sha256:b7f9ee819f94c6abfa56ec7b1dbab586f41ebbdc0a57e6524bd5e7f487a878c7 --hash=sha256:ba0d8a5d7f04f73ee7d01d974d47c5834f8a1b0224390e4fe7c12a3a92a78ecc --hash=sha256:bac4200befe50c670c405dc33af26dad5a3b6b255dd6c000d92fe4629f9ed6a5 --hash=sha256:bc8ab71e2e31b16e40868a40a69007bc305e1109bd4658eb6cad007e0bf67c41 --hash=sha256:bce22519c989bb72a7e6b36a199384c53db7722fe669ba891da75907fe3587db --hash=sha256:bf3490bcbb985a1ae97b2ce9ad1c0f06a852d5b19dde9b07bdf25bf224248c95 --hash=sha256:c1e448051717a334891f2b9a620fe36776ebf3dd8ec46a0b877c8ae69575feb4 --hash=sha256:c54f768482cef41e219720013cd05933b6f971d9562544d691c68699bf2b6801 --hash=sha256:c56b4d162ca2b43318ac671c65bd4d563e841a694ac70e1a976ac38fcf4ca1d2 --hash=sha256:c9c30003b9347c24bcc210958c5d167b9e4f9be786cb380a7d32f14f9b84674f --hash=sha256:cc4076a5b4f36d849fd709284b4a3b112326652f3b0466f04002a6c15a0c96c1 --hash=sha256:cfe6d3f0c9e3b7e8c0c694b24d25e677776f5ca26dce46fd6b0489f9c8339391 --hash=sha256:d6c2d5919075a1f2e413c00b056ea0c2f065b3f5fe83c3d07d325ab92dce51d6 --hash=sha256:d8b4a27eebd684319bdf473d39f1d79eed36bf2cd34bd4465cdb4618d82b3d56 --hash=sha256:dbe6095001465294f13f1adcd3311e50dd84e5a71525f20a10bd16689c61ce0b --hash=sha256:dd16e78eb18ffdb25ee33a0682d17912e8cc8a770e885aeee95020046128f1ce --hash=sha256:ddd76a9f58e6a00f8772e72cff8ebcff78e022be95edf018766707c730593e1e --hash=sha256:df9eb838c44f570283712e7cff14c16329a9f0fb19ca492d21d4b7528ee6821e --hash=sha256:dfec44d532be4c07088c3de2876130ff0fbeeacaa89a137decbbb5f665855a0f --hash=sha256:e18bc3f73bd41243c9b38a6d9f2366cd0e0137a9aebe2d8ff76c5b67d4c0a3f4 --hash=sha256:e43586ce5bd28f9f285a6e729466841368c4a0353f6fd08d4ce4630843d3648a --hash=sha256:e6b49cd2aad93a1790ce9cffb18964f6d3a4b0b3dbdbd5de094b65296fce6e58 --hash=sha256:e6c7a21dffba883234baefe91bc3388e629779582038f75d2a5be918e250f0ed --hash=sha256:e721d1b46e25c481dc5ded6f4b3f66c897c58d2e8cfdf77bbced84339108b0b9 --hash=sha256:eadade04221641516fa25139273505a1c19f9bf97589a05bc4cfcd8b4a618031 --hash=sha256:ee3a83ce492074c35a74cc76cf8235d49e77b757193a5365ff86e3f2f93db9fd --hash=sha256:f117efad42068f9715677c8523ed2be1518116d1c49b1dd17987716695181efe --hash=sha256:f3b5a391c7597ffa96b41bd5cbd2ed0305f515fcbb367dfa72735679d5502364 --hash=sha256:f4ff94e58e84aedb9c9fce66d4ef9f27a190285b451420f297c9a09f2b9abee9 --hash=sha256:f99be08cfead2020c7ca6e396c13543baea32343b7a9a5780c462e323bd8872f --hash=sha256:fd0a5e563c756de210bb964789b5abe4f114dacae9104a47e1a649b910361536 --hash=sha256:feff9e54ec0dd3833d659257f5c3f5322a12eee58ffa360984b716f8b92983f4 --hash=sha256:ffcca5b9efe948ba0661e9df0fa50d2bc4b097c70b9810212d6b62f05d83b2dd +requests==2.32.5 --hash=sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6 --hash=sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf +scikit-learn==1.8.0 --hash=sha256:00d6f1d66fbcf4eba6e356e1420d33cc06c70a45bb1363cd6f6a8e4ebbbdece2 --hash=sha256:0d6ae97234d5d7079dc0040990a6f7aeb97cb7fa7e8945f1999a429b23569e0a --hash=sha256:146b4d36f800c013d267b29168813f7a03a43ecd2895d04861f1240b564421da --hash=sha256:15fc3b5d19cc2be65404786857f2e13c70c83dd4782676dd6814e3b89dc8f5b9 --hash=sha256:2838551e011a64e3053ad7618dda9310175f7515f1742fa2d756f7c874c05961 --hash=sha256:29ffc74089f3d5e87dfca4c2c8450f88bdc61b0fc6ed5d267f3988f19a1309f6 --hash=sha256:2de443b9373b3b615aec1bb57f9baa6bb3a9bd093f1269ba95c17d870422b271 --hash=sha256:35c007dedb2ffe38fe3ee7d201ebac4a2deccd2408e8621d53067733e3c74809 --hash=sha256:3bad7565bc9cf37ce19a7c0d107742b320c1285df7aab1a6e2d28780df167242 --hash=sha256:4496bb2cf7a43ce1a2d7524a79e40bc5da45cf598dbf9545b7e8316ccba47bb4 --hash=sha256:4511be56637e46c25721e83d1a9cea9614e7badc7040c4d573d75fbe257d6fd7 --hash=sha256:5025ce924beccb28298246e589c691fe1b8c1c96507e6d27d12c5fadd85bfd76 --hash=sha256:56079a99c20d230e873ea40753102102734c5953366972a71d5cb39a32bc40c6 --hash=sha256:5e30adb87f0cc81c7690a84f7932dd66be5bac57cfe16b91cb9151683a4a2d3b --hash=sha256:5fb63362b5a7ddab88e52b6dbb47dac3fd7dafeee740dc6c8d8a446ddedade8e --hash=sha256:6b595b07a03069a2b1740dc08c2299993850ea81cce4fe19b2421e0c970de6b7 --hash=sha256:72358cce49465d140cc4e7792015bb1f0296a9742d5622c67e31399b75468b9e --hash=sha256:74b66d8689d52ed04c271e1329f0c61635bcaf5b926db9b12d58914cdc01fe57 --hash=sha256:7cc267b6108f0a1499a734167282c00c4ebf61328566b55ef262d48e9849c735 --hash=sha256:80832434a6cc114f5219211eec13dcbc16c2bac0e31ef64c6d346cde3cf054cb --hash=sha256:8c497fff237d7b4e07e9ef1a640887fa4fb765647f86fbe00f969ff6280ce2bb --hash=sha256:8fdf95767f989b0cfedb85f7ed8ca215d4be728031f56ff5a519ee1e3276dc2e --hash=sha256:9bccbb3b40e3de10351f8f5068e105d0f4083b1a65fa07b6634fbc401a6287fd --hash=sha256:a0bcfe4d0d14aec44921545fd2af2338c7471de9cb701f1da4c9d85906ab847a --hash=sha256:a69525355a641bf8ef136a7fa447672fb54fe8d60cab5538d9eb7c6438543fb9 --hash=sha256:ada8121bcb4dac28d930febc791a69f7cb1673c8495e5eee274190b73a4559c1 --hash=sha256:bf97c10a3f5a7543f9b88cbf488d33d175e9146115a451ae34568597ba33dcde --hash=sha256:c22a2da7a198c28dd1a6e1136f19c830beab7fdca5b3e5c8bba8394f8a5c45b3 --hash=sha256:c2656924ec73e5939c76ac4c8b026fc203b83d8900362eb2599d8aee80e4880f --hash=sha256:c57b1b610bd1f40ba43970e11ce62821c2e6569e4d74023db19c6b26f246cb3b --hash=sha256:eddde82a035681427cbedded4e6eff5e57fa59216c2e3e90b10b19ab1d0a65c3 --hash=sha256:edec98c5e7c128328124a029bceb09eda2d526997780fef8d65e9a69eead963e --hash=sha256:ee787491dbfe082d9c3013f01f5991658b0f38aa8177e4cd4bf434c58f551702 --hash=sha256:f28dd15c6bb0b66ba09728cf09fd8736c304be29409bd8445a080c1280619e8c --hash=sha256:f984ca4b14914e6b4094c5d52a32ea16b49832c03bd17a110f004db3c223e8e1 --hash=sha256:fb65db5d7531bccf3a4f6bec3462223bea71384e2cda41da0f10b7c292b9e7c4 --hash=sha256:fe1c011a640a9f0791146011dfd3c7d9669785f9fed2b2a5f9e207536cf5c2fd +scipy==1.16.3 --hash=sha256:0151a0749efeaaab78711c78422d413c583b8cdd2011a3c1d6c794938ee9fdb2 --hash=sha256:01e87659402762f43bd2fee13370553a17ada367d42e7487800bf2916535aecb --hash=sha256:03192a35e661470197556de24e7cb1330d84b35b94ead65c46ad6f16f6b28f2a --hash=sha256:0553371015692a898e1aa858fed67a3576c34edefa6b7ebdb4e9dde49ce5c203 --hash=sha256:062246acacbe9f8210de8e751b16fc37458213f124bef161a5a02c7a39284304 --hash=sha256:0c3b4dd3d9b08dbce0f3440032c52e9e2ab9f96ade2d3943313dfe51a7056959 --hash=sha256:0c623a54f7b79dd88ef56da19bc2873afec9673a48f3b85b18e4d402bdd29a5a --hash=sha256:16b8bc35a4cc24db80a0ec836a9286d0e31b2503cb2fd7ff7fb0e0374a97081d --hash=sha256:1fb2472e72e24d1530debe6ae078db70fb1605350c88a3d14bc401d6306dbffe --hash=sha256:21d9d6b197227a12dcbf9633320a4e34c6b0e51c57268df255a0942983bac562 --hash=sha256:2a207a6ce9c24f1951241f4693ede2d393f59c07abc159b2cb2be980820e01fb --hash=sha256:2b71d93c8a9936046866acebc915e2af2e292b883ed6e2cbe5c34beb094b82d9 --hash=sha256:2d1ae2cf0c350e7705168ff2429962a89ad90c2d49d1dd300686d8b2a5af22fc --hash=sha256:3a4c460301fb2cffb7f88528f30b3127742cff583603aa7dc964a52c463b385d --hash=sha256:3d4a07a8e785d80289dfe66b7c27d8634a773020742ec7187b85ccc4b0e7b686 --hash=sha256:40be6cf99e68b6c4321e9f8782e7d5ff8265af28ef2cd56e9c9b2638fa08ad97 --hash=sha256:4aff59800a3b7f786b70bfd6ab551001cb553244988d7d6b8299cb1ea653b353 --hash=sha256:50a3dbf286dbc7d84f176f9a1574c705f277cb6565069f88f60db9eafdbe3ee2 --hash=sha256:532fb5ad6a87e9e9cd9c959b106b73145a03f04c7d57ea3e6f6bb60b86ab0876 --hash=sha256:53c3844d527213631e886621df5695d35e4f6a75f620dca412bcd292f6b87d78 --hash=sha256:56edc65510d1331dae01ef9b658d428e33ed48b4f77b1d51caf479a0253f96dc --hash=sha256:57d01cb6f85e34f0946b33caa66e892aae072b64b034183f3d87c4025802a119 --hash=sha256:5803c5fadd29de0cf27fa08ccbfe7a9e5d741bf63e4ab1085437266f12460ff9 --hash=sha256:6020470b9d00245926f2d5bb93b119ca0340f0d564eb6fbaad843eaebf9d690f --hash=sha256:63d3cdacb8a824a295191a723ee5e4ea7768ca5ca5f2838532d9f2e2b3ce2135 --hash=sha256:663b8d66a8748051c3ee9c96465fb417509315b99c71550fda2591d7dd634234 --hash=sha256:72d1717fd3b5e6ec747327ce9bda32d5463f472c9dce9f54499e81fbd50245a1 --hash=sha256:7dc1360c06535ea6116a2220f760ae572db9f661aba2d88074fe30ec2aa1ff88 --hash=sha256:7f68154688c515cdb541a31ef8eb66d8cd1050605be9dcd74199cbd22ac739bc --hash=sha256:81fc5827606858cf71446a5e98715ba0e11f0dbc83d71c7409d05486592a45d6 --hash=sha256:875555ce62743e1d54f06cdf22c1e0bc47b91130ac40fe5d783b6dfa114beeb6 --hash=sha256:8b3c820ddb80029fe9f43d61b81d8b488d3ef8ca010d15122b152db77dc94c22 --hash=sha256:8be1ca9170fcb6223cc7c27f4305d680ded114a1567c0bd2bfcbf947d1b17511 --hash=sha256:8d09d72dc92742988b0e7750bddb8060b0c7079606c0d24a8cc8e9c9c11f9079 --hash=sha256:9452781bd879b14b6f055b26643703551320aa8d79ae064a71df55c00286a184 --hash=sha256:96491a6a54e995f00a28a3c3badfff58fd093bf26cd5fb34a2188c8c756a3a2c --hash=sha256:9b9c9c07b6d56a35777a1b4cc8966118fb16cfd8daf6743867d17d36cfad2d40 --hash=sha256:a8a26c78ef223d3e30920ef759e25625a0ecdd0d60e5a8818b7513c3e5384cf2 --hash=sha256:aadd23f98f9cb069b3bd64ddc900c4d277778242e961751f77a8cb5c4b946fb0 --hash=sha256:b7180967113560cca57418a7bc719e30366b47959dd845a93206fbed693c867e --hash=sha256:b7c5f1bda1354d6a19bc6af73a649f8285ca63ac6b52e64e658a5a11d4d69800 --hash=sha256:b81c27fc41954319a943d43b20e07c40bdcd3ff7cf013f4fb86286faefe546c4 --hash=sha256:bb61878c18a470021fb515a843dc7a76961a8daceaaaa8bad1332f1bf4b54657 --hash=sha256:bea0a62734d20d67608660f69dcda23e7f90fb4ca20974ab80b6ed40df87a005 --hash=sha256:c5192722cffe15f9329a3948c4b1db789fbb1f05c97899187dcf009b283aea70 --hash=sha256:c97176013d404c7346bf57874eaac5187d969293bf40497140b0a2b2b7482e07 --hash=sha256:cd13e354df9938598af2be05822c323e97132d5e6306b83a3b4ee6724c6e522e --hash=sha256:d2ec56337675e61b312179a1ad124f5f570c00f920cc75e1000025451b88241c --hash=sha256:d3837938ae715fc0fe3c39c0202de3a8853aff22ca66781ddc2ade7554b7e2cc --hash=sha256:d9f48cafc7ce94cf9b15c6bffdc443a81a27bf7075cf2dcd5c8b40f85d10c4e7 --hash=sha256:da7763f55885045036fabcebd80144b757d3db06ab0861415d1c3b7c69042146 --hash=sha256:deb3841c925eeddb6afc1e4e4a45e418d19ec7b87c5df177695224078e8ec733 --hash=sha256:e1d27cbcb4602680a49d787d90664fa4974063ac9d4134813332a8c53dbe667c --hash=sha256:e5d42a9472e7579e473879a1990327830493a7047506d58d73fc429b84c1d49d --hash=sha256:e7efa2681ea410b10dde31a52b18b0154d66f2485328830e45fdf183af5aefc6 --hash=sha256:eab43fae33a0c39006a88096cd7b4f4ef545ea0447d250d5ac18202d40b6611d --hash=sha256:f2622206f5559784fa5c4b53a950c3c7c1cf3e84ca1b9c4b6c03f062f289ca26 --hash=sha256:f379b54b77a597aa7ee5e697df0d66903e41b9c85a6dd7946159e356319158e8 --hash=sha256:f667a4542cc8917af1db06366d3f78a5c8e83badd56409f94d1eac8d8d9133fa --hash=sha256:fb4b29f4cf8cc5a8d628bc8d8e26d12d7278cd1f219f22698a378c3d67db5e4b --hash=sha256:ffa6eea95283b2b8079b821dc11f50a17d0571c92b43e2b5b12764dc5f9b285d +setuptools==80.9.0 --hash=sha256:062d34222ad13e0cc312a4c02d73f059e86a4acbfbdea8f8f76b28c99f306922 --hash=sha256:f36b47402ecde768dbfafc46e8e4207b4360c654f1f3bb84475f0a28628fb19c +six==1.17.0 --hash=sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274 --hash=sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81 +sympy==1.14.0 --hash=sha256:d3d3fe8df1e5a0b42f0e7bdf50541697dbe7d23746e894990c030e2b05e72517 --hash=sha256:e091cc3e99d2141a0ba2847328f5479b05d94a6635cb96148ccb3f34671bd8f5 +threadpoolctl==3.6.0 --hash=sha256:43a0b8fd5a2928500110039e43a5eed8480b918967083ea48dc3ab9f13c4a7fb --hash=sha256:8ab8b4aa3491d812b623328249fab5302a68d2d71745c8a4c719a2fcaba9f44e +tiktoken==0.12.0 --hash=sha256:01d99484dc93b129cd0964f9d34eee953f2737301f18b3c7257bf368d7615baa --hash=sha256:04f0e6a985d95913cabc96a741c5ffec525a2c72e9df086ff17ebe35985c800e --hash=sha256:06a9f4f49884139013b138920a4c393aa6556b2f8f536345f11819389c703ebb --hash=sha256:09eb4eae62ae7e4c62364d9ec3a57c62eea707ac9a2b2c5d6bd05de6724ea179 --hash=sha256:0ee8f9ae00c41770b5f9b0bb1235474768884ae157de3beb5439ca0fd70f3e25 --hash=sha256:15d875454bbaa3728be39880ddd11a5a2a9e548c29418b41e8fd8a767172b5ec --hash=sha256:20cf97135c9a50de0b157879c3c4accbb29116bcf001283d26e073ff3b345946 --hash=sha256:285ba9d73ea0d6171e7f9407039a290ca77efcdb026be7769dccc01d2c8d7fff --hash=sha256:2b90f5ad190a4bb7c3eb30c5fa32e1e182ca1ca79f05e49b448438c3e225a49b --hash=sha256:2cff3688ba3c639ebe816f8d58ffbbb0aa7433e23e08ab1cade5d175fc973fb3 --hash=sha256:35a2f8ddd3824608b3d650a000c1ef71f730d0c56486845705a8248da00f9fe5 --hash=sha256:399c3dd672a6406719d84442299a490420b458c44d3ae65516302a99675888f3 --hash=sha256:3de02f5a491cfd179aec916eddb70331814bd6bf764075d39e21d5862e533970 --hash=sha256:3e68e3e593637b53e56f7237be560f7a394451cb8c11079755e80ae64b9e6def --hash=sha256:47a5bc270b8c3db00bb46ece01ef34ad050e364b51d406b6f9730b64ac28eded --hash=sha256:4a1a4fcd021f022bfc81904a911d3df0f6543b9e7627b51411da75ff2fe7a1be --hash=sha256:4c9614597ac94bb294544345ad8cf30dac2129c05e2db8dc53e082f355857af7 --hash=sha256:508fa71810c0efdcd1b898fda574889ee62852989f7c1667414736bcb2b9a4bd --hash=sha256:54c891b416a0e36b8e2045b12b33dd66fb34a4fe7965565f1b482da50da3e86a --hash=sha256:584c3ad3d0c74f5269906eb8a659c8bfc6144a52895d9261cdaf90a0ae5f4de0 --hash=sha256:5edb8743b88d5be814b1a8a8854494719080c28faaa1ccbef02e87354fe71ef0 --hash=sha256:604831189bd05480f2b885ecd2d1986dc7686f609de48208ebbbddeea071fc0b --hash=sha256:65b26c7a780e2139e73acc193e5c63ac754021f160df919add909c1492c0fb37 --hash=sha256:6de0da39f605992649b9cfa6f84071e3f9ef2cec458d08c5feb1b6f0ff62e134 --hash=sha256:6e227c7f96925003487c33b1b32265fad2fbcec2b7cf4817afb76d416f40f6bb --hash=sha256:6faa0534e0eefbcafaccb75927a4a380463a2eaa7e26000f0173b920e98b720a --hash=sha256:6fb2995b487c2e31acf0a9e17647e3b242235a20832642bb7a9d1a181c0c1bb1 --hash=sha256:775c2c55de2310cc1bc9a3ad8826761cbdc87770e586fd7b6da7d4589e13dab3 --hash=sha256:82991e04fc860afb933efb63957affc7ad54f83e2216fe7d319007dab1ba5892 --hash=sha256:83d16643edb7fa2c99eff2ab7733508aae1eebb03d5dfc46f5565862810f24e3 --hash=sha256:8f317e8530bb3a222547b85a58583238c8f74fd7a7408305f9f63246d1a0958b --hash=sha256:981a81e39812d57031efdc9ec59fa32b2a5a5524d20d4776574c4b4bd2e9014a --hash=sha256:9baf52f84a3f42eef3ff4e754a0db79a13a27921b457ca9832cf944c6be4f8f3 --hash=sha256:a01b12f69052fbe4b080a2cfb867c4de12c704b56178edf1d1d7b273561db160 --hash=sha256:a1af81a6c44f008cba48494089dd98cccb8b313f55e961a52f5b222d1e507967 --hash=sha256:a90388128df3b3abeb2bfd1895b0681412a8d7dc644142519e6f0a97c2111646 --hash=sha256:b18ba7ee2b093863978fcb14f74b3707cdc8d4d4d3836853ce7ec60772139931 --hash=sha256:b4e7ed1c6a7a8a60a3230965bdedba8cc58f68926b835e519341413370e0399a --hash=sha256:b6cfb6d9b7b54d20af21a912bfe63a2727d9cfa8fbda642fd8322c70340aad16 --hash=sha256:b8a0cd0c789a61f31bf44851defbd609e8dd1e2c8589c614cc1060940ef1f697 --hash=sha256:b97f74aca0d78a1ff21b8cd9e9925714c15a9236d6ceacf5c7327c117e6e21e8 --hash=sha256:c06cf0fcc24c2cb2adb5e185c7082a82cba29c17575e828518c2f11a01f445aa --hash=sha256:c2c714c72bc00a38ca969dae79e8266ddec999c7ceccd603cc4f0d04ccd76365 --hash=sha256:cbb9a3ba275165a2cb0f9a83f5d7025afe6b9d0ab01a22b50f0e74fee2ad253e --hash=sha256:cde24cdb1b8a08368f709124f15b36ab5524aac5fa830cc3fdce9c03d4fb8030 --hash=sha256:d186a5c60c6a0213f04a7a802264083dea1bbde92a2d4c7069e1a56630aef830 --hash=sha256:d51d75a5bffbf26f86554d28e78bfb921eae998edc2675650fd04c7e1f0cdc1e --hash=sha256:d5f89ea5680066b68bcb797ae85219c72916c922ef0fcdd3480c7d2315ffff16 --hash=sha256:da900aa0ad52247d8794e307d6446bd3cdea8e192769b56276695d34d2c9aa88 --hash=sha256:dc2dd125a62cb2b3d858484d6c614d136b5b848976794edfb63688d539b8b93f --hash=sha256:df37684ace87d10895acb44b7f447d4700349b12197a526da0d4a4149fde074c --hash=sha256:dfdfaa5ffff8993a3af94d1125870b1d27aed7cb97aa7eb8c1cefdbc87dbee63 --hash=sha256:edde1ec917dfd21c1f2f8046b86348b0f54a2c0547f68149d8600859598769ad --hash=sha256:f18f249b041851954217e9fd8e5c00b024ab2315ffda5ed77665a05fa91f42dc --hash=sha256:f61c0aea5565ac82e2ec50a05e02a6c44734e91b51c10510b084ea1b8e633a71 --hash=sha256:fc530a28591a2d74bce821d10b418b26a094bf33839e69042a6e86ddb7a7fb27 --hash=sha256:ffc5288f34a8bc02e1ea7047b8d041104791d2ddbf42d1e5fa07822cbffe16bd +torch @ https://download-r2.pytorch.org/whl/cu128/torch-2.9.1%2Bcu128-cp311-cp311-manylinux_2_28_x86_64.whl --hash=sha256:2a1da940f0757621d098c9755f7504d791a72a40920ec85a4fd98b20253fca4e +torchmetrics==1.8.2 --hash=sha256:08382fd96b923e39e904c4d570f3d49e2cc71ccabd2a94e0f895d1f0dac86242 --hash=sha256:cf64a901036bf107f17a524009eea7781c9c5315d130713aeca5747a686fe7a5 +tqdm==4.67.1 --hash=sha256:26445eca388f82e72884e0d580d5464cd801a3ea01e63e5601bdff9ba6a48de2 --hash=sha256:f8aef9c52c08c13a65f30ea34f4e5aac3fd1a34959879d7e59e63027286627f2 +triton==3.5.1 --hash=sha256:02c770856f5e407d24d28ddc66e33cf026e6f4d360dcb8b2fabe6ea1fc758621 --hash=sha256:0b4d2c70127fca6a23e247f9348b8adde979d2e7a20391bfbabaac6aebc7e6a8 --hash=sha256:275a045b6ed670dd1bd005c3e6c2d61846c74c66f4512d6f33cc027b11de8fd4 --hash=sha256:56765ffe12c554cd560698398b8a268db1f616c120007bfd8829d27139abd24a --hash=sha256:5fc53d849f879911ea13f4a877243afc513187bc7ee92d1f2c0f1ba3169e3c94 --hash=sha256:61413522a48add32302353fdbaaf92daaaab06f6b5e3229940d21b5207f47579 --hash=sha256:8932391d7f93698dfe5bc9bead77c47a24f97329e9f20c10786bb230a9083f56 --hash=sha256:bac7f7d959ad0f48c0e97d6643a1cc0fd5786fe61cb1f83b537c6b2d54776478 --hash=sha256:d0637b1efb1db599a8e9dc960d53ab6e4637db7d4ab6630a0974705d77b14b60 --hash=sha256:d2c6b915a03888ab931a9fd3e55ba36785e1fe70cbea0b40c6ef93b20fc85232 --hash=sha256:da47169e30a779bade679ce78df4810fca6d78a955843d2ddb11f226adc517dc --hash=sha256:f3f4346b6ebbd4fad18773f5ba839114f4826037c9f2f34e0148894cd5dd3dba --hash=sha256:f617aa7925f9ea9968ec2e1adaf93e87864ff51549c8f04ce658f29bbdb71e2d --hash=sha256:f63e34dcb32d7bd3a1d0195f60f30d2aee8b08a69a0424189b71017e23dfc3d2 +typing-extensions==4.15.0 --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548 +tzdata==2025.3 --hash=sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1 --hash=sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7 +urllib3==2.6.3 --hash=sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed --hash=sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4 +yarl==1.22.0 --hash=sha256:01e73b85a5434f89fc4fe27dcda2aff08ddf35e4d47bbbea3bdcd25321af538a --hash=sha256:029866bde8d7b0878b9c160e72305bbf0a7342bcd20b9999381704ae03308dc8 --hash=sha256:078278b9b0b11568937d9509b589ee83ef98ed6d561dfe2020e24a9fd08eaa2b --hash=sha256:078a8aefd263f4d4f923a9677b942b445a2be970ca24548a8102689a3a8ab8da --hash=sha256:07a524d84df0c10f41e3ee918846e1974aba4ec017f990dc735aad487a0bdfdf --hash=sha256:088e4e08f033db4be2ccd1f34cf29fe994772fb54cfe004bbf54db320af56890 --hash=sha256:0b5bcc1a9c4839e7e30b7b30dd47fe5e7e44fb7054ec29b5bb8d526aa1041093 --hash=sha256:0cf71bf877efeac18b38d3930594c0948c82b64547c1cf420ba48722fe5509f6 --hash=sha256:0d6e6885777af0f110b0e5d7e5dda8b704efed3894da26220b7f3d887b839a79 --hash=sha256:0dd9a702591ca2e543631c2a017e4a547e38a5c0f29eece37d9097e04a7ac683 --hash=sha256:10619d9fdee46d20edc49d3479e2f8269d0779f1b031e6f7c2aa1c76be04b7ed --hash=sha256:131a085a53bfe839a477c0845acf21efc77457ba2bcf5899618136d64f3303a2 --hash=sha256:1380560bdba02b6b6c90de54133c81c9f2a453dee9912fe58c1dcced1edb7cff --hash=sha256:139718f35149ff544caba20fce6e8a2f71f1e39b92c700d8438a0b1d2a631a02 --hash=sha256:14291620375b1060613f4aab9ebf21850058b6b1b438f386cc814813d901c60b --hash=sha256:1834bb90991cc2999f10f97f5f01317f99b143284766d197e43cd5b45eb18d03 --hash=sha256:1ab72135b1f2db3fed3997d7e7dc1b80573c67138023852b6efb336a5eae6511 --hash=sha256:1e7ce67c34138a058fd092f67d07a72b8e31ff0c9236e751957465a24b28910c --hash=sha256:1e8fbaa7cec507aa24ea27a01456e8dd4b6fab829059b69844bd348f2d467124 --hash=sha256:22965c2af250d20c873cdbee8ff958fb809940aeb2e74ba5f20aaf6b7ac8c70c --hash=sha256:22b029f2881599e2f1b06f8f1db2ee63bd309e2293ba2d566e008ba12778b8da --hash=sha256:243dda95d901c733f5b59214d28b0120893d91777cb8aa043e6ef059d3cddfe2 --hash=sha256:2ca6fd72a8cd803be290d42f2dec5cdcd5299eeb93c2d929bf060ad9efaf5de0 --hash=sha256:2e4e1f6f0b4da23e61188676e3ed027ef0baa833a2e633c29ff8530800edccba --hash=sha256:31f0b53913220599446872d757257be5898019c85e7971599065bc55065dc99d --hash=sha256:334b8721303e61b00019474cc103bdac3d7b1f65e91f0bfedeec2d56dfe74b53 --hash=sha256:33e32a0dd0c8205efa8e83d04fc9f19313772b78522d1bdc7d9aed706bfd6138 --hash=sha256:34b36c2c57124530884d89d50ed2c1478697ad7473efd59cfd479945c95650e4 --hash=sha256:3aa27acb6de7a23785d81557577491f6c38a5209a254d1191519d07d8fe51748 --hash=sha256:3b06bcadaac49c70f4c88af4ffcfbe3dc155aab3163e75777818092478bcbbe7 --hash=sha256:3b7c88eeef021579d600e50363e0b6ee4f7f6f728cd3486b9d0f3ee7b946398d --hash=sha256:3e2daa88dc91870215961e96a039ec73e4937da13cf77ce17f9cad0c18df3503 --hash=sha256:3ea66b1c11c9150f1372f69afb6b8116f2dd7286f38e14ea71a44eee9ec51b9d --hash=sha256:42188e6a615c1a75bcaa6e150c3fe8f3e8680471a6b10150c5f7e83f47cc34d2 --hash=sha256:433885ab5431bc3d3d4f2f9bd15bfa1614c522b0f1405d62c4f926ccd69d04fa --hash=sha256:437840083abe022c978470b942ff832c3940b2ad3734d424b7eaffcd07f76737 --hash=sha256:4398557cbf484207df000309235979c79c4356518fd5c99158c7d38203c4da4f --hash=sha256:45c2842ff0e0d1b35a6bf1cd6c690939dacb617a70827f715232b2e0494d55d1 --hash=sha256:47743b82b76d89a1d20b83e60d5c20314cbd5ba2befc9cda8f28300c4a08ed4d --hash=sha256:4792b262d585ff0dff6bcb787f8492e40698443ec982a3568c2096433660c694 --hash=sha256:47d8a5c446df1c4db9d21b49619ffdba90e77c89ec6e283f453856c74b50b9e3 --hash=sha256:47fdb18187e2a4e18fda2c25c05d8251a9e4a521edaed757fef033e7d8498d9a --hash=sha256:4c52a6e78aef5cf47a98ef8e934755abf53953379b7d53e68b15ff4420e6683d --hash=sha256:4dcc74149ccc8bba31ce1944acee24813e93cfdee2acda3c172df844948ddf7b --hash=sha256:50678a3b71c751d58d7908edc96d332af328839eea883bb554a43f539101277a --hash=sha256:51af598701f5299012b8416486b40fceef8c26fc87dc6d7d1f6fc30609ea0aa6 --hash=sha256:594fcab1032e2d2cc3321bb2e51271e7cd2b516c7d9aee780ece81b07ff8244b --hash=sha256:595697f68bd1f0c1c159fcb97b661fc9c3f5db46498043555d04805430e79bea --hash=sha256:59c189e3e99a59cf8d83cbb31d4db02d66cda5a1a4374e8a012b51255341abf5 --hash=sha256:5a3bf7f62a289fa90f1990422dc8dff5a458469ea71d1624585ec3a4c8d6960f --hash=sha256:5c401e05ad47a75869c3ab3e35137f8468b846770587e70d71e11de797d113df --hash=sha256:5cdac20da754f3a723cceea5b3448e1a2074866406adeb4ef35b469d089adb8f --hash=sha256:5d0fcda9608875f7d052eff120c7a5da474a6796fe4d83e152e0e4d42f6d1a9b --hash=sha256:5dbeefd6ca588b33576a01b0ad58aa934bc1b41ef89dee505bf2932b22ddffba --hash=sha256:62441e55958977b8167b2709c164c91a6363e25da322d87ae6dd9c6019ceecf9 --hash=sha256:663e1cadaddae26be034a6ab6072449a8426ddb03d500f43daf952b74553bba0 --hash=sha256:669930400e375570189492dc8d8341301578e8493aec04aebc20d4717f899dd6 --hash=sha256:68986a61557d37bb90d3051a45b91fa3d5c516d177dfc6dd6f2f436a07ff2b6b --hash=sha256:6944b2dc72c4d7f7052683487e3677456050ff77fcf5e6204e98caf785ad1967 --hash=sha256:6a635ea45ba4ea8238463b4f7d0e721bad669f80878b7bfd1f89266e2ae63da2 --hash=sha256:6c5010a52015e7c70f86eb967db0f37f3c8bd503a695a49f8d45700144667708 --hash=sha256:6dcbb0829c671f305be48a7227918cfcd11276c2d637a8033a99a02b67bf9eda --hash=sha256:70dfd4f241c04bd9239d53b17f11e6ab672b9f1420364af63e8531198e3f5fe8 --hash=sha256:719ae08b6972befcba4310e49edb1161a88cdd331e3a694b84466bd938a6ab10 --hash=sha256:75976c6945d85dbb9ee6308cd7ff7b1fb9409380c82d6119bd778d8fcfe2931c --hash=sha256:7861058d0582b847bc4e3a4a4c46828a410bca738673f35a29ba3ca5db0b473b --hash=sha256:792a2af6d58177ef7c19cbf0097aba92ca1b9cb3ffdd9c7470e156c8f9b5e028 --hash=sha256:8009b3173bcd637be650922ac455946197d858b3630b6d8787aa9e5c4564533e --hash=sha256:80ddf7a5f8c86cb3eb4bc9028b07bbbf1f08a96c5c0bc1244be5e8fefcb94147 --hash=sha256:8218f4e98d3c10d683584cb40f0424f4b9fd6e95610232dd75e13743b070ee33 --hash=sha256:84fc3ec96fce86ce5aa305eb4aa9358279d1aa644b71fab7b8ed33fe3ba1a7ca --hash=sha256:852863707010316c973162e703bddabec35e8757e67fcb8ad58829de1ebc8590 --hash=sha256:8884d8b332a5e9b88e23f60bb166890009429391864c685e17bd73a9eda9105c --hash=sha256:8dee9c25c74997f6a750cd317b8ca63545169c098faee42c84aa5e506c819b53 --hash=sha256:939fe60db294c786f6b7c2d2e121576628468f65453d86b0fe36cb52f987bd74 --hash=sha256:99b6fc1d55782461b78221e95fc357b47ad98b041e8e20f47c1411d0aacddc60 --hash=sha256:9d7672ecf7557476642c88497c2f8d8542f8e36596e928e9bcba0e42e1e7d71f --hash=sha256:9f6d73c1436b934e3f01df1e1b21ff765cd1d28c77dfb9ace207f746d4610ee1 --hash=sha256:9fb17ea16e972c63d25d4a97f016d235c78dd2344820eb35bc034bc32012ee27 --hash=sha256:a49370e8f711daec68d09b821a34e1167792ee2d24d405cbc2387be4f158b520 --hash=sha256:a4fcfc8eb2c34148c118dfa02e6427ca278bfd0f3df7c5f99e33d2c0e81eae3e --hash=sha256:a899cbd98dce6f5d8de1aad31cb712ec0a530abc0a86bd6edaa47c1090138467 --hash=sha256:a9b1ba5610a4e20f655258d5a1fdc7ebe3d837bb0e45b581398b99eb98b1f5ca --hash=sha256:af74f05666a5e531289cb1cc9c883d1de2088b8e5b4de48004e5ca8a830ac859 --hash=sha256:b0748275abb8c1e1e09301ee3cf90c8a99678a4e92e4373705f2a2570d581273 --hash=sha256:b266bd01fedeffeeac01a79ae181719ff848a5a13ce10075adbefc8f1daee70e --hash=sha256:b4f15793aa49793ec8d1c708ab7f9eded1aa72edc5174cae703651555ed1b601 --hash=sha256:b580e71cac3f8113d3135888770903eaf2f507e9421e5697d6ee6d8cd1c7f054 --hash=sha256:b6a6f620cfe13ccec221fa312139135166e47ae169f8253f72a0abc0dae94376 --hash=sha256:b790b39c7e9a4192dc2e201a282109ed2985a1ddbd5ac08dc56d0e121400a8f7 --hash=sha256:b85b982afde6df99ecc996990d4ad7ccbdbb70e2a4ba4de0aecde5922ba98a0b --hash=sha256:b8a0588521a26bf92a57a1705b77b8b59044cdceccac7151bd8d229e66b8dedb --hash=sha256:ba440ae430c00eee41509353628600212112cd5018d5def7e9b05ea7ac34eb65 --hash=sha256:bca03b91c323036913993ff5c738d0842fc9c60c4648e5c8d98331526df89784 --hash=sha256:bebf8557577d4401ba8bd9ff33906f1376c877aa78d1fe216ad01b4d6745af71 --hash=sha256:bec03d0d388060058f5d291a813f21c011041938a441c593374da6077fe21b1b --hash=sha256:bf4a21e58b9cde0e401e683ebd00f6ed30a06d14e93f7c8fd059f8b6e8f87b6a --hash=sha256:c0232bce2170103ec23c454e54a57008a9a72b5d1c3105dc2496750da8cfa47c --hash=sha256:c4647674b6150d2cae088fc07de2738a84b8bcedebef29802cf0b0a82ab6face --hash=sha256:c7044802eec4524fde550afc28edda0dd5784c4c45f0be151a2d3ba017daca7d --hash=sha256:c7bd6683587567e5a49ee6e336e0612bec8329be1b7d4c8af5687dcdeb67ee1e --hash=sha256:ca1f59c4e1ab6e72f0a23c13fca5430f889634166be85dbf1013683e49e3278e --hash=sha256:cb95a9b1adaa48e41815a55ae740cfda005758104049a640a398120bf02515ca --hash=sha256:cfebc0ac8333520d2d0423cbbe43ae43c8838862ddb898f5ca68565e395516e9 --hash=sha256:d332fc2e3c94dad927f2112395772a4e4fedbcf8f80efc21ed7cdfae4d574fdb --hash=sha256:d3e32536234a95f513bd374e93d717cf6b2231a791758de6c509e3653f234c95 --hash=sha256:d5372ca1df0f91a86b047d1277c2aaf1edb32d78bbcefffc81b40ffd18f027ed --hash=sha256:d77e1b2c6d04711478cb1c4ab90db07f1609ccf06a287d5607fcd90dc9863acf --hash=sha256:d947071e6ebcf2e2bee8fce76e10faca8f7a14808ca36a910263acaacef08eca --hash=sha256:dd7afd3f8b0bfb4e0d9fc3c31bfe8a4ec7debe124cfd90619305def3c8ca8cd2 --hash=sha256:de6b9a04c606978fdfe72666fa216ffcf2d1a9f6a381058d4378f8d7b1e5de62 --hash=sha256:e1651bf8e0398574646744c1885a41198eba53dc8a9312b954073f845c90a8df --hash=sha256:e1b329cb8146d7b736677a2440e422eadd775d1806a81db2d4cded80a48efc1a --hash=sha256:e1b51bebd221006d3d2f95fbe124b22b247136647ae5dcc8c7acafba66e5ee67 --hash=sha256:e340382d1afa5d32b892b3ff062436d592ec3d692aeea3bef3a5cfe11bbf8c6f --hash=sha256:e4b582bab49ac33c8deb97e058cd67c2c50dac0dd134874106d9c774fd272529 --hash=sha256:e51ac5435758ba97ad69617e13233da53908beccc6cfcd6c34bbed8dcbede486 --hash=sha256:e5542339dcf2747135c5c85f68680353d5cb9ffd741c0f2e8d832d054d41f35a --hash=sha256:e6438cc8f23a9c1478633d216b16104a586b9761db62bfacb6425bac0a36679e --hash=sha256:e81fda2fb4a07eda1a2252b216aa0df23ebcd4d584894e9612e80999a78fd95b --hash=sha256:ea70f61a47f3cc93bdf8b2f368ed359ef02a01ca6393916bc8ff877427181e74 --hash=sha256:ebd4549b108d732dba1d4ace67614b9545b21ece30937a63a65dd34efa19732d --hash=sha256:efb07073be061c8f79d03d04139a80ba33cbd390ca8f0297aae9cce6411e4c6b --hash=sha256:f0d97c18dfd9a9af4490631905a3f131a8e4c9e80a39353919e2cfed8f00aedc --hash=sha256:f1e09112a2c31ffe8d80be1b0988fa6a18c5d5cad92a9ffbb1c04c91bfe52ad2 --hash=sha256:f3d7a87a78d46a2e3d5b72587ac14b4c16952dd0887dbb051451eceac774411e --hash=sha256:f4afb5c34f2c6fecdcc182dfcfc6af6cccf1aa923eed4d6a12e9d96904e1a0d8 --hash=sha256:f6d2cb59377d99718913ad9a151030d6f83ef420a2b8f521d94609ecc106ee82 --hash=sha256:f87ac53513d22240c7d59203f25cc3beac1e574c6cd681bbfd321987b69f95fd --hash=sha256:ff86011bd159a9d2dfc89c34cfd8aff12875980e3bd6a39ff097887520e60249 +zstandard==0.25.0 --hash=sha256:011d388c76b11a0c165374ce660ce2c8efa8e5d87f34996aa80f9c0816698b64 --hash=sha256:01582723b3ccd6939ab7b3a78622c573799d5d8737b534b86d0e06ac18dbde4a --hash=sha256:05353cef599a7b0b98baca9b068dd36810c3ef0f42bf282583f438caf6ddcee3 --hash=sha256:05df5136bc5a011f33cd25bc9f506e7426c0c9b3f9954f056831ce68f3b6689f --hash=sha256:06acb75eebeedb77b69048031282737717a63e71e4ae3f77cc0c3b9508320df6 --hash=sha256:07b527a69c1e1c8b5ab1ab14e2afe0675614a09182213f21a0717b62027b5936 --hash=sha256:0bbc9a0c65ce0eea3c34a691e3c4b6889f5f3909ba4822ab385fab9057099431 --hash=sha256:0be7622c37c183406f3dbf0cba104118eb16a4ea7359eeb5752f0794882fc250 --hash=sha256:106281ae350e494f4ac8a80470e66d1fe27e497052c8d9c3b95dc4cf1ade81aa --hash=sha256:10ef2a79ab8e2974e2075fb984e5b9806c64134810fac21576f0668e7ea19f8f --hash=sha256:1673b7199bbe763365b81a4f3252b8e80f44c9e323fc42940dc8843bfeaf9851 --hash=sha256:172de1f06947577d3a3005416977cce6168f2261284c02080e7ad0185faeced3 --hash=sha256:181eb40e0b6a29b3cd2849f825e0fa34397f649170673d385f3598ae17cca2e9 --hash=sha256:1869da9571d5e94a85a5e8d57e4e8807b175c9e4a6294e3b66fa4efb074d90f6 --hash=sha256:19796b39075201d51d5f5f790bf849221e58b48a39a5fc74837675d8bafc7362 --hash=sha256:1cd5da4d8e8ee0e88be976c294db744773459d51bb32f707a0f166e5ad5c8649 --hash=sha256:1f3689581a72eaba9131b1d9bdbfe520ccd169999219b41000ede2fca5c1bfdb --hash=sha256:1f830a0dac88719af0ae43b8b2d6aef487d437036468ef3c2ea59c51f9d55fd5 --hash=sha256:223415140608d0f0da010499eaa8ccdb9af210a543fac54bce15babbcfc78439 --hash=sha256:22a06c5df3751bb7dc67406f5374734ccee8ed37fc5981bf1ad7041831fa1137 --hash=sha256:22a086cff1b6ceca18a8dd6096ec631e430e93a8e70a9ca5efa7561a00f826fa --hash=sha256:23ebc8f17a03133b4426bcc04aabd68f8236eb78c3760f12783385171b0fd8bd --hash=sha256:25f8f3cd45087d089aef5ba3848cd9efe3ad41163d3400862fb42f81a3a46701 --hash=sha256:2b6bd67528ee8b5c5f10255735abc21aa106931f0dbaf297c7be0c886353c3d0 --hash=sha256:2e54296a283f3ab5a26fc9b8b5d4978ea0532f37b231644f367aa588930aa043 --hash=sha256:3756b3e9da9b83da1796f8809dd57cb024f838b9eeafde28f3cb472012797ac1 --hash=sha256:37daddd452c0ffb65da00620afb8e17abd4adaae6ce6310702841760c2c26860 --hash=sha256:3a39c94ad7866160a4a46d772e43311a743c316942037671beb264e395bdd611 --hash=sha256:3b870ce5a02d4b22286cf4944c628e0f0881b11b3f14667c1d62185a99e04f53 --hash=sha256:3c83b0188c852a47cd13ef3bf9209fb0a77fa5374958b8c53aaa699398c6bd7b --hash=sha256:4203ce3b31aec23012d3a4cf4a2ed64d12fea5269c49aed5e4c3611b938e4088 --hash=sha256:457ed498fc58cdc12fc48f7950e02740d4f7ae9493dd4ab2168a47c93c31298e --hash=sha256:474d2596a2dbc241a556e965fb76002c1ce655445e4e3bf38e5477d413165ffa --hash=sha256:4b14abacf83dfb5c25eb4e4a79520de9e7e205f72c9ee7702f91233ae57d33a2 --hash=sha256:4b6d83057e713ff235a12e73916b6d356e3084fd3d14ced499d84240f3eecee0 --hash=sha256:4d441506e9b372386a5271c64125f72d5df6d2a8e8a2a45a0ae09b03cb781ef7 --hash=sha256:4f187a0bb61b35119d1926aee039524d1f93aaf38a9916b8c4b78ac8514a0aaf --hash=sha256:51526324f1b23229001eb3735bc8c94f9c578b1bd9e867a0a646a3b17109f388 --hash=sha256:53e08b2445a6bc241261fea89d065536f00a581f02535f8122eba42db9375530 --hash=sha256:53f94448fe5b10ee75d246497168e5825135d54325458c4bfffbaafabcc0a577 --hash=sha256:5a56ba0db2d244117ed744dfa8f6f5b366e14148e00de44723413b2f3938a902 --hash=sha256:5f1ad7bf88535edcf30038f6919abe087f606f62c00a87d7e33e7fc57cb69fcc --hash=sha256:5f5e4c2a23ca271c218ac025bd7d635597048b366d6f31f420aaeb715239fc98 --hash=sha256:6a573a35693e03cf1d67799fd01b50ff578515a8aeadd4595d2a7fa9f3ec002a --hash=sha256:6c0e5a65158a7946e7a7affa6418878ef97ab66636f13353b8502d7ea03c8097 --hash=sha256:6dffecc361d079bb48d7caef5d673c88c8988d3d33fb74ab95b7ee6da42652ea --hash=sha256:7030defa83eef3e51ff26f0b7bfb229f0204b66fe18e04359ce3474ac33cbc09 --hash=sha256:7149623bba7fdf7e7f24312953bcf73cae103db8cae49f8154dd1eadc8a29ecb --hash=sha256:72d35d7aa0bba323965da807a462b0966c91608ef3a48ba761678cb20ce5d8b7 --hash=sha256:75ffc32a569fb049499e63ce68c743155477610532da1eb38e7f24bf7cd29e74 --hash=sha256:7713e1179d162cf5c7906da876ec2ccb9c3a9dcbdffef0cc7f70c3667a205f0b --hash=sha256:78228d8a6a1c177a96b94f7e2e8d012c55f9c760761980da16ae7546a15a8e9b --hash=sha256:7b3c3a3ab9daa3eed242d6ecceead93aebbb8f5f84318d82cee643e019c4b73b --hash=sha256:809c5bcb2c67cd0ed81e9229d227d4ca28f82d0f778fc5fea624a9def3963f91 --hash=sha256:81dad8d145d8fd981b2962b686b2241d3a1ea07733e76a2f15435dfb7fb60150 --hash=sha256:85304a43f4d513f5464ceb938aa02c1e78c2943b29f44a750b48b25ac999a049 --hash=sha256:89c4b48479a43f820b749df49cd7ba2dbc2b1b78560ecb5ab52985574fd40b27 --hash=sha256:8e735494da3db08694d26480f1493ad2cf86e99bdd53e8e9771b2752a5c0246a --hash=sha256:913cbd31a400febff93b564a23e17c3ed2d56c064006f54efec210d586171c00 --hash=sha256:9174f4ed06f790a6869b41cba05b43eeb9a35f8993c4422ab853b705e8112bbd --hash=sha256:9300d02ea7c6506f00e627e287e0492a5eb0371ec1670ae852fefffa6164b072 --hash=sha256:933b65d7680ea337180733cf9e87293cc5500cc0eb3fc8769f4d3c88d724ec5c --hash=sha256:9654dbc012d8b06fc3d19cc825af3f7bf8ae242226df5f83936cb39f5fdc846c --hash=sha256:98750a309eb2f020da61e727de7d7ba3c57c97cf6213f6f6277bb7fb42a8e065 --hash=sha256:99c0c846e6e61718715a3c9437ccc625de26593fea60189567f0118dc9db7512 --hash=sha256:a1a4ae2dec3993a32247995bdfe367fc3266da832d82f8438c8570f989753de1 --hash=sha256:a3f79487c687b1fc69f19e487cd949bf3aae653d181dfb5fde3bf6d18894706f --hash=sha256:a4089a10e598eae6393756b036e0f419e8c1d60f44a831520f9af41c14216cf2 --hash=sha256:a51ff14f8017338e2f2e5dab738ce1ec3b5a851f23b18c1ae1359b1eecbee6df --hash=sha256:a5a419712cf88862a45a23def0ae063686db3d324cec7edbe40509d1a79a0aab --hash=sha256:a9ec8c642d1ec73287ae3e726792dd86c96f5681eb8df274a757bf62b750eae7 --hash=sha256:aaf21ba8fb76d102b696781bddaa0954b782536446083ae3fdaa6f16b25a1c4b --hash=sha256:ab85470ab54c2cb96e176f40342d9ed41e58ca5733be6a893b730e7af9c40550 --hash=sha256:b9af1fe743828123e12b41dd8091eca1074d0c1569cc42e6e1eee98027f2bbd0 --hash=sha256:bfc4e20784722098822e3eee42b8e576b379ed72cca4a7cb856ae733e62192ea --hash=sha256:bfd06b1c5584b657a2892a6014c2f4c20e0db0208c159148fa78c65f7e0b0277 --hash=sha256:c19bcdd826e95671065f8692b5a4aa95c52dc7a02a4c5a0cac46deb879a017a2 --hash=sha256:c2ba942c94e0691467ab901fc51b6f2085ff48f2eea77b1a48240f011e8247c7 --hash=sha256:c8e167d5adf59476fa3e37bee730890e389410c354771a62e3c076c86f9f7778 --hash=sha256:ca54090275939dc8ec5dea2d2afb400e0f83444b2fc24e07df7fdef677110859 --hash=sha256:d7541afd73985c630bafcd6338d2518ae96060075f9463d7dc14cfb33514383d --hash=sha256:d8c56bb4e6c795fc77d74d8e8b80846e1fb8292fc0b5060cd8131d522974b751 --hash=sha256:da469dc041701583e34de852d8634703550348d5822e66a0c827d39b05365b12 --hash=sha256:daab68faadb847063d0c56f361a289c4f268706b598afbf9ad113cbe5c38b6b2 --hash=sha256:e05ab82ea7753354bb054b92e2f288afb750e6b439ff6ca78af52939ebbc476d --hash=sha256:e09bb6252b6476d8d56100e8147b803befa9a12cea144bbe629dd508800d1ad0 --hash=sha256:e29f0cf06974c899b2c188ef7f783607dbef36da4c242eb6c82dcd8b512855e3 --hash=sha256:e59fdc271772f6686e01e1b3b74537259800f57e24280be3f29c8a0deb1904dd --hash=sha256:e7360eae90809efd19b886e59a09dad07da4ca9ba096752e61a2e03c8aca188e --hash=sha256:e96594a5537722fdfb79951672a2a63aec5ebfb823e7560586f7484819f2a08f --hash=sha256:ea9d54cc3d8064260114a0bbf3479fc4a98b21dffc89b3459edd506b69262f6e --hash=sha256:ec996f12524f88e151c339688c3897194821d7f03081ab35d31d1e12ec975e94 --hash=sha256:f27662e4f7dbf9f9c12391cb37b4c4c3cb90ffbd3b1fb9284dadbbb8935fa708 --hash=sha256:f373da2c1757bb7f1acaf09369cdc1d51d84131e50d5fa9863982fd626466313 --hash=sha256:f5aeea11ded7320a84dcdd62a3d95b5186834224a9e55b92ccae35d21a8b63d4 --hash=sha256:f604efd28f239cc21b3adb53eb061e2a205dc164be408e553b41ba2ffe0ca15c --hash=sha256:f67e8f1a324a900e75b5e28ffb152bcac9fbed1cc7b43f99cd90f395c4375344 --hash=sha256:fd7a5004eb1980d3cefe26b2685bcb0b17989901a70a1040d1ac86f1d898c551 --hash=sha256:ffef5a74088f1e09947aecf91011136665152e0b4b359c42be3373897fb39b01 diff --git a/benchmarks/cqa/study.py b/benchmarks/cqa/study.py new file mode 100644 index 000000000..f730404f7 --- /dev/null +++ b/benchmarks/cqa/study.py @@ -0,0 +1,332 @@ +"""Frozen CQA inputs, reference batches, verification gates, and job execution.""" + +import importlib.metadata +import os +import platform +import random +import subprocess +import time +from collections import Counter +from pathlib import Path + +import numpy as np +import torch + +from dicee.query_answering._checkpoint import BenchmarkCheckpoint, checksum, implementation_fingerprint, input_path, read, source_fingerprint, write_json +from dicee.query_answering._query import PLUS_H_SHAPES, compile_query, relation_signature +from dicee.query_answering.context import fingerprint +from dicee.query_answering.datasets import PLUS_H_DATASETS, dataset_spec, inference_graph_for_split, load_benchmark, source_query_groups +from dicee.query_answering.method_evaluation import evaluate_method, save_results +from dicee.query_answering.methods import REFERENCES + +from .manifests import validate_entry +from .provenance import validate_training + +SOURCE_ROOT = Path(__file__).resolve().parents[2] + + +def dataset_key(entry, split): + key = f'{entry["dataset"]}/{split}' + graph = inference_graph_for_split(entry['dataset'], split, entry.get('inference_graph')) + return key + '/train+valid' if graph == 'train+valid' else key + + +def code_identity(): + """Source that can change frozen-study results. + + The dicee package without its command-line scripts, and this harness without + tests or paper tooling, so local scripts never break verification elsewhere. + """ + package, harness = SOURCE_ROOT / 'dicee', Path(__file__).parent + paths = [path for path in package.rglob('*.py') if path.relative_to(package).parts[0] != 'scripts'] + paths += [path for path in harness.rglob('*.py') if path.relative_to(harness).parts[0] not in ('tests', 'paper')] + return source_fingerprint(paths, SOURCE_ROOT) + + +def environment(device): + try: + driver = subprocess.check_output(['nvidia-smi', '--query-gpu=uuid,name,driver_version', '--format=csv,noheader'], text=True).strip() + except (OSError, subprocess.CalledProcessError): + driver = None + return dict(python=platform.python_version(), platform=platform.platform(), torch=str(torch.__version__), + cuda=torch.version.cuda, device=str(device), driver=driver, + gpu=torch.cuda.get_device_name(device) if torch.device(device).type == 'cuda' else None, + image_id=os.environ.get('DICEE_IMAGE_ID'), source_commit=os.environ.get('DICEE_SOURCE_COMMIT'), + source_dirty=os.environ.get('DICEE_SOURCE_DIRTY'), + packages={name: importlib.metadata.version(name) for name in ('torch', 'numpy', 'lightning', 'pandas')}, + threads=torch.get_num_threads(), precision='float32 IEEE; no autocast', + deterministic_algorithms=torch.are_deterministic_algorithms_enabled(), + cublas_workspace_config=os.environ.get('CUBLAS_WORKSPACE_CONFIG')) + + +def make_plan(data, entry, root, query_ids=None): + """Keep each structure's original conversion order and batch membership.""" + wanted = set(entry['query_types']) + lookup = {query.query: query for query in data.queries if query.shape in wanted} + if entry['query_order'] == 'upstream-pickle': + groups = source_query_groups(data, input_path(root, entry['_data_root']), entry['query_types']) + else: + groups = [[query for query in data.queries if query.shape == shape] for shape in entry['query_types']] + if entry['query_order'] == 'relation': + groups = [sorted(group, key=lambda query: (relation_signature(compile_query(query.query)), query.query)) for group in groups] + queries, ends = [], [] + for group in groups: + for start in range(0, len(group), entry['query_batch_size']): + queries.extend(group[start:start + entry['query_batch_size']]) + ends.append(len(queries)) + if len(queries) != len(lookup) or len(set(queries)) != len(queries): + raise ValueError('Reference order does not cover each selected query exactly once') + return dict(queries=[query_ids[query.query] if query_ids is not None else query.identity for query in queries], batch_ends=ends, + query_counts=dict(Counter(query.shape for query in queries)), order=entry['query_order']) + + +def freeze(manifest, output, input_root): + """Pin inputs and plans without loading model weights or running test inference.""" + manifest = read(manifest) if isinstance(manifest, (str, Path)) else manifest + if (set(manifest) - {'answer_filter'} != {'version', 'data_root', 'entries', 'seed', 'threads', 'archives'} + or manifest['version'] != 1 or manifest.get('answer_filter', 'released') not in ('released', 'corrected')): + raise ValueError('Expected version, data_root, entries, seed, threads, archives') + if type(manifest['seed']) is not int or type(manifest['threads']) is not int or manifest['threads'] < 1: + raise ValueError('Invalid seed or thread count') + entries = manifest['entries'] + if not entries or len({entry['id'] for entry in entries}) != len(entries): + raise ValueError('Entries need unique IDs') + for entry in entries: + validate_entry(entry) + if manifest.get('answer_filter') == 'corrected' and any(e['dataset'] not in PLUS_H_DATASETS for e in entries): + raise ValueError('Corrected answer filters are only defined for the +H suite') + output = Path(output) + if (output / 'bundle.json').exists(): + raise FileExistsError('Use a new bundle directory to change a frozen study') + pins = {} + + def pin(relative): + pins[relative] = checksum(input_path(input_root, relative)) + + for entry in entries: + pin(entry['checkpoint']) + if entry.get('training'): + pin(entry['training']) + _, training_pins = validate_training(entry, input_root, manifest['data_root'], file_hashes=pins) + pins.update(training_pins) + for relative in entry.get('adapters', {}).values(): + pin(relative) + if entry.get('verification'): + pin(entry['verification']) + datasets, plans, corrections = {}, {}, {} + for name in dict.fromkeys(entry['dataset'] for entry in entries): + for split in ('valid', 'test'): + matching = [entry for entry in entries if entry['dataset'] == name] + policies = list(dict.fromkeys(inference_graph_for_split(name, split, entry.get('inference_graph')) for entry in matching)) + data = load_benchmark(input_path(input_root, manifest['data_root']), name, split=split, + inference_graph=policies[0]) + query_ids = {query.query: query.identity for query in data.queries} + key = dataset_key(dict(dataset=name, inference_graph=policies[0]), split) + datasets[key] = dict(context=data.context.identity, candidates=fingerprint(data.candidates), + metadata=data.metadata, queries=len(data.queries), + query_ids=fingerprint(sorted(query_ids.values()))) + for filename, digest in data.metadata['files'].items(): + relative = str(Path(manifest['data_root']) / dataset_spec(name)[1] / filename) + pins[relative] = digest + if split == 'test' and manifest.get('answer_filter') == 'corrected': + from dicee.query_answering.datasets import audit_plus_h_filters + audit = audit_plus_h_filters(input_path(input_root, manifest['data_root']), data) + relative = f'filters/{name}.json' + write_json(output / relative, audit) + corrections[name] = dict(path=relative, sha256=checksum(output / relative), per_shape=audit['per_shape']) + for filename, digest in audit['source_files'].items(): + pins[str(Path(manifest['data_root']) / dataset_spec(name)[1] / filename)] = digest + for policy in policies[1:]: + variant = load_benchmark(input_path(input_root, manifest['data_root']), name, split=split, + inference_graph=policy) + variant_key = dataset_key(dict(dataset=name, inference_graph=policy), split) + datasets[variant_key] = dict(datasets[key], context=variant.context.identity, metadata=variant.metadata) + for filename, digest in variant.metadata['files'].items(): + pins[str(Path(manifest['data_root']) / dataset_spec(name)[1] / filename)] = digest + prepared_plans = {} + for entry in entries: + if entry['dataset'] != name: + continue + layout = fingerprint({key: entry[key] for key in ('query_types', 'query_batch_size', 'query_order')}) + if layout not in prepared_plans: + plan = make_plan(data, dict(entry, _data_root=manifest['data_root']), input_root, query_ids) + relative = f'plans/{name}-{split}-{layout[:16]}.json' + write_json(output / relative, plan) + prepared_plans[layout] = dict(path=relative, sha256=checksum(output / relative)) + plans[f'{entry["id"]}/{split}'] = prepared_plans[layout] + bundle = dict(version=1, manifest=manifest, files=pins, datasets=datasets, plans=plans, filter_corrections=corrections, + source_sha256=code_identity(), implementation_sha256=implementation_fingerprint(), + created=time.time(), python=platform.python_version(), + protocol=dict(tie_policies=['sort', 'expected'], tie_equality='exact', + filtering=manifest.get('answer_filter', 'released'), + averaging='answers per query; queries per type; equal types', + observed_graphs=('entry-specific test graph; validation uses train; pinned by context hashes' + if all(e['dataset'] in PLUS_H_DATASETS for e in entries) else + 'published dataset-specific validation/test graphs; pinned by context hashes'), + candidates='dataset-specific; pinned by candidate hashes')) + write_json(output / 'bundle.json', bundle) + write_json(output / 'bundle.sha256.json', {'sha256': checksum(output / 'bundle.json')}) + return bundle + + +def verify_bundle(directory, input_root): + directory = Path(directory) + if checksum(directory / 'bundle.json') != read(directory / 'bundle.sha256.json')['sha256']: + raise ValueError('Bundle checksum mismatch') + bundle = read(directory / 'bundle.json') + if bundle['source_sha256'] != code_identity(): + raise ValueError('Source differs from the frozen bundle; freeze a new study') + for relative, digest in bundle['files'].items(): + if checksum(input_path(input_root, relative)) != digest: + raise ValueError(f'Input checksum mismatch: {relative}') + for plan in bundle['plans'].values(): + if checksum(directory / plan['path']) != plan['sha256']: + raise ValueError('Query plan checksum mismatch') + for correction in bundle.get('filter_corrections', {}).values(): + if checksum(directory / correction['path']) != correction['sha256']: + raise ValueError('Answer-filter correction checksum mismatch') + return bundle + + +def bundle_entry(bundle, entry_id): + """The frozen entry ``entry_id`` of ``bundle``.""" + matches = [entry for entry in bundle['manifest']['entries'] if entry['id'] == entry_id] + if len(matches) != 1: + raise ValueError(f'No frozen entry {entry_id!r} in this bundle') + return matches[0] + + +def run_job(bundle_dir, entry_id, input_root, output, *, device='cpu', phase='pilot', pilot_queries=2, + on_prediction=None, probe_only=False, on_control_prediction=None): + """Pilot validation or full test; never choose settings from test labels.""" + from dicee.models._inference import float32_precision_backends + bundle = verify_bundle(bundle_dir, input_root) + entry = bundle_entry(bundle, entry_id) + if phase not in ('pilot', 'test'): + raise ValueError('Choose the pilot or test phase') + if probe_only and phase != 'pilot': + raise ValueError('Probe selection is only available for validation pilots') + if phase == 'test': + validate_training(entry, input_root, bundle['manifest']['data_root'], final=True, file_hashes=bundle['files']) + if entry.get('blockers') or (entry['method'].endswith('-adapter') and not entry.get('finalized')): + raise ValueError(f'Entry is not ready for final testing: {entry.get("blockers", ["adapter recipe is provisional"])}') + if not entry.get('verification'): + raise ValueError('Final testing requires pinned reference parity evidence') + seed, threads = bundle['manifest']['seed'], bundle['manifest']['threads'] + random.seed(seed) + np.random.seed(seed) + torch.manual_seed(seed) + torch.set_num_threads(threads) + for backend in float32_precision_backends(): + backend.fp32_precision = 'ieee' + env = environment(device) + if phase == 'test': + evidence = read(input_path(input_root, entry['verification'])) + expected = dict(entry_sha256=fingerprint({key: value for key, value in entry.items() if key != 'verification'}), + source_sha256=bundle['source_sha256'], environment=env, + inputs_sha256=entry_inputs_identity(bundle, entry)) + if not evidence.get('passed') or any(evidence.get(key) != value for key, value in expected.items()): + raise ValueError('Parity evidence does not match this entry, source, and execution hardware') + output = Path(output) + identity = dict(bundle=checksum(Path(bundle_dir) / 'bundle.json'), entry=entry_id, phase=phase, + pilot_queries=pilot_queries if phase == 'pilot' else None, probe_only=probe_only, environment=env) + with BenchmarkCheckpoint(output / 'job', identity): + if (output / 'result.json').exists(): + result = read(output / 'result.json') + if result.get('benchmark_run', result.get('paper_run')) != identity: + raise ValueError('Result identity mismatch') + if checksum(output / 'ranks.sqlite3') != result['rank_trace_sha256']: + raise ValueError('Completed rank trace checksum mismatch') + for name, expected_checksum in result.get('comparison_results', {}).items(): + comparison = read(output / name / 'result.json') + if (checksum(output / name / 'result.json') != expected_checksum or + checksum(output / name / 'ranks.sqlite3') != comparison['rank_trace_sha256']): + raise ValueError('Completed comparison checksum mismatch') + return result + write_json(output / 'status.json', dict(state='loading', updated=time.time(), **identity)) + started = time.monotonic() + split = 'valid' if phase == 'pilot' else 'test' + data = load_benchmark(input_path(input_root, bundle['manifest']['data_root']), entry['dataset'], split=split, + inference_graph=entry.get('inference_graph')) + if data.context.identity != bundle['datasets'][dataset_key(entry, split)]['context']: + raise ValueError('Loaded inference graph differs from the frozen graph') + lookup = {query.identity: query for query in data.queries} + filter_corrections = None + if phase == 'test' and bundle['manifest'].get('answer_filter') == 'corrected': + from dicee.query_answering.datasets import corrected_answer_filters + correction = bundle['filter_corrections'][entry['dataset']] + filter_corrections = corrected_answer_filters(data, read(Path(bundle_dir) / correction['path'])) + query_lookup = {query.query: query for query in data.queries} + prediction_hook = (lambda query, scores: on_prediction(query_lookup[query], scores)) if on_prediction else None + control_hook = (lambda query, scores: on_control_prediction(query_lookup[query], scores)) if on_control_prediction else None + saved_plan = read(Path(bundle_dir) / bundle['plans'][f'{entry_id}/{split}']['path']) + plan = [lookup[key] for key in saved_plan['queries']] + ends = saved_plan['batch_ends'] + reference_batches = {} + if phase == 'pilot': + if type(pilot_queries) is not int or pilot_queries < 1: + raise ValueError('Positive pilot query budget required') + selected, selected_ends, counts, start = [], [], Counter(), 0 + for end in ends: + batch = plan[start:end] + if counts[batch[0].shape] < pilot_queries: + probes = batch[:pilot_queries - counts[batch[0].shape]] if probe_only else batch + reference_batches[probes[0].query] = [query.query for query in batch] + selected.extend(probes) + selected_ends.append(len(selected)) + counts[batch[0].shape] += len(probes) + start = end + plan, ends = selected, selected_ends + loading = time.monotonic() - started + if torch.device(device).type == 'cuda': + torch.cuda.reset_peak_memory_stats(device) + write_json(output / 'status.json', dict(state='evaluating', updated=time.time(), **identity)) + try: + recipe = {key: entry[key] for key in ('method', 'dataset', 'query_types', 'query_batch_size')} + recipe.update(checkpoint=str(input_path(input_root, entry['checkpoint'])), + root=str(input_path(input_root, bundle['manifest']['data_root'])), + options=dict(entry['options'])) + if 'inference_graph' in entry: + recipe['inference_graph'] = entry['inference_graph'] + if entry['method'] in REFERENCES: + recipe['vocabulary_dataset'] = entry['dataset'] + if 'per_shape' in recipe['options']: + recipe['per_shape'] = recipe['options'].pop('per_shape') + else: + recipe.update(adapters={name: str(input_path(input_root, path)) for name, path in entry['adapters'].items()}, + operators=entry['operators'], selection_protocol=entry['selection_protocol'], + adapter_ablation=entry.get('adapter_ablation', False)) + report = evaluate_method(recipe, output=output, data=data, split=split, device=device, seed=seed, + query_plan=plan, batch_ends=ends, rank_trace_path=output / 'ranks.sqlite3', provenance=identity, + query_order='published' if entry['method'] in REFERENCES else entry['query_order'], + write_result=False, on_prediction=prediction_hook, reference_batches=reference_batches, + on_control_prediction=control_hook if entry['method'] not in REFERENCES else None, + filter_corrections=filter_corrections) + profile = ('bounded' if not entry['options'].get('reference_batching', False) else 'reference') if entry['method'] in ('cqd', 'cqd-hybrid') else ('reference' if entry['method'] in REFERENCES else 'native') + common = dict(execution_profile=profile, reference=entry['reference'], + graph_ablation=entry.get('graph_ablation'), + graph_recipe_sha256=fingerprint(dict( + recipe={key: value for key, value in entry.items() + if key not in ('id', 'inference_graph', 'graph_ablation', 'verification', 'reference')}, + inputs=entry_inputs_identity(bundle, entry), source=bundle['source_sha256'], + filters=bundle.get('filter_corrections', {}).get(entry['dataset']), + plan=bundle['plans'][f'{entry_id}/{split}']['sha256'], seed=seed, environment=env)), coverage=dict( + selected_types=entry['query_types'], expected_types=data.metadata['expected_query_types'], + complete_benchmark_types=set(entry['query_types']) == set(data.metadata['expected_query_types']), + complete_16_types=set(entry['query_types']) == set(PLUS_H_SHAPES)), + dataset_loading_seconds=loading, total_wall_seconds=time.monotonic() - started, + peak_cuda_allocated_bytes=torch.cuda.max_memory_allocated(device) if torch.device(device).type == 'cuda' else None) + save_results(report, output, run=identity, metadata=common) + write_json(output / 'status.json', dict(state='complete', updated=time.time(), **identity)) + return report + except BaseException as error: + write_json(output / 'status.json', dict(state='failed', error=str(error), updated=time.time(), **identity)) + raise + + +def entry_inputs_identity(bundle, entry): + selected = {entry['checkpoint'], *entry.get('adapters', {}).values()} + if entry.get('training'): + selected.add(entry['training']) + prefix = str(Path(bundle['manifest']['data_root']) / dataset_spec(entry['dataset'])[1]) + '/' + return fingerprint({key: value for key, value in bundle['files'].items() if key in selected or key.startswith(prefix)}) diff --git a/benchmarks/cqa/tests/__init__.py b/benchmarks/cqa/tests/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/benchmarks/cqa/tests/recipe_fingerprints.json b/benchmarks/cqa/tests/recipe_fingerprints.json new file mode 100644 index 000000000..25332636f --- /dev/null +++ b/benchmarks/cqa/tests/recipe_fingerprints.json @@ -0,0 +1,179 @@ +{ + "plus_h/baselines.json": { + "cone-FB15k237+H": "b777464a0561176a7797ad69c58bbc4f48b4f1f1531ac5c67dc8dbeef662a0a5", + "gnnqe-FB15k237+H": "91f82093f41dd43afc45e66c871648498fa4f9b827f36dc131fc186e160c52db", + "ultraquery-FB15k237+H": "7e61565765bc01f245d977095a0a91bfde7e22c228f63d6e6bdb00bafaecbe31", + "clmpt-FB15k237+H": "8594c53f58b3305715e5d45571b7ac4792209a603deacf405c779c8649f8a394", + "cqd-FB15k237+H": "2f8594e09e9aeaedfd4a530b85115f9029775bc3f3bd8b4f40a4a377374d663f", + "cqd-hybrid-FB15k237+H": "83dd457559834229bd99e518eaa3482f887d9d24fb908d0c08c51f348a95c1f9", + "qto-FB15k237+H": "55544a11fc616298c97b89502368403586c758c15fa58914588ae05b0b9f94fd", + "cone-NELL995+H": "c8b275487e2b7bd6a25af041b69c3f5bbe9089da718b7f5d26e0d223f7afd1c4", + "gnnqe-NELL995+H": "4e854b0b944fca240caedfd3db0994870354fa577be2146d9b7155d7d2107a78", + "ultraquery-NELL995+H": "8daf270d1dfef53ce684e513d7e825385ffc66165ff974792ed90efc44f0cec2", + "clmpt-NELL995+H": "1d69cdee8d2133eaf09286cd3134c934edee36d5580981d8ae77e20eb94b8bf9", + "cqd-NELL995+H": "435d309810afafc07fede359c0f53aeee8d6de6f3ea813dcfc7e69e347a04006", + "cqd-hybrid-NELL995+H": "9572fb778227a97087e871f0c6852240e582e9a41e8fcce83c340c9e485942ea", + "qto-NELL995+H": "1d6a0273a6f2d11834132e288612ab0848099810abc5303da9ce7d849b77b754", + "cone-ICEWS18+H": "13714f669fcfe488f65afe8cc18ce25a144f3e25b0b21bccdae403500dba0b74", + "gnnqe-ICEWS18+H": "62ac479f319b62ab29105b14e327dae0a303a6cf00d5f9989d38e135d833af52", + "ultraquery-ICEWS18+H": "c0cba93ed7bc90435d613a856b49dc1b22ff7aed523ef704204abd7fe4e48ca8", + "clmpt-ICEWS18+H": "2c0d83424f3b632f767c1fc8ee9bfc5a325e6de99d72ce1f22b2e28731d466a9", + "cqd-ICEWS18+H": "742156216a0ee43512138fad200af95e494b2146ae160b17c2e8f4839b893bda", + "cqd-hybrid-ICEWS18+H": "37e3d6d0307f3661c1a58eebf3f07960605008ae959b421ffc3fe63f98509a89", + "qto-ICEWS18+H": "cef09df05749b23f75aff1b0b4dc49dc77de547064cd0e57289219e976f811e0" + }, + "plus_h/kgfm_adapters.json": { + "ultra-product-14type-FB15k237+H": "bc15b0f7cc9c5eaed7cc63f6c023964eead80b9e721561cdb28ae5df64244826", + "ultra-product-14type-NELL995+H": "86e00279f85d026b08bd7363c3e1fc0688b81727da1acefd0d55611f4940f85c", + "ultra-product-14type-ICEWS18+H": "e2843b22b81cd16efb593b27e3438e5eefdc5df2f2bdbf13b0bea5fed261dca9", + "trix-product-14type-FB15k237+H": "593033539e5d68f216c3d2cf796bab5f956c563eb4319556699feb18e5d450e2", + "trix-product-14type-NELL995+H": "4cf792ec22efee88e808657ebffa9887688d51ef69e5e9ad084ee97e08461f27", + "trix-product-14type-ICEWS18+H": "c6f956f332f9b0a3d28f89a49c2d4007646af696239ea690977020e87040c4ad" + }, + "ultraquery/baselines.json": { + "ultraquery-FB15k237LogicalQuery": "529aa658841bff87867a50b626cae7e9c01dc8a7b38b5177eda2af712988e66d", + "ultraquery-FB15kLogicalQuery": "01ae98208647999c884181ef7308944ffc47555d260b4f27d7bdf2bc0dea5f7f", + "ultraquery-NELL995LogicalQuery": "16df73e62cb45ee294b26c5b683050d74253cb8dbc2a4a1b9cd6797eba7cede9", + "ultraquery-InductiveFB15k237Query:106": "c5073b00330b53eacd1a8915c0bce42b9bd3529a58e594289a461ef4449be596", + "ultraquery-InductiveFB15k237Query:113": "6889d15aa1354a9b09f03437cf2cfcb36693f04a381e2bc4ff330fcb4988c105", + "ultraquery-InductiveFB15k237Query:122": "aa367e591c621ac797c68e88b4301fe6fb2bb02dac24325772ebd12547e42a7d", + "ultraquery-InductiveFB15k237Query:134": "74e4dc629d34402184e676ee1ffb3201e74e0210de3d3fc48a8717e23e66653f", + "ultraquery-InductiveFB15k237Query:150": "68be6b843432b955d14fe9843fff09f211bf5bbc7df0a5722798600327b24fac", + "ultraquery-InductiveFB15k237Query:175": "26fb1d46a553d085106dd0d83548f8307eb4af270c639bffb390a96b164c8831", + "ultraquery-InductiveFB15k237Query:217": "3ba266366574e77f74e9427c358940025fe6a7a737d616af64f8e6abdcac173b", + "ultraquery-InductiveFB15k237Query:300": "137fa330abe62fcc62243e7cdce5a94d677e37cdf188fcc29bb9a713100a253f", + "ultraquery-InductiveFB15k237Query:550": "4cdadd990e7e369ce5771a82070d3d3927a702ead0fe561c49bb26ab6a26c0cf", + "ultraquery-WikiTopicsQuery:art": "9f167ee40580fb4e03957e9e3580204c05b1c3b5be300528d7a7b55b8ddc21f9", + "ultraquery-WikiTopicsQuery:award": "b371b7eb035887b1adbf674bf554660b1cc871d18fbfb523987e6c3c2a586ec2", + "ultraquery-WikiTopicsQuery:edu": "e49caaab3d330ac85b5e9e0a7fb5b2075237d0f6504c3cf380f444725b40fb6e", + "ultraquery-WikiTopicsQuery:health": "b68f71dab3d57c6552b1bc39ddf90b5d883182cb592f76fd79cdd13d23ac056a", + "ultraquery-WikiTopicsQuery:infra": "aebc9bb5dfadc082387fea7bda8cdcab41c0cc37063005fe11296dbf2c5d527f", + "ultraquery-WikiTopicsQuery:loc": "bb4317cddf9490ed94bb88d7beb70507b2962256812eecd3a59cfc716c50b652", + "ultraquery-WikiTopicsQuery:org": "92a78b53b6dd1d670978c482d2cd4d2ae9f5289985847a5937598d28a60cc7e0", + "ultraquery-WikiTopicsQuery:people": "6e8ad2618a2f1ba0c4c4d4e7a052c90319a0587cd4c2e97f8fb3daeb13027ef4", + "ultraquery-WikiTopicsQuery:sci": "89a3adb5346ad51c3c8e245953755d54455d04d5b55c496e14f6e5b275c3d1aa", + "ultraquery-WikiTopicsQuery:sport": "40615d4debf7ef280ecb1386d8605741b73203e16b4b78f9c4decf0ac9173cd3", + "ultraquery-WikiTopicsQuery:tax": "b6ad26d90fced664325931c4e938e41cb1dbf9ebc43323a09bee9e7b8a403c75" + }, + "ultraquery/comparisons.json": { + "ultraquery-lp-FB15k237LogicalQuery": "dbfdd8496fff9d398ea92815edae6c2eab3fdf1e08175f9edd040297a8baced4", + "ultraquery-lp-no-threshold-FB15k237LogicalQuery": "a963727dc2154cb1636b61644805055ffd248abe946bd6d8a0febbb53c72eba1", + "ultraquery-lp-FB15kLogicalQuery": "2942f971df1a2a38a2afdc9896968748f12af2fce65d402d8ad5dd2bb02c215d", + "ultraquery-lp-no-threshold-FB15kLogicalQuery": "eabcdea0bfb9b93cbba21ef8a8f61d3dee33c673417be502182e9a61a076fe17", + "ultraquery-lp-NELL995LogicalQuery": "4fb015b5b6a1d862fd4d8ab6060aa5e8f26d270620491d0fd3cee11f70391335", + "ultraquery-lp-no-threshold-NELL995LogicalQuery": "a0cff7ce323c74c231a7862a36295d6d2fb69d5552ca7253156d2a4657d2ff40", + "ultraquery-lp-InductiveFB15k237Query:106": "d7517583ccd0462ccce2e51601844b60c2999a91add248389c421834ea431169", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:106": "5595ffcc392e0701b9b57c9a481b0463f6de9e62e81613e7506e29b7a718b2d7", + "ultraquery-lp-InductiveFB15k237Query:113": "060f0d6218ddd8ddd3d88c5961dcb4687b02f8b492d3c1c5cadccff415b03668", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:113": "439641456aeea80e1dc8fcc14707f9e374830e5a49f1ee3fd7619d1908bb68bb", + "ultraquery-lp-InductiveFB15k237Query:122": "a9f55a1f18bdea9e93d2d50ca3eaa794d29f21de0f5c9e9cc1303a2eb4b3abd2", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:122": "bb183066fe67fc2257c6e29294e9be67fb9607d1bf1829c7bd6875257de55b6a", + "ultraquery-lp-InductiveFB15k237Query:134": "24bf68250d0d3a17ca2844089b58fb0c536414e87b4fffc35fe93252804a0cae", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:134": "a44dea55c40f3d9ec3173a142fe61e7fada997e65563863f47c991fd94e4640f", + "ultraquery-lp-InductiveFB15k237Query:150": "fbb584c8ef2d7c1b5a1326a7d7f4d22965d2451cc4734f985574a905328e2461", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:150": "019325f11cba8d58ff67b3bd0b8befa6a993fd8274822858392acf5df4967c17", + "ultraquery-lp-InductiveFB15k237Query:175": "532a92102320abedbf9b0b7e4521227b44f9f269c48da49ec7f8c0fea1f37291", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:175": "dd067eaa46b768cbdd2fa8ec5439e0ecbc9dea8542733326cd8a3b4ce23c665f", + "ultraquery-lp-InductiveFB15k237Query:217": "ea4323a26c441c05b1b5ff3bb46ed2ee911a86d5ab193cfe644d8093b9458d60", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:217": "302711780fddcf86b0bdfb40de34b936182e029429a8fdadefb59779fbad289c", + "ultraquery-lp-InductiveFB15k237Query:300": "a57db5a0229a0092b93ef8d46e667dcc55173ed61b72d0aca9b122f95a531de9", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:300": "74c6e9bb759ea2df0089ec6aaa14c82eb50b466338f1255f7d8cb2450b7d7dbe", + "ultraquery-lp-InductiveFB15k237Query:550": "bfd49146b7bba02f9248483d7671d74a0d11c62865c47defe3657a631a4d8239", + "ultraquery-lp-no-threshold-InductiveFB15k237Query:550": "d3bc8fc45c74056dc974ab85e0c2625482f2ac98fc9371a72e1eafb1d1ad60af", + "ultraquery-lp-WikiTopicsQuery:art": "469b6f3a77c4773e910e76759a4e7612de4fb90c01333ea9ff51d4774e81a65e", + "ultraquery-lp-no-threshold-WikiTopicsQuery:art": "f10e58cf5be73c2325641aa71c476185884697610475ac1f19cbb77a985ed08a", + "incoming-relation-WikiTopicsQuery:art": "f84fe5bae3e9370e1f2372d05e18f0947780e65fe882297e96ed8692c895866d", + "ultraquery-lp-WikiTopicsQuery:award": "dc51e75a10149557cd3327fd4fd9ddd7dda8579faa8e3cea060c3f53813734c8", + "ultraquery-lp-no-threshold-WikiTopicsQuery:award": "7f8a1b01c3274abba4a8330b530cedfcf55fc803ca5d933e61298b2ed7c15d09", + "incoming-relation-WikiTopicsQuery:award": "89c89da1bda6b88d8274450f7a59272fcce3215af6ac2c8efe9c67d91e0a870b", + "ultraquery-lp-WikiTopicsQuery:edu": "392b620f3207eda26be33bdbd78954cac8046616941ad066d88edee1d2b2ce72", + "ultraquery-lp-no-threshold-WikiTopicsQuery:edu": "def2bb596f29b1382397c1ccc6a288632376843db132c3141a3d0c98f4996200", + "incoming-relation-WikiTopicsQuery:edu": "4450dbdb181c8e0a95d321381d80f4564a190a78284e31e909df145c9a8da09e", + "ultraquery-lp-WikiTopicsQuery:health": "9035ad431fd94baaa485b669e5d866ca17d55e0361ae9279e69bf6583d2bc7f4", + "ultraquery-lp-no-threshold-WikiTopicsQuery:health": "d1d75775f4d019b7ea95eef3f8e5c1327b571b8007717153a5076b5a7dafb710", + "incoming-relation-WikiTopicsQuery:health": "3d4de5790d6e115a70aa2def0d9bca9f43958e7ecb06ffb147ee06f1d3c3f273", + "ultraquery-lp-WikiTopicsQuery:infra": "f77c293a5aa2f24cb7c2a3c1df75b4dd2170856c4e8ccc3e26b5250b3d9b423e", + "ultraquery-lp-no-threshold-WikiTopicsQuery:infra": "595ee1f9f6667b4c99480f481a7bef440195b40ef06a3bcc6b2aa18a9f33c59f", + "incoming-relation-WikiTopicsQuery:infra": "d0579e7faf5ecdddf7daa9f0ff9d1a26530bd5eb99a94f8b1d55eacc4df483b3", + "ultraquery-lp-WikiTopicsQuery:loc": "9ca9886f6ba850f0a33ed341df262c53a3f51dfc039afb5bb7f1250fbccede91", + "ultraquery-lp-no-threshold-WikiTopicsQuery:loc": "8ab7c739c5ece4ae216fb20f3398c5904035ce0915cfd9efafd71a3660845fba", + "incoming-relation-WikiTopicsQuery:loc": "1aa09be175cd1f1e50b2122a50bc14f41c6f78ffc2f5c0d327a1493e33a145ae", + "ultraquery-lp-WikiTopicsQuery:org": "4c6bb425601958397b13325a3d5be8b9966da03d8960a4194214140f033fa4d3", + "ultraquery-lp-no-threshold-WikiTopicsQuery:org": "ba0eb0c8e4c6b20f0693a5414fd71747515a186ad73bebe572e1b72bad8057c8", + "incoming-relation-WikiTopicsQuery:org": "f800373bf4fbde6389b17089f5ee39f53171aa0fcd605314796d465b60fa4175", + "ultraquery-lp-WikiTopicsQuery:people": "7b4f924c501bdb6e35a80a372fd9cbe9bce471d93d71e9a15f33743493371540", + "ultraquery-lp-no-threshold-WikiTopicsQuery:people": "5ba0c5b20189a04577f591ff25af015a3fc60e04bae0024bf43276f7b8fd921e", + "incoming-relation-WikiTopicsQuery:people": "99db30b400072675395912609cc3a3f0f470d5ace0f93140ef4d7a76ab12d09f", + "ultraquery-lp-WikiTopicsQuery:sci": "dfbb20e0298ef0f8c3b3f5b19ecf3694247451c29697c62efd3ec04fa8e1293c", + "ultraquery-lp-no-threshold-WikiTopicsQuery:sci": "aab5467d9d5d09585726043a512720f48b993d0e8c60f085e1480c49665eeecb", + "incoming-relation-WikiTopicsQuery:sci": "3c16464e475c51daa2b38854ea1856dd00e0184b406ab057ab5f40b64b3b3e57", + "ultraquery-lp-WikiTopicsQuery:sport": "051a0ad562e33e6f2d2889369bc54d1bd94deef33ed57cc9dd0d3532918e9931", + "ultraquery-lp-no-threshold-WikiTopicsQuery:sport": "bd1bfbea70a7b7c60ccb6a69045bfd4b79d808b56694bf6f5b06d1c41324dcb3", + "incoming-relation-WikiTopicsQuery:sport": "af14d509a098ee3eb5b1a1dfaa7cd40b3e0803eeaa52158480b61671840b251e", + "ultraquery-lp-WikiTopicsQuery:tax": "2a3baeefe692b9938f53447f82e53c15b4a1be187462bd49928190d624881a95", + "ultraquery-lp-no-threshold-WikiTopicsQuery:tax": "150b9d100def6f28df7ec8c060e050dfc506e50b959f8c91d927cec7cc794f5f", + "incoming-relation-WikiTopicsQuery:tax": "92940ef98b13543f54d4e43f765e51d35aab803ab4e122b570bd27ed7a373433", + "qto-FB15k237LogicalQuery": "0d66aa3766e00bb38eb03d1945dae8040b031753f55a16922ed5454e0ebdc787", + "qto-NELL995LogicalQuery": "10d947a9870d943ce731cb64fcbf914b3c1a116c1affdebdeba101975272d0e2" + }, + "ultraquery/kgfm_adapters.json": { + "ultra-product-intersections-FB15k237LogicalQuery": "b7f024872516b9bbc02968b3afa41ffbe02fda98f7a61b92a587d099aa42b05f", + "ultra-product-intersections-FB15kLogicalQuery": "37fa9d6876b01a382ca198969511e42afc953da7763840e434356b4a67627c2a", + "ultra-product-intersections-NELL995LogicalQuery": "1c8074dd1de9fda420033c6bef9e3837bad2184636cc5f19f8ea70bc28ef3f96", + "ultra-product-intersections-InductiveFB15k237Query:106": "87c7ba8fdc0c61d8ec1cc2acfa27919c7682f9bd5d9ca279420a49e2992b56d7", + "ultra-product-intersections-InductiveFB15k237Query:113": "1e4d5067e04800bc8b3e86c3502aa27f2de884a8c94c98919bce51d633b0cb37", + "ultra-product-intersections-InductiveFB15k237Query:122": "9ec2c6949fe9358486082cc8079e93b0e0b461292e8682d3c05c78667dfdc99b", + "ultra-product-intersections-InductiveFB15k237Query:134": "eaff89cd2cf71ca069924f1b808e8fd29f16951191c8a68436571d24ced3d482", + "ultra-product-intersections-InductiveFB15k237Query:150": "b426d29a415af98a05851bae5dc16c90b37de10d7548398662408949e604ad32", + "ultra-product-intersections-InductiveFB15k237Query:175": "9778ebf4123dad98d51d9a48ddbf948865703efc6382eff6c3bb7a994aec9c5f", + "ultra-product-intersections-InductiveFB15k237Query:217": "f17b74708c32126a33f421d506bd7172606abe0ac3eaa4ac95c9881bed85da3c", + "ultra-product-intersections-InductiveFB15k237Query:300": "1e4667e72faee905cad2e021bd4717dc1aa285496422eada16a790ecbc2166bd", + "ultra-product-intersections-InductiveFB15k237Query:550": "29db5c01d7712b17ebe07dd13958bfdea1d379e552dedfcc12b407d4f37c098e", + "ultra-product-intersections-WikiTopicsQuery:art": "699d89e9fc1e676c745e3614bd04afec3de80e0c4005a126a829afc776f26d4a", + "ultra-product-intersections-WikiTopicsQuery:award": "4ef7835651fece94dff248a58db7000a89dff2f67231d7d69ebdf31f15a4bdea", + "ultra-product-intersections-WikiTopicsQuery:edu": "8170f4c5cb9714143c3d172537e26879a9e5b3aa2add6944a130ff5ef3292fe2", + "ultra-product-intersections-WikiTopicsQuery:health": "f3768f1968b3dd829a0028ca13e96e29157b0c091b3e536f7df2b2d3f06bba83", + "ultra-product-intersections-WikiTopicsQuery:infra": "1750cb01194aefca24a03d125d4b1c29ddb8a57ed6c834f93370835b3655a7b0", + "ultra-product-intersections-WikiTopicsQuery:loc": "d515e376f742826dc1fc0d45d8b047d5b16bd490c4291f36f25176b8d8a5edd0", + "ultra-product-intersections-WikiTopicsQuery:org": "58fc3260b53f2beb2536a3420b0c8ca81bd7856b9460f1e8dc3d4f518a1d9334", + "ultra-product-intersections-WikiTopicsQuery:people": "4f63bb7367dc685a1efeda42fb15d6e4c3e17f3e1ba84c123a2fb5a08eea79e5", + "ultra-product-intersections-WikiTopicsQuery:sci": "07896dd08a1e70badcca0b3aca16a553d2eb8dce877560aeee7a935bf77b10b7", + "ultra-product-intersections-WikiTopicsQuery:sport": "d02a3f11dcc1fa68ce5bdfb491d7f99bd3d23c3b9d8d7b8f7b63e604ae9d3520", + "ultra-product-intersections-WikiTopicsQuery:tax": "73d6cfa003d9a87c152367c3970d15934267583e5b94946fa137e952235e680f", + "trix-product-intersections-FB15k237LogicalQuery": "fd27d852fb1f09eff4aae25c3d9792ee4e79db94f816f120d1541edf8202b423", + "trix-product-intersections-FB15kLogicalQuery": "4fc028ffd5f035214a875de201f906e4ba7871eb5fbcbc6f3a47870fdb90bb4a", + "trix-product-intersections-NELL995LogicalQuery": "6bd7b036a128288b6187350c81c22d4ef32ce76d1bf86d55d0a9a20304770e13", + "trix-product-intersections-InductiveFB15k237Query:106": "df530e73b516ef9bbec728473f04182b62fb5b6938dc82f03bd98aed9e12470a", + "trix-product-intersections-InductiveFB15k237Query:113": "e9fe38062feded83a25e7d043f65efb72b34c4217fef9fc43a443511d873e9e9", + "trix-product-intersections-InductiveFB15k237Query:122": "a286cdad697c89631b0af783225d6e5a60e5ec0546d70dd3cd7d30c6015f9d7f", + "trix-product-intersections-InductiveFB15k237Query:134": "3a1dea4c930992e31f56f1e11a91604c7dbfaf4149e4152049185ee0bd2563a2", + "trix-product-intersections-InductiveFB15k237Query:150": "d9475a2c0fcbf344377a94416b280e9f47dd6e6a0a87fdeb99309362bb048083", + "trix-product-intersections-InductiveFB15k237Query:175": "485545e143d118b5e52cbd2ee2fe545904a8e07ec0444a600fa3b9ccf30cafd2", + "trix-product-intersections-InductiveFB15k237Query:217": "060957dac48e9d84250fb355c77e320b811b0afeed886d2546fef8aee0d6da24", + "trix-product-intersections-InductiveFB15k237Query:300": "b80c3d5aed48d51818f600ef082030ac27242ff0ecd40040a3288e553030ae8a", + "trix-product-intersections-InductiveFB15k237Query:550": "9b59854367c05e81398920e430e15b451294785b6887bcaa8276a0665f8bf7f1", + "trix-product-intersections-WikiTopicsQuery:art": "7c375b93e8045391c9ae585f5b12742f4ff3e52649dfec05cdfa29f9dafd9536", + "trix-product-intersections-WikiTopicsQuery:award": "4db5e7755f0422e5c4e834fa553abfd56cf660f33f954c1e104a810122a74e90", + "trix-product-intersections-WikiTopicsQuery:edu": "9f561a6e3f9294243df80c410e3af977feb0ab78b7c609857d71d53527224348", + "trix-product-intersections-WikiTopicsQuery:health": "9403ddc30a81fa9b03d3a5048c691588f98f55edbebd5e7c6074d3b52036e6bb", + "trix-product-intersections-WikiTopicsQuery:infra": "1188f0407bc57a617562ece83fa75787fd6a64df6200fadf13a5b71c8b8a85e9", + "trix-product-intersections-WikiTopicsQuery:loc": "3a68391770ce5faee466840b2fd0eaa68e985bdc9987850913e6a52f74ccff85", + "trix-product-intersections-WikiTopicsQuery:org": "c93762c407b778070aa576dd8e59cbdd7c2ff95b0d1dcde1d4fb1abc7a7dc9e2", + "trix-product-intersections-WikiTopicsQuery:people": "53190c3c7c971fecb60682ac6fdda4bcaa742f9da481faf3c56c1305669e6d33", + "trix-product-intersections-WikiTopicsQuery:sci": "50c1c0417641a3868b81c5b597636f129e58f79677bba148fca532254c5811f6", + "trix-product-intersections-WikiTopicsQuery:sport": "670bf147bd1a3f6a2027f87c7aefcb4da12b4e9ce5357b83c0bd7f2f11dab10c", + "trix-product-intersections-WikiTopicsQuery:tax": "afd681810b572d959993a34b9f382c1e5172c70734362870b9652161b6334d8f" + }, + "ultraquery/trained_baselines.json": { + "qto-FB15kLogicalQuery": "6f769ebd4a6f84d0f42a443486b2f0d778055201557996f01deec98417665cbe", + "inductive-gnnqe-InductiveFB15k237Query:106": "1fa57c57fae80e52dcde4de9dbcca48dc6dcd8b22639792aa2478d79daf530bd", + "inductive-gnnqe-InductiveFB15k237Query:113": "b77cbaa878b8ae58e5bd878a09df7c1d8a992eb8778ebb6deade5bf55a43845f", + "inductive-gnnqe-InductiveFB15k237Query:122": "149f13b82a1fb5466de8299340222b1bd6eab900a57d8ecee708b70ff3c76c6c", + "inductive-gnnqe-InductiveFB15k237Query:134": "97de3fe8f047d42b6ddad861ba4b809a384cece028e7074cda7177684dfc8c94", + "inductive-gnnqe-InductiveFB15k237Query:150": "2609eacb22e59fc0298f171fee0e4719c69fc371378093d3995b8bab873ae4fc", + "inductive-gnnqe-InductiveFB15k237Query:175": "72f4fcf6ce5744c505c51f0287d298c0e8fe3f5caf00037cf61e34e36b51bc6a", + "inductive-gnnqe-InductiveFB15k237Query:217": "b5e9faa1ec482b963b9e4aac10da6fc45d7aa107711359bf5142f68c2b7c1782", + "inductive-gnnqe-InductiveFB15k237Query:300": "e32809e684d3ce1e0adc5f1d07c123fb9223d84850ca7f1e284e1d8ebf75e234", + "inductive-gnnqe-InductiveFB15k237Query:550": "817f41685b53ecb8cbea82fb0640c79c12dccb70f23beda6dbdfade138951511" + } +} diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py new file mode 100644 index 000000000..e5daca7c6 --- /dev/null +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -0,0 +1,227 @@ +"""Paired calibration controls, shared logits, and crash-safe comparison traces.""" + +import subprocess +import sys + +import pytest +import torch + +from benchmarks.cqa import cli +from benchmarks.cqa.manifests import REPO, suite_directory +from benchmarks.cqa.reports import adapter_effects, export_reports, trace_queries +from benchmarks.cqa.study import freeze, read, run_job, write_json +from benchmarks.cqa.tests.test_protocol import paper_fixture, small_data, use_ultraquery_fixture +from dicee.query_answering.benchmark import evaluate_benchmark +from dicee.query_answering.context import state_fingerprint +from dicee.query_answering.engine import AtomicBatchCache, AtomicScorer + + +class BatchRows(torch.nn.Module): + num_entities, num_relations = 6, 1 + + def __init__(self): + super().__init__() + self.values = torch.nn.Parameter(torch.arange(36.).reshape(6, 6)) + self.calls = 0 + + def forward_k_vs_all(self, conditions): + self.calls += 1 + return self.values[conditions[:, 0]] + len(conditions) / 100 + + +def test_shared_atomic_cache_preserves_batches_and_invalidates_weights(): + model = BatchRows().eval() + cache = AtomicBatchCache(48) + first = AtomicScorer(model, row_batch_size=2, raw_cache=cache) + second = AtomicScorer(model, row_batch_size=2, raw_cache=cache) + pair = [(0, 0), (1, 0)] + expected = first.rows(pair) + reused = second.rows(pair) + assert torch.equal(expected, reused) and model.calls == 1 and cache.hits == 2 + reused.zero_() + assert torch.equal(second.rows(pair), expected) + # A singleton has different floating-point batch semantics in this fixture. + assert not torch.equal(second.rows(pair[:1])[0], expected[0]) + assert model.calls == 2 and cache.used <= 48 + first.rows(pair) + assert model.calls == 3 # The complete pair was evicted. + with torch.no_grad(): + model.values.add_(1) + assert torch.equal(second.rows(pair), expected + 1) + assert model.calls == 4 + + +def test_paired_resume_replays_both_variants_and_preserves_metrics(tmp_path): + data = small_data() + + def learned(query): + return torch.tensor([10., 8., 7., 6., 5., 4.]) + + def control(query): + return torch.tensor([10., 1., 2., 3., 4., 5.]) + + settings = dict(checkpoint_dir=tmp_path / 'progress', checkpoint_identity={'paired': True}, + checkpoint_every=2, rank_trace_path=tmp_path / 'ranks.sqlite3', additional_tie_policies=('expected',)) + + def fail(query): + if query[0] == 3: + raise RuntimeError('interrupted between variants') + return control(query) + + with pytest.raises(RuntimeError, match='between variants'): + evaluate_benchmark(data, learned, comparison_predictors={'without-adapter': fail}, **settings) + seen = [] + + def resume(query): + seen.append(query[0]) + return learned(query) + + result = evaluate_benchmark(data, resume, comparison_predictors={'without-adapter': control}, **settings) + assert seen == [2, 3, 4, 5] + assert result['per_shape'] == evaluate_benchmark(data, learned)['per_shape'] + assert result['comparisons']['without-adapter']['per_shape'] == evaluate_benchmark(data, control)['per_shape'] + left, right = tmp_path / 'ranks.sqlite3', tmp_path / 'without-adapter/ranks.sqlite3' + assert len(list(trace_queries(left))) == len(list(trace_queries(right))) == 6 + effects = adapter_effects(left, right, bootstrap_samples=10) + assert effects['macro']['expected']['mrr'] == pytest.approx(.75) + assert effects['macro']['expected']['mrr_ci95'] == pytest.approx([.75, .75]) + assert adapter_effects(left, left, bootstrap_samples=0)['macro']['sort']['mrr'] == 0 + + +@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +@pytest.mark.parametrize('facts,ultraquery', [(None, False), ('none', False), ('atomic', False), ('both', False), ('both', True)]) +def test_paired_kgfm_verification_full_run_and_reports(tmp_path, backbone, facts, ultraquery): + from dicee.models import TRIX, ULTRA + from dicee.query_answering.score_adapter import QueryScoreAdapter + manifest = paper_fixture(tmp_path) + if ultraquery: + use_ultraquery_fixture(manifest, tmp_path) + count = len(manifest['entries'][0]['query_types']) + model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) + torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + QueryScoreAdapter('context_scores', 1., bias_bound=8., + weights=torch.randn(2, 8, generator=torch.Generator().manual_seed(4)).double() / 5, + metadata={'backbone_state_sha256': state_fingerprint(model)}).save(tmp_path / 'adapter.json') + entry = manifest['entries'][0] + entry.update(id=f'{backbone}-paired', method=f'{backbone}-adapter', checkpoint='kgfm.pt', + options={'beam_size': 2, 'row_batch_size': 1, 'backend_batch_size': 1, 'cache_bytes': 4096, 'raw_cache_bytes': 4096}, + adapters={'product': 'adapter.json'}, operators={shape: 'product' for shape in entry['query_types']}, + selection_protocol='source-validation', finalized=True, adapter_ablation=True, + query_batch_size=4, query_order='relation') + if facts is not None: + entry['options']['observed_facts'] = facts + if ultraquery: + entry['options'].update(raw_cache_device='model', relation_cache_mb=1, projection_cache_mb=1) + freeze(manifest, tmp_path / 'bundle', tmp_path) + subprocess.run([sys.executable, '-m', 'benchmarks.cqa', 'plus_h', 'integration', '--bundle', str(tmp_path / 'bundle'), + '--input-root', str(tmp_path), '--entry', entry['id'], '--output', str(tmp_path / 'verification'), + '--device', 'cpu', '--probes', '1'], check=True, cwd=REPO) + evidence = read(tmp_path / 'verification/integration.json') + assert evidence['passed'] and len(evidence['queries']) == count * 2 + entry['verification'] = 'verification/integration.json' + freeze(manifest, tmp_path / 'verified-bundle', tmp_path) + result = run_job(tmp_path / 'verified-bundle', entry['id'], tmp_path, tmp_path / 'test', phase='test') + control = read(tmp_path / 'test/without-adapter/result.json') + assert result['queries'] == control['queries'] == count + assert result['inference']['cache_statistics']['backbone_reused_rows'] > 0 + assert control['paired_with'] == entry['id'] + assert control['inference']['calibration'] == 'without-adapter' + settings = result['inference']['observed_facts'] + assert settings == control['inference']['observed_facts'] + assert settings['atomic_mix'] == {'product': float(facts != 'none')} + assert settings['restore_answers'] == (facts in (None, 'both')) + assert read(tmp_path / 'adapter.json')['observed_mix'] == 1 + assert run_job(tmp_path / 'verified-bundle', entry['id'], tmp_path, tmp_path / 'test', phase='test') == result + rows = export_reports(tmp_path / 'test', suite_directory('plus_h') / 'published_results.json', tmp_path / 'reports', bootstrap_samples=10) + assert len(rows) == 2 and all(row['complete_test'] for row in rows) + assert all(row['complete_16_type_test'] == (not ultraquery) for row in rows) + assert all(row['observed_facts'] == settings for row in rows) + assert len(read(tmp_path / 'reports/adapter-effects.json')) == 1 + if ultraquery: + write_json(tmp_path / 'manifest.json', manifest) + args = ['ultraquery', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + '--output', str(tmp_path / 'cli'), '--entries', entry['id'], '--split', 'test', '--device', 'cpu'] + cli.main(args) + direct = read(tmp_path / 'cli' / entry['id'] / 'result.json') + direct_control = read(tmp_path / 'cli' / entry['id'] / 'without-adapter/result.json') + assert direct['per_shape'] == result['per_shape'] + assert direct_control['per_shape'] == control['per_shape'] + cli.main(args) + assert read(tmp_path / 'cli' / entry['id'] / 'result.json')['per_shape'] == direct['per_shape'] + (tmp_path / 'test/without-adapter/result.json').write_text('{}') + with pytest.raises(ValueError, match='comparison checksum'): + run_job(tmp_path / 'verified-bundle', entry['id'], tmp_path, tmp_path / 'test', phase='test') + + +def test_graph_effects_pair_calibrations_and_reject_changed_recipes(tmp_path): + from dataclasses import replace + + from dicee.query_answering.method_evaluation import save_results + results = tmp_path / 'results' + for graph, scores in [('train', [10., 1., 2., 3., 4., 5.]), ('train+valid', [10., 8., 7., 6., 5., 4.])]: + data = replace(small_data(), name='FB15k237+H', split='test', + metadata=dict(inference_graph=graph, expected_query_types=['1p'])) + destination = results / graph + report = evaluate_benchmark(data, lambda query: torch.tensor(scores), + comparison_predictors={'without-adapter': lambda query: torch.zeros(6)}, + checkpoint_dir=destination / 'progress', checkpoint_identity={'fixture': graph}, + rank_trace_path=destination / 'ranks.sqlite3', additional_tie_policies=('expected',)) + report['inference'] = dict(method='ultra-adapter', calibration='learned') + report['comparisons']['without-adapter']['inference'] = dict(method='ultra-adapter', calibration='without-adapter') + save_results(report, destination, run=dict(entry=graph, phase='test'), + metadata=dict(reference={}, graph_ablation='paired', graph_recipe_sha256='same')) + export_reports(results, None, tmp_path / 'reports', bootstrap_samples=10) + effects = {row['calibration']: row for row in read(tmp_path / 'reports/graph-effects.json')} + assert len(read(tmp_path / 'reports/adapter-effects.json')) == 2 + assert effects['learned']['macro']['expected']['mrr'] == pytest.approx(.75) + assert effects['without-adapter']['macro']['expected']['mrr'] == 0 + target = results / 'train+valid/result.json' + value = read(target) + value['graph_recipe_sha256'] = 'changed' + write_json(target, value) + with pytest.raises(ValueError, match='Graph ablation changed'): + export_reports(results, None, tmp_path / 'invalid', bootstrap_samples=0) + + +def test_filter_controls_share_predictions_and_resume_all_traces(tmp_path, monkeypatch): + from dataclasses import replace + + from dicee.query_answering._checkpoint import BenchmarkCheckpoint + from dicee.query_answering.method_evaluation import save_results + calls = [] + data = replace(small_data(), metadata={'expected_query_types': ['1p']}) + def predict(query): + calls.append(query) + return torch.tensor([10., 8., 7., 6., 5., 4.]) + options = dict(checkpoint_dir=tmp_path / 'progress', checkpoint_identity={'fixed': True}, + checkpoint_every=2, rank_trace_path=tmp_path / 'ranks.sqlite3', + additional_tie_policies=('expected',), comparison_predictors={'without-adapter': predict}, + filter_corrections={q.query: frozenset() for q in data.queries}) + original = BenchmarkCheckpoint.save + def fail_after_commit(self, state): + if state['completed'] == 4: + raise RuntimeError('interrupted filter control') + return original(self, state) + monkeypatch.setattr(BenchmarkCheckpoint, 'save', fail_after_commit) + with pytest.raises(RuntimeError, match='interrupted filter control'): + evaluate_benchmark(data, predict, **options) + monkeypatch.setattr(BenchmarkCheckpoint, 'save', original) + calls.clear() + report = evaluate_benchmark(data, predict, **options) + assert len(calls) == 8 # Four remaining queries, two predictors, both filters each. + assert report['averages']['all']['mrr'] == .5 + assert report['comparisons']['released-filters']['averages']['all']['mrr'] == 1. + for name, result in [(None, report), *report['comparisons'].items()]: + result['inference'] = dict(method='ultra-adapter', calibration='without-adapter' if name and name.startswith('without-adapter') else 'learned') + save_results(report, tmp_path, run={'entry': 'paired', 'phase': 'pilot'}, metadata={'reference': {}}) + rows = export_reports(tmp_path, None, tmp_path / 'reports', bootstrap_samples=10) + assert len(rows) == 4 + assert len(read(tmp_path / 'reports/adapter-effects.json')) == 2 + filters = read(tmp_path / 'reports/filter-effects.json') + assert len(filters) == 2 + assert all(row['macro']['expected']['mrr'] == -.5 for row in filters) + for name in ('', 'without-adapter', 'released-filters', 'without-adapter-released-filters'): + assert len(list(trace_queries(tmp_path / name / 'ranks.sqlite3'))) == 6 + options['filter_corrections'] = {} + with pytest.raises(ValueError, match='inputs/settings changed'): + evaluate_benchmark(data, predict, **options) diff --git a/benchmarks/cqa/tests/test_comparison_baselines.py b/benchmarks/cqa/tests/test_comparison_baselines.py new file mode 100644 index 000000000..e2361ba3b --- /dev/null +++ b/benchmarks/cqa/tests/test_comparison_baselines.py @@ -0,0 +1,279 @@ +"""Missing baseline integration, resume-safe heuristic and author training parity.""" + +import copy +import json +import os +import pickle +import subprocess +import sys +from pathlib import Path + +import pytest +import torch + +from benchmarks.cqa import cli +from benchmarks.cqa.evaluate import evaluate_manifest +from benchmarks.cqa.manifests import REPO, prepare_manifest, read_manifest, validate_entry +from benchmarks.cqa.oracles import verify_predictions +from benchmarks.cqa.study import freeze, run_job +from benchmarks.cqa.tests.test_ultraquery_launcher import PUBLIC, fixture +from benchmarks.cqa.train import verify_v2 +from dicee.query_answering import QueryContext, load_benchmark +from dicee.query_answering._checkpoint import checksum +from dicee.query_answering.methods import load_method +from dicee.query_answering.methods.heuristic import IncomingRelationHeuristic + +EXPORTER = REPO / 'benchmarks/cqa/verification/export_reference.py' + + +def test_comparison_recipes_cover_published_families(): + m = prepare_manifest([PUBLIC / 'comparisons.json', PUBLIC / 'trained_baselines.json'], + suite='ultraquery', answer_filter='released') + counts = {} + for e in m['entries']: + validate_entry(e) + counts[e['method']] = counts.get(e['method'], 0) + 1 + assert counts == {'ultraquery-lp': 46, 'incoming-relation': 11, 'qto': 3, 'inductive-gnnqe': 9} + thresholds = {e['dataset']: e['options']['threshold'] for e in m['entries'] + if e['method']=='ultraquery-lp' and '-no-threshold-' not in e['id']} + assert thresholds['NELL995LogicalQuery'] == .97 + assert all(value == (.97 if name=='NELL995LogicalQuery' else .8) for name,value in thresholds.items()) + assert all('2404.07198v2' in e['reference']['settings'] for e in m['entries'] if e['method']=='ultraquery-lp') + + +def test_heuristic_ignores_heads_and_random_order_is_subset_batch_resume_stable(): + context = QueryContext([(0, 0, 1), (2, 0, 3), (1, 1, 2)], 5, 2) + m = IncomingRelationHeuristic(context, seed=19) + a, b = (0, (0,)), (4, (0,)) + classes = m.membership_batch([('project', 0, ('anchor', 0)), ('project', 0, ('anchor', 4))]) + assert torch.equal(classes[0], classes[1]) + assert classes[0].tolist() == [0., 1., 0., 1., 0.] + scores = m.predict_batch([a, b]) + assert torch.equal(scores[0], m.predict(a)) and torch.equal(scores[1], m.predict(b)) + torch.rand(100) + assert torch.equal(scores, m.predict_batch([a, b])) + assert torch.equal(scores.flip(0), m.predict_batch([b, a])) + assert (scores[:, [1, 3]].min() > scores[:, [0, 2, 4]].max()) + assert not torch.equal(scores, IncomingRelationHeuristic(context, seed=20).predict_batch([a, b])) + + +def test_v2_gate_rejects_unknown_or_missing_training_inputs(tmp_path): + with pytest.raises(ValueError, match='Missing v2'): + verify_v2(tmp_path, '106') + (tmp_path / 'train_graph.txt').write_text('0 0 1\n') + with pytest.raises(ValueError): + verify_v2(tmp_path, '106') + + +def test_train_selection_cpu_and_no_writes_in_dry_run(tmp_path, capsys): + cli.main(['ultraquery', 'train', '--methods', 'inductive-gnnqe', '--datasets', 'InductiveFB15k237Query:106', + '--output', str(tmp_path / 'models'), '--dry-run']) + plan = json.loads(capsys.readouterr().out) + assert plan['device']=='cpu' and len(plan['jobs'])==1 + assert not (tmp_path / 'models').exists() + for suite, selection in (('ultraquery', ['--methods', 'qto', '--datasets', 'WikiTopicsQuery:art']), ('plus_h', ['--methods', 'qto'])): + with pytest.raises(SystemExit): + cli.main([suite, 'train', *selection, '--output', str(tmp_path), '--dry-run']) + + +def test_docker_train_defaults_to_cpu(tmp_path, capsys): + args = ['ultraquery', 'train', '--image', 'test', '--input-root', str(tmp_path), '--output', str(tmp_path / 'models'), + '--methods', 'qto', '--datasets', 'FB15kLogicalQuery', '--dry-run'] + cli.main(args) + out = capsys.readouterr().out + assert '--gpus' not in out and 'nvidia.com/gpu' not in out + assert 'test ultraquery train --input-root /inputs --output /results' in out + assert '--manifest-output-root /inputs/models' in out + with pytest.raises(SystemExit): + cli.main([*args, '--device', 'cuda']) + + +def trained_fixture(root): + manifest=fixture(root,'FB15kLogicalQuery') + entry=copy.deepcopy(next(e for e in read_manifest(PUBLIC/'trained_baselines.json')['entries'] + if e['method']=='qto')) + entry.update(checkpoint='model.pt',training='training.json') + manifest['entries']=[entry] + folder=root/'data/FB15k-betae' + (folder/'valid.txt').write_text('0\t0\t3\n') + (folder/'test.txt').write_text('1\t2\t3\n') + torch.save({'embeddings.0.weight':torch.zeros(8,16),'embeddings.1.weight':torch.zeros(4,16)},root/'model.pt') + record=dict(version=1,status='complete',method='qto',dataset=entry['dataset'],profile='smoke',dataset_release='fixture', + checkpoint_sha256=checksum(root/'model.pt'), + inputs={p.name:checksum(p) for p in folder.iterdir() if p.is_file()}) + (root/'training.json').write_text(json.dumps(record)) + return manifest,record,folder + + +@pytest.mark.parametrize('profile,release',[('smoke','fixture'),('fixture','fixture'),('custom','fixture')]) +def test_shipped_manifest_cannot_promote_smoke_or_fixture_weights(tmp_path,profile,release): + manifest,record,_=trained_fixture(tmp_path) + record.update(profile=profile,dataset_release=release) + (tmp_path/'training.json').write_text(json.dumps(record)) + assert manifest['entries'][0]['blockers']==[] + freeze(manifest,tmp_path/'bundle',tmp_path) + with pytest.raises(ValueError,match='smoke/fixture training checkpoint'): + run_job(tmp_path/'bundle',manifest['entries'][0]['id'],tmp_path,tmp_path/'final',phase='test') + pilot=run_job(tmp_path/'bundle',manifest['entries'][0]['id'],tmp_path,tmp_path/'pilot',phase='pilot') + assert pilot['queries']==14 + + +@pytest.mark.parametrize('changed_file',['id2ent.pkl','id2rel.pkl','train.txt','valid.txt','test.txt','test-hard-answers.pkl']) +def test_training_input_changes_rejected_by_freeze_and_direct_evaluation(tmp_path,changed_file): + manifest,_,folder=trained_fixture(tmp_path) + path=folder/changed_file + if changed_file.startswith('id2'): + mapping=pickle.loads(path.read_bytes()) + mapping[0],mapping[1]=mapping[1],mapping[0] + path.write_bytes(pickle.dumps(mapping)) + else: + path.write_bytes(path.read_bytes()+b'\n') + with pytest.raises(ValueError,match='Training input differs'): + freeze(manifest,tmp_path/'bundle',tmp_path) + with pytest.raises(ValueError,match='Training input differs'): + evaluate_manifest(manifest,input_root=tmp_path,output=tmp_path/'direct') + assert not (tmp_path/'direct').exists() + + +@pytest.mark.parametrize('missing',['training','input','profile']) +def test_required_training_bindings_cannot_be_omitted(tmp_path,missing): + manifest,record,_=trained_fixture(tmp_path) + if missing=='training': + del manifest['entries'][0]['training'] + elif missing=='input': + del record['inputs']['id2ent.pkl'] + else: + del record['profile'] + (tmp_path/'training.json').write_text(json.dumps(record)) + with pytest.raises(ValueError,match='Training provenance'): + freeze(manifest,tmp_path/'bundle',tmp_path) + with pytest.raises(ValueError,match='Training provenance'): + evaluate_manifest(manifest,input_root=tmp_path,output=tmp_path/'direct') + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_INDUCTIVE_REFERENCE_ROOT'), reason='Author dependencies and clean checkout required') +@pytest.mark.parametrize('method', ['incoming-relation', 'inductive-gnnqe', 'ultraquery-lp', 'qto']) +def test_author_training_export_parity_and_verified_execution(tmp_path, method): + name = ('WikiTopicsQuery:art' if method=='incoming-relation' else 'InductiveFB15k237Query:106' + if method=='inductive-gnnqe' else 'FB15kLogicalQuery') + manifest = fixture(tmp_path, name) + e = manifest['entries'][0] + e['method'], e['id'] = method, method+'-fixture' + if method=='incoming-relation': + (tmp_path / 'heuristic.json').write_bytes((PUBLIC / 'heuristic.json').read_bytes()) + e.update(checkpoint='heuristic.json', options={}) + elif method=='ultraquery-lp': + # The actual released LP weights, rather than a synthetic query checkpoint. + (tmp_path/'lp.pt').write_bytes((REPO / 'Experiments/query-baselines/upstream/ultra/ckpts/ultra_3g.pth').read_bytes()) + e['checkpoint']='lp.pt' + e['options']['threshold']=.8 + else: + e.update(copy.deepcopy(next(row for row in read_manifest(PUBLIC/'trained_baselines.json')['entries'] + if row['method']==method and row['dataset']==name))) + folder = tmp_path / 'data' / ('106' if method=='inductive-gnnqe' else 'FB15k-betae') + if method=='inductive-gnnqe': + queries=pickle.loads((folder/'valid_queries.pkl').read_bytes()) + (folder/'train_queries.pkl').write_bytes(pickle.dumps(queries)) + answers={s:{q:{1} for q in group} for s,group in queries.items()} + (folder/'train_answers_hard.pkl').write_bytes(pickle.dumps(answers)) + else: + (folder/'valid.txt').write_text('0\t0\t3\n') + (folder/'test.txt').write_text('1\t2\t3\n') + source = Path(os.environ['DICEE_INDUCTIVE_REFERENCE_ROOT']) if method=='inductive-gnnqe' else REPO/'Experiments/query-baselines/upstream/qto' + checkout = tmp_path/'Experiments/query-baselines/upstream'/('inductiveqe' if method=='inductive-gnnqe' else 'qto') + checkout.parent.mkdir(parents=True) + checkout.symlink_to(source, target_is_directory=True) + subprocess.run([sys.executable,'-m','benchmarks.cqa','ultraquery','train','--methods',method, + '--datasets',name,'--input-root',str(tmp_path),'--data-root','data', + '--output',str(tmp_path/'trained'),'--smoke'],check=True) + training=tmp_path/'trained'/f'{method}-{name}' + e['checkpoint']=str(training/'checkpoint.pt') + metadata=json.loads((training/'training.json').read_text()) + assert metadata['status']=='complete' and metadata['profile']=='smoke' and metadata['updates']==1 + assert metadata['checkpoint_selection']=='validation MRR only' + generated=json.loads((training/'manifest.json').read_text()) + assert generated['data_root']=='data' and generated['threads']==2 + assert generated['entries'][0]['blockers'] + assert (tmp_path/generated['entries'][0]['checkpoint']).is_file() + assert (tmp_path/generated['entries'][0]['training']).is_file() + e['training']=generated['entries'][0]['training'] + freeze(generated,tmp_path/'smoke-bundle',tmp_path) + with pytest.raises(ValueError,match='not ready for final testing'): + run_job(tmp_path/'smoke-bundle',generated['entries'][0]['id'],tmp_path,tmp_path/'blocked',phase='test') + changed=dict(metadata,checkpoint_sha256='0'*64) + (training/'training.json').write_text(json.dumps(changed)) + with pytest.raises(ValueError,match='Training provenance'): + freeze(generated,tmp_path/'invalid-training',tmp_path) + (training/'training.json').write_text(json.dumps(metadata)) + evaluate_manifest(generated,input_root=tmp_path,output=tmp_path/'direct',split='valid',limit=1) + result=json.loads((tmp_path/'direct'/generated['entries'][0]['id']/'result.json').read_text()) + assert result['inference']['paper_protocol']['training']['profile']=='smoke' + e['options']={'logic':'product'} if method=='inductive-gnnqe' else { + 'threshold':.001,'negation_scale':6,'cache_bytes':2**20,'row_batch_size':100} + context=load_benchmark(tmp_path/'data',name,split='valid').context + native=load_method(method,e['checkpoint'],context,**e['options']) + if method=='inductive-gnnqe': + assert native.provenance['checkpoint_graph_buffers']['train_graph']['training_facts_verified'] + from benchmarks.cqa.train import compatibility + compatibility() + from torchdrug.data import Graph + with torch.serialization.safe_globals([Graph]): + state=torch.load(e['checkpoint'],weights_only=True) + del state['model']['train_graph'] + torch.save(state,tmp_path/'incomplete.pt') + with pytest.raises(ValueError,match='Missing inductive checkpoint graph'): + load_method(method,tmp_path/'incomplete.pt',context,**e['options']) + freeze(manifest,tmp_path/'bundle',tmp_path) + source = (Path(os.environ['DICEE_INDUCTIVE_REFERENCE_ROOT']) if method in ('incoming-relation','inductive-gnnqe') + else REPO/'Experiments/query-baselines/upstream'/('qto' if method=='qto' else 'ultra')) + subprocess.run([sys.executable,str(EXPORTER),'--bundle',str(tmp_path/'bundle'), + '--input-root',str(tmp_path),'--entry',e['id'],'--upstream',str(source), + '--device','cpu','--output',str(tmp_path/'reference.pt')],check=True) + evidence=verify_predictions(tmp_path/'bundle',e['id'],tmp_path,tmp_path/'reference.pt',tmp_path/'evidence.json') + assert evidence['passed'] and len(evidence['queries'])==14, json.dumps(evidence) + e['verification']='evidence.json' + freeze(manifest,tmp_path/'verified',tmp_path) + if method in ('qto','inductive-gnnqe'): + # Even successful independent parity cannot promote genuine one-update + # smoke weights through the shipped manifest's empty blocker list. + assert e['blockers']==[] + with pytest.raises(ValueError,match='smoke/fixture training checkpoint'): + run_job(tmp_path/'verified',e['id'],tmp_path,tmp_path/'test',phase='test') + report=run_job(tmp_path/'verified',e['id'],tmp_path,tmp_path/'pilot',phase='pilot') + else: + report=run_job(tmp_path/'verified',e['id'],tmp_path,tmp_path/'test',phase='test') + assert report['coverage']['complete_benchmark_types'] + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_INDUCTIVE_REFERENCE_ROOT'),reason='Author runtime required') +def test_qto_training_consumes_exact_epochs(tmp_path): + fixture(tmp_path,'FB15kLogicalQuery') + folder=tmp_path/'data/FB15k-betae' + (folder/'valid.txt').write_text('0\t0\t3\n') + (folder/'test.txt').write_text('1\t2\t3\n') + checkout=tmp_path/'Experiments/query-baselines/upstream/qto' + checkout.parent.mkdir(parents=True) + checkout.symlink_to(REPO/'Experiments/query-baselines/upstream/qto',target_is_directory=True) + subprocess.run([sys.executable,'-m','benchmarks.cqa','ultraquery','train', + '--methods','qto','--datasets','FB15kLogicalQuery','--input-root',str(tmp_path), + '--data-root','data','--output',str(tmp_path/'trained'), + '--epochs','2','--batch-size','2'],check=True) + record=json.loads((tmp_path/'trained/qto-FB15kLogicalQuery/training.json').read_text()) + assert record['updates']==6 # Six triples, three batches per epoch, two epochs. + assert record['best_epoch']==1 # Retain the authors' e % valid == 0 schedule. + assert record['profile']=='custom' and record['status']=='complete' + manifest=json.loads((tmp_path/'trained/qto-FB15kLogicalQuery/manifest.json').read_text()) + entry=manifest['entries'][0] + freeze(manifest,tmp_path/'bundle',tmp_path) + subprocess.run([sys.executable,str(EXPORTER),'--bundle',str(tmp_path/'bundle'), + '--input-root',str(tmp_path),'--entry',entry['id'], + '--upstream',str(REPO/'Experiments/query-baselines/upstream/qto'), + '--device','cpu','--output',str(tmp_path/'reference.pt')],check=True) + evidence=verify_predictions(tmp_path/'bundle',entry['id'],tmp_path,tmp_path/'reference.pt',tmp_path/'evidence.json') + assert evidence['passed'] + entry['verification']='evidence.json' + freeze(manifest,tmp_path/'verified',tmp_path) + report=run_job(tmp_path/'verified',entry['id'],tmp_path,tmp_path/'test',phase='test') + assert report['protocol']['full_split'] diff --git a/benchmarks/cqa/tests/test_cqd_reference.py b/benchmarks/cqa/tests/test_cqd_reference.py new file mode 100644 index 000000000..8441dac2a --- /dev/null +++ b/benchmarks/cqa/tests/test_cqd_reference.py @@ -0,0 +1,74 @@ +"""Optional independent CQD oracle tests. + +Set DICEE_CQD_REFERENCE to the pinned upstream checkout (d1ce74164936a7c09d9147e83190da047cb39429). +No DICE package or repository-local model fixtures are needed. Tolerance here +quantifies partition rounding against the dense upstream profile; it does not +change the exported profile's score/ranking/tie verification gates. +""" + +import importlib.util +import inspect +import os +from pathlib import Path +from unittest.mock import patch + +import pytest +import torch + +QUERIES = {'1p': [0, 0], '2p': [0, 0, 2], '3p': [0, 0, 2, 1], '4p': [0, 0, 2, 1, 3], + '2i': [0, 0, 1, 2], '3i': [0, 0, 1, 2, 2, 1], '4i': [0, 0, 1, 2, 2, 1, 3, 3], + 'ip': [0, 0, 1, 2, 2], 'pi': [0, 0, 2, 1, 2], '2u': [0, 0, 1, 2, -1], 'up': [0, 0, 1, 2, -1, 2]} + + +@pytest.fixture(scope='module') +def reference(): + checkout = os.environ.get('DICEE_CQD_REFERENCE') + if not checkout: + pytest.skip('Set DICEE_CQD_REFERENCE to the optional pinned CQD checkout') + with pytest.MonkeyPatch.context() as monkeypatch: + monkeypatch.syspath_prepend(checkout) + from cqd import discrete + from cqd.base import CQD + path = Path(__file__).resolve().parents[1] / 'verification' / 'reference_cqd.py' + spec = importlib.util.spec_from_file_location('bounded_cqd_reference', path) + helper = importlib.util.module_from_spec(spec) + spec.loader.exec_module(helper) + yield CQD, discrete, helper + + +@pytest.mark.parametrize('hybrid', [False, True]) +@pytest.mark.parametrize('tnorm', ['prod', 'min']) +@pytest.mark.parametrize('batch_size', [2, 32]) +def test_positive_shapes_against_upstream(reference, hybrid, tnorm, batch_size): + CQD, source, helper = reference + filters = {(0, 0): [1, 2], (1, 2): [3], (2, 2): [4], (3, 0): [5], (5, 2): [6], (4, 0): [0]} + model = CQD(11, 4, 7, k=3, max_k=5, max_norm=.9 if hybrid else 1., filters=filters, + do_normalize=True, t_norm_name=tnorm).eval() + generator = torch.Generator().manual_seed(107) + with torch.no_grad(): + for parameter in model.parameters(): + parameter.copy_(torch.randn(parameter.shape, generator=generator)) + + def scoring(lhs, relation, rhs): + values = model.score_o(lhs, relation, rhs)[0] + return model.max_norm * (values - values.min()) / (values.max() - values.min()) + + for shape, flat in QUERIES.items(): + queries = torch.tensor([flat]) + function = getattr(source, 'query_' + {'2u': '2u_dnf', 'up': 'up_dnf'}.get(shape, shape)) + arguments = dict(entity_embeddings=model.embeddings[0], predicate_embeddings=model.embeddings[1], + queries=queries, filters=filters, k=model.k, max_k=model.max_k, max_norm=model.max_norm, + scoring_function=scoring, t_norm=torch.mul if tnorm == 'prod' else torch.minimum, + t_conorm=(lambda a, b: 1 - (1 - a) * (1 - b)) if tnorm == 'prod' else torch.maximum) + expected = function(**{name: arguments[name] for name in inspect.signature(function).parameters}) + with patch.object(model, 'score_o', wraps=model.score_o) as calls: + actual = helper.query_bounded(model, source, shape, queries, batch_size) + assert all(call.args[0].shape[0] <= batch_size for call in calls.call_args_list) + torch.testing.assert_close(actual, expected, atol=1e-6, rtol=1e-6, msg=(shape, hybrid, tnorm, batch_size)) + assert torch.equal(actual, helper.query_bounded(model, source, shape, queries, batch_size)) + + +def test_rejects_multiple_query_batches(reference): + _, source, helper = reference + with pytest.raises(ValueError, match='one query'): + helper.query_bounded(None, source, '1p', torch.zeros(2, 2, dtype=torch.long), 32) diff --git a/benchmarks/cqa/tests/test_download_inputs.py b/benchmarks/cqa/tests/test_download_inputs.py new file mode 100644 index 000000000..c382c92e2 --- /dev/null +++ b/benchmarks/cqa/tests/test_download_inputs.py @@ -0,0 +1,213 @@ +"""Input setup must be selective, bounded, and preserve immutable inputs.""" + +import hashlib +import io +import json +import stat +import subprocess +import sys +import zipfile + +import pytest + +from benchmarks.cqa import cli, docker, inputs +from benchmarks.cqa.manifests import REPO, SUITES, default_recipes, prepare_manifest + +DATASET = {'plus_h': 'FB15k237+H', 'ultraquery': 'WikiTopicsQuery:art'} + + +def recipes(suite, **selection): + return prepare_manifest(default_recipes(suite), suite=suite, answer_filter=SUITES[suite]['answer_filter'], **selection) + + +def test_setup_plan_downloads_only_selected_methods_and_datasets(): + jobs, weights = inputs.plan(recipes('plus_h', methods=['cqd', 'cqd-hybrid'], datasets=['NELL995+H']), 'plus_h') + assert len(jobs) == 1 + assert list(jobs[0]['folders']) == ['iscqa-compl-benchmarks/new_benchmarks/NELL995+H'] + assert weights == ['checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint'] + manifest = recipes('ultraquery', methods=['ultra-adapter'], datasets=['WikiTopicsQuery:art', 'InductiveFB15k237Query:106']) + jobs, weights = inputs.plan(manifest, 'ultraquery') + assert [job['id'] for job in jobs] == ['ultra-inductive-106', 'ultra-wikitopics'] + assert list(jobs[1]['folders']) == ['WikiTopics_QE/art'] + assert weights == ['checkpoints/ultra_3g.pth'] + with pytest.raises(ValueError): + recipes('plus_h', methods=['misspelled']) + + +def test_plus_h_plan_includes_every_released_report_category_and_corrected_filter(): + from benchmarks.cqa.difficulty import REDUCTIONS + required = inputs.plus_h_files() + for shape, labels in REDUCTIONS.items(): + for label in labels: + assert f'test-query-reduction/{shape}/{label}/test-hard-answers.pkl' in required + assert 'test-query-reduction/2in/all/test-easy-answers.pkl' in required + assert 'test-query-reduction/pni/all/test-hard-answers.pkl' in required + icews = inputs.plus_h_files(True) + assert 'KG_splits/test.txt' in icews and 'test.txt' not in icews + assert not any(name.startswith('test-query-reduction') for name in icews) + + +def test_streamed_download_rejects_bad_hash_without_touching_existing_input(tmp_path): + source = tmp_path / 'source' + source.write_bytes(b'official bytes') + target = tmp_path / 'checkpoint' + expected = hashlib.sha256(source.read_bytes()).hexdigest() + inputs.download(source.as_uri(), target, expected) + assert target.read_bytes() == b'official bytes' + source.write_bytes(b'corrupted download') + with pytest.raises(ValueError, match='SHA-256'): + inputs.download(source.as_uri(), target, expected) + assert target.read_bytes() == b'official bytes' + assert not list(tmp_path.glob('.input-*')) + with pytest.raises(ValueError, match='refusing to replace'): + inputs.install(io.BytesIO(b'different input'), target) + assert target.read_bytes() == b'official bytes' + + +def test_interrupted_stream_never_installs_partial_input_and_reads_are_bounded(tmp_path): + class Broken: + calls = 0 + + def read(self, size): + assert size == inputs.CHUNK + self.calls += 1 + if self.calls == 2: + raise OSError('connection dropped') + return b'partial' + + with pytest.raises(OSError, match='connection dropped'): + inputs.install(Broken(), tmp_path / 'checkpoint') + assert not list(tmp_path.iterdir()) + + +@pytest.mark.parametrize('unsafe', ['../escape', '/absolute', 'symlink']) +def test_archive_is_validated_before_any_file_is_installed(tmp_path, unsafe): + archive = tmp_path / 'data.zip' + with zipfile.ZipFile(archive, 'w') as zipped: + zipped.writestr('valid.txt', b'valid') + if unsafe == 'symlink': + member = zipfile.ZipInfo('symlink') + member.external_attr = (stat.S_IFLNK | 0o777) << 16 + zipped.writestr(member, '../escape') + else: + zipped.writestr(unsafe, b'unsafe') + root = tmp_path / 'inputs' + root.mkdir() + with pytest.raises(ValueError, match='Unsafe|Symlink'): + inputs.extract(archive, root, lambda name: name if name == 'valid.txt' else None) + assert not list(root.iterdir()) + + +def test_complete_public_inputs_do_not_contact_network_and_install_shipped_adapter(tmp_path, monkeypatch): + manifest = recipes('ultraquery', methods=['ultra-adapter'], datasets=['WikiTopicsQuery:art']) + jobs, weights = inputs.plan(manifest, 'ultraquery') + for job in jobs: + for name in inputs.missing_files(tmp_path, job): + path = tmp_path / name + path.parent.mkdir(parents=True, exist_ok=True) + path.write_bytes(b'existing labels') + weight = tmp_path / weights[0] + weight.parent.mkdir(parents=True, exist_ok=True) + weight.write_bytes(b'weight fixture') + monkeypatch.setitem(inputs.WEIGHT_HASHES, weights[0], inputs.digest(weight)) + monkeypatch.setattr(inputs, 'download', lambda *a, **kw: pytest.fail('Unexpected network request')) + inputs.ensure_inputs(manifest, tmp_path, suite='ultraquery') + adapter = next(iter(manifest['entries'][0]['adapters'].values())) + assert (tmp_path / adapter).read_bytes() == (REPO / adapter).read_bytes() + inputs.ensure_inputs(manifest, tmp_path, suite='ultraquery', download_missing=False) + + +def test_custom_labels_are_not_mixed_with_public_data_and_missing_custom_weights_fail(tmp_path, monkeypatch): + manifest = recipes('plus_h', methods=['cqd'], datasets=['FB15k237+H']) + manifest['archives'] = {} + manifest['entries'][0]['checkpoint'] = 'my-model.pt' + monkeypatch.setattr(inputs, 'download', lambda *a, **kw: pytest.fail('Unexpected download for custom inputs')) + with pytest.raises(ValueError, match='custom checkpoint'): + inputs.ensure_inputs(manifest, tmp_path, suite='plus_h') + (tmp_path / 'my-model.pt').write_bytes(b'custom weights') + inputs.ensure_inputs(manifest, tmp_path, suite='plus_h') + assert not (tmp_path / manifest['data_root']).exists() + + +@pytest.mark.parametrize('suite,method', [('plus_h', 'cqd'), ('ultraquery', 'ultraquery')]) +def test_host_commands_need_only_the_standard_library(tmp_path, suite, method): + """Setup and Docker launches run with ``python -S``: no PyTorch or other site packages.""" + root = tmp_path / 'inputs' + common = [sys.executable, '-S', '-m', 'benchmarks.cqa', suite] + selection = ['--input-root', str(root), '--methods', method, '--datasets', DATASET[suite]] + output = subprocess.check_output([*common, 'setup', *selection, '--dry-run'], text=True, cwd=REPO) + assert 'https://' in output and method in output.lower() + checked = subprocess.run([*common, 'setup', *selection, '--check'], capture_output=True, text=True, cwd=REPO) + assert checked.returncode == 1 and 'Missing:' in checked.stdout + root.mkdir() + launch = subprocess.check_output([*common, 'evaluate', *selection, '--output', str(root / 'results'), + '--image', 'example:test', '--dry-run'], text=True, cwd=REPO) + assert launch.startswith('docker run') and f'example:test {suite} evaluate --input-root /inputs' in launch + assert list(root.iterdir()) == [] + + +def test_run_sets_up_the_frozen_bundle_inputs_not_the_current_recipes(tmp_path, monkeypatch): + manifest = recipes('plus_h', methods=['cqd'], datasets=['ICEWS18+H']) + study = tmp_path / 'study' + (study / 'bundle').mkdir(parents=True) + (study / 'bundle/bundle.json').write_text(json.dumps({'manifest': manifest, 'files': {'pinned': 'digest'}})) + before = (study / 'bundle/bundle.json').read_bytes() + seen = [] + + def setup(manifest, root, **kwargs): + seen.append(manifest) + raise RuntimeError('stop after setup') + + monkeypatch.setattr(inputs, 'ensure_inputs', setup) + with pytest.raises(RuntimeError, match='stop after setup'): + cli.main(['plus_h', 'run', '--phase', 'pilot', '--input-root', str(tmp_path), '--output', str(study)]) + assert seen == [manifest] + assert (study / 'bundle/bundle.json').read_bytes() == before + + +@pytest.mark.parametrize('suite', SUITES) +def test_evaluate_sets_up_selected_inputs_before_evaluation(tmp_path, monkeypatch, suite): + from benchmarks.cqa import evaluate + calls = [] + monkeypatch.setattr(inputs, 'ensure_inputs', lambda manifest, root, **kwargs: calls.append(('setup', manifest, kwargs))) + + def evaluated(manifest, **kwargs): + assert calls[-1][:2] == ('setup', manifest) + calls.append(('evaluate', manifest, kwargs)) + + monkeypatch.setattr(evaluate, 'evaluate_manifest', evaluated) + args = [suite, 'evaluate', '--methods', 'ultraquery', '--datasets', DATASET[suite], '--input-root', str(tmp_path), + '--output', str(tmp_path / 'results')] + cli.main(args) + assert [call[0] for call in calls] == ['setup', 'evaluate'] + assert [entry['dataset'] for entry in calls[0][1]['entries']] == [DATASET[suite]] + assert calls[0][2]['suite'] == suite and calls[0][2].get('download_missing', True) + calls.clear() + cli.main([*args, '--no-setup']) + assert calls[0][2]['download_missing'] is False + + +@pytest.mark.parametrize('suite', SUITES) +def test_setup_dry_run_lists_sources_without_writing(tmp_path, capsys, suite): + cli.main([suite, 'setup', '--methods', 'ultraquery', '--datasets', DATASET[suite], + '--input-root', str(tmp_path / 'absent'), '--dry-run']) + output = capsys.readouterr().out + assert 'https://' in output and 'ultraquery.pth' in output + assert not (tmp_path / 'absent').exists() + + +@pytest.mark.parametrize('suite', SUITES) +def test_docker_launch_fetches_on_host_before_isolated_container(tmp_path, monkeypatch, suite): + calls = [] + monkeypatch.setattr(inputs, 'ensure_inputs', lambda manifest, root, **kwargs: calls.append(('setup', root, kwargs['suite']))) + monkeypatch.setattr(docker, 'run', lambda image, argv, **kwargs: calls.append(('container', image, argv))) + root = tmp_path / 'inputs' + root.mkdir() + args = [suite, 'evaluate', '--input-root', str(root), '--output', str(root / 'results'), '--image', 'test', '--device', 'cpu', + '--methods', 'ultraquery', '--datasets', DATASET[suite]] + cli.main(args) + assert [call[0] for call in calls] == ['setup', 'container'] and calls[0][2] == suite + assert '--no-setup' in calls[1][2] and '--image' not in calls[1][2] + calls.clear() + cli.main([*args, '--no-setup']) + assert [call[0] for call in calls] == ['container'] diff --git a/benchmarks/cqa/tests/test_inference_difficulty.py b/benchmarks/cqa/tests/test_inference_difficulty.py new file mode 100644 index 000000000..834599f42 --- /dev/null +++ b/benchmarks/cqa/tests/test_inference_difficulty.py @@ -0,0 +1,201 @@ +"""Answer partition, graph provenance and inference-free difficulty regressions.""" +import json +import pickle +import sqlite3 +from collections import defaultdict + +import numpy as np +import pytest + +from benchmarks.cqa.difficulty import ( + DifficultyClassifier, + difficulty_name, + export_difficulty_reports, + positive_edges, + released_labels, + root_queries, + summarize_difficulty, +) +from dicee.query_answering._checkpoint import checksum, write_json +from dicee.query_answering._query import QUERY_SHAPES, compile_query + + +def outgoing(edges): + result = defaultdict(lambda: defaultdict(set)) + for h, r, t in edges: + result[h][r].add(t) + return result + + +def test_minimum_witness_and_graph_change_with_bounded_cache(): + full = outgoing([(0, 0, 1), (0, 0, 2), (1, 1, 3), (2, 1, 3), (2, 1, 4)]) + train = outgoing([(0, 0, 1)]) + extended = outgoing([(0, 0, 1), (0, 0, 2)]) + q = (0, (0, 1)) + classifier = DifficultyClassifier(full, train, 5, cache_answers=2) + costs, maximum = classifier.classify('2p', q, {3, 4}) + assert costs == {3: 1, 4: 2} and maximum == 2 + assert classifier.cached_answers <= 2 + for relation in range(10, 20): + classifier.costs(('project', relation, ('anchor', 0))) + assert len(classifier.cache) <= 2 + assert DifficultyClassifier(full, extended, 5).classify('2p', q, {3, 4})[0] == {3: 1, 4: 1} + assert [difficulty_name(k, maximum) for k in range(3)] == ['observed', 'partial', 'full'] + with pytest.raises(ValueError, match='not true'): + classifier.classify('2p', q, {0}) + + +def test_union_chooses_branch_and_negation_constrains_intermediate_witness(): + full = outgoing([(0, 0, 2), (0, 0, 3), (1, 1, 2), (2, 2, 4), (3, 2, 4)]) + train = outgoing([(0, 0, 2), (2, 2, 4)]) + classifier = DifficultyClassifier(full, train, 5) + union = (((0, (0,)), (1, (1,)), (-1,)), (2,)) + assert classifier.classify('up', union, {4}) == ({4: 0}, 2) + # Witness 2 is cheap but violates the negated branch; witness 3 costs two. + negated = (((0, (0,)), (1, (1, -2))), (2,)) + assert classifier.classify('inp', negated, {4}) == ({4: 2}, 2) + pni = ((1, (1, 2, -2)), (0, (0,))) + assert classifier.classify('pni', pni, {2, 3}) == ({2: 0, 3: 1}, 1) + assert positive_edges(compile_query(((0, (0,)), (1, (1,)), (-1,)))) == 1 + + +def fixture_records(tmp_path): + queries = [(0, (0, 1)), (1, (0, 1))] + folder = tmp_path / 'data' + folder.mkdir() + for name, value in { + 'queries': {QUERY_SHAPES['2p']: set(queries)}, + 'easy-answers': {q: {9} for q in queries}, + 'hard-answers': {queries[0]: {3, 4}, queries[1]: {3}}, + }.items(): + (folder / f'test-{name}.pkl').write_bytes(pickle.dumps(value)) + records = root_queries(folder, ['2p']) + trace = tmp_path / 'ranks.sqlite3' + with sqlite3.connect(trace) as db: + db.execute('CREATE TABLE queries(position INTEGER, query_id TEXT, shape TEXT, answers TEXT)') + for i, q in enumerate(queries): + key = next(k for k, r in records.items() if r['query'] == q) + rows = [[3, 1, 0, 2], [4, 4, 3, 1]] if i == 0 else [[3, 2, 1, 1]] + db.execute('INSERT INTO queries VALUES (?, ?, ?, ?)', (i, key, '2p', json.dumps(rows))) + return folder, queries, records, trace + + +class ToyClassifier: + def classify(self, shape, query, hard): + return ({3: 1, 4: 2} if query[0] == 0 else {3: 1}), 2 + + +def test_mixed_answers_ties_conditional_means_and_additive_weights(tmp_path): + _, _, records, trace = fixture_records(tmp_path) + summary = summarize_difficulty(trace, records, ToyClassifier()) + rows = {(r['grouping'], r['label']): r for r in summary['rows']} + partial, full = rows['difficulty', 'partial'], rows['difficulty', 'full'] + assert partial['queries'] == 2 and full['queries'] == 1 + assert partial['sort']['mrr'] == .75 + assert partial['expected']['mrr'] == .625 # E[1/rank] for uniform ranks 1,2. + assert partial['expected']['hits1'] == .25 + assert full['sort']['mrr'] == .25 + overall = rows['overall', 'all'] + assert overall['sort']['mrr'] == .5625 + assert partial['query_weight'] == .75 and full['query_weight'] == .25 + for policy in ('sort', 'expected'): + for metric in ('mrr', 'hits1', 'hits3', 'hits10'): + assert np.isclose(sum(r['original_weight_contribution'][policy][metric] for r in (partial, full)), overall[policy][metric]) + assert rows['released_reduction', 'unavailable']['hard_answers'] == 3 + + +@pytest.mark.parametrize('mutation,match', [ + ("UPDATE queries SET query_id='wrong' WHERE position=0", 'identity'), + ("UPDATE queries SET answers='[[5,1,0,1],[4,4,3,1]]' WHERE position=0", 'exact root'), + ("UPDATE queries SET answers='[[3,1,0,1],[3,4,3,1]]' WHERE position=0", 'exact root'), + ("UPDATE queries SET answers='[[3,3,0,2],[4,4,3,1]]' WHERE position=0", 'tie block'), +]) +def test_identity_answer_and_rank_invariants(tmp_path, mutation, match): + _, _, records, trace = fixture_records(tmp_path) + with sqlite3.connect(trace) as db: + db.execute(mutation) + with pytest.raises(ValueError, match=match): + summarize_difficulty(trace, records, ToyClassifier()) + + +def test_released_partitions_missing_overlap_extra_and_provenance(tmp_path): + folder, queries, records, _ = fixture_records(tmp_path) + unavailable, info = released_labels(folder, records, dataset='FB15k237+H') + assert not unavailable and info['2p']['status'] == 'unavailable' + first = folder / 'test-query-reduction/2p/1p/test-hard-answers.pkl' + second = folder / 'test-query-reduction/2p/2p/test-hard-answers.pkl' + first.parent.mkdir(parents=True) + first.write_bytes(pickle.dumps({queries[0]: {3, 8}, queries[1]: {3}})) + with pytest.raises(FileNotFoundError): + released_labels(folder, records, dataset='FB15k237+H') + second.parent.mkdir(parents=True) + second.write_bytes(pickle.dumps({queries[0]: {4}})) + labels, info = released_labels(folder, records, dataset='FB15k237+H') + assert len(labels) == 2 and info['2p']['label_reference_graph'] == 'train+valid' + assert info['2p']['excluded_extra_answers'] == 1 + second.write_bytes(pickle.dumps({queries[0]: {3, 4}})) + with pytest.raises(ValueError, match='Overlapping'): + released_labels(folder, records, dataset='FB15k237+H') + second.write_bytes(pickle.dumps({})) + with pytest.raises(ValueError, match='Missing released'): + released_labels(folder, records, dataset='FB15k237+H') + + +def test_partial_trace_does_not_claim_complete_root_coverage(tmp_path): + _, _, records, trace = fixture_records(tmp_path) + with sqlite3.connect(trace) as db: + db.execute('DELETE FROM queries WHERE position=1') + summary = summarize_difficulty(trace, records, ToyClassifier()) + assert summary['counts']['2p']['queries'] == 1 and len(records) == 2 + + +@pytest.mark.parametrize('method', ['cone', 'qto', 'cqd-hybrid']) +@pytest.mark.parametrize('inference_graph', ['train', 'train+valid']) +def test_export_fixed_test_reference_corrected_filters_and_pending_jobs(tmp_path, method, inference_graph): + from dicee.query_answering.datasets import dataset_spec + folder, queries, records, trace = fixture_records(tmp_path) + actual = tmp_path / 'inputs' / 'data' / dataset_spec('FB15k237+H')[1] + actual.parent.mkdir(parents=True) + folder.rename(actual) + # Distinct relations to keep reciprocal facts from creating shortcuts. + (actual / 'train.txt').write_text('0 0 2\n') + (actual / 'valid.txt').write_text('1 0 2\n') + (actual / 'test.txt').write_text('2 1 3\n2 1 4\n') + (actual / 'id2ent.pkl').write_bytes(pickle.dumps({i: str(i) for i in range(10)})) + bundle, results = tmp_path / 'bundle', tmp_path / 'results' + correction = bundle / 'filters.json' + write_json(correction, {'changes': {}}) + pins = {str(p.relative_to(tmp_path / 'inputs')): checksum(p) for p in actual.glob('*')} + frozen = {'manifest': {'data_root': 'data', 'entries': [{'id': 'done'}, {'id': 'excluded'}, {'id': 'pending'}]}, + 'files': pins, 'source_sha256': 'old-code', + 'filter_corrections': {'FB15k237+H': {'path': 'filters.json', 'sha256': checksum(correction)}}} + write_json(bundle / 'bundle.json', frozen) + results.mkdir() + trace.rename(results / 'ranks.sqlite3') + overall = next(r for r in summarize_difficulty(results / 'ranks.sqlite3', records, ToyClassifier())['rows'] if r['grouping'] == 'overall') + report = {'benchmark_run': {'entry': 'done', 'bundle': checksum(bundle / 'bundle.json')}, + 'dataset': 'FB15k237+H', 'split': 'test', 'inference': {'method': method}, + 'dataset_metadata': {'inference_graph': inference_graph}, + 'protocol': {'answer_filter': 'corrected', 'full_split': True}, + 'rank_trace_sha256': checksum(results / 'ranks.sqlite3'), + 'per_shape': {'2p': overall['sort'] | {'queries': 2, 'hard_answers': 3}}, + 'additional_tie_metrics': {'expected': {'per_shape': {'2p': overall['expected']}}}} + write_json(results / 'result.json', report) + write_json(results / 'excluded' / 'result.json', report | { + 'benchmark_run': report['benchmark_run'] | {'entry': 'excluded'}}) + # An active job is represented by an unusable trace and no result; never read. + (results / 'active').mkdir() + (results / 'active' / 'ranks.sqlite3').write_text('do not open') + payload = export_difficulty_reports(results, bundle, tmp_path / 'inputs', tmp_path / 'out', entries=['done'], query_types=['2p']) + assert payload['pending_main_entries'] == ['pending'] + assert payload['hardness_reference_graph'] == 'train+valid' + assert {r['comparison_graph'] for r in payload['rows']} == {'train+valid'} + assert {r['label_reference_graph'] for r in payload['rows']} == {'train+valid'} + assert {r['inference_graph'] for r in payload['rows']} == {inference_graph} + assert {r['label'] for r in payload['rows'] if r['grouping'] == 'inferred_positive_edges'} == {'1'} + assert len(payload['details']) == 1 + assert payload['frozen_inference_source_sha256'] == 'old-code' + assert payload['postprocessor_files'] + assert all(r['answer_filter'] == 'corrected' for r in payload['rows']) + with pytest.raises(ValueError, match='new report directory'): + export_difficulty_reports(results, bundle, tmp_path / 'inputs', results / 'out') diff --git a/benchmarks/cqa/tests/test_kgfm_reference.py b/benchmarks/cqa/tests/test_kgfm_reference.py new file mode 100644 index 000000000..3353b35ab --- /dev/null +++ b/benchmarks/cqa/tests/test_kgfm_reference.py @@ -0,0 +1,124 @@ +"""Independent integration oracle checks, including ties and observed proofs.""" + +import importlib.util +import json +from pathlib import Path + +import pytest +import torch + +from dicee.query_answering import AdapterQuery, AdapterTrainingData, QueryAnswerer, QueryContext, QueryScoreAdapter, fit_query_adapter +from dicee.query_answering._query import QUERY_SHAPES +from dicee.query_answering.context import state_fingerprint + +spec = importlib.util.spec_from_file_location('reference_kgfm', Path(__file__).parents[1] / 'verification' / 'reference_kgfm.py') +reference_module = importlib.util.module_from_spec(spec) +spec.loader.exec_module(reference_module) + + +class Rows(torch.nn.Module): + num_entities, num_relations = 7, 4 + + def __init__(self): + super().__init__() + self.values = torch.nn.Parameter(torch.randn(7, 4, 7, generator=torch.Generator().manual_seed(8))) + + def forward_k_vs_all(self, conditions): + return self.values[conditions[:, 0], conditions[:, 1]] + + +@pytest.mark.parametrize('name', ['DistMult', 'ULTRA', 'TRIX', 'Flock']) +def test_default_adapter_fits_and_reloads_for_every_backbone(name, tmp_path): + from dicee.models import TRIX, ULTRA, DistMult, Flock + + model = {'DistMult': DistMult, 'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[name](dict( + num_entities=7, num_relations=4, embedding_dim=8, ultra_dim=8, ultra_num_layers=2, + trix_dim=8, flock_dim=8, flock_walk_num=2, flock_walk_len=8, flock_refinements=2, flock_seed=17, + )).eval() + context = QueryContext([(0, 0, 2), (1, 1, 2)], 7, 4) + data = AdapterTrainingData('source', context, (AdapterQuery(((0, (0,)), (1, (1,))), {2, 3}),)) + before = state_fingerprint(model) + result = fit_query_adapter(model, [data], epochs=2) + assert result.adapter.feature_mode == QueryScoreAdapter().feature_mode == 'context_scores' + assert result.adapter.hidden_dim == 0 and result.adapter.weights.numel() == 16 + assert result.adapter.weights.count_nonzero() > 0 + assert state_fingerprint(model) == before + result.adapter.save(tmp_path / 'adapter.json') + restored = QueryScoreAdapter.load(tmp_path / 'adapter.json', model=model) + assert restored.feature_mode == 'context_scores' + torch.testing.assert_close(restored.weights, result.adapter.weights, atol=0, rtol=0) + + +@pytest.mark.parametrize('hidden_dim', [0, 5]) +def test_adapter_feature_alias_preserves_scores_and_saves_canonical_name(hidden_dim, tmp_path): + model = Rows() + context = QueryContext([(0, 0, 2), (1, 1, 2)], 7, 4) + expected = QueryScoreAdapter('context_scores', 1., hidden_dim=hidden_dim, + weights=torch.full((2, hidden_dim or 8), .1), + metadata={'backbone_state_sha256': state_fingerprint(model)}) + payload = dict(expected.to_dict(), feature_mode='context_scores_v1') + path = tmp_path / 'adapter.json' + path.write_text(json.dumps(payload)) + actual = QueryScoreAdapter.load(path, model=model) + raw = model.forward_k_vs_all(torch.tensor([[0, 0], [1, 1]])) + observed, base = context.features([(0, 0), (1, 1)], device='cpu') + torch.testing.assert_close(actual(raw, observed, base), expected(raw, observed, base), atol=0, rtol=0) + actual.save(tmp_path / 'canonical.json') + assert json.loads((tmp_path / 'canonical.json').read_text())['feature_mode'] == 'context_scores' + + +def instantiate(shape, counters=None): + counters = [0, 0] if counters is None else counters + if shape == 'e': + counters[0] += 1 + return (counters[0] - 1) % 7 + if shape == 'r': + counters[1] += 1 + return (counters[1] - 1) % 4 + if shape in ('n', 'u'): + return -2 if shape == 'n' else -1 + return tuple(instantiate(child, counters) for child in shape) + + +@pytest.mark.parametrize('operator', ['product', 'min']) +@pytest.mark.parametrize('cache_bytes', [0, 4096]) +@pytest.mark.parametrize('facts', ['none', 'atomic', 'both']) +def test_independent_reference_covers_all_shapes(operator, cache_bytes, facts): + model = Rows().eval() + context = QueryContext([(0, 0, 1), (0, 0, 2), (2, 1, 6), (1, 1, 3), (3, 2, 4), (4, 3, 5)], 7, 4) + adapter = QueryScoreAdapter('context_scores', float(facts != 'none'), bias_bound=8., + weights=torch.randn(2, 8, generator=torch.Generator().manual_seed(9)).double() / 5) + reference = reference_module.ReferenceKGFM(context.triples, 7, 4, adapter.to_dict(), beam_size=1, device='cpu', + restore_observed=facts == 'both') + conditions = [(h, r) for h in range(7) for r in range(4)] + with torch.no_grad(): + for start in range(0, len(conditions), 2): + batch = conditions[start:start + 2] + reference.capture(batch, model.forward_k_vs_all(torch.tensor(batch))) + engine = QueryAnswerer(model, context=context, adapter=adapter, row_batch_size=2, cache_bytes=cache_bytes, + restore_observed=facts == 'both') + queries = [instantiate(shape) for shape in QUERY_SHAPES.values()] + engine.prefetch(queries) + for query in queries: + expected = reference.predict(query, operator) + actual = engine.predict(query, beam_size=1, tnorm='prod' if operator == 'product' else 'min', return_log_scores=True) + torch.testing.assert_close(actual, expected, atol=1e-14, rtol=1e-14) + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)) + # Both observed first hops tie at one; ID 2 is pruned, but its proof survives. + assert (reference.predict((0, (0, 1)), operator)[6] == 0).item() == (facts == 'both') + assert (engine.predict((0, (0,)), return_log_scores=True)[1] == 0).item() == (facts != 'none') + with torch.no_grad(): + adapter.weights[1].add_(1) + assert not torch.allclose(engine.predict((0, (0,)), return_log_scores=True), reference.predict((0, (0,)))) + + +@pytest.mark.parametrize('operator', ['product', 'min']) +def test_reference_needs_no_rows_for_zero_prefix_but_requires_live_rows(operator): + adapter = QueryScoreAdapter('context_scores', 1.) + reference = reference_module.ReferenceKGFM([(0, 0, t) for t in range(7)], 7, 4, + adapter.to_dict(), beam_size=7, device='cpu') + reference.capture([(0, 0)], torch.zeros(1, 7)) + contradiction = (((0, (0,)), (0, (0, -2))), (1,)) + assert torch.isneginf(reference.predict(contradiction, operator)).all() + with pytest.raises(KeyError): + reference.predict((0, (0, 1)), operator) diff --git a/benchmarks/cqa/tests/test_launcher.py b/benchmarks/cqa/tests/test_launcher.py new file mode 100644 index 000000000..8fc7eeeb6 --- /dev/null +++ b/benchmarks/cqa/tests/test_launcher.py @@ -0,0 +1,467 @@ +"""Portable preparation profiles and launcher checks without Docker or inference.""" +import json +import subprocess + +import pytest + +from benchmarks.cqa import cli +from benchmarks.cqa.manifests import prepare_manifest, read_manifest, suite_directory, validate_entry +from benchmarks.cqa.study import freeze, read, run_job +from benchmarks.cqa.tests.test_protocol import paper_fixture + +PUBLIC = suite_directory('plus_h') +IMAGE = ['--image', 'example/plus-h:local', '--dry-run'] + + +@pytest.mark.parametrize('suite', ['plus_h', 'ultraquery']) +def test_h100_profile_preserves_protocol_and_records_execution_options(suite): + paths = [suite_directory(suite) / name for name in ('baselines.json', 'kgfm_adapters.json')] + settings = dict(suite=suite, answer_filter='corrected' if suite == 'plus_h' else 'released') + baseline = prepare_manifest(paths, **settings) + h100 = prepare_manifest(paths, hardware_profile='h100', **settings) + for original, changed in zip(baseline['entries'], h100['entries']): + validate_entry(changed) + for key in original.keys() - {'options', 'reference'}: + assert changed[key] == original[key] + options = changed['options'] + if original['method'].endswith('-adapter'): + assert options['raw_cache_device'] == 'model' + assert options['row_batch_size'] == options['backend_batch_size'] == 16 + assert options['cache_bytes'] == 4 * 2**30 and options['raw_cache_bytes'] == 2 * 2**30 + assert options['beam_size'] == original['options']['beam_size'] + assert options['relation_cache_mb'] == 256 and options['projection_cache_mb'] == 512 + else: + assert changed == original + override = prepare_manifest(paths, hardware_profile='h100', kgfm_batch_size=8, **settings) + assert all(e['options']['backend_batch_size'] == e['options']['row_batch_size'] == 8 + for e in override['entries'] if e['method'].endswith('-adapter')) + assert prepare_manifest(paths, **settings) == baseline + + +@pytest.mark.parametrize('settings', [dict(hardware_profile='bad'), dict(kgfm_batch_size=0), + dict(kgfm_batch_size=True), dict(kgfm_batch_size=1, methods=['qto'])]) +def test_invalid_hardware_settings_fail_before_inputs(settings): + with pytest.raises(ValueError): + prepare_manifest([PUBLIC / 'baselines.json'], **settings) + + +@pytest.mark.parametrize('suite', ['plus_h', 'ultraquery']) +def test_hardware_profile_cli_and_container_forwarding(tmp_path, capsys, suite): + output = tmp_path / 'run' + cli.main([suite, 'evaluate', '--hardware-profile', 'h100', '--kgfm-batch-size', '16', '--methods', 'ultra-adapter', + '--output', str(output), '--dry-run']) + entries = json.loads(capsys.readouterr().out)['entries'] + assert all(e['options']['backend_batch_size'] == 16 and e['options']['raw_cache_device'] == 'model' for e in entries) + common = ['--input-root', str(tmp_path), '--output', str(output), *IMAGE] + flags = ['--hardware-profile', 'h100', '--kgfm-batch-size', '16'] + cli.main([suite, 'prepare', *common, *flags]) + assert '--hardware-profile h100 --kgfm-batch-size 16' in capsys.readouterr().out + assert not output.exists() + # Frozen bundles fix the execution options; a run cannot change them. + with pytest.raises(SystemExit): + cli.main([suite, 'run', *common, *flags]) + assert 'unrecognized arguments' in capsys.readouterr().err + + +def test_profiles_preserve_beams_and_per_shape_settings(): + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + reference = prepare_manifest(paths, profile='reference') + bounded = prepare_manifest(paths, profile='bounded') + original = sum((read_manifest(path)['entries'] for path in paths), []) + assert reference['entries'] == original + assert reference['answer_filter'] == bounded['answer_filter'] == 'corrected' + assert prepare_manifest(paths, answer_filter='released')['answer_filter'] == 'released' + assert len(bounded['entries']) == len(reference['entries']) + for expected, actual in zip(reference['entries'], bounded['entries']): + if expected['method'] not in ('cqd', 'cqd-hybrid'): + assert actual == expected + continue + assert actual['options']['reference_batching'] is False + assert actual['options']['row_batch_size'] == actual['options']['final_batch_size'] == 32 + for key, value in expected['options'].items(): + if key not in ('reference_batching', 'row_batch_size', 'final_batch_size'): + assert actual['options'][key] == value + assert actual['query_types'] == expected['query_types'] + assert actual['query_batch_size'] == expected['query_batch_size'] + assert 'bounded' in actual['reference']['status'] + selected = prepare_manifest(paths, entries=[original[0]['id']]) + assert [entry['id'] for entry in selected['entries']] == [original[0]['id']] + with pytest.raises(ValueError, match='distinct'): + prepare_manifest(paths, entries=['missing']) + + +def test_method_dataset_query_combinations_preserve_recipes_and_trim_overrides(): + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + original = prepare_manifest(paths, profile='reference') + selected = prepare_manifest(paths, profile='reference', methods=['cqd', 'qto', 'ultra-adapter'], + datasets=['FB15k237+H', 'NELL995+H'], query_types=['epfo', '2in'], atomic_negation=True) + assert len(selected['entries']) == 6 + assert {(e['method'], e['dataset']) for e in selected['entries']} == { + (method, dataset) for method in ('cqd', 'qto', 'ultra-adapter') for dataset in ('FB15k237+H', 'NELL995+H')} + for entry in selected['entries']: + validate_entry(entry) + assert len(entry['query_types']) == 12 + assert '2in' in entry['query_types'] and 'pni' not in entry['query_types'] + assert set(entry['options'].get('per_shape', {})) <= set(entry['query_types']) + if 'operators' in entry: + assert set(entry['operators']) == set(entry['query_types']) + baseline = next(e for e in original['entries'] if e['id'] == entry['id']) + assert entry['checkpoint'] == baseline['checkpoint'] + assert {k: v for k, v in entry['options'].items() if k not in ('atomic_negation', 'per_shape')} == { + k: v for k, v in baseline['options'].items() if k not in ('atomic_negation', 'per_shape')} + assert prepare_manifest(paths, profile='reference') == original + assert prepare_manifest(paths, methods=['all'], datasets=['all']) == prepare_manifest(paths) + + +@pytest.mark.parametrize('selection', [dict(methods=['missing']), dict(datasets=['missing']), + dict(methods=['cqd', 'cqd']), dict(query_types=['bad']), + dict(query_types=['all', '2p']), dict(query_types=['2p', '2p']), + dict(methods=['qto'], entries=['cqd-FB15k237+H'])]) +def test_invalid_combinations_fail_before_opening_inputs(selection): + with pytest.raises(ValueError): + prepare_manifest([PUBLIC / 'baselines.json'], **selection) + + +@pytest.mark.parametrize('query_group', [None, 'all', 'epfo', 'negation']) +def test_evaluate_dry_run_resolves_default_cqd_coverage_without_inputs(tmp_path, capsys, query_group): + from dicee.query_answering._query import PLUS_H_SHAPES + output = tmp_path / 'no-results' + args = ['plus_h', 'evaluate', '--methods', 'cqd', 'cqd-hybrid', '--input-root', str(tmp_path / 'missing-inputs'), + '--output', str(output), '--dry-run'] + if query_group is not None: + args += ['--query-types', query_group] + cli.main(args) + manifest = json.loads(capsys.readouterr().out) + assert {(entry['method'], entry['dataset']) for entry in manifest['entries']} == { + (method, dataset) for method in ('cqd', 'cqd-hybrid') + for dataset in ('FB15k237+H', 'ICEWS18+H', 'NELL995+H')} + expected = set(PLUS_H_SHAPES) + if query_group in ('epfo', 'negation'): + expected = {shape for shape in expected if ('n' in shape) == (query_group == 'negation')} + for entry in manifest['entries']: + validate_entry(entry) + assert set(entry['query_types']) == expected + assert entry['options']['atomic_negation'] + assert not entry['options']['reference_batching'] + assert set(entry['options']['per_shape']) <= expected + assert any('signed-atom negation with +H scoring' in note for note in entry['reference']['notes']) + assert not output.exists() + + +def test_direct_subset_evaluation_scores_only_selected_methods_datasets_and_queries(tmp_path, monkeypatch): + import torch + + from dicee.models.complex import ComplEx + from dicee.query_answering.methods.cqd import CQD + + manifest = paper_fixture(tmp_path) + model = ComplEx(dict(model='ComplEx', num_entities=8, num_relations=4, embedding_dim=8, normalization=None)) + torch.save(model.state_dict(), tmp_path / 'complex.pt') + for method in ('cqd', 'cqd-hybrid'): + manifest['entries'].append(dict(manifest['entries'][0], id=f'{method}-FB15k237+H', method=method, + checkpoint='complex.pt', options={'beam_size': 2, 'atomic_negation': True, + 'per_shape': {'2p': {'beam_size': 3}}})) + manifest['entries'].append(dict(manifest['entries'][-1], id='excluded-dataset', dataset='NELL995+H', checkpoint='missing.pt')) + path = tmp_path / 'manifest.json' + path.write_text(json.dumps(manifest)) + output = tmp_path / 'results' + args = ['plus_h', 'evaluate', '--manifests', str(path), '--answer-filter', 'released', '--methods', 'cqd', 'cqd-hybrid', + '--datasets', 'FB15k237+H', '--query-types', 'negation', '--input-root', str(tmp_path), '--output', str(output), + '--device', 'cpu', '--threads', '2'] + cli.main(args) + assert sorted(p.name for p in output.iterdir()) == ['cqd-FB15k237+H', 'cqd-hybrid-FB15k237+H'] + for method in ('cqd', 'cqd-hybrid'): + report_path = output / f'{method}-FB15k237+H' / 'result.json' + report = json.loads(report_path.read_text()) + assert report['queries'] == 5 + assert set(report['per_shape']) == {'2in', '3in', 'inp', 'pin', 'pni'} + assert report['inference']['configuration']['atomic_negation'] + assert report['inference']['negation_scope'] == 'CQD-A signed-atom negation with +H scoring' + monkeypatch.setattr(CQD, 'predict', lambda *args: pytest.fail('Completed subset was recomputed')) + cli.main(args) + + +def test_observed_fact_recipes_reuse_checkpoints_and_select_only_kgfms(): + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + originals = {entry['id']: entry for entry in prepare_manifest(paths)['entries']} + expanded = prepare_manifest(paths, observed_facts=['all'])['entries'] + assert len(expanded) == 18 + for entry in expanded: + validate_entry(entry) + mode = entry['options']['observed_facts'] + original = originals[entry['id'].removesuffix(f'-facts-{mode}')] + assert entry['method'].endswith('-adapter') + assert {k: v for k, v in entry.items() if k not in ('id', 'options', 'reference')} == { + k: v for k, v in original.items() if k not in ('id', 'options', 'reference')} + assert {k: v for k, v in entry['options'].items() if k != 'observed_facts'} == original['options'] + selected = prepare_manifest(paths, observed_facts=['none', 'atomic'])['entries'] + assert len(selected) == 12 + assert {entry['options']['observed_facts'] for entry in selected} == {'none', 'atomic'} + one = prepare_manifest(paths, observed_facts=['all'], entries=[expanded[0]['id']])['entries'] + assert one == expanded[:1] + for invalid in ([], ['all', 'none'], ['atomic', 'atomic'], ['invalid']): + with pytest.raises(ValueError, match='observed-fact'): + prepare_manifest(paths, observed_facts=invalid) + one[0]['options']['observed_facts'] = 'invalid' + with pytest.raises(ValueError, match='Observed facts'): + validate_entry(one[0]) + + +def test_graph_ablation_freezes_weights_and_reuses_graph_independent_methods(): + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + original = {e['id']: e for e in prepare_manifest(paths)['entries']} + expanded = prepare_manifest(paths, inference_graphs=['train', 'train+valid'])['entries'] + assert len(expanded) == 45 + assert sum(1 + int(e.get('adapter_ablation', False)) for e in expanded) == 57 + for entry in expanded: + validate_entry(entry) + if entry['method'] in ('cone', 'clmpt', 'cqd'): + assert entry['id'] in original and entry['reference']['graph_independent'] + else: + base = original[entry['graph_ablation']] + assert entry['options'] == base['options'] + assert entry['checkpoint'] == base['checkpoint'] + assert entry.get('adapters') == base.get('adapters') + assert entry.get('operators') == base.get('operators') + for invalid in ([], ['train', 'train'], ['test']): + with pytest.raises(ValueError, match='inference graphs'): + prepare_manifest(paths, inference_graphs=invalid) + + +def test_public_test_graph_defaults_and_explicit_train_override(): + from dicee.query_answering.method_evaluation import GRAPH_INDEPENDENT_METHODS + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + defaults = prepare_manifest(paths)['entries'] + for entry in defaults: + expected = 'train' if entry['method'] in GRAPH_INDEPENDENT_METHODS else 'train+valid' + assert entry['inference_graph'] == expected + if entry['method'] in ('gnnqe', 'ultraquery', 'qto'): + assert entry['reference']['inference_graph'] == 'train' + overridden = prepare_manifest(paths, inference_graphs=['train'])['entries'] + assert len(overridden) == len(defaults) + assert all(entry['inference_graph'] == 'train' for entry in overridden) + + +def test_container_dry_run_forwards_selection_and_rejects_bad_arguments(tmp_path, capsys): + output = tmp_path / 'run' + common = ['--input-root', str(tmp_path), '--output', str(output), *IMAGE] + + def launched(command, *extra): + cli.main(['plus_h', command, *common, *extra]) + return capsys.readouterr().out + + result = launched('prepare', '--entries', 'cqd-FB15k237+H') + assert result.startswith('docker run --rm --network none --read-only') + assert f'source={tmp_path},target=/inputs,readonly' in result and f'source={output},target=/results' in result + assert 'example/plus-h:local plus_h prepare --input-root /inputs --output /results --entries cqd-FB15k237+H --no-setup' in result + assert not output.exists() + assert '--observed-facts none atomic' in launched('prepare', '--observed-facts', 'none', '--observed-facts', 'atomic') + assert '--inference-graphs train train+valid' in launched('prepare', '--inference-graphs', 'train', '--inference-graphs', 'train+valid') + assert '--answer-filter released' in launched('prepare', '--answer-filter', 'released') + for extra in (['--profile', 'invalid'], ['--output', str(tmp_path.parent / 'outside')], ['--unknown', 'x']): + with pytest.raises(SystemExit): + launched('prepare', *extra) + assert 'plus_h run --input-root /inputs --output /results --no-setup' in launched('run') + selected = launched('run', '--entries', 'ultra-product-14type-FB15k237+H-facts-none', '--entries', 'trix-product-14type-NELL995+H-facts-atomic') + assert '--entries ultra-product-14type-FB15k237+H-facts-none trix-product-14type-NELL995+H-facts-atomic' in selected + for extra in (['--answer-filter', 'corrected'], ['--observed-facts', 'none']): + with pytest.raises(SystemExit): + launched('run', *extra) + + +def test_container_forwards_combination_selectors_and_keeps_queries_frozen(tmp_path, capsys): + common = ['--input-root', str(tmp_path), '--output', str(tmp_path / 'run'), *IMAGE] + + def launched(command, *extra): + cli.main(['plus_h', command, *common, *extra]) + return capsys.readouterr().out + + result = launched('evaluate', '--methods', 'cqd', 'cqd-hybrid', '--datasets', 'FB15k237+H', 'NELL995+H', '--query-types', 'negation', + '--atomic-negation', '--split', 'valid', '--max-queries-per-shape', '3') + assert '--methods cqd cqd-hybrid --datasets FB15k237+H NELL995+H --query-types negation --atomic-negation' in result + assert '--split valid --max-queries-per-shape 3' in result + assert not (tmp_path / 'run').exists() + assert '--methods qto --datasets ICEWS18+H --query-types 2p 3p' in launched('prepare', '--methods', 'qto', '--datasets', 'ICEWS18+H', + '--query-types', '2p', '3p') + assert '--methods qto --datasets ICEWS18+H' in launched('run', '--methods', 'qto', '--datasets', 'ICEWS18+H') + for command, extra in [('run', ['--query-types', '2p']), ('run', ['--atomic-negation']), ('run', ['--split', 'valid']), + ('evaluate', ['--methods']), ('evaluate', ['--max-queries-per-shape', '0'])]: + with pytest.raises(SystemExit): + launched(command, *extra) + + +class _FakeWorkers: + """Popen stand-in: each worker stays running for one poll, then exits.""" + + def __init__(self, failing=()): + self.started, self.active, self.peak, self.failing = [], {}, {}, set(failing) + outer = self + + class Worker: + pid = 7 + + def __init__(self, command, *, env, **kwargs): + self.entry, self.gpu, self.returncode, self.polls = command[0], env['CUDA_VISIBLE_DEVICES'], None, 0 + outer.started.append((self.entry, self.gpu)) + outer.active[self.gpu] = outer.active.get(self.gpu, 0) + 1 + outer.peak[self.gpu] = max(outer.peak.get(self.gpu, 0), outer.active[self.gpu]) + + def poll(self): + self.polls += 1 + if self.polls < 2: + return None + if self.returncode is None: + outer.active[self.gpu] -= 1 + self.returncode = int(self.entry in outer.failing) + return self.returncode + + self.module = __import__('types').SimpleNamespace(Popen=Worker, DEVNULL=subprocess.DEVNULL, STDOUT=subprocess.STDOUT) + + +def test_parallel_workers_order_long_entries_first_and_bound_each_gpu(tmp_path, monkeypatch): + fake = _FakeWorkers() + monkeypatch.setattr(cli, 'subprocess', fake.module) + monkeypatch.setattr(cli.time, 'sleep', lambda seconds: None) + methods = ['cone', 'ultraquery', 'trix-adapter', 'cqd', 'ultra-adapter', 'gnnqe', 'clmpt'] + jobs = [(f'e{i}-{method}', method, [f'e{i}-{method}'], tmp_path / f'{i}.log') for i, method in enumerate(methods)] + assert cli.run_workers(jobs, gpus=['0', 'GPU-a'], workers_per_gpu=2, status=tmp_path / 'status.json') == [] + order = [entry.split('-', 1)[1] for entry, _ in fake.started] + assert order[:4] == ['trix-adapter', 'ultra-adapter', 'gnnqe', 'cqd'] and sorted(order) == sorted(methods) + assert {gpu for _, gpu in fake.started} == {'0', 'GPU-a'} and max(fake.peak.values()) == 2 + assert json.loads((tmp_path / 'status.json').read_text())['running'] == {} + + +def test_parallel_failure_stops_new_entries_but_lets_running_workers_finish(tmp_path, monkeypatch): + fake = _FakeWorkers(failing={'a'}) + monkeypatch.setattr(cli, 'subprocess', fake.module) + monkeypatch.setattr(cli.time, 'sleep', lambda seconds: None) + jobs = [(name, 'cone', [name], tmp_path / f'{name}.log') for name in ('a', 'b', 'c')] + assert cli.run_workers(jobs, gpus=['0', '1'], workers_per_gpu=1, status=tmp_path / 'status.json') == [('a', 1)] + assert [entry for entry, _ in fake.started] == ['a', 'b'] + assert json.loads((tmp_path / 'status.json').read_text())['failed'] == ['a'] + + +def pilot_study(tmp_path): + """A frozen two-entry study and the fake worker processes that run its pilot in this process.""" + from types import SimpleNamespace + manifest = paper_fixture(tmp_path) + manifest['entries'].append(dict(manifest['entries'][0], id='second')) + study = tmp_path / 'study' + freeze(manifest, study / 'bundle', tmp_path) + seen = [] + + class Worker: + pid, returncode = 1, 0 + + def __init__(self, command, *, env, **kwargs): + entry = command[command.index('--entries') + 1] + device = command[command.index('--device') + 1] if '--device' in command else 'cuda' + seen.append((entry, env.get('CUDA_VISIBLE_DEVICES'), device)) + run_job(study / 'bundle', entry, tmp_path, study / 'pilot' / entry) + + def poll(self): + return 0 + + workers = SimpleNamespace(Popen=Worker, DEVNULL=subprocess.DEVNULL, STDOUT=subprocess.STDOUT) + return study, ['plus_h', 'run', '--phase', 'pilot', '--input-root', str(tmp_path), '--output', str(study)], workers, seen + + +def test_parallel_run_uses_fresh_workers_and_resumes_like_sequential_runs(tmp_path, monkeypatch): + study, args, workers, seen = pilot_study(tmp_path) + monkeypatch.setattr(cli, 'subprocess', workers) + args += ['--device', 'cuda'] + cli.main(args + ['--gpus', '3', '5']) + assert sorted(seen) == [('cone-fixture', '3', 'cuda'), ('second', '5', 'cuda')] + assert read(study / 'pilot/status.json') == dict(state='complete', entries=['cone-fixture', 'second']) + stamp = (study / 'pilot/second/result.json').stat().st_mtime_ns + cli.main(args + ['--gpus', '0', '--workers-per-gpu', '2']) + assert (study / 'pilot/second/result.json').stat().st_mtime_ns == stamp + for invalid in (['--gpus', '0', '0'], ['--gpus', '0', '--workers-per-gpu', '0'], ['--workers-per-gpu', '2']): + with pytest.raises(SystemExit): + cli.main(args + invalid) + with pytest.raises(SystemExit): + cli.main(args[:-2] + ['--device', 'cpu', '--gpus', '0']) + + +def test_container_forwards_parallel_gpus_only_for_evaluate_and_run(tmp_path, capsys): + common = ['--input-root', str(tmp_path), '--output', str(tmp_path / 'out'), *IMAGE] + cli.main(['plus_h', 'run', *common, '--gpus', '0', '1', 'GPU-2c', '--workers-per-gpu', '2']) + assert '--gpus 0 1 GPU-2c --workers-per-gpu 2' in capsys.readouterr().out + cli.main(['plus_h', 'evaluate', *common, '--gpus', '1']) + assert '--gpus 1' in capsys.readouterr().out + for command, extra in [('prepare', ['--gpus', '0']), ('run', ['--workers-per-gpu', '2']), ('run', ['--gpus'])]: + with pytest.raises(SystemExit): + cli.main(['plus_h', command, *common, *extra]) + + +def test_run_subsets_share_lock_and_resume_without_recomputing(tmp_path, monkeypatch, capsys): + from dicee.query_answering._checkpoint import BenchmarkCheckpoint, checksum + study, args, workers, seen = pilot_study(tmp_path) + monkeypatch.setattr(cli, 'subprocess', workers) + args += ['--device', 'cpu'] + cli.main(args + ['--entries', 'cone-fixture']) + first_result = study / 'pilot/cone-fixture/result.json' + stamp = first_result.stat().st_mtime_ns + assert not (study / 'pilot/second/result.json').exists() + cli.main(args + ['--entries', 'second']) + cli.main(args) + assert first_result.stat().st_mtime_ns == stamp + assert read(study / 'pilot/status.json')['entries'] == ['cone-fixture', 'second'] + identity = dict(bundle=checksum(study / 'bundle/bundle.json'), phase='pilot', device='cpu', pilot_queries=2) + with BenchmarkCheckpoint(study / 'pilot/suite', identity): + with pytest.raises(RuntimeError, match='already running'): + cli.main(args + ['--entries', 'second']) + assert [entry for entry, _, _ in seen] == ['cone-fixture', 'second', 'cone-fixture', 'second'] + with pytest.raises(SystemExit): + cli.main(args + ['--pilot-queries', '3']) + assert 'settings changed' in capsys.readouterr().err + + +def test_verification_runs_each_entry_in_a_fresh_process_and_requires_oracles(tmp_path, monkeypatch, capsys): + study = tmp_path / 'study' + manifest = paper_fixture(tmp_path) + manifest['entries'].append(dict(manifest['entries'][0], id='cqd-example', method='cqd', options={'atomic_negation': True})) + freeze(manifest, study / 'bundle', tmp_path) + references, comparisons = tmp_path / 'references', tmp_path / 'dense' + references.mkdir() + comparisons.mkdir() + args = ['plus_h', 'verify', '--input-root', str(tmp_path), '--output', str(study), '--references', str(references), + '--comparison-references', str(comparisons)] + + def rejected(message): + with pytest.raises(SystemExit): + cli.main(args) + assert message in capsys.readouterr().err + + rejected('Missing baseline oracle cone-fixture.pt') + for name in ('cone-fixture', 'cqd-example'): + (references / f'{name}.pt').touch() + rejected('Missing comparison oracle') + (comparisons / 'cqd-example.pt').touch() + commands = [] + + def parity(command): + commands.append(command) + evidence = command[command.index('--output') + 1] + cli.write_json(evidence, dict(passed=True)) + return subprocess.CompletedProcess(command, 0) + + monkeypatch.setattr(cli.subprocess, 'run', parity) + cli.main(args) + assert [command[command.index('--entry') + 1] for command in commands] == ['cone-fixture', 'cqd-example'] + assert all(command[5] == 'parity' for command in commands) + assert '--comparison-reference' in commands[1] and '--comparison-reference' not in commands[0] + verified = read(study / 'verified-manifest.json') + assert [entry['verification'] for entry in verified['entries']] == ['study/evidence/cone-fixture.json', 'study/evidence/cqd-example.json'] + assert (study / 'verified-bundle/bundle.json').is_file() + + +def test_container_rejects_retagged_image_before_launch(tmp_path, monkeypatch): + from benchmarks.cqa import docker + (tmp_path / 'container-image.json').write_text(json.dumps({'image_id': 'sha256:original'})) + monkeypatch.setattr(docker.subprocess, 'check_output', lambda *a, **k: json.dumps([{'Id': 'sha256:changed'}])) + launches = [] + monkeypatch.setattr(docker.subprocess, 'run', lambda *a, **k: launches.append(a)) + with pytest.raises(ValueError, match='Image differs'): + docker.run('example/plus-h:local', ['plus_h', 'verify'], inputs=tmp_path, results=tmp_path) + assert launches == [] diff --git a/benchmarks/cqa/tests/test_manifests.py b/benchmarks/cqa/tests/test_manifests.py new file mode 100644 index 000000000..be30c2654 --- /dev/null +++ b/benchmarks/cqa/tests/test_manifests.py @@ -0,0 +1,36 @@ +"""Compact public recipes resolve to exactly the pinned benchmark entries.""" + +import json +from pathlib import Path + +import pytest + +from benchmarks.cqa.manifests import REPO, expand, merge, read_manifest +from dicee.query_answering.context import fingerprint + +PINNED = json.loads(Path(__file__).with_name('recipe_fingerprints.json').read_text()) + + +@pytest.mark.parametrize('name', sorted(PINNED)) +def test_public_recipes_expand_to_the_pinned_entries(name): + """Any change to a public recipe must update recipe_fingerprints.json in the same review.""" + entries = read_manifest(REPO / 'benchmarks' / name)['entries'] + assert {entry['id']: fingerprint(entry) for entry in entries} == PINNED[name] + assert len(entries) == len(PINNED[name]) + + +def test_entries_merge_defaults_recursively_and_fill_dataset_ids(): + recipes = [{'defaults': {'id': 'm-{dataset}', 'method': 'm', 'options': {'a': 1, 'b': {'c': 2}}, 'query_types': ['1p', '2p']}, + 'entries': [{'dataset': 'x'}, {'dataset': 'y', 'id': 'custom', 'options': {'b': {'d': 3}}, 'query_types': ['1p']}]}] + assert expand(recipes) == [ + {'id': 'm-x', 'method': 'm', 'options': {'a': 1, 'b': {'c': 2}}, 'query_types': ['1p', '2p'], 'dataset': 'x'}, + {'id': 'custom', 'method': 'm', 'options': {'a': 1, 'b': {'c': 2, 'd': 3}}, 'query_types': ['1p'], 'dataset': 'y'}] + defaults = {'options': {'a': 1}} + assert merge(defaults, {'options': None}) == {'options': None} and defaults == {'options': {'a': 1}} + + +def test_resolved_and_bundled_manifests_read_unchanged(tmp_path): + manifest = dict(version=1, data_root='data', entries=[dict(id='a', method='cone', dataset='FB15k237+H')]) + (tmp_path / 'manifest.json').write_text(json.dumps(manifest)) + (tmp_path / 'bundle.json').write_text(json.dumps(dict(manifest=manifest, files={}))) + assert read_manifest(tmp_path / 'manifest.json') == read_manifest(tmp_path / 'bundle.json') == manifest diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py new file mode 100644 index 000000000..fd0c4aa2a --- /dev/null +++ b/benchmarks/cqa/tests/test_protocol.py @@ -0,0 +1,617 @@ +"""Paper protocol integrity, batch replay, and inference-free tie analysis.""" + +import itertools +import os +import pickle +import shutil +import sqlite3 +import subprocess +import sys +from pathlib import Path + +import numpy as np +import pytest +import torch + +from benchmarks.cqa.oracles import verify_predictions +from benchmarks.cqa.reports import export_reports, summarize_trace, trace_queries +from benchmarks.cqa.study import freeze, read, run_job, verify_bundle +from dicee.query_answering import BenchmarkQuery, QueryBenchmark, QueryContext +from dicee.query_answering._checkpoint import BenchmarkCheckpoint, write_json +from dicee.query_answering._query import PLUS_H_SHAPES, QUERY_SHAPES +from dicee.query_answering.benchmark import QueryMetrics, evaluate_benchmark +from dicee.query_answering.context import state_fingerprint +from dicee.query_answering.datasets import dataset_spec +from dicee.query_answering.methods import ConE +from dicee.query_answering.score_adapter import QueryScoreAdapter + + +def plus_h_fixture(root, name): + folder = root / dataset_spec(name)[1] + folder.mkdir(parents=True) + graph = folder / 'KG_splits' if name == 'ICEWS18+H' else folder + graph.mkdir(exist_ok=True) + for split, triples in [('train', [(0, 0, 1), (1, 2, 2)]), ('valid', [(0, 0, 3), (3, 2, 4)]), + ('test', [(0, 0, 5), (5, 2, 6)])]: + inverse = [(t, r + 1, h) for h, r, t in triples] + (graph / f'{split}.txt').write_text(''.join(f'{h}\t{r}\t{t}\n' for h, r, t in triples + inverse)) + def dump(name, value): + (folder / name).write_bytes(pickle.dumps(value)) + dump('id2ent.pkl', {i: str(i) for i in range(8)}) + dump('id2rel.pkl', {i: str(i) for i in range(4)}) + def instantiate(shape, counts): + if shape in ('n', 'u'): + return -2 if shape == 'n' else -1 + if shape in ('e', 'r'): + index = 0 if shape == 'e' else 1 + value = counts[index] + counts[index] += 1 + return value % (8 if index == 0 else 4) + return tuple(instantiate(part, counts) for part in shape) + queries = {QUERY_SHAPES[name]: {instantiate(QUERY_SHAPES[name], [0, 0])} for name in PLUS_H_SHAPES} + for split, hard in [('valid', {3, 4}), ('test', {5, 6})]: + dump(f'{split}-queries.pkl', queries) + dump(f'{split}-easy-answers.pkl', {q: {1, 7} for group in queries.values() for q in group}) + dump(f'{split}-hard-answers.pkl', {q: hard for group in queries.values() for q in group}) + + +@pytest.fixture(autouse=True) +def threads(): + previous = torch.get_num_threads() + torch.set_num_threads(2) + yield + torch.set_num_threads(previous) + + +def small_data(): + queries = tuple(BenchmarkQuery('1p', (i, (0,)), frozenset({0}), frozenset({1, 2})) for i in range(6)) + return QueryBenchmark('test', 'transductive', 'valid', QueryContext([(0, 0, 1)], 6, 1), queries, tuple(range(6))) + + +def test_resume_preserves_completed_cache_report_and_resets_live_cache(tmp_path): + data, stats = small_data(), {} + options = dict(checkpoint_dir=tmp_path / 'resume', checkpoint_identity='fixed', checkpoint_every=3) + calls = 0 + + def predict(query): + nonlocal calls + calls += 1 + if calls == 5: + raise RuntimeError('interrupted') + stats['raw_rows'] = stats.get('raw_rows', 0) + 1 + stats.update(cache_bytes=256, cache_peak_bytes=256) + return torch.arange(6).float() + + with pytest.raises(RuntimeError, match='interrupted'): + evaluate_benchmark(data, predict, statistics=stats, **options) + stats, observations = {}, [] + + def resumed_predict(query): + stats['raw_rows'] += 1 + stats['cache_bytes'] = 128 + return torch.arange(6).float() + + report = evaluate_benchmark(data, resumed_predict, statistics=stats, + progress=lambda *_: observations.append(stats['cache_bytes']), **options) + assert observations[0] == 0 + assert stats == dict(raw_rows=6, cache_bytes=128, cache_peak_bytes=256) + replayed_stats = {} + replayed = evaluate_benchmark(data, lambda _: pytest.fail('Completed queries were rescored'), + statistics=replayed_stats, **options) + assert replayed['per_shape'] == report['per_shape'] + assert replayed_stats == stats + + +def test_trix_completed_resume_preserves_cache_statistics(tmp_path, monkeypatch): + from dicee.models import TRIX + from dicee.query_answering import QueryAnswerer, benchmark_model + + model = TRIX(dict(num_entities=1, num_relations=1, trix_dim=8)) + options = dict(beam_size=2, row_batch_size=4, checkpoint_dir=tmp_path / 'trix', checkpoint_every=3) + report = benchmark_model(model, small_data(), **options) + assert report['inference']['statistics']['cache_bytes'] > 0 + monkeypatch.setattr(QueryAnswerer, 'predict', lambda *a, **k: pytest.fail('Completed queries were rescored')) + resumed = benchmark_model(model, small_data(), **options) + assert resumed['per_shape'] == report['per_shape'] + assert resumed['inference']['statistics'] == report['inference']['statistics'] + assert model.query_batch_size == 8 and model.training and model.graph_triples is None + + +def test_kgfm_determinism_is_strict_and_restores_caller_state(): + from dicee.query_answering.method_evaluation import deterministic_kgfm + enabled = torch.are_deterministic_algorithms_enabled() + warning = torch.is_deterministic_algorithms_warn_only_enabled() + try: + torch.use_deterministic_algorithms(False, warn_only=True) + with pytest.raises(RuntimeError, match='probe'): + with deterministic_kgfm(): + assert torch.are_deterministic_algorithms_enabled() + assert not torch.is_deterministic_algorithms_warn_only_enabled() + raise RuntimeError('probe') + assert not torch.are_deterministic_algorithms_enabled() + assert torch.is_deterministic_algorithms_warn_only_enabled() + finally: + torch.use_deterministic_algorithms(enabled, warn_only=warning) + + +def test_one_sort_and_exact_uniform_tie_expectation(monkeypatch): + calls = 0 + original = torch.Tensor.argsort + + def counted(*args, **kwargs): + nonlocal calls + calls += 1 + return original(*args, **kwargs) + + monkeypatch.setattr(torch.Tensor, 'argsort', counted) + scores = torch.tensor([.8, .5, .5, .5, .2, .5]) + metrics, records = QueryMetrics(6, candidates=[0, 1, 2, 3, 4]).evaluate(scores, {0}, {1, 2}, records=True) + assert calls == 1 + assert [row[2:] for row in records] == [[0, 2], [0, 2]] + permutations = list(itertools.permutations([1, 2, 3])) + rr = [] + for order in permutations: + rr.append(np.mean([1 / (1 + sum(x == 3 for x in order[:order.index(target)])) for target in (1, 2)])) + assert metrics['expected']['mrr'] == pytest.approx(np.mean(rr)) + assert metrics['expected']['mrr'] == .75 + + +def test_trace_resume_replays_whole_batch_and_truncates_uncheckpointed_rows(tmp_path, monkeypatch): + data, prepared, seen = small_data(), {}, [] + + def prepare(queries): + seen.append(tuple(queries)) + values = torch.arange(6).float().remainder(1 + len(queries)) + prepared.update({query: values for query in queries}) + + options = dict(query_plan=data.queries, batch_ends=[3, 6], prepare=prepare, checkpoint_every=2, + checkpoint_dir=tmp_path / 'progress', checkpoint_identity={'model': 'batch-dependent'}, + rank_trace_path=tmp_path / 'ranks.sqlite3', additional_tie_policies=('expected',)) + original = BenchmarkCheckpoint.save + + def fail_after_trace_commit(self, state): + if state['completed'] == 6: + raise RuntimeError('power loss') + original(self, state) + + monkeypatch.setattr(BenchmarkCheckpoint, 'save', fail_after_trace_commit) + with pytest.raises(RuntimeError, match='power loss'): + evaluate_benchmark(data, lambda query: prepared[query], **options) + saved = read(tmp_path / 'progress' / 'state.json')['state'] + assert saved['completed'] == 3 + with sqlite3.connect(tmp_path / 'ranks.sqlite3') as connection: + assert connection.execute('SELECT COUNT(*) FROM queries').fetchone()[0] == 6 + monkeypatch.setattr(BenchmarkCheckpoint, 'save', original) + resumed = evaluate_benchmark(data, lambda query: prepared[query], **options) + assert [len(batch) for batch in seen] == [3, 3, 3] + assert seen[1] == seen[2] + rows = list(trace_queries(tmp_path / 'ranks.sqlite3')) + assert len(rows) == 6 and len({row['query_id'] for row in rows}) == 6 + summary = summarize_trace(tmp_path / 'ranks.sqlite3', bootstrap_samples=20) + assert summary['averages']['sort']['all']['mrr'] == resumed['averages']['all']['mrr'] + assert summary['averages']['expected']['all']['mrr'] == resumed['additional_tie_metrics']['expected']['averages']['all']['mrr'] + + +def paper_fixture(tmp_path): + data_root = tmp_path / 'data' + plus_h_fixture(data_root, 'FB15k237+H') + context = QueryContext([(0, 0, 1)], 8, 4) + model = ConE(context, dim=8, gamma=12, center_reg=.02, projection_dim=16) + torch.save(model.state_dict(), tmp_path / 'cone.pt') + entry = dict(id='cone-fixture', method='cone', dataset='FB15k237+H', checkpoint='cone.pt', + options={'center_reg': .02}, query_types=list(PLUS_H_SHAPES), query_batch_size=1, + query_order='upstream-pickle', reference={'status': 'test fixture'}, blockers=[]) + manifest = dict(version=1, data_root='data', seed=0, threads=2, archives={}, entries=[entry]) + return manifest + + +@pytest.mark.parametrize('name', ('FB15k237+H', 'NELL995+H', 'ICEWS18+H')) +def test_graph_conditions_keep_labels_fixed_and_never_read_test_edges(tmp_path, name): + from dicee.query_answering.datasets import load_benchmark + plus_h_fixture(tmp_path, name) + train = load_benchmark(tmp_path, name, inference_graph='train') + extended = load_benchmark(tmp_path, name, inference_graph='train+valid') + assert load_benchmark(tmp_path, name).context == extended.context + assert extended.metadata['inference_graph'] == 'train+valid' + assert set(train.context.triples) < set(extended.context.triples) + assert (0, 0, 3) not in train.context.triples and (0, 0, 3) in extended.context.triples + assert train.queries == extended.queries + assert [q.identity for q in train.queries] == [q.identity for q in extended.queries] + assert 'valid.txt' not in {Path(p).name for p in train.metadata['files']} + path = tmp_path / dataset_spec(name)[1] + graph = path / 'KG_splits' if name == 'ICEWS18+H' else path + (graph / 'test.txt').write_text('unreadable target triples') + assert load_benchmark(tmp_path, name, inference_graph='train+valid').context == extended.context + assert load_benchmark(tmp_path, name, split='valid', inference_graph='train+valid').context == train.context + assert load_benchmark(tmp_path, name, split='valid').context == train.context + + +def test_graph_conditions_pin_distinct_contexts_and_identical_query_plans(tmp_path): + from benchmarks.cqa.study import dataset_key + manifest = paper_fixture(tmp_path) + entry = manifest['entries'][0] + entry.update(inference_graph='train', graph_ablation='paired') + manifest['entries'].append(dict(entry, id='extended', inference_graph='train+valid')) + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + other = manifest['entries'][1] + assert bundle['datasets'][dataset_key(entry, 'test')]['context'] != bundle['datasets'][dataset_key(other, 'test')]['context'] + assert dataset_key(entry, 'valid') == dataset_key(other, 'valid') + for split in ('valid', 'test'): + assert bundle['plans'][f'{entry["id"]}/{split}'] == bundle['plans'][f'{other["id"]}/{split}'] + assert len(bundle['datasets']) == 3 + + +def test_implicit_test_graph_matches_explicit_train_valid_bundle(tmp_path): + from benchmarks.cqa.study import dataset_key + manifest = paper_fixture(tmp_path) + entry = manifest['entries'][0] + explicit = dict(entry, id='explicit', inference_graph='train+valid') + manifest['entries'].append(explicit) + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + assert dataset_key(entry, 'test') == dataset_key(explicit, 'test') == 'FB15k237+H/test/train+valid' + assert len(bundle['datasets']) == 2 + assert bundle['datasets'][dataset_key(entry, 'test')]['metadata']['inference_graph'] == 'train+valid' + assert bundle['plans'][f'{entry["id"]}/test'] == bundle['plans'][f'{explicit["id"]}/test'] + + +def test_direct_evaluation_rejects_supplied_wrong_graph(tmp_path): + from dicee.query_answering.datasets import load_benchmark + from dicee.query_answering.method_evaluation import evaluate_method + paper_fixture(tmp_path) + data = load_benchmark(tmp_path / 'data', 'FB15k237+H', inference_graph='train+valid') + with pytest.raises(ValueError, match='requested inference graph'): + evaluate_method(dict(method='cone', dataset='FB15k237+H', inference_graph='train'), + output=tmp_path / 'result', data=data) + + +def test_baseline_filter_control_keeps_inference_and_graph_metadata(tmp_path): + from dicee.query_answering.datasets import load_benchmark + from dicee.query_answering.method_evaluation import evaluate_method + manifest = paper_fixture(tmp_path) + data = load_benchmark(tmp_path / 'data', 'FB15k237+H', query_types=['2in'], inference_graph='train') + entry = manifest['entries'][0] + recipe = dict(method='cone', dataset=entry['dataset'], vocabulary_dataset=entry['dataset'], + root=str(tmp_path / 'data'), checkpoint=str(tmp_path / entry['checkpoint']), + options=entry['options'], query_types=['2in'], inference_graph='train') + report = evaluate_method(recipe, output=tmp_path / 'evaluation', data=data, filter_corrections={}) + control = read(tmp_path / 'evaluation/released-filters/result.json') + assert report['inference'] == control['inference'] + assert report['per_shape'] == control['per_shape'] + assert report['protocol']['answer_filter'] == 'corrected' + assert control['protocol']['answer_filter'] == 'released' + assert 'paired_with' not in control + assert control['filter_paired_with'] == report['benchmark_run']['entry'] + + +def test_filter_audit_preserves_targets_and_keeps_test_facts_out_of_context(tmp_path): + from dataclasses import replace + + from dicee.query_answering.datasets import audit_plus_h_filters + plus_h_fixture(tmp_path, 'FB15k237+H') + query = BenchmarkQuery('2in', ((0, (0,)), (1, (2, -2))), frozenset({1, 2, 3}), frozenset({5})) + other = BenchmarkQuery('3in', ((0, (0,)), (0, (0,)), (1, (2, -2))), frozenset({1, 3}), frozenset({5})) + folder = tmp_path / dataset_spec('FB15k237+H')[1] / 'test-query-reduction/2in/all' + folder.mkdir(parents=True) + for kind, value in [('queries', {QUERY_SHAPES['2in']: {query.query}}), + ('easy-answers', {query.query: {1, 3}}), ('hard-answers', {query.query: {5}})]: + (folder / f'test-{kind}.pkl').write_bytes(pickle.dumps(value)) + data = QueryBenchmark('FB15k237+H', 'transductive', 'test', QueryContext([(0, 0, 1)], 8, 4), + (query, other), tuple(range(8))) + audit = audit_plus_h_filters(tmp_path, data) + assert audit['changes'] == {query.identity: {'remove': [2], 'add': []}} + assert audit['per_shape']['3in']['changed_queries'] == 0 + assert audit['per_shape']['3in']['hard_answers'] == 1 + assert data.context.triples == ((0, 0, 1),) + invalid = replace(data, queries=(replace(query, hard=frozenset({6})),)) + with pytest.raises(ValueError, match='hard targets'): + audit_plus_h_filters(tmp_path, invalid) + (folder / 'test-easy-answers.pkl').write_bytes(pickle.dumps({query.query: {1, 2, 3}})) + with pytest.raises(ValueError, match='filters disagree with full-graph truth'): + audit_plus_h_filters(tmp_path, data) + + +def test_frozen_filter_corrections_reject_tampering(tmp_path, monkeypatch): + import dicee.query_answering.datasets as datasets + manifest = paper_fixture(tmp_path) + manifest['answer_filter'] = 'corrected' + monkeypatch.setattr(datasets, 'audit_plus_h_filters', lambda *args: dict(changes={}, per_shape={}, source_files={})) + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + verify_bundle(tmp_path / 'bundle', tmp_path) + correction = bundle['filter_corrections']['FB15k237+H'] + (tmp_path / 'bundle' / correction['path']).write_text('{}') + with pytest.raises(ValueError, match='Answer-filter correction checksum'): + verify_bundle(tmp_path / 'bundle', tmp_path) + + +def use_ultraquery_fixture(manifest, root): + from dicee.query_answering._query import ULTRAQUERY_SHAPES + data = root / manifest['data_root'] + source = data / dataset_spec('FB15k237+H')[1] + destination = data / dataset_spec('FB15k237LogicalQuery')[1] + shutil.copytree(source, destination) + for split in ('valid', 'test'): + path = destination / f'{split}-queries.pkl' + queries = pickle.loads(path.read_bytes()) + path.write_bytes(pickle.dumps({QUERY_SHAPES[shape]: queries[QUERY_SHAPES[shape]] for shape in ULTRAQUERY_SHAPES})) + for entry in manifest['entries']: + entry.update(dataset='FB15k237LogicalQuery', query_types=list(ULTRAQUERY_SHAPES)) + + +def test_shared_study_and_reports_use_dataset_coverage(tmp_path): + from benchmarks.cqa.cli import main + from dicee.query_answering.method_evaluation import evaluate_method + manifest = paper_fixture(tmp_path) + use_ultraquery_fixture(manifest, tmp_path) + frozen = freeze(manifest, tmp_path / 'bundle', tmp_path) + assert len(frozen['plans']) == 2 + entry = manifest['entries'][0] + root = str(tmp_path / manifest['data_root']) + recipe = dict(method='cone', dataset=entry['dataset'], vocabulary_dataset=entry['dataset'], root=root, + checkpoint=str(tmp_path / entry['checkpoint']), options=entry['options'], query_types=entry['query_types']) + # A direct evaluation can be reported without requiring a +H recipe. + result = evaluate_method(recipe, output=tmp_path / 'direct', split='test') + assert result['queries'] == 14 and result['protocol']['all_benchmark_shapes'] + pilot = run_job(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'pilot') + assert pilot['queries'] == 14 and pilot['coverage']['complete_benchmark_types'] + assert not pilot['coverage']['complete_16_types'] + assert frozen['datasets']['FB15k237LogicalQuery/valid']['context'] == frozen['datasets']['FB15k237LogicalQuery/test']['context'] + assert result['benchmark_run']['mode'] == 'direct' + published = tmp_path / 'published.json' + write_json(published, {'source': 'fixture', 'datasets': {entry['dataset']: {'cone': dict.fromkeys(entry['query_types'], 10.)}}}) + rows = export_reports(tmp_path / 'direct', published, tmp_path / 'reports', bootstrap_samples=0) + assert rows[0]['complete_test'] and not rows[0]['complete_16_type_test'] + assert rows[0]['types'] == 14 and rows[0]['published_mrr'] == 10. + write_json(tmp_path / 'manifest.json', manifest) + main(['ultraquery', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + '--output', str(tmp_path / 'cli'), '--entries', entry['id'], '--device', 'cpu']) + cli = read(tmp_path / 'cli' / entry['id'] / 'result.json') + assert cli['per_shape'] == result['per_shape'] + assert cli['additional_tie_metrics'] == result['additional_tie_metrics'] + + +@pytest.mark.parametrize('query_order', ('canonical', 'relation', 'upstream-pickle')) +def test_corrected_filter_cli_preserves_query_type_selection(tmp_path, query_order): + from benchmarks.cqa.cli import main + manifest = paper_fixture(tmp_path) + manifest['answer_filter'] = 'corrected' + entry = manifest['entries'][0] + entry.update(query_types=['1p'], query_order=query_order) + write_json(tmp_path / 'manifest.json', manifest) + main(['plus_h', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + '--output', str(tmp_path / 'cli'), '--entries', entry['id'], '--device', 'cpu']) + destination = tmp_path / 'cli' / entry['id'] + result = read(destination / 'result.json') + control = read(destination / 'released-filters/result.json') + assert result['queries'] == control['queries'] == 1 + assert set(result['per_shape']) == set(control['per_shape']) == {'1p'} + assert result['per_shape'] == control['per_shape'] + assert result['protocol']['answer_filter'] == 'corrected' + assert control['protocol']['answer_filter'] == 'released' + + +def test_frozen_inputs_pipeline_pilot_and_offline_report(tmp_path): + manifest = paper_fixture(tmp_path) + bundle = tmp_path / 'bundle' + frozen = freeze(manifest, bundle, tmp_path) + assert len(frozen['datasets']) == 2 + assert len(verify_bundle(bundle, tmp_path)['files']) == 11 + output = tmp_path / 'results' / 'cone-fixture' + report = run_job(bundle, 'cone-fixture', tmp_path, output) + assert report['queries'] == 16 and report['split'] == 'valid' + assert report['protocol']['all_benchmark_shapes'] + assert run_job(bundle, 'cone-fixture', tmp_path, output) == report + published = tmp_path / 'published.json' + write_json(published, dict(source='fixture', datasets={'FB15k237+H': {'cone': dict.fromkeys(PLUS_H_SHAPES, 10.)}})) + rows = export_reports(tmp_path / 'results', published, tmp_path / 'tables', bootstrap_samples=10) + assert rows[0]['published_mrr'] is None + assert not rows[0]['complete_16_type_test'] + with pytest.raises(ValueError, match='parity evidence'): + run_job(bundle, 'cone-fixture', tmp_path, tmp_path / 'test', phase='test') + (tmp_path / 'cone.pt').write_bytes(b'changed') + with pytest.raises(ValueError, match='checksum mismatch'): + verify_bundle(bundle, tmp_path) + + +def test_plan_tampering_and_no_overwrite(tmp_path): + manifest = paper_fixture(tmp_path) + bundle = tmp_path / 'bundle' + frozen = freeze(manifest, bundle, tmp_path) + with pytest.raises(FileExistsError, match='new bundle'): + freeze(manifest, bundle, tmp_path) + plan = bundle / frozen['plans']['cone-fixture/test']['path'] + value = read(plan) + value['queries'].reverse() + write_json(plan, value) + with pytest.raises(ValueError, match='plan checksum'): + verify_bundle(bundle, tmp_path) + + +def test_probe_selection_preserves_full_encoding_batches(tmp_path, monkeypatch): + manifest = paper_fixture(tmp_path) + manifest['entries'][0]['query_batch_size'] = 4 + path = next((tmp_path / 'data').rglob('valid-queries.pkl')).parent + query = (4, (0,)) + for filename, update in ( + ('queries', lambda value: next(group for shape, group in value.items() if shape == ('e', ('r',))).add(query)), + ('easy-answers', lambda value: value.update({query: {1, 7}})), + ('hard-answers', lambda value: value.update({query: {3, 4}})), + ): + target = path / f'valid-{filename}.pkl' + value = pickle.loads(target.read_bytes()) + update(value) + target.write_bytes(pickle.dumps(value)) + calls = [] + original = ConE.encode_trees + + def coupled(self, trees): + calls.append(tuple(trees)) + return [branch + branch.mean(0, keepdim=True) for branch in original(self, trees)] + + monkeypatch.setattr(ConE, 'encode_trees', coupled) + bundle = tmp_path / 'bundle' + freeze(manifest, bundle, tmp_path) + full, probes = {}, {} + run_job(bundle, 'cone-fixture', tmp_path, tmp_path / 'full-pilot', pilot_queries=1, + on_prediction=lambda query, scores: full.update({query.query: scores.clone()})) + full_calls = calls.copy() + calls.clear() + report = run_job(bundle, 'cone-fixture', tmp_path, tmp_path / 'probe', pilot_queries=1, probe_only=True, + on_prediction=lambda query, scores: probes.update({query.query: scores.clone()})) + assert len(full) == 17 and len(probes) == report['queries'] == 16 + assert calls == full_calls + assert max(map(len, calls)) == 2 + assert all(torch.equal(score, full[query]) for query, score in probes.items()) + from dicee.query_answering.method_evaluation import evaluate_method + calls.clear() + direct = {} + entry = manifest['entries'][0] + recipe = dict(method='cone', checkpoint=str(tmp_path / entry['checkpoint']), + root=str(tmp_path / 'data'), dataset=entry['dataset'], vocabulary_dataset=entry['dataset'], + options=entry['options'], query_types=entry['query_types'], query_batch_size=4) + report = evaluate_method(recipe, output=tmp_path / 'direct', split='valid', limit=1, + query_order='upstream-pickle', + on_prediction=lambda query, scores: direct.update({query: scores.clone()})) + assert calls == full_calls and len(direct) == report['queries'] == 16 + assert all(torch.equal(score, full[query]) for query, score in direct.items()) + with pytest.raises(ValueError, match='validation pilots'): + run_job(bundle, 'cone-fixture', tmp_path, tmp_path / 'test', phase='test', probe_only=True) + + +def test_checked_in_protocol_settings(): + from benchmarks.cqa.manifests import read_manifest, suite_directory + root = suite_directory('plus_h') + manifest = read_manifest(root / 'baselines.json') + assert len(manifest['entries']) == 21 + by_id = {entry['id']: entry for entry in manifest['entries']} + assert by_id['cqd-FB15k237+H']['options']['per_shape']['2p']['beam_size'] == 512 + assert by_id['cqd-FB15k237+H']['options']['per_shape']['pi']['beam_size'] == 256 + assert by_id['cqd-hybrid-ICEWS18+H']['options']['per_shape']['4p']['max_k'] == 64 + assert by_id['cqd-FB15k237+H']['options']['reference_batching'] + for method in ('cqd', 'cqd-hybrid'): + assert by_id[f'{method}-FB15k237+H']['options']['per_shape']['2u']['tnorm'] == 'prod' + assert by_id['cone-ICEWS18+H']['query_batch_size'] == 4 + assert by_id['gnnqe-NELL995+H']['query_batch_size'] == 8 + assert by_id['ultraquery-FB15k237+H']['query_batch_size'] == 32 + assert by_id['clmpt-FB15k237+H']['query_batch_size'] == 5000 + assert by_id['clmpt-NELL995+H']['query_batch_size'] == 8 + for method in ('cqd', 'cqd-hybrid'): + for dataset in ('FB15k237+H', 'ICEWS18+H', 'NELL995+H'): + entry = by_id[f'{method}-{dataset}'] + assert len(entry['query_types']) == 16 + assert entry['options']['atomic_negation'] + published = read(root / 'published_results.json') + assert sum(published['datasets']['FB15k237+H']['ultraquery'].values()) / 16 == pytest.approx(9.6) + + +def test_rank_trace_rejects_missing_committed_answers(tmp_path): + data = small_data() + options = dict(checkpoint_dir=tmp_path / 'progress', checkpoint_identity={'a': 1}, rank_trace_path=tmp_path / 'ranks.sqlite3') + evaluate_benchmark(data, lambda query: torch.zeros(6), **options) + with sqlite3.connect(tmp_path / 'ranks.sqlite3') as connection: + connection.execute('DELETE FROM queries WHERE position=2') + with pytest.raises(ValueError, match='missing checkpointed'): + evaluate_benchmark(data, lambda query: torch.zeros(6), **options) + + +def test_invalid_batch_boundaries(tmp_path): + data = small_data() + for ends in ([2, 4], [3, 3, 6], [0, 6], [6, 3]): + with pytest.raises(ValueError, match='batch boundaries'): + evaluate_benchmark(data, lambda query: torch.zeros(6), query_plan=data.queries, batch_ends=ends) + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_CONE_REFERENCE'), reason='Set DICEE_CONE_REFERENCE to the pinned upstream checkout') +def test_independent_exporter_parity_and_full_run(tmp_path): + manifest = paper_fixture(tmp_path) + bundle = tmp_path / 'bundle' + freeze(manifest, bundle, tmp_path) + reference = tmp_path / 'reference.pt' + subprocess.run([sys.executable, str(Path(__file__).parents[1] / 'verification' / 'export_reference.py'), + '--bundle', str(bundle), '--input-root', str(tmp_path), '--entry', 'cone-fixture', + '--upstream', os.environ['DICEE_CONE_REFERENCE'], '--output', str(reference)], check=True) + evidence = verify_predictions(bundle, 'cone-fixture', tmp_path, reference, tmp_path / 'parity.json') + assert evidence['passed'] and len(evidence['queries']) == 16 + manifest['entries'][0]['verification'] = 'parity.json' + freeze(manifest, tmp_path / 'verified-bundle', tmp_path) + report = run_job(tmp_path / 'verified-bundle', 'cone-fixture', tmp_path, tmp_path / 'full', phase='test') + assert report['protocol']['full_split'] and report['coverage']['complete_16_types'] + assert report['split'] == 'test' + + +@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +def test_provisional_kgfm_pipeline_and_finalization_guard(tmp_path, backbone): + from dicee.models import TRIX, ULTRA + manifest = paper_fixture(tmp_path) + model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) + torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + for operator in ('product', 'min'): + adapter = QueryScoreAdapter('global', observed_mix=1, metadata=dict( + backbone_state_sha256=state_fingerprint(model), training={} if operator == 'product' else {'tnorm': 'min'})) + adapter.save(tmp_path / f'{operator}.json') + entry = manifest['entries'][0] + entry.update(id=f'{backbone}-fixture', method=f'{backbone}-adapter', checkpoint='kgfm.pt', options={'beam_size': 2, 'cache_bytes': 4096}, + adapters={operator: f'{operator}.json' for operator in ('product', 'min')}, + operators={shape: 'min' if 'n' in shape else 'product' for shape in PLUS_H_SHAPES}, + selection_protocol='source-validation', finalized=False, query_batch_size=4, query_order='relation') + freeze(manifest, tmp_path / 'bundle', tmp_path) + result = run_job(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'pilot') + assert result['queries'] == 16 + assert result['inference']['selection_protocol'] == 'source-validation' + assert len(list(trace_queries(tmp_path / 'pilot' / 'ranks.sqlite3'))) == 16 + with pytest.raises(ValueError, match='not ready'): + run_job(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'test', phase='test') + + +def test_comparison_does_not_relax_reference_verification(tmp_path, monkeypatch): + import benchmarks.cqa.oracles as verification + from benchmarks.cqa.study import entry_inputs_identity + from dicee.query_answering.context import fingerprint + from dicee.query_answering.datasets import load_benchmark + from dicee.query_answering.methods import REFERENCES + manifest = paper_fixture(tmp_path) + entry = manifest['entries'][0] + entry['query_types'] = ['1p'] + entry['inference_graph'] = 'train' + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + query = next(q for q in load_benchmark(tmp_path / 'data', 'FB15k237+H', split='valid').queries if q.shape == '1p') + key = query.identity + scores = torch.arange(8).float() + oracle = dict(version=1, entry_sha256=fingerprint(entry), inputs_sha256=entry_inputs_identity(bundle, entry), + validation_plan_sha256=bundle['plans'][entry['id'] + '/valid']['sha256'], + reference_commit=REFERENCES['cone'][1], environment=dict.fromkeys( + ('python', 'torch', 'cuda', 'gpu', 'driver', 'precision', 'threads'), 'fixture'), + graphs={split: bundle['datasets'][f'{entry["dataset"]}/{split}']['context'] for split in ('valid', 'test')}, + pilot_queries=1, probe_only=True, scores={key: scores}, orders={key: scores.argsort(descending=True)}) + torch.save(oracle, tmp_path / 'declared.pt') + previous = scores.clone() + previous[3] = 20 + control = dict(oracle, scores={key: previous}, orders={key: previous.argsort(descending=True)}) + torch.save(control, tmp_path / 'dense.pt') + + def run(*args, on_prediction, **kwargs): + on_prediction(query, scores) + return {'benchmark_run': {'environment': oracle['environment']}} + + monkeypatch.setattr(verification, 'run_job', run) + result = verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'declared.pt', + tmp_path / 'parity.json', comparison_reference=tmp_path / 'dense.pt') + assert result['passed'] + comparison = result['upstream_comparison'] + assert not comparison['queries'][key]['ranks_match'] + assert comparison['delta_macro']['sort']['mrr'] != 0 + assert comparison['delta_macro']['expected']['mrr'] != 0 + scores = previous + failed = verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'declared.pt', + tmp_path / 'failed.json', comparison_reference=tmp_path / 'dense.pt') + assert not failed['passed'] + control['inputs_sha256'] = 'different inputs' + torch.save(control, tmp_path / 'dense.pt') + with pytest.raises(ValueError, match='Comparison reference uses different'): + verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'declared.pt', + tmp_path / 'invalid.json', comparison_reference=tmp_path / 'dense.pt') + oracle['graphs']['test'] = 'wrong graph' + torch.save(oracle, tmp_path / 'wrong-graph.pt') + with pytest.raises(ValueError, match='Reference inference graphs differ'): + verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'wrong-graph.pt', + tmp_path / 'wrong-graph.json') diff --git a/benchmarks/cqa/tests/test_ultraquery_launcher.py b/benchmarks/cqa/tests/test_ultraquery_launcher.py new file mode 100644 index 000000000..2110a6d9b --- /dev/null +++ b/benchmarks/cqa/tests/test_ultraquery_launcher.py @@ -0,0 +1,240 @@ +"""Shared launch interface, independent input reading, and final-run parity gates.""" + +import json +import os +import pickle +import subprocess +import sys + +import pytest +import torch + +from benchmarks.cqa import cli, docker +from benchmarks.cqa.manifests import REPO, SUITES, prepare_manifest, read_manifest, suite_directory, validate_entry +from benchmarks.cqa.oracles import verify_predictions +from benchmarks.cqa.study import dataset_key, entry_inputs_identity, freeze, run_job +from benchmarks.cqa.verification import export_reference as exporter +from dicee.query_answering import BENCHMARK_DATASETS, QueryContext, load_benchmark +from dicee.query_answering._query import QUERY_SHAPES, ULTRAQUERY_SHAPES +from dicee.query_answering.context import fingerprint +from dicee.query_answering.datasets import dataset_spec +from dicee.query_answering.methods import REFERENCES, UltraQuery + +PUBLIC = suite_directory('ultraquery') + + +@pytest.fixture(autouse=True) +def threads(): + previous = torch.get_num_threads() + torch.set_num_threads(2) + yield + torch.set_num_threads(previous) + + +def fixture(root, name): + group, folder, _ = dataset_spec(name) + path = root / 'data' / folder + path.mkdir(parents=True) + pairs = ((0, 1), (2, 3)) if group == 'transductive' else ((0, 2), (1, 3)) + + def graph(stem, direct): + triples = QueryContext(direct, 8, 4, pairs).triples + (path / f'{stem}.txt').write_text(''.join(f'{h}\t{r}\t{t}\n' for h, r, t in triples)) + + def dump(filename, value): + (path / filename).write_bytes(pickle.dumps(value)) + + train = [(0, 0, 1), (1, 2 if group == 'transductive' else 1, 2), (2, 0, 3)] + if group == 'transductive': + graph('train', train) + dump('id2ent.pkl', {i: str(i) for i in range(8)}) + dump('id2rel.pkl', {i: str(i) for i in range(4)}) + else: + graph('train_graph', train) + if group == 'inductive-e': + graph('val_inference', [(2, 1, 5)]) + graph('test_inference', [(2, 1, 6)]) + else: + graph('test_inference', [(0, 1, 3), (3, 0, 1), (1, 1, 2)]) + + def instantiate(shape, counts): + if shape in ('n', 'u'): + return -2 if shape == 'n' else -1 + if shape in ('e', 'r'): + i = int(shape == 'r') + value = counts[i] + counts[i] += 1 + return value % (4 if i else 8) + return tuple(instantiate(part, counts) for part in shape) + + queries = {QUERY_SHAPES[s]: {instantiate(QUERY_SHAPES[s], [0, 0])} for s in ULTRAQUERY_SHAPES} + for split in ('valid', 'test'): + if group == 'transductive': + dump(f'{split}-queries.pkl', queries) + dump(f'{split}-easy-answers.pkl', {q: {1} for qs in queries.values() for q in qs}) + dump(f'{split}-hard-answers.pkl', {q: {3} for qs in queries.values() for q in qs}) + else: + dump(f'{split}_queries.pkl', queries) + dump(f'{split}_answers_easy.pkl', {s: {q: {1} for q in qs} for s, qs in queries.items()}) + dump(f'{split}_answers_hard.pkl', {s: {q: {3} for q in qs} for s, qs in queries.items()}) + data = load_benchmark(root / 'data', name, split='valid') + model = UltraQuery(data.context, dim=8, num_layers=2) + torch.save({'model': {'model.model.' + k: v for k, v in model.state_dict().items()}}, root / 'model.pt') + entry = dict(id='ultraquery-fixture', method='ultraquery', dataset=name, checkpoint='model.pt', + options={'threshold': 0., 'logic': 'product'}, query_types=list(ULTRAQUERY_SHAPES), + query_batch_size=32, query_order='upstream-pickle', reference={'status': 'test fixture'}, blockers=[]) + return dict(version=1, data_root='data', entries=[entry], seed=0, threads=2, archives={}, answer_filter='released') + + +def test_public_recipes_cover_all_datasets_and_selected_adapters(): + paths = [PUBLIC / name for name in ('baselines.json', 'kgfm_adapters.json')] + manifest = prepare_manifest(paths, suite='ultraquery', answer_filter='released') + assert len(manifest['entries']) == 69 + assert all('-product-intersections-' in e['id'] for e in manifest['entries'] if e['method'].endswith('-adapter')) + for entry in manifest['entries']: + validate_entry(entry) + assert set(entry['query_types']) == set(ULTRAQUERY_SHAPES) + assert 'inference_graph' not in entry + for method in ('ultraquery', 'ultra-adapter', 'trix-adapter'): + assert {e['dataset'] for e in manifest['entries'] if e['method'] == method} == set(BENCHMARK_DATASETS) + for backbone in ('ultra', 'trix'): + adapter = json.loads((REPO / 'benchmarks/adapters' / f'{backbone}_product_intersections.json').read_text()) + assert adapter['training']['shapes'] == ['2i', '3i'] + # Both suites share one copy of every released adapter. + shared = {path for suite in SUITES for name in ('kgfm_adapters.json',) + if (suite_directory(suite) / name).is_file() + for entry in read_manifest(suite_directory(suite) / name)['entries'] for path in entry['adapters'].values()} + assert shared and all(path.startswith('benchmarks/adapters/') and (REPO / path).is_file() for path in shared) + + +def test_cli_subset_and_suite_policies_fail_before_opening_inputs(tmp_path, capsys): + cli.main(['ultraquery', 'evaluate', '--methods', 'ultraquery', 'ultra-adapter', '--datasets', 'WikiTopicsQuery:art', + 'InductiveFB15k237Query:106', '--query-types', 'negation', '--input-root', str(tmp_path), + '--output', str(tmp_path / 'results'), '--dry-run']) + manifest = json.loads(capsys.readouterr().out) + assert len(manifest['entries']) == 4 and manifest['answer_filter'] == 'released' + assert all(set(e['query_types']) == {'2in', '3in', 'inp', 'pin', 'pni'} for e in manifest['entries']) + assert not (tmp_path / 'results').exists() + for selection in (['--answer-filter', 'corrected'], ['--datasets', 'FB15k237+H'], ['--methods', 'bad']): + with pytest.raises(SystemExit): + cli.main(['ultraquery', 'evaluate', '--output', str(tmp_path / 'results'), '--dry-run', *selection]) + + +@pytest.mark.parametrize('action', ['prepare', 'evaluate', 'run', 'report']) +def test_docker_actions_use_the_shared_runtime_and_correct_suite(tmp_path, capsys, action): + args = ['ultraquery', action, '--image', 'dicee/cqa:test', '--input-root', str(tmp_path), '--output', str(tmp_path / 'results'), + '--gpu', 'none', '--dry-run'] + if action in ('evaluate', 'run'): + args += ['--device', 'cpu'] + if action == 'report': + args += ['--results', str(tmp_path / 'results/test')] + else: + args += ['--methods', 'ultraquery', '--datasets', 'WikiTopicsQuery:art'] + if action in ('evaluate', 'prepare'): + args += ['--query-types', 'negation'] + cli.main(args) + output = capsys.readouterr().out + assert f'dicee/cqa:test ultraquery {action} --input-root /inputs --output /results' in output + assert '--gpus' not in output and '--published' not in output + if action == 'run': + with pytest.raises(SystemExit): + cli.main([*args, '--query-types', '1p']) + assert not (tmp_path / 'results').exists() + + +def test_docker_custom_manifests_are_mapped_and_confined_to_inputs(tmp_path, capsys): + inputs = tmp_path / 'inputs' + inputs.mkdir() + manifests = [inputs / name for name in ('native.json', 'adapters.json')] + for path in manifests: + path.write_text('{}') + args = ['ultraquery', 'prepare', '--image', 'dicee/cqa:test', '--input-root', str(inputs), '--output', str(inputs / 'results'), '--dry-run'] + cli.main([*args, '--manifests', str(manifests[0]), '--manifests', str(manifests[1])]) + assert '--manifests /inputs/native.json /inputs/adapters.json' in capsys.readouterr().out + outside = tmp_path / 'outside.json' + outside.write_text('{}') + with pytest.raises(SystemExit): + cli.main([*args, '--manifests', str(outside)]) + assert 'below --input-root' in capsys.readouterr().err + assert not (inputs / 'results').exists() + + +def test_container_runs_the_cli_entrypoint_with_a_pinned_image(tmp_path, monkeypatch): + launches = [] + monkeypatch.setattr(docker.subprocess, 'check_output', lambda *args, **kwargs: '[{"Id":"sha256:test"}]') + monkeypatch.setattr(docker.subprocess, 'run', lambda command, **kwargs: launches.append(command)) + results = tmp_path / 'results' + results.mkdir() + docker.run('dicee/cqa:test', ['ultraquery', 'evaluate', '--output', '/results'], inputs=tmp_path, results=results) + command = launches[0] + assert '--entrypoint' not in command and command[command.index('--network') + 1] == 'none' + assert command[command.index('sha256:test') + 1:] == ['ultraquery', 'evaluate', '--output', '/results'] + assert json.loads((results / 'container-image.json').read_text())['image_id'] == 'sha256:test' + + +@pytest.mark.parametrize('name', ['FB15k237LogicalQuery', 'InductiveFB15k237Query:106', 'WikiTopicsQuery:art']) +def test_independent_exporter_reads_all_three_published_layouts(tmp_path, name): + manifest = fixture(tmp_path, name) + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + prefix, structured, easy, hard, graph, graphs = exporter.reference_dataset(bundle, manifest['entries'][0], tmp_path) + assert set(graph['triples']) == set(load_benchmark(tmp_path / 'data', name, split='valid').context.triples) + assert {q for qs in structured.values() for q in qs} == set(easy) == set(hard) + assert graphs == {split: bundle['datasets'][dataset_key(manifest['entries'][0], split)]['context'] for split in ('valid', 'test')} + assert prefix.endswith(dataset_spec(name)[1] + '/') + + +def test_final_runs_require_matching_parity_and_preserve_14_type_coverage(tmp_path): + manifest = fixture(tmp_path, 'WikiTopicsQuery:art') + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + with pytest.raises(ValueError, match='requires pinned reference'): + run_job(tmp_path / 'bundle', 'ultraquery-fixture', tmp_path, tmp_path / 'test', phase='test') + scores = {} + pilot = run_job(tmp_path / 'bundle', 'ultraquery-fixture', tmp_path, tmp_path / 'pilot', + on_prediction=lambda q, values: scores.update({q.identity: values.clone()})) + entry = manifest['entries'][0] + oracle = dict(version=1, entry_sha256=fingerprint(entry), inputs_sha256=entry_inputs_identity(bundle, entry), + validation_plan_sha256=bundle['plans']['ultraquery-fixture/valid']['sha256'], + reference_commit=REFERENCES['ultraquery'][1], pilot_queries=2, scores=scores, + orders={k: v.argsort(descending=True) for k, v in scores.items()}, + environment=pilot['benchmark_run']['environment'], + graphs={split: bundle['datasets'][dataset_key(entry, split)]['context'] for split in ('valid', 'test')}) + reference = tmp_path / 'reference.pt' + torch.save(oracle, reference) + evidence = verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, reference, tmp_path / 'evidence.json') + assert evidence['passed'] and len(evidence['queries']) == 14 + missing_graphs = dict(oracle, graphs={}) + torch.save(missing_graphs, reference) + with pytest.raises(ValueError, match='inference graphs'): + verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, reference, tmp_path / 'bad.json') + oracle['scores'][next(iter(scores))] = torch.zeros_like(next(iter(scores.values()))) + oracle['orders'] = {k: v.argsort(descending=True) for k, v in oracle['scores'].items()} + torch.save(oracle, reference) + assert not verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, reference, tmp_path / 'failed.json')['passed'] + entry['verification'] = 'evidence.json' + freeze(manifest, tmp_path / 'verified', tmp_path) + report = run_job(tmp_path / 'verified', entry['id'], tmp_path, tmp_path / 'test', phase='test') + assert report['protocol']['full_split'] and report['coverage']['complete_benchmark_types'] + assert not report['coverage']['complete_16_types'] + assert set(report['per_shape']) == set(ULTRAQUERY_SHAPES) + assert set(report['additional_tie_metrics']) == {'expected'} + cli.main(['ultraquery', 'report', '--results', str(tmp_path / 'test'), '--output', str(tmp_path / 'reports'), '--bootstrap-samples', '0']) + rows = json.loads((tmp_path / 'reports/comparison.json').read_text())['rows'] + assert rows[0]['complete_test'] and rows[0]['types'] == 14 and rows[0]['published_mrr'] is None + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_ULTRAQUERY_REFERENCE_ROOT'), reason='Set the pinned upstream root and dependencies') +@pytest.mark.parametrize('name', ['FB15k237LogicalQuery', 'InductiveFB15k237Query:106', 'WikiTopicsQuery:art']) +def test_independent_ultraquery_export_parity_and_full_run(tmp_path, name): + manifest = fixture(tmp_path, name) + freeze(manifest, tmp_path / 'bundle', tmp_path) + reference = tmp_path / 'reference.pt' + subprocess.run([sys.executable, str(REPO / 'benchmarks/cqa/verification/export_reference.py'), '--bundle', str(tmp_path / 'bundle'), + '--input-root', str(tmp_path), '--entry', 'ultraquery-fixture', '--upstream', + os.environ['DICEE_ULTRAQUERY_REFERENCE_ROOT'], '--output', str(reference)], check=True) + evidence = verify_predictions(tmp_path / 'bundle', 'ultraquery-fixture', tmp_path, reference, tmp_path / 'evidence.json') + assert evidence['passed'] and len(evidence['queries']) == 14 + manifest['entries'][0]['verification'] = 'evidence.json' + freeze(manifest, tmp_path / 'verified', tmp_path) + report = run_job(tmp_path / 'verified', 'ultraquery-fixture', tmp_path, tmp_path / 'test', phase='test') + assert report['protocol']['full_split'] and report['coverage']['complete_benchmark_types'] diff --git a/benchmarks/cqa/tests/test_ultraquery_protocol.py b/benchmarks/cqa/tests/test_ultraquery_protocol.py new file mode 100644 index 000000000..4f28612bd --- /dev/null +++ b/benchmarks/cqa/tests/test_ultraquery_protocol.py @@ -0,0 +1,164 @@ +"""Optional conformance checks against the released UltraQuery suite and code.""" + +import hashlib +import os +from dataclasses import replace +from pathlib import Path + +import numpy as np +import pytest +import torch + +from dicee.query_answering import BENCHMARK_DATASETS, evaluate_benchmark, load_benchmark +from dicee.query_answering._query import ULTRAQUERY_SHAPES +from dicee.query_answering.benchmark import QueryMetrics +from dicee.query_answering.datasets import REFERENCE_COMMIT, dataset_spec + + +@pytest.fixture(autouse=True) +def threads(): + previous = torch.get_num_threads() + torch.set_num_threads(2) + yield + torch.set_num_threads(previous) + + +@pytest.fixture +def upstream_reference(monkeypatch): + if not os.environ.get('DICEE_ULTRAQUERY_REFERENCE_ROOT'): + pytest.skip('Set DICEE_ULTRAQUERY_REFERENCE_ROOT, with upstream dependencies installed') + reference = Path(os.environ['DICEE_ULTRAQUERY_REFERENCE_ROOT']) + # Verify the actual source files, including when a Docker image lacks git. + hashes = { + 'query_utils.py': '9b41775a5b54a0e40b9bd3acc24e0f20e54ecf0150f30beae382aa95c36191a0', + 'datasets_query.py': 'c82a04f477724cf3b6d69ef9e2bcdc2c03b7da0b856c47c915d8b3608168a510', + } + for name, checksum in hashes.items(): + assert hashlib.sha256((reference / 'ultra' / name).read_bytes()).hexdigest() == checksum, REFERENCE_COMMIT + monkeypatch.syspath_prepend(str(reference)) + from ultra import datasets_query, query_utils + return datasets_query, query_utils + + +def test_published_negative_infinity_candidate_edge_case(upstream_reference): + _, reference = upstream_reference + scores = torch.full((1, 6), -torch.inf) + easy = torch.zeros_like(scores, dtype=torch.bool) + hard = easy.clone() + hard[0, 2] = True + candidates = torch.tensor([0, 2, 4]) + published, _ = reference.batch_evaluate(scores.clone(), (torch.tensor([0]), easy, hard), candidates) + _, records = QueryMetrics(6, candidates=candidates.tolist()).evaluate(scores[0], set(), {2}, records=True) + assert published.tolist() == [3] + assert records[0][1] == 2 + + +@pytest.mark.integration +@pytest.mark.skipif(not os.environ.get('DICEE_ULTRAQUERY_DATA_ROOT'), reason='Set DICEE_ULTRAQUERY_DATA_ROOT to the official extracted data') +@pytest.mark.parametrize('name', BENCHMARK_DATASETS) +@pytest.mark.parametrize('split', ['valid', 'test']) +def test_official_ultraquery_data_graphs_and_reference_ranks(name, split): + """Real-data conformance for all 23 datasets in the published suite.""" + root = Path(os.environ['DICEE_ULTRAQUERY_DATA_ROOT']) + data = load_benchmark(root, name, split=split) + path = root / dataset_spec(name)[1] + + def triples(stem): + file = path / f'{stem}.txt' + if file.is_file(): + return {tuple(map(int, row.split())) for row in file.read_text().splitlines() if row.strip()} + return {tuple(row) for row in torch.load(path / f'{stem}.pt', weights_only=True).tolist()} + + if data.group == 'transductive': + observed = triples('train') + assert data.candidates == tuple(range(data.context.num_entities)) + elif data.group == 'inductive-e': + observed = triples('train_graph') | triples('val_inference' if split == 'valid' else 'test_inference') + else: + observed = triples('train_graph' if split == 'valid' else 'test_inference') + assert set(data.context.triples) == observed + if data.group != 'transductive': + assert set(data.candidates) == {entity for h, _, t in observed for entity in (h, t)} + scores = torch.sin(torch.arange(data.context.num_entities, dtype=torch.float64)) + report = evaluate_benchmark(data, lambda q: scores, max_queries_per_shape=1) + first = {} + for query in data.queries: + first.setdefault(query.shape, query) + masked = scores.clone() + masked[list(set(range(len(scores))) - set(data.candidates))] = -torch.inf + order = masked.argsort(descending=True).tolist() + positions = {entity: i for i, entity in enumerate(order)} + for shape, query in first.items(): + true_answers = sorted(query.easy | query.hard, key=positions.__getitem__) + ranks = [positions[entity] - offset + 1 for offset, entity in enumerate(true_answers) if entity in query.hard] + expected = dict(mrr=np.mean([1 / r for r in ranks]), + **{f'hits{k}': np.mean([r <= k for r in ranks]) for k in (1, 3, 10)}) + assert {key: report['per_shape'][shape][key] for key in expected} == pytest.approx(expected) + assert report['queries'] == 14 and report['protocol']['all_14_shapes'] + assert not report['protocol']['full_split'] + + +@pytest.mark.integration +@pytest.mark.skipif(not (os.environ.get('DICEE_ULTRAQUERY_DATA_ROOT') and os.environ.get('DICEE_ULTRAQUERY_REFERENCE_ROOT')), + reason='Set official data and pinned upstream roots, with upstream dependencies installed') +@pytest.mark.parametrize('name', ['FB15k237LogicalQuery', 'InductiveFB15k237Query:106', 'WikiTopicsQuery:art']) +@pytest.mark.parametrize('split', ['valid', 'test']) +@pytest.mark.parametrize('tied', [False, True]) +def test_official_ultraquery_evaluator_parity(upstream_reference, name, split, tied): + """Execute the authors' unchanged evaluator on real labels from all 14 types.""" + datasets_query, reference = upstream_reference + + data = load_benchmark(os.environ['DICEE_ULTRAQUERY_DATA_ROOT'], name, split=split) + assert data.metadata['reference_commit'] == REFERENCE_COMMIT + if data.group != 'transductive': + cls = datasets_query.InductiveFB15k237Query if data.group == 'inductive-e' else datasets_query.WikiTopicsQuery + upstream_data = object.__new__(cls) + upstream_data.root = os.environ['DICEE_ULTRAQUERY_DATA_ROOT'] + upstream_data.version = name.split(':')[1] + upstream_data.query_types, upstream_data.union_type = None, 'DNF' + upstream_data.pre_transform = None + if data.group == 'inductive-er': + # DICE's selective extraction omits this unused WikiTopics file; + # the authors' build_vocab ignores validation triples entirely. + upstream_data.load_file = lambda path: ([] if Path(path).stem == 'val_inference' + else cls.load_file(upstream_data, path)) + # Run graph construction without loading training queries or building + # auxiliary relation graphs. This does not modify source data or code. + upstream_data.load_queries = lambda path: None + upstream_data.process() + graph = getattr(upstream_data, f'{split}_graph') + edges = torch.stack((graph.edge_index[0], graph.edge_type, graph.edge_index[1]), dim=1) + assert set(map(tuple, edges.tolist())) == set(data.context.triples) + assert graph.num_nodes == data.context.num_entities + assert graph.num_relations == data.context.num_relations + nodes = getattr(graph, 'restrict_nodes', torch.arange(graph.num_nodes)) + assert tuple(sorted(nodes.tolist())) == data.candidates + grouped = {shape: [] for shape in sorted(ULTRAQUERY_SHAPES)} + for query in data.queries: + grouped[query.shape].append(query) + # Unequal type sizes distinguish macro averaging from query/answer pooling. + selected = tuple(query for i, queries in enumerate(grouped.values()) for query in queries[:1 + i % 3]) + data = replace(data, queries=selected) + n = data.context.num_entities + scores = torch.sin(torch.arange(n, dtype=torch.float64)) + if tied: + scores = scores.round() + report = evaluate_benchmark(data, lambda _: scores) + id2type = [shape + '-DNF' if shape in ('2u', 'up') else shape for shape in grouped] + types = torch.tensor([id2type.index(q.shape + '-DNF' if q.shape in ('2u', 'up') else q.shape) for q in selected]) + easy = torch.zeros((len(selected), n), dtype=torch.bool) + hard = easy.clone() + for i, query in enumerate(selected): + easy[i, sorted(query.easy)] = True + hard[i, sorted(query.hard)] = True + ranks, answer_ranks = reference.batch_evaluate(scores.expand(len(selected), -1).clone(), (types, easy, hard), + torch.tensor(data.candidates)) + expected = reference.evaluate((ranks, torch.zeros(len(selected))), (types, answer_ranks, easy.sum(-1), hard.sum(-1)), + ['mrr', 'hits@1', 'hits@3', 'hits@10'], id2type) + for metric in ('mrr', 'hits1', 'hits3', 'hits10'): + upstream_metric = 'mrr' if metric == 'mrr' else metric.replace('hits', 'hits@') + for shape, upstream_shape in zip(grouped, id2type): + assert report['per_shape'][shape][metric] == pytest.approx(expected[f'[{upstream_shape}] {upstream_metric}']) + for group, label in (('epfo', 'EPFO'), ('negation', 'negation')): + assert report['averages'][group][metric] == pytest.approx(expected[f'[{label}] {upstream_metric}']) + assert report['averages']['all'][metric] == pytest.approx(expected[upstream_metric]) diff --git a/benchmarks/cqa/train.py b/benchmarks/cqa/train.py new file mode 100644 index 000000000..2cc66c1a2 --- /dev/null +++ b/benchmarks/cqa/train.py @@ -0,0 +1,293 @@ +"""Train missing UltraQuery comparison weights using clean, pinned author code.""" + +import collections +import collections.abc +import hashlib +import importlib.metadata +import json +import os +import pickle +import platform +import random +import subprocess +import sys +import time +import types +import zlib +from pathlib import Path + +from .manifests import catalog, read_manifest, suite_directory + +PUBLIC = suite_directory('ultraquery') +# Upstream checkout below Experiments/query-baselines/upstream and its pinned commit. +PINS = {'qto': ('qto', catalog().REFERENCES['qto'][1]), + 'inductive-gnnqe': ('inductiveqe', catalog().INDUCTIVE_QE[1])} + + +def sha(path): + with Path(path).open('rb') as stream: + return hashlib.file_digest(stream, 'sha256').hexdigest() + + +def write(path, value): + Path(path).write_text(json.dumps(value, indent=2, sort_keys=True) + '\n') + + +def verify_source(source, pin): + if subprocess.check_output(['git', '-C', str(source), 'rev-parse', 'HEAD'], text=True).strip() != pin: + raise ValueError('Unexpected training source revision') + if subprocess.check_output(['git', '-C', str(source), 'status', '--porcelain', '--untracked-files=no'], text=True).strip(): + raise ValueError('Training source has modified tracked files') + + +def verify_v2(folder, version): + release = json.loads((PUBLIC / 'inductive-v2-files.json').read_text()) + for filename, expected in release['files'][version].items(): + path = folder / filename + if not path.is_file(): + raise ValueError(f'Missing v2 training input {path}; download the complete official {version}.zip') + crc = 0 + with path.open('rb') as stream: + while block := stream.read(1024 * 1024): + crc = zlib.crc32(block, crc) + if path.stat().st_size != expected['bytes'] or crc != expected['crc32']: + raise ValueError(f'Input differs from corrected v2 release: {path}') + + +def compatibility(): + """Python 3.11 import compatibility; neither GNN arithmetic nor losses change.""" + collections.Sequence = collections.abc.Sequence + drawing = types.ModuleType('rdkit.Chem.Draw.mplCanvas') + drawing.Canvas = object + sys.modules[drawing.__name__] = drawing + + +def train_qto(job, folder, source, output, args): + import numpy as np + import torch + sys.path.insert(0, str(source / 'kbc/src')) + import datasets + import engines + + # Keep the public integer vocabulary: the authors' text preprocessor + # reindexes first-seen strings, which cannot be used directly by our loader. + name = 'FB15K' + prepared = output / 'kbc-data' + prepared.mkdir() + arrays = {} + for split in ('train', 'valid', 'test'): + arrays[split] = np.array([tuple(map(int, line.split())) for line in (folder / f'{split}.txt').read_text().splitlines() + if line.strip()], dtype=np.int64) + with (prepared / f'{split}.pickle').open('wb') as stream: + pickle.dump(arrays[split], stream) + with (folder / 'id2ent.pkl').open('rb') as stream: + n = len(pickle.load(stream)) + with (folder / 'id2rel.pkl').open('rb') as stream: + nr = len(pickle.load(stream)) + filters = {'lhs': collections.defaultdict(set), 'rhs': collections.defaultdict(set)} + for values in arrays.values(): + for h, r, t in values: + filters['rhs'][int(h), int(r)].add(int(t)) + filters['lhs'][int(t), int(r) + nr].add(int(h)) + with (prepared / 'to_skip.pickle').open('wb') as stream: + pickle.dump({side: {key: sorted(value) for key, value in groups.items()} for side, groups in filters.items()}, stream) + config = dict(dataset=name, device=args.device, reciprocal=False, cache_eval=None, + model_cache_path=str(output) + '/', alias='', seed=str(args.seed), model='ComplEx', + rank=8 if args.smoke else 1000, init=1e-3, regularizer='N3', lmbda=.01, + optimizer='Adagrad', learning_rate=.1, decay1=.9, decay2=.999, dropout=0, + world='LCWA', num_neg=0, score_rel=True, score_rhs=True, score_lhs=False, + w_rel=.1, w_lhs=1., max_epochs=args.epochs or (1 if args.smoke else 100), + batch_size=args.batch_size or (2 if args.smoke else 100), valid=1 if args.smoke else 5) + def setup_ds(options): + dataset = datasets.Dataset(options, data_path=prepared) + dataset.n_entities, dataset.n_predicates = n, nr + return dataset + engines.setup_ds = setup_ds + declared_config = dict(config) + engine = engines.KBCEngine(config) + sampler = engine.dataset.get_sampler('train') + best, best_epoch, updates = -1., None, 0 + for epoch in range(config['max_epochs']): + engine.model.train() + # The upstream while-is_epoch loop consumes the first batch of the + # next epoch before its counter advances. Consume exactly one pass. + for _ in range(0, sampler.size, config['batch_size']): + batch = sampler.batchify(config['batch_size'], args.device) + scores, factors = engine.model(batch, score_rel=True, score_rhs=True, score_lhs=False) + loss = engine.loss(scores[0], batch[:, 2]) + .1 * engine.loss(scores[1], batch[:, 1]) + loss = loss + engine.regularizer.penalty(batch, factors)[0] + if not torch.isfinite(loss): + raise ValueError('Nonfinite QTO training loss') + engine.optimizer.zero_grad() + loss.backward() + engine.optimizer.step() + updates += 1 + if args.smoke: + break + if epoch % config['valid'] == 0: + engine.model.eval() + mrrs, _, _ = engine.dataset.eval(engine.model, 'valid', -1) + score = sum(float(v) for v in mrrs.values()) / len(mrrs) + if score > best: + best, best_epoch = score, epoch + 1 + torch.save(engine.model.state_dict(), output / 'checkpoint.pt') + engine.writer.close() + return dict(configuration=declared_config, model_shape=list(engine.dataset.get_shape()), + best_validation_mrr=best, best_epoch=best_epoch, updates=updates, + adjustments=['Preserve public integer IDs.', + 'Correct the upstream epoch rollover: exactly one pass per epoch.', + 'Select checkpoints on validation only; omit repeated test diagnostics.']) + + +def train_inductive(job, folder, source, output, args): + import torch + compatibility() + sys.path.insert(0, str(source)) + from gnnqe import dataset, gnn, model, task, util # noqa: F401 (imports register TorchDrug classes) + from torchdrug import utils + from torchdrug.layers import functional + if not hasattr(functional, '_size_to_index'): + functional._size_to_index = lambda size: torch.arange(len(size), device=size.device).repeat_interleave(size) + from unittest.mock import patch + + config = util.load_config(source / 'config/complex_query/gnnqe_main.yaml', + context={'ratio': int(job['dataset'].split(':')[1]), 'gpus': 'null' if args.device == 'cpu' else [torch.device(args.device).index or 0]}) + config.engine.batch_size = args.batch_size or (2 if args.smoke else 64) + config.train.num_epoch = args.epochs or (1 if args.smoke else 10) + if args.smoke: + config.train.batch_per_epoch = 1 + config.task.model.model.input_dim = 8 + config.task.model.model.hidden_dims = [8, 8] + config.fast_test = 1 + # Use the authors' local data reader to avoid their unconditional download. + with patch.object(utils, 'download', return_value=str(folder.parent / (folder.name + '.zip'))): + data = dataset.InductiveFB15k237Comp(str(folder.parent), ratio=int(folder.name), verbose=0) + if len(data.split()[1]) < config.fast_test: + config.fast_test = len(data.split()[1]) + solver = util.build_solver(config, data) + config.optimizer.pop('params', None) + # Save the best complete state directly; evaluation validates the graph + # buffers and loads learned tensors into the public inference context. + best, best_epoch, updates = -1., None, 0 + previous = Path.cwd() + os.chdir(output) + try: + for epoch in range(config.train.num_epoch): + solver.model.split = 'train' + solver.train(num_epoch=1, batch_per_epoch=config.train.batch_per_epoch) + updates += config.train.batch_per_epoch + solver.model.split = 'valid' + score = float(solver.evaluate('valid')[config.metric]) + if score > best: + best, best_epoch = score, epoch + 1 + solver.save('checkpoint.pt') + finally: + os.chdir(previous) + return dict(configuration=json.loads(json.dumps(config, default=str)), best_validation_mrr=best, + best_epoch=best_epoch, updates=updates, + adjustments=['Use local corrected v2 inputs; omit final test inference during training.', + 'Configure TorchDrug size-to-index helper and Python/RDKit imports.']) + + +def add_arguments(parser): + parser.add_argument('--methods', nargs='+', choices=tuple(PINS), required=True) + parser.add_argument('--datasets', nargs='+') + parser.add_argument('--data-root', default='KGs/UltraQuery') + parser.add_argument('--output', type=Path, required=True, help='Training directory, below the input root for Docker') + parser.add_argument('--manifest-output-root', type=Path, help='Path of OUTPUT as later evaluations see it, below the input root') + parser.add_argument('--device', default='cpu') + parser.add_argument('--seed', type=int, default=0) + parser.add_argument('--threads', type=int, default=2) + parser.add_argument('--batch-size', type=int) + parser.add_argument('--epochs', type=int) + parser.add_argument('--reference-deps', type=Path, nargs='+', default=[], help='Extra import roots for author dependencies') + parser.add_argument('--smoke', action='store_true', help='Tiny model and one-step fixture test; never paper weights') + + +def run(args): + """Train the selected recipes of ``trained_baselines.json``, each author codebase in its own process.""" + if args.threads < 1 or any(v is not None and v < 1 for v in (args.batch_size, args.epochs)): + raise ValueError('Positive threads, batch size and epoch count required') + recipes = read_manifest(PUBLIC / 'trained_baselines.json') + jobs = [e for e in recipes['entries'] if e['method'] in args.methods + and (args.datasets is None or e['dataset'] in args.datasets)] + if not jobs or (args.datasets and set(args.datasets) - {e['dataset'] for e in jobs}): + raise ValueError('Select compatible methods/datasets from trained_baselines.json') + if args.dry_run: + print(json.dumps(dict(device=args.device, jobs=[dict(id=j['id'], dataset=j['dataset'], method=j['method']) for j in jobs], + seed=args.seed, smoke=args.smoke), indent=2)) + return + if args.device == 'cpu': + os.environ['CUDA_VISIBLE_DEVICES'] = '' + for path in reversed(args.reference_deps): + sys.path.insert(0, str(path.resolve())) + if (path / 'bin').is_dir(): + os.environ['PATH'] = str(path.resolve() / 'bin') + os.pathsep + os.environ['PATH'] + import numpy as np + import torch + torch.set_num_threads(args.threads) + torch.set_float32_matmul_precision('highest') + args.input_root, args.output = args.input_root.resolve(), args.output.resolve() + manifest_root = (args.manifest_output_root or args.output).resolve() + if args.manifest_output_root and not manifest_root.is_relative_to(args.input_root): + raise ValueError('Manifest output root must be below input-root') + for job in jobs: + # Separate interpreters prevent registry/name collisions between authors. + if len(jobs) > 1: + command = [sys.executable, '-m', 'benchmarks.cqa', 'ultraquery', 'train', '--methods', job['method'], + '--datasets', job['dataset'], '--input-root', str(args.input_root), '--data-root', args.data_root, + '--output', str(args.output), '--device', args.device, '--threads', str(args.threads), '--seed', str(args.seed)] + for option, value in [('--batch-size', args.batch_size), ('--epochs', args.epochs)]: + if value is not None: + command += [option, str(value)] + if args.manifest_output_root: + command += ['--manifest-output-root', str(manifest_root)] + if args.reference_deps: + command += ['--reference-deps', *map(str, args.reference_deps)] + if args.smoke: + command.append('--smoke') + subprocess.run(command, check=True) + continue + checkout, pin = PINS[job['method']] + source = args.input_root / 'Experiments/query-baselines/upstream' / checkout + verify_source(source, pin) + folder = args.input_root / args.data_root / ('FB15k-betae' if job['method'] == 'qto' else job['dataset'].split(':')[1]) + if job['method'] == 'inductive-gnnqe' and not args.smoke: + verify_v2(folder, job['dataset'].split(':')[1]) + output = args.output / job['id'] + if output.exists(): + raise FileExistsError(f'Use a fresh training output: {output}') + output.mkdir(parents=True) + provenance = dict(version=1, method=job['method'], dataset=job['dataset'], source_commit=pin, + launcher_sha256=sha(__file__), seed=args.seed, device=args.device, threads=args.threads, + profile='smoke' if args.smoke else 'custom' if args.epochs or args.batch_size else 'author-recipe', + dataset_release='fixture' if args.smoke else 'InductiveQE v2.0' if job['method']=='inductive-gnnqe' else 'BetaE', + inputs={p.name: sha(p) for p in sorted(folder.iterdir()) if p.is_file()}, + environment=dict(python=platform.python_version(), torch=str(torch.__version__), + image_id=os.environ.get('DICEE_IMAGE_ID'), + packages={d.metadata['Name']: d.version for d in importlib.metadata.distributions() + if d.metadata['Name']}), + checkpoint_selection='validation MRR only', status='running') + write(output / 'training.json', provenance) + torch.manual_seed(args.seed) + random.seed(args.seed) + np.random.seed(args.seed) + started = time.monotonic() + try: + result = (train_qto if job['method']=='qto' else train_inductive)(job, folder, source, output, args) + provenance.update(result, status='complete', seconds=time.monotonic()-started, + checkpoint_sha256=sha(output / 'checkpoint.pt')) + write(output / 'training.json', provenance) + logical = manifest_root / job['id'] + def manifest_path(filename): + path = logical / filename + return str(path.relative_to(args.input_root) if path.is_relative_to(args.input_root) else path) + local = dict(recipes, seed=args.seed, threads=args.threads, data_root=args.data_root, + entries=[dict(job, checkpoint=manifest_path('checkpoint.pt'), training=manifest_path('training.json'))]) + local['entries'][0]['reference']['training_profile'] = provenance['profile'] + local['entries'][0]['blockers'] = ['Training smoke checkpoint; not a paper baseline'] if args.smoke else [] + write(output / 'manifest.json', local) + except Exception as error: + provenance.update(status='failed', error=str(error)) + write(output / 'training.json', provenance) + raise diff --git a/benchmarks/cqa/training/Dockerfile b/benchmarks/cqa/training/Dockerfile new file mode 100644 index 000000000..e737bcd33 --- /dev/null +++ b/benchmarks/cqa/training/Dockerfile @@ -0,0 +1,17 @@ +# CPU author runtime. Build from an immutable shared benchmark image ID. +ARG BENCHMARK_IMAGE +FROM ${BENCHMARK_IMAGE} +USER root +RUN apt-get -o Acquire::Retries=5 update \ + && apt-get install -y --no-install-recommends git libxrender1 libxext6 libglib2.0-0 \ + && rm -rf /var/lib/apt/lists/* +COPY requirements.lock /tmp/author-requirements.lock +# TorchDrug's Python upper bound predates 3.11; the launcher supplies import +# compatibility. Keep base dependencies intact and verify every added wheel. +RUN pip install --no-cache-dir --no-deps --require-hashes --ignore-requires-python \ + -r /tmp/author-requirements.lock +COPY torchdrug_compat.py /opt/dicee/benchmarks/cqa/training/torchdrug_compat.py +RUN python /opt/dicee/benchmarks/cqa/training/torchdrug_compat.py > /opt/dicee/benchmarks/cqa/training/torchdrug-compat.json +ENV MAX_JOBS=2 TORCH_EXTENSIONS_DIR=/cache/torch_extensions MPLCONFIGDIR=/cache/matplotlib +# TorchDrug also creates short-lived compiler locks in the working directory. +WORKDIR /tmp diff --git a/benchmarks/cqa/training/requirements.lock b/benchmarks/cqa/training/requirements.lock new file mode 100644 index 000000000..43585eb8b --- /dev/null +++ b/benchmarks/cqa/training/requirements.lock @@ -0,0 +1,22 @@ +# Author runtime additions to the locked +H/UltraQuery image; Python 3.11 / Linux x86_64. +# Install without dependencies: the base image supplies the remaining pinned dependencies. +torchdrug==0.2.1 --hash=sha256:f416dbbfb3fc697770e9ee7fa7769611fad060a4749ee49499d87583cfb58ee2 +torch-geometric==2.6.1 --hash=sha256:8faeb353f9655f7dbec44c5e0b44c721773bdfb279994da96b9b8b12fd30f427 +ninja==1.13.2 --hash=sha256:65a24341b5ac09fcadcc37082660be40a94174e51a937fabf6e2cae26225fa2c +fair-esm==2.0.0 --hash=sha256:7dcb58828a401155d1457d071a03800bd1a50331ddf24ac79ad1dd0f2ea682a2 +easydict==1.13 --hash=sha256:6b787daf4dcaf6377b4ad9403a5cee5a86adbc0ca9a5bcf5410e9902002aeac2 +decorator==5.3.1 --hash=sha256:f47fe6fdbd2edd623ecfe36875d37aba411624e2670dd395dddae1358689bb3c +lmdb==2.3.0 --hash=sha256:4d0019870b5b93b2160fc324a609ffee1447024b2b8ce0da3b3f2f04b0131870 +rdkit==2026.3.6 --hash=sha256:dcf09347e1a0dc1d7e5fcc34f5da79d1f4bb0e04ecadee669449b82ae2492799 +pillow==12.3.0 --hash=sha256:23d27a3e0307ec2244cc51e7287b919aa68d097504ebe19df4e76a98a3eea5bd +matplotlib==3.11.2 --hash=sha256:07d9b9fa60cd4c393692f50d0bb03123242ddf61c99bb0e95e75feb354e7c1a8 +pyparsing==3.3.3 --hash=sha256:ece8c00a69cf01b45d0b1dedabb469c90d8caf996d4fda40f147627a122849a4 +cycler==0.12.1 --hash=sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30 +kiwisolver==1.5.1 --hash=sha256:95a02752aa032eef4aed01cda6d9b687c669bd0396bf4519eef8bba22a286720 +fonttools==4.66.1 --hash=sha256:72299346b96b9244dabcc051b24e4653da4edfda6105544cfb10ce856a1afaac +contourpy==1.3.3 --hash=sha256:51e79c1f7470158e838808d4a996fa9bac72c498e93d8ebe5119bc1e6becb0db +ogb==1.3.6 --hash=sha256:29ab84078c66a7846bf137c9be9545978616a053e734c032a2ff731d026bb5e9 +outdated==0.2.2 --hash=sha256:3e9c2ee6d17e86ae8cc7bb71d70c4172690121cda367155a30994742172678c8 +littleutils==0.2.4 --hash=sha256:d10d5fe2e107c49fe2fc2904a08d6e5a302b41f8405921835ffcc323782d5dbc +torch_scatter @ https://data.pyg.org/whl/torch-2.9.0%2Bcu128/torch_scatter-2.1.2%2Bpt29cu128-cp311-cp311-linux_x86_64.whl --hash=sha256:58b82728cd48fe565ceae3a049b58f8a1378dbdcae75d24aecdf870a29196331 +torch_cluster @ https://data.pyg.org/whl/torch-2.9.0%2Bcu128/torch_cluster-1.6.3%2Bpt29cu128-cp311-cp311-linux_x86_64.whl --hash=sha256:f605601a14406d65c904297437b1e56cb339cb7db8ba48a39397a31a1703eb51 diff --git a/benchmarks/cqa/training/torchdrug_compat.py b/benchmarks/cqa/training/torchdrug_compat.py new file mode 100644 index 000000000..6ed453b3d --- /dev/null +++ b/benchmarks/cqa/training/torchdrug_compat.py @@ -0,0 +1,49 @@ +"""Apply three mechanical TorchDrug 0.2.1 fixes for the pinned PyTorch runtime. + +No kernel arithmetic changes: update two moved includes and pass loader options +by keyword because the modern PyTorch positional signature has changed. +""" + +import argparse +import hashlib +import importlib.util +import json +from pathlib import Path + + +def apply(root): + replacements = { + 'layers/functional/extension/spmm.h': ('#include ', + '#include '), + 'layers/functional/extension/rspmm.h': ('#include ', + '#include '), + 'utils/torch.py': ('self.extra_ldflags, self.extra_include_paths, self.build_directory,\n' + ' self.verbose, **self.kwargs)', + 'extra_ldflags=self.extra_ldflags, extra_include_paths=self.extra_include_paths,\n' + ' build_directory=self.build_directory, verbose=self.verbose, **self.kwargs)'), + } + pending = [] + for relative, (old, new) in replacements.items(): + path = root / relative + original = path.read_text() + if old not in original and new not in original: + raise ValueError(f'Unexpected TorchDrug source; refusing to patch {path}') + pending.append((path, original, original.replace(old, new))) + report = {} + for path, original, updated in pending: + if original != updated: + path.write_text(updated) + report[str(path.relative_to(root))] = dict( + before_sha256=hashlib.sha256(original.encode()).hexdigest(), + after_sha256=hashlib.sha256(updated.encode()).hexdigest()) + return report + + +if __name__ == '__main__': + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('root', nargs='?', type=Path) + args = parser.parse_args() + root = args.root + if root is None: + root = Path(importlib.util.find_spec('torchdrug').origin).parent + print(json.dumps(apply(root), indent=2)) diff --git a/benchmarks/cqa/verification/__init__.py b/benchmarks/cqa/verification/__init__.py new file mode 100644 index 000000000..d246a948c --- /dev/null +++ b/benchmarks/cqa/verification/__init__.py @@ -0,0 +1 @@ +"""Independent reference implementations and parity checks.""" diff --git a/benchmarks/cqa/verification/export_reference.py b/benchmarks/cqa/verification/export_reference.py new file mode 100644 index 000000000..37b274519 --- /dev/null +++ b/benchmarks/cqa/verification/export_reference.py @@ -0,0 +1,460 @@ +"""Export full-candidate validation oracles from upstream code, without DICE imports.""" + +import argparse +import collections +import collections.abc +import hashlib +import importlib.util +import json +import pickle +import platform +import random +import re +import subprocess +import sys +import types +from pathlib import Path +from types import FunctionType + +import numpy as np +import torch +from torch.overrides import TorchFunctionMode + + +class ReferenceAttention(TorchFunctionMode): + """Partition independent heads; retain each complete reference query batch.""" + def __torch_function__(self, func, types, args=(), kwargs=None): + kwargs = kwargs or {} + if func is torch.nn.functional.multi_head_attention_forward: + namespace = func.__globals__ | {'scaled_dot_product_attention': lambda *a, **kw: self.__torch_function__( + torch.nn.functional.scaled_dot_product_attention, (), a, kw)} + copied = FunctionType(func.__code__, namespace, func.__name__, func.__defaults__, func.__closure__) + return copied(*args, **kwargs) + if func is torch.nn.functional.scaled_dot_product_attention: + q, k, v = args[:3] + if q.is_cuda and q.shape[-3] > 1 and q.shape[-2] * k.shape[-2] > 1024**2: + mask = args[3] if len(args) > 3 else kwargs.get('attn_mask') + dropout = args[4] if len(args) > 4 else kwargs.get('dropout_p', 0) + if mask is not None or dropout or kwargs.get('enable_gqa', False): + raise ValueError('Reference attention expects unmasked inference') + heads = [func(q.narrow(-3, i, 1), k.narrow(-3, i, 1), v.narrow(-3, i, 1), *args[3:], **kwargs) + for i in range(q.shape[-3])] + return torch.cat(heads, dim=-3) + return func(*args, **kwargs) + + +FORMULAS = { + '1p': 'r1(s1,f)', '2p': '(r1(s1,e1))&(r2(e1,f))', + '3p': '((r1(s1,e1))&(r2(e1,e2)))&(r3(e2,f))', + '4p': '(((r1(s1,e1))&(r2(e1,e2)))&(r3(e2,e3)))&(r4(e3,f))', + '2i': '(r1(s1,f))&(r2(s2,f))', '3i': '((r1(s1,f))&(r2(s2,f)))&(r3(s3,f))', + '4i': '(((r1(s1,f))&(r2(s2,f)))&(r3(s3,f)))&(r4(s4,f))', + 'ip': '((r1(s1,e1))&(r2(s2,e1)))&(r3(e1,f))', + 'pi': '((r1(s1,e1))&(r2(e1,f)))&(r3(s2,f))', + '2in': '(r1(s1,f))&(!(r2(s2,f)))', '3in': '((r1(s1,f))&(r2(s2,f)))&(!(r3(s3,f)))', + 'inp': '((r1(s1,e1))&(!(r2(s2,e1))))&(r3(e1,f))', + 'pin': '((r1(s1,e1))&(r2(e1,f)))&(!(r3(s2,f)))', + 'pni': '((r1(s1,e1))&(!(r2(e1,f))))&(r3(s2,f))', +} + + +def digest(value): + return hashlib.sha256(json.dumps(value, sort_keys=True, separators=(',', ':')).encode()).hexdigest() + + +def sha(path): + with path.open('rb') as stream: + return hashlib.file_digest(stream, 'sha256').hexdigest() + + +def flatten(value): + return [i for part in value for i in flatten(part)] if isinstance(value, tuple) else [value] + + +def structure(query): + if isinstance(query[0], int): + return 'e', tuple('n' if r == -2 else 'r' for r in query[1]) + if len(query) == 2 and all(isinstance(r, int) for r in query[1]): + return structure(query[0]), tuple('n' if r == -2 else 'r' for r in query[1]) + return tuple(('u',) if part == (-1,) else structure(part) for part in query) + + +def module(path, name): + spec = importlib.util.spec_from_file_location(name, path) + result = importlib.util.module_from_spec(spec) + spec.loader.exec_module(result) + return result + + +# The pinned upstream revisions, read from the import-free catalog (no DICE imports). +COMMITS = {method: commit for method, (_, commit) in + module(Path(__file__).resolve().parents[3] / 'dicee/query_answering/catalog.py', 'cqa_catalog').REFERENCES.items()} + + +def load_state(path): + state = torch.load(path, map_location='cpu', weights_only=True) + while any(key in state for key in ('model', 'model_state_dict', 'state_dict')): + state = next(state[key] for key in ('model', 'model_state_dict', 'state_dict') if key in state) + return state + + +def reference_dataset(bundle, entry, root): + """Read published layouts independently; never import DICE's dataset loader.""" + name = entry['dataset'] + plus_h = {'FB15k237+H': 'FB15k-237+H', 'NELL995+H': 'NELL995+H', 'ICEWS18+H': 'ICEWS18+H'} + transductive = {'FB15k237LogicalQuery': 'FB15k-237-betae', 'FB15kLogicalQuery': 'FB15k-betae', + 'NELL995LogicalQuery': 'NELL-betae'} + if name in plus_h: + folder = Path('iscqa-compl-benchmarks/new_benchmarks') / plus_h[name] + elif name in transductive: + folder = Path(transductive[name]) + else: + family, version = name.split(':') + if family not in ('InductiveFB15k237Query', 'WikiTopicsQuery'): + raise ValueError('Unsupported reference dataset') + folder = Path(version) if family == 'InductiveFB15k237Query' else Path('WikiTopics_QE') / version + prefix = str(Path(bundle['manifest']['data_root']) / folder) + '/' + raw = Path(root) / prefix + + def unpickle(filename): + with (raw / filename).open('rb') as stream: + return pickle.load(stream) + + def triples(stem): + path = raw / (stem + '.txt') + if path.is_file(): + return [tuple(map(int, line.split())) for line in path.read_text().splitlines() if line.strip()] + return list(map(tuple, torch.load(raw / (stem + '.pt'), map_location='cpu', weights_only=True).tolist())) + + def context(edges, n, nr, pairs): + inverse = {a: b for h, t in pairs for a, b in ((h, t), (t, h))} + edges = sorted(set(edges) | {(t, inverse[r], h) for h, r, t in edges if r in inverse}) + return dict(triples=edges, num_entities=n, num_relations=nr, inverse_relations=sorted(pairs)) + + if name in plus_h or name in transductive: + n, nr = len(unpickle('id2ent.pkl')), len(unpickle('id2rel.pkl')) + stem = 'KG_splits/train' if name == 'ICEWS18+H' else 'train' + train = triples(stem) + test = train + if name in plus_h and (entry.get('inference_graph') or 'train+valid') == 'train+valid': + test = train + triples('KG_splits/valid' if name == 'ICEWS18+H' else 'valid') + pairs = [(r, r + 1) for r in range(0, nr, 2)] + graphs = {'valid': context(train, n, nr, pairs), 'test': context(test, n, nr, pairs)} + structured, easy, hard = [unpickle('valid-' + kind + '.pkl') for kind in ('queries', 'easy-answers', 'hard-answers')] + else: + train, test = triples('train_graph'), triples('test_inference') + if family == 'InductiveFB15k237Query': + valid = triples('val_inference') + vocabulary = train + valid + test + n = max(entity for h, _, t in vocabulary for entity in (h, t)) + 1 + nr = max(r for _, r, _ in vocabulary) + 1 + pairs = [(r, r + nr // 2) for r in range(nr // 2)] + graphs = {split: context(train + edges, n, nr, pairs) for split, edges in [('valid', valid), ('test', test)]} + else: + mapping = unpickle('og_mappings.pkl')['r2id'] if (raw / 'og_mappings.pkl').is_file() else None + graphs = {} + for split, edges in [('valid', train), ('test', test)]: + n = max(entity for h, _, t in edges for entity in (h, t)) + 1 + nr = max(r for _, r, _ in edges) + 1 + pairs = ([(r, mapping[label + '_inv']) for label, r in mapping.items() + if label + '_inv' in mapping and r < nr and mapping[label + '_inv'] < nr] + if mapping else [(r, r + nr // 2) for r in range(nr // 2)]) + graphs[split] = context(edges, n, nr, pairs) + structured, grouped_easy, grouped_hard = [unpickle('valid_' + kind + '.pkl') + for kind in ('queries', 'answers_easy', 'answers_hard')] + easy = {query: answers for group in grouped_easy.values() for query, answers in group.items()} + hard = {query: answers for group in grouped_hard.values() for query, answers in group.items()} + graph = graphs['valid'] + return prefix, structured, easy, hard, graph, {split: digest(value) for split, value in graphs.items()} + + +def predictor(entry, upstream, checkpoint, n, nr, triples, queries, device, probe_queries=None): + method, options = entry['method'], entry['options'] + names = {structure(query): shape + '-DNF' if shape in ('2u', 'up') else shape for shape, query in queries.values()} + if method == 'cone': + source, state = module(upstream / 'models.py', 'reference_cone'), load_state(checkpoint) + dim = state['entity_embedding'].shape[1] + model = source.KGReasoning(n, nr, dim, state['gamma'].item(), use_cuda=device.startswith('cuda'), + query_name_dict=names, center_reg=options['center_reg']) + model.cone_proj = source.ConeProjection(dim, state['cone_proj.layer1.weight'].shape[0], 2) + model.load_state_dict(state, strict=True) + model.to(device).eval() + + def predict(shape, batch): + encoded = {structure(batch[0]): torch.tensor([flatten(q) for q in batch], device=device)} + indices = {structure(batch[0]): list(range(len(batch)))} + return torch.cat([model(None, torch.arange(start, min(start + 1024, n), device=device)[None] + .expand(len(batch), -1), None, encoded, indices)[1] + for start in range(0, n, 1024)], dim=-1) + return predict + if method in ('cqd', 'cqd-hybrid'): + from cqd.base import CQD + state = load_state(checkpoint) + filters = collections.defaultdict(list) + for h, r, t in triples: + filters[h, r].append(t) + model = CQD(n, nr, state['embeddings.0.weight'].shape[1] // 2, k=options['beam_size'], max_k=options['max_k'], + max_norm=.9 if method == 'cqd-hybrid' else 1., filters=filters, + do_normalize=options['normalize'], t_norm_name=options['tnorm'], query_name_dict=names) + model.load_state_dict(state, strict=True) + model.to(device).eval() + + def predict(shape, batch): + settings = options | options['per_shape'].get(shape, {}) + model.k, model.t_norm_name, model.max_k = settings['beam_size'], settings['tnorm'], settings['max_k'] + with torch.device(device): + if settings.get('reference_batching') is False: + from cqd import discrete + from reference_cqd import query_bounded + return query_bounded(model, discrete, shape, torch.tensor([flatten(q) for q in batch], device=device), + settings['row_batch_size']) + if shape == '4p' and options.get('final_batch_size') and device.startswith('cuda'): + from cqd import discrete + from reference_cqd import query_4p + return query_4p(model, discrete, torch.tensor([flatten(q) for q in batch], device=device), + options['final_batch_size']) + return model(None, None, None, {structure(batch[0]): torch.tensor([flatten(q) for q in batch], device=device)}, + {structure(batch[0]): list(range(len(batch)))})[1] + return predict + if method == 'clmpt': + from src.language.foq import EFO1Query + from src.language.grammar import parse_lstr_to_lformula + from src.pipeline.clmpt import CLMPTLayer, CLMPTReasoner + from src.structure.nbp_complex import ComplEx + state = load_state(checkpoint) + pre_norm = any(key.startswith('transformer.encoder.') for key in state) + backbone = ComplEx(n, nr, state['nbp._entity_embedding.weight'].shape[1] // 2, device=device) + hidden = state['transformer.encoder.layers.0.ffn.layer1.weight' if pre_norm else 'transformer.layers.0.linear1.weight'].shape[0] + model = CLMPTLayer(hidden, backbone, layers=2, pre_norm=pre_norm, agg_func=options['aggregation']) + model.load_state_dict(state, strict=True) + model.to(device).eval() + reasoner = CLMPTReasoner(backbone, model) + + def atomic(shape, batch): + formula = FORMULAS[shape] + symbols = [] + for relation, source, _ in re.findall(r'(r\d+)\((\w+),(\w+)\)', formula): + for key in (source, relation): + if key.startswith(('s', 'r')) and key not in symbols: + symbols.append(key) + query = EFO1Query(parse_lstr_to_lformula(formula)) + for row in batch: + query.append_qa_instances(dict(zip(symbols, [value for value in flatten(row) if value >= 0])), {'f': []}, {'f': []}) + reasoner.initialize_with_query(query) + with ReferenceAttention(): + reasoner.estimate_variable_embeddings() + embeddings = reasoner.get_ent_emb('f')[:probe_queries] + return torch.stack([torch.cat([torch.cosine_similarity(row[None], entities, dim=-1) + for entities in backbone.entity_embedding.split(options['candidate_batch_size'])]) for row in embeddings]) + + def predict(shape, batch): + if shape == '2u': + return torch.maximum(atomic('1p', [q[0] for q in batch]), atomic('1p', [q[1] for q in batch])) + if shape == 'up': + return torch.maximum(*[atomic('2p', [(q[0][branch][0], (*q[0][branch][1], *q[1])) for q in batch]) for branch in (0, 1)]) + return atomic(shape, batch) + return predict + if method in ('ultraquery', 'ultraquery-lp'): + from torch_geometric.data import Data + from ultra import datasets_query, tasks # noqa: F401 + from ultra.models import Ultra + from ultra.query_utils import Query + from ultra.ultraquery import UltraQuery + edges = torch.tensor(triples) + graph = Data(edge_index=edges[:, [0, 2]].T, edge_type=edges[:, 1], num_nodes=n, num_relations=nr) + tasks.build_relation_graph(graph) + graph = graph.to(device) + state = load_state(checkpoint) + sentinel = 'relation_model.layers.0.linear.weight' + prefix = next(p for p in ('model.model.', 'model.', '') if p + sentinel in state) + state = {k[len(prefix):]: v for k, v in state.items()} + key = sentinel + dim = state[key].shape[0] + layers = len({k.split('.')[2] for k in state if k.startswith('relation_model.layers.')}) + config = dict(input_dim=dim, hidden_dims=[dim] * layers, message_func='distmult', aggregate_func='sum', short_cut=True, layer_norm=True) + backbone = Ultra(dict(config, **{'class': 'RelNBFNet'}), dict(config, **{'class': 'QueryNBFNet'})) + model = UltraQuery(backbone, threshold=options['threshold'], logic=options['logic']) + backbone.load_state_dict(state, strict=True) + model.to(device).eval() + return lambda shape, batch: model(graph, torch.stack([Query.from_nested(q) for q in batch]).to(device), symbolic_traversal=False) + if method in ('gnnqe', 'inductive-gnnqe', 'incoming-relation'): + collections.Sequence = collections.abc.Sequence + drawing = types.ModuleType('rdkit.Chem.Draw.mplCanvas') + drawing.Canvas = object + sys.modules[drawing.__name__] = drawing + from gnnqe.data import Query + from gnnqe.gnn import NeuralBellmanFordNetwork + from gnnqe.model import QueryExecutor + from torchdrug import data + from torchdrug.layers import functional + if not hasattr(functional, '_size_to_index'): + functional._size_to_index = lambda size: torch.arange(len(size), device=size.device).repeat_interleave(size) + graph = data.Graph(torch.tensor(triples)[:, [0, 2, 1]], num_node=n, num_relation=nr).to(device) + if method == 'incoming-relation': + from gnnqe.heuristic_baseline import HeuristicBaseline + model = HeuristicBaseline().to(device).eval() + seed = options.get('seed', torch.initial_seed()) + # Building TorchDrug's random perfect-hash index must not consume + # the query's random ranking stream. + graph.match(torch.tensor([[-1, -1, r] for r in range(nr)], device=device)) + + def heuristic_predict(shape, batch): + scores = [] + devices = [torch.device(device).index or 0] if device.startswith('cuda') else [] + for q in batch: + payload = json.dumps([seed, flatten(q)], separators=(',', ':')).encode() + local_seed = int.from_bytes(hashlib.sha256(payload).digest()[:8], 'little') % (2**63) + with torch.random.fork_rng(devices=devices): + torch.manual_seed(local_seed) + scores.append(model(graph, Query.from_nested(q)[None].to(device))[0]) + return torch.stack(scores) + return heuristic_predict + with torch.serialization.safe_globals([data.Graph]): + state = torch.load(checkpoint, map_location='cpu', weights_only=True)['model'] + buffers = ('train_graph', 'valid_graph', 'test_graph', 'valid_nodes', 'test_nodes') if method == 'inductive-gnnqe' else ('fact_graph', 'graph') + state = {key.removeprefix('model.'): value for key, value in state.items() if key not in buffers} + dim = state['model.query.weight'].shape[1] + count = len({key.split('.')[3] for key in state if key.startswith('model.model.layers.')}) + backbone = NeuralBellmanFordNetwork(dim, [dim] * count, nr, aggregate_func='pna', short_cut=True, layer_norm=True, + concat_hidden=state['model.mlp.layers.0.weight'].shape[1] != 2 * dim) + model = QueryExecutor(backbone, logic=options['logic']) + model.load_state_dict(state, strict=True) + model.to(device).eval() + return lambda shape, batch: model(graph, torch.stack([Query.from_nested(q) for q in batch]).to(device)) + if method == 'qto': + source = module(upstream / 'model.py', 'reference_qto') + from reference_qto import ReferenceRelations + from src.models import ComplEx + state = load_state(checkpoint) + backbone = ComplEx([n, nr, n], rank=state['embeddings.0.weight'].shape[1] // 2, init_size=1.) + backbone.load_state_dict(state, strict=True) + backbone.to(device).eval() + + model = source.KGReasoning.__new__(source.KGReasoning) + torch.nn.Module.__init__(model) + model.nentity, model.device, model.fraction, model.neg_scale = n, device, min(n, 100), options['negation_scale'] + model.relation_embeddings = ReferenceRelations(source, backbone, triples, n, device, options['threshold'], model.fraction) + return lambda shape, batch: model.embed_query(torch.tensor([flatten(q) for q in batch], device=device), structure(batch[0]), 0)[0] + raise ValueError('Only upstream baselines have an independent reference exporter') + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--bundle', type=Path, required=True) + parser.add_argument('--input-root', type=Path, required=True) + parser.add_argument('--entry', required=True) + parser.add_argument('--upstream', type=Path, required=True) + parser.add_argument('--device', default='cpu') + parser.add_argument('--pilot-queries', type=int, default=2) + parser.add_argument('--probe-only', action='store_true', help='Score only the pilot queries after encoding complete reference batches') + parser.add_argument('--output', type=Path, required=True) + args = parser.parse_args() + if args.pilot_queries < 1: + parser.error('Positive pilot budget required') + bundle = json.loads((args.bundle / 'bundle.json').read_text()) + if sha(args.bundle / 'bundle.json') != json.loads((args.bundle / 'bundle.sha256.json').read_text())['sha256']: + raise ValueError('Bundle checksum mismatch') + entries = {entry['id']: entry for entry in bundle['manifest']['entries']} + if args.entry not in entries: + parser.error(f'No frozen entry {args.entry!r} in this bundle') + entry = entries[args.entry] + commit = subprocess.check_output(['git', '-C', str(args.upstream), 'rev-parse', 'HEAD'], text=True).strip() + if commit != COMMITS.get(entry['method']): + raise ValueError('Unexpected upstream revision') + if subprocess.check_output(['git', '-C', str(args.upstream), 'status', '--porcelain', '--untracked-files=no'], text=True).strip(): + raise ValueError('Upstream tracked files differ from the pinned revision') + for relative, expected in bundle['files'].items(): + if sha(args.input_root / relative) != expected: + raise ValueError(f'Input checksum mismatch: {relative}') + torch.set_num_threads(bundle['manifest']['threads']) + seed = bundle['manifest']['seed'] + torch.manual_seed(seed) + random.seed(seed) + np.random.seed(seed) + torch.backends.cuda.matmul.fp32_precision = 'ieee' + torch.backends.cudnn.conv.fp32_precision = 'ieee' + sys.path.insert(0, str(args.upstream.resolve())) + if entry['method'] == 'qto': + sys.path.insert(0, str(args.upstream.resolve() / 'kbc')) + prefix, structured, easy, hard, graph, graphs = reference_dataset(bundle, entry, args.input_root) + n, nr, triples = graph['num_entities'], graph['num_relations'], graph['triples'] + name_shapes = {} + for shape in entry['query_types']: + # Infer structure labels independently from the source query syntax. + example = {'1p': (0, (0,)), '2p': (0, (0, 0)), '3p': (0, (0, 0, 0)), '4p': (0, (0, 0, 0, 0)), + '2i': ((0, (0,)), (1, (0,))), '3i': ((0, (0,)), (1, (0,)), (2, (0,))), + '4i': ((0, (0,)), (1, (0,)), (2, (0,)), (3, (0,))), + 'ip': (((0, (0,)), (1, (0,))), (0,)), 'pi': ((0, (0, 0)), (1, (0,))), + '2u': ((0, (0,)), (1, (0,)), (-1,)), 'up': (((0, (0,)), (1, (0,)), (-1,)), (0,)), + '2in': ((0, (0,)), (1, (0, -2))), '3in': ((0, (0,)), (1, (0,)), (2, (0, -2))), + 'inp': (((0, (0,)), (1, (0, -2))), (0,)), 'pin': ((0, (0, 0)), (1, (0, -2))), + 'pni': ((0, (0, 0, -2)), (1, (0,)))}[shape] + name_shapes[structure(example)] = shape + queries = {digest((name_shapes[struct], query, sorted(easy[query]), sorted(hard[query]))): (name_shapes[struct], query) + for struct, group in structured.items() if struct in name_shapes for query in group} + frozen_plan = bundle['plans'][f'{args.entry}/valid'] + if sha(args.bundle / frozen_plan['path']) != frozen_plan['sha256']: + raise ValueError('Plan checksum mismatch') + plan = json.loads((args.bundle / frozen_plan['path']).read_text()) + selected_inputs = {entry['checkpoint'], *entry.get('adapters', {}).values()} + if entry.get('training'): + selected_inputs.add(entry['training']) + inputs = {key: value for key, value in bundle['files'].items() if key in selected_inputs or key.startswith(prefix)} + oracle = dict(version=1, entry_sha256=digest({key: value for key, value in entry.items() if key != 'verification'}), + inputs_sha256=digest(inputs), validation_plan_sha256=frozen_plan['sha256'], + reference_commit=commit, exporter_sha256=sha(Path(__file__)), pilot_queries=args.pilot_queries, + probe_only=args.probe_only, scores={}, orders={}) + oracle['graphs'] = graphs + oracle['runtime_adjustments'] = (['Set the default tensor device during CQD forward; upstream hybrid padding omits device.'] + if entry['method'] in ('cqd', 'cqd-hybrid') else []) + if entry['method'] == 'qto': + oracle['runtime_adjustments'] = ['Lazy canonical 100-head calibration; up to 100 max-reduction partitions instead of 10.'] + oracle['helpers_sha256'] = {'reference_qto.py': sha(Path(__file__).with_name('reference_qto.py'))} + if entry['method'] == 'clmpt': + oracle['runtime_adjustments'] = ['Partition independent attention heads; preserve complete query sequences and batches.'] + if entry['method'] == 'incoming-relation': + oracle['runtime_adjustments'] = ['Seed each query independently before upstream random tie shuffling; preserve Boolean classes.'] + if entry['method'] in ('gnnqe', 'inductive-gnnqe', 'incoming-relation'): + oracle['runtime_adjustments'].append('Configure TorchDrug size-to-index helper and Python/RDKit imports.') + if entry['method'] in ('cqd', 'cqd-hybrid') and entry['options'].get('reference_batching') is False: + oracle['runtime_adjustments'].append( + 'Bound every CQD atom stage with declared row batches and stage-global normalization before observed overrides; ' + 'use upstream row-wise candidate selection and global padding, streaming final max, and released 3p/4p quirks.') + oracle['arithmetic_profile'] = dict(name='cqd-bounded-rows-v1', row_batch_size=entry['options']['row_batch_size'], + topk='row-wise', normalization='stage-global-before-observed-facts') + oracle['helpers_sha256'] = {'reference_cqd.py': sha(Path(__file__).with_name('reference_cqd.py'))} + elif (entry['method'] in ('cqd', 'cqd-hybrid') and entry['options'].get('final_batch_size') + and args.device.startswith('cuda')): + oracle['runtime_adjustments'].append('Stream final 4p projection with stage-global normalization; preserve released 4p quirks.') + oracle['helpers_sha256'] = {'reference_cqd.py': sha(Path(__file__).with_name('reference_cqd.py'))} + try: + driver = subprocess.check_output(['nvidia-smi', '--query-gpu=uuid,name,driver_version', '--format=csv,noheader'], text=True).strip() + except (OSError, subprocess.CalledProcessError): + driver = None + oracle['environment'] = dict(python=platform.python_version(), torch=str(torch.__version__), cuda=torch.version.cuda, + gpu=torch.cuda.get_device_name(args.device) if args.device.startswith('cuda') else None, + driver=driver, precision='float32 IEEE; no autocast', threads=torch.get_num_threads()) + with torch.no_grad(): + predict = predictor(entry, args.upstream, args.input_root / entry['checkpoint'], n, nr, triples, queries, + args.device, args.pilot_queries if args.probe_only else None) + counts, start = collections.Counter(), 0 + for end in plan['batch_ends']: + keys = plan['queries'][start:end] + shape = queries[keys[0]][0] + if counts[shape] < args.pilot_queries: + values = predict(shape, [queries[key][1] for key in keys]) + if args.probe_only: + keys = keys[:args.pilot_queries - counts[shape]] + values = values[:len(keys)] + orders = values.argsort(dim=-1, descending=True) + for key, value, order in zip(keys, values, orders): + oracle['scores'][key], oracle['orders'][key] = value.cpu(), order.cpu() + counts[shape] += len(keys) + print(json.dumps(dict(shape=shape, queries=counts[shape])), flush=True) + start = end + args.output.parent.mkdir(parents=True, exist_ok=True) + torch.save(oracle, args.output) + + +if __name__ == '__main__': + main() diff --git a/benchmarks/cqa/verification/reference_cqd.py b/benchmarks/cqa/verification/reference_cqd.py new file mode 100644 index 000000000..29b226604 --- /dev/null +++ b/benchmarks/cqa/verification/reference_cqd.py @@ -0,0 +1,183 @@ +"""Bound the released 4p oracle's final projection; no DICE imports.""" + +import torch + + +def query_4p(model, source, queries, batch_size): + if len(queries) != 1: + raise ValueError('The released hybrid executor requires single-query batches') + entity, predicate = model.embeddings + + def raw(lhs, rel, rhs): + result = model.score_o(lhs, rel, rhs)[0] + return result.sigmoid() * model.max_norm if model.do_sigmoid else result + + def scoring(lhs, rel, rhs): + result = raw(lhs, rel, rhs) + if model.do_normalize: + result = model.max_norm * (result - result.min()) / (result.max() - result.min()) + return result + + ids = queries[:, 0] + # Each stage gathers by ID, so selected embedding tensors are unnecessary. + for position in (1, 2, 3): + relation = queries[:, position] + atoms = torch.stack((ids, relation.expand_as(ids)), -1) + prefix, _, ids = source.score_candidates( + queries=atoms, filters=model.filters, s_emb=entity(ids), p_emb=predicate(relation), + candidates_emb=entity.weight, k=model.k, max_norm=model.max_norm, max_k=model.max_k, + entity_embeddings=lambda indices: None, scoring_function=scoring) + ids = ids.flatten().long() + + # Preserve both release quirks: r3 embeddings for atom 4, and only atom 3's prefix. + relation = predicate(queries[:, 3]) + prefix = prefix.flatten() + low, high = None, None + if model.do_normalize: + for heads in ids.split(batch_size): + values = raw(entity(heads), relation.expand(len(heads), -1), entity.weight) + lo, hi = values.min(), values.max() + low = lo if low is None else torch.minimum(low, lo) + high = hi if high is None else torch.maximum(high, hi) + result = None + for offset in range(0, len(ids), batch_size): + heads = ids[offset:offset + batch_size] + values = raw(entity(heads), relation.expand(len(heads), -1), entity.weight) + if model.do_normalize: + values = model.max_norm * (values - low) / (high - low) + if model.max_norm != 1: + for row, head in enumerate(heads.tolist()): + values[row, model.filters.get((head, int(queries[0, 4])), [])] = 1 + before = prefix[offset:offset + len(heads), None] + combined = before * values if model.t_norm_name == 'prod' else torch.minimum(before, values) + best = combined.max(0).values + result = best if result is None else torch.maximum(result, best) + return result[None] + + +class _BoundedStages: + """Partition score_o calls while delegating fact overrides/top-k to upstream. + + The profile fixes both GEMM row groups and row-wise candidate selection. + Extrema cover an entire logical atom stage, before any observed-fact override. + Only selected IDs/scores survive between stages, never selected embeddings. + """ + + def __init__(self, model, source, batch_size): + self.model, self.source, self.batch_size = model, source, batch_size + self.entity, self.predicate = model.embeddings + self.combine = torch.mul if model.t_norm_name == 'prod' else torch.minimum + + def raw(self, heads, relation): + values = self.model.score_o(self.entity(heads), self.predicate(relation).expand(len(heads), -1), self.entity.weight)[0] + return values.sigmoid() * self.model.max_norm if self.model.do_sigmoid else values + + def rows(self, heads, relation): + low, high, retained = None, None, None + if self.model.do_normalize: + for group in heads.split(self.batch_size): + values = self.raw(group, relation) + low = values.min() if low is None else torch.minimum(low, values.min()) + high = values.max() if high is None else torch.maximum(high, values.max()) + if len(heads) <= self.batch_size: + retained = values + del values + if high == low: + raise ValueError('Upstream min-max normalization is undefined for constant scores') + for offset in range(0, len(heads), self.batch_size): + group = heads[offset:offset + self.batch_size] + values = retained if retained is not None else self.raw(group, relation) + retained = None + if self.model.do_normalize: + values = self.model.max_norm * (values - low) / (high - low) + yield offset, group, values + + def candidates(self, heads, relation, values, k): + # score_candidates remains responsible for observed-fact replacement, + # per-row beam width, and the upstream topk implementation. + return self.source.score_candidates( + queries=torch.stack((heads, relation.expand_as(heads)), -1), + filters=self.model.filters, s_emb=self.entity(heads), p_emb=self.predicate(relation), + candidates_emb=self.entity.weight, k=k, max_norm=self.model.max_norm, max_k=self.model.max_k, + entity_embeddings=lambda indices: None, scoring_function=lambda *_: values) + + def select(self, heads, relation): + selected = [] + for _, group, values in self.rows(heads, relation): + for index in range(len(group)): + scores, _, ids = self.candidates(group[index:index + 1], relation, values[index:index + 1], self.model.k) + selected.append((scores, ids)) + # Upstream hybrid pads each parent's selections to the largest width + # across the full stage, not to a per-partition width. + width = max(scores.shape[1] for scores, _ in selected) + scores = torch.cat([torch.nn.functional.pad(s, (0, width - s.shape[1])) for s, _ in selected]) + ids = torch.cat([torch.nn.functional.pad(i, (0, width - i.shape[1])) for _, i in selected]) + return scores, ids + + def finish(self, heads, relation, prefix, observed_relation=None): + result = None + for offset, group, values in self.rows(heads, relation): + scores, _, _ = self.candidates(group, relation if observed_relation is None else observed_relation, values, None) + best = self.combine(prefix[offset:offset + len(group), None], scores).max(0).values + result = best if result is None else torch.maximum(result, best) + return result[None] + + def path(self, queries): + heads = queries[:, 0] + if queries.shape[1] == 2: + _, group, values = next(self.rows(heads, queries[:, 1])) + return self.candidates(group, queries[:, 1], values, None)[0] + stages = [] + for position in range(1, queries.shape[1] - 1): + scores, heads = self.select(heads.flatten(), queries[:, position]) + stages.append(scores) + if queries.shape[1] == 5: + # Released 4p discards earlier prefixes and scores r3 again, while + # its observed-fact lookup still uses the requested r4. + return self.finish(heads.flatten(), queries[:, 3], stages[-1].flatten(), queries[:, 4]) + prefix = stages[0].flatten() + if len(stages) == 2: + # Literal upstream 3p repeat (not repeat_interleave). + prefix = self.combine(prefix.repeat(stages[1].shape[1]), stages[1].flatten()) + return self.finish(heads.flatten(), queries[:, -1], prefix) + + +def query_bounded(model, source, shape, queries, batch_size): + """Independent bounded oracle for all eleven released positive shapes. + + This is a declared arithmetic profile, not a claim of bitwise equivalence + with the release's unpartitioned GEMMs. Both oracle and implementation must + use the declared row grouping; numerical/rank/tie checks remain unchanged. + """ + if len(queries) != 1 or type(batch_size) is not int or batch_size < 1: + raise ValueError('Bounded CQD requires one query and a positive integer row batch size') + stages = _BoundedStages(model, source, batch_size) + if shape in ('1p', '2p', '3p', '4p'): + return stages.path(queries) + if shape == 'pi': + return stages.combine(stages.path(queries[:, :3]), stages.path(queries[:, 3:5])) + + # Retain upstream composition for all intersection/union base branches. + def scoring(lhs, rel, rhs): + values = model.score_o(lhs, rel, rhs)[0] + if model.do_sigmoid: + values = values.sigmoid() * model.max_norm + if model.do_normalize: + values = model.max_norm * (values - values.min()) / (values.max() - values.min()) + return values + + union = shape in ('2u', 'up') + function = source.query_2u_dnf if union else getattr(source, 'query_' + ('2i' if shape == 'ip' else shape)) + combine = (lambda a, b: 1 - (1 - a) * (1 - b)) if model.t_norm_name == 'prod' else torch.maximum + base = function(entity_embeddings=model.embeddings[0], predicate_embeddings=model.embeddings[1], + queries=queries[:, :4] if shape in ('ip', 'up') else queries, + filters=model.filters, max_k=model.max_k, max_norm=model.max_norm, + scoring_function=scoring, **{'t_conorm' if union else 't_norm': combine if union else stages.combine}) + if shape not in ('ip', 'up'): + return base + existing = int((base == 1).sum()) if model.max_norm != 1 else 0 + count = min(model.k + existing, model.nentity) + if model.max_k is not None: + count = min(count, model.max_k) + prefix, heads = base.topk(count, dim=1) + return stages.finish(heads.flatten(), queries[:, 5 if union else 4], prefix.flatten()) diff --git a/benchmarks/cqa/verification/reference_kgfm.py b/benchmarks/cqa/verification/reference_kgfm.py new file mode 100644 index 000000000..eb0a8cff0 --- /dev/null +++ b/benchmarks/cqa/verification/reference_kgfm.py @@ -0,0 +1,112 @@ +"""Independent adapter and fixed-k algebra; atomic backbone logits are shared.""" + +import math +from collections import Counter, defaultdict + +import torch + + +class ReferenceKGFM: + def __init__(self, triples, n, nr, adapter, *, beam_size, device, restore_observed=True): + if (adapter['feature_mode'] not in ('context_scores', 'context_scores_v1', 'global') or adapter['hidden_dim'] + or adapter['normalization'] != 'none' or adapter['observed_mix'] not in (0, 1)): + raise ValueError('This reference covers the frozen linear observed-fact recipe') + self.n, self.nr, self.adapter = n, nr, adapter + self.k, self.device = beam_size, device + self.restore_observed = restore_observed + self.edges = defaultdict(set) + triples = set(map(tuple, triples)) + self.degree = Counter(h for h, _, _ in triples) + self.frequency = Counter(r for _, r, _ in triples) + for h, r, t in triples: + self.edges[h, r].add(t) + self.rows = {} + self.raw_rows = 0 + + def capture(self, conditions, raw): + """Calibrate fresh logits without calling the production feature/adapter code.""" + raw = raw.double() + observed = torch.zeros_like(raw, dtype=torch.bool) + features = [] + for i, (h, r) in enumerate(conditions): + tails = self.edges[h, r] + observed[i, sorted(tails)] = True + features.append([1., math.log1p(len(tails)) / math.log1p(self.n), + math.log1p(self.degree[h]) / math.log1p(self.n * self.nr), + math.log1p(self.frequency[r]) / math.log1p(self.n**2)]) + mean = raw.mean(1) + centered = raw - raw.max(1, keepdim=True).values + mass = centered.exp() + total = mass.sum(1) + entropy = (total.log() - (mass * centered).sum(1) / total) / math.log(self.n) + top = raw.topk(2, dim=1).values + gap = ((top[:, 0] - top[:, 1]) / 4).tanh() + count = observed.sum(1) + contrast = torch.where(count > 0, (((raw * observed).sum(1) / count.clamp_min(1) - mean) / 4).tanh(), 0.) + features = torch.cat((raw.new_tensor(features), + torch.stack(((mean / 4).tanh(), entropy, gap, contrast), dim=1)), 1) + if self.adapter['feature_mode'] == 'global': + features = raw.new_ones((len(raw), 1)) + u, v = (features @ raw.new_tensor(self.adapter['weights']).T).unbind(1) + bound = math.log(self.adapter['scale_bound']) + alpha = (bound * (u * (math.log(2) / bound)).tanh()).exp() + logits = alpha[:, None] * raw + self.adapter['bias_bound'] * v.tanh()[:, None] + calibrated = torch.nn.functional.logsigmoid(logits) + if self.adapter['observed_mix'] == 1: + calibrated = calibrated.masked_fill(observed, 0.) + self.rows.update((tuple(condition), row.cpu()) for condition, row in zip(conditions, calibrated)) + self.raw_rows += len(conditions) + + @staticmethod + def complement(value): + result = torch.empty_like(value) + small = value < -math.log(2) + result[small] = torch.log1p(-value[small].exp()) + result[~small] = torch.log(-torch.expm1(value[~small])) + return result + + def predict(self, query, operator='product'): + """Interpret nested tuples directly, with no production parser or executor.""" + def visit(value): + if isinstance(value, int): + scores = torch.full((self.n,), -torch.inf, dtype=torch.float64, device=self.device) + scores[value] = 0. + return scores, {value}, True + if (len(value) == 2 and value[1] and value[1] != (-1,) + and all(isinstance(r, int) for r in value[1])): + scores, answers, positive = visit(value[0]) + for position, relation in enumerate(value[1]): + if relation == -2: + scores, positive = self.complement(scores), False + answers = set(range(self.n)) - answers + continue + if isinstance(value[0], int) and position == 0: + scores = self.rows[value[0], relation].to(self.device) + else: + heads = scores.argsort(descending=True, stable=True)[:self.k].tolist() + reduced = torch.full_like(scores, -torch.inf) + for head in heads: + if torch.isneginf(scores[head]).item(): + continue + row = self.rows[head, relation].to(self.device) + joined = scores[head] + row if operator == 'product' else torch.minimum(scores[head], row) + reduced = torch.maximum(reduced, joined) + scores = reduced + answers = set().union(*(self.edges[h, relation] for h in answers)) + return scores, answers, positive + union = value[-1] == (-1,) + branches = [visit(branch) for branch in (value[:-1] if union else value)] + rows = torch.stack([row for row, _, _ in branches]) + if operator == 'product': + scores = self.complement(self.complement(rows).sum(0)) if union else rows.sum(0) + else: + scores = rows.max(0).values if union else rows.min(0).values + sets = [answers for _, answers, _ in branches] + answers = set.union(*sets) if union else set.intersection(*sets) + return scores, answers, all(positive for _, _, positive in branches) + + scores, answers, positive = visit(query) + if self.restore_observed and self.adapter['observed_mix'] == 1 and positive: + scores = scores.clone() + scores[sorted(answers)] = 0. + return scores diff --git a/benchmarks/cqa/verification/reference_qto.py b/benchmarks/cqa/verification/reference_qto.py new file mode 100644 index 000000000..4aee4da00 --- /dev/null +++ b/benchmarks/cqa/verification/reference_qto.py @@ -0,0 +1,70 @@ +"""Lazy reference adjacency with upstream QTO's canonical 100-head calibration.""" + +from collections import OrderedDict, defaultdict + +import torch + + +class ReferenceRelations: + def __init__(self, source, model, triples, n, device, threshold, fraction=100, cache_bytes=256 * 2**20): + self.source, self.model = source, model + self.n, self.device, self.threshold, self.fraction = n, device, threshold, fraction + self.cache, self.cache_bytes, self.bytes = OrderedDict(), cache_bytes, 0 + self.observed = defaultdict(lambda: defaultdict(list)) + for head, relation, tail in triples: + self.observed[relation][head].append(tail) + + def block(self, relation, start): + key = relation, start + if key in self.cache: + self.cache.move_to_end(key) + return self.cache[key] + end = min(start + 100, self.n) + heads = torch.arange(start, end, device=self.device) + rel = torch.tensor([relation], device=self.device) + scores = self.source.kge_forward(self.model, heads, rel, self.device, self.n) + degree = scores.new_tensor([max(1, len(self.observed[relation][head])) for head in range(start, end)]) + value = torch.softmax(scores, dim=1) * degree[:, None] + value = ((value >= self.threshold).float() * value).cpu() + value = (value >= 1).float() * .9999 + (value < 1).float() * value + for head in range(start, end): + value[head - start, self.observed[relation][head]] = 1 + size = value.numel() * value.element_size() + if size <= self.cache_bytes: + while self.bytes + size > self.cache_bytes: + _, previous = self.cache.popitem(last=False) + self.bytes -= previous.numel() * previous.element_size() + self.cache[key] = value + self.bytes += size + return value + + def __getitem__(self, relation): + return _Relation(self, int(relation)) + + +class _Relation: + def __init__(self, owner, relation): + self.owner, self.relation = owner, relation + + def __getitem__(self, part): + return _Rows(self.owner, self.relation, part * (self.owner.n // self.owner.fraction)) + + +class _Rows: + def __init__(self, owner, relation, offset): + self.owner, self.relation, self.offset = owner, relation, offset + + def to_dense(self): + # Upstream immediately selects active rows; materialize only that selection. + return self + + def __getitem__(self, key): + indices, columns = key + if columns != slice(None): + raise ValueError('Expected the complete candidate domain') + heads = indices.cpu().tolist() + rows = [] + for index in heads: + head = index + self.offset + rows.append(self.owner.block(self.relation, head // 100 * 100)[head % 100]) + return torch.stack(rows).to(self.owner.device) diff --git a/benchmarks/cqa/verification/verify_kgfm.py b/benchmarks/cqa/verification/verify_kgfm.py new file mode 100644 index 000000000..0becf9019 --- /dev/null +++ b/benchmarks/cqa/verification/verify_kgfm.py @@ -0,0 +1,98 @@ +"""Validate the frozen KGFM pipeline against independent calibration/composition.""" + +import json +from pathlib import Path +from unittest.mock import patch + +import torch + +from dicee.query_answering.context import fingerprint +from dicee.query_answering.engine import AtomicScorer, QueryAnswerer + +from ..study import bundle_entry, checksum, entry_inputs_identity, read, run_job, verify_bundle +from .reference_kgfm import ReferenceKGFM + + +def verify(bundle_dir, entry_id, root, output, *, device='cuda', probes=2): + output = Path(output) + output.mkdir(parents=True, exist_ok=True) + if (output / 'pilot').exists(): + raise FileExistsError('Use a fresh directory so every prediction is checked') + bundle = verify_bundle(bundle_dir, root) + entry = bundle_entry(bundle, entry_id) + if not entry['method'].endswith('-adapter') or len(entry['adapters']) != 1: + raise ValueError('Select a frozen single-operator KGFM entry') + adapter = read(Path(root) / next(iter(entry['adapters'].values()))) + observed_facts = entry['options'].get('observed_facts') + if observed_facts is not None: + adapter['observed_mix'] = float(observed_facts != 'none') + references, scorers, comparisons, scores, orders = {}, {}, {}, {}, {} + original = AtomicScorer.rows + original_init = QueryAnswerer.__init__ + + def initialize(engine, *args, **kwargs): + original_init(engine, *args, **kwargs) + scorer = engine.scorer + variant = 'without-adapter' if engine.adapter.metadata.get('calibration') == 'identity' else 'learned' + expected_adapter = adapter if variant == 'learned' else dict(adapter, feature_mode='global', weights=[[0.], [0.]]) + reference = ReferenceKGFM(scorer.context.triples, scorer.n, scorer.nr, expected_adapter, + beam_size=entry['options']['beam_size'], device=scorer.device, + restore_observed=observed_facts in (None, 'both')) + scorers[id(scorer)] = reference + references[variant] = reference + + def capture(scorer, conditions): + raw = original(scorer, conditions) + scorers[id(scorer)].capture(conditions, raw) + return raw + + def compare(query, actual, variant='learned'): + key = query.identity + expected = references[variant].predict(query.query, entry['operators'][query.shape]) + order = expected.argsort(descending=True) + finite = actual.isfinite() & expected.isfinite() + error = (actual[finite] - expected[finite]).abs().max().item() if finite.any() else 0. + result = dict(shape=query.shape, variant=variant, max_error=error, + scores_match=torch.allclose(actual, expected, atol=1e-12, rtol=1e-12), + ranks_match=torch.equal(actual.argsort(descending=True), order), + ties_match=torch.equal(actual[order][1:] == actual[order][:-1], + expected[order][1:] == expected[order][:-1])) + result['passed'] = all(result[name] for name in ('scores_match', 'ranks_match', 'ties_match')) + comparisons[f'{variant}:{key}'] = result + scores.setdefault(variant, {})[key], orders.setdefault(variant, {})[key] = expected.cpu(), order.cpu() + print(json.dumps(dict(query=len(comparisons), **result)), flush=True) + + with patch.object(AtomicScorer, 'rows', capture), patch.object(QueryAnswerer, '__init__', initialize): + report = run_job(bundle_dir, entry_id, root, output / 'pilot', device=device, phase='pilot', + pilot_queries=probes, probe_only=True, on_prediction=compare, + on_control_prediction=lambda query, actual: compare(query, actual, 'without-adapter')) + variants = {'learned', 'without-adapter'} if entry.get('adapter_ablation') else {'learned'} + if set(references) != variants or any({row['shape'] for row in comparisons.values() if row['variant'] == variant} + != set(entry['query_types']) for variant in variants): + raise ValueError('Integration check missed a query type or calibration variant') + identity = dict(entry_sha256=fingerprint({k: v for k, v in entry.items() if k != 'verification'}), + inputs_sha256=entry_inputs_identity(bundle, entry)) + scope = ('Independent context features, linear adapter, tuple interpretation, stable fixed-k pruning, ' + 'fuzzy composition and positive observed-answer restoration. Shared native backbone logits; ' + 'this is integration evidence, not an independent backbone reproduction. ' + 'Paired entries also verify the identity-calibration control on every query type.') + oracle = dict(version=1, **identity, validation_plan_sha256=bundle['plans'][f'{entry_id}/valid']['sha256'], + pilot_queries=probes, probe_only=True, scores=scores['learned'], orders=orders['learned'], + comparison_scores={key: value for key, value in scores.items() if key != 'learned'}, + comparison_orders={key: value for key, value in orders.items() if key != 'learned'}, + environment=report['benchmark_run']['environment'], runtime_adjustments=[scope]) + torch.save(oracle, output / 'reference.pt') + evidence = dict(**identity, source_sha256=bundle['source_sha256'], environment=report['benchmark_run']['environment'], + reference_sha256=checksum(output / 'reference.pt'), reference_commit=None, + reference_implementation={p.name: checksum(p) for p in (Path(__file__), Path(__file__).with_name('reference_kgfm.py'))}, + queries=comparisons, scope=scope, probe_only=True, + reference_adjustments=[scope], atol=1e-12, rtol=1e-12, + passed=all(row['passed'] for row in comparisons.values()), + raw_rows=sum(reference.raw_rows for reference in references.values()), + unique_rows=sum(len(reference.rows) for reference in references.values()), + peak_cuda_allocated_bytes=report['peak_cuda_allocated_bytes'], + total_wall_seconds=report['total_wall_seconds']) + (output / 'integration.json').write_text(json.dumps(evidence, indent=2) + '\n') + if not evidence['passed']: + raise RuntimeError('Integration parity failed; inspect integration.json') + return evidence diff --git a/benchmarks/plus_h/baselines.json b/benchmarks/plus_h/baselines.json new file mode 100644 index 000000000..2e64ca343 --- /dev/null +++ b/benchmarks/plus_h/baselines.json @@ -0,0 +1,359 @@ +{ + "version": 1, + "answer_filter": "corrected", + "data_root": "KGs/query-benchmarks-plus-h", + "seed": 0, + "threads": 4, + "archives": { + "models": {"sha256": "d30b77a9c84d28de766bb5722c600bdc3c1e46d16cdaa3066ed4faca2b9b236f", "bytes": 4507216854, "source": "https://github.com/april-tools/is-cqa-complex#pre-trained-models"}, + "datasets": { + "source": "https://github.com/april-tools/is-cqa-complex/releases/tag/benchs-1.0", + "checksum_status": "Official release API digest; extracted runtime files are independently pinned by freeze.", + "sha256": "bf60135d7b1bc109ab9d90892e318fa96ace905fdc8204afd270b1fd98002a80", + "bytes": 1675873193 + } + }, + "recipes": [ + { + "defaults": { + "id": "cone-{dataset}", + "method": "cone", + "options": {"center_reg": 0.02}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 4, + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": ["Query batch size 4 follows the released checkpoint configuration."], + "graph_independent": true + }, + "blockers": [], + "inference_graph": "train" + }, + "entries": [ + {"dataset": "FB15k237+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/ConE/FB15k237/checkpoint"}, + {"dataset": "NELL995+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/ConE/NELL995/checkpoint"}, + {"dataset": "ICEWS18+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/ConE/ICEWS18/checkpoint"} + ] + }, + { + "defaults": { + "id": "gnnqe-{dataset}", + "method": "gnnqe", + "options": {"logic": "product", "edge_batch_size": 65536}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": ["Inference preserves the released query batch sizes, sparse reduction order and normalization arithmetic.", "Validation GPU scores, orders and ties match the pinned upstream batches."], + "inference_graph": "train" + }, + "blockers": [], + "inference_graph": "train+valid" + }, + "entries": [ + {"dataset": "FB15k237+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_FB15k237.pth", "query_batch_size": 48}, + {"dataset": "NELL995+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_NELL995.pth", "query_batch_size": 8}, + {"dataset": "ICEWS18+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_ICEWS18.pth", "query_batch_size": 48} + ] + }, + { + "defaults": { + "id": "ultraquery-{dataset}", + "method": "ultraquery", + "checkpoint": "Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth", + "options": {"logic": "product", "threshold": 0.0, "cache_bytes": 67108864}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 32, + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": [ + "The +H model archive README explicitly references this public PyG checkpoint.", + "Inference preserves the released query batch sizes, sparse reduction order and normalization arithmetic.", + "Validation GPU scores, orders and ties match the pinned upstream batches." + ], + "inference_graph": "train" + }, + "blockers": [], + "inference_graph": "train+valid" + }, + "entries": [{"dataset": "FB15k237+H"}, {"dataset": "NELL995+H"}, {"dataset": "ICEWS18+H"}] + }, + { + "defaults": { + "id": "clmpt-{dataset}", + "method": "clmpt", + "options": {"aggregation": "mean", "candidate_batch_size": 1024}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": [ + "Batch sizes follow the original CLMPT README/defaults; query grouping is reconstructed using the released converter and +H pickle iteration order.", + "Post-norm predictions depend on batch membership. Both up branches use the original relation groundings.", + "Conversion uses the released query files and pinned batches.", + "Independent attention heads are evaluated separately to bound workspace while preserving complete query batches." + ], + "graph_independent": true + }, + "blockers": [], + "inference_graph": "train" + }, + "entries": [ + {"dataset": "FB15k237+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-fb15k237.ckpt", "query_batch_size": 5000}, + {"dataset": "NELL995+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-nell995.ckpt", "query_batch_size": 8}, + {"dataset": "ICEWS18+H", "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-icews18.ckpt", "query_batch_size": 5000} + ] + }, + { + "defaults": { + "id": "cqd-{dataset}", + "method": "cqd", + "options": { + "beam_size": 2, + "tnorm": "prod", + "max_k": 512, + "normalize": true, + "reference_quirks": true, + "row_batch_size": 32, + "cache_bytes": 536870912, + "per_shape": { + "2p": {"tnorm": "prod"}, + "3p": {"tnorm": "prod"}, + "2i": {"tnorm": "prod"}, + "3i": {"tnorm": "prod"}, + "pi": {"tnorm": "prod"}, + "ip": {"tnorm": "prod"}, + "2u": {}, + "up": {"tnorm": "min"}, + "4p": {"beam_size": 2, "tnorm": "prod"}, + "4i": {"beam_size": 2, "tnorm": "prod"} + }, + "reference_batching": true, + "atomic_negation": true + }, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 1, + "query_order": "upstream-pickle", + "reference": {"status": "native reference port; full reproduction pending", "settings": "https://arxiv.org/html/2410.12537v3#A6", "graph_independent": true}, + "blockers": [], + "inference_graph": "train" + }, + "entries": [ + { + "dataset": "FB15k237+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/fb15k237checkpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 512}, + "3p": {"beam_size": 8}, + "2i": {"beam_size": 128}, + "3i": {"beam_size": 128}, + "pi": {"beam_size": 256}, + "ip": {"beam_size": 64}, + "2u": {"beam_size": 512, "tnorm": "prod"}, + "up": {"beam_size": 512} + } + }, + "reference": { + "notes": [ + "All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", + "Released 3p/4p quirks are preserved.", + "FB 2u uses product: full-query CPU diagnostics reproduce published 40.1/42.2, while the appendix states min. The up setting uses the documented min." + ] + } + }, + { + "dataset": "NELL995+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 512}, + "3p": {"beam_size": 2}, + "2i": {"beam_size": 2}, + "3i": {"beam_size": 2}, + "pi": {"beam_size": 256}, + "ip": {"beam_size": 256}, + "2u": {"beam_size": 512, "tnorm": "min"}, + "up": {"beam_size": 512} + } + }, + "reference": { + "notes": ["All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", "Released 3p/4p quirks are preserved."] + } + }, + { + "dataset": "ICEWS18+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/ICEWS18/checkpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 32}, + "3p": {"beam_size": 2}, + "2i": {"beam_size": 2}, + "3i": {"beam_size": 2}, + "pi": {"beam_size": 512}, + "ip": {"beam_size": 256}, + "2u": {"beam_size": 2, "tnorm": "min"}, + "up": {"beam_size": 2} + } + }, + "reference": { + "notes": ["All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", "Released 3p/4p quirks are preserved."] + } + } + ] + }, + { + "defaults": { + "id": "cqd-hybrid-{dataset}", + "method": "cqd-hybrid", + "options": { + "beam_size": 2, + "tnorm": "prod", + "max_k": 512, + "normalize": true, + "reference_quirks": true, + "row_batch_size": 32, + "cache_bytes": 536870912, + "per_shape": { + "2p": {"tnorm": "prod"}, + "3p": {"tnorm": "prod"}, + "2i": {"tnorm": "prod"}, + "3i": {"tnorm": "prod"}, + "pi": {"tnorm": "prod"}, + "ip": {"tnorm": "prod"}, + "2u": {}, + "up": {"tnorm": "min"}, + "4p": {"beam_size": 2, "tnorm": "prod"}, + "4i": {"beam_size": 2, "tnorm": "prod"} + }, + "reference_batching": true, + "final_batch_size": 32, + "atomic_negation": true + }, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 1, + "query_order": "upstream-pickle", + "reference": {"status": "native reference port; full reproduction pending", "settings": "https://arxiv.org/html/2410.12537v3#A6"}, + "blockers": [], + "inference_graph": "train+valid" + }, + "entries": [ + { + "dataset": "FB15k237+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/fb15k237checkpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 512}, + "3p": {"beam_size": 8}, + "2i": {"beam_size": 128}, + "3i": {"beam_size": 128}, + "pi": {"beam_size": 256}, + "ip": {"beam_size": 64}, + "2u": {"beam_size": 512, "tnorm": "prod"}, + "up": {"beam_size": 512} + } + }, + "reference": { + "notes": [ + "All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", + "Released 3p/4p quirks are preserved.", + "Stream the final projection with global stage normalization; bounded 4p reference preserves the released quirks.", + "FB 2u uses product: full-query CPU diagnostics reproduce published 40.1/42.2, while the appendix states min. The up setting uses the documented min." + ], + "inference_graph": "train+valid" + } + }, + { + "dataset": "NELL995+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 512}, + "3p": {"beam_size": 2}, + "2i": {"beam_size": 2}, + "3i": {"beam_size": 2}, + "pi": {"beam_size": 256}, + "ip": {"beam_size": 256}, + "2u": {"beam_size": 512, "tnorm": "min"}, + "up": {"beam_size": 512} + } + }, + "reference": { + "notes": [ + "All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", + "Released 3p/4p quirks are preserved.", + "Stream the final projection with global stage normalization; bounded 4p reference preserves the released quirks." + ], + "inference_graph": "train+valid" + } + }, + { + "dataset": "ICEWS18+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/ICEWS18/checkpoint", + "options": { + "per_shape": { + "2p": {"beam_size": 32}, + "3p": {"beam_size": 2}, + "2i": {"beam_size": 2}, + "3i": {"beam_size": 2}, + "pi": {"beam_size": 512}, + "ip": {"beam_size": 256}, + "2u": {"beam_size": 2, "tnorm": "min"}, + "up": {"beam_size": 2}, + "4p": {"max_k": 64} + } + }, + "reference": { + "notes": [ + "All 16 types are enabled, including the five negated types using CQD-A signed-atom negation with +H scoring.", + "Released 3p/4p quirks are preserved.", + "Stream the final projection with global stage normalization; bounded 4p reference preserves the released quirks." + ], + "inference_graph": "unverified" + } + } + ] + }, + { + "defaults": { + "id": "qto-{dataset}", + "method": "qto", + "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 1, + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": [], + "inference_graph": "train" + }, + "blockers": [], + "inference_graph": "train+valid" + }, + "entries": [ + { + "dataset": "FB15k237+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/fb15k237checkpoint", + "options": {"negation_scale": 3} + }, + { + "dataset": "NELL995+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint", + "options": {"negation_scale": 6} + }, + { + "dataset": "ICEWS18+H", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/ICEWS18/checkpoint", + "options": {"negation_scale": 3} + } + ] + } + ] +} diff --git a/benchmarks/plus_h/kgfm_adapters.json b/benchmarks/plus_h/kgfm_adapters.json new file mode 100644 index 000000000..7b3f31e76 --- /dev/null +++ b/benchmarks/plus_h/kgfm_adapters.json @@ -0,0 +1,108 @@ +{ + "version": 1, + "answer_filter": "corrected", + "data_root": "KGs/query-benchmarks-plus-h", + "seed": 0, + "threads": 4, + "archives": { + "models": {"sha256": "d30b77a9c84d28de766bb5722c600bdc3c1e46d16cdaa3066ed4faca2b9b236f", "bytes": 4507216854, "source": "https://github.com/april-tools/is-cqa-complex#pre-trained-models"}, + "datasets": { + "source": "https://github.com/april-tools/is-cqa-complex/releases/tag/benchs-1.0", + "checksum_status": "Official release API digest; extracted runtime files are independently pinned by freeze.", + "sha256": "bf60135d7b1bc109ab9d90892e318fa96ace905fdc8204afd270b1fd98002a80", + "bytes": 1675873193 + } + }, + "recipes": [ + { + "defaults": { + "id": "ultra-product-14type-{dataset}", + "method": "ultra-adapter", + "checkpoint": "checkpoints/ultra_3g.pth", + "adapters": {"product": "benchmarks/adapters/ultra_product_14types.json"}, + "options": {"beam_size": 64, "row_batch_size": 8, "backend_batch_size": 8, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product", + "4p": "product", + "4i": "product" + }, + "selection_protocol": "target-validation", + "finalized": true, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "frozen shared 14-type recipe; verification pending", + "notes": [ + "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; all 14 source query types; product t-norm; k=64.", + "One shared recipe across both backbones and all three datasets. +H validation screening informed recipe selection; this is not target-untuned zero-shot selection.", + "The 4p and 4i types were not included in adapter training.", + "Paired learned/identity calibration: alpha=1 and beta=0 in the control; retain observed facts, normalization, query plan, operators and beam width. Share exact atomic batches through a bounded 2 GiB CPU cache; split the 512 MiB calibrated cache equally." + ] + }, + "blockers": [], + "adapter_ablation": true, + "inference_graph": "train+valid" + }, + "entries": [{"dataset": "FB15k237+H"}, {"dataset": "NELL995+H"}, {"dataset": "ICEWS18+H"}] + }, + { + "defaults": { + "id": "trix-product-14type-{dataset}", + "method": "trix-adapter", + "checkpoint": "checkpoints/trix/entity_prediction.pth", + "adapters": {"product": "benchmarks/adapters/trix_product_14types.json"}, + "options": {"beam_size": 64, "row_batch_size": 1, "backend_batch_size": 1, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product", + "4p": "product", + "4i": "product" + }, + "selection_protocol": "target-validation", + "finalized": true, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "frozen shared 14-type recipe; verification pending", + "notes": [ + "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; all 14 source query types; product t-norm; k=64.", + "One shared recipe across both backbones and all three datasets. +H validation screening informed recipe selection; this is not target-untuned zero-shot selection.", + "The 4p and 4i types were not included in adapter training.", + "Paired learned/identity calibration: alpha=1 and beta=0 in the control; retain observed facts, normalization, query plan, operators and beam width. Share exact atomic batches through a bounded 2 GiB CPU cache; split the 512 MiB calibrated cache equally." + ] + }, + "blockers": [], + "adapter_ablation": true, + "inference_graph": "train+valid" + }, + "entries": [{"dataset": "FB15k237+H"}, {"dataset": "NELL995+H"}, {"dataset": "ICEWS18+H"}] + } + ] +} diff --git a/benchmarks/plus_h/published_results.json b/benchmarks/plus_h/published_results.json new file mode 100644 index 000000000..85fb31d9b --- /dev/null +++ b/benchmarks/plus_h/published_results.json @@ -0,0 +1,390 @@ +{ + "source": "https://github.com/april-tools/is-cqa-complex/blob/d1ce74164936a7c09d9147e83190da047cb39429/README.md", + "unit": "MRR x100; rounded published values", + "datasets": { + "FB15k237+H": { + "gnnqe": { + "1p": 42.8, + "2p": 5.2, + "3p": 4.0, + "2i": 6.0, + "3i": 8.8, + "pi": 5.6, + "ip": 9.9, + "2u": 32.5, + "up": 10.0, + "4p": 4.3, + "4i": 20.0, + "2in": 6.8, + "3in": 6.5, + "pin": 3.7, + "pni": 5.0, + "inp": 3.3 + }, + "ultraquery": { + "1p": 40.6, + "2p": 4.5, + "3p": 3.5, + "2i": 5.2, + "3i": 7.2, + "pi": 5.3, + "ip": 10.1, + "2u": 29.4, + "up": 8.3, + "4p": 3.8, + "4i": 16.4, + "2in": 5.3, + "3in": 5.5, + "pin": 2.6, + "pni": 3.7, + "inp": 2.2 + }, + "cqd": { + "1p": 46.7, + "2p": 4.4, + "3p": 2.4, + "2i": 11.3, + "3i": 12.8, + "pi": 6.0, + "ip": 11.5, + "2u": 40.1, + "up": 10.6, + "4p": 1.1, + "4i": 23.8, + "2in": 3.3, + "3in": 2.6, + "pin": 0.6, + "pni": 4.9, + "inp": 1.2 + }, + "cqd-hybrid": { + "1p": 46.7, + "2p": 4.8, + "3p": 3.1, + "2i": 6.0, + "3i": 8.6, + "pi": 5.5, + "ip": 12.9, + "2u": 42.2, + "up": 12.0, + "4p": 2.4, + "4i": 17.4, + "2in": 4.7, + "3in": 1.6, + "pin": 1.0, + "pni": 3.2, + "inp": 1.3 + }, + "cone": { + "1p": 41.8, + "2p": 4.6, + "3p": 3.9, + "2i": 9.1, + "3i": 10.3, + "pi": 3.8, + "ip": 7.9, + "2u": 22.8, + "up": 6.0, + "4p": 3.5, + "4i": 20.3, + "2in": 5.1, + "3in": 4.9, + "pin": 2.9, + "pni": 3.3, + "inp": 3.6 + }, + "qto": { + "1p": 46.7, + "2p": 4.9, + "3p": 3.7, + "2i": 8.7, + "3i": 10.1, + "pi": 6.1, + "ip": 13.5, + "2u": 30.6, + "up": 11.2, + "4p": 3.9, + "4i": 20.2, + "2in": 10.6, + "3in": 3.1, + "pin": 2.0, + "pni": 5.3, + "inp": 1.5 + }, + "clmpt": { + "1p": 45.3, + "2p": 5.3, + "3p": 4.7, + "2i": 10.2, + "3i": 12.2, + "pi": 5.6, + "ip": 14.9, + "2u": 33.6, + "up": 14.2, + "4p": 4.5, + "4i": 24.0, + "2in": 6.8, + "3in": 2.3, + "pin": 1.6, + "pni": 4.8, + "inp": 2.5 + } + }, + "NELL995+H": { + "gnnqe": { + "1p": 53.6, + "2p": 8.0, + "3p": 6.0, + "2i": 10.7, + "3i": 13.3, + "pi": 16.0, + "ip": 13.5, + "2u": 47.5, + "up": 9.8, + "4p": 4.7, + "4i": 19.4, + "2in": 5.5, + "3in": 6.4, + "pin": 5.8, + "pni": 3.3, + "inp": 4.4 + }, + "ultraquery": { + "1p": 38.9, + "2p": 6.1, + "3p": 4.1, + "2i": 7.9, + "3i": 10.2, + "pi": 15.8, + "ip": 9.3, + "2u": 28.1, + "up": 9.5, + "4p": 4.2, + "4i": 15.6, + "2in": 4.5, + "3in": 5.9, + "pin": 4.3, + "pni": 2.7, + "inp": 3.6 + }, + "cqd": { + "1p": 60.4, + "2p": 9.6, + "3p": 4.2, + "2i": 18.5, + "3i": 19.6, + "pi": 18.9, + "ip": 22.6, + "2u": 46.3, + "up": 18.5, + "4p": 2.0, + "4i": 24.8, + "2in": 4.2, + "3in": 1.5, + "pin": 1.5, + "pni": 4.9, + "inp": 2.6 + }, + "cqd-hybrid": { + "1p": 60.4, + "2p": 9.0, + "3p": 6.1, + "2i": 12.1, + "3i": 14.4, + "pi": 17.4, + "ip": 21.2, + "2u": 46.4, + "up": 19.3, + "4p": 3.5, + "4i": 20.4, + "2in": 5.1, + "3in": 1.2, + "pin": 1.4, + "pni": 4.3, + "inp": 2.4 + }, + "cone": { + "1p": 53.1, + "2p": 7.9, + "3p": 6.7, + "2i": 21.8, + "3i": 23.6, + "pi": 14.9, + "ip": 11.8, + "2u": 39.9, + "up": 8.8, + "4p": 5.2, + "4i": 27.6, + "2in": 4.6, + "3in": 6.0, + "pin": 3.7, + "pni": 2.7, + "inp": 6.4 + }, + "qto": { + "1p": 60.3, + "2p": 9.8, + "3p": 8.0, + "2i": 14.6, + "3i": 15.8, + "pi": 17.6, + "ip": 21.1, + "2u": 49.1, + "up": 18.9, + "4p": 7.0, + "4i": 20.9, + "2in": 10.2, + "3in": 2.3, + "pin": 3.1, + "pni": 8.4, + "inp": 2.4 + }, + "clmpt": { + "1p": 58.1, + "2p": 10.1, + "3p": 7.8, + "2i": 22.7, + "3i": 25.0, + "pi": 17.2, + "ip": 24.4, + "2u": 50.0, + "up": 22.0, + "4p": 7.2, + "4i": 29.1, + "2in": 6.5, + "3in": 2.4, + "pin": 4.1, + "pni": 2.3, + "inp": 4.5 + } + }, + "ICEWS18+H": { + "gnnqe": { + "1p": 12.2, + "2p": 0.9, + "3p": 0.5, + "2i": 16.1, + "3i": 26.5, + "pi": 19.1, + "ip": 3.5, + "2u": 7.6, + "up": 1.1, + "4p": 0.4, + "4i": 34.0, + "2in": 4.5, + "3in": 6.9, + "pin": 0.9, + "pni": 3.5, + "inp": 0.8 + }, + "ultraquery": { + "1p": 6.3, + "2p": 1.2, + "3p": 1.2, + "2i": 7.0, + "3i": 11.7, + "pi": 8.8, + "ip": 1.3, + "2u": 3.3, + "up": 1.2, + "4p": 0.8, + "4i": 15.9, + "2in": 2.3, + "3in": 4.8, + "pin": 1.2, + "pni": 2.2, + "inp": 1.6 + }, + "cqd": { + "1p": 16.6, + "2p": 2.5, + "3p": 1.5, + "2i": 13.0, + "3i": 19.5, + "pi": 17.1, + "ip": 6.7, + "2u": 6.8, + "up": 5.9, + "4p": 1.1, + "4i": 24.0, + "2in": 1.5, + "3in": 2.9, + "pin": 0.2, + "pni": 2.7, + "inp": 0.9 + }, + "cqd-hybrid": { + "1p": 16.6, + "2p": 2.6, + "3p": 1.5, + "2i": 15.0, + "3i": 25.5, + "pi": 17.5, + "ip": 5.8, + "2u": 6.8, + "up": 5.6, + "4p": 0.9, + "4i": 33.2, + "2in": 1.7, + "3in": 4.0, + "pin": 0.3, + "pni": 2.2, + "inp": 1.1 + }, + "cone": { + "1p": 3.5, + "2p": 0.9, + "3p": 0.9, + "2i": 1.2, + "3i": 0.5, + "pi": 1.2, + "ip": 1.6, + "2u": 1.1, + "up": 0.9, + "4p": 0.6, + "4i": 0.3, + "2in": 1.7, + "3in": 2.9, + "pin": 1.1, + "pni": 0.9, + "inp": 1.3 + }, + "qto": { + "1p": 16.6, + "2p": 2.6, + "3p": 1.4, + "2i": 15.7, + "3i": 25.0, + "pi": 18.4, + "ip": 6.2, + "2u": 6.7, + "up": 4.9, + "4p": 1.1, + "4i": 31.5, + "2in": 4.9, + "3in": 8.7, + "pin": 1.2, + "pni": 3.0, + "inp": 0.9 + }, + "clmpt": { + "1p": 4.7, + "2p": 0.8, + "3p": 0.1, + "2i": 12.0, + "3i": 23.0, + "pi": 9.7, + "ip": 2.1, + "2u": 2.7, + "up": 2.2, + "4p": 0.1, + "4i": 31.0, + "2in": 1.2, + "3in": 2.1, + "pin": 0.1, + "pni": 1.0, + "inp": 0.2 + } + } + } +} diff --git a/benchmarks/ultraquery/baselines.json b/benchmarks/ultraquery/baselines.json new file mode 100644 index 000000000..b325a72d3 --- /dev/null +++ b/benchmarks/ultraquery/baselines.json @@ -0,0 +1,55 @@ +{ + "version": 1, + "answer_filter": "released", + "data_root": "KGs/UltraQuery", + "seed": 0, + "threads": 4, + "archives": { + "datasets": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90#datasets-1", "checksum_status": "Every extracted runtime input is independently pinned by freeze."}, + "models": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90/ckpts", "checksum_status": "Released checkpoint and adapter bytes are independently pinned by freeze."} + }, + "recipes": [ + { + "defaults": { + "id": "ultraquery-{dataset}", + "method": "ultraquery", + "checkpoint": "Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth", + "options": {"logic": "product", "threshold": 0.0, "cache_bytes": 67108864}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 32, + "query_order": "upstream-pickle", + "reference": { + "status": "released PyG port; frozen validation parity required", + "settings": "https://github.com/DeepGraphLearning/ULTRA/blob/427966ad8ed60420eef034063d44f3153addff90/README.md#ultraquery", + "notes": ["Public query-trained checkpoint, product logic, threshold 0.0, published batch size 32.", "Released PyG implementation; original paper used a different TorchDrug checkpoint."] + }, + "blockers": [] + }, + "entries": [ + {"dataset": "FB15k237LogicalQuery"}, + {"dataset": "FB15kLogicalQuery"}, + {"dataset": "NELL995LogicalQuery"}, + {"dataset": "InductiveFB15k237Query:106"}, + {"dataset": "InductiveFB15k237Query:113"}, + {"dataset": "InductiveFB15k237Query:122"}, + {"dataset": "InductiveFB15k237Query:134"}, + {"dataset": "InductiveFB15k237Query:150"}, + {"dataset": "InductiveFB15k237Query:175"}, + {"dataset": "InductiveFB15k237Query:217"}, + {"dataset": "InductiveFB15k237Query:300"}, + {"dataset": "InductiveFB15k237Query:550"}, + {"dataset": "WikiTopicsQuery:art"}, + {"dataset": "WikiTopicsQuery:award"}, + {"dataset": "WikiTopicsQuery:edu"}, + {"dataset": "WikiTopicsQuery:health"}, + {"dataset": "WikiTopicsQuery:infra"}, + {"dataset": "WikiTopicsQuery:loc"}, + {"dataset": "WikiTopicsQuery:org"}, + {"dataset": "WikiTopicsQuery:people"}, + {"dataset": "WikiTopicsQuery:sci"}, + {"dataset": "WikiTopicsQuery:sport"}, + {"dataset": "WikiTopicsQuery:tax"} + ] + } + ] +} diff --git a/benchmarks/ultraquery/comparisons.json b/benchmarks/ultraquery/comparisons.json new file mode 100644 index 000000000..5bf9e51ef --- /dev/null +++ b/benchmarks/ultraquery/comparisons.json @@ -0,0 +1,229 @@ +{ + "version": 1, + "answer_filter": "released", + "data_root": "KGs/UltraQuery", + "seed": 0, + "threads": 4, + "archives": { + "datasets": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90#datasets-1", "checksum_status": "Every extracted runtime input is independently pinned by freeze."}, + "models": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90/ckpts", "checksum_status": "Released checkpoint and adapter bytes are independently pinned by freeze."} + }, + "recipes": [ + { + "defaults": { + "id": "ultraquery-lp-{dataset}", + "method": "ultraquery-lp", + "checkpoint": "Experiments/query-baselines/upstream/ultra/ckpts/ultra_3g.pth", + "options": {"logic": "product", "cache_bytes": 67108864}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 32, + "query_order": "upstream-pickle", + "reference": { + "status": "released PyG port; frozen validation parity required", + "settings": "https://arxiv.org/html/2404.07198v2#S0.SS2", + "notes": ["Released PyG 3g link-prediction checkpoint; thresholds follow UltraQuery arXiv v2, Appendix B.", "Released PyG checkpoint is distinct from original TorchDrug paper weights."] + }, + "blockers": [] + }, + "entries": [ + {"dataset": "FB15k237LogicalQuery", "options": {"threshold": 0.8}}, + { + "dataset": "FB15k237LogicalQuery", + "id": "ultraquery-lp-no-threshold-FB15k237LogicalQuery", + "options": {"threshold": 0.0} + }, + {"dataset": "FB15kLogicalQuery", "options": {"threshold": 0.8}}, + { + "dataset": "FB15kLogicalQuery", + "id": "ultraquery-lp-no-threshold-FB15kLogicalQuery", + "options": {"threshold": 0.0} + }, + {"dataset": "NELL995LogicalQuery", "options": {"threshold": 0.97}}, + { + "dataset": "NELL995LogicalQuery", + "id": "ultraquery-lp-no-threshold-NELL995LogicalQuery", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:106", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:106", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:106", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:113", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:113", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:113", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:122", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:122", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:122", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:134", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:134", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:134", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:150", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:150", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:150", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:175", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:175", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:175", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:217", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:217", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:217", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:300", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:300", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:300", + "options": {"threshold": 0.0} + }, + {"dataset": "InductiveFB15k237Query:550", "options": {"threshold": 0.8}}, + { + "dataset": "InductiveFB15k237Query:550", + "id": "ultraquery-lp-no-threshold-InductiveFB15k237Query:550", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:art", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:art", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:art", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:award", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:award", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:award", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:edu", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:edu", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:edu", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:health", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:health", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:health", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:infra", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:infra", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:infra", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:loc", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:loc", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:loc", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:org", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:org", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:org", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:people", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:people", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:people", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:sci", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:sci", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:sci", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:sport", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:sport", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:sport", + "options": {"threshold": 0.0} + }, + {"dataset": "WikiTopicsQuery:tax", "options": {"threshold": 0.8}}, + { + "dataset": "WikiTopicsQuery:tax", + "id": "ultraquery-lp-no-threshold-WikiTopicsQuery:tax", + "options": {"threshold": 0.0} + } + ] + }, + { + "defaults": { + "id": "incoming-relation-{dataset}", + "method": "incoming-relation", + "checkpoint": "benchmarks/ultraquery/heuristic.json", + "options": {}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 32, + "query_order": "upstream-pickle", + "reference": { + "status": "untrained authors heuristic; independent validation parity required", + "settings": "https://github.com/DeepGraphLearning/InductiveQE/tree/ab49a0e64e3449e687e484a42269d9898e1d1325", + "notes": ["Boolean incoming-relation classes; query-seeded random shuffle for resumable evaluation."] + }, + "blockers": [] + }, + "entries": [ + {"dataset": "WikiTopicsQuery:art"}, + {"dataset": "WikiTopicsQuery:award"}, + {"dataset": "WikiTopicsQuery:edu"}, + {"dataset": "WikiTopicsQuery:health"}, + {"dataset": "WikiTopicsQuery:infra"}, + {"dataset": "WikiTopicsQuery:loc"}, + {"dataset": "WikiTopicsQuery:org"}, + {"dataset": "WikiTopicsQuery:people"}, + {"dataset": "WikiTopicsQuery:sci"}, + {"dataset": "WikiTopicsQuery:sport"}, + {"dataset": "WikiTopicsQuery:tax"} + ] + }, + { + "defaults": { + "id": "qto-{dataset}", + "method": "qto", + "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 1, + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": ["Reuse +H released weights: original ID maps and training triples are identical; verify against QTO on original query sets."], + "inference_graph": "train" + }, + "blockers": [] + }, + "entries": [ + { + "dataset": "FB15k237LogicalQuery", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/fb15k237checkpoint", + "options": {"negation_scale": 3} + }, + { + "dataset": "NELL995LogicalQuery", + "checkpoint": "checkpoints/query-baselines/iscqa-compl-models/models/CQD:CQD-HYBRID:QTO/QTO/nellcheckpoint", + "options": {"negation_scale": 6} + } + ] + } + ] +} diff --git a/benchmarks/ultraquery/heuristic.json b/benchmarks/ultraquery/heuristic.json new file mode 100644 index 000000000..8ef063593 --- /dev/null +++ b/benchmarks/ultraquery/heuristic.json @@ -0,0 +1,6 @@ +{ + "version": 1, + "method": "incoming-relation", + "reference_commit": "ab49a0e64e3449e687e484a42269d9898e1d1325", + "ranking": "query-seeded random shuffle within Boolean classes" +} diff --git a/benchmarks/ultraquery/inductive-v2-files.json b/benchmarks/ultraquery/inductive-v2-files.json new file mode 100644 index 000000000..28dd2c8f1 --- /dev/null +++ b/benchmarks/ultraquery/inductive-v2-files.json @@ -0,0 +1,636 @@ +{ + "version": "2.0", + "source": "https://zenodo.org/records/7306046", + "files": { + "106": { + "train_answers_valid.pkl": { + "bytes": 222615050, + "crc32": 2127457251 + }, + "val_predict.txt": { + "bytes": 146463, + "crc32": 1962570836 + }, + "test_answers_hard.pkl": { + "bytes": 8012856, + "crc32": 4274819325 + }, + "valid_answers_easy.pkl": { + "bytes": 190930802, + "crc32": 2032002918 + }, + "stats.txt": { + "bytes": 110, + "crc32": 916940677 + }, + "valid_answers_hard.pkl": { + "bytes": 9337662, + "crc32": 2641552673 + }, + "test_queries.pkl": { + "bytes": 3904572, + "crc32": 3909217021 + }, + "train_queries.pkl": { + "bytes": 33327290, + "crc32": 170044298 + }, + "og_mappings.pkl": { + "bytes": 351138, + "crc32": 614139134 + }, + "val_inference.txt": { + "bytes": 829929, + "crc32": 3500356919 + }, + "train_answers_test.pkl": { + "bytes": 221922191, + "crc32": 61633874 + }, + "test_predict.txt": { + "bytes": 114275, + "crc32": 515135815 + }, + "train_answers_hard.pkl": { + "bytes": 256358832, + "crc32": 537753088 + }, + "test_inference.txt": { + "bytes": 647847, + "crc32": 3601583391 + }, + "test_answers_easy.pkl": { + "bytes": 195359464, + "crc32": 2584167393 + }, + "train_graph.txt": { + "bytes": 6397355, + "crc32": 956701669 + }, + "valid_queries.pkl": { + "bytes": 3928336, + "crc32": 1356027438 + } + }, + "113": { + "train_answers_valid.pkl": { + "bytes": 225603284, + "crc32": 4279546648 + }, + "val_predict.txt": { + "bytes": 225526, + "crc32": 2153236401 + }, + "test_answers_hard.pkl": { + "bytes": 10082998, + "crc32": 2283473921 + }, + "valid_answers_easy.pkl": { + "bytes": 157677730, + "crc32": 4145877345 + }, + "stats.txt": { + "bytes": 112, + "crc32": 4251385914 + }, + "valid_answers_hard.pkl": { + "bytes": 11342559, + "crc32": 415546472 + }, + "test_queries.pkl": { + "bytes": 3981855, + "crc32": 903912400 + }, + "train_queries.pkl": { + "bytes": 32966406, + "crc32": 1582195831 + }, + "og_mappings.pkl": { + "bytes": 350013, + "crc32": 1962790053 + }, + "val_inference.txt": { + "bytes": 1277765, + "crc32": 1428619069 + }, + "train_answers_test.pkl": { + "bytes": 218874594, + "crc32": 991468924 + }, + "test_predict.txt": { + "bytes": 211532, + "crc32": 2320895943 + }, + "train_answers_hard.pkl": { + "bytes": 239712017, + "crc32": 2821696352 + }, + "test_inference.txt": { + "bytes": 1198069, + "crc32": 2029575231 + }, + "test_answers_easy.pkl": { + "bytes": 153584506, + "crc32": 2208956229 + }, + "train_graph.txt": { + "bytes": 5141002, + "crc32": 89518030 + }, + "valid_queries.pkl": { + "bytes": 3989231, + "crc32": 4285792803 + } + }, + "122": { + "train_answers_valid.pkl": { + "bytes": 227775955, + "crc32": 1925017448 + }, + "val_predict.txt": { + "bytes": 288572, + "crc32": 427082963 + }, + "test_answers_hard.pkl": { + "bytes": 17676225, + "crc32": 1069461696 + }, + "valid_answers_easy.pkl": { + "bytes": 166736811, + "crc32": 3894232451 + }, + "stats.txt": { + "bytes": 112, + "crc32": 4038247536 + }, + "valid_answers_hard.pkl": { + "bytes": 15165545, + "crc32": 4175911720 + }, + "test_queries.pkl": { + "bytes": 5128445, + "crc32": 2878735352 + }, + "train_queries.pkl": { + "bytes": 32535566, + "crc32": 3346475155 + }, + "og_mappings.pkl": { + "bytes": 349725, + "crc32": 1969171057 + }, + "val_inference.txt": { + "bytes": 1635657, + "crc32": 805202829 + }, + "train_answers_test.pkl": { + "bytes": 227079621, + "crc32": 1548910851 + }, + "test_predict.txt": { + "bytes": 333248, + "crc32": 3875030041 + }, + "train_answers_hard.pkl": { + "bytes": 226863249, + "crc32": 3565487833 + }, + "test_inference.txt": { + "bytes": 1886648, + "crc32": 1080774119 + }, + "test_answers_easy.pkl": { + "bytes": 166213516, + "crc32": 3869019787 + }, + "train_graph.txt": { + "bytes": 3816444, + "crc32": 146621670 + }, + "valid_queries.pkl": { + "bytes": 5089342, + "crc32": 113618264 + } + }, + "134": { + "train_answers_valid.pkl": { + "bytes": 232388780, + "crc32": 638433923 + }, + "val_predict.txt": { + "bytes": 340343, + "crc32": 1546527536 + }, + "test_answers_hard.pkl": { + "bytes": 45573463, + "crc32": 3916559349 + }, + "valid_answers_easy.pkl": { + "bytes": 327167263, + "crc32": 132510776 + }, + "stats.txt": { + "bytes": 111, + "crc32": 3490429564 + }, + "valid_answers_hard.pkl": { + "bytes": 44755981, + "crc32": 1021389800 + }, + "test_queries.pkl": { + "bytes": 15812052, + "crc32": 1569178564 + }, + "train_queries.pkl": { + "bytes": 32230339, + "crc32": 1812113743 + }, + "og_mappings.pkl": { + "bytes": 346933, + "crc32": 4124865534 + }, + "val_inference.txt": { + "bytes": 1932846, + "crc32": 3024773898 + }, + "train_answers_test.pkl": { + "bytes": 232194115, + "crc32": 1820189611 + }, + "test_predict.txt": { + "bytes": 348401, + "crc32": 1832583827 + }, + "train_answers_hard.pkl": { + "bytes": 216024902, + "crc32": 1503661660 + }, + "test_inference.txt": { + "bytes": 1977504, + "crc32": 903245296 + }, + "test_answers_easy.pkl": { + "bytes": 334834974, + "crc32": 3316223477 + }, + "train_graph.txt": { + "bytes": 2884883, + "crc32": 2461824179 + }, + "valid_queries.pkl": { + "bytes": 15823689, + "crc32": 4154145113 + } + }, + "150": { + "train_answers_valid.pkl": { + "bytes": 206829540, + "crc32": 2622602600 + }, + "val_predict.txt": { + "bytes": 345019, + "crc32": 374871620 + }, + "test_answers_hard.pkl": { + "bytes": 72097527, + "crc32": 3921641806 + }, + "valid_answers_easy.pkl": { + "bytes": 429105480, + "crc32": 1305220952 + }, + "stats.txt": { + "bytes": 111, + "crc32": 1969255981 + }, + "valid_answers_hard.pkl": { + "bytes": 59967681, + "crc32": 3458923041 + }, + "test_queries.pkl": { + "bytes": 19385640, + "crc32": 2409607166 + }, + "train_queries.pkl": { + "bytes": 31225181, + "crc32": 380877425 + }, + "og_mappings.pkl": { + "bytes": 347176, + "crc32": 2345290980 + }, + "val_inference.txt": { + "bytes": 1956323, + "crc32": 2462227954 + }, + "train_answers_test.pkl": { + "bytes": 222962542, + "crc32": 655110866 + }, + "test_predict.txt": { + "bytes": 425310, + "crc32": 457502557 + }, + "train_answers_hard.pkl": { + "bytes": 177217090, + "crc32": 774506850 + }, + "test_inference.txt": { + "bytes": 2412571, + "crc32": 545194768 + }, + "test_answers_easy.pkl": { + "bytes": 472301691, + "crc32": 575961351 + }, + "train_graph.txt": { + "bytes": 2045704, + "crc32": 1094433206 + }, + "valid_queries.pkl": { + "bytes": 19336144, + "crc32": 3799685740 + } + }, + "175": { + "train_answers_valid.pkl": { + "bytes": 231658132, + "crc32": 2338021379 + }, + "val_predict.txt": { + "bytes": 374452, + "crc32": 3645624910 + }, + "test_answers_hard.pkl": { + "bytes": 70174732, + "crc32": 1097366851 + }, + "valid_answers_easy.pkl": { + "bytes": 309746882, + "crc32": 263560611 + }, + "stats.txt": { + "bytes": 111, + "crc32": 1426340539 + }, + "valid_answers_hard.pkl": { + "bytes": 62065943, + "crc32": 3481264274 + }, + "test_queries.pkl": { + "bytes": 20586045, + "crc32": 2267890764 + }, + "train_queries.pkl": { + "bytes": 30744012, + "crc32": 1428388548 + }, + "og_mappings.pkl": { + "bytes": 337664, + "crc32": 3639673031 + }, + "val_inference.txt": { + "bytes": 2125466, + "crc32": 245359974 + }, + "train_answers_test.pkl": { + "bytes": 237446394, + "crc32": 2418683699 + }, + "test_predict.txt": { + "bytes": 408845, + "crc32": 970098317 + }, + "train_answers_hard.pkl": { + "bytes": 170942744, + "crc32": 3838087073 + }, + "test_inference.txt": { + "bytes": 2320451, + "crc32": 1307371129 + }, + "test_answers_easy.pkl": { + "bytes": 341969689, + "crc32": 2430511246 + }, + "train_graph.txt": { + "bytes": 1268480, + "crc32": 3026052970 + }, + "valid_queries.pkl": { + "bytes": 20594963, + "crc32": 3394616982 + } + }, + "217": { + "train_answers_valid.pkl": { + "bytes": 136495499, + "crc32": 3465188741 + }, + "val_predict.txt": { + "bytes": 403705, + "crc32": 87815284 + }, + "test_answers_hard.pkl": { + "bytes": 65584728, + "crc32": 1167581732 + }, + "valid_answers_easy.pkl": { + "bytes": 221899548, + "crc32": 3501421439 + }, + "stats.txt": { + "bytes": 111, + "crc32": 3317629882 + }, + "valid_answers_hard.pkl": { + "bytes": 70989244, + "crc32": 39487799 + }, + "test_queries.pkl": { + "bytes": 20618039, + "crc32": 849975777 + }, + "train_queries.pkl": { + "bytes": 28096983, + "crc32": 1210595688 + }, + "og_mappings.pkl": { + "bytes": 338157, + "crc32": 2367516723 + }, + "val_inference.txt": { + "bytes": 2290131, + "crc32": 3491177888 + }, + "train_answers_test.pkl": { + "bytes": 141649548, + "crc32": 2003735472 + }, + "test_predict.txt": { + "bytes": 389882, + "crc32": 1434760274 + }, + "train_answers_hard.pkl": { + "bytes": 94947311, + "crc32": 3826735907 + }, + "test_inference.txt": { + "bytes": 2212932, + "crc32": 349255903 + }, + "test_answers_easy.pkl": { + "bytes": 219221355, + "crc32": 2211991067 + }, + "train_graph.txt": { + "bytes": 640360, + "crc32": 2677427181 + }, + "valid_queries.pkl": { + "bytes": 20668742, + "crc32": 1513051335 + } + }, + "300": { + "train_answers_valid.pkl": { + "bytes": 211853710, + "crc32": 1083432408 + }, + "val_predict.txt": { + "bytes": 353491, + "crc32": 2721905548 + }, + "test_answers_hard.pkl": { + "bytes": 75406827, + "crc32": 275037086 + }, + "valid_answers_easy.pkl": { + "bytes": 205819376, + "crc32": 2104015365 + }, + "stats.txt": { + "bytes": 111, + "crc32": 1757620724 + }, + "valid_answers_hard.pkl": { + "bytes": 64180660, + "crc32": 2866994750 + }, + "test_queries.pkl": { + "bytes": 20550283, + "crc32": 1154687234 + }, + "train_queries.pkl": { + "bytes": 24113843, + "crc32": 2428668404 + }, + "og_mappings.pkl": { + "bytes": 332839, + "crc32": 1225606516 + }, + "val_inference.txt": { + "bytes": 2009632, + "crc32": 1759567357 + }, + "train_answers_test.pkl": { + "bytes": 224335036, + "crc32": 364211603 + }, + "test_predict.txt": { + "bytes": 391694, + "crc32": 490777807 + }, + "train_answers_hard.pkl": { + "bytes": 102976653, + "crc32": 2066889623 + }, + "test_inference.txt": { + "bytes": 2225314, + "crc32": 1460261459 + }, + "test_answers_easy.pkl": { + "bytes": 258478502, + "crc32": 1161846747 + }, + "train_graph.txt": { + "bytes": 288179, + "crc32": 1711314424 + }, + "valid_queries.pkl": { + "bytes": 20523744, + "crc32": 2538452426 + } + }, + "550": { + "train_answers_valid.pkl": { + "bytes": 67939823, + "crc32": 1612544607 + }, + "val_predict.txt": { + "bytes": 300357, + "crc32": 964660324 + }, + "test_answers_hard.pkl": { + "bytes": 64205685, + "crc32": 2309798725 + }, + "valid_answers_easy.pkl": { + "bytes": 138521541, + "crc32": 2605770060 + }, + "stats.txt": { + "bytes": 111, + "crc32": 109310899 + }, + "valid_answers_hard.pkl": { + "bytes": 57947005, + "crc32": 2281276267 + }, + "test_queries.pkl": { + "bytes": 20293809, + "crc32": 816724508 + }, + "train_queries.pkl": { + "bytes": 20499571, + "crc32": 630566200 + }, + "og_mappings.pkl": { + "bytes": 314875, + "crc32": 298538 + }, + "val_inference.txt": { + "bytes": 1716884, + "crc32": 335509201 + }, + "train_answers_test.pkl": { + "bytes": 75661505, + "crc32": 3447717392 + }, + "test_predict.txt": { + "bytes": 305168, + "crc32": 1714620031 + }, + "train_answers_hard.pkl": { + "bytes": 39959829, + "crc32": 412282031 + }, + "test_inference.txt": { + "bytes": 1742124, + "crc32": 362131730 + }, + "test_answers_easy.pkl": { + "bytes": 174113211, + "crc32": 2351455741 + }, + "train_graph.txt": { + "bytes": 57819, + "crc32": 3024727647 + }, + "valid_queries.pkl": { + "bytes": 20303298, + "crc32": 820371586 + } + } + } +} diff --git a/benchmarks/ultraquery/kgfm_adapters.json b/benchmarks/ultraquery/kgfm_adapters.json new file mode 100644 index 000000000..0d6f5001d --- /dev/null +++ b/benchmarks/ultraquery/kgfm_adapters.json @@ -0,0 +1,147 @@ +{ + "version": 1, + "answer_filter": "released", + "data_root": "KGs/UltraQuery", + "seed": 0, + "threads": 4, + "archives": { + "datasets": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90#datasets-1", "checksum_status": "Every extracted runtime input is independently pinned by freeze."}, + "models": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90/ckpts", "checksum_status": "Released checkpoint and adapter bytes are independently pinned by freeze."} + }, + "recipes": [ + { + "defaults": { + "id": "ultra-product-intersections-{dataset}", + "method": "ultra-adapter", + "checkpoint": "checkpoints/ultra_3g.pth", + "adapters": {"product": "benchmarks/adapters/ultra_product_intersections.json"}, + "options": {"beam_size": 64, "row_batch_size": 8, "backend_batch_size": 8, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product" + }, + "selection_protocol": "target-validation", + "finalized": true, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "frozen transfer recipe; independent KGFM verification required", + "notes": [ + "Frozen source-trained product adapter; CQD beam 64; paired learned/identity calibration with shared atomic batches.", + "Training graphs: FB15k237, WN18RR and CoDExMedium. No target test labels select these recipes.", + "Backbone parity is checked separately; per-run KGFM evidence verifies adapter/composition against independently captured atomic logits.", + "Adapter training uses only 2i and 3i; checkpoint selection uses reserved source validation.", + "Recipe inclusion is informed by the 23-dataset UltraQuery validation sweep (50 sampled queries/type), not target-untuned model selection." + ] + }, + "blockers": [], + "adapter_ablation": true + }, + "entries": [ + {"dataset": "FB15k237LogicalQuery"}, + {"dataset": "FB15kLogicalQuery"}, + {"dataset": "NELL995LogicalQuery"}, + {"dataset": "InductiveFB15k237Query:106"}, + {"dataset": "InductiveFB15k237Query:113"}, + {"dataset": "InductiveFB15k237Query:122"}, + {"dataset": "InductiveFB15k237Query:134"}, + {"dataset": "InductiveFB15k237Query:150"}, + {"dataset": "InductiveFB15k237Query:175"}, + {"dataset": "InductiveFB15k237Query:217"}, + {"dataset": "InductiveFB15k237Query:300"}, + {"dataset": "InductiveFB15k237Query:550"}, + {"dataset": "WikiTopicsQuery:art"}, + {"dataset": "WikiTopicsQuery:award"}, + {"dataset": "WikiTopicsQuery:edu"}, + {"dataset": "WikiTopicsQuery:health"}, + {"dataset": "WikiTopicsQuery:infra"}, + {"dataset": "WikiTopicsQuery:loc"}, + {"dataset": "WikiTopicsQuery:org"}, + {"dataset": "WikiTopicsQuery:people"}, + {"dataset": "WikiTopicsQuery:sci"}, + {"dataset": "WikiTopicsQuery:sport"}, + {"dataset": "WikiTopicsQuery:tax"} + ] + }, + { + "defaults": { + "id": "trix-product-intersections-{dataset}", + "method": "trix-adapter", + "checkpoint": "checkpoints/trix/entity_prediction.pth", + "adapters": {"product": "benchmarks/adapters/trix_product_intersections.json"}, + "options": {"beam_size": 64, "row_batch_size": 1, "backend_batch_size": 1, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product" + }, + "selection_protocol": "target-validation", + "finalized": true, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "frozen transfer recipe; independent KGFM verification required", + "notes": [ + "Frozen source-trained product adapter; CQD beam 64; paired learned/identity calibration with shared atomic batches.", + "Training graphs: FB15k237, WN18RR and CoDExMedium. No target test labels select these recipes.", + "Backbone parity is checked separately; per-run KGFM evidence verifies adapter/composition against independently captured atomic logits.", + "Adapter training uses only 2i and 3i; checkpoint selection uses reserved source validation.", + "Recipe inclusion is informed by the 23-dataset UltraQuery validation sweep (50 sampled queries/type), not target-untuned model selection." + ] + }, + "blockers": [], + "adapter_ablation": true + }, + "entries": [ + {"dataset": "FB15k237LogicalQuery"}, + {"dataset": "FB15kLogicalQuery"}, + {"dataset": "NELL995LogicalQuery"}, + {"dataset": "InductiveFB15k237Query:106"}, + {"dataset": "InductiveFB15k237Query:113"}, + {"dataset": "InductiveFB15k237Query:122"}, + {"dataset": "InductiveFB15k237Query:134"}, + {"dataset": "InductiveFB15k237Query:150"}, + {"dataset": "InductiveFB15k237Query:175"}, + {"dataset": "InductiveFB15k237Query:217"}, + {"dataset": "InductiveFB15k237Query:300"}, + {"dataset": "InductiveFB15k237Query:550"}, + {"dataset": "WikiTopicsQuery:art"}, + {"dataset": "WikiTopicsQuery:award"}, + {"dataset": "WikiTopicsQuery:edu"}, + {"dataset": "WikiTopicsQuery:health"}, + {"dataset": "WikiTopicsQuery:infra"}, + {"dataset": "WikiTopicsQuery:loc"}, + {"dataset": "WikiTopicsQuery:org"}, + {"dataset": "WikiTopicsQuery:people"}, + {"dataset": "WikiTopicsQuery:sci"}, + {"dataset": "WikiTopicsQuery:sport"}, + {"dataset": "WikiTopicsQuery:tax"} + ] + } + ] +} diff --git a/benchmarks/ultraquery/trained_baselines.json b/benchmarks/ultraquery/trained_baselines.json new file mode 100644 index 000000000..5c2cc3360 --- /dev/null +++ b/benchmarks/ultraquery/trained_baselines.json @@ -0,0 +1,96 @@ +{ + "version": 1, + "answer_filter": "released", + "data_root": "KGs/UltraQuery", + "seed": 0, + "threads": 4, + "archives": { + "datasets": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90#datasets-1", "checksum_status": "Every extracted runtime input is independently pinned by freeze."}, + "models": {"source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90/ckpts", "checksum_status": "Released checkpoint and adapter bytes are independently pinned by freeze."} + }, + "recipes": [ + { + "defaults": { + "id": "qto-{dataset}", + "method": "qto", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/qto-FB15kLogicalQuery/checkpoint.pt", + "options": {"threshold": 0.001, "negation_scale": 6, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 1, + "query_order": "upstream-pickle", + "reference": { + "status": "native reference port; full reproduction pending", + "settings": "https://arxiv.org/html/2410.12537v3#A6", + "notes": ["Train with the pinned QTO FB15k recipe, then verify against independent QTO inference."], + "inference_graph": "train" + }, + "blockers": [], + "training": "checkpoints/ultraquery_benchmark-trained/qto-FB15kLogicalQuery/training.json" + }, + "entries": [{"dataset": "FB15kLogicalQuery"}] + }, + { + "defaults": { + "id": "inductive-gnnqe-{dataset}", + "method": "inductive-gnnqe", + "options": {"logic": "product"}, + "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], + "query_batch_size": 64, + "query_order": "upstream-pickle", + "reference": { + "status": "requires locally trained v2 checkpoint and independent validation parity", + "settings": "https://github.com/DeepGraphLearning/InductiveQE/blob/ab49a0e64e3449e687e484a42269d9898e1d1325/config/complex_query/gnnqe_main.yaml", + "notes": ["Train on corrected Zenodo 7306046 version 2.0; validation-only model selection."] + }, + "blockers": [] + }, + "entries": [ + { + "dataset": "InductiveFB15k237Query:106", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:106/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:106/training.json" + }, + { + "dataset": "InductiveFB15k237Query:113", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:113/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:113/training.json" + }, + { + "dataset": "InductiveFB15k237Query:122", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:122/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:122/training.json" + }, + { + "dataset": "InductiveFB15k237Query:134", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:134/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:134/training.json" + }, + { + "dataset": "InductiveFB15k237Query:150", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:150/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:150/training.json" + }, + { + "dataset": "InductiveFB15k237Query:175", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:175/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:175/training.json" + }, + { + "dataset": "InductiveFB15k237Query:217", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:217/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:217/training.json" + }, + { + "dataset": "InductiveFB15k237Query:300", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:300/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:300/training.json" + }, + { + "dataset": "InductiveFB15k237Query:550", + "checkpoint": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:550/checkpoint.pt", + "training": "checkpoints/ultraquery_benchmark-trained/inductive-gnnqe-InductiveFB15k237Query:550/training.json" + } + ] + } + ] +} diff --git a/pyproject.toml b/pyproject.toml index 7399ab693..d951ac15f 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -57,12 +57,13 @@ ignore = [ "__init__.py" = ["F401"] # Allow unused imports in __init__.py files [tool.ruff.lint.isort] -known-first-party = ["dicee"] +known-first-party = ["dicee", "benchmarks"] section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"] [tool.pytest.ini_options] # Pytest configuration -testpaths = ["tests"] +testpaths = ["tests", "benchmarks"] +pythonpath = ["."] python_files = ["test_*.py"] python_classes = ["Test*"] python_functions = ["test_*"] From d42b336492ddb7060054b2dbb0f4cf0361be3e64 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 2 Oct 2026 09:16:12 +0200 Subject: [PATCH 04/39] fix(query_answering): share adapter score rows across seeds for deterministic backbones --- dicee/query_answering/_adapter_cache.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/dicee/query_answering/_adapter_cache.py b/dicee/query_answering/_adapter_cache.py index 6cf7b82d2..9f1e6404a 100644 --- a/dicee/query_answering/_adapter_cache.py +++ b/dicee/query_answering/_adapter_cache.py @@ -34,10 +34,13 @@ def __init__(self, model, context, *, cache_dir, row_batch_size, seed, samples, self.feature_cache = OrderedDict() self.stats = dict(host_hits=0, device_hits=0, disk_rows=0, scored_rows=0, feature_preparations=0, seconds=0.) self.disk_limit = disk_bytes if cache_dir is not None else min(disk_bytes, cache_bytes) + from ..models.flock import Flock + # Only sampled backbones (Flock walks) depend on the scoring seed; others share rows across seeds. + sampled = isinstance(model, Flock) settings = dict(version=2, backbone=state_fingerprint(model), context=context.identity, scoring_code=scoring_fingerprint(), architecture=str(model), args={k: str(v) for k, v in getattr(model, 'args', {}).items()}, - row_batch_size=row_batch_size, seed=seed, samples=samples, + row_batch_size=row_batch_size, seed=seed if sampled else None, samples=samples if sampled else None, precision=float32_precision_token(), torch=str(torch.__version__), deterministic=torch.are_deterministic_algorithms_enabled(), autocast=torch.is_autocast_enabled(next(model.parameters()).device.type), From ffa9e70ccf79536948b5a5b31ba2ae87b01ed531 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 2 Oct 2026 09:16:12 +0200 Subject: [PATCH 05/39] feat(query_answering): hardness-balanced adapter training data prepare_adapter_data(hardness='balanced') gives each source query a missing-link level in rotation and trains it on that level's hard answers; queries can carry explicit positives. The default path is unchanged. --- dicee/query_answering/adapter_training.py | 133 +++++++++++++++++++--- 1 file changed, 115 insertions(+), 18 deletions(-) diff --git a/dicee/query_answering/adapter_training.py b/dicee/query_answering/adapter_training.py index 6a572638d..e5faff228 100644 --- a/dicee/query_answering/adapter_training.py +++ b/dicee/query_answering/adapter_training.py @@ -55,8 +55,15 @@ def _structure(query): @dataclass(frozen=True) class AdapterQuery: + """A source query, its complete answers, and optionally the hard answers it is trained on. + + ``positives`` defaults to every hard answer (answers not provable from the + masked context). Other answers are filtered from the ranking either way. + """ + query: tuple answers: frozenset + positives: frozenset | None = None def __post_init__(self): query = _canonical_query(nested(self.query)) @@ -69,6 +76,8 @@ def __post_init__(self): raise ValueError('Training intersections require distinct atoms') object.__setattr__(self, 'query', query) object.__setattr__(self, 'answers', frozenset(self.answers)) + if self.positives is not None: + object.__setattr__(self, 'positives', frozenset(self.positives)) @property def shape(self): @@ -104,12 +113,15 @@ def __post_init__(self): easy = self.context.answers(tree) if ('n' not in item.shape and not easy <= item.answers) or not item.answers - easy: raise ValueError('Source answers must contain hard answers and all positive context proofs') + if item.positives is not None and (not item.positives or not item.positives <= item.answers - easy): + raise ValueError('Positives must be a nonempty subset of the hard answers') if len(item.answers) == self.context.num_entities: raise ValueError('Training queries need at least one negative candidate') def to_dict(self): def records(items): - return [dict(query=q.query, answers=sorted(q.answers)) for q in items] + return [dict(query=q.query, answers=sorted(q.answers), + **({} if q.positives is None else dict(positives=sorted(q.positives)))) for q in items] return dict(version=1, name=self.name, context=self.context.to_dict(), train=records(self.train), validation=records(self.validation), metadata=self.metadata) @@ -126,17 +138,81 @@ def load(cls, path): tuple(AdapterQuery(**q) for q in data.get('validation', [])), data.get('metadata', {})) +def answer_levels(tree, full, observed): + """Minimum number of unobserved links each answer needs, counted along positive branches. + + Intersections add their branches' counts and unions take the cheapest + branch. Negated branches restrict answers by ``full`` truth without adding + links. Answers provable from ``observed`` alone have level 0. + """ + op = tree[0] + if op == 'anchor': + return {tree[1]: 0} + if op == 'project': + result = {} + for head, cost in answer_levels(tree[2], full, observed).items(): + seen = observed.outgoing.get(head, {}).get(tree[1], ()) + for tail in full.outgoing.get(head, {}).get(tree[1], ()): + value = cost + (tail not in seen) + if value < result.get(tail, value + 1): + result[tail] = value + return result + if op == 'or': + result = {} + for child in tree[1:]: + for answer, value in answer_levels(child, full, observed).items(): + result[answer] = min(result.get(answer, value), value) + return result + if op == 'and' and any(child[0] != 'not' for child in tree[1:]): + parts = [answer_levels(child, full, observed) for child in tree[1:] if child[0] != 'not'] + result = {a: sum(part[a] for part in parts) for a in min(parts, key=len) if all(a in part for part in parts)} + for child in tree[1:]: + if child[0] == 'not': + for answer in full.answers(child[1]): + result.pop(answer, None) + return result + raise ValueError('Answer levels need a positive anchored branch') + + +def _max_level(tree): + if tree[0] in ('anchor', 'not'): + return 0 + if tree[0] == 'project': + return 1 + _max_level(tree[2]) + levels = [_max_level(child) for child in tree[1:]] + return sum(levels) if tree[0] == 'and' else max(levels) + + +def _shape_tree(shape): + """Compile a query type's pattern with placeholder IDs.""" + def visit(pattern): + if pattern in ('e', 'r', 'n', 'u'): + return {'e': 0, 'r': 0, 'n': -2, 'u': -1}[pattern] + return tuple(visit(part) for part in pattern) + return compile_query(visit(QUERY_SHAPES[shape])) + + +def _split(total, parts): + return [total // parts + (i < total % parts) for i in range(parts)] + + def prepare_adapter_data(source, *, name='source', mask_fraction=.3, train_per_shape=96, validation_per_shape=32, seed=2026090851, max_attempts=100_000, shapes=('2i', '3i'), - extend=None, train_counts=None): + extend=None, train_counts=None, hardness='standard'): """Mask reciprocal pairs and reuse QueryGenerator's grounding on source facts. ``source`` must contain source-training facts only. Never pass target test facts here. Answer supervision uses the source; scoring sees only the mask. + + ``hardness='balanced'`` gives each query a level in rotation, from 1 to the + type's maximum, and trains it on its hard answers at that level (see + ``answer_levels``), so every level gets the same number of queries. """ from ..query_generator import QueryGenerator if not 0 < mask_fraction < 1 or train_per_shape < 1 or validation_per_shape < 0 or max_attempts < 1: raise ValueError('Require 0 < mask_fraction < 1 and positive training/attempt counts') + if hardness not in ('standard', 'balanced') or (hardness == 'balanced' and extend is not None): + raise ValueError("Choose hardness 'standard' or 'balanced'; only standard data can be extended") shapes = tuple(shapes) if not shapes or len(set(shapes)) != len(shapes) or any(s not in TRAINING_SHAPES for s in shapes): raise ValueError(f'Choose distinct training shapes from {TRAINING_SHAPES}') @@ -171,11 +247,14 @@ def canonical(edge): for shape in shapes: width = int(shape[0]) if shape in FLAT_SHAPES else 1 targets = sorted(t for t, rs in generator.ent_in.items() if sum(map(len, rs.values())) >= width) - examples = [] - required = (counts[shape] - sum(q.shape == shape for q in training) if extend is not None - else counts[shape] + validation_per_shape) + levels = _max_level(_shape_tree(shape)) if hardness == 'balanced' else 1 + train_demand, validation_demand = _split(counts[shape], levels), _split(validation_per_shape, levels) + if extend is not None: + train_demand = [counts[shape] - sum(q.shape == shape for q in training)] + demand = [t + (0 if extend is not None else v) for t, v in zip(train_demand, validation_demand)] + pools = [[] for _ in range(levels)] for _ in range(max_attempts): - if len(examples) == required or not targets: + if all(len(pool) == n for pool, n in zip(pools, demand)) or not targets: break query = generator.tuple2list(QUERY_SHAPES[shape]) if generator.fill_query(query, generator.ent_in, generator.ent_out, rng.choice(targets)): @@ -190,22 +269,39 @@ def canonical(edge): continue if 'n' in shape and not context_answers - answers: continue + if hardness == 'standard': + seen.add(query) + pools[0].append(AdapterQuery(query, answers)) + continue + hard = answers - context_answers + level = answer_levels(tree, source, context) + if not hard <= level.keys() or not all(1 <= level[a] <= levels for a in hard): + raise RuntimeError(f'Answer levels disagree with exact answers for {shape} {query}') + # Rarer, higher levels first; skip queries whose levels are already filled. + chosen = next((v for v in sorted({level[a] for a in hard}, reverse=True) if len(pools[v - 1]) < demand[v - 1]), None) + if chosen is None: + continue seen.add(query) - examples.append(AdapterQuery(query, answers)) - if len(examples) != required: - raise ValueError(f'Only generated {len(examples)} distinct {shape} queries; reduce counts or supply prepared data') - rng.shuffle(examples) - if extend is None: - training.extend(examples[:counts[shape]]) - validation.extend(examples[counts[shape]:]) - else: - training.extend(examples) + pools[chosen - 1].append(AdapterQuery(query, answers, frozenset(a for a in hard if level[a] == chosen))) + if any(len(pool) != n for pool, n in zip(pools, demand)): + raise ValueError(f'Only generated {sum(map(len, pools))} distinct {shape} queries; reduce counts or supply prepared data') + shape_train, shape_validation = [], [] + for pool, n in zip(pools, train_demand): + rng.shuffle(pool) + shape_train.extend(pool[:n]) + shape_validation.extend(pool[n:]) + if hardness == 'balanced': + rng.shuffle(shape_train) + rng.shuffle(shape_validation) + training.extend(shape_train) + validation.extend(shape_validation) return AdapterTrainingData(name, context, tuple(training), tuple(validation), dict(extend.metadata if extend is not None else {}, source_sha256=source.identity, seed=seed, mask_fraction=mask_fraction, masked_fact_pairs=count, train_per_shape=train_per_shape, train_counts=counts, - validation_per_shape=validation_per_shape, shapes=list(shapes))) + validation_per_shape=validation_per_shape, shapes=list(shapes), + **({} if hardness == 'standard' else dict(hardness=hardness)))) def _bank(model, data, *, cache_dir, row_batch_size, seed, samples, device='cpu', @@ -350,7 +446,7 @@ def _validation(adapter, sources, banks): if query.shape != shape: continue scores = _query_logs(adapter, bank, query) - hard = query.answers - _context_answers(bank, query) + hard = query.positives if query.positives is not None else query.answers - _context_answers(bank, query) ranks = _filtered_ranks(scores, query.answers, hard) metrics.append([sum(1 / rank for rank in ranks) / len(ranks), *(sum(rank <= k for rank in ranks) / len(ranks) for k in (1, 3, 10))]) @@ -487,7 +583,8 @@ def fit_query_adapter(model, sources, *, feature_mode='context_scores', observed selected_counts[cell] = selected_counts.get(cell, 0) + 1 if not examples: raise ValueError('No queries for the selected training shapes') - hard_answers = [q.answers - sources[i].context.answers(compile_query(q.query)) for i, q in examples] + hard_answers = [q.positives if q.positives is not None else q.answers - sources[i].context.answers(compile_query(q.query)) + for i, q in examples] cells = {(i, q.shape) for i, q in examples} counts = {cell: sum((i, q.shape) == cell for i, q in examples) for cell in cells} rng, history, best = random.Random(seed), [], None From 07c9fedd3eae951dbe48688a1d06eeada8c0613e Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 2 Oct 2026 09:16:12 +0200 Subject: [PATCH 06/39] feat(query_answering): route query types to labelled adapters KGFM recipes accept operators such as 'product:chains', so one recipe can score some query types with a second adapter of the same t-norm. --- dicee/query_answering/catalog.py | 9 +++++++-- dicee/query_answering/method_evaluation.py | 4 ++-- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/dicee/query_answering/catalog.py b/dicee/query_answering/catalog.py index 291ccb396..aae38d38c 100644 --- a/dicee/query_answering/catalog.py +++ b/dicee/query_answering/catalog.py @@ -139,5 +139,10 @@ def check_recipe(entry: dict, shapes: list[str] | tuple[str, ...]) -> None: if entry.get('selection_protocol') not in ('source-validation', 'target-validation'): raise ValueError('Declare the operator selection protocol') operators = entry.get('operators', {}) - if set(operators) != set(shapes) or set(operators.values()) - {'product', 'min'} or set(operators.values()) - entry.get('adapters', {}).keys(): - raise ValueError('Each query type needs one operator, product or min, with its matching adapter') + + def valid(operator): # A t-norm, optionally labelled to route query types to different adapters ('product:chains'). + norm, colon, label = operator.partition(':') + return norm in ('product', 'min') and (not colon or (label != '' and all(c.isalnum() or c in '-_' for c in label))) + + if set(operators) != set(shapes) or not all(map(valid, operators.values())) or set(operators.values()) - entry.get('adapters', {}).keys(): + raise ValueError('Each query type needs one operator, product or min (optionally labelled), with its matching adapter') diff --git a/dicee/query_answering/method_evaluation.py b/dicee/query_answering/method_evaluation.py index 2ee1beb0d..f5ecd5ce1 100644 --- a/dicee/query_answering/method_evaluation.py +++ b/dicee/query_answering/method_evaluation.py @@ -277,7 +277,7 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict entry['checkpoint']).to(device).eval().requires_grad_(False) adapters = {name: QueryScoreAdapter.load(path, model=model) for name, path in entry['adapters'].items()} for operator, adapter in adapters.items(): - expected = 'prod' if operator == 'product' else 'min' + expected = 'prod' if operator.partition(':')[0] == 'product' else 'min' if adapter.metadata.get('training', {}).get('tnorm', 'prod') != expected: raise ValueError('Operator must use an adapter fitted with the matching t-norm') observed_facts = options.get('observed_facts') @@ -332,7 +332,7 @@ def predict(query, variant='learned'): operator = entry['operators'][shape_by_query[query]] engine = engines[variant][operator] result = engine.predict(query, beam_size=options.get('beam_size', 64), - tnorm='prod' if operator == 'product' else 'min', return_log_scores=True) + tnorm='prod' if operator.partition(':')[0] == 'product' else 'min', return_log_scores=True) record(engine.last_info) callback = on_prediction if variant == 'learned' else on_control_prediction if callback: From e8eb8422f47be778c82701adb33af6bf8a471a44 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 2 Oct 2026 09:16:12 +0200 Subject: [PATCH 07/39] fix(benchmarks): import TorchDrug 0.2.1 on newer PyTorch --- benchmarks/cqa/train.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/benchmarks/cqa/train.py b/benchmarks/cqa/train.py index 2cc66c1a2..3fc9aa402 100644 --- a/benchmarks/cqa/train.py +++ b/benchmarks/cqa/train.py @@ -55,11 +55,14 @@ def verify_v2(folder, version): def compatibility(): - """Python 3.11 import compatibility; neither GNN arithmetic nor losses change.""" + """Python 3.11 and newer-PyTorch import compatibility; neither GNN arithmetic nor losses change.""" collections.Sequence = collections.abc.Sequence drawing = types.ModuleType('rdkit.Chem.Draw.mplCanvas') drawing.Canvas = object sys.modules[drawing.__name__] = drawing + from torch.utils import cpp_extension, file_baton + if not hasattr(cpp_extension, 'FileBaton'): # Newer PyTorch no longer re-exports it. + cpp_extension.FileBaton = file_baton.FileBaton def train_qto(job, folder, source, output, args): From d989907559117cf6b55a70136dcbbe44673b9004 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 2 Oct 2026 09:53:18 +0200 Subject: [PATCH 08/39] test: check ConE union batching against the running CPU Bit-exact comparison with fixture scores recorded on another CPU failed on CI runners. The joint DNF projection batch is now rebuilt on the test machine; the fixture comparison keeps its 3e-5 tolerance. --- tests/test_query_baselines.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/tests/test_query_baselines.py b/tests/test_query_baselines.py index 5aa5aee9a..1159f7fec 100644 --- a/tests/test_query_baselines.py +++ b/tests/test_query_baselines.py @@ -9,8 +9,10 @@ import torch from dicee.query_answering import BenchmarkQuery, QueryBenchmark, QueryContext, evaluate_benchmark +from dicee.query_answering._query import compile_query from dicee.query_answering.benchmark import QueryMetrics from dicee.query_answering.methods import REFERENCES, load_method +from dicee.query_answering.methods._common import union_branches ROOT = Path(__file__).parent / 'fixtures' / 'query_baselines' @@ -48,7 +50,12 @@ def test_checkpoint_scores_ranks_ties_and_metrics(tmp_path, fixture, case): actual = model.predict(fixture['queries'][shape]) torch.testing.assert_close(actual, expected, atol=3e-5, rtol=3e-5, msg=shape) if case['name'] == 'cone' and shape in ('2u', 'up'): - torch.testing.assert_close(actual, expected, atol=0, rtol=0, msg='ConE union branches must use the reference joint projection batch') + # The reference embeds all DNF branches in one projection batch. Batch composition changes the + # float bits, so rebuild that joint batch on this CPU instead of comparing bits recorded on another. + branches = union_branches(compile_query(fixture['queries'][shape])) + joint = [values.reshape(1, len(branches), -1) for values in model.embed_batch(branches)] + torch.testing.assert_close(actual, model.score_embeddings(joint)[0], atol=0, rtol=0, + msg='ConE union branches must use the reference joint projection batch') assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)), shape assert torch.equal(actual[:, None] == actual[None], expected[:, None] == expected[None]), shape for policy in ('sort', 'expected'): From cd25c92fce4ce82e54cc9b79e2b279582d5691b1 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 01:32:38 +0200 Subject: [PATCH 09/39] perf(query_answering): reuse backbone rows across batches and compute the state token once AtomicBatchCache gains a row granularity: rows are cached and evicted one by one, so a row computed in one atomic batch is reused by any later batch instead of only by an identical batch. KGFM evaluation enables it with the raw_cache_granularity option ('batch' stays the default). AtomicScorer memoizes the model-state token for the duration of an evaluation context rather than hashing all parameters for every atomic batch. Scores are unchanged up to float rounding from the batch shapes. On the S1 validation screens with atomic batches of 16, TRIX runs 5.5x faster and ULTRA 1.6x, and all 26 datasets match their previous results. --- benchmarks/cqa/tests/test_adapter_pairs.py | 32 ++++++ dicee/query_answering/engine.py | 115 +++++++++++++++++---- dicee/query_answering/method_evaluation.py | 10 +- 3 files changed, 135 insertions(+), 22 deletions(-) diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index e5daca7c6..7a04712d1 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -51,6 +51,38 @@ def test_shared_atomic_cache_preserves_batches_and_invalidates_weights(): assert model.calls == 4 +def test_row_cache_reuses_rows_across_batches_and_invalidates_weights(): + model = BatchRows().eval() + cache = AtomicBatchCache(10_000, granularity='row') + scorer = AtomicScorer(model, row_batch_size=2, raw_cache=cache) + first = scorer.rows([(0, 0), (1, 0)]) + assert model.calls == 1 and cache.computed == 2 + mixed = scorer.rows([(1, 0), (2, 0), (1, 0)]) + # Only the missing row is computed, in a batch of its own; the fixture marks batch sizes in the values. + assert model.calls == 2 and cache.computed == 3 and cache.hits == 2 + assert torch.equal(mixed[0], first[1]) and torch.equal(mixed[2], first[1]) + assert torch.equal(mixed[1], model.values[2].detach() + 1 / 100) + mixed.zero_() + assert torch.equal(scorer.rows([(0, 0)])[0], first[0]) and model.calls == 2 + with torch.no_grad(): + model.values.add_(1) + assert torch.equal(scorer.rows([(0, 0), (1, 0)]), first + 1) and model.calls == 3 + + +def test_cache_token_is_computed_once_per_evaluation(monkeypatch): + from dicee.query_answering import engine + calls = [] + original = engine.state_token + monkeypatch.setattr(engine, 'state_token', lambda model: calls.append(model) or original(model)) + scorer = AtomicScorer(BatchRows().eval(), row_batch_size=1, raw_cache=AtomicBatchCache(10_000, granularity='row')) + with scorer.evaluation(): + for head in range(3): + scorer.rows([(head, 0)]) + assert len(calls) == 1 + scorer.rows([(0, 0)]) + assert len(calls) == 2 + + def test_paired_resume_replays_both_variants_and_preserves_metrics(tmp_path): data = small_data() diff --git a/dicee/query_answering/engine.py b/dicee/query_answering/engine.py index 823096bd5..9ab05a813 100644 --- a/dicee/query_answering/engine.py +++ b/dicee/query_answering/engine.py @@ -15,6 +15,7 @@ # Public contexts derived from graph models, released with the model. _MODEL_CONTEXTS = weakref.WeakKeyDictionary() +_UNSET = object() def _model_context(model, token, tensors): @@ -33,15 +34,21 @@ class AtomicBatchCache: ``model`` keeps scores on their producing device, avoiding host round trips when GPU memory is available. CPU storage remains the portable default. + ``granularity='row'`` stores single rows and computes only missing rows, in + batches of their own. Rows are then reused whatever batch requests them, so + a row's last bits can depend on the batch that first computed it. """ - def __init__(self, max_bytes, *, device='cpu'): + def __init__(self, max_bytes, *, device='cpu', granularity='batch'): if type(max_bytes) is not int or max_bytes < 0: raise ValueError('Atomic cache size must be a nonnegative integer') if device not in ('cpu', 'model'): raise ValueError('Atomic cache device must be cpu or model') + if granularity not in ('batch', 'row'): + raise ValueError('Atomic cache granularity must be batch or row') self.max_bytes = max_bytes self.device = device + self.granularity = granularity self.rows, self.token, self.used = OrderedDict(), None, 0 self.hits, self.computed, self.peak = 0, 0, 0 @@ -77,6 +84,41 @@ def put(self, conditions, values): self.used += size self.peak = max(self.peak, self.used) + def lookup(self, token, conditions): + """Row granularity: cached rows by condition and the distinct missing conditions.""" + if token is None or token != self.token: + self.clear() + self.token = token + found, missing = {}, [] + for key in dict.fromkeys(conditions): + if token is not None and key in self.rows: + self.rows.move_to_end(key) + found[key] = self.rows[key] + else: + missing.append(key) + self.hits += sum(key in found for key in conditions) + return found, missing + + def put_rows(self, conditions, values): + """Row granularity: store each row of a computed batch on its own.""" + self.computed += len(conditions) + if self.token is None or not len(conditions): + return + size = values[0].numel() * values.element_size() + if size > self.max_bytes: + return + stored = values.detach().to(values.device if self.device == 'model' else 'cpu') + for key, row in zip(conditions, stored): + if key in self.rows: + self.used -= self.rows.pop(key).numel() * row.element_size() + while self.rows and self.used + size > self.max_bytes: + _, old = self.rows.popitem(last=False) + self.used -= old.numel() * old.element_size() + # A copy per row lets eviction release each row's memory. + self.rows[key] = row.clone() + self.used += size + self.peak = max(self.peak, self.used) + class AtomicScorer: """Use DICE's existing all-tail API; only stochastic scoring needs special care.""" @@ -127,13 +169,21 @@ def evaluation(self): yield return with evaluation_mode(self.model): - self._evaluating = True + self._evaluating, self._token_memo = True, _UNSET try: yield finally: - self._evaluating = False + self._evaluating, self._token_memo = False, _UNSET def cache_token(self): + """Walking the model's tensors is costly; one evaluation context cannot change them, so it walks once.""" + if getattr(self, '_evaluating', False): + if self._token_memo is _UNSET: + self._token_memo = self._cache_token() + return self._token_memo + return self._cache_token() + + def _cache_token(self): from ..models._inference import float32_precision_token from ..models.flock import Flock # Training callers can still reuse rows within a query, but never carry @@ -154,8 +204,6 @@ def cache_token(self): @torch.no_grad() def rows(self, conditions): - from ..models.flock import Flock - from ..models.graph_model import GraphKGE conditions = [tuple(map(int, pair)) for pair in conditions] if not conditions: return torch.empty((0, self.n), device=self.device) @@ -163,27 +211,56 @@ def rows(self, conditions): raise ValueError('Atomic query outside the public vocabulary') token = self.cache_token() if self.raw_cache is not None else None with self.evaluation(): + if self.raw_cache is not None and self.raw_cache.granularity == 'row': + return self._cached_rows(token, conditions) cached = self.raw_cache.get(token, conditions) if self.raw_cache is not None else None if cached is not None: return cached.to(self.device, copy=True) - if isinstance(self.model, Flock): - samples = self.model.test_samples if self.samples is None else self.samples - seeds = [int(fingerprint([self.context.identity, self.seed, samples, h, r])[:15], 16) for h, r in conditions] - result = self.model.forward_k_vs_all_seeded(torch.tensor(conditions, device=self.device), seeds, samples=samples) - else: - # Graph models validate and map host queries before an asynchronous copy. - host = self.graph_model and type(self.model).forward_k_vs_sample is GraphKGE.forward_k_vs_sample - batches = (torch.tensor(conditions[start:start + self.row_batch_size]) - for start in range(0, len(conditions), self.row_batch_size)) - result = torch.cat([self.model.forward_k_vs_all(batch if host else to_device(batch, self.device)) - for batch in batches]) - if result.shape != (len(conditions), self.n): - raise ValueError('Atomic scorer must return finite complete [rows, entities] logits') - require(torch.isfinite(result).all(), ValueError('Atomic scorer must return finite complete [rows, entities] logits')) + result = self._compute(conditions) if self.raw_cache is not None: self.raw_cache.put(conditions, result) return result.detach() + def _cached_rows(self, token, conditions): + """Row-granular reuse: compute only rows missing from the cache, then restore the requested order.""" + found, missing = self.raw_cache.lookup(token, conditions) + fresh = {} + if missing: + computed = self._compute(missing) + self.raw_cache.put_rows(missing, computed) + fresh = {key: i for i, key in enumerate(missing)} + reused = [i for i, key in enumerate(conditions) if key not in fresh] + if not reused: + return computed[[fresh[key] for key in conditions]].detach() + # Stacking copies, so callers never alias cached storage. + rows = torch.stack([found[conditions[i]] for i in reused]).to(self.device) + if not fresh: + return rows + result = torch.empty((len(conditions), self.n), dtype=computed.dtype, device=self.device) + result[reused] = rows + new = [i for i, key in enumerate(conditions) if key in fresh] + result[new] = computed[[fresh[conditions[i]] for i in new]] + return result.detach() + + def _compute(self, conditions): + from ..models.flock import Flock + from ..models.graph_model import GraphKGE + if isinstance(self.model, Flock): + samples = self.model.test_samples if self.samples is None else self.samples + seeds = [int(fingerprint([self.context.identity, self.seed, samples, h, r])[:15], 16) for h, r in conditions] + result = self.model.forward_k_vs_all_seeded(torch.tensor(conditions, device=self.device), seeds, samples=samples) + else: + # Graph models validate and map host queries before an asynchronous copy. + host = self.graph_model and type(self.model).forward_k_vs_sample is GraphKGE.forward_k_vs_sample + batches = (torch.tensor(conditions[start:start + self.row_batch_size]) + for start in range(0, len(conditions), self.row_batch_size)) + result = torch.cat([self.model.forward_k_vs_all(batch if host else to_device(batch, self.device)) + for batch in batches]) + if result.shape != (len(conditions), self.n): + raise ValueError('Atomic scorer must return finite complete [rows, entities] logits') + require(torch.isfinite(result).all(), ValueError('Atomic scorer must return finite complete [rows, entities] logits')) + return result + class QueryAnswerer: """Answer indexed query tuples with the same evaluator for KGEs and KGFMs. diff --git a/dicee/query_answering/method_evaluation.py b/dicee/query_answering/method_evaluation.py index f5ecd5ce1..b7156ac00 100644 --- a/dicee/query_answering/method_evaluation.py +++ b/dicee/query_answering/method_evaluation.py @@ -264,11 +264,14 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict backbone = entry['method'].split('-')[0] options = entry['options'] allowed = {'beam_size', 'row_batch_size', 'backend_batch_size', 'cache_bytes', 'raw_cache_bytes', 'observed_facts', - 'raw_cache_device', 'relation_cache_mb', 'projection_cache_mb'} + 'raw_cache_device', 'raw_cache_granularity', 'relation_cache_mb', 'projection_cache_mb'} if options.keys() - allowed: raise ValueError('Unknown KGFM execution option') if options.get('raw_cache_device', 'cpu') not in ('cpu', 'model'): raise ValueError('Atomic cache device must be cpu or model') + granularity = options.get('raw_cache_granularity', 'batch') + if granularity not in ('batch', 'row'): + raise ValueError('Atomic cache granularity must be batch or row') model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict( num_entities=1, num_relations=1, graph_inference_backend='auto', graph_relation_cache_mb=options.get('relation_cache_mb', 64), @@ -288,8 +291,9 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict shape_by_query = {query.query: query.shape for query in data.queries} stats = Counter() paired = entry.get('adapter_ablation', False) - raw_cache = AtomicBatchCache(options.get('raw_cache_bytes', 2 * 1024**3), - device=options.get('raw_cache_device', 'cpu')) if paired else None + # Row granularity also helps a single configuration: beams of different queries share rows. + raw_cache = AtomicBatchCache(options.get('raw_cache_bytes', 2 * 1024**3), device=options.get('raw_cache_device', 'cpu'), + granularity=granularity) if paired or granularity == 'row' else None with ExitStack() as stack: stack.enter_context(deterministic_kgfm()) stack.enter_context(attached_context(model, data.context)) From ade8eefd97ff03d7e5e93bf7dab50dbb10cca80d Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:06:24 +0200 Subject: [PATCH 10/39] docs(benchmarks): describe sort-order ties and +H answer balance; test the row cache The docs describe `sort` ties as PyTorch's default descending argsort, which is not guaranteed stable, and `expected` as the exact expectation under random order within ties. +H is described as balancing hard answers across the number of links that must be predicted, and the examples pass the required --split. Also documents the state-token assumption of the row cache, types its new methods, and tests the row-granular cache through KGFM evaluation. --- README.md | 7 +++-- benchmarks/cqa/PROTOCOL.md | 10 ++++--- benchmarks/cqa/README.md | 7 +++-- benchmarks/cqa/tests/test_adapter_pairs.py | 33 ++++++++++++++++++++++ dicee/query_answering/benchmark.py | 6 ++-- dicee/query_answering/engine.py | 11 ++++++-- 6 files changed, 59 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 008d65eda..a3912202f 100644 --- a/README.md +++ b/README.md @@ -572,11 +572,12 @@ See the [CQA guide](docs/guides/multi_hop_queries.md) for adapters and method ev **Benchmarks.** [`benchmarks/cqa`](benchmarks/cqa/README.md) evaluates these methods on the 23 UltraQuery datasets and on **+H**: FB15k237+H, NELL995+H and ICEWS18+H from -[Gregucci et al.](https://arxiv.org/abs/2410.12537), built so that complex queries cannot be -reduced to simpler link prediction. Select any methods, datasets and query types: +[Gregucci et al.](https://arxiv.org/abs/2410.12537), whose hard answers are balanced across the +number of links that must be predicted to reach them. Select any methods, datasets and query +types; `--split` is required: ```bash -python -m benchmarks.cqa plus_h evaluate --output results/plus-h-subset \ +python -m benchmarks.cqa plus_h evaluate --split valid --output results/plus-h-subset \ --methods cqd cqd-hybrid qto --datasets FB15k237+H NELL995+H --query-types 2p 3p ``` diff --git a/benchmarks/cqa/PROTOCOL.md b/benchmarks/cqa/PROTOCOL.md index b112d6e9a..5cb4fb451 100644 --- a/benchmarks/cqa/PROTOCOL.md +++ b/benchmarks/cqa/PROTOCOL.md @@ -15,10 +15,12 @@ query types equally within a dataset group; suite means weight datasets equally. Reports state whether a run covers the full split and every query type of its dataset, and partial runs are never presented as full-suite scores. -Ties are scored twice from the same predictions: `sort` follows the order of a -stable descending sort, and `expected` is the exact expectation of each rank -under uniformly random ordering within a tied block. `expected` is not the -midpoint rank. Rank traces store every hard answer's ranks under both policies, +Ties are scored twice from the same predictions: `sort` follows PyTorch's +default descending argsort, as the reference evaluator does. That sort is not +guaranteed stable, so exactly tied scores can order differently on another +device or library version. `expected` is the exact expectation of each rank +under uniformly random ordering within a tied block, which removes that +dependence. `expected` is not the midpoint rank. Rank traces store every hard answer's ranks under both policies, so later analyses never rerun inference. Each suite keeps its released candidates and inference graphs. UltraQuery diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index f80c9a53a..9c2e8b99b 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -5,7 +5,7 @@ Reproducible evaluation of complex query answering (CQA) on two suites: | Suite | Datasets | Query types | Answer filters | |---|---|---|---| | `ultraquery` | The 23 released UltraQuery datasets: 3 transductive, 9 inductive with new entities, 11 WikiTopics with new entities and relations | 14 (9 positive, 5 negated) | released | -| `plus_h` | **+H**: FB15k237+H, NELL995+H and ICEWS18+H from [Gregucci et al.](https://arxiv.org/abs/2410.12537), built so that complex queries cannot be reduced to simpler link prediction | 16 (adds `4p`, `4i`) | corrected, with released controls | +| `plus_h` | **+H**: FB15k237+H, NELL995+H and ICEWS18+H from [Gregucci et al.](https://arxiv.org/abs/2410.12537), whose hard answers are balanced across the number of links that must be predicted to reach them | 16 (adds `4p`, `4i`) | corrected, with released controls | Each suite evaluates published methods (UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE, CLMPT) through native DICE ports and the ULTRA and TRIX foundation models @@ -33,10 +33,11 @@ Containers have no network access, read inputs from `--input-root` (default: the repository) read-only, and write only below `--output`; `--gpu cdi` selects CDI device access and `--gpu none` runs on CPU. -Exploratory evaluation of any subset needs no preparation: +Exploratory evaluation of any subset needs no preparation. `--split` is +required, so the test split is only ever evaluated on request: ```bash -python -m benchmarks.cqa plus_h evaluate --output results/cqd-negation \ +python -m benchmarks.cqa plus_h evaluate --split valid --output results/cqd-negation \ --methods cqd cqd-hybrid --datasets FB15k237+H --query-types negation ``` diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index 7a04712d1..3fa8dee4f 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -257,3 +257,36 @@ def fail_after_commit(self, state): options['filter_corrections'] = {} with pytest.raises(ValueError, match='inputs/settings changed'): evaluate_benchmark(data, predict, **options) + + +@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +def test_row_granular_raw_cache_reaches_the_engine_and_keeps_scores(tmp_path, backbone): + from dicee.models import TRIX, ULTRA + from dicee.query_answering.score_adapter import QueryScoreAdapter + manifest = paper_fixture(tmp_path) + use_ultraquery_fixture(manifest, tmp_path) + model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) + torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + QueryScoreAdapter('context_scores', 1., bias_bound=8., + weights=torch.randn(2, 8, generator=torch.Generator().manual_seed(4)).double() / 5, + metadata={'backbone_state_sha256': state_fingerprint(model)}).save(tmp_path / 'adapter.json') + entry = manifest['entries'][0] + entry.update(id=f'{backbone}-paired', method=f'{backbone}-adapter', checkpoint='kgfm.pt', + options={'beam_size': 2, 'row_batch_size': 2, 'backend_batch_size': 2, 'cache_bytes': 4096, + 'raw_cache_bytes': 1 << 20, 'raw_cache_device': 'model', 'relation_cache_mb': 1, 'projection_cache_mb': 1}, + adapters={'product': 'adapter.json'}, operators={shape: 'product' for shape in entry['query_types']}, + selection_protocol='source-validation', finalized=True, adapter_ablation=True, + query_batch_size=4, query_order='relation') + results = {} + for granularity in ('batch', 'row'): + entry['options']['raw_cache_granularity'] = granularity + write_json(tmp_path / 'manifest.json', manifest) + cli.main(['ultraquery', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + '--output', str(tmp_path / granularity), '--entries', entry['id'], '--split', 'test', '--device', 'cpu']) + results[granularity] = read(tmp_path / granularity / entry['id'] / 'result.json') + row, batch = results['row'], results['batch'] + assert row['inference']['options']['raw_cache_granularity'] == 'row' + for shape, values in batch['per_shape'].items(): + assert row['per_shape'][shape]['mrr'] == pytest.approx(values['mrr'], abs=1e-6) + statistics = row['inference']['cache_statistics'], batch['inference']['cache_statistics'] + assert statistics[0]['backbone_computed_rows'] <= statistics[1]['backbone_computed_rows'] diff --git a/dicee/query_answering/benchmark.py b/dicee/query_answering/benchmark.py index 5508707b5..6eaae3371 100644 --- a/dicee/query_answering/benchmark.py +++ b/dicee/query_answering/benchmark.py @@ -210,8 +210,10 @@ def evaluate_benchmark(data: QueryBenchmark, predict: Callable[[tuple], torch.Te Args: data: Benchmark queries, inference graph and candidates. predict: Scores of every entity for one query. - tie_policy: ``'sort'`` (stable descending order) or ``'expected'`` (exact - expectation under random order within ties). + tie_policy: ``'sort'`` (PyTorch's default descending argsort, as in the + reference evaluator; not guaranteed stable, so exact ties may order + differently across devices) or ``'expected'`` (exact expectation + under random order within ties, which removes that dependence). max_queries_per_shape: Sample at most this many queries per type. progress: Called with completed and total query counts. prepare: Called with each batch of queries before they are predicted. diff --git a/dicee/query_answering/engine.py b/dicee/query_answering/engine.py index 9ab05a813..810efcaea 100644 --- a/dicee/query_answering/engine.py +++ b/dicee/query_answering/engine.py @@ -3,6 +3,7 @@ import math import weakref from collections import OrderedDict +from collections.abc import Hashable, Sequence from contextlib import contextmanager import torch @@ -84,7 +85,7 @@ def put(self, conditions, values): self.used += size self.peak = max(self.peak, self.used) - def lookup(self, token, conditions): + def lookup(self, token: Hashable | None, conditions: Sequence[Hashable]) -> tuple[dict[Hashable, torch.Tensor], list[Hashable]]: """Row granularity: cached rows by condition and the distinct missing conditions.""" if token is None or token != self.token: self.clear() @@ -99,7 +100,7 @@ def lookup(self, token, conditions): self.hits += sum(key in found for key in conditions) return found, missing - def put_rows(self, conditions, values): + def put_rows(self, conditions: Sequence[Hashable], values: torch.Tensor) -> None: """Row granularity: store each row of a computed batch on its own.""" self.computed += len(conditions) if self.token is None or not len(conditions): @@ -176,7 +177,11 @@ def evaluation(self): self._evaluating, self._token_memo = False, _UNSET def cache_token(self): - """Walking the model's tensors is costly; one evaluation context cannot change them, so it walks once.""" + """Walking the model's tensors is costly, so one evaluation context walks them once. + + This assumes parameters, buffers and the attached graph do not change inside + the context; a caller that mutates them there must leave and re-enter it. + """ if getattr(self, '_evaluating', False): if self._token_memo is _UNSET: self._token_memo = self._cache_token() From 1075d49d4e96cea97dc56a73d934d081c77d676a Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:06:28 +0200 Subject: [PATCH 11/39] fix(benchmarks): require an explicit split for direct evaluation `evaluate` defaulted to the test split, so an exploratory run could score test queries by accident. The flag is now required rather than defaulted to valid: the host forwards only non-default options into the pinned container, whose older code would otherwise fall back to its own test default. --- benchmarks/cqa/cli.py | 3 ++- benchmarks/cqa/tests/test_download_inputs.py | 6 +++--- benchmarks/cqa/tests/test_launcher.py | 11 ++++++----- benchmarks/cqa/tests/test_protocol.py | 4 ++-- benchmarks/cqa/tests/test_ultraquery_launcher.py | 6 ++++-- 5 files changed, 17 insertions(+), 13 deletions(-) diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 0b8f87b67..832465f67 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -92,7 +92,8 @@ def parallel(p): selection(p) p.add_argument('--output', type=Path, required=True) p.add_argument('--device', default='cuda') - p.add_argument('--split', choices=('valid', 'test'), default='test') + p.add_argument('--split', choices=('valid', 'test'), required=True, + help='Query split; required, so the test split is only ever evaluated on request') p.add_argument('--max-queries-per-shape', type=int, help='Uniform sample of each query type') p.add_argument('--seed', type=int) p.add_argument('--threads', type=int) diff --git a/benchmarks/cqa/tests/test_download_inputs.py b/benchmarks/cqa/tests/test_download_inputs.py index c382c92e2..2f5c68047 100644 --- a/benchmarks/cqa/tests/test_download_inputs.py +++ b/benchmarks/cqa/tests/test_download_inputs.py @@ -140,7 +140,7 @@ def test_host_commands_need_only_the_standard_library(tmp_path, suite, method): checked = subprocess.run([*common, 'setup', *selection, '--check'], capture_output=True, text=True, cwd=REPO) assert checked.returncode == 1 and 'Missing:' in checked.stdout root.mkdir() - launch = subprocess.check_output([*common, 'evaluate', *selection, '--output', str(root / 'results'), + launch = subprocess.check_output([*common, 'evaluate', '--split', 'test', *selection, '--output', str(root / 'results'), '--image', 'example:test', '--dry-run'], text=True, cwd=REPO) assert launch.startswith('docker run') and f'example:test {suite} evaluate --input-root /inputs' in launch assert list(root.iterdir()) == [] @@ -176,7 +176,7 @@ def evaluated(manifest, **kwargs): calls.append(('evaluate', manifest, kwargs)) monkeypatch.setattr(evaluate, 'evaluate_manifest', evaluated) - args = [suite, 'evaluate', '--methods', 'ultraquery', '--datasets', DATASET[suite], '--input-root', str(tmp_path), + args = [suite, 'evaluate', '--split', 'test', '--methods', 'ultraquery', '--datasets', DATASET[suite], '--input-root', str(tmp_path), '--output', str(tmp_path / 'results')] cli.main(args) assert [call[0] for call in calls] == ['setup', 'evaluate'] @@ -203,7 +203,7 @@ def test_docker_launch_fetches_on_host_before_isolated_container(tmp_path, monke monkeypatch.setattr(docker, 'run', lambda image, argv, **kwargs: calls.append(('container', image, argv))) root = tmp_path / 'inputs' root.mkdir() - args = [suite, 'evaluate', '--input-root', str(root), '--output', str(root / 'results'), '--image', 'test', '--device', 'cpu', + args = [suite, 'evaluate', '--split', 'test', '--input-root', str(root), '--output', str(root / 'results'), '--image', 'test', '--device', 'cpu', '--methods', 'ultraquery', '--datasets', DATASET[suite]] cli.main(args) assert [call[0] for call in calls] == ['setup', 'container'] and calls[0][2] == suite diff --git a/benchmarks/cqa/tests/test_launcher.py b/benchmarks/cqa/tests/test_launcher.py index 8fc7eeeb6..a513e688a 100644 --- a/benchmarks/cqa/tests/test_launcher.py +++ b/benchmarks/cqa/tests/test_launcher.py @@ -48,7 +48,7 @@ def test_invalid_hardware_settings_fail_before_inputs(settings): @pytest.mark.parametrize('suite', ['plus_h', 'ultraquery']) def test_hardware_profile_cli_and_container_forwarding(tmp_path, capsys, suite): output = tmp_path / 'run' - cli.main([suite, 'evaluate', '--hardware-profile', 'h100', '--kgfm-batch-size', '16', '--methods', 'ultra-adapter', + cli.main([suite, 'evaluate', '--split', 'test', '--hardware-profile', 'h100', '--kgfm-batch-size', '16', '--methods', 'ultra-adapter', '--output', str(output), '--dry-run']) entries = json.loads(capsys.readouterr().out)['entries'] assert all(e['options']['backend_batch_size'] == 16 and e['options']['raw_cache_device'] == 'model' for e in entries) @@ -126,7 +126,7 @@ def test_invalid_combinations_fail_before_opening_inputs(selection): def test_evaluate_dry_run_resolves_default_cqd_coverage_without_inputs(tmp_path, capsys, query_group): from dicee.query_answering._query import PLUS_H_SHAPES output = tmp_path / 'no-results' - args = ['plus_h', 'evaluate', '--methods', 'cqd', 'cqd-hybrid', '--input-root', str(tmp_path / 'missing-inputs'), + args = ['plus_h', 'evaluate', '--split', 'test', '--methods', 'cqd', 'cqd-hybrid', '--input-root', str(tmp_path / 'missing-inputs'), '--output', str(output), '--dry-run'] if query_group is not None: args += ['--query-types', query_group] @@ -165,7 +165,7 @@ def test_direct_subset_evaluation_scores_only_selected_methods_datasets_and_quer path = tmp_path / 'manifest.json' path.write_text(json.dumps(manifest)) output = tmp_path / 'results' - args = ['plus_h', 'evaluate', '--manifests', str(path), '--answer-filter', 'released', '--methods', 'cqd', 'cqd-hybrid', + args = ['plus_h', 'evaluate', '--split', 'test', '--manifests', str(path), '--answer-filter', 'released', '--methods', 'cqd', 'cqd-hybrid', '--datasets', 'FB15k237+H', '--query-types', 'negation', '--input-root', str(tmp_path), '--output', str(output), '--device', 'cpu', '--threads', '2'] cli.main(args) @@ -285,7 +285,8 @@ def launched(command, *extra): '--query-types', '2p', '3p') assert '--methods qto --datasets ICEWS18+H' in launched('run', '--methods', 'qto', '--datasets', 'ICEWS18+H') for command, extra in [('run', ['--query-types', '2p']), ('run', ['--atomic-negation']), ('run', ['--split', 'valid']), - ('evaluate', ['--methods']), ('evaluate', ['--max-queries-per-shape', '0'])]: + ('evaluate', ['--split', 'valid', '--methods']), ('evaluate', ['--split', 'valid', '--max-queries-per-shape', '0']), + ('evaluate', ['--methods', 'qto'])]: with pytest.raises(SystemExit): launched(command, *extra) @@ -387,7 +388,7 @@ def test_container_forwards_parallel_gpus_only_for_evaluate_and_run(tmp_path, ca common = ['--input-root', str(tmp_path), '--output', str(tmp_path / 'out'), *IMAGE] cli.main(['plus_h', 'run', *common, '--gpus', '0', '1', 'GPU-2c', '--workers-per-gpu', '2']) assert '--gpus 0 1 GPU-2c --workers-per-gpu 2' in capsys.readouterr().out - cli.main(['plus_h', 'evaluate', *common, '--gpus', '1']) + cli.main(['plus_h', 'evaluate', *common, '--split', 'test', '--gpus', '1']) assert '--gpus 1' in capsys.readouterr().out for command, extra in [('prepare', ['--gpus', '0']), ('run', ['--workers-per-gpu', '2']), ('run', ['--gpus'])]: with pytest.raises(SystemExit): diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py index fd0c4aa2a..affb10835 100644 --- a/benchmarks/cqa/tests/test_protocol.py +++ b/benchmarks/cqa/tests/test_protocol.py @@ -362,7 +362,7 @@ def test_shared_study_and_reports_use_dataset_coverage(tmp_path): assert rows[0]['complete_test'] and not rows[0]['complete_16_type_test'] assert rows[0]['types'] == 14 and rows[0]['published_mrr'] == 10. write_json(tmp_path / 'manifest.json', manifest) - main(['ultraquery', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + main(['ultraquery', 'evaluate', '--split', 'test', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), '--output', str(tmp_path / 'cli'), '--entries', entry['id'], '--device', 'cpu']) cli = read(tmp_path / 'cli' / entry['id'] / 'result.json') assert cli['per_shape'] == result['per_shape'] @@ -377,7 +377,7 @@ def test_corrected_filter_cli_preserves_query_type_selection(tmp_path, query_ord entry = manifest['entries'][0] entry.update(query_types=['1p'], query_order=query_order) write_json(tmp_path / 'manifest.json', manifest) - main(['plus_h', 'evaluate', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), + main(['plus_h', 'evaluate', '--split', 'test', '--manifests', str(tmp_path / 'manifest.json'), '--input-root', str(tmp_path), '--output', str(tmp_path / 'cli'), '--entries', entry['id'], '--device', 'cpu']) destination = tmp_path / 'cli' / entry['id'] result = read(destination / 'result.json') diff --git a/benchmarks/cqa/tests/test_ultraquery_launcher.py b/benchmarks/cqa/tests/test_ultraquery_launcher.py index 2110a6d9b..c2a39d0e5 100644 --- a/benchmarks/cqa/tests/test_ultraquery_launcher.py +++ b/benchmarks/cqa/tests/test_ultraquery_launcher.py @@ -108,7 +108,7 @@ def test_public_recipes_cover_all_datasets_and_selected_adapters(): def test_cli_subset_and_suite_policies_fail_before_opening_inputs(tmp_path, capsys): - cli.main(['ultraquery', 'evaluate', '--methods', 'ultraquery', 'ultra-adapter', '--datasets', 'WikiTopicsQuery:art', + cli.main(['ultraquery', 'evaluate', '--split', 'test', '--methods', 'ultraquery', 'ultra-adapter', '--datasets', 'WikiTopicsQuery:art', 'InductiveFB15k237Query:106', '--query-types', 'negation', '--input-root', str(tmp_path), '--output', str(tmp_path / 'results'), '--dry-run']) manifest = json.loads(capsys.readouterr().out) @@ -117,7 +117,7 @@ def test_cli_subset_and_suite_policies_fail_before_opening_inputs(tmp_path, caps assert not (tmp_path / 'results').exists() for selection in (['--answer-filter', 'corrected'], ['--datasets', 'FB15k237+H'], ['--methods', 'bad']): with pytest.raises(SystemExit): - cli.main(['ultraquery', 'evaluate', '--output', str(tmp_path / 'results'), '--dry-run', *selection]) + cli.main(['ultraquery', 'evaluate', '--split', 'test', '--output', str(tmp_path / 'results'), '--dry-run', *selection]) @pytest.mark.parametrize('action', ['prepare', 'evaluate', 'run', 'report']) @@ -126,6 +126,8 @@ def test_docker_actions_use_the_shared_runtime_and_correct_suite(tmp_path, capsy '--gpu', 'none', '--dry-run'] if action in ('evaluate', 'run'): args += ['--device', 'cpu'] + if action == 'evaluate': + args += ['--split', 'test'] if action == 'report': args += ['--results', str(tmp_path / 'results/test')] else: From 9732d6df58eeac65775a9addb379a2dcd54ea503 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:10:42 +0200 Subject: [PATCH 12/39] feat(benchmarks): report suite-level paired effects with seed-averaged ranks `report` now writes suite-effects.json/.md: for every adapter recipe, the suite-level MRR difference to its no-adapter control, to UltraQuery, and of the control to UltraQuery, overall, for EPFO and negation types and per UltraQuery family. Query types within a dataset and datasets within a group weigh equally. Seed replicates are averaged per query before differencing; the control is shared across seeds. Intervals come from a query bootstrap stratified by dataset and query type, conditional on the frozen models, adapters and seeds; per-seed point estimates are listed too. Only complete test runs with the suite's target answer filter are compared. --- benchmarks/cqa/reports.py | 163 ++++++++++++++++++++++++++ benchmarks/cqa/tests/test_protocol.py | 42 +++++++ 2 files changed, 205 insertions(+) diff --git a/benchmarks/cqa/reports.py b/benchmarks/cqa/reports.py index 00cf7f0bd..8211cb078 100644 --- a/benchmarks/cqa/reports.py +++ b/benchmarks/cqa/reports.py @@ -3,6 +3,7 @@ import csv import json import math +import re import sqlite3 from collections import defaultdict from pathlib import Path @@ -259,4 +260,166 @@ def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0 writer.writerow([pair['corrected'], pair['dataset'], shape, row['queries'], row['sort']['mrr'] * 100, row['expected']['mrr'] * 100]) (output / 'filter-effects.md').write_text('\n'.join(lines) + '\n') + records = [dict(id=row['id'], dataset=row['dataset'], method=row['method'], calibration=detail['calibration'], + paired_with=detail['paired_with'], complete=row['complete_test'], answer_filter=detail['answer_filter'], + trace=Path(detail['result']).parent / 'ranks.sqlite3') + for row, detail in zip(rows, details)] + effects = suite_effects(records, bootstrap_samples=bootstrap_samples, seed=seed) + write_json(output / 'suite-effects.json', effects) + lines = ['# Suite-level paired effects', '', + 'Treatment minus baseline, MRR ×100, equal weight per query type within a dataset and per dataset within ' + 'a group. Adapter seeds are averaged per query before differencing; intervals resample queries within ' + 'dataset × type and are conditional on the frozen models, adapters and seeds.', '', + '| Comparison | Recipe | Suite | Group | Seeds | Sort Δ | Sort 95% CI | Expected Δ | Seed range (sort) |', + '|---|---|---|---|---:|---:|---|---:|---|'] + for effect in effects: + for group, values in effect['macro']['sort'].items(): + ci = values['ci95'] + interval = f'[{ci[0]:+.2f}, {ci[1]:+.2f}]' if ci is not None else '—' + seeds = [s['sort'][group] for s in effect['per_seed'] if group in s['sort']] + spread = f'{min(seeds):+.2f} to {max(seeds):+.2f}' if len(seeds) > 1 else '—' + lines.append(f'| {effect["comparison"]} | {effect["recipe"]} | {effect["suite"]} | {group} | {len(effect["per_seed"])} | ' + f'{values["delta"]:+.2f} | {interval} | {effect["macro"]["expected"][group]["delta"]:+.2f} | {spread} |') + (output / 'suite-effects.md').write_text('\n'.join(lines) + '\n') return rows + + +def query_scores(path): + """{query_id: (shape, hard answers, sort MRR, expected MRR)} of one rank trace.""" + return {q['query_id']: (q['shape'], q['hard_answers'], q['sort']['mrr'], q['expected']['mrr']) for q in trace_queries(path)} + + +def paired_strata(treatments, baseline): + """{(policy, shape): per-query MRR differences}, treatments averaged per query (seed means). + + Every trace must cover the same queries with the same types and hard-answer counts. + """ + reference = query_scores(baseline) + scores = [query_scores(path) for path in treatments] + if any(set(s) != set(reference) for s in scores) or not reference: + raise ValueError(f'Suite comparison needs identical nonempty query coverage: {baseline}') + strata = defaultdict(list) + for query_id, (shape, answers, sort_mrr, expected_mrr) in reference.items(): + rows = [s[query_id] for s in scores] + if any(row[0] != shape or row[1] != answers for row in rows): + raise ValueError(f'Suite comparison changes query types or answers: {baseline}') + strata['sort', shape].append(100 * (sum(row[2] for row in rows) / len(rows) - sort_mrr)) + strata['expected', shape].append(100 * (sum(row[3] for row in rows) / len(rows) - expected_mrr)) + return {key: np.asarray(values) for key, values in strata.items()} + + +def macro_effects(by_dataset, groups, *, bootstrap_samples=2000, seed=0): + """{policy: {group: delta, ci95, datasets}} with equal type and dataset weights. + + by_dataset maps a dataset to its paired strata; groups map a name to (datasets, type filter). + The bootstrap resamples queries within each dataset × type stratum, in bounded memory. + """ + rng = np.random.default_rng(seed) + output = {} + for policy in ('sort', 'expected'): + output[policy] = {} + for group, (datasets, keep) in groups.items(): + members = [d for d in datasets if d in by_dataset] + shapes = {d: [s for p, s in by_dataset[d] if p == policy and keep(s)] for d in members} + members = [d for d in members if shapes[d]] + if not members: + continue + point = float(np.mean([np.mean([by_dataset[d][policy, s].mean() for s in shapes[d]]) for d in members])) + interval = None + if bootstrap_samples: + draws = np.zeros(bootstrap_samples) + for d in members: + for s in shapes[d]: + values = by_dataset[d][policy, s] + chunk = max(1, 4_000_000 // len(values)) + means = np.concatenate([values[rng.integers(0, len(values), size=(min(chunk, bootstrap_samples - start), len(values)))].mean(1) + for start in range(0, bootstrap_samples, chunk)]) + draws += means / len(shapes[d]) / len(members) + interval = [float(v) for v in np.quantile(draws, [.025, .975])] + output[policy][group] = dict(delta=point, ci95=interval, datasets=len(members)) + return output + + +# A run ID is method and recipe, an optional -seedN tag of the adapter training seed, the dataset, and the suffixes +# of paired controls and evaluation conditions. +SEED = re.compile(r'-seed(\d+)(?=-|$)') +CONDITION_SUFFIXES = ('-graph-train-valid', '-graph-train', '-released-filters') + + +def identity_run(record): + """A no-adapter control: paired with a learned run or identity-calibrated.""" + return bool(record.get('paired_with') or record.get('calibration') == 'without-adapter' + or '-without-adapter' in (record.get('id') or '')) + + +def system_of(record): + """((method, identity, recipe), seed tag) of one result; recipes exclude dataset, seed and condition.""" + text = record['id'].replace(record['dataset'], '').replace('-without-adapter', '') + for suffix in CONDITION_SUFFIXES: + text = text.replace(suffix, '') + match = SEED.search(text) + recipe = re.sub('-+', '-', SEED.sub('', text)).strip('-') or record['method'] + return (record['method'], identity_run(record), recipe), int(match.group(1)) if match else 0 + + +def suite_effects(records, *, bootstrap_samples=2000, seed=0): + """Suite-level paired effects of every adapter recipe: against its no-adapter control and against UltraQuery. + + Seed replicates (entry IDs differing only by -seedN) are averaged per query; the control, + which identity calibration makes independent of the adapter seed, is its lowest seed tag. + Only complete test runs with corrected (+H) or released (UltraQuery) filters are compared. + """ + from dicee.query_answering.catalog import BENCHMARK_DATASETS, PLUS_H_DATASETS, dataset_spec + + suites = {'ultraquery': [d for d in BENCHMARK_DATASETS if dataset_spec(d)[0] in ('transductive', 'inductive-e', 'inductive-er')], + 'plus_h': list(PLUS_H_DATASETS)} + negation = {s for s in PLUS_H_SHAPES if 'n' in s} + systems = defaultdict(lambda: defaultdict(dict)) + for record in records: + target_filter = 'corrected' if record['dataset'] in PLUS_H_DATASETS else 'released' + if not record['complete'] or record['answer_filter'] != target_filter or record['id'].endswith('-released-filters'): + continue + system, tag = system_of(record) + systems[system][record['dataset']][tag] = record['trace'] + output = [] + for (method, identity, recipe), runs in sorted(systems.items()): + if identity or not method.endswith('-adapter'): + continue + control = systems.get((method, True, recipe), {}) + baseline = systems.get(('ultraquery', False, 'ultraquery'), {}) + for suite, datasets in suites.items(): + present = [d for d in datasets if d in runs] + if not present: + continue + families = {'all': (datasets, lambda s: True), 'epfo': (datasets, lambda s: s not in negation), + 'negation': (datasets, lambda s: s in negation)} + if suite == 'ultraquery': + families |= {family: ([d for d in datasets if dataset_spec(d)[0] == family], lambda s: True) + for family in ('transductive', 'inductive-e', 'inductive-er')} + seeds = sorted(set.intersection(*(set(runs[d]) for d in present))) + for comparison, reference in (('adapter-minus-identity', control), ('adapter-minus-ultraquery', baseline), + ('identity-minus-ultraquery', baseline if control else {})): + if comparison == 'identity-minus-ultraquery': + treatments = {d: [control[d][min(control[d])]] for d in present if d in control} + else: + treatments = {d: [runs[d][tag] for tag in seeds] for d in present} + shared = [d for d in present if d in reference and d in treatments and treatments[d]] + if not shared: + continue + base = {d: reference[d][min(reference[d])] for d in shared} + strata = {d: paired_strata(treatments[d], base[d]) for d in shared} + per_seed = [] + if comparison != 'identity-minus-ultraquery': + for tag in seeds: + single = {d: paired_strata([runs[d][tag]], base[d]) for d in shared} + values = macro_effects(single, families, bootstrap_samples=0) + per_seed.append(dict(seed_tag=tag, **{p: {g: v['delta'] for g, v in values[p].items()} for p in values})) + output.append(dict(comparison=comparison, method=method, recipe=recipe, suite=suite, + datasets=len(shared), complete_suite=len(shared) == len(datasets), + seed_tags=seeds if comparison != 'identity-minus-ultraquery' else [], + macro=macro_effects(strata, families, bootstrap_samples=bootstrap_samples, seed=seed), + per_seed=per_seed, + uncertainty=dict(unit='paired query', stratification='dataset x query type', + resamples=bootstrap_samples, seed=seed, + scope='Conditional on frozen models, adapters and the evaluated seeds.'))) + return output diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py index affb10835..71531c007 100644 --- a/benchmarks/cqa/tests/test_protocol.py +++ b/benchmarks/cqa/tests/test_protocol.py @@ -615,3 +615,45 @@ def run(*args, on_prediction, **kwargs): with pytest.raises(ValueError, match='Reference inference graphs differ'): verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'wrong-graph.pt', tmp_path / 'wrong-graph.json') + + +def test_suite_effects_average_seeds_per_query_and_pair_the_shared_control(tmp_path): + from collections import namedtuple + + from benchmarks.cqa.reports import suite_effects + from dicee.query_answering._rank_trace import RankTrace + from dicee.query_answering.catalog import PLUS_H_DATASETS + Query = namedtuple('Query', 'identity shape') + records = [] + runs = (('ultra-r-{}', 'ultra-adapter', 1, {}), ('ultra-r-seed1-{}', 'ultra-adapter', 2, {}), + ('ultra-r-{}-without-adapter', 'ultra-adapter', 4, dict(paired_with='ultra-r-{}', calibration='without-adapter')), + ('ultraquery-{}', 'ultraquery', 2, {})) + for dataset in PLUS_H_DATASETS: + for template, method, rank, extra in runs: + entry = template.format(dataset) + path = tmp_path / entry / 'ranks.sqlite3' + with RankTrace(path, {'entry': entry}, 0) as trace: + for position, shape in enumerate(['1p'] * 4 + ['2in'] * 4): + trace.add(position, Query(f'{dataset}-{position}', shape), [[7, rank, rank - 1, 1]]) + trace.commit() + records.append(dict(id=entry, dataset=dataset, method=method, complete=True, answer_filter='corrected', trace=path, + paired_with=extra.get('paired_with', '').format(dataset) or None, + calibration=extra.get('calibration', 'learned'))) + effects = {e['comparison']: e for e in suite_effects(records, bootstrap_samples=20)} + assert set(effects) == {'adapter-minus-identity', 'adapter-minus-ultraquery', 'identity-minus-ultraquery'} + # Seed tags 0 and 1 rank the answer first and second: a per-query seed mean of 0.75 MRR. + for comparison, delta in (('adapter-minus-identity', 50), ('adapter-minus-ultraquery', 25), ('identity-minus-ultraquery', -25)): + effect = effects[comparison] + assert effect['complete_suite'] and effect['datasets'] == 3 + for group in ('all', 'epfo', 'negation'): + assert effect['macro']['sort'][group]['delta'] == pytest.approx(delta) + assert effect['macro']['sort'][group]['ci95'] == pytest.approx([delta, delta]) + assert [s['sort']['all'] for s in effects['adapter-minus-identity']['per_seed']] == pytest.approx([75, 25]) + assert effects['adapter-minus-identity']['seed_tags'] == [0, 1] + # Only seeds covering every dataset enter the seed mean; a missing baseline run makes the suite incomplete. + records[0]['complete'] = False + effects = {e['comparison']: e for e in suite_effects(records, bootstrap_samples=0)} + assert effects['adapter-minus-identity']['seed_tags'] == [1] and effects['adapter-minus-identity']['complete_suite'] + next(r for r in records if r['method'] == 'ultraquery')['complete'] = False + effects = {e['comparison']: e for e in suite_effects(records, bootstrap_samples=0)} + assert effects['adapter-minus-ultraquery']['datasets'] == 2 and not effects['adapter-minus-ultraquery']['complete_suite'] From 48ce1b1af535ce76e4a2e21bb9c2c8f45cab4482 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:27:09 +0200 Subject: [PATCH 13/39] feat(benchmarks): ship the 2i/3i adapters on +H and the measured H100 profile - +H now ships the 2i/3i-trained adapters, the recipe selected for both suites. - The h100 profile is the configuration measured on full validation splits: batches of 16, a 24 GiB per-row raw-score cache in host memory and a 512 MiB calibrated cache. --- benchmarks/cqa/README.md | 24 ++-- benchmarks/cqa/manifests.py | 12 +- benchmarks/cqa/tests/recipe_fingerprints.json | 104 +++++++++--------- benchmarks/cqa/tests/test_launcher.py | 7 +- benchmarks/plus_h/kgfm_adapters.json | 22 ++-- benchmarks/ultraquery/kgfm_adapters.json | 4 +- 6 files changed, 89 insertions(+), 84 deletions(-) diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index 9c2e8b99b..bec288dc2 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -81,7 +81,7 @@ execution options. Each suite directory holds its public recipes: | File | Contents | |---|---| | `plus_h/baselines.json` | The seven published methods on the three +H datasets (21 entries) | -| `plus_h/kgfm_adapters.json` | ULTRA and TRIX with 14-type adapters (6 entries, each with an identity control) | +| `plus_h/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters (6 entries, each with an identity control) | | `plus_h/published_results.json` | Scores reported by the +H authors, for `report` | | `ultraquery/baselines.json` | Native UltraQuery on all 23 datasets | | `ultraquery/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters on all 23 datasets | @@ -89,8 +89,8 @@ execution options. Each suite directory holds its public recipes: | `ultraquery/trained_baselines.json` | QTO on FB15k and inductive GNN-QE, after `train` | Defaults are `baselines.json` and `kgfm_adapters.json`; `--manifests FILE ...` -replaces them. Adapter weights shared by both suites are in -[`benchmarks/adapters`](../adapters). Recipe files list shared `defaults` once +replaces them. Adapter weights shared by both +suites are in [`benchmarks/adapters`](../adapters). Recipe files list shared `defaults` once per method, and each entry only what differs; `{dataset}` in an ID is filled in. [`tests/recipe_fingerprints.json`](tests/recipe_fingerprints.json) pins every resolved entry, so a recipe change is always visible in review. @@ -147,8 +147,8 @@ Each ablation is a separate study with its own verification. - **Answer filters** (+H): every prediction is also scored with the released filters (`-released-filters`); `--answer-filter released` prepares a study with released filters only. -- **Adapters**: every ULTRA/TRIX entry has a `without-adapter` control scored - from the same backbone batches. +- **Adapters**: every shipped ULTRA/TRIX entry has a `without-adapter` control + scored from the same backbone batches. `report` writes paired effects with query-bootstrap confidence intervals conditional on the frozen weights: `adapter-effects`, `filter-effects` and @@ -156,18 +156,20 @@ conditional on the frozen weights: `adapter-effects`, `filter-effects` and ## Hardware and parallelism -`--hardware-profile h100` (on `prepare` or `evaluate`) is a starting point for -H100 80 GB and H100 NVL GPUs: ULTRA/TRIX use atomic batches of 16, a 4 GiB -budget for calibrated scores, 2 GiB of raw scores on the GPU, and 256/512 MiB -relation/projection caches. `--kgfm-batch-size N` overrides the batch. Other +`--hardware-profile h100` (on `prepare` or `evaluate`) is the configuration +measured on full validation splits on H100 80 GB and H100 NVL GPUs: ULTRA/TRIX +use atomic batches of 16, a 512 MiB budget for calibrated scores, and a 24 GiB +cache of raw backbone scores in host memory, kept per row so that the beams of +different queries share it. `--kgfm-batch-size N` overrides the batch. Other methods keep their settings. These settings can change floating-point results, so they are frozen with the study and verified on the target GPU. `run` and `evaluate` accept `--gpus 0 1 2 3`: each entry runs in a fresh worker that sees one GPU, longest methods first, with results identical to a sequential run. `--workers-per-gpu 2` overlaps one worker's host work with -another's GPU work; with the H100 profile a KGFM worker needs about 6 GiB. Keep -one worker per GPU on GPUs shared with other jobs. +another's GPU work, for about 1.5 times the throughput of one worker; with the +H100 profile each KGFM worker stays below 12 GiB of GPU memory and holds up to +24 GiB of host memory. Keep one worker per GPU on GPUs shared with other jobs. ## UltraQuery comparison baselines diff --git a/benchmarks/cqa/manifests.py b/benchmarks/cqa/manifests.py index 88d79b1e7..b705bccb2 100644 --- a/benchmarks/cqa/manifests.py +++ b/benchmarks/cqa/manifests.py @@ -22,10 +22,12 @@ 'ultraquery': dict(title='UltraQuery benchmark (released PyG)', answer_filter='released'), } KGFM_EXECUTION = { - # H100 / H100 NVL starting point for ULTRA/TRIX adapters: larger atomic - # batches and bounded GPU caches. Native methods need no profile. - 'h100': dict(row_batch_size=16, backend_batch_size=16, cache_bytes=4 * 2**30, raw_cache_bytes=2 * 2**30, - raw_cache_device='model', relation_cache_mb=256, projection_cache_mb=512), + # ULTRA/TRIX adapters on H100 / H100 NVL, as measured on full validation + # splits: atomic batches of 16 and a per-row cache of raw backbone scores + # in host memory, which beams of different queries share. Native methods + # need no profile. + 'h100': dict(row_batch_size=16, backend_batch_size=16, cache_bytes=512 * 2**20, raw_cache_bytes=24 * 2**30, + raw_cache_device='cpu', raw_cache_granularity='row'), } @@ -261,7 +263,7 @@ def prepare_manifest(paths, *, profile='bounded', entries=None, methods=None, da entry['options'].update(KGFM_EXECUTION[hardware_profile]) entry['reference']['status'] = 'H100 execution profile; independent validation required' entry['reference'].setdefault('notes', []).append( - 'H100 / H100 NVL starting configuration, not a measured optimum. Float32 IEEE, query batches, beams, ' + 'H100 / H100 NVL configuration measured on full validation splits. Float32 IEEE, query batches, beams, ' 'operators and observed facts retained. Validate memory, scores, orders and ties on the target GPU.') if kgfm and kgfm_batch_size is not None: entry['options'].update(row_batch_size=kgfm_batch_size, backend_batch_size=kgfm_batch_size) diff --git a/benchmarks/cqa/tests/recipe_fingerprints.json b/benchmarks/cqa/tests/recipe_fingerprints.json index 25332636f..5e4a88aad 100644 --- a/benchmarks/cqa/tests/recipe_fingerprints.json +++ b/benchmarks/cqa/tests/recipe_fingerprints.json @@ -23,12 +23,12 @@ "qto-ICEWS18+H": "cef09df05749b23f75aff1b0b4dc49dc77de547064cd0e57289219e976f811e0" }, "plus_h/kgfm_adapters.json": { - "ultra-product-14type-FB15k237+H": "bc15b0f7cc9c5eaed7cc63f6c023964eead80b9e721561cdb28ae5df64244826", - "ultra-product-14type-NELL995+H": "86e00279f85d026b08bd7363c3e1fc0688b81727da1acefd0d55611f4940f85c", - "ultra-product-14type-ICEWS18+H": "e2843b22b81cd16efb593b27e3438e5eefdc5df2f2bdbf13b0bea5fed261dca9", - "trix-product-14type-FB15k237+H": "593033539e5d68f216c3d2cf796bab5f956c563eb4319556699feb18e5d450e2", - "trix-product-14type-NELL995+H": "4cf792ec22efee88e808657ebffa9887688d51ef69e5e9ad084ee97e08461f27", - "trix-product-14type-ICEWS18+H": "c6f956f332f9b0a3d28f89a49c2d4007646af696239ea690977020e87040c4ad" + "ultra-product-intersections-FB15k237+H": "b69ee51b10efde939da3acca958737342f0b9c04cb87029a433f96a9694dbd09", + "ultra-product-intersections-NELL995+H": "f6a4a3f314e45764186125e90e21c7874be9bdf6903cf3dc27e1d31f244ddcb4", + "ultra-product-intersections-ICEWS18+H": "c6283b9ab962a54bd825c230173b16fc10e8a9529dab1c5733755a2770a937fb", + "trix-product-intersections-FB15k237+H": "6fabf9f473c59f4519446bfe53445cd8be1a7bbb0be889d88103c7c8281f1a94", + "trix-product-intersections-NELL995+H": "69cb115effd0ee6d9c14c06f8d4866e3ff2148260174b36722d0a7b68e8dab3c", + "trix-product-intersections-ICEWS18+H": "6f84bbe2e79bb47b5c8a788db48dd51079f52ad1274a839043fe472d36f66b37" }, "ultraquery/baselines.json": { "ultraquery-FB15k237LogicalQuery": "529aa658841bff87867a50b626cae7e9c01dc8a7b38b5177eda2af712988e66d", @@ -117,52 +117,52 @@ "qto-NELL995LogicalQuery": "10d947a9870d943ce731cb64fcbf914b3c1a116c1affdebdeba101975272d0e2" }, "ultraquery/kgfm_adapters.json": { - "ultra-product-intersections-FB15k237LogicalQuery": "b7f024872516b9bbc02968b3afa41ffbe02fda98f7a61b92a587d099aa42b05f", - "ultra-product-intersections-FB15kLogicalQuery": "37fa9d6876b01a382ca198969511e42afc953da7763840e434356b4a67627c2a", - "ultra-product-intersections-NELL995LogicalQuery": "1c8074dd1de9fda420033c6bef9e3837bad2184636cc5f19f8ea70bc28ef3f96", - "ultra-product-intersections-InductiveFB15k237Query:106": "87c7ba8fdc0c61d8ec1cc2acfa27919c7682f9bd5d9ca279420a49e2992b56d7", - "ultra-product-intersections-InductiveFB15k237Query:113": "1e4d5067e04800bc8b3e86c3502aa27f2de884a8c94c98919bce51d633b0cb37", - "ultra-product-intersections-InductiveFB15k237Query:122": "9ec2c6949fe9358486082cc8079e93b0e0b461292e8682d3c05c78667dfdc99b", - "ultra-product-intersections-InductiveFB15k237Query:134": "eaff89cd2cf71ca069924f1b808e8fd29f16951191c8a68436571d24ced3d482", - "ultra-product-intersections-InductiveFB15k237Query:150": "b426d29a415af98a05851bae5dc16c90b37de10d7548398662408949e604ad32", - "ultra-product-intersections-InductiveFB15k237Query:175": "9778ebf4123dad98d51d9a48ddbf948865703efc6382eff6c3bb7a994aec9c5f", - "ultra-product-intersections-InductiveFB15k237Query:217": "f17b74708c32126a33f421d506bd7172606abe0ac3eaa4ac95c9881bed85da3c", - "ultra-product-intersections-InductiveFB15k237Query:300": "1e4667e72faee905cad2e021bd4717dc1aa285496422eada16a790ecbc2166bd", - "ultra-product-intersections-InductiveFB15k237Query:550": "29db5c01d7712b17ebe07dd13958bfdea1d379e552dedfcc12b407d4f37c098e", - "ultra-product-intersections-WikiTopicsQuery:art": "699d89e9fc1e676c745e3614bd04afec3de80e0c4005a126a829afc776f26d4a", - "ultra-product-intersections-WikiTopicsQuery:award": "4ef7835651fece94dff248a58db7000a89dff2f67231d7d69ebdf31f15a4bdea", - "ultra-product-intersections-WikiTopicsQuery:edu": "8170f4c5cb9714143c3d172537e26879a9e5b3aa2add6944a130ff5ef3292fe2", - "ultra-product-intersections-WikiTopicsQuery:health": "f3768f1968b3dd829a0028ca13e96e29157b0c091b3e536f7df2b2d3f06bba83", - "ultra-product-intersections-WikiTopicsQuery:infra": "1750cb01194aefca24a03d125d4b1c29ddb8a57ed6c834f93370835b3655a7b0", - "ultra-product-intersections-WikiTopicsQuery:loc": "d515e376f742826dc1fc0d45d8b047d5b16bd490c4291f36f25176b8d8a5edd0", - "ultra-product-intersections-WikiTopicsQuery:org": "58fc3260b53f2beb2536a3420b0c8ca81bd7856b9460f1e8dc3d4f518a1d9334", - "ultra-product-intersections-WikiTopicsQuery:people": "4f63bb7367dc685a1efeda42fb15d6e4c3e17f3e1ba84c123a2fb5a08eea79e5", - "ultra-product-intersections-WikiTopicsQuery:sci": "07896dd08a1e70badcca0b3aca16a553d2eb8dce877560aeee7a935bf77b10b7", - "ultra-product-intersections-WikiTopicsQuery:sport": "d02a3f11dcc1fa68ce5bdfb491d7f99bd3d23c3b9d8d7b8f7b63e604ae9d3520", - "ultra-product-intersections-WikiTopicsQuery:tax": "73d6cfa003d9a87c152367c3970d15934267583e5b94946fa137e952235e680f", - "trix-product-intersections-FB15k237LogicalQuery": "fd27d852fb1f09eff4aae25c3d9792ee4e79db94f816f120d1541edf8202b423", - "trix-product-intersections-FB15kLogicalQuery": "4fc028ffd5f035214a875de201f906e4ba7871eb5fbcbc6f3a47870fdb90bb4a", - "trix-product-intersections-NELL995LogicalQuery": "6bd7b036a128288b6187350c81c22d4ef32ce76d1bf86d55d0a9a20304770e13", - "trix-product-intersections-InductiveFB15k237Query:106": "df530e73b516ef9bbec728473f04182b62fb5b6938dc82f03bd98aed9e12470a", - "trix-product-intersections-InductiveFB15k237Query:113": "e9fe38062feded83a25e7d043f65efb72b34c4217fef9fc43a443511d873e9e9", - "trix-product-intersections-InductiveFB15k237Query:122": "a286cdad697c89631b0af783225d6e5a60e5ec0546d70dd3cd7d30c6015f9d7f", - "trix-product-intersections-InductiveFB15k237Query:134": "3a1dea4c930992e31f56f1e11a91604c7dbfaf4149e4152049185ee0bd2563a2", - "trix-product-intersections-InductiveFB15k237Query:150": "d9475a2c0fcbf344377a94416b280e9f47dd6e6a0a87fdeb99309362bb048083", - "trix-product-intersections-InductiveFB15k237Query:175": "485545e143d118b5e52cbd2ee2fe545904a8e07ec0444a600fa3b9ccf30cafd2", - "trix-product-intersections-InductiveFB15k237Query:217": "060957dac48e9d84250fb355c77e320b811b0afeed886d2546fef8aee0d6da24", - "trix-product-intersections-InductiveFB15k237Query:300": "b80c3d5aed48d51818f600ef082030ac27242ff0ecd40040a3288e553030ae8a", - "trix-product-intersections-InductiveFB15k237Query:550": "9b59854367c05e81398920e430e15b451294785b6887bcaa8276a0665f8bf7f1", - "trix-product-intersections-WikiTopicsQuery:art": "7c375b93e8045391c9ae585f5b12742f4ff3e52649dfec05cdfa29f9dafd9536", - "trix-product-intersections-WikiTopicsQuery:award": "4db5e7755f0422e5c4e834fa553abfd56cf660f33f954c1e104a810122a74e90", - "trix-product-intersections-WikiTopicsQuery:edu": "9f561a6e3f9294243df80c410e3af977feb0ab78b7c609857d71d53527224348", - "trix-product-intersections-WikiTopicsQuery:health": "9403ddc30a81fa9b03d3a5048c691588f98f55edbebd5e7c6074d3b52036e6bb", - "trix-product-intersections-WikiTopicsQuery:infra": "1188f0407bc57a617562ece83fa75787fd6a64df6200fadf13a5b71c8b8a85e9", - "trix-product-intersections-WikiTopicsQuery:loc": "3a68391770ce5faee466840b2fd0eaa68e985bdc9987850913e6a52f74ccff85", - "trix-product-intersections-WikiTopicsQuery:org": "c93762c407b778070aa576dd8e59cbdd7c2ff95b0d1dcde1d4fb1abc7a7dc9e2", - "trix-product-intersections-WikiTopicsQuery:people": "53190c3c7c971fecb60682ac6fdda4bcaa742f9da481faf3c56c1305669e6d33", - "trix-product-intersections-WikiTopicsQuery:sci": "50c1c0417641a3868b81c5b597636f129e58f79677bba148fca532254c5811f6", - "trix-product-intersections-WikiTopicsQuery:sport": "670bf147bd1a3f6a2027f87c7aefcb4da12b4e9ce5357b83c0bd7f2f11dab10c", - "trix-product-intersections-WikiTopicsQuery:tax": "afd681810b572d959993a34b9f382c1e5172c70734362870b9652161b6334d8f" + "ultra-product-intersections-FB15k237LogicalQuery": "287c4c1e7f5000232b37686fb2cd11d480b8963226c9e723396a6eac6c5d5e48", + "ultra-product-intersections-FB15kLogicalQuery": "eb453b1cb918f07548d613970c35d12bf9cd7358acf5bc9fd18fbc8e7da45536", + "ultra-product-intersections-NELL995LogicalQuery": "29040aa44a675f7bae08f50f11eafff27fbfd6624e1fca5be03999ae2427f887", + "ultra-product-intersections-InductiveFB15k237Query:106": "7daf756989b77b0533b6fb557ca71b0b3a51a1031b63cc5b98128719209222de", + "ultra-product-intersections-InductiveFB15k237Query:113": "81552189926526ed9e2bdf8fe87ab52f0694322cb346668f190eb2bb60bf0901", + "ultra-product-intersections-InductiveFB15k237Query:122": "159166cb777fd904b4bc48baa48e980925c841a657b5588699382cadbecb90c5", + "ultra-product-intersections-InductiveFB15k237Query:134": "b2e5c879638b717de49dc4aaf215a3d1f6e7b29511f21f23047e3052404e75c8", + "ultra-product-intersections-InductiveFB15k237Query:150": "e3fce4a47cfe2b60d731accaaa05cff15dc5935fb44d235a8dcdfc86dbe46077", + "ultra-product-intersections-InductiveFB15k237Query:175": "6af28e4a40732fbe77ed918b78eee663f1bdc3d85fd1468bdfe14b4d36e1e26c", + "ultra-product-intersections-InductiveFB15k237Query:217": "98f3277b203311f6a8f43d849adf1b785a4edf0e2369e88afbc088e937c54761", + "ultra-product-intersections-InductiveFB15k237Query:300": "8663e0173bba7a2d68f4ab0dccfc8953d901d100e4645a138bc80328208271dd", + "ultra-product-intersections-InductiveFB15k237Query:550": "cd242c77612ea35b082694b3acc37470afaa13b79c392a4890ffa8ada3092007", + "ultra-product-intersections-WikiTopicsQuery:art": "a2a4c3998c2b70d96f76fa5c208a7572aa1d003f537245ddba7805293d995728", + "ultra-product-intersections-WikiTopicsQuery:award": "41fd60ec92e9bfca93e371f49a50523079bdbd797140ee547beb989e5b5000c4", + "ultra-product-intersections-WikiTopicsQuery:edu": "f184d870d32e8b9ba212d30674e52a4d5083d4546f087df9b550b0f494a909e7", + "ultra-product-intersections-WikiTopicsQuery:health": "e0860965b3fe6efba4ed5e8d26a3812388c14e3853e483f28df0074871f8e2ed", + "ultra-product-intersections-WikiTopicsQuery:infra": "34d6d916257068bc41d74f101b0eb623fb0cde18d63f12d26d82cd7f3f8a0ee5", + "ultra-product-intersections-WikiTopicsQuery:loc": "46db49317b65728e40e2ebd1eda4489eceda6ced547e1e1878b0839b392112e3", + "ultra-product-intersections-WikiTopicsQuery:org": "1a0eaf3df270714b6e8bd7a7da6db50a55772ed9dbcb474f526c7d7caa5b5ede", + "ultra-product-intersections-WikiTopicsQuery:people": "c24dc427aaa681a3877510c45bd87772e9ed1003183dd49579225ee6b2819d29", + "ultra-product-intersections-WikiTopicsQuery:sci": "0305cb5e98f62f9022b3e558c411b65c2b316d6bd8fa626fa616e6a9aea576fc", + "ultra-product-intersections-WikiTopicsQuery:sport": "d6000c937fff7b281157a1afe8de25d0d9011febc3834fb7964f8a2e4f7969e5", + "ultra-product-intersections-WikiTopicsQuery:tax": "cc0dcdba8ea327700aa81c87620c1de31590f01c54b064002ef9f53465f48da5", + "trix-product-intersections-FB15k237LogicalQuery": "1be3cf045d6511e9fa27d588a192bf615efcdf285bd859eca74c2ee8b2d6a90e", + "trix-product-intersections-FB15kLogicalQuery": "978d9dc4efd48c154cc8dafcddf2bd6056a9cfc36dd9206facaff356e7fb5452", + "trix-product-intersections-NELL995LogicalQuery": "c0edaec7b91da7684f35f0bf5225d3d95ac3dd043fa89f6b288a6c153ce88838", + "trix-product-intersections-InductiveFB15k237Query:106": "5f304ec689a95e64cbe2d78a36fdd1b16451f510ec60de87169291b9e5ed1888", + "trix-product-intersections-InductiveFB15k237Query:113": "81b0daebd89d258a16bfdbb4204f0e81647d283fe0ad0dd7594fdd8b1914798b", + "trix-product-intersections-InductiveFB15k237Query:122": "e1922ac49ff1fa062ad7e69dc5d4e62a3ce6706c0e2229892d2594e85bf13240", + "trix-product-intersections-InductiveFB15k237Query:134": "b24a1a635170150791fd01a5bf84556bdd8c8947cbb1d26207c35c70ae8021ae", + "trix-product-intersections-InductiveFB15k237Query:150": "0d31a07a19fa186d58d8aee2a1c778ec88195732340907afd557112a710e90c1", + "trix-product-intersections-InductiveFB15k237Query:175": "3419ce50681b12b8243ed05fbc779b6150453400d40dc520961e324a5f975088", + "trix-product-intersections-InductiveFB15k237Query:217": "7224a0bb0c9c2cfb778181cc6942ded084d1458ca12cc462920be438b8f29e1e", + "trix-product-intersections-InductiveFB15k237Query:300": "3c4c21948c52c4ffb10f462984279b425671dfd9088ae3b6864313c99a7edbba", + "trix-product-intersections-InductiveFB15k237Query:550": "0721fae25c558915cdcc154c6563c57d0fa933b5f30b0e9604e7308bd435ced5", + "trix-product-intersections-WikiTopicsQuery:art": "24620fd2cf94976a906b063418aebfbea7bff4219ec86e574437643bfffd967c", + "trix-product-intersections-WikiTopicsQuery:award": "d0f497a6a7dc1035fdcfb9a0b2b699aa5033bc235e0f1f34838bd8a18115131c", + "trix-product-intersections-WikiTopicsQuery:edu": "79a42ccaf3fee6e6aa8e5f1669301cf9e0b45c8895f3ecb01227f297f9b67891", + "trix-product-intersections-WikiTopicsQuery:health": "7f785b8624f72b7028dbd83eedd1b436a48de90364313089f345a9212c55ac8e", + "trix-product-intersections-WikiTopicsQuery:infra": "52920e879c823801319a7bc994eff5557da7171311298465f41e4faf61222599", + "trix-product-intersections-WikiTopicsQuery:loc": "3daa68f827ca911ef0501a02ba42811b985b9ee0f9ee29b372769c40a369d4ae", + "trix-product-intersections-WikiTopicsQuery:org": "106df045f26443278f54aa129a0ac2ae1e56a1e7516efbec6d5a9cc11845046b", + "trix-product-intersections-WikiTopicsQuery:people": "a07fa82767dabbe08c71c767b551da571ad930f210c22502675ce476bf8d907f", + "trix-product-intersections-WikiTopicsQuery:sci": "64a1ed5aadb56eac0a836cf421fb0f3ecb3db6580e2f6d2e0117a2e199449fbf", + "trix-product-intersections-WikiTopicsQuery:sport": "789c3e69c42d240f41d9b14cc72dee70f887a0498b14de7b92e50b89975b0c69", + "trix-product-intersections-WikiTopicsQuery:tax": "ca14cbcb7938c80e89c121d75f71c9163c26cc6dc622efabb7e35ebc3457dd40" }, "ultraquery/trained_baselines.json": { "qto-FB15kLogicalQuery": "6f769ebd4a6f84d0f42a443486b2f0d778055201557996f01deec98417665cbe", diff --git a/benchmarks/cqa/tests/test_launcher.py b/benchmarks/cqa/tests/test_launcher.py index a513e688a..03080bec3 100644 --- a/benchmarks/cqa/tests/test_launcher.py +++ b/benchmarks/cqa/tests/test_launcher.py @@ -25,11 +25,10 @@ def test_h100_profile_preserves_protocol_and_records_execution_options(suite): assert changed[key] == original[key] options = changed['options'] if original['method'].endswith('-adapter'): - assert options['raw_cache_device'] == 'model' + assert options['raw_cache_device'] == 'cpu' and options['raw_cache_granularity'] == 'row' assert options['row_batch_size'] == options['backend_batch_size'] == 16 - assert options['cache_bytes'] == 4 * 2**30 and options['raw_cache_bytes'] == 2 * 2**30 + assert options['cache_bytes'] == 512 * 2**20 and options['raw_cache_bytes'] == 24 * 2**30 assert options['beam_size'] == original['options']['beam_size'] - assert options['relation_cache_mb'] == 256 and options['projection_cache_mb'] == 512 else: assert changed == original override = prepare_manifest(paths, hardware_profile='h100', kgfm_batch_size=8, **settings) @@ -51,7 +50,7 @@ def test_hardware_profile_cli_and_container_forwarding(tmp_path, capsys, suite): cli.main([suite, 'evaluate', '--split', 'test', '--hardware-profile', 'h100', '--kgfm-batch-size', '16', '--methods', 'ultra-adapter', '--output', str(output), '--dry-run']) entries = json.loads(capsys.readouterr().out)['entries'] - assert all(e['options']['backend_batch_size'] == 16 and e['options']['raw_cache_device'] == 'model' for e in entries) + assert all(e['options']['backend_batch_size'] == 16 and e['options']['raw_cache_granularity'] == 'row' for e in entries) common = ['--input-root', str(tmp_path), '--output', str(output), *IMAGE] flags = ['--hardware-profile', 'h100', '--kgfm-batch-size', '16'] cli.main([suite, 'prepare', *common, *flags]) diff --git a/benchmarks/plus_h/kgfm_adapters.json b/benchmarks/plus_h/kgfm_adapters.json index 7b3f31e76..0d140d782 100644 --- a/benchmarks/plus_h/kgfm_adapters.json +++ b/benchmarks/plus_h/kgfm_adapters.json @@ -16,10 +16,10 @@ "recipes": [ { "defaults": { - "id": "ultra-product-14type-{dataset}", + "id": "ultra-product-intersections-{dataset}", "method": "ultra-adapter", "checkpoint": "checkpoints/ultra_3g.pth", - "adapters": {"product": "benchmarks/adapters/ultra_product_14types.json"}, + "adapters": {"product": "benchmarks/adapters/ultra_product_intersections.json"}, "options": {"beam_size": 64, "row_batch_size": 8, "backend_batch_size": 8, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, "operators": { "1p": "product", @@ -45,10 +45,11 @@ "query_batch_size": 16, "query_order": "relation", "reference": { - "status": "frozen shared 14-type recipe; verification pending", + "status": "frozen shared 2-type recipe; verification pending", "notes": [ - "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; all 14 source query types; product t-norm; k=64.", - "One shared recipe across both backbones and all three datasets. +H validation screening informed recipe selection; this is not target-untuned zero-shot selection.", + "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; trained on 2i and 3i source queries; product t-norm; k=64.", + "Training graphs: FB15k237, WN18RR and CoDExMedium; checkpoint selection uses reserved source validation. No target test labels select this recipe.", + "One shared recipe across both backbones and both suites, selected on validation queries of both suites; this is not target-untuned zero-shot selection.", "The 4p and 4i types were not included in adapter training.", "Paired learned/identity calibration: alpha=1 and beta=0 in the control; retain observed facts, normalization, query plan, operators and beam width. Share exact atomic batches through a bounded 2 GiB CPU cache; split the 512 MiB calibrated cache equally." ] @@ -61,10 +62,10 @@ }, { "defaults": { - "id": "trix-product-14type-{dataset}", + "id": "trix-product-intersections-{dataset}", "method": "trix-adapter", "checkpoint": "checkpoints/trix/entity_prediction.pth", - "adapters": {"product": "benchmarks/adapters/trix_product_14types.json"}, + "adapters": {"product": "benchmarks/adapters/trix_product_intersections.json"}, "options": {"beam_size": 64, "row_batch_size": 1, "backend_batch_size": 1, "cache_bytes": 536870912, "raw_cache_bytes": 2147483648}, "operators": { "1p": "product", @@ -90,10 +91,11 @@ "query_batch_size": 16, "query_order": "relation", "reference": { - "status": "frozen shared 14-type recipe; verification pending", + "status": "frozen shared 2-type recipe; verification pending", "notes": [ - "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; all 14 source query types; product t-norm; k=64.", - "One shared recipe across both backbones and all three datasets. +H validation screening informed recipe selection; this is not target-untuned zero-shot selection.", + "Linear score-aware adapter, observed facts, bias bound 8, scale bound 2; trained on 2i and 3i source queries; product t-norm; k=64.", + "Training graphs: FB15k237, WN18RR and CoDExMedium; checkpoint selection uses reserved source validation. No target test labels select this recipe.", + "One shared recipe across both backbones and both suites, selected on validation queries of both suites; this is not target-untuned zero-shot selection.", "The 4p and 4i types were not included in adapter training.", "Paired learned/identity calibration: alpha=1 and beta=0 in the control; retain observed facts, normalization, query plan, operators and beam width. Share exact atomic batches through a bounded 2 GiB CPU cache; split the 512 MiB calibrated cache equally." ] diff --git a/benchmarks/ultraquery/kgfm_adapters.json b/benchmarks/ultraquery/kgfm_adapters.json index 0d6f5001d..115926223 100644 --- a/benchmarks/ultraquery/kgfm_adapters.json +++ b/benchmarks/ultraquery/kgfm_adapters.json @@ -44,7 +44,7 @@ "Training graphs: FB15k237, WN18RR and CoDExMedium. No target test labels select these recipes.", "Backbone parity is checked separately; per-run KGFM evidence verifies adapter/composition against independently captured atomic logits.", "Adapter training uses only 2i and 3i; checkpoint selection uses reserved source validation.", - "Recipe inclusion is informed by the 23-dataset UltraQuery validation sweep (50 sampled queries/type), not target-untuned model selection." + "One shared recipe across both backbones and both suites, selected on validation queries of both suites; this is not target-untuned zero-shot selection." ] }, "blockers": [], @@ -111,7 +111,7 @@ "Training graphs: FB15k237, WN18RR and CoDExMedium. No target test labels select these recipes.", "Backbone parity is checked separately; per-run KGFM evidence verifies adapter/composition against independently captured atomic logits.", "Adapter training uses only 2i and 3i; checkpoint selection uses reserved source validation.", - "Recipe inclusion is informed by the 23-dataset UltraQuery validation sweep (50 sampled queries/type), not target-untuned model selection." + "One shared recipe across both backbones and both suites, selected on validation queries of both suites; this is not target-untuned zero-shot selection." ] }, "blockers": [], From 731fcb9719b5a8d3bf07fe72e0f845cfcbc6459d Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:33:22 +0200 Subject: [PATCH 14/39] feat(benchmarks): resume KGFM verification from passing integration checks verify now reuses a passing integration check of an unchanged ULTRA/TRIX entry (same entry, inputs and source), so an interrupted verification resumes and the checks can run as separate jobs. An incomplete check still requires a fresh directory. --- benchmarks/cqa/README.md | 4 ++- benchmarks/cqa/cli.py | 13 ++++++-- benchmarks/cqa/study.py | 10 ++++++ benchmarks/cqa/tests/test_adapter_pairs.py | 39 +++++++++++++++++++++- 4 files changed, 61 insertions(+), 5 deletions(-) diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index bec288dc2..bb1176c2d 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -126,7 +126,9 @@ The exporter imports no DICE code. Acceptance needs scores within tolerance and identical candidate order and ties for every query. ULTRA/TRIX entries need no oracle: an independent implementation checks calibration, pruning, composition and identity controls on captured backbone logits; the backbones' own parity is -tested separately. Evidence binds inputs, query batches, source, image and +tested separately. A passing check of an unchanged ULTRA/TRIX entry is reused, +so an interrupted `verify` resumes; an incomplete check must be removed from +`STUDY/verification` first. Evidence binds inputs, query batches, source, image and hardware; a change to any of them needs a new study. For the bounded profile, `--comparison-references` additionally compares CQD with dense oracles. diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 832465f67..618985b51 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -351,8 +351,12 @@ def prepare(parser, args): def verify(parser, args): - """Run every entry's parity check in a fresh process, then freeze the passing evidence.""" - from .study import freeze, verify_bundle + """Run every entry's parity check in a fresh process, then freeze the passing evidence. + + A passing KGFM integration check of an unchanged entry is reused, so an + interrupted verification resumes and checks can run as separate jobs. + """ + from .study import freeze, integration_passed, verify_bundle study, root = args.output.resolve(), args.input_root.resolve() if (study / 'verified-bundle' / 'bundle.json').exists(): raise ValueError('A verified bundle already exists; use a new output directory for new evidence') @@ -360,13 +364,16 @@ def verify(parser, args): if args.study_path is None and not study.is_relative_to(root): raise ValueError('The study directory must be below --input-root, where evidence paths are recorded') relative = Path(args.study_path) if args.study_path is not None else study.relative_to(root) - manifest = verify_bundle(study / 'bundle', root)['manifest'] + bundle = verify_bundle(study / 'bundle', root) + manifest = bundle['manifest'] jobs = [] for entry in manifest['entries']: common = [sys.executable, '-u', '-m', 'benchmarks.cqa', args.suite] options = ['--bundle', str(study / 'bundle'), '--input-root', str(root), '--entry', entry['id'], '--device', args.device] if entry['method'].endswith('-adapter'): target = study / 'verification' / entry['id'] + if integration_passed(target / 'integration.json', bundle, entry): + continue if (target / 'pilot').exists(): raise ValueError(f'KGFM verification requires a fresh directory: {target}') jobs.append((entry['id'], [*common, 'integration', *options, '--output', str(target)])) diff --git a/benchmarks/cqa/study.py b/benchmarks/cqa/study.py index f730404f7..06049ff16 100644 --- a/benchmarks/cqa/study.py +++ b/benchmarks/cqa/study.py @@ -330,3 +330,13 @@ def entry_inputs_identity(bundle, entry): selected.add(entry['training']) prefix = str(Path(bundle['manifest']['data_root']) / dataset_spec(entry['dataset'])[1]) + '/' return fingerprint({key: value for key, value in bundle['files'].items() if key in selected or key.startswith(prefix)}) + + +def integration_passed(path, bundle, entry): + """Whether ``path`` holds a passing KGFM integration check of this frozen entry, inputs and source.""" + if not Path(path).is_file(): + return False + evidence = read(path) + return bool(evidence.get('passed') and evidence.get('source_sha256') == bundle['source_sha256'] + and evidence.get('entry_sha256') == fingerprint({k: v for k, v in entry.items() if k != 'verification'}) + and evidence.get('inputs_sha256') == entry_inputs_identity(bundle, entry)) diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index 3fa8dee4f..6ca073062 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -9,7 +9,7 @@ from benchmarks.cqa import cli from benchmarks.cqa.manifests import REPO, suite_directory from benchmarks.cqa.reports import adapter_effects, export_reports, trace_queries -from benchmarks.cqa.study import freeze, read, run_job, write_json +from benchmarks.cqa.study import freeze, integration_passed, read, run_job, verify_bundle, write_json from benchmarks.cqa.tests.test_protocol import paper_fixture, small_data, use_ultraquery_fixture from dicee.query_answering.benchmark import evaluate_benchmark from dicee.query_answering.context import state_fingerprint @@ -185,6 +185,43 @@ def test_paired_kgfm_verification_full_run_and_reports(tmp_path, backbone, facts run_job(tmp_path / 'verified-bundle', entry['id'], tmp_path, tmp_path / 'test', phase='test') +def test_verify_reuses_passing_integration_checks_and_rejects_partial_ones(tmp_path, monkeypatch, capsys): + from dicee.models import ULTRA + from dicee.query_answering.score_adapter import QueryScoreAdapter + manifest = paper_fixture(tmp_path) + model = ULTRA(dict(num_entities=1, num_relations=1)) + torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + QueryScoreAdapter('context_scores', 1., bias_bound=8., weights=torch.full((2, 8), .1, dtype=torch.float64), + metadata={'backbone_state_sha256': state_fingerprint(model)}).save(tmp_path / 'adapter.json') + entry = manifest['entries'][0] + entry.update(id='ultra-paired', method='ultra-adapter', checkpoint='kgfm.pt', + options={'beam_size': 2, 'row_batch_size': 1, 'backend_batch_size': 1, 'cache_bytes': 4096, 'raw_cache_bytes': 4096}, + adapters={'product': 'adapter.json'}, operators={shape: 'product' for shape in entry['query_types']}, + selection_protocol='source-validation', finalized=True, adapter_ablation=True, + query_batch_size=4, query_order='relation') + manifest['entries'] = [entry] + study = tmp_path / 'study' + freeze(manifest, study / 'bundle', tmp_path) + target = study / 'verification' / entry['id'] + # The check verify would run, launched as a separate job. + subprocess.run([sys.executable, '-m', 'benchmarks.cqa', 'plus_h', 'integration', '--bundle', str(study / 'bundle'), + '--input-root', str(tmp_path), '--entry', entry['id'], '--output', str(target), '--device', 'cpu'], + check=True, cwd=REPO) + bundle = verify_bundle(study / 'bundle', tmp_path) + assert integration_passed(target / 'integration.json', bundle, entry) + assert not integration_passed(target / 'integration.json', bundle, dict(entry, options=dict(entry['options'], beam_size=3))) + args = ['plus_h', 'verify', '--input-root', str(tmp_path), '--output', str(study), '--device', 'cpu'] + (target / 'integration.json').rename(tmp_path / 'integration.json') + with pytest.raises(SystemExit): + cli.main(args) + assert 'KGFM verification requires a fresh directory' in capsys.readouterr().err + (tmp_path / 'integration.json').rename(target / 'integration.json') + monkeypatch.setattr(cli.subprocess, 'run', lambda command: pytest.fail('A passing check was run again')) + cli.main(args) + assert read(study / 'verified-manifest.json')['entries'][0]['verification'] == 'study/evidence/ultra-paired.json' + assert read(study / 'evidence/ultra-paired.json') == read(target / 'integration.json') + + def test_graph_effects_pair_calibrations_and_reject_changed_recipes(tmp_path): from dataclasses import replace From 3f8cc62c509372e78780e98b026e8c6535457e63 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 14:58:40 +0200 Subject: [PATCH 15/39] feat(benchmarks): setup pins and downloads the ULTRA 4g and 50g checkpoints setup now pins and downloads the ULTRA 4g and 50g checkpoints from the pinned ULTRA tree. --- benchmarks/cqa/inputs.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/benchmarks/cqa/inputs.py b/benchmarks/cqa/inputs.py index acfb42fa5..5a8fcaee2 100644 --- a/benchmarks/cqa/inputs.py +++ b/benchmarks/cqa/inputs.py @@ -24,7 +24,7 @@ 'EccKx4K6sZ1Nhy_fJTL8L44BFtpNRZwmI43-ffPRSmb28g?e=kO5dYk&download=1') MODEL_PREFIX = 'checkpoints/query-baselines/' # SHA-256 of the released files, extracted from the archive pinned in the +H -# manifests. The three standalone weights are from the pinned ULTRA/TRIX trees. +# manifests. The standalone weights are from the pinned ULTRA/TRIX trees. WEIGHT_HASHES = { 'Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth': '9b6dc20801c35e7c9ebe65764acb4ed9cb5bffc6b0a0a727bd48935589e9388d', 'checkpoints/query-baselines/iscqa-compl-models/models/CLMPT/CLMPT-fb15k237.ckpt': '4ce1e2abeda74199970c9350e3da10d928d34f974f3c1f42ead553a9c13799b9', @@ -41,6 +41,8 @@ 'checkpoints/query-baselines/iscqa-compl-models/models/GNN-QE/model/model_NELL995.pth': '086619b977d7b45658c11b4804b6e0e1c92a356cd4f427b4bf5b8ea1ee7016b3', 'checkpoints/trix/entity_prediction.pth': '8f6e7266093c2d15ad88d41e9825e4b327171143543cf060cfee907d9a890342', 'checkpoints/ultra_3g.pth': 'fdedc01b0045fc089d2ad5da08569466b7b221691fe978a18e91082bbb133c18', + 'checkpoints/ultra_4g.pth': '48a046e708adf5632d87c30eacae01f5f51466b2301effdc2cb42358d22854e0', + 'checkpoints/ultra_50g.pth': 'f1c5377b2cf547aaa67520ffb6fce27b75b6eb3417b86dc9cf9dba89964ed10f', } @@ -49,6 +51,8 @@ def weight_urls(): for repository, commit in (catalog().ULTRA, catalog().TRIX)) return {'Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth': f'{ultra}/ckpts/ultraquery.pth', 'checkpoints/ultra_3g.pth': f'{ultra}/ckpts/ultra_3g.pth', + 'checkpoints/ultra_4g.pth': f'{ultra}/ckpts/ultra_4g.pth', + 'checkpoints/ultra_50g.pth': f'{ultra}/ckpts/ultra_50g.pth', 'checkpoints/trix/entity_prediction.pth': f'{trix}/entity_prediction.pth'} From a2cad925532b02289b8a683cd383c63d703e913f Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sat, 3 Oct 2026 15:14:01 +0200 Subject: [PATCH 16/39] fix(benchmarks): resolve the harness path in the study source identity code_identity resolved the checkout root but not the harness directory, so study commands failed when the code was imported through a symlinked path (for example a home directory mounted under another prefix). --- benchmarks/cqa/study.py | 2 +- benchmarks/cqa/tests/test_protocol.py | 11 ++++++++++- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/benchmarks/cqa/study.py b/benchmarks/cqa/study.py index 06049ff16..036d3d837 100644 --- a/benchmarks/cqa/study.py +++ b/benchmarks/cqa/study.py @@ -37,7 +37,7 @@ def code_identity(): The dicee package without its command-line scripts, and this harness without tests or paper tooling, so local scripts never break verification elsewhere. """ - package, harness = SOURCE_ROOT / 'dicee', Path(__file__).parent + package, harness = SOURCE_ROOT / 'dicee', Path(__file__).resolve().parent paths = [path for path in package.rglob('*.py') if path.relative_to(package).parts[0] != 'scripts'] paths += [path for path in harness.rglob('*.py') if path.relative_to(harness).parts[0] not in ('tests', 'paper')] return source_fingerprint(paths, SOURCE_ROOT) diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py index 71531c007..fb54ec547 100644 --- a/benchmarks/cqa/tests/test_protocol.py +++ b/benchmarks/cqa/tests/test_protocol.py @@ -15,7 +15,7 @@ from benchmarks.cqa.oracles import verify_predictions from benchmarks.cqa.reports import export_reports, summarize_trace, trace_queries -from benchmarks.cqa.study import freeze, read, run_job, verify_bundle +from benchmarks.cqa.study import SOURCE_ROOT, code_identity, freeze, read, run_job, verify_bundle from dicee.query_answering import BenchmarkQuery, QueryBenchmark, QueryContext from dicee.query_answering._checkpoint import BenchmarkCheckpoint, write_json from dicee.query_answering._query import PLUS_H_SHAPES, QUERY_SHAPES @@ -68,6 +68,15 @@ def small_data(): return QueryBenchmark('test', 'transductive', 'valid', QueryContext([(0, 0, 1)], 6, 1), queries, tuple(range(6))) +def test_source_identity_is_the_same_through_a_symlinked_checkout(tmp_path): + """A checkout imported through a symlink (for example a mounted home) keeps its source identity.""" + link = tmp_path / 'checkout' + link.symlink_to(SOURCE_ROOT, target_is_directory=True) + linked = subprocess.run([sys.executable, '-c', 'from benchmarks.cqa.study import code_identity; print(code_identity())'], + cwd=tmp_path, env=dict(os.environ, PYTHONPATH=str(link)), capture_output=True, text=True, check=True) + assert linked.stdout.strip() == code_identity() + + def test_resume_preserves_completed_cache_report_and_resets_live_cache(tmp_path): data, stats = small_data(), {} options = dict(checkpoint_dir=tmp_path / 'resume', checkpoint_identity='fixed', checkpoint_every=3) From 6c174dcf14c0e71f8d07bfc1e198da1dc323333a Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sun, 4 Oct 2026 12:43:34 +0200 Subject: [PATCH 17/39] perf(benchmarks): parallel reports that read each rank trace once report --workers N summarizes the rank traces and computes the paired, graph, filter and suite effects in N processes. Suite effects read each dataset's traces once for the seed mean and every single seed, instead of once per seed, and all datasets of all comparisons run together. Every bootstrap seeds its own generator, so the outputs are byte-identical for any number of workers. --- benchmarks/cqa/cli.py | 6 +- benchmarks/cqa/reports.py | 217 +++++++++++++-------- benchmarks/cqa/tests/test_adapter_pairs.py | 31 +++ 3 files changed, 173 insertions(+), 81 deletions(-) diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 618985b51..7c08fde85 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -133,6 +133,7 @@ def parallel(p): p.add_argument('--published', type=Path, help="Published scores (default: the suite's published_results.json)") p.add_argument('--bootstrap-samples', type=int, default=2000) p.add_argument('--seed', type=int, default=0) + p.add_argument('--workers', type=int, default=1, help='Processes for traces and effects; results do not depend on it') container(p) p = command('difficulty-report', 'Answer-level difficulty from completed frozen rank traces; CPU only') @@ -432,7 +433,8 @@ def report(parser, args): from .reports import export_reports published = args.published or suite_directory(args.suite) / 'published_results.json' rows = export_reports(args.results, published if published.is_file() else None, args.output, - bootstrap_samples=args.bootstrap_samples, seed=args.seed, title=SUITES[args.suite]['title']) + bootstrap_samples=args.bootstrap_samples, seed=args.seed, title=SUITES[args.suite]['title'], + workers=args.workers) print(json.dumps(dict(results=len(rows), output=str(args.output)))) @@ -482,7 +484,7 @@ def main(argv=None): command.error('--gpus needs distinct devices and --workers-per-gpu a positive count') if args.device not in ('cuda', 'cuda:0'): command.error('With --gpus, use --device cuda; each worker sees only its assigned GPU') - for name in ('kgfm_batch_size', 'max_queries_per_shape', 'pilot_queries', 'bootstrap_samples', 'probes'): + for name in ('kgfm_batch_size', 'max_queries_per_shape', 'pilot_queries', 'bootstrap_samples', 'probes', 'workers'): if getattr(args, name, None) is not None and getattr(args, name) < (0 if name == 'bootstrap_samples' else 1): command.error(f'--{name.replace("_", "-")} must be positive') try: diff --git a/benchmarks/cqa/reports.py b/benchmarks/cqa/reports.py index 8211cb078..2f03cbd52 100644 --- a/benchmarks/cqa/reports.py +++ b/benchmarks/cqa/reports.py @@ -3,14 +3,18 @@ import csv import json import math +import multiprocessing import re import sqlite3 from collections import defaultdict +from concurrent.futures import ProcessPoolExecutor +from contextlib import contextmanager +from functools import partial from pathlib import Path import numpy as np -from dicee.query_answering._checkpoint import write_json +from dicee.query_answering._checkpoint import checksum, read, write_json from dicee.query_answering._query import PLUS_H_SHAPES from dicee.query_answering.benchmark import METRICS, _averages from dicee.query_answering.datasets import query_types_for_dataset @@ -96,28 +100,65 @@ def adapter_effects(learned_trace, control_trace, *, bootstrap_samples=2000, see resamples=bootstrap_samples, seed=seed, scope='Conditional on frozen models and adapters; not training-seed uncertainty.')) -def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0, title='CQA benchmark'): - """Compare matching coverage only; partial means never become full-suite means.""" - from dicee.query_answering._checkpoint import checksum, read +@contextmanager +def parallel(workers=1): + """``starmap(function, argument_tuples)``: results in order, computed in up to ``workers`` processes. + + Every bootstrap seeds its own generator, so results do not depend on the number of workers. + """ + if type(workers) is not int or workers < 1: + raise ValueError('Use a positive number of workers') + if workers == 1: + yield lambda function, calls: [function(*arguments) for arguments in calls] + return + with ProcessPoolExecutor(workers, mp_context=multiprocessing.get_context('spawn')) as pool: + yield lambda function, calls: [future.result() for future in [pool.submit(function, *arguments) for arguments in calls]] + + +def offline_summary(path, bootstrap_samples=2000, seed=0): + """(result, expected types, offline summary) of one saved run after checking its rank trace; None for other files.""" + report = read(path) + if report.get('benchmark_run', report.get('paper_run')) is None: + return None + trace = Path(path).parent / 'ranks.sqlite3' + if checksum(trace) != report['rank_trace_sha256']: + raise ValueError(f'Rank trace checksum mismatch: {trace}') + expected_types = report.get('dataset_metadata', {}).get('expected_query_types') + if expected_types is None: + expected_types = query_types_for_dataset(report['dataset']) + summary = summarize_trace(trace, bootstrap_samples=bootstrap_samples, seed=seed, expected_types=expected_types) + for shape, values in summary['per_shape'].items(): + for policy in ('sort', 'expected'): + online = report['per_shape'][shape] if policy == 'sort' else report['additional_tie_metrics'][policy]['per_shape'][shape] + if any(not math.isclose(online[metric], values[policy][metric], abs_tol=1e-11) for metric in METRICS): + raise ValueError(f'Offline rank metrics differ from evaluation: {path}') + return report, expected_types, summary + + +def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0, title='CQA benchmark', workers=1): + """Compare matching coverage only; partial means never become full-suite means. + + ``workers`` processes summarize traces and compute effects; the outputs do not depend on it. + """ + with parallel(workers) as starmap: + return _export_reports(results, published, output, bootstrap_samples=bootstrap_samples, seed=seed, title=title, + starmap=starmap) + + +def _trace(detail): + return Path(detail['result']).parent / 'ranks.sqlite3' + + +def _export_reports(results, published, output, *, bootstrap_samples, seed, title, starmap): published = read(published) if published is not None else {'source': None, 'datasets': {}} rows, details = [], [] - for path in sorted(Path(results).rglob('result.json')): - report = read(path) - run = report.get('benchmark_run', report.get('paper_run')) - if run is None: + paths = sorted(Path(results).rglob('result.json')) + effect = partial(adapter_effects, bootstrap_samples=bootstrap_samples, seed=seed) + for path, saved in zip(paths, starmap(offline_summary, [(path, bootstrap_samples, seed) for path in paths])): + if saved is None: continue - trace = path.parent / 'ranks.sqlite3' - if checksum(trace) != report['rank_trace_sha256']: - raise ValueError(f'Rank trace checksum mismatch: {trace}') - expected_types = report.get('dataset_metadata', {}).get('expected_query_types') - if expected_types is None: - expected_types = query_types_for_dataset(report['dataset']) - summary = summarize_trace(trace, bootstrap_samples=bootstrap_samples, seed=seed, expected_types=expected_types) - for shape, values in summary['per_shape'].items(): - for policy in ('sort', 'expected'): - online = report['per_shape'][shape] if policy == 'sort' else report['additional_tie_metrics'][policy]['per_shape'][shape] - if any(not math.isclose(online[metric], values[policy][metric], abs_tol=1e-11) for metric in METRICS): - raise ValueError(f'Offline rank metrics differ from evaluation: {path}') + report, expected_types, summary = saved + run = report.get('benchmark_run', report.get('paper_run')) method = report['inference']['method'] scores = published['datasets'].get(report['dataset'], {}).get(method, {}) coverage = summary['all_benchmark_types'] and report['protocol']['full_split'] and report['split'] == 'test' @@ -168,17 +209,12 @@ def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0 f'{row["sort_mrr"]:.2f} | {row["expected_random_mrr"]:.2f} | {row["tie_delta"]:+.2f} |') (output / 'comparison.md').write_text('\n'.join(lines) + '\n') lookup = {row['id']: row for row in details} - pairs = [] - for control in details: - if control['paired_with'] not in lookup: - continue - learned = lookup[control['paired_with']] - effect = adapter_effects(Path(learned['result']).parent / 'ranks.sqlite3', - Path(control['result']).parent / 'ranks.sqlite3', - bootstrap_samples=bootstrap_samples, seed=seed) - if learned['answer_filter'] != control['answer_filter']: - raise ValueError('Adapter comparison changed answer filters') - pairs.append(dict(learned=learned['id'], control=control['id'], dataset=control['dataset'], answer_filter=control['answer_filter'], **effect)) + controls = [control for control in details if control['paired_with'] in lookup] + if any(lookup[control['paired_with']]['answer_filter'] != control['answer_filter'] for control in controls): + raise ValueError('Adapter comparison changed answer filters') + effects = starmap(effect, [(_trace(lookup[control['paired_with']]), _trace(control)) for control in controls]) + pairs = [dict(learned=control['paired_with'], control=control['id'], dataset=control['dataset'], + answer_filter=control['answer_filter'], **values) for control, values in zip(controls, effects)] write_json(output / 'adapter-effects.json', pairs) lines = ['# Learned adapter effect', '', 'Learned minus identity calibration, MRR ×100. Observed facts, query plans, operators and beams are held fixed.', '', @@ -203,18 +239,14 @@ def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0 if detail['inference_graph'] in group: raise ValueError('Duplicate graph-ablation condition') group[detail['inference_graph']] = detail - graph_pairs = [] - for group in groups.values(): - if set(group) != {'train', 'train+valid'}: - continue - train, extended = group['train'], group['train+valid'] - if not train['graph_recipe_sha256'] or train['graph_recipe_sha256'] != extended['graph_recipe_sha256']: + complete = [group for group in groups.values() if set(group) == {'train', 'train+valid'}] + for group in complete: + if not group['train']['graph_recipe_sha256'] or group['train']['graph_recipe_sha256'] != group['train+valid']['graph_recipe_sha256']: raise ValueError('Graph ablation changed model, adapter, operators, beam, or query settings') - effect = adapter_effects(Path(extended['result']).parent / 'ranks.sqlite3', - Path(train['result']).parent / 'ranks.sqlite3', - bootstrap_samples=bootstrap_samples, seed=seed) - graph_pairs.append(dict(train=train['id'], train_valid=extended['id'], dataset=train['dataset'], - calibration=train['calibration'], answer_filter=train['answer_filter'], **effect)) + effects = starmap(effect, [(_trace(group['train+valid']), _trace(group['train'])) for group in complete]) + graph_pairs = [dict(train=group['train']['id'], train_valid=group['train+valid']['id'], dataset=group['train']['dataset'], + calibration=group['train']['calibration'], answer_filter=group['train']['answer_filter'], **values) + for group, values in zip(complete, effects)] write_json(output / 'graph-effects.json', graph_pairs) lines = ['# Inference graph effect', '', 'Train+valid minus train, MRR ×100. Checkpoints, operators, queries and answer-filter policy are fixed.', '', @@ -232,17 +264,13 @@ def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0 writer.writerow([pair['train'], pair['train_valid'], pair['dataset'], shape, row['queries'], row['sort']['mrr'] * 100, row['expected']['mrr'] * 100]) (output / 'graph-effects.md').write_text('\n'.join(lines) + '\n') - filter_pairs = [] - for control in details: - if control['filter_paired_with'] not in lookup: - continue - corrected = lookup[control['filter_paired_with']] - if (corrected['answer_filter'], control['answer_filter']) != ('corrected', 'released'): - raise ValueError('Invalid corrected/released filter comparison') - effect = adapter_effects(Path(corrected['result']).parent / 'ranks.sqlite3', - Path(control['result']).parent / 'ranks.sqlite3', - bootstrap_samples=bootstrap_samples, seed=seed) - filter_pairs.append(dict(corrected=corrected['id'], released=control['id'], dataset=control['dataset'], **effect)) + released = [control for control in details if control['filter_paired_with'] in lookup] + if any((lookup[control['filter_paired_with']]['answer_filter'], control['answer_filter']) != ('corrected', 'released') + for control in released): + raise ValueError('Invalid corrected/released filter comparison') + effects = starmap(effect, [(_trace(lookup[control['filter_paired_with']]), _trace(control)) for control in released]) + filter_pairs = [dict(corrected=control['filter_paired_with'], released=control['id'], dataset=control['dataset'], **values) + for control, values in zip(released, effects)] write_json(output / 'filter-effects.json', filter_pairs) lines = ['# Answer-filter effect', '', 'Corrected minus released filters, MRR ×100. Predictions and released hard targets are identical.', '', @@ -262,9 +290,9 @@ def export_reports(results, published, output, *, bootstrap_samples=2000, seed=0 (output / 'filter-effects.md').write_text('\n'.join(lines) + '\n') records = [dict(id=row['id'], dataset=row['dataset'], method=row['method'], calibration=detail['calibration'], paired_with=detail['paired_with'], complete=row['complete_test'], answer_filter=detail['answer_filter'], - trace=Path(detail['result']).parent / 'ranks.sqlite3') + trace=_trace(detail)) for row, detail in zip(rows, details)] - effects = suite_effects(records, bootstrap_samples=bootstrap_samples, seed=seed) + effects = suite_effects(records, bootstrap_samples=bootstrap_samples, seed=seed, starmap=starmap) write_json(output / 'suite-effects.json', effects) lines = ['# Suite-level paired effects', '', 'Treatment minus baseline, MRR ×100, equal weight per query type within a dataset and per dataset within ' @@ -294,8 +322,17 @@ def paired_strata(treatments, baseline): Every trace must cover the same queries with the same types and hard-answer counts. """ + return dataset_strata(treatments, baseline)[0] + + +def dataset_strata(treatments, baseline, singles=False): + """paired_strata of the treatments and, with ``singles``, of each treatment alone; every trace is read once.""" reference = query_scores(baseline) scores = [query_scores(path) for path in treatments] + return _strata(scores, reference, baseline), [_strata([s], reference, baseline) for s in scores] if singles else [] + + +def _strata(scores, reference, baseline): if any(set(s) != set(reference) for s in scores) or not reference: raise ValueError(f'Suite comparison needs identical nonempty query coverage: {baseline}') strata = defaultdict(list) @@ -340,6 +377,21 @@ def macro_effects(by_dataset, groups, *, bootstrap_samples=2000, seed=0): return output +NEGATION = frozenset(s for s in PLUS_H_SHAPES if 'n' in s) + + +def any_type(shape): + return True + + +def epfo_type(shape): + return shape not in NEGATION + + +def negation_type(shape): + return shape in NEGATION + + # A run ID is method and recipe, an optional -seedN tag of the adapter training seed, the dataset, and the suffixes # of paired controls and evaluation conditions. SEED = re.compile(r'-seed(\d+)(?=-|$)') @@ -362,18 +414,19 @@ def system_of(record): return (record['method'], identity_run(record), recipe), int(match.group(1)) if match else 0 -def suite_effects(records, *, bootstrap_samples=2000, seed=0): +def suite_effects(records, *, bootstrap_samples=2000, seed=0, starmap=None): """Suite-level paired effects of every adapter recipe: against its no-adapter control and against UltraQuery. Seed replicates (entry IDs differing only by -seedN) are averaged per query; the control, which identity calibration makes independent of the adapter seed, is its lowest seed tag. Only complete test runs with corrected (+H) or released (UltraQuery) filters are compared. + ``starmap`` (see ``parallel``) computes the per-dataset strata and the bootstraps. """ from dicee.query_answering.catalog import BENCHMARK_DATASETS, PLUS_H_DATASETS, dataset_spec + starmap = starmap or (lambda function, calls: [function(*arguments) for arguments in calls]) suites = {'ultraquery': [d for d in BENCHMARK_DATASETS if dataset_spec(d)[0] in ('transductive', 'inductive-e', 'inductive-er')], 'plus_h': list(PLUS_H_DATASETS)} - negation = {s for s in PLUS_H_SHAPES if 'n' in s} systems = defaultdict(lambda: defaultdict(dict)) for record in records: target_filter = 'corrected' if record['dataset'] in PLUS_H_DATASETS else 'released' @@ -381,7 +434,7 @@ def suite_effects(records, *, bootstrap_samples=2000, seed=0): continue system, tag = system_of(record) systems[system][record['dataset']][tag] = record['trace'] - output = [] + plans = [] for (method, identity, recipe), runs in sorted(systems.items()): if identity or not method.endswith('-adapter'): continue @@ -391,10 +444,9 @@ def suite_effects(records, *, bootstrap_samples=2000, seed=0): present = [d for d in datasets if d in runs] if not present: continue - families = {'all': (datasets, lambda s: True), 'epfo': (datasets, lambda s: s not in negation), - 'negation': (datasets, lambda s: s in negation)} + families = {'all': (datasets, any_type), 'epfo': (datasets, epfo_type), 'negation': (datasets, negation_type)} if suite == 'ultraquery': - families |= {family: ([d for d in datasets if dataset_spec(d)[0] == family], lambda s: True) + families |= {family: ([d for d in datasets if dataset_spec(d)[0] == family], any_type) for family in ('transductive', 'inductive-e', 'inductive-er')} seeds = sorted(set.intersection(*(set(runs[d]) for d in present))) for comparison, reference in (('adapter-minus-identity', control), ('adapter-minus-ultraquery', baseline), @@ -404,22 +456,29 @@ def suite_effects(records, *, bootstrap_samples=2000, seed=0): else: treatments = {d: [runs[d][tag] for tag in seeds] for d in present} shared = [d for d in present if d in reference and d in treatments and treatments[d]] - if not shared: - continue - base = {d: reference[d][min(reference[d])] for d in shared} - strata = {d: paired_strata(treatments[d], base[d]) for d in shared} - per_seed = [] - if comparison != 'identity-minus-ultraquery': - for tag in seeds: - single = {d: paired_strata([runs[d][tag]], base[d]) for d in shared} - values = macro_effects(single, families, bootstrap_samples=0) - per_seed.append(dict(seed_tag=tag, **{p: {g: v['delta'] for g, v in values[p].items()} for p in values})) - output.append(dict(comparison=comparison, method=method, recipe=recipe, suite=suite, - datasets=len(shared), complete_suite=len(shared) == len(datasets), - seed_tags=seeds if comparison != 'identity-minus-ultraquery' else [], - macro=macro_effects(strata, families, bootstrap_samples=bootstrap_samples, seed=seed), - per_seed=per_seed, - uncertainty=dict(unit='paired query', stratification='dataset x query type', - resamples=bootstrap_samples, seed=seed, - scope='Conditional on frozen models, adapters and the evaluated seeds.'))) + if shared: + plans.append(dict(comparison=comparison, method=method, recipe=recipe, suite=suite, datasets=datasets, + families=families, seeds=seeds, shared=shared, treatments=treatments, + base={d: reference[d][min(reference[d])] for d in shared})) + # Read every dataset's traces once, for all comparisons at the same time. + calls = [(plan['treatments'][d], plan['base'][d], plan['comparison'] != 'identity-minus-ultraquery') + for plan in plans for d in plan['shared']] + computed = iter(starmap(dataset_strata, calls)) + for plan in plans: + plan['strata'] = {d: next(computed) for d in plan['shared']} + macros = starmap(partial(macro_effects, bootstrap_samples=bootstrap_samples, seed=seed), + [({d: pooled for d, (pooled, _) in plan['strata'].items()}, plan['families']) for plan in plans]) + output = [] + for plan, macro in zip(plans, macros): + per_seed = [] + for index, tag in enumerate(plan['seeds'] if plan['comparison'] != 'identity-minus-ultraquery' else []): + values = macro_effects({d: singles[index] for d, (_, singles) in plan['strata'].items()}, plan['families'], bootstrap_samples=0) + per_seed.append(dict(seed_tag=tag, **{p: {g: v['delta'] for g, v in values[p].items()} for p in values})) + output.append(dict(comparison=plan['comparison'], method=plan['method'], recipe=plan['recipe'], suite=plan['suite'], + datasets=len(plan['shared']), complete_suite=len(plan['shared']) == len(plan['datasets']), + seed_tags=plan['seeds'] if plan['comparison'] != 'identity-minus-ultraquery' else [], + macro=macro, per_seed=per_seed, + uncertainty=dict(unit='paired query', stratification='dataset x query type', + resamples=bootstrap_samples, seed=seed, + scope='Conditional on frozen models, adapters and the evaluated seeds.'))) return output diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index 6ca073062..8f473a44f 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -252,6 +252,37 @@ def test_graph_effects_pair_calibrations_and_reject_changed_recipes(tmp_path): export_reports(results, None, tmp_path / 'invalid', bootstrap_samples=0) +def test_parallel_reports_are_byte_identical_to_sequential_reports(tmp_path): + from dataclasses import replace + + from dicee.query_answering.method_evaluation import save_results + + def scores(offset): + return lambda query: torch.rand(6, generator=torch.Generator().manual_seed(17 * query[0] + offset)) + + results = tmp_path / 'results' + for offset, graph in enumerate(('train', 'train+valid')): + data = replace(small_data(), name='FB15k237LogicalQuery', split='test', + metadata=dict(inference_graph=graph, expected_query_types=['1p'])) + destination = results / graph + report = evaluate_benchmark(data, scores(offset), comparison_predictors={'without-adapter': scores(5)}, + checkpoint_dir=destination / 'progress', checkpoint_identity={'fixture': graph}, + rank_trace_path=destination / 'ranks.sqlite3', additional_tie_policies=('expected',)) + report['inference'] = dict(method='ultra-adapter', calibration='learned') + report['comparisons']['without-adapter']['inference'] = dict(method='ultra-adapter', calibration='without-adapter') + save_results(report, destination, run=dict(entry=graph, phase='test'), + metadata=dict(reference={}, graph_ablation='paired', graph_recipe_sha256='same')) + export_reports(results, None, tmp_path / 'sequential', bootstrap_samples=50) + export_reports(results, None, tmp_path / 'parallel', bootstrap_samples=50, workers=3) + names = sorted(path.name for path in (tmp_path / 'sequential').iterdir()) + assert names == sorted(path.name for path in (tmp_path / 'parallel').iterdir()) + assert all((tmp_path / 'sequential' / name).read_bytes() == (tmp_path / 'parallel' / name).read_bytes() for name in names) + suite = read(tmp_path / 'parallel/suite-effects.json') + assert len(read(tmp_path / 'parallel/adapter-effects.json')) == 2 and len(suite) == 2 + low, high = suite[0]['macro']['sort']['all']['ci95'] + assert low < high + + def test_filter_controls_share_predictions_and_resume_all_traces(tmp_path, monkeypatch): from dataclasses import replace From c3212cb02824d503f58cb97d779b07468c4f63ec Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sun, 4 Oct 2026 14:07:06 +0200 Subject: [PATCH 18/39] feat(benchmarks): resume baseline verification from passing parity evidence verify now also reuses passing parity evidence of an unchanged baseline entry checked against the same oracles (and comparison oracle), so parity checks can run as separate guarded jobs and an interrupted verification resumes without repeating them. --- benchmarks/cqa/README.md | 7 +++--- benchmarks/cqa/cli.py | 14 ++++++++---- benchmarks/cqa/study.py | 10 ++++++++ benchmarks/cqa/tests/test_launcher.py | 33 ++++++++++++++++++++++++++- 4 files changed, 55 insertions(+), 9 deletions(-) diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index bb1176c2d..7ee9ab289 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -126,9 +126,10 @@ The exporter imports no DICE code. Acceptance needs scores within tolerance and identical candidate order and ties for every query. ULTRA/TRIX entries need no oracle: an independent implementation checks calibration, pruning, composition and identity controls on captured backbone logits; the backbones' own parity is -tested separately. A passing check of an unchanged ULTRA/TRIX entry is reused, -so an interrupted `verify` resumes; an incomplete check must be removed from -`STUDY/verification` first. Evidence binds inputs, query batches, source, image and +tested separately. Passing evidence of an unchanged entry is reused (an +ULTRA/TRIX integration check, or a parity check against the same oracles), so +an interrupted `verify` resumes and checks can run as separate jobs; an +incomplete ULTRA/TRIX check must be removed from `STUDY/verification` first. Evidence binds inputs, query batches, source, image and hardware; a change to any of them needs a new study. For the bounded profile, `--comparison-references` additionally compares CQD with dense oracles. diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 7c08fde85..764d83f3e 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -354,10 +354,11 @@ def prepare(parser, args): def verify(parser, args): """Run every entry's parity check in a fresh process, then freeze the passing evidence. - A passing KGFM integration check of an unchanged entry is reused, so an - interrupted verification resumes and checks can run as separate jobs. + Passing evidence of an unchanged entry (a KGFM integration check, or a + parity check against the same oracles) is reused, so an interrupted + verification resumes and checks can run as separate jobs. """ - from .study import freeze, integration_passed, verify_bundle + from .study import freeze, integration_passed, parity_passed, verify_bundle study, root = args.output.resolve(), args.input_root.resolve() if (study / 'verified-bundle' / 'bundle.json').exists(): raise ValueError('A verified bundle already exists; use a new output directory for new evidence') @@ -382,13 +383,16 @@ def verify(parser, args): reference = args.references / f'{entry["id"]}.pt' if args.references else None if reference is None or not reference.is_file(): raise ValueError(f'Missing baseline oracle {entry["id"]}.pt; pass --references') - command = [*common, 'parity', *options, '--reference', str(reference), '--output', str(study / 'evidence' / f'{entry["id"]}.json')] + evidence = study / 'evidence' / f'{entry["id"]}.json' + command = [*common, 'parity', *options, '--reference', str(reference), '--output', str(evidence)] + comparison = None if args.comparison_references and entry['method'] in ('cqd', 'cqd-hybrid'): comparison = args.comparison_references / f'{entry["id"]}.pt' if not comparison.is_file(): raise ValueError(f'Missing comparison oracle: {comparison}') command += ['--comparison-reference', str(comparison)] - jobs.append((entry['id'], command)) + if not parity_passed(evidence, bundle, entry, reference, comparison): + jobs.append((entry['id'], command)) for entry, command in jobs: print(json.dumps(dict(entry=entry, state='verifying')), flush=True) if subprocess.run(command).returncode: diff --git a/benchmarks/cqa/study.py b/benchmarks/cqa/study.py index 036d3d837..b628a3bb7 100644 --- a/benchmarks/cqa/study.py +++ b/benchmarks/cqa/study.py @@ -340,3 +340,13 @@ def integration_passed(path, bundle, entry): return bool(evidence.get('passed') and evidence.get('source_sha256') == bundle['source_sha256'] and evidence.get('entry_sha256') == fingerprint({k: v for k, v in entry.items() if k != 'verification'}) and evidence.get('inputs_sha256') == entry_inputs_identity(bundle, entry)) + + +def parity_passed(path, bundle, entry, reference, comparison_reference=None): + """Whether ``path`` holds passing parity evidence of this frozen entry, inputs and source against these oracles.""" + if not integration_passed(path, bundle, entry): + return False + evidence = read(path) + comparison = evidence.get('upstream_comparison', {}).get('reference_sha256') + return (evidence.get('reference_sha256') == checksum(reference) + and comparison == (checksum(comparison_reference) if comparison_reference is not None else None)) diff --git a/benchmarks/cqa/tests/test_launcher.py b/benchmarks/cqa/tests/test_launcher.py index 03080bec3..67ad88e0f 100644 --- a/benchmarks/cqa/tests/test_launcher.py +++ b/benchmarks/cqa/tests/test_launcher.py @@ -6,7 +6,7 @@ from benchmarks.cqa import cli from benchmarks.cqa.manifests import prepare_manifest, read_manifest, suite_directory, validate_entry -from benchmarks.cqa.study import freeze, read, run_job +from benchmarks.cqa.study import entry_inputs_identity, freeze, read, run_job, verify_bundle from benchmarks.cqa.tests.test_protocol import paper_fixture PUBLIC = suite_directory('plus_h') @@ -456,6 +456,37 @@ def parity(command): assert (study / 'verified-bundle/bundle.json').is_file() +def test_verification_reuses_passing_parity_evidence_for_the_same_oracle(tmp_path, monkeypatch): + from dicee.query_answering._checkpoint import checksum + from dicee.query_answering.context import fingerprint + study = tmp_path / 'study' + freeze(paper_fixture(tmp_path), study / 'bundle', tmp_path) + bundle = verify_bundle(study / 'bundle', tmp_path) + entry = bundle['manifest']['entries'][0] + references = tmp_path / 'references' + references.mkdir() + (references / f'{entry["id"]}.pt').write_bytes(b'oracle') + evidence = dict(passed=True, source_sha256=bundle['source_sha256'], inputs_sha256=entry_inputs_identity(bundle, entry), + entry_sha256=fingerprint({k: v for k, v in entry.items() if k != 'verification'}), + reference_sha256=checksum(references / f'{entry["id"]}.pt')) + cli.write_json(study / 'evidence' / f'{entry["id"]}.json', dict(evidence, reference_sha256='another oracle')) + commands = [] + + def parity(command): + commands.append(command) + cli.write_json(command[command.index('--output') + 1], evidence) + return subprocess.CompletedProcess(command, 0) + + monkeypatch.setattr(cli.subprocess, 'run', parity) + args = ['plus_h', 'verify', '--input-root', str(tmp_path), '--output', str(study), '--references', str(references)] + cli.main(args) + assert len(commands) == 1 + # Evidence for the same entry, inputs, source and oracle is reused. + (study / 'verified-bundle').rename(tmp_path / 'first-verified-bundle') + cli.main(args) + assert len(commands) == 1 and (study / 'verified-bundle/bundle.json').is_file() + + def test_container_rejects_retagged_image_before_launch(tmp_path, monkeypatch): from benchmarks.cqa import docker (tmp_path / 'container-image.json').write_text(json.dumps({'image_id': 'sha256:original'})) From a732303a6343dc3e0068aabb121a8d59278059b2 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sun, 4 Oct 2026 18:34:36 +0200 Subject: [PATCH 19/39] feat(benchmarks): verify CQD with CQD-A negation on its upstream-covered types The pinned +H CQD has no negation in its beam search, so oracles of CQD and CQD-Hybrid with CQD-A signed-atom negation cannot cover the five negated types. The exporter now declares exactly those types as exempt; verify accepts no other exemption, still evaluates the exempt queries, and records them as checked without an upstream reference (fixtures compare them with CQD-A outputs). --- benchmarks/cqa/README.md | 6 +- benchmarks/cqa/oracles.py | 27 ++++++++- benchmarks/cqa/tests/test_protocol.py | 60 +++++++++++++++++++ .../cqa/verification/export_reference.py | 19 +++++- 4 files changed, 108 insertions(+), 4 deletions(-) diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index 7ee9ab289..0f983518a 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -123,7 +123,11 @@ python benchmarks/cqa/verification/export_reference.py \ ``` The exporter imports no DICE code. Acceptance needs scores within tolerance and -identical candidate order and ties for every query. ULTRA/TRIX entries need no +identical candidate order and ties for every query. CQD and CQD-Hybrid answer +the five negated +H types with CQD-A signed-atom negation, which the pinned +H +code does not implement: their oracles cover the eleven positive types, and +`verify` records the negated types as evaluated without an upstream +reference; fixtures check them against CQD-A outputs. ULTRA/TRIX entries need no oracle: an independent implementation checks calibration, pruning, composition and identity controls on captured backbone logits; the backbones' own parity is tested separately. Passing evidence of an unchanged entry is reused (an diff --git a/benchmarks/cqa/oracles.py b/benchmarks/cqa/oracles.py index b397eaaa1..c053493f0 100644 --- a/benchmarks/cqa/oracles.py +++ b/benchmarks/cqa/oracles.py @@ -1,7 +1,7 @@ """Validate independently exported reference scores on the intended hardware.""" import tempfile -from collections import defaultdict +from collections import Counter, defaultdict import torch @@ -13,6 +13,19 @@ from .study import bundle_entry, checksum, dataset_key, entry_inputs_identity, run_job, verify_bundle +# Query types an upstream oracle cannot cover; the exporter declares exactly these, with this reason. +NEGATED_TYPES = ('2in', '3in', 'inp', 'pin', 'pni') +EXEMPTION_REASON = ('No upstream reference: the pinned +H CQD has no negation in its beam search. The negated types use CQD-A ' + 'signed-atom negation, checked against CQD-A outputs in ' + 'tests/test_query_baselines.py::test_opt_in_cqd_negation_matches_cqda.') + + +def upstream_exempt_types(entry): + """The pinned +H CQD has no negation in its beam search, so CQD-A negated types have no upstream reference.""" + if entry['method'] in ('cqd', 'cqd-hybrid') and entry['options'].get('atomic_negation'): + return sorted(set(entry['query_types']) & set(NEGATED_TYPES)) + return [] + def verify_predictions(bundle_dir, entry_id, input_root, reference, output, *, device='cpu', atol=3e-5, rtol=3e-5, comparison_reference=None): @@ -30,6 +43,10 @@ def verify_predictions(bundle_dir, entry_id, input_root, reference, output, *, d if (entry['method'] in REFERENCES and ('inference_graph' in entry or entry['dataset'] in BENCHMARK_DATASETS) and oracle.get('graphs') != graphs): raise ValueError('Reference inference graphs differ from the frozen validation/test protocol') + exempt = set(upstream_exempt_types(entry)) + if set((oracle.get('exempt_types') or {}).get('types', [])) != exempt: + raise ValueError('Reference exemptions differ from the query types its upstream code cannot answer') + skipped = Counter() control = None comparisons = {} if comparison_reference is not None: @@ -42,6 +59,9 @@ def verify_predictions(bundle_dir, entry_id, input_root, reference, output, *, d results = {} def compare(query, actual): + if query.shape in exempt: + skipped[query.shape] += 1 # evaluated, but without an upstream reference + return key = query.identity gold = oracle['scores'][key].to(actual.device) order = oracle['orders'][key].to(actual.device) @@ -85,8 +105,10 @@ def compare(query, actual): raise ValueError('Reference was produced with different hardware, precision, or runtime versions') if set(results) != set(oracle['scores']) or set(results) != set(oracle['orders']): raise ValueError('Reference query coverage differs from the frozen pilot batches') - if {row['shape'] for row in results.values()} != set(entry['query_types']): + if {row['shape'] for row in results.values()} != set(entry['query_types']) - exempt: raise ValueError('Reference omits a requested query type') + if set(skipped) != exempt: + raise ValueError('An exempt query type was not evaluated') evidence = dict(entry_sha256=expected['entry_sha256'], inputs_sha256=expected['inputs_sha256'], source_sha256=bundle['source_sha256'], environment=env, reference_sha256=checksum(reference), reference_commit=oracle.get('reference_commit'), queries=results, @@ -94,6 +116,7 @@ def compare(query, actual): reference_adjustments=oracle.get('runtime_adjustments', []), probe_only=oracle.get('probe_only', False), scope='paired full-candidate validation predictions, exact frozen batch membership', + exempt_types=dict(types=sorted(exempt), reason=EXEMPTION_REASON, evaluated_queries=dict(skipped)) if exempt else None, atol=atol, rtol=rtol, passed=all(value['passed'] for value in results.values())) if control is not None: groups = defaultdict(list) diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py index fb54ec547..9b644c96c 100644 --- a/benchmarks/cqa/tests/test_protocol.py +++ b/benchmarks/cqa/tests/test_protocol.py @@ -666,3 +666,63 @@ def test_suite_effects_average_seeds_per_query_and_pair_the_shared_control(tmp_p next(r for r in records if r['method'] == 'ultraquery')['complete'] = False effects = {e['comparison']: e for e in suite_effects(records, bootstrap_samples=0)} assert effects['adapter-minus-ultraquery']['datasets'] == 2 and not effects['adapter-minus-ultraquery']['complete_suite'] + + +def test_reference_exemptions_are_exactly_the_negated_types_of_cqd_with_cqda_negation(): + import importlib.util + + import benchmarks.cqa.oracles as verification + spec = importlib.util.spec_from_file_location('export_reference', Path(__file__).parents[1] / 'verification/export_reference.py') + exporter = importlib.util.module_from_spec(spec) + spec.loader.exec_module(exporter) + negated = ['2in', '3in', 'inp', 'pin', 'pni'] + cases = [(dict(method='cqd', options={'atomic_negation': True}, query_types=list(PLUS_H_SHAPES)), negated), + (dict(method='cqd-hybrid', options={'atomic_negation': True}, query_types=['1p', '2in', 'pni']), ['2in', 'pni']), + (dict(method='cqd', options={}, query_types=list(PLUS_H_SHAPES)), []), + (dict(method='qto', options={'atomic_negation': True}, query_types=list(PLUS_H_SHAPES)), [])] + for entry, expected in cases: + assert verification.upstream_exempt_types(entry) == exporter.exempt_types(entry) == expected + assert exporter.EXEMPTION_REASON == verification.EXEMPTION_REASON + + +def test_exempt_types_are_evaluated_but_not_compared_and_must_be_declared(tmp_path, monkeypatch): + import benchmarks.cqa.oracles as verification + from benchmarks.cqa.study import entry_inputs_identity + from dicee.query_answering.context import fingerprint + from dicee.query_answering.datasets import load_benchmark + from dicee.query_answering.methods import REFERENCES + manifest = paper_fixture(tmp_path) + entry = manifest['entries'][0] + entry['query_types'] = ['1p', '2in'] + entry['inference_graph'] = 'train' + bundle = freeze(manifest, tmp_path / 'bundle', tmp_path) + queries = load_benchmark(tmp_path / 'data', 'FB15k237+H', split='valid').queries + checked, exempt = (next(q for q in queries if q.shape == shape) for shape in ('1p', '2in')) + scores = torch.arange(8).float() + oracle = dict(version=1, entry_sha256=fingerprint(entry), inputs_sha256=entry_inputs_identity(bundle, entry), + validation_plan_sha256=bundle['plans'][entry['id'] + '/valid']['sha256'], + reference_commit=REFERENCES['cone'][1], environment=dict.fromkeys( + ('python', 'torch', 'cuda', 'gpu', 'driver', 'precision', 'threads'), 'fixture'), + graphs={split: bundle['datasets'][f'{entry["dataset"]}/{split}']['context'] for split in ('valid', 'test')}, + pilot_queries=1, probe_only=True, scores={checked.identity: scores}, + orders={checked.identity: scores.argsort(descending=True)}, + exempt_types=dict(types=['2in'], reason=verification.EXEMPTION_REASON)) + torch.save(oracle, tmp_path / 'oracle.pt') + + def run(*args, on_prediction, **kwargs): + on_prediction(checked, scores) + on_prediction(exempt, torch.zeros(8)) + return {'benchmark_run': {'environment': oracle['environment']}} + + monkeypatch.setattr(verification, 'run_job', run) + monkeypatch.setattr(verification, 'upstream_exempt_types', lambda entry: ['2in']) + result = verification.verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'oracle.pt', tmp_path / 'parity.json') + assert result['passed'] and set(result['queries']) == {checked.identity} + assert result['exempt_types']['types'] == ['2in'] and result['exempt_types']['evaluated_queries'] == {'2in': 1} + # An oracle has to declare exactly the exemptions the rule allows. + torch.save({key: value for key, value in oracle.items() if key != 'exempt_types'}, tmp_path / 'undeclared.pt') + with pytest.raises(ValueError, match='Reference exemptions differ'): + verification.verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'undeclared.pt', tmp_path / 'x.json') + monkeypatch.setattr(verification, 'upstream_exempt_types', lambda entry: []) + with pytest.raises(ValueError, match='Reference exemptions differ'): + verification.verify_predictions(tmp_path / 'bundle', entry['id'], tmp_path, tmp_path / 'oracle.pt', tmp_path / 'y.json') diff --git a/benchmarks/cqa/verification/export_reference.py b/benchmarks/cqa/verification/export_reference.py index 37b274519..15e0b26af 100644 --- a/benchmarks/cqa/verification/export_reference.py +++ b/benchmarks/cqa/verification/export_reference.py @@ -43,6 +43,20 @@ def __torch_function__(self, func, types, args=(), kwargs=None): return func(*args, **kwargs) +# Query types an upstream oracle cannot cover; benchmarks/cqa/oracles.py accepts exactly these exemptions. +NEGATED_TYPES = ('2in', '3in', 'inp', 'pin', 'pni') +EXEMPTION_REASON = ('No upstream reference: the pinned +H CQD has no negation in its beam search. The negated types use CQD-A ' + 'signed-atom negation, checked against CQD-A outputs in ' + 'tests/test_query_baselines.py::test_opt_in_cqd_negation_matches_cqda.') + + +def exempt_types(entry): + """The pinned +H CQD has no negation in its beam search, so CQD-A negated types have no upstream reference.""" + if entry['method'] in ('cqd', 'cqd-hybrid') and entry['options'].get('atomic_negation'): + return sorted(set(entry['query_types']) & set(NEGATED_TYPES)) + return [] + + FORMULAS = { '1p': 'r1(s1,f)', '2p': '(r1(s1,e1))&(r2(e1,f))', '3p': '((r1(s1,e1))&(r2(e1,e2)))&(r3(e2,f))', @@ -404,6 +418,9 @@ def main(): inputs_sha256=digest(inputs), validation_plan_sha256=frozen_plan['sha256'], reference_commit=commit, exporter_sha256=sha(Path(__file__)), pilot_queries=args.pilot_queries, probe_only=args.probe_only, scores={}, orders={}) + exempt = set(exempt_types(entry)) + if exempt: + oracle['exempt_types'] = dict(types=sorted(exempt), reason=EXEMPTION_REASON) oracle['graphs'] = graphs oracle['runtime_adjustments'] = (['Set the default tensor device during CQD forward; upstream hybrid padding omits device.'] if entry['method'] in ('cqd', 'cqd-hybrid') else []) @@ -441,7 +458,7 @@ def main(): for end in plan['batch_ends']: keys = plan['queries'][start:end] shape = queries[keys[0]][0] - if counts[shape] < args.pilot_queries: + if counts[shape] < args.pilot_queries and shape not in exempt: values = predict(shape, [queries[key][1] for key in keys]) if args.probe_only: keys = keys[:args.pilot_queries - counts[shape]] From a2ee877b44a7d5df80b79fd485eb928a8036f3ab Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Sun, 4 Oct 2026 23:49:41 +0200 Subject: [PATCH 20/39] perf(query-answering): QTO reads relation matrices built once instead of per-query rows Chained QTO projections recompute almost a whole relation matrix for every query behind a 512 MiB row cache, which puts full +H and UltraQuery test splits at days per dataset. With matrix_bytes (and host_matrix_bytes), each relation's thresholded calibrated matrix is built once from the same canonical 100-head blocks and kept in CSR form on the GPU, spilling to host memory; projections from at most eight heads keep computing rows unless the matrix is already on the device. Scores are identical: tests compare both paths bit for bit on a three-block random graph across all 16 shapes, small caches, invalidation and host spill, and against the upstream fixture. The six QTO recipes enable it (6 GiB on the device, 32 GiB in host memory). --- benchmarks/cqa/README.md | 7 + benchmarks/cqa/tests/recipe_fingerprints.json | 12 +- benchmarks/plus_h/baselines.json | 2 +- benchmarks/ultraquery/comparisons.json | 2 +- benchmarks/ultraquery/trained_baselines.json | 2 +- dicee/query_answering/methods/_common.py | 15 +- dicee/query_answering/methods/qto.py | 156 ++++++++++++++++-- tests/test_query_baselines.py | 104 ++++++++++++ 8 files changed, 274 insertions(+), 26 deletions(-) diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index 0f983518a..fca3ef9cf 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -178,6 +178,13 @@ another's GPU work, for about 1.5 times the throughput of one worker; with the H100 profile each KGFM worker stays below 12 GiB of GPU memory and holds up to 24 GiB of host memory. Keep one worker per GPU on GPUs shared with other jobs. +The QTO recipes build each relation's thresholded calibrated matrix once, from +the released canonical 100-head blocks, and keep it in CSR form: up to 6 GiB +on the GPU (`matrix_bytes`) and 32 GiB in host memory (`host_matrix_bytes`), +least recently used out first. Scores are identical to computing the rows for +every query, which recomputes almost a whole relation matrix for each chained +projection and needs days per full test split. + ## UltraQuery comparison baselines `trained_baselines.json` needs weights trained locally with pinned author code diff --git a/benchmarks/cqa/tests/recipe_fingerprints.json b/benchmarks/cqa/tests/recipe_fingerprints.json index 5e4a88aad..5682ae064 100644 --- a/benchmarks/cqa/tests/recipe_fingerprints.json +++ b/benchmarks/cqa/tests/recipe_fingerprints.json @@ -6,21 +6,21 @@ "clmpt-FB15k237+H": "8594c53f58b3305715e5d45571b7ac4792209a603deacf405c779c8649f8a394", "cqd-FB15k237+H": "2f8594e09e9aeaedfd4a530b85115f9029775bc3f3bd8b4f40a4a377374d663f", "cqd-hybrid-FB15k237+H": "83dd457559834229bd99e518eaa3482f887d9d24fb908d0c08c51f348a95c1f9", - "qto-FB15k237+H": "55544a11fc616298c97b89502368403586c758c15fa58914588ae05b0b9f94fd", + "qto-FB15k237+H": "e1d7c0c74e9f26a17e9650007d9e2750c5dc7fc6cdb54e05d17709a3d078769c", "cone-NELL995+H": "c8b275487e2b7bd6a25af041b69c3f5bbe9089da718b7f5d26e0d223f7afd1c4", "gnnqe-NELL995+H": "4e854b0b944fca240caedfd3db0994870354fa577be2146d9b7155d7d2107a78", "ultraquery-NELL995+H": "8daf270d1dfef53ce684e513d7e825385ffc66165ff974792ed90efc44f0cec2", "clmpt-NELL995+H": "1d69cdee8d2133eaf09286cd3134c934edee36d5580981d8ae77e20eb94b8bf9", "cqd-NELL995+H": "435d309810afafc07fede359c0f53aeee8d6de6f3ea813dcfc7e69e347a04006", "cqd-hybrid-NELL995+H": "9572fb778227a97087e871f0c6852240e582e9a41e8fcce83c340c9e485942ea", - "qto-NELL995+H": "1d6a0273a6f2d11834132e288612ab0848099810abc5303da9ce7d849b77b754", + "qto-NELL995+H": "cbc241f18bacddfe47d801f3aa36a69e0598df782db455469b13ebc832abf6a0", "cone-ICEWS18+H": "13714f669fcfe488f65afe8cc18ce25a144f3e25b0b21bccdae403500dba0b74", "gnnqe-ICEWS18+H": "62ac479f319b62ab29105b14e327dae0a303a6cf00d5f9989d38e135d833af52", "ultraquery-ICEWS18+H": "c0cba93ed7bc90435d613a856b49dc1b22ff7aed523ef704204abd7fe4e48ca8", "clmpt-ICEWS18+H": "2c0d83424f3b632f767c1fc8ee9bfc5a325e6de99d72ce1f22b2e28731d466a9", "cqd-ICEWS18+H": "742156216a0ee43512138fad200af95e494b2146ae160b17c2e8f4839b893bda", "cqd-hybrid-ICEWS18+H": "37e3d6d0307f3661c1a58eebf3f07960605008ae959b421ffc3fe63f98509a89", - "qto-ICEWS18+H": "cef09df05749b23f75aff1b0b4dc49dc77de547064cd0e57289219e976f811e0" + "qto-ICEWS18+H": "980a9eff4f1feeadae6314974d8e44da51c51bbfe5479b9087c6cc78baf7d01e" }, "plus_h/kgfm_adapters.json": { "ultra-product-intersections-FB15k237+H": "b69ee51b10efde939da3acca958737342f0b9c04cb87029a433f96a9694dbd09", @@ -113,8 +113,8 @@ "ultraquery-lp-WikiTopicsQuery:tax": "2a3baeefe692b9938f53447f82e53c15b4a1be187462bd49928190d624881a95", "ultraquery-lp-no-threshold-WikiTopicsQuery:tax": "150b9d100def6f28df7ec8c060e050dfc506e50b959f8c91d927cec7cc794f5f", "incoming-relation-WikiTopicsQuery:tax": "92940ef98b13543f54d4e43f765e51d35aab803ab4e122b570bd27ed7a373433", - "qto-FB15k237LogicalQuery": "0d66aa3766e00bb38eb03d1945dae8040b031753f55a16922ed5454e0ebdc787", - "qto-NELL995LogicalQuery": "10d947a9870d943ce731cb64fcbf914b3c1a116c1affdebdeba101975272d0e2" + "qto-FB15k237LogicalQuery": "6d0c84fe3626ad70e8237e8d373193ed22311262aac96ba7c8b09770ab75ccd5", + "qto-NELL995LogicalQuery": "472be331538648555c38e58b7a02c6a0b9d0ac1710bc14686210bcf9d434e879" }, "ultraquery/kgfm_adapters.json": { "ultra-product-intersections-FB15k237LogicalQuery": "287c4c1e7f5000232b37686fb2cd11d480b8963226c9e723396a6eac6c5d5e48", @@ -165,7 +165,7 @@ "trix-product-intersections-WikiTopicsQuery:tax": "ca14cbcb7938c80e89c121d75f71c9163c26cc6dc622efabb7e35ebc3457dd40" }, "ultraquery/trained_baselines.json": { - "qto-FB15kLogicalQuery": "6f769ebd4a6f84d0f42a443486b2f0d778055201557996f01deec98417665cbe", + "qto-FB15kLogicalQuery": "fbfdca9fe1cbcf143a8d8e2db1f3df8e341454b21b5325e7abe6b92de9be8b48", "inductive-gnnqe-InductiveFB15k237Query:106": "1fa57c57fae80e52dcde4de9dbcca48dc6dcd8b22639792aa2478d79daf530bd", "inductive-gnnqe-InductiveFB15k237Query:113": "b77cbaa878b8ae58e5bd878a09df7c1d8a992eb8778ebb6deade5bf55a43845f", "inductive-gnnqe-InductiveFB15k237Query:122": "149f13b82a1fb5466de8299340222b1bd6eab900a57d8ecee708b70ff3c76c6c", diff --git a/benchmarks/plus_h/baselines.json b/benchmarks/plus_h/baselines.json index 2e64ca343..a6facaac2 100644 --- a/benchmarks/plus_h/baselines.json +++ b/benchmarks/plus_h/baselines.json @@ -324,7 +324,7 @@ "defaults": { "id": "qto-{dataset}", "method": "qto", - "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true, "matrix_bytes": 6442450944, "host_matrix_bytes": 34359738368}, "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni", "4p", "4i"], "query_batch_size": 1, "query_order": "upstream-pickle", diff --git a/benchmarks/ultraquery/comparisons.json b/benchmarks/ultraquery/comparisons.json index 5bf9e51ef..a435a054a 100644 --- a/benchmarks/ultraquery/comparisons.json +++ b/benchmarks/ultraquery/comparisons.json @@ -200,7 +200,7 @@ "defaults": { "id": "qto-{dataset}", "method": "qto", - "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "options": {"threshold": 0.0002, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true, "matrix_bytes": 6442450944, "host_matrix_bytes": 34359738368}, "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], "query_batch_size": 1, "query_order": "upstream-pickle", diff --git a/benchmarks/ultraquery/trained_baselines.json b/benchmarks/ultraquery/trained_baselines.json index 5c2cc3360..0efdc02d6 100644 --- a/benchmarks/ultraquery/trained_baselines.json +++ b/benchmarks/ultraquery/trained_baselines.json @@ -14,7 +14,7 @@ "id": "qto-{dataset}", "method": "qto", "checkpoint": "checkpoints/ultraquery_benchmark-trained/qto-FB15kLogicalQuery/checkpoint.pt", - "options": {"threshold": 0.001, "negation_scale": 6, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true}, + "options": {"threshold": 0.001, "negation_scale": 6, "row_batch_size": 32, "cache_bytes": 536870912, "reference_batching": true, "matrix_bytes": 6442450944, "host_matrix_bytes": 34359738368}, "query_types": ["1p", "2p", "3p", "2i", "3i", "ip", "pi", "2u", "up", "2in", "3in", "inp", "pin", "pni"], "query_batch_size": 1, "query_order": "upstream-pickle", diff --git a/dicee/query_answering/methods/_common.py b/dicee/query_answering/methods/_common.py index 7232864b4..7e90a19ca 100644 --- a/dicee/query_answering/methods/_common.py +++ b/dicee/query_answering/methods/_common.py @@ -34,6 +34,14 @@ def predict(self, query): return scores.clone() +def cache_token(model): + """Validity token of cached inference tensors; None when nothing may be cached (inference tensors, autocast).""" + token = state_token(model) + if torch.is_autocast_enabled(next(model.parameters()).device.type): + return None + return None if token is None else (token, float32_precision_token()) + + class TensorCache: """Bounded inference cache, invalidated by parameter and device changes.""" @@ -45,12 +53,7 @@ def __init__(self, capacity): self.optional = OrderedDict() def refresh(self, model): - token = state_token(model) - device_type = next(model.parameters()).device.type - if torch.is_autocast_enabled(device_type): - token = None - elif token is not None: - token = token, float32_precision_token() + token = cache_token(model) if token is None or token != self.token: self.values.clear() self.optional.clear() diff --git a/dicee/query_answering/methods/qto.py b/dicee/query_answering/methods/qto.py index b9f4a4955..806edaa93 100644 --- a/dicee/query_answering/methods/qto.py +++ b/dicee/query_answering/methods/qto.py @@ -1,21 +1,118 @@ """QTO's calibrated neural adjacency and max-product query execution.""" +from collections import OrderedDict + import torch -from ._common import QueryMethod, TensorCache, complex_rows, require_complex +from ._common import QueryMethod, TensorCache, cache_token, complex_rows, require_complex + +# Rows times entities densified at once when a projection reads a relation matrix. +DENSE_ELEMENTS = 2**24 +# Projections from at most this many heads compute their rows unless the relation matrix is already on the device. +ROW_HEADS = 8 + + +def _size(matrix): + return sum(tensor.numel() * tensor.element_size() for tensor in matrix) + + +class RelationMatrices: + """Thresholded calibrated relation matrices in CSR form, least recently used out first. + + Matrices stay on the model's device up to ``device_bytes``; evicted ones move to host memory, up to + ``host_bytes``, and return on their next use. Parameter changes invalidate both, as in ``TensorCache``. + """ + + def __init__(self, device_bytes, host_bytes): + if any(type(capacity) is not int or capacity < 0 for capacity in (device_bytes, host_bytes)): + raise ValueError('Matrix cache capacities must be nonnegative byte counts') + self.capacity = dict(device=device_bytes, host=host_bytes) + self.tiers = dict(device=OrderedDict(), host=OrderedDict()) + self.bytes, self.token = dict(device=0, host=0), None + + def refresh(self, model): + token = cache_token(model) + if token is None or token != self.token: + for tier in self.tiers.values(): + tier.clear() + self.bytes, self.token = dict(device=0, host=0), token + + def resident(self, relation): + """The matrix if it is on the device; host memory is not consulted.""" + if relation in self.tiers['device']: + self.tiers['device'].move_to_end(relation) + return self.tiers['device'][relation] + return None + + def get(self, relation, device): + matrix = self.resident(relation) + if matrix is not None: + return matrix + matrix = self.tiers['host'].pop(relation, None) + if matrix is None: + return None + self.bytes['host'] -= _size(matrix) + matrix = tuple(tensor.to(device) for tensor in matrix) + self.put(relation, matrix) + return matrix + + def put(self, relation, matrix): + self._store('device', relation, matrix) + + def _store(self, tier, relation, matrix): + if self.token is None: + return + size = _size(matrix) + if size > self.capacity[tier]: + self._spill(tier, relation, matrix) + return + values = self.tiers[tier] + while self.bytes[tier] + size > self.capacity[tier]: + victim, old = values.popitem(last=False) + self.bytes[tier] -= _size(old) + self._spill(tier, victim, old) + values[relation] = matrix + self.bytes[tier] += size + + def _spill(self, tier, relation, matrix): + if tier == 'device' and matrix[0].device.type != 'cpu': + self._store('host', relation, tuple(tensor.cpu() for tensor in matrix)) class QTO(QueryMethod): + """QTO with the released canonical 100-head calibration. + + With ``matrix_bytes`` > 0, projections read each relation's thresholded calibrated matrix, built once from + the same canonical blocks and kept in CSR form (see ``RelationMatrices``), instead of recomputing rows per + query. Scores are identical; only time and memory change. + """ + def __init__(self, model, context, *, threshold, negation_scale, row_batch_size=100, cache_bytes=512 * 2**20, - reference_batching=False): + reference_batching=False, matrix_bytes=0, host_matrix_bytes=0): super().__init__(context) require_complex(model, context) if not 0 <= threshold <= 1 or negation_scale <= 0 or row_batch_size < 1: raise ValueError('Invalid QTO calibration or batch size') + if (matrix_bytes or host_matrix_bytes) and not (reference_batching and matrix_bytes): + raise ValueError('Relation matrices need reference_batching and matrix_bytes > 0') self.model, self.threshold, self.negation_scale = model, threshold, negation_scale self.row_batch_size = row_batch_size self.reference_batching = reference_batching self.cache = TensorCache(cache_bytes) + self.matrices = RelationMatrices(matrix_bytes, host_matrix_bytes) if matrix_bytes else None + + def calibrated(self, group, relation): + """Calibrated rows of the heads in ``group``, scored together as one block.""" + raw = complex_rows(self.model, group, [relation] * len(group)) + observed = [self.context.outgoing.get(head, {}).get(relation, ()) for head in group] + degrees = raw.new_tensor([max(1, len(tails)) for tails in observed]) + calibrated = raw.softmax(-1) * degrees[:, None] + calibrated = calibrated * (calibrated >= self.threshold) + calibrated = torch.where(calibrated >= 1, .9999, calibrated) + rows = [i for i, tails in enumerate(observed) for _ in tails] + if rows: + calibrated[rows, [tail for tails in observed for tail in tails]] = 1 + return calibrated def rows(self, heads, relation): self.cache.refresh(self.model) @@ -25,13 +122,7 @@ def rows(self, heads, relation): groups = ([list(range(start, min(start + 100, self.context.num_entities))) for start in sorted({head // 100 * 100 for head in missing})] if self.reference_batching else [missing] if missing else []) for group in groups: - raw = complex_rows(self.model, group, [relation] * len(group)) - degrees = raw.new_tensor([max(1, len(self.context.outgoing.get(head, {}).get(relation, ()))) for head in group]) - calibrated = raw.softmax(-1) * degrees[:, None] - calibrated = calibrated * (calibrated >= self.threshold) - calibrated = torch.where(calibrated >= 1, .9999, calibrated) - for head, row in zip(group, calibrated): - row[sorted(self.context.outgoing.get(head, {}).get(relation, ()))] = 1 + for head, row in zip(group, self.calibrated(group, relation)): if head in values: values[head] = row.clone() if self.reference_batching else row self.cache.put((head, relation), row) @@ -42,13 +133,56 @@ def rows(self, heads, relation): self.cache.put((head, relation), row) return torch.stack([values[head] for head in requested]) + def matrix(self, relation): + """``relation``'s calibrated matrix as CSR (row pointers, int32 columns, values), from canonical blocks.""" + self.matrices.refresh(self.model) + matrix = self.matrices.get(relation, self.device) + if matrix is None: + n = self.context.num_entities + counts, columns, values = [], [], [] + for start in range(0, n, 100): + block = self.calibrated(list(range(start, min(start + 100, n))), relation) + rows, cols = block.nonzero(as_tuple=True) + counts.append(torch.bincount(rows, minlength=len(block))) + columns.append(cols.to(torch.int32)) + values.append(block[rows, cols]) + pointers = torch.cat([counts[0].new_zeros(1), torch.cat(counts).cumsum(0)]) + matrix = pointers, torch.cat(columns), torch.cat(values) + self.matrices.put(relation, matrix) + return matrix + + def matrix_rows(self, matrix, heads): + """Dense calibrated rows of ``heads`` from a CSR matrix.""" + pointers, columns, values = matrix + starts = pointers[heads] + lengths = pointers[heads + 1] - starts + rows = values.new_zeros(len(heads), self.context.num_entities) + total = int(lengths.sum()) + if total: + local = torch.repeat_interleave(torch.arange(len(heads), device=heads.device), lengths, output_size=total) + offsets = torch.arange(total, device=heads.device) - (lengths.cumsum(0) - lengths)[local] + starts[local] + rows[local, columns[offsets].long()] = values[offsets] + return rows + def projection(self, prefix, relation, negate=False): result = torch.zeros_like(prefix) heads = prefix.nonzero().flatten() if not len(heads): return result - for chunk in heads.split(self.row_batch_size): - rows = self.rows(chunk, relation) + matrix = None + if self.matrices is not None: + # Both paths give the same rows; a few heads rarely justify loading or building a whole matrix. + self.matrices.refresh(self.model) + matrix = self.matrices.resident(relation) + if matrix is None and len(heads) > ROW_HEADS: + matrix = self.matrix(relation) + if matrix is None: + chunks = ((chunk, self.rows(chunk, relation)) for chunk in heads.split(self.row_batch_size)) + else: + size = max(1, DENSE_ELEMENTS // self.context.num_entities) + chunks = ((chunk, self.matrix_rows(matrix, chunk)) for chunk in heads.split(size)) + # The maximum over heads does not depend on how they are chunked. + for chunk, rows in chunks: if negate: rows = 1 - torch.minimum(torch.ones_like(rows), self.negation_scale * rows) result = torch.maximum(result, (prefix[chunk, None] * rows).max(0).values) diff --git a/tests/test_query_baselines.py b/tests/test_query_baselines.py index 1159f7fec..b2d6b46a7 100644 --- a/tests/test_query_baselines.py +++ b/tests/test_query_baselines.py @@ -238,6 +238,110 @@ def test_qto_empty_intermediate_stays_empty(tmp_path): assert torch.equal(model.projection(torch.zeros(context.num_entities), 0, negate=True), torch.zeros(context.num_entities)) +def _shift_anchors(query, offset, n): + if isinstance(query, tuple) and len(query) == 2 and isinstance(query[0], int) and isinstance(query[1], tuple): + return (query[0] + offset) % n, query[1] + return tuple(_shift_anchors(part, offset, n) if isinstance(part, tuple) else part for part in query) + + +def _random_qto_pair(n=257, relations=5, seed=0, **options): + """Row-path and matrix-path QTO on one random graph and ComplEx state spanning several canonical blocks.""" + from dicee.query_answering.methods import qto + from dicee.query_answering.methods.checkpoints import _complex + generator = torch.Generator().manual_seed(seed) + triples = torch.stack([torch.randint(n, (4 * n,), generator=generator), torch.randint(relations, (4 * n,), generator=generator), + torch.randint(n, (4 * n,), generator=generator)], 1).tolist() + context = QueryContext(triples, n, relations) + # Small weights spread the softmax, so rows mix entries below and above the threshold. + state = {'embeddings.0.weight': .6 * torch.randn(n, 16, generator=generator), + 'embeddings.1.weight': .6 * torch.randn(relations, 16, generator=generator)} + config = dict(threshold=2e-4, negation_scale=3., reference_batching=True) + rows = qto.QTO(_complex(state, context), context, **config) + matrices = qto.QTO(_complex(state, context), context, **config | options) + return rows, matrices + + +@pytest.mark.parametrize('matrix_bytes,dense_elements', [(2**30, 2**24), (1, 2**24), (2**30, 300)]) +def test_qto_relation_matrices_reproduce_row_scores(monkeypatch, matrix_bytes, dense_elements): + from dicee.query_answering.methods import qto + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + monkeypatch.setattr(qto, 'DENSE_ELEMENTS', dense_elements) + rows, matrices = _random_qto_pair(matrix_bytes=matrix_bytes) + n = rows.context.num_entities + for shape, query in fixture['queries'].items(): + support = 0 + for offset in (0, 100, 230): + shifted = _shift_anchors(query, offset, n) + expected = rows.predict(shifted) + support = max(support, int(expected.count_nonzero())) + torch.testing.assert_close(matrices.predict(shifted), expected, atol=0, rtol=0, msg=shape) + assert support > 10, shape # the comparison covers nontrivial score vectors of every shape + if matrix_bytes > 1: + assert 0 < matrices.matrices.bytes['device'] <= matrix_bytes + else: + assert not matrices.matrices.tiers['device'] + + +def test_qto_few_heads_compute_rows_unless_the_matrix_is_resident(): + from unittest.mock import patch + + from dicee.query_answering.methods import qto + rows, matrices = _random_qto_pair(matrix_bytes=2**30) + n = rows.context.num_entities + anchor = torch.nn.functional.one_hot(torch.tensor(130), n).float() + dense = torch.rand(n, generator=torch.Generator().manual_seed(1)) + with torch.no_grad(): + torch.testing.assert_close(matrices.projection(anchor, 1), rows.projection(anchor, 1), atol=0, rtol=0) + assert not matrices.matrices.tiers['device'] + torch.testing.assert_close(matrices.projection(dense, 1), rows.projection(dense, 1), atol=0, rtol=0) + assert set(matrices.matrices.tiers['device']) == {1} + expected = rows.projection(anchor, 1, negate=True) + with patch.object(qto, 'complex_rows', wraps=qto.complex_rows) as scorer: + actual = matrices.projection(anchor, 1, negate=True) + assert scorer.call_count == 0 + torch.testing.assert_close(actual, expected, atol=0, rtol=0) + + +def test_qto_relation_matrices_match_upstream_fixture_and_invalidate(tmp_path): + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + case = fixture['cases'][0] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'weights.pt' + torch.save(case['state'], path) + model = load_method('qto', path, context, reference_batching=True, matrix_bytes=2**20, **case['config']) + for shape, query in fixture['queries'].items(): + torch.testing.assert_close(model.predict(query), case['scores'][shape], msg=shape) + rows = load_method('qto', path, context, reference_batching=True, **case['config']) + with torch.no_grad(): + for method in (model, rows): + method.model.entity_embeddings.weight.mul_(2) + for shape, query in fixture['queries'].items(): + torch.testing.assert_close(model.predict(query), rows.predict(query), atol=0, rtol=0, msg=shape) + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason='host spill of device matrices') +def test_qto_relation_matrices_spill_to_host_memory(): + fixture = torch.load(ROOT / 'qto.pt', weights_only=True) + rows, matrices = _random_qto_pair(matrix_bytes=40_000, host_matrix_bytes=2**30) + rows, matrices = rows.cuda(), matrices.cuda() + for shape, query in fixture['queries'].items(): + for offset in (0, 100, 230): + shifted = _shift_anchors(query, offset, rows.context.num_entities) + torch.testing.assert_close(matrices.predict(shifted), rows.predict(shifted), atol=0, rtol=0, msg=shape) + tiers = matrices.matrices.tiers + assert tiers['host'] and all(tensor.device.type == 'cpu' for matrix in tiers['host'].values() for tensor in matrix) + assert matrices.matrices.bytes['device'] <= 40_000 + + +def test_qto_relation_matrix_options_are_validated(): + with pytest.raises(ValueError, match='reference_batching'): + _random_qto_pair(n=7, matrix_bytes=2**20, reference_batching=False) + with pytest.raises(ValueError, match='reference_batching'): + _random_qto_pair(n=7, host_matrix_bytes=2**20) + with pytest.raises(ValueError, match='nonnegative'): + _random_qto_pair(n=7, matrix_bytes=2**20, host_matrix_bytes=-1) + + def test_dual_tie_protocol_resume_uses_one_prediction(tmp_path): data = QueryBenchmark('toy', 'transductive', 'test', QueryContext([], 5, 2), tuple(BenchmarkQuery('1p', (head, (0,)), frozenset({1}), frozenset({3})) for head in range(3)), From 3daabdba3ec12d7a8a49772c9e6739d4d0446823 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 13:11:17 +0200 Subject: [PATCH 21/39] feat(query-answering): optional fixed membership threshold on score adapters membership_threshold zeroes memberships at or below a fixed value before observed facts override them, the hand-set calibration UltraQuery LP applies. It lets that calibration run inside the beam-search executor as a lower reference point for the learned adapter. The executor already treats zero memberships as ordinary values, also under negation. Adapters without a threshold keep their configuration, so existing artifacts and cache keys are unchanged; the threshold is saved, loaded and part of the cache key. --- dicee/query_answering/score_adapter.py | 23 ++++++++++++++++----- tests/test_query_engine.py | 28 ++++++++++++++++++++++++++ 2 files changed, 46 insertions(+), 5 deletions(-) diff --git a/dicee/query_answering/score_adapter.py b/dicee/query_answering/score_adapter.py index bdb5a71c4..d4da66654 100644 --- a/dicee/query_answering/score_adapter.py +++ b/dicee/query_answering/score_adapter.py @@ -62,10 +62,13 @@ class QueryScoreAdapter(nn.Module): ``global`` learns only two parameters. ``context`` and ``context_scores`` learn eight and sixteen with a linear head. Context observations can override or interpolate memberships. Newly fitted adapters bind to a backbone state hash. + ``membership_threshold`` zeroes memberships at or below a fixed value, the hand-set + calibration of UltraQuery LP; it is not trained. """ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=None, metadata=None, - bias_bound=4., scale_bound=2., normalization='none', hidden_dim=0, hidden_weights=None, seed=0): + bias_bound=4., scale_bound=2., normalization='none', hidden_dim=0, hidden_weights=None, seed=0, + membership_threshold=0.): super().__init__() feature_mode = canonical_feature_mode(feature_mode) if not math.isfinite(observed_mix) or not 0 <= observed_mix <= 1: @@ -76,11 +79,14 @@ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=No raise ValueError('scale_bound must exceed one, or be None for unrestricted scaling') if normalization not in ('none', 'standard'): raise ValueError('Choose none or standard row normalization') + if not math.isfinite(membership_threshold) or not 0 <= membership_threshold < 1: + raise ValueError('membership_threshold must be in [0, 1)') if type(hidden_dim) is not int or hidden_dim < 0: raise ValueError('hidden_dim must be a nonnegative integer') self.feature_mode, self.observed_mix = feature_mode, float(observed_mix) self.bias_bound, self.normalization, self.hidden_dim = float(bias_bound), normalization, hidden_dim self.scale_bound = None if scale_bound is None else float(scale_bound) + self.membership_threshold = float(membership_threshold) features = FEATURE_COUNTS[feature_mode] size = (2, hidden_dim or features) value = torch.zeros(size, dtype=torch.float64) if weights is None else torch.as_tensor(weights, dtype=torch.float64) @@ -102,8 +108,11 @@ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=No @property def configuration(self): - return dict(feature_mode=self.feature_mode, observed_mix=self.observed_mix, bias_bound=self.bias_bound, - scale_bound=self.scale_bound, normalization=self.normalization, hidden_dim=self.hidden_dim) + configuration = dict(feature_mode=self.feature_mode, observed_mix=self.observed_mix, bias_bound=self.bias_bound, + scale_bound=self.scale_bound, normalization=self.normalization, hidden_dim=self.hidden_dim) + if self.membership_threshold: + configuration['membership_threshold'] = self.membership_threshold + return configuration def prepare(self, raw, observed=None, base=None): """Prepare parameter-independent inputs once for frozen training banks.""" @@ -146,6 +155,9 @@ def transform(self, raw, observed, features): require(torch.isfinite(scale).all() & ~(scale <= 0).any(), FloatingPointError('Nonfinite or zero adapter scale')) logits = scale[:, None] * raw + self.bias_bound * v.tanh()[:, None] logs = F.logsigmoid(logits) + if self.membership_threshold: + # UltraQuery LP's fixed calibration: memberships at or below the threshold become exactly zero. + logs = logs.masked_fill(logs <= math.log(self.membership_threshold), -math.inf) if self.observed_mix == 1: logs = logs.masked_fill(observed, 0.) elif self.observed_mix: @@ -205,7 +217,8 @@ def load(cls, path: str | Path, *, model: Any, key: str | None = None, raise ValueError('Select a catalog entry with key=...') if payload.get('version', 1) not in (1, 2, 3): raise ValueError('Unsupported adapter artifact version') - fields = ('weights', 'feature_mode', 'observed_mix', 'version', 'bias_bound', 'scale_bound', 'normalization', 'hidden_dim', 'hidden_weights') + fields = ('weights', 'feature_mode', 'observed_mix', 'version', 'bias_bound', 'scale_bound', 'normalization', 'hidden_dim', + 'hidden_weights', 'membership_threshold') metadata = {k: v for k, v in payload.items() if k not in fields} if 'backbone_state_sha256' not in metadata: if checkpoint is None or 'backbone_checkpoint_sha256' not in metadata: @@ -222,6 +235,6 @@ def load(cls, path: str | Path, *, model: Any, key: str | None = None, weights=payload['weights'], metadata=metadata, bias_bound=payload.get('bias_bound', 4.), scale_bound=payload.get('scale_bound', 2.), normalization=payload.get('normalization', 'none'), hidden_dim=payload.get('hidden_dim', 0), - hidden_weights=payload.get('hidden_weights')) + hidden_weights=payload.get('hidden_weights'), membership_threshold=payload.get('membership_threshold', 0.)) adapter.verify_model(model) return adapter diff --git a/tests/test_query_engine.py b/tests/test_query_engine.py index 370d9ba5f..e5e95e87f 100644 --- a/tests/test_query_engine.py +++ b/tests/test_query_engine.py @@ -514,3 +514,31 @@ def test_cache_separates_raw_logits_and_bypasses_autocast(raw): for _ in range(2): engine.predict(query) assert engine.last_info['raw_rows'] == 1 + + +def test_membership_threshold_zeroes_low_memberships_like_ultraquery_lp(tmp_path): + model = TableModel(np.zeros((4, 1, 4))) + adapter = QueryScoreAdapter('global', 1., membership_threshold=.5, metadata={'backbone_state_sha256': state_fingerprint(model)}) + raw = torch.tensor([[-2., 0., .1, 3.]], dtype=torch.float64) + observed, base = QueryContext([(0, 0, 0)], 4, 1).features([(0, 0)], device='cpu') + scores = adapter(raw, observed, base) + # Memberships .12, .5, .52, .95: those at or below .5 become zero, unless observed (entity 0 is an observed fact). + assert scores[0, 0] == 0 and scores[0, 1] == -torch.inf + torch.testing.assert_close(scores[0, 2:], torch.nn.functional.logsigmoid(raw[0, 2:]), rtol=0, atol=0) + adapter.save(tmp_path / 'adapter.json') + loaded = QueryScoreAdapter.load(tmp_path / 'adapter.json', model=model) + assert loaded.configuration == adapter.configuration and loaded.configuration['membership_threshold'] == .5 + # Adapters without a threshold keep their configuration, so existing artifacts and cache keys do not change. + assert 'membership_threshold' not in QueryScoreAdapter('global').configuration + with pytest.raises(ValueError, match='membership_threshold'): + QueryScoreAdapter('global', membership_threshold=1.) + + +def test_membership_threshold_runs_in_the_executor_and_keys_its_cache(): + adapter = QueryScoreAdapter('global') + engine = QueryAnswerer(TableModel(np.random.default_rng(3).normal(size=(5, 2, 5))).eval(), adapter=adapter) + before = engine.predict(((0, (0,)), (1, (1, -2)))) + adapter.membership_threshold = .6 + after = engine.predict(((0, (0,)), (1, (1, -2)))) + # Zero memberships are ordinary values for the executor, also under negation. + assert torch.isfinite(after).all() and (after == 0).any() and (after > 0).any() and not torch.equal(before, after) From 25979363f505c112a9b0f5f71f414bf444524eac Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 19:43:23 +0200 Subject: [PATCH 22/39] feat(benchmarks): integration oracle applies fixed membership thresholds The independent KGFM reference now zeroes memberships at or below an adapter's membership_threshold before observed facts override them, as the production adapter does, so frozen studies can verify entries that run UltraQuery LP's fixed calibration in the beam-search executor. The identity control is still checked without a threshold, matching the paired control the evaluator builds. Tests compare executor and reference on every query shape with ties at zero membership inside the beams. --- benchmarks/cqa/tests/test_kgfm_reference.py | 39 +++++++++++++++++++ benchmarks/cqa/verification/reference_kgfm.py | 6 ++- benchmarks/cqa/verification/verify_kgfm.py | 3 +- 3 files changed, 46 insertions(+), 2 deletions(-) diff --git a/benchmarks/cqa/tests/test_kgfm_reference.py b/benchmarks/cqa/tests/test_kgfm_reference.py index 3353b35ab..bb0ca4a5b 100644 --- a/benchmarks/cqa/tests/test_kgfm_reference.py +++ b/benchmarks/cqa/tests/test_kgfm_reference.py @@ -112,6 +112,45 @@ def test_independent_reference_covers_all_shapes(operator, cache_bytes, facts): assert not torch.allclose(engine.predict((0, (0,)), return_log_scores=True), reference.predict((0, (0,)))) +@pytest.mark.parametrize('operator', ['product', 'min']) +@pytest.mark.parametrize('facts', ['none', 'both']) +@pytest.mark.parametrize('mode', ['global', 'context_scores']) +def test_reference_applies_a_fixed_membership_threshold(operator, facts, mode): + model = Rows().eval() + context = QueryContext([(0, 0, 1), (0, 0, 2), (2, 1, 6), (1, 1, 3), (3, 2, 4), (4, 3, 5)], 7, 4) + weights = None if mode == 'global' else torch.randn(2, 8, generator=torch.Generator().manual_seed(9)).double() / 5 + conditions = [(h, r) for h in range(7) for r in range(4)] + with torch.no_grad(): + # Threshold at the median unobserved membership, so it zeroes about half of them. + memberships = QueryScoreAdapter(mode, 0., bias_bound=8., weights=weights)( + model.forward_k_vs_all(torch.tensor(conditions)), *context.features(conditions, device='cpu')).exp() + adapter = QueryScoreAdapter(mode, float(facts != 'none'), bias_bound=8., weights=weights, + membership_threshold=memberships.median().item()) + reference = reference_module.ReferenceKGFM(context.triples, 7, 4, adapter.to_dict(), beam_size=3, device='cpu', + restore_observed=facts == 'both') + with torch.no_grad(): + for start in range(0, len(conditions), 2): + batch = conditions[start:start + 2] + reference.capture(batch, model.forward_k_vs_all(torch.tensor(batch))) + # The threshold zeroes part of some rows, so ties at zero membership reach the beams. + assert any(torch.isneginf(row).any() and torch.isfinite(row).any() for row in reference.rows.values()) + engine = QueryAnswerer(model, context=context, adapter=adapter, row_batch_size=2, restore_observed=facts == 'both') + queries = [instantiate(shape) for shape in QUERY_SHAPES.values()] + engine.prefetch(queries) + for query in queries: + expected = reference.predict(query, operator) + actual = engine.predict(query, beam_size=3, tnorm='prod' if operator == 'product' else 'min', return_log_scores=True) + torch.testing.assert_close(actual, expected, atol=1e-14, rtol=1e-14) + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)) + unthresholded = reference_module.ReferenceKGFM(context.triples, 7, 4, dict(adapter.to_dict(), membership_threshold=0.), + beam_size=3, device='cpu') + unthresholded.capture([(0, 0)], model.forward_k_vs_all(torch.tensor([[0, 0]]))) + assert not torch.equal(unthresholded.rows[0, 0], reference.rows[0, 0]) + with pytest.raises(ValueError): + reference_module.ReferenceKGFM(context.triples, 7, 4, dict(adapter.to_dict(), membership_threshold=1.), + beam_size=3, device='cpu') + + @pytest.mark.parametrize('operator', ['product', 'min']) def test_reference_needs_no_rows_for_zero_prefix_but_requires_live_rows(operator): adapter = QueryScoreAdapter('context_scores', 1.) diff --git a/benchmarks/cqa/verification/reference_kgfm.py b/benchmarks/cqa/verification/reference_kgfm.py index eb0a8cff0..755f22586 100644 --- a/benchmarks/cqa/verification/reference_kgfm.py +++ b/benchmarks/cqa/verification/reference_kgfm.py @@ -9,7 +9,8 @@ class ReferenceKGFM: def __init__(self, triples, n, nr, adapter, *, beam_size, device, restore_observed=True): if (adapter['feature_mode'] not in ('context_scores', 'context_scores_v1', 'global') or adapter['hidden_dim'] - or adapter['normalization'] != 'none' or adapter['observed_mix'] not in (0, 1)): + or adapter['normalization'] != 'none' or adapter['observed_mix'] not in (0, 1) + or not 0 <= adapter.get('membership_threshold', 0.) < 1): raise ValueError('This reference covers the frozen linear observed-fact recipe') self.n, self.nr, self.adapter = n, nr, adapter self.k, self.device = beam_size, device @@ -52,6 +53,9 @@ def capture(self, conditions, raw): alpha = (bound * (u * (math.log(2) / bound)).tanh()).exp() logits = alpha[:, None] * raw + self.adapter['bias_bound'] * v.tanh()[:, None] calibrated = torch.nn.functional.logsigmoid(logits) + if self.adapter.get('membership_threshold'): + # A fixed threshold makes memberships at or below it exactly zero; observed facts still override. + calibrated = calibrated.masked_fill(calibrated <= math.log(self.adapter['membership_threshold']), -math.inf) if self.adapter['observed_mix'] == 1: calibrated = calibrated.masked_fill(observed, 0.) self.rows.update((tuple(condition), row.cpu()) for condition, row in zip(conditions, calibrated)) diff --git a/benchmarks/cqa/verification/verify_kgfm.py b/benchmarks/cqa/verification/verify_kgfm.py index 0becf9019..3e2ff710e 100644 --- a/benchmarks/cqa/verification/verify_kgfm.py +++ b/benchmarks/cqa/verification/verify_kgfm.py @@ -34,7 +34,8 @@ def initialize(engine, *args, **kwargs): original_init(engine, *args, **kwargs) scorer = engine.scorer variant = 'without-adapter' if engine.adapter.metadata.get('calibration') == 'identity' else 'learned' - expected_adapter = adapter if variant == 'learned' else dict(adapter, feature_mode='global', weights=[[0.], [0.]]) + expected_adapter = adapter if variant == 'learned' else dict(adapter, feature_mode='global', weights=[[0.], [0.]], + membership_threshold=0.) reference = ReferenceKGFM(scorer.context.triples, scorer.n, scorer.nr, expected_adapter, beam_size=entry['options']['beam_size'], device=scorer.device, restore_observed=observed_facts in (None, 'both')) From 4d075bf4b582f25c091877fec45411efa99dd025 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 19:50:01 +0200 Subject: [PATCH 23/39] feat(models): add KG-ICL with deterministic prompt graphs and fused inference Pure PyTorch reimplementation of KG-ICL (Cui et al., NeurIPS 2024) that loads the official nju-websoft/KG-ICL model_best.tar checkpoints strictly. Prompt examples and extra prompt entities are drawn from generators seeded by the prompt seed and the public relation ID; prompt encodings are cached per relation. Inference runs either upstream's hop-by-hop expansion in PyTorch, one query at a time, or batched Triton kernels whose rows are independent of the batch. Fixtures come from the pinned official code with the documented bug-fix patch applied. --- dicee/config.py | 11 + dicee/models/__init__.py | 1 + dicee/models/_fused_kgicl.py | 90 +++++ dicee/models/_triton_kgicl.py | 206 ++++++++++ dicee/models/kgicl.py | 414 +++++++++++++++++++++ dicee/models/kgicl_prompts.py | 232 ++++++++++++ dicee/scripts/run.py | 14 +- dicee/static_funcs.py | 2 + dicee/static_preprocess_funcs.py | 2 +- dicee/trainer/dice_trainer.py | 2 +- tests/fixtures/kgicl/generate_reference.py | 192 ++++++++++ tests/fixtures/kgicl/official.pt | Bin 0 -> 613848 bytes tests/fixtures/kgicl/tiny.pt | Bin 0 -> 394189 bytes tests/fixtures/kgicl/upstream-fixes.patch | 77 ++++ tests/test_kgicl.py | 396 ++++++++++++++++++++ 15 files changed, 1636 insertions(+), 3 deletions(-) create mode 100644 dicee/models/_fused_kgicl.py create mode 100644 dicee/models/_triton_kgicl.py create mode 100644 dicee/models/kgicl.py create mode 100644 dicee/models/kgicl_prompts.py create mode 100644 tests/fixtures/kgicl/generate_reference.py create mode 100644 tests/fixtures/kgicl/official.pt create mode 100644 tests/fixtures/kgicl/tiny.pt create mode 100644 tests/fixtures/kgicl/upstream-fixes.patch create mode 100644 tests/test_kgicl.py diff --git a/dicee/config.py b/dicee/config.py index e018b7e7d..d0a26ddc3 100644 --- a/dicee/config.py +++ b/dicee/config.py @@ -55,6 +55,17 @@ def __init__(self, **kwargs): self.flock_compact_state: bool = True self.flock_compile_sampler: bool = True self.flock_pack_walks: bool = True + self.kgicl_checkpoint: Optional[str] = None + self.kgicl_dim: int = 32 + self.kgicl_attn_dim: int = 5 + self.kgicl_num_layers: int = 6 + self.kgicl_prompt_layers: int = 3 + self.kgicl_prompt_hops: int = 3 + self.kgicl_shots: int = 5 + self.kgicl_prompt_open_nodes: int = 50 + self.kgicl_prompt_seed: int = 0 + self.kgicl_masked_distances: Optional[list] = None + self.kgicl_query_batch_size: int = 8 self.graph_inference_backend: str = 'auto' self.graph_relation_cache_mb: int = 64 self.graph_projection_cache_mb: int = 64 diff --git a/dicee/models/__init__.py b/dicee/models/__init__.py index 45f71cd4c..95bcdb9e0 100644 --- a/dicee/models/__init__.py +++ b/dicee/models/__init__.py @@ -12,3 +12,4 @@ from .trix import TRIX, TRIXRelation # noqa from .flock import Flock, FlockRelation # noqa +from .kgicl import KGICL # noqa diff --git a/dicee/models/_fused_kgicl.py b/dicee/models/_fused_kgicl.py new file mode 100644 index 000000000..30755df80 --- /dev/null +++ b/dicee/models/_fused_kgicl.py @@ -0,0 +1,90 @@ +"""Optional KG-ICL inference kernels; training and unsupported settings use PyTorch. + +The fused path keeps a dense ``[batch, entities, dim]`` state with an active +mask. Messages leave only active entities, so its scores equal upstream's +hop-by-hop expansion. Triton is imported only on the CUDA path. +""" +import torch +from torch.nn import functional as F + +from ._fused_message import csr_layout +from ._inference import to_device + + +def fused_reasoning_supported(model, edges): + """Whether batched Triton reasoning applies; ``backend='triton'`` raises when it cannot.""" + backend = getattr(model, '_inference_backend', 'auto') + weight = model.W_final.weight + supported = (edges[0] is model.edge_index and edges[1] is model.edge_type and weight.is_cuda + and weight.dtype == torch.float32 and model.dim <= 128 and model.attn_dim <= 16) + if backend == 'torch' or not supported: + if backend == 'triton' and not supported: + raise RuntimeError('The triton KG-ICL backend requires float32 CUDA inference on the attached graph') + return False + try: + from . import _triton_kgicl # noqa: F401 + except ImportError: + if backend == 'triton': + raise RuntimeError('The triton inference backend requires Triton') from None + return False + return True + + +def attention_width(model): + return max(2, 1 << (model.attn_dim - 1).bit_length()) + + +def layer_tables(model, relation, prompt): + """Per-layer relation states, their attention projections and the query term of one relation. + + Computed for a single relation at a time, so values never depend on which + other relations share a query batch. + """ + width = attention_width(model) + rel, result = prompt, [] + for i, layer in enumerate(model.gnn_layers): + rel = model.layer_norms_rel[i](rel + F.relu(model.rel_transfer[i](rel))) + result.append((rel, F.pad(layer.Wr_attn(rel), (0, width - model.attn_dim)), + F.pad(layer.Wqr_attn(rel[relation]), (0, width - model.attn_dim)))) + rel = model.layer_norms_rel[i](rel) + return result + + +def fused_scores(model, heads, relations, ids, prompts, edges): + """All-entity scores ``[B, N]`` and first-reach depths (or None) for a query batch.""" + from ._triton_kgicl import Workspace, aggregate, project, update + from .kgicl import RRELU_LOWER, RRELU_UPPER + + slope = (RRELU_LOWER + RRELU_UPPER) / 2 + device, batch, nodes = heads.device, len(heads), model.num_entities + unique = list(dict.fromkeys(ids)) + position = {q: i for i, q in enumerate(unique)} + tables = model._layer_tables(unique, prompts) + query_index = to_device(torch.tensor([position[q] for q in ids], dtype=torch.int32), device) + if model._destination_edges is None: + model._destination_edges = model.edge_index.flip(0).contiguous() + layout = csr_layout(model._destination_edges, model.edge_type, nodes) + width = attention_width(model) + space = Workspace(batch, nodes, model.dim, width, device) + rows = torch.arange(batch, device=device) + initial = torch.stack([prompts[q][q] for q in ids]) + space.states[0].index_put_((rows, heads), initial) + space.active[0].index_put_((rows, heads), torch.ones((), dtype=torch.int8, device=device)) + space.attention[0].index_put_((rows, heads), project(initial, model.gnn_layers[0].Ws_attn.weight, width)) + depth = None + if model.masked_distances: + depth = torch.full((batch, nodes), -1, dtype=torch.int8, device=device) + depth.index_put_((rows, heads), torch.zeros((), dtype=torch.int8, device=device)) + current = 0 + for i, layer in enumerate(model.gnn_layers): + relation_states, attention_states, query_terms = tables[i] + alpha = layer.w_alpha + aggregate(space, current, relation_states, attention_states, query_terms, query_index, + F.pad(alpha.weight[0], (0, width - model.attn_dim)), alpha.bias, layout, slope) + last = i == len(model.gnn_layers) - 1 + update(space, current, layer, model.gate, model.layer_norms[i], + None if last else model.gnn_layers[i + 1].Ws_attn.weight, model.W_final, slope, i == 0, last) + if depth is not None: + depth.masked_fill_((space.active[1 - current] != 0) & (space.active[current] == 0), i + 1) + current = 1 - current + return space.scores, depth diff --git a/dicee/models/_triton_kgicl.py b/dicee/models/_triton_kgicl.py new file mode 100644 index 000000000..4fbe2b0ac --- /dev/null +++ b/dicee/models/_triton_kgicl.py @@ -0,0 +1,206 @@ +"""Fused KG-ICL reasoning: attention-weighted CSR aggregation and GRU node updates. + +Every (query, entity) row is computed by a fixed sequence of operations with +no atomics, so rows are deterministic and independent of the query batch. +""" +import torch +import triton +import triton.language as tl +from triton.language.extra import libdevice + +EDGES = 32 + + +@triton.jit +def _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, edge, end, base, table, qc, wa, ba, feature, attention, + D: tl.constexpr, AP: tl.constexpr, SLOPE: tl.constexpr): + # One chunk of incoming edges: sigmoid query-aware attention times (h_source + r). + inside = edge < end + source = tl.load(SRC + edge, inside, other=0) + relation = tl.load(TYPE + edge, inside, other=0) + valid = inside & (tl.load(ACT + base + source, inside, other=0) != 0) + rows = (base + source)[:, None] + pre = (tl.load(AS + rows * AP + attention[None, :], valid[:, None], other=0) + + tl.load(ATBL + (table + relation)[:, None] * AP + attention[None, :], valid[:, None], other=0) + + qc[None, :]) + pre = tl.where(pre >= 0, pre, pre * SLOPE) + alpha = tl.sigmoid(tl.sum(pre * wa[None, :], axis=1) + ba) + alpha = tl.where(valid, alpha, 0.) + mask = valid[:, None] & (feature[None, :] < D) + state = tl.load(H + rows * D + feature[None, :], mask, other=0) + rel = tl.load(TBL + (table + relation)[:, None] * D + feature[None, :], mask, other=0) + return tl.sum(alpha[:, None] * (state + rel), axis=0), tl.max(valid.to(tl.int32), axis=0) + + +@triton.jit +def _tile_partials(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, P, PR, PTR, SRC, TYPE, ROWS, STARTS, TILES, + N: tl.constexpr, D: tl.constexpr, RS: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, + EDGES: tl.constexpr, SLOPE: tl.constexpr): + # One program per 32-edge tile of a high in-degree row; the row program adds them in order. + tile, batch = tl.program_id(0), tl.program_id(1).to(tl.int64) + row = tl.load(ROWS + tile) + end = tl.load(PTR + row + 1) + edge = tl.load(STARTS + tile) + tl.arange(0, EDGES) + feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) + qi = tl.load(QIDX + batch).to(tl.int64) + qc = tl.load(QC + qi * AP + attention) + total, reach = _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, edge, end, batch * N, qi * RS, qc, tl.load(WA + attention), + tl.load(BA), feature, attention, D, AP, SLOPE) + tl.store(P + (batch * TILES + tile) * D + feature, total, feature < D) + tl.store(PR + batch * TILES + tile, reach) + + +@triton.jit +def _aggregate(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, AGG, NEW, PTR, SRC, TYPE, FIRST, P, PR, TILES, + N: tl.constexpr, D: tl.constexpr, RS: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, + EDGES: tl.constexpr, SLOPE: tl.constexpr): + row, batch = tl.program_id(0).to(tl.int64), tl.program_id(1).to(tl.int64) + feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) + qi = tl.load(QIDX + batch).to(tl.int64) + qc, wa, ba = tl.load(QC + qi * AP + attention), tl.load(WA + attention), tl.load(BA) + start, end = tl.load(PTR + row), tl.load(PTR + row + 1) + first = tl.load(FIRST + row) + total = tl.zeros((FEATURES,), tl.float32) + reach = tl.zeros((), tl.int32) + if first < 0: + for chunk in range(start, end, EDGES): + value, hit = _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, chunk + tl.arange(0, EDGES), end, batch * N, qi * RS, + qc, wa, ba, feature, attention, D, AP, SLOPE) + total += value + reach = tl.maximum(reach, hit) + else: + count = (end - start + EDGES - 1) // EDGES + for block in range(0, count): + total += tl.load(P + (batch * TILES + first + block) * D + feature, feature < D, other=0) + reach = tl.maximum(reach, tl.load(PR + batch * TILES + first + block)) + current = batch * N + row + active = tl.load(ACT + current) + if active != 0: + # The implicit self-loop edge with relation slot RS - 1. + pre = tl.load(AS + current * AP + attention) + tl.load(ATBL + (qi * RS + RS - 1) * AP + attention) + qc + pre = tl.where(pre >= 0, pre, pre * SLOPE) + alpha = tl.sigmoid(tl.sum(pre * wa, axis=0) + ba) + state = tl.load(H + current * D + feature, feature < D, other=0) + rel = tl.load(TBL + (qi * RS + RS - 1) * D + feature, feature < D, other=0) + total += alpha * (state + rel) + tl.store(AGG + current * D + feature, total, feature < D) + tl.store(NEW + current, ((active != 0) | (reach != 0)).to(tl.int8)) + + +@triton.jit +def _matrix(W, rows, columns, R: tl.constexpr, C: tl.constexpr): + # W[rows, columns] for an [R, C] row-major matrix, transposed for x @ W.T; padding is zero. + return tl.load(W + columns[None, :] * C + rows[:, None], (rows[:, None] < C) & (columns[None, :] < R), other=0) + + +@triton.jit +def _gate(x, W, B, index: tl.constexpr, feature, D: tl.constexpr): + # One GRU gate block: x @ W[index * D:(index + 1) * D].T + b[index * D:(index + 1) * D]. + value = tl.dot(x, _matrix(W + index * D * D, feature, feature, D, D), input_precision="ieee") + return value + tl.load(B + index * D + feature, feature < D, other=0)[None, :] + + +@triton.jit +def _update(AGG, H, NEW, OUT, AS, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WS, WF, TOTAL, + D: tl.constexpr, A: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, ROWS: tl.constexpr, + EPS: tl.constexpr, SLOPE: tl.constexpr, FIRST: tl.constexpr, LAST: tl.constexpr): + # RReLU(W_h agg) -> LayerNorm -> GRU cell with the previous state; inactive rows stay zero. + # The first layer's GRU state is zero: the query embedding at the head is only a message input. + rows = tl.program_id(0).to(tl.int64) * ROWS + tl.arange(0, ROWS) + feature = tl.arange(0, FEATURES) + inside = rows < TOTAL + mask = inside[:, None] & (feature[None, :] < D) + offsets = rows[:, None] * D + feature[None, :] + x = tl.load(AGG + offsets, mask, other=0) + if FIRST: + previous = tl.zeros((ROWS, FEATURES), tl.float32) + else: + previous = tl.load(H + offsets, mask, other=0) + active = tl.load(NEW + rows, inside, other=0) != 0 + y = tl.dot(x, _matrix(WH, feature, feature, D, D), input_precision="ieee") + y = tl.where(y >= 0, y, y * SLOPE) + y = tl.where(feature[None, :] < D, y, 0.) + mean = tl.sum(y, axis=1) / D + centered = tl.where(feature[None, :] < D, y - mean[:, None], 0.) + variance = tl.sum(centered * centered, axis=1) / D + norm_weight = tl.load(LNW + feature, feature < D, other=0) + norm_bias = tl.load(LNB + feature, feature < D, other=0) + y = centered * tl.rsqrt(variance + EPS)[:, None] * norm_weight[None, :] + norm_bias[None, :] + reset = tl.sigmoid(_gate(y, WIH, BIH, 0, feature, D) + _gate(previous, WHH, BHH, 0, feature, D)) + update = tl.sigmoid(_gate(y, WIH, BIH, 1, feature, D) + _gate(previous, WHH, BHH, 1, feature, D)) + candidate = libdevice.tanh(_gate(y, WIH, BIH, 2, feature, D) + reset * _gate(previous, WHH, BHH, 2, feature, D)) + state = (1 - update) * candidate + update * previous + state = tl.where(active[:, None] & (feature[None, :] < D), state, 0.) + if LAST: + weight = tl.load(WF + feature, feature < D, other=0) + tl.store(SCORE + rows, tl.sum(state * weight[None, :], axis=1), inside) + else: + tl.store(OUT + offsets, state, mask) + attention = tl.arange(0, AP) + projection = tl.load(WS + attention[:, None] * D + feature[None, :], + (attention[:, None] < A) & (feature[None, :] < D), other=0) + values = tl.sum(state[:, None, :] * projection[None, :, :], axis=2) + tl.store(AS + rows[:, None] * AP + attention[None, :], values, inside[:, None]) + + +@triton.jit +def _project(X, W, OUT, TOTAL, D: tl.constexpr, A: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr): + # Attention projection of single rows, with the reduction used by _update. + row = tl.program_id(0) + feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) + state = tl.load(X + row * D + feature, feature < D, other=0) + projection = tl.load(W + attention[:, None] * D + feature[None, :], (attention[:, None] < A) & (feature[None, :] < D), other=0) + values = tl.sum(state[None, :] * projection, axis=1) + tl.store(OUT + row * AP + attention, values) + + +class Workspace: + """Per-call activation buffers for one query batch.""" + + def __init__(self, batch, nodes, dim, ap, device): + self.states = [torch.zeros(batch, nodes, dim, device=device) for _ in range(2)] + self.attention = [torch.zeros(batch, nodes, ap, device=device) for _ in range(2)] + self.active = [torch.zeros(batch, nodes, dtype=torch.int8, device=device) for _ in range(2)] + self.aggregate = torch.empty(batch, nodes, dim, device=device) + self.scores = torch.empty(batch, nodes, device=device) + + +def project(rows, weight, ap): + output = rows.new_zeros(len(rows), ap) + if len(rows): + _project[(len(rows),)](rows, weight, output, len(rows), rows.shape[-1], weight.shape[0], ap, + max(16, triton.next_power_of_2(rows.shape[-1])), num_warps=1, enable_fp_fusion=False) + return output + + +def aggregate(space, current, tables, attention_tables, query_constants, query_index, alpha_weight, alpha_bias, layout, slope): + batch, nodes, dim = space.states[current].shape + ap = space.attention[current].shape[-1] + relation_slots = tables.shape[1] + features = max(16, triton.next_power_of_2(dim)) + edges = (layout.offsets, layout.sources, layout.types) + hubs = len(layout.hub_rows) + partials = torch.empty((batch, max(hubs, 1), dim), device=tables.device) + flags = torch.empty((batch, max(hubs, 1)), dtype=torch.int32, device=tables.device) + common = (space.states[current], space.attention[current], space.active[current], tables, attention_tables, + query_constants, query_index, alpha_weight, alpha_bias) + if hubs: + _tile_partials[(hubs, batch)](*common, partials, flags, *edges, layout.hub_rows, layout.hub_starts, hubs, + nodes, dim, relation_slots, ap, features, EDGES, slope, num_warps=4, enable_fp_fusion=False) + _aggregate[(nodes, batch)](*common, space.aggregate, space.active[1 - current], *edges, layout.hub_first, partials, flags, + max(hubs, 1), nodes, dim, relation_slots, ap, features, EDGES, slope, + num_warps=4, enable_fp_fusion=False) + + +def update(space, current, layer, gate, norm, next_projection, final, slope, first, last): + batch, nodes, dim = space.states[current].shape + ap = space.attention[current].shape[-1] + total = batch * nodes + rows = 32 + projection = next_projection if next_projection is not None else final.weight + _update[(triton.cdiv(total, rows),)]( + space.aggregate, space.states[current], space.active[1 - current], space.states[1 - current], space.attention[1 - current], + space.scores, layer.W_h.weight, norm.weight, norm.bias, gate.weight_ih_l0, gate.weight_hh_l0, gate.bias_ih_l0, + gate.bias_hh_l0, projection, final.weight, total, dim, + next_projection.shape[0] if next_projection is not None else 1, ap, + max(16, triton.next_power_of_2(dim)), rows, norm.eps, slope, first, last, num_warps=4, enable_fp_fusion=False) diff --git a/dicee/models/kgicl.py b/dicee/models/kgicl.py new file mode 100644 index 000000000..8905ccf2b --- /dev/null +++ b/dicee/models/kgicl.py @@ -0,0 +1,414 @@ +"""Pure PyTorch KG-ICL, compatible with the official nju-websoft/KG-ICL checkpoints. + +Reimplementation of Cui et al., "A Prompt-Based Knowledge Graph Foundation +Model for Universal In-Context Reasoning" (NeurIPS 2024, +https://arxiv.org/abs/2410.12288), verified against +https://github.com/nju-websoft/KG-ICL at UPSTREAM_COMMIT. Module names follow +the released ``model_best.tar`` state dictionaries. Prompt graphs are runtime +context derived from the attached graph (see kgicl_prompts.py), never part of +the transferable state. docs/kgicl.md documents the corrected upstream defects. +""" +from collections import OrderedDict +from typing import Optional, Sequence + +import torch +from torch import nn +from torch.nn import functional as F + +from ._fused_kgicl import attention_width, fused_reasoning_supported, fused_scores, layer_tables +from ._inference import candidate_features, candidate_slice, host_ids, inference_only +from .graph_model import GraphKGE +from .kgicl_prompts import PromptGraph, PromptSampler + +UPSTREAM_COMMIT = "6a3166e347ae468acdfb30a70a2cf3608b66b8f1" +# nn.RReLU's default bounds; in evaluation its negative slope is their mean. +RRELU_LOWER, RRELU_UPPER = 1. / 8, 1. / 3 + + +class PromptEncoder(nn.Module): + """Upstream ``PromptEncoder`` with the released configuration. + + Settings: unified tokens, concatenated entity messages, sigmoid attention, + max aggregation for entities and relations. Relation tokens start at zero + except the query relation. ``ent_norm`` multiplies messages twice, as in + the released model, so the checkpoints keep their trained behavior. + """ + + def __init__(self, dim=32, num_layers=3, hops=3): + super().__init__() + self.dim, self.num_layers, self.hops = dim, num_layers, hops + self.start_relation_embeddings = nn.Embedding(1, dim) + self.position_embedding = nn.Embedding((hops + 1) ** 2, dim) + self.self_loop_embedding = nn.Embedding(1, dim) + for embedding in (self.start_relation_embeddings, self.position_embedding, self.self_loop_embedding): + nn.init.xavier_normal_(embedding.weight.data) + self.act = nn.RReLU() + self.W_ht2r = nn.ModuleList([nn.Linear(3 * dim, dim) for _ in range(num_layers)]) + self.W_message = nn.ModuleList([nn.Linear(3 * dim, dim) for _ in range(num_layers)]) + self.alpha = nn.ModuleList([nn.Linear(2 * dim, 1) for _ in range(num_layers)]) + self.beta = nn.ModuleList([nn.Linear(2 * dim, 1) for _ in range(num_layers)]) + self.loop_transfer = nn.ModuleList([nn.Linear(2 * dim, dim) for _ in range(num_layers)]) + self.ent_transfer = nn.ModuleList([nn.Linear(dim, dim) for _ in range(num_layers)]) + self.rel_transfer = nn.ModuleList([nn.Linear(dim, dim) for _ in range(num_layers)]) + self.final_to_rel_embeddings = nn.Linear(dim * num_layers, dim) + self.dropout = nn.Dropout(0.3) + self.layer_norm_rels = nn.ModuleList([nn.LayerNorm(dim) for _ in range(num_layers + 1)]) + self.layer_norm_ents = nn.ModuleList([nn.LayerNorm(dim) for _ in range(num_layers + 1)]) + self.layer_norm_loop = nn.ModuleList([nn.LayerNorm(dim) for _ in range(num_layers + 1)]) + + @staticmethod + def _max(values, index, size): + # torch_scatter.scatter_max semantics: empty groups are zero. + out = values.new_zeros(size, values.shape[-1]) + return out.scatter_reduce(0, index[:, None].expand_as(values), values, 'amax', include_self=False) + + def forward(self, graphs: Sequence[PromptGraph], relation: int, num_relations: int) -> torch.Tensor: + """Mean prompt representation ``[num_relations + 1, dim]``; the last row is the self-loop relation.""" + device = self.position_embedding.weight.device + shots = len(graphs) + sizes = torch.tensor([g.num_nodes for g in graphs]) + node_offsets = torch.cat((sizes.new_zeros(1), sizes.cumsum(0)[:-1])) + num_nodes = int(sizes.sum()) + edge_index = torch.cat([g.edge_index + offset for g, offset in zip(graphs, node_offsets.tolist())], 1).to(device) + slots = torch.arange(shots) * num_relations + edge_type = torch.cat([g.edge_type + slot for g, slot in zip(graphs, slots.tolist())]).to(device) + edge_query = torch.cat([torch.full((g.edge_type.numel(),), relation + slot) for g, slot in zip(graphs, slots.tolist())]).to(device) + labels = torch.cat([g.labels for g in graphs]).to(device) + heads = (node_offsets + torch.tensor([g.head for g in graphs])).to(device) + tails = (node_offsets + torch.tensor([g.tail for g in graphs])).to(device) + query_slots = (relation + slots).to(device) + + node = self.position_embedding.weight[labels[:, 0] * (self.hops + 1) + labels[:, 1]] + node = node.index_put((heads,), self.position_embedding.weight[0].expand(shots, -1)) + node = node.index_put((tails,), self.position_embedding.weight[1].expand(shots, -1)) + rel = node.new_zeros(num_relations * shots, self.dim) + rel = rel.index_put((query_slots,), self.start_relation_embeddings.weight[0].expand(shots, -1)) + loop = self.self_loop_embedding.weight.expand(shots, -1) + source, target = edge_index + degree = torch.zeros(num_nodes, device=device).index_add_(0, target, torch.ones_like(target, dtype=node.dtype)) + inverse_sqrt = degree.pow(-0.5) + inverse_sqrt = inverse_sqrt.masked_fill(inverse_sqrt == float('inf'), 0) + norm = (inverse_sqrt[target] * inverse_sqrt[source])[:, None] + layers = [] + for i in range(self.num_layers): + r, q = rel[edge_type], rel[edge_query] + h = node[source] + message = self.act(self.W_message[i](torch.cat((h, r, q), -1))) + alpha = torch.sigmoid(self.alpha[i](self.act(torch.cat((r, q), -1)))) + message = message * alpha * norm * norm + node = self.act(self.ent_transfer[i](self._max(message, target, num_nodes))) + node = self.layer_norm_ents[i](node) + message = self.act(self.W_ht2r[i](torch.cat((node[source], node[target], q), -1))) + message = message * torch.sigmoid(self.beta[i](torch.cat((r, q), -1))) + rel = self.act(self.rel_transfer[i](self._max(message, edge_type, len(rel)))) + rel + rel = self.layer_norm_rels[i](rel) + layers.append(rel) + loop = loop + self.act(self.loop_transfer[i](torch.cat((loop, rel[query_slots]), -1))) + loop = self.layer_norm_loop[i](loop) + final = self.layer_norm_rels[-1](self.act(self.final_to_rel_embeddings(torch.cat(layers, -1)))) + final = self.dropout(final.view(shots, num_relations, self.dim).mean(0)) + return torch.cat((final, loop.mean(0, keepdim=True))) + + +class _UnusedConv(nn.Module): + """Parameters of the official checkpoints' unused NBFNet layer, kept for strict loading.""" + + def __init__(self, dim): + super().__init__() + self.linear = nn.Linear(2 * dim, dim) + self.relation_projection = nn.Sequential(nn.Linear(dim, dim), nn.ReLU(), nn.Linear(dim, dim)) + + +class GNNLayer(nn.Module): + """Query-aware attention with TransE-style ``h + r`` messages and sum aggregation.""" + + def __init__(self, dim=32, attn_dim=5): + super().__init__() + self.inference_backend = 'auto' + self.Ws_attn = nn.Linear(dim, attn_dim, bias=False) + self.Wr_attn = nn.Linear(dim, attn_dim, bias=False) + self.Wqr_attn = nn.Linear(dim, attn_dim) + self.w_alpha = nn.Linear(attn_dim, 1) + self.W_h = nn.Linear(dim, dim, bias=False) + self.conv = _UnusedConv(dim) + self.act = nn.RReLU() + + def forward(self, hidden, source, edge_batch, edge_relation, target, num_targets, relations, query): + hs = hidden[source] + hr = relations[edge_batch, edge_relation] + hq = relations[edge_batch, query[edge_batch]] + # Upstream constructs a fresh nn.RReLU per call, which always samples + # random slopes. Evaluation uses the module's deterministic mean slope. + attention = F.rrelu(self.Ws_attn(hs) + self.Wr_attn(hr) + self.Wqr_attn(hq), RRELU_LOWER, RRELU_UPPER, self.training) + alpha = torch.sigmoid(self.w_alpha(attention)) + message = alpha * (hs + hr) + aggregate = hidden.new_zeros(num_targets, hidden.shape[-1]).index_add_(0, target, message) + return self.act(self.W_h(aggregate)) + + +class KGICL(GraphKGE): + """KG-ICL entity prediction with the official state dictionary and DICE triple order. + + Prompt graphs for a query relation are drawn deterministically from the + attached graph; their encodings are cached per relation. The reasoner + expands one hop per layer from the query head, as upstream does: entities + outside the reached set have no state and score zero. + """ + + name = 'KGICL' + config_prefix = 'kgicl' + graph_filename = 'kgicl_graph.pt' + checkpoint_hint = ('official KG-ICL-6L requires kgicl_dim=32, kgicl_attn_dim=5, kgicl_num_layers=6, ' + 'kgicl_prompt_layers=3, kgicl_prompt_hops=3; all keys and shapes must match') + deterministic_inference = True + + def __init__(self, args): + super().__init__(args) + self.dim = args.get('kgicl_dim', 32) + self.attn_dim = args.get('kgicl_attn_dim', 5) + self.num_layers = args.get('kgicl_num_layers', 6) + self.prompt_layers = args.get('kgicl_prompt_layers', 3) + self.prompt_hops = args.get('kgicl_prompt_hops', 3) + self.shots = args.get('kgicl_shots', 5) + self.open_nodes = args.get('kgicl_prompt_open_nodes', 50) + self.prompt_seed = args.get('kgicl_prompt_seed', 0) + masked = args.get('kgicl_masked_distances') + self.masked_distances = tuple(sorted(set(int(d) for d in masked))) if masked else () + if min(self.dim, self.attn_dim, self.num_layers, self.prompt_layers, self.prompt_hops, self.shots) < 1: + raise ValueError('KG-ICL dimensions, layers, hops and shots must be positive') + if self.open_nodes < 0 or any(d < 0 for d in self.masked_distances): + raise ValueError('KG-ICL open nodes and masked distances must be nonnegative') + if not isinstance(self.prompt_seed, int) or not 0 <= self.prompt_seed < 2 ** 63: + raise ValueError('kgicl_prompt_seed must be a nonnegative integer less than 2**63') + self.relation_encoder = PromptEncoder(self.dim, self.prompt_layers, self.prompt_hops) + self.gnn_layers = nn.ModuleList([GNNLayer(self.dim, self.attn_dim) for _ in range(self.num_layers)]) + self.rel_transfer = nn.ModuleList([nn.Linear(self.dim, self.dim) for _ in range(self.num_layers)]) + self.layer_norms = nn.ModuleList([nn.LayerNorm(self.dim) for _ in range(self.num_layers)]) + self.layer_norms_rel = nn.ModuleList([nn.LayerNorm(self.dim) for _ in range(self.num_layers)]) + # Unused by the released model's forward pass; retained for strict checkpoint loading. + self.layer_norms_query = nn.ModuleList([nn.LayerNorm(self.dim) for _ in range(self.num_layers)]) + self.query_transfer = nn.ModuleList([nn.Linear(self.dim, self.dim) for _ in range(self.num_layers)]) + self.W_score = nn.ModuleList([nn.Linear(2 * self.dim, 1, bias=False) for _ in range(self.num_layers)]) + self.dropout = nn.Dropout(args.get('kgicl_dropout', 0.0)) + self.W_final = nn.Linear(self.dim, 1, bias=False) + self.gate = nn.GRU(self.dim, self.dim) + self.prompt_cache_mb = args.get('graph_relation_cache_mb', 64) + self.table_cache_mb = args.get('graph_projection_cache_mb', 64) + if min(self.prompt_cache_mb, self.table_cache_mb) < 0: + raise ValueError('Graph cache limits must be nonnegative') + self._prompt_overrides = {} + self._sampler: Optional[PromptSampler] = None + self.set_inference_backend(args.get('graph_inference_backend', 'auto')) + + # ----- checkpoint, graph and cache lifecycle ----- + + def load_pretrained(self, path): + """Load an official ``model_best.tar`` (``state_dict`` key), a ``model`` wrapper or a bare state.""" + state = torch.load(path, map_location='cpu', weights_only=True) + if 'state_dict' in state and isinstance(state['state_dict'], dict): + state = state['state_dict'] + state = state.get('model', state) + expected = self.state_dict() + if set(state) != set(expected) or any(state[k].shape != expected[k].shape for k in expected): + raise ValueError(f'Checkpoint architecture mismatch for {self.name}: {self.checkpoint_hint}') + self.load_state_dict(state, strict=True) + return self + + def clear_inference_cache(self): + self._prompt_cache = OrderedDict() + self._prompt_cache_token = None + self._table_cache = OrderedDict() + self._table_cache_token = None + self._layout = None + self._destination_edges = None + + def _build_relation_graph(self): + # KG-ICL samples prompt graphs lazily; no relation graph is constructed. + self.clear_inference_cache() + self._sampler = None + self._prompt_overrides = {} + + def prompt_settings(self): + """Settings that determine prompt graphs and score masks, for cache identities.""" + return (self.shots, self.prompt_hops, self.open_nodes, self.prompt_seed, self.masked_distances, + tuple(sorted((q, id(g)) for q, g in self._prompt_overrides.items()))) + + def inference_token(self): + token = super().inference_token() + return None if token is None else (*token, self.prompt_settings()) + + @property + def sampler(self) -> PromptSampler: + """Prompt sampler of the attached graph, created on first use.""" + self._require_graph() + if self._sampler is None: + mapping = self.relation_id_map.detach().cpu().tolist() + public = {internal: external for external, internal in enumerate(mapping)} + self._sampler = PromptSampler(self.graph_triples, self.num_entities, self.num_direct_relations, + [public[r] for r in range(self.num_direct_relations)], shots=self.shots, + hops=self.prompt_hops, open_nodes=self.open_nodes, seed=self.prompt_seed) + return self._sampler + + def use_prompts(self, prompts: Optional[dict] = None): + """Replay fixed prompt graphs, keyed by internal query relation; ``None`` restores sampling. + + Each value lists one ``PromptGraph`` per shot. Attaching a graph clears the replay. + """ + prompts = dict(prompts or {}) + if any(len(graphs) < 1 for graphs in prompts.values()): + raise ValueError('Replayed prompts need at least one graph per relation') + self._prompt_overrides = {int(q): list(graphs) for q, graphs in prompts.items()} + self.clear_inference_cache() + return self + + def prompt_graphs(self, relation: int) -> list: + """Prompt graphs of an internal query relation; training draws examples with replacement.""" + if relation in self._prompt_overrides: + return self._prompt_overrides[relation] + sampler = self.sampler + slots = None + if self.training: + # Upstream training picks one of the loaded examples at random for each shot. + count = len(sampler.examples(relation % self.num_direct_relations)) + if count: + slots = torch.randint(count, (self.shots,)).tolist() + return sampler.prompts(relation, slots) + + def encode_prompts(self, relation: int, graphs: Optional[Sequence[PromptGraph]] = None) -> torch.Tensor: + """Prompt representation ``[2R + 1, dim]`` of an internal query relation.""" + self._require_graph() + graphs = self.prompt_graphs(relation) if graphs is None else graphs + return self.relation_encoder(graphs, relation, 2 * self.num_direct_relations) + + def _prompts(self, relations): + """Per-query prompt representations, cached by relation during inference.""" + ids = host_ids(relations) + token = self.inference_token() if inference_only(self) and self.prompt_cache_mb else None + if token is None: + values = {q: self.encode_prompts(q) for q in dict.fromkeys(ids)} + return values, ids + if token != self._prompt_cache_token: + self._prompt_cache.clear() + self._prompt_cache_token = token + capacity = int(self.prompt_cache_mb * 2**20) // ((2 * self.num_direct_relations + 1) * self.dim + * next(self.parameters()).element_size()) + values = {} + for q in dict.fromkeys(ids): + if q not in self._prompt_cache: + self._prompt_cache[q] = self.encode_prompts(q).detach() + self._prompt_cache.move_to_end(q) + values[q] = self._prompt_cache[q] + # Keep current-call values alive even when they exceed the LRU capacity. + while len(self._prompt_cache) > max(capacity, 1): + self._prompt_cache.popitem(last=False) + return values, ids + + def _layer_tables(self, relations, prompts): + """Stacked per-layer relation tables of the fused path, cached per relation like prompts.""" + token = self._prompt_cache_token + size = (self.num_layers * (2 * self.num_direct_relations + 1) * (self.dim + attention_width(self)) + * next(self.parameters()).element_size()) + capacity = int(self.table_cache_mb * 2**20) // size + if token is None or not capacity: + values = {q: layer_tables(self, q, prompts[q]) for q in relations} + else: + if token != self._table_cache_token: + self._table_cache.clear() + self._table_cache_token = token + values = {} + for q in relations: + if q not in self._table_cache: + self._table_cache[q] = layer_tables(self, q, prompts[q]) + self._table_cache.move_to_end(q) + values[q] = self._table_cache[q] + while len(self._table_cache) > max(capacity, 1): + self._table_cache.popitem(last=False) + return [tuple(torch.stack([values[q][i][k] for q in relations]) for k in range(3)) + for i in range(self.num_layers)] + + # ----- reasoning ----- + + def _out_edges(self, edges): + """Edges grouped by source entity: offsets [N + 1], targets, types.""" + cached = self._layout + if cached is not None and cached[0] is edges[0] and cached[1] is edges[1]: + return cached[2] + edge_index, edge_type = edges + order = edge_index[0].argsort(stable=True) + counts = torch.bincount(edge_index[0], minlength=self.num_entities) + layout = (torch.cat((counts.new_zeros(1), counts.cumsum(0))), edge_index[1, order], edge_type[order]) + if not self.training: + self._layout = (edge_index, edge_type, layout) + return layout + + def _expand_scores(self, heads, relations, prompts, edges): + """Upstream's hop-by-hop reasoning for a batch; returns ``[B, N]`` scores and first-reach depths.""" + n, dim = self.num_entities, self.dim + offsets, targets, types = self._out_edges(edges) + self_loop = 2 * self.num_direct_relations + batch = torch.arange(len(heads), device=heads.device) + node_batch, node_entity = batch, heads + hidden = prompts[batch, relations] + rel, state = prompts, None + depth = heads.new_zeros(len(heads)) + for i, layer in enumerate(self.gnn_layers): + counts = offsets[node_entity + 1] - offsets[node_entity] + source = torch.arange(len(node_entity), device=heads.device).repeat_interleave(counts) + starts = offsets[node_entity].repeat_interleave(counts) + position = starts + torch.arange(len(source), device=heads.device) - (counts.cumsum(0) - counts).repeat_interleave(counts) + loops = torch.arange(len(node_entity), device=heads.device) + source = torch.cat((source, loops)) + edge_relation = torch.cat((types[position], torch.full_like(loops, self_loop))) + edge_target = torch.cat((targets[position], node_entity)) + edge_batch = node_batch[source] + keys, target = (edge_batch * n + edge_target).unique(sorted=True, return_inverse=True) + previous = torch.searchsorted(keys, node_batch * n + node_entity) + rel = self.layer_norms_rel[i](rel + F.relu(self.rel_transfer[i](rel))) + hidden = layer(hidden, source, edge_batch, edge_relation, target, len(keys), rel, relations) + initial = hidden.new_zeros(len(keys), dim) + if state is not None: + initial = initial.index_copy(0, previous, state) + hidden = self.layer_norms[i](self.dropout(hidden)) + hidden, state = self.gate(hidden.unsqueeze(0), initial.unsqueeze(0)) + hidden, state = hidden.squeeze(0), state.squeeze(0) + rel = self.layer_norms_rel[i](rel) + depth = torch.full_like(keys, i + 1).index_copy(0, previous, depth) + node_batch, node_entity = keys // n, keys % n + scores = hidden.new_zeros(len(heads), n).index_put((node_batch, node_entity), self.W_final(hidden).squeeze(-1)) + reached = torch.full((len(heads), n), -1, dtype=torch.long, device=heads.device) + reached = reached.index_put((node_batch, node_entity), depth) + return scores, reached + + def _mask_distances(self, scores, depth, evaluation): + """Zero entities first reached at masked distances; upstream masks heads also in training.""" + masked = [d for d in self.masked_distances if evaluation or d == 0] + if masked and depth is not None: + scores = scores.masked_fill(torch.isin(depth, torch.tensor(masked, device=depth.device)), 0) + return scores + + def _all_scores(self, heads, relations, edges, fused): + values, ids = self._prompts(relations) + if fused: + scores, depth = fused_scores(self, heads, relations, ids, values, edges) + else: + prompts = torch.stack([values[q] for q in ids]) + scores, depth = self._expand_scores(heads, relations, prompts, edges) + return self._mask_distances(scores, depth, not self.training) + + def _score(self, heads, relations, candidates, query_relations, edges): + # Query conditioning uses the actual (possibly inverse) relation, as upstream does. + self._require_graph() + output = [] + inference = inference_only(self) + fused = inference and fused_reasoning_supported(self, edges) + # Batched GPU reasoning is row-wise; the PyTorch path scores each query + # alone during inference, so a row never depends on its batch. + chunk = self.query_batch_size if fused or not inference else 1 + ids = host_ids(relations) + for start in range(0, len(heads), chunk): + sl = slice(start, start + chunk) + part = relations[sl] + part._dicee_ids = ids[sl] + scores = self._all_scores(heads[sl], part, edges, fused) + output.append(candidate_features(scores[..., None], candidate_slice(candidates, sl)).squeeze(-1)) + return torch.cat(output) if output else next(self.parameters()).new_empty((0, candidates.shape[1])) diff --git a/dicee/models/kgicl_prompts.py b/dicee/models/kgicl_prompts.py new file mode 100644 index 000000000..ddee382f6 --- /dev/null +++ b/dicee/models/kgicl_prompts.py @@ -0,0 +1,232 @@ +"""KG-ICL prompt graphs: deterministic example sampling and extraction. + +Semantics follow nju-websoft/KG-ICL at UPSTREAM_COMMIT (``utils_all.py`` and +``data_loader.py``), with the prompt construction of the released datasets: +an example fact ``(u, q, v)``, every entity ``x`` within ``hops`` of both ``u`` +and ``v`` with ``dist(x,u) + dist(x,v) <= hops``, up to ``open_nodes`` further +entities within ``hops`` of both, and every fact among the selected entities. +Upstream draws examples and the additional entities with unseeded NumPy +calls. Here every draw comes from a generator seeded by the prompt seed and +the public ID of the direct relation, so a graph and relation always yield +the same prompt graphs, independently of query batches and call order. +docs/kgicl.md lists the upstream defects that are corrected here. +""" +import hashlib +from dataclasses import dataclass +from typing import Optional + +import torch + +UNREACHED = 1 << 30 + + +def prompt_generator(*values: int) -> torch.Generator: + """A CPU generator seeded from integer values, stable across processes and platforms.""" + text = 'kgicl-prompt:' + ':'.join(str(int(v)) for v in values) + return torch.Generator().manual_seed(int(hashlib.sha256(text.encode()).hexdigest()[:15], 16)) + + +@dataclass(frozen=True, eq=False) +class PromptGraph: + """One prompt graph in encoder layout, specialized for a query relation. + + ``edge_index`` holds local (head, tail) pairs of every prompt fact and its + inverse. ``edge_type`` uses internal relation IDs: direct relations in + ``[0, R)`` and their inverses in ``[R, 2R)``. ``labels`` are the distance + tokens ``(dist to u, dist to v)`` of the example fact ``(u, q, v)``; + ``head`` and ``tail`` are the local nodes that receive the head and tail + tokens. For an inverse query relation they are swapped, as upstream does. + """ + + edge_index: torch.Tensor + edge_type: torch.Tensor + labels: torch.Tensor + head: int + tail: int + + @property + def num_nodes(self) -> int: + return len(self.labels) + + +@dataclass(frozen=True, eq=False) +class PromptExample: + """An example fact's extracted prompt graph, before specialization to a query relation. + + ``entities`` maps local nodes to graph entities: node 0 is the example head + and, unless the example is a self-loop, node 1 its tail. ``triples`` are the + deduplicated direct facts among these entities in local IDs. + """ + entities: torch.Tensor # [n] + triples: torch.Tensor # [E, 3] + labels: torch.Tensor # [n, 2] + self_loop: bool + + +def _csr(keys, values, size): + order = keys.argsort(stable=True) + counts = torch.bincount(keys, minlength=size) + return torch.cat((counts.new_zeros(1), counts.cumsum(0))), values[order] + + +def _gather(offsets, values, nodes): + """Concatenated CSR rows of ``nodes``, in node order.""" + starts, counts = offsets[nodes], offsets[nodes + 1] - offsets[nodes] + total = int(counts.sum()) + if not total: + return values[:0] + rows = torch.arange(len(nodes)).repeat_interleave(counts) + index = starts[rows] + torch.arange(total) - (counts.cumsum(0) - counts)[rows] + return values[index] + + +class PromptSampler: + """Deterministic prompt graphs of an attached graph, kept on the host. + + Args: + triples: ``[N, 3]`` internal (head, relation, tail) facts including + inverse facts, as attached by ``GraphKGE.set_graph``. + num_entities: Entity vocabulary size. + num_direct: Number of direct relations ``R``; inverse IDs are ``r + R``. + public_relations: Public ID of each internal direct relation, used for seeding. + shots: Prompt graphs per query relation (upstream ``shot``). + hops: Distance bound ``k`` (upstream ``hop``/``path_hop``). + open_nodes: Additional entities beyond ``dist(x,u) + dist(x,v) <= k`` + (upstream ``enclosing=False``: 50). + seed: Prompt seed. + """ + + def __init__(self, triples: torch.Tensor, num_entities: int, num_direct: int, public_relations: list, + shots: int = 5, hops: int = 3, open_nodes: int = 50, seed: int = 0): + triples = triples.detach().cpu().long() + direct = triples[triples[:, 1] < num_direct].unique(dim=0) + self.num_entities, self.num_direct = num_entities, num_direct + self.public_relations = list(public_relations) + self.shots, self.hops, self.open_nodes, self.seed = shots, hops, open_nodes, seed + # Facts of each relation in canonical (head, tail) order. + relation_order = (direct[:, 1] * num_entities + direct[:, 0]) * num_entities + direct[:, 2] + direct = direct[relation_order.argsort()] + self.relation_offsets = torch.cat((torch.zeros(1, dtype=torch.long), + torch.bincount(direct[:, 1], minlength=num_direct).cumsum(0))) + self.relation_facts = direct[:, [0, 2]] + # Facts by head, for induced subgraphs, and an undirected simple adjacency for distances. + self.head_offsets, self.head_facts = _csr(direct[:, 0], direct, num_entities) + pairs = torch.cat((direct[:, [0, 2]], direct[:, [2, 0]])) + pairs = pairs[pairs[:, 0] != pairs[:, 1]].unique(dim=0) + self.adjacency_offsets, self.adjacency = _csr(pairs[:, 0], pairs[:, 1], num_entities) + self._examples = {} + + def distances(self, source: int) -> torch.Tensor: + """Undirected hop distances from ``source`` up to ``hops``; farther entities are ``UNREACHED``.""" + distance = torch.full((self.num_entities,), UNREACHED, dtype=torch.long) + distance[source] = 0 + frontier = torch.tensor([source]) + for step in range(1, self.hops + 1): + neighbors = _gather(self.adjacency_offsets, self.adjacency, frontier).unique() + frontier = neighbors[distance[neighbors] == UNREACHED] + if not len(frontier): + break + distance[frontier] = step + return distance + + def extract(self, head: int, tail: int, generator: Optional[torch.Generator] = None) -> PromptExample: + """Prompt graph of the example fact ``(head, ?, tail)``, before query specialization.""" + to_head, to_tail = self.distances(head), self.distances(tail) + within = (to_head <= self.hops) & (to_tail <= self.hops) + within[[head, tail]] = False + candidates = within.nonzero().flatten() + total = to_head[candidates] + to_tail[candidates] + close, far = candidates[total <= self.hops], candidates[total > self.hops] + if len(far) > self.open_nodes: + far = far[torch.randperm(len(far), generator=generator)[:self.open_nodes]].sort().values + rest = torch.cat((close, far)).sort().values + nodes = torch.cat((torch.tensor([head] if head == tail else [head, tail]), rest)) + local = torch.full((self.num_entities,), -1, dtype=torch.long) + local[nodes] = torch.arange(len(nodes)) + facts = _gather(self.head_offsets, self.head_facts, nodes) + facts = facts[local[facts[:, 2]] >= 0] + triples = torch.stack((local[facts[:, 0]], facts[:, 1], local[facts[:, 2]]), 1) + labels = torch.stack((to_head[nodes], to_tail[nodes]), 1) + if head == tail: + labels[0] = torch.tensor([0, 0]) + else: + labels[0], labels[1] = torch.tensor([0, 1]), torch.tensor([1, 0]) + return PromptExample(nodes, triples, labels, head == tail) + + def examples(self, relation: int) -> list: + """Up to ``shots`` extracted example facts of a direct relation, in sampling order.""" + if relation not in self._examples: + public = self.public_relations[relation] + start, end = int(self.relation_offsets[relation]), int(self.relation_offsets[relation + 1]) + facts = self.relation_facts[start:end] + order = torch.randperm(len(facts), generator=prompt_generator(self.seed, public))[:self.shots] + self._examples[relation] = [self.extract(int(facts[i, 0]), int(facts[i, 1]), + prompt_generator(self.seed, public, slot)) + for slot, i in enumerate(order.tolist())] + return self._examples[relation] + + def prompts(self, relation: int, slots: Optional[list] = None) -> list: + """Prompt graphs of an internal query relation, one per shot. + + Slot ``j`` uses example ``j mod n`` when only ``n < shots`` examples exist. + ``slots`` overrides that choice with explicit example indices (training draws). + """ + direct = relation % self.num_direct + examples = self.examples(direct) + if not examples: + # Upstream's fallback for a relation without facts: two nodes joined by + # one query-relation edge, without its inverse. + head, tail = (0, 1) if relation < self.num_direct else (1, 0) + dummy = PromptGraph(torch.tensor([[0], [1]]), torch.tensor([relation]), + torch.tensor([[0, 1], [1, 0]]), head, tail) + return [dummy] * self.shots + if slots is None: + slots = [j % len(examples) for j in range(self.shots)] + return [specialize(examples[j], relation, self.num_direct) for j in slots] + + +def specialize(example: PromptExample, relation: int, num_direct: int) -> PromptGraph: + """Add inverse facts and place the head/tail tokens for a direct or inverse query relation.""" + triples = example.triples + inverse = torch.stack((triples[:, 2], triples[:, 1] + num_direct, triples[:, 0]), 1) + both = torch.cat((triples, inverse)) + if example.self_loop: + head = tail = 0 + else: + head, tail = (0, 1) if relation < num_direct else (1, 0) + return PromptGraph(both[:, [0, 2]].T.contiguous(), both[:, 1].contiguous(), example.labels, head, tail) + + +def answer_distance_rates(facts: torch.Tensor, background: torch.Tensor, num_entities: int, + max_distance: int = 9) -> list: + """Fractions of reachable ``facts`` whose endpoints lie at each undirected distance in ``background``. + + Upstream (``utils.get_distance``) computes these rates from validation facts + on the validation background graph and suppresses entities first reached at + a distance whose rate is below 0.02. Unreachable facts are not counted. + """ + facts, background = torch.as_tensor(facts).long().cpu(), torch.as_tensor(background).long().cpu() + pairs = torch.cat((background[:, [0, 2]], background[:, [2, 0]])) + pairs = pairs[pairs[:, 0] != pairs[:, 1]].unique(dim=0) + offsets, adjacency = _csr(pairs[:, 0], pairs[:, 1], num_entities) + counts = [0] * (max_distance + 1) + reachable = 0 + for source in facts[:, 0].unique().tolist(): + targets = facts[facts[:, 0] == source, 2] + distance = torch.full((num_entities,), UNREACHED, dtype=torch.long) + distance[source] = 0 + frontier = torch.tensor([source]) + remaining = targets.unique() + step = 0 + while len(frontier) and (distance[remaining] == UNREACHED).any(): + step += 1 + neighbors = _gather(offsets, adjacency, frontier).unique() + frontier = neighbors[distance[neighbors] == UNREACHED] + distance[frontier] = step + found = distance[targets] + found = found[found != UNREACHED] + reachable += len(found) + for value in found.tolist(): + if value <= max_distance: + counts[value] += 1 + return [count / reachable if reachable else float('nan') for count in counts] diff --git a/dicee/scripts/run.py b/dicee/scripts/run.py index e38dc4268..fd3f93a75 100755 --- a/dicee/scripts/run.py +++ b/dicee/scripts/run.py @@ -56,6 +56,18 @@ def get_default_arguments(description=None): parser.add_argument('--flock_compact_state', action=argparse.BooleanOptionalAction, default=True) parser.add_argument('--flock_compile_sampler', action=argparse.BooleanOptionalAction, default=True) parser.add_argument('--flock_pack_walks', action=argparse.BooleanOptionalAction, default=True) + parser.add_argument("--kgicl_checkpoint", default=None, help="Official KG-ICL model_best.tar path") + parser.add_argument("--kgicl_dim", type=int, default=32) + parser.add_argument("--kgicl_attn_dim", type=int, default=5) + parser.add_argument("--kgicl_num_layers", type=int, default=6) + parser.add_argument("--kgicl_prompt_layers", type=int, default=3) + parser.add_argument("--kgicl_prompt_hops", type=int, default=3) + parser.add_argument("--kgicl_shots", type=int, default=5) + parser.add_argument("--kgicl_prompt_open_nodes", type=int, default=50) + parser.add_argument("--kgicl_prompt_seed", type=int, default=0) + parser.add_argument("--kgicl_masked_distances", type=int, nargs="*", default=None, + help="Zero the scores of entities first reached at these hop distances (upstream's optional answer-distance mask)") + parser.add_argument("--kgicl_query_batch_size", type=int, default=8) parser.add_argument('--graph_inference_backend', choices=['auto', 'torch', 'triton'], default='auto') parser.add_argument('--graph_relation_cache_mb', type=int, default=64) parser.add_argument('--graph_projection_cache_mb', type=int, default=64) @@ -66,7 +78,7 @@ def get_default_arguments(description=None): # Model related arguments parser.add_argument("--model", type=str, default="Keci", - choices=["ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation", "ComplEx", "Keci", "KeciTransformer", "CKeci", "ConEx", "AConEx", "ConvQ", "AConvQ", "ConvO", "AConvO", "QMult", + choices=["ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation", "KGICL", "ComplEx", "Keci", "KeciTransformer", "CKeci", "ConEx", "AConEx", "ConvQ", "AConvQ", "ConvO", "AConvO", "QMult", "OMult", "Shallom", "DistMult", "TransE", "MuRE", "TransH", "RotatE", "DualE", "BytE", "CoKE", "Pykeen_MuRE", "Pykeen_QuatE", "Pykeen_DistMult", "Pykeen_BoxE", "Pykeen_CP", diff --git a/dicee/static_funcs.py b/dicee/static_funcs.py index 635dfa3e5..20735098a 100644 --- a/dicee/static_funcs.py +++ b/dicee/static_funcs.py @@ -30,6 +30,7 @@ from .models.flock import Flock, FlockRelation from .models.fsdp_models import FSDPShardedEntityModel, create_fsdp_sharded_model_class from .models.graph_model import GraphKGE +from .models.kgicl import KGICL from .models.pykeen_models import PykeenKGE from .models.transformers import BytE from .models.trix import TRIX, TRIXRelation @@ -42,6 +43,7 @@ 'ULTRA': (ULTRA, 'EntityPrediction'), 'Flock': (Flock, 'EntityPrediction'), 'FlockRelation': (FlockRelation, 'RelationPrediction'), + 'KGICL': (KGICL, 'EntityPrediction'), 'TRIX': (TRIX, 'EntityPrediction'), 'TRIXRelation': (TRIXRelation, 'RelationPrediction'), 'Shallom': (Shallom, 'RelationPrediction'), diff --git a/dicee/static_preprocess_funcs.py b/dicee/static_preprocess_funcs.py index 13b499351..4e271a473 100644 --- a/dicee/static_preprocess_funcs.py +++ b/dicee/static_preprocess_funcs.py @@ -84,7 +84,7 @@ def preprocesses_input_args(args): temperature = getattr(args, "adversarial_temperature", None) if temperature is not None and (not np.isfinite(temperature) or temperature < 0): raise ValueError("adversarial_temperature must be finite and nonnegative") - if args.model in ("ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation"): + if args.model in ("ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation", "KGICL"): if args.trainer not in ("torchCPUTrainer", "PL"): raise ValueError(f"{args.model} currently supports CPU/single GPU native and Lightning trainers") if args.byte_pair_encoding or args.num_folds_for_cv or args.save_embeddings_as_csv: diff --git a/dicee/trainer/dice_trainer.py b/dicee/trainer/dice_trainer.py index fc7b0cbba..3842981ee 100644 --- a/dicee/trainer/dice_trainer.py +++ b/dicee/trainer/dice_trainer.py @@ -125,7 +125,7 @@ def initialize_trainer( # Fall back to CPU when CUDA is unavailable or its context is broken. # _disable_cuda_in_process() was already called above when needed. _default_accelerator = "cpu" if not torch.cuda.is_available() else "auto" - trainer = pl.Trainer(devices=kwargs.get("devices", 1 if args.model in ("ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation") else "auto"), accelerator=kwargs.get("accelerator", _default_accelerator), + trainer = pl.Trainer(devices=kwargs.get("devices", 1 if args.model in ("ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation", "KGICL") else "auto"), accelerator=kwargs.get("accelerator", _default_accelerator), strategy=kwargs.get("strategy", "auto"), num_nodes=kwargs.get("num_nodes", 1), precision=kwargs.get("precision", None), diff --git a/tests/fixtures/kgicl/generate_reference.py b/tests/fixtures/kgicl/generate_reference.py new file mode 100644 index 000000000..99e3a7702 --- /dev/null +++ b/tests/fixtures/kgicl/generate_reference.py @@ -0,0 +1,192 @@ +"""Generate KG-ICL fixtures with the pinned official code plus upstream-fixes.patch. + +Use an isolated environment with torch, torch-scatter 2.1.2, numpy, scipy and +networkx (the reference environment used torch 2.7.1, numpy 1.24.0). No DICE +code is imported. The generator checks the checkout revision and that its +tracked files are unmodified, applies the committed patch to a temporary copy, +processes a fixture graph with the official prompt extraction, loads it with the +official data loader and records the official model's outputs on CPU: + + CUDA_VISIBLE_DEVICES='' python tests/fixtures/kgicl/generate_reference.py \ + /path/to/KG-ICL tests/fixtures/kgicl +""" +import argparse +import hashlib +import os +import random +import shutil +import subprocess +import sys +import tempfile +from pathlib import Path +from types import SimpleNamespace + +import numpy as np +import torch + +COMMIT = "6a3166e347ae468acdfb30a70a2cf3608b66b8f1" +HERE = Path(__file__).resolve().parent + + +def patched_copy(root, workdir): + """Pinned sources with upstream-fixes.patch applied, importable from ``workdir``.""" + head = subprocess.check_output(["git", "-C", str(root), "rev-parse", "HEAD"], text=True).strip() + assert head == COMMIT, head + assert not subprocess.check_output(["git", "-C", str(root), "diff", "HEAD", "--", "src", "run_your_own_dataset"], text=True) + for name in ("src", "run_your_own_dataset"): + shutil.copytree(root / name, workdir / name) + subprocess.run(["patch", "-p1", "-s", "-d", str(workdir), "-i", str(HERE / "upstream-fixes.patch")], check=True) + sys.path[:0] = [str(workdir / "src"), str(workdir / "run_your_own_dataset")] + + +def fixture_graph(): + """A small graph with hubs, cycles, parallel facts, self-loops and rare relations.""" + rng = random.Random(7) + facts = set() + while len(facts) < 90: + h, t = rng.randrange(30), rng.randrange(30) + if h != t: + facts.add((h, rng.choice((0, 0, 0, 3)), t)) + facts |= {(30, 1, 31), (31, 1, 32), (2, 1, 30), # three facts: fewer cases than shots + (33, 2, 34), # one fact + (5, 4, 6), (6, 4, 33), # two facts + (7, 3, 7), (8, 3, 8), (5, 0, 6), (5, 3, 6), # self-loops and parallel facts + (34, 0, 35), (35, 0, 36), (36, 3, 37), (37, 0, 38)} # a chain away from the core + train = sorted(facts) + valid = [(0, 0, 4), (9, 3, 12), (30, 1, 2), (33, 0, 35), (14, 0, 21), (38, 0, 34), (6, 4, 5), (19, 0, 3)] + test = [(1, 0, 2), (31, 1, 33), (33, 2, 6), (7, 3, 9), (6, 5, 10), (36, 0, 39), (12, 4, 30), (38, 3, 36)] + return train, valid, test, 41, 6 # entity 40 never occurs; relation 5 has no training facts + + +def write_dataset(utils_all, train, valid, test, num_entities, num_relations, destination): + """The official transductive layout: cases from training facts, test background = train + valid.""" + np.random.seed(0) + random.seed(0) + kg = utils_all.KG(train, num_entities, num_relations) + cases = kg.build_cases_for_large_graph(case_num=25, enclosing=False, hop=3) + for split in ("train", "valid", "test"): + directory = destination / split + directory.mkdir(parents=True) + background = train + valid if split == "test" else train + utils_all.write_triple(directory / "background.txt", background) + utils_all.write_triple(directory / "facts.txt", {"train": train, "valid": valid, "test": test}[split]) + utils_all.write_triple(directory / "filter.txt", train + valid + (test if split == "test" else [])) + utils_all.write_dict(directory / "entity2id.txt", {f"e{i}": i for i in range(num_entities)}) + utils_all.write_dict(directory / "relation2id.txt", {f"r{i}": i for i in range(num_relations)}) + for relation in range(num_relations): + (directory / "cases" / f"r{relation}").mkdir(parents=True) + for i, case in enumerate(cases[relation]): + utils_all.write_cases(str(directory / "cases" / f"r{relation}" / str(i)), case) + extracted = {} + for relation, items in cases.items(): + extracted[relation] = [] + for local_triples, labels, entities in items: + order = sorted(entities) + example = local_triples[0] + extracted[relation].append(dict( + example=(entities[example[0]], entities[example[2]]), entities=[entities[k] for k in order], + labels=[list(map(int, labels[k])) for k in order], + triples=sorted({(entities[h], int(r), entities[t]) for h, r, t in local_triples}))) + return extracted + + +def settings(dim, attn_dim, layers, prompt_layers): + return SimpleNamespace( + finetune=False, train_batch_size=8, test_batch_size=64, shot=5, device=torch.device("cpu"), + use_attn=True, attn_type="Sigmoid", AGG="max", AGG_rel="max", MSG="concat", use_augment=False, + use_token_set=True, use_prompt_graph=True, prompt_graph_type="all", path_hop=3, hidden_dim=dim, + attn_dim=attn_dim, n_relation_encoder_layer=prompt_layers, n_layer=layers, act="idd", dropout=0.0, + relation_mask_rate=0.0, use_rspmm=False) + + +def slot_prompts(loader, relation, shot): + """Per-shot prompt graphs exactly as the patched get_case_graph assembles them.""" + kg = loader.kg + edge_index, edge_type, heads, tails, _, _, labels, _ = kg.get_case_graph([relation] * shot, False) + graphs, node_start, edge_start = [], 0, 0 + for slot in range(shot): + case_edges, _, _, _, nodes = kg.case_select(relation, id=slot) + edges = case_edges.shape[1] + graphs.append(dict(edge_index=edge_index[:, edge_start:edge_start + edges] - node_start, + edge_type=edge_type[edge_start:edge_start + edges] - slot * kg.relation_num, + labels=labels[node_start:node_start + nodes], + head=int(heads[slot]) - node_start, tail=int(tails[slot]) - node_start)) + node_start, edge_start = node_start + nodes, edge_start + edges + return graphs + + +def generate(root, destination, checkpoint_dir=None): + torch.set_num_threads(2) + workdir = Path(tempfile.mkdtemp(prefix="kgicl-")) + # The official loader derives split paths by replacing these words. + assert "train" not in str(workdir) and "test" not in str(workdir) and "valid" not in str(workdir) + try: + patched_copy(root, workdir) + import utils_all + from data_loader import DataLoader + from encoder.EntityEncoder import EntityEncoder + + train, valid, test, num_entities, num_relations = fixture_graph() + data = workdir / "fixture" + extracted = write_dataset(utils_all, train, valid, test, num_entities, num_relations, data) + queries = torch.tensor([[0, 0], [5, 3], [30, 1], [33, 2], [5, 4], [7, 3], [6, 5], [40, 0], + [2, 6], [31, 7], [34, 8], [6, 10], [10, 11], [33, 9], [36, 6], [35, 0]]) + variants = [("tiny", 8, 3, 3, 2), ("official", 32, 5, 6, 3)] + for name, dim, attn_dim, layers, prompt_layers in variants: + args = settings(dim, attn_dim, layers, prompt_layers) + loader = DataLoader(args, str(data / "test") + "/", "fixture") + torch.manual_seed(42) + model = EntityEncoder(args) + fixture = dict(upstream_commit=COMMIT, patch_sha256=hashlib.sha256((HERE / "upstream-fixes.patch").read_bytes()).hexdigest(), + num_entities=num_entities, num_relations=num_relations, dim=dim, attn_dim=attn_dim, + num_layers=layers, prompt_layers=prompt_layers, shots=args.shot, + graph=torch.tensor(sorted(map(tuple, loader.kg.background[loader.kg.background[:, 1] < num_relations].tolist()))), + train=torch.tensor(train), valid=torch.tensor(valid), queries=queries, + answer_distance=[float(loader.kg.answer_distance[i]) for i in range(10)], cases=extracted) + if name == "tiny": + with torch.no_grad(): + for parameter in model.parameters(): + parameter.add_(0.3 * torch.randn_like(parameter)) + fixture["state_dict"] = {k: v.clone() for k, v in model.state_dict().items()} + else: + if checkpoint_dir is None: + continue + path = Path(checkpoint_dir) / "model_best.tar" + state = torch.load(path, map_location="cpu", weights_only=True)["state_dict"] + model.load_state_dict({k: v for k, v in state.items() if k in model.state_dict()}, strict=True) + fixture["checkpoint_sha256"] = hashlib.sha256(path.read_bytes()).hexdigest() + model.eval() + relations = sorted(set(queries[:, 1].tolist())) + fixture["prompts"] = {q: slot_prompts(loader, q, args.shot) for q in relations} + with torch.no_grad(): + fixture["prompt_outputs"] = {} + for q in relations: + batch = loader.get_case_graph(np.array([q] * args.shot), False) + output = model.relation_encoder(*batch, loader, shot=args.shot)[0] + fixture["prompt_outputs"][q] = output[0] + subs, rels = queries[:, 0].numpy(), queries[:, 1].numpy() + fixture["scores"] = model(subs, rels, loader=loader, training=False)[0] + single = torch.cat([model(subs[i:i + 1], rels[i:i + 1], loader=loader, training=False)[0] + for i in range(len(subs))]) + torch.testing.assert_close(single, fixture["scores"], atol=1e-5, rtol=1e-5) + loader.kg.answer_distance = {i: 1.0 for i in range(10)} + fixture["unmasked_scores"] = model(subs, rels, loader=loader, training=False)[0] + # Evaluation-mode gradients are deterministic after fix B1. + weights = torch.randn(fixture["unmasked_scores"].shape, generator=torch.Generator().manual_seed(3)) + (model(subs, rels, loader=loader, training=False)[0] * weights).sum().backward() + fixture["gradient_weights"] = weights + fixture["gradients"] = {k: (None if p.grad is None else p.grad.clone()) for k, p in model.named_parameters()} + torch.save(fixture, destination / f"{name}.pt") + print(name, "generated", flush=True) + finally: + shutil.rmtree(workdir, ignore_errors=True) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("upstream", type=Path, help="Pinned nju-websoft/KG-ICL checkout") + parser.add_argument("destination", type=Path) + parser.add_argument("--checkpoint-dir", type=Path, help="Directory with the official KG-ICL-6L model_best.tar") + options = parser.parse_args() + os.environ.setdefault("CUDA_VISIBLE_DEVICES", "") + generate(options.upstream.resolve(), options.destination.resolve(), options.checkpoint_dir) diff --git a/tests/fixtures/kgicl/official.pt b/tests/fixtures/kgicl/official.pt new file mode 100644 index 0000000000000000000000000000000000000000..e5d062e212366efe74872c928ae283dcfad3e5be GIT binary patch literal 613848 zcmb5%1$b0f+y3o9aCdiyLUFB7D228I#fp{y0fH2rO`uA>NvXTLySq|%H|p;0-hS70 z-}gmV?Ro#-a~$uRb5>XO%&gga{W3{_3Aw^b1qIcr75w9W^$Y43tX#No$^0e7%X%*; zE-l`C)zW37N7gQwnf`CTitF+P-KN*Yr>|MHx-=^(UOs33%H_+Kl;$f;?}pJq#r^vZ z8dTDMz~JJN0fUAV&tI@`UjIJDgZmWso4>ICpgu$94H`6W$ilw)iqmUh`l{m6`HSbQ zUR>O7;Glfr^ldQIcfsI+3kNLdKe$id1q0{d{|1$m;QyDD^cyg5-k^R1OXlOyC4Ku0 z8dx&0@4^Me3+D|OFr;K*pFw^5_3z(*;oy8FJMxM(%jcA=C|y#zq-1rza<2RI+Bh}` zvyx@SrAt<>Se>tut1`V1qYIWS&sWX0o6c1!E-hU#hXd7em8aK;Pgz#HM@hCiUmf## zlvUZv<*Q2P#AuCN;q=NFUA=f^>FRtU^p%8FMl&exh>x-y%;c=I`HN|!8KT?6+$ zZ_Scr3+9xTtXRD=o3plGjePBH-KJONr(rStLDSh(w z?D5WDwI*MG+=L3H`34hn1-VtZ!m@nBTw$(4S-#Qw`SVvUTUIjPo?(sg*@BX+WWlH< z^Gj>w8+V_SZ&I3XIw{}G9%5-$ykteb`C>eR#dQ|@UG&YjSX_VH5FENC551U&Zsmt= zy?!x|(55usc2d5b9bs+pvLy@h?f-Iwe)$fI>*t!4<~#BL)p&qTet^z?fG(x^u9Ncq zr1NV^GQK|D|8j`_`5rh#yVCq-JVd=*#jsM*KrT!JnV?-ycwQColnQf|a+Pyc za#gWVHFC9bwR3fHb@7br=NjZ1<{IT1=bGf2=9=Z2=UU`i=33=i=i21jmrSpM$G5C_ zUdgi6`7Mg_TXrkTZ-vK^t58yu-?|$PTmTI3#^VFq5EX$D1m}$89FA<;4Ud2rr8(OP zqX~Zc7=70E`cFIPKkcahl+(yq%^9b=*hwSfH8Me%sLz_jhr#=r%n?4qoi%3)!I7z& zJWY>zx-dhZK2vjc(SMrd|Ea{Tu+nS^UYXVTqN4n4E>}UWPI-Qgp?P_JF4rwrzdT=T zXk4D3XJ}fUpKoYUo?if9!OHU`c$@{f2IcvM2K=W*eB`+{<@v=xVXks{eu)7G+!eQR zZ{_)=27J~s1CG2LuYWMh*mUCYR?A!l_-5D=g0+Y`~Gr z40y`r27J~b20ZumhGymYLviBc^T*(du}?qNfX_P4fEVR>pfHD*@&sH{_7a?Es9Byr$$;l|vH{Qi6kK)o;7>K+ z(@(=yXh%LBD9qtuoPn#-j&r5~>vNU?Pw;G@Fo)xugX`8l>s$lY`8-3d^8ERRmgV^i zfI^->7vd5x;A?RaU{B{_T=I5GTw=g#Tx!5)U535DPTI>2IBBl{?4`WYfEVs6>=yQ# zUTvsRp1;O`Q{q|!4tO09k`HXa+f1+cU3Rs){t zZP<|txV*Omb^_di9SS>kdHznoR^zUcHS6*lx-A}z2Uw>pfA?Z+f%kOd4NUy|7FZo8 zQcb+%wehl!bbh4mo)OSMqbfzUe$kk zP51S>M&8hzH#x$c@hy$K?I>A{4ep&y8{E5C=Yky0mG`(r+~D3f;AQ*3fJ^a11J3x5 z0Nda`#=&ia`^13%^eOL-8{B7rZE&9(aKJBc+pdZ)4LGg8GT_Kx+jfS_>>C4ipKlE~ zvA(nI47vH#d%~GwnNR)bBz#qkSXJwvch|ZAtrfoNeXiWs+?zW8H?+zAtCnxb0jWLHq8Ujda^OZwq6O&PL%Q zx9P^Ys%6=BxPhHI8_huu;aW*I>uR`qv{nE0E7re#y~?dR8^fa%W!u}qaG;W+YzMRL z+1ZX}`$9C!#W?oPY^>RK-)vl%<2!|UobhJ=+zDaq*4e~l{-k7lax#DC#8Z;_Qz;1A8uoIt z8`<8pe{GztbMwpNY#-XcFwXXsaliYy?JC@#_OFn$17uub2fD2!2hmZIgJtZLWo|1; zIUOZAM8@-4@3yP+P&!I-n2eGfE@Rz}knwzvl(B|K$tcOubd=;68L!2$ZY#-gGIr(T z=_ttwbd=;ox9yrI(NU6HoV?EEJqalU|_)u|xkJXecPAYsxyxDa#(j z4VL5~4ss~hG1tke@GwV;vPbMccoiNsdleot`|kgEj8`nN-R%jx*%3Qhr}FGc+{p1e zOr6WKr|8ZY?^2#U4fD}F!^wCwRq$=3>{;C4qj`>l9Ku|F#mn!)@Ov=-RkeTnK1|zO z`&P=6*bn*EtX}@Uq!E@Jcf0RkMBDBYQ38aPNOTng2%2 z=W*Ul#@~u@_TlYh{GDX}yUCpQ62EWuo_vtZ|1j}Ki9ZhWzCJPgbNMtG|125*JQ@EY z@t0vfm#@tJ7``^!cZRZWlKI~z^S_HZd<@^4{d0eaIfZ`4{Af3$hd<#4UU%!^&vf+g z7a2YLRmT4Mn~Xi_cenNM4?22SP%(@-72JHYlvQ+F8w+JzyOro@V`UlpRuvidTa}JB zR+G`F>N2k58g#U=ri|{@lF^FVZo9tgxUG$K>1bm;x3#gpo8LXk8qm?nhB6*QBe(4_ zjp^uQ6B+wQQ@3@p86BN$E~5i2+}6pKbab+njOW)BC8Cp*#6$<8ufmo9GWWLFuT>_$f?yVKFh9&T&GW^{D2r;JYal5uWq?zT?$rlXU6 zWOTBxjP>a!V?F!R(a8ZajyaHyP7ZQgCkNBf$ssa2IaJ144RhQ6y#*be+)_p-x02Dx zt!4CWxZ66p4IP~v;kGpyNk=EQm9fsFWE^KZIyyO8MkmL(?Ht=)MkjZmqmw(z=wwbt zC&$XTuW@ec$EM;X437ki*zW@c7a)}S@_6e)yy?4%ZhM=#hT4Q4q37I9hg6Va=>c+^=AkF z^^*g>8=J!;6=ienfL^O&v)5{#*}k=u%@5nVjbywe=5u_Z*?0a$$(+Su&RG&>#db}` zmzsUYUKZo5!184Nie&!E#H*6|d9xoUOXjSOaUQcY8DC@e$GkQf-!10zG4Gyuk7UlC zX8+v167L=6b6l6q-zS-~@1{BSb|CK($#cS=^8q!bgkQV;Opq9()BW`bc2j@<3_ht=_Wd=bhC^q-6CUsZk4f~x6x6h z+hrW{4mzrIr`xJ@7adjFAfrlm%UG*>+_qcZOGlONlToGnWmM?_88vy(ZB=@Rjw(Iu zwl#T#jw(GWW1Sz9ah%8LsL~TMs`RAW&atOtROx9ts`QMEDm^QsO3%r-ujk!Xr5EU^ z(u;08{zf{g^pcEo?`1lw^orZAqgQ3TF0av1rPtkduD(G>mELsQI==<8K5yeA>r)}u zqAYs{H&~x{ImjXGQ2%U?|H$UA-v|8j9g}`;jrU9TZs|Q9t0;Tl4(a{*AP$e8;A9_~ z{j2_uVx0T;$7X*Q^-1DS6MvTY^Dy`0FOu;u6Mtp)z5MHB{x@dt$+yY;?~*y+#~ePk zACfsgCgVSa*^{4>Ilm<1zb5`I=J1%mC*yy_IFD0+-&lzs24xk(9Iu#+7bfGC5?40+ z+E&?QYf)9Z87-=Y8){K?I$BgiMvH37*u!ecxbADatwnX{Xi;4mbLzRRMfKg*q6RXq zkA`%#sF94lp|OnnZ9+$jn#$-vGa1)Pb2?hoLPm>P%Gi%vx$PQi?Y0)Rp`%4@-PWRZ zZfj9{I$G30#$)K{w(GbP9WClC;~MSawib1zqeb0h?6uw9)}kJCv}iLK&#|Z5uJ2xS zv}kh~E$S^}4g1J=?tNvfXFnM&>Q6_D2FQ3_2D+_9gJiU5FdZ!#LPv{+x^3SbMn{Xb zkkO(oWtAXs(QNub7S&&2!szG+)N+ zvVe{jmALI(T}VfZ7P)Pm7t`?$X$j0O?TU}=Qng&&vTP}CuuIE0$f19{D@wnU_t#$~ z_}lMOS(BFYI7QhCJDfLZrP<#TtulKj@@9X3l!dwfu1>~FV?NunCd@f&6Ym!DIljBu zd$UI}XU}BLUdj00$@sc3?`xkh`>}5_f4{{0Cvy%+#t%%!4+`_K9c=c;R+fyHhk3t; zgn7T~6CY~!bvrB>KRm|cyK_g_&1lb&xS{qOMMry%meHPLWb9eT%DB#tb6b0kr=vY5 z$e44Y+uC!I+uC!ojO*bPI@)upjJ@DA8TWfS9qlAJ&@UJn4yYz3#{NEG*VfN20z@HT0I}P4%1+$M=jB(yC|1^Q-R7zYq%=@Zh z_Qy~)8LyViub#Mu+3%}njPt%~g?Y@{iR+mC_;t}C|FA#SKR zjp!&&V;RM1B4gKTD&tCT=CNCo1JMDIK)MvDe`izlrZfx(i`s_eQ zeRh;lpPY>K87pHw$I(%ron#zyJRS9!;I{fqq@zBQWYlM}jJ4X?ZM)(WI_fi3Mt!Eq zsLym6)tKS7`pl%GKD)SWO=i(ipCTFSJX^+b=Fm}}xiacg?6z}ko{aj;r=va#WYnib zMtv5_xUWTStIuLO>a)ac$KREX`Ye@k?k%IEKFi&99j%b@x~!z5KC9ezuIA~ePv*9D zUJbK8rTEDDG|IIs%huoq>$8@F9Qr@%^XD&2|M{J_7I+l?Cq`JG-FPIt*RTV6efBVW zefBi__lEY0aqj$ko4o?-67Q4D**6*AFU(zf|76YqX5Xa`Ongwx=Y1U<=8j!v_6n3I za}F{4<6Ix(ystxJoX0sV89&_Y$2lU#Ip@g4MsUAGwO2+Zm2$|(ovt&WYp($8N1dQGOqM9-BzEo=%~-xGUlA)w)&jw zw)&hWh@^#{FJIM}01qvGZRd8Q_LGU~HI#v0x&V?FPcQJ?$hsL%Z}UY7^lR-XrD)aM~O>hmxi z^?Af?JME)%)aNl7^?6*zx$%VC>hmNW^?6E0eV&%FKF`Ql&u8hV&vP=4`8*xhqP1 zbMI?9>hq1;uA^^dye{9-QJ?SKcCP+FM}2;D+dBUQvpzrLBkNO`Yg(55f*Y*QuN>r1 z)aS3ibMRk3_xZ;k*2#Y3aqu$@JDj)Y53{$Y0Doduzgbl(=%3 z`*oF=&mL4wTrJGwR8QvDF#EfOnqkhVmCUJa_Qz8vnNv5$Ilo>qUO#bzWKP4xjS@Ew z^YJ%H#+!!uT$&~0&6D{p%)TZqlkrwD9`ANq+s)`r8{AND+S1XRb~1X?UdBGvLB_S+ z(QUoyL`QEr%b3%}ZN2I0w%&A;aSe2*qc=TdT>qQNxZj?1^rn~0cN#LThu(DbrjLx? z^p&ya_H)~H(%)^p89+yG2D+^`gXn0?U>Wy2#BJB-P&yhjOvbghh1(jlB^`~~O2!_# zwc8pqoQ}q9Bjb6EaNBh|l8(k~E2A-^WUSkEGM?{f8EZI3Mq{?8qcJIsWR4c8Xb+{pSw2W zm^0{T%uKg6W*0gdGfPHeie#+SY`5)wbLeQyTp5iimeH7bGTJcTZH-w#M`KFdwk8Yd zXv`uR>%3UTahA~0m|bNwW~tlGv1KwEvz(5`tdP-|l`fEZ+wn{3 zXv`WJ=iXX68nc_*uASXwye@mt(U?8mcCPM4M`QMO+d8j<*_eIsk&VFvD$Dl84K`*! z4sr-P(f_~SElB@NJm2B$&m$FO2gCuna~^2+${b|&-SS|wzpE*WIo!$1lR1aP93E$V zGXKzI{IF#H;bHFNN5mZZ$S{w8R5E^a;$zJIF6G!{{J3QN_+dk9Phq@C>hl&I^?6%Hecq9=R`0rPSA36-`n)frJ|D=a&xbOq z@sZo=^D!Ou`NVB&@+lql`Ao(-e=g%VU(ivXFJ;u{E4Q6vU(2Y^H+0nJTN(BFPDXvc zmvLV|xUD`v(ovtE+;;q*>8Q^yGS0nU>8Q_dZo7_tm+`v%K}UTG@K>S0cCJ>Sqdpbg zw$6nx>r)9I{T)t&vaB+0us&5dh|jmz6T8d*dWZ8LeLGrzopthx2zh)y>|X z8euk|rrG!3T8V3$eebT5xNhQlF`vh&ALicOAQ^9%%x`4&cQ}p1{M;tVoTg^~lUB`= zIn867^IIh2En}QrY?ZimGQUljkFBlQ+tx0b(>|HgAsO$OxRcqxi`F^DdB0s^JiepW z)ow;_y5WX;)18jq^pMe;&1CFTJ!M?mz1-HD&FSb(Zy9s?xUDyR-PW6aGOmICbo6F` zjO%}(jQbr#M{fqpe5WDfdKgMaZ-&X}%@#8D+%4U9oowZ{-fT@rZ-%?AH`~zBm=QAW zccj~{&u!^w%qSVx-ga(l%xF3qGe*W9y1m;PvjZKC*-^&x%DL^j9ZN@J#>r^RPBPYQ zyo~2NLB<+Rl+l<;bTnqNjMrjkw>4&pjK)l*qcPLyXbk^)CD``U8FVyeri{kyBIA6R z<+jEY(b1UMG8!{S#`?^av7W_rG-jTRW6r0eF$>(*m=Zb~vrtB37Rgwv#ctdCmeA3d zU1c<8sf@-flhKCdZfnd6IvTUmZELcMj>hC=taB#gIIHPsOsR~n~uh;bKCLvp`$VT$~gD-qoXnVyY1RJK*sBGARUc4$ZhB9 z!E`jH%x&vj4zn?b;G_Qx2Y-vgdfZ@R4&@+T1zvOMdz`=i{=mQg1jl}R+6r?Rk5ZH! zZU^(i9AWmt9BKA?92Mi-xsNvc?tV;|vh>_NAc}D`*GSOZlBEQ5a#3TX!gh1Da_~CIhoTX z%<-mM*Ot&>= z7a5J2MMq?UKKcb9RTJ?Lo6o-!JCKmVqI|NHlykKvK$@uwU9`l047n=PsTomJc%om6G zd@o7nUuyR6(Os6zxjf9zy(00IW-s7XW`E3AC*#*_ns4u9uC<#{oa=By#kro2;@lvk zI5*1JwQiDerQhtf;@m<hrja$MA&PuG}Z- zsLxX}uF9v~R-b3+sL!)9cGu_JR-fnTsLu;Bp5u#dyP`MJQJhlgA^?BEAJMDXP)aQK}_4z=?x$&Xf>hlpD z_4!yveLj(~KA*~1&(G+n&*w6Z`2`*I`OQljO=U7D<^(myI zK9ywDr?QOtRFQFCRozw}{>u-lPj$B)zXl!ksVU>!t3^kBYP;<^sw3ldsY^$F>bdP) ztxrdN8n|tp8^WwlBYb3ia59x;jd6qZX~IDc{pCAlfBn1J{`^ka|N47wn(|2a-KjVr zcj@M4uTKlJ@6s*JUY}Mmhr4v^WKNry!{f9~=C@1SKAGPk%-y?V%%M9a^E)TwT@rUq z+|BGeeD`F$N8-(rIX%r@hhAYmm(7#$-e&&^RG%;(TVJ!^SHEO_|HK1gKG$Jjn4dc+ znKO8ktv*BSX4GdWZm2%P=%~*YGU~IXj9qIh8CUw&ZmZ95I_k5Hj5#CRR-ch>tIxJF zu82`|)Mq;xyTND~_dAA;`fM*_=ifob)v+TT^~uSo&sZ5d@Hn?!H9NVjKI7@A&jh#C zXQJEcGl`D+OqTH&c6Qs9JB5z=OqFp}PIFs*_>WMiJ~L$Ot~1?MpIzvv&ny|wvB+&# z^lUonGe<^!=E_*ZVj0hUo{aUJFQYyS=%`PLjMrtM+v>AOMtv63QJ*Dr)Mr<>?X*kj zsLwJP^;s_C+*skZ`mCg*KC5KZCof}tG8yZ+nvVLE$~fj4I_k65ZS~oWj{58_qdt4c zSgSqVwkz&MM}78|QJ-}(>a&lGYV7N_`s_zXefD?TnjAn!eGZhd&Iidj&cSrlr%XnD z%H4L39U`MX>*=V^p)%@on2h=yF5|wAa9e$jq~pEMQEof_(R9@37#Zi@v2@huIJaF# z$IEzKPN1VcC%WxiJ&BI`ob0xBJ_TldPQ^#or&6v_S#}z3us)}AkVDv^unl65(7(=- z{(S;}_9y+bHu`&R{BOBAgGa)94LhK}_c_b#^*P(@yYx9`-;K`=bH_d}=FsPxeP_NP znR8)`b2q*y=5sf`IOfoo#2g;y(wIYE7IXNymnUG!#i>yzI6s z_Z2$o^Qw%i@-?^B=XE;X`@A7zcYV`s^?8eq`n)aUIlkkzEBakJ>hqqA`n)e=4L^|a z+&`4Do*&7m&&PDs=Mx#P%cpLu&u22~^En;$`GSu6eCf8G_A5H-^RbCm)Mn`>qmr?mVg)+t zQ&C2J3T4!%l8kCpc3XX_&{3bNZd;RTbkwK1jCHOd<2W_xs81~!^{MT)bF7Yx`qZVP zKJ{eOr@oB(G>~y$4c%6sMs(DtvD=Q{gpT?&m2vJhqoY2}-F6+dkny^-q@zBq+;*+_uhbVb-S|KC(VF_;-A^#|_q}0|z;@sXpm%qy7D-JOBFL$9}rgk;lP14Lh8- zr?c7H)5Yw)>1y^pv|BRXJsIy|_C0sAWKPdyPOli}{=0cH-aE$Gi9TWO<9%Ze=l4tI z^pA1QACSx+n9LcJcyKajNHRXu?9XeM*&qKF$@rGZ_*TjI)@FY-b|MHPD94^FollZOqJ1_X)^ZQ>2AADX1J|4GwJBfE^h11EIJxf zB;$T(yY2d%Lq}ug%DDE5-PV|SbTnqZj6HOL+Zt0sM`ISscwUR#cHJ(fqcKZlG-g*B z>$X(J^Iaxm4VTMk%nCXhvr@)uvC3_Y$;)U=Mn_{-)6tkxx9z8E=xEGZ8I9RZ#`&|#_Uf=V-Aqfm;+_3)j@9C`wpg~ zF=a9uQ!b-1hsbEddbc&^P&yiOnA_Ima5@@ugp74QQpRzPqN6cK%V^9oZac@0mC=~v z=xEIGG8%J&jK-WO#bcI})g<8?WUj>eqr zwsZ9yIvR7X+t&F!n2k9fAN{90wac;#aD$Dxkb^iYc&=ef#J-R=#{W$p{!O0$_fK~& z;*s!9!w%?`xy0<1xioC=G|axEULIxzt_X8Sy)qfUDw%(^*>~@2%)YB%o6NZ`%wt}k zjNf4P&%H6md0#grzB!q5ON{d|-~?4SEUGX7x9kKZSF$Zke)9>xt7=Mg%J^QesCJSJn;dR)ep{)F3#^CTU` zc}m8dr`=YZXWUktXJuRw&(Tqw=Vj~$FUYvx7wIU@Mj1Q*OERvGm+2_ZD>91ns*D}@ zHMdoVh)eLeKNj7jPv+ACeFni9)E1&apCy0H#^zQsLy!ZP<N82kt~FW4mANACo`b?EEXPVpU!+)OLzJkHOJ2ykd6)}^J`s^ZOH<%^k zev9a+&ukex{~Q@t$6Pw_bO=_NAjf`?+nW-Jg#793Z1U2g*1%4su(4 z4yL0%WiskhE@OQTk+GiZ>8Q`4GLCr|9rZcfZS^^Vj`|!aqdrH;SgWJmwksY(M}3Z! zQJ>>v)aQ5^)i}Xz^*ND_`kdspH947%`kW$Tolli=;CA{po2#dOr?61QDPm&$luE~BG9m%Hs; zy@HPVTus+vvkVF4cpMU??O#SCO$!||beXiq?@Lt0X z==Hh5?De_P?0@FwrZ9Kco5S3JZ%M{)O?;c#ckkPi@jGJN-fP4-k8_vV%d#QN@w;OV z=iigezt@b55aaj7I3L^n=6J7>_`zh(Lx~?Y`*9vg{AkSKV|Xl?|9CRziDdlA#7`x2 zo{n)o&SzqrkMr40bL_iq&)LnW&-1vU`n*6#eO{DNpN%qht(Rn6=`XvjKCjSGpI2qf zdChJ0dEIUAecq69MZ8HzecqC>8@w&!e&3;^KJUud`QMXqb-YhUeLj#;pATj1z#qBo zs`=P$_4$O3`h4oP`h4cL`g~4DeZG+K7`}AdmHQPP_4!)HRr!tE>hmof_4!W5?)tsk z>hl8~_4!f8bNtC|SM<+x)aMr&_4!rC8vZ8Zx&JO>J^zqVpMsh=PSmG@jMt^2+v-y& zqdt}Bs83}&>QlvSJ8e}u>QhZdeX7eiH)^=8J~ip6Pc0essV!rD>d08nx^&d1o{VGG zr=va%+*Y54bkwJjjQTW|u~tpowktNJqdv`K)TgeGXc`fTR5S zJj^|Ho5Uj$j|_7U-Zt^5WX^VGzpv5B_!zVQR`d4B_zqznbH|v&$B;|rj7`SJCF46K z|t|dT=&IpYtcNqB94S>dcKS~3*6SC61TNzp^WQe5naeff#0E$ zahxSG?sr$Z66Rn}S}LOh%VbZ>KyN-9Kt6>hBu!oFmbWgXnXfL|D-`CzUp4U3JwP+u@2Ik-~ z?{g_9|c$`PeI5&=QTZ@jR>tR05f#YPf=y)0HbApWZ zJdx%eg=3y1#(iDwwiaDOH^=AVwY%1B$G?tlfpN^gUdFk11KrZcZ*<#rbd!wN zN)&G=q}t~mo{*aLpTP$ z{KtOr=TC(G{CUv-{5Nzqb?I&%3-34Vklv+x%@uO&(tT!c#rCw{@~kKx5I zkH69E4SXr)bNuBPXIoxL=D!+qIR0AV*JBRH-$?vsGUu%r=ked(Wb4v9b`v`Q&;56C z1H$=<_Zu``8lI2u%Q(M2kg=bAC}R)!$ZcKvn68M=#r6G(j5(jWtxKP|txKQFxUVnh zLOu$--;i;fuVmcs*K{S!!8QGjj3#_5OFz?9 z@VVHlesNouesx=yexs}U@qd@`82)hEHC<2(bE;tu_K6BIuGflg>rx?I-S4ZCjOSI^ zZC$ED*T5V+=BhHDV>P#3>(%L+n1j8!hK&2IDPs+5$v94J8S7a`MwjZ+wQwACsh*72 zrM}y`)Idg;8q(Y!uvU%e=u%_1?ZHjx=u%S|kF%MKbECQ2y3~S>F13`=rB*W5r?rgr zY(qzv+R8X)J36}5-fdm#Ku4E4%6R;pWUN(Zx9yi*=;%^c8J+1Sqf6ao^rVN|y0jS` zUFzw!HR(l1mo}HN&b?(Erw<)n>MP^g?B}*~tiOyd4WOe-17&n+kcu8$60MPOb*!bMM7zn@ z8FrU(zkAS8qCI6)U@sY0%HDL8Xq}7_?IUA1-q&qc(0*rX=pZ^u zbg+!aQ0BI)xSWm>9U|ijUGKIM9ZE-u4wJFd9`3dh9YIHlj+F5nk8<19eKZ{7$H{o^$IDpH6J(U=L^?`zl8o2oWVe;*6d5Htm5vgfMn{QGciXOe1|20jQ$~r- zl5uXF?Y0t~Lr00ul~JPeWUSBmGS>3~I!bh*jALFzM~N{b~ix{Zz!-7cd&g5#lJPeazm@pyWd1ve-%b2pGXMR=A0+-T@kfb2PW*}4 zd-G{B{#oMB!))6ZW^dA$o95U%qOa^`bm(i`P=~&uqeI`y=+JjE_OI_{T=PG;twTT3 z(V?GY%=y`E9s0#>9r{(qwecGr9r|6yzVL^P`z@%AInkjCG8#}(#&uFiM~5oO=ul-D zdvO)FT|ZUb)}d;2bf~)9I#k1L9jZx3V`|B`_G-JWF?Hx@OkEj!Xg#+zram2wX&~eA zH+0)|+lY?FG?vkrCNkEisf_2-LG^Q;bjcG?m zSK7T_ob=&zcjE+uhA)^yp z%IL&aGLFBs+d46vj!tYtM;k`SIA=!E(S~i^c5aW7v9{aM(SXrzTaz(#yc^k`Zi}nG z9scYE%y%X`;v z-|Hus{U(-Y4~Jad!%Cl+=y_PbfQVS69Wxgxji zYqROt*XGEWGuLhVTCv;qwRtjL%lS0-BkVy7WL&EyZhM^;x@`|yM8_Vqn2vp9iHvJz zS30iGr8KV@Jf3BATqnzEUK_X`R>-&>R?=|}t)k<#&(rbRXE0y;)%eKQ9xroQR*D;Z z?bmS7UU_^)V6XIAj^Llyv;W|)^zLSVrS~xV?}F?ZQuk0UpTzR+JrNQ~UuQ zZ1x9OX7&eI9%eodF?&AOCvy%pdxj57#t+|QJGG9`O@0&nNZinAaFp9#`lH?U(jP;| zOMk4}@^hTq@^d`h5~0NDbOPNT&$k2KM$jGba(BcJE$EJLC%lb-OV$+U3h_5af%p>d zRDQtf)yfs(kA33?SMPKVatNQr3;NG*fcqDD`oZjf{ZcCakwshSGk6^Qp>I2!uk=}F zU+J^We$k&3kI2}B9+h#wkJ0f(-QzO8sCz<2;GU%8i@K*|TmetZ*ifHw z+m-RG+penT=(wt$ciUC<0v+E_cu~gvZgkt5v6txhV((=cF@42dn8TaESLxWKUz4#( zzwWj#_THf5i@i5xJg>Lh_Ql@YbbPV*j*Kt%-j%U#@5y++@5@-j4`h6?_aPl$?0qET zwfNX=U+jG%4?c^bbPV*x!c}6e?i9=eqYM?!tW~?=fl@-`@-)VI==AxR>l{8 z-^o~??`5p#4|IIt_oIws{zOO6es?b#4vw3x_uN$i`IUum7~g4K}772RUSo(YF!)`WIXIH?;rn zU;k;(W8u$>+abL(9nIdEPH|VZmtxTb#KT~D&XPS)t zc)HuJp&4%L&rCY{vy0pMGs|sX)fLgvqS-PY!yLC=$8+guQL&6`be`KciC3LiCR~ao@Dq{_o$$0L|Wvu5487*2#M~ha;cwO>tYf&bn zMXTv(Q7IiQTI05TcP$+)+D%4_c9(H(?BTW+?MX+A_L9+}y=AP=IvMM^4;?MqSH>~- zqoYOpyRAhB(9xm;WwhuZ8EbX0+xEyZI$BgNqeX|vXwiBZ4LQ_pEjo;j79H-kH93Ng z79A;LosW`noTKSz(J?YwbgbLXvEyX4=y*C>bb^c)ohYM4C&{?4lik*$Q|M^Xsct*| zX>_#cbQ$N~8FaMhOt)P}XUTY7&ZeV9=eX@$J(rFao#(c7KA(;^w->$4R+~b4syu4^w(eiNx#MY=Pv*?!8-o)pZL9m$H8APWry=7U1s(sU2gVwnODR( z_vEQ@=TSP^^O%hGJT7C;dP2r^{-oR5^AsKJd0NJtXWZ7FXWiDG=VV+D&(qPK7i8=O zFUq*zjdZl&)jwme@;hlzL3$IFJ-LT zS2CXO*D}`d8yUU%mX6+hC*!sF-fg}4K}K(Wq@y=K(b1cq-L|*>LPu|YmC>8uWSkGb zyRA2W(9xTMx?%LDf{gX4C}TYf>F7-*8ON+lM{laQtv6Na=uI^ly{Rr^t!lV!AFN47 zZ)(ZtO>G&ysUxEkb=}sRdUW)rzT4KM0Uf<*C}W))$v949I(pMYMsJ$B?Hp?+qc_dz z=uHb5y=f_)9lX!&LKX+s@zOC6G|EOeqyD%UB=$OODJjU$D**=-SLzs_Y z$1p!PXZA9UP3Dh_an9K(#`(G9H_f*iO|Y9$qlvho8cm|3Mw4aKXlEHa+7ubPz*M)@ zXc`?gnl59`47b&2rrT z-MPeVSJXnc)o2kNHCpVp8ZB|#JE2|aDAQ6Ik71eHuIlA1;x9!3Q(ov>^WR&S(8Rtfs+safvw{Oh?gCrlVz)=@=Pnb*$TV%;V@N)A2IObb^dBohYLyC%LUmC(}`;Q{1*D zr_xcT(`2mk=`xOU1|4NOQ%0H2a@#p}wu~~JLr0m;l~JbiWR&TA8TWO8+sbqy9c8-6 zZO6Zujxt>$2zx1Fn3(NU(W-L}rx(D6>_TDm=Ukq-C= z_h1(5dVFNDTC!L-;0B9zBL_K@6st0>%>TDv`)P&8fxoCEdUX?zg+KglhxA_EV)kC$ zYWBVMHnX?u_AvL?JHp&|?@Z?0mCV_Y%(*-9J<0rglkxk^e!ur8;}0bBA57*vWcG$U z9CP^C9!bU@jd3>TvBZxjbDoHCK9?tx@u$q*w5MYZkMm57)6XX3&n5GpPsU$J=D!%@ ze4HCMja#E$vYXMUmvKXldWDWgy(*(ougTckUYD^Syy3P+y-7!--jXrrZMQY*9k(^= zT^ZNSdvrAFeHnYk2Qu#WLpmDuk&HfkEaMvbgpNjiDx*=K$=IhqciXk~h1(kSB^{0W z%59DM+HH;chK@#kE8{VI=eFzndpa8RgN$qUN4GWVCpsGSvy46X7q>O)S2`N?n~dl9 zyW6h&Kj>&wLA@{N26-XXjB~;=SE$(HL4yRjjAuBQ4M6QPeU2&*@%utHI{MACUi8asoNUWjE+V% zm(i#eGS;f4+xE^@bTq29j7GJQ(WtgE+S1N#jcQLvqdK^4O*+!is7^B0xwDMpbfKeB zU1cK@?lKzHgN{aRCZkb3Wi+anjQiT$ZH?+pN2B_;3ugf4h8a3E$=jsqT8a32y>pYB(E^Ps`OIzY2yVNPyxh&fXH`t}EImjXWwnN8U z7kfW6oMZSYh5aY*%LudgWu)1^^R{h_b1xkg;}!fnNZZ-X4%h`d;vd4m4gC(q7`hX7 zrq1{&1>G5Qy5Of2FdyfR_{hiEJcobsIENd2oMSo2p}+L=|K-J&88;vrzP{Jo4rUg!o07U$(&u1@mYzB zk~y=J@i{Th$2K>{>EdM0ykyS&Fdy@R#3jl6g=YVG)}k2aF&8IZlFZ*V@zPCmtcuI* zW>j%GZm5bY=&0gK8C6^*V>ivq*nu*)RdF>PRVlN++D`bw1DKWIW&F zWvt-|GU|6C9rZg&#%po1+v<0UjQX8QNBvHtqkgBmZKpqjj{2P`qkd<}I0w#lTm8v;hk^}A5UF)yN{eiyr~ewWZuze{D*?=l%{b-CMi)f^`*V9qI8)U5WjWUjN6CL%tSw{VCaoag|tBm^HMo0Z_ zmr=hvWYq6Y8TWOU+v>N0j{4p0w&UMJNB!=VaqitmNB!=1+qLt6jMwEsI_me3+s@U8 z>8Rf$Zd>O^VV2}Ed}K+g@UM(~95+~!CpgHVzm(*k@5KJs_YU<=>`5LAf9%^1={^*tL?7yG)Y?%A~b1{d0-t6z1UP$J=n9SK2bGQe;l+1rQng2>M{%VYKkAE#0e?1w0 zBh1I}W-|U(GX8ercM`uF=Hq$K?2rHbWX=c4_=hph$MaD#=i|hmn7yB$n!S^s#ToDH;r3!zOtLqoUd_1&H09o=6oxoIp4|H!@ies-T&aW=KM%UbAFOB=V!OQ z6Z^$&{rOeK_3;}W{rO$S-tdQv`z@%CInkdAGCELE#LFu&Hj}ZQJ?UssFB!+&oQ@Xtc3X@3 z(9xp4GFsG6##;4v+a5W9jus7+(V{^zS~OTjLx#AmMMLRm(J;5I$rg09XiFLEyp@dO zY)wathRbNtHf}q|M#yNt9WC14ZO7k%ju!1Gti(mh z{Mm`;B%YhhFE;!8g?Y)G`N^CG$#_XJzA*73vma-1GQPy@kAK(1OOrXvlJVuq_=?0U z&3^n<$#_0-mUwmIQnNpXHOcteP2<*{-Rx$xXLsCCd-kBCJ$uS%&t5Y2ti5Gi=j+_o zo_*+O&%QF|?B}-j?C-Yr93bO*IFOF^93*2eI9SI0meJ9kavA&nAu_Iw^>no7P#Ntx zOve6uxZAFoBiz=WBk5?*QEqF`(RB3Y7#a6_tlO^DPlQPp6|dXUOQynKIVxEE&)DY#D2Kj*Q-%OGj_clkr-d@3!7t zAfq=I($SlX=;+PGZrfWgp`$mK%IM8yGR}v~-PW5c=;+OrGJ12BjP&*>x^yWqxy}3!oTHWlneef1KdULCc-rOdmH@C~^#2s$y&7E}g<}SCb z$p$)lbGM9jzDLG!?xmwQ_sQtZ{cbzQ9+1(S2kGd|Lo#~vu#Db3BICXubz5&9qoX&E zyY2W-(9xSGWt@9Y(b1cy-FEFfBja^>mX6*$=eBe8c{+OYg4@>lMVO7*h>vVc^<0y( z>?Pb_V_xPUhyL>3rwXpYYPdH3{ttrrUmE$h-_46Zdj1NJRFu7H2lRJ7ubKUw&+BI2 zE#EMEao&tMeAn?-GX8d$U**4(jK7=sJ#)O%F#EfO4`L2K_rqlTqh$WaG0r)k#5mtY zd}{W`_F3Z3!<_#`nDf6(=6q%L$MbcVbG}LDe{1%~`CT&S`e@werwWEoLVy9X~?)b>d;Y~x-yDWPsR>h-)&b-1Gg2YAsxkO z8MXT8PBo3 z+pg#ibkwJ#jQVtvv4)*xJohd#*0ZaO`gEhCKHX)!E&a(Sc z`fMd*t+saCt~i{I`fMYkJ|kq*XQYg3Z0olAjH07H+qrE`M$=KBF*4S9dl|>sfsXp@ zD5E|(x1D2SWz=UJ9rf8sMt#Q1sLuo$_chUN^_fIReI~o@_&d{4pD8lVy{UB6XPVot zqvSvChZSf9BZlJV7MKTc`lHOZW{VLr~?%>Foc5A!+hk<8gM%<;XFIeW)A zAJ4kP`@|fM?;GR%-2GxaelvW3yBWPX05{Z|1L^3^K{9%Cu#A1GOvbfc?zY|>LPu}b z%b0Vh+j?`D+j?`jjBDTsI(l=YjO+g>8TWfM9lbe5<~t1;*TZpi^yYXOy*WX~o_nI( zu9K78)|->*=*=l^>&>ZjH0CrJ_j|hAuFo^*Xv~>1uD!F|)|j*DXv{e>_Rw?P)|m6? zXw3OCp4SC#yKXO}qcIoBXw1bj*6k7*&-YRpYj~NA##~NEW3G_#T3qS2##|+%F;~;k zm}}^0%(ZUYPp_k+G1tpz%ndTmha272n49Qm%*`?ybBm1ixmCt`-bP1bZkKV)JLqW4 zoo;K)U34^NgN(-9En}_jaogT^FCC4!Pex9P=IvVq^+t%a}IvVq+ zjCFoY#&I5}qcKm&Xv~vtJI9`q(U_;{Xv{M*8uP4-#yltEzMgkmV_u-6F)zC9_#5eH z%u6!Py_e}|%qwoYc3ze7y1Yh5V_tXLx%vhjjd{~;>--kX#=MP>Y)qqEgR<-$++btg z6z_1}kdX-!9Q+PJMaZQb?`ryU*jX)oh3ba301 z+mVj?bdqsZc6M8Ry3kRdt}=GlZf>hjcRK3RL&kI5%xzb6Pde(;OGbS*m$8PuWjyyj zGS;)NjQaGWqdxs*yeNALr`V6L{K11BL(+;JhKEq_xXA2qU#+GiY&sKEQ zXKNYt87^aewvn-(Bj~8lNEyf6mX7+2a$9}2qoY2fWz=VkjJ4X{ZM)(Qbkt`@8THA@ zsLxm#)fnft`s_qUea5?OO(xJ$pNTTod6JCdOs1ngJIkog6t|sYQ)Sd=8XfhSE~7p( zWYlM-jQiTfZS|Q&M}3OicKq3N)Mt*2b8jvk^(l7Sbu>@L>oT8?`YdqUxmrR;eHOZH zofpBZ&tiOJeH!NKmSszDgZ0^!gBf?X*^0r`5uY)H2df7mCWBe%==vz z<}vq4=Im?sWA2xX@1M*+AQ?X}@j;0X4)eas!o08Y#D|#uajs9s4-NBk4~scbpTq5D z)aMA?P<@W1qdrH;sL#>w%sIhr^*PaP^*Kq#6>%~h^*Kex zZg8rM`#p`0`kXFf=RZTn)o~^r^*KvMea@D#1E1rztL9v{)#p4q>T|x^>T`kH>T@9- z^|?sKW4PFDSMDWr)aOzeSLJ1HtIy?h)aMEryX%#1tIt(*)aPm$&+!_!UD4OlQJ?E% z)aQB`Yj}f<=YFG%^}I<&eQu_sKDWqtU2b(-eQuLcpWErE&mDBs=T5inw0F@_pA9nV zbGM9h;~uxw=UzJMbDxa*+%IE&9+0t~57JSehh!Y{VLIybh}-J(C>`~AOh$bkm$6n) zxNTQ_l8*X3C8Iu1%c##YGOF>c+v@Wi9rbzMZENxZ9rbxp#yW45ah#XvsL#tX>hp@* z&aqcz)aNxi>hrpc`n(~dK5xpnueaP*pSS6#&pU2A{=0P4=RFzc-uraa=L5H0M<2>~ zT|T0tJ|Da7T>XTO`h4oPb^Z)yeLlxW)~6|dgWwC?V12&iAcy`@pa1nc1poY-7rx?g z@J_=H=k58%?Cts1?7#p0U5v9I-^V!pLo)tjGXJN)%t41b-Za1s^`;>my=f$)H;rZNQ%z)C+fCipn`U(Mrn!tcE!@_d zmTv1!D;d{7YdU(u9dqoX(NWxmspaXoaTqc@#o^ro|nJ-3V7u9L2A>rFR0 zdehx)z3D+mV>Xje31+kUz& z9gP_!qcPjbI3Gs4tubThXw3F98nc6p_1RIzdgkb8%vc%697jiEc5+)|#?#T52{IZp zQN~(La@*cFnU2QnETb_~WHe@~j5bVjTVtlv(U=)-Ta%e|G-ekW>pV-waf;|@%xoEr znd7!|Y_5#P6w}d||Bt=14wLE#`t=egPTT`gVubbGxDweI6Wa(O1eO3HK$;;=9OCZo z?(PY3cXxMpPwrb?{hK{GXOMi)cmKK1<#|&5c6CqHsXpCZr)Op-JBi6L1I6T+L1KJ$ zIL90_*f`~wot>loA;u}k3>7o?h8d?Evx{?FJHy4?mtBohjv3(`=juq~lw(FY$8p{b zwj2{EEywVC#N)$gDwbo)rZiQ|G1y^M7QZ{)`P)9#-e2qd<%Kb3tzXzZ8ud)GM`X`5 zdnRYLYwwlx#(O8d?WFr8wrsI)>SH`MvhURUW%}=*`k0*qlHT~h3?G!~e{iP%AxUrc z$7TAD&+ws{{)c7w@Wl4oBQpJuOl+|nmC+xa;bSs=j!kTKj*IMB=lD$j6C!);Cnmkw zKPl7yJVph%-#wi?y4E;lqwAbwHoD$9o_=mHPMPUOG1qXDb6nLo8>h^4igu zw;89*bi0_H_YUWnneH@BndvSuG2ZPQSNlE2DKp(GCNoVCGlutxiT!>tde1 zMb&Jr(r)l`xF6OXBr-geY!GCXaDr%U~9XP!R8 zGbFaxcFpK#jO@GmOd0*m8J;DwXM|ak-ZI5(iOuHhk^S7&Ez@U?49}VAKUZY8Id_KV z$@G~wvfG?5=`F7LGkq4w^jR>YUns*1XZkFX^k!$#iautg?y;J(QV%N1N{bn%thBh8 zth9uf-E2uQJHS%TF)J-?oU&3+F@2VCj#+70=a`k26SGp5H%?h;1u?rsFEM^sG)`Hm zx0sAjD`wTy8Kfd;w5gb^w3%_rN_~w}Rw_Bi9e8u&l$Ev+la;m< zGdH$!j#+7Il|Q5iluvF)|TWcnYQ>2q9U zw|{)5&k2z|Kb)B9e^RE;$(cTTkIER^cN+z{uf8~*e|JY%te>RYRW~IQBf|s+&JZ;E5ziYE5+<# zSBY8oS3AdCbd7P!Mc0bybDeX{Mb|sWTy%q&^>L$d%0)Mc*&A*aG3S_z9yd<8=m{|~KIt6S_fy6x7dC=RGmw`Mz<=MIVT<`Jr*jMISlGT=cPV%0-`u$wi-v8LQ8n z;~x3Bamqzsh{;7?ipfP^iOC^fJI7q~jd99F-#W)J`OY}yqVL6w^ABR|{AiqV(NAJ> z(a+9tj{PDg7yW9Sa?x*Ma?$T%a?u}ReEsPhbJ1VMDHr|i9PR&OoN`gkJc*fmU5ryM zn#wt@qp8K*muZYsE}GUk&eiFRQ!bj`IgaxT#_5FA6}G%IBc*> zc93DGDdwih{XdHQ|4=lG+36Q%jpjTj%@*0uM6*ZsJk%}eZNHu)qn|UQpDXEYFP=NH zpDE@^Y_FX+(`UYne*R4V1v0!~>Tj=IDARx8OrJ$kAKU8}&2aa~p4)n4^ovFIe6Vs*EMMW6dsc|mlzVznQSMpMIOU$+VscNd zm_4gb%sQ`kj=877IOU#3F@2hxWA15oj=85r%z9`wPPu0#F?+$vV*IXRoN~{qV)p&j z#H@|gjZ^MfLrm^jQ_TLmmUCP)Ydgo>vyO4fJ?lEh+|$Q6<(u`y_+8&QuGI~UQ@+_y z%sOmyj`?OI%Rm@n8aE|-nNaK`m zMv2KcyNSs+K}?<)?Huz>**N8!G0t&Jb~jG>W)Csryr&pDdl{#Ev$vRhvyXF}WBZE9 zH)D-czS&PqzS&<)zBxdQuLGT9zB$M^<(q?@qy0mSQ@$A|X6}tQPWk3g=eTwb6LVh< zH%|HH2guR4m6FXG&95a!lvxr~2QT7QTxe z&ppSRoqpkjXwGxYiIF|WoD|u=k8pBi-rc=0KO>_*Gt>X9 zq&GWfCpJ6hq&}uUH|fphc^Uornf@0fw*D7p_@WG79NF{DB}s2KFOBSRU6%To{_>3e ziljIDS7!8AMfMzgb%w7=Y<8|q{VlHRDjajn^|6|A%nekOV{SA~Ip!uYIp$_D`_wIB z*7mK=F~{6yoN~xL$IO>-J^ilw)2IlVe^LGj6YmiT8CeWB7)c z9P_4e$}w+=xfgFc#~kyHm>l!2amq388K)fczH{79KQK-?=0h<#<|8rl;bZ5RV?HrX zIp$L_Ip#Alk<(RLXV~+X8IOUjc#pIap#EjMV&T;Si!8qlZ zAI0RDpTy*tpT*>cUz}r(`PDe(nBSb^nEY;>a?BrM#`#Y%cK$L>Ip%LMIp!bdILB({ zjeX)=>SCO7%v54>%+z9X%rs(rP3s(U%yh;n$4u`W?ayGGa!gk-b8klDlw)Rcj%#OT zG52K_Q{*8q6 zyV^0!%x#wXg?XYu&oc8y_AE1BWZ!}3kL=$pTOhIRx(jCX3njK4b>U2(MI!qSzi39^ zJ+bY^Ju>>mGQ4> zjZ?a&99Qn<#wq)3 zA!b!>=^S^At&CIl*;>r*+U^{)&o;&>`)n&F#_gQrir(HhWuJaxvd<1;#<0Jb*mo2& zo&&^WpPh_T_8BPVz6^4X*{4HH_8DxPvd_-ODfNHOCxO3ZlfW}LE55My(+amqer=a_xQ7^m#ByO`{=hnTV2(>d;ndl{$f zv$vS+vyYhUv#*$}G1fU|pZ$ze_SxS#j>!SWDf=8KW}FWaW9MMwlzk2nlYPcH$2m4$ z%n9dEgAM1ZvrqAW6kLj<-^tm$A=c-Jfs}q~eYchOorq6X5{q>3Mns3PPjgdXu z+?45mb7cP|w_7s$TQmJ{OM1KJ+mk+Jm^)%MWtcmuD8t-koHESaVlvDXPh$3{bKq&;2g8cgJNd-L&hnqJS=9FKO)B0qsA$#JSJvGe_YJ0f5JFrl_$ky zm8Zn)tWP_~)$ojS%qq_sr>ydvbIdBw8>dY2f*8LqI>%M`l5xr;FN;}WuQ2(lYA*AlYAv+4t(t#Gs!o`DU*CFCX;+8 zW_-REGoC*fr%dvr7@I#Cr%dv*bIc^a7^h6~tC&pko0zfs-8t@Xe;B7s@~49bs>&+?f*D@6A5Nw1{0YgjSUzjuafGhCP9`pAAZYl!SN8#DT*#1?yVWRJZi z!>t)!DZ?u#PMKttSWTH^RVvCPs~M+EvbvZ|vWA$QX-zS!c`fIdN!B(_nPeR?eb#l3 znWT@HnZBNJ$|UQHS>+pu@wK6G$|P-KcJz(J%=(RuQzqF&OeWb>%+9)*b6gF5ons~` z8K+FLxpT}UTNtNIvZWZmTRF#7xV3T0B<*5W*f!2FlWc38GRbygcFOIYVS!WG~~CN%j_#N%j#lR{J`~9d4{~$|U=V$t3%W$s`Ae$p8mB$4qjNampkIJI66O z#5iS=abm`Kycj!&8mCNhn3zm*xO1FiM~KNJM;fP0a+H`%a zB*!~P`zIKuOmd=_xp$Ir$|NT{$F*~cnEP_7ampm8Imfwrx^c=RXE?`kJ`=V~au%g! zlDXR!8XwN4VwvO|Q<|!hNvgjimi;a1?B_0?NzOGZoH3#?&m`wZ_Dpg?WZyL}OnTc* zFN*9L=Hd)rlGrlIrIG!$mnF8H{_@DaTVIj-oBqm7pQ{p^ud6fqYcl<>&Gfl0>CNx; zk=_0cnf^Cs_@)fsoZ(v%o8Ma_`}N8R^?B#G8eVXYndC*|lu2H4j+x|T#wnA0Wt=j}*UoX*{KhzCl5fRi zlJCUKf$yDTCi%fQWs)DoWRjo6jL*+v#`72Blu3RSWAiuTlu3Sfj+x{SS;b_M*~Da$*~R$k<{UH09L6b=%;_BM&t;r4$=qV* z-aN)Blg#TJ*Uo%m?#ukfDU&SV9OvqS#wn95G!rePb7S{63-+(%nE0WXpBvb9dYr<{*KlX8D287zeBZDM!$4qf48S+ zM!!s^|FRkVavA;d8T|?w?v>#cGu%7FwHdC9?AKPG;f73~#*DrxvR`v^hFdcITQmBV zBD?*SGx}9B`c)(QxUH7q)hm5sCRrm^QzluHiZaPs#wnAmEhdw!BW7n>SIlbe;~X=| zdd4Y}tS_d|2F@{)Y$#@?w;88QvXPiozOfizn;54|vZlV&&HEih|Gs#xQDU)pN95YF~ampmyi1E9vb6kbn8K+FLy_gl&&pBq29gI^Z=`Uud z+|fB^k^#mklk6lWu7S>Rbq+F4nWRHZCK)Vd+;$cd?+`I#I8;m~8D^X^$u45<#c=1C zNp=;JNk$l_Ofu3qWs*_Oao60F9cY{~$w6W=$-!bW$suAgz&Pia zNyZzeOme7m9FxP0QzkiF%s3w*#?Fz(DU%!}CX*cP9Ou|EVlv6G#wn8=Cnl2|FD8?m zAja2;&M}jmWSla|$EEpmu2*qXY^M@_FebN#P*DTRi^*d8T~a$Z#J*Z=&#H0^{J29xgoNjId078 zZ%X~`d~kE>V>WNe^tm-I@OPB)$2)H|fphgbd%8 z`k3GQGyNZ^aLh6f#%jtk4^dH;dDu8*nMcHAnMcL!T91iY>5n_dEc1kM$}&%i>GPCx z{FMG_=a_Mx5wjwmHBK4lIWfDz^J4tIV4O0}i(+>Em&B}&myJ`#c|}adc~#5~{F-xI zHLp9zjPr(Z$~bR2$BgrqbNrP4ZR3=E-Vt*R?>fho`<`*iKJSZJl^;0A?DL^<%03^7 z*1QuEoMBw5tDtsHBQ;*J2Cg= zd*_&aeh`y=el$+m=O^QoeSUV1JMAyVDf|2?Cj0y*W^VlM9J9|K#wq*!DJJ{;C1!m7 z7Bimz7^m!0vp`~Ob}>%bXDa8IeWo@}*=HIt*=JfYV>O*~+!d!cPT6M$G1;f9nCvs7 zn5;3AbId+78>j3ui*p>4S&dWnnN7?%&o0JJH{+Cj<`9#8=5&s8Y%Vd`XKv$^edZC9 zedZODedZJ6YkudLeHJiI*=IrLXn!H&lzkQ!GxruTPT6Ns=eUl#i@7g7j8pbm%sI~0 z#f?+;S;9Gv^OA7Kn2xq-_)`n8=h(2c733j4Mj0P^Qn5U=j44f($wUA1U$0r#tn~}a zMWddJmXGYYXobk0i+W{v#ni|4-QJNs|I{YE?YniUzwOiYnLZ6kZ+#jweVQ`*=1l*V zjJ`Fp=c1J|`jr#g^{kT7ubSc2BKvDs&*;~P?AO0$M!!~KyZ*IPAG_vtBD8(#&(%Wk{s`QUJYU5Zktt%-&WK zvmb2k9COqb#wkZ_DW=a>&M`-A?HqGdyO?#ejd99R+ltvUwiDxbd*hU&`iaR8JBV3B z{f$$O+EGl78X#t$-pM(xt%1%lM-4JgIjX}s=BUBWF-PreoO09@wGHOe^UsNKZG7@Xs}A8nj+R9Q@p8Y5;5cNY`;9%9CG zPcb=aFXNP>_7-zr_Hm9mYF{xqYOHa}QTrLE9JRl5+>Z}1PC4p8F*)iWF>~W!=a{1o zF-|#ZoR}OnUd;F$DrP(nGfp|`a4|NIFitt@NavWNjxtU;>S!@J>KHL&b*yvTJC8F? zIqG;ZIqC#4IqF0)x#cA1n4?ZMPC4on=Qt*(8mAm}nwW7uU5uSGj8l#}Q%sIJ%Q?=m zv&H17bBt4tI#*1NI!{cFI$w;h3!Gz)y3jb~sEeGV{fmuLj=Dt5+`H5`<*3V?<2t%r z%ze4SIOV7-o#R}+$~fhytDWOGUt^s9HuGBJ9_%8E@i*PDot&-SS&8yXALcuIGC(tMUh9+bwzRkH%?-{K+})kUtxz9r713JLIoouKzdZxN?6t zPCMiuVs@}Uo#RgUmvP$h{uXl|{}I!_WBfVdSo(%A-R! z6#SJ3vS(XOzc8o4*f5tB?K9G^W6;hW{fCYi)Ujun8|9E$diESL>yX*nyU^AU<}p>b zjSuNk4)cP2iE660`^Sg*sI=YR)@6K{A3A)<+{={00#G?Dh%AMLknLS%zP#6{j<7JQ ze_3w~i}w>RjcGhuwFwO39szjcuNt%u5?0a*%-$YF)?XbDZ|8IK9&&84hK%3)<>DXfC*9FJj{kyw?MzHMu?EovjN8WkUj)gd>t22>7fB1>T{ z_LTke|v~Zy_m&3M@2hK@&J1T7Z1in4wUiv}humiFb`Xj3Z zUKe(x0ejPx!vM(aO*by=1X|z&Dc#l}s2nDzV(`HjGbQ1QTrLT+Xl zR1Ui!OJO*&5csYrs|8*kM$p17KZ;vE67l$WkaHt3=)q z#?V0I50}I4klA~9T-XD&$oHglTYEv}us5<4_CZ#Ud|z7nvL7vGk&mU~k?#k&nf;-1 zH~?7+2O@KkceHis7Y;(t)_AZL|6c9!<~N2zXkiR?WDLfEJ_gr~596t{U1wu(DC7WGNhhtTF~o;Yb=7gX_xSD9G$xH!d6v+87)|>9&rA%HcR*%ush5iIb@KNSqA0u~VROI2Bn6ry+AAF*clzvReEt;S5^vvVA$633>Rv z#)q@0wDq#^&xYK~IZ!#Ai!6onkX6EO4d>H1*6|xkrMi%0}24$7F>w1T4Y2i9q^w&Wi zH;evyD!%A%fZWTCP&wR$EQOnq#klKg!!0ymk41kgWcFC}w}BS-?UZio4yYXNM3%x` z$f|MQO+(+dZGFw(L&f917ji2TpmMkmSqk?f3voYyvRd4A;Xzu`e18b^z?tt4Q}Ox! z2;^=ah05VEWGOt3tP*&Ac!CB3XTCoPnLXzFQ=kR@G^N{m1}cYVk)`k)vTESZ)6lnV zC!gpqQ1QTDgxtzYP&vGeEQME)g}`4$SuOB}@ER>#Clmd3$m3?Bzd^+(`kRn@c?&9s zw~?jr4zfzzjp1Dyu*XDy4>Eg9^!GuF`vXe1^&wOaA0bQOV`SC1KcS&-+XX(+Kc(Vv ze+Idg&!KYo0$B=QB6D$fv`xkTDi1wd-PcwWx4OEf@C_|o@$%*HE#xD>|MC1gDm;#} z)W3(^-w#kZ{D>@tpO95XpgH_Z1NP=AhhHGGH_y26D`+F|8>QR&9V&-Ekfrb^vU3FD zPFL3w{xWU1wr$JdZ^#UFwH5yl6(5M2g=DM?R1Q-iOJQncZXm{nX;4-Rzcoxti-$iQ zR0)52Djxm}kY93Fs2pZQmcmTPV)*sF!^|{z__IJM{8>Q@e>O_DH9J%e-H@d)2eLE# zVV!Z$Nkd=GUoq~vsCe9SLvCdrh{ttgDa?l~#63UCDsk7>h6QNxxEF*faW6#0<6anY zFN;7twlWRJE0$GsXAk9&2jz?CByD7BM;BjvRrMNc+E$&Sy-PWcM&+$l} zb1EM97LZ%n65=r)$zwb+7k5Y7)cry`dN#UktSD}D_03^hTF7yB zgxe1EA>atNJrzH~^@H5u4p2GtN0!2l$SOn75(dz~5KJhCoglNv8EznGLokTaZFNB9 zFc?`1J0m-XAntVatzn31yKTGi05EQQ^X#Q|uj4SUeQ06bU@dqQUK z!Es?P&<0>{O1HHSR1W(hOJOXsa{z{ABHxdezHO`7TPx$k{!~2j10XkZAXE+qAxq(4 zWFhiHP*#h)E{vlk-TLvMN6xK3l#1W_!ytEaI8+WtAWPv$WR=M4!%;N&tv?zvd))eC zK#TlXO1E_!R1U`@OW_1$^~g`8rEl8-e$P*$;*p;WxtUWS9^{cc$Ri7ppN_Ix~Wa85VXiIqI6pq zLp;eNd6Gv~kNh%P`tmkHJj`8A#UsB0ax+&#Jjx?^lt&gKzXoNs$eY5ow4~X79q5rW z+pnkMv;79h-P{QAERW<_9$6*w=5PxQKHG1F%pSA-Hqau!oziXH0r4!4AUe%U3|LVL(N0K7jiojAfD!tJk29>p~sKvA3)EZ_n;NUJ+Gl9JVZ;n{SSkc+y4j^ zzx|Iw?(i|F93DrO!V}0UgU}kDq``0hQ&777PlGlH&rrIpXQ6U<4p|D%BRdBn?s<*9 z!waVEws8X!^F`1s#aZwY6(5S1A-DDlR1U8qOW`$SZYaiv*HKm(fX3SJ1}$9gujTM2 z%#jqU~k`Y_y96{`;H4Af)@Wrly2)| zs2n~)mcpmV&iIFA0{@JbzHRI94mDfe=TtoKFCaJbB~%VyAxq(FWFhcxP*w}PK730{ zy7S+G9ytsDdn$hCe}LT0k5D=Mge--hkyRpZ2*1$acm7w%?6L5F11<93Dc#l|P&xdG zEQP<2)g%9#mcDI!`Yr#5ibr0vu*`IUc%n!0M2{>)J`KuhkvE2EY4KY=9aOpH(^K(V zJ_F=T~-g(rqmX@l228nI2g^@}9KxZTr@5`7%^I@?{}6vmC@jJ(7od zWG?df$x1KuY`Gv9S*P!A9 zu_olk)`H4mZDc8|gUk)Y*sw0jD&aTPg+8=+`0GKH@Yko};co!BmkptEXhW95M#w7R z*N2U1@bEW*Quv#K7XD_GZmTa;4kctMY>w;IqZlmg#pMaaW{sYXz;iPLMiS+ zpvB!m>9z(#<*+ld6ow$H#yymVzI@Lo#yyOR$Gr>WR)#}7(j$4KM;789iLzSUO<@!* z9`|lgCGJ4Q;~ovUmomf?J(4GSWRZdv8j&wGYG-J(4GSWYxI$ zqoFU~6^e21PsQUt0CFn_LOjqTd7wuY;ywgrwYXctI9fdJ@lYl1L#cS&he7V;aERx5 zB+v86Dsi`lqiFEBkA_m*$AA|1v6OD>IEd$YB+v86s&Su4Ltj2|k8z(w#p6C1ax14m zJkBF|oJZ#3?r58i-&IA=Mt6o4#f`4HcQ}(4HhcTH_AJnc;C|kir{W*io&&kVbD?rL z4_ON5Ba1`OTpKQ+fg#`%+6y7G$0xKGfi?seQ@X87pmMkrSqhgSJBJ|dbj@|)a?|=p zv{!&;sk<%tE2;QUTm`wctD$nZ23ZQ%B7G>j_y?0Ud?0%r%4!2pAFihbH+G!A0rUaj zOm`y{Khxa=xtp7za<~Oq3b!Jw3_wG;jRpo_LOI+HnLW;QcYrnkcT&2oyP$Ho8(9kX zAUg+OSSIp&X{mf9JAsNvejns!?uW|Z0c0sWh%7|@5Xx$iH-?94A#(dn_7Tt{=QG(y zsrYBIk3sI{ai|=gK$gOj$SRRHg{NpBaz2xN8Zvu)Ci@I%kv~i6ww{B^;dx{!ynw78 z`HQqvK9hZkibwu3O2$$n17 z1OEbYGhaeH%_Di5M-~GA24%ItTf?`saLer&{~hR&+tWOi^fV8-n;#*b=8-(jBa4x@ z^bWt!K;#_be}&ARJko*hc_dHs$m)^*O-to7*?*{b7KS{0KB`)TihoqKDCAzc zL*>u|Sqh6GtAyVe7N-Gwd{ngrWcK)|YDv(-Uy9OgEe(}JPh=@9gX|1{SZCbJ(op$K zb~!2@_wtZiSph1CUdU2d5m|`4H_B>pH-%bSxK0**9prJd=@m>?LS~PNJ_xk9J1E`O zV2Fo#BoFh*s&Nmcq4JsRFe)DRE|6Op4)HLLgT1M$TgWGU={tTF=iVNV*c$7iy8L1vH7WcLPb1ookH zTl+%gFcw(~`yo3=AntUn4Pk%N#?NFAfXq<*Z1O-VJ`e{%ZtP&F91cO2!Z>7ZAjXFA zD656v7!IYy!#@nFgnu{{5B~_ry&MVgof>2*9F43Jep5Jx1`q#OD20C9$UQ z_*xCJ6iz~RhCi$`?vrV#d?tGe6_5K=$gP|PmBZ=CQaA%yi2F>G)#7drXVKzupAA*w zK8K3OeJBgRec$7!-D37cf`HM7EK9+rnibwu3Bc^R%HdOFDSU?P9E5hiw#M+esr{4LFF-RDKbifKijT%ukemA&Du-{7 zrSL5>HyUHZcPOilK~wmiCj8h(vp;}727FlcBNhL!>LaovFOXbtqd8l~o^FnTBK8QzpB#-pSLhK8otQI@p zhF*v!Vz+bM!l1{_xo#0Eey&>-azEW69_o=i)FZ3JURxU$r-j%#*ewB>K@N6Hf)@Ky zlx}Qkh^KlaPxZ*^u`f$Y<@4F)sCewlLvCgTh{t*)kM+nx?7dM|jlC|^(v;?W9q6$$ z=j*BXoNs{KPb0*GJ(34|WVP7qLklfF=UX8&$edpZwAfdsbYrVPJlP|8vPV{reRWzo zKcQWNng_oo&(Z-_bT>zpyTPw!c1BRN4M&8^U@tr75sJSeXJFQ1L0S zA>mklkL`2d^Fl2H@6MMcjb|#upKft8e_xuD65V^bLdACSInohJ3u}Jd`jD& zihpFcBjj!dKz!i_SqcM@)rO!Y459^td`#N`nL$3L9SqtK>`dv#hCqDh23ZQjkex#? zEED=Jv{XK(9ZtnV-xYE*BOtykk1T~z$U^A5p{yEuYX~%@+dmrg*x3QfRQ&djf!xpT zP&w>@EQLLhRbuBm%zM$|w|{TQ46+0416u6+Qo6CRP&w>}EQS4%)nh+^mdXdU2U79a z4}#px!4Qx6NFMW%h1kcVtQI@pjy{wozwL)XmD_$e6~FCAKqdYCYU;YUV9(pm&VR_KNTN~2OzihAXE+yAxq(5WNs|RhDT6V z9f6kcC`~>Bk3p3Yc$|ulz!Q+Wc@ipzr;w%aG_u+Vw1#JB@ez0yN+a+bXe01Er5k$z z;+r?fQg{j3IRe8vBY&BO$|tt3Q1QrLh1|+(5Z|0fmckpzLga6vtQI+6lzxjQkNj<@ z68Sq+Jo0xTck>=p4(}sN;R9rq$oWR|hqQR)A3-Vdk3oz46G}JsDO3)hAxq(NWYx&O zprP`a?Uz(M@~ zKC)Wm_2D;KJo4Y66!{;ZMgAwH8~Y35Ss%%>KC)`$HQmiZ`qZ`y6_0!>$gNBb@u-jF zQ6E`|d^(g>BX0=P)8vuQ097LIO2s3e5pp*(K|JXrdD2H#i@Y(+N{dH68Q8X%Ok_UAv5+FK5{^Lb9lhc9W#c7>EWACeN$M33fbX2_OV4l zi))s)?&CvuDtxxU7TE*xt6B`=PiB$)$t<$1i+dTCvDh4zq$OEg3anUM+FlVY_JrKx zG7x_^i{$TSt$nJZ#g?!~vV8voDdquRkBIFi(Lwq9#SqgR5K6TMzYpACsS!@6+ z78~sq(P9(i7MmfylY=aUR%@T8V3BV;uS83-xH4F=xQe|ZT3i)!i>pC=IR{w^YgqfV zMT@mzObKFCs7&)TOeTC5A}(~>N109Gt+Xs?JC+aR~N z5mXKvBTHcuYoESou|8}{OR~5bSh3jGUJ)&pAh)^rP!uHnQwP>+1^rIzN+ySgu>~F7#7I%c);sA(8ek70l$hH}a z7MsE#T9U;Muwrqry&_uN8FGt5AfEe?Joj7sOht>$VHaAG#o=JZ;;#0JXmJGO7Dqzm zFbY`;yCKK4Pghe@GkW02&@nm$6h#LuVYKPHZG0ThKV{Gy%-*)l_%Mb_+cLJycZb}; z9uVKNN0!1~$oAQ4@G@f80i$>67}P&G+M9-=qt>vG>D|%3V8zi`D(+}M$Q|tu@%OVx z{(ctOK6_0~&CX%KprIZ7ioqToLw6p+wssIL1y6jf_h8ezr$fMsr*Tx=(|E`|9SW7h zVaQTA92tK_K%Pd2BT$VEMZv82sj}zB$Diyzm(;&Zw)1h)W16c}Z zBHNd%sd5dYJBAPLKYZlKQT;pe7jYIZDqci=INS7b9L|9%<8Uq&zlQT5zlQT6zVeSO zg$t3k@{4z5>;6N^b)i>pMSl^!ijEt?#il2EKGVGfG|%1Jb{rorrP8*eP5jFs_k1~2 z4p$&c;YwutA~lopywlJDqr+A7EBb8=SDQWtd<_)cjtkd<_PB5zrMtWy;#)`nA6I&BI!o8E)H1*`;nD-{p+Hpo5S4smutmcpILNd{ZnD+YTP{fd5@!`-Hj z!QKO?njow1IS4RTc=d z9~>b0g9GFwgRS#mpQK;WZ)oR*NBmXPf|Y9`}6-rqOrT6A3- z-ZFg*`E4kL{0?X#zf0*}--9?jAvruDCl_*MK7UB(qTjmkk?B3;kHJdFpHT6TKZV@+ zXHYqOjx2>Qkdq5JP3bS`T6A3>zA}9b`D-YJ{0(R!e@p3Jzk|x*dt@p6fSg>&m0A5G zor``O!cV66kbed%A^$?fL;e+V=f6RG=z=VTKai6PIZf<8=~{H%82&PS4Eb*;h5Qd_ zA=fa2+-nzzZ&)Guh841X(V8lAYrybPLk4tC>S^d$^w|`qHGQ|XHOgT+$b5EbTVs5f zo(jLa!0tQ)ZS?v(Da2UHG=AxmL#58C5+MCin)5`DukLYSqf_-ClP05>aIh-qRWP`uIXc(eV|I5>rwGI*N5Eg z22eR{h%ALR<+yP2)_6IG_ z9Vy-60Em+*l9MU2ed%fwC_a?)vri*N59ZWTc{m=#3yQv5LWk)|HZ$-?~0dXo1r+d+TYuMHFG2x7WqW5uOBxs?JqIA!@L3}+8 zSqh_(QxbY*PM3K>!8hMZ9%FhBeRr@D`W{p~^gSWJfW07oE(*!dMIomo^fbHorF+qR zZ5V6%82Wxt3VnajLO+1gJs$}1cPmK#ZUs3dp;xB)A-tgIn?F%Ey@x&?tb~3j6%YL| z$S>eyk+_r_}fql{2kB&f0xo7zXx$rMsiX{ zPC?+6ss17Ti>@2ON2d3{KL#s-e?r9r{}ginpFtd!ksOwhQxJHX>R-~k=)Ey~W%?NS z*H8-l8_)v(meL)62XS6Ta$ZKZuUKtY9Xxcz04DoLd&jl&J;utLtv~X@;x#mdpG?mP z@Lu1~ppO9W_5DI6ot+`Skl!HA&PdMA$o3Wf%Z0?r|0gdiUPg2H%k*(5{)W;}`~%uh z)GVee=mK$$Mskiuwl7od3Wg8Zt0VLuF*59GgE6}EnQj_hQuN*urZs)^J{^?2PY;^+ z87Mvet`MhbB&TWQM4l`P-ecr5^Ma!9)-a3dqwiUvlSC;+~yrk&8E-Y#K=zS?Dd0!ed?>#Bq`!W!xZ6v2{ zG*h$m{)$;8l1*(RX85)%4N#YEbgMI%vMvpmg7BLY%~r zoWzlnjhtuN%sO9(mlVA>g>_9Iz4w8V_w_*YzCNXU-vHu3j^sd&oNVODdtB!m@q(i7 z=CHBpqwh_i zw}CjKBRQfYr!4Zc&bQ|UMc=KVpXsCT9iZg9KWM&pq;%f{AWrK@PV2}ii@dVV2l0}E zcfP~jVfyHOFqFLS44U^Ll**M?n9AAOI2lJAkA`5r~- zzITH-tRp$BBd09#$~rIel1--UdeiD06JIg8+-Yx&bmq?8c}+3Ky0C}oV~l%3DaO4( zi*avCk8vM}-=skDn-s{&UT^Xq*VKNzpy<0k>~H$$`v55UJ`gnD2T{83gCV{Ii{wkN z$jOdx^j%p~<9SKZdqX(X^wIlaQ1X5_Xx@*Ybniz(d^Z-!cVm%L7I|7z$MAxp@5XSf z>7(!Cpyc~_(0rdj>Ap{d%HbqrDV&U)vdAlI>J(m5^xhOsHGTAc8kD@B4x0BfDBb&+ z5WjzcEQPa?Qxc!d>O_xhEm_`4q&@dLT>T8D#tX`4HtZM))jUiXQ93 zbEc2)hd&QRkK@7%phfs1rF(k`;)l4A{17*?ecrq`z9FKS`YIiYzW7OQ)BBP6bm&dzwDmrZp@0mW%n)ji23(e;TRNUu>ko)`y zDu<7erSJ)|iqC(~)KBSD^w|_XGkx^=IaKla1r_)CCFDN8g394*WGQ@u%r6h()J#ot z=UaLeoi>N>Odp+o4^^E0K*gQ@2)WarAP()wQuqa#Umh8!aq|31pQ6i_@SEx5bp0KQ zF8NbL&?e8Hl=^th-IsIjQ&^oC|V?b3^4Y53&^IMdpXJF26kHqf^mo zU6|kWan>vV#an1T7o_4o7lPd9!caLZf-HqakyU*DdwF!HQ_*LA=wbTkb1|smb8#x} za|y_OE(!4qgh+mY5Sd>d#F<+jJ?T|++7Om8eRR4kRB^f-6?eKk-Da?yeEyPau)}2_&*Ou9~W8d9=`}=&vcX znm+nl2{M0id8|yum&YoQ`&<<&ht-g!usSloJa~@FE{`?nQuNpy)--)w9&16-E70b_`Wof?@J@|%Yy;!TpsJwq3Ek6Y+!m{9vgz@th-IsHY$DxH-g;Z#t=V- zf-Hqik@+F5&o7V7=u~vt8v2?(&YBVwZ=w0zoQnJ00&<^QLj06DlAkh1R`L1o`rH<(_}q?)``jLKpZy^Iv=Yhxp9q;>9>kej9y`*j=(IKrFnx5o6I5|J zkcvAU1i8}=h)=MQ{Omb0zdSNd}LAtFF@umE|1Yve0h{1_c;dQw^xw-_6jn;Jb2j8E{{Fw zQuNpm_A-539(zO4BY&_7T7>&jy0@_qf3S(<4>pnc<-ve#Yl<&kk3m&bYZDZ1qUtYrE)T`z#5 zOMZ_Xw8?W3rMtTr;>*@Zevchl99K=%v^*}OQ^6l!@W0&j(ccx2`HRcrN-DlQu7cd> z)ez@MB;|nL5uJvO80g%#0e6~2@;uK9t>#b z^0F(P@3S&-8KD z+z-WDXg(jH;yxdQ+~-3OM@S?`NMseC|6U%C(y8dPAv|XK=<{)?;`0eA?(<2=eLe+o zghX*r=q{+@Sf?TzxN^Y7njEe zRD5}S2)WOXAkL9U&XLIc@@V|`^7xc4MUO4vGtK>A$Rx_#OV>q=@HpJH}3`HzOIn= znqO%yxZ}(9znR|M{SH>#{Xxau{Rz3dzaUPJNKTK)_Bo60;!LUGD?>$RwV{jYY+}UX?I;#)eOdrFV14?1d30hclQM#YGAx?@&PKwB4Se5r|=cBpksUgg7 zdJk&>uoBjSR6MMOAa}Pg#32#MArV;&E4@kEoyMZG#?Zs`F|5U)6xQOPg|!5w`&km= zV2I>kh%AOxc|*1*%|%a5VHwkVSj&Qyu$H6ZVJ#22yA>dggh-Br$YNOOz1-e37M(SR zTGPj{>Yx->J!oMyP`aN+h_fJ)vmmk<7P&S4rCw;Ex#+1Sw3^<-S_!O#wK5eCYZb`d ztqO4rL~;y77Q<@r4`tV&vFNNdtZDif)>=>sYi-cNT8Gm8tP61fL~;N`7Q44{JlP5>^`(4{IaH-E9nU{6lj5Ll(no^sqLgvFNNe^fi49s|2O6HU}-N zEhyd3mJmliBu74E`&?{IonIlze5`EW_$fN73)`4JI@%UWj|HJ!vgEY6^RqK04YPN{;pc&C$M;?r1E;2@c5#4q1pNZF&dLR&>)G4m5pqa}bo= z91NP9Lnz(NIEZr_l5-of5Km>#JB-$%qn2>E>7%0~pycRC&>S5_>5h(uIIJN#tRV~W zq}}c~+KO&k!||q%Zcc!bn-f8Ea}uSyIT_-7hU9#PEW}gU>`tS#;E3;)pKki-=nN=1 zIukTUXHmMNvmwr8NX}%)LOf}kJCC-ao7!-`>7$zqpycL4(A-=^>25BDIEx`Uiy;f~ zRCc+`Xe~P8C-zMr9bEw>M^}R8=qgHgbTz~Q49NiuS%@d?Z`aXQbi+^Vn?Aa^0ZMLe z1kKG&lOo3(^$^5i3&~*%Sv9W8UiTTDx~rEU z&Q?gyR>-PxRrb7B=}~mn5?(WXboM%woV@{>vo|T-*;^1NDN$JkM zf;dkhIZq+0#+CNJZ)q>OstwT?&>FqlN6GZ6tZeul|ArRdK8`2 zh2Kmco&63aXMcd^>`zK}_7}uC3duPNSv9V-57zM4MnzZkp^NFGtEr&mYHHA2O+)Ff zriD04AvsDRtHxE?3umB5(OE<2YWnDGMkqO(2{dOjQ@XQRAP!PU4pPXfai#rmcG`=s z8bdeJM^|$|$<>^oxtfd8UCj+~mO^rtLdN$lGS7SccN^0Y_Uhab=cCUih2YgG?qu`F zF81|=qMgbPw7?|nq@82IN!Y2Z_=P56C#}?lCt;_u!WNl?owPC*orImrjP5=OJ835N zn1r3m3|edwcG8_+Ja(~fEyUrk@~0h3#2)ruMxjT%Q%g?FLgh9sH8Bh69xXjF3zZwx zb7B_K-C1U07Am)9*@;<5_hq?>S*YBULzAD(HY;)m0fAm2n*hWJ0qA^AVbA=|s*X6FIrj^v~N&>{VY_YSMkRP@vwRyRH8 zVE*c24bWWeXz$dmNyS~Q1-YxWp>kLUSqkeS3$BJlSAA$Ix@rmQnciKk4^~`lK*e2c z2)U~^h##;;@&mTW_$x*+DqB1$rcG!lI%*A@n!a1xj{N_mq3DO-vjuJYEm69U%^`l$ z3dv7eA#*-Fn5}5Y`>5y76}C2g^kIKgnS5*mnvZQM-N$wi|9c8#DfB~*8PjXCw&`b> z_m)$3J^Ym}HTK_TZBtKEQ!~R1+_v1m`D$uwMh+f4bl}hd!&mGzn7<+!Q0~8bM;OhI z8}(Uhg_>>u%fDLld+RrE9^3^l_TR+)E?Co)@jKdod5#Y#hweOLSH580XRW&b<~m+x zQ-fW=>U-?=*;F{U|0aF`bJVQXc>z1^RqhxW_#LM{YpwJ@@T)NzKD1mO-eK1;Zq*Ow zpAP@_-^8zBwwhHtuVK)D@_-e4_gSm;e|`Zt``172dDVZmOH})3-^a6mcI&eLY`NRN zyxua8{mbhuXW75J-kurkpY&6EHQp&hyJOjZ_LhkF6b4P z`lW7_BCpr=OL@J$=Vt%%dOJSaKV7faI{W4IHoNR!UT+^a*gxrYz4`v~ zFTF~Cb>}!rFFTe8?Vt3rBY$~)5AR+xeJWMxb$PwUM|$~HJ-?52O$PJ&*>ZZ>Q9r#- z*Q0rp*Xuq?FFP}*7v}Z4k2A_}Ds^A-`h0)c*Z9nov!nLBUe}S=Yu@Jdx}LmV^Et1# z_fqVi;`UnSdd};$zNFW6tIX@|_j>G~#@lP1^Dw_}X};z4+Lxr4Kl@1)`=@!~wa)9$ z>-D<4Ui**q>Lm)Fam^y;U$wC?3k*O}LAAIR%9pYnS9n*sYLz5MEWbl<#JO=X{wUi~$Hv|iO; z_bad0{mAQeJz8h7qxqWGD=$m0>(Mym_1fRGUS(hVLtd}_D6iN2%j*@F^tv9|(e=u& z)~WRBuj|)5Re#yf>otxVzkGk`WnXzHuh)Fj{gfTuZ|P-6`>@uB`fGfoSAW^p^N8lL z)=OS*zmI1BRH}dXsI95#kxCVd=k&6>SkkM^_t)#BUm}4@UH_6vuTuS&N}y7D`LieA z`S09&#sioL_TQwQeAmuB`PTMXYxV#6ldnI4>v~jbJ*loz^HAd~z2;qBuX&NzYu)Ab znzzzxTy>vR%CGjJyk2&smp#oN>1AK*EU#Bw>LX+AR9q0ARBhu@7^ZjL4dX@64@seJ4w7#X6ogV3h+P`E+?RmY%L3-I&UHi4{ zXrIpOwXaAoJF4q-vZJ{2dfhMSWk>f#`?&0Aob&p8f7#JE==nx=)SlPtI`VqW!@OSC zlhe@&+W$4Kvaj*a??ale(#x*$j_$MU=sNRyy)LiU zz9GH(X&=+PmVK3Zy~Z)GSDbmh{Av7TSN`*QU8nA|`YT@P^?Hr7?!Wr0%Y+U61VOdgWK^PI~p%^=m$=zwGDr z8b^&^zQ6Rcul$kMYrg4z%8u^0^s=LURqH_gH9pd-zwGOILGxJ8nJT64o(%R#rPj}4 zsjf0rYZgzSQu-wlsMPf=ne-~vf2joa{5WCX=eM1}1hN1A%kyL1|ApsAjko5j;?Vle zkE_N@pm-f={3%pH@XhZU+r7!uj{h$8@+G;UnbCC|NWQotN*_+e!5;= zUw*taP8v7$SG-!6dcDR&{dy8(_MhyipXRshXk4`~sh{=>mCAd%KHY!KXT47MRo7tS ze{9XNkH$B+yZpEDZ}?vve~p7mjhFTb%^%H2mD;~mYM)f8`!Kmu>qGmG@|*IW?yvf3 zpH->-R{N~>ckQ3DtM#K&`=#R5eNj9rPx^eR`NA!Y|CDDnj(LBISM7>h^Kf#d zu3O`y>(soOLw@$-mZJ zzEpqt(d(pFDZd&oUBBkF=C9U6zSRBDxaD7`c3rRLspg&LRel~#Zk@=EO3fqLk$z&O z{Oh`O{nG2YRH~oGS$@bt-kgR9C6_t9g_!HGec7`BLjo^HtX^ zyZKW6^QFc^b~Jx9-(**%^qSAgFS>qRw@R&B%}>?!dX>5k&0F=;eah?Au63tU>p|nL z*X8GPe*UYj`>c7Cf1TQOy_%Q#`KI}#`SJhPfzJTVf0df2nm_qc^C&<6Ro8sh{M9^_ z-F&J3`BL{&cK%;m2U>rc=PEUhT8A2M&3l#FKUFH9sGQvVR=dVk>sRwY>U_9(?(><(K5H#HxzA_h@4uE>9}|1s>vbyg zugll-{j|?YuX19qQ+vKtf0g<6DXmZJ_0sElRnOaYs1V_fxz2 z=i8;v_mf`zbsyDFrS$p!YL{O9q*p1u`sGXY({<$ARaZZi>Yp#wUuC|(^!ZYD@_M~K zug}*f)-SK0TwQi2c0E(tu73Ga{#B}7{!~hzFZH^7Kk4)R)z6+!wz#t2;=MVz+kcaK zKAAK3eA3)!t=aO=Cli}jdLKmZ>r_{%*U6qI@yee{-9NoQ zB)>X0*Pljpzpp&adzG4>nm_qc^C&;>Ro6V$yw&`a z-F&J3`BL{&cK%GP%LsrDnyCyig;pW^*L?A;5z?qiuh{+)8R zcY8b3CWkE%3Y+cBex6OgRE#p3B1NQ3B%M?;GNPn|V>KfxQp%xp5Sg;RUojOKC6%O< z>8Kn!4TVPk@6+1v*X!SBzwUKE>wqS!*K758UB~;nulu^L@BMtAwHI>xHcx6OZut>s z);C%`n}_lsUgs^J;$eq|?D%6R56*#Hy!LB7=={uQ>zen8{IRnhdwfV=z6PHsR(ewR z7nTMAc0Xf%p2&aywCxoB{-1gq7WGf+m-r91UiwF8JW11oB&UNjfduEc+^_0m5&<4KwxB!~DV^n4gr zKmDX#()97oUwlZ8t|5I`(=W+O_V_UEOZ;K=O7{4WzY;xo{@j1YK}-GR4|8B|@Y>R7#IAE2FwyrmsEzv@!Gsi&-;T3_%3)e%4VCA7Y{ z(c*#PmS_H<^HsO@tNu$!A37g2RIlnMQQg>oqJC4K;^jAyexf|^qh8b(zYt#?i(9-< zf2u+Q%CA#y6#6aq%PG>qWZ~t zN2_1;sxJ9Wq@U>g`1yOQd-a(0Esy$7zSTK2C!yyBtkpBQyy{o;Pu}$hJ^cjrk#pAH z<`BR3t8eYo{IL&cUG~<&hw9V(QAhHY>)0Q;eVQ9J6t8@UFY6kuj?F*&7q4@cKk=|b zLw5YJlLvVx7q9(V4?3@$$L4z?f9$Ns9v{+|ufgYw^EcY$hqrbC4t~m?FJ{kpVtik| zdH1I+*Um4@{o>wYRA=Kw{ZO*2$=OY{9>0m!fhk9mL;MmBtC#j^mo$BR{fiID(KVzG zYx*U5$sQl3eThG;UdbLG@>inGoAILlF4@)O?50|e-$d)cl%vTZehG)wOZ&7-nm)ey zjStDuHKY$~`XzbE9v`NCi9f7f$sQl_SE2{clLeo7>u-P4J?IBNV?9q+&gV(@2jgbN z^F*Jym+3dpV>G=IpFI5x;$3UToNM>*6b3(I#k<7wuloZf<9+^#S015!4&u4w%)`Gr zzl&w?GgdrHFUa}VP~7q(PWS0V_h$1=9>ne3 zq6(~zB+HQH*vT}C-TeQy8Pfn`ts*I)wz1sABoOK z9@CCo-0D^xs<6^ES669AE^c+2^{2k9KiwCj2R_{wqj^xj`T;&veW8EVJv4X3qp$S= zG+&|T4Xo8Wx%nd>>cf1}KlJn))Mw_E{x`Sy)t^v*+pl?LKhXO8SPwtZoHBRiFW0e8 za{JBak9kudf3L;A3$Uy_&X@x_ZyKP7(Zc`lUnYy6a#=+bDTnwnUBNjvrBz6fAk=^d5#as(KVzGYx*U5$sS+4==4+K zr=I6dNx#NVd5Io8k8WIe`B&z50Stb|dLAwD{;d0hNK^Ix%zX$>^*ztr@f>!)gYI4K z7oOjq@9sV3p69xF`KQMpK2-0{W1{ys&y%d15-nc)7pHq$V%D*Hll-`!LHl7x&winN z(i2zhp5`8@FB195b7O}O>C1=vo4ooQq7FT$66HJf@zs~l1?na1!*i>I{6KZc4}J-A zeR0SmKhXL49AQ7|xP-NNy*|=+=B{}L&F#`W zO}=@c-_(t{A})G4XLD}qPjiG{`!FZO%RfE-@S*cFC(JeZNdNXhZa?OPzNn#i?O&Yc zY@#_OPUogC#R2KDqi4TRKIw_e{;UI?gE?v5Ch|kyI_&TvefjV_8{DUtKYXdr%or$i zKV#jech2wgyFd8Wi|_N}*Tbr$b5$=7HtM6=I>YLf{FLlV{PZ)dUd@i5Ql826Va;F4 z(fpumSklKA4?6vo_^Fq4$qpZ~E79_)&ujB&s^sQQ&EK$kB|jzm5t*r<7-M z^R?zLpTS?hmXC`~9(f%R{2)v3q3=JwH7seg5(}s@uw6 z{#QbFp1(eKu@|rNNImh{hxqwX57uYTu7viLC@%Z74!_p_zZ$oEiCXm5v@>%$c`RNy%J4dy_EElKRD0TZ@cb$ukI2z_!;Xw^ZUy!x_^&X`~Ffs^IYVw z#3wh8_!-1I(SJX&MfdML##?{lb3TcKc-mRV?KQs(c{B{4Hqn1DWSC8Jyd0#jE z{&uudK7tCFC3C(Tw zS3~*qy{0*3u850X)~7l)Kk_-muYGu4iI;zR{NY1$(S2Dx$Vd9O4|4nQoHN&JC|>&) zr#YMG9xqPkCO_hU^w`m}UuZ7V6PNv22RaAOA469eO`Aa#PA9M{%`uO5O zr@sEORc;BDO6OX4rL_3tnUl*`{ymX-*2k*pZMg_KE#PmBxi?);?Me2xAvJx&JGO+ z`S`|uYj6MQE}+5BSov7u`={>v_)`6<3uwRcV_#@`$tTCBhY!h6aXz z9zG;b+Pdr@e(Iy?rC)MET22q^-*i;-@~EUiu}+r-u*8 zlOFWPdY@nQtm`|$;AgD<*dl%(ev9t=_D#q6`|$Ruk279;@#efk(=#{t;Xm!|+x%gl z_(-1r3x@dnx0%PxH#*UI$Uho7M|0e{nB(X~a&~Aqnfbq9jKAL~4s|Cl`1Yk<6Y1GE zKk}CL{L3Hv#7A`f4)OOZGmn{XbfWW+e>8NC>d?8ULv$iJJ2aeB{f_bXGsU6qo8_j!N%^W%XBA8_bqFFoM!12$XGeV#6TepF9T z{rO(h_oco+hrW-7zDI}Zwub85_r$)3_I)BRou^nI=UdVgp?(E8%@eLH@l zzB7mNd-q(=e&yM|v!6?}xW$+A1#P}~KWhKtbl$#C7Y92uWXB&n`}e&#xj609deHaf zz8|-)`JKogJL|E>hxFBvb5PIfRv#qFzr3X#xwzG-dQ(qXKehhg2a1~?{1RGUT;j(U z7o;cO)`8Ah-THeX_MiQbG&|_L&`{l~r$lumA5g!kQ}ObbNIy{?_)$0Nj9-Yap2aIp zs87`+njN&hKBMPc@F6+WcTgY5w|r$CXWgTnulh+la&fE2tTT0_E~e{$w6fGaRHy1F zQ9U_FsE*aG`s6Q>exh^a=kKll?MHn>dDMsUtlpt{2|Yhxt**(%p>LhPyz3Ks`U>hN z=d91oBYyQE)W`N~9@!7HK0nsOPgJMolDd+|T+e>V?b|%5p}57D^^I1~=Ar$I(|OCI zIM|^fJO0?&zx|>Sotyb=UGqMXKX%q*j}PgqqrvClXWp~&4`vJm-OpI>+wMgHMw zp?NvD2^uGytreE5)mG(AWT>7iljqn$fDh@bZ4kQ^r8I^;0< zN%I5Q!PKwO>>z!JUs{hmaajFaC;gB^^7Nl{>ZP1N=v?VReEv#EAMy+F)1Evr_0aUt z5Fg^h()#3Zs`SJG`A;N=}vWodva)9I4nQo zV2=;+Ygp13Ps;IO`Y-Y6kwbh~;)^5YgZt@v`(F6zdEJG7@H5u^G=G12%OQS$OF;VK<~Z0XYwA3Kkpl%_ipy-y_9`G z`QgWU_=!FT`h4a+t^DPB_DOEP`F)npLnRcyJc-wP$3*Y-ycd)YaXWW;6&E`+WXB&n z`GC%ap1AGby3l!gpJ;ub=Mwp2XFc}#kiNXBEA_38^+lrdkiWDe7dQXvP@QF6)%t}W z^~4^(gw_?0xbejU>B+NopmSEoS-06ANwb5_2@U-{6LqYf64jBsB;uXVKi0!fH2<8JIV*p;o_&(rZ$5X-nG%XW^O*A=t**>T z`4G2rmsfGILqm4_v6BzzThxFxb@cCr7-#vAcMV(;q zGuG#m{Qh>!?%$J4_Wikj$hxZ0HM^Re|6%p$j~CN_(&>*JraWnLVOagNPdhZfC4GHe zk|)1JTMw4>YW$KtzIf5;uf!i#uVjx8`76=-yEOMo{F+@&&hM~#^v8?oKk4*G4pW}A zxjU?W+NT|w-;%!PK}nwc5^X(L(yQ@H_W0sOr@s<^SiO=xKIE@N51voQuXV`p=5>mL zpRt}#OT0fD;@{8dNB2PJ-r%|Hx$j;C-J76$Ak^nIbZ-)m`+@tL`9;q?3c9Dchj`w* z518lB{l`At2kZk{S6tS?Pjp{#-*Io2zg*8g$?aFa)ll5>B2IOcsLtGjNeYRL{`!1J>%A+*}clIxu(i2|axU^^-ZI z&&?zK2lcOgnnU&htt&3;;3t}Q=8<_Sf4QE0lH0F2QbTdei#T(>qs=ArP#(nVyya0m z?9h-Mf9&Kz{>jB_zt)4!&3v}5d7sE1JL|E>hxFxZ@cH6}YoEW=ME?E4mQ(Qelhwa- z8y0JJHMw=BT94ln*4873B|rH3d02gRFzu2~J^hXkOLpXm^kK?}rAzksF#VPI!|Ijn z@gaXDT7R2Q!(z>@Cb!O1>+xH{+Ir-$BE!{OPB2N zVfriaht(_D<3s*R^x*k(`FnqT#6x)bL_~L@}E?a1X(oo4;1FZD9r7o(Ze4{*9KM)UGe_k}uE z_t4xCkG|Fi(0qlSH?UUko#nXTRk3ozEfXl_+lc5obOR(B_tTDG%ax?(!)fc4)|sKX&o}od-Q}+qZS0 zb2P{2E#9~|JRcJIWp7=6@F9Kq8+^W5Zqar-?B6j4KjZrTeu)2mhPuyltkE^Qnwxb};SG{L+KwIU2G<*N{G}>6hdsdwlVt z(@%+?dY(Ha{Te^zC3^5YdeZ05Ic0tqz~E=B=TZLmQ??xAzyG7Jp?isYmFK(r1oYg5 z?n6+2*U-Jl^WHtc{mlHL=bi*T*WJ_HJIybC-AADNj{SP>+YhupKi0!f^xRNi?#c3) z>)9{4ee1Itid%lfnRSX*ukJhYAYSJ#pWAJUgMajI{1tS=Isi~OY>xwzG<`cq$7PqlvG2dXE2@JncYafu&aT#%l8TL(IC zb?ozs{bzq9%?>&*G*rLNDN#MiN1{Gdx8mkEk$$3l@S}dz8@~`=eXD2jLVc?)(d^*7 z#SX=x|L8j>d`J%UBh(l2FTYvW*#~Int)9}3T-@q2>rP#%lj(jKJ#c*h)vI$#R9D#t zXmzcQ)hoY=^b?&YKYy?NppVr%lu!LB@9H0#r_l2S*6N&Ge)X|>kbiwcPoF{k<-GO1 z{qd_Wp}w|XbIN|8_4%>zSt8a5s9>nY1Z`rF(Z7Hf7jxpk&mkKe>xC+U)YO^==D$FTbBVA>^}dY%XPuw+M`NFSzr zSh{47KiPQmxs-8Pr^HWri5@(k?)=l2@0!rRzwG|L``VTNo~l09-_U)t-0~yNtUt8*pbz9hyv|)d#lsE_+409t9-#A}CvN+;E_9CWbMqD_ zKpgrokze-Kr05}k`YrX9Js)vY>IXIWRZzTpR|D}L}xXnk>sA75OM zo_t#eI(PM)^_zW?G&|_L(9q`t_3XT$dXkSs{iuG$&0iw@MET%H{irv7A-?)n&l$J) z^|AUyvxnKfvj} z7|qK=-52Uu-9vLnJo;K6K=T!P-oRSDlbb*KSzVY<`iGu=gZj+8(*NcbzxosEZ~HZ` z><3z(AM4>Knm6W^`74jPp8b;BcRq)lSE9J(N1XXQK$~0Ur96n&xyz?`*r6di{@BR_ zbRP7?ZQs^~&e0s7w|L{?@O((*m%VlQ!H4waZ&JU1*8TTEYM)=!OP*tm)-NT!nw;HK z>+zeI>m*&$uj#QfMuyn~DU!9@TZ;79Jo(m=Y8b9SF z+FUTFhDGzIq+gS>n`%9N6LX!UOZqiEcIM--`s`rZq4}i;$icSA^Ak(;0N-T zNDj%Zn|yUZ4)NKi9hyEpIIKMN$4l4NAFsd3>Q6KtcJd|;=Rgke>6MT^>4^jKpGXeLCmIJokiSH7NN(Na5AJ&>A9V5Dv%3r7;AgDg@5#Sk zyH)r1)obq`N_FP_hxbSB$==V1Gtv7K?*+ZT@%hvHFYk-IxAWf1`#Adi(Z^4;51&ii zpT+NfE-rlW<$bkyhYroC!N z$$y?dI`z>dbiPoYoR{~n;Il+@>cD&V>GK}V_#@@K)t5eo>PX#X|LfaCb)|3gfxgqv*|+LY{nO`l$xC)6zI>0@Z|Wy)J^TkNKm5a77hOVgA?5tR zl$#s1zN*Rfb4jlzFWHs&`gOd1Q$K0z;XhdU;UDI@=n|S6Dd!KSd@x^*{f7_DxwR{Z z!OvLpWr@!p-QTyJ=;sgf*u3?*!@P&?h0whRs^c1(%jUKDo6jkF=05a$0Oqv$?E7YZ z&2#AccKh{wv>#}W@MAsvMDxwLdQQt@u4ljG_C5W32cr|v?+eUZJP^$jeU<1Ovkv&d zhxFB#^Hb;Q+1ySvr`1#1k&9d1szY^_bye#dexSPI2fu{Y7nk_)#Rcifw{@WYQ_oqy z*(XV}gU$;Lr+-gvw4%)Cb)zrL9rMb0;X`uh`3d!hbC~Xn(M0P9INcYcdGVZ+56>}k z)$`b#fcWZp-r{;zZ=Q=#y_(x-_VA(Vi^bv2$mfE2EFSTDK0tK@J#S#`IY2JY@?l;& z2lJL*J{NM1>wo9Nujd2w+^}EgVn5LO{8$e^(fONK>PsGTJ^LlM?|cq9uS9Xnk2v#Q zj#lU9r96n&xvO*WutP(3{IQb<=sf6&+rF&}oufHEZ}G;(;rWorFMI3qgAeJ;-{AAh zME`!^R^8u6uYG<|FL{nNTECR^YI1f{t;cU-u9I|0zoy4dT@9a&Ashvt_aBuB#%pFEL1O!=^M$sS*wq0?`PpL(7|^!#)$^!zq|+<)8`+~3@L+{ftiM;|}YoKlzaCw}K6E`0Ijd6sDR zwM6U6n|<+5jxS#O6`#2Hf%230DR$)i(Ia=i@jT1(bnY+r9>ofDcqbbjgx(ueB6=dS7V9?ke8 z<-FCGK8ET@-DUsl+eCGxZ}fq_)6dzr>QMdD=Z`*qqJ5}yeI|bWA})OKnG-cs7m3!D zH~q{%Ilg%9SA62)2g;B6q)*wA^GA=|Jebt?_ubzUp8o#c$qk44gLcx%SJ(Ix#asss z`Ar%>(OgJAdzf-_qt;h7xqdF`)#N3+5?{ZL*Kg`4Z9V)4D?j|hTo+wJb0g*a!IV$x z`}^+i1J>SusW0^i&13V{=MM88x)(zC9;l9MXfB)A=5Icy=$ZS_dth_geD=PPU-KM# z-)g^}kM;x25q_+PpXhnwTs^1dG1s$Sa{Hcs?>t(e-WShXT(IVezDjhCSqJ>!L;C8= z`KfdDtUnUN)E-`y^?0 z(0QTZ^!N9p6=goJ8+~E!m{-mVACg1QPpChf!*pMaCR#th>Ao1vi|3qtc#fH?p2y|{ z#8=Pr7T2?S^IU}L)!at2hYwX>EDm@2`}@U-a4z}-n)lAja|1uo`I}ejOC5OLSa&9$ay95qh7_C_j0s4H!nRu#j6h0xp>&2Av^xq$ph3c^u%r7)`dC8=Plm2I6NN` z`DJfi&jWl&U;ZZb{rwPsKUTfuIo4?Rs*+w!&Tgvp_)W}pk}m1j^w_DZVfER;v_tbt z50ax{iBFzLAEta*x@3>9&d}+%#7{k+8%p{$e#%R9@pBJoVBaqu(Ny4&Zv-QOA5dYtPDqg(1P|FeIH5Ah*B#E1A0AL2uNh(E~7 z*(cxr$Fn=e;AgD7x1RmV zvwgc~)sP?g5og|0(C!yL@5+OCox6OBhaDQSL^kD$Va07Q?KIYH<5m#eDI@w)EmDLUp@QYNBrW3`c{3S*+X%t zTYAnZ`Q-Wz>IZpem-U?Wk9N-LDDB9_t1h$N)RX#{?t{?^Q2$V!s-Hx4l=Y8R&+1p5 z@|#FM(RuRo_tppcPn|<~)Q9q|?xFb!Jx^e*zRBfP|EdFd*Dv(+7t~kIS-+c0{OU)j zpY2yZ><3z(AM4>Ks#kMHUCCpvXTRk3ZLZW%-0~yNtaG%wHXr3dyv|)d#lsE_+409t z9-#A}CvN+;E_9COw)M^bMEcfYhYzhQUxUxX2fpWXFPhge20!C@|FF$C{{EwNheiES z(yz(cO|>4siMdYFCHeVFoL>5@IZ zc+u&%#2;2K?a`2*5=oIbsb8$b2X zkX>Th*Ys14PP7hw()h3>$A_su(fHZ%TSDhbAL6qU7daZH9zJB3dT2-=;wPpYoyacv zXmO!o+9gd7rkvm8(@%Nok<(8(e(K@VcaHQRe(ICs)5C}O^b+ZbBjsp%kbWY4nELpM z{3M@!@{=y9`A#^NARA3 zU++Dj_bT@3J&^rC>+@qh{6z0lyhriANB(j>`z5z;pCf80Zut?Xdv2n8ulFnRAYSJ! zpWx^yJw((D|y{@qXXN4mu|^RJZCVQT@nAqP|n7;^sGz zexiKvqi)n0zYt$Ni(9-WDtRc-3Rp znL08zr|W;T^VB_5pXw)39cA64)v>x&pZq4$PjsIA{Jqt`xtDb=kNQx)^$BFJ4`8jX z$>meOI)C}rC-n3c)KAV=f15-6>O-i1?b95xA837ktcRbdPR%3rB!9V{{gT_ac~V1h z%a1s-zR~L0Jd_9VI&b+D4?8qu#~(X+a1P|+wO{K&=Vv}!*St^UkDc|{<3sxLHTXQS z(vyDkq#1(%yPvT>Pvn0;Wt;BzUMKtaSJc^fQU9b}iT_~hrGIqBlQca@4)IH94h^fH ze$p;!`uO@CACjYMNFUbpOY)LEK1}-(e^|YeJwD{GM4L-fC-woY%icQp(0xaLxL>&E;ts(khioW=T}{-H}#bDQ|k+U zpgQ6Qzl7EoH(ESU-15vnbiV4=e${^o=|ks(hU!)QB&r+xPtQ8luW(TdWzvwv^d`J%U8&v=D&VSagI!|=Y>L=~U`BjHmXX;3uOxOKr zhSa6HNmM^s?`ZX_UezVPiS!elA3uL@b*~$+tR(<|OpIfVFximskC2{>i)k zpr@apK61|b+Z^K8e)X+=nm_gdt;^mz_)vYCKk7){avl34w@-7UhT@eE@nv13)v@_! z|KfGd@+Tg4XvmH~cJd(ap|z0^Vob(8*yBU`@-_H;asEb|{P5N;z`@U0 zpD*&?uW!@+yXIm4{knP^7WG3(zb0ol)q4CUS_h^aO%Cx(IILdUr(M$Y@%1l0BuCef zKCJ1NZ|P4}Q5{EYQHS>pGvy1!3R z`~55Z=6Q_Pk0n02`yIPMylc&vbM5|}!r*7Dc$awo4e|HmI+uU-KkLdPl+Qstmz;U{ zSLb(DgP*bDSt5U9{QV&NhUUHdl6#o@8g&1I?z7N-YUtkKzU;p09^~BUxer12P4_GJ z8TTE2-OHf+o&CCp*$=cnKi0!fbYAXJ@|Ww_C%OIly&&gbLvhQGINhfc-J8ufc@VdA zmrrrALqm4_vHPpy?g-~WPu%uzUFaO$SLZEuC=U1NM1I*@mmhpcU;dn@I#l=Qc`r-$_gw_|A`0>RB>B+ZspmSH(S;z94NFO>UH1ziu)N|Gs zT0O}}qP|qW;^sGzexiKvqkhyIzYt%2tLKbc{Q6jZqS?cB7dsG-ex&cb@F6+Wmr#E= z59gNko&A7T_v$L`$i=Nrv;NeV^{4w{^uVY4Vl)rxS3kgqsxS1fx`*bDc=WYCfaWXo zyn(fPCpUlOLw%S}`iGu=gZj+8(*NcbzxosEZ~HZ`><3z(AM4>Knp5Vk{N+0KNp8RS z{4sAzC~o-?XFd_{A*4~hJ; zw=O^UkiPs4KCc|M?_Ph}zhex3#`?UHpP#nv{x071`@_+L(%;TMX?#cy@k^-hhSldM z_0jy%gXH=bACjYMNFUbpOY)LEzIf5;r^HV^&xMkHji2%oU7Bw-zWGzqtI63-wI08T zxlYn0{hA&-^Kn>xcBzl%j~*m9&+#ESx`y;&O}`{B+2e~BoqkIE)brda>DTxvFVTbN z(Txi)|H}L>fWgmL&!c>Qwr%(KkZSKA^|yK9`Rln{yYK1e8hXCEpSb_HN0>YG-0z@! zm-~h1x92;*_Tjni9>+gD{_vrCcODbH$9bM)-IQqY+P^s6+Y+;motyl~E3_YW^z0YP zCp~eg2kSuR;2xX0A& z66X5ikVk%?^V3K6qmD~RAId)(%D1{xABpP1eiQYNIutj*d<>O@reuS zCv}Bp5A_MT{NqD%s9&HumS3Oirt5dKGM%G(o37u{y!@@#uep+QR^RI*eP`~PXVBcP z%~f*qK)ItO#oyiMeXzIE8)L;CXJc{aFDFMs$_pP4aG z=zhk!Pv^gX+_w9BZQESMpP`FY(jQuzEE+eoA>J*M~KKDM#~z zu3XrPI>`VOgGpt_Cj-OJV$<5cA zzm%i-LD#UPk1rl{`YZ8MFX@sUK4e#-<#RCqk6N_xjmLBk#KF(F=70D1v?e?M^_hNx z`0iEukQ^V9C!P99*Ys0fqig=hYoGp-uKAm+e4^{I%X7(ioHKohPahx6Z}Lt2=csNgfB9bt z*?Io@+{IqJ&Lj22XCLC{M?F}dJ-ZUxSE9J=(>nZG|Nm;-@+E$GO|;Ka{*o_`&RhQE z)A^K;ojl7s`$7L~bKVbLcWYNDgP(ErPxtpBYW*W0P@bUtpcC2AgQ-`d>C0(cr0lk%je>vuHM>iF-qe$`XXS@ohH%>{E;T|#qP{nb!D zeXnUwnJeO=m-VTR&5wKz@oOKRSK{TL9)I}ITy$Sn5Au=z?StHYJm<{y8j9Ec#c9qa zy2p#txyg?>AU$^U>=&BL^u%R<)`8B!bI9{9kstcjVTTXt%ZKOL;66R!?|-|0k38A; z|ISstJlLqOYU>QESMpP`FY(jQuzEE+eoA>J*M~KKDM#~zu3XrPI>`VOgGpt_Cj-OJV$<5cAzm%i-LD#UPk1rl{`YZ8M zFX@sUK4e#-<#RCqC;I*GcHO`4n(X}7XZlIMCCaC{P(%B-PtQ-!!F>KF%})M2H`$BV zy)X5|XCLC{$G)x0o?Qv;D^XnbX&rv8|9>@Z`4YdpCfa8yf613e=PiHo>3mAaPM+nR z{h+@l`u={qA^!W_@&V-u$`3k`9X*(OC7Qmxmh_S@Z_qhF`9vqOqX$#3MAKIF1+Vk(+*eA*}{)6RLoVkuT@pB)U4|?)2 zIIpcA{i<8`?*bqEjP-p%e*e5(_xnw??=QqBkMbRs!BG!%c+ge#Xj2e*d&x_kDb+e$@rEU-_{wG`-}LDf0w z@|O1e%OCs1M|AxT@%Jk;kC|_DqVte{G<1&Y(7C8XbRs!BG@MlZj`8<1#i8!x1>e51 zZqfAYn;&^gd;aB*ec~ghe&@_sH=d`P&+lF^tu^)oHS?JHMkhKC`A0+Ns1BWrIz%Uu zvqQt->vztKIZNcDdm%9Muk&GF;!t<;f^T2yHIbfu^TU7I^Dlqw6Cc_2+kN1luHSpn{7V7`#@c&U-bmlpYKI|U+VjF==*5sdvvI7YpBkBPwabW-}kC>dK3LV z-S34!-`Co&_lNcatuH>`x8o=3J98+%chB|gSDx)V`?*AmTYNcR(B_NxqxLUO=k5D+ zaj-)}cKorkf8UFfi_<=>2Yp}e`*G`<---OOvmSeVNM9W}2lcFO^+BTi%Ujx!i(8$l zH}#bDQ|k|Ypt$+LFQN6tC4PKyL3;9S9q63Zt-mK?|Je^ovxCkH4b`oBN>oSk0ri_Y z6)%5@^b_TQA9bV7_=WiDS-j$e`cyrl*+J{;GkVSiACg0T2lat`%U9NM);-$!s-LtY z7q@!MI#WmLV!HlED@)x&b*hdM)su6C>R8>XPyQ0=Cpt%d{@&`}e$+RVM|~*I>K&Sw z(DMV<>Y7{}`quf&yFQ_(ub_T%&idRu;#VI+eQdwxk^MmH^J6{yM0IK|sVjNR_3W42 zzRi;wid%eH-)Qx09@@V+owq!SgB=>OjIj z8hjpp<~=L_V8%eu{gmIg&zZ5)5}${=FQgX!_2=Qr>-HtYS^wgyVa={4=YOj8_)W}p zk}m1j^w{aAVfER;v`aem^gI4|k$*T|d-^4Nd`KUb_~fvpSL3I=MC<3;d`o%Ft|sSi zs`dCy%yp73>DTnwnYY90vx8}ubn2P=_~S+X;dt%om+bK&eOTg?!;)T&pYjqtc>b*U z<{2l?7%bTRjPLo=ec?OF=Z`)&KOuhJ2g&hEsNZXt_Vn>fbn?Z8pU5AikB0a#`TQmy zJuIewcIh9#g!Ezh#fQ$79>mXe$RT;sC4TCO1F}P>K6wqVnF!gIRJ4hemm)0Xs99BQqNk8O} zJpCt~dMW1*I#+rSpT82)hx|hPv?otYJv2Qu#E1B>v_3hUDm`&P{u9X|`9$O32lAIl z4#};Xe04w$@l&6_M0WT!yPAH@o*Y^i4$IFt*yBU|8kY3MlX85R{!4s%%C*5_j=w7%7?g}yS$2v9U8LZkDYu#=R!~1_HSM2JiSk}zRz=s{IRnh zdwfV=-qe-)R>%4x(Rs*U+L4Q!e|4zNvaV|V!jF1lk6%LTibve|;(_$!**efUtK+QO z?2n|`LFa^q{+@|CR!@oQNL~{4qq-G8zlrn{<%J*hqu%(1`09Gz;zWpF+))3jPc(Zd z4*f^ZdErBHs1KpOa1QDy>pJ@Yt=`pD+L4Q!|ExdtrCz4{VKfud{VK&Rh;?T$HADXMs^99!GoZP&T2X&G2NPj_nWiIJ=^NBzG2=%jlnoITp<%b{Z z;U}7Z&dZ#Yzg*8g$?Z3vJLXIY#h-c1`Hxmt=A?Xx+quiDxY(f~JO0?o2Xrp<#BKl9 zh0fFbw!ZpL8*yBU`@;3NykYACE9whq*vpY?D55mPJbo-uzDqX ze8^vk*59SMSK`;~YI1&u)uTUNO#exzKXRDzq|M!7_0vA>(EOJ4Jr7FqjB_zt)4!&Hc@~`ZbY1 zcGhE$59!O7dQi{m*5{%`=OJ%tM=oylX&rTybyVvQexN$y2fu{k5qHKTE_(9JKXkt8 z*5?-c&VERm9du4;sBYC!qWY1CM17}D#m#Rb{Y3fTN8PA1ej&bk7PokzK2?uscF_9z zjGptshvZP-L46?a>LBYl>mKc#)lu4!i(5TfN1drB^)X%lqbD|9|D$<$sOn#zsBdVV zh(q71cc`AB=Lf9SHMzMW9(7>u=o5PS3hF0wNS~WW`VZ<~`!t8_16o&H*1=CS@603f zRQ_^3`y{ttbEJmimKSm6d`Fv0=Ak@@*LlmMc-WyKJO0?ogZz_=*M6-Botyb=UGqMX zKX%q*j}Pg~*WmNT3)en>sfqpjh3*ehJVM@o=~MMJQLOnPhqZO|^RW8qFYS`1kFVeH zAvwB+^kGfEBrnUj3*5kK?we`qh$q&Bg!?617 zVA>^}dgd=aEZLDK(uXM@mM+=j!}M3;535(Q$A|ot=)v>n^7sDwhzb4sh0VLauQSQ# zkN$M;gYGHrdG0Bmo6tQ8y7xhSUqkl;_a*l__XKm7p8EoHFLVF!ymueq*S!V0|Jbkl zjQv3C^J6{yM9(GX?%pAfxt{%!+qd@%&Z&grmLGAdzeICGKg)x7ox6OBhaDQSpS}at?t!T+L6nn zI?ei1U+QJLFGe$`AK-LfjOOK`?hAFS?xDFO9(}D3p!o_tZ(yz7$;}`AtS-za{X3?&JU;PR7xBZ$|_5-cYkM-~q%^UN|{FTRC&wk16JD)?&D^c9?BhGvtpv^7w zQXa(X+~rd|?9h-Mf9&J|IuCl{wr}e~=V*@4TfA{`cs?ZZ%ig;D;6wWIH~4(B+@kGv z*uP^8e#Z6v{pQ`@%dC8VukQ04Yjn-7Cg*>u_4rN9b&@XW*Ywz_t6}xo!L&p3OAqRE zG-QXaA$?fWFUd>x_~J#UpAtXyJQqs(HGaxVv^io<4U09qn%p{5t;cU-u9I|0zoy5| zd>mGv9ZWkkzx1Gaj)v^eHKY$~`XzbE9$&oZ^i$%ep65|a8fcu&GMbAA6dak>t zxp$gh{JM`o_Z|E7+_xWSeSWNmpXj-vzTA`LG1s$Sa{Jb2H59k}h%@UHtzO-CezEH(YeT9+L4P} zy{bR;mGxBX7k;36;s?Kk))$xf@x=w{$+vZ&^H#?`uh@U~N7C$|^Fl-Q>zoqRlYAuV zLv<@|eiP{@$_GE{N4@b2@zu9_7BAGd>JrTk&RgtI9Qu#GbHaz@P(MO_A^-B5b)9{H zcHZhK?a0NgKC|xBl{%U3htUJq2T;8_r$lv?eSlWi>R7$mocs|WelH}v!w)L+h9-`gL*`V#7E`!%QR2U?#W>)|J=TXRZ% z$z!f(zvT99zSL0M@*~cyceMI8C*?uB&Rssm!wwDE@yAXcAh~$$*Lu+TncJQ(*7rO} z=G2XR7u1 zP0V$YF6r0w*r~T+_1VF+OFH%RKRztkktfoJDIbGR-YYAyQEXk^8g=~?8p=8!;}w8m+bK;8*e_BGA`?s z_$e>ZgXhzofBN!W6Z-d;n|FWTz4HByKGxsReZ{@PeZ{>7dhSEdS*Xuz=(+5k>7M7l zV1ChaZ-DNf?s@KU?rr?Kzd-jO`*mNjA837ktcRcIdE{K(H{>zbvtM%i_8!7Hl~COB zBhIWpwE3V9I#g#_SGB(32dXQ6@JncYafu&aT#%l8TL(IK^_=yaeUdag z=)BO-=L7ZZyr6oLk3{{be#OmSBK<`9;79$aH+~_$`c}^wxA^t3`b4vb>qcMbNBYhS zACg0T3H66_5NFnR_5)hotE;plmq&G)^{2kn%XD9iW==oA>Ao1v%R}84>R8=Fb4NV- zS|3336?)#lTD_B-Kl)i+m{0nLo_>S+%)HY7<`%#D6Y6jKHLvUkTAv^5;U}6m=9T#? zkGY=xlG}Gahn!cUxaCKj`8+_ITjr%ah}XHxr+C<*Av^xq$pdsA^u%r7)`iZ|9G|y% za&Ashvt_aBuB#%pFEL1O!=^M$sS*wq0?`PpL(7PCH)#dP z9z2f@KYs2x6Z`$M?!O06`290;4(faTUPAg%KSTVqCr?a0G(9xLhxo9xJ~^B!J#j$( z6Uia@MC0HG@|Q>s$*r4wbwCdB*{2rRho$w&;Z*5~1M;6p4#_7P2S1R%L~=-O-Q=qSa){49?a=h; z!C~d8KVG`F{&@XOR)3=Lu#-1&I0tfwPp^dZA^#9R?a32U4^0mZ@gY7etxpc8N>3b+ z|3q>~KG8V%f&3+sLvrgTe{kPB`JjvEp50vt2R~!|e$NtrzjpKP@2gkdKa}ds`w#Dr z+>^bZ5oevm-lh>`J<1YXdgb8xIc^E{ajr5;>-JdiT1uO z(Yo?xU;LBfi`Ra|CoX=V{N(#IcI5ogBlmtwo#lC|Lzw%|bCdr(e{|}jOXz%|JUK7# zU&Uqp60(yAG<1H>A<;RgBj+eC{6zVuhjxzE;a`0_Cp3NN{L~So57mM9?$hTzn(;@< zd8;pd4Aqgk%l_B5iRwz<=mUMHpR;e(q57xKAAS5p`%vflO#J#qT=?QMCu*oJ60Iw5 z`k8-neDT_^_{7Bzlppg+pRyz8j~=;sFt{Hqy~?IbU(p3L_!;Ydu;lOmc7NY~lE44! z-0Xj%sP0PkHF?Rd#Fy{!`c3_$t%v_$<%fTm>!M3&E~K14m~wNY)>k#TelF?N_1vH$R)Ik$ENG58s4zAX9qqx<`|6a4&P z9-Fs5cbNCky%4(hKy_S0bJ@H$fAcv-&)kQ855Sx@pMBrVuXzrA-)_I2kM;x25q_+P zpJ={0SI=pA%=PS-+`gxO?_hKS`h9_UiwB~4qOTI2W7Yvb_>jK(a(?PuJ)7H!=CpcB zJ92TWTXm?;vaV`pRjaHQT zyl(V`xno{AFMLQ2JwKuTa1PUbF`8)o0H^z6G%ucW^5HpVu6iDu6A)iL&s$v2>dkWz zs#kLx%^p5feX%&)8Tni=kHsT?&j+ZEpyv&&JqO6;Sw755=V0E_%jZJQasBUn`1O2% zo*VY-Ts6H=Plm2I6NN``DJfie()iE`5SzGneg8a+@kyY=#|ee>Lt&y zM(dZ7UQNz!s`dCy%yp73>DTnwsjFf2*}=3!^GgqsqhX0po=6|2d|0|9@pB zJ+>z_$S8~ulL=!$@>&La{lO%yWe=8<#{@HnETIjlm9$_bn2r^=zO6(IWPBbaaq5F?BoFrou6|^ zbPnpsIf@HEQU2+nouhU5SKrPFO&>Zxbp+`{b>MT?^m&hF{E>3r>PsI(b)@dH|MhL6 zy3#lLK;P-->|1rH{^|2aA3xDP)VV$rzkU%HzWB_E8mfy#>&lyc=ARs2y!IihdGy1yqp{r$b88w&LY<)o9ZuJI>|xeglgn>2o+xsZJJFy-b( zt*>fw{an(k$xC)6zJ49A-_%dqdiW1ke)xyEF1m!~M#}kvDWBB$_gi#-AF%TNOMR(F zXdaulK6jY+(7h14_ds=ALvz`@Hh=RuMbF%a-UFM{=Ck*W{F>*``&Rq)e6$~Ej__kW z{6xdfWenS1>9H#qXG|~D2PWQ!VUOeaI!*k4B^*lBwAijE@x453wo97}_ zujV$IJ$$J8VsW_B-`_7zgmcj!(7bnEo*Vdy&fmOJU+Tc~&U&5?P9C6sp(k$pwl2&$K5y~H#o_so$S-^AdLH0I`tmoq z@9*n>KUTfuIo4?Rs*+w!&Tgvp_)W}pk}m1j^w_DZVfER;v_tbt50ax{iBFzLAEta* zx@3>9&d}+%#7{k+8%p{$e#%R9@pBJgP*bT zvc$iC+M@gSl|#NiweIB3zx(%A56Ag0=zdRfiq3yh`(M!ge$2zN|L%LZzlr^K@9Q6y z{df25zlr^K^Yvlbe>Zn0xc{FY`-$dNPyR@=_Axj2p8C>N7VY`D&oxJ{x%{GqH@>g= z`nQ)~^uF8n7+HAQkDCkDc}IWiBbIKzebsw<7kp{0_P&4obF=$nu55N)^zZF{Up}L~ zcK!r`@9%x> zwriWSpLbca^HR6;Zd`Vs-jUz`PBZ_ao0|n6-C>7we*T{$hh6jNX6c{Y)9Y>0A9>~< z&mTGZD}QXR`s6!DF8b(KFaPb`?_Bu1XD{EZ@uO9HOYgm6^NDX?(p&hgb(+0@^Ybr$ z;m0fXk63ua$hITD9oc%@T}FQR%J+=?{QbH)#<{MK(a@4M~XW~U!sIr6i|yr%c_mwmMNiw``dJ#MK_^q+Iu=It|XSfxGf z_8a>5zx-3pE{op!#b2$xe*23f*KhYZaBjQFRln}v@RBFCGY&tbcfoR-wF|!cv*yZ8 z9@if9*jc>={Xg{2e$tEDHy`oh_E~$rw|Dg2uf6Y` zwc0~2dr|-AU;1-%&+)6b%bYT&f8Yg=YS+5v$mW>+e%;&tU3WCQ|KjoOzx@8V-VL+g z)AYC5w7>H$Pi{YZ!fNgQKY40<-}8^@pYxw{+x_?Z?;YOxvU{3McUhwE8|B`RcY+o^Rr}mE1SL~nquE(@L z9Qlvl>;AB9`;+^7?U{exqrK(OulAQ(=IQNSPhPG)@CAFer!Cy2{mHUhw?EqFgS`!w zU3$?Mf3ls_)hKm5`Yn>Y5J*#G)d zKGVE%wSRBk^P7Kfp7Ez=^uP0=+nUvuTe`pW2Y%ID^TrQ13%0wjdEU3~A35w#@96(< ztJ&@L-@CHeqjz<4)Cb?)yJ_JG{p0@S#^$=)zta23Rln}-H|vulFWh&lk!?5l$B`4> zG;`#hHD)*ae(>gn=dV1g+3DK0cl|3jZti))CokXV*>n1j`}4BRAy=&0oHlozkzIa$ zCKWE`H5B<}^6)#)AH~;mw^**)Q{DlWz{F9OYed=<}kuyF%vfj6D{^Hd)&2GN6 z+FZz3gS}+kS9Cd;j}SYrpXR z)0#b>{D$_m8^5&wmam-G>~`tey<1N`p#QcX-PAno%bPR{U;gs;k}GcSU%J@|{kQG< z^#0S|^oiz!D;+iRg_AdG_dWfl{`+Qa+x&U^6&HQ>$QQOVu6|Sd$@@<2KY8f|?SZe} zym`u1uj?QEs@FDeIAHnql$&>G2luTzXMFaqW4aGigP*bPw@du}kOkenf0Dm{bn`_Y zZLa&{^4snAvu*m@A2F+a?((zxC;WP&_JDIg)qmNKH*N3w;MLvCzN7#8|DN4m_x?MZ zJyu?7;YA<0wE5q|zPs@GZ{Mna`tnce@3Y&|i~jsiS1jCcr)AsM9&=}N<5r&^S@qnR z&9`n`r)^I7ZZmJqFE!sg_KarXH?MAHtiFElf4_HL^TAzDY4)4HO1tNCp3vO)lZ$uU z=bFnezxJoI7R`S2z0DIIyXvCtzj#Y?%uT=VzxK1|^p<_itoDd69o4^VuQl7fDUox9$p{k49yNxQ{fmo{hY^XvW@Us$Hy=f(fsoO1t4&0SYs z*xY-U)0=r;}y*VJHKV&2QK+c^Mp@5y;=3`bJ_%d&_8keUp6;wdvmk(%ihp@`)lVm+dt;T z3pc&~S^W>b{mJX-K?_Q>>Ypm?kk(yPMzD{y!uy~ul@Y< z&3->PxmoYE_ceQ*dS-9#rWZE1eREcG!8NnmhdciZpL14o$$y_a@`sC8>~FBa%=Vyf zT-iJR^o`pM&i-=$i9dg8+bsJZ&CQ41)1QCQ%yxxie$`wxcmC!7y8cI+D|h_W!k@iv z%l=~z-ljkA;CuRS_~bt?JbI6n+DrcD_U1>kcNw|l85=d{ES%SVZR4Ld&GuI`kKgw# z-96{s&DNjTyLa{{KGpnY)03O~FPzz4cGWBT>z#Z<^R>gD(!Svnuj+s3m~SyMW`USW2wqN~*=DZ=9C^6&f8tr^H8=kA)gz~Uf2IBhcAwoIa_E)46+ZUV_R8Zf z>3@5dP1`-b^k2=F-}t-!lOMBed*hKeH$VT;uSWLX;KR*v2kzKA>1)sG|KZwg`%k@P z#-gA8dCtO{p1)%I(+Tf4pI+gCSFS^qzp+dlgIW{)pl*8Fhh z3cY_l^DWJW_r9sw^Zl!|N1uLB^T2I;Hy3VnPH&axt<>K3y%`JVF5IwPw9(i5m!7a$ zyYSqjo85M~zrX$S?rd(J`_tyU`?qUWx$obbxtpHSd)#~X>96pbb^1GR`1}6sXFtF9 z%-1g0-uF*;H+!7&iiK;;eSLG9UB(--D{#9{NCf%dP{Tlk8WuW zTkXBg;Q9B5-lM)evFG39|9;j{4_wrL_0wM5JMtq>Y?rzJp!Vlqy}Ma(`%djLGk)Hm zIrD^esXrb#GUv%lFWP6zJ=(o*xpU;ccFxESm)zaFe4l%o6OZ_M@92AP?tg6cv-`U) z_p@fjLl0<9c-GU}rFXc$+4gJqE_}+qJGUQw>DKMdYkqlT{VNaZKmW{^^tbrgymt4u zZr0xU;wSgdT>IdM{rrFMjjNjz-uREreW&l;`{?^uU-Y&2pWS@uzwhb4`;ad+i;jBy zqTfAjh5nh}`C0SXd;h(E)Q2D2-uKS8_J92KZ#V0F_^ZvJU$;K#xb|@?ex$wVjo)v+ zb;UOqZgSS__E&G8(QbR$#m!ppTB|v3i(fYDv==sezUOhxe|_rOX1T8)+&pf>ne8$= ze!bcK+`W3cUUEVI_=R`&cDe49=Jv<`L%YjO-Dih2wr-Dq+L8VJKK6!o|4Sd!-uS@G zMVBA(toG)2zi#BP?;YCQvEMrF=ChA)UUt{X{a5UNZ12d&Z?@>`&seQ_{=J`RMxOf8 zcBwTtY%jZQ+1|&t-m%^7v>ENf^UrE_+GWfBGgkUgbJVAv+%ET%Rod+jc~O6t)&9Bt z@GCaH{MtL;)8FLX|I(~**?R3!kN$XX*E=?9KX%Id`d4gvLi>fA4(&G^ud!&i@62vD zoco5h_r|r`*Bw8zee<=ewKL9|+u!x>b^7=GVCJHaJ?_o@g+IQ&_nB+gZ6EmOIqhxF zoZFt(_S*~2n$^DaE%W-T?Re41uXcP*d(6Qu~c*Q z?^kW_f6i^q#xHzSyX&I=Y0hik*Wc>qUE1r;e?zm>9sk*HUiYN-%oR6lKlYP@+Y_F5 z%fgpDcir|KcW>7J=}~L+ZlC|;_OAW`%}M87)4X-J_cc46w0!@%llSWHvCh`*jQ?4` z{m2#nxaiakSL&^C?>6l!@BaP{_rLya{RPi`MSr!E4sDNo{TKS@T=b0{_uT9E%^S}B zr}mWx?YZ!dl{RXxzT}kt>%aP{_S3sB-EMi>tVQR{+qM19|Ht0DKvUJV4gbz0hmb== zat=9@u;-kMlISR;1L>qA>7>a#NGeIC!oIFuNkS!+N|HlIMLJNC`gVQe zzW>j7|Ihn<-*eypZ}k4h`^+)cm}{>+_g-_&IoG;=^P1OnEvF5#*g#JQX{%iT^Sz5r#T=p_zyu_)a4Dq`iV#=|`a6opMre)RdJ;+F?hi z8mhdG0N+bhV0Uf^G4*z(McNTGIzyYa2rjwY%o~96<~(#-+X5F}$Pt6trWm?F79+2} zht;!^h=L%RoM&R_x8D+9wq@`azxVj%~;P$Wm|Ngo=yzcJtL~)IefHB8~m)CFi-1unoHE^_M#(H(Eka)*j^izMWu0v$~-#! znG|K_quA%QQE*%)4d*Yr&YM%P0NtgBu(Vx{p}Zo&1U*>r@SI35`}j;0K* z0>7YabfaeVGws&5{J>t3RY>h4Yhd8bST`Xz+iV&TmZF z23O*OY0t+Zuz#?b=c>MwHul88z4J@K>VOR?sTT)@3e1W8}Do5)p;>gTFnb@S}5T3!dv84-ah`l^TTmU<7)CmW*mJ!s|=O}2}(N- zUg9g9%m?dM54bRJFYO&Fj{%k=v3SWL7tK@^Y-0C;6@`;f?;*H5VmjuV%q3oL`#`35 z9JP&`foflPD46Gn%U!~+p^aDa{W)bq!jryLl60@)uChmF6cY@hvBk8=xe&R@7eDO~!{zc; z=%<)3`8c{4_)w zG}D72RxKLRdacm)>M>d;aK%I+Bi5@Np^=diIO(DT-Dj(SvD2#IO25w#Y*|h-(yj36 z<8*proiTQPa>A1$K^Q3UjK8t)CVezx5vB=bQSf~zUXwaXoQ}Sv_dYA3tAQJ>+5MDk z;%Y#<;)_eDiXM16yeWB_nhtgI*OAtmBd~rnp^0v%!6w8JLbNy0jpG)9*y;uFZM9Ih zb7KcDHK~%Exp#^zJ~xGwI7A5bGzJhm#S=_ZB7xV$;7)ROY5z_8pw99&|K1u4Se$r= zzaY;ZGVP5Z&npOqx7E4GHzmNy+rG3X#U3q9^iX9%3(?iQ2!**I9U_#S`m&pHX*PPaKnS4l1PlFi_MHE0>#NM{5cHw|F_W z88q;gl|3p}l#;P~WT@%Qr?h*ND~4`+L5&o)QvGThnA22D6|E&vHg`BqP%)sf`_xc3 z^AJB?{(;Ms+v51`xEIbX4hIKbC5X9|(8?ZnyftYU-aI@GCCN%UVE$Beb{PhR1IJ>A zRX5ZP^1#;Lr$9z&6OG+93@4=PW4o3p>g`UUJyBgWM|3jAxTMmigB7%`v-Ovc|3k-A zasAl!bffP|R2S+$(=`rZ_kKBydYg(Zb^$bWpbp56Zzefg9O&id6HvQCj;5T9$65Ww z*!l}$H0JhJ>e%}Zf*UsQb6mW!rd@=2%o_oDOCC|ha1YeVnTbW!nG~`V(WuP~ZxrsJ z4qxo}{4buEQfu^6{^k4F-ug@O&rZ1R{Ws;`gq`o;ZD~40Ch=(Z6lE;WZX@GQEkeEc zD!TXBRD7E6fhV@gFtL1wm3C8MPqHa2krBsG%|K`}%A*JSt`hsbkE!e6JJ8ZJ5=|ZZ z;aqh;I2q|jYXiLTtFk%fzf(n(VU-a0@d!1Ca_Al&MbBxU0N-)8am! zwz)F%i(g0Oq(-3CAscLs?BoS|JOGVdj%f5v9xHju7-GB|Ud9{ahtE8!e5?o>u0+A^ zJubL=%2U{pvH~_duYtvHrO?c<3v!7G8j5|VM|N+-9m^G{&LazECH)n$3q~Pt%O)_9 zdJC~Z;`mYI46*spk7lc6(Ipq(kn#uW__|FUe{bAI_gd$YN=7l`vm@5ECz1I{Iq)v> z1W0vHriNuZ;E};*2$?Y%TQ@v_?NOyLUvZhH-WdQ|6JFD)Nn)6}#2Lr0)WphT{-8g7H+=+? z@Qk_^@~XwLZt+!E>6Aq)u1VpJ@VzuxDG%1vD5LClf2uQy2bVPqAkq6H)fr}vZcf_l z#AX?swCN_TJ#-t2`>UbsdM_$+dS$z%h`j_z4##A z?KTOuy`=Eq z?`^mr!BNeD^5`umMO9ABz~zTaXiLs`tg7+F&TtX7Y5NHLwnQFmBM|OMe}+(PH%Og& zhdStL!tlbowBmCwM2)n?{zKJqg3D^?c(tE~q>RQp<5jSDcNZ{~yP!Z$(y+mbm@IjS z)q+6fop8;r64cUMaof{w8vp(|++HWtTL|YTg(>~9*6(*%DKQpmZ2F+q z*$qYNZ#l2%KO4R|Wzxdc3b-a(1+OTn;o{?36ub=aupW?{VP2@_DupR&Gts2)6VzwC zqEeoYC~4UTK^=~$=aWM7MGcur#4NOb_=Maj$fcpGKrY;W4tvX*V6VO_UAT<&;Q@M z1p;3U#WR5_xIiOLs>tzTpxCuv|-=Z7DO@y+0YKcoy z9Bi%OgZ$|_kR7%Mlhdp5y7fhHdbp838ET62I6b&h@*S@7wCK9?`=D~D2pum71?}}y zabV;Xdc~lRe{F*s>I{DV%b!30y?g)PSO2S9AbinYSX?TPmy5>XyS2%9>hV}S&)W`# zE`gX(>OGQ0TZG80qA_m{VtY?3Ir(G-=8ySIJ6=TciW(xQU3L}B5e;R@+UE4( zPRK888?(_Q~?w<=(?+nPX&a z|3LH)^(YSWcH4-M} zO*{KV($midpjbl;J%74@W}g?K{!0dq@Z>bsiH7YVk7`rq3?Z}3_E6t(QqT>am8epCDS zr|+qd#utjvc#uyL?`lDGhchp;SdQKhH1NYODZ>mKzl)U#2ly29OZ#0Y<-G`sD*52t zL0;a>oX(5Xc{>HmW7>4Qaj*0GhFj#^F>$PMUJGWKd?x^P{l-R~Y~7R93$rXlp9(W=J(wyn_k_ zDU`ddLyvlG1F6mTNYD{Wtd3Ph*`^^F6B|WUUwnfd`w~eNFCR3wnxo_n9SqE~q?2GP zUH?uSv&wa_F1`ffw8g05lrhx7c0ZhH-a(tvz3I*4J9)qQ{3+O9RsIdA$iA6kiHuYu-7t_=P+^}yj^t!Tq8Bf z<+rvxGo{Ti`ty1+t9C1I{naTh8Tbt3%{EZ}^NVn&eL=Vv7&;T2%{qM{KCZ$0l&NUk0(SdSHfzHQ%TbW z;tbffZ##MPW*KR=u!i22^L({?v-mQOdt4q88AuFn=Y@V(faxy^$?~H^AXUKeu0BYuot~n$r2o8i)Bu zZm2`uqFlbsl>_`E$B*(IPhR8O;tF2sxVwCvhO7M36Gb6L&zk!ADxuDhk*GN_i#B=4 z<7+W9>J{2TI>KB@ZsJo&UB1@Yu&V|(6_%1E@28^ad^1eUS%e{VJlfXEp`Y;iwX{?Z z^)m=6?HPy1Regxm%2HZw;f@01NX&nEnt0ycL>>EYqT7e}!>xT|sPXDT+ACd6n1>?m z9M=g7_R@Ia!3L_M*$R_%i}^bx5AxJ5NWzzW3TS(+lP7N(0t*vNX|SOeZdfgk-O~o+ z=jp%E3BHE7d&G8^AxVa46z7b3sv|MY=rPIPTu0%cCALj4#1+E(s2E(S+@7s8Awdx> zryij*C8B8Mv{AoY|M@ubBRId`OSPiB@XWki)R`QO{pObwPdRT4|L8(z+#2qbo0bC!wmJVeyekeDAfoD6-%dJ)ZSDlm_auAkPpC zlH7_jyA!C`1rO|Kx<%qW{Hdww1vtL!G2Hey_$mLE=|#@}Yw}O%Z}KWS&pfAx&=3LUnZ}|l@_KYOh)kEhOJ~@&!fah-e0JnMxZR*I#owRibl9Wwby@5icN{Lqo`s1qx>Qy<6<$s) zA}!0q;JC>(s5G`F8>YU5bF+q{(~%4GNp3&hbF&(fEnh?COo}7H`Hr~uSv3?pYGETg zM!J`1U|v@s@&ZFKwQ2&XTH}TCGpAr<)hslaG8}t!nw;6i@tt&fzgrnU+egxp$Xhh>^5b7V{saRApeKI{PH7gA{a`o1RM2-y#izb||;e#FfVzAWBoC zH2%d5y1LjJ`!@8z-g5+Yd^`uspIcJxHMd}GbTg5;z6fqwzW~jf?ff|a3zuRlon((I^d9nac+xCGtPj-8?}Lo95A17B1NR|ccs7qF&=Grg60Jpj zRIN6Z_>s3D#eW9Ani@iWjD-eN#+I8UpjLVuwr-1q#O@YQn3PFO9-M;?-F*HTHT_?{ z{{MRRdDs=L4n_%D)N17e2=UG(Cyy9ofOr)hA0~(OOQeuDtC4;c+CF(ib^(8FA>_Vp zh8e}b@yg9(XrfmTc~>H!`gfnesDm=t_3|FnM1SEow0lxDFMEua?T59SGvI;WIasyW zf_8}RgC%~uiTssZF!^u^{0u5Vw?rAP&iIYkJn5k!SE|8)YA`AL>)4_fR9X-P?=A+IL#9xW}T@n$`+ zqfZ5GBO4(y$En0feI?C&G6IV?ieiV-To8=PhmxjAGzsqt*YTT)LT@UxH{B7g5FU0J zZnXSYfp&HXOJFS!KyELv0EEr8UdqS4#SRsaX;nXgVmnj|C;<0`aS+l`FB-A9%N-^ zlis2pe$&nINY?YHf2jh!(yZH{Mv1j zJl*;kbelpC?bT`~D--KMR;wSz-Wq_sFHgZDk6~`LEzUTkg%jhqxXdq!gJqtZ`4W9z zSh%Bv7j|;YFYkZXC!6`TewQFW#2U31_CRfy0k&f$!R=Zfte5wvr_aj?Cvrkth#_uR z`Di55y1bgqwd#R;hj){ZZyDtI1Ouv*JOed?8cA%TG?_1}!%uuT4!759QU4q}T-pCN zmHn^~yBEcks+pRz@TczBJy8cU=NyAsZWa*9m`}hZrPC={0AiB2J4ZEE$(STKvI8AC0J*KV3zDWyxLEY}<&IwA3#0!uzL z68D~zWy;>C;ouf4{9>O%$8J0WPZHvYo{ch^Mm>d?9%)Qmy&P-$j$!-O!B~9Kl$KW- zVP=^TsuUdM$7)N`BJ0x-Fr*1ee0-?wa2vjcyBKcl?t^D*_ru1?ugFzfAD1~VO8M?z zKl2u6d1C*v!BlUhHTK#x({QU`9DSyZ-|A?~f?I_4CFwe-7uBCE8n+d`6-x2D<)i2= z<5KeIkphdJ>`vSUy#vKsXIy(3W`w z@Q9?+EPOcHie&atDF2|2HuGoV;`arRy~7LZ0%X}6n>bu?`ZJ%67|u-QO~=9eR55pj zEcSkx>LON<2rK-AJhOWXo%QY@<+Wer`TnK`-IYTzNmd>@m$s0WW+$xG(ns9~&q+~z z9xrCnX!=Z25w(Z3!SItj;$S-Om-m0qBymWbVau96EW=l$Qcy*ECGrgX=$jl1tZ?zc z6n{J1w^@P~=eR%%e=piR8$&xkjz-P7GW70J6`GKJjjF$~gs$@ou`@v$yH8A_E8fqi z<;(OK8=Va*PxhcBJpc=}3{fi56E{rkPm|9n67$3zq}kr`r~kuZcP*{ICjW%~_J33U z=>|RFvwJ4EdVe1;eA$Z9nEHWq<_!aUcPoa52%q`A>I+eAYz7t7e1j#0a#SnvHN-j) zw3;J{wZBU-&ry!J(f>W)C};+5{4fBYSQ?{BRSo|mD6yd7qp?tRI;vkygU{#6d0*74 zslAy#23E9E{avF-dHFl&n&knlYE{sk^pPher;7r;{-vsWgnp|Z>uB<=Em%BnD`d;- zu@qh&e3>AIv5FrdFGvbE%@@H%mvU%I`!q7Csexvg_7LThBhX=`5$Y+q&_vNaq$Ah? zjbetN{w@QUd(s;c@};nR;&_^8+{Y`D@BkJ2KrET52}5R9@CPUxL2Ga%*w}0HlDBUJ zH^~|FLLh*Bnmk`daWBm}wFL%buLQSq7R1>|89en>AjjB_Hwo)_El2g}YoA!sy3!8h zA4Y%?KicKf%k#YP&!QpOdo^5cF$S}160qXQ0)C=yACX$a;B}G_JfFNB9z0%1$B%SC zDKjHHG*+3Ky*&=y+pA$~d=V)$lSEau<=ArhHfeh}7;A1Xq&XLDv18o~6f7NyS43*) zwbL%R?btTp9SBDCb)(RXZ;g{G7w|G;2QoEC5vc-C!*(#l; zU6_MLy2J3^4R_4Cno7HtJ7ZLQBY(4s3kLgG;G(ACLiu50zkJ@(HXt&oHZ++G!B=IT z^u#kgyfJwJwpnhcHp5$>E@K##QTz^9v?zw$k;bG9DVD!z9I8Cx!F9D1{A@6S9@bUDZSNmKOXYWHi4@QPS6ke- zVm~c?Wr_waJk0Q&i^*53__6v`G%sQ)iZ&>r+VElcMez{1V%AA3cMZa~rK4$&atD!< zOoiLgk);=27{H2Ci(K9>Nr7^a6J$$e5qQ*lQz^p>uvWz0bpsTP z73$%Iu@hqM9*4(EX7J)t?NR=f8NMx#g?HR3yf`=wXMfhfoLdI;nVlzE&HoHvE5)g+ z(_ok;Wr>xwXUNU>YV=#=BPdoKLHrGGx@gZXg~VZdq5kk;x`Z!-+iLA_hglF+_^ym& zBwa|w2xHJ!eFOVz7`A#(gv*cQ;3!u>^%qRW+h~VHgQlUX#zJ~WXb*kUdOXOgyJ2{R z4wi^c!@9l8V4=`|ENQboE_V>F37l8L5BaIIxW1iAJa9+N&@}35T}@j@Hve+{lg>a5 z)Ve*Bz8*dguX^TTqg^U~D0u^$*6hWN+Y_nxC}SAE#+?*@Fr=&0vS9MavE*~sdeqKT zWRf$NP~N&lv@Z4qq-<#8+njg7Fheo6Rcc>pj`bV5y(SXpqBkCReS(J09*lXjKEUX6 ztLX*5;h;Op9h(C*e$M~Qd*zP(HTfru`|>yCpS(#1c)?@n>Z&HSP0H919z{m1;n3?{ z28H*IIKF;0&OLvRW(aK`N!tvbpEiw$2>ta;?Rl4M+CI6i7Rfx2{0}^w0!FnGg z{i_FHhTLQF>^sF7FB_?vRH)FW!UE=to3JkY3L%Yy@U!P-7ujjoVXo>*VN8a-^u~h@ z7t^IuEJR~G9Wl)e>n|E&a>=XG%#(*;>ToA~F|9u)2yI6TmQd)ZF~jcbQ>atSU5GHX zfM^wW%=A_xwf+GRMsnbK-*BwnvX?hu5D$&_iZH{4(dhRkvQ*Gx!V+55u=S+|+MAn^ z_4`giR@`7%JfM#B9=0X^yFXKz`wz&v#>7n3o_;=#uc^6WdfR&OUMaxWo0yB~2gu)=`k4OA#2F-BrN zs$(h@adJnKqAz60if1r)ye-NL%HV*@P5P<09~Lc|MCG@5W8YH^3<%W1uWKZsP*a(0 ztD1^~{oGJ&lLQ9IyYTAvXt7KuSDZ2Y7X5r=IWhDvgDK-@(?ntX3zt<6cw@-{VyCWx zE{ci}f4+kph#!hQwoCAWM>{zpV~klLJaTBf4F(@vfDYSz5iZWBiL*yy@7sm^siI?X zoa!Ll>!yzze#<5q#WGBDFT)QrC!_Az9KH$Fph+7Bu=4(6acfmSmMa-UA#Lz4pa1ng zp--%Y{+eA)ugLtkE(nfDC7LoO*y*r`9(`hfB3qVWm2@7R@iApm!QI@m75t)ll`razhnt^R_{aCAWasi7@?{(^0H=IyM^$eYaa2$eZ`_EUuB_ zmifD>sogzdHlhZuddu@3e0mQFYZ`gSr7iHA^(-PD;*Dt@_4I+_3Us`yfwdooG5>?s zIMQPXj{B|yZTq)_=erSf#gLPK+>8TyJUv`6s+-5v1NX`v0`#@bTVQ`N*`sTbxh zS_qG&?!u^PJ0Rvv1>fheJ$X6#EWFd&3b9`9c;JLLIGJ66##KY0-pc|{mMkTb0gkx% zzBCi_S&9DbI(#BIj7jIHqWlee{Lrt#DbRl-nZHPa9?zDivrQeS$dLzhRt^Q3f-a~Z zCyW`;z7%8)U-A89E$~R8C`N5d2iJ-L{IBLEFu~iDBu-VwkhS+pKI|NY-6ihO`A!6* z-WQNGjc#z5dzQqWV<@*aiOT0&qMpQBoYP%M^S8KRM_)c!T-yShvxRFVD3p)CKd1WQ zLi^Z_k@SP@SoA!kh5>g5qQcf!{FxucS$?uVa-0ipnbZk9y#{_wfEX)Z=Y-SMuhWF1 z62woT7R)STh^dzobiFwZ$3n!J>_-)RSfRtjBSg?E@B2E!F!_0bp9{ za<DZB!a;h^T;7X?frjG3l4fzb_YaLACHS9qk>7R=?%oq?&j%Pfn!Mv?{@)tO0`e zsA1VW0U1!0OpcHQ+;Yd6sQxB{OT6Of<+qm9A?-A^&sqhV@8ocPtP(cvzeG13KgoNv z#Ep4)FU7l&37D|Wk%sZ6VR*wvzI(70sVt9#@HzfauGr51VgLDn%Kx?aFLr-F{>!iC z?|+~F-!1U(7Wj7y{C91EUv2;VU%~#Xa)B@aU|F9b^Rw z?8o_oFG_Ksj_ljh{@jnx|1srQ-ez?T>fHC!L0s)9O>Us5-_LUW6c4bofulL+(BYit zHw|vRu_(v(DsZzq^*Gznuh^QE9-R79j%%Oj#1&08T zlPePA%=;^G%VNDanKfdZ_Y)Ith0JhnzSeN=LQyHR9H_{#fEd=4ZODZb-DkU}$#K4S z@3S9ue4O>*XZ~Z~TG^hlD`%K>B(gm|3z<&ibS87+GW)Qpgnb?`kVe^#Wf@K+FDDP%FsZzMJ0%hT62ayZNI?uvQDrFh577rL;#CbO<@ZQjak0d zB9>zm$6md^#j?-+&O}F?p{dRxKhLj_yqVpux8WQr3YpToNLF}n%%Ao8QMW%*U;90l zt60qn4f}CMO65#plMGi;CByA0HsZXRftigv&pKo47&Mo$wLY?pz^|n_K2w^?yEO|RHZA5HFXdKo)yAk9S`OJc4W*=$df z5<62rkqeuc%4%b4+5Uo@pY^^&)Bdc#McEtX?a{(?9nCq-T4U~Jn-8~ejSP3;iS5t2 zF6lMndalcI^|KT?6XS2}-a~bceeGsSrQcZI0w>Ps&OmM@r^4kt*X4#8$#F@&V>rL8C${18h=3s+s(Iek`h>sYKLP}Y&*i&8U0FVnWrKZ(Huu(1& zO`g`%YXL(AlPr=^?w}ew;F*a(HWBUjIKubi&-|ZM_rL6+*pF^p$mEEh{p#rJ%f&zT z<@UW^%gILMv5y-ZxfQc{+~FA$S#qogH*~ZQ=YDl8r=C8YrDsg!WRLl9#ngv8duTo9 z_+mXbFCm1b%=6-wejdY>J)gpTiX6*T?DOJYUGw5*ty<5~5o5W#YfQP1cR5buo(X3i zc$!(BLRR}$pKCLc%VYBz#}PalEvrholemYLwse0H5awoKYaU$>j%o=uy7{-@Lu4HiZ8|NMW! z%9Nk`ih^g%uOyR2g$J>tv&#Pb-ekQ7ckr$(clHwDnC<|sXWlT*c*Lcj-=`$Xa~8c_ z?A*=)ocARaj-6EGhUklPC#poah;lQoB1DecHkIQV%%r(lqZGLEK}OsQLpknAz9jeJ zt{Qjls3NChAj2JMHRlZUWVyJrlq*-2m_~<4;7GUIgb;we|f4gM%kR;EqHH*l)`6?(L*;t|Edm(tDwk!q)A>Y}QJ-Jh;g&h<15$~P5+zOZ5v z!zKzew@9&}~=PQT(6&=O_gW&gXz5XICA>ewH7#k!x7u@n_kWVb7SS z_XjrCSo7yG+14(0TWlcr+RWh3G9HfgKYzPd>G97zQ2qte)NW$#vCXWkqn?#*5apuo zw6SS{-`VIZO+U+Ap7{A^zIfkF_U`3l7W(^3R%+Y&^H|E%6Kvf0i$C{8gz2{B1TOQ~ zf}iIzFt%bmdu6VIj`{QaKlC@CwlR(gU!?M5`8;lXM6F*^a-O zUp>5^(zX|}+`r1NZS5-DujJP(qb=Amd z*B9`!k8c(w{@K_68NZ5eiJ|}ISCRjtG(>wF`-5LAm?QUJgg5*&qDcsHDRE!LPOZWZ2jnkxcB3>d$d_UPk86@%WGYnyXqx|B+v-6rEXT&wcuX zU*m&kvLF2V^p-sn`QPyC!O0`o4}Miu>7)OVUk495%KqTjX$8~R!<|>?4}KlDvz+~_ z{2D7~$^HM0UyYWBuI`ANh~{U(K(hE4107yae{Y z;@2B0B3zhEJNv<}y2~yzRsTNr2funm-e7shOW4rr59~|u4VD=%$`wqw$+9v(vPp4I zSo832><7PgW_@6COJ6a^on0(b{R^8iH2cA?rs)UR4}LB1I?euf z{MxssjQ!x(bE|H#|H!YSHf?8r@avn)acpC5E&YREx1PVo{xg2v;WPThU*cE$zaM|? z)Te{|d9Ff5tBnWhZA{{|*_hJCyGdXldW&`hRpXLVQ}_>a4+`z@H<7;Qb74x^B3ex* zlVhFAG-%j8vY|DGmNETmxTVOmF%p-cd8i7UdTK}obpr)f(=zGm zv72C!^=j(zEej>S*5XBH9~wQ?52x&r#>X8JHSG?#4E&m&eXLc0#j4S2_M2b~-^v9w^WC5~U14(UU` z!D|ssOx^eq&U{LN!(P{kwAvEtGd>2AA5Y>PmB@v%UAO37(V29Hnk^k=kcnw6nRMHy zblj6M2NQj-fb3LJI&iEieHTzr>U%|zHMyk0Xg6CNZ)76q)_e!r?2}7)us$K@tBLr^ zT`or&)tF+t7fLqpNND4-9U&K&G#||f#Z$?+|6dW+7 zohZb0k@5v@){G%be(fyq#c6^Ve(QeuF+iiWKW4w<(9q1rX%KBu4Pq0_nS1Rkp{-^B9^w~a`G$*l{Bf1g?sgCV zh{jb67TP9;oIdH|d1*0yKT)G}WBC-Ea`_tX<;G!P+#=KuERDn`w~TSW-xJKTjYXB2 zM~O10#EyK)LVmXztA2@eisf18e|9aFR9;8rlNPw)fF6xHTvJ+>oCo)B_fZMM6GZfo z3boFkNF184)88F-)5PyKxNPKi;-~YJF2AHLG?+=mkEakj3x?rIxrabz?x*4JhT!P! zqU;U-HAYSn!|bA)VCfe|d?ohLeXgfzg<*f3Iy#y>uGYaTCAZ0k2MzH3P=B;)He=&f z){^{-PEa8I4EAK56xx~Yq5~%%hv*9>RH3Jv+6yv3r6~eiX6~ke$5XJs@9(f@_;`4v zM(-iVhNa>30rvFKVmaC+d^b_#y%EIY;dS!b!7SNKl0 z_jyVC{MZ*_CN;ittW z?^9&lWfPneUr0u;`2v%>wv*Z094IVOqMlZwXl`uU{gBz7-)5tt*R?(-g-o{~sa~(JjJwvs( zQJS~o1AV#8n$B?1V-G* z1@GbLhj6r3ReBV5gj@OmN z?ZI7`>~ohKJQ9cJwv5Kr4~xmbC++m&p%T(r@|4c;Erl8TLiCk`#5cKQvBTpMF>1EeLDEHKqE^2<|Y%w>3 zj8yNXpZsTGNo)z&9}Y$DW&v$1t|yPq8{$|?JL=GK1YfPaL>1^|7#yK!M zi8{aY=512mO}8fJk>e#%xYXC5Du!I)g^zfECcbxw<-m57^nb{kK5qbiyXj2p=4-L- z)>r7M$-9Y5>3NjD?t#90vT$VT5_%#2GX1Wli}SLslj$L+slmobl(G_~YXlF$c;x`v zVf}?%{k)jmx{$_e*nWvVY8Z<_<`-$ljy_xvKZ#U7TtxN>>k*l9o_BxO1ngL}ov_MI zTV-1ZNV$}8XH>Yznylegz}}= zhtuVK8R$H=lUEnHjv-O9_GwInnBej#z(b1Wp(zf$JsSgRh}IDoCpf zimR5w6{TXj;(09HGinWP8svv13wp_u52NW*MRCEsc{iXu`z$%9D13~i&@;i7&YZdkC)y?peQ>ux!mA9(i<^&6myE>y-dnM+-I|S1PXyGW z^vLuhWbg%Fnisp94!tW&Q*DIr))}UXSNk2txdwpymt5heWsKyF*}e(w<)_lwcfP{Z z>SJK^QUduOL$PICe;gZffYul{lZt~^sg`v*HL)5%txWf$l8+hYyDO8Pcju^L_i*ae z{Dwxj_`$w=HF*8y1Du-VjBn4J5RMl&w0#!<(^g3f6m>n;gw2fBLe<+8lPLoO9&kG~|Y zoxs_DQop2|Q%i2`&ERUBuLyo`9K*HR6bm-)+0T-1FS(TDrOMULxyll!uHrs^Mfz~# z8g637Rsrj8LqD4*U0UR1erca~^rh;9JkI(2H^K9vDV)Z-4l0}Qnp<0@a9LzW8C;z- zgZrU>?pAdVi4@M;er*4e{@MQT$ItrxzAc#mE<$NB2j%Ks(WAE$@qSb_y!RPOw{)1( zRLh50!^NY=ifptTRze2c(P0L)lTqsgqRSI^+LFA31oo4Mc5p@LyIvj<%I8m z`FHxIEg;iuMEnOfl#Y*<0*{gBUDSV@2Tel%E32CxypOUgd6yrqg@Tdqc@?t8rOKm_ zFI#Ix#OkIJeGNO8fM;HCS4(K_aeg!e531zX4djSJ`zkVUPBb}nHmk&9wFd7*lpf^Y zkK#}8ImDAt{*7;T%9T3^yM=$_L>RAL=(JllWh`F4X~dSTbS0nW-hkw(e3Fr{0MG9A`foq}c0Z06WWCwV z&OS&Y8#f8pg~u*qCreZXl^z-b`)fzp4ik4OW2Yf7lBs9M76k|v>lGENx+55y_B$JAbdI(*jA9V9PEdR3oM4vg zWI_6G!OY_1S%J^MEcWr0CH$UV#yg;R0iu^1(nj@@#F~DGsYm?aiu?)e=ix~C^IPDG zEr-7IHKp&K4rpp?l0ypmK2`5V=#PEr^|t48zAH)zlWU)12S+Io6S z?mbzjsX&k9t;JoH5758tchcLok2bxZ40~EFv3~AUcBpeY&vcgsnOYZwzjrpH#PxW3 zG%bjN^fMBbAVS8ySjyN_5y4^cYjpPN2`pmBH{2fDk9B0L!}azuDwds&X$~bA@L&|% z_CcQ7-4c2%SDUkuPFh&BHlAKM`w(2rS}<=sYOKvw{-?$Ml)Q8-~jG3_ThOVIs2j6bLI zEb&olqR~gGVBfNQ{uila%*cE}lrM&&o_;n7Jl{z?4Rf(&(@O{!wI{nz55nC%3zU;H zq&};LgZFkzY#rQ8owj#_Rh1u|`8oj|jUK`YuF_@g17z- zJy&q#lLB*$oJo}r_ZN8B5W&14ee@YHg@pUP#D*E3*t4sWCA6s0f~(IUquLEzBJA0h z5z$O{oi9lhOT`5~dYne2gCI!I3{k%Bf+EjI`o=sBO2-Zt)Xv>aB>ansOy*2F$@4aT zD%($cCO1&C;6dyMf8D6&rAG=c|Ht;PUH{*YUo*Nog>U(Kp+M1mw_rk33cCMZg$b5- zNz?tsBzo6*Rw+G^iIpxuN4Fw+@UbTI@huhb9)F`x!(PyN$4*d#7hV5@w6lGu>WSO_ z4xy4HArX}%Ns>zJHQymglB6dI$xl*AQc0!Sgd|Bwk|fVbB`IRBnIWWSl~78ON_tYM zq|&{v`#-pj>&1TM@M3L_nOXBa&(DYaQK^Qd$xB$1wkNin5YJ?9j>09n1KFzPPEcwQ zv2o!SY44v4Xyv6QWHEUo8ob*c+xeR_Ij_%P`6H3e*eGT$2lp^_q5oavErYT*wc@Uh zT~N^S4yLGvvCi3h2wQoX9J?;Kh1`$PJYzq6At4J)Yj~t*c9!;j%R?DKec-w=1KGt` zVYj3aH1)`SyiIcsL^#B-2Twk+_^x}zb<{JVm-`aZws)bhRqN=VbP64b#-#aUgy7@c zgiHm`qP<1}GAwZ9zqUn4CC)LV`=uiv@+g4lAM%kp=0+0s8}ZCR8~H69#djudL|!8& zlU~J_T&V9PE?QOA~|!5`HBfHrg;e~Y$dsl&F}OCTbv7Awv$qRSt>g4Ehf+EiRmk`@KB z^dmv|+{pXn;*MC-Rv^Pi`7ei?TQg|EFX6uJFr(+!4}uR#6-4`CG5tRC5_KFkf^HwN z44!V6K;T{t(6ZYmIMj#WkhcK>$4!ALYs68TkInEbI3E%^^;pE5D0JiTJv1n)jKr-R zg;Jbf5napE+||l^;;xxZ=>eX}biJ)=9FiF5!Ou(X{`F{<#JGf)%OUL%A|C#mb5x{Uj7|D1}siHAnhN5BVuQj5pd=LOe&> zqp7>I(b~y($yeJ%B+(xVB~D7jY2Y3xNXi4F;16VlTPBG+r-(!mwbG{wbLhy+*HK-m z8~k~ok3?Y^R;@4H=)#u_y+C$Uwrd$$nGRHBDiwRpY9fnXt%5l55mawuM2)A|lO^ds z^wZvGlr(iZ|7N#3Xg}GDe%y#6?n~OZyXE8Px5a@FQY0aC$z_;!TKM1oa)Y?Z%c0Nv z9uXCx1BjlR(*I7@!}FQ?c-KP_HPG?}Keta}uf@kJHjTHZS9xDjw|xVR$({` zos+{G%tqmi%rba(C>vI#PJlO+D$IE`6UQhVXKO;Wu-lkfuqyO4(ZVlDvU~;oQ+bg3 zCsflxULT2F?*fz*K)F53^xn61TiWZL~C+VVUO?w(bp ztL+<5wyhd2G1tcm-2)i&Ji)!$YYtw@2IS7#XQ<`uSvs%qDhd2$AoXveBr{2k*)~e4-LwOy6t4#r-D7mgXYimL#Syc_^%tL1uuGvSJb1HYJ+Q51wCXlsyQ)T>Fl7t{F%joSuNe!C}^4vwfLfxiuCow!rOjkC=t*bXJ_{ z3~{uGMk%}#?s|fmNqaZoFZUoqW{7qE19=E~JOICYvxs?JUPeS^aX4+NI!$=5fzgf~ z;NN9}bt<+qnI}9oty_W(j-;|x1!lM`CaThTMFxD%Xl4zp2!~|t1Izc9v7XUZ_V4dK zz|!*|6NxGlHp^A^*DS(`Z`D|!whlU%7Ds#g)ga~98r)gC4d-gNQX{1tT&^dNeIDJy zYARcC?WA3-Xj>q}W$eQei$hdi0s2^(zPCP|9wOri^NpiX$=OlZ-|*B61|zb9hrHrg+I&sNvPUl`ew2(c65J% zB6cK_=*yE~Vn;juGvA25eKrt(7}?04#|GmUQ+w&I33jl(X*j~&3o6?tXkiuAW#pBx ze`;n6UD3ZLxVTpp%+vO>zx5fo|H@{Z_ICg__4&@(oz-NYHU`7Dk1{wf^$;5%@Mz1A z%ojM-@$g-kAJ}y$;hxj;aUHiC#%|Wa%S+`eS?>?FSZO^JSlBS#xkcFBWjIdu5aXb> zL6vopHxW#|%;w$8Vdv9<6Bnn);A-yQS%n~Ji(F47CD#-kt z8!1>74px~0cd30by{YR8k4!}L^X(+0P!x^k73_mQ0<&Iu(0WQ5ZJ^{@Aikg%&B~iM z;?rY}GCkKqCUI7V{~(*%#8#j@dvkm*@*#}zy2YGsufY>{9${JE4Vm+^i{Ne-#Vm9K zzyW?i^kqftI_?b_r4xaDzDQW~U~}00L!hH|gkbNf)A5`nP0If|0FxqOnCTcx{PX@b zdhm87-Tq7$_uU%Luum^?{p`zR^a9y2i?OisVhnDI&7uXy=VA4o@mQ|^G1H1`XLhQe zAt7=syR(_6nUfB}@w3;UZ_9pe4voQnreW;e{pon0NE??8y9MudDq~mA92j^?_&W#H zkYW9wq58cu4t=LDAt`BuZ~18qvQ3_5Pa=Q-8f6bz>}Or_V*u>rUo0KZQfLgEBI2t>?B| z{H0H&dLWs5hN_JJ21V_z$bD=9w4B;Y=fqhtkEzd5_O(%zEoqfT$JKKes?*@Yz4f%` z*AftiMxa%f!=S%c5!m)gNV{i0)t^|4j@oYo<(8k+u>T2>oNXdwawfnH>l*qa@HZGc z4}(j`Mqo|dDC+AGM+^I;OfABL?CZ4!jgq<8_3Uxvz_mbf`e{&X%%|!p=V;0fW4gS5 z5%?s11oP8vu=9^K(>SMs_Zmj9WZDCnm1kL;OcrhTHpM3&@4?yL0*mJMNakUDl}5WC zgcRMsWbe)}I`Vxkd3{twyL?|G{~SbG9EZZ!Z#BGsq=;W~V<7!Lsg{rF7dSsk&!x_` z186{58Gps-I102&;%7d6g+}kpAvJj`(emaj?%M3bNX~o@_p*)hwzVB7wb~CopIk<) zb9f~4-HWInl|f%$e&$kEv>`bfLX1Q25VuA>x^3%z%nHZS&7*F>39%y9sm54V>O_sR zma!q~o^1KNPoQw<8+C5IN$naU@Qg>7sl?zvsajeZ-K#(;3s+$l!#wb1kp~ki0{*FY zgxMFBw{5bGKnv{$beGBXF-}kE1pz;;OPsN#h`27@3h61|h*t1k zsMbzFY-ty&82W%Lluki&sztQhr-YM7U1F_A-;hCa2{$wBAyV3MQ~cq?d(^QkpBr3t zkc8+S;B2z*lhZ=4f5l2Wa&OTw{%NsYxe6@B+Gv;Lk-{P2zy#IE?#gOE6d#@KBw;B%!a3| z!f6`IHI-xD@Er#%Y{3r$)$sJ+AF;{ax!^c@7|co+vCywpR4-sNjp~_7Py3x`yV~!e zIeSO4u=7J%lTj;+*l5ZWpXcFM9xX_uH%TgiRQAy}9H-ikW7|VCSWLSNTke}dS?*kt z;L(C5VVlGiNiEPdX)x1NPNcDcQ`iY%UGYKJ*k7+KY}&pTPPNRZI=L}$eV{wtcwY`X zFHfX<9A@F7vmfXOpR-t`cR(uoJ`cTbyw2Jib(!PRJR~!74rIJ_!RtF-QTfJ6Se#vj z;y;Xp05*_DEb>Hk)%vuw;SJaSe5An99}SmAyya9c$V2W+5tl4ghj`y6Zk$~a>3LJg z=|7R9%{>g++}lH%lqoN{kWIQX68Yuy1y}w*e7UO!NMThYx~DJ9at-&Re5^^zo(&=9 zcV*~Rg`+4p=o1Q`zlU}nzK{IYKL^7?Ig0L&0ExdY@lO@e=(z`w$ohk{^ScvS{a8fp zx0FEVP)(eDcqnCq2l64kCyD9uX70ipfx~-cmbBM9ndFR?2p%{Gn%yVxPL4WKscam? zTONYad4niRT#Ev?o#hYot3tEJP%3)-NV?R24~@_90OJeMAo?$t*HT^%{+sfMS8gL= zg$f{ga9J$pUy34%N77?u=Fp~h8vd_^|R**7A3L|H`&~EQ|6u9ynk*oyXRq(Zo)UH|iE#i>)!BG^g9!^p$ znmKpt45AqB#c5tYDvrK(9NAMZF8^;hYPh^h9Dgza=}8uIib0c!#K@3~n-NB;&sm|+ zr$2bjN3;2o$$F&h*f8EbeI@5p5k`#u$&!*bXQZOOf`pFy$Nf=D;{PZ_^F5pQk}~C? zD5+~564qlhezXmHeracAK*CEnnpR7Dui1iury(v8GR`i%Or>ArAgp>V7YY zW%lvo*!`~*w^tP5cQa3*b$vEi^yeO$`cD(Pj_4BDtID{j=@D8uG?J;_T+A|JW0+dS zX~>`EjI$zzyU!!_Y}ta}tO>uwnrr+Z^~f@|^_x}YN!|^MI;yOSBzr(>$2y$eu>?Qe z`<B5}mRk%^<5KGCNgG-wBwY$2aUUXK}x`z{CJPaD&rA~ykhC2k{{ zC(PhXY&uIh>%gkpbJ&LYH4yb!jLUa?2l2U59>L_MNrSENw(NSo@0 zbV6WbCh6Srh)0^wXtPWf36mq#xbX_#bFP6le>+ajUJikKU$&Cx0TqxuCYnlyOoxga zQRuv@A8eTKjAk~SB15K0L3tOzOv!ONU_ct^51mbe?>8d6v<4L&Dud>9N7_FlpC0=A zl0+@9AlE({!b&%R<-ZDpPgfz_e$h$VrWGSmX*!J)vT3u_2GJR-cEPMON;vewd)|BE z0Emi9A>GbWak~Pd?^ZoT!M4L`QTtFXM8}^#b7(-@7w_l$`+g9`4XJd~fRVKO!A3Y) zw**x!?nK#dlgP)EVifx81us`UnGU`zLC&TcVy|H*0XwG&cLQU{@YoT=GbM}kFBwU+ zWZh`6=pCp}S_grzvyr};D|~-;oi{xgA%2`LM;&a{QE*8RZ7!P!0ps`5p!%_pWMe~X zg)_@ToxxPTY$5H5u10%X4an}S0rYo56_E+u2tGsY(RPhgBn~-9V)t}#OIDsGYhV+% zPcc=Tv@8Q@NH%eM{bSIB;0W>jkEtl|KMyX}cn0yfGL4Ifi6$Z!J7g9hLw0)F@*8X> zk%JW)e9F(Y+*gf*BrS9Z`C9IdA|3uCuJ`1Tc4!(uh#leO1Ea{jVIxuai0x=WaWcWaMfK){5bst-Y2X-Vv}}O*!YPaT$q5v=SSc_ z#^bEhyW}e!1{veMV`VD+H@mUcac-6F0s~O4bTjljuC*>YdmEwtP1f3Xh4-?1@x)%} zxtSTiq1hKo@E%JWoQkt?WB6da^nHuqt(?kaO~SBqL_DqwVKDbh0W*Gc0(Z>O#s#Lu zEV5)_<&72xhF?#%{t+22oTuW*udYfK_vS3dp_5UddIZWizme!Yzs_YC9VLOD3%I~R z5#qo=;cg*$0mqy-A&KUH;T!GN>SCyA-F(p22v}PK>DL$bc|A&aI8*&tAUDmW{m=lpY(|= zOHySaXVvkKbR{Oy@aDtQhgF_ha17RVxv<1)D?D#aG-QXkVC89IwncM0C?*DiiGC;x zd~}daDK^4EAM?@9##5l=Fpza+N?_icr!WgQfhe=fa@4sv*goeGD39L-W)@%2gTXTF zj^#Gk^r-^!{=5Oh&Pf#Ro72t;6?MH}BHiM0aYsdlLaa4blF;o9GxY9c+j19YP z&rW`m!@a5fSjBxDsFY@7(aQn2Zb2m5`d6NHo{z(FB8|$cOM7rYgCUL{>`v?G1!$;J zpc#wKk@`N$efTgG9!PnC6OaR5GwaC2LlfBSADt|ipTRUIK879KU067CsP!w`PIk>^ z4*s)Jkrl-=rm6Xj_UQbgk|b@ssqz-aiYqzi5|MREdth-57jIw9-5Qq9&e$76?^QDvA-|j%T0Uh#Lv>h6 zYall5^MHP7J#}iSW802g#er8pqS#Thz;Wex8pjTxBFp(Swnqt7E6n0zBM^Mm8j50f z>qD-u4wtQA0bbFvs9|0cDVp?%Ye3^@M&5hWE4T>cmcQepb#IcM1tq-E8Aa6bW*luJ zIRxv=g7#nqDnB&?MSq!1>h2qnPehk))4haDPY#Dl)s-mw-6@C_uw#WfdZa2Vjeawg zp{3=2`At{)kncq`T7II04@uyW@`44_@bwpRTResO>^nsJQVyWzLl?MA6e4U@?y%A( z6$M`!N!EHtk;_p7sBG^Pus$6M3!mqsZDpTP-z81t(>omvNxz8XpNxf=R}xxXkj6Qr z#UqOhDZSn?4`MtVNZ`ObM6o3wE&ZiLkAF`f*A7*p&RJ2?-k-)?T&fk#_?;_VvNj*} zjMD%U%PVALt{Zx4JRQCctR-udd|-p$0yJ2y4c&?vMn{i4$5~j+<{Hjwp@0)AB%?$s z-uUV=E%~6wC&idR>pl^Q?3qjcoiIh()d{>fZY9$3(c~AsoGXq0wUC@YtjXVhG>tr- zY$TnjFpn%WSLTgrCl|P&Lz?b46^*Oy=S4^IxQ(`d#PxwsxQidE#JyKX@GfIak*1RVN$HgGMNB@ZA(M^8uCOepM z^96(k-X;<9Cs6vXRM4~V;2+NSqVh+MBZTZhVK#O)fNGDf^ ztsxJ&4pNlwO-!F_A%i=KAl+?5w|TrrQJ=!8Vzz|8sXCFUPp^i;A5q9;+9_(k=^*ub zFT>SMu?PF!6JT!AMT(ksqHWH@kVwfMdKTCVC_#@^1TUeXBttXuxNhp zwJ~(V)h-(BszYPt26Lv$6ToxAJW#P+jF*?@=YEKMnyO7r*Jz-Q zktYb~YJ#8RIMVUk9d*nsKpUPOCv|K8aG}F1h}NL}oR>j?Sgd^sH5l*baAyko;gTR$ z8GjCKJG_kx9BWT}7us@9A0-nL)m7-}2o>Vg<;olPT9W#c6ZvfldpXs>PCcSPb5|Fd6t+=V~0%y0*XSenHe zP#dLIdD9^U8{C{qGlGwDZA}uW_334+6WDN@QWFBGYMl0Hr>M|-M`QogBbQ=>qNG2!&iBt|@oU8}|tk|*Kdb(e5%v^9QcG?^)#j-qeI-e7IB zw_~%zk+i4z7>N)Z(jU6-A{B$lq`CMna=LPf*Q|Ua&7Rgx>Rw;sndg0CzNJ?BOrw)n zH01CfN)8|&?MS{P_6}-}O(GU+=b%jWL{1XF2h}_M$JtsJ@`YY^k>3wzq`W*w$W;~~ z*KhNQ{iZH1WMvbl6t;G*5RbJ!YHA zW=@bmn{*>eaOUXpP){26!3bN%pP{3xu2Td1R+_$W0=3W!qejzqLD1~sOnJgTSoqtK z*1c24*WRq8amwcO#zQ$gzUmzDy4FqmPN`C-u6TOPa1EB~4rO-UU*KcadV0Xn2j@K7 zM}@N{z8dt92G~ueN7kj#sx?co>Bt<~aBUsY-~SIBeC)8{E_D{3=u4cVTln3r@$h(6 zH+ia9PhEtbfyEScdMex!4tpc!I_C<_8$O3x{7}KIl?~*A_f-@p&!{L}A3~O$=Tzn; z@;{bsK!y8Ckfp*I^5Wq@^v<)EJpUHMO$sOxpS@p!sz)8-Tqk5AbEA{ual5V{#ey)d z-D0V*{yTG3-KWV3CqLv?r%5&s^yQUp?FdMx@e7KgxGl*UWR%Z%;yy174b_b#yE=8y zl7*%GA@6+t-_BFS?W74RI4Jn!tqOr1c)~xKkjRcVe1HJ~qglq*6U@@N3fe#D;I93* znRrhf^yYO!I6n((ZFXX7BpM;YlgP^oAPF(D{HmrffyH;T8LI#FRbzv<*jz7C~9M2Bjt!*bU=snjVzS z{PiDG+0R!XZ>S0O{{0Su)(&6?OU>}+Gn9&U*;aaeor+g&?xX+y9fHKWWAW{qbFp5- zT~2bv7VA}Mu?4Ra@yy}Z>5Vm-_~x;H&>eS)8-UV0taz33| zHigRFkEHi#0BCNgCDqD_&?M(X6sscnTFXQ9uh@wU^$VoSm3{fk(NWX^Fo{~C1Gm!X&d!H&KSIMGv#q&tIW&mX2uSn)R&|RzNLbPrdQFwI#8Rzdr z6}#8N^S}Yr=)qE2mv91ACsvZc139el;Z>UNc!Y8zQ!b=BCd2@*ToljEiQ%G)^KAUqV724e7>Ex-#*zLV?<%S{V_|s@J*1kECKKVTW zFWo9+uYYvVj;9EJ96kbX8g+~9pJrOAEyRI7B;Fw|cdw(Ghnwh}Gpg7yyBp2ukH+He zU&K((68ER4;)aqY2tF*FQLbdcdm%gY4dqbfm&u@?HIOOIv7D~L8=ASNLHAB|m)_`>|HQ_Vv^mV2WY|c1%TpDyp=!^HyO ze$*P4sV0Nb!KHZ5r000OR~7qmfC3yj3Qj@A%7 zzC;hlr1NC)UFoyZ$E0h1I*<03k@%xU(z5V-q&_y0$NRRRv^IafN^}(|PKhA7EmP3c zws1~zY7NT94qUSB3Eqdlih4iJMseDSL=<`)6%|bNLvzF}sW$FWHfhTm|*0Z?RgD^i^2NxYPW=30hFT$GxAuwHXB}koKO5XI~cl((N(QJ?Af4aL}M+m@@eL*-f{|^W*iR(vhTw; zXGB}uyO`*)n7Xo;5Zxz-sU;#6@yj*tEKC$TOG0KL6c>i0Lmtp<@ItUH+cx1>GX)oj<9iWE{3`F=sowBbnOc zZz$!`Tcq*+A^1$tA_kGIgt-=ylpH%YR4}wVuCIdd~ zCNGpzgO9As_XYJ#_T3e7v^hrg?!$~y&C*28}+#Tng* z27b-~tmJ}hw~V4iIZv_r%EwG)5Lnl^hvE%il(ABlkTF!8T{-cIJ&Qkb05)6{IBb3z z)*jxIE4TlN#*bVon91j{mFG20D#!ktz>fcp!Hwr+tuyv2LTB$j>(5}mVBQPY`n(E?s7;SN-YT!mS^&dLhO!(6dwQIJ&Rt}7P3-)tqi z=OmVR&9;*4j;#>w%M*+Ijl`nHD5>a4j97A6Un-hLtwb3YtwbnW`2Cqu$<<@h#&d@u z)nqg_u5qImW3wRe_ZkxSz6S8BmD1XIu588YZitiipj$#V$mNX(!^sl*Sn(;{(}I|h zmLB~cCCtIrd?H__48-aFlUVD4QNnC*B6u7+fhLvPLG}$<7!dUV^gd7FT_X-5gKO)N zYl9gK_V^CBPhX~Qc1NK?i%Fwz3*XiYO8FJ}Xf%Rovpi+dmSJ#y<`nyD2^fHsjN&Z~Q@zK09-XN8{o6q-( zW=LI)4vJl4vUtC>27GVcey;B50lxXZ9)}CdrLMcrNu5_`@c6+rE^tZ$7xAA1Jkbfn zO8@S&_{X7mbJ}f|TeE-#+na-?Qn2EiESf)E z0}95EWF-%N!(+Y8c*BX;@aE)E?DZ>#ORs#2Ep&#`!b|!%Gwv`{rzm5m(`%TGe-?

-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

ip&LHs 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%0Dh+qj2MN#FSJH{-h~H|q>{1isJAFHney3`4 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%0A_7>(judXdGaRrscw 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

!wlVvCZJUgbHT!QhZe1 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� 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 qd_Qfk{clJ1%X0Qj (scores == 0).sum() + model.masked_distances = () + model.clear_inference_cache() + # Evaluation-mode gradients; upstream's checkpoint keeps unused NBFNet parameters. + (score_queries(model, fixture["queries"], fixture["num_relations"]) * fixture["gradient_weights"]).sum().backward() + for parameter_name, parameter in model.named_parameters(): + expected = fixture["gradients"].get(parameter_name) + if expected is None: + assert parameter.grad is None, parameter_name + else: + torch.testing.assert_close(parameter.grad, expected, atol=2e-5, rtol=1e-4, + msg=lambda msg: parameter_name + ": " + msg) + + +def test_prompt_extraction_matches_upstream(): + fixture = torch.load(FIXTURES / "tiny.pt", weights_only=False) + sampler = PromptSampler(fixture["train"], fixture["num_entities"], fixture["num_relations"], + list(range(fixture["num_relations"]))) + checked = 0 + for relation, cases in fixture["cases"].items(): + for case in cases: + example = sampler.extract(*case["example"]) + entities = example.entities.tolist() + assert sorted(entities) == sorted(case["entities"]) + assert dict(zip(entities, example.labels.tolist())) == dict(zip(case["entities"], case["labels"])) + triples = {(entities[h], r, entities[t]) for h, r, t in example.triples.tolist()} + assert triples == set(case["triples"]) and len(triples) == len(example.triples) + assert example.self_loop == (case["example"][0] == case["example"][1]) + checked += 1 + assert checked > 40 and any(c["example"][0] == c["example"][1] for cases in fixture["cases"].values() for c in cases) + + +def test_prompt_sampling_is_seeded_and_order_independent(facts): + model = make_model(facts).eval() + other = make_model(facts).eval() + for relation in (0, 1, 2, 4, 5): + first = model.prompt_graphs(relation) + assert len(first) == 5 + again = other.prompt_graphs(relation) + for a, b in zip(first, again): + assert torch.equal(a.edge_index, b.edge_index) and torch.equal(a.labels, b.labels) + assert (a.head, a.tail) == (b.head, b.tail) + # Relation 0 has six facts: five distinct examples. Relation 1 has three: slots cycle. + assert len(model.sampler.examples(0)) == 5 and len(model.sampler.examples(1)) == 3 + slots = model.prompt_graphs(1) + assert slots[3] is not slots[0] and torch.equal(slots[3].edge_index, slots[0].edge_index) + # Inverse relations reuse the examples with swapped head and tail tokens. + assert [(g.head, g.tail) for g in model.prompt_graphs(4)] == [(1, 0) if not e.self_loop else (0, 0) + for e in [model.sampler.examples(1)[j % 3] for j in range(5)]] + seeded = make_model(facts, kgicl_prompt_seed=1).eval() + assert any(not torch.equal(a.entities, b.entities) for a, b in zip(model.sampler.examples(0), seeded.sampler.examples(0))) + queries = torch.tensor([[0, 0], [1, 1], [2, 2], [3, 0], [4, 1], [0, 2]]) + with torch.no_grad(): + expected = model(queries) + reversed_model = make_model(facts).eval() + reversed_model.load_state_dict(model.state_dict()) + actual = reversed_model(queries.flip(0)).flip(0) + reversed_model.query_batch_size = 1 + single = reversed_model(queries) + assert torch.equal(expected, actual) and torch.equal(expected, single) + + +def test_self_loop_example_puts_both_tokens_on_the_example_entity(): + model = KGICL(dict(num_entities=4, num_relations=1, **SMALL)).set_graph(torch.tensor([[0, 0, 0], [0, 0, 1], [1, 0, 2]])) + examples = model.sampler.examples(0) + loop = next(e for e in examples if e.self_loop) + assert loop.labels[0].tolist() == [0, 0] and loop.entities[0] == 0 + graphs = model.sampler.prompts(0, [next(i for i, e in enumerate(examples) if e is loop)]) + assert (graphs[0].head, graphs[0].tail) == (0, 0) + # Each self-loop fact appears once, with its inverse. + assert (graphs[0].edge_index[0] == graphs[0].edge_index[1]).sum() == 2 + + +def test_relation_without_facts_uses_upstream_fallback(facts): + model = KGICL(dict(num_entities=6, num_relations=4, **SMALL)).set_graph(facts).eval() + for relation, (head, tail) in ((3, (0, 1)), (7, (1, 0))): + graphs = model.prompt_graphs(relation) + assert len(graphs) == 5 and all(g is graphs[0] for g in graphs) + assert graphs[0].edge_index.tolist() == [[0], [1]] and graphs[0].edge_type.tolist() == [relation] + assert (graphs[0].head, graphs[0].tail) == (head, tail) + with torch.no_grad(): + assert torch.isfinite(model(torch.tensor([[0, 3]]))).all() + + +@pytest.mark.parametrize("seed", [0, 3]) +def test_scoring_interfaces_and_chunking(facts, seed): + model = make_model(facts, kgicl_prompt_seed=seed).eval() + queries, target = facts[:, :2], facts[:, 2:] + with torch.no_grad(): + all_scores = model(queries) + torch.testing.assert_close(model(facts), all_scores.gather(1, target).flatten()) + torch.testing.assert_close(model((queries, target)), all_scores.gather(1, target)) + torch.testing.assert_close(model(queries, torch.tensor([0, 1])), all_scores[:, :2]) + groups = facts[:, None].repeat(1, all_scores.shape[1], 1) + groups[..., 2] = torch.arange(all_scores.shape[1]) + torch.testing.assert_close(model(groups), all_scores) + torch.testing.assert_close(model(facts[[2, 1, 2, 0]]), model(facts)[[2, 1, 2, 0]]) + heads = model.forward_k_vs_all_heads(facts[:, 1:]) + assert torch.isfinite(all_scores).all() and torch.isfinite(heads).all() + assert model(torch.empty(0, 3, dtype=torch.long)).shape == (0,) + assert model(torch.empty(0, 2, dtype=torch.long)).shape == (0, all_scores.shape[1]) + # Entity 5 has no facts: it is never reached and scores exactly zero. + assert (all_scores[:, 5] == 0).all() + + +def test_reached_set_and_distance_mask(facts): + model = make_model(facts).eval() + with torch.no_grad(): + scores = model(torch.tensor([[0, 0]])) + _, depth = model._expand_scores(torch.tensor([0]), torch.tensor([0]), + model.encode_prompts(0)[None], (model.edge_index, model.edge_type)) + model.masked_distances = (0, 1) + model.clear_inference_cache() + masked = model(torch.tensor([[0, 0]])) + assert depth[0, 0] == 0 and depth[0, 5] == -1 and (depth[0, [1, 2, 3, 4]] == 1).all() + assert (masked[0, :5] == 0).all() and scores[0, :5].ne(0).all() + + +def test_graph_lifecycle_and_equivariance(facts, tmp_path): + model = make_model(facts).eval() + prompts = {q: model.prompt_graphs(q) for q in range(6)} + model.use_prompts(prompts) + with torch.no_grad(): + before = model(facts) + entities = torch.tensor([3, 5, 1, 0, 2, 4]) + permuted = torch.stack((entities[facts[:, 0]], facts[:, 1], entities[facts[:, 2]]), 1) + model.set_graph(permuted).use_prompts(prompts) + with torch.no_grad(): + torch.testing.assert_close(model(permuted), before, atol=1e-5, rtol=1e-4) + model.set_graph(facts) + assert not model._prompt_overrides + model.save_graph(tmp_path / "kgicl_graph.pt") + restored = make_model(facts).eval() + restored.load_state_dict(model.state_dict(), strict=True) + restored.load_graph(tmp_path / "kgicl_graph.pt") + with torch.no_grad(): + torch.testing.assert_close(restored(facts), model(facts)) + assert not any("edge_index" in key or "graph" in key or "relation_id_map" in key for key in model.state_dict()) + model.set_graph(torch.tensor([[7, 2, 6]]), num_entities=8, num_relations=3) + with torch.no_grad(): + assert torch.isfinite(model(torch.tensor([[7, 2, 5]]))).all() + with pytest.raises(ValueError, match="vocabulary"): + model.load_graph(tmp_path / "kgicl_graph.pt") + + +def test_inverse_mapping(facts): + model = make_model(facts).eval() + prompts = {q: model.prompt_graphs(q) for q in range(6)} + model.use_prompts(prompts) + with torch.no_grad(): + before, heads = model(facts), model.forward_k_vs_all_heads(facts[:, 1:]) + forward, inverse = facts.clone(), facts[:, [2, 1, 0]].clone() + forward[:, 1] *= 2 + inverse[:, 1] = inverse[:, 1] * 2 + 1 + model.set_graph(torch.cat((forward, inverse)), 6, 6, {0: 1, 2: 3, 4: 5}).use_prompts(prompts) + with torch.no_grad(): + torch.testing.assert_close(model(forward), before) + torch.testing.assert_close(model(inverse[:, :2]), heads) + # Prompt examples are seeded by the public direct relation ID. + assert model.sampler.public_relations == [0, 2, 4] + + +def test_training_masks_and_gradients(facts): + model = make_model(facts) + captured = [] + original = model._expand_scores + model._expand_scores = lambda *a: captured.append(a[3]) or original(*a) + scores = model(facts[:1, :2]) + index, types = captured[0] + kept = set(map(tuple, torch.stack((index[0], types, index[1]), 1).tolist())) + assert (0, 0, 1) not in kept and (1, 3, 0) not in kept and (0, 0, 2) not in kept + assert (1, 1, 2) in kept + scores.square().mean().backward() + assert all(torch.isfinite(p.grad).all() for p in model.parameters() if p.grad is not None) + assert model.relation_encoder.W_message[0].weight.grad.abs().sum() > 0 + assert model.gnn_layers[0].W_h.weight.grad.abs().sum() > 0 + + +def test_checkpoint_validation(facts, tmp_path): + model = make_model(facts) + state = model.state_dict() + path = tmp_path / "model_best.tar" + for wrapped in ("bare", "model", "state_dict"): + payload = state if wrapped == "bare" else {wrapped: state, "optimizer_state_dict": {}, "epoch_id": 3} + torch.save(payload, path) + model.load_pretrained(path) + for invalid in ({**state, "extra": torch.ones(1)}, dict(list(state.items())[1:]), KGICL({}).state_dict()): + torch.save({"state_dict": invalid}, path) + with pytest.raises(ValueError, match="architecture mismatch"): + model.load_pretrained(path) + + +def test_invalid_settings_and_ids(facts): + for args in ({"kgicl_dim": 0}, {"kgicl_shots": 0}, {"kgicl_query_batch_size": 0}, {"kgicl_prompt_seed": -1}, + {"kgicl_masked_distances": [-1]}, {"normalization": "LayerNorm"}, {"byte_pair_encoding": True}): + with pytest.raises(ValueError): + KGICL(args) + model = make_model(facts).eval() + for triples in (torch.tensor([[6, 0, 1]]), torch.tensor([[0, 3, 1]]), torch.tensor([[-1, 0, 1]])): + with pytest.raises(ValueError, match="vocabulary"): + model(triples) + with pytest.raises(ValueError): + model.use_prompts({0: []}) + + +@pytest.mark.skipif(not torch.cuda.is_available(), reason="CUDA is unavailable") +@pytest.mark.parametrize("deterministic", [False, True]) +def test_cuda_fused_path_matches_and_is_batch_invariant(facts, deterministic, monkeypatch): + pytest.importorskip("triton") + # PyTorch requires this for deterministic cuBLAS; the query benchmarks set it for the process. + monkeypatch.setenv("CUBLAS_WORKSPACE_CONFIG", ":4096:8") + model = KGICL(dict(num_entities=6, num_relations=3, kgicl_query_batch_size=4)).set_graph(facts).eval().requires_grad_(False) + queries = torch.cat((facts[:, :2], torch.tensor([[5, 0], [1, 2]]))) + with torch.no_grad(): + cpu, cpu_heads = model(queries), model.forward_k_vs_all_heads(queries[:, [1, 0]]) + model.cuda() + previous = torch.are_deterministic_algorithms_enabled() + try: + torch.use_deterministic_algorithms(deterministic) + for backend in ("torch", "triton"): + model.set_inference_backend(backend) + with torch.no_grad(): + batched = model(queries) + model.query_batch_size = 1 + single = model(queries) + reordered = model(queries.flip(0)).flip(0) + model.query_batch_size = 4 + heads = model.forward_k_vs_all_heads(queries[:, [1, 0]].cuda()) + torch.testing.assert_close(batched.cpu(), cpu, atol=2e-4, rtol=2e-4) + torch.testing.assert_close(heads.cpu(), cpu_heads, atol=2e-4, rtol=2e-4) + # Triton rows never use atomics; PyTorch's CUDA scatter needs deterministic algorithms. + if backend == "triton" or deterministic: + assert torch.equal(batched, single) and torch.equal(batched, reordered) + finally: + torch.use_deterministic_algorithms(previous) + + +@pytest.mark.parametrize("model_name,technique,grouped,trainer", [ + ("KGICL", "NegSample", False, "torchCPUTrainer"), + ("KGICL", "NegSample", True, "torchCPUTrainer"), + ("KGICL", "KvsAll", False, "torchCPUTrainer"), + ("KGICL", "1vsAll", False, "PL"), +]) +def test_execute_and_reload(tmp_path, model_name, technique, grouped, trainer): + from dicee.executer import Execute + from dicee.knowledge_graph_embeddings import KGE + dataset = tmp_path / "data" + dataset.mkdir() + (dataset / "train.txt").write_text("a r b\na r c\nb s c\nc r d\nd s a\nb r d\n") + (dataset / "valid.txt").write_text("a s d\n") + (dataset / "test.txt").write_text("d r b\n") + args = Namespace() + args.model = model_name + args.kgicl_dim, args.kgicl_attn_dim, args.kgicl_num_layers, args.kgicl_prompt_layers = 8, 3, 3, 2 + args.dataset_dir, args.path_to_store_single_run = str(dataset), str(tmp_path / "run") + args.num_epochs, args.batch_size, args.neg_ratio, args.lr = 1, 2, 2, 0.001 + args.scoring_technique, args.trainer = technique, trainer + args.backend, args.separator = "pandas", " " + args.strict_negative_sampling = grouped + args.adversarial_temperature = 1.0 if grouped else None + if trainer == "PL": + args.pl_trainer_kwargs = {"accelerator": "cpu", "devices": 1} + execute = Execute(args) + report = execute.start() + assert np.isfinite(report["Test"]["MRR"]) + restored = KGE(path=str(tmp_path / "run")) + triples = torch.tensor([[0, 0, 1]]) + with torch.no_grad(): + torch.testing.assert_close(restored.model(triples), execute.trained_model.eval()(triples)) + assert (tmp_path / "run" / "kgicl_graph.pt").is_file() + restored.predict_missing_head_entity("r", "b") + restored.predict_missing_tail_entity("a", "r") + + +def test_zero_epoch_official_checkpoint_format(tmp_path): + from dicee.executer import Execute + dataset = tmp_path / "data" + dataset.mkdir() + (dataset / "train.txt").write_text("a r b\nb s c\nc r a\na s c\n") + (dataset / "test.txt").write_text("a s b\n") + path = tmp_path / "model_best.tar" + pretrained = KGICL({}) + torch.save({"state_dict": pretrained.state_dict(), "optimizer_state_dict": {}, "epoch_id": 22}, path) + args = Namespace() + args.model, args.kgicl_checkpoint = "KGICL", str(path) + args.dataset_dir, args.path_to_store_single_run = str(dataset), str(tmp_path / "run") + args.num_epochs, args.batch_size = 0, 2 + args.scoring_technique, args.eval_model = "KvsAll", "test" + report = Execute(args).start() + state = torch.load(tmp_path / "run" / "model.pt", weights_only=True) + for key in state: + torch.testing.assert_close(state[key], pretrained.state_dict()[key]) + assert np.isfinite(report["Test"]["MRR"]) + assert json.loads((tmp_path / "run" / "configuration.json").read_text())["kgicl_dim"] == 32 From ce6cd64c3017ce8bcc42401fbe507df2ecdf5050 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 22:22:12 +0200 Subject: [PATCH 24/39] perf(models): entity-major fused KG-ICL kernels The Triton path keeps states entity-major, [entities, queries, dim]: one program aggregates an entity's incoming edges for a block of four queries whose source states are contiguous, and the attention's source term Ws_attn h is projected once per entity and layer instead of once per edge. GRU updates use 3xTF32 tensor-core dots where TF32 exists and IEEE FMA dots otherwise. Rows keep a fixed operation order without atomics, so they stay bitwise independent of the query batch; entities with more than 256 incoming edges are summed in ordered 64-edge partial sums. On an RTX 5070 Laptop GPU the FB15k-237 kernels take 0.93 ms per query in batches of 8, down from 4.5 ms. During inference the prompt encoder projects entity and relation tables before the per-edge gather, which bounds the memory of hub-sized prompt graphs, and prompt distances use boolean-mask BFS. prompt_identity() describes prompt sampling for persistent score caches. Tests cover hub rows, padded query blocks and the distance mask on CUDA, and rows that are bitwise independent of batching in the query evaluator. Gradient parity uses atol=1e-4, as official gradients reach about 450. --- dicee/models/_fused_kgicl.py | 78 +++++--- dicee/models/_triton_kgicl.py | 331 +++++++++++++++++++--------------- dicee/models/kgicl.py | 93 +++++++--- dicee/models/kgicl_prompts.py | 7 +- tests/test_kgicl.py | 54 +++++- 5 files changed, 365 insertions(+), 198 deletions(-) diff --git a/dicee/models/_fused_kgicl.py b/dicee/models/_fused_kgicl.py index 30755df80..065108a70 100644 --- a/dicee/models/_fused_kgicl.py +++ b/dicee/models/_fused_kgicl.py @@ -1,22 +1,25 @@ """Optional KG-ICL inference kernels; training and unsupported settings use PyTorch. -The fused path keeps a dense ``[batch, entities, dim]`` state with an active -mask. Messages leave only active entities, so its scores equal upstream's -hop-by-hop expansion. Triton is imported only on the CUDA path. +The fused path keeps a dense node-major ``[entities, batch, dim]`` state with an +active mask. Messages leave only active entities, so its scores equal +upstream's hop-by-hop expansion. Triton is imported only on the CUDA path. """ import torch from torch.nn import functional as F -from ._fused_message import csr_layout +from ._fused_message import CSRLayout from ._inference import to_device +ATTENTION = 16 # Padded attention width of the fused kernels. + def fused_reasoning_supported(model, edges): """Whether batched Triton reasoning applies; ``backend='triton'`` raises when it cannot.""" backend = getattr(model, '_inference_backend', 'auto') weight = model.W_final.weight supported = (edges[0] is model.edge_index and edges[1] is model.edge_type and weight.is_cuda - and weight.dtype == torch.float32 and model.dim <= 128 and model.attn_dim <= 16) + and weight.dtype == torch.float32 and model.dim <= 128 and model.attn_dim <= ATTENTION + and model.num_entities < 2**31 and model.edge_type.numel() < 2**31) if backend == 'torch' or not supported: if backend == 'triton' and not supported: raise RuntimeError('The triton KG-ICL backend requires float32 CUDA inference on the attached graph') @@ -30,29 +33,52 @@ def fused_reasoning_supported(model, edges): return True -def attention_width(model): - return max(2, 1 << (model.attn_dim - 1).bit_length()) - - def layer_tables(model, relation, prompt): """Per-layer relation states, their attention projections and the query term of one relation. Computed for a single relation at a time, so values never depend on which other relations share a query batch. """ - width = attention_width(model) rel, result = prompt, [] for i, layer in enumerate(model.gnn_layers): rel = model.layer_norms_rel[i](rel + F.relu(model.rel_transfer[i](rel))) - result.append((rel, F.pad(layer.Wr_attn(rel), (0, width - model.attn_dim)), - F.pad(layer.Wqr_attn(rel[relation]), (0, width - model.attn_dim)))) + result.append((rel, F.pad(layer.Wr_attn(rel), (0, ATTENTION - model.attn_dim)), + F.pad(layer.Wqr_attn(rel[relation]), (0, ATTENTION - model.attn_dim)))) rel = model.layer_norms_rel[i](rel) return result +def tile_layout(targets, sources, types, num_nodes, edges, hub_tiles): + """Edges grouped by target in ``edges``-wide tiles; rows with more than ``hub_tiles`` tiles are hubs. + + The same structure as ``csr_layout``, with 32-bit indices and a configurable tile width. + """ + order = targets.argsort(stable=True) + counts = torch.bincount(targets, minlength=num_nodes) + offsets = torch.cat((counts.new_zeros(1), counts.cumsum(0))) + tile_counts = (counts + edges - 1) // edges + tile_offsets = tile_counts.cumsum(0) - tile_counts + rows = torch.arange(num_nodes, device=counts.device).repeat_interleave(tile_counts) + starts = offsets[rows] + (torch.arange(len(rows), device=rows.device) - tile_offsets[rows]) * edges + hub = tile_counts > hub_tiles + hub_counts = torch.where(hub, tile_counts, 0) + return CSRLayout(*(tensor.to(torch.int32).contiguous() for tensor in ( + offsets, sources[order], types[order], rows, starts, rows[hub[rows]], starts[hub[rows]], + torch.where(hub, hub_counts.cumsum(0) - hub_counts, -1)))) + + +def destination_layout(model): + """Incoming edges of every entity in segments, cached until the graph changes.""" + from ._triton_kgicl import HUB_SEGMENTS, SEGMENT + if model._destination_layout is None: + model._destination_layout = tile_layout(model.edge_index[1], model.edge_index[0], model.edge_type, + model.num_entities, SEGMENT, HUB_SEGMENTS) + return model._destination_layout + + def fused_scores(model, heads, relations, ids, prompts, edges): """All-entity scores ``[B, N]`` and first-reach depths (or None) for a query batch.""" - from ._triton_kgicl import Workspace, aggregate, project, update + from ._triton_kgicl import Workspace, aggregate, update from .kgicl import RRELU_LOWER, RRELU_UPPER slope = (RRELU_LOWER + RRELU_UPPER) / 2 @@ -61,30 +87,24 @@ def fused_scores(model, heads, relations, ids, prompts, edges): position = {q: i for i, q in enumerate(unique)} tables = model._layer_tables(unique, prompts) query_index = to_device(torch.tensor([position[q] for q in ids], dtype=torch.int32), device) - if model._destination_edges is None: - model._destination_edges = model.edge_index.flip(0).contiguous() - layout = csr_layout(model._destination_edges, model.edge_type, nodes) - width = attention_width(model) - space = Workspace(batch, nodes, model.dim, width, device) + layout = destination_layout(model) + space = Workspace(nodes, batch, model.dim, model.attn_dim, device) rows = torch.arange(batch, device=device) - initial = torch.stack([prompts[q][q] for q in ids]) - space.states[0].index_put_((rows, heads), initial) - space.active[0].index_put_((rows, heads), torch.ones((), dtype=torch.int8, device=device)) - space.attention[0].index_put_((rows, heads), project(initial, model.gnn_layers[0].Ws_attn.weight, width)) + space.states[0].index_put_((heads, rows), torch.stack([prompts[q][q] for q in ids])) + space.active[0].index_put_((heads, rows), torch.ones((), dtype=torch.int8, device=device)) depth = None if model.masked_distances: - depth = torch.full((batch, nodes), -1, dtype=torch.int8, device=device) - depth.index_put_((rows, heads), torch.zeros((), dtype=torch.int8, device=device)) + depth = torch.full((nodes, batch), -1, dtype=torch.int8, device=device) + depth.index_put_((heads, rows), torch.zeros((), dtype=torch.int8, device=device)) current = 0 for i, layer in enumerate(model.gnn_layers): relation_states, attention_states, query_terms = tables[i] alpha = layer.w_alpha aggregate(space, current, relation_states, attention_states, query_terms, query_index, - F.pad(alpha.weight[0], (0, width - model.attn_dim)), alpha.bias, layout, slope) - last = i == len(model.gnn_layers) - 1 - update(space, current, layer, model.gate, model.layer_norms[i], - None if last else model.gnn_layers[i + 1].Ws_attn.weight, model.W_final, slope, i == 0, last) + F.pad(alpha.weight[0], (0, ATTENTION - model.attn_dim)), alpha.bias, layer.Ws_attn.weight, layout, slope) + update(space, current, layer, model.gate, model.layer_norms[i], model.W_final, slope, i == 0, + i == len(model.gnn_layers) - 1) if depth is not None: depth.masked_fill_((space.active[1 - current] != 0) & (space.active[current] == 0), i + 1) current = 1 - current - return space.scores, depth + return space.scores.T.contiguous(), None if depth is None else depth.T.contiguous() diff --git a/dicee/models/_triton_kgicl.py b/dicee/models/_triton_kgicl.py index 4fbe2b0ac..43dbaa81a 100644 --- a/dicee/models/_triton_kgicl.py +++ b/dicee/models/_triton_kgicl.py @@ -1,90 +1,148 @@ """Fused KG-ICL reasoning: attention-weighted CSR aggregation and GRU node updates. -Every (query, entity) row is computed by a fixed sequence of operations with -no atomics, so rows are deterministic and independent of the query batch. +States are node-major, ``[entities, queries, dim]``: one program aggregates the +incoming edges of one entity for a fixed block of queries, whose source states +are contiguous. The source term ``Ws_attn h`` of the attention is projected +once per node and layer rather than once per edge. Every (entity, query) row is +computed by a fixed sequence of operations with no atomics, so rows are +deterministic and independent of the query batch: blocks always hold +``QUERIES`` lanes, padded when the batch is smaller, and high in-degree rows +are split into partial sums that are added in order. """ import torch import triton import triton.language as tl from triton.language.extra import libdevice -EDGES = 32 +EDGES = 4 # Edges per chunk; lane j accumulates edges j, j + EDGES, ... of a row in order. +QUERIES = 4 # Queries per aggregation program. +WARPS = 1 # Warps per aggregation program: many small programs hide the gather latency. +SEGMENT = 64 # Edges per partial sum of a hub row. +HUB_SEGMENTS = 4 # Rows with more segments are hubs, split across programs. +ATTENTION = tl.constexpr(16) # Row width of the padded attention tables. @triton.jit -def _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, edge, end, base, table, qc, wa, ba, feature, attention, - D: tl.constexpr, AP: tl.constexpr, SLOPE: tl.constexpr): - # One chunk of incoming edges: sigmoid query-aware attention times (h_source + r). - inside = edge < end - source = tl.load(SRC + edge, inside, other=0) - relation = tl.load(TYPE + edge, inside, other=0) - valid = inside & (tl.load(ACT + base + source, inside, other=0) != 0) - rows = (base + source)[:, None] - pre = (tl.load(AS + rows * AP + attention[None, :], valid[:, None], other=0) - + tl.load(ATBL + (table + relation)[:, None] * AP + attention[None, :], valid[:, None], other=0) - + qc[None, :]) +def _alpha(projected, table, query_term, weight, bias, valid, SLOPE: tl.constexpr): + # sigmoid(w_alpha . rrelu(Ws h + Wr r + Wqr q) + b_alpha) over the last axis; padded lanes are zero. + pre = projected + table + query_term pre = tl.where(pre >= 0, pre, pre * SLOPE) - alpha = tl.sigmoid(tl.sum(pre * wa[None, :], axis=1) + ba) - alpha = tl.where(valid, alpha, 0.) - mask = valid[:, None] & (feature[None, :] < D) - state = tl.load(H + rows * D + feature[None, :], mask, other=0) - rel = tl.load(TBL + (table + relation)[:, None] * D + feature[None, :], mask, other=0) - return tl.sum(alpha[:, None] * (state + rel), axis=0), tl.max(valid.to(tl.int32), axis=0) + return tl.where(valid, tl.sigmoid(tl.sum(pre * weight, axis=-1) + bias), 0.) @triton.jit -def _tile_partials(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, P, PR, PTR, SRC, TYPE, ROWS, STARTS, TILES, - N: tl.constexpr, D: tl.constexpr, RS: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, - EDGES: tl.constexpr, SLOPE: tl.constexpr): - # One program per 32-edge tile of a high in-degree row; the row program adds them in order. - tile, batch = tl.program_id(0), tl.program_id(1).to(tl.int64) - row = tl.load(ROWS + tile) - end = tl.load(PTR + row + 1) - edge = tl.load(STARTS + tile) + tl.arange(0, EDGES) - feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) - qi = tl.load(QIDX + batch).to(tl.int64) - qc = tl.load(QC + qi * AP + attention) - total, reach = _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, edge, end, batch * N, qi * RS, qc, tl.load(WA + attention), - tl.load(BA), feature, attention, D, AP, SLOPE) - tl.store(P + (batch * TILES + tile) * D + feature, total, feature < D) - tl.store(PR + batch * TILES + tile, reach) +def _queries(QIDX, QC, WA, B, A: tl.constexpr, AW: tl.constexpr, QUERIES: tl.constexpr): + # The query block of this program: ids, mask, relation slots, attention query terms and w_alpha. + queries = tl.program_id(1) * QUERIES + tl.arange(0, QUERIES) + query_mask = queries < B + lane = tl.arange(0, AW) + qi = tl.load(QIDX + queries, query_mask, other=0).to(tl.int64) + query_term = tl.load(QC + qi[:, None] * ATTENTION + lane[None, :], (lane < A)[None, :], other=0) + return queries, query_mask, qi, query_term, tl.load(WA + lane, lane < A, other=0) @triton.jit -def _aggregate(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, AGG, NEW, PTR, SRC, TYPE, FIRST, P, PR, TILES, - N: tl.constexpr, D: tl.constexpr, RS: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, - EDGES: tl.constexpr, SLOPE: tl.constexpr): - row, batch = tl.program_id(0).to(tl.int64), tl.program_id(1).to(tl.int64) - feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) - qi = tl.load(QIDX + batch).to(tl.int64) - qc, wa, ba = tl.load(QC + qi * AP + attention), tl.load(WA + attention), tl.load(BA) +def _segment(H, AS, ACT, TBL, ATBL, SRC, TYPE, start, end, queries, query_mask, qi, query_term, weight, bias, + B, D: tl.constexpr, A: tl.constexpr, AW: tl.constexpr, RS, FEATURES: tl.constexpr, + EDGES: tl.constexpr, QUERIES: tl.constexpr, SLOPE: tl.constexpr): + # Sum of alpha * (h_source + r) over edges [start, end) for a query block, and which queries an edge reaches. + feature = tl.arange(0, FEATURES) + lane = tl.arange(0, AW) + lanes = tl.zeros((EDGES, QUERIES, FEATURES), tl.float32) + reach = tl.zeros((QUERIES,), tl.int32) + for chunk in range(start, end, EDGES): + edge = chunk + tl.arange(0, EDGES) + inside = edge < end + source = tl.load(SRC + edge, inside, other=0).to(tl.int64) + pair = source[:, None] * B + queries[None, :] + present = inside[:, None] & query_mask[None, :] + valid = present & (tl.load(ACT + pair, present, other=0) != 0) + hits = tl.max(valid.to(tl.int32), axis=0) + # Chunks without an active source contribute nothing; skip them. + if tl.max(hits, axis=0) != 0: + slot = qi[None, :] * RS + tl.load(TYPE + edge, inside, other=0).to(tl.int64)[:, None] + attention = valid[:, :, None] & (lane < A)[None, None, :] + projected = tl.load(AS + pair[:, :, None] * AW + lane[None, None, :], attention, other=0) + table = tl.load(ATBL + slot[:, :, None] * ATTENTION + lane[None, None, :], attention, other=0) + alpha = _alpha(projected, table, query_term[None, :, :], weight[None, None, :], bias, valid, SLOPE) + mask = valid[:, :, None] & (feature < D)[None, None, :] + state = tl.load(H + pair[:, :, None] * D + feature[None, None, :], mask, other=0) + rel = tl.load(TBL + slot[:, :, None] * D + feature[None, None, :], mask, other=0) + lanes += alpha[:, :, None] * (state + rel) + reach = tl.maximum(reach, hits) + return tl.sum(lanes, axis=0), reach + + +@triton.jit +def _project(H, ACT, WS, AS, TOTAL, D: tl.constexpr, A: tl.constexpr, AW: tl.constexpr, FEATURES: tl.constexpr, + ROWS: tl.constexpr, PRECISION: tl.constexpr): + # Attention source terms Ws_attn h of active rows; rows that are inactive are never read. + rows = tl.program_id(0).to(tl.int64) * ROWS + tl.arange(0, ROWS) + inside = rows < TOTAL + active = inside & (tl.load(ACT + rows, inside, other=0) != 0) + if tl.max(active.to(tl.int32), axis=0) == 0: + return + feature = tl.arange(0, FEATURES) + lane = tl.arange(0, ATTENTION) + x = tl.load(H + rows[:, None] * D + feature[None, :], active[:, None] & (feature < D)[None, :], other=0) + weight = tl.load(WS + lane[None, :] * D + feature[:, None], (feature < D)[:, None] & (lane < A)[None, :], other=0) + projected = tl.dot(x, weight, input_precision=PRECISION) + tl.store(AS + rows[:, None] * AW + lane[None, :], projected, inside[:, None] & (lane < AW)[None, :]) + + +@triton.jit +def _hub_partials(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, P, PR, PTR, SRC, TYPE, SEGMENT_ROWS, SEGMENT_STARTS, + B, D: tl.constexpr, A: tl.constexpr, AW: tl.constexpr, RS, FEATURES: tl.constexpr, + EDGES: tl.constexpr, QUERIES: tl.constexpr, SEGMENT: tl.constexpr, SLOPE: tl.constexpr): + # One program per segment of a hub row and query block; the row program adds the segments in order. + segment = tl.program_id(0) + queries, query_mask, qi, query_term, weight = _queries(QIDX, QC, WA, B, A, AW, QUERIES) + row = tl.load(SEGMENT_ROWS + segment) + start = tl.load(SEGMENT_STARTS + segment) + end = tl.minimum(start + SEGMENT, tl.load(PTR + row + 1)) + total, reach = _segment(H, AS, ACT, TBL, ATBL, SRC, TYPE, start, end, queries, query_mask, qi, query_term, weight, + tl.load(BA), B, D, A, AW, RS, FEATURES, EDGES, QUERIES, SLOPE) + feature = tl.arange(0, FEATURES) + rows = segment.to(tl.int64) * B + queries + tl.store(P + rows[:, None] * D + feature[None, :], total, query_mask[:, None] & (feature < D)[None, :]) + tl.store(PR + rows, reach, query_mask) + + +@triton.jit +def _aggregate(H, AS, ACT, TBL, ATBL, QC, QIDX, WA, BA, AGG, NEW, PTR, SRC, TYPE, FIRST, P, PR, + B, D: tl.constexpr, A: tl.constexpr, AW: tl.constexpr, RS, FEATURES: tl.constexpr, + EDGES: tl.constexpr, QUERIES: tl.constexpr, SEGMENT: tl.constexpr, SLOPE: tl.constexpr): + row = tl.program_id(0).to(tl.int64) + queries, query_mask, qi, query_term, weight = _queries(QIDX, QC, WA, B, A, AW, QUERIES) + bias = tl.load(BA) + feature = tl.arange(0, FEATURES) start, end = tl.load(PTR + row), tl.load(PTR + row + 1) first = tl.load(FIRST + row) - total = tl.zeros((FEATURES,), tl.float32) - reach = tl.zeros((), tl.int32) if first < 0: - for chunk in range(start, end, EDGES): - value, hit = _chunk(H, AS, ACT, TBL, ATBL, SRC, TYPE, chunk + tl.arange(0, EDGES), end, batch * N, qi * RS, - qc, wa, ba, feature, attention, D, AP, SLOPE) - total += value - reach = tl.maximum(reach, hit) + total, reach = _segment(H, AS, ACT, TBL, ATBL, SRC, TYPE, start, end, queries, query_mask, qi, query_term, weight, + bias, B, D, A, AW, RS, FEATURES, EDGES, QUERIES, SLOPE) else: - count = (end - start + EDGES - 1) // EDGES - for block in range(0, count): - total += tl.load(P + (batch * TILES + first + block) * D + feature, feature < D, other=0) - reach = tl.maximum(reach, tl.load(PR + batch * TILES + first + block)) - current = batch * N + row - active = tl.load(ACT + current) - if active != 0: - # The implicit self-loop edge with relation slot RS - 1. - pre = tl.load(AS + current * AP + attention) + tl.load(ATBL + (qi * RS + RS - 1) * AP + attention) + qc - pre = tl.where(pre >= 0, pre, pre * SLOPE) - alpha = tl.sigmoid(tl.sum(pre * wa, axis=0) + ba) - state = tl.load(H + current * D + feature, feature < D, other=0) - rel = tl.load(TBL + (qi * RS + RS - 1) * D + feature, feature < D, other=0) - total += alpha * (state + rel) - tl.store(AGG + current * D + feature, total, feature < D) - tl.store(NEW + current, ((active != 0) | (reach != 0)).to(tl.int8)) + total = tl.zeros((QUERIES, FEATURES), tl.float32) + reach = tl.zeros((QUERIES,), tl.int32) + for segment in range(0, (end - start + SEGMENT - 1) // SEGMENT): + rows = (first + segment).to(tl.int64) * B + queries + total += tl.load(P + rows[:, None] * D + feature[None, :], query_mask[:, None] & (feature < D)[None, :], other=0) + reach = tl.maximum(reach, tl.load(PR + rows, query_mask, other=0)) + current = row * B + queries + active = query_mask & (tl.load(ACT + current, query_mask, other=0) != 0) + # The implicit self-loop edge with relation slot RS - 1. + slot = qi * RS + RS - 1 + lane = tl.arange(0, AW) + attention = active[:, None] & (lane < A)[None, :] + projected = tl.load(AS + current[:, None] * AW + lane[None, :], attention, other=0) + table = tl.load(ATBL + slot[:, None] * ATTENTION + lane[None, :], attention, other=0) + alpha = _alpha(projected, table, query_term, weight[None, :], bias, active, SLOPE) + mask = active[:, None] & (feature < D)[None, :] + state = tl.load(H + current[:, None] * D + feature[None, :], mask, other=0) + rel = tl.load(TBL + slot[:, None] * D + feature[None, :], mask, other=0) + total += alpha[:, None] * (state + rel) + tl.store(AGG + current[:, None] * D + feature[None, :], total, query_mask[:, None] & (feature < D)[None, :]) + tl.store(NEW + current, (active | (reach != 0)).to(tl.int8), query_mask) @triton.jit @@ -94,30 +152,33 @@ def _matrix(W, rows, columns, R: tl.constexpr, C: tl.constexpr): @triton.jit -def _gate(x, W, B, index: tl.constexpr, feature, D: tl.constexpr): +def _gate(x, W, B, index: tl.constexpr, feature, D: tl.constexpr, PRECISION: tl.constexpr): # One GRU gate block: x @ W[index * D:(index + 1) * D].T + b[index * D:(index + 1) * D]. - value = tl.dot(x, _matrix(W + index * D * D, feature, feature, D, D), input_precision="ieee") + value = tl.dot(x, _matrix(W + index * D * D, feature, feature, D, D), input_precision=PRECISION) return value + tl.load(B + index * D + feature, feature < D, other=0)[None, :] @triton.jit -def _update(AGG, H, NEW, OUT, AS, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WS, WF, TOTAL, - D: tl.constexpr, A: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr, ROWS: tl.constexpr, - EPS: tl.constexpr, SLOPE: tl.constexpr, FIRST: tl.constexpr, LAST: tl.constexpr): +def _update(AGG, H, NEW, OUT, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WF, TOTAL, + D: tl.constexpr, FEATURES: tl.constexpr, ROWS: tl.constexpr, EPS: tl.constexpr, SLOPE: tl.constexpr, + FIRST: tl.constexpr, LAST: tl.constexpr, PRECISION: tl.constexpr): # RReLU(W_h agg) -> LayerNorm -> GRU cell with the previous state; inactive rows stay zero. # The first layer's GRU state is zero: the query embedding at the head is only a message input. rows = tl.program_id(0).to(tl.int64) * ROWS + tl.arange(0, ROWS) - feature = tl.arange(0, FEATURES) inside = rows < TOTAL + active = tl.load(NEW + rows, inside, other=0) != 0 + # Active sets only grow, so an inactive row's outputs are already zero. + if tl.max(active.to(tl.int32), axis=0) == 0: + return + feature = tl.arange(0, FEATURES) mask = inside[:, None] & (feature[None, :] < D) offsets = rows[:, None] * D + feature[None, :] - x = tl.load(AGG + offsets, mask, other=0) + x = tl.load(AGG + offsets, mask & active[:, None], other=0) if FIRST: previous = tl.zeros((ROWS, FEATURES), tl.float32) else: previous = tl.load(H + offsets, mask, other=0) - active = tl.load(NEW + rows, inside, other=0) != 0 - y = tl.dot(x, _matrix(WH, feature, feature, D, D), input_precision="ieee") + y = tl.dot(x, _matrix(WH, feature, feature, D, D), input_precision=PRECISION) y = tl.where(y >= 0, y, y * SLOPE) y = tl.where(feature[None, :] < D, y, 0.) mean = tl.sum(y, axis=1) / D @@ -126,9 +187,10 @@ def _update(AGG, H, NEW, OUT, AS, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WS, W norm_weight = tl.load(LNW + feature, feature < D, other=0) norm_bias = tl.load(LNB + feature, feature < D, other=0) y = centered * tl.rsqrt(variance + EPS)[:, None] * norm_weight[None, :] + norm_bias[None, :] - reset = tl.sigmoid(_gate(y, WIH, BIH, 0, feature, D) + _gate(previous, WHH, BHH, 0, feature, D)) - update = tl.sigmoid(_gate(y, WIH, BIH, 1, feature, D) + _gate(previous, WHH, BHH, 1, feature, D)) - candidate = libdevice.tanh(_gate(y, WIH, BIH, 2, feature, D) + reset * _gate(previous, WHH, BHH, 2, feature, D)) + reset = tl.sigmoid(_gate(y, WIH, BIH, 0, feature, D, PRECISION) + _gate(previous, WHH, BHH, 0, feature, D, PRECISION)) + update = tl.sigmoid(_gate(y, WIH, BIH, 1, feature, D, PRECISION) + _gate(previous, WHH, BHH, 1, feature, D, PRECISION)) + candidate = libdevice.tanh(_gate(y, WIH, BIH, 2, feature, D, PRECISION) + + reset * _gate(previous, WHH, BHH, 2, feature, D, PRECISION)) state = (1 - update) * candidate + update * previous state = tl.where(active[:, None] & (feature[None, :] < D), state, 0.) if LAST: @@ -136,71 +198,56 @@ def _update(AGG, H, NEW, OUT, AS, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WS, W tl.store(SCORE + rows, tl.sum(state * weight[None, :], axis=1), inside) else: tl.store(OUT + offsets, state, mask) - attention = tl.arange(0, AP) - projection = tl.load(WS + attention[:, None] * D + feature[None, :], - (attention[:, None] < A) & (feature[None, :] < D), other=0) - values = tl.sum(state[:, None, :] * projection[None, :, :], axis=2) - tl.store(AS + rows[:, None] * AP + attention[None, :], values, inside[:, None]) - - -@triton.jit -def _project(X, W, OUT, TOTAL, D: tl.constexpr, A: tl.constexpr, AP: tl.constexpr, FEATURES: tl.constexpr): - # Attention projection of single rows, with the reduction used by _update. - row = tl.program_id(0) - feature, attention = tl.arange(0, FEATURES), tl.arange(0, AP) - state = tl.load(X + row * D + feature, feature < D, other=0) - projection = tl.load(W + attention[:, None] * D + feature[None, :], (attention[:, None] < A) & (feature[None, :] < D), other=0) - values = tl.sum(state[None, :] * projection, axis=1) - tl.store(OUT + row * AP + attention, values) class Workspace: - """Per-call activation buffers for one query batch.""" - - def __init__(self, batch, nodes, dim, ap, device): - self.states = [torch.zeros(batch, nodes, dim, device=device) for _ in range(2)] - self.attention = [torch.zeros(batch, nodes, ap, device=device) for _ in range(2)] - self.active = [torch.zeros(batch, nodes, dtype=torch.int8, device=device) for _ in range(2)] - self.aggregate = torch.empty(batch, nodes, dim, device=device) - self.scores = torch.empty(batch, nodes, device=device) - - -def project(rows, weight, ap): - output = rows.new_zeros(len(rows), ap) - if len(rows): - _project[(len(rows),)](rows, weight, output, len(rows), rows.shape[-1], weight.shape[0], ap, - max(16, triton.next_power_of_2(rows.shape[-1])), num_warps=1, enable_fp_fusion=False) - return output - - -def aggregate(space, current, tables, attention_tables, query_constants, query_index, alpha_weight, alpha_bias, layout, slope): - batch, nodes, dim = space.states[current].shape - ap = space.attention[current].shape[-1] - relation_slots = tables.shape[1] - features = max(16, triton.next_power_of_2(dim)) - edges = (layout.offsets, layout.sources, layout.types) - hubs = len(layout.hub_rows) - partials = torch.empty((batch, max(hubs, 1), dim), device=tables.device) - flags = torch.empty((batch, max(hubs, 1)), dtype=torch.int32, device=tables.device) - common = (space.states[current], space.attention[current], space.active[current], tables, attention_tables, - query_constants, query_index, alpha_weight, alpha_bias) - if hubs: - _tile_partials[(hubs, batch)](*common, partials, flags, *edges, layout.hub_rows, layout.hub_starts, hubs, - nodes, dim, relation_slots, ap, features, EDGES, slope, num_warps=4, enable_fp_fusion=False) - _aggregate[(nodes, batch)](*common, space.aggregate, space.active[1 - current], *edges, layout.hub_first, partials, flags, - max(hubs, 1), nodes, dim, relation_slots, ap, features, EDGES, slope, - num_warps=4, enable_fp_fusion=False) - - -def update(space, current, layer, gate, norm, next_projection, final, slope, first, last): - batch, nodes, dim = space.states[current].shape - ap = space.attention[current].shape[-1] - total = batch * nodes - rows = 32 - projection = next_projection if next_projection is not None else final.weight - _update[(triton.cdiv(total, rows),)]( - space.aggregate, space.states[current], space.active[1 - current], space.states[1 - current], space.attention[1 - current], - space.scores, layer.W_h.weight, norm.weight, norm.bias, gate.weight_ih_l0, gate.weight_hh_l0, gate.bias_ih_l0, - gate.bias_hh_l0, projection, final.weight, total, dim, - next_projection.shape[0] if next_projection is not None else 1, ap, - max(16, triton.next_power_of_2(dim)), rows, norm.eps, slope, first, last, num_warps=4, enable_fp_fusion=False) + """Node-major activation buffers of one query batch; outputs of inactive rows stay zero. + + Dense products use 3xTF32 tensor-core dots where available: float32-level + accuracy, and like IEEE FMA dots a fixed per-row operation order. + """ + + def __init__(self, nodes, batch, dim, attention, device): + self.states = [torch.zeros(nodes, batch, dim, device=device) for _ in range(2)] + self.active = [torch.zeros(nodes, batch, dtype=torch.int8, device=device) for _ in range(2)] + self.projected = torch.empty(nodes, batch, max(2, triton.next_power_of_2(attention)), device=device) + self.aggregate = torch.empty(nodes, batch, dim, device=device) + self.scores = torch.zeros(nodes, batch, device=device) + tensor_cores = torch.cuda.get_device_capability(device) >= (8, 0) + self.precision, self.rows = ('tf32x3', 64) if tensor_cores else ('ieee', 32) + + +def _features(dim): + return max(16, triton.next_power_of_2(dim)) + + +def aggregate(space, current, tables, attention_tables, query_constants, query_index, alpha_weight, alpha_bias, + projection, layout, slope): + nodes, batch, dim = space.states[current].shape + attention, width = projection.shape[0], space.projected.shape[-1] + total = nodes * batch + _project[(triton.cdiv(total, space.rows),)](space.states[current], space.active[current], projection, space.projected, + total, dim, attention, width, _features(dim), space.rows, space.precision, + num_warps=4, enable_fp_fusion=False) + shapes = (batch, dim, attention, width, tables.shape[1], _features(dim), EDGES, QUERIES, SEGMENT, slope) + common = (space.states[current], space.projected, space.active[current], tables, attention_tables, query_constants, + query_index, alpha_weight, alpha_bias) + blocks = triton.cdiv(batch, QUERIES) + segments = len(layout.hub_rows) + partials = torch.empty((max(segments, 1), batch, dim), device=tables.device) + reached = torch.empty((max(segments, 1), batch), dtype=torch.int32, device=tables.device) + if segments: + _hub_partials[(segments, blocks)](*common, partials, reached, layout.offsets, layout.sources, layout.types, + layout.hub_rows, layout.hub_starts, *shapes, num_warps=WARPS, enable_fp_fusion=False) + _aggregate[(nodes, blocks)](*common, space.aggregate, space.active[1 - current], layout.offsets, layout.sources, + layout.types, layout.hub_first, partials, reached, *shapes, num_warps=WARPS, enable_fp_fusion=False) + + +def update(space, current, layer, gate, norm, final, slope, first, last): + nodes, batch, dim = space.states[current].shape + total = nodes * batch + _update[(triton.cdiv(total, space.rows),)]( + space.aggregate, space.states[current], space.active[1 - current], space.states[1 - current], space.scores, + layer.W_h.weight, norm.weight, norm.bias, gate.weight_ih_l0, gate.weight_hh_l0, gate.bias_ih_l0, + gate.bias_hh_l0, final.weight, total, dim, _features(dim), space.rows, norm.eps, slope, first, last, + space.precision, num_warps=4, enable_fp_fusion=False) diff --git a/dicee/models/kgicl.py b/dicee/models/kgicl.py index 8905ccf2b..234053f2f 100644 --- a/dicee/models/kgicl.py +++ b/dicee/models/kgicl.py @@ -8,14 +8,15 @@ context derived from the attached graph (see kgicl_prompts.py), never part of the transferable state. docs/kgicl.md documents the corrected upstream defects. """ +import hashlib from collections import OrderedDict -from typing import Optional, Sequence +from typing import Optional, Sequence, cast import torch from torch import nn from torch.nn import functional as F -from ._fused_kgicl import attention_width, fused_reasoning_supported, fused_scores, layer_tables +from ._fused_kgicl import ATTENTION, fused_reasoning_supported, fused_scores, layer_tables from ._inference import candidate_features, candidate_slice, host_ids, inference_only from .graph_model import GraphKGE from .kgicl_prompts import PromptGraph, PromptSampler @@ -25,6 +26,18 @@ RRELU_LOWER, RRELU_UPPER = 1. / 8, 1. / 3 +def _split_linear(linear, *parts: tuple[torch.Tensor, torch.Tensor]) -> torch.Tensor: + """``linear(cat([table[index] for table, index in parts], -1))`` without the concatenation. + + Each table is projected by its block of the weight before the per-edge gather. + """ + dim = parts[0][0].shape[-1] + value = F.linear(parts[0][0], linear.weight[:, :dim])[parts[0][1]] + for k, (table, index) in enumerate(parts[1:], 1): + value = value.add_(F.linear(table, linear.weight[:, k * dim:(k + 1) * dim])[index]) + return value.add_(linear.bias) + + class PromptEncoder(nn.Module): """Upstream ``PromptEncoder`` with the released configuration. @@ -91,15 +104,27 @@ def forward(self, graphs: Sequence[PromptGraph], relation: int, num_relations: i norm = (inverse_sqrt[target] * inverse_sqrt[source])[:, None] layers = [] for i in range(self.num_layers): - r, q = rel[edge_type], rel[edge_query] - h = node[source] - message = self.act(self.W_message[i](torch.cat((h, r, q), -1))) - alpha = torch.sigmoid(self.alpha[i](self.act(torch.cat((r, q), -1)))) - message = message * alpha * norm * norm + if self.training: + # RReLU samples a slope per element, so training keeps upstream's per-edge inputs. + r, q = rel[edge_type], rel[edge_query] + message = self.act(self.W_message[i](torch.cat((node[source], r, q), -1))) + alpha = torch.sigmoid(self.alpha[i](self.act(torch.cat((r, q), -1)))) + message = message * alpha * norm * norm + else: + # Project entity and relation tables before gathering them per edge; this + # avoids [edges, 3 * dim] inputs for the hub-sized prompt graphs of large KGs. + message = self.act(_split_linear(self.W_message[i], (node, source), (rel, edge_type), (rel, edge_query))) + active = self.act(rel) + alpha = torch.sigmoid(_split_linear(self.alpha[i], (active, edge_type), (active, edge_query))) + message = message.mul_(alpha).mul_(norm).mul_(norm) node = self.act(self.ent_transfer[i](self._max(message, target, num_nodes))) node = self.layer_norm_ents[i](node) - message = self.act(self.W_ht2r[i](torch.cat((node[source], node[target], q), -1))) - message = message * torch.sigmoid(self.beta[i](torch.cat((r, q), -1))) + if self.training: + message = self.act(self.W_ht2r[i](torch.cat((node[source], node[target], q), -1))) + message = message * torch.sigmoid(self.beta[i](torch.cat((r, q), -1))) + else: + message = self.act(_split_linear(self.W_ht2r[i], (node, source), (node, target), (rel, edge_query))) + message = message.mul_(torch.sigmoid(_split_linear(self.beta[i], (rel, edge_type), (rel, edge_query)))) rel = self.act(self.rel_transfer[i](self._max(message, edge_type, len(rel)))) + rel rel = self.layer_norm_rels[i](rel) layers.append(rel) @@ -192,11 +217,12 @@ def __init__(self, args): self.dropout = nn.Dropout(args.get('kgicl_dropout', 0.0)) self.W_final = nn.Linear(self.dim, 1, bias=False) self.gate = nn.GRU(self.dim, self.dim) - self.prompt_cache_mb = args.get('graph_relation_cache_mb', 64) - self.table_cache_mb = args.get('graph_projection_cache_mb', 64) - if min(self.prompt_cache_mb, self.table_cache_mb) < 0: + # Prompt encodings and the fused path's per-layer relation tables, like ULTRA's caches. + self.relation_cache_mb = args.get('graph_relation_cache_mb', 64) + self.projection_cache_mb = args.get('graph_projection_cache_mb', 64) + if min(self.relation_cache_mb, self.projection_cache_mb) < 0: raise ValueError('Graph cache limits must be nonnegative') - self._prompt_overrides = {} + self._prompt_overrides: dict[int, list[PromptGraph]] = {} self._sampler: Optional[PromptSampler] = None self.set_inference_backend(args.get('graph_inference_backend', 'auto')) @@ -220,7 +246,7 @@ def clear_inference_cache(self): self._table_cache = OrderedDict() self._table_cache_token = None self._layout = None - self._destination_edges = None + self._destination_layout = None def _build_relation_graph(self): # KG-ICL samples prompt graphs lazily; no relation graph is constructed. @@ -237,6 +263,28 @@ def inference_token(self): token = super().inference_token() return None if token is None else (*token, self.prompt_settings()) + def prompt_identity(self) -> dict: + """Stable description of prompt sampling for persistent score caches. + + Replayed prompts are identified by a digest of their tensors. + """ + digest = None + if self._prompt_overrides: + content = hashlib.sha256() + for relation in sorted(self._prompt_overrides): + for graph in self._prompt_overrides[relation]: + content.update(repr((relation, graph.head, graph.tail)).encode()) + for tensor in (graph.edge_index, graph.edge_type, graph.labels): + content.update(tensor.detach().cpu().contiguous().numpy().tobytes()) + digest = content.hexdigest() + return dict(sampler='kgicl-prompt-v1', shots=self.shots, hops=self.prompt_hops, open_nodes=self.open_nodes, + seed=self.prompt_seed, masked_distances=list(self.masked_distances), replayed=digest) + + @property + def _entities(self) -> int: + """Entity count of the attached graph; scoring and sampling run only after ``set_graph``.""" + return cast(int, self.num_entities) + @property def sampler(self) -> PromptSampler: """Prompt sampler of the attached graph, created on first use.""" @@ -244,7 +292,7 @@ def sampler(self) -> PromptSampler: if self._sampler is None: mapping = self.relation_id_map.detach().cpu().tolist() public = {internal: external for external, internal in enumerate(mapping)} - self._sampler = PromptSampler(self.graph_triples, self.num_entities, self.num_direct_relations, + self._sampler = PromptSampler(self.graph_triples, self._entities, self.num_direct_relations, [public[r] for r in range(self.num_direct_relations)], shots=self.shots, hops=self.prompt_hops, open_nodes=self.open_nodes, seed=self.prompt_seed) return self._sampler @@ -278,19 +326,20 @@ def encode_prompts(self, relation: int, graphs: Optional[Sequence[PromptGraph]] """Prompt representation ``[2R + 1, dim]`` of an internal query relation.""" self._require_graph() graphs = self.prompt_graphs(relation) if graphs is None else graphs - return self.relation_encoder(graphs, relation, 2 * self.num_direct_relations) + encoded: torch.Tensor = self.relation_encoder(graphs, relation, 2 * self.num_direct_relations) + return encoded def _prompts(self, relations): """Per-query prompt representations, cached by relation during inference.""" ids = host_ids(relations) - token = self.inference_token() if inference_only(self) and self.prompt_cache_mb else None + token = self.inference_token() if inference_only(self) and self.relation_cache_mb else None if token is None: values = {q: self.encode_prompts(q) for q in dict.fromkeys(ids)} return values, ids if token != self._prompt_cache_token: self._prompt_cache.clear() self._prompt_cache_token = token - capacity = int(self.prompt_cache_mb * 2**20) // ((2 * self.num_direct_relations + 1) * self.dim + capacity = int(self.relation_cache_mb * 2**20) // ((2 * self.num_direct_relations + 1) * self.dim * next(self.parameters()).element_size()) values = {} for q in dict.fromkeys(ids): @@ -306,9 +355,9 @@ def _prompts(self, relations): def _layer_tables(self, relations, prompts): """Stacked per-layer relation tables of the fused path, cached per relation like prompts.""" token = self._prompt_cache_token - size = (self.num_layers * (2 * self.num_direct_relations + 1) * (self.dim + attention_width(self)) + size = (self.num_layers * (2 * self.num_direct_relations + 1) * (self.dim + ATTENTION) * next(self.parameters()).element_size()) - capacity = int(self.table_cache_mb * 2**20) // size + capacity = int(self.projection_cache_mb * 2**20) // size if token is None or not capacity: values = {q: layer_tables(self, q, prompts[q]) for q in relations} else: @@ -335,7 +384,7 @@ def _out_edges(self, edges): return cached[2] edge_index, edge_type = edges order = edge_index[0].argsort(stable=True) - counts = torch.bincount(edge_index[0], minlength=self.num_entities) + counts = torch.bincount(edge_index[0], minlength=self._entities) layout = (torch.cat((counts.new_zeros(1), counts.cumsum(0))), edge_index[1, order], edge_type[order]) if not self.training: self._layout = (edge_index, edge_type, layout) @@ -343,7 +392,7 @@ def _out_edges(self, edges): def _expand_scores(self, heads, relations, prompts, edges): """Upstream's hop-by-hop reasoning for a batch; returns ``[B, N]`` scores and first-reach depths.""" - n, dim = self.num_entities, self.dim + n, dim = self._entities, self.dim offsets, targets, types = self._out_edges(edges) self_loop = 2 * self.num_direct_relations batch = torch.arange(len(heads), device=heads.device) diff --git a/dicee/models/kgicl_prompts.py b/dicee/models/kgicl_prompts.py index ddee382f6..669ee373a 100644 --- a/dicee/models/kgicl_prompts.py +++ b/dicee/models/kgicl_prompts.py @@ -114,7 +114,7 @@ def __init__(self, triples: torch.Tensor, num_entities: int, num_direct: int, pu pairs = torch.cat((direct[:, [0, 2]], direct[:, [2, 0]])) pairs = pairs[pairs[:, 0] != pairs[:, 1]].unique(dim=0) self.adjacency_offsets, self.adjacency = _csr(pairs[:, 0], pairs[:, 1], num_entities) - self._examples = {} + self._examples: dict[int, list[PromptExample]] = {} def distances(self, source: int) -> torch.Tensor: """Undirected hop distances from ``source`` up to ``hops``; farther entities are ``UNREACHED``.""" @@ -122,8 +122,9 @@ def distances(self, source: int) -> torch.Tensor: distance[source] = 0 frontier = torch.tensor([source]) for step in range(1, self.hops + 1): - neighbors = _gather(self.adjacency_offsets, self.adjacency, frontier).unique() - frontier = neighbors[distance[neighbors] == UNREACHED] + reached = torch.zeros(self.num_entities, dtype=torch.bool) + reached[_gather(self.adjacency_offsets, self.adjacency, frontier)] = True + frontier = (reached & (distance == UNREACHED)).nonzero().flatten() if not len(frontier): break distance[frontier] = step diff --git a/tests/test_kgicl.py b/tests/test_kgicl.py index a3e622ed7..ee4d25d89 100644 --- a/tests/test_kgicl.py +++ b/tests/test_kgicl.py @@ -110,7 +110,7 @@ def test_upstream_numerical_parity(name): if expected is None: assert parameter.grad is None, parameter_name else: - torch.testing.assert_close(parameter.grad, expected, atol=2e-5, rtol=1e-4, + torch.testing.assert_close(parameter.grad, expected, atol=1e-4, rtol=1e-4, msg=lambda msg: parameter_name + ": " + msg) @@ -309,7 +309,7 @@ def test_invalid_settings_and_ids(facts): @pytest.mark.parametrize("deterministic", [False, True]) def test_cuda_fused_path_matches_and_is_batch_invariant(facts, deterministic, monkeypatch): pytest.importorskip("triton") - # PyTorch requires this for deterministic cuBLAS; the query benchmarks set it for the process. + # PyTorch requires this for deterministic cuBLAS; the CQA Docker image sets it. monkeypatch.setenv("CUBLAS_WORKSPACE_CONFIG", ":4096:8") model = KGICL(dict(num_entities=6, num_relations=3, kgicl_query_batch_size=4)).set_graph(facts).eval().requires_grad_(False) queries = torch.cat((facts[:, :2], torch.tensor([[5, 0], [1, 2]]))) @@ -337,6 +337,38 @@ def test_cuda_fused_path_matches_and_is_batch_invariant(facts, deterministic, mo torch.use_deterministic_algorithms(previous) +@pytest.mark.skipif(not torch.cuda.is_available(), reason="CUDA is unavailable") +def test_cuda_fused_hub_rows_and_query_blocks(): + """Hub rows are summed in fixed segments and query blocks are padded; a row never depends on its batch.""" + pytest.importorskip("triton") + from dicee.models._triton_kgicl import HUB_SEGMENTS, QUERIES, SEGMENT + generator = torch.Generator().manual_seed(0) + n = 3 * SEGMENT * HUB_SEGMENTS + + def relations(count): + return torch.randint(0, 3, (count,), generator=generator) + # Entity 0 receives an edge from every other entity, a hub row of several segments. + spokes = torch.stack((torch.arange(1, n), relations(n - 1), torch.zeros(n - 1, dtype=torch.long)), 1) + noise = torch.stack((torch.randint(0, n, (4 * n,), generator=generator), relations(4 * n), + torch.randint(0, n, (4 * n,), generator=generator)), 1) + model = KGICL(dict(num_entities=n, num_relations=3, kgicl_masked_distances=[0, 2], kgicl_query_batch_size=2 * QUERIES + 1)) + model = model.set_graph(torch.cat((spokes, noise))).eval().requires_grad_(False).cuda() + queries = torch.cat((torch.tensor([[0, 0], [0, 1], [5, 2]]), noise[:10, :2])).cuda() + with torch.no_grad(): + model.set_inference_backend("torch") + expected = model(queries) + model.set_inference_backend("triton") + batched = model(queries) + model.query_batch_size = 1 + single = model(queries) + model.query_batch_size = 3 + reordered = model(queries.flip(0)).flip(0) + torch.testing.assert_close(batched, expected, atol=2e-4, rtol=2e-4) + assert torch.equal(batched, single) and torch.equal(batched, reordered) + # Heads and entities first reached after two hops are masked. + assert (batched[torch.arange(len(queries)), queries[:, 0]] == 0).all() and (batched != 0).any() + + @pytest.mark.parametrize("model_name,technique,grouped,trainer", [ ("KGICL", "NegSample", False, "torchCPUTrainer"), ("KGICL", "NegSample", True, "torchCPUTrainer"), @@ -394,3 +426,21 @@ def test_zero_epoch_official_checkpoint_format(tmp_path): torch.testing.assert_close(state[key], pretrained.state_dict()[key]) assert np.isfinite(report["Test"]["MRR"]) assert json.loads((tmp_path / "run" / "configuration.json").read_text())["kgicl_dim"] == 32 + + +def test_query_rows_are_bitwise_independent_of_batching(facts, monkeypatch): + """The query evaluator caches rows across beams and controls; batching must not change a row.""" + from dicee.query_answering.context import QueryContext, attached_context + from dicee.query_answering.engine import AtomicScorer + from dicee.query_answering.method_evaluation import deterministic_kgfm + monkeypatch.setenv("CUBLAS_WORKSPACE_CONFIG", ":4096:8") + context = QueryContext([tuple(t) for t in facts.tolist()], 6, 3) + conditions = [(h, r) for h in range(6) for r in range(3)] + for device in ["cpu"] + (["cuda"] if torch.cuda.is_available() else []): + model = KGICL(dict(num_entities=1, num_relations=1, kgicl_query_batch_size=4)).eval().requires_grad_(False).to(device) + with deterministic_kgfm(), attached_context(model, context): + reference = AtomicScorer(model, context, row_batch_size=1).rows(conditions) + for size in (2, 5, 18): + rows = AtomicScorer(model, context, row_batch_size=size).rows(conditions[::-1]).flip(0) + assert torch.equal(rows, reference), (device, size) + assert torch.isfinite(reference).all() and (reference != 0).any() From 6e7c15e7153168ec37dc1be5be005e7e5fdc06ed Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 22:22:17 +0200 Subject: [PATCH 25/39] feat(benchmarks): KG-ICL in the KGFM zero-shot, inference and upstream runners kgfm_zero_shot.py evaluates KG-ICL with a prompt seed (--prompt-seed) and, optionally, the official answer-distance mask (--distance-mask), and labels FB15k-237 and the NELL-995 variants as related to its FB V1 and NELL V1 pretraining graphs. kgfm_upstream.py runs the pinned official KG-ICL in its own interpreter (--upstream-python) with the bug-fix patch applied to a temporary copy (--upstream-variant unpatched times the released code). Both implementations read the same graph, DICE's seeded prompt graphs written in the official case format and the same distance mask. --allow-unchecked-gpu records an unavailable nvidia-smi process check instead of aborting, and the float64 diagnostic promotes the official loader's incidence matrices. --- benchmarks/kgfm_inference.py | 17 ++-- benchmarks/kgfm_upstream.py | 171 +++++++++++++++++++++++++++++++---- benchmarks/kgfm_zero_shot.py | 27 +++++- 3 files changed, 190 insertions(+), 25 deletions(-) diff --git a/benchmarks/kgfm_inference.py b/benchmarks/kgfm_inference.py index 342e26026..b4911392a 100644 --- a/benchmarks/kgfm_inference.py +++ b/benchmarks/kgfm_inference.py @@ -15,12 +15,17 @@ from pathlib import Path ROOT = Path(__file__).resolve().parents[1] -CHECKPOINTS = {'ULTRA': 'ultra_3g.pth', 'TRIX': 'trix/entity_prediction.pth', 'Flock': 'flock/flock_entity.pth'} +CHECKPOINTS = {'ULTRA': 'ultra_3g.pth', 'TRIX': 'trix/entity_prediction.pth', 'Flock': 'flock/flock_entity.pth', + 'KGICL': 'kgicl/KG-ICL-6L/model_best.tar'} def digest(path): - with path.open('rb') as stream: - return hashlib.file_digest(stream, 'sha256').hexdigest() + # Chunked hashing also runs on the Python 3.9 reference environment of official KG-ICL. + result = hashlib.sha256() + with Path(path).open('rb') as stream: + for block in iter(lambda: stream.read(1 << 20), b''): + result.update(block) + return result.hexdigest() def inference_arguments(args): @@ -41,7 +46,7 @@ def worker(args): import torch from dicee.evaluation.link_prediction import evaluate_lp - from dicee.models import TRIX, ULTRA, Flock + from dicee.models import KGICL, TRIX, ULTRA, Flock torch.set_num_threads(args.threads) torch.manual_seed(42) @@ -71,8 +76,8 @@ def worker(args): graph_inference_backend=args.inference_backend, graph_relation_cache_mb=args.relation_cache_mb, graph_projection_cache_mb=args.projection_cache_mb, graph_inference_compile=args.compile_inference, flock_compact_state=args.compact_state, flock_compile_sampler=args.compile_sampler, - flock_pack_walks=args.pack_walks) - cls = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[args.model] + flock_pack_walks=args.pack_walks, kgicl_masked_distances=metadata.get('kgicl_masked_distances')) + cls = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock, 'KGICL': KGICL}[args.model] begin = time.perf_counter() model = cls(settings).load_pretrained(checkpoint).set_graph(facts).eval().requires_grad_(False).to(device=args.device, dtype=getattr(torch, args.dtype)) setup_seconds = time.perf_counter() - begin diff --git a/benchmarks/kgfm_upstream.py b/benchmarks/kgfm_upstream.py index c0b8b6cf8..46f4cf35a 100644 --- a/benchmarks/kgfm_upstream.py +++ b/benchmarks/kgfm_upstream.py @@ -4,6 +4,13 @@ environment. Dataset loading, graph construction, filtering, and fixed-walk transfers are outside warm inference timings. Flock additionally replays the official sampler's records through both neural models for a score parity check. + +KG-ICL's official worker runs in its own environment (``--upstream-python``) +on the pinned checkout plus tests/fixtures/kgicl/upstream-fixes.patch, unless +``--upstream-variant unpatched`` is given. Both models read the same graph, +the same DICE-sampled prompt graphs, written in the official case format, and +the same answer-distance mask. Prompt graph extraction is preprocessing and +is not timed for either implementation. """ import argparse import importlib.metadata @@ -24,8 +31,10 @@ 'ULTRA': '427966ad8ed60420eef034063d44f3153addff90', 'TRIX': '7596e14eefefe89e61396205a0550172cadeddb0', 'Flock': 'f35103d25a78bdf4075de5c673a51de4979aa4d7', + 'KGICL': '6a3166e347ae468acdfb30a70a2cf3608b66b8f1', } -SOURCE_DIRS = {'ULTRA': 'ultra', 'TRIX': 'src', 'Flock': 'src_entity'} +SOURCE_DIRS = {'ULTRA': 'ultra', 'TRIX': 'src', 'Flock': 'src_entity', 'KGICL': 'src'} +KGICL_PATCH = ROOT / 'tests' / 'fixtures' / 'kgicl' / 'upstream-fixes.patch' def git(root, *args): @@ -63,11 +72,14 @@ def filtered_metrics(scores, triples, directory): **{f'H@{k}': (ranks <= k).double().mean().item() for k in (1, 3, 10)}} -def gpu_processes(): +def gpu_processes(require=True): if not shutil.which('nvidia-smi'): raise RuntimeError('nvidia-smi is required to detect competing CUDA jobs') run = subprocess.run(['nvidia-smi', '--query-compute-apps=pid,process_name,used_memory', - '--format=csv,noheader,nounits'], check=True, text=True, capture_output=True) + '--format=csv,noheader,nounits'], check=require, text=True, capture_output=True) + if run.returncode: + # Explicitly allowed (--allow-unchecked-gpu), e.g. after an NVML driver/library mismatch. + return ['unavailable: ' + (run.stdout + run.stderr).strip()] lines = [line for line in run.stdout.splitlines() if line.strip()] desktop = {'/usr/bin/kwin_wayland', '/usr/bin/kwin_x11', '/usr/lib/Xorg', '/usr/bin/Xorg'} other = [line for line in lines if int(line.split(',')[0]) != os.getpid() @@ -77,6 +89,91 @@ def gpu_processes(): return lines +def kgicl_data(args, facts, valid, triples, metadata): + """Write the splits and DICE's prompt graphs in the official processed layout. + + The test background is the training graph DICE attaches. Examples are those + DICE samples, so both models read identical prompts. Returns the distance + mask both models apply: hop distances holding under 2% of validation facts. + """ + sys.path.insert(0, str(ROOT)) + from dicee.models import KGICL + from dicee.models.kgicl_prompts import answer_distance_rates + + nr = metadata['num_relations'] + model = KGICL(dict(num_entities=metadata['num_entities'], num_relations=nr, kgicl_prompt_seed=args.prompt_seed)) + model.set_graph(facts) + data = args.output / 'kgicl-data' + queried = set(triples[:, 1].tolist()) + + def write(path, rows): + path.write_text(''.join('\t'.join(map(str, row)) + '\n' for row in rows)) + + for split, queries in (('valid', valid), ('test', triples)): + directory = data / split + directory.mkdir(parents=True, exist_ok=True) + write(directory / 'background.txt', facts.tolist()) + write(directory / 'facts.txt', queries.tolist()) + write(directory / 'filter.txt', torch_cat(facts, valid, triples).tolist()) + write(directory / 'entity2id.txt', [(f'e{i}', i) for i in range(metadata['num_entities'])]) + write(directory / 'relation2id.txt', [(f'r{i}', i) for i in range(nr)]) + for relation in range(nr): + cases = directory / 'cases' / f'r{relation}' + cases.mkdir(parents=True, exist_ok=True) + if relation not in queried: + continue + for index, example in enumerate(model.sampler.examples(relation)): + local = example.triples.tolist() + first = [0, relation, 0 if example.self_loop else 1] + local.remove(first) + write(cases / f'{index}.triples', [first, *local]) + write(cases / f'{index}.labels', [(node, *label) for node, label in enumerate(example.labels.tolist())]) + write(cases / f'{index}.node2id', [(entity, node) for node, entity in enumerate(example.entities.tolist())]) + rates = answer_distance_rates(valid, facts, metadata['num_entities']) + masked = [d for d in range(7) if rates[d] < 0.02] + (data / 'distance_mask.json').write_text(json.dumps(dict(rates=rates, masked_distances=masked)) + '\n') + return masked + + +def torch_cat(*parts): + import torch + return torch.cat(parts) + + +def official_kgicl(args, metadata): + """Official EntityEncoder and DataLoader, pinned and optionally patched, on the written data.""" + import tempfile + + import torch + work = Path(tempfile.mkdtemp(prefix='kgicl-')) + # The official loader derives split paths by replacing these words in the path. + assert not any(word in str(work) for word in ('train', 'valid', 'test')) + for name in ('src', 'run_your_own_dataset'): + shutil.copytree(args.upstream_root / name, work / name) + if args.upstream_variant == 'patched': + subprocess.run(['patch', '-p1', '-s', '-d', str(work), '-i', str(KGICL_PATCH)], check=True) + shutil.copytree(args.output / 'kgicl-data', work / 'data') + sys.path.insert(0, str(work / 'src')) + from types import SimpleNamespace + + from data_loader import DataLoader + from encoder.EntityEncoder import EntityEncoder + + options = SimpleNamespace( + finetune=False, train_batch_size=8, test_batch_size=args.query_batch_size, shot=5, device=torch.device(args.device), + use_attn=True, attn_type='Sigmoid', AGG='max', AGG_rel='max', MSG='concat', use_augment=False, + use_token_set=True, use_prompt_graph=True, prompt_graph_type='all', path_hop=3, hidden_dim=32, attn_dim=5, + n_relation_encoder_layer=3, n_layer=6, act='idd', dropout=0.0, relation_mask_rate=0.0, use_rspmm=False) + loader = DataLoader(options, str(work / 'data' / 'test') + '/', metadata['dataset']) + expected = json.loads((work / 'data' / 'distance_mask.json').read_text())['rates'] + assert all(abs(loader.kg.answer_distance[d] - expected[d]) < 1e-12 for d in range(7)), 'distance rates differ' + model = EntityEncoder(options) + state = torch.load(ROOT / 'checkpoints' / CHECKPOINTS['KGICL'], map_location='cpu', weights_only=True)['state_dict'] + # Official evaluation drops the checkpoint's unused NBFNet keys the same way (strict=False). + model.load_state_dict({key: value for key, value in state.items() if key in model.state_dict()}, strict=True) + return model, loader + + def official_model(args, facts, metadata): import torch from torch_geometric.data import Data @@ -139,16 +236,23 @@ def worker(args): triples = triples_cpu.to(args.device) checkpoint = ROOT / 'checkpoints' / CHECKPOINTS[args.model] started = time.perf_counter() - if args.variant == 'official': + loader = None + if args.variant == 'official' and args.model == 'KGICL': + model, loader = official_kgicl(args, metadata) + elif args.variant == 'official': model, graph = official_model(args, facts, metadata) else: sys.path.insert(0, str(ROOT)) - from dicee.models import TRIX, ULTRA, Flock + from dicee.models import KGICL, TRIX, ULTRA, Flock - cls = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[args.model] + cls = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock, 'KGICL': KGICL}[args.model] + masked = None + if args.model == 'KGICL': + masked = json.loads((args.output / 'kgicl-data' / 'distance_mask.json').read_text())['masked_distances'] model = cls(dict(num_entities=metadata['num_entities'], num_relations=metadata['num_relations'], **{args.model.lower() + '_query_batch_size': args.query_batch_size}, - flock_walk_num=args.walk_num, flock_test_samples=1, flock_seed=args.seed)) + flock_walk_num=args.walk_num, flock_test_samples=1, flock_seed=args.seed, + kgicl_prompt_seed=args.prompt_seed, kgicl_masked_distances=masked)) model.load_pretrained(checkpoint).set_graph(facts) model.eval().requires_grad_(False).to(device=args.device, dtype=getattr(torch, args.dtype)) initial_weights = {name: value.detach().cpu().clone() for name, value in model.state_dict().items()} @@ -176,6 +280,9 @@ def double_ones(*a, **kw): kw['dtype'] = torch.float64 return original_ones(*a, **kw) torch.ones = double_ones + if loader is not None: + # Official KG-ICL's incidence matrices only select neighbors; they multiply default-dtype one-hots. + loader.M_sub, loader.M_obj = loader.M_sub.double(), loader.M_obj.double() records = {} if args.mode == 'replay': for i in range(len(triples)): @@ -193,6 +300,15 @@ def predict(count=None, capture=False): if args.variant == 'dice' and args.mode == 'native': return torch.stack((model.forward_k_vs_all(query[:, :2]), model.forward_k_vs_all_heads(query[:, 1:])), 1) + if loader is not None: + # Official KG-ICL: tail queries (h, r) and head queries (t, r + R) as inverse tail queries. + sides = [] + for heads, relations in ((query[:, 0], query[:, 1]), (query[:, 2], query[:, 1] + metadata['num_relations'])): + sides.append(torch.cat([model(heads[s:s + args.query_batch_size].cpu().numpy(), + relations[s:s + args.query_batch_size].cpu().numpy(), + loader=loader, training=False)[0] + for s in range(0, len(query), args.query_batch_size)])) + return torch.stack(sides, 1) outputs = [] for side in ('tail', 'head'): chunks = [] @@ -232,7 +348,7 @@ def timed(): torch.cuda.synchronize(args.device) return time.perf_counter() - begin, scores - snapshots = [gpu_processes()] + snapshots = [gpu_processes(not args.allow_unchecked_gpu)] if args.scores_only: with torch.no_grad(): scores = predict().cpu() @@ -253,11 +369,11 @@ def timed(): baseline_memory = torch.cuda.memory_allocated(args.device) / 2**20 timings = [] for _ in range(args.repeats): - snapshots.append(gpu_processes()) + snapshots.append(gpu_processes(not args.allow_unchecked_gpu)) elapsed, scores = timed() timings.append(elapsed) del scores - snapshots.append(gpu_processes()) + snapshots.append(gpu_processes(not args.allow_unchecked_gpu)) peak = torch.cuda.max_memory_allocated(args.device) / 2**20 scores = predict().cpu() if args.variant == 'official' and args.model == 'Flock' and args.mode == 'native' and args.replay_queries: @@ -277,6 +393,9 @@ def timed(): if not hasattr(extension, 'rspmm_add_mul_forward_cuda'): raise RuntimeError('The official fused CUDA extension is missing') dependencies['rspmm_binary_sha256'] = digest(Path(extension.__file__)) + if args.model == 'KGICL' and args.variant == 'official': + source['patch'] = None if args.upstream_variant == 'unpatched' else dict(path=str(KGICL_PATCH.relative_to(ROOT)), + sha256=digest(KGICL_PATCH)) report = dict(model=args.model, variant=args.variant, mode=args.mode, source=source, dataset=metadata['dataset'], test_indices=indices.tolist(), test_triples=len(triples), ranked_queries=2 * len(triples), query_batch_size=args.query_batch_size, @@ -300,13 +419,14 @@ def timed(): print(json.dumps({key: report[key] for key in ['model', 'variant', 'mode', 'median_forward_seconds', 'metrics']}), flush=True) -def compare(directory, stochastic=False, fp64_path=None, raise_on_failure=True): +def compare(directory, stochastic=False, fp64_path=None, raise_on_failure=True, same_environment=True): import torch official, dice = [json.loads((directory / f'{name}.json').read_text()) for name in ('official', 'dice')] for key in ('test_indices', 'query_batch_size', 'walk_num', 'test_samples', 'seed', 'torch', 'cuda', 'dtype', 'tf32', 'hardware', 'device', 'checkpoint_sha256', 'train_sha256', 'test_sha256'): - assert official[key] == dice[key], key + if same_environment or key not in ('torch', 'cuda'): + assert official[key] == dice[key], key left, right = [torch.load(directory / f'{name}.pt', weights_only=True) for name in ('official', 'dice')] assert torch.isfinite(left).all() and torch.isfinite(right).all() differences = {key: dice['metrics'][key] - value for key, value in official['metrics'].items()} @@ -351,6 +471,12 @@ def main(): parser.add_argument('--seed', type=int, default=42) parser.add_argument('--walk-num', type=int, default=128) parser.add_argument('--replay-queries', type=int, default=8) + parser.add_argument('--upstream-python', type=Path, help='Interpreter of the official model (KG-ICL: its own environment)') + parser.add_argument('--upstream-variant', choices=['patched', 'unpatched'], default='patched', + help='KG-ICL: apply tests/fixtures/kgicl/upstream-fixes.patch to the official code (default)') + parser.add_argument('--prompt-seed', type=int, default=0, help='KG-ICL prompt sampling seed') + parser.add_argument('--allow-unchecked-gpu', action='store_true', + help='Record, instead of rejecting, an unavailable nvidia-smi process check') parser.add_argument('--variant', choices=['official', 'dice'], help=argparse.SUPPRESS) parser.add_argument('--mode', choices=['native', 'replay'], default='native', help=argparse.SUPPRESS) parser.add_argument('--walks', type=Path, help=argparse.SUPPRESS) @@ -384,13 +510,26 @@ def main(): for mode, queries in modes: directory = args.output / mode directory.mkdir(parents=True, exist_ok=True) + if args.model == 'KGICL': + import numpy as np + import torch + metadata = json.loads((args.indexed_data / 'result.json').read_text()) + facts = torch.from_numpy(np.load(args.indexed_data / 'train_set.npy').astype(np.int64)) + valid = torch.from_numpy(np.load(args.indexed_data / 'valid_set.npy').astype(np.int64)) + test = torch.from_numpy(np.load(args.indexed_data / 'test_set.npy').astype(np.int64)) + indices = torch.randperm(len(test), generator=torch.Generator().manual_seed(args.seed))[:queries] + kgicl_data(argparse.Namespace(output=directory, prompt_seed=args.prompt_seed), facts, valid, test[indices], metadata) + def run_worker(variant, **overrides): - command = [sys.executable, str(Path(__file__).resolve())] + python = args.upstream_python if variant == 'official' and args.upstream_python else sys.executable + command = [str(python), str(Path(__file__).resolve())] options = vars(args) | dict(mode=mode, queries=queries, output=directory, variant=variant) | overrides for key, value in options.items(): - if key == 'scores_only': + if key in ('scores_only', 'allow_unchecked_gpu'): if value: - command.append('--scores-only') + command.append('--' + key.replace('_', '-')) + continue + if value is None: continue command.extend(['--' + key.replace('_', '-'), str(value)]) label = 'official-fp64' if options['scores_only'] else variant @@ -400,7 +539,7 @@ def run_worker(variant, **overrides): for variant in ('official', 'dice'): run_worker(variant) stochastic = args.model == 'Flock' and mode == 'native' - result = compare(directory, stochastic=stochastic, raise_on_failure=False) + result = compare(directory, stochastic=stochastic, raise_on_failure=False, same_environment=args.upstream_python is None) if not result['scores_close'] and args.model != 'Flock': run_worker('official', dtype='float64', scores_only=True) compare(directory, fp64_path=directory / 'official-fp64.pt') diff --git a/benchmarks/kgfm_zero_shot.py b/benchmarks/kgfm_zero_shot.py index 85c88c4c5..76b0a1c05 100644 --- a/benchmarks/kgfm_zero_shot.py +++ b/benchmarks/kgfm_zero_shot.py @@ -27,13 +27,15 @@ from dicee.evaluation._graph_inference import GraphRankPlan from dicee.evaluation.link_prediction import evaluate_lp from dicee.knowledge_graph import KG -from dicee.models import TRIX, ULTRA, Flock +from dicee.models import KGICL, TRIX, ULTRA, Flock +from dicee.models.kgicl_prompts import answer_distance_rates -MODELS = {"ULTRA": ULTRA, "TRIX": TRIX, "Flock": Flock} +MODELS = {"ULTRA": ULTRA, "TRIX": TRIX, "Flock": Flock, "KGICL": KGICL} CHECKPOINTS = { "ULTRA": "checkpoints/ultra_3g.pth", "TRIX": "checkpoints/trix/entity_prediction.pth", "Flock": "checkpoints/flock/flock_entity.pth", + "KGICL": "checkpoints/kgicl/KG-ICL-6L/model_best.tar", } METRICS = ("MRR", "H@1", "H@3", "H@10") @@ -85,6 +87,12 @@ def check_split_overlap(train, valid, test, *, allow=False): def pretraining_status(model, variant, dataset): + if model == "KGICL": + # KG-ICL pretrains on FB V1, NELL V1 and CoDEx-small. GraIL's FB/NELL splits are + # subgraphs of FB15k-237 and NELL-995, so those graphs share facts with pretraining. + if dataset in ("CoDEx-Small", "FB237_v1", "NELL_v1"): + return "yes" + return "related" if dataset == "FB15k-237" or dataset.startswith("NELL-995") else "no" dataset = {"FB15k-237": "FB15k237", "CoDEx-Medium": "CoDExMedium", "YAGO3-10": "YAGO310", "NELL-995": "NELL995"}.get(dataset, dataset) if model == "ULTRA" and variant in ("4g", "50g") and dataset.startswith("NELL-995-"): @@ -123,6 +131,10 @@ def main(): parser.add_argument('--pack-walks', action=argparse.BooleanOptionalAction, default=True) parser.add_argument('--reuse-queries', action=argparse.BooleanOptionalAction, default=True) parser.add_argument('--prefetch-walks', action=argparse.BooleanOptionalAction, default=True) + parser.add_argument('--prompt-seed', type=int, default=0, help='KG-ICL prompt sampling seed') + parser.add_argument('--distance-mask', action='store_true', + help="KG-ICL: zero entities first reached at distances where under 2%% of validation " + "facts lie (the official evaluation's default heuristic)") parser.add_argument("--seed", type=int, default=42) parser.add_argument("--tie-policy", choices=TIE_POLICIES, default="sort") parser.add_argument("--tie-seed", type=int, default=None, @@ -131,6 +143,8 @@ def main(): args = parser.parse_args() if args.model != "ULTRA" and args.ultra_checkpoint != "3g": parser.error("--ultra-checkpoint applies only to ULTRA") + if args.model != "KGICL" and (args.distance_mask or args.prompt_seed): + parser.error("--distance-mask and --prompt-seed apply only to KGICL") if args.tie_seed is None: args.tie_seed = args.seed if min(args.batch_size, args.query_batch_size, args.threads, args.walk_num, args.test_samples) < 1: @@ -202,6 +216,11 @@ def main(): if overlap["train_test"]: logging.warning("Original-split evaluation includes %d distinct test facts in the " "inference graph; these results contain leakage", overlap["train_test"]) + masked = None + if args.distance_mask: + rates = answer_distance_rates(kg.valid_set, kg.train_set, kg.num_entities) + masked = [d for d in range(7) if rates[d] < 0.02] + write_json(output / "distance_mask.json", {"rates": rates, "masked_distances": masked, "threshold": 0.02}) settings = dict(num_entities=kg.num_entities, num_relations=kg.num_relations, **{f"{args.model.lower()}_query_batch_size": args.query_batch_size}, flock_walk_num=args.walk_num, flock_test_samples=args.test_samples, @@ -209,7 +228,8 @@ def main(): graph_inference_backend=args.inference_backend, graph_relation_cache_mb=args.relation_cache_mb, graph_projection_cache_mb=args.projection_cache_mb, graph_inference_compile=args.compile_inference, flock_compact_state=args.compact_state, flock_compile_sampler=args.compile_sampler, - flock_pack_walks=args.pack_walks) + flock_pack_walks=args.pack_walks, kgicl_prompt_seed=args.prompt_seed, + kgicl_masked_distances=masked) model = MODELS[args.model](settings).load_pretrained(checkpoint) model.set_graph(kg.train_set).eval().requires_grad_(False) initial_weights = {key: value.clone() for key, value in model.state_dict().items()} @@ -264,6 +284,7 @@ def main(): "split_overlap": overlap, "test_facts_in_inference_graph": bool(overlap["train_test"]), "model_label": model_label, "pretraining_status": pretraining, "target_graph_in_pretraining": {"yes": True, "no": False}.get(pretraining), + "kgicl_masked_distances": masked, "test_triples": len(kg.test_set), "ranked_queries": 2 * len(kg.test_set), "num_entities": kg.num_entities, "num_relations": kg.num_relations, "inference_edges": model.edge_type.numel(), "metrics": metrics, From 9ba1c354627ef3fd250f4b2692931551a945f1e8 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 22:25:02 +0200 Subject: [PATCH 26/39] feat(query-answering): KG-ICL as a frozen CQA backbone with provisional recipes kgicl-adapter evaluates KG-ICL like the ULTRA and TRIX adapters. The catalog pins the official repository and commit; score adapters bind to the backbone through the state fingerprint of its checkpoint, which keeps the weights under 'state_dict'; cached adapter training rows record the prompt sampling identity. Prompt graphs come from each benchmark's inference graph with seed 0, or a recipe's prompt_seed. The +H and UltraQuery recipes are marked finalized=false and list their blockers: the product adapter is not fitted yet. They cache the per-layer relation tables of every query relation (projection_cache_mb 512), which makes rows on FB15k237 about 2.5 times faster than the 64 MiB default. Validation-only runs no longer require the +H test reduction labels, and the benchmark CLI accepts --model KGICL. The paired KGFM pipeline tests also run with KG-ICL. --- benchmarks/cqa/README.md | 5 +- benchmarks/cqa/cli.py | 7 +- benchmarks/cqa/inputs.py | 24 ++-- benchmarks/cqa/tests/test_adapter_pairs.py | 18 +-- benchmarks/cqa/tests/test_protocol.py | 9 +- benchmarks/plus_h/kgfm_kgicl.json | 105 ++++++++++++++ benchmarks/ultraquery/kgfm_kgicl.json | 157 +++++++++++++++++++++ dicee/query_answering/_adapter_cache.py | 3 + dicee/query_answering/adapter_training.py | 2 + dicee/query_answering/benchmark.py | 6 +- dicee/query_answering/catalog.py | 8 +- dicee/query_answering/context.py | 8 ++ dicee/query_answering/method_evaluation.py | 11 +- dicee/query_answering/score_adapter.py | 6 +- 14 files changed, 335 insertions(+), 34 deletions(-) create mode 100644 benchmarks/plus_h/kgfm_kgicl.json create mode 100644 benchmarks/ultraquery/kgfm_kgicl.json diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index fca3ef9cf..4d7ba19af 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -82,14 +82,17 @@ execution options. Each suite directory holds its public recipes: |---|---| | `plus_h/baselines.json` | The seven published methods on the three +H datasets (21 entries) | | `plus_h/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters (6 entries, each with an identity control) | +| `plus_h/kgfm_kgicl.json` | **Not finalized.** KG-ICL with a product adapter (3 entries, each with an identity control); the adapter is not fitted yet | | `plus_h/published_results.json` | Scores reported by the +H authors, for `report` | | `ultraquery/baselines.json` | Native UltraQuery on all 23 datasets | | `ultraquery/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters on all 23 datasets | +| `ultraquery/kgfm_kgicl.json` | **Not finalized.** KG-ICL with a product adapter on all 23 datasets; the adapter is not fitted yet | | `ultraquery/comparisons.json` | ULTRA link-prediction weights, an incoming-relation heuristic and QTO | | `ultraquery/trained_baselines.json` | QTO on FB15k and inductive GNN-QE, after `train` | Defaults are `baselines.json` and `kgfm_adapters.json`; `--manifests FILE ...` -replaces them. Adapter weights shared by both +replaces them. The KG-ICL recipes are never defaults: they list their blockers +and need a fitted, pinned adapter before any test run ([KG-ICL guide](../../docs/kgicl.md#complex-query-answering)). Adapter weights shared by both suites are in [`benchmarks/adapters`](../adapters). Recipe files list shared `defaults` once per method, and each entry only what differs; `{dataset}` in an ID is filled in. [`tests/recipe_fingerprints.json`](tests/recipe_fingerprints.json) pins every diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 764d83f3e..3f6d80e47 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -206,10 +206,13 @@ def resolve(args): def ensure_inputs(args, manifest): + # Validation-only evaluation never reads the +H test reduction labels. + test_labels = getattr(args, 'split', 'test') != 'valid' if not args.no_setup: - inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, models_archive=args.models_archive) + inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, models_archive=args.models_archive, + test_labels=test_labels) else: - inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, download_missing=False) + inputs.ensure_inputs(manifest, args.input_root, suite=args.suite, download_missing=False, test_labels=test_labels) def in_container(parser, args): diff --git a/benchmarks/cqa/inputs.py b/benchmarks/cqa/inputs.py index 5a8fcaee2..b3bc9bb08 100644 --- a/benchmarks/cqa/inputs.py +++ b/benchmarks/cqa/inputs.py @@ -43,13 +43,15 @@ 'checkpoints/ultra_3g.pth': 'fdedc01b0045fc089d2ad5da08569466b7b221691fe978a18e91082bbb133c18', 'checkpoints/ultra_4g.pth': '48a046e708adf5632d87c30eacae01f5f51466b2301effdc2cb42358d22854e0', 'checkpoints/ultra_50g.pth': 'f1c5377b2cf547aaa67520ffb6fce27b75b6eb3417b86dc9cf9dba89964ed10f', + 'checkpoints/kgicl/KG-ICL-6L/model_best.tar': '80f885ffa2c0175cd6ed829af99ae45177fdb5f77302c7648591bbdf62bc1c81', } def weight_urls(): - ultra, trix = (f'https://raw.githubusercontent.com/{repository}/{commit}' - for repository, commit in (catalog().ULTRA, catalog().TRIX)) + ultra, trix, kgicl = (f'https://raw.githubusercontent.com/{repository}/{commit}' + for repository, commit in (catalog().ULTRA, catalog().TRIX, catalog().KG_ICL)) return {'Experiments/query-baselines/upstream/ultra/ckpts/ultraquery.pth': f'{ultra}/ckpts/ultraquery.pth', + 'checkpoints/kgicl/KG-ICL-6L/model_best.tar': f'{kgicl}/checkpoint/KG-ICL-6L/model_best.tar', 'checkpoints/ultra_3g.pth': f'{ultra}/ckpts/ultra_3g.pth', 'checkpoints/ultra_4g.pth': f'{ultra}/ckpts/ultra_4g.pth', 'checkpoints/ultra_50g.pth': f'{ultra}/ckpts/ultra_50g.pth', @@ -168,9 +170,11 @@ def plan(manifest, suite): return jobs, weights -def missing_files(root, job): +def missing_files(root, job, test_labels=True): + """Required files of a dataset job that are absent; ``test_labels=False`` skips +H test reduction labels.""" return [f"{job['root']}/{folder}/{name}" for folder, names in job['folders'].items() - for name in sorted(names) if not target(root, f"{job['root']}/{folder}/{name}").is_file()] + for name in sorted(names) if (test_labels or not name.startswith('test-query-reduction/')) + and not target(root, f"{job['root']}/{folder}/{name}").is_file()] def extract(archive, root, select): @@ -267,8 +271,12 @@ def fetch_weights(root, weights, models_archive=None): print(f'Checkpoint inputs present: {len(weights)}; released files checked by SHA-256', flush=True) -def ensure_inputs(manifest, input_root, *, suite, models_archive=None, download_missing=True): - """Set up only requested public inputs; custom data/checkpoints stay explicit.""" +def ensure_inputs(manifest, input_root, *, suite, models_archive=None, download_missing=True, test_labels=True): + """Set up only requested public inputs; custom data/checkpoints stay explicit. + + ``test_labels=False`` (validation-only evaluation) neither requires nor downloads + the +H test reduction labels, which only test-split difficulty reports read. + """ root = Path(input_root).expanduser().resolve() root.mkdir(parents=True, exist_ok=True) jobs, weights = plan(manifest, suite) @@ -276,7 +284,7 @@ def ensure_inputs(manifest, input_root, *, suite, models_archive=None, download_ public = json.loads((REPO / 'benchmarks' / suite / 'baselines.json').read_text()) official = manifest.get('archives', {}).get('datasets') == public['archives']['datasets'] if official: - missing += [p for job in jobs for p in missing_files(root, job)] + missing += [p for job in jobs for p in missing_files(root, job, test_labels)] extras = {p for e in manifest['entries'] for p in e.get('adapters', {}).values()} extras |= {e['checkpoint'] for e in manifest['entries'] if e['checkpoint'].endswith('.json')} for name in sorted(extras): @@ -299,7 +307,7 @@ def ensure_inputs(manifest, input_root, *, suite, models_archive=None, download_ fetch_weights(root, weights, models_archive) if official: for job in jobs: - if missing_files(root, job): + if missing_files(root, job, test_labels): fetch_dataset(root, job) diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index 8f473a44f..6115b8b5e 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -120,17 +120,18 @@ def resume(query): assert adapter_effects(left, left, bootstrap_samples=0)['macro']['sort']['mrr'] == 0 -@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +@pytest.mark.parametrize('backbone', ['ultra', 'trix', 'kgicl']) @pytest.mark.parametrize('facts,ultraquery', [(None, False), ('none', False), ('atomic', False), ('both', False), ('both', True)]) def test_paired_kgfm_verification_full_run_and_reports(tmp_path, backbone, facts, ultraquery): - from dicee.models import TRIX, ULTRA + from dicee.models import KGICL, TRIX, ULTRA from dicee.query_answering.score_adapter import QueryScoreAdapter manifest = paper_fixture(tmp_path) if ultraquery: use_ultraquery_fixture(manifest, tmp_path) count = len(manifest['entries'][0]['query_types']) - model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) - torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL}[backbone](dict(num_entities=1, num_relations=1)) + # KG-ICL checkpoints keep their weights under 'state_dict'. + torch.save({'state_dict' if backbone == 'kgicl' else 'model': model.state_dict()}, tmp_path / 'kgfm.pt') QueryScoreAdapter('context_scores', 1., bias_bound=8., weights=torch.randn(2, 8, generator=torch.Generator().manual_seed(4)).double() / 5, metadata={'backbone_state_sha256': state_fingerprint(model)}).save(tmp_path / 'adapter.json') @@ -327,14 +328,15 @@ def fail_after_commit(self, state): evaluate_benchmark(data, predict, **options) -@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +@pytest.mark.parametrize('backbone', ['ultra', 'trix', 'kgicl']) def test_row_granular_raw_cache_reaches_the_engine_and_keeps_scores(tmp_path, backbone): - from dicee.models import TRIX, ULTRA + from dicee.models import KGICL, TRIX, ULTRA from dicee.query_answering.score_adapter import QueryScoreAdapter manifest = paper_fixture(tmp_path) use_ultraquery_fixture(manifest, tmp_path) - model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) - torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL}[backbone](dict(num_entities=1, num_relations=1)) + # KG-ICL checkpoints keep their weights under 'state_dict'. + torch.save({'state_dict' if backbone == 'kgicl' else 'model': model.state_dict()}, tmp_path / 'kgfm.pt') QueryScoreAdapter('context_scores', 1., bias_bound=8., weights=torch.randn(2, 8, generator=torch.Generator().manual_seed(4)).double() / 5, metadata={'backbone_state_sha256': state_fingerprint(model)}).save(tmp_path / 'adapter.json') diff --git a/benchmarks/cqa/tests/test_protocol.py b/benchmarks/cqa/tests/test_protocol.py index 9b644c96c..72b2048ff 100644 --- a/benchmarks/cqa/tests/test_protocol.py +++ b/benchmarks/cqa/tests/test_protocol.py @@ -548,12 +548,13 @@ def test_independent_exporter_parity_and_full_run(tmp_path): assert report['split'] == 'test' -@pytest.mark.parametrize('backbone', ['ultra', 'trix']) +@pytest.mark.parametrize('backbone', ['ultra', 'trix', 'kgicl']) def test_provisional_kgfm_pipeline_and_finalization_guard(tmp_path, backbone): - from dicee.models import TRIX, ULTRA + from dicee.models import KGICL, TRIX, ULTRA manifest = paper_fixture(tmp_path) - model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict(num_entities=1, num_relations=1)) - torch.save({'model': model.state_dict()}, tmp_path / 'kgfm.pt') + model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL}[backbone](dict(num_entities=1, num_relations=1)) + # KG-ICL checkpoints keep their weights under 'state_dict'. + torch.save({'state_dict' if backbone == 'kgicl' else 'model': model.state_dict()}, tmp_path / 'kgfm.pt') for operator in ('product', 'min'): adapter = QueryScoreAdapter('global', observed_mix=1, metadata=dict( backbone_state_sha256=state_fingerprint(model), training={} if operator == 'product' else {'tnorm': 'min'})) diff --git a/benchmarks/plus_h/kgfm_kgicl.json b/benchmarks/plus_h/kgfm_kgicl.json new file mode 100644 index 000000000..1c4d6a869 --- /dev/null +++ b/benchmarks/plus_h/kgfm_kgicl.json @@ -0,0 +1,105 @@ +{ + "version": 1, + "answer_filter": "corrected", + "data_root": "KGs/query-benchmarks-plus-h", + "seed": 0, + "threads": 4, + "archives": { + "models": { + "sha256": "d30b77a9c84d28de766bb5722c600bdc3c1e46d16cdaa3066ed4faca2b9b236f", + "bytes": 4507216854, + "source": "https://github.com/april-tools/is-cqa-complex#pre-trained-models" + }, + "datasets": { + "source": "https://github.com/april-tools/is-cqa-complex/releases/tag/benchs-1.0", + "checksum_status": "Official release API digest; extracted runtime files are independently pinned by freeze.", + "sha256": "bf60135d7b1bc109ab9d90892e318fa96ace905fdc8204afd270b1fd98002a80", + "bytes": 1675873193 + } + }, + "recipes": [ + { + "defaults": { + "id": "kgicl-product-intersections-{dataset}", + "method": "kgicl-adapter", + "checkpoint": "checkpoints/kgicl/KG-ICL-6L/model_best.tar", + "adapters": { + "product": "benchmarks/adapters/kgicl_product_intersections.json" + }, + "options": { + "beam_size": 64, + "row_batch_size": 8, + "backend_batch_size": 8, + "cache_bytes": 536870912, + "raw_cache_bytes": 2147483648, + "projection_cache_mb": 512 + }, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product", + "4p": "product", + "4i": "product" + }, + "selection_protocol": "target-validation", + "finalized": false, + "query_types": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "ip", + "pi", + "2u", + "up", + "2in", + "3in", + "inp", + "pin", + "pni", + "4p", + "4i" + ], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "provisional KG-ICL recipe; adapter not fitted; not finalized", + "notes": [ + "Provisional, not finalized: the KG-ICL product adapter is not fitted yet. Fit it with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection) and pin its bytes before any test run.", + "Backbone: DICE KG-ICL with the official KG-ICL-6L weights (nju-websoft/KG-ICL 6a3166e3), verified against the pinned code plus tests/fixtures/kgicl/upstream-fixes.patch; see docs/kgicl.md.", + "Prompt graphs: five examples per relation, sampled from the attached inference graph with prompt seed 0, identical for every query batch and call order; no answer-distance mask. CQD beam 64, product t-norm, paired identity control. The per-layer relation tables of every query relation are cached (projection_cache_mb 512, about 260 MiB for FB15k237); with the default 64 MiB they are recomputed on graphs with many relations, about 2.5 times slower." + ] + }, + "blockers": [ + "Fit and pin benchmarks/adapters/kgicl_product_intersections.json; it does not exist yet.", + "Run KG-ICL backbone checks on the benchmark graphs and the KGFM integration verification." + ], + "adapter_ablation": true, + "inference_graph": "train+valid" + }, + "entries": [ + { + "dataset": "FB15k237+H" + }, + { + "dataset": "NELL995+H" + }, + { + "dataset": "ICEWS18+H" + } + ] + } + ] +} diff --git a/benchmarks/ultraquery/kgfm_kgicl.json b/benchmarks/ultraquery/kgfm_kgicl.json new file mode 100644 index 000000000..2a0b3b337 --- /dev/null +++ b/benchmarks/ultraquery/kgfm_kgicl.json @@ -0,0 +1,157 @@ +{ + "version": 1, + "answer_filter": "released", + "data_root": "KGs/UltraQuery", + "seed": 0, + "threads": 4, + "archives": { + "datasets": { + "source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90#datasets-1", + "checksum_status": "Every extracted runtime input is independently pinned by freeze." + }, + "models": { + "source": "https://github.com/DeepGraphLearning/ULTRA/tree/427966ad8ed60420eef034063d44f3153addff90/ckpts", + "checksum_status": "Released checkpoint and adapter bytes are independently pinned by freeze." + } + }, + "recipes": [ + { + "defaults": { + "id": "kgicl-product-intersections-{dataset}", + "method": "kgicl-adapter", + "checkpoint": "checkpoints/kgicl/KG-ICL-6L/model_best.tar", + "adapters": { + "product": "benchmarks/adapters/kgicl_product_intersections.json" + }, + "options": { + "beam_size": 64, + "row_batch_size": 8, + "backend_batch_size": 8, + "cache_bytes": 536870912, + "raw_cache_bytes": 2147483648, + "projection_cache_mb": 512 + }, + "operators": { + "1p": "product", + "2p": "product", + "3p": "product", + "2i": "product", + "3i": "product", + "ip": "product", + "pi": "product", + "2u": "product", + "up": "product", + "2in": "product", + "3in": "product", + "inp": "product", + "pin": "product", + "pni": "product" + }, + "selection_protocol": "target-validation", + "finalized": false, + "query_types": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "ip", + "pi", + "2u", + "up", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "query_batch_size": 16, + "query_order": "relation", + "reference": { + "status": "provisional KG-ICL recipe; adapter not fitted; not finalized", + "notes": [ + "Provisional, not finalized: the KG-ICL product adapter is not fitted yet. Fit it with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection) and pin its bytes before any test run.", + "Backbone: DICE KG-ICL with the official KG-ICL-6L weights (nju-websoft/KG-ICL 6a3166e3), verified against the pinned code plus tests/fixtures/kgicl/upstream-fixes.patch; see docs/kgicl.md.", + "Prompt graphs: five examples per relation, sampled from the attached inference graph with prompt seed 0, identical for every query batch and call order; no answer-distance mask. CQD beam 64, product t-norm, paired identity control. The per-layer relation tables of every query relation are cached (projection_cache_mb 512, about 260 MiB for FB15k237); with the default 64 MiB they are recomputed on graphs with many relations, about 2.5 times slower." + ] + }, + "blockers": [ + "Fit and pin benchmarks/adapters/kgicl_product_intersections.json; it does not exist yet.", + "Run KG-ICL backbone checks on the benchmark graphs and the KGFM integration verification." + ], + "adapter_ablation": true + }, + "entries": [ + { + "dataset": "FB15k237LogicalQuery" + }, + { + "dataset": "FB15kLogicalQuery" + }, + { + "dataset": "NELL995LogicalQuery" + }, + { + "dataset": "InductiveFB15k237Query:106" + }, + { + "dataset": "InductiveFB15k237Query:113" + }, + { + "dataset": "InductiveFB15k237Query:122" + }, + { + "dataset": "InductiveFB15k237Query:134" + }, + { + "dataset": "InductiveFB15k237Query:150" + }, + { + "dataset": "InductiveFB15k237Query:175" + }, + { + "dataset": "InductiveFB15k237Query:217" + }, + { + "dataset": "InductiveFB15k237Query:300" + }, + { + "dataset": "InductiveFB15k237Query:550" + }, + { + "dataset": "WikiTopicsQuery:art" + }, + { + "dataset": "WikiTopicsQuery:award" + }, + { + "dataset": "WikiTopicsQuery:edu" + }, + { + "dataset": "WikiTopicsQuery:health" + }, + { + "dataset": "WikiTopicsQuery:infra" + }, + { + "dataset": "WikiTopicsQuery:loc" + }, + { + "dataset": "WikiTopicsQuery:org" + }, + { + "dataset": "WikiTopicsQuery:people" + }, + { + "dataset": "WikiTopicsQuery:sci" + }, + { + "dataset": "WikiTopicsQuery:sport" + }, + { + "dataset": "WikiTopicsQuery:tax" + } + ] + } + ] +} diff --git a/dicee/query_answering/_adapter_cache.py b/dicee/query_answering/_adapter_cache.py index 9f1e6404a..38dc20fa4 100644 --- a/dicee/query_answering/_adapter_cache.py +++ b/dicee/query_answering/_adapter_cache.py @@ -45,6 +45,9 @@ def __init__(self, model, context, *, cache_dir, row_batch_size, seed, samples, deterministic=torch.are_deterministic_algorithms_enabled(), autocast=torch.is_autocast_enabled(next(model.parameters()).device.type), device=str(next(model.parameters()).device)) + if hasattr(model, 'prompt_identity'): + # KG-ICL rows depend on its prompt sampling; other backbones keep their identities. + settings['prompts'] = model.prompt_identity() self.identity = fingerprint(settings) path = ':memory:' if cache_dir is not None: diff --git a/dicee/query_answering/adapter_training.py b/dicee/query_answering/adapter_training.py index e5faff228..ad0cfb403 100644 --- a/dicee/query_answering/adapter_training.py +++ b/dicee/query_answering/adapter_training.py @@ -324,6 +324,8 @@ def _bank(model, data, *, cache_dir, row_batch_size, seed, samples, device='cpu' autocast=torch.is_autocast_enabled(next(model.parameters()).device.type), scoring_code=scoring_fingerprint(), architecture=str(model), configuration={k: str(v) for k, v in getattr(model, 'args', {}).items()}) + if hasattr(model, 'prompt_identity'): + identity['prompts'] = model.prompt_identity() key = fingerprint(identity) path = Path(cache_dir) / f'{key}.pt' if cache_dir is not None else None if path is not None and path.exists(): diff --git a/dicee/query_answering/benchmark.py b/dicee/query_answering/benchmark.py index 6eaae3371..d430c0270 100644 --- a/dicee/query_answering/benchmark.py +++ b/dicee/query_answering/benchmark.py @@ -564,7 +564,7 @@ def add_benchmark_parser(commands): source = parser.add_mutually_exclusive_group(required=True) source.add_argument('--experiment', help='Saved DICE experiment') source.add_argument('--checkpoint', type=Path, help='Pretrained graph-model checkpoint') - parser.add_argument('--model', choices=['ULTRA', 'TRIX', 'Flock'], default='ULTRA') + parser.add_argument('--model', choices=['ULTRA', 'TRIX', 'Flock', 'KGICL'], default='ULTRA') parser.add_argument('--model-config', type=Path, help='Optional model constructor arguments as JSON') parser.add_argument('--adapter', type=Path, help='Fitted DICE adapter JSON') parser.add_argument('--observed-mix', type=float) @@ -590,7 +590,7 @@ def add_benchmark_parser(commands): def run_benchmark_cli(args): - from ..models import TRIX, ULTRA, Flock + from ..models import KGICL, TRIX, ULTRA, Flock from ..models._inference import float32_precision_backends from ..models.graph_model import GraphKGE if args.threads < 1: @@ -616,7 +616,7 @@ def run_benchmark_cli(args): model = kge.model else: configuration = json.loads(args.model_config.read_text()) if args.model_config else {} - model = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock}[args.model](dict(configuration, num_entities=1, num_relations=1)) + model = {'ULTRA': ULTRA, 'TRIX': TRIX, 'Flock': Flock, 'KGICL': KGICL}[args.model](dict(configuration, num_entities=1, num_relations=1)) model.load_pretrained(args.checkpoint) model.to(args.device) adapter = QueryScoreAdapter.load(args.adapter, model=model) if args.adapter else None diff --git a/dicee/query_answering/catalog.py b/dicee/query_answering/catalog.py index aae38d38c..d7d1bcdd3 100644 --- a/dicee/query_answering/catalog.py +++ b/dicee/query_answering/catalog.py @@ -35,6 +35,7 @@ # Pinned upstream implementations: method -> (repository, commit). ULTRA = ('DeepGraphLearning/ULTRA', '427966ad8ed60420eef034063d44f3153addff90') TRIX = ('yuchengz99/TRIX', '7596e14eefefe89e61396205a0550172cadeddb0') +KG_ICL = ('nju-websoft/KG-ICL', '6a3166e347ae468acdfb30a70a2cf3608b66b8f1') INDUCTIVE_QE = ('DeepGraphLearning/InductiveQE', 'ab49a0e64e3449e687e484a42269d9898e1d1325') IS_CQA = ('april-tools/is-cqa-complex', 'd1ce74164936a7c09d9147e83190da047cb39429') REFERENCES = { @@ -49,7 +50,9 @@ 'cone': ('MIRALab-USTC/QE-ConE', 'cc45b90e3cdce0f609670a257e6f756d28495a93'), 'clmpt': ('qianlima-lab/CLMPT', '6c4f3b8a5e052e8bc1c0c93eaed18ef869a1bcd7'), } -KGFM_ADAPTERS = ('ultra-adapter', 'trix-adapter') +KGFM_ADAPTERS = ('ultra-adapter', 'trix-adapter', 'kgicl-adapter') +# The upstream backbone each adapter method reproduces (KG-ICL with docs/kgicl.md's bug fixes). +KGFM_BACKBONES = {'ultra-adapter': ULTRA, 'trix-adapter': TRIX, 'kgicl-adapter': KG_ICL} METHODS = (*REFERENCES, *KGFM_ADAPTERS) # Methods whose checkpoints score queries without the inference graph. GRAPH_INDEPENDENT_METHODS = ('cone', 'clmpt', 'cqd') @@ -134,6 +137,9 @@ def check_recipe(entry: dict, shapes: list[str] | tuple[str, ...]) -> None: return if options.get('observed_facts', 'none') not in ('none', 'atomic', 'both'): raise ValueError('Observed facts must be none, atomic, or both') + if 'prompt_seed' in options and (method != 'kgicl-adapter' or type(options['prompt_seed']) is not int + or not 0 <= options['prompt_seed'] < 2**63): + raise ValueError('Only KG-ICL recipes take prompt_seed, a nonnegative integer below 2**63') if type(entry.get('adapter_ablation', False)) is not bool: raise ValueError('Adapter ablation must be a boolean') if entry.get('selection_protocol') not in ('source-validation', 'target-validation'): diff --git a/dicee/query_answering/context.py b/dicee/query_answering/context.py index 075665d40..72806bdfc 100644 --- a/dicee/query_answering/context.py +++ b/dicee/query_answering/context.py @@ -27,6 +27,14 @@ def state_fingerprint(model_or_state): return digest.hexdigest() +def checkpoint_state(path): + """Tensor state of a backbone checkpoint: bare, under 'model' (ULTRA, TRIX, Flock) or 'state_dict' (KG-ICL).""" + state = torch.load(path, map_location='cpu', weights_only=True) + if isinstance(state.get('state_dict'), dict): + return state['state_dict'] + return state.get('model', state) + + def state_token(model): """Cheap mutation token; inference tensors cannot safely be retained in caches. diff --git a/dicee/query_answering/method_evaluation.py b/dicee/query_answering/method_evaluation.py index b7156ac00..5a83613b9 100644 --- a/dicee/query_answering/method_evaluation.py +++ b/dicee/query_answering/method_evaluation.py @@ -260,11 +260,13 @@ def deterministic_kgfm(): def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_prediction=None, reference_batches=None, on_control_prediction=None, *, limit=None, seed=0, query_order='relation', rank_trace_path=None, filter_corrections=None): - from ..models import TRIX, ULTRA + from ..models import KGICL, TRIX, ULTRA backbone = entry['method'].split('-')[0] options = entry['options'] allowed = {'beam_size', 'row_batch_size', 'backend_batch_size', 'cache_bytes', 'raw_cache_bytes', 'observed_facts', 'raw_cache_device', 'raw_cache_granularity', 'relation_cache_mb', 'projection_cache_mb'} + if backbone == 'kgicl': + allowed |= {'prompt_seed'} if options.keys() - allowed: raise ValueError('Unknown KGFM execution option') if options.get('raw_cache_device', 'cpu') not in ('cpu', 'model'): @@ -272,11 +274,14 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict granularity = options.get('raw_cache_granularity', 'batch') if granularity not in ('batch', 'row'): raise ValueError('Atomic cache granularity must be batch or row') - model = {'ultra': ULTRA, 'trix': TRIX}[backbone](dict( + # KG-ICL samples prompt graphs from the attached context with a fixed seed (default 0); + # options without a default here keep each backbone's construction unchanged. + extra = {'kgicl_prompt_seed': options['prompt_seed']} if 'prompt_seed' in options else {} + model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL}[backbone](dict( num_entities=1, num_relations=1, graph_inference_backend='auto', graph_relation_cache_mb=options.get('relation_cache_mb', 64), graph_projection_cache_mb=options.get('projection_cache_mb', 64), - **{f'{backbone}_query_batch_size': options.get('backend_batch_size', 1)})).load_pretrained( + **{f'{backbone}_query_batch_size': options.get('backend_batch_size', 1)}, **extra)).load_pretrained( entry['checkpoint']).to(device).eval().requires_grad_(False) adapters = {name: QueryScoreAdapter.load(path, model=model) for name, path in entry['adapters'].items()} for operator, adapter in adapters.items(): diff --git a/dicee/query_answering/score_adapter.py b/dicee/query_answering/score_adapter.py index d4da66654..911352c7a 100644 --- a/dicee/query_answering/score_adapter.py +++ b/dicee/query_answering/score_adapter.py @@ -15,7 +15,7 @@ from torch.nn import functional as F from ._deferred import require -from .context import state_fingerprint, state_token +from .context import checkpoint_state, state_fingerprint, state_token FEATURE_COUNTS = {'global': 1, 'context': 4, 'context_scores': 8} @@ -228,9 +228,7 @@ def load(cls, path: str | Path, *, model: Any, key: str | None = None, checksum = hashlib.file_digest(stream, 'sha256').hexdigest() if checksum != metadata['backbone_checkpoint_sha256']: raise ValueError('Adapter checkpoint checksum mismatch') - state = torch.load(checkpoint, map_location='cpu', weights_only=True) - state = state.get('model', state) - metadata['backbone_state_sha256'] = state_fingerprint(state) + metadata['backbone_state_sha256'] = state_fingerprint(checkpoint_state(checkpoint)) adapter = cls(payload.get('feature_mode', 'context'), payload.get('observed_mix', 0.), weights=payload['weights'], metadata=metadata, bias_bound=payload.get('bias_bound', 4.), scale_bound=payload.get('scale_bound', 2.), From 3803a82275146f23cd683612482b446264e671d2 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Mon, 5 Oct 2026 23:03:48 +0200 Subject: [PATCH 27/39] docs: KG-ICL guide, zero-shot results, defect effects and speed comparison docs/kgicl.md covers checkpoints, prompt graphs, the official evaluation protocol, training, determinism, the five corrected upstream defects with their measured effects on five of the paper's zero-shot datasets, fixture and real-graph verification against the pinned official code, and the provisional CQA recipes. The README adds a KG-ICL section and its zero-shot rows for all twelve datasets, with Partial pretraining exposure for FB15k-237 and the NELL-995 variants; docs/kgfm_benchmarks.md documents that exposure with exact overlap counts. docs/kgfm_inference.md compares warm inference with the official code on FB15k-237, WN18RR and YAGO3-10 on an RTX 5070 Laptop GPU and reports query-evaluator row throughput on CQA graphs. --- CHANGELOG.md | 1 + README.md | 45 ++++- docs/kgfm_benchmarks.md | 56 +++++-- docs/kgfm_inference.md | 81 +++++++++ docs/kgicl.md | 364 ++++++++++++++++++++++++++++++++++++++++ 5 files changed, 535 insertions(+), 12 deletions(-) create mode 100644 docs/kgicl.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 61d8316e1..91f3c2810 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Sharded checkpoint save/resume for the `torchFSDP` trainer - Adaptive Momentum Weight Averaging and soft-label support - `--log_level` CLI flag; TriX model +- KG-ICL (`KGICL`): official checkpoints in pure PyTorch with seeded, batch-independent prompt graphs, deterministic fused Triton inference, parity fixtures against the pinned official code with five upstream defects corrected, zero-shot benchmarks, and provisional (not finalized) +H and UltraQuery adapter recipes - Complex query answering (`dicee.query_answering`): CQD beam search over KGEs and KGFMs with learned score adapters, negated query types, native UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE and CLMPT checked against their upstream implementations, and resumable filtered evaluation with exact expected ranks under ties - Reproducible UltraQuery and +H benchmarks (`python -m benchmarks.cqa`): frozen studies verified against the pinned upstream implementations, a pinned Docker runtime, paired adapter, answer-filter and inference-graph ablations diff --git a/README.md b/README.md index a3912202f..ae7cac0cd 100644 --- a/README.md +++ b/README.md @@ -722,6 +722,30 @@ sampling budgets, reproducibility, training, and verification against upstream.

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 PGLtfsYXABF`q}>nYNR0S literal 0 HcmV?d00001 diff --git a/tests/fixtures/kgicl/tiny.pt b/tests/fixtures/kgicl/tiny.pt new file mode 100644 index 0000000000000000000000000000000000000000..a07f43af452e1f6fdcb6dc9892e894f4254f49f4 GIT binary patch literal 394189 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

r$lRzj-|bPj(8S(qiD-+{w8c#c`>(xXD$Db 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�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⩔q8l<6wKe%H`(}AksMEsCvdw0c{+^?=*X$?(i*#?bM;_8awbQminZ``0Soex_h%ICLRttqYPVFZe zLwfAT`L-3eqE3 z@`B7o@%%>X|M3@wx4c~bf8Z}z{(pYOaS&L4iV(=<+6#0GHwY>$776y#5JAuI5<#ht zlOT<6<(_R>CJ3yJ5ZGNjBp7jX7mT%;E6}*LO32x~zd-E7Y{8ZQ zCxJUS2>!|J5=_~+OHlYZT2S3{M6hr-BM{rWLZIdADrk4~6Ig7r5tyB`7tAUP5TwoA zA;9)Cf-4Pn0xmD~R2`P_Qx1 zQ!u64NznLmo?!7-Pr>C2rh@-Hzk^}6`~MHm&+32Auli^X<~JA76=xKw3RmFa5TC?1Y&W+aV#rRD0I3hROuYt0*LCD~{s$ ztNKi#%a4^gkHC|f-I#lOB zaHjip%n9;f(V0ECYR*wXjD$9N(0QyrmS@{VX0iW0zv7gok^leaH+9PYo?lB;17Q~= zxQrzSvHHkJxS^E>L6Tqa>xs2E**h1mjBAF@znw&XwkWPQ{0)b+LOJP^m+1Rf%kaDM zY0&>1Aq?2XXUw-e#U{sb+~vU?aOyz_Fn872TD_Fk>1#oE>N57gQIxIT z9}h7DMfj;`2B_cRpK zMPjINE@=o^&OVxlp-Oif>A0#7EzOEB?!jw#?B_wE1Eg3;Q66PU_ViBqc5a@+1mWIe zU(qa^&|Q4)EBM45_@Zq?ToXoNj zrh7+8b1*)i%t+FLn4wydFy9$>j7+5CSMEkZd@>Gg+)t05nt_e~9f84|T4JeXPr|Hr zlkTk}L9#V~+Ll&=eq{#Uj}HKuZAqkDT8I06LzWovTm_$3cj)I{Ie6JU5TUT4uH8PQY+VS9j48*&$4MB{5Xquj4T*bhIl86JAoZdA z-MPD3ctGW#@PXYn(%ytL%v~Nbv4Y$$Gza0NQ>Z0#1?8+R(3>mA5SzjRusbnb7#RA5 z{(7SeqMw{uw(BO`^rnkcuHjt@1^FaY)*gG8+{Ud#m%+o{nC+<$;arSj@ca5+*rGcm zl-fB=o>@)Aci|t1`Rc2rZBIG6^7DZ=ZnL-zH%0JMiawZdt1;0v8;&fz2p<{(h?RvE z*Bn&>@5w39csLd64maS-@h`#mu@|Xv8HZQmHV9<@Gld`7W?TqyXO1rx(m!{+aL`$V z3;EfOz2#r3LFowVHS8=>7xopE3+jpNB1b#5tqP>G+^0i0mK3a|`(V!58Wlds;EmEscz(_r4jv-miqf8)7U zcAmnfnOT_F^M&p@97T1#m(h691t6KlJ92mjbawt(JfSW}HNS;JjmT(l`(}^b_EXsW zbq3(LS%hU=7m&^=xgdJ9Ug)wl*ycj&T->GGgb%mvgb?17ILplm-6Zn`8{bHv&$G{P zd7ljPRIU&tcowq0TyOg5aw#b8^u}!~)Y0bSUR>(EnWSi#;-vA;U|pDk+dTO*WSK3r z7i=e4qvR1T?Lkq6DcqtCbB=qonm?O&(3^(8aVV%B$4%1}wv z`VSk2mCr%zM;wUusNv5Q;h-?*IA_{w!E9b!hYw$dNYcJ4`1K_S&wQT%we}0Jra^?; zAvr)7c>I7Dg;wnEE^#hClJBRwYqBwePQnjAghKtH|4`IVl6~A$D69&pgP$wLawj`W zu(P5Tm7fekmt7OlI1`Ogxpl%<`^|*52Njse<^e3)*p0{DhG5PK5k}V_Q zw|5H9czu42Zv3f0`j?22H9Y(6dx-+h*f5DL>Q_P*XO8zPDusTb*HKyZsZhLUHM6(8 z0C%p+Fy-(F;%#x8`xW&Le#U-5I^BxhPlqGoEW$-bs@#HFHEzLUJ67kSh~7Kw z7)X!8aywaY{yLi5)!7c}>eHB7j|Nxtwv`>SGlty_rubS*iP_lSKrVI&GcPV-KfdVV zrNG%ts^k)erE79|d6j6baFM27OUFxEXJDpV2AU7X3cgn#g!LYmsUSCrlazme+ZW!3 z2oF`xvbPSm<=sP-XEJPKSP!08DuKcc76ON$9qhfxFAN^Tf9_U9sC$j@4lug&rV~^sv5emc0Kxi_8`vtm*KYp-b06?bZ}dfhaTDN{kI5HTDW`yVdI<@>8fF1UV-Ix4@?rGJ|H=*~ZH=%erz z&}ip}LX~p7dglbXiX8{90b`!!^NRdk^oD#9DB+P${_te;RYB)01$O1z8*A64wwy*5 z6=d1-9FfnzNpSjo%${V-mB~4g_M4G{8xJyS5!1C5|vdvTx zr_H-TH?P@@?`_@jyv1l1uIobOROE!(j{JV=|?KOcIoWRHtXZ|^aI&dGw0g{)#h5KhBX-Y#9CpdVL8!*TNSu;C9d}bJY zy48%$f-GX13O z$5os0CZ4eIzdC_-LW@wfyqvUX3MPlg1VbN`ZU)24B6{e4*Rp*XTlX%5T{&|_VK|6AlGZ+sF~wuV{6%0OmQ_(D1ND+|$|xG|o@~zjdp@ zn_%Th$}{zE5eqsMOVTSU7n?_8`-Zz)0N%5exDGa6a{P5n%TIgTv3yuCZxb>(R zf1V-idxaR!p5MSe=q7{q(n-W;`Zefqv%>Q-pXeVie{S9WF+^_lYfR362k*p6Y1{>8 z=I(PC^Bu*w;o^4M_h>pe-ALg)ZtKwl*Hhr0k_`BCjS-sjnd`h*FHSaAhBeM@7H~I!P9bDg~H_(>)OigCL4R^Z1#RgO!Gg-u6o z;H-oeoBsJ5M5P78i^eA0`$-O$FIHvmc8W2nilNFwdC$SAx0=s%4)EuqO{}xc2d;e^ z%|2~Vz{MT8Y`Xn_ba-+X+evkIAv&v7ubxOCQLP4~A*3i}2=~ zO5E=gPxfibbH^4xp~K-Jpw-E6?x6!vqWlfr{^XIab7NWHX>HE_M*s``4(zYt0RH#4 zA6{-aOWW70!OJNHw7n+~->FPwK9WP=cqARdFqMDb?1VxoF|Kx8IJRt7V0*PTv$Y{R z(B_UfyYaD_>^|B7w^NfLJ0=qBx|Sk3hLel&Ik>ApndN?2k3rinz>{O5ob@>wl=#p= zkNy3|P03HLgn%rFG^ ztm4o-Aq_T23E1k}xm?xMT;br*Rha2_lpI>)f*oqdP~r4B9PgS&lPc07WzWybx_8r< z=`=oDo83h&kAFdWwvM9hL(#ap*a$+`IpWaK&#-F06$Cx>;FeiLk%U9qIJ9aW-gs}v zzQq}VtFHoQx|UG76q2G;1SL~ zJHB%1l^lWLyhY%aEyQmt+HlwDbmF`B8H9PraPbYj^sv$)NZBVthP%b#gZU+Pt!D?f z;7Jozc)Ez2@G=yp%c!%q6BMRh7Yf?9H-ckZJmk)JgRCn8Wk=m2m+Yg#R!M<59T|k? zkZdwvI-lNh&xMTpJK55yr(mdaJ&1qYLrvvw;Fs&EblaE5a66z1L#@7|Wxf$Tm(>jN zGL6`uFU=aHpTRS=DDqZ5gt{(PVDqEf$>|6ea9OCw9b57cWQ!=2%=rajDxyrYtp(1n z5n*~KGU(i<%{cD(0G^zEk@qkQh~+5}Nc+iWV$%%q-M9Dn^ztj5YQh8yix;t}Y*DtKm1@{Lz?aNPB{rT_1^x55v;yQcU@D9@Kaq z#Hi=;#G}p|zR#iLr|N8Ld;b5`=4>NgXt&256E7*SL2OLS=hFMpXXK?(x39VsL=Hb!!0ezo_s!+)PIT2^*#$b-KKE)|1JYJSc1QI zuEl8$0`$CQ2*=JQppTd|8@m#T;M+Qgwo0Y#dO9evVksz}Nx^H*sj#os60~;n?uKv) zR^)9!M(gMaj-(l|*gy_B(PDUPE{3D~WU(?J7Pe+xB8Kg8w5&#h`7VgS7fSCjvWI6; z?TJEzvHHwm)eO9T5QK)jkHqzBHryQW2lW_bSiJBXc)E|mig6>L|G5a)FzPWLf18F^ z!&5;#rxUj+?txP-=je*lp`g4Y3|33bfx2fpeD-l7JDh$7R0IQLTwgb`N7`U+j#PTF zCNbg0lkTT&0*Cz3c*s_XyT21@;=M`4?irtJ?@NVs{+sC>_YO){8E~$*!+37_CT>rw zJvSm&hyGqSgZylT!zEJ&q)?fc?aU`rHgT`j0#f` z7vcUC+(p+?aW)YAj<#Qlf^i#5fP0of>zC=W>K09*tIvIq51z%dmPPPGz*hvCs7Fmu-| zX2*NOmv~Mhd(L@bA-`WQe6@&af0f6rFLuG3f;Z^Z5J=C&ey6KM+-a>A(p#E}>yk_sx*l5xWA z4m=yAz!gM%ChXfRlu(smm(Q<(%F+)s`x)=KNKj=unaZ5pMS}@0{p>2#k^_*o%)+iN zV4-J6upI^qxqD{2;qjhYNT}I~*Um+96aSiW?BH(BcotIMC%m`vS{`<+(xr>Uw}2Ag zR~J+6A$!D}AZuhU*c3Uz!tyfW^depOd?}xE%eUh6Zi%o-8}GxKXm6_b>DLpv0;4PG#B{L}6grd&Eq+iOQ=co;t-Av5r}mpgA7{@AB3>0uAobu7xLQ(L&%57urk^4`(=OvZ-4S@|_D#6DAp|B~+X-tF z3fKV!SFXr!G`Gc}1a$}ZV)LObl#MYZKfN`$?~lr9sn`S@=xro@W6gy74g%V%Rlv4U zUvQq&2((|W#Eo!xK*wLJrB4r=c}?HF zmuBvI75LdxjGe94XO$DrL44OKOidjLXEntj@#iVQ#%dRk^fzFuMywDlw7P~Pt|E;~C0{MY0|{-iT7v0?@e zCbgsWL?tlEs>1cx^`S%>B z`^54YtjS=tEFD9{Jq4%Q55mM!PpYhD&Jy;>GM8;qobt5!VC!x`XE#nmAID+z&0m80 z3v5w)t2}wZ5J=%e8SHBbKtzn$1mOy;kkAA9G}&!R_BUcC?>_|L?_Abr?6 z;u1K@dU5Z~8z64J3Jgmmy zYN7A@0dhnAGI?(s3~xR>AmeHRq0hpW4cr~U%@HVaF%?(g(7Qz#Sab{&@~+S|#v6F1 zS_V!zWdQRf^1!0ut2R8S56{&N!^-Q0<;d%|EY&qnld zeh)=KQ^EFj6iI)(2R)tLg~1O;LS%jiek6&I>OPY_)sQwo|s( z7}r1I9S{@xVXT=gwN?{>L&3GZd6+LvgTrgvU2;3it$EG1wT;}nNJ~AD{4Q-i<6RIYm@cD5v_ID0mSx`m| zgN(6sHHFHQae#$O$tR~!*3IXaO8+DZ`zy(Ywh?_~!~H$j(e z&p@g5G(J;(M)r-6;KCexY4Gqr(z%e&xt~iV^{?vaZrhXS^z0wWyBv)Wun*IZbzo_T z2-p8xfJ?rQtTgUfVKe?|mauqZHBo7;z_jOT=$?Oy4tObGu$u?mI9P@{AN5$1-)>U6 zX(E}Pvmej!88X|DS0EQS9#VPVwUtXU4*Gesa`RMJ+;d`r9;_wmM_-~EarV?2ANR~_59z)lsJVmS4 z95hH*!)Nb8iOGR$RLssEuZ{VF4dz;qHTn~5l$OSjd9iH2X%fyl@|E;d=Yn6`XMA+A z6voV5i*IZ`(2A|Cke+Hlz7+Bvr-Qs7BdwokeVT{MWdTjz@t&fr9IAZnF)a-l#tMNh z{z*Il?T5tJxT=Y4r@>LkT&WIi6|tma)dmO~$#?WO)qwEl9jt#S4cgH^!B%h)9~^s* zzKyM*kZuYK4HDqik5eS*x)oRQB8&>AX9iB= zm^pW`BT|n)dqzR~?^QHX|0vqMwxgz6i@|Vllpvr;l%}VNGWR?)RF3`uan+~cYR4V2 zFW0g1ytyb-j}zr|L$%onJ2P(a>k{m%PeK*jGIFsa4x*R-hff{O!?UaUB-P23?*#rw zmuzI{eK-SWyAML^69Ji$a}5n&KLhZMBC)HixJeSx(Eq@b^w$Z1Dc(d|lec8#Tw``5 zM2)G`{w0l7vJ5O`U}LKvh~9k!e1H@(rLW?3u?;|cH(+<9EMB`cjjN~#!X?|JNczTn zXz}Cu6NyjBmG&=!nf`odIa{A+C0SArl_|7)bOH{~F=oHBs!7V{r}!(ckAAU~VLNJG zVn)|&2-z4zJl^j^ThVi9o;Mi+| z=!Z5VY;+HU*+#kK%(!B5X0`>?IG2N3!xv~ZS_|LfZ8-BfFW9tm5&RjbryK4}q}q*1 zutr)PC;YuD+!Dy=DfZkaW(On%!BcP3Ak#9s#L*t@c)v-m-(1Xo7KxwYW`J&WGPtOo zr<-r2L7t8U+tHN6ciCjP4`qH(+UCQ~E)mKi(YYC?2QcbrPWQeBSx@@0TTwIuS!vmDEvX@d@mdv9Wn=y^8M+Z$^m; zyche|1F}g$NY+W6!t)W^Fw$cHM;a%P5ppV|$1_f#=M)Q#N#BL(B5k%Kz{1}~=nc&wqzzpBqu2d_S*&L7_qKShuXou^gieBX`DD0aGi}uZ8hTDT! zOvZmWwXq9)FZ99jzcqNF*$Z@n`FFv{Xq+G&gonQ;kX7zBFxst)21u4b(?Ux+-*qN= zc`A%Of3C~=UaiJU^8dk98Gj6Ph(!Z~OgNKrn+i6+hsiDpFvI9R-Fhq@GVD&XgVx!w zBR>(ZbuC0~6(mRRDRM*Kc9G}XF2Y1J5xCO)giNk^27BMBVN<9*bCrJxVn>$2E&pUx z6kA6lw^w29A$3~ZY)l{OjNrXnzregzj5StoMSt`Cn4#o}SE_EK+IEip2|S2gM;-4= zm8(n>xya80g3$e9J~VYM<+@FN2m&wq32u#=j&GML(1uMBV6m*y=EbK07@w6qrh|4RN62BVxh#Tx(WJ+Gl~4J@$5#0CL9aePi%`{ zffC=-bnrhz5+};Au$)$Sm%S6Mew7K|NY>(RDF+nK530C&%mP(nmO##jAo#k;4!2}d zd{Co9FRq-#3@vovyP`8rk?kY)_U~zM#2D@#pG(jFIgymq#=_O>AIL?MTi{Y(0qQO7 zeDCiKom77iU(EQyW7NgSoli4yS!^oU@fljpkQPDf>Pz(Q(IPs^Y$^TOy9e60Mu5GE z5&CU;O11u*Nl(>1$Nf%voVI%!%=SGBM|&ED<3gT*!#-6yq3Sk0&gVgjZ+X&zjeO>Q z-)%m(FT<@YD~7utOgJgIzqEhBNEYl-iT7QAJA77OuxM%{l#P>Qp0mQ?U;J}?s*w## zGKWy{XEB6m$Fixrlt8>CNch?%1ujmv#JQKcK;GgC4kqW|?%x-%{(v==mT822Y8?a@ zCP7X@DLs-m6Nd*)n7I8p^8RTTcC{IB@ivjD>#54!ekjRWRr)Y;^HaDw`71i{+{&3Z zO;}D$0<3R83lnZAv-b1vNS#&>tk;~zNk~lvnaS@lxU~>#$KFSeN$qH5Fc#A~?m%mc z7~3wf9HsbOK~7R3+ALGR!f!ng%_wdfcnvqkeI{4;R8_t*{YMVON(v@iXvhBd;V{SG z3tfLbzx>zaS)iUELH$-aW0G|# zijv66TkFoS^D!c<&HW?W?lKl!PyPVqb4&3|trYiA(-NQUx1h6U$B-M{``|w_cMdmJ zq5J1%C>Ga*!C6-9l`q(c&Zt7MA5ZW?PB3S9_!C+b8?pz_0x==eL9p$kHs{d<+-sFZ za7*_ueo;{ZFxSH%K?F?OF`eU#)`1`I$~xoiaN^$( zswA6$rpE+){lkHZZV2Xb>qg>V0};AnphtM|D~D3k#$sc02KtN|#Z;xFxIM45nX9iR zCi1ht%aeKEir*OU>U1J^6?S0hrC+4E|2hrzk>`}kGO43k4EFZM!DC$q+|#!X>-FWi zSDqT2%dR+#&Q?Hm^{4c9-&p**Y7KqZorj__l5Ek;xuoUu419k_1Ygw#3quM{(c?En zse4v)MXcXLc)C%BODH;DSv{+n_qaOZt0kAma=r|-?Ex!)a-lhuaaXBtHn(wDN)xx}Exq{*A2cYwj5*)VM z3~Pj!E0|2)2o78vh#U>=Hcw1YGgK2&$s;49{6jMd{UR;jZ0ew6r%DW(Hq} zt`Uh~wN@H8=7-YY-Ul!&x4+WBGzgU^t%GH6T5X;i$+KOpQ_;CC13dL=tgcOw;&!gI zhm8FXNaXM>`e*YvFtS^OvXc}!v7@8#d}jsB?ctfF+ZhxEn35q+Sun~R4U346aMK1p zPcH{2szpMS(eDFfUdT*Uvq ze$$d&Bbcqa{U2YROo(=+kqX?}n!_P|g8# z9F2rtT|elmTHbdw(*f5nipBu1qx7cRNUUj(1?PvI^i`cT9*iy&MDV-=Q%4R$<9Vil z31*iJ0rT);LEKYUZzH$KPa?gc-3bo*im zpCk@kqB68oAHmgtQu1x4GUV2+!ws8@Ayv=>`>Y({ex?9T#+`-%=R{n-`81x%rZ7~a z&#FJarE<%s3U4tDNc%QVF#V|_PBmTtpC5~}%(WdTCZ9lFPWKn|8VK>`()-ZS2+S6vHi=av1H=lo5qI?cpLlbV>& z%}W%Pw~r)G_@0Ssf`GfcIUZO1=g39<*8<7Q_Oi*wR$zI55#(l=Gau~)7#dj4MTND& zj%#gTmV5w?nVDkXQU3igED37Emr1Cf9OI)5_^dHoSbbL2AR=^K01p zhi8){=i}0-A{t}RN;@R7v3~4yZpyO9psGKa1yABV09P*2QDO32$dW1;K6L|H{<=WY zGcl64e;1pXSB}-2&Vy-86Df4ahADf7Y2h}ZV9BjXaA&?Tvzt^0nXk5Caz+9C8g&gV zp4q_R;YI9^jyyE+d%=C#OX$G;OXSYjYgTLbPbZ&On!r7`<)ED^&7Qw{gWofaLA03P zw|5J;Witk_`k6cZr4dW#y{v_pDc8VjN-Q|ihhVV(Bjtw5Fw=4}R~08<>JJpqu=_O> zF6tBtavN~pM=LJ<-30VheE`bk^4!|_cS-1=B}vrnry~ERaWfCShW%2N5WlEa_+-a& z&Sd2p9Olmh$e#(N(-HqF{Ge572Qf)zH&rMaz^&pwxNhrdl+&|kQ* zW5xKxG>Pxmsvmd4G8l<1og<+qgptM@;@mo)HNsc#UO+bQnVGsgQgHU$FwSiILEGD{ zNLt<;Owu{RMkTFcA3c*PM2uuYpUFhV)`Bw?m|H(Oh;V&YD9il4oOF&`D2R{O)wSqCZmDoG=0$kj; z9U{WRKv82pMBVj9O`nBObJP!ITiuYo?nb$B{j}0)IhW2m`+{?Cu@&PNqnlD1zIF;g ziP?O&UGg0i?G|TxS8qU~e>K$XC=u>GWoS^CM#{nl&BA zcCCk7ZjwUZJ2S9EJr`qC@8h%9N|3`?;mOf5oI}SKu;tmBGdd^2j%CMSwADd8e6txB ztE+L7!lbw?t8QA5umQb)J;x(O+fhR)9l~!kld0ofS;(1%@axWEZiaa>ebpX<|IN{b z9T%#w{Yeh`?zsY%hdo&lKkM8ZHN(c-RoQJ9arP5r^P&4{(y=7FoJ7Dl?7;NI%fSaU%JcI>(bTQcv`Cr@3O>IGBS zxwV&;h26$O%@@d^;4!&9RY>+uZbtQu3S7Lco(-f-x`#jy`{Zn}SDh zb`5$c7vs)C7qpQ#38!$pg`u*Cd1 z={C0o=5mtE+iQp~XD-2#gZHWB5@&p?9>DjJ%LTXc^GWF*3079A1Dt;hm48!8{w3Ss z=<27mHD)h$7%&iICy2sZy?*-GCJ@%d)_}yCFx2y!Pb=oR;WvJcP_%6?`N$=ZX%D9f zCS96KeJlCdxKkFnyJa`uvzMfO!D`rdwu(mU{0Ck$3n4vaxxnzsdrAU#^SSTuY+TE0 z@aw%K81z^GEcpnWx%N=lye*te+PM$7idvy^=L=zZu_nY$`6*Cu(8no_4#f3%D3mT- z1aES*ap8yzG&~^<4`f=%k%LFrE!{UnM@^pf>i!@`VM?$kw~t#fe3E&!9%9Q5*a|=Y zAUJ&f5qMWBv&;@prgEo}vkL!tv?G3!d14W8?z zFzD%1xa8=J$;soHzPTOuQuHLJJxzjZNK-@$wBWjijk)!+958702-0SC3DI!QJyXmmFW1&(C@9HUe`u>4TD0H)sv-RQ$Rn61MQ3 zp`FLh;=JQLyXLwQQ+;$BNXaJ~rkE5P<2vG^o09(10IQeKLu1@A*U}# z2@~I)gz$`&;POcfxbvH!X{|PXb~^z*rUFcRT1NUd2b0{mr?lz7CeYn-9*_3wv$a=# z!`B`MQg`DdX_wUnr;G-ONQfartIg?ZWi_-6%%Nj_=W=!DErCh%z3;4JY{nx8XniCu z*q+u1SwYFr>7EDS9bMqE`U(g)6Q0YQ5BH4vVNd@9x`Xw?A+;2cvw2PT!vnG)S7w|nAJ~SG|8nOkQStf8$DFW7w$$~WrCGgTYajvvCl#a48!}o#Z z_&ZdDJ-PFfPB3x7zvs;0N3ki_f9N8_?%IS-mjmdTR%O#9cvUE%(Qf^^BvL)6m!)ci2e40jFFURBa zh+R;R;V@m!l+(SzGeWi>s%Wkr1OJ(BLSeiLR!nvzBma8~ZmllR{ADCHoVt}OU2V)M zgx#>N(n*HUlM#a9CK2{fM;%AjE`ddg@j^^4A!U!+&}3T(-jE-Mk@r5LU(zRGRJIW; z-uMsR@biSKh-aXkNspcnZSmn*1-llZw}%D# z`MjkU-l!9+@A;&DN(jW)s-xJ5VR-LcD-5E_(39;4UhT7p+t{}>|B5ztJa_=}(teTm z)#i9`vj+Ck465!qfU+l*x$_l>9>-jW!^I^0z3wvo2cdB0gan_<9YmXEORx`#2M4tv z+%w@S@6o$YG(No(RK|b9OPLq&nfDEpn#&)VH5P%x(*O$E9fI!NRW?d3w-MP8E_BNx zD$nl;Z@oH;FKdPH^5Nvl$NhhyT}O+ny}JZ+yJA6o>R&inriYi~#xjfgC#YC54|>-X zlL?lh_om&m=9l z0Q3Kjf|O4+0{c{3OqLGDRsY!&eSUv-b7vQM({~*wev*b9I-c!zZQ}RijWjykgU>X7 zBUU?o;IU32#JBPL%+OO{c`h452PC-0*75AMK_z}WZjIl{=AusXO`3jyLt717;Th%e z==P#%6*A;F17-}R;txLOJN4Weu$bir zCWGqWpmdRREOvx-25Dq(-fp3F?+sk{K!YqTeT#Ox3h+b8U-;%F#RkpPasGfc-U$Cl zUpchGqB#XnHYpz3l4G%VgeK=QYafo5xyXBx0N0!6()@^1xH#c89o{$wQ+|}eHeVSo z)!CY59sejCIwua@DPO=lJpeENDWq$3&O-6jHNy9b@=eV6&k4wV_r#(59 z5?s}pEPQb|4dwnkhcRUdp?;b?SGXby52BO z?J6!bT!dBqop?WY8*^Ls9GldtP|;!xGm|O@o#IK{)XCG~tW5^cALiV}ICZL0?}=yR z&p^)F6Hv5wFIRdZQ;_(Jr)fTEq0@{l|36 zz_Tuvhtd+oA8=^E293>i>A4>h@PWZx4C5JUnFWS?ZqXkvTkOW0pM{lIPkZ31k^@lT zvJO+sL#emPNO&S8%~*T@Y8+sKp_X2pC3c!dC~UB~F)L6Iq3P&VHlAl{casRJ{uw_g)YR{a&Eqb;ae-$Zkr>Dq3_lWVhcmFOp zdtCz`>FBcjK^1Pn$wXTARtlW=9T(GLfYz;A^p(~rE?-JBcGEwp(`x|9fK zyW}0{Sn89?rYiF0`)GJ}yofH|JszX~oIx+48B8AjN$>55f%AhSS!(NLv^{!D(7SUH z)(l=E-Ov9BR=FqQivSatB5QygG7gk{IE(#;I%hN7{7ET z?+jUn+KcX2I*tAZ!QS`jV^Kxqe4M$Y{$X<1;4+q;=%dH#uF*gIoKe}_7HbbA(!cxb zG3wL=Zp4|1XmwyL)_s=a_RV__u8Tu(cDpM3eA1t_n@Dn(N3MlW(XzBSx(edbqH%aY z9QJMgM}8(Zg7%JGQ2V?e{l^`ov9~mtY+)i6JV}AgNxV<9H32t_N+N6i=)(=o*Odwl zIWT1mgXtY^yaz;-i@33!t$nB|aIG`q3_24*^=A&auT&;hHy7hTff1K66b<*~%dNj0 zTSiKQY~Y>O5G{Iqo!xr@<|r^c2+YR6~jXE~xvSO^@#^fw#-$SX^xn%6!yia>|XoOG1i`X-pGQ>7amuY@q3(2?aQ}iLsxVuclRqtm zdp@?Ic9ko2+S&pA>kYWKBPP*m8HA8Im1G8P#64?AljsG`!Xy((I&J6?z7#Bh^jFWZ zxN9x;)m8C#a}j3RG#;w1hQRtRF+3|QrOR&Wq07)X5IbK&Pap6{m(w@trH~Wgf29Dz zo_W*W)guJ^$`{#`N(*t<-~R+|l=m-0c7eq_2l8p=9^8K_oc{9l!s(j*c(17y#Y_JP zo%%C``W02szd}fp=kuAz+PA`!S483Kli8#ZOW{Gwa`cGH6Bt=1)1o6C5OQNFT@d>g zcP|N{hWs6JY-|KbWM89I-xb($&s{ugWD;!lZ6l|w@4^+;9voKD!!rf{Fi$g%9x2sf zN2BD}zmG|v6+RxyQ)>?Y<53`VYRx0p4R>PQfm4ugy#lt4y(&Dj`Z3&!mSwdzS#YeY5yvFR zaelKpp4lsb+*6+v zNU;k-zv^1d>pH?BE1YS@Mp=9nsmw+?S~IoZRW!@ok7m89gPHvY&|99rKk%9086g~2 zF0$dfLyfqt=m6iJ65x%?XYq-#Dp#)%f%kq0F~PAMFA0P3KW+vrSaSnr8E(hPVL$2F z$z$;F%KO+mlY__C?P1m92tmuOay%lf0|A}>Se?hujO1QZ^Ra=#==cHX4!TY^uM7EK z2M^bVoW|DTF0$HAj+^23otWFdg?4ihyk;uJZkOc1vXOJ?C7YFWYJ?U{9jGFH&#z;9 zjWnWo8Xk+z!I$r)$;nNYTu-9}JRG_pG*~AOvLfJT7q3~RoSm>1x_WW4lVMYlh_N{pt7bAw4Gl(L>pF>;g&9b7R?*v% zVlY)TAHvo|(-J3FYVd!QooPH(?;GxwG4q%rWXhN^h5g)%ib~R?Qc@y{W=ex5GG$C= zGDT5oP?BLk_bLie8Yxo0CaEY=rl_3tKQGU_#B?3oV%KFM4fsKE4K*Q%ZE7+B**uvM1MnrJ|uj%DJ?`9bVLv70QW0X{qS z5 zd<@e|yje%v4a|_)1vD^_Vh5Kgv7*%teBR+jbVm#iM!9`vjDG-T1tx)e$$aL762#O{OC-W!or~KcM>c3rzRx|kA|Cdf!R82Nj`?O;Le<4V-X@x+SfPS|mf zu#zh{?e2#%UP0J8XfL=+0yjl~cakR@?e9gig)^8|&$DFKz8TV{P)BHJ%4*K#SH_zAzMYb68wek*Qf$6Eef8_K8^IVW&7351sXGM=5PES}MGhIg83jJl5_ zV-paAMXP6_wuUSt(6ku}J&n-u?hd%fH=@gW%$b-kY2<*_r0P*t84Tjhu_nuxf9}j{ zXb}5?AK!ey7oD$3US~3`+q0J5<#NghtI6C}%(HdB>H`(IQ}D~Ge2x`11dno7!^WmH zaMp#z>gUbye4aP?xJMZsHsL_&AE*2f>Y4)XBt&(k!8np)L7y1dX62V z%%&xB*=wQ*J*KB&rN;-wk|2t;Us}QD{RBLgZNNUbV8KWf8o{6J(`4h7Vkpls zXRk`1M4R?*^cieWUx1bJThaVwJWiX9D9xR-Pswu1|8GA`FFi=_ z2t`4(P!8Om{h3_lG9fB^1YyI+fbI!DFpA5v4CsDLiS!@bm%oBJtM?Y92DhNO=6_Cu#)~|tZvi%0S)8?8qz{L>1Bt$4I-|J59~ysb#%CYP zAzmsPF1!dtnRyzZF5yNeeJ>|Wej`*Qyn^{nO7O8^KE#=CV*971V6@OXSmt$)+!Q_z z(-OSt{LCDzw00%M>*D#3PTznv(h=y^)<@JPR%3#EGJRpDj<`Rbbbfe)Rqz>mT1?3M zxI&WEunksii~*UbMEam)D(038!K|Now$=U5Nn*htqMX;uaVF1@f!v9p(((*`GLzWW zU2&Z5xtyq1mEon?!*rEiAf7oc!T4L9BDV*gVY`qlBPP6*x#;JQP9cG|-HO_vGcO5v zmhA`kqg7Ir>#NM6Lg^FdJ-24Zv~QqYXbAj#&WEE7 z+hNJx#~5J5ooBN$9$g#*+)|8p=WHr99~5M1cMMq1U5^>eNj#d!hxx*l7%sn#iN0il zq5cstU!ajUqxUc_4WhJsogB}9?hU9}zZDjb`LHtcIj`pPpLABu9~$>q0~FpFLV9up zKJFc)3EKzgOxJ9HxkG#vsi|P5`;}yf7Q(If(e&Q)8mQJh2N(C8fIrMPj0uaheY~KK zK2{9l4Rrm)zCRCn%E~)Ye9lX%zJo$e#6M2^*hl~Uc#S_5|KaIlgEU7WjMGNnq*JWx z$zaNPFq^cWd8}>#%}uwdtA8wU9lKA||MX!^dNw|78i%3*S%{MRK->GC;;pM` zATpv4!M{VnLF^2>BUKSM_L!luC->b8=WySb8?ai*5GyZpTpA&3)OaO=otK2bTelJ} zpC2JSQyVEnEqrCQfj_I2<=5FXd}&^ar)sOQ8B#2sTXC#f(?U zbVltc2&4&NX*dC~`ZDY_*n+w)f5|(0Uwr>T6XrVPfr@?ro)nnGgqI4lZ*v5(TY&Sm z{Z%19SESN{d`%*LzXqD+5M~^11!HQw6C?KWH2X4iC3<&FVe{Wf zvroD!ZIv`E*ab2tVB!H6=0}npT63&V$3My7{ve836aOCLLpyQ6DHlT4p5qzcro>A! zyV~h^B#ebDVH7TUF@Lw-haG{}*@a5QXn)a)Y2jvcn-Zqt-tP-YSM&_HD7YWL9#{vr z3&+shcO{L|ZbSoxt?ZQ7qRjCbIS><(0BXM#h+MrO<25poIWT4bUw)>bCacJ{DS6Rl zt2id$TLJdU{72wDF_dk3=ErI+UQhWmwV7+R8tg7TORQ800JF$x%(x)Krn8yo_CSu| z*TiB>9paMfW8iUyhu#%yQ11R?IyYYt=p$_sJfoQ3ZX!>sM;^huAs?78(@R3H1XG_T zd+_P|4ze8yj97;ZYvrWDb{d-SlFmef{gXE|?CvGVZ82e_RSj(=H>gqjp($jwq9hxs z`V6c5=0W|23*cz{9yCW{ZB5$GLf5*oN~hs`8dGy0ZAWJ@{7ItBz~XU~*NCQ8GjDRb z`zCNT(SgdNmqCWxcj?#fV~qZDqrrc~8KuC#P;{h=H?PBwxLUAOZsH^m^-802v=!OQ zr$j-2O9^}?ZRCUN5m+@S!GuovjMiICFx)rG*3vQ_G~<&^3vinlRQfO`!` zPm*s&ci_&J>Fl$2N=(D%*{oUGE%;87!0{G7XcYkA1=U^5tu-Sm- zGkDK zm3Q!c3ZId8!I_{EkwNxu@1wEGVQ{y37U-)c;k!BkcAans|Lm(Tm?!WKgq*$;nKKP| zRs25remV&zY^;Z&x9yj+3(bEq03V)AHB_aWH#M2=lzL&&T3w;<;W zQw}BDw&xaUK0cq`C}W8HPzg@n6io6GY(PMN0*a@u!}Kk7ytW0m`R1)|5T?e*ee&ug zXQwefDwClhx1F)kuOfzbn-H;iFMOC&&J&(v0Qb-MgPqZG zuu41*Tiou^OAwNyg4Ujr%+iGWu!`$( z&Mc5(mNcb6uG4w2$$L)j6`#d)&ifU&ZzGd(^&nSM-k|PzTvoXE64)fd`MsE9jWPMPhzXmz zg14wk5P8p*aW#-B+|f~C=N>C3IbQ47xwbsk=)5v>=cy9U=3O-U&NvH&tPZ+aT7Z4_ z8$6<_19=OCh7`^#V*GmHq#)YKAS9fn~5!d z{=;S0Iyn!LQY2GCr!g$Bf` zGilNytc0mBE2g9l&tD`#Mr9S(gKWa;+r=3D{RNC1UV|I%FU3mtGX6#99Nw>}M6jFo z90R*#*(Dw)sk@0LQ`R&KpPBn$*n?r>Dw&4{nVGN+tv`db>(sr|N;S=)Zn<;rF3m(U2LHqh7EIm7eOf0e| zf%%*sQErIy8w*jR^>I9_?A`D}e;R5QC);Z6*M|GYP9k6ShRx4)jWC#CgP(+V;{u*N zWEic$=E3`XgUBP`*|!NEYNkRiKb?N?Hbb!pbwJ(@82l;9zLK1S!AuF9ocC9U&rWi9LY6%@W5P6AaQEa?Qsyba_j3!wA3=v$@uJ5N z6}OCCyIU7KeD$CAAK~VzWD=}%n+ePI9A?jon6d)y9t<;&k4d~| zQ2E}BHJY`66^fq4toCujtqXdI*M&>?d$b)@g&bJRQcbMcE661Kye9d(^TAr92}Xow zvYsi+*risduxexkb*!sMWLq#RB+0NPg;CJ!`2|ax1eyPKe!*3C3)uimbw=}AC;W=D zVpL6c5W~wc41;H>;5io6CqIE>xyxX~D;xB#Im4ckaK*@F;piRq1z%d&v$CC19Fb1~ z?&=m|?FKu}! z@Qj?^@{yJ|WWevksbs-j1)v4r$&~#UVD3qCNXSZoCaEe|=^qY5QXVA#P!_!{;RnA} zg5b?=e~?mn04AZoY2CUqUevcTT#;EwG}@YB?ag6G`d9~BJ*Du*=1*jG=N@?V^gS7# zDFk_$?etoB16BR_ljgn-1)+dfIL}&`jf)E*r+@mAJK-(F_|hfZa_J`3=}e?FSesPV z=ApbnH_WsvC)r=(@!H!_Iw|KQYCZR)xqNX*p_^&;Zhfd9z5>q2>{;WobJfY;9GD6B zdTEmJNxU%gJS;!%MoTSTgM;~PlGb+ukLN6ehy7|;F~gOrloeszr8680#EhAayU{rG zJ?Qitg!9GQFy8GC4bpEU74MHi+Rh?89d?ywN-iQ(R-WaBg;An)bvqm}+k}yV<eLrb{gUFkyPsN zb{BqgegLFqI*Iu8p7O8M0r9z9DcSaubhH*#udJI1-W>O1lW9D)pEv`q+ug?D-pTx? zAM0U**aS9L))agXs(^iBGPCBGJLs-l!S{HX{mzD&Q4%PF5>$Cig57YH zVJi$bqr!r-X!T7lj;lFHt@=> zl-%u0gW1}dv`c0tUDu-vdm}R8v!ERAn_Z0egRT&XmLgtCKLsc4XcF450cvUn)k~sf zsdd*Mep-Jrx%0#hWo`Jh+E0X}9&~~C=3E`w98Z_mJf_!oFN3e&UO_;|B}|&L98#Nv z8S`C_Xwu~jm{&bQ=iK}TzCvehJ-9p{uYsFYr8=izp^7;>YvuRZBTXN zOo-JqXTF}8jm`#9`19aA`tG?BEaq~#=l63QRP{2_>-dv?jk-?K&;I2(3M_`!w|n8= z@FEB%Mz~}o7w>I;#4A0AaDTfdgn#ViN2gnYPR1MCu|8+!zyu`woNlw2^W_b2etN;P@P#NdYL6?h^`R4y`NJ`I$N6xfZ6aLp6Gx8h#*}S4 z4^vK+@Qjw}F%!cC*p3lPj=>@eW0oB_Rj`Jq9Xv{ykSg*yzX8vC|F ziB;tI>WfMz!e;*kY@~k`>$}35bv_>quf0_9%UK?mFExw~Qy93G9g6lROX%Y1Mfh+@ zCp??qfQ7F&avry4_Oas(tbMf>8bWV@z`=SvyC4p;H`KvlGf9vgRA9Hojq|le9`Kuw zULP=99PF~-M?gO=woOQc}FxJ zMDq1d8l(Sjd#e7t0jEj{V^!ZVIJ;pbhU+R|ew;S0I4Vxk9H!E4<#Cki_obt@hw+}g z3ofzDgj@U7$$~>Hb>z(h@zNridB7JBvZBoGIX$E;LWGq0-oT~V7tqZ@ob5V(5W<>& z(m57=H0k7XyzAyd!C)EIc$D!rxp>maHt|s6tcz=g)lraRw{3n9#lN{W3vN7OIbXv) zayE4{gxUoGYp?(|I*6cWcQ=gGUPlG%b$o+dj!n3zkX-s>4*z0*(Of1Q?H<;^>7&+g zWiEIBk(rK$liri&>zkL1681Fhh4k3gL&E(9s3HkmNTDcCL9v zT0K*U)+X+IPh65&l6nC)tPQ4%>?gs`$ue+j-YztX5(o3@cVytT0rULpJyIr^f!Z>M zInOCK^V#f#<{#G5phgAOiuDBlP#L)KaT&gz<;3ODmC_`s25W5>Ii^qTBY*w^bqF_Z z zy>dm9Cab+uhcTD9WIIqZ0oo$^$+qWLfJXd*oWvU1xf zCLj7&IMDA?O8Cmrzj*wz65bB}8+=vwhU){e$@#+`tdR{5HI*dTrrQm$BuRt`74v0# zW~uPcZJG{l_M8@C?g}(Nx*X->_rk$MA@(WH3*Ng6GWX|?k=@npL{`=uzh5ckU#iyz zkGILtY}n6B3X{NH?Rn%$ej%0!&SCR?hsh_yU|79Imm2vQGSPjlxIsspyj__9RqJyx zu_O*dbIefCdKydDT|+-Eu17=g9veU(p!)QcnDng%S%JS~v@98(U-sg7z}s2D^tWW~ zSw%>F&`Sj3DRyz1ri*YH*4QMm2~W?mujNkg3}W|ltlFil$M;iI;&wX!nzsgc#_D0r zEiZ2FXalA{xeUNwH&C<`BKtq~k&8Xo!1UTOIIRSwL8*1Uy0dB8t z`VcPKH`0}IL%3h}70sQOiofP7v3S6pF}<0{@f0_rsm^=;>3QSSYuO``CvpIE#IC{T zU|k}`X$a+tC!(x!3&u`1VI~`$MU8kd_D$^w?|9~Y@?!IDSQzpRz+a20F%e{@qB5Hy z-huNsmC^&m42SkugTc)2)f&>LKx6WAvQW^QvCT^57&@8w_tR=Tq9( z(tV7-;R%M97xOj_t|w}d#^@+U@DG=bHf~3t?aCm>QC^D=KJ8);&1!{Yu_7uT-3e8h z9=KfRBmHHq{qD=ygSWM$mw<2#W$(s)NHgo&1w0f1c~v>5-R!o4%~{< z$F&N>FsA4N*O$EHwTZ@n^Vx9Lp+gbYxx4_o_G;2)?|{ZG3{EvULjs8aBY7ttt9s;E zfsJS3^}$)>!whd&{-_O2O1!yDFEgm@OQA8FcEH)a>qy8iNml;IakkWs(`Bj%V8E~{ z6qzsN|F-fp5>?L)sC$3Rm!w`1vf#81jx3LA$7u-Z|O z%brnU^G?-s_p1?nVt5+Y)yU)3{Zee9P&nwkPUZI;n$4`*G(v9gUyQYh@?`GYMrs&z z0+v@D2Y>E85x;W+^DRxC9lw*wX?}wsuq_^*h^)aJ=S}?a`GC7U?3g_vQ79_(n*Xfy zDBsdRiXjzq z=5E|WY?4_;-~Bs5l#YF*?&eAK(Z~%PT&PEC{ys;U-wAkkU?zL{LIwO%RwbpYevz(e zE6Jn9;^4eX0at$#gn6pQuzX54of}$92YNT6NAVt>kX0@QwWo6#28+4BUxaJOCeY9? zV?Vw*jr)rUrtUsM=Gl!>kSK&x3R|G}`fB#JUojZuYSZ)X57DWjgtZ&o1&_QZGu}a( z?C--7^i)VGh%fwsCwk8y>?1EiSIKR+?oA|Wb zooNm-!2CLS3^*}_+kG$49YNRVP48GpI&_KtEEFZI$2{hQ_gm=yC5~S`6QOnW3TC=U z2o`OvBW?E_nAnVFoS3za$V=U!FaNWLNqI@=oaV`Q>N-muI0pIrr(*1}<|g_*+m;oR zJIvP3h{T5vh6o#^3El0V!R&A+>Ls2aEkAN#mc2ULIxh-7yqE)hsSN5JS`Cx+b(yRA zn~A&pTa20Lh^uT$>DZ1-I3BFTT$75S=8cm;R`5BTYcj%v6=Qt=JRQ*FuJzMJ1yJX* z0s8+7#O#d)u>IdD*i|%{dD?jyt=+RxlFz^_&r4X3hD6|IHOL2FC*jtV&JWT;brCCY zDkw*xb`|K*{0R4@JK)o)LHNO)%ifu-)bqLv4DQh5c1pImV>y=t)q8?HlIG10#&A8c zN(y|PdIg^U&cmcjPcT|ahCMi{g2qAK5E!LLr@RTGeanx4>zY*Jc0ry^D{~`Dd-}mE zdoFWi^;QfD5y0&Qf{=JB3A`0n(W=3J;HvNm!=DLLnHE7J5O5OfwU%M3#!awd_u_Z8 zW_*|NnZIZ64%X|BB)jnE3P{hqj_*(UQx)@0;@f=@d{6Ghl-(BmSd}O;zupT5QYW%| zJ)-%l+zc_$s**08odhyd9a+z`AaHU_hHk%&m|!Ep`t7mB!6U8YF7t`(+As^vWrpxu z=``3I+e*(gZl;5qD)7SBGI+UT7Tvm*<@P(Vu)S+N=qQ)*l}+C8?)KaV=jz*dqtXIW zt_#4Z$8Q*Xoz4AE1-vs4EMUKyD0^=B7@T}04tt3NNvHaZ*=k{8^Z7ESwqL}3?G3bE zaXqVUHVU#o>!GN83dCD~;4fY~oz-CCAzA}@2QzDV@678kI;{d0IJwXf$D7pIwh8y_ zn}uE@f=s!nDb^j>2v3@liC5r|P3{6E5dA%yNg96#KG!G1nCv$k1ADkOG)nq7pZ)D) zMNk;^i}p#Z#vt!>+HEpU>2>bC!*P7CSS40ZGtvMfm%lXhzBrqqGL0{~B^u8^o6K&H zyhdM@4S|;#;*k$rEmfup`V-&sX_N%$IWB=?_sy7Xhc01o=47TW>>ivSwn6c}F|sd< zV6yF9Ds{n>>6<)&dUsailbC$^ud#(b`cIfSKfIbTvy)_|hR?&bVppM@QD6imTaK7e3OkUmN zmA22pp)Ii-11u5WiI3vv5v~p}k+MDhWepDLN1%6_7ki)E_j^|##*ZhTq6w8?+$F@> zifR2MY5Qr^u9HB?Rcja*D1rmjh;O*O2cKPfKps@RM>CN^4E^(s_WNo;L@isLvM(Fj z&q*-N4+Ln0LlAq(MUAJ07G$F5Y-UTXDsz8TF~)YRNAoX>vGV>V2p^gPZoe)LFh;~1S={qUhkVACb6FWyvo%#mfDQP z`uVVU-yIy06#|qQZSYn-g1f5|wjXqxI1>W&#*cl#4+c^FoE11MsZ21X;z0c`x;TFFBzYI`ZFaf`1 zU!nh8-(Z|*1yMMx4qYRqczbv?Y~l9IL3af3if<}2YBrztbUvrO2P64I3QMs+$rQ(0 z-+=q{$JWvpRx>73CxFa`_ZaxA0@%+{D5xb2T0078%ZEIaKEIxLM4N%hnM81T6;Ey6 zp2oQJaol+>httXg!hGX9IQ}IX5B=MVPdmJsB=bp(r+G1J<#PtgZ@%DnZL(&c?O#iy z)sr!QOc#PLzruxbwQ#XTmb+hTkcfxnJZBLt_T|q#oOs2EiK~AHei?|17z}GdnEF%uF|9+lJA-mFOfCSrE>7HDqXDN-)2Gr-YLdHep;q0NwN3jd}m0f~@ow zzzC0zDD(aYaW%ZT@V$X^dI3}i^UhGIB$^8Fm($_B0rbNFmCl*ai7z1 zvO2;IUQP>zo;#c-&wK|73tWbNOS0*?TT@t>Dj{->o8Puuw7_6o2F~cN1JA|MxZbM* zPI&m>$3)7{aVkf7O&##6GT^lF3j8stsklbXgo)Q;$<4zRe7p4?C|e=I+}Pnn#HFTF zS=(CMjgwPR*KY__rXIxgUoMer1@HpWn&Win*Xa2!^@*v-DVp9UI>#6T~3C+2?|1LCq1c7>-vnEDyanB{>rihtqg zj(n_f<1!^OUlElMCoZ#ZI#(|rW7cKthQeZXDz09Fse`_>Z&w!tJRczQ?r-B*2)~J6 zoh(Rt0xsP*4KiLtFwGYfnFzUZSZM$xgO|!!Y}SHlWIAJa!UbmUbqC?TVq*DDfYEw4 zmFnySxG;S_-8)_j4!?C+zl7}=o0lcCtM(Te*Dl5aP-C!UZ4j zNuTj7R-xu5=%~CPBL_v$Yr_zvoHW8&zkM+7^B6xNYXYXvtmZzG;*4SKPmGO~U=BBj zVN$dOwA|T-ur$SXUE>|z?tq{4u+2<7dHg85;3${%yz@I=9J>h?Mdt5X(%w~-?dQ3d78kh-oU!*Si;1QpQ?@1O6ZeaRb-Kr3MiTI;fqHp zJWiO2E`ft2clSTqKl&G)C$!-t-Z=epxEvSi=`c|$OR385EaIbag=760!X*7Cz?xiz z;_?bO>&Rn0t!!`>=kxHVRp4(lig|hg>=COWvgO_gboKtjfMp>-)gQvzQUkP}HV4e6 zbulZGNs5o~mrej0Np$knyp32L?USsb^Gx#GtCqg_ z`w(P25{OVmKE1cA2uylUVD0k&X#MtzWTiFJDy|l6cgf`53s*=761hY-T*A#35#4;;ub-8+MEtb!>7T(AdprMc9Kap z$-G^U#-U~6Nm!`(6jRQ;ql4w|uuAO%y`&z1`r^vi*JWHKLoZ>xZZ`RG=O6icVKd)$ zTLeh>96`U|vnjDOM3PX2_KS=dZH3dQ^DGQ=G)1ubQ!_1Cokh|Ga|)ukOccl~cQZ_-Hm~bARm(SX8z$+dO9oS1JN^x0KE}gjBRERZMuS%{yHsMwMcI1gqy@dn8 z4LI{x0Y0id4<33JnAQ;wD}$xD`FAHz>dAzuL2nl~mUM&lQEt0_7T*sic>u#8v<6>(TBMF(#F1$$J{aEU3hMO~s@b3&tPAy#n zdUFDC=9yvY|79hAcj!Yr=9~yUsY~E>o+6gdc}$yh-eKG!L5SF13a`FhC7s+ZsW|f= zHEELu#Ws5^xqB5_ZuLOVmU^ylI}cWGR$%^BJ&d!?gOSXeiuGjRvhmH_ z{`U}bv_BrdPPz$S+sEjEfrTg{@6SByv|t(@tHb@_SomBVfj{)4$(NOp%%>13Xzugk zi=@dxYPAk~^}|KX#o5&|Y#iB}<3UZ`zoM#PJ@)PBrY{Qg7*qLe5KzAc<0L9kB6JeT zunvX`cW$E8_eNezY!=@3nan=3(`9ZAtYWqI?_WiRDL75dmCW8>JjGtq-0#4XuvGy`c%jr4DT*pWA*@2~Ah{Y2QtM1&OlPUkV_x&Bo3DL}*2qB?vg) z@Ij%4X1A#9%ThRhl+aEPtzE;jmpeO!h6`a{xQ+!a_73a8dl-VZ}KuEpDG;pq6faOZo9S3|&82Dfq9S5qub;VlI>Mz_O~+hZoMmivyg7u>b! z;#acFtp(vUFVBLpPAP?^gi2nz;TAZ*_A5EW=3~|5FtR2`1AVrggOl0G?6?2%FAVaC zbf-2LeO<-&{g(`_*W+n&V;t&l_>R}t-T|G+SgK|rjMd9Mp?mZQ`5wsC7ORAb=c#5e z`7acel#BRY0Y8X&a}joneFtDFU50(S zND;5LMT5taY$}nJ1d5L|+1AxdiN!f@cGH4XT6?RU%4Gi`i4y~`_|kK7{a_xkXLTWT zvK%vM!Y13uMc1(E)pDDRch|tXY6#w#N|1e;U>Th(}27h76 zHsLHbKx77dVde1L#58i3{}>EU%P#-{2w1-lWR* zs*5r1pBw1w;fvH*%O0lGGwl6|`B1Q-9nPC&5hLyj@p`voD;6m|ZH&t}lf&@#s%}L~SF<;rOo&&Wdc3x-5IS za6SJ|q6auXdIYQNY(Zy4iY)etLxpU#P`gIgSXywP2OVYD2v$Yu#UFEa@{x`NSqp&0XK7RM=n zvJbi+$g)l=J`(-%kML_nKdh0>z;>^mRgBh$>tN=T*$Q1&&9mZe5;-FBa!EAh+0A~fSVQ0)kT;i69 zCC|g*#k?mtvabeG`>*gVy#&C{E`>M$m^AC&>p*$;TyfQ}T-fk@9jr8J$06gxD0q4| zYQ0K?YfoFTV+AI^b)G%$}p{i17t4q6}xR5nRdE_TyL6> zdg58w^WX$N=(~hB;+5E1PRpQ|dKuPNcHuosJNC=kD`=A@33)^x3x+2oHsb(Ho?M3E<4d6J&|A{H*?@WSwFPj`UB29U5nNY$ zkNmTpzyuyuMal6OxX@6U$z7$&>Em!YOpPa|arKJ|~9X!?BO?fd;Oswcj!b%Hw5Z z&98cxMrX0%FS4*;(M4qJKSI8)7KT_4^Mw2gNa6N~YGu2VaPQ|*yeoYSzVXFCX?YN& z^`BtUm^pYt=`MXNQ3;zH`FLAL69k#bO!=b{bUi$goq1$2W!0iFA=L)^tTvHr6N9k1 zx0Td{9>Q5cK(?tm@`Fy!!nwCDLwKbS`?k!8v64Fnn6{k_o>dF(zJ^T5(v#>=BgBSo zECnlzI?S-TgXaQMVAJArD6cJq4NU`>@!JpMF8+gg&T;$@`PV4d*bh}4b7sbPBV6c= z#?zXmVA(i8Z`K`vZ%1|5yslihyF(Pr@1&u>b{&6whZd`IGmZqVX@a@$3ejFs0N<~= z!ry#y9OQENP!o5Vn0}3eCYXxmjc-WA#}hDgEdoTmJwfu29Q4J6p@PQ?Ix9;7HaZ7@ z=e!Su+*3y}yo1{H6PSRK3bMw32eDGl!0!(yuz|-c*_x#PNaJiHW=@MJ2K~8>(@Hpf zL&FPvvf?7BPS{DcPKcuKHa$Eh^8>;oFQc@7D`prqV{>II9G-KQR8ELz%H`@ogLfVd z*Iz}y1Hw3O-+XR2pac#dRbkEi{XiBvurDtN^ES8i)7=4Q$a9UQJcW-0Pd*GIipeKz z(+?Tr>K*mup{Nk!F|vzZnX7}xiqi2Mmzy#AIETxp?!f1{3(zYunvQKh&UtW@*`4ZP z)S*KeqV*=ghN~&KG+dX;m;*7{dX`v>AtkO3(4k-id7sx~_^e94u7najou-Dr4rD;m z`crV?a~Pl9=Lto#Q}E%fF?eVHiYHKHi7&Fg@vI|1(`gQ8QJ~BRhbLYo8Rc&H@k1x< zn`z0LvCI!QU2xW1mx3DSYYbTK z53P@v;64v==Alys?fN`{`QcQ-x2QgVszvVXaV;5EIk*VAE8bx4z3oJiI~m@A8`(K28KyODP=$ z-v_XVjb~y_-8pKQr^bvF4)T|!g)ooqYctioc9>gXh^+;}=;v&Ob2p!Yr&>x_Fl`~r zv@YTQZa)l%gazsBbwMDqGXhV3o6epReuEF^`0;=1ouWs|GvV2tM-clefi<%kRo5A(n<@e(>7Zo&(J1eQCCiZ$)Z9u)`? z5cuC?xwD{ zH;zn*G^{J;;i^DIT*l>$Ew`jVz6Ed@(NT2k{dTG+{+sryE<|@VE08>3je`cGRGYa& z2MpDCgMppI@p?U+^i@ZX^y6?yaVnqLGLy@EUB_M?aHp&Hj8mBaIW}dHG#u8b1b5BZ z#KonPu5fOrf4x${Sb8RYIsb~>QmiADOQUe>W_|F#@(J4JsIuE^LrKPyz0l$lNzM*j zg2b_zkUnK6Z}R3;2)yD6CkyXD4QoW7s06}9^M5>YHwLujc0zvIcVx6;;n$t-@N(Zo zw(N90j{D|<%jsNF99;f?&(GXphJwHZ?zp(e|Ht`R{O|l+g*d*OXCrS}IE(#7pNUws zFwO~Wq&H6`Q}^T#*p)ODF20lj|7-<(Ww#A|j~ZM| z&7nsXe)9qf9^#q)x7bj`Wt)_)gD=(Q_~M^6IXmkG$EQezlo1iMRoRM@T3h-mI-v=>6kE~po-){geT^0DBh&=jlXaKu45hQYJ z1RJ)X124{d3aY-lssEZ&pr10z&3n>u-dx0aLv_%5fb)dk;QA2nYnWqb0G?Tk*vr*_ zflQNRgDxt;PEPmQ{B9J_YhHyVl@4rvJ3TZNATiY7)00IgOk5SVI!w69n82( z9Hf2lR`CXw9*BXJ^OVSv%~g=eyM&!vBG_(aBlbsyp6$9K8%|I3m|U1}7>xxinf{P8 zP?-Iq`t-4{C|@Z-GTFP(*nAQT+HTV|PpjaR%m(;&tC}V)Tgd8(UdNbqxzMxeCe?g! z03D~U1?vZoY|r_v$J>YI;`fuaXz}fO~JnTnY88CW8tdf3`ZC(BWV%_pdYCzDAP!U zOUmysfwRDdc~Kas`dH8_`HQa1)xcW0Iuv@zVR`g3JZ;^FVo5%@yQUJ~K1#(+i%huQ ztF5$S|1a9$Z-w2ai}B_~{#t%$0mVNC>E1Pb9^yw6PO-3IKg!;aqxGG1?n5KC(lriz z{C9v)>uB(3J>iUNY@0fYnOgGBpMYve&(MO* zGqWLgyel^CDZz}58*t1GA=TL-&m2Y0(7(0SpnS}hQJs3Pm3~qbh<0hdH5eJPE4S4S6EZ*Bml-U zLEK6VOz$P*{)k4Lc;mQ0C3y*03JwEtTaP=x*ph8#S}?!1lGJE+BkrCGv;Q5%2^0AD zW6hT|AwCLQ_y5DATc`2;nkXVyT7m1uL|B1i0{wjCE)6%xLh-BLg>|k5sF*W?y@=dR zT+CJ>@ZAB;3Bi0%GZatyD}&WCIhOdV7yWmC!NE2W)_eF7of6PgAxyX>nB3WgPO*#e zurklVDLN&*v`HRD=7(d$BvD9x7M|)6cn8u8) z7NY{cAPv+@q}fw+c;;-;}mf--UbF1H~c1_J7~W%junPFe8LU{`yXQ z4&;Gv7NApop5S82NHl(Xfi{K);i*-ju-o5?l#1$b+l-ySc6mCyi64bFx}QjzY$EJS zkmedMMdQkojnutz1{pKqfN-F?h3r$EM5NsY_-x1mtZkc4`@U`=?tI^LzSE-PiJrT}*s=4C0@5LaX%nTmZK|)(>W?bSu^7b`B&-1u zA7$3xtV@2)D}WH@@G1>L)}0xm+0Imw}EBOSy-SPk=!lzlWTz0xx=p z$fHVr$Jx0L3_7xiuTnWg{hd!m++xA>dOak}>82Sz5+KFz;X?K$gU^U1yie2!`~uGk zqV``C_?u-x;~YieI)>+v-QnkJQyjpqPzBQV3JNGSzPu<33bWarq8n(lJnJ9KqIE4**WDw_C4Yo%*9Cwck z1kXde&`|z46xum~y`3^F6TgCb*%h$ojW-N!KZ^3abIWM<19a&;4w)0TfgsABmq0>jqcS~mDit71i=U7&%Jr2v}^jNOmdJML@m*UxD9nhR+fw%UK z!`}UKX}Wb7ChpbX>YK+v-8>;)dNmR6-;M`qB8k_2^K3-j3>LmZhxZh&z)1IpxbV0s zi@X^K3l<3>|Mjs7pEWk@<0>VX91_4r?n`0X!Be?P?f0mEB^E9{{3Cdn+y_@TOLGsK zWm%QmbeQlv1p}1UV8Ffktel^ZF3Q?~^FkW1cdY_EQ~$s_F8NuOY9X1OREGU`cf(tL zHn`mXCjEPK0nd-N#CMZYX=LnuNPT|KWBD) zQ|7h2t@e$j zPgHK>FS9{Gw8&g^t{2DDSF7;8@mhG7U4k#??IAXc{lI=kFqE_$!Sws5&~&O8xUQLs z-+~_Ch9(W{UXlyr->fE{p%M_2WHTImu&w^fP3>fL&v*SZQ< z%9mAK9Ull$H{|iay0$cZR+K(ouY;v`Ltyso0y^jQ0rUu%OzxSB zu$t1jIH~ru;B6E|v5`qQ%o&rLfqGE9+@Q9e-9q_oYjI0KJ6XH!Hfs5c2>QiW zVZ)3)ME8{}j&zELs;VZ;a(9Bi(OdDP^c_quOd`!qv5*tN^NsYQ>9cDoc#>x6z!bsJTxWpQjcQcW*iP zE0&IRqpo9;QYl#*;Rc&NR8gG*Mx0{C(ayyapy_!M&hOcZ(rWSWt~vkl*>;AgTsVVfYT+OjGm_@sLH;~< z2I1;)e&@7+j6SK1$8x*KEqzM7t|y`O%`~F!riY`QE|Fp5kHY#f%G7m55qj@cBA(wv zFfyS5qhJR-%DRGq+Gpv7!LyhWYlo^kv;`H_qj5!o3>gfQWl5zkXnCtAt#USH|Ll1_ z%Aqsh!FZDPuiZf6C|(uG0M9j zM>VeGUi#-?sFy5v<);SwP;w255BkEH<|gpqpBcNBDl^}$^I>OdAk3dE#j&V#yz4xb z*44M;(o$_s;(3ukLuD4*Jvke$-|RzI*MDFmRY)^E^|%qSZ-~vcuh@_|7G3MYEEfMh z0=HeSp>Tr&bJ*aGm8rhy?Bol_lBVG9%JnF{uLMmc)VLerGwo}XM<0=JibgHGq0 z^wsZ3O#jRCw{BlS^{0<$Z<#yvil~7`QyvcQi9$W!PpI(WGv<#N!4_xTLe~qM$g}fb zaQcxt>~=80j0qRfvv4+DE;EQve4KE{a+XW!1Q;uK6%SdNh0$H+o zh~BuR3X;EyNtfUQHjC{6fBX+^y3$GNh903@M+A*C+Yi$(woyA1hJ)|!VzvDeh?X5d z2_+ZYd+iYT>{7+Ohu%^RsZQY{(Tn7+dmmmGO%(c>?W0xm&V$|da;&eh2K6Q>w%t^T zYQ-+ZInfF5M|2qV<0pZ(xE;I+%tyC-iZs+j2lCa#A<*~=$XQ+I-;LzB!ma|Cy`x94 zJ!c|&sPGqmeU27h+P)WGmhK1j&>yIxBS*vdeR@t-2IK^G&@-#oz}fxy{$&dCKhRlGPyQH=SO( z8cYlibXMq{E`Yn%DmZEPSni003~Mp?g#SdxGw*vNxaZ2*7+;hMrpae>-9r*2&TjGUdGdY-Sl_N;DvR6j%jP=4m+al>!M~H797q?Y zzjy;*UajIP&OO4#BAwD6m3(Nme|l2e;nNW7qs`@aO6e zc=g6EcKFUP*8Wmt882*D@6*2!HNu*8=wGIlwwBDq?xVnNb1>l87@RczF3$X!4xRUT zOOzA^-FxDk!QniJEir&Au~uvX?@)3Zyh6z8AXXRA1D3C^VAbKBAhLBmyCG`Csp^Pv z`JayA+|S8Eqd8HyUTO{9;2%nU4I##l+XKqC6S&;K`9O zy!Sf@{!ZOaXWJjZwyw#fOWza+_>Q{!#-C)4)Grdd?T^5;Zxb5FZo%N zdM-C$OyV`19#Vn}29J@$A_-{zw-l`=MwoxQc!kD)s>T_aMc8k&5*Ms2Lci<+)Qi=s zh&4M!mv~Kt$Co^D!?AZb4r><*_DEJ*X>$@KT_ zH8`eG7mn{11Hr9t$aO8J8^>xv!59Lz>ff-$qytr2BH=&(7~C;Jl)asm&htWrup+1z zw7-{;@YFwGt1VB(zuv$z{P(J}i=!*Qq@kj99{;Y&`@?AvrITYx@q=l2QM`dR*l#6S ze_z3r%{@4t6BV8`KMRJXjS!pH2!F<%LiOeX_+5~TawFD2eA5F+yK@;MdFDmavC}yA zO&j?V8$lLHhYKsVmJl>l!%fB$S??7cOUK9}YTA*AJ2I1bo~=1#zxTrj#Yqt876DtQ zisJe4ccE)dHS8UE0UBDPEWerDf=Kyr&f75@?%i%9=~hp{F7APFUDhMKkgdl(KH4T& zJK-fcV)$9`?zk5yjQd8`ea)fzGg|PwXC%#>^Oot(*=3uSV2kSPj7JfAhq%E1} z;7L*h(>J?_ujMt_iy3}2nmfTe$f7`3{wmJt8qfVHv*LbK#}U2oeP}mb9j{$^1z|~Z zIgbTW@MrZkoHolvSURsCT*GF;`z`IX@6-?6*s>D$J#)st9Xq&<->q<$?>syaUILS5 z#lTweP<(m4oIcOnz^-L^JpZwbB&{mKu_347k46nyJo^GEh`0-jMCWjwZidV?_YaND zdWG3C33#DTkBa+MBjQ&2>g}CpB8iu31BUe|q8=xjLw` z+Y5jBz0<<;xg;#f1ODz4@cFoztY~GC@WgCgHsj}2m_L`p^_y?Q(#h#`zCu5>_c{*8 z2j!ssrYCvTQjO!b|HYujXXJE?1#C`8L5mI-{HF5}59a8AT-+w~;^#}RH}=t)`o2`( zrXCY4?$T)YGEyDZhBtR#$K`T$Lf5Nn@Zez=e9SZbg1+6yD6=t;xb7^^&^N;!O3h@p zzZ8=a2k`U$jsr#fzuCn1A!KJl)XE_Ib!H*7kKG4DippT~CJCEkZG~pk00#?rrlZV= z8&{_UlT+TKA>hmfysI-3NozEYE1iy~BG%xm;Rk43`wSQ6ZvjcG7Lr*Q2L4g+aX|hh zF55T;`sQ|^Nb+`22;Yu>Q507@?T0U)8t~V=ZrrkGkHGwZ3vTs&MxEE{RX7!FMNzQ= z+@QD)WQ%U1MamI);UT0g*&^IWe#ZXob2t)>Bf@+IF)qi%8zYT2;$D;6sP4NK?sYUk zs__IUJ@=6Q+|o()i)x`MItQ+cyrSKOr|6%8349mv3gmAnCDt--zz!*Jr9m8Ry+vV- z>@;>%BMEXJl)%@Rx0GtjaijNSpy{5G+|jCjn03P&s&)>8v-D(ad8^4S@qJEJMb_aA zXK7B8PJx;CE9if>Cvabu8DQ|lg&1b&iPuO?gSMuH>?(1`%Ss12w!HHs+eMz}0$0V$&b`RE>vEy-3=8!?;tyH6z-?8U&+uNoxznWp-rRvP+k z5?Jm0PJT}QMCPvB3^SZ-XoO@kS-rjwCpl=L$I~eO`PYSl;~Tw5+^?J0)Q7gTYL$#mdjWAOLL(~2LH%c*0^X8va!#O-C1 zS?-%+823$s1Z9~{D;NV~n zlMmHUd51GN#b7DK&HIMIdD&>;D+BcxPhicNQK+=+D<;+-7Y-}c;NQR-^s>`3GAnT` zY95ioV^xQ{;i{S~|h(63N%s=4`otaPZO$ZgT+7 zVRziXF6|DWjt>NQIC&cPa#aehU(hI!4{gCHjWL{xdcQK;x z6sfX*NVU3-2om<>;PAF*lt}bI{^oIPo5p==u-t?Gr}06!)Tj;Tci)5g5npLh-~i8j z0YN}?97v}*^Uk0|+&D9LW*^+K7vI3wX*;L|ys>m9e7CU08{ z_h-#w&1W}YliEoz?reZ-vZrvb@i9($xishh)B~ob+X9_9n|yzl#Gc8-a;L;!3CE~^ zAT!PF*?+2csCxN6P+t25`CA4%tr0@ZO5S0oVhpGRuSA7Y>YScq2|ADd2>Ta=VXf{X zR#na5-i9Wkw73OM?W!WjS4WdWYA28iOgOLXS)AX*Zd#u(5v%O3(sdovxcB24Q03YO z*lwE+js{*#N0wt@uSYQN%od^IB46ws3c=W_gYd!b3@o_lgpntwaA5{3IlqC?_-@;A z)Hc;*t^*}o0qU@qN*)=IH(lovt%t5Dz{{hfHDQIpG&GholZ zjl)>Jmnw0r09_w#gQpt9SfO(n(xjC+Y3VL#9r}+b6(=+6D_)kG>LpZ$cj2V@7;}f~ zHi1Wz1h>@L9cSpa(APiC;{JhTkawscCNnkIEfW=tpv|!BQa&pGOT>UBF3g{2bu9I~ zhp9W4;Kqte_-K(j{#Yaj(kueQ%#x|)dLyKC670INi>7*&U=6>cGmF>>YkPxXD0VG; zcxeq8U*6))J2Je3=L!D|{e+5j{QLF6AadvMZ4&i}|NH0B=$FFxn73z;o8ChtJ=BCw z8|ev>vsTdJUoEuN&<2?79jrTYlpN~3g?n#C!Iq7lIMnTe4KJ0+vC*Sh{?8b)EF+b! zxm8W)VIs6Qd!Y2UXz=lBCRuy_!&7BDK*7b3jc%7@&bwZL@Am&--pG3VuR)ZxkLTG8 z35C#?k&SjXO(fOu4rUxO#6MBW-1P&J?ER=JP%5v*&{b8C;p&MSC6?2+#na%jpBT3w zEe@|QbH^!{q}ZI9=ipHMSu}MpU{knQn(8v1Ggfm0xo8>gn$>4eYiNg`dT-$1MiI8N zD2!D^iLxD|O7OIlBjh+&Q>i-7=9DEC#+Wy11 z-A&ZLI33ShltBN~>hjyZIXL!k5*&W0$NBt?K_h)twlGee={#P+nj^=v729Rta53M> zpJ>cd9=<|XD_PFhxrLn4)?u-ELMr}q5qD}@7EHAb!fhwV(5FHCEZOin4QPvDUE%HM zxNr)$ru;M>Hti%cnF@PXl0h3ENrPEP4ZM;pgb^2Nshs}>*!j&6<({pC<>j$BZ6og< zF72TU8#bbUfjpZXn#4ZY+W|fD1*Q2c;o}!^AnLUj9N&z_@@ZrEdFBl=rt&CE4^tuf z$0w6lCY#uwbaPyhsE!8iquH|~6s*KVx!=C)EYnq{T2?& z$E*p)W49GyP^}5;<9-seu)ipOSOUIpISjXa7J*gHU;OCk&HFpU@L1DH%e}r21bufW z(b%>zv@a>ZBgWs9+rhWXGS&u3W9%dkJUcyCu)DolBOmXyEmrh!vd({*$swJWZ|@Z<<6oW}3ir{v(REurYNFaf51`iid= zLa?WI5Q|5<35~aohF+uZI3y{g-Q7>nur(8c;vwtTMwKZkHbvn|hv)w_9|zU>%Rn0*anVFp*eO#!Swh0(pcL|JXPI(t6n zG1(W{1%2QD!P`zXcERK=xtIKmxD2^+Irrv5&eRF;-t!yYbIszJAq<^0FF>*9FO+u^ z68j&YalYq8&PBZpE)I6Pe36U)-8Lvtrr8)m&YgAy+v47Y(|r ziwRBx7=N)7DtG?D3pSG6o+r0J@0UJpfOJa53h0gxIndZH%KRV22nWh@snua`JiJB} zyDrpVgkPxeL-4c;v!A(O<9h%<2AP1GLM7~qDB<(J9I-j@iJbZF4GV|71xb@t*=fIH zSgBSbG&{79Ze4np^gG-`l}i#BRa%GbHF3Dhbp}iP8HOR(QyHvMI+07l1NqxTOz zp3&EYn=30vRc0$Fujs89!U z-zI@d%rvI&av1wZJcUzYqd3{&o6yAf3a8(ZBZqI~(*s^1V4RmO6xGY54U5bmQ9_4P z=(7VcYge>R9)d6_Wfm6w9(K@qFf)y3d5U@Ci1%sq+V5O?Z{#58duR(Ya;D??-+a#5 zNrltgn9jBv9Ac051kwA`3|XPFIe9Oq2E!|Saj>eBc%RdwD=xpqIR^D;HrX8Xld^&P z+C%$ZS1AfcyM$zh6)#Jwnt7DUHD;U^W2^I?m6ET-n{N*zBPbn^Z-d|255eu>3o^u?ZGtwR0iDw+ICH~XuD5?Y`xbYOJ_y#p$!%5Sy`}=E z)@g=b7Y`!)I+wK+O=hpkRl$4CapqhyoBdw%n$+xxgV;UysfM~PY-`(yeyLux_30ou z_|-$c-UKF$7{MA&Bw-l;J@3$3Mpb-fv9jx)Xj4*+8H1r*VB|9_sd$IqaRfv47~~8I z(6x4Sn8u(*|7kj{rU?{2%b>-P0u1`8h%%>?;nU5H(B)hYwaqDl!r)+hyJDEGIy`~v zySxW>eDJ3Zqy6FX<|5dZ;D>h_y2;zp)1=+Tk4;#YF4&PHO*~#N!A+7yg1rN-EJjM4 z)Ao_%EHX5?u8wEWo^}WuQ^ta(xjj*8-%8v2qp+y56SR!a)WRe7ehQ@ z#>uOA=vfaW%}$4XH6^fFO$4VboKKv04MDV3A2BSQOZo%v;i%3!vb)Tf#$WnO{y3{~ zCSk*{eRCGB^aw}!m*w<+-$U5aCt#P_x$D=#kz~4_fX5neXaxyj9SF4dM+s~IxY`I1x@<-xyp53Bx zYX_Qr$rD&et8)Fnjo8TB((vBGg>0D-PnJB(!;;ajEwg{5<4w_Uv|qlE+y3zbZG3hZ z&xTCJHTIfNl&6hm?opuL`i>l20^GlX_n>d6%&oZMjm;*{;c2xVm!+@3TE_0dE%7d} z*FcU5J)~i&_CuoN=nYQSav)YVLKrdWGVg!9%FiKu=-z|jf^{}ptU4tWU7TfDKnk#k zdwb#ORo+K3D98S^j)$>prm?3NJMfd35PE0vzIvlHzCSbrf9zL=c~k{d!Y5KK?j-8$ zctt%wb>i;jy#mXF>qycDEy#!%#T9qh&@cDu$@f1G=u>SYZlj4STlw4oTsAG?Y#la` zQB}t5+lkGBv@bEZ%BK)4Uk%{9(`IaeaR7v*7%&NpzzZeLXy{Q1x}Qd1QH{SKUSWXP zw1vaG5hlb_@d`EGIROXDI5HvYFRpmt1N#geX$aRR%pcppXm_Uz>65r z7>wbk0-z=4Dir}k#86Z8ta*;IPx8@kP6&onRuGBHck%i>P1^Ik3-ukm@lH||ZoAfq zJ)aigu>pox2EJg3nH89}E`&B$eVXz$0F>PHF(`W{xiB!2N+{aF(e@X@Xh#Kfv_1x* z>TxJFa)9TJ{K4~^LWGXt$!IjH1C^2nu}#4e`k%hRn|~_>tTPvL+%z!mzZvK@b`IWi zNrcd^y5Q@?I|%Mgp&rxaAZxo6yj&v%-{-I68is61Z-fS0E*=I!Ms`f*jTO_^K8iMf zcz;bbg_m=WM;#xA5n*#8ApWUuigXqS*KvU*LvJNwhv!Lk6}wRCAcwKt1C2A z>xGj7D9zbp%r*w=vGATZ7-BAk83QRi7jGt;o}!J?i$s_%{R`h~rMVvNJX(ku!Img@ zuq{Y{Tcry*!zN@Ifec-!qvx11uA01DuYw{jEs!!4MOxfXpxZ2tsrJ3cB+Vdrq_+;M ze`bN@#5pWTM4S`;x`y|)X0qg(DQGaG^@fMT?f*wzYjykM&Yrs^6Z>! z5a>e)Z8`o~aB$UiIDc6O>=$cO$H8S_aOey%tD24P4Bw#bX>IP(JQ>bfsRcftxDFB; z)i9DAqi%Xvv3`XHjHbHie!-mErWnQ6dp#AN^KgOAQN1vABG1a&V90F?*~NX#8_!1A zNwR?y1LC(>i_P5=h#Rez5lt(5s4-YmtA9+rXAOHSgh(gdpM z_m*dhk7Tjsw;>u5i7iwTm1R8VJ=@w6ycD?InNhGH*@mfJVzB#~B<&xrg-t7(F+(sG zoD^NLXKxZ2x#0w!ICc@t&+5UVSs!5YdpW8Vu@QjZ{S5uMOr)DCah%YIGr1FrYqd3T zM%@UQ-8zw4@*ZxF-d>^Pi3nJDUmk{|wMlQ~Oqdy)i0_kqu}^LYwWft)^Ip+dZaY9Z|b|C#Pg!@ma4;jUT@+0Y&UcQf12SZXP^U0N4U z9nj{KCM@M=8jopY{w1jX<$(^(DdgkG_vjb!niTeALUQ5>XkS_d!<&uShY3Gm!MAgy zL^*;?d#?*UAxA*8L5W+lG6ZScQTVvQ4lJ)TFxE|pWEEQ)4DZ3!G zVl{J;t3}_X6~fED*}^FMBy3SJ=B)Y7GVOSdOIAOpPd!!G{B^SIPWv|;P>v)!x9)&g zo}*no?*=A(5#_AiE<)ZH8*=HL2{(D?T$~xA!->6LNyXj_;MsC%vhmzc!T1UBc(tnp zUKO5%Q|kpxr0g>E#0bc`?Dt?Fd|I&JnI0%?GU9z&pP=Y=8apAAj_pU5;m>h{M23XZ zJ8fz#N-2p1)waNms6&{#m4iTHi4)k&oA6UI($ z!VNkeSl<;0<2=rjw+^4M;LJ^WwbubImYIOv-_NKxoI-2XmhkM?J6PWF6jPpb;yeDn z`E!I3rj2c;#l`-lRq2}0dCeJI|EiP5G_NK%-3xGgdl-4Xp`WHEln|vSX}EX)VZ3}r zj&xpHi(3^Wu;oNCKDiV~4(9X`mm4zyCvWDjfuk_%;vM{*o=+ZrQA3&04+VME6@s=P zM<^3q!#%$?44_sC9}C#V(XMG``?arFKI?7Ach<|>KQt51TzhVVh8e6AX&pobj!k+DCXl{yK)(ueB%dBxc`}a zdhwY$gtS*I%}Yhy@ktoee1KToc}H{j>_SFCA(T#$V`dZ1l0bbIZr!X|T$j-$(6+II zDWV}b^>r6~KYST~aZYex@>}RXyO=p?AK~{}rnpm3A&_Y26FPe(xsX$P;C_w_mvPDs z{R=(tL-A35=k^A4jI7~Y_(Oa;)&V63CAkJePuyk{gDp0PgdS2AaLG;{Qfw&9l7ECA ze6MPi>jnDI?>dy+cVw z;FO?e_;y_q82nYnHOa9cKg9ucvkA+Ht(BIk+ji!BAu!>6`S0DvFiCWyw0SHL#8JM7jvV z)Jo9ow;496oWpJWtXuNJE#BA0fr-gN)ReDB(W)aj_u2{JzXxB*E{7M?>`@2mUGl-m z?zNcBpT(Z@jTQ|+0C;8g=p~16K?Wcsc^oJbKGho7k~Xc**~>GtUM! zKmObwwgl()g@KI4JN$8|8W&ArLYbQ~TuELTDIJ>&oy3AAqJ+d5T;wiVW^t} zxQ!kn&d!avu`d`^BqXrj%?gAIB)IL5+v(ApVThTD71!bG8_H-MpC!?X z9!I)5T)=40PLT83M*Nc}!j6AZ?9-(S@O9Bw)IY1jrJ6~=YBxPDYGe&x+gZUr={%=R z6MqOM7RKTiIYo$h!*|5>mr?h*@#L;t5e-qgg41mH*_$OJCk*5vm1o)Ve|R6}{xLC{%g3Q@$Db}c)bs{ba)Yqd0RjtGz_lY3jgNL z#RqlM@M_yen7Q8x&;4u15<__=?0XnzAf82O%Rm4Boe&D|(Hw~M@q?II#=2XV%AFRXe}g$ez^ z(D))AS08*teHZV=`XlZzTti`3=?U1F^%g(G`(iNX1K%g8U=q)02Gir@VE<;E(9l3) zhv!hAg(46dvWiYQcozTcOodaaHuz-i2ecgE=MTF_L0+Q}AGW?U|DduTU370*J{eg+ zwT%xFtmj~q>Hn_(NzB)6J1kPy5iFU$0wTTYNx_ppysKK46*)bJ`l$`%(UxIhd)!sz z9M8eZ%q_UUs0FXN^G=Z`uOTX+6oPop*LC%kWPF_))}CJvYZs|+Hu6&GK zo(43lucOiLcEGW9p9LDSqXfJ8+}4KKsibX5GH$u7#tb&RAc@brY2z+QYM@^U@>dqq zt)h2ennwpD9dzL?Rb2(yNn2>mg9PX_V@dqAim~1^*-0rw zuHGY)EKc5s3s(5U!rtj*d!!BXtmog8)86BPWAVZO?G3n{XBu1=If=&wpUJ5`A2A@H z9NOIDLDpjwyKrw6+@D=SbxLDUn6eks5|$D38F7%f;{vebVJPh>$F_GT!#lpqela5j zY9@c?c}_-b{rgGe+pH*9*|C+GkH3$f7nbAJo4JIzR*nIelrcu z?kYWHhYpX`xa<(In`< z0$jdWMX>gf6X%|DFkY(_?Xi%H|5`npEuI zuXiQ6U-aVMa{R6S4s{FaapL-C_$DF~e;q6&u>3ThIX045+n&Lyf_^mJ^jly_Gsy?{ zn|LK57@nuRqW=zTLs6bDVxAUFSDlGNZq8o(FI^JXE-uBtdz0Xt>3i(=S&nJOgXCoH zDf}~OK1MA$3?K6z(}K@kxZApioPF7h&-9M)`Qr$hbLKP-7~Y}nt<{2f(d$AT!6$SQ z*ixGnqp_n{mDbwNMf`If=J)OdyV3k}&E_uJUfBdG&d2dX$X6^*-2_DjukrAk%ZNVb zaO&Iy`t^+)<_w0=*0mkDDkMa(cWwhNvrfPr#~Sfzat%!uGlUuCmh6oNpUsbqU|Da* zf}2Yqt!M9GQD+#4_7&j_w@Iisemx%hd>@@lC$esvF1YEj0Zc}2qCvIwXeWP{Y+cd< z9(JwJ6rzEVYD-zYmjtfWab_nn|KX1KllUKhKP*$wXGwncbhqLk%vkaVr0X4oZ%*CA zkA~vh&j~x=_x%ivIv;>|AciT^^2t3Eo@z4EAr_*0BeyAOvVxGnw34k5gtYhu0S$qwRx- z7+^6Ow3kZLeGW_U!lUJ89g0F+=A4E<%)=okYz=OYy@_hPCo6FGW0Vp(jFBrNA@<5@ z5^||!%6W$>^bP0RI)nKVV?*sK!!c~RN;PAZ!i()LWCc+yhIK<%NH%%z{-3+_= zJ=jp40?tg8Wa8hS;?d(*XkJ_hoOWG_OVl=#W&Oi=yly_aG-YCA)fY1NeibfGyh{Q< zc%uL5-OzaZD5&TvvSopBBvm{O^adhf-tq}F>6t5N4e(i;Gkv7}RyodkTnx=)9zlZ- z$A$ZevWEdyoa35sY--eEV`tc~T0Rr`sMVP|ejbUFrl-?KUp1LZVHsW#E&-Ewe0R58 zj*W`yMHMkuaG5uNUvKmZj_>7N7#`>Fa_w3;_GBw8SWpQ!ll`!iFW#&-5P`%*P452v zZ^F5jk<29fKD@8|hkHiZ6W67Zc=vBKyI2^8%UZ)>Xh8|giWnlx4p?xGvsb``gF~34 zk`EdCCa@~Lp7XNv1XgMB4#3_vP>){+3#bb^=C?udTTx~_}D9cs7aAvBWyXm}>)0qF=#iX+EIR2Vw zTv4+kNvNWu%B}Gh!`{WC*@(h^;xBuLtmwT%64KJJ$@DuM=2^D4a}A&&a}Hgjt%!|< zvY043fpHza@bu^sQo3n0cQxcNt`E)vxeedIzj!lw6LK2Yv`{SUaiQu(zaC7Da_Q$oO(?QrD))VrB{MFMpeuzoWq-6C zI-th9Mc-0isb9Fy_$2A=-UT=8BJs~)0`F1P;YWj!I8!PMY~(-Fn3+{L^8vweDbHcb zoJu06cM=Oem!iw<$uReT3_S1mz`G99phHOw`;(})IT8Q{I^5nBJf z0$WG~`jmWwupTcS;M0eG$*CA$dy6{gAI0^lOR?5SjD6PC2EP@nnZ(g>9L&q7n+x`m z*)zn5<&h28b>$i9eb$fb_)J^RGB32rzKr3Q%LE5P9+TK#1~B&KWVX z?+59}17DYN(5K4=+)wgn^$hAcwiw$QC5hu(b?}R_Ap0t};pRgpF#XU4db~>$?WW!m z9PB5;L5*v4#=gy{!FMUiN}5$%wZT2t#f!x$_lH6631#VboUY1 ze^CimWt8w|jab@Yk_+o+O+@df&d{1E!4$I(pwq4~Liw|wiPn8__VM;Hq2K;sVI|*B z?^A5Vx=GFW+|m|8W_zRir5G&MwI}7iMf7%!1-@C?4dOGe(^DfJgUp~V8}D6-Qe#JO zUFyJD?RkJoI{NVTv>~^C_6$fX@8w#I55Uai2>q^i_mH zU!ViBpW>WV2S1ZNBteyzLNHMhG1Ji`Yol(x#7+5H50@jA`hDnSU!RJf{8t z_q1l5^YtRGXfVe|r))Xxw~{Q!VIO?RSLI^5|6t`MKkCX_h|57_cyT>j1tw z(?|P!IPO509FsCF2_b0%3WB}pu@7=g?KK(h|4^YS%VfypXC-t(cM81se*h&5-k8=QjBVum@F%jV|7QTeDpPDnp;JJ3!qG4jRJ#qjIP0=}9>*FL#8?){fsxc4fw*y1NKt(m9pma;W0^Q32^p;M|P!Zo}Qn zFW{i$1aR@bNZj1LpuN?c-pHQ{DvK8r^VS&TZTmkFV*Ab2A zZM1Qv5i`Ly18m@#prj`m#&hS^2jm3)ITwW|xA1Y#oFWw2`4D2Sd7G9CXRSGdJJ>zjs|?uabrG(N3fr z6XzGshl&Te%n#8WjG*~0SZSLwvtGL}OVAD+PkzBm0dp8TAz|E9%1G?@NA&D|f805* z2mW72}EY*{+jvkd0U zx`9NfLl(4!YO zz~&R?WTZsie4mF8kX#k!N1qK@w=$FLoze*L>wL)%{#I;tO$O!1%|A)&$`NP}o4|X0a6Vmd{~|q}C4S2b;i1l9!@J>0+ zala1}q5fC&dn?8^d0SAnoTVlU0%3pKVff&q3TERzljjmIs0jA)da_*6>-S^fQ_m+v zt+zp9Iyw&@$}>z;$*BQ44;0EoWGfja$y4)CuRWfPn8a@xeHafV<4g~ zm!5kW0yToG)cS@JDQO(T7${H0ZJUenbc7k!%e*BDwRdUs`F!CueJRX&l7mk*UZVGg z92hD*g1n(!R4rVT4Vp8La}{Vp)tz2A9od9FeoD-vt)IyDo!J1(tD$YyIcyrWrLGGT zK;``k;ie&Hc8bD$Xk2g)?6`TiNZn2dubqN=ulD1ig=;yNRy|Z4bAzapGnnd62}I`A z6>|0Pf8?J`B=$=R;Y8F?93CrRG&F;8io6r~5qKQ6)kDF2fe%U4SqxhQnS!#mB3#Zn zIr@`SK>PIsJne89EpG0|qN)PY#AUrUOy1A@H*W)sUoV40@h|D4fMN5qw&&2w+Kv@? z*1*OIkBDfX2HrNB$BvGV#u~@3=>A5FeLYr%owtr-xLaQadW!pw`u7uq7A=6^+2^?3 zHs>64oWijN)?t>jB+i)~LwwI10r!xNWci~hj4(->t;x>A$v4~adWkB25_({~Z$6Yy z^QLpV@?fFgH;Cv~6?_f2@0cuaF)_Ptz(L{XkKiRb!& zq48LiP=q<*a%_WOB9;z?nq^OVL#pm((DO5+!Q`R}DivNMZDN@i^imIm#D;b1druvn z$iuXODC(Y7f)`bysP@k`-r?pN2iA zQ-Pp` z2^s%mxH~RHU!DjP${l{@+?2tiek*Xx+f@9iVNCO)qH%6l15qBM4a@2(NY1rN7^9+w ziRUV4i)IE+d2xwIo$zB0U;T~ax&4^)qh1{NITLBmGI&w68KP8+@n@a_ezHCW9^GwF z5)%Mr)(_F*_cX!vv}52WwUB!bWC4?VABv8oh9Qw5@e zwHO)S9NvaA58$?r5O)3OHcxh)$@G68!ZCNW&0W6s)9KUvaWHci^L#cT8(iYyeVH%u zn`q1!wtk0KPhV2kkk75g#S7Lyagq2_}5Gj zk&$QILe@b}oH?`jXc5bioj~X7D`NI-Ec1J{1$3sTz@@EwF!IMg_}KJ;9(GA*mfU_t z)J-CBcllQKVV;mos54`8mMMVst%+=TnI{H6_Q3#)0#Lsl$axj^VDu4=J(J=HpU0l3 zQt9X6=DkJC&%E{Q72PAKn{ymiWu}q9dCTx}xdRRSyOrb4EP+gogAm#@fSyug*c8R{ zP;kf$+{3nT3|)IXRh)#|Z^(nHOFqvhLyf4}8gs0}H*jaKH|ms6BR`&a;$?vYs6Wkt z5Dhh0yW}3(tD20Fk19yU@G#!<_CQD7W}5LK8`8dV`RF_mcvP3l+q(QGy1q%ESM6pq zKeqls-HV$+;kX0_wI_l4P&}8h>4UnBL3DG(OWIJ{%nS6PoEzx|_G%?VpT{%myj=|9 zDlFmctn<*&n?jmr{sgy>OlWWm!RJ*2IBa^2o)1e$-GCxwBer0kQ6Px#(Irin#=w5G zfRMniWO}?dQ1!h4PamSX?Q@uacRVQE&j-1{1E4u!BO~{topTXy!1Ogz#Qxp{E)PDI zb0KQ5Q)2ZH1|EW)uh)k93`yTYReE@TA~Gi;&Q=J-XC8&uVprA zECt)^sn}EN50z?Fcu)Thytuia@vVOZzi&n0Uu6+?M&D|l^PeQN6pX{q$xjx|9U9Aw zo((0xS~ft@m^3^g5eD|B^+*)Ih3h>FaNpoCI4!edD!I&;Pd?WHe)flK)%iqRw<(jR zi8J8uERHWJB7xK;k@+Kc+I-M%70NtvM5Xw%(8(AJAO78fg$XZc(#$&ab-iXToF4*f zasokahb#AuF(1|1rwhbH6yVGmFI2g-jJ$k5OVB4S$?)rEgU8T3=4#<#@G4e8i6Kd* z{V7WlxqaQAW=BR`JstXNU0CVjYBE&9bqvjd!P%f4Rn{H@fAU7y`05#)t?Pknv&S)Y zMJM3(eE~{J>oQwpo54*<1RRvYVBuUAYsF0=NAna;J<0=fB7nT7@p$-9I#hXzLSy%S z=zsW%WF3%TmMoKpy>s>0(pA#TyXFF%=$!_5by8{EK?tlgN`l~aS1LaqB zVAt46hky6Lc;!;$4a5Q`g2Wcrov`ldDonVt3_C>oh`Ngp=3Ebf(@!6x$JS56ydf@o zG|?Sm6o$Djk1r~`Ov5esj4p58fyYgAkhDLc2Tr^dZ2Z$feJ@KhHzT~*idMuI?YT(O z#2Nd+H)yzg7wvhK0;?n5;k(zmOq2~D=f=)~Ujw$_K0}>z(0d8>CuiZFQhk`nmt=F9 zObFENhK^f*aN8dvP|dc5U(HJ)%GH9+Ri6oa(q^)(ni}wg`CK062Q~4{g^P=x!OCDR zPmnhQjn;6kjIUd9jmmB;&)Wut9CJeZ9UoNxCF1r08D`~4S`c4&^Pubug>iw zXd4YesaFSN&KOTRO*3HXEIzu-SH^Eum%z?Ej{3ws2EUx?6pK%Ce&!K)Ajk(g!-N^# zu#C=$jD!gb#xOg@XEQgxPlP#ZM#)0XeHpX=5D8kSNPIG^us6s7uKEu{vxpol+_r=& z{#Xs|<2bM8f>aR1a_r4_1Qs-^GG%^cDDYK)sHvGCjpw1`5;vO()dZt}y=byUffS9- zGFznCk8PKhg6`~75F1oU8%GYn{l*M1^x4Gy9=I<1UQL)gu>@9cHpLz5)^ho^9MqLa z0W{h`Q`}F{kC%5KaeIxo8@4kCZ)`uz-8#kn_8 zvEVd2`m>m9vRVy$uE)^4%MQ>Ybs7{qP1(A96BKc8A#<``L59*_?tZBN&BS30IO31d z2d1$1$sNjnEy8MU>Y=<}bMRv2a@5oLh9+Mv3G2{_0?h()v}rkUoG1dC`so-v_9Jl` z$|v6!a?`qhr%}cvUbsL4U^MiFaK&4D-0IUwxh*;5UR7kkDFYU)YJ)GGcQ6$bDecgL z>iT0i+p?Za+&dGKJr2TH{YdO8UkhRv6lmeb8<4Gh2|j%55u*7SvgXAB67tUz219LN zS3?>aHXp$}*HFy-8w8=Nmop|?+!?n`Q&8PbjbSGRV^yyg^H*;cL_D)37W&?(T3d^< z?`K13^dgv5--;JD1OR`2Gd0fqhw_hBu_}?=jOvXZHc5-Knahn}pT=iQ`O$_8be;>I z_YT02p%8|+Ya^WD4{w)`!u=j6{I!23`c+5pME~l8&%U*sORAhcN-l;cVrPg>$8suG zG)PuiDsVHTr*vo}0=6#dp%+{Y*wSwTy20QdI4ugnn8As(zU(-pnI5Fgaj|Hp_z4;L zIGmR03yZge!1BeXvB`BBg$^I6; zc`JZ@f~~N9r6^oGl_6Lwnucw6OTewqw ze!&?&s&7IT76WxEy~qNP?b`5ehOIX|q6y)*r7Y8rv^`gLpi#(&74?`E|S# zlcgE06eq~dmq0a%_fS(X4GiDffXy8V)=gI%8QZgHu|Nrzm-kVpy&)KyWsFxMl(9(F z5hteoBW4d>=u+_u5VU;~W2w81bNX(?h9$9hurO3ub@(gpJRV1GNSSlbMNPqxL3xrh z;~hAu6vAJLbu?$>K6Wc_ffQ0kR(@NFK0__Q<45AczTfE4U;7}B$#vaFm5F-*|Zp{o+#qu#3;_WRR?~#JGgV1I2_4MWRz#6;vFXuywe#^ zXSyylKYcEwX3JYWW?aJjP%rq66L;)vr3`%%9;o3D;l};Hq(yBO ztNk_|^4K;yQAv+=2}_0)Zq9Jhe-880B?h%jI1g2(Jgc(J4Hl*-P;q`LY za+h=sjz^KBVW9g`6i;v*iWQ23!ryD6X{R=ywVU?^UaN7Oz{z)Ea7dQ%z4sEHhnGMs zFAQTx9>ArV>Eb92n<;yd9GZktDug_lP7_1uXxS*X} zKKBsEEu4b8#4~WB*kneJxry| zx)eTDS7M=r4PZRiA4XfNd&2eOpJ7^uJ3FR-HZx{8B zC}og>FAD_p`?>_M+}(%koYG)=-ft**ug3gW{FKH#h`Af$M6`MdTuyZ%lkC!P?i@qj;^+ztSY}7t zqOPG*DGMQf*?2Cg0bd4L!$~#>l=c1D@t;$0c0(*4|MMP}#=HZo6Q=BnNypJ=w>ER# zArjur=!aKIE9iT6RFLer(H0I$mm7|PhSs1)L z@gEy7BbrQG_Z*`RjDekng)lXCEm@_*Yv(hL-_!+<9mded06;)Vg*+TyF*hwrvF!@oadgc8)QkDEd@kOoN$l?WA!+u|3lu=6MfjN_2u# z_Ak^j>c*T;veaW~4Da*nc-ncM<1CEPq(j6Cp3FwP^3EGu1FnmOn zvEaC~-pe@tP0D0E+us9PCo15DaVA-toyWL+N6=ikp30fufQaMvVD|nuT=dCeKZGv9 z6E&*rAFeBsb0`wlNVsv_%3X|S)mb($d@Y$^5`|NWR|4a9k9%iK0Ff66zG4(s{5!xt z8spCBS#T_r4`Y}NuFLx|aw9%I@tKxBn8O^`o{nY)!4QA<0g)QBhWf3XftU8x;~LSA z=&-?n@|*tS%}v(FX3aDV`*H|YZgzuT+07Ub6E?ysXdK#^=BizFHv8v(_3-vE8X*HA==zrX|C>5OPWhkAs|B(hW0MTV%Mu6 zS4v6YrwZz_kmF%W9D~e)#aJ!oh}9d_(dAM(40kBf#m+8xI7pOE%P2f1(e?5lXxS$gA z953UcNJ(tW8v`X0OHksEBL+L_(WTRCV1u-o(CpcLd_IzeH)?(0ON1h9%AOBJ3E|w% zXQl8-R~lUF<>3VpP5k~OlX$L5V0B&P;o0*stYn}FJJW1CCYz2yu@P;26V-xsPqkQw z$I5JA7nfh>Q`TJ}6)gNL;k#`SEZVCATefGhW-*bl?NT@@J?8q9^K}_!s~$UP1HsX) z0O$Av^izxys~`Ri*JWqJ$D}*hd@c){5^BLFz#NuI24IKF7B(yV95J1=9%IWzn369A zyqb?w8M|A4u&i?eJKt(ET5agTbG@J7Y1BG6BWw^Bkr*;jWO0#=Z|YYV8YczCHBZi*T}H`Zg{nv=(RCnvnv%@r<;u zGV0zIqH0J7=Dw~#r?uC3oo8#Xrs55;I{z7*G+&a;edlP?aV;#}H-ShUTR}%w#$o+` z6Bx%GDey%p8^_1ypkJvEvfm{Gbi<`B{)Z z^$&T!VJ!2ao^ReH)5J?upO4!@9hij28mODWv0=Y%AhvB3jr!JucwDvcbhQeH{vd`0UwWbfHVD-a6Y1v+}~~h zkL3iA{iqyPTFFAun^<1?<>mNlh9^E4^bp=HI18-@;u&-MX-sOyC*piC11l2i;QP;f z?0CzoQ17Zz$+9r*OSnGr5vD8QdoHqH~!Eya>q!`N41W ztBxeQxT~LRj?jgIRtwZs@+K07>3DePAlRghg|&O|GraJDG{+sM8aEPAx?F+y?5&0QpMOKksvWq>xR|cX(gTCd zz-o3&Bq0li?-qT&Ke579J$-jx1`PJcE(W0bu8Ik#|P-I-R5XSEyyA z0o!k7kV%F?P?o+I4z+}0b@+NB&}Zn+!Bn9~_j44{GGU6t|Bz>K0G4ZJ(Sd0*;h-%G zdFItzj%k=II#NV+BM#t);yajYI7kjneF*Y%k|1Lb$68VpWe-P55%bBn@#~H#e9Eqe z;{zulxOG|H;ALPIhTjtqXA}7 z2DJ4^1J05DgHh|Ngu<*cn6fb#7J83IFU30;J+Pl@7A3&msn>{yLjrn~0^58<6n+bi z!s;)P`1OS-@euVFb`Eh_od5~QnaPolKF-B|GtZ;CbS~-?niCG(z%Fo!LJymrcw)m_ zG%WML6?=FvyTJ)}+ZFK+2u^_m&A~|b75K_T^3!Uu3csVA7Q9hf7 znXy@*y3&VUZ9I-;^;d)`#+i^$Com#$`o!$iM7E<-L0A_Rgc&wMEK2CX6Zel}zEL{- z+RiZ#6t_XSkr>dVa*#bR0~c-hiVJVdr1`Q3m`#PU%&oWH_&q=zPgoA)uBA5667z?? zmv6!i9U|<5s1Rt)_)(*%pwC)qKBax>J0LH>5MGo9o7Z{7QiB=XJZpLshzaK7)NDPl zN>patTi2tywl!2&uEx~^`pm}QWL)9KkUr(Lcwn(K6aHizqyH|IoVjv_gpZ746s}pr z;&0yM$K5pd!%jH#HVh8^VIjaQ9+I{7QS&92)iN+;tTMA; z^X?qH@Dzm+_wV7XsNZzjJvr8|VGO)8+5!$F1PVWXCxLgSL#o3M(h@BR>V`3>W^e>Q zx(w02>PcXj8iML6*;vtkR2W=hh7RS{Xx^Uz!Ypm}dWH=;`OIZc7;Ce0v$SzppA9xA za=gX;rEucXd01bvgpG6mOL{H@!3XtWZjNJy#yc0_t37AIs^%&3)yA?NoM6t2we0R5YeVRI>GPnbMzYU^($P6acXBm}9-A$CkZ-7HU9jpNwP)FV9kj`>WjPa8R&(nhrZrNhSc;pDr<9C()z#5_~a zLh;N*;x=l`R(iarZu&d$*_8_H`0pW1c`_Y3%zq2_o5^!Cs1k76mJbGAl~_DyCWKi9 zGC_s~5D@PS8Jdx(#C;dYS)2mfK|_e@-bITP44`F40vxe4g&q$Uy4=Ev%ou%iGEPBx znReo78ZCVK@jg+PoWkVntHgV;?$~p58yTu80F|gb;Ftg|F(lx zLvL|r=g-@4Q7u)VIdGQuw|g^Yd!MKGlYa3&>7?MXu@eN()~d0!oeV7hFbsPQr5WLW zKj~_%X(Xn81+3xvEG}Oq;jQ^60Ixi-QrrS375Qw{F7CauGmF;et;SvTL1?75i2ZAF z7W{upvoo$Hvl$s?VBPzJu5(ePZta6mwzmg%Z%CkCRWTqRU`MjXN$~VOtYMQiVwlZa zk^ZcU;r!2`(3mL&7d*{at^2!JtsV<3nY$fj!`;~T77HLI_aVmaI)gsO$LYyOm$9{M z6`N@Kn)dRN@T0dJyD#(`dF#qRW33p|tK|Tr+Z5TJKpB=ds|!`qWLbsoe5h;_#Z%G$ zL7un_<|ORKyW=iletHvl?M=a~N$PA}cOib$J_=*_->KQ`EujCV5$}&}g@M}zG*D*} zY0nTxvFZ}sG>$tXR_RgqzH#{2a3!+O7>r+Kgr}6oGj#YooxC`Qemi@H=X~rcZsr(H zGe=Hiq5nZV+IO0LQ5{>W%o$SWT@!^LVLfp7cPlA0sTUs4zJ@>Ul%Pk6E7NbPD!df; z4;63y#B6z4roBHL#Eh;9Kd4)RZ|!4Rp%aC(g;p@)*$)45#hE>ig3)eB3G?6HGOrwx zXKn1C(%#Y_G`YV5LMCEH?lMCyS=^)@rgzH0q8d z+aFmj2pPW+TArUkR~ci}-s(ydxxD`eE+-JJ_ZB6uUqW3G0j%a6oyFc$n5V{E9*p0Q ztCX(5^Ubp%H9ZiYY-}K2F~+d!s4;1~#zXIPU3jpsi9FftO{MP6Wwtr@3*{$mL-Em5 zkTYc}oAF;dn#fnfEh}AS&*yc#T5eul@=c1VerCwrKQ{q?zS$_0oYukp7W25w+&kfa z@g7vdKLrIgl5E-NWL&>Jjk+E&f%mF5sGK?jhl3x3b5<=jok+tyiw|NNEy8@)J#gtu zFoZn@Ao@E!{a`sBeR`X`oIWI!ZK=htD=2Op zzK-H?Z-~~<>1g_B89dJCxH_#K*eYj<{#eZUV!S}>j68E+I+B?;UkVMLKgEajj<9Uv zAwX`1v^&OwksGnc=*BCge5V(j60d~L?gfnY``OF}=V3fvqDs|2GYntO7<-Qlq1THU zV4d`Vx%aCWUw;#0ws2moyen&QN$eCDIsOiIDrzx1ykeLDrB7t+Zs4+y!K{qjdE)#z zhCUc4PQ>lRnfil|gk6btB$>NEarQxdp4pbuXk5a7LQ7VMIB zyJ_W#>#%0NI=kr!Twb-y;re}yfNJ*P#S2(-8%{W_Opd!xbJ|gV;T1PvI-&< z@RIO0=0J&314&Ci1(s4pRQ=Oz_DHP>zL`7(&2^u+Icx`7?ujFcz55~5yU zu`vA_*O9ne#ChWpns{P1HKYPEzg6$z$k^8h}+{}U`1CV|Qx zeY6sPi>0wvcxT@f_!`;Avysz$p@YFrK`c6z7jsXaY7t78sK zc9_CSKMbaZ#$t3;MFR*-j$^67hK*7_OV9lE!mzPZ8P^%jw4i4O9=&3S9eLyFcJ?7^ z`YnP)8x>Idw1u*=Q6S8i&7M8XFqe<%lQ=CkMkAn+)~Fl6D+eK#qB71ta}kF!{^0Gu zLF~=**CF_zI%B(UH6Gck%?t{QnI&%T!SnVyoViF7k31cv10M-~uUZZ+t63C27y~~} zOLARofAF8@NFqHs#&pajveB^_=60vze}A6~jyh;^-2N<(S97QTB`0#798XA%9Yl|= zY?}4bn)F)f(fF-^OtMhp`+DQoY|}@9D6hp+I3=yL)(1#rlN(tCI_KuP6BQj z+J!SBq}f)J2KfB;6ut65fh0s-GH+P^1&j`Sg|3?y(Ihz+g0E%s?$+!kacv$TlH5VB z9iPmOeiz3)eNlGR#1wkJ!wDtam6+s(<8YvC1I=%^LrO0HBmNR~SRKX9`fHj|zDb=9#6@Mp7zgYWQp(g8e`F%!1^lfk@4Q<-noOIX7Zj$Ju@8|*AmW*-~_p`83< z^7Us0DwJNuj!g-maQG&cn94Bv*G$1|+FZtb@q3~3Pg7yz&w2=e-EhoMmC?4YfW9#n zj0sovey3lLUQ<|ypvIZCZC~hZU%N~CI-rUnP9*m=2 z(JxkV40G)rK2i9qK-0%R3WW7ZaV z(CLR`xMw0-Uv?$pDmnB@T|0;$xQ+iVT!6kw+;_TdE}Y*S z0psqnut7_Ty;I@`&c<1oSQSSTHUTfK-<-MgCKD_m5hUEx@bs3GbY&x#C7NKsn5Jfd z*@5#kSvi@kl8;5Rzhkg#y)k_$UjzB`OYmivtx(#n6y2`Rg=cqW(;+E&=E|NV@^H5^ zdLGE(-8K6synpnh&^AdI4PP)Ys(G{?Fu+2?SjM9OW@DD{6hfgYY4NTT9Fk$QOvWuoWS;Fdoq?@(pVT8PW@|k zK)F>O_Nnv;yZpOgPWMl6_sT_Q)3dm48p6H!WkRXeJRlcVuqQq1A^1x)v{#>i@$S;h zp5R8fJYND-=7!)Ron@@azDn9$n~b-oEurT;w?S?$;QDFn^xSS+64Nw@ac;l3*yu+G_^NL3%k#bej7G2`mtbJZjKcS#{5<~msn2xREnB=ky3~7BM^mNg|8x3lB>3l13Jv$HDP8hHsrK(Uh zutq4Wu?)3)$IN|Kz=sCvh$Ak#i)%KYidG$$V>45Fa;d~0i@5b zf=Q3c3A1`PzDylQx4+27?2IaMbm<9P*vdJ`dqps^F(2+&v{KDUNAP!JIz8g8MXwmE zk}t0(FKkxl<7kC4+nA?AUoFX{2Yy~8_KYj9t5gC?2?%*6Imx#V|0U9l>AO)#o(I@LMt^0Bs zJOu~v%8EW(XQ;=P9pm;y=@gG~nONU|EAZ_7AtX)C(BBUSUVmnDt zeH1qBQNn}w-LZe6 zF^b%bBcm4ObhhMi{I%i;J~{RT_AVqi_fZ${EyBQQelD57v41bC7m$YJm8?k5IbOeY z2UUzs0Z%&F7+{D;`{E5u?(XnVe#KPYMfZUu5OR63i^@STE-nRSCWjLfi)fNuYRbxVO3+E`&ZDn!E=*S% z<~8&sll55_d3u)%U_Hl#m2{D(Ga8H0bZR12`!N_2Bg*1(0gi211f|m53nLR^xgNS1 zckk>bG$IpqL|<_Zl?U`l?_(UbxdJMh`P8UpBN?zijFE*IRIj%NEly8hC!dWLKCjIr z^+!IT-5f7Cm{y7phm%n$s2+`N>d-_c1J&ZR+1`(D(CB6;{8~H75xaH2Ce|KRp5mD8nhR4BWLaMKq5>A zrWQ%Fzji()uFF3l-T#WtwwcH}cTa)~17~pO>OT6Pj|VPV@`!$rJ}nH6JjjYXt)K(Z zb6AnFwk*%I5kD1h9P+d{+@(V)FJKXwJ=5HqK_?XK)vf zt!c+O&fb6(9T5Icj!`@L2nr*dnWk|I*plE0>^+ksLd%Wb&}JcyRyG10>XgOA6&3W- zJ1a~Zr_b&yxq}U1SK-{_B(u$Oo~(aICM+$!iRquDFo1Joe9>3E{8DLecFx ztajuD=%14Y2JLR(Ey9}j6dlCTFRkG5{ukY&XMq?nAI?SUfU+Dx<=-hJQ!x@wxib*) zD-FMMvva=2N8u}MrB`^)*gQTI$MlZ_=|{hLdHoY{^$7zedHYPb-{lGxil4aLZY0h3 zTR~(_QyOYNmieG+P6rx!P+>hlCdCS9c6mD;{*i;fwVz_cMj7HY`6=9~jR!N8*F5X( zicIdyQpB$uFEv;n1{AZv%TX0_zDHuxF>Q2F{|OQMs|dYhEHITFA*0V4h&DH`9PTtl ziNT#P^ysqCXs8q`PfMUyLL7Eh-A3QFKVZgKe@qrT#q-^Ff;=%h18v_2XZ;&RMJIn)qONJbD+`rD;KT%o~)6j>DX(TI~CmpK<4=BurZLgzg-_ z7QQIt;xe5C_MAolJjhMLn8T$wyCo1`%$-j^ojHkNeK|x+b1~O@tR(G~_wlNt7RDKJ zEQj_{&Xs$H+WGFq&zysyujLe6y7imdWgvcBGaYVCy9z0r%o$BCmyz&15%w>!K}Soj z_j~Xdy2ZJ|4bBs_xcn9IZ_+}+V=kLAB>+@w-qEP^ZD_SbhDi&MW?Hhlsr_EU8s@}P z=~8EQ?!gAUd!rr_;%njRvQ%91qzcyPDBz?iLJYY6nra=2K>45N;QgO3L4!%t+u> zuI|JoX=-#N=LdEj%tib4VIZ15ht)R-#H~eftcTwyZ{ph`cyQn!Hr7U=uuv9d*U7<} zi!X70u`1cIGzCxcC7BiRTTvlg6LZf?;%o2gRPXv}RJfN5as3J~{`+2L)mDETxTHot z9rmN|a3f}ZxPlf2%CM+qGV?Ha2M$(>vZm%dc5(rzT9_pN{J7C!x-xktXL@uv%goP|_*ETVuH& z=U5P2c-DfHbjd-XW2dlkfjc~08$^12-59gzHfm{f93{P-sLt(Bl*vlNH|c+9!e@Du z(sjngaUoQ@M3%8#xd=4|2|atUhB|l*Vs(8o{rzeb#HD{@wb?whh`deSncpG1lx^|L zk_)8YZ$3IM2*Zj3*bD7nNW(EpCrmgkN1KnFgcm9?MB+>p$rxIT%cSC| zgbPab-8i@vor4tk*oFaCf3UUW!dQ zeiCfIw$t!jQCQ%33Faw@u&d7$aSV@V(5cL$VVm>G^w&wS$6tYc&UBNl|~LCWDQSllfj>4%!(`n_s_$DNbtdL;?$$EOSb_E*#YrXHijrvOeSi7>CKY=FiW zgKXqXvcPk>(0b}v=3`jf|K|rtm>BE-ANUI<|KkVDtDVM{?fFcX_K!g1oCPqBbP66l z)M9>nTjHN9^P&ITTs(VkA(x}rL1nbXSy{g|DBo62D@OOz!VlT>VW%bp7yqQCW7~v5 z4q}W0w|}oJm&SNK&ePW5i2+I{xO0s>Gd9ATmd7Wcpk+Vq;oR=kP7~QCCOx-bG*tli~U9@bJ{7xzYk@>@Du}+G;Z!3lCH*`TpMLKOhm<^MO z6u$Bd!^Uq<@qhdUsp8@4{{w%)^ncfn85738tZ{(9O)r!$HJitu(7lGAAAXRZb;Oz9 zv@M)}X2}`;yP$0TgeOV-g_At_a}omi!c1rWGe0lB>f+7(gee95`7*hDlj`k!6ULh# zQN5S{TGNeB;v@Kfa-#SKMqd1VTKoC>qWk%K9kcm6q6_(&$(#8(8$9?XE4=twxQQR$ zdXOJjyOuw1mm9w*I*gyRZx#Pac{<R7 z6u=jEJ<8YYisOHCUdi_g+R9%Nw}XF3WHbNtfkS+e(P;k2T~EHfizmOY%$zTuU>!_S=soR<)pC8*+pL}! z^sQ~h4wY<{z|E0z;vwa4dWlY@S_L{lKgW{5 zsUdV3-lYppLUkSwQ$9o3_*{(GBMU*5D`7a_8Ms;^j-SnST5RLc#qR*VxHS$Hw{p42muBSO zRgP7ccU5@%QYI{Heurn?O@p^~S@idcOEmV4A~+sagrp@Q=y9^1?wl3^&5N_4rrm&A z%E@pus2lji#}95>wt zM@_@J@6Bk~;6ZODj_2CrNtiupFWys=XEWYr;g;+u5ZPn{+l)S-=;7JSwN*A4j5|Tv zJQ0e;r?L-c9K)qCMKJfQJFI+mkw(kQ;;rr_sQ>ULT6l0?^2xH8%jE?_&y>Numzyc$ z!pDJa>*+h*wZrKjO5wZK zIULiggUwbP>wn}8xJw4WRIS58|KVHI>s~ZnC+!C>bClU!FfczC+tll?{OUNi>D>9PGrm~*Zq{Rd{v5gJ^dR(RYcVxJNk##nkgKHRlUR#x28$>TYuKw-f0I z4PrV5IqJd`TUs74iJ9r=4Sb`yBv@z?+n+I=>2Cf_t$gj+niWQjduS9YT6DsHr-Yig+i?Mw4Vs*tJui8TS;o*!XEW6LtC_E*`Z+lN_?QNaDKZs8 z8z6o57<%}2K+DQ4aC3N&d}FtR4wotJal8)6*av?L$I#Z~D^&eCg8@AU@KSRgY2{q- zalZ&WT2+IWFBhZ0))l0lDFC%-Zg79prDC79?Hm_*^S$wV+1(KJJ6NeSINF6u7V4fG_`cOXIV>wRq zDj$R9`d%`6wu$efvWlti-G*-8?Lk<6GP})4n3-#<0R=bCK(q~u{bz+)^P!6z%cTsS z$ZEj#EOU&k+|E9~F%5O?Pe9Q@dDd7gm;SK2g1tV{*f+3|>w4I*lEG)m@xVs(UcH>T zyyyX}4fSLiW?HgdGm>DPZXwn@m18scGVJ$FR&>3t9cCHokZ6vjay6_A?%DiC#odS4 z^OAzpM|mPi{@w>Ucpkn6>M_Tvxo1b1JNsU-smBfpVJDU`9%-%Z{^_o!uc#~ehxG*pT-;Wr=aVaSpK)sF*5JpHr6&P0+u>% z;Y%MX0`p>JW~GA~HD2Su);2Zcv{VhgOTHfKA;rzq^5oEXSs;6b%k~WJcCt_z7sOvO zd8jHRiW-8^X!IxuM*9|l!HyBr7_HF9)qA#~%g@8ab?_04PZQ=1JblGWSR@Q>Q-yKg zW>@q`olp0i4Iqq@C8m!i(5;KELTX?G4J}E<^zA~Z{-KdJZs&F!r@vD}o5`qgZ-CCu z*#km*N{FYoE;(@e1KbJT4T3TZkt(*MCdy8@w?LYEUX$>|a5=F^vcS8CD)2_}F*Mgy z!L{{UiI((cP~M!5%Zv_Fp$Y9ou?3*5RgQcWP9VA~CIBxZ9PI4e@LtL`I;K@jTb)Yy zXAYN=@HJiF@i+&Ai7pMFHw=flZmP~t9W=F>%`C2tAzQU4K+sn^cyfLV%)d*?#E20p z_QfA6eif3GW!s_k`4pydmH?}>BOawiGD+&O>tG)qhpWo=;`W}Gcq%T4<^?Ble7;w( z^FMA*!T$i3Lvx^P3yb(6ACE2Zft>|UsO_Iz^7n~7bL;p$__t;y8~i5}X4L?)`8PqL zsSNqPyQ$pARq*$IDdHV^ldq5o7kQ!71g-;l{LDA|kke%}>iE>&7`QVyXqZcYP>!i?0KDcL7Fw z$#o0Myjzt2^DMre{gK`qJ5I!}2{WsXEo3x$93d(AA03MRgBAL}_^E@&sLDNWDoO|7 zVnZ67shA7z*SDbC<79X+!xEeoKfv;~QF^mG6^ud{82sf=TK`p1?+L?vgQY<@v77T7 z>q#*wCr_cZn>sdgvr|W{xn%p=`RJ#c#QH6e#P+uw&#%c5=VhBhG(Q@St6JcZsGDSZ z>wT(ovzp9X90paIdqF*Nm05gq7Dn2TGDB5t=?Md6M^Sdi0u_|YktY1p z191P62D>|@0wXQ9QH#9o(0J@FWazKQAM-_->{1i*GVCMyZm5Hb6Qihp`zcg$d`S&5 zd_erpJEB#oNA}y#!;WwBCh-$wR)CibXo`a ze-6T3PxJ8Sm?4ps&m%&crlX-t10M1*C(d)*Y4^!C++#JL8Cdy`-@uT|yz~Da++7 zxXh4)O&Z?cmw;;bOqsWD8_~D+H$DAXlbKw!5Y>vRY2EfL3< &2rcWe1u_emKXd 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 (AP7|rofFa&dysp6lQ!ia7lg63gQ`aP1 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

+[KG-ICL](docs/kgicl.md) answers queries in context, from prompt graphs around a few +example facts of the query relation. The official checkpoints run in pure PyTorch, +with fused Triton kernels for CUDA inference. Scores and gradients are verified +against the official implementation, with five upstream defects corrected. + +
+KG-ICL checkpoint download and inference + +```bash +mkdir -p checkpoints/kgicl/KG-ICL-6L +wget -P checkpoints/kgicl/KG-ICL-6L https://raw.githubusercontent.com/nju-websoft/KG-ICL/6a3166e347ae468acdfb30a70a2cf3608b66b8f1/checkpoint/KG-ICL-6L/model_best.tar + +python -m dicee --model KGICL --dataset_dir KGs/UMLS \ + --kgicl_checkpoint checkpoints/kgicl/KG-ICL-6L/model_best.tar --num_epochs 0 \ + --trainer torchCPUTrainer --scoring_technique NegSample \ + --batch_size 8 --eval_model test +``` + +Prompt examples are drawn with a seed per graph and relation, so predictions are +deterministic. The [KG-ICL guide](docs/kgicl.md) covers prompt graphs, the official +evaluation protocol, training, the corrected defects, and verification. + +
+ ## KGFM Link Prediction Test-set entity prediction with released checkpoints and no fine-tuning, using @@ -732,7 +756,8 @@ Tie strategy: **pessimistic** (worst rank among exactly equal scores after filte
Show results -**Bold** marks the best result per dataset and metric; **Yes** marks target graphs used in pretraining. +**Bold** marks the best result per dataset and metric; **Yes** marks target graphs used in pretraining; +**Partial** marks targets of which KG-ICL saw a subgraph in pretraining (FB V1 and NELL V1; [counts](docs/kgfm_benchmarks.md#kinship-and-nell-variants)). | Dataset | Model | Target graph used in pretraining? | MRR | Hits@1 | Hits@3 | Hits@10 | |---|---|:---:|---:|---:|---:|---:| @@ -741,64 +766,78 @@ Tie strategy: **pessimistic** (worst rank among exactly equal scores after filte | YAGO3-10 | ULTRA-50g | Yes | **0.5769** | **0.4966** | **0.6259** | **0.7203** | | YAGO3-10 | TRIX | No | 0.4094 | 0.3024 | 0.4574 | 0.6265 | | YAGO3-10 | Flock | No | 0.3998 | 0.3092 | 0.4526 | 0.5636 | +| YAGO3-10 | KG-ICL | No | 0.3792 | 0.2684 | 0.4356 | 0.5938 | | NELL-995-h25† | ULTRA-3g | No | 0.3557 | 0.2771 | 0.4001 | 0.5023 | | NELL-995-h25† | ULTRA-4g | Yes | **0.4032** | **0.3218** | **0.4476** | **0.5591** | | NELL-995-h25† | ULTRA-50g | Yes | 0.3991 | 0.3169 | 0.4448 | 0.5577 | | NELL-995-h25† | TRIX | No | 0.3729 | 0.2939 | 0.4136 | 0.5232 | | NELL-995-h25† | Flock | No | 0.3672 | 0.2868 | 0.4100 | 0.5199 | +| NELL-995-h25† | KG-ICL | Partial | 0.3375 | 0.2700 | 0.3716 | 0.4661 | | NELL-995-h50† | ULTRA-3g | No | 0.3480 | 0.2618 | 0.3960 | 0.5108 | | NELL-995-h50† | ULTRA-4g | Yes | **0.3975** | **0.3059** | **0.4468** | **0.5753** | | NELL-995-h50† | ULTRA-50g | Yes | 0.3828 | 0.2938 | 0.4375 | 0.5516 | | NELL-995-h50† | TRIX | No | 0.3637 | 0.2769 | 0.4057 | 0.5309 | | NELL-995-h50† | Flock | No | 0.3646 | 0.2730 | 0.4126 | 0.5423 | +| NELL-995-h50† | KG-ICL | Partial | 0.3374 | 0.2618 | 0.3760 | 0.4805 | | NELL-995-h75† | ULTRA-3g | No | 0.3298 | 0.2477 | 0.3741 | 0.4861 | | NELL-995-h75† | ULTRA-4g | Yes | **0.3732** | **0.2848** | 0.4164 | **0.5470** | | NELL-995-h75† | ULTRA-50g | Yes | 0.3640 | 0.2800 | **0.4180** | 0.5239 | | NELL-995-h75† | TRIX | No | 0.3428 | 0.2593 | 0.3798 | 0.5075 | | NELL-995-h75† | Flock | No | 0.3469 | 0.2585 | 0.3882 | 0.5227 | +| NELL-995-h75† | KG-ICL | Partial | 0.3286 | 0.2543 | 0.3644 | 0.4699 | | NELL-995-h100 | ULTRA-3g | No | 0.3159 | 0.2368 | 0.3546 | 0.4713 | | NELL-995-h100 | ULTRA-4g | Yes | 0.3560 | 0.2719 | 0.3940 | 0.5239 | | NELL-995-h100 | ULTRA-50g | Yes | **0.3619** | **0.2803** | **0.4076** | **0.5271** | | NELL-995-h100 | TRIX | No | 0.3354 | 0.2504 | 0.3720 | 0.5053 | | NELL-995-h100 | Flock | No | 0.3397 | 0.2481 | 0.3840 | 0.5202 | +| NELL-995-h100 | KG-ICL | Partial | 0.3308 | 0.2552 | 0.3675 | 0.4810 | | FB15k-237 | ULTRA-3g | Yes | **0.3693** | 0.2718 | **0.4101** | **0.5620** | | FB15k-237 | ULTRA-4g | Yes | 0.3684 | 0.2723 | 0.4051 | 0.5593 | | FB15k-237 | ULTRA-50g | Yes | 0.3675 | **0.2724** | 0.4037 | 0.5579 | | FB15k-237 | TRIX | Yes | 0.3618 | 0.2649 | 0.3989 | 0.5546 | | FB15k-237 | Flock | Yes | 0.3116 | 0.2215 | 0.3442 | 0.4912 | +| FB15k-237 | KG-ICL | Partial | 0.3310 | 0.2416 | 0.3626 | 0.5098 | | WN18RR | ULTRA-3g | Yes | 0.3691 | 0.2924 | 0.3923 | 0.5329 | | WN18RR | ULTRA-4g | Yes | 0.4838 | 0.4146 | 0.5198 | 0.6173 | | WN18RR | ULTRA-50g | Yes | 0.4282 | 0.3641 | 0.4600 | 0.5463 | | WN18RR | TRIX | Yes | 0.5065 | 0.4592 | 0.5217 | 0.6040 | | WN18RR | Flock | Yes | **0.5303** | **0.4783** | **0.5482** | **0.6367** | +| WN18RR | KG-ICL | No | 0.4387 | 0.4017 | 0.4515 | 0.5137 | | KINSHIP | ULTRA-3g | No | 0.2054 | 0.1439 | 0.2067 | 0.3156 | | KINSHIP | ULTRA-4g | No | 0.1298 | 0.0545 | 0.1336 | 0.2649 | | KINSHIP | ULTRA-50g | No | 0.2919 | 0.1858 | 0.2914 | 0.5442 | | KINSHIP | TRIX | No | 0.1487 | 0.1020 | 0.1373 | 0.2007 | | KINSHIP | Flock | No | **0.3803** | **0.2751** | **0.4013** | **0.6001** | +| KINSHIP | KG-ICL | No | 0.1522 | 0.0703 | 0.1480 | 0.3012 | | UMLS | ULTRA-3g | No | 0.6960 | 0.5983 | 0.7474 | 0.8956 | | UMLS | ULTRA-4g | No | 0.6684 | 0.5749 | 0.7118 | 0.8601 | | UMLS | ULTRA-50g | No | **0.8061** | **0.7330** | **0.8419** | **0.9607** | | UMLS | TRIX | No | 0.7256 | 0.6430 | 0.7632 | 0.8986 | | UMLS | Flock | No | 0.7768 | 0.7005 | 0.8169 | 0.9244 | +| UMLS | KG-ICL | No | 0.7797 | 0.7095 | 0.8132 | 0.9357 | | Countries-S1 | ULTRA-3g | No | 0.9375 | 0.8750 | **1.0000** | **1.0000** | | Countries-S1 | ULTRA-4g | No | **1.0000** | **1.0000** | **1.0000** | **1.0000** | | Countries-S1 | ULTRA-50g | No | 0.9757 | 0.9583 | **1.0000** | **1.0000** | | Countries-S1 | TRIX | No | 0.9271 | 0.8542 | **1.0000** | **1.0000** | | Countries-S1 | Flock | No | 0.9271 | 0.8542 | **1.0000** | **1.0000** | +| Countries-S1 | KG-ICL | No | 0.9132 | 0.8333 | **1.0000** | **1.0000** | | Countries-S2 | ULTRA-3g | No | 0.8715 | 0.7500 | **1.0000** | **1.0000** | | Countries-S2 | ULTRA-4g | No | **0.9167** | **0.8333** | **1.0000** | **1.0000** | | Countries-S2 | ULTRA-50g | No | 0.9062 | 0.8125 | **1.0000** | **1.0000** | | Countries-S2 | TRIX | No | 0.8854 | 0.7708 | **1.0000** | **1.0000** | | Countries-S2 | Flock | No | 0.8854 | 0.7708 | **1.0000** | **1.0000** | +| Countries-S2 | KG-ICL | No | 0.6643 | 0.5000 | 0.7708 | **1.0000** | | Countries-S3 | ULTRA-3g | No | 0.2354 | **0.0625** | 0.2917 | 0.6458 | | Countries-S3 | ULTRA-4g | No | 0.2459 | 0.0208 | 0.4375 | 0.5000 | | Countries-S3 | ULTRA-50g | No | 0.2049 | **0.0625** | 0.1667 | 0.6042 | | Countries-S3 | TRIX | No | **0.3625** | **0.0625** | **0.5833** | **0.8958** | | Countries-S3 | Flock | No | 0.2533 | 0.0208 | 0.4583 | 0.5000 | +| Countries-S3 | KG-ICL | No | 0.2455 | 0.0417 | 0.3958 | 0.5208 | † Original splits contain training/test leakage: h25/h50/h75 include 52/33/9 distinct test facts in training. Splits are preserved; these scores are not strictly held-out estimates. +KG-ICL uses prompt seed 0 and no answer-distance mask; its paper reports the official protocol, see the [KG-ICL guide](docs/kgicl.md#scores-and-the-official-evaluation-protocol). +
@@ -816,6 +855,10 @@ RTX 4070 Ti SUPER, float32, matched query batches, and five-repeat medians on sa \* Flock includes independently sampled walks at the same budget; identical-walk neural speedups are **1.23–2.01×**. YAGO3-10 Flock timings varied more. See the [full comparison and validation](docs/kgfm_inference.md). +KG-ICL, measured separately on an RTX 5070 Laptop GPU against the official code with its +[corrected defects](docs/kgicl.md#upstream-defects-corrected-in-dice), is **49.76×** faster on FB15k-237, +**4.43×** on WN18RR, and **35.58×** on YAGO3-10 ([details](docs/kgfm_inference.md#kg-icl)). +
## Link Prediction Benchmarks diff --git a/docs/kgfm_benchmarks.md b/docs/kgfm_benchmarks.md index 687226279..5e4d5f65c 100644 --- a/docs/kgfm_benchmarks.md +++ b/docs/kgfm_benchmarks.md @@ -23,6 +23,10 @@ lists all 50 graphs. It includes FB15k-237, WN18RR, YAGO3-10, and NELL995; KINSHIP, UMLS, and Countries are absent. **No** indicates transfer outside a checkpoint's documented training mixture. The original 4g/50g run records retain the earlier metadata; these corrected labels do not change the measured scores. +KG-ICL was pretrained on FB V1, NELL V1, and CoDEx-small +([configuration](https://github.com/nju-websoft/KG-ICL/blob/6a3166e347ae468acdfb30a70a2cf3608b66b8f1/src/pretrain.py#L72)). +FB V1 and NELL V1 are GraIL subgraphs of FB15k-237 and NELL-995, so **Partial** +marks those targets for KG-ICL (counts below). ## Checkpoints and evaluation settings @@ -33,6 +37,7 @@ the earlier metadata; these corrected labels do not change the measured scores. | ULTRA-50g | [ultra_50g.pth](https://github.com/DeepGraphLearning/ULTRA/blob/427966ad8ed60420eef034063d44f3153addff90/ckpts/ultra_50g.pth) | `checkpoints/ultra_50g.pth` | [ULTRA](ultra.md) | | TRIX | [entity_prediction.pth](https://github.com/yuchengz99/TRIX/blob/7596e14eefefe89e61396205a0550172cadeddb0/entity_prediction.pth) | `checkpoints/trix/entity_prediction.pth` | [TRIX](trix.md) | | Flock | [flock_entity.pth](https://github.com/jw9730/flock/blob/f35103d25a78bdf4075de5c673a51de4979aa4d7/checkpoints/flock_entity.pth) | `checkpoints/flock/flock_entity.pth` | [Flock](flock.md) | +| KG-ICL | [KG-ICL-6L/model_best.tar](https://github.com/nju-websoft/KG-ICL/blob/6a3166e347ae468acdfb30a70a2cf3608b66b8f1/checkpoint/KG-ICL-6L/model_best.tar) | `checkpoints/kgicl/KG-ICL-6L/model_best.tar` | [KG-ICL](kgicl.md) | Runs use float32, TF32 disabled on GPU, four CPU threads, 128 test triples per batch, and seed 42. ULTRA/TRIX on UMLS use batches of 8 and seed 1. @@ -40,18 +45,20 @@ Flock uses 128 base walks of length 128, six refinements, and one prediction per query: a single-seed result, not an ensemble. Its query order and batch boundaries affect sampling; see the [sampling notes](flock.md#checkpoints-and-zero-shot-evaluation). -| Dataset | ULTRA device / query batch | TRIX device / query batch | Flock device / query batch | -|---|---|---|---| -| Countries-S1 / S2 / S3, UMLS | CPU / 8 | CPU / 8 | CUDA / 1 | -| WN18RR | CUDA / 8 | CUDA / 4 | CUDA / 1 | -| YAGO3-10 | CUDA / 2 | CUDA / 2 | CUDA / 1 | -| FB15k-237 | CUDA / 4 | CUDA / 2 | CUDA / 1 | -| KINSHIP | CUDA / 8 | CUDA / 2 | CUDA / 1 | -| NELL-995-h25 / h50 / h75 / h100 | CUDA / 4 | CUDA / 2 | CUDA / 1 | - +| Dataset | ULTRA device / query batch | TRIX device / query batch | Flock device / query batch | KG-ICL device / query batch | +|---|---|---|---|---| +| Countries-S1 / S2 / S3, UMLS | CPU / 8 | CPU / 8 | CUDA / 1 | CUDA / 16 | +| WN18RR | CUDA / 8 | CUDA / 4 | CUDA / 1 | CUDA / 16 | +| YAGO3-10 | CUDA / 2 | CUDA / 2 | CUDA / 1 | CUDA / 16 | +| FB15k-237 | CUDA / 4 | CUDA / 2 | CUDA / 1 | CUDA / 16 | +| KINSHIP | CUDA / 8 | CUDA / 2 | CUDA / 1 | CUDA / 16 | +| NELL-995-h25 / h50 / h75 / h100 | CUDA / 4 | CUDA / 2 | CUDA / 1 | CUDA / 16 | + +KG-ICL uses prompt seed 0 and no answer-distance mask; its official evaluation +protocol differs, see the [KG-ICL guide](kgicl.md#scores-and-the-official-evaluation-protocol). The September 10 runs used PyTorch 2.5.1, Triton 3.1.0, an AMD Ryzen 7 7800X3D CPU, and an RTX 4070 Ti SUPER GPU. KINSHIP, all four NELL variants, and the ULTRA-4g/50g runs (September 21) use -PyTorch 2.9.1+cu128, Triton 3.5.1, and an RTX 5070 Laptop GPU. These are accuracy +PyTorch 2.9.1+cu128, Triton 3.5.1, and an RTX 5070 Laptop GPU, as do the KG-ICL runs (October 5). These are accuracy results; controlled timings are in the [inference speed comparison](kgfm_inference.md). ## KINSHIP and NELL variants @@ -94,6 +101,22 @@ zero-shot held-out estimates. The upstream data commit predates both checkpoints file hashes and all split comparisons are saved in `Experiments/nell-pretraining-overlap/audit.json`. +**Pretraining overlap (KG-ICL):** exact triple matches against the training and +validation files of FB V1, NELL V1, and CoDEx-small in the official `datasets.zip` +at the pinned commit. GraIL's NELL V1 names entities `concept:type:name`; they are +compared as `concept_type_name`, the NELL-995 variants' spelling. + +| Target | Pretraining graph | Distinct test facts present | Percentage | Shared entities | +|---|---|---:|---:|---:| +| FB15k-237 | FB V1 | 0 / 20,466 | 0.00% | 1,594 | +| NELL-995-h25 | NELL V1 | 257 / 9,185 | 2.80% | 2,929 | +| NELL-995-h50 | NELL V1 | 200 / 5,392 | 3.71% | 2,825 | +| NELL-995-h75 | NELL V1 | 192 / 4,389 | 4.37% | 2,750 | +| NELL-995-h100 | NELL V1 | 174 / 3,746 | 4.64% | 2,488 | + +All 4,734 FB V1 training and validation facts are FB15k-237 training facts. No +other README target shares entities with KG-ICL's pretraining graphs. + ## Reproduction Place the checkpoints at the paths above and datasets under `KGs//` @@ -129,7 +152,18 @@ python benchmarks/kgfm_zero_shot.py --model ULTRA --ultra-checkpoint 4g \ --output Experiments/kgfm-ultra-checkpoints-20260921/NELL-995-h50/ULTRA-4g ``` -Use a separate output per checkpoint. For other datasets, use the settings above. The +Use a separate output per checkpoint. For other datasets, use the settings above. +KG-ICL runs every dataset with the same settings; `--prompt-seed` selects the +prompt sampling seed (default 0) and `--distance-mask` applies the official +answer-distance heuristic, which the README results do not use: + +```bash +python benchmarks/kgfm_zero_shot.py --model KGICL --dataset FB15k-237 --device cuda:0 \ + --query-batch-size 16 --batch-size 128 --threads 4 --seed 42 --tie-policy pessimistic \ + --output Experiments/kgfm-kgicl-20261005/FB15k-237/KGICL +``` + +The [runner](../benchmarks/kgfm_zero_shot.py) verifies unchanged weights and saves progress after each batch. An identical invocation resumes; changed settings or source require a new output directory. Local reports include metrics, exact diff --git a/docs/kgfm_inference.md b/docs/kgfm_inference.md index 50ba24e9e..436edb842 100644 --- a/docs/kgfm_inference.md +++ b/docs/kgfm_inference.md @@ -82,6 +82,72 @@ YAGO3-10 Flock had higher timing variance: official native repeats ranged 394–583 ms/query (DICE 65–67), and replay repeats ranged 76–170 ms/query (DICE 47–54). Treat its reported median speedups as approximate. +## KG-ICL + +Measured on 2026-10-05 against the [pinned official KG-ICL](https://github.com/nju-websoft/KG-ICL/tree/6a3166e347ae468acdfb30a70a2cf3608b66b8f1) +with the [bug-fix patch](../tests/fixtures/kgicl/upstream-fixes.patch) applied (see the [KG-ICL guide](kgicl.md)), +on different hardware than the table above: an RTX 5070 Laptop GPU (8 GiB) and +an Intel Core i7-14700HX. + +| Dataset | Query batch | Official ms/query | DICE ms/query | Speedup | CUDA MiB | +|---|---:|---:|---:|---:|---:| +| FB15k-237 | 8 | 68.25 | 1.37 | 49.76× | 3096 → 177 | +| WN18RR | 16 | 3.63 | 0.82 | 4.43× | 924 → 326 | +| YAGO3-10† | 2 | 277.71 | 7.80 | 35.58× | 3382 → 373 | + +† Validated against the official model in float64, see below. + +The workload matches the table above: 128 test triples (seed 42), head and +tail prediction, and the complete training graph plus inverse edges. Both +implementations read the same prompt graphs, DICE's seeded samples written in +the official case format, and apply the official answer-distance mask. The +official code runs in its own environment (Python 3.9, PyTorch 2.7.1 with CUDA +12.8, torch-scatter 2.1.2); DICE uses PyTorch 2.9.1 with CUDA 12.8 and Triton +3.5.1. Both use float32 with TF32 disabled and four CPU threads, with two +warmups and five timed repetitions (medians), one process at a time. The +driver's GPU process listing was unavailable on this machine +(`--allow-unchecked-gpu`); no other compute job ran. Query batches are the +largest the official code fits in 8 GiB; it ran out of GPU memory on YAGO3-10 +with four queries. + +Prompt graph extraction is preprocessing for both implementations. The +official code assembles and encodes the prompt graphs of every batch, while +DICE encodes each relation's prompts once and caches them, as ULTRA caches +relation representations. Without that cache, DICE takes 8.97 ms/query on +FB15k-237. DICE gains from larger batches: with 16 queries per pass it takes +1.19 ms/query on FB15k-237 and 4.82 ms/query on YAGO3-10, with scores +bitwise identical to the table's runs. + +Scores agree within `atol=2e-4, rtol=2e-4` on FB15k-237 (maximum absolute error +`1.84e-4`) and WN18RR (`7.25e-5`), and filtered MRR and hit rates match (MRR +within `5e-8`). On YAGO3-10, float32 scores differ by up to `2.7e-3`: one entity +has 61,044 incoming edges, and long float32 sums depend on their order. +Against the official model in float64, run with one query per batch because two +do not fit in float64, DICE's maximum error is `2.65e-5` (mean `6.9e-7`) and +the official float32 code's is `2.73e-3` (mean `9.7e-5`). DICE's MRR equals the +float64 value; hit rates match. + +### Query answering rows + +Warm atomic rows in the query evaluator under deterministic algorithms, as in +complex query answering: batches of 8 random head–relation pairs scored against +all entities, on the same laptop GPU, with the KG-ICL recipes' 512 MiB cache of +per-layer relation tables (`projection_cache_mb`): + +| Inference graph | Entities | Relations with inverses | Edges | ms/row | First pass over all relations | +|---|---:|---:|---:|---:|---:| +| FB15k237+H | 14,505 | 474 | 544,230 | 1.01 | 16.9 s | +| NELL995+H | 63,361 | 400 | 228,426 | 1.71 | 8.4 s | +| ICEWS18+H | 20,840 | 500 | 426,608 | 1.04 | 20.0 s | +| UltraQuery FB15k237 | 14,505 | 474 | 544,230 | 0.98 | 14.1 s | +| UltraQuery NELL995 | 63,361 | 400 | 228,426 | 1.68 | 7.9 s | +| UltraQuery inductive FB15k237 (550) | 13,438 | 312 | 136,560 | 0.54 | 5.7 s | +| UltraQuery WikiTopics art | 10,000 | 129 | 54,524 | 0.55 | 2.7 s | + +The first pass samples and encodes the prompt graphs of every relation. With the +default 64 MiB table cache, graphs with hundreds of relations recompute tables: +FB15k237+H then takes 2.55 ms/row. + ## Reproduce Use the pinned official checkout with PyTorch 2.5.1/CUDA 12.4, PyG 2.4.0, @@ -101,3 +167,18 @@ python benchmarks/kgfm_upstream.py --model ULTRA \ Use the table’s batch sizes for the other pairs. For Flock, use `--queries 32 --query-batch-size 1 --walk-num 128 --replay-queries 8`. All generated JSON, score tensors, and walk records land in the `Experiments/` directories. + +KG-ICL's official worker runs in its own environment, passed with +`--upstream-python`: Python 3.9 with PyTorch, a matching torch-scatter build, +NumPy, SciPy and NetworkX. The runner applies the bug-fix patch to a temporary +copy of the pinned checkout; `--upstream-variant unpatched` times the released +code. Where `nvidia-smi` cannot list GPU processes, `--allow-unchecked-gpu` +records that instead of aborting; make sure no other GPU work runs. + +```bash +python benchmarks/kgfm_upstream.py --model KGICL \ + --upstream-root /path/to/KG-ICL --upstream-python /path/to/kgicl-env/bin/python \ + --indexed-data Experiments/kgfm-kgicl-20261005/FB15k-237/KGICL \ + --queries 128 --query-batch-size 8 --repeats 5 --warmups 2 \ + --output Experiments/official-comparison/FB15k-237/KGICL +``` diff --git a/docs/kgicl.md b/docs/kgicl.md new file mode 100644 index 000000000..c449bd7c1 --- /dev/null +++ b/docs/kgicl.md @@ -0,0 +1,364 @@ +# KG-ICL in DICE + +[Paper](https://arxiv.org/abs/2410.12288) · +[Pinned official implementation](https://github.com/nju-websoft/KG-ICL/tree/6a3166e347ae468acdfb30a70a2cf3608b66b8f1) · +[Bug-fix patch](../tests/fixtures/kgicl/upstream-fixes.patch) + +KG-ICL answers a query `(s, q, ?)` in context. It samples a few example facts +`(u, q, v)` of the query relation, extracts a prompt graph around each example +and encodes the relations of these prompt graphs. The mean prompt encoding +initializes the relations of a query-conditioned reasoner that expands one hop +per layer from `s` over the inference graph. DICE provides `KGICL` for entity +prediction with the graph, training and reload interfaces of [ULTRA](ultra.md), +[TRIX](trix.md) and [Flock](flock.md). The official `KG-ICL-4L`, `KG-ICL-5L` and +`KG-ICL-6L` checkpoints load without renaming or dropping parameters. Only +PyTorch is required; Triton adds the fused CUDA inference path. NetworkX, +torch-scatter and the official code are needed only to regenerate fixtures. + +## Checkpoints and zero-shot evaluation + +```bash +mkdir -p checkpoints/kgicl/KG-ICL-6L +wget -P checkpoints/kgicl/KG-ICL-6L https://raw.githubusercontent.com/nju-websoft/KG-ICL/6a3166e347ae468acdfb30a70a2cf3608b66b8f1/checkpoint/KG-ICL-6L/model_best.tar +sha256sum checkpoints/kgicl/KG-ICL-6L/model_best.tar +# 80f885ffa2c0175cd6ed829af99ae45177fdb5f77302c7648591bbdf62bc1c81 + +python -m dicee --model KGICL --dataset_dir KGs/UMLS \ + --kgicl_checkpoint checkpoints/kgicl/KG-ICL-6L/model_best.tar --num_epochs 0 \ + --trainer torchCPUTrainer --scoring_technique NegSample \ + --batch_size 8 --eval_model test \ + --path_to_store_single_run Experiments/kgicl-zero-shot +``` + +The directory contains `train.txt`, `test.txt` and optionally `valid.txt` in +`(head, relation, tail)` order. Reasoning and prompt graphs use training facts +only. Validation and test facts are used for filtered evaluation. The released +`model_best.tar` holds `{"state_dict", "optimizer_state_dict", "epoch_id"}`; +`load_pretrained()` also accepts a `{"model": ...}` wrapper or a bare state +dictionary. Keys and shapes are checked before loading. Fine-tuning starts with +a new optimizer. + +| Setting | Default | Meaning | +|---|---:|---| +| `kgicl_dim` | 32 | Hidden dimension | +| `kgicl_attn_dim` | 5 | Reasoner attention dimension | +| `kgicl_num_layers` | 6 | Reasoner layers: 4, 5 or 6 for the official checkpoints | +| `kgicl_prompt_layers` | 3 | Prompt encoder layers | +| `kgicl_prompt_hops` | 3 | Prompt distance bound `k`; sets the token table size | +| `kgicl_shots` | 5 | Prompt graphs per query relation | +| `kgicl_prompt_open_nodes` | 50 | Further entities per prompt graph, see below | +| `kgicl_prompt_seed` | 0 | Seed of example and entity sampling | +| `kgicl_masked_distances` | unset | Hop distances whose entities score zero | +| `kgicl_query_batch_size` | 8 | Queries per batched GPU reasoning pass | + +The first five settings determine checkpoint shapes; leave them at their +defaults for `KG-ICL-6L`. Generic `embedding_dim` does not control KG-ICL. +`graph_relation_cache_mb` bounds the cached prompt encodings and +`graph_projection_cache_mb` the per-layer relation tables of the fused path. + +## Prompt graphs + +DICE builds prompt graphs from the attached graph as the official data +processing builds them (`utils_all.py`, `enclosing=False`): + +- Examples are up to `kgicl_shots` distinct facts `(u, q, v)` of the direct + relation `q`. With `n < shots` facts, shot `j` uses example `j mod n`. +- Distances are undirected hop counts in the attached graph, computed up to + `k = 3` from `u` and from `v`. The prompt graph contains `u`, `v`, every + entity `x` within `k` of both with `dist(x,u) + dist(x,v) <= k`, and up to 50 + further entities within `k` of both. It contains every fact among them. +- Entity tokens are `(dist(x,u), dist(x,v))`. `u` receives the head token and + `v` the tail token. An inverse query relation `q⁻` reuses the examples of `q` + with head and tail tokens swapped; the other tokens keep their `(u, v)` order, + as in the released code. +- A relation without facts uses the official fallback: two nodes joined by one + query-relation edge. + +The official code samples examples and further entities with unseeded NumPy +calls once, offline. DICE draws them from CPU generators seeded with +`sha256("kgicl-prompt:{seed}:{relation}")`, for the prompt seed and the public +ID of the direct relation; further entities additionally use the example index. +Examples are drawn from the relation's facts sorted by `(head, tail)`. A graph, +relation and seed therefore always produce the same prompt graphs, independently +of query batches, call order and other relations. Prompt graphs are built on +first use. Their encodings are cached per relation during inference and cleared +when the graph, weights, device or settings change. During training, each shot +draws one of the relation's examples at random, as the official training does. + +## Scores and the official evaluation protocol + +Entities the reasoner does not reach within `kgicl_num_layers` hops score exactly +zero, as in the official code. The official evaluation differs from DICE's +benchmark protocol in three ways, which DICE exposes but does not apply by default: + +- **Inference graph.** Official test queries reason over training plus + validation facts; prompt graphs use training facts only. DICE uses the graph + passed to `set_graph()` for both. +- **Distance mask.** Official evaluation computes, from validation facts, the + fraction of answers at each hop distance and zeroes entities first reached at + distances below 2% (always including the query head). Use + `--kgicl_masked_distances 0 5 6` or `answer_distance_rates()` with + `benchmarks/kgfm_zero_shot.py --distance-mask` to apply it. +- **Ties.** Official ranks break exact ties by entity ID (`rankdata(method='ordinal')`). + +## Training and fine-tuning + +Entity prediction supports `NegSample`, `FixedNegSample`, `KvsAll`, `1vsAll`, +`1vsSample` and `KvsSample`, with grouped strict negatives and adversarial BCE: + +```bash +python -m dicee --model KGICL --dataset_dir KGs/UMLS \ + --kgicl_checkpoint checkpoints/kgicl/KG-ICL-6L/model_best.tar \ + --trainer torchCPUTrainer --scoring_technique NegSample \ + --strict_negative_sampling --adversarial_temperature 1 --neg_ratio 64 \ + --batch_size 8 --num_epochs 5 --optim Adam --lr 0.0005 +``` + +Training removes supervised facts and their inverses from the reasoning graph; +pair queries hide all their known answers. Prompt graphs keep all training facts, +as in the official training. Training mode samples RReLU slopes, applies the +prompt encoder's dropout and draws prompt examples at random. DICE trains with +its own objectives; it does not reproduce the official multi-graph pretraining +loop or its relation-dropout augmentation. Native CPU/single GPU and +single-device Lightning are supported. BPE, distributed training, +cross-validation and static embedding export are rejected. + +## Python use and experiment reloads + +```python +import torch +from dicee.models import KGICL + +facts = torch.tensor([[0, 0, 1], [1, 1, 2], [2, 0, 0], [0, 1, 2]]) +model = KGICL(dict(num_entities=3, num_relations=2)).load_pretrained( + "checkpoints/kgicl/KG-ICL-6L/model_best.tar") +model.set_graph(facts).eval() +with torch.no_grad(): + triples = model(torch.tensor([[0, 1, 2]])) + tails = model(torch.tensor([[0, 1]])) # (head, relation) + heads = model.forward_k_vs_all_heads(torch.tensor([[1, 2]])) # (relation, tail) +``` + +Scores are logits. Call `.eval()` for inference. Triples use DICE's +`(head, relation, tail)` order. Head prediction conditions on the converted +inverse relation, as the official evaluation does. `set_graph()` adds inverse +edges, deduplicates facts and resets prompt graphs; pass +`inverse_relations={direct_id: inverse_id}` for vocabularies with explicit +inverses. `prompt_graphs(relation)` returns the prompt graphs of an internal +relation ID (inverses are `r + R`), `encode_prompts(relation, graphs)` encodes +any prompt graphs, and `use_prompts({relation: graphs})` replays fixed prompt +graphs, for example ones recorded from the official loader. + +```python +from dicee import KGE + +kge = KGE(path="Experiments/kgicl-zero-shot") +tails = kge.predict_missing_tail_entity("entity_a", "relation_r") +``` + +Keep `kgicl_graph.pt` beside the weights, configuration and vocabularies when +moving an experiment. Prompt graphs are rebuilt from it with the saved seed. + +## Determinism and batching + +Inference is deterministic, and a row depends only on the graph, weights, +settings, head and relation: + +- The PyTorch path scores each query alone during inference, so its rows never + depend on the batch. On CUDA it is bitwise reproducible under + `torch.use_deterministic_algorithms(True)` (set `CUBLAS_WORKSPACE_CONFIG`). +- The fused CUDA path (Triton) keeps a dense entity-major `[entities, queries, dim]` + state with an active mask: messages leave only active entities, which + reproduces the official hop-by-hop expansion. One program aggregates the + incoming edges of one entity for a block of four queries, whose source states + are contiguous; the attention's source term `Ws_attn h` is projected once per + entity and layer instead of once per edge. Each row's aggregation and GRU + update use a fixed operation order without atomics, so rows are bitwise + identical for every query batch size and order, with or without deterministic + algorithms. Entities with more than 256 incoming edges are summed in 64-edge + partial sums that are added in order. Dense products use 3xTF32 tensor-core + dots, which keep float32 accuracy, on GPUs with TF32 support, and IEEE FMA + dots otherwise. +- Prompt encodings and relation tables are computed for one relation at a time. + +`kgicl_query_batch_size` only trades memory for speed on the fused path: each +query holds about `420 * entities` bytes of state, and 16 queries per pass are +about 13% faster than 8 on FB15k-237. See [KGFM inference speed](kgfm_inference.md#kg-icl) +for timings against the official code. + +## Upstream defects corrected in DICE + +DICE implements the corrected behavior. `tests/fixtures/kgicl/upstream-fixes.patch` +applies exactly these fixes to the pinned official code; all parity checks below +compare against the patched official code. Effects are measured below. + +| ID | Location | Defect | Correction | +|---|---|---|---| +| B1 | `EntityEncoder.py` | The reasoner's attention activation is a fresh `nn.RReLU()` per call. A new module is in training mode, so evaluation samples random negative slopes: predictions change between runs and exact ties are broken at random. | Use the model's mode: random slopes in training, the mean slope `(1/8 + 1/3) / 2` in evaluation, as RReLU defines. | +| B2 | `data_loader.py` | Evaluation shot `i` of the batch-wide relation list selects case `i mod n_cases`. For a relation with 2 to 4 cases, the selected cases depend on the relation's rank among the batch's relations, so prompts depend on the (shuffled) query batch. | Shot `j` of a relation selects case `j mod n_cases`. | +| B3 | `utils_all.py` | Distance labels are aligned with the node list but are paired with nodes in Python set order, and the loader reads label rows as local node IDs. Most prompt entities receive another entity's distance tokens. The pretraining data was processed with the same code. | Pair each entity with its own label; write rows in local-ID order. | +| B4 | `utils_all.py` | A self-loop pair `(a, a)` is looked up in both directions, so every self-loop fact appears twice in the prompt graph (doubling its degree). | Each fact appears once. | +| B5 | `data_loader.py` | For a self-loop example `(u, q, u)` the tail token goes to local node 1, an unrelated entity. | Head and tail tokens go to the example entity (the tail token overwrites the head token, matching the token assignment order). | + +No defect leaks test facts: prompt graphs come from training facts, and the +reasoning graph of test queries holds training and validation facts. + +### Measured effects + +Filtered MRR of the official code under the official protocol, relative to the +code with all five fixes, on the five verification datasets below. Each row +restores one defect: B1, B2 and B5 in the code, B3 and B4 in the prompt +processing. Rows with random or order-dependent results give the mean and +standard deviation over three query orders. + +| | WN V1 | FB V2 | NELL V2 | NL-0 | FB-25 | +|---|---:|---:|---:|---:|---:| +| MRR with all fixes | 0.7346 | 0.5635 | 0.6391 | 0.5655 | 0.4213 | +| Range over three query orders | 0.7345–0.7346 | 0.5634–0.5635 | 0.6390–0.6391 | 0.5654–0.5674 | 0.4213–0.4213 | +| B1 | −0.0008 ± 0.0006 | −0.0006 ± 0.0009 | −0.0031 ± 0.0022 | −0.0049 ± 0.0041 | +0.0001 ± 0.0002 | +| B1, pessimistic ties | −0.0008 ± 0.0006 | +0.0004 ± 0.0009 | −0.0001 ± 0.0022 | +0.0006 ± 0.0041 | +0.0002 ± 0.0002 | +| B2 | +0.0010 ± 0.0000 | +0.0003 ± 0.0003 | 0.0000 ± 0.0000 | −0.0002 ± 0.0000 | +0.0001 ± 0.0000 | +| B3 | −0.0014 | +0.0021 | −0.0029 | −0.0100 | +0.0052 | +| B4 | not present | not present | not present | −0.0010 | −0.0087 | +| B5 | not present | not present | not present | 0.0000 | +0.0012 | +| All five (released code) | +0.0027 ± 0.0011 | +0.0023 ± 0.0005 | −0.0039 ± 0.0021 | −0.0051 ± 0.0029 | −0.0022 ± 0.0002 | + +How many prompts each processing or loading defect touches, among the five +examples per relation that evaluation loads: + +| | WN V1 | FB V2 | NELL V2 | NL-0 | FB-25 | +|---|---:|---:|---:|---:|---:| +| Relations with 2 to 4 examples (B2) | 2 of 8 | 32 of 172 | 9 of 79 | 21 of 112 | 23 of 216 | +| Prompt entities with another entity's tokens (B3) | 237 of 396 | 25,236 of 43,692 | 14,745 of 27,634 | 17,090 of 33,480 | 52,901 of 98,725 | +| Prompt graphs with duplicated self-loop facts (B4) | 0 of 36 | 0 of 710 | 0 of 353 | 95 of 470 | 949 of 979 | +| Self-loop examples (B5) | 0 | 0 | 0 | 3 | 21 | + +- **B1** makes evaluation nondeterministic: the standard deviation of MRR over + three runs reaches 0.004 (NL-0). Its random slopes also break exact score ties + at random; under the official ranking, which orders ties by entity ID, this + lowers MRR on NL-0 and NELL V2, while pessimistic MRR changes by less than 0.001. +- **B2** changes MRR by at most 0.0010 here, but makes a query's prediction + depend on which relations share its batch. +- **B3** is the largest defect. The checkpoints were pretrained with the same + processing code (`datasets/utils_all.py` contains both B3 and B4), so the + correction changes prompts relative to training, and its effect varies in sign: + from −0.0100 to +0.0052 MRR. +- **B4** lowers MRR on graphs with self-loop facts in prompts (−0.0087 on FB-25, + where almost every prompt graph has them). +- **B5** affects only self-loop examples (+0.0012 on FB-25). + +Official-code differences of about 1e-4 are within the run-to-run noise of the +official CUDA scatter kernels (range row). DICE always implements the +corrected behavior; to evaluate the released behavior, run the official code. + +## Upstream behavior DICE keeps + +These choices are consistent between the official training and evaluation, and +the checkpoints depend on them; DICE matches them: + +- The prompt encoder multiplies entity messages by the symmetric degree + normalization twice, and the reasoner applies each relation layer norm twice. +- Unused parameters (`layer_norms_query`, `query_transfer`, `W_score` and the + NBFNet `conv` layers present when the checkpoints were trained) are retained + for strict loading; the official evaluation drops them with `strict=False`. +- Prompt graphs follow the released processing (`enclosing=False`: up to 50 + further entities), not the paper's `dist(x,u) + dist(x,v) <= k` alone. +- The reasoner sums messages (the paper writes mean pooling) and updates + entities with a GRU; unreached entities score zero. +- Labels of inverse-query prompts keep the direct example's `(u, v)` order; only + the head and tail tokens are swapped. +- The official sigmoid attention (`attn_type='Sigmoid'`); the GAT option, which + indexes its normalizer by a node ID where an edge ID is meant, is unused. + +## Verification + +Fixtures are generated by `tests/fixtures/kgicl/generate_reference.py` with the +pinned official code plus the patch. It verifies the revision and that tracked +files are unmodified, processes a fixture graph with the official prompt +extraction (hubs, cycles, parallel facts, self-loop facts and examples, +relations with one to five facts, a relation without facts, an isolated entity), +loads it with the official data loader and records official outputs on CPU. +`tiny` uses a small random model (dimension 8, three reasoner layers), `official` +the released `KG-ICL-6L` weights. DICE replays the recorded prompt graphs: + +| Check (float32, CPU) | `tiny` | `official` | +|---|---|---| +| Prompt extraction of every relation's examples | identical entities, facts and tokens | (same graph) | +| Prompt encodings, maximum absolute error | 9.5e-7 | 1.2e-6 | +| All-entity scores of 16 queries, with and without the distance mask | 1.8e-7 | 5.3e-6 (scores up to 15.8) | +| Gradients of every parameter (110 and 184 tensors), evaluation mode | within 3% of `atol = rtol = 1e-4` | within 82% of `atol = rtol = 1e-4` (gradients up to 454) | +| Answer-distance rates | identical | identical | + +The tests use `atol = 2e-5, rtol = 1e-4` for prompts and scores. Prompt sampling +is checked separately: seeded, independent of relation and call order, and +identical after reattaching the graph or reloading an experiment. + +On real graphs, the official evaluation of five of the paper's zero-shot datasets +ran with the patched official code (separate environment: PyTorch 2.7.1, +torch-scatter 2.1.2) and with DICE replaying the prompt graphs the patched official +loader assembles, both on CUDA in float32 with TF32 disabled. DICE used the fused +Triton path. Metrics use the official ranking (ties by entity ID) unless noted: + +| Dataset | Queries × entities | Max. abs. score error | MRR official / DICE | Hits@10 official / DICE | Pessimistic MRR official / DICE | Answers ranked differently | Paper MRR / Hits@10 | +|---|---|---:|---:|---:|---:|---:|---:| +| WN V1 | 352 × 922 | 5.2e-5 | 0.73456 / 0.73455 | 0.8165 / 0.8165 | 0.73350 / 0.73349 | 2 of 376 | 0.733 / 0.838 | +| FB V2 | 791 × 1660 | 6.8e-5 | 0.56350 / 0.56342 | 0.7542 / 0.7542 | 0.56247 / 0.56217 | 5 of 956 | 0.565 / 0.749 | +| NELL V2 | 686 × 2086 | 7.7e-5 | 0.63907 / 0.63907 | 0.8330 / 0.8330 | 0.63605 / 0.63605 | 2 of 952 | 0.644 / 0.835 | +| NL-0 | 1037 × 2026 | 7.2e-5 | 0.56551 / 0.56549 | 0.7870 / 0.7870 | 0.55995 / 0.55990 | 2 of 1526 | 0.557 / 0.777 | +| FB-25 | 6656 × 4097 | 1.1e-4 | 0.42134 / 0.42134 | 0.6873 / 0.6873 | 0.42128 / 0.42123 | 22 of 11432 | 0.396 / 0.656 | + +All scores agree within `atol = rtol = 2e-4`. The differing ranks are near-ties +(score gaps around `1e-5`) that are exact ties in one implementation only. The +official code is not bitwise reproducible across query orders either (CUDA +scatter atomics): its MRR varied by up to 9e-5 (2e-3 on NL-0, which has many +exact ties) over three query orders, a range that contains DICE's values. The +released official code (all five defects) averaged 0.7372, 0.5658, 0.6351, +0.5604 and 0.4191 MRR over three runs, also close to the paper. FB-25 is about +0.025 above the paper with both implementations and the released code. + +```bash +# Offline fixtures and DICE integration; no upstream packages required. +python -m pytest tests/test_kgicl.py -q + +# Include the official KG-ICL-6L checkpoint, verified by SHA-256. +KGICL_CHECKPOINT_DIR=checkpoints/kgicl/KG-ICL-6L python -m pytest tests/test_kgicl.py -q +``` + +To regenerate the fixtures, create an isolated environment with PyTorch, a +matching torch-scatter build, NumPy, SciPy and NetworkX (the fixtures used +torch 2.7.1 and torch-scatter 2.1.2), check out the pinned commit, then run: + +```bash +CUDA_VISIBLE_DEVICES='' python tests/fixtures/kgicl/generate_reference.py \ + /path/to/KG-ICL tests/fixtures/kgicl --checkpoint-dir /path/to/KG-ICL/checkpoint/KG-ICL-6L +``` + +## Complex query answering + +`kgicl-adapter` evaluates KG-ICL as a frozen backbone in the query benchmarks +(`python -m benchmarks.cqa`), with the adapter, beam search and controls of the +ULTRA and TRIX recipes. Prompt graphs come from each benchmark's inference +graph with prompt seed 0 (a recipe may set `prompt_seed`); no distance mask is +applied. Score adapters bind to the backbone through the checkpoint's state +fingerprint, and cached training rows record the prompt settings. The +evaluator caches atomic rows across beams and controls; KG-ICL rows are +bitwise identical whatever the batching or call order, which the tests check +under deterministic algorithms on CPU and CUDA. + +The provisional recipes `benchmarks/plus_h/kgfm_kgicl.json` and +`benchmarks/ultraquery/kgfm_kgicl.json` are **not finalized**: their adapter +`benchmarks/adapters/kgicl_product_intersections.json` still has to be fitted +with the shared source recipe and pinned. They cache the per-layer relation +tables of every query relation (`projection_cache_mb` 512, about 260 MiB on +FB15k237); the default 64 MiB recomputes them on graphs with hundreds of +relations, about 2.5 times slower. Outside the benchmark's Docker image, set +`CUBLAS_WORKSPACE_CONFIG=:4096:8`: the evaluator enables deterministic +algorithms, and the prompt encoder uses cuBLAS. + +## License + +The official KG-ICL code and checkpoints are distributed under GPL-3.0 by their +authors; download the checkpoints from the official repository. DICE's +implementation is an independent reimplementation that loads the released state +dictionaries. The bug-fix patch modifies GPL-3.0 code and is distributed under +GPL-3.0. From 987429b571b9290481d23c119ea43e1fdc8a15fc Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Tue, 6 Oct 2026 07:18:54 +0200 Subject: [PATCH 28/39] test: exclude KG-ICL from the NegSampleMargin model sweep KG-ICL supports the same scoring techniques as the other graph-based foundation models (static_preprocess_funcs.py rejects NegSampleMargin for it), so the sweep excludes it like ULTRA, TRIX and Flock. --- tests/test_neg_sample_margin_model_coverage.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/test_neg_sample_margin_model_coverage.py b/tests/test_neg_sample_margin_model_coverage.py index c35c9e39e..9e1fcd88d 100644 --- a/tests/test_neg_sample_margin_model_coverage.py +++ b/tests/test_neg_sample_margin_model_coverage.py @@ -8,7 +8,7 @@ matrix rather than gathering per-row scores, so NegSample-family techniques do not produce a correctly shaped batch for it. - Pyke is excluded per project convention (not covered by this sweep). -- ULTRA, TRIX, TRIXRelation, Flock, and FlockRelation only support the +- ULTRA, TRIX, TRIXRelation, Flock, FlockRelation, and KGICL only support the scoring techniques validated in static_preprocess_funcs.py (KvsAll and, for the entity-prediction variants, NegSample/FixedNegSample/1vsAll/1vsSample/ KvsSample). Their forward_triples loops over unique (head, relation) @@ -22,7 +22,7 @@ from dicee.executer import Execute from dicee.static_funcs import MODEL_REGISTRY -EXCLUDED_MODELS = {"Shallom", "Pyke", "ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation"} +EXCLUDED_MODELS = {"Shallom", "Pyke", "ULTRA", "TRIX", "TRIXRelation", "Flock", "FlockRelation", "KGICL"} NATIVE_MODELS = sorted(set(MODEL_REGISTRY) - EXCLUDED_MODELS - {"BytE"}) From 5bf2e13f624931c225793b0f3d5f657f4c4a5cb8 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Wed, 7 Oct 2026 17:23:01 +0200 Subject: [PATCH 29/39] feat(benchmarks): pin the KG-ICL adapter The KG-ICL product adapter is fitted with the shared ULTRA/TRIX source recipe (training seed 2026090851); the file holds the bytes the frozen test studies pinned. Both kgfm_kgicl.json recipes are now final, with the reference entry and its identity control; the docs, the CQA README and the changelog no longer call them provisional. --- CHANGELOG.md | 2 +- .../adapters/kgicl_product_intersections.json | 123 ++++++++++++++++++ benchmarks/cqa/README.md | 4 +- benchmarks/plus_h/kgfm_kgicl.json | 11 +- benchmarks/ultraquery/kgfm_kgicl.json | 11 +- docs/kgicl.md | 10 +- 6 files changed, 140 insertions(+), 21 deletions(-) create mode 100644 benchmarks/adapters/kgicl_product_intersections.json diff --git a/CHANGELOG.md b/CHANGELOG.md index 91f3c2810..baac68d6c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,7 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Sharded checkpoint save/resume for the `torchFSDP` trainer - Adaptive Momentum Weight Averaging and soft-label support - `--log_level` CLI flag; TriX model -- KG-ICL (`KGICL`): official checkpoints in pure PyTorch with seeded, batch-independent prompt graphs, deterministic fused Triton inference, parity fixtures against the pinned official code with five upstream defects corrected, zero-shot benchmarks, and provisional (not finalized) +H and UltraQuery adapter recipes +- KG-ICL (`KGICL`): official checkpoints in pure PyTorch with seeded, batch-independent prompt graphs, deterministic fused Triton inference, parity fixtures against the pinned official code with five upstream defects corrected, zero-shot benchmarks, and pinned +H and UltraQuery adapter recipes - Complex query answering (`dicee.query_answering`): CQD beam search over KGEs and KGFMs with learned score adapters, negated query types, native UltraQuery, GNN-QE, QTO, CQD, CQD-Hybrid, ConE and CLMPT checked against their upstream implementations, and resumable filtered evaluation with exact expected ranks under ties - Reproducible UltraQuery and +H benchmarks (`python -m benchmarks.cqa`): frozen studies verified against the pinned upstream implementations, a pinned Docker runtime, paired adapter, answer-filter and inference-graph ablations diff --git a/benchmarks/adapters/kgicl_product_intersections.json b/benchmarks/adapters/kgicl_product_intersections.json new file mode 100644 index 000000000..3aafdc8fa --- /dev/null +++ b/benchmarks/adapters/kgicl_product_intersections.json @@ -0,0 +1,123 @@ +{ + "backbone_state_sha256": "8816c1555269384a6cd81a4b7650c9bd6e2394cec4cab5e7f75bd9909dcc9020", + "training": { + "objective": "filtered_softmax_v1", + "epochs": 500, + "batch_size": 8, + "learning_rate": 0.02, + "identity_penalty": 0.001, + "gradient_clip": 1.0, + "seed": 2026090851, + "weighting": "equal_source_shape", + "selection": "source_validation_mrr", + "shapes": [ + "2i", + "3i" + ], + "validation_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "validation_every": 5, + "training_sources": [ + "CoDExMedium", + "FB15k237", + "WN18RR" + ], + "train_per_shape": 140, + "early_stopping_patience": 100, + "beam_size": 64, + "tnorm": "prod", + "validation_shapes": [ + "1p", + "2p", + "3p", + "2i", + "3i", + "2in", + "3in", + "inp", + "pin", + "pni" + ], + "device": "cuda", + "validation_device": "cpu", + "cpu_threads": 4, + "training_cache_bytes": 6442450944, + "device_cache_bytes": 536870912, + "selected_epoch": 45, + "selected_validation_mrr": 0.18387722985219088, + "epochs_completed": 145, + "stopped_early": true, + "stop_reason": "validation_patience", + "training_queries": 840, + "optimizer_steps": 15225, + "row_cache": { + "FB15k237": { + "host_hits": 189328, + "device_hits": 92583, + "disk_rows": 0, + "scored_rows": 6581, + "feature_preparations": 6581, + "seconds": 3425.798498520162 + }, + "WN18RR": { + "host_hits": 185804, + "device_hits": 96153, + "disk_rows": 0, + "scored_rows": 6535, + "feature_preparations": 6535, + "seconds": 1409.8266095069703 + }, + "CoDExMedium": { + "host_hits": 186698, + "device_hits": 96815, + "disk_rows": 0, + "scored_rows": 4979, + "feature_preparations": 4979, + "seconds": 1814.797347703483 + } + } + }, + "score_banks": [ + "65bd769dade4744a953d7742ae96dee03c29d30075f9951792c8ac5b9df9bd3b", + "0fd86492f49259b3ab273d1885e0413b44389ae9507e7e32aaa96cb1a16b6c7e", + "279d5eff7128ad31d2fb5110f2d7d9d35a3b8959b7c14438322caae476a6c3ac" + ], + "sources": { + "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", + "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", + "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" + }, + "version": 3, + "feature_mode": "context_scores", + "observed_mix": 1.0, + "bias_bound": 8.0, + "scale_bound": 2.0, + "normalization": "none", + "hidden_dim": 0, + "weights": [ + [ + -2.32368504798207, + 2.0049527287265114, + 1.4638496934559073, + -0.9412350507752393, + -0.260616153643281, + -1.8338308666061056, + -1.3255903255988397, + -0.6410547923533959 + ], + [ + -2.378670486469166, + -0.6121190155466186, + -0.773915400608249, + -1.6690557466596192, + -0.976340557301146, + -1.761396502127226, + -0.8284843834185431, + -1.0345695110208457 + ] + ], + "hidden_weights": null +} diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index 4d7ba19af..99bdf0590 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -82,11 +82,11 @@ execution options. Each suite directory holds its public recipes: |---|---| | `plus_h/baselines.json` | The seven published methods on the three +H datasets (21 entries) | | `plus_h/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters (6 entries, each with an identity control) | -| `plus_h/kgfm_kgicl.json` | **Not finalized.** KG-ICL with a product adapter (3 entries, each with an identity control); the adapter is not fitted yet | +| `plus_h/kgfm_kgicl.json` | KG-ICL with the product adapter (3 entries, each with an identity control) | | `plus_h/published_results.json` | Scores reported by the +H authors, for `report` | | `ultraquery/baselines.json` | Native UltraQuery on all 23 datasets | | `ultraquery/kgfm_adapters.json` | ULTRA and TRIX with `2i`/`3i`-trained adapters on all 23 datasets | -| `ultraquery/kgfm_kgicl.json` | **Not finalized.** KG-ICL with a product adapter on all 23 datasets; the adapter is not fitted yet | +| `ultraquery/kgfm_kgicl.json` | KG-ICL with the product adapter on all 23 datasets (each with an identity control) | | `ultraquery/comparisons.json` | ULTRA link-prediction weights, an incoming-relation heuristic and QTO | | `ultraquery/trained_baselines.json` | QTO on FB15k and inductive GNN-QE, after `train` | diff --git a/benchmarks/plus_h/kgfm_kgicl.json b/benchmarks/plus_h/kgfm_kgicl.json index 1c4d6a869..ce1dbf968 100644 --- a/benchmarks/plus_h/kgfm_kgicl.json +++ b/benchmarks/plus_h/kgfm_kgicl.json @@ -53,7 +53,7 @@ "4i": "product" }, "selection_protocol": "target-validation", - "finalized": false, + "finalized": true, "query_types": [ "1p", "2p", @@ -75,17 +75,14 @@ "query_batch_size": 16, "query_order": "relation", "reference": { - "status": "provisional KG-ICL recipe; adapter not fitted; not finalized", + "status": "KG-ICL adapter recipe, fitted and pinned; additional backbone", "notes": [ - "Provisional, not finalized: the KG-ICL product adapter is not fitted yet. Fit it with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection) and pin its bytes before any test run.", + "Adapter fitted with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection; training seed 2026090851) and pinned before any test run.", "Backbone: DICE KG-ICL with the official KG-ICL-6L weights (nju-websoft/KG-ICL 6a3166e3), verified against the pinned code plus tests/fixtures/kgicl/upstream-fixes.patch; see docs/kgicl.md.", "Prompt graphs: five examples per relation, sampled from the attached inference graph with prompt seed 0, identical for every query batch and call order; no answer-distance mask. CQD beam 64, product t-norm, paired identity control. The per-layer relation tables of every query relation are cached (projection_cache_mb 512, about 260 MiB for FB15k237); with the default 64 MiB they are recomputed on graphs with many relations, about 2.5 times slower." ] }, - "blockers": [ - "Fit and pin benchmarks/adapters/kgicl_product_intersections.json; it does not exist yet.", - "Run KG-ICL backbone checks on the benchmark graphs and the KGFM integration verification." - ], + "blockers": [], "adapter_ablation": true, "inference_graph": "train+valid" }, diff --git a/benchmarks/ultraquery/kgfm_kgicl.json b/benchmarks/ultraquery/kgfm_kgicl.json index 2a0b3b337..641f09b88 100644 --- a/benchmarks/ultraquery/kgfm_kgicl.json +++ b/benchmarks/ultraquery/kgfm_kgicl.json @@ -48,7 +48,7 @@ "pni": "product" }, "selection_protocol": "target-validation", - "finalized": false, + "finalized": true, "query_types": [ "1p", "2p", @@ -68,17 +68,14 @@ "query_batch_size": 16, "query_order": "relation", "reference": { - "status": "provisional KG-ICL recipe; adapter not fitted; not finalized", + "status": "KG-ICL adapter recipe, fitted and pinned; additional backbone", "notes": [ - "Provisional, not finalized: the KG-ICL product adapter is not fitted yet. Fit it with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection) and pin its bytes before any test run.", + "Adapter fitted with the shared ULTRA/TRIX recipe (linear score-aware adapter, observed facts, bias bound 8, scale bound 2, 2i/3i source queries of FB15k237, WN18RR and CoDExMedium, source-validation checkpoint selection; training seed 2026090851) and pinned before any test run.", "Backbone: DICE KG-ICL with the official KG-ICL-6L weights (nju-websoft/KG-ICL 6a3166e3), verified against the pinned code plus tests/fixtures/kgicl/upstream-fixes.patch; see docs/kgicl.md.", "Prompt graphs: five examples per relation, sampled from the attached inference graph with prompt seed 0, identical for every query batch and call order; no answer-distance mask. CQD beam 64, product t-norm, paired identity control. The per-layer relation tables of every query relation are cached (projection_cache_mb 512, about 260 MiB for FB15k237); with the default 64 MiB they are recomputed on graphs with many relations, about 2.5 times slower." ] }, - "blockers": [ - "Fit and pin benchmarks/adapters/kgicl_product_intersections.json; it does not exist yet.", - "Run KG-ICL backbone checks on the benchmark graphs and the KGFM integration verification." - ], + "blockers": [], "adapter_ablation": true }, "entries": [ diff --git a/docs/kgicl.md b/docs/kgicl.md index c449bd7c1..6bf5ac069 100644 --- a/docs/kgicl.md +++ b/docs/kgicl.md @@ -345,10 +345,12 @@ evaluator caches atomic rows across beams and controls; KG-ICL rows are bitwise identical whatever the batching or call order, which the tests check under deterministic algorithms on CPU and CUDA. -The provisional recipes `benchmarks/plus_h/kgfm_kgicl.json` and -`benchmarks/ultraquery/kgfm_kgicl.json` are **not finalized**: their adapter -`benchmarks/adapters/kgicl_product_intersections.json` still has to be fitted -with the shared source recipe and pinned. They cache the per-layer relation +The recipes `benchmarks/plus_h/kgfm_kgicl.json` and +`benchmarks/ultraquery/kgfm_kgicl.json` use the adapter +`benchmarks/adapters/kgicl_product_intersections.json`, fitted with the shared +source recipe of ULTRA and TRIX (training seed 2026090851) and paired with an +identity control. +They cache the per-layer relation tables of every query relation (`projection_cache_mb` 512, about 260 MiB on FB15k237); the default 64 MiB recomputes them on graphs with hundreds of relations, about 2.5 times slower. Outside the benchmark's Docker image, set From 1f421217cb7d498f1660d40e03fbc906a5f3df2b Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 9 Oct 2026 14:21:20 +0200 Subject: [PATCH 30/39] fix(deps): keep pyarrow below 26 with NumPy 1 and read polars triples as strings pyarrow 26 requires NumPy 2, which the NumPy 1.26.4 pin excludes before Python 3.13, so importing dicee failed on 3.11 and 3.12. polars 2.0 removed read_csv's dtypes argument, and its replacement needs one dtype per column of the file; infer_schema_length=0 reads every column as String, as the pandas reader does, on every polars version. --- dicee/read_preprocess_save_load_kg/util.py | 2 +- requirements.txt | 3 ++- setup.py | 4 +++- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/dicee/read_preprocess_save_load_kg/util.py b/dicee/read_preprocess_save_load_kg/util.py index 16f5b078a..470cb1fab 100644 --- a/dicee/read_preprocess_save_load_kg/util.py +++ b/dicee/read_preprocess_save_load_kg/util.py @@ -180,7 +180,7 @@ def read_with_polars(data_path, read_only_few: Optional[int] = None, sample_trip low_memory=False, n_rows=read_only_few, columns=[0, 1, 2], - dtypes=[polars.String], + infer_schema_length=0, # every column as String, like the pandas reader new_columns=['subject', 'relation', 'object'], separator=separator) diff --git a/requirements.txt b/requirements.txt index 5c985d4df..61ecb9720 100644 --- a/requirements.txt +++ b/requirements.txt @@ -9,7 +9,8 @@ pandas>=2.1.0 # Optional dependencies polars>=0.16.14 -pyarrow>=11.0.0 +pyarrow>=11.0.0,<26; python_version < '3.13' +pyarrow>=11.0.0; python_version >= '3.13' rdflib>=7.0.0 tiktoken>=0.5.1 pykeen>=1.10.2 diff --git a/setup.py b/setup.py index 4bef16b25..8cd80d4af 100644 --- a/setup.py +++ b/setup.py @@ -26,7 +26,9 @@ # Optional dependencies for various features _optional_deps = [ - "pyarrow>=11.0.0", + # pyarrow 26 requires NumPy 2, which the NumPy pin above excludes before Python 3.13. + "pyarrow>=11.0.0,<26; python_version < '3.13'", + "pyarrow>=11.0.0; python_version >= '3.13'", "rdflib>=7.0.0", "tiktoken>=0.5.1", "pykeen>=1.10.2", From 70dac49cd112bda75566a4757957a9ecc1ced7a6 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 9 Oct 2026 14:21:38 +0200 Subject: [PATCH 31/39] feat(query_answering): training-free calibrations, observed traversal and negation from known facts - QueryScoreAdapter.fixed_calibration: CQD-Hybrid's min-max and QTO's softmax times the observed degree, plus the plain softmax and a tie-free cap for analysis; optional masking of known-tail logits; recipes may break ties among known facts by the model. - UltraQuery executor: opt-in exact traversal of the observed facts at every projection and softmax-degree projections in place of the sigmoid. - ULTRA relation_conditioning='query' conditions relation reasoning on the queried relation, so UltraQuery's weights run as a frozen ULTRA backbone. - Engine option negation='observed': a negated branch removes its exact known answers. - Recipe checks for the new options and Flock's walk_num and test_samples. --- dicee/models/graph_model.py | 11 +- dicee/models/ultra.py | 5 + dicee/query_answering/_query.py | 15 ++- dicee/query_answering/catalog.py | 14 ++- dicee/query_answering/engine.py | 18 ++- dicee/query_answering/method_evaluation.py | 31 ++++- dicee/query_answering/methods/_common.py | 54 +++++++- dicee/query_answering/methods/ultraquery.py | 12 +- dicee/query_answering/score_adapter.py | 78 ++++++++++-- docs/ultra.md | 7 ++ tests/test_query_baselines.py | 130 ++++++++++++++++++++ tests/test_query_engine.py | 89 ++++++++++++++ 12 files changed, 435 insertions(+), 29 deletions(-) diff --git a/dicee/models/graph_model.py b/dicee/models/graph_model.py index 56956e7ed..dac05051d 100644 --- a/dicee/models/graph_model.py +++ b/dicee/models/graph_model.py @@ -61,6 +61,9 @@ def __init__(self, args): for name in ('graph_triples', 'relation_id_map', 'edge_index', 'edge_type'): self.register_buffer(name, None, persistent=False) self.num_direct_relations = 0 + # Which relation conditions relation reasoning for a tail query (h, r, ?): 'direct', as upstream link + # prediction does (an inverse query uses its direct relation), or 'query', the queried relation itself. + self.relation_conditioning = 'direct' def clear_inference_cache(self): """Drop derived representations when graph, weights or device change.""" @@ -79,7 +82,7 @@ def inference_token(self): tensors = list(self.parameters()) + list(self.buffers()) if any(t.is_inference() for t in tensors): return None - return (getattr(self, '_inference_backend', 'auto'), torch.is_autocast_enabled(self.device.type), + return (getattr(self, '_inference_backend', 'auto'), self.relation_conditioning, torch.is_autocast_enabled(self.device.type), torch.are_deterministic_algorithms_enabled(), float32_precision_token(), tuple(getattr(m, 'inference_compile', False) for m in self.modules() if hasattr(m, 'inference_backend')), @@ -257,8 +260,10 @@ def forward_k_vs_sample(self, x, target_entity_idx): # Host queries were validated without a device read; keep their relation # IDs on the host so inference caches need no device-to-host copy. host_ids = None + direct = self.relation_conditioning == 'direct' if x.device.type == 'cpu' and self.device.type != 'cpu': - host_ids = (self._host_relation_map()[x[:, 1]] % self.num_direct_relations).tolist() + mapped = self._host_relation_map()[x[:, 1]] + host_ids = (mapped % self.num_direct_relations if direct else mapped).tolist() x = to_device(x, self.device) queries = torch.stack((x[:, 0], self.relation_id_map[x[:, 1]]), dim=1) candidates = target_entity_idx.to(dtype=torch.long) @@ -272,7 +277,7 @@ def forward_k_vs_sample(self, x, target_entity_idx): candidates = candidates.to(device=self.device) if all_entities: candidates._dicee_all_entities = True - query_relations = queries[:, 1] % self.num_direct_relations + query_relations = queries[:, 1] % self.num_direct_relations if direct else queries[:, 1] if host_ids is not None: query_relations._dicee_ids = host_ids return self._score(queries[:, 0], queries[:, 1], candidates, query_relations, self._training_edges(queries=queries)) diff --git a/dicee/models/ultra.py b/dicee/models/ultra.py index 922e06376..5cdb0189a 100644 --- a/dicee/models/ultra.py +++ b/dicee/models/ultra.py @@ -170,6 +170,11 @@ def __init__(self, args): self.set_inference_backend(args.get('graph_inference_backend', 'auto')) for layer in (*self.relation_model.layers, *self.entity_model.layers): layer.inference_compile = args.get('graph_inference_compile', False) + # 'query' conditions an inverse tail query on the inverse relation, as UltraQuery's projection does, for weights + # trained that way; the default 'direct' is ULTRA link prediction. + self.relation_conditioning = args.get('ultra_relation_conditioning', 'direct') + if self.relation_conditioning not in ('direct', 'query'): + raise ValueError('ultra_relation_conditioning must be direct or query') def clear_inference_cache(self): self._relation_cache = OrderedDict() diff --git a/dicee/query_answering/_query.py b/dicee/query_answering/_query.py index c5344b72c..79c36ba27 100644 --- a/dicee/query_answering/_query.py +++ b/dicee/query_answering/_query.py @@ -182,8 +182,13 @@ def negate(value, norm='standard', parameter=0., *, logits=False): def execute_query(tree, row_batches, *, n, device, row_batch_size, beam_size=64, - tnorm="prod", neg_norm="standard", lambda_=0., use_logits=False, executor="cqd", stats=None, skip_zero_prefix=False): - """Compose rows with live beam selection; gradients flow through retained scores.""" + tnorm="prod", neg_norm="standard", lambda_=0., use_logits=False, executor="cqd", stats=None, skip_zero_prefix=False, + negation_answers=None): + """Compose rows with live beam selection; gradients flow through retained scores. + + With ``negation_answers`` (a callable from a subtree to its exact answers over the known facts), a negated branch + excludes exactly those answers and nothing else: membership zero on them, one elsewhere. + """ if stats is None: stats = dict(negated_pruning=False, bound_skipped=0) def execute(node): @@ -197,6 +202,12 @@ def execute(node): if op in ('and', 'or'): branches = [execute(child) for child in node[1:]] return combine([v for v, _ in branches], op, tnorm, logits=use_logits), any(p for _, p in branches) + if op == 'not' and negation_answers is not None: + result = torch.zeros((n,), dtype=torch.float64, device=device) + answers = sorted(negation_answers(node[1])) + if answers: + result[torch.tensor(answers, device=device)] = -torch.inf + return result, False if op == 'not': values, pruned = execute(node[1]) stats['negated_pruning'] |= pruned diff --git a/dicee/query_answering/catalog.py b/dicee/query_answering/catalog.py index d7d1bcdd3..fff0a5f18 100644 --- a/dicee/query_answering/catalog.py +++ b/dicee/query_answering/catalog.py @@ -36,6 +36,7 @@ ULTRA = ('DeepGraphLearning/ULTRA', '427966ad8ed60420eef034063d44f3153addff90') TRIX = ('yuchengz99/TRIX', '7596e14eefefe89e61396205a0550172cadeddb0') KG_ICL = ('nju-websoft/KG-ICL', '6a3166e347ae468acdfb30a70a2cf3608b66b8f1') +FLOCK = ('jw9730/flock', 'f35103d25a78bdf4075de5c673a51de4979aa4d7') INDUCTIVE_QE = ('DeepGraphLearning/InductiveQE', 'ab49a0e64e3449e687e484a42269d9898e1d1325') IS_CQA = ('april-tools/is-cqa-complex', 'd1ce74164936a7c09d9147e83190da047cb39429') REFERENCES = { @@ -50,9 +51,9 @@ 'cone': ('MIRALab-USTC/QE-ConE', 'cc45b90e3cdce0f609670a257e6f756d28495a93'), 'clmpt': ('qianlima-lab/CLMPT', '6c4f3b8a5e052e8bc1c0c93eaed18ef869a1bcd7'), } -KGFM_ADAPTERS = ('ultra-adapter', 'trix-adapter', 'kgicl-adapter') +KGFM_ADAPTERS = ('ultra-adapter', 'trix-adapter', 'kgicl-adapter', 'flock-adapter') # The upstream backbone each adapter method reproduces (KG-ICL with docs/kgicl.md's bug fixes). -KGFM_BACKBONES = {'ultra-adapter': ULTRA, 'trix-adapter': TRIX, 'kgicl-adapter': KG_ICL} +KGFM_BACKBONES = {'ultra-adapter': ULTRA, 'trix-adapter': TRIX, 'kgicl-adapter': KG_ICL, 'flock-adapter': FLOCK} METHODS = (*REFERENCES, *KGFM_ADAPTERS) # Methods whose checkpoints score queries without the inference graph. GRAPH_INDEPENDENT_METHODS = ('cone', 'clmpt', 'cqd') @@ -137,9 +138,18 @@ def check_recipe(entry: dict, shapes: list[str] | tuple[str, ...]) -> None: return if options.get('observed_facts', 'none') not in ('none', 'atomic', 'both'): raise ValueError('Observed facts must be none, atomic, or both') + if options.get('observed_ties', 'entity') not in ('entity', 'model'): + raise ValueError('Observed ties must be entity or model') + if options.get('negation', 'model') not in ('model', 'observed'): + raise ValueError('Negation must be model or observed') if 'prompt_seed' in options and (method != 'kgicl-adapter' or type(options['prompt_seed']) is not int or not 0 <= options['prompt_seed'] < 2**63): raise ValueError('Only KG-ICL recipes take prompt_seed, a nonnegative integer below 2**63') + if 'relation_conditioning' in options and (method != 'ultra-adapter' or options['relation_conditioning'] not in ('direct', 'query')): + raise ValueError('Only ULTRA recipes take relation_conditioning, direct or query') + if any(name in options and (method != 'flock-adapter' or type(options[name]) is not int or options[name] < 1) + for name in ('test_samples', 'walk_num')): + raise ValueError('Only Flock recipes take test_samples and walk_num, positive integers') if type(entry.get('adapter_ablation', False)) is not bool: raise ValueError('Adapter ablation must be a boolean') if entry.get('selection_protocol') not in ('source-validation', 'target-validation'): diff --git a/dicee/query_answering/engine.py b/dicee/query_answering/engine.py index 810efcaea..86cf56cc0 100644 --- a/dicee/query_answering/engine.py +++ b/dicee/query_answering/engine.py @@ -333,8 +333,7 @@ def _condition_batches(self, conditions, use_logits, stats): transformed = raw else: context = self.scorer.context - needs_context = self.adapter.feature_mode != 'global' or self.adapter.observed_mix - obs, base = context.features(missing, device=raw.device) if context and needs_context else (None, None) + obs, base = context.features(missing, device=raw.device) if context and self.adapter.needs_context else (None, None) transformed = self.adapter(raw, obs, base) for key, value in zip(missing, transformed): # Copies keep evicted batches from being retained by one row. @@ -389,10 +388,18 @@ def _checked(self): @torch.no_grad() def predict(self, query, *, beam_size=64, tnorm='prod', neg_norm='standard', lambda_=0., - use_logits=False, return_log_scores=False, executor='cqd'): - """QTO evaluates every potentially improving head without a beam limit.""" + use_logits=False, return_log_scores=False, executor='cqd', negation='model'): + """QTO evaluates every potentially improving head without a beam limit. + + ``negation='observed'`` negates from the known facts alone: a negated branch removes its exact answers over the + context graph and keeps every other entity at membership one (a control; ``'model'`` is the default). + """ if executor not in ('cqd', 'qto'): raise ValueError('Choose cqd or qto executor') + if negation not in ('model', 'observed'): + raise ValueError('Negation must be model or observed') + if negation == 'observed' and (use_logits or self.scorer.context is None): + raise ValueError('Negation from known facts needs memberships and a context graph') if executor == 'qto' and use_logits: raise ValueError('QTO requires bounded memberships, not raw logits') if type(beam_size) is not int or beam_size < 1: @@ -407,7 +414,7 @@ def predict(self, query, *, beam_size=64, tnorm='prod', neg_norm='standard', lam self.adapter.verify_model(self.scorer.model) n, nr = self.scorer.n, self.scorer.nr context = self.scorer.context - if context is None and (self.adapter.feature_mode != 'global' or self.adapter.observed_mix): + if context is None and self.adapter.needs_context: raise ValueError('Adapter features and observed overrides require a context graph') tree = compile_query(query) validate_tree(tree, n, nr) @@ -422,6 +429,7 @@ def predict(self, query, *, beam_size=64, tnorm='prod', neg_norm='standard', lam tree, lambda heads, relation: self._row_batches(heads, relation, use_logits, stats), n=n, device=self.scorer.device, row_batch_size=self.scorer.row_batch_size, beam_size=beam_size, tnorm=tnorm, neg_norm=neg_norm, lambda_=lambda_, + negation_answers=context.answers if negation == 'observed' else None, use_logits=use_logits, executor=executor, stats=stats, skip_zero_prefix=skip_zero_prefix) if self.restore_observed and not use_logits and self.adapter.observed_mix == 1 and positive(tree): result = result.clone() diff --git a/dicee/query_answering/method_evaluation.py b/dicee/query_answering/method_evaluation.py index 5a83613b9..91758d65b 100644 --- a/dicee/query_answering/method_evaluation.py +++ b/dicee/query_answering/method_evaluation.py @@ -261,12 +261,17 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict on_control_prediction=None, *, limit=None, seed=0, query_order='relation', rank_trace_path=None, filter_corrections=None): from ..models import KGICL, TRIX, ULTRA + from ..models.flock import Flock backbone = entry['method'].split('-')[0] options = entry['options'] - allowed = {'beam_size', 'row_batch_size', 'backend_batch_size', 'cache_bytes', 'raw_cache_bytes', 'observed_facts', - 'raw_cache_device', 'raw_cache_granularity', 'relation_cache_mb', 'projection_cache_mb'} + allowed = {'beam_size', 'row_batch_size', 'backend_batch_size', 'cache_bytes', 'raw_cache_bytes', 'observed_facts', 'observed_ties', + 'raw_cache_device', 'raw_cache_granularity', 'relation_cache_mb', 'projection_cache_mb', 'negation'} if backbone == 'kgicl': allowed |= {'prompt_seed'} + if backbone == 'ultra': + allowed |= {'relation_conditioning'} + if backbone == 'flock': + allowed |= {'test_samples', 'walk_num'} if options.keys() - allowed: raise ValueError('Unknown KGFM execution option') if options.get('raw_cache_device', 'cpu') not in ('cpu', 'model'): @@ -277,7 +282,12 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict # KG-ICL samples prompt graphs from the attached context with a fixed seed (default 0); # options without a default here keep each backbone's construction unchanged. extra = {'kgicl_prompt_seed': options['prompt_seed']} if 'prompt_seed' in options else {} - model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL}[backbone](dict( + if 'relation_conditioning' in options: + extra['ultra_relation_conditioning'] = options['relation_conditioning'] + if backbone == 'flock': + # Flock samples walks; each atom row has its own seed (AtomicScorer), so scores do not depend on batching. + extra.update(flock_test_samples=options.get('test_samples', 1), flock_walk_num=options.get('walk_num', 128)) + model = {'ultra': ULTRA, 'trix': TRIX, 'kgicl': KGICL, 'flock': Flock}[backbone](dict( num_entities=1, num_relations=1, graph_inference_backend='auto', graph_relation_cache_mb=options.get('relation_cache_mb', 64), graph_projection_cache_mb=options.get('projection_cache_mb', 64), @@ -293,6 +303,16 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict for adapter in adapters.values(): adapter.observed_mix = float(observed_facts != 'none') restore_observed = observed_facts in (None, 'both') + # Ties among known facts in a beam: lowest entity IDs (the default) or the backbone's order. + ties = options.get('observed_ties', 'entity') + if ties not in ('entity', 'model'): + raise ValueError('Observed ties must be entity or model') + for adapter in adapters.values(): + adapter.observed_tie_break = ties == 'model' + # Negated branches: 1 - membership (the default) or the known facts alone (a control). + negation = options.get('negation', 'model') + if negation not in ('model', 'observed'): + raise ValueError('Negation must be model or observed') shape_by_query = {query.query: query.shape for query in data.queries} stats = Counter() paired = entry.get('adapter_ablation', False) @@ -307,6 +327,8 @@ def _evaluate_kgfm(entry, data, plan, ends, output, device, identity, on_predict if paired: recipes['without-adapter'] = {name: QueryScoreAdapter('global', adapter.observed_mix, normalization=adapter.normalization, metadata={'calibration': 'identity'}) for name, adapter in adapters.items()} + for control in recipes['without-adapter'].values(): + control.observed_tie_break = ties == 'model' engines = {variant: {name: QueryAnswerer(model, context=data.context, adapter=adapter, restore_observed=restore_observed, row_batch_size=options.get('row_batch_size', 1), @@ -341,7 +363,8 @@ def predict(query, variant='learned'): operator = entry['operators'][shape_by_query[query]] engine = engines[variant][operator] result = engine.predict(query, beam_size=options.get('beam_size', 64), - tnorm='prod' if operator.partition(':')[0] == 'product' else 'min', return_log_scores=True) + tnorm='prod' if operator.partition(':')[0] == 'product' else 'min', return_log_scores=True, + negation=negation) record(engine.last_info) callback = on_prediction if variant == 'learned' else on_control_prediction if callback: diff --git a/dicee/query_answering/methods/_common.py b/dicee/query_answering/methods/_common.py index 7e90a19ca..e1ae001a6 100644 --- a/dicee/query_answering/methods/_common.py +++ b/dicee/query_answering/methods/_common.py @@ -10,6 +10,7 @@ from ...models._inference import float32_precision_token from .._query import compile_query, validate_tree from ..context import evaluation_mode, state_token +from ..score_adapter import SOFTMAX_DEGREE_CEILING class QueryMethod(nn.Module): @@ -106,10 +107,29 @@ def fuzzy_combine(values, op, logic): class FuzzyGNN(QueryMethod): - def __init__(self, context, logic='product'): + """Fuzzy-set execution with a learned projection. + + ``observed_traversal`` (off by default, and not part of any upstream method) also traverses the observed facts + exactly at every projection: a tail receives at least the highest membership of a head linked to it by the + projected relation, as with symbolic traversal (max over heads of a product with one). + + ``calibration='softmax-degree'`` (off by default, not part of any upstream method) replaces the sigmoid of every + projection by QTO's calibration, generalized to fuzzy head sets: the softmax of the projection logits over all + entities times d, the membership mass of the observed tails that the traversal reaches (at least one), capped at + 0.9999. For a single anchor head, d is the number of its observed tails, as in the beam executor's calibration. + """ + + def __init__(self, context, logic='product', observed_traversal=False, calibration=None): super().__init__(context) fuzzy_combine([torch.tensor(0.)], 'and', logic) + if type(observed_traversal) is not bool: + raise ValueError('observed_traversal must be a boolean') + if calibration not in (None, 'softmax-degree'): + raise ValueError('calibration must be None or softmax-degree') self.logic = logic + self.observed_traversal = observed_traversal + self.calibration = calibration + self._relation_edges = None def membership(self, tree): return self.membership_batch([tree])[0] @@ -128,11 +148,41 @@ def membership_batch(self, trees): if op == 'project': relation_ids = tuple(tree[1] for tree in trees) relations = torch.tensor(relation_ids, device=self.device) - return self.project_batch(self.membership_batch([tree[2] for tree in trees]), relations, relation_ids=relation_ids) + source = self.membership_batch([tree[2] for tree in trees]) + if self.calibration is None: + projected = self.project_batch(source, relations, relation_ids=relation_ids) + return torch.maximum(projected, self.traverse(source, relations)) if self.observed_traversal else projected + known = self.traverse(source, relations) + logits = self.project_batch(source, relations, relation_ids=relation_ids, logits=True) + degree = known.sum(1, keepdim=True).clamp_min(1) + projected = (logits.log_softmax(1) + degree.log()).exp().clamp_max(SOFTMAX_DEGREE_CEILING) + return torch.maximum(projected, known) if self.observed_traversal else projected if op == 'not': return 1 - self.membership_batch([tree[1] for tree in trees]) return fuzzy_combine([self.membership_batch(children) for children in zip(*(tree[1:] for tree in trees))], op, self.logic) + def traverse(self, membership, relations): + """Exact traversal of observed facts: each tail's highest membership among heads with (head, relation, tail).""" + device = membership.device + if self._relation_edges is None or self._relation_edges[0].device != device: + triples = torch.tensor(self.context.triples, dtype=torch.long).reshape(-1, 3) + triples = triples[torch.argsort(triples[:, 1], stable=True)] + counts = torch.bincount(triples[:, 1], minlength=self.context.num_relations) + offsets = torch.cat((counts.new_zeros(1), counts.cumsum(0))) + self._relation_edges = tuple(t.contiguous().to(device) for t in (offsets, triples[:, 0], triples[:, 2])) + offsets, heads, tails = self._relation_edges + starts = offsets[relations] + lengths = offsets[relations + 1] - starts + result = torch.zeros_like(membership) + total = int(lengths.sum()) + if total: + rows = torch.repeat_interleave(torch.arange(len(relations), device=device), lengths, output_size=total) + positions = torch.arange(total, device=device) - (lengths.cumsum(0) - lengths)[rows] + starts[rows] + values = membership[rows, heads[positions]] + # A maximum does not depend on the reduction order, so this is deterministic on every device. + result.view(-1).scatter_reduce_(0, rows * membership.shape[1] + tails[positions], values, 'amax') + return result + @torch.no_grad() def predict_batch(self, queries): trees = [compile_query(query) for query in queries] diff --git a/dicee/query_answering/methods/ultraquery.py b/dicee/query_answering/methods/ultraquery.py index 8791a77e2..414e1e634 100644 --- a/dicee/query_answering/methods/ultraquery.py +++ b/dicee/query_answering/methods/ultraquery.py @@ -8,10 +8,13 @@ class UltraQuery(FuzzyGNN): - def __init__(self, context, *, dim=64, num_layers=6, threshold=0., logic='product', cache_bytes=64 * 2**20): - super().__init__(context, logic) + def __init__(self, context, *, dim=64, num_layers=6, threshold=0., logic='product', cache_bytes=64 * 2**20, + observed_traversal=False, calibration=None): + super().__init__(context, logic, observed_traversal, calibration) if not 0 <= threshold <= 1: raise ValueError('Threshold must be between zero and one') + if calibration and threshold: + raise ValueError('A calibrated projection takes no membership threshold') self.threshold = threshold self.relation_model = RelNBFNet(dim, num_layers) self.entity_model = EntityNBFNet(dim, num_layers) @@ -32,7 +35,7 @@ def _layer(layer, hidden, boundary, relations, edges): value = layer.linear(torch.cat((hidden, update), -1)) return layer.layer_norm(value).relu() + hidden - def project_batch(self, membership, relation, *, relation_ids=None): + def project_batch(self, membership, relation, *, relation_ids=None, logits=False): rel_edges = cached_layout(self._layouts, 'relation', self.rel_edge_index, self.rel_edge_type, self.context.num_relations) ent_edges = cached_layout(self._layouts, 'entity', self.edge_index, self.edge_type, self.context.num_entities) @@ -63,4 +66,5 @@ def project_batch(self, membership, relation, *, relation_ids=None): hidden = self._layer(layer, hidden, boundary, projected, ent_edges) # Preserve the reference MLP arithmetic, including saturated probability ties. features = torch.cat((hidden, query[:, None].expand_as(hidden)), -1) - return self.entity_model.mlp(features).squeeze(-1).sigmoid() + output = self.entity_model.mlp(features).squeeze(-1) + return output if logits else output.sigmoid() diff --git a/dicee/query_answering/score_adapter.py b/dicee/query_answering/score_adapter.py index 911352c7a..1f4c63d39 100644 --- a/dicee/query_answering/score_adapter.py +++ b/dicee/query_answering/score_adapter.py @@ -18,6 +18,21 @@ from .context import checkpoint_state, state_fingerprint, state_token FEATURE_COUNTS = {'global': 1, 'context': 4, 'context_scores': 8} +# Fixed calibrations of published executors, applied instead of the sigmoid when ``fixed_calibration`` selects them: +# CQD-Hybrid's min-max normalization below the observed-fact membership, and QTO's softmax times the observed degree. +FIXED_CALIBRATIONS = ('minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties') +# Softmax calibrations: QTO's softmax times the observed degree, the plain softmax (degree one) and QTO with the ties at +# its cap ordered by the raw score, so that a beam or a ranking keeps the backbone's order among capped entities. +SOFTMAX_CALIBRATIONS = ('softmax-degree', 'softmax', 'softmax-degree-ties') +MINMAX_CEILING = .9 +SOFTMAX_DEGREE_CEILING = .9999 +# softmax-degree-ties lowers a capped log-membership by CAP_TIE_EPSILON * (1/2 - atan(raw) / pi), less than this +# much and strictly decreasing in the raw score: resolvable at the cap and after summing log-memberships over atoms. +CAP_TIE_EPSILON = 1e-6 +# With observed_tie_break, a known fact gets membership exp(-OBSERVED_TIE_EPSILON * (1 - mu)), mu its calibrated +# membership, instead of exactly one: still one for every practical purpose, but a beam over more known tails than it +# holds keeps those the backbone scores highest instead of those with the lowest entity IDs. +OBSERVED_TIE_EPSILON = 1e-9 def canonical_feature_mode(mode): @@ -63,12 +78,14 @@ class QueryScoreAdapter(nn.Module): learn eight and sixteen with a linear head. Context observations can override or interpolate memberships. Newly fitted adapters bind to a backbone state hash. ``membership_threshold`` zeroes memberships at or below a fixed value, the hand-set - calibration of UltraQuery LP; it is not trained. + calibration of UltraQuery LP; it is not trained. ``fixed_calibration`` replaces the sigmoid by a training-free + row calibration: ``minmax`` (CQD-Hybrid: 0.9 times the min-max normalized row) or ``softmax-degree`` (QTO: the + softmax over tails times the number of observed tails, at least one, capped below one). Both take no weights. """ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=None, metadata=None, bias_bound=4., scale_bound=2., normalization='none', hidden_dim=0, hidden_weights=None, seed=0, - membership_threshold=0.): + membership_threshold=0., fixed_calibration=None, mask_known_logits=False): super().__init__() feature_mode = canonical_feature_mode(feature_mode) if not math.isfinite(observed_mix) or not 0 <= observed_mix <= 1: @@ -83,10 +100,20 @@ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=No raise ValueError('membership_threshold must be in [0, 1)') if type(hidden_dim) is not int or hidden_dim < 0: raise ValueError('hidden_dim must be a nonnegative integer') + if fixed_calibration not in (None, *FIXED_CALIBRATIONS): + raise ValueError(f'Choose a fixed calibration: {", ".join(FIXED_CALIBRATIONS)}, or None for the sigmoid') + if fixed_calibration and (feature_mode != 'global' or hidden_dim or normalization != 'none' + or (weights is not None and bool(torch.as_tensor(weights).any()))): + raise ValueError('Training-free calibrations take no weights, features or normalization') + if mask_known_logits and fixed_calibration not in SOFTMAX_CALIBRATIONS: + raise ValueError('Masking known-tail logits applies to the softmax calibrations only') self.feature_mode, self.observed_mix = feature_mode, float(observed_mix) self.bias_bound, self.normalization, self.hidden_dim = float(bias_bound), normalization, hidden_dim self.scale_bound = None if scale_bound is None else float(scale_bound) self.membership_threshold = float(membership_threshold) + self.fixed_calibration = fixed_calibration + self.mask_known_logits = bool(mask_known_logits) + self.observed_tie_break = False # an evaluation option of the recipe, not part of the adapter artifact features = FEATURE_COUNTS[feature_mode] size = (2, hidden_dim or features) value = torch.zeros(size, dtype=torch.float64) if weights is None else torch.as_tensor(weights, dtype=torch.float64) @@ -112,15 +139,24 @@ def configuration(self): scale_bound=self.scale_bound, normalization=self.normalization, hidden_dim=self.hidden_dim) if self.membership_threshold: configuration['membership_threshold'] = self.membership_threshold + if self.fixed_calibration: + configuration['fixed_calibration'] = self.fixed_calibration + if self.mask_known_logits: + configuration['mask_known_logits'] = True return configuration + @property + def needs_context(self): + """Whether rows need the observed facts of a context graph (features, overrides or observed degrees).""" + return self.feature_mode != 'global' or bool(self.observed_mix) or self.fixed_calibration in SOFTMAX_CALIBRATIONS + def prepare(self, raw, observed=None, base=None): """Prepare parameter-independent inputs once for frozen training banks.""" raw = raw.to(dtype=torch.float64) if raw.ndim != 2: raise ValueError('Adapter requires [rows, entities] logits') if observed is None or base is None: - if self.feature_mode != 'global' or self.observed_mix: + if self.needs_context: raise ValueError('Context features/observations require an explicit context graph') observed = torch.zeros_like(raw, dtype=torch.bool) base = raw.new_zeros((len(raw), 4)) @@ -142,6 +178,8 @@ def _on(self, name, device): return copies[name][1] def transform(self, raw, observed, features): + if self.fixed_calibration: + return self._fixed(raw, observed) weights = self._on('weights', raw.device) if self.hidden_weights is not None: features = (features @ self._on('hidden_weights', raw.device).T).tanh() @@ -154,12 +192,37 @@ def transform(self, raw, observed, features): scale = log_scale.exp() require(torch.isfinite(scale).all() & ~(scale <= 0).any(), FloatingPointError('Nonfinite or zero adapter scale')) logits = scale[:, None] * raw + self.bias_bound * v.tanh()[:, None] - logs = F.logsigmoid(logits) + return self._finish(F.logsigmoid(logits), observed) + + def _fixed(self, raw, observed): + if self.fixed_calibration == 'minmax': + low, high = raw.min(1, keepdim=True).values, raw.max(1, keepdim=True).values + # A constant row has no order to normalize; all its memberships become zero. + logs = (MINMAX_CEILING * (raw - low) / torch.where(high > low, high - low, 1.)).log() + else: + scores = raw + if self.mask_known_logits: + # Known tails leave the softmax (a row of known tails only keeps its scores); the override still + # gives them membership one. + scores = torch.where(observed.all(1, keepdim=True), raw, raw.masked_fill(observed, -math.inf)) + logs = scores.log_softmax(1) + if self.fixed_calibration != 'softmax': + logs = logs + observed.sum(1, keepdim=True).clamp_min(1).to(raw.dtype).log() + capped = logs >= math.log(SOFTMAX_DEGREE_CEILING) + logs = logs.clamp_max(math.log(SOFTMAX_DEGREE_CEILING)) + if self.fixed_calibration == 'softmax-degree-ties': + logs = torch.where(capped, logs - CAP_TIE_EPSILON * (.5 - torch.atan(raw) / math.pi), logs) + return self._finish(logs, observed) + + def _finish(self, logs, observed): if self.membership_threshold: # UltraQuery LP's fixed calibration: memberships at or below the threshold become exactly zero. logs = logs.masked_fill(logs <= math.log(self.membership_threshold), -math.inf) if self.observed_mix == 1: - logs = logs.masked_fill(observed, 0.) + if self.observed_tie_break: + logs = torch.where(observed, OBSERVED_TIE_EPSILON * torch.expm1(logs), logs) + else: + logs = logs.masked_fill(observed, 0.) elif self.observed_mix: mixed = torch.logaddexp(logs.new_tensor(math.log(self.observed_mix)), math.log1p(-self.observed_mix) + logs) logs = torch.where(observed, mixed, logs) @@ -218,7 +281,7 @@ def load(cls, path: str | Path, *, model: Any, key: str | None = None, if payload.get('version', 1) not in (1, 2, 3): raise ValueError('Unsupported adapter artifact version') fields = ('weights', 'feature_mode', 'observed_mix', 'version', 'bias_bound', 'scale_bound', 'normalization', 'hidden_dim', - 'hidden_weights', 'membership_threshold') + 'hidden_weights', 'membership_threshold', 'fixed_calibration', 'mask_known_logits') metadata = {k: v for k, v in payload.items() if k not in fields} if 'backbone_state_sha256' not in metadata: if checkpoint is None or 'backbone_checkpoint_sha256' not in metadata: @@ -233,6 +296,7 @@ def load(cls, path: str | Path, *, model: Any, key: str | None = None, weights=payload['weights'], metadata=metadata, bias_bound=payload.get('bias_bound', 4.), scale_bound=payload.get('scale_bound', 2.), normalization=payload.get('normalization', 'none'), hidden_dim=payload.get('hidden_dim', 0), - hidden_weights=payload.get('hidden_weights'), membership_threshold=payload.get('membership_threshold', 0.)) + hidden_weights=payload.get('hidden_weights'), membership_threshold=payload.get('membership_threshold', 0.), + fixed_calibration=payload.get('fixed_calibration'), mask_known_logits=payload.get('mask_known_logits', False)) adapter.verify_model(model) return adapter diff --git a/docs/ultra.md b/docs/ultra.md index e584a68a6..773ee0835 100644 --- a/docs/ultra.md +++ b/docs/ultra.md @@ -61,6 +61,13 @@ For direct model use, import `ULTRA` from `dicee.models`, load weights with `load_pretrained(path)`, and attach indexed training triples with `set_graph(...)`. Triples follow DICE's `(head, relation, tail)` order. +Like upstream link prediction, ULTRA conditions the relation graph of a tail query +`(h, r, ?)` on the direct relation, also when `r` is an inverse relation. +`ultra_relation_conditioning="query"` conditions it on `r` itself, as UltraQuery's +projection does; with UltraQuery's weights the model then scores atoms exactly +like UltraQuery's single-source projection. It applies to tail queries +(`forward_k_vs_all`, `forward_k_vs_sample`). + ## Tests ```bash diff --git a/tests/test_query_baselines.py b/tests/test_query_baselines.py index b2d6b46a7..dd4c95c11 100644 --- a/tests/test_query_baselines.py +++ b/tests/test_query_baselines.py @@ -425,3 +425,133 @@ def test_checkpoint_graphs_validate_ids_without_using_held_out_edges(): graph._edge_list = torch.tensor([[0, 2, 2]]) with pytest.raises(ValueError, match='out-of-vocabulary'): _validate_graph_buffer('graph', graph, context, metadata) + + +@pytest.mark.parametrize('index', range(3)) +def test_ultraquery_observed_traversal_is_an_exact_max_with_symbolic_traversal(tmp_path, index): + """The opt-in observed-fact traversal equals max(GNN projection, naive symbolic traversal) at every projection.""" + from dicee.query_answering.methods._common import fuzzy_combine + fixture = torch.load(ROOT / 'ultra.pt', weights_only=True, map_location='cpu') + case = fixture['cases'][index] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'checkpoint.pt' + torch.save({'model_state_dict': case['state']}, path) + plain = load_method('ultraquery', path, context, **case['config']) + model = load_method('ultraquery', path, context, **case['config'], observed_traversal=True) + assert model.provenance['configuration']['observed_traversal'] is True + + def symbolic(source, relation): + result = torch.zeros_like(source) + for h, r, t in context.triples: + if r == relation: + result[t] = torch.maximum(result[t], source[h]) + return result + + def membership(tree): + if tree[0] == 'anchor': + return torch.nn.functional.one_hot(torch.tensor(tree[1]), context.num_entities).float() + if tree[0] == 'project': + source = membership(tree[2]) + return torch.maximum(plain.project(source, tree[1]), symbolic(source, tree[1])) + if tree[0] == 'not': + return 1 - membership(tree[1]) + return fuzzy_combine([membership(child) for child in tree[1:]], tree[0], plain.logic) + + with torch.no_grad(): + for shape, query in fixture['queries'].items(): + tree = compile_query(query) + torch.testing.assert_close(model.membership(tree), membership(tree), atol=0, rtol=0, msg=shape) + # Off by default: the plain port keeps the pinned upstream scores. + torch.testing.assert_close(plain.predict(query), case['scores'][shape], atol=3e-5, rtol=3e-5, msg=shape) + anchor, (relation,) = fixture['queries']['1p'] + tails = sorted(context.outgoing.get(anchor, {}).get(relation, ())) + assert tails and bool((model.membership(compile_query(fixture['queries']['1p']))[tails] == 1).all()) + batch = [fixture['queries'][shape] for shape in ('2p', '2p')] + torch.testing.assert_close(model.predict_batch(batch)[0], model.predict(batch[0]), atol=3e-5, rtol=3e-5) + + +@pytest.mark.parametrize('conditioning', ['direct', 'query']) +def test_frozen_ultra_with_query_conditioning_equals_the_ultraquery_projection(tmp_path, conditioning): + """UltraQuery's weights as a frozen ULTRA: with relation_conditioning='query', every atom equals UltraQuery's 1p projection; + ULTRA's link-prediction default conditions inverse queries on their direct relation instead.""" + from dicee.models import ULTRA + from dicee.query_answering.context import attached_context, evaluation_mode + fixture = torch.load(ROOT / 'ultra.pt', weights_only=True, map_location='cpu') + case = fixture['cases'][0] + # Declared inverse pairs make the context graph identical for both models. + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations'], ((0, 2), (1, 3))) + path = tmp_path / 'checkpoint.pt' + torch.save({'model_state_dict': case['state']}, path) + port = load_method('ultraquery', path, context, threshold=0.) + state = {key.removeprefix('model.model.').removeprefix('model.'): value for key, value in case['state'].items()} + torch.save({'model': state}, tmp_path / 'ultra.pth') + dim = state['relation_model.layers.0.linear.weight'].shape[0] + layers = len({key.split('.')[2] for key in state if key.startswith('relation_model.layers.')}) + model = ULTRA(dict(num_entities=1, num_relations=1, graph_inference_backend='torch', ultra_dim=dim, ultra_num_layers=layers, + ultra_relation_conditioning=conditioning)).load_pretrained(str(tmp_path / 'ultra.pth')).eval() + differences = {} + with torch.no_grad(), attached_context(model, context), evaluation_mode(model): + for h in range(context.num_entities): + for r in range(context.num_relations): + membership = port.project(torch.nn.functional.one_hot(torch.tensor(h), context.num_entities).float(), r) + differences[h, r] = (model.forward_k_vs_all(torch.tensor([[h, r]]))[0].sigmoid() - membership).abs().max().item() + direct = [d for (_, r), d in differences.items() if r in (0, 1)] + inverse = [d for (_, r), d in differences.items() if r in (2, 3)] + assert max(direct) < 1e-5 + assert (max(inverse) < 1e-5) == (conditioning == 'query') + with pytest.raises(ValueError, match='relation_conditioning'): + ULTRA(dict(num_entities=1, num_relations=1, ultra_relation_conditioning='inverse')) + + +@pytest.mark.parametrize('index', [0]) +@pytest.mark.parametrize('traversal', [False, True]) +def test_ultraquery_softmax_degree_calibration_follows_its_closed_form(tmp_path, index, traversal): + """Calibrated projections: min(d * softmax(logits), 0.9999), d the observed-tail mass reached from the fuzzy set.""" + from dicee.query_answering.methods._common import fuzzy_combine + fixture = torch.load(ROOT / 'ultra.pt', weights_only=True, map_location='cpu') + case = fixture['cases'][index] + context = QueryContext(fixture['triples'], fixture['num_entities'], fixture['num_relations']) + path = tmp_path / 'checkpoint.pt' + torch.save({'model_state_dict': case['state']}, path) + config = dict(case['config'], threshold=0.) + plain = load_method('ultraquery', path, context, **config) + model = load_method('ultraquery', path, context, **config, observed_traversal=traversal, calibration='softmax-degree') + assert model.provenance['configuration']['calibration'] == 'softmax-degree' + + def symbolic(source, relation): + result = torch.zeros_like(source) + for h, r, t in context.triples: + if r == relation: + result[t] = torch.maximum(result[t], source[h]) + return result + + def membership(tree): + if tree[0] == 'anchor': + return torch.nn.functional.one_hot(torch.tensor(tree[1]), context.num_entities).float() + if tree[0] == 'project': + source = membership(tree[2]) + logits = plain.project_batch(source[None], torch.tensor([tree[1]]), relation_ids=(tree[1],), logits=True)[0] + known = symbolic(source, tree[1]) + value = (logits.softmax(0) * known.sum().clamp_min(1)).clamp_max(.9999) + return torch.maximum(value, known) if traversal else value + if tree[0] == 'not': + return 1 - membership(tree[1]) + return fuzzy_combine([membership(child) for child in tree[1:]], tree[0], plain.logic) + + with torch.no_grad(): + for shape, query in fixture['queries'].items(): + tree = compile_query(query) + torch.testing.assert_close(model.membership(tree), membership(tree), atol=1e-6, rtol=1e-5, msg=shape) + # A single anchor head: d is its number of observed tails, as in the beam executor's calibration. + anchor, (relation,) = fixture['queries']['1p'] + tails = sorted(context.outgoing.get(anchor, {}).get(relation, ())) + logits = plain.project_batch(torch.nn.functional.one_hot(torch.tensor([anchor]), context.num_entities).float(), + torch.tensor([relation]), relation_ids=(relation,), logits=True)[0] + expected = (logits.softmax(0) * max(1, len(tails))).clamp_max(.9999) + if traversal: + expected[tails] = 1. + torch.testing.assert_close(model.membership(compile_query(fixture['queries']['1p'])), expected, atol=1e-6, rtol=1e-5) + with pytest.raises(ValueError, match='threshold'): + load_method('ultraquery', path, context, **dict(case['config'], threshold=.5), calibration='softmax-degree') + with pytest.raises(ValueError, match='calibration'): + load_method('ultraquery', path, context, **config, calibration='minmax') diff --git a/tests/test_query_engine.py b/tests/test_query_engine.py index e5e95e87f..1bda004f3 100644 --- a/tests/test_query_engine.py +++ b/tests/test_query_engine.py @@ -162,6 +162,24 @@ def test_observed_proofs_survive_pruning_and_do_not_shortcut_negation(): assert exact[3] == 0 +def test_negation_from_known_facts_excludes_only_their_answers(raw): + # Known answers: (1, 1) -> {2, 3}; the chain 0 -0-> 1 -1-> reaches {2, 3} too. + context = QueryContext([(0, 0, 1), (1, 1, 2), (1, 1, 3)], 4, 2) + engine = QueryAnswerer(TableModel(raw), context=context, observed_mix=1) + keep = torch.tensor([1., 1., 0., 0.], dtype=torch.float64) + pa, pb = engine.predict((0, (0,))), engine.predict((1, (1,))) + two_in = ((0, (0,)), (1, (1, -2))) + torch.testing.assert_close(engine.predict(two_in, negation='observed'), pa * keep, rtol=1e-14, atol=0) + # The default still negates the backbone's memberships, not the facts. + torch.testing.assert_close(engine.predict(two_in), pa * (1 - pb), rtol=1e-14, atol=0) + pni = ((0, (0, 1, -2)), (1, (1,))) + torch.testing.assert_close(engine.predict(pni, negation='observed'), pb * keep, rtol=1e-14, atol=0) + with pytest.raises(ValueError, match='Negation must be'): + engine.predict(two_in, negation='facts') + with pytest.raises(ValueError, match='known facts needs'): + QueryAnswerer(TableModel(raw)).predict(two_in, negation='observed') + + def test_cache_bounded_reused_and_invalidated(raw): model = TableModel(raw) engine = QueryAnswerer(model, cache_bytes=4*8) @@ -542,3 +560,74 @@ def test_membership_threshold_runs_in_the_executor_and_keys_its_cache(): after = engine.predict(((0, (0,)), (1, (1, -2)))) # Zero memberships are ordinary values for the executor, also under negation. assert torch.isfinite(after).all() and (after == 0).any() and (after > 0).any() and not torch.equal(before, after) + + +def test_training_free_calibrations_follow_cqd_hybrid_and_qto(tmp_path): + model = TableModel(np.zeros((4, 1, 4))) + raw = torch.tensor([[-2., 0., 1., 3.], [5., 5., 5., 5.]], dtype=torch.float64) + observed, base = QueryContext([(0, 0, 0), (0, 0, 1)], 4, 1).features([(0, 0), (1, 0)], device='cpu') + minmax = QueryScoreAdapter('global', 0., fixed_calibration='minmax')(raw, observed, base).exp() + # CQD-Hybrid: 0.9 (s - min) / (max - min); a constant row has no order and gets zero everywhere. + torch.testing.assert_close(minmax[0], .9 * (raw[0] + 2) / 5, rtol=0, atol=1e-15) + assert bool((minmax[1] == 0).all()) + softmax = QueryScoreAdapter('global', 0., fixed_calibration='softmax-degree')(raw, observed, base).exp() + # QTO: softmax times the observed tail count (two for (0, 0), at least one otherwise), capped at 0.9999. + expected = (raw.softmax(1) * torch.tensor([[2.], [1.]], dtype=torch.float64)).clamp_max(.9999) + torch.testing.assert_close(softmax, expected, rtol=1e-12, atol=0) + facts = QueryScoreAdapter('global', 1., fixed_calibration='softmax-degree', + metadata={'backbone_state_sha256': state_fingerprint(model), 'calibration': 'documentation only'}) + scores = facts(raw, observed, base) + assert scores[0, 0] == 0 and scores[0, 1] == 0 and scores[0, 3] < 0 + facts.save(tmp_path / 'adapter.json') + loaded = QueryScoreAdapter.load(tmp_path / 'adapter.json', model=model) + assert loaded.configuration == facts.configuration and loaded.fixed_calibration == 'softmax-degree' and loaded.needs_context + assert loaded.metadata['calibration'] == 'documentation only' + # The default sigmoid keeps every existing configuration, artifact and cache key unchanged. + assert 'fixed_calibration' not in QueryScoreAdapter('global').configuration and not QueryScoreAdapter('global').needs_context + with pytest.raises(ValueError, match='Training-free'): + QueryScoreAdapter('global', fixed_calibration='minmax', weights=[[1.], [0.]]) + with pytest.raises(ValueError, match='Training-free'): + QueryScoreAdapter('context_scores', fixed_calibration='softmax-degree') + with pytest.raises(ValueError, match='fixed calibration'): + QueryScoreAdapter('global', fixed_calibration='temperature') + with pytest.raises(ValueError, match='context graph'): + QueryScoreAdapter('global', fixed_calibration='softmax-degree')(raw) + + +def test_observed_ties_follow_the_backbone_only_when_asked(): + raw = torch.tensor([[1., 3., 2., 0.]], dtype=torch.float64) + observed, base = QueryContext([(0, 0, 0), (0, 0, 1), (0, 0, 2)], 4, 1).features([(0, 0)], device='cpu') + adapter = QueryScoreAdapter('global', 1.) + plain = adapter(raw, observed, base) + # Default: every known tail is exactly one, so a beam keeps the lowest entity IDs among them. + assert bool((plain[0, :3] == 0).all()) and plain[0, 3] < 0 + adapter.observed_tie_break = True + ordered = adapter(raw, observed, base) + # Known tails stay within a billionth of one, ordered by the backbone (entity 1 > 2 > 0); other entities are unchanged. + assert bool((ordered[0, :3] <= 0).all()) and bool((ordered[0, :3] > -1e-9).all()) + assert ordered[0, 1] > ordered[0, 2] > ordered[0, 0] + assert ordered[0, 3] == plain[0, 3] + assert 'observed_tie_break' not in adapter.configuration + + +def test_softmax_calibration_variants_and_known_tail_masking(): + raw = torch.tensor([[0., 30., 30.5, 2., 1.], [1., 2., 3., 4., 5.]], dtype=torch.float64) + observed, base = QueryContext([(0, 0, 0), (0, 0, 3), (0, 0, 4)], 5, 1).features([(0, 0), (1, 0)], device='cpu') + softmax = QueryScoreAdapter('global', 0., fixed_calibration='softmax')(raw, observed, base).exp() + # d = 1: the plain softmax, capped below one. + torch.testing.assert_close(softmax, raw.softmax(1).clamp_max(.9999), rtol=1e-12, atol=0) + qto = QueryScoreAdapter('global', 0., fixed_calibration='softmax-degree')(raw, observed, base) + ties = QueryScoreAdapter('global', 0., fixed_calibration='softmax-degree-ties')(raw, observed, base) + # QTO's memberships up to a millionth; with d = 3, entities 1 and 2 of row 0 both exceed the cap and tie under QTO. + assert float((qto - ties).abs().max()) <= 1e-6 + assert qto[0, 1] == qto[0, 2] and ties[0, 2] > ties[0, 1] + assert bool((qto[1] == ties[1]).all()) + masked = QueryScoreAdapter('global', 1., fixed_calibration='softmax-degree', mask_known_logits=True) + scores = masked(raw, observed, base) + # Known tails (entities 0, 3 and 4 of row 0) leave the softmax and keep membership one through the override. + expected = (raw[0, 1:3].softmax(0) * 3).clamp_max(.9999).log() + torch.testing.assert_close(scores[0, 1:3], expected, rtol=1e-12, atol=0) + assert scores[0, 0] == 0 and scores[0, 3] == 0 and scores[0, 4] == 0 + assert masked.configuration['mask_known_logits'] is True and 'mask_known_logits' not in QueryScoreAdapter('global').configuration + with pytest.raises(ValueError, match='Masking known-tail'): + QueryScoreAdapter('global', fixed_calibration='minmax', mask_known_logits=True) From 9adfecfec89b378a5f5f4109c28f34db6be10355 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 9 Oct 2026 14:21:51 +0200 Subject: [PATCH 32/39] feat(benchmarks): parallel verification and a KGFM reference for the new calibrations - verify runs its checks in parallel with --gpus; combined reports keep candidate and context identity. - The independent KGFM reference covers the training-free calibrations, the observed traversal and negation from known facts. - PROTOCOL.md documents the two opt-in options that are not upstream methods: UltraQuery's observed traversal and UltraQuery's weights as a frozen ULTRA backbone. Every adapter file under benchmarks/adapters is tracked. --- .gitignore | 1 + benchmarks/cqa/PROTOCOL.md | 11 ++ benchmarks/cqa/README.md | 9 +- benchmarks/cqa/cli.py | 26 +++-- benchmarks/cqa/reports.py | 3 + benchmarks/cqa/study.py | 5 +- benchmarks/cqa/tests/recipe_fingerprints.json | 30 ++++++ benchmarks/cqa/tests/test_adapter_pairs.py | 7 ++ benchmarks/cqa/tests/test_kgfm_reference.py | 100 ++++++++++++++++++ benchmarks/cqa/tests/test_launcher.py | 4 +- .../cqa/verification/export_reference.py | 32 ++++++ benchmarks/cqa/verification/reference_kgfm.py | 54 ++++++++-- benchmarks/cqa/verification/verify_kgfm.py | 6 +- 13 files changed, 263 insertions(+), 25 deletions(-) diff --git a/.gitignore b/.gitignore index 40ecfec25..0e6b44156 100644 --- a/.gitignore +++ b/.gitignore @@ -184,6 +184,7 @@ Experiments/ # Benchmark reports are local artifacts; recipes, adapters and published scores are tracked. /benchmarks/**/*.json !/benchmarks/adapters/*.json +!/benchmarks/adapters/**/*.json !/benchmarks/plus_h/*.json !/benchmarks/ultraquery/*.json !/benchmarks/cqa/tests/*.json diff --git a/benchmarks/cqa/PROTOCOL.md b/benchmarks/cqa/PROTOCOL.md index 5cb4fb451..33a73198f 100644 --- a/benchmarks/cqa/PROTOCOL.md +++ b/benchmarks/cqa/PROTOCOL.md @@ -103,6 +103,17 @@ backbone logits; backbone checkpoint parity is tested separately. The bounded CQD profile is verified against an equally bounded reference and can differ numerically from dense upstream execution. +Two opt-in variants are not upstream +methods. UltraQuery with `observed_traversal` also takes, at every projection, +the maximum with an exact traversal of the observed facts from the same fuzzy +set; its oracles come from the pinned upstream code with that maximum added +through upstream's own `SymbolicTraversal`. UltraQuery's released weights used +as a frozen ULTRA backbone (`relation_conditioning: query`) condition relation +reasoning on the queried relation, as UltraQuery's projection does; ULTRA's link +prediction conditions an inverse tail query on its direct relation instead. +With that setting the frozen backbone equals UltraQuery's single-source +projection for every relation (tests/test_query_baselines.py). + ## Reproducibility Inference is float32 with IEEE matrix products, no autocast and deterministic diff --git a/benchmarks/cqa/README.md b/benchmarks/cqa/README.md index 99bdf0590..bf4d6b028 100644 --- a/benchmarks/cqa/README.md +++ b/benchmarks/cqa/README.md @@ -176,10 +176,11 @@ so they are frozen with the study and verified on the target GPU. `run` and `evaluate` accept `--gpus 0 1 2 3`: each entry runs in a fresh worker that sees one GPU, longest methods first, with results identical to a -sequential run. `--workers-per-gpu 2` overlaps one worker's host work with -another's GPU work, for about 1.5 times the throughput of one worker; with the -H100 profile each KGFM worker stays below 12 GiB of GPU memory and holds up to -24 GiB of host memory. Keep one worker per GPU on GPUs shared with other jobs. +sequential run; `verify` runs its checks the same way. `--workers-per-gpu 2` +overlaps one worker's host work with another's GPU work, for about 1.5 times +the throughput of one worker; with the H100 profile each KGFM worker stays +below 12 GiB of GPU memory and holds up to 24 GiB of host memory. Keep one +worker per GPU on GPUs shared with other jobs. The QTO recipes build each relation's thresholded calibrated matrix once, from the released canonical 100-head blocks, and keep it in CSR form: up to 6 GiB diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 3f6d80e47..5ab6eac2b 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -114,6 +114,7 @@ def parallel(p): p.add_argument('--comparison-references', type=Path, help='Optional dense CQD oracles for comparison reporting') p.add_argument('--device', default='cuda') p.add_argument('--study-path', help=argparse.SUPPRESS) + parallel(p) container(p) p = command('run', 'Run frozen entries: a validation pilot, or the test after verification') @@ -359,7 +360,9 @@ def verify(parser, args): Passing evidence of an unchanged entry (a KGFM integration check, or a parity check against the same oracles) is reused, so an interrupted - verification resumes and checks can run as separate jobs. + verification resumes and checks can run as separate jobs. With ``--gpus`` + the checks run concurrently, one GPU per worker, logged to + ``verification/ENTRY.log``; the evidence does not depend on the order. """ from .study import freeze, integration_passed, parity_passed, verify_bundle study, root = args.output.resolve(), args.input_root.resolve() @@ -381,7 +384,7 @@ def verify(parser, args): continue if (target / 'pilot').exists(): raise ValueError(f'KGFM verification requires a fresh directory: {target}') - jobs.append((entry['id'], [*common, 'integration', *options, '--output', str(target)])) + jobs.append((entry['id'], entry['method'], [*common, 'integration', *options, '--output', str(target)])) continue reference = args.references / f'{entry["id"]}.pt' if args.references else None if reference is None or not reference.is_file(): @@ -395,11 +398,19 @@ def verify(parser, args): raise ValueError(f'Missing comparison oracle: {comparison}') command += ['--comparison-reference', str(comparison)] if not parity_passed(evidence, bundle, entry, reference, comparison): - jobs.append((entry['id'], command)) - for entry, command in jobs: - print(json.dumps(dict(entry=entry, state='verifying')), flush=True) - if subprocess.run(command).returncode: - raise SystemExit(f'Verification of {entry} failed; see its output above') + jobs.append((entry['id'], entry['method'], command)) + if args.gpus and jobs: + logs = study / 'verification' + logs.mkdir(parents=True, exist_ok=True) + failed = run_workers([(entry, method, command, logs / f'{entry}.log') for entry, method, command in jobs], + status=logs / 'status.json', gpus=args.gpus, workers_per_gpu=args.workers_per_gpu) + if failed: + raise SystemExit('Verification failed (see verification/ENTRY.log): ' + ', '.join(entry for entry, _ in failed)) + else: + for entry, _, command in jobs: + print(json.dumps(dict(entry=entry, state='verifying')), flush=True) + if subprocess.run(command).returncode: + raise SystemExit(f'Verification of {entry} failed; see its output above') for entry in manifest['entries']: evidence = study / 'evidence' / f'{entry["id"]}.json' if entry['method'].endswith('-adapter'): @@ -483,6 +494,7 @@ def integration(parser, args): def main(argv=None): + argv = sys.argv[1:] if argv is None else list(argv) parser, commands = build_parser() args = parser.parse_args(argv) command = commands[args.command] diff --git a/benchmarks/cqa/reports.py b/benchmarks/cqa/reports.py index 2f03cbd52..6df5b0cf1 100644 --- a/benchmarks/cqa/reports.py +++ b/benchmarks/cqa/reports.py @@ -185,6 +185,9 @@ def _export_reports(results, published, output, *, bootstrap_samples, seed, titl details.append(dict(id=run['entry'], dataset=report['dataset'], **summary, inference_graph=graph, graph_ablation=report.get('graph_ablation') if run['phase'] == 'test' else None, graph_recipe_sha256=report.get('graph_recipe_sha256'), + # Candidate and context identity, so comparisons across runs stay verifiable from this file. + num_candidates=report.get('num_candidates'), candidate_sha256=report.get('candidate_sha256'), + context_sha256=report.get('context_sha256'), calibration=report['inference'].get('calibration'), answer_filter=answer_filter, filter_paired_with=report.get('filter_paired_with'), paired_with=report.get('paired_with'), published_per_shape=scores if coverage else {}, result=str(path))) diff --git a/benchmarks/cqa/study.py b/benchmarks/cqa/study.py index b628a3bb7..7c5456391 100644 --- a/benchmarks/cqa/study.py +++ b/benchmarks/cqa/study.py @@ -35,11 +35,12 @@ def code_identity(): """Source that can change frozen-study results. The dicee package without its command-line scripts, and this harness without - tests or paper tooling, so local scripts never break verification elsewhere. + tests, paper tooling or the reproduction driver (whose manifests and adapters + are pinned by the bundle itself), so local scripts never break verification elsewhere. """ package, harness = SOURCE_ROOT / 'dicee', Path(__file__).resolve().parent paths = [path for path in package.rglob('*.py') if path.relative_to(package).parts[0] != 'scripts'] - paths += [path for path in harness.rglob('*.py') if path.relative_to(harness).parts[0] not in ('tests', 'paper')] + paths += [path for path in harness.rglob('*.py') if path.relative_to(harness).parts[0] not in ('tests', 'paper', 'reproduction')] return source_fingerprint(paths, SOURCE_ROOT) diff --git a/benchmarks/cqa/tests/recipe_fingerprints.json b/benchmarks/cqa/tests/recipe_fingerprints.json index 5682ae064..935ebdf45 100644 --- a/benchmarks/cqa/tests/recipe_fingerprints.json +++ b/benchmarks/cqa/tests/recipe_fingerprints.json @@ -30,6 +30,11 @@ "trix-product-intersections-NELL995+H": "69cb115effd0ee6d9c14c06f8d4866e3ff2148260174b36722d0a7b68e8dab3c", "trix-product-intersections-ICEWS18+H": "6f84bbe2e79bb47b5c8a788db48dd51079f52ad1274a839043fe472d36f66b37" }, + "plus_h/kgfm_kgicl.json": { + "kgicl-product-intersections-FB15k237+H": "3e0c3f327646759f60036d9f5f09be48bc1693d483d38fe2fae8fca625cf6781", + "kgicl-product-intersections-NELL995+H": "9ac42998bb1d26ba9c06da2ff84f467274c5bfe7817d4aa6c6d77c5d69cfb8e4", + "kgicl-product-intersections-ICEWS18+H": "5977665fc7a15759ee0c2a40a1b71b757bdd222a52ff551175c13d7fc65fc146" + }, "ultraquery/baselines.json": { "ultraquery-FB15k237LogicalQuery": "529aa658841bff87867a50b626cae7e9c01dc8a7b38b5177eda2af712988e66d", "ultraquery-FB15kLogicalQuery": "01ae98208647999c884181ef7308944ffc47555d260b4f27d7bdf2bc0dea5f7f", @@ -164,6 +169,31 @@ "trix-product-intersections-WikiTopicsQuery:sport": "789c3e69c42d240f41d9b14cc72dee70f887a0498b14de7b92e50b89975b0c69", "trix-product-intersections-WikiTopicsQuery:tax": "ca14cbcb7938c80e89c121d75f71c9163c26cc6dc622efabb7e35ebc3457dd40" }, + "ultraquery/kgfm_kgicl.json": { + "kgicl-product-intersections-FB15k237LogicalQuery": "cff9eea715c7a4a4768486e720d7c0ecbb7d5a35354d0845f30b918bd3adc65c", + "kgicl-product-intersections-FB15kLogicalQuery": "a3c9e24991f977f0b94f058b9c526d2a019bbed8024487d12adf880a88fef751", + "kgicl-product-intersections-NELL995LogicalQuery": "b19316ac77ca1e865c9a309bd3f2be16df59763e150eaa77059091c16d2a90ea", + "kgicl-product-intersections-InductiveFB15k237Query:106": "e61fb816352242fc91e7dfc64e0bdc025aff3cffc722c522d5e347660b61b557", + "kgicl-product-intersections-InductiveFB15k237Query:113": "2d57a3d39d734335db012f43d436bcae09adb54b0710a2c70dc6f874566ad41d", + "kgicl-product-intersections-InductiveFB15k237Query:122": "d4abc1950f6d50f5a556a40244ed2ee360f9a255cca68cb1abbf8f8d0297d205", + "kgicl-product-intersections-InductiveFB15k237Query:134": "0c889ef74caa71112580914fcdda71bd238579fa8925d0ceb84e71d37727d76d", + "kgicl-product-intersections-InductiveFB15k237Query:150": "5de5b5c6a3ad1613cab2f3354a54a6cfa1887f1059d4ee39a3d50de43e6447bc", + "kgicl-product-intersections-InductiveFB15k237Query:175": "ad5f2c720057f394097d108506139d736ad8b416e569e04d11c2e0e17b6b66ee", + "kgicl-product-intersections-InductiveFB15k237Query:217": "e28d1b34573eaee7d94993e96ce9430a9e2386f1f5d538501d498048bfed3d07", + "kgicl-product-intersections-InductiveFB15k237Query:300": "86fffdd3c4358c56533596fb9a2b478f57582d84f70943c8b024fd77f2b6fed9", + "kgicl-product-intersections-InductiveFB15k237Query:550": "ac49339a01fee731825b09d78472150552470507adcb716e43995cb98372125a", + "kgicl-product-intersections-WikiTopicsQuery:art": "d4b346dad1f3e596d48d126c7791cb5194d1a0b3e4ae776c5df612633d276532", + "kgicl-product-intersections-WikiTopicsQuery:award": "3900bfe021dc7c9dc7db621eb913e505fdcd7a8a1a153da305bbecc1132c1fba", + "kgicl-product-intersections-WikiTopicsQuery:edu": "a81509b725b885d475a9b613969a16142aa69e9af8d62da310c7139944b028a2", + "kgicl-product-intersections-WikiTopicsQuery:health": "892b8215293c912e5de38089ea4f3ec0e6f6d41a3f512e67221d0e8b202217c0", + "kgicl-product-intersections-WikiTopicsQuery:infra": "43c4a124071b007bd0a63bbfb473273c824fc395a9955cf6792c1a8fe41209be", + "kgicl-product-intersections-WikiTopicsQuery:loc": "87095e5bd34466c4a457233bb95ea552c4059a9de22d2596b9837ea2f9cfb2eb", + "kgicl-product-intersections-WikiTopicsQuery:org": "06382ab313032eab6443a8bf6a8ca7d714454dbd3768a221cd3d55c8503fd78e", + "kgicl-product-intersections-WikiTopicsQuery:people": "185d92a96b7679d19fd8388e20e5790f20ba5fee09d02dcdf8d954d66413a69e", + "kgicl-product-intersections-WikiTopicsQuery:sci": "8f26bbc1b3a2fe0fd764a0fb6958e4bff8566907751d253728f4e380836ad288", + "kgicl-product-intersections-WikiTopicsQuery:sport": "7a8d96f2a063eb4d2ee0b68ddcf8d2aac1f15870bf662413eb834ec0a423997c", + "kgicl-product-intersections-WikiTopicsQuery:tax": "dd2b9ccb6fe96f624635c3d1693204bfe939942d41b50413635a30657873c6bb" + }, "ultraquery/trained_baselines.json": { "qto-FB15kLogicalQuery": "fbfdca9fe1cbcf143a8d8e2db1f3df8e341454b21b5325e7abe6b92de9be8b48", "inductive-gnnqe-InductiveFB15k237Query:106": "1fa57c57fae80e52dcde4de9dbcca48dc6dcd8b22639792aa2478d79daf530bd", diff --git a/benchmarks/cqa/tests/test_adapter_pairs.py b/benchmarks/cqa/tests/test_adapter_pairs.py index 6115b8b5e..a4739c31d 100644 --- a/benchmarks/cqa/tests/test_adapter_pairs.py +++ b/benchmarks/cqa/tests/test_adapter_pairs.py @@ -169,6 +169,13 @@ def test_paired_kgfm_verification_full_run_and_reports(tmp_path, backbone, facts assert len(rows) == 2 and all(row['complete_test'] for row in rows) assert all(row['complete_16_type_test'] == (not ultraquery) for row in rows) assert all(row['observed_facts'] == settings for row in rows) + # Combined reports carry no result files, so the details keep the candidate and context identity. + details = {d['id']: d for d in read(tmp_path / 'reports/comparison.json')['details']} + for raw in (result, control): + detail = details[raw.get('benchmark_run', raw.get('paper_run'))['entry']] + assert detail['candidate_sha256'] and detail['context_sha256'] + assert {k: detail[k] for k in ('num_candidates', 'candidate_sha256', 'context_sha256')} == \ + {k: raw[k] for k in ('num_candidates', 'candidate_sha256', 'context_sha256')} assert len(read(tmp_path / 'reports/adapter-effects.json')) == 1 if ultraquery: write_json(tmp_path / 'manifest.json', manifest) diff --git a/benchmarks/cqa/tests/test_kgfm_reference.py b/benchmarks/cqa/tests/test_kgfm_reference.py index bb0ca4a5b..a8e829142 100644 --- a/benchmarks/cqa/tests/test_kgfm_reference.py +++ b/benchmarks/cqa/tests/test_kgfm_reference.py @@ -151,6 +151,93 @@ def test_reference_applies_a_fixed_membership_threshold(operator, facts, mode): beam_size=3, device='cpu') +@pytest.mark.parametrize('operator', ['product', 'min']) +@pytest.mark.parametrize('facts', ['none', 'atomic', 'both']) +@pytest.mark.parametrize('calibration', ['minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-degree-ties-masked']) +def test_reference_applies_training_free_calibrations(operator, facts, calibration): + model = Rows().eval() + context = QueryContext([(0, 0, 1), (0, 0, 2), (2, 1, 6), (1, 1, 3), (3, 2, 4), (4, 3, 5)], 7, 4) + masked = calibration.endswith('-masked') + adapter = QueryScoreAdapter('global', float(facts != 'none'), bias_bound=8., fixed_calibration=calibration.removesuffix('-masked'), + mask_known_logits=masked) + reference = reference_module.ReferenceKGFM(context.triples, 7, 4, adapter.to_dict(), beam_size=2, device='cpu', + restore_observed=facts == 'both') + conditions = [(h, r) for h in range(7) for r in range(4)] + with torch.no_grad(): + for start in range(0, len(conditions), 2): + batch = conditions[start:start + 2] + reference.capture(batch, model.forward_k_vs_all(torch.tensor(batch))) + engine = QueryAnswerer(model, context=context, adapter=adapter, row_batch_size=2, restore_observed=facts == 'both') + queries = [instantiate(shape) for shape in QUERY_SHAPES.values()] + engine.prefetch(queries) + for query in queries: + expected = reference.predict(query, operator) + actual = engine.predict(query, beam_size=2, tnorm='prod' if operator == 'product' else 'min', return_log_scores=True) + torch.testing.assert_close(actual, expected, atol=1e-14, rtol=1e-14) + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)) + with pytest.raises(ValueError): + reference_module.ReferenceKGFM(context.triples, 7, 4, dict(adapter.to_dict(), weights=[[1.], [0.]]), + beam_size=2, device='cpu') + + +@pytest.mark.parametrize('operator', ['product', 'min']) +@pytest.mark.parametrize('calibration', [None, 'softmax-degree']) +def test_reference_orders_known_tails_by_the_backbone_when_asked(operator, calibration): + model = Rows().eval() + # (0, 0) has three known tails, more than the beam of two holds. + context = QueryContext([(0, 0, 1), (0, 0, 2), (0, 0, 5), (2, 1, 6), (1, 1, 3), (5, 1, 4), (3, 2, 4), (4, 3, 5)], 7, 4) + adapter = QueryScoreAdapter('global', 1., bias_bound=8., fixed_calibration=calibration) + adapter.observed_tie_break = True + reference = reference_module.ReferenceKGFM(context.triples, 7, 4, adapter.to_dict(), beam_size=2, device='cpu', + observed_ties='model') + conditions = [(h, r) for h in range(7) for r in range(4)] + with torch.no_grad(): + for start in range(0, len(conditions), 2): + batch = conditions[start:start + 2] + reference.capture(batch, model.forward_k_vs_all(torch.tensor(batch))) + engine = QueryAnswerer(model, context=context, adapter=adapter, row_batch_size=2) + plain = QueryAnswerer(model, context=context, adapter=QueryScoreAdapter('global', 1., bias_bound=8., fixed_calibration=calibration), + row_batch_size=2) + queries = [instantiate(shape) for shape in QUERY_SHAPES.values()] + engine.prefetch(queries) + plain.prefetch(queries) + changed = False + for query in queries: + expected = reference.predict(query, operator) + tnorm = 'prod' if operator == 'product' else 'min' + actual = engine.predict(query, beam_size=2, tnorm=tnorm, return_log_scores=True) + torch.testing.assert_close(actual, expected, atol=1e-14, rtol=1e-14) + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)) + changed |= not torch.equal(actual, plain.predict(query, beam_size=2, tnorm=tnorm, return_log_scores=True)) + assert changed + + +@pytest.mark.parametrize('operator', ['product', 'min']) +@pytest.mark.parametrize('calibration', [None, 'softmax-degree']) +def test_reference_negates_from_known_facts_when_asked(operator, calibration): + model = Rows().eval() + context = QueryContext([(0, 0, 1), (0, 0, 2), (0, 0, 5), (2, 1, 6), (1, 1, 3), (5, 1, 4), (3, 2, 4), (4, 3, 5)], 7, 4) + adapter = QueryScoreAdapter('global', 1., bias_bound=8., fixed_calibration=calibration) + reference = reference_module.ReferenceKGFM(context.triples, 7, 4, adapter.to_dict(), beam_size=2, device='cpu', negation='observed') + conditions = [(h, r) for h in range(7) for r in range(4)] + with torch.no_grad(): + for start in range(0, len(conditions), 2): + batch = conditions[start:start + 2] + reference.capture(batch, model.forward_k_vs_all(torch.tensor(batch))) + engine = QueryAnswerer(model, context=context, adapter=adapter, row_batch_size=2) + queries = [instantiate(shape) for shape in QUERY_SHAPES.values()] + engine.prefetch(queries) + tnorm = 'prod' if operator == 'product' else 'min' + changed = False + for query in queries: + expected = reference.predict(query, operator) + actual = engine.predict(query, beam_size=2, tnorm=tnorm, return_log_scores=True, negation='observed') + torch.testing.assert_close(actual, expected, atol=1e-14, rtol=1e-14) + assert torch.equal(actual.argsort(descending=True), expected.argsort(descending=True)) + changed |= not torch.equal(actual, engine.predict(query, beam_size=2, tnorm=tnorm, return_log_scores=True)) + assert changed + + @pytest.mark.parametrize('operator', ['product', 'min']) def test_reference_needs_no_rows_for_zero_prefix_but_requires_live_rows(operator): adapter = QueryScoreAdapter('context_scores', 1.) @@ -161,3 +248,16 @@ def test_reference_needs_no_rows_for_zero_prefix_but_requires_live_rows(operator assert torch.isneginf(reference.predict(contradiction, operator)).all() with pytest.raises(KeyError): reference.predict((0, (0, 1)), operator) + + +def test_recipe_rules_of_the_opt_in_backbone_options(): + from dicee.query_answering.catalog import KGFM_ADAPTERS, KGFM_BACKBONES, check_recipe + shapes = ['1p', '2i'] + base = dict(operators={'1p': 'product', '2i': 'product'}, adapters={'product': 'a.json'}, selection_protocol='source-validation') + assert 'flock-adapter' in KGFM_ADAPTERS and KGFM_BACKBONES['flock-adapter'][0] == 'jw9730/flock' + check_recipe(dict(base, method='flock-adapter', options=dict(test_samples=1, walk_num=128)), shapes) + check_recipe(dict(base, method='ultra-adapter', options=dict(relation_conditioning='query')), shapes) + for method, options in (('ultra-adapter', dict(test_samples=1)), ('flock-adapter', dict(walk_num=0)), + ('trix-adapter', dict(relation_conditioning='query')), ('ultra-adapter', dict(relation_conditioning='inverse'))): + with pytest.raises(ValueError): + check_recipe(dict(base, method=method, options=options), shapes) diff --git a/benchmarks/cqa/tests/test_launcher.py b/benchmarks/cqa/tests/test_launcher.py index 67ad88e0f..3521ac6e9 100644 --- a/benchmarks/cqa/tests/test_launcher.py +++ b/benchmarks/cqa/tests/test_launcher.py @@ -383,12 +383,14 @@ def test_parallel_run_uses_fresh_workers_and_resumes_like_sequential_runs(tmp_pa cli.main(args[:-2] + ['--device', 'cpu', '--gpus', '0']) -def test_container_forwards_parallel_gpus_only_for_evaluate_and_run(tmp_path, capsys): +def test_container_forwards_parallel_gpus_only_for_evaluate_verify_and_run(tmp_path, capsys): common = ['--input-root', str(tmp_path), '--output', str(tmp_path / 'out'), *IMAGE] cli.main(['plus_h', 'run', *common, '--gpus', '0', '1', 'GPU-2c', '--workers-per-gpu', '2']) assert '--gpus 0 1 GPU-2c --workers-per-gpu 2' in capsys.readouterr().out cli.main(['plus_h', 'evaluate', *common, '--split', 'test', '--gpus', '1']) assert '--gpus 1' in capsys.readouterr().out + cli.main(['plus_h', 'verify', *common, '--gpus', '0', '1']) + assert '--gpus 0 1' in capsys.readouterr().out for command, extra in [('prepare', ['--gpus', '0']), ('run', ['--workers-per-gpu', '2']), ('run', ['--gpus'])]: with pytest.raises(SystemExit): cli.main(['plus_h', command, *common, *extra]) diff --git a/benchmarks/cqa/verification/export_reference.py b/benchmarks/cqa/verification/export_reference.py index 15e0b26af..9361787e1 100644 --- a/benchmarks/cqa/verification/export_reference.py +++ b/benchmarks/cqa/verification/export_reference.py @@ -290,6 +290,31 @@ def predict(shape, batch): model = UltraQuery(backbone, threshold=options['threshold'], logic=options['logic']) backbone.load_state_dict(state, strict=True) model.to(device).eval() + if options.get('calibration') == 'softmax-degree': + # DICE's opt-in calibrated variant, built from upstream parts: upstream's relation and entity models give the + # projection logits; the softmax over entities times the observed-tail mass that upstream's SymbolicTraversal + # reaches from the fuzzy set (at least one), capped at 0.9999, replaces the sigmoid; with observed_traversal + # the result also takes the maximum with that traversal. + from ultra.ultraquery import SymbolicTraversal + if options['threshold']: + raise ValueError('A calibrated projection takes no membership threshold') + projection, symbolic, traverse = model.model, SymbolicTraversal(), bool(options.get('observed_traversal')) + + def calibrated(graph, h_prob, r_index): + rel_reprs = projection.model.relation_model(graph.relation_graph, query=r_index) + query = rel_reprs[torch.arange(r_index.shape[0], device=r_index.device), r_index] + output = projection.model.entity_model(graph, torch.einsum('bn, bd -> bnd', h_prob, query), rel_reprs, query) + known = symbolic(graph, h_prob, r_index) + result = (output.log_softmax(1) + known.sum(1, keepdim=True).clamp(min=1).log()).exp().clamp(max=.9999) + return torch.maximum(result, known) if traverse else result + model.model.forward = calibrated + elif options.get('observed_traversal'): + # DICE's opt-in variant, built from upstream parts: each projection also takes the maximum with upstream's + # own symbolic traversal of the same fuzzy set, so observed facts keep their source's membership. + from ultra.ultraquery import SymbolicTraversal + neural, symbolic = model.model.forward, SymbolicTraversal() + model.model.forward = lambda graph, h_prob, r_index: torch.maximum(neural(graph, h_prob, r_index), + symbolic(graph, h_prob, r_index)) return lambda shape, batch: model(graph, torch.stack([Query.from_nested(q) for q in batch]).to(device), symbolic_traversal=False) if method in ('gnnqe', 'inductive-gnnqe', 'incoming-relation'): collections.Sequence = collections.abc.Sequence @@ -431,6 +456,13 @@ def main(): oracle['runtime_adjustments'] = ['Partition independent attention heads; preserve complete query sequences and batches.'] if entry['method'] == 'incoming-relation': oracle['runtime_adjustments'] = ['Seed each query independently before upstream random tie shuffling; preserve Boolean classes.'] + if entry['method'] in ('ultraquery', 'ultraquery-lp') and entry['options'].get('observed_traversal'): + oracle['runtime_adjustments'] = ['Opt-in observed traversal (not an upstream option): every projection takes the maximum ' + "with upstream's SymbolicTraversal of the same fuzzy set."] + if entry['method'] in ('ultraquery', 'ultraquery-lp') and entry['options'].get('calibration'): + oracle.setdefault('runtime_adjustments', []).append( + 'Opt-in softmax-times-degree calibration (not an upstream option): every projection applies the softmax of ' + "upstream's projection logits times the observed-tail mass of upstream's SymbolicTraversal, capped at 0.9999.") if entry['method'] in ('gnnqe', 'inductive-gnnqe', 'incoming-relation'): oracle['runtime_adjustments'].append('Configure TorchDrug size-to-index helper and Python/RDKit imports.') if entry['method'] in ('cqd', 'cqd-hybrid') and entry['options'].get('reference_batching') is False: diff --git a/benchmarks/cqa/verification/reference_kgfm.py b/benchmarks/cqa/verification/reference_kgfm.py index 755f22586..a4590565f 100644 --- a/benchmarks/cqa/verification/reference_kgfm.py +++ b/benchmarks/cqa/verification/reference_kgfm.py @@ -7,14 +7,19 @@ class ReferenceKGFM: - def __init__(self, triples, n, nr, adapter, *, beam_size, device, restore_observed=True): + def __init__(self, triples, n, nr, adapter, *, beam_size, device, restore_observed=True, observed_ties='entity', negation='model'): if (adapter['feature_mode'] not in ('context_scores', 'context_scores_v1', 'global') or adapter['hidden_dim'] or adapter['normalization'] != 'none' or adapter['observed_mix'] not in (0, 1) - or not 0 <= adapter.get('membership_threshold', 0.) < 1): + or not 0 <= adapter.get('membership_threshold', 0.) < 1 + or adapter.get('fixed_calibration') not in (None, 'minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties') + or (adapter.get('fixed_calibration') + and (adapter['feature_mode'] != 'global' or any(w for row in adapter['weights'] for w in row)))): raise ValueError('This reference covers the frozen linear observed-fact recipe') self.n, self.nr, self.adapter = n, nr, adapter self.k, self.device = beam_size, device self.restore_observed = restore_observed + self.observed_ties = observed_ties + self.negation = negation self.edges = defaultdict(set) triples = set(map(tuple, triples)) self.degree = Counter(h for h, _, _ in triples) @@ -48,16 +53,41 @@ def capture(self, conditions, raw): torch.stack(((mean / 4).tanh(), entropy, gap, contrast), dim=1)), 1) if self.adapter['feature_mode'] == 'global': features = raw.new_ones((len(raw), 1)) - u, v = (features @ raw.new_tensor(self.adapter['weights']).T).unbind(1) - bound = math.log(self.adapter['scale_bound']) - alpha = (bound * (u * (math.log(2) / bound)).tanh()).exp() - logits = alpha[:, None] * raw + self.adapter['bias_bound'] * v.tanh()[:, None] - calibrated = torch.nn.functional.logsigmoid(logits) + calibration = self.adapter.get('fixed_calibration') + if calibration == 'minmax': + # CQD-Hybrid: 0.9 (s - min) / (max - min) per row; a constant row gets membership zero everywhere. + low, high = raw.min(1, keepdim=True).values, raw.max(1, keepdim=True).values + spread = high - low + calibrated = torch.where(spread > 0, 0.9 * (raw - low) / torch.where(spread > 0, spread, 1.), 0.).log() + elif calibration in ('softmax-degree', 'softmax', 'softmax-degree-ties'): + # QTO: softmax over tails times the observed tail count (at least one), capped at 0.9999 below one; 'softmax' + # drops the count, '-ties' orders capped tails by the raw score. Masked known tails leave the softmax. + scores = raw + if self.adapter.get('mask_known_logits'): + keep = ~observed | observed.all(1, keepdim=True) + scores = torch.where(keep, raw, raw.new_tensor(-math.inf)) + level = torch.log_softmax(scores, 1) + if calibration != 'softmax': + level = level + count.clamp_min(1).double().log()[:, None] + calibrated = torch.minimum(level, raw.new_tensor(math.log(0.9999))) + if calibration == 'softmax-degree-ties': + calibrated = calibrated - torch.where(level >= math.log(0.9999), 1e-6 * torch.atan2(torch.ones_like(raw), raw) / math.pi, + raw.new_zeros(())) + else: + u, v = (features @ raw.new_tensor(self.adapter['weights']).T).unbind(1) + bound = math.log(self.adapter['scale_bound']) + alpha = (bound * (u * (math.log(2) / bound)).tanh()).exp() + logits = alpha[:, None] * raw + self.adapter['bias_bound'] * v.tanh()[:, None] + calibrated = torch.nn.functional.logsigmoid(logits) if self.adapter.get('membership_threshold'): # A fixed threshold makes memberships at or below it exactly zero; observed facts still override. calibrated = calibrated.masked_fill(calibrated <= math.log(self.adapter['membership_threshold']), -math.inf) if self.adapter['observed_mix'] == 1: - calibrated = calibrated.masked_fill(observed, 0.) + if self.observed_ties == 'model': + # Known facts a billionth below one, in the order of their calibrated membership. + calibrated = torch.where(observed, -1e-9 * (1 - calibrated.exp()), calibrated) + else: + calibrated = calibrated.masked_fill(observed, 0.) self.rows.update((tuple(condition), row.cpu()) for condition, row in zip(conditions, calibrated)) self.raw_rows += len(conditions) @@ -81,7 +111,13 @@ def visit(value): scores, answers, positive = visit(value[0]) for position, relation in enumerate(value[1]): if relation == -2: - scores, positive = self.complement(scores), False + if self.negation == 'observed': + # Known facts alone: exclude the branch's exact answers, keep every other entity at one. + scores = torch.zeros(self.n, dtype=torch.float64, device=self.device) + scores[sorted(answers)] = -torch.inf + else: + scores = self.complement(scores) + positive = False answers = set(range(self.n)) - answers continue if isinstance(value[0], int) and position == 0: diff --git a/benchmarks/cqa/verification/verify_kgfm.py b/benchmarks/cqa/verification/verify_kgfm.py index 3e2ff710e..d6665109e 100644 --- a/benchmarks/cqa/verification/verify_kgfm.py +++ b/benchmarks/cqa/verification/verify_kgfm.py @@ -35,10 +35,12 @@ def initialize(engine, *args, **kwargs): scorer = engine.scorer variant = 'without-adapter' if engine.adapter.metadata.get('calibration') == 'identity' else 'learned' expected_adapter = adapter if variant == 'learned' else dict(adapter, feature_mode='global', weights=[[0.], [0.]], - membership_threshold=0.) + membership_threshold=0., fixed_calibration=None) reference = ReferenceKGFM(scorer.context.triples, scorer.n, scorer.nr, expected_adapter, beam_size=entry['options']['beam_size'], device=scorer.device, - restore_observed=observed_facts in (None, 'both')) + restore_observed=observed_facts in (None, 'both'), + observed_ties=entry['options'].get('observed_ties', 'entity'), + negation=entry['options'].get('negation', 'model')) scorers[id(scorer)] = reference references[variant] = reference From 4aae9a2dd44e7f7e86ae68547e527159ca90bbbe Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Wed, 14 Oct 2026 23:39:06 +0200 Subject: [PATCH 33/39] chore(benchmarks): drop the 14-type adapters that no recipe references --- benchmarks/adapters/trix_product_14types.json | 134 ------------------ .../adapters/ultra_product_14types.json | 134 ------------------ 2 files changed, 268 deletions(-) delete mode 100644 benchmarks/adapters/trix_product_14types.json delete mode 100644 benchmarks/adapters/ultra_product_14types.json diff --git a/benchmarks/adapters/trix_product_14types.json b/benchmarks/adapters/trix_product_14types.json deleted file mode 100644 index 1af43d796..000000000 --- a/benchmarks/adapters/trix_product_14types.json +++ /dev/null @@ -1,134 +0,0 @@ -{ - "backbone_state_sha256": "4a2e050130570df0964fc84cf14e6fcaec8672e30afb44f2b0aaf358864d95f7", - "training": { - "objective": "filtered_softmax_v1", - "epochs": 500, - "batch_size": 8, - "learning_rate": 0.02, - "identity_penalty": 0.001, - "gradient_clip": 1.0, - "seed": 2026090851, - "weighting": "equal_source_shape", - "selection": "source_validation_mrr", - "shapes": [ - "1p", - "2i", - "2in", - "2p", - "2u", - "3i", - "3in", - "3p", - "inp", - "ip", - "pi", - "pin", - "pni", - "up" - ], - "validation_sources": [ - "CoDExMedium", - "FB15k237", - "WN18RR" - ], - "validation_every": 5, - "training_sources": [ - "CoDExMedium", - "FB15k237", - "WN18RR" - ], - "train_per_shape": 20, - "early_stopping_patience": 100, - "beam_size": 64, - "validation_shapes": [ - "1p", - "2p", - "3p", - "2i", - "3i", - "2in", - "3in", - "inp", - "pin", - "pni" - ], - "device": "cuda", - "validation_device": "cpu", - "cpu_threads": 4, - "training_cache_bytes": 6442450944, - "device_cache_bytes": 536870912, - "selected_epoch": 15, - "selected_validation_mrr": 0.2160742403142149, - "epochs_completed": 115, - "stopped_early": true, - "stop_reason": "validation_patience", - "training_queries": 840, - "optimizer_steps": 12075, - "row_cache": { - "FB15k237": { - "host_hits": 1466481, - "device_hits": 52637, - "disk_rows": 12913, - "scored_rows": 3173, - "feature_preparations": 3177, - "seconds": 1113.5889300499111 - }, - "WN18RR": { - "host_hits": 1393241, - "device_hits": 126645, - "disk_rows": 12583, - "scored_rows": 2735, - "feature_preparations": 2760, - "seconds": 492.1543016753276 - }, - "CoDExMedium": { - "host_hits": 1138753, - "device_hits": 385423, - "disk_rows": 9294, - "scored_rows": 1734, - "feature_preparations": 1761, - "seconds": 476.73713415215025 - } - } - }, - "score_banks": [ - "8d06f4ecca4f7c446ed706644f784b789c48cc7c0797df173915ea99b158379b", - "6e8c83f950fb39daae2e43f662e3384727b42dfc69250b851bdadf64f396021b", - "1981e87027c19d29146a1ed70c9c9ecbb47382d45cb73aef8b326bf7b4cc1fd6" - ], - "sources": { - "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", - "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", - "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" - }, - "version": 3, - "feature_mode": "context_scores_v1", - "observed_mix": 1.0, - "bias_bound": 8.0, - "scale_bound": 2.0, - "normalization": "none", - "hidden_dim": 0, - "weights": [ - [ - -0.4206266978568604, - 1.8175990925134906, - -0.20239740750133875, - -0.10149383004454994, - -0.10618729432335908, - 0.8947173515160507, - 2.372061080351603, - 0.8125137228828666 - ], - [ - -0.97435279237582, - 1.5779700697689738, - -0.31425804123937096, - 0.2372066367521474, - -0.7893614994120073, - -0.48732115928976905, - -1.1798536343618, - -0.2108354323830918 - ] - ], - "hidden_weights": null -} diff --git a/benchmarks/adapters/ultra_product_14types.json b/benchmarks/adapters/ultra_product_14types.json deleted file mode 100644 index 186bcc393..000000000 --- a/benchmarks/adapters/ultra_product_14types.json +++ /dev/null @@ -1,134 +0,0 @@ -{ - "backbone_state_sha256": "5524f131f909918c40daa0c6169eaf8ebb7ca344ccf9e96e1d81154cd5097e5b", - "training": { - "objective": "filtered_softmax_v1", - "epochs": 500, - "batch_size": 8, - "learning_rate": 0.02, - "identity_penalty": 0.001, - "gradient_clip": 1.0, - "seed": 2026090851, - "weighting": "equal_source_shape", - "selection": "source_validation_mrr", - "shapes": [ - "1p", - "2i", - "2in", - "2p", - "2u", - "3i", - "3in", - "3p", - "inp", - "ip", - "pi", - "pin", - "pni", - "up" - ], - "validation_sources": [ - "CoDExMedium", - "FB15k237", - "WN18RR" - ], - "validation_every": 5, - "training_sources": [ - "CoDExMedium", - "FB15k237", - "WN18RR" - ], - "train_per_shape": 20, - "early_stopping_patience": 100, - "beam_size": 64, - "validation_shapes": [ - "1p", - "2p", - "3p", - "2i", - "3i", - "2in", - "3in", - "inp", - "pin", - "pni" - ], - "device": "cuda", - "validation_device": "cpu", - "cpu_threads": 4, - "training_cache_bytes": 6442450944, - "device_cache_bytes": 536870912, - "selected_epoch": 110, - "selected_validation_mrr": 0.21033703261698602, - "epochs_completed": 210, - "stopped_early": true, - "stop_reason": "validation_patience", - "training_queries": 840, - "optimizer_steps": 22050, - "row_cache": { - "FB15k237": { - "host_hits": 2691269, - "device_hits": 95863, - "disk_rows": 13107, - "scored_rows": 3177, - "feature_preparations": 3429, - "seconds": 654.5506004370982 - }, - "WN18RR": { - "host_hits": 2501664, - "device_hits": 286752, - "disk_rows": 12399, - "scored_rows": 2601, - "feature_preparations": 2843, - "seconds": 353.80072834936436 - }, - "CoDExMedium": { - "host_hits": 2121753, - "device_hits": 670378, - "disk_rows": 9481, - "scored_rows": 1804, - "feature_preparations": 6516, - "seconds": 351.37388774967985 - } - } - }, - "score_banks": [ - "234956d0ff36b7c9b617eaccf08f5b90cdfcf767bf0ea7cd16370b89d5796d73", - "bde8017c40d3b147437e164de2de075ed6ffd46beeeadcc869ba68127ceb19dd", - "fb5f99029aedca2a5d177da53b2ad24fa04f477a223fa5de82dc3e7910893a0e" - ], - "sources": { - "FB15k237": "b144aa69f3fb06b4e62148adfae3f966c99776c8942ab987ec011d1a4855e6d1", - "WN18RR": "b5b638df29e8d26c20f4a32851d2266700a23d7bba4b28d84b917034a41bc9d1", - "CoDExMedium": "de72a1ae56a1f8ce0b54314c1cf6b8e06b0f65dba4fabf7ced49f725c2afcd6d" - }, - "version": 3, - "feature_mode": "context_scores_v1", - "observed_mix": 1.0, - "bias_bound": 8.0, - "scale_bound": 2.0, - "normalization": "none", - "hidden_dim": 0, - "weights": [ - [ - -2.0626464576086057, - 2.5843856571497836, - -0.8894196831163416, - 1.0546347147429727, - -0.8845241302531646, - 1.555732410649971, - 1.8981372913377885, - 0.7030732760071264 - ], - [ - -0.8441497931973995, - 1.1414811216674428, - 0.11921445306291666, - 0.7004416344087456, - -0.5180700160343036, - -0.7152943095341088, - -0.5694389475806457, - -0.1457005467138816 - ] - ], - "hidden_weights": null -} From e6d79d213da6b1be23261aa96adf4180e6d06b1b Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 15 Oct 2026 10:20:52 +0200 Subject: [PATCH 34/39] feat(query_answering): FIT's softmax-mass calibration fixed_calibration='softmax-mass' scales the softmax over tails so that the observed tails together hold their count (FIT, Yin et al., 2024, Section 5.2), capped at QTO's 0.9999 below the membership of an observed fact. A row without observed tails keeps the plain softmax, and known-tail masking is refused because the factor divides by the softmax mass on those tails. The KGFM reference oracle covers the new calibration. --- benchmarks/cqa/tests/test_kgfm_reference.py | 3 ++- benchmarks/cqa/verification/reference_kgfm.py | 9 ++++++- dicee/query_answering/score_adapter.py | 25 +++++++++++++------ tests/test_query_engine.py | 13 ++++++++++ 4 files changed, 41 insertions(+), 9 deletions(-) diff --git a/benchmarks/cqa/tests/test_kgfm_reference.py b/benchmarks/cqa/tests/test_kgfm_reference.py index a8e829142..def73a749 100644 --- a/benchmarks/cqa/tests/test_kgfm_reference.py +++ b/benchmarks/cqa/tests/test_kgfm_reference.py @@ -153,7 +153,8 @@ def test_reference_applies_a_fixed_membership_threshold(operator, facts, mode): @pytest.mark.parametrize('operator', ['product', 'min']) @pytest.mark.parametrize('facts', ['none', 'atomic', 'both']) -@pytest.mark.parametrize('calibration', ['minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-degree-ties-masked']) +@pytest.mark.parametrize('calibration', ['minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-degree-ties-masked', + 'softmax-mass']) def test_reference_applies_training_free_calibrations(operator, facts, calibration): model = Rows().eval() context = QueryContext([(0, 0, 1), (0, 0, 2), (2, 1, 6), (1, 1, 3), (3, 2, 4), (4, 3, 5)], 7, 4) diff --git a/benchmarks/cqa/verification/reference_kgfm.py b/benchmarks/cqa/verification/reference_kgfm.py index a4590565f..ff86c4238 100644 --- a/benchmarks/cqa/verification/reference_kgfm.py +++ b/benchmarks/cqa/verification/reference_kgfm.py @@ -11,7 +11,7 @@ def __init__(self, triples, n, nr, adapter, *, beam_size, device, restore_observ if (adapter['feature_mode'] not in ('context_scores', 'context_scores_v1', 'global') or adapter['hidden_dim'] or adapter['normalization'] != 'none' or adapter['observed_mix'] not in (0, 1) or not 0 <= adapter.get('membership_threshold', 0.) < 1 - or adapter.get('fixed_calibration') not in (None, 'minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties') + or adapter.get('fixed_calibration') not in (None, 'minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-mass') or (adapter.get('fixed_calibration') and (adapter['feature_mode'] != 'global' or any(w for row in adapter['weights'] for w in row)))): raise ValueError('This reference covers the frozen linear observed-fact recipe') @@ -73,6 +73,13 @@ def capture(self, conditions, raw): if calibration == 'softmax-degree-ties': calibrated = calibrated - torch.where(level >= math.log(0.9999), 1e-6 * torch.atan2(torch.ones_like(raw), raw) / math.pi, raw.new_zeros(())) + elif calibration == 'softmax-mass': + # FIT: softmax times the observed tail count over the softmax mass on the observed tails (no factor for a row + # without observed tails), capped at 0.9999 below one. + share = torch.softmax(raw, 1) + mass = (share * observed).sum(1) + factor = torch.where(count > 0, count.double() / mass, raw.new_ones(())) + calibrated = torch.minimum((share * factor[:, None]).log(), raw.new_tensor(math.log(0.9999))) else: u, v = (features @ raw.new_tensor(self.adapter['weights']).T).unbind(1) bound = math.log(self.adapter['scale_bound']) diff --git a/dicee/query_answering/score_adapter.py b/dicee/query_answering/score_adapter.py index 1f4c63d39..a3d224758 100644 --- a/dicee/query_answering/score_adapter.py +++ b/dicee/query_answering/score_adapter.py @@ -20,10 +20,11 @@ FEATURE_COUNTS = {'global': 1, 'context': 4, 'context_scores': 8} # Fixed calibrations of published executors, applied instead of the sigmoid when ``fixed_calibration`` selects them: # CQD-Hybrid's min-max normalization below the observed-fact membership, and QTO's softmax times the observed degree. -FIXED_CALIBRATIONS = ('minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties') -# Softmax calibrations: QTO's softmax times the observed degree, the plain softmax (degree one) and QTO with the ties at -# its cap ordered by the raw score, so that a beam or a ranking keeps the backbone's order among capped entities. -SOFTMAX_CALIBRATIONS = ('softmax-degree', 'softmax', 'softmax-degree-ties') +FIXED_CALIBRATIONS = ('minmax', 'softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-mass') +# Softmax calibrations: QTO's softmax times the observed degree, the plain softmax (degree one), QTO with the ties at +# its cap ordered by the raw score, so that a beam or a ranking keeps the backbone's order among capped entities, and +# FIT's softmax times the observed degree over the softmax mass on the observed tails (softmax-mass). +SOFTMAX_CALIBRATIONS = ('softmax-degree', 'softmax', 'softmax-degree-ties', 'softmax-mass') MINMAX_CEILING = .9 SOFTMAX_DEGREE_CEILING = .9999 # softmax-degree-ties lowers a capped log-membership by CAP_TIE_EPSILON * (1/2 - atan(raw) / pi), less than this @@ -79,8 +80,9 @@ class QueryScoreAdapter(nn.Module): interpolate memberships. Newly fitted adapters bind to a backbone state hash. ``membership_threshold`` zeroes memberships at or below a fixed value, the hand-set calibration of UltraQuery LP; it is not trained. ``fixed_calibration`` replaces the sigmoid by a training-free - row calibration: ``minmax`` (CQD-Hybrid: 0.9 times the min-max normalized row) or ``softmax-degree`` (QTO: the - softmax over tails times the number of observed tails, at least one, capped below one). Both take no weights. + row calibration: ``minmax`` (CQD-Hybrid: 0.9 times the min-max normalized row), ``softmax-degree`` (QTO: the + softmax over tails times the number of observed tails, at least one, capped below one) or ``softmax-mass`` (FIT: the + softmax times the number of observed tails over their softmax mass, capped below one). They take no weights. """ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=None, metadata=None, @@ -107,6 +109,8 @@ def __init__(self, feature_mode='context_scores', observed_mix=0., *, weights=No raise ValueError('Training-free calibrations take no weights, features or normalization') if mask_known_logits and fixed_calibration not in SOFTMAX_CALIBRATIONS: raise ValueError('Masking known-tail logits applies to the softmax calibrations only') + if mask_known_logits and fixed_calibration == 'softmax-mass': + raise ValueError('softmax-mass divides by the softmax mass on the known tails, so they cannot leave the softmax') self.feature_mode, self.observed_mix = feature_mode, float(observed_mix) self.bias_bound, self.normalization, self.hidden_dim = float(bias_bound), normalization, hidden_dim self.scale_bound = None if scale_bound is None else float(scale_bound) @@ -206,7 +210,14 @@ def _fixed(self, raw, observed): # gives them membership one. scores = torch.where(observed.all(1, keepdim=True), raw, raw.masked_fill(observed, -math.inf)) logs = scores.log_softmax(1) - if self.fixed_calibration != 'softmax': + if self.fixed_calibration == 'softmax-mass': + # FIT (Yin et al., 2024, Section 5.2): the softmax is scaled so that the observed tails together hold + # their count, which makes their mean membership one before the cap. A row without observed tails keeps + # the softmax. The cap stays QTO's 0.9999, below the membership of an observed fact. + count = observed.sum(1, keepdim=True) + mass = logs.masked_fill(~observed, -math.inf).logsumexp(1, keepdim=True) + logs = logs + torch.where(count > 0, count.clamp_min(1).to(raw.dtype).log() - mass, 0.) + elif self.fixed_calibration != 'softmax': logs = logs + observed.sum(1, keepdim=True).clamp_min(1).to(raw.dtype).log() capped = logs >= math.log(SOFTMAX_DEGREE_CEILING) logs = logs.clamp_max(math.log(SOFTMAX_DEGREE_CEILING)) diff --git a/tests/test_query_engine.py b/tests/test_query_engine.py index 1bda004f3..a1f270a62 100644 --- a/tests/test_query_engine.py +++ b/tests/test_query_engine.py @@ -631,3 +631,16 @@ def test_softmax_calibration_variants_and_known_tail_masking(): assert masked.configuration['mask_known_logits'] is True and 'mask_known_logits' not in QueryScoreAdapter('global').configuration with pytest.raises(ValueError, match='Masking known-tail'): QueryScoreAdapter('global', fixed_calibration='minmax', mask_known_logits=True) + # FIT: the softmax times the observed tail count over the softmax mass on the observed tails, so that the observed + # tails of row 0 (entities 0, 3 and 4) together hold three before the cap; row 1 has none and keeps the softmax. + fit = QueryScoreAdapter('global', 0., fixed_calibration='softmax-mass')(raw, observed, base).exp() + share = raw.softmax(1) + factor = 3 / share[0, [0, 3, 4]].sum() + torch.testing.assert_close(fit[0], (share[0] * factor).clamp_max(.9999), rtol=1e-12, atol=0) + torch.testing.assert_close(fit[1], share[1].clamp_max(.9999), rtol=1e-12, atol=0) + # Before the cap the observed tails hold exactly their count. Here the two unobserved entities hold nearly all of the + # softmax mass, so the factor is large and lifts them to the cap, above two of the three observed tails. + torch.testing.assert_close((share[0, [0, 3, 4]] * factor).sum(), torch.tensor(3., dtype=torch.float64), rtol=1e-12, atol=0) + assert float(factor) > 1e11 and fit[0, 1] == fit[0, 2] == .9999 and fit[0, 0] < fit[0, 4] < .9999 + with pytest.raises(ValueError, match='softmax-mass'): + QueryScoreAdapter('global', fixed_calibration='softmax-mass', mask_known_logits=True) From 5fb98262826091c7e99051d4cad17997a533e6d0 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 15 Oct 2026 10:20:55 +0200 Subject: [PATCH 35/39] feat(benchmarks): difficulty reports of direct evaluate runs difficulty-report --direct reads the results of direct evaluate runs, which carry no bundle hash; the bundle then only pins the label-generation inputs and the filter corrections. Without the flag such results are refused as before, and the report records its result_mode. --- benchmarks/cqa/cli.py | 5 ++++- benchmarks/cqa/difficulty.py | 17 ++++++++++++----- .../cqa/tests/test_inference_difficulty.py | 11 +++++++++++ 3 files changed, 27 insertions(+), 6 deletions(-) diff --git a/benchmarks/cqa/cli.py b/benchmarks/cqa/cli.py index 5ab6eac2b..575320396 100644 --- a/benchmarks/cqa/cli.py +++ b/benchmarks/cqa/cli.py @@ -144,6 +144,8 @@ def parallel(p): p.add_argument('--labels-root', type=Path, help='Separate extraction root for released reduction labels') p.add_argument('--entries', nargs='+', action='extend', help='Completed result IDs, including control suffixes') p.add_argument('--query-types', nargs='+', action='extend', help='Report-only query-type subset') + p.add_argument('--direct', action='store_true', + help='Read results of direct evaluate runs; the bundle only pins the data files and filter corrections') container(p) p = command('train', 'Train UltraQuery baselines in the author runtime (UltraQuery suite)') @@ -459,7 +461,8 @@ def report(parser, args): def difficulty_report(parser, args): from .difficulty import export_difficulty_reports result = export_difficulty_reports(args.results, args.bundle, args.input_root, args.output, - labels_root=args.labels_root, entries=args.entries, query_types=args.query_types) + labels_root=args.labels_root, entries=args.entries, query_types=args.query_types, + direct=args.direct) print(json.dumps(dict(rows=len(result['rows']), pending_main_entries=len(result['pending_main_entries']), output=str(args.output)))) diff --git a/benchmarks/cqa/difficulty.py b/benchmarks/cqa/difficulty.py index 047ea0f17..da70eab5b 100644 --- a/benchmarks/cqa/difficulty.py +++ b/benchmarks/cqa/difficulty.py @@ -300,12 +300,17 @@ def summarize_difficulty(path, records, classifier, *, author_labels=None, shape return dict(rows=result, counts=dict(counts), seen=seen) -def export_difficulty_reports(results, bundle, input_root, output, *, labels_root=None, entries=None, query_types=None): +def export_difficulty_reports(results, bundle, input_root, output, *, labels_root=None, entries=None, query_types=None, + direct=False): """Postprocess completed jobs from a frozen inference bundle. No frozen-source verification, model loading, checkpoint locks or writes to inference artifacts. A new output directory is required. In-progress traces without result.json are never opened. + + ``direct`` reads the results of direct evaluate runs, which carry no bundle + hash. The bundle then only pins the label-generation inputs and the filter + corrections. """ from dicee.query_answering.method_evaluation import GRAPH_INDEPENDENT_METHODS @@ -326,12 +331,13 @@ def export_difficulty_reports(results, bundle, input_root, output, *, labels_roo run = report.get('benchmark_run', report.get('paper_run')) if run is None: continue - if run.get('bundle') == bundle_hash: + matches = (run.get('mode') == 'direct' and 'bundle' not in run) if direct else run.get('bundle') == bundle_hash + if matches: completed.add(run['entry']) if selected_entries is not None and run['entry'] not in selected_entries: continue - if run['bundle'] != bundle_hash: - raise ValueError(f'Result was not produced by this frozen bundle: {path}') + if not matches: + raise ValueError(f'Result was not produced by {"a direct run" if direct else "this frozen bundle"}: {path}') if report['split'] != 'test': raise ValueError('Inference difficulty currently supports test traces only') jobs.append((path, report, run)) @@ -440,7 +446,8 @@ def classify(self, shape, query, hard): semantics='Minimum missing positive atoms on full-truth witnesses; negation restricts truth at zero cost; union selects a branch.', averaging='Within each group: answers per query, then participating queries per parent type. No cross-type difficulty macro.', contribution='original_weight_contribution sums to the parent metric within each grouping; query_weight is its original answer-per-query mass.', - pending_main_entries=sorted(expected_jobs - completed), selected_types=sorted(shapes), + pending_main_entries=[] if direct else sorted(expected_jobs - completed), selected_types=sorted(shapes), + result_mode='direct' if direct else 'bundle', sources=sources, details=details, rows=all_rows) write_json(output / 'inference-difficulty.json', payload) fields = ['entry', 'dataset', 'method', 'calibration', 'answer_filter', 'inference_graph', 'comparison_graph', diff --git a/benchmarks/cqa/tests/test_inference_difficulty.py b/benchmarks/cqa/tests/test_inference_difficulty.py index 834599f42..321f7f207 100644 --- a/benchmarks/cqa/tests/test_inference_difficulty.py +++ b/benchmarks/cqa/tests/test_inference_difficulty.py @@ -199,3 +199,14 @@ def test_export_fixed_test_reference_corrected_filters_and_pending_jobs(tmp_path assert all(r['answer_filter'] == 'corrected' for r in payload['rows']) with pytest.raises(ValueError, match='new report directory'): export_difficulty_reports(results, bundle, tmp_path / 'inputs', results / 'out') + # A direct evaluate run carries no bundle hash: refused by default, read with direct=True. + write_json(results / 'result.json', report | {'benchmark_run': {'entry': 'done', 'mode': 'direct'}}) + with pytest.raises(ValueError, match='frozen bundle'): + export_difficulty_reports(results, bundle, tmp_path / 'inputs', tmp_path / 'refused', entries=['done'], query_types=['2p']) + unbundled = export_difficulty_reports(results, bundle, tmp_path / 'inputs', tmp_path / 'direct', entries=['done'], + query_types=['2p'], direct=True) + assert unbundled['rows'] == payload['rows'] and unbundled['pending_main_entries'] == [] + assert (unbundled['result_mode'], payload['result_mode']) == ('direct', 'bundle') + with pytest.raises(ValueError, match='a direct run'): + export_difficulty_reports(results, bundle, tmp_path / 'inputs', tmp_path / 'none', entries=['excluded'], query_types=['2p'], + direct=True) From 35aa1c0c5a7b0b9a08469c00d824a259484a14dd Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 29 Oct 2026 18:03:12 +0100 Subject: [PATCH 36/39] fix(models): run the KG-ICL and kernel tests on Triton 3.1 setup.py allows torch>=2.5.1, which ships Triton 3.1. Two Triton 3.1 limits broke tests there: - The first KG-ICL GRU layer multiplied the constant zero state in three tf32x3 dots. Triton 3.1 aborts the whole process on such a dot ("DotOperandEncodingAttr non-NvidiaMmaEncodingAttr parent not supported yet"). The state is zero, so the first layer now adds only the hidden biases. On Triton 3.7 the outputs are bitwise equal to the old kernel, and the first layer runs 4 dots instead of 7. - The oracle kernels in tests/test_inference_kernels.py imported tl inside a helper function. Triton 3.1 looks up kernel names only in the module globals, so the imports move to module level. (cherry picked from commit eb030f0315854122f39c79aca870f47274029f38) --- dicee/models/_triton_kgicl.py | 26 ++++++++++++++++++++++---- tests/test_inference_kernels.py | 14 +++++++++----- 2 files changed, 31 insertions(+), 9 deletions(-) diff --git a/dicee/models/_triton_kgicl.py b/dicee/models/_triton_kgicl.py index 43dbaa81a..b32e123ab 100644 --- a/dicee/models/_triton_kgicl.py +++ b/dicee/models/_triton_kgicl.py @@ -151,11 +151,29 @@ def _matrix(W, rows, columns, R: tl.constexpr, C: tl.constexpr): return tl.load(W + columns[None, :] * C + rows[:, None], (rows[:, None] < C) & (columns[None, :] < R), other=0) +@triton.jit +def _bias(B, index: tl.constexpr, feature, D: tl.constexpr): + # b[index * D:(index + 1) * D] as one [1, FEATURES] row; padding is zero. + return tl.load(B + index * D + feature, feature < D, other=0)[None, :] + + @triton.jit def _gate(x, W, B, index: tl.constexpr, feature, D: tl.constexpr, PRECISION: tl.constexpr): # One GRU gate block: x @ W[index * D:(index + 1) * D].T + b[index * D:(index + 1) * D]. value = tl.dot(x, _matrix(W + index * D * D, feature, feature, D, D), input_precision=PRECISION) - return value + tl.load(B + index * D + feature, feature < D, other=0)[None, :] + return value + _bias(B, index, feature, D) + + +@triton.jit +def _hidden(h, W, B, index: tl.constexpr, feature, D: tl.constexpr, FIRST: tl.constexpr, PRECISION: tl.constexpr): + # The hidden block W_hh h + b_hh of one GRU gate. The first layer's state is zero, so the product is + # exactly zero and only the bias remains. Skipping that dot also avoids a Triton 3.1 compiler abort + # ("DotOperandEncodingAttr non-NvidiaMmaEncodingAttr parent") on tf32x3 dots of a constant zero tensor. + if FIRST: + value = _bias(B, index, feature, D) + else: + value = _gate(h, W, B, index, feature, D, PRECISION) + return value @triton.jit @@ -187,10 +205,10 @@ def _update(AGG, H, NEW, OUT, SCORE, WH, LNW, LNB, WIH, WHH, BIH, BHH, WF, TOTAL norm_weight = tl.load(LNW + feature, feature < D, other=0) norm_bias = tl.load(LNB + feature, feature < D, other=0) y = centered * tl.rsqrt(variance + EPS)[:, None] * norm_weight[None, :] + norm_bias[None, :] - reset = tl.sigmoid(_gate(y, WIH, BIH, 0, feature, D, PRECISION) + _gate(previous, WHH, BHH, 0, feature, D, PRECISION)) - update = tl.sigmoid(_gate(y, WIH, BIH, 1, feature, D, PRECISION) + _gate(previous, WHH, BHH, 1, feature, D, PRECISION)) + reset = tl.sigmoid(_gate(y, WIH, BIH, 0, feature, D, PRECISION) + _hidden(previous, WHH, BHH, 0, feature, D, FIRST, PRECISION)) + update = tl.sigmoid(_gate(y, WIH, BIH, 1, feature, D, PRECISION) + _hidden(previous, WHH, BHH, 1, feature, D, FIRST, PRECISION)) candidate = libdevice.tanh(_gate(y, WIH, BIH, 2, feature, D, PRECISION) - + reset * _gate(previous, WHH, BHH, 2, feature, D, PRECISION)) + + reset * _hidden(previous, WHH, BHH, 2, feature, D, FIRST, PRECISION)) state = (1 - update) * candidate + update * previous state = tl.where(active[:, None] & (feature[None, :] < D), state, 0.) if LAST: diff --git a/tests/test_inference_kernels.py b/tests/test_inference_kernels.py index d445d3232..5b257af12 100644 --- a/tests/test_inference_kernels.py +++ b/tests/test_inference_kernels.py @@ -9,6 +9,15 @@ from dicee.models._inference import cached_relation_batch, float32_precision_backends from dicee.query_answering.engine import AtomicBatchCache, AtomicScorer +# Module-level imports: Triton 3.1 resolves the names in a kernel from module globals only, not from an +# enclosing function, so the oracle kernels below fail with NameError('tl is not defined') otherwise. +try: + import triton + import triton.language as tl + from triton.language.extra.cuda import libdevice +except ImportError: # CPU-only installs: every Triton test calls pytest.importorskip('triton'). + triton = tl = libdevice = None + CUDA = pytest.mark.skipif(not torch.cuda.is_available(), reason='CUDA unavailable') DEVICES = ['cpu', pytest.param('cuda', marks=CUDA)] @@ -120,8 +129,6 @@ def test_one_warp_ordered_aggregation_is_bitwise_equal_to_four_warps(dim, reduct def _single_pass_rows(): """The previous one-program-per-row kernel, retained as the bitwise oracle.""" - import triton - import triton.language as tl @triton.jit def rows(S, R, B, O, PTR, SRC, TYPE, @@ -192,9 +199,6 @@ def test_hub_split_rows_are_bitwise_equal_to_single_pass_rows(batch, dim, dtype) def _sequential_ordered(): """The previous one-edge-per-iteration ordered kernel, retained as the bitwise oracle.""" - import triton - import triton.language as tl - from triton.language.extra.cuda import libdevice @triton.jit def reduce(S, R, O, PTR, SRC, REL, From 9482ab1d4273ec0c4793d09e4536c3215c2129fc Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 29 Oct 2026 18:18:21 +0100 Subject: [PATCH 37/39] test: compare the fused Flock path with IEEE float32 cuDNN test_flock_fused_fixed_walks_match_official_checkpoint failed on every CUDA setup (torch 2.5.1 on an RTX 4070 Ti SUPER, torch 2.9.1 on an H100 NVL) by about 1e-3. The reference scores are IEEE float32 runs of the official Flock code on the CPU. Flock's GRU runs in cuDNN, which uses TF32 by default, and torch.set_float32_matmul_precision does not change that. The autouse fixture now also turns off TF32 in cuDNN (convolutions and RNNs), as the KGFM benchmark runners do, and restores the settings after each test. On PyTorch with per-backend precision, it reads the cuDNN precision objects from the class, because an imported torch.backends.cudnn.rnn submodule hides the module attribute. With IEEE cuDNN the largest differences are 6e-6 (entity) and 2e-6 (relation). The module passes (32 tests) with torch 2.5.1 and 2.9.1. (cherry picked from commit 983275aef0b6cd63ecb136f59ee253a07dfed938) --- tests/test_kgfm_next_inference.py | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/tests/test_kgfm_next_inference.py b/tests/test_kgfm_next_inference.py index a75a27eec..97340d9f2 100644 --- a/tests/test_kgfm_next_inference.py +++ b/tests/test_kgfm_next_inference.py @@ -13,15 +13,46 @@ FACTS = torch.tensor([[0, 0, 1], [0, 0, 2], [1, 1, 2], [2, 0, 3], [3, 1, 0]]) +def ieee_cudnn(): + """Turn off TF32 in cuDNN, as the KGFM benchmark runners do, and return a function that restores the settings. + + The reference fixtures are IEEE float32 CPU runs. cuDNN uses TF32 by default, also for Flock's GRU, and + ``torch.set_float32_matmul_precision`` does not change that: the Flock scores then differ by about 1e-3. + The precision objects come from the class: after ``torch.backends.cudnn.rnn`` is imported, the module + attribute of that name is the submodule (see ``dicee.models._inference.float32_precision_backends``). + The legacy ``allow_tf32`` is not read on this path, because PyTorch rejects a mix of the two APIs. + """ + cudnn = type(torch.backends.cudnn) + backends = [backend for backend in (getattr(cudnn, 'conv', None), getattr(cudnn, 'rnn', None)) + if hasattr(backend, 'fp32_precision')] + if backends: + previous = [backend.fp32_precision for backend in backends] + for backend in backends: + backend.fp32_precision = 'ieee' + + def restore(): + for backend, value in zip(backends, previous): + backend.fp32_precision = value + return restore + previous = torch.backends.cudnn.allow_tf32 + torch.backends.cudnn.allow_tf32 = False + + def restore(): + torch.backends.cudnn.allow_tf32 = previous + return restore + + @pytest.fixture(autouse=True) def small_thread_pool(): previous = torch.get_num_threads() previous_precision = torch.get_float32_matmul_precision() torch.set_float32_matmul_precision('highest') + restore_cudnn = ieee_cudnn() try: torch.set_num_threads(2) yield finally: + restore_cudnn() torch.set_num_threads(previous) torch.set_float32_matmul_precision(previous_precision) From 9901dcc5e0fb050d448d00c78286ea5b3aa83098 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Thu, 29 Oct 2026 20:44:16 +0100 Subject: [PATCH 38/39] fix: route the split files of dataset_dir by file name ReadFromDisk chose the split of each file in dataset_dir with a substring test on the full path. A parent folder whose name contains "train", "valid" or "test" misrouted the files. Under a pytest temporary folder (/tmp/pytest-of-/...), valid.txt became the test set and raw_valid_set stayed unset. The reader now tests the file name only, as the research checkout on kiowl does. The new test fails with the old rule and passes with the new one. UMLS loads the same rows as before. --- .../read_from_disk.py | 10 +++-- tests/test_read_from_disk_splits.py | 38 +++++++++++++++++++ 2 files changed, 45 insertions(+), 3 deletions(-) create mode 100644 tests/test_read_from_disk_splits.py diff --git a/dicee/read_preprocess_save_load_kg/read_from_disk.py b/dicee/read_preprocess_save_load_kg/read_from_disk.py index 1a9fee2bb..7168e2e4a 100644 --- a/dicee/read_preprocess_save_load_kg/read_from_disk.py +++ b/dicee/read_preprocess_save_load_kg/read_from_disk.py @@ -1,5 +1,6 @@ import glob import logging +from pathlib import Path import numpy as np import pandas as pd @@ -50,15 +51,18 @@ def start(self) -> None: self.kg.raw_test_set = None elif self.kg.dataset_dir: for i in glob.glob(self.kg.dataset_dir + '/*'): - if 'train' in i: + # Route by the file name only: a parent folder named like "pytest-..." or "train-..." must not + # decide the split. + name = Path(i).name + if 'train' in name: self.kg.raw_train_set = read_from_disk(i, self.kg.read_only_few, self.kg.sample_triples_ratio, backend=self.kg.backend, separator=self.kg.separator) if self.kg.add_noise_rate: self.add_noisy_triples_into_training() - elif 'test' in i and self.kg.eval_model is not None: + elif 'test' in name and self.kg.eval_model is not None: self.kg.raw_test_set = read_from_disk(i, backend=self.kg.backend, separator=self.kg.separator) - elif 'valid' in i and self.kg.eval_model is not None: + elif 'valid' in name and self.kg.eval_model is not None: self.kg.raw_valid_set = read_from_disk(i, backend=self.kg.backend, separator=self.kg.separator) else: logger.warning(f'Not processed data: {i}') diff --git a/tests/test_read_from_disk_splits.py b/tests/test_read_from_disk_splits.py new file mode 100644 index 000000000..887e8dc37 --- /dev/null +++ b/tests/test_read_from_disk_splits.py @@ -0,0 +1,38 @@ +"""ReadFromDisk routes the split files of a dataset folder by their file names.""" + +from types import SimpleNamespace + +import pytest + +from dicee.read_preprocess_save_load_kg.read_from_disk import ReadFromDisk + +TRAIN = [('a', 'r', 'b'), ('b', 'r', 'c')] +VALID = [('a', 'r', 'c')] +TEST = [('c', 'r', 'a')] + + +def _write(path, triples) -> None: + path.write_text(''.join(f'{head}\t{relation}\t{tail}\n' for head, relation, tail in triples)) + + +def _rows(frame) -> list: + return [tuple(row) for row in frame.values.tolist()] + + +@pytest.mark.parametrize('folder', ['train-valid-test-kg', 'test', 'valid']) +def test_split_files_are_routed_by_file_name(tmp_path, folder): + """A folder name that contains a split word must not decide the split of its files.""" + dataset = tmp_path / folder + dataset.mkdir() + _write(dataset / 'train.txt', TRAIN) + _write(dataset / 'valid.txt', VALID) + _write(dataset / 'test.txt', TEST) + kg = SimpleNamespace(path_single_kg=None, sparql_endpoint=None, dataset_dir=str(dataset), read_only_few=None, + sample_triples_ratio=None, backend='pandas', separator=r'\s+', add_noise_rate=None, + eval_model='train_val_test') + + ReadFromDisk(kg).start() + + assert _rows(kg.raw_train_set) == TRAIN + assert _rows(kg.raw_valid_set) == VALID + assert _rows(kg.raw_test_set) == TEST From e40dd5edf9895a5c79cefd2bd7fdad5fea20da41 Mon Sep 17 00:00:00 2001 From: Luke Friedrichs Date: Fri, 30 Oct 2026 08:50:36 +0100 Subject: [PATCH 39/39] test: restore the kernel tests' precision settings without monkeypatch Since pytest 9.2, monkeypatch.setattr records the old value of an attribute without a data descriptor and restores it with delattr. The precision objects of PyTorch (for example _FP32Precision) serve fp32_precision through __getattr__ and __setattr__. So the undo of the autouse fixture in tests/test_inference_kernels.py raised AttributeError at teardown and stopped CI. The fixture now saves each setting, sets IEEE precision and restores the settings in a finally block, as 98b3ae70 does for the KGFM cache test. Checked with pytest 9.2.0 and torch 2.14.1 (6 passed, 51 skipped on the CPU, settings restored) and with pytest 8.3.4 and torch 2.5.1. --- tests/test_inference_kernels.py | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/tests/test_inference_kernels.py b/tests/test_inference_kernels.py index 5b257af12..bc0942584 100644 --- a/tests/test_inference_kernels.py +++ b/tests/test_inference_kernels.py @@ -33,13 +33,20 @@ def forward_k_vs_all(self, pairs): @pytest.fixture(autouse=True) -def execution_settings(monkeypatch): +def execution_settings(): previous = torch.get_num_threads() + # Not monkeypatch: since pytest 9.2 its undo calls delattr on objects without a data descriptor, and the + # precision objects of PyTorch serve fp32_precision through __getattr__/__setattr__. + saved = [(backend, backend.fp32_precision) for backend in float32_precision_backends()] torch.set_num_threads(2) - for backend in float32_precision_backends(): - monkeypatch.setattr(backend, 'fp32_precision', 'ieee') - yield - torch.set_num_threads(previous) + try: + for backend, _ in saved: + backend.fp32_precision = 'ieee' + yield + finally: + for backend, precision in reversed(saved): + backend.fp32_precision = precision + torch.set_num_threads(previous) @pytest.mark.parametrize('device', DEVICES)