# ibrahimethemhamamci/dentex architecture

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

- Interactive diagram: https://gitdiagram.com/ibrahimethemhamamci/dentex
- Repository: https://github.com/ibrahimethemhamamci/dentex

## Overview

This repository packages the DENTEX challenge evaluation entry point and two Dockerized HierarchicalDet algorithm phases. The main algorithm workflow configures and trains a hierarchical dental detector, then exposes prediction and evaluation; the intended result is abnormal-tooth boxes with quadrant, tooth-enumeration, and diagnosis labels. The README documents the three annotation levels and evaluation on fully labeled data. Source excerpts confirm detector/head/loss and COCO-style evaluation responsibilities; several training and inference connections are only indicated by the source index, so those links are marked unverified.

Main entry points: [`HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py`](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py) (Diffusion detector), [`HierarchialDet-FinalPhase-Docker/process.py`](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/process.py) (Training entry point), [`HierarchialDet-FinalPhase-Docker/hierarchialdet/predictor.py`](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/predictor.py) (Prediction API), [`HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py`](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py) (Hierarchical metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Algorithm workflow"]
  node_process["Training entry point<br/>[process.py]"]
  node_predictor["Prediction API<br/>[predictor.py]"]
  node_dataset[("Dental datasets<br/>[coco.py]")]
  node_mapper["Dataset mapping<br/>[dataset_mapper.py]"]
  node_loader["Data loading<br/>[loader.py]"]
  node_output["Dental findings"]
end

subgraph group_model["Detection model"]
  node_detector["Diffusion detector<br/>[detector.py]"]
  node_head["Detection head<br/>[head.py]"]
  node_loss["Training losses<br/>[loss.py]"]
  node_backbone["Swin backbone<br/>[swintransformer.py]"]
end

subgraph group_framework["Detectron2 services"]
  node_config["Model configuration<br/>[config.py]"]
  node_structures["Boxes and instances<br/>[boxes.py]"]
  node_training["Training loop<br/>[train_loop.py]"]
end

subgraph group_evaluation["Challenge evaluation"]
  node_metrics["Hierarchical metrics"]
  node_challenge_eval["Challenge evaluator<br/>[evaluation.py]"]
end

node_participant(("Algorithm participant"))

node_participant -.->|"starts training"| node_process
node_process -.->|"loads settings"| node_config
node_process -.->|"runs training"| node_training
node_process -->|"imports predictor"| node_predictor
node_process -.->|"configures datasets"| node_dataset
node_dataset -.->|"supplies records"| node_mapper
node_mapper -.->|"maps samples"| node_loader
node_loader -.->|"feeds batches"| node_training
node_training -.->|"invokes model"| node_detector
node_detector -->|"calls head"| node_head
node_detector -->|"computes loss"| node_loss
node_detector -.->|"builds backbone"| node_backbone
node_detector -->|"uses instances"| node_structures
node_predictor -.->|"runs inference"| node_detector
node_predictor -.->|"returns predictions"| node_output
node_participant -.->|"submits results"| node_challenge_eval
node_challenge_eval -.->|"scores predictions"| node_metrics
node_metrics -->|"reads annotations"| node_dataset
node_metrics -.->|"reports metrics"| node_output

click node_process "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/process.py"
click node_predictor "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/predictor.py"
click node_dataset "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/data/datasets/coco.py"
click node_mapper "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/dataset_mapper.py"
click node_loader "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/loader.py"
click node_config "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/config/config.py"
click node_detector "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py"
click node_head "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/head.py"
click node_loss "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/loss.py"
click node_backbone "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/swintransformer.py"
click node_structures "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/structures/boxes.py"
click node_training "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/engine/train_loop.py"
click node_metrics "https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py"
click node_challenge_eval "https://github.com/ibrahimethemhamamci/dentex/blob/main/DentexChallenge-AlgorithmPhases-Evaluation-Docker/evaluation.py"

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_process,node_predictor,node_dataset,node_mapper,node_loader,node_output toneBlue
class node_detector,node_head,node_loss,node_backbone toneAmber
class node_config,node_structures,node_training toneMint
class node_metrics,node_challenge_eval toneRose
class node_participant toneIndigo
```

## Components

### Algorithm workflow

- [Training entry point](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/process.py): `HierarchialDet-FinalPhase-Docker/process.py`
- [Prediction API](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/predictor.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/predictor.py`
- [Dental datasets](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/data/datasets/coco.py): `HierarchialDet-FinalPhase-Docker/detectron2/data/datasets/coco.py`
- [Dataset mapping](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/dataset_mapper.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/dataset_mapper.py`
- [Data loading](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/loader.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/loader.py`
- **Dental findings**

### Detection model

- [Diffusion detector](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py`
- [Detection head](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/head.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/head.py`
- [Training losses](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/loss.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/loss.py`
- [Swin backbone](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/swintransformer.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/swintransformer.py`

### Detectron2 services

- [Model configuration](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/config/config.py): `HierarchialDet-FinalPhase-Docker/detectron2/config/config.py`
- [Boxes and instances](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/structures/boxes.py): `HierarchialDet-FinalPhase-Docker/detectron2/structures/boxes.py`
- [Training loop](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/detectron2/engine/train_loop.py): `HierarchialDet-FinalPhase-Docker/detectron2/engine/train_loop.py`

### Challenge evaluation

- [Hierarchical metrics](https://github.com/ibrahimethemhamamci/dentex/blob/main/HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py): `HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py`
- [Challenge evaluator](https://github.com/ibrahimethemhamamci/dentex/blob/main/DentexChallenge-AlgorithmPhases-Evaluation-Docker/evaluation.py): `DentexChallenge-AlgorithmPhases-Evaluation-Docker/evaluation.py`

### Other components

- **Algorithm participant**

## Connections

- Algorithm participant → Training entry point: starts training
- Training entry point → Model configuration: loads settings
- Training entry point → Training loop: runs training
- Training entry point → Prediction API: imports predictor (evidence: `HierarchialDet-FinalPhase-Docker/process.py`)
- Training entry point → Dental datasets: configures datasets
- Dental datasets → Dataset mapping: supplies records
- Dataset mapping → Data loading: maps samples
- Data loading → Training loop: feeds batches
- Training loop → Diffusion detector: invokes model
- Diffusion detector → Detection head: calls head (evidence: `HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py`)
- Diffusion detector → Training losses: computes loss (evidence: `HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py`)
- Diffusion detector → Swin backbone: builds backbone
- Diffusion detector → Boxes and instances: uses instances (evidence: `HierarchialDet-FinalPhase-Docker/hierarchialdet/detector.py`)
- Prediction API → Diffusion detector: runs inference
- Prediction API → Dental findings: returns predictions
- Algorithm participant → Challenge evaluator: submits results
- Challenge evaluator → Hierarchical metrics: scores predictions
- Hierarchical metrics → Dental datasets: reads annotations (evidence: `HierarchialDet-FinalPhase-Docker/hierarchialdet/util/coco_3class_eval.py`)
- Hierarchical metrics → Dental findings: reports metrics
