oxirs_embed/evaluation/
mod.rs

1//! Evaluation module for embeddings and knowledge graphs
2//!
3//! This module provides comprehensive evaluation tools and metrics for assessing
4//! the quality of embeddings and knowledge graph reasoning systems, including
5//! advanced ML techniques for uncertainty quantification, adversarial robustness,
6//! fairness assessment, and explanation quality evaluation.
7
8pub mod advanced_evaluation;
9pub mod query_evaluation;
10pub mod reasoning_evaluation;
11
12// Re-export commonly used types and functions, avoiding conflicts
13pub use advanced_evaluation::{
14    AdvancedEvaluationConfig, AdvancedEvaluationResults, AdvancedEvaluator,
15    AdversarialAttackGenerator, AdversarialResults, BasicMetrics, CrossDomainResults,
16    ExplanationQualityEvaluator, ExplanationResults, FairnessAssessment, FairnessResults,
17    TemporalResults, UncertaintyQuantifier, UncertaintyResults,
18};
19pub use query_evaluation::{
20    QueryAnsweringEvaluator, QueryEvaluationConfig, QueryEvaluationResults, QueryMetric,
21    QueryResult, QueryTemplate, QueryType, ReasoningStep as QueryReasoningStep,
22    TypeSpecificResults,
23};
24pub use reasoning_evaluation::{
25    ReasoningChain, ReasoningEvaluationConfig, ReasoningEvaluationResults, ReasoningRule,
26    ReasoningStep, ReasoningTaskEvaluator, ReasoningType,
27};
28
29// A/B testing framework
30pub mod ab_test;
31
32// Re-exports for A/B testing
33pub use ab_test::{
34    evaluate_hits_at_k, evaluate_link_prediction, evaluate_silhouette, AbTestResult, AbTestRunner,
35    EmbedMetric, ModelEvalResult, StatTest,
36};
37
38// Embedding quality metrics: link prediction, analogy, clustering
39pub mod embedding_metrics;
40
41pub use embedding_metrics::{
42    AnalogicalReasoningBenchmark, AnalogyQuad, EmbeddingClusteringMetrics, EmbeddingEvaluator,
43};
44
45// ── KGC evaluation framework (FB15k-237 / WN18RR style) ──────────────────
46
47/// Standard KGC evaluation metrics (MRR, Hits@K, Mean Rank, filtered variants).
48pub mod kgc_metrics;
49
50/// KGC dataset with train/valid/test splits and TSV loading.
51pub mod kgc_dataset;
52
53/// KGC evaluator and high-level evaluation suite.
54pub mod kgc_evaluator;
55
56// Flat re-exports for convenience.
57pub use kgc_dataset::{EvaluationTriple, KgcDataset};
58pub use kgc_evaluator::{EvalSplit, KgcEvaluationSuite, KgcEvaluator, KgcEvaluatorConfig};
59pub use kgc_metrics::{
60    compute_filtered_rank, hits_at_k, mean_rank, mean_reciprocal_rank, EvaluationMetrics,
61};
oxirs_embed/evaluation/mod.rs

oxirs_embed/evaluation/
mod.rs
