# eitiyamamoto/full-triple-matcher architecture

> Architecture diagram of the GitHub repository eitiyamamoto/full-triple-matcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eitiyamamoto/full-triple-matcher
- Repository: https://github.com/eitiyamamoto/full-triple-matcher

## Overview

Full-Triple-Matcher is a research project for integrating general-purpose and domain-specific knowledge graphs through entity and schema alignment. The documented workflow computes functionality and inverse functionality, runs the early-stop FTM matcher, and evaluates matches; triple matching can also be run separately from entity pairs. The README also describes experimental evaluation and broader alignment methods. Source excerpts cover only graph similarity helpers, so most workflow relationships below are based on explicit README statements, not inspected notebook internals.

Main entry points: [`codes/entity-matching/FTM - early stop.ipynb`](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20early%20stop.ipynb) (Early-Stop FTM), [`results`](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/results) (Matcher Results), [`codes/entity-matching/FTM - Calculate inverse functionality.ipynb`](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20Calculate%20inverse%20functionality.ipynb) (Functionality Metrics), [`codes/entity-matching/Analyze paris and ftm matches.ipynb`](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/Analyze%20paris%20and%20ftm%20matches.ipynb) (Match Metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_matching["Entity Matching"]
  node_functionality["Functionality Metrics"]
  node_ftm["Early-Stop FTM"]
  node_alignment["Entity and Schema Alignment"]
  node_similarity["Graph Similarity"]
end

subgraph group_analysis["Evaluation"]
  node_topn["Top-N Analysis"]
  node_match_eval["Match Metrics"]
end

subgraph group_triples["Triple Matching"]
  node_triple_similarity["Triple Similarity"]
  node_triple_gold["Triple Gold Standards"]
end

subgraph group_resources["Data and Results"]
  node_kg_data[("KGs and Seeds")]
  node_entity_gold[("Entity Gold Standards")]
  node_triple_data[("Triple Data")]
  node_outputs[("Matcher Results")]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_functionality
node_functionality -->|"precomputes metrics"| node_ftm
node_researcher -->|"runs"| node_ftm
node_kg_data -->|"provides KGs"| node_functionality
node_kg_data -->|"provides KGs"| node_ftm
node_ftm -->|"writes matches"| node_outputs
node_researcher -->|"runs"| node_topn
node_researcher -->|"runs"| node_match_eval
node_outputs -->|"evaluates matches"| node_topn
node_outputs -->|"evaluates matches"| node_match_eval
node_entity_gold -->|"supplies gold standards"| node_match_eval
node_researcher -->|"runs optionally"| node_triple_similarity
node_outputs -->|"provides entity pairs"| node_triple_similarity
node_triple_data -.->|"provides triples"| node_triple_similarity
node_researcher -.->|"creates standards"| node_triple_gold
node_similarity -.->|"supports comparison"| node_ftm
node_researcher -->|"uses alignment methods"| node_alignment

click node_functionality "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20Calculate%20inverse%20functionality.ipynb"
click node_ftm "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20early%20stop.ipynb"
click node_alignment "https://github.com/eitiyamamoto/full-triple-matcher/tree/main/codes/entity-matching"
click node_similarity "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/graph_similarity.py"
click node_topn "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/Analyzing%20top%40n.ipynb"
click node_match_eval "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/Analyze%20paris%20and%20ftm%20matches.ipynb"
click node_triple_similarity "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/triple-matching/Calculate%20triple%20similarity.ipynb"
click node_triple_gold "https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/triple-matching/Creating%20gold%20standard.ipynb"
click node_kg_data "https://github.com/eitiyamamoto/full-triple-matcher/tree/main/dataset/entity-matching"
click node_entity_gold "https://github.com/eitiyamamoto/full-triple-matcher/tree/main/dataset/entity-matching"
click node_triple_data "https://github.com/eitiyamamoto/full-triple-matcher/tree/main/codes/triple-matching"
click node_outputs "https://github.com/eitiyamamoto/full-triple-matcher/tree/main/results"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_functionality,node_ftm,node_alignment,node_similarity toneBlue
class node_topn,node_match_eval toneAmber
class node_triple_similarity,node_triple_gold toneMint
class node_kg_data,node_entity_gold,node_triple_data,node_outputs toneRose
class node_researcher toneIndigo
```

## Components

### Entity Matching

- [Functionality Metrics](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20Calculate%20inverse%20functionality.ipynb): `codes/entity-matching/FTM - Calculate inverse functionality.ipynb`
- [Early-Stop FTM](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/FTM%20-%20early%20stop.ipynb): `codes/entity-matching/FTM - early stop.ipynb`
- [Entity and Schema Alignment](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/codes/entity-matching): `codes/entity-matching`
- [Graph Similarity](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/graph_similarity.py): `codes/entity-matching/graph_similarity.py`

### Evaluation

- [Top-N Analysis](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/Analyzing%20top%40n.ipynb): `codes/entity-matching/Analyzing top@n.ipynb`
- [Match Metrics](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/entity-matching/Analyze%20paris%20and%20ftm%20matches.ipynb): `codes/entity-matching/Analyze paris and ftm matches.ipynb`

### Triple Matching

- [Triple Similarity](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/triple-matching/Calculate%20triple%20similarity.ipynb): `codes/triple-matching/Calculate triple similarity.ipynb`
- [Triple Gold Standards](https://github.com/eitiyamamoto/full-triple-matcher/blob/main/codes/triple-matching/Creating%20gold%20standard.ipynb): `codes/triple-matching/Creating gold standard.ipynb`

### Data and Results

- [KGs and Seeds](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/dataset/entity-matching): `dataset/entity-matching`
- [Entity Gold Standards](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/dataset/entity-matching): `dataset/entity-matching`
- [Triple Data](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/codes/triple-matching): `codes/triple-matching`
- [Matcher Results](https://github.com/eitiyamamoto/full-triple-matcher/tree/main/results): `results`

### Other components

- **Researcher**

## Connections

- Researcher → Functionality Metrics: runs (evidence: `README.md`)
- Functionality Metrics → Early-Stop FTM: precomputes metrics (evidence: `README.md`)
- Researcher → Early-Stop FTM: runs (evidence: `README.md`)
- KGs and Seeds → Functionality Metrics: provides KGs (evidence: `README.md`)
- KGs and Seeds → Early-Stop FTM: provides KGs (evidence: `README.md`)
- Early-Stop FTM → Matcher Results: writes matches (evidence: `README.md`)
- Researcher → Top-N Analysis: runs (evidence: `README.md`)
- Researcher → Match Metrics: runs (evidence: `README.md`)
- Matcher Results → Top-N Analysis: evaluates matches (evidence: `README.md`)
- Matcher Results → Match Metrics: evaluates matches (evidence: `README.md`)
- Entity Gold Standards → Match Metrics: supplies gold standards (evidence: `README.md`)
- Researcher → Triple Similarity: runs optionally (evidence: `README.md`)
- Matcher Results → Triple Similarity: provides entity pairs (evidence: `README.md`)
- Triple Data → Triple Similarity: provides triples
- Researcher → Triple Gold Standards: creates standards
- Graph Similarity → Early-Stop FTM: supports comparison
- Researcher → Entity and Schema Alignment: uses alignment methods (evidence: `README.md`)
