Skip to main content

intraoralphoto-classifier

This repository provides a deep learning system for classifying intraoral dental photographs into five standard orthodontic viewpoints:

  • center
  • up (upper occlusal)
  • down (lower occlusal)
  • left
  • right

The project evaluates preprocessing, data augmentation strategies, multiple image resolutions, and two versions of ResNet-18 (pretrained and trained from scratch).

1. Installation

Install from PyPi:

pip install intraoralphoto-classifier

Install from source:

git clone https://github.com/AImageLab-zip/intraoralphoto-classifier
cd intraoralphoto-classifier
pip install -e .

The framework automatically uses GPU if available; otherwise CPU is used.

2. Inference

from intraoralphoto_classifier.config import get_device
from intraoralphoto_classifier.infer import run_inference

run_inference(
    patient_dir="<path_to_patient_folder>",
    model_path="<best_model.pth>",
    output_dir="<results_folder>",
    device=get_device(),
)

3. Model Weights or Checkpoints

Download the model Here: https://drive.google.com/drive/u/0/folders/1LM9fIciXma-2ak9nyRqOzRrinzIH7K0S

Metadata

Release files for intraoralphoto-classifier 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for intraoralphoto-classifier 0.1.1
File Size Uploaded
intraoralphoto_classifier-0.1.1.tar.gz 7.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for intraoralphoto-classifier 0.1.1
File Interpreter ABI Platform
intraoralphoto_classifier-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 16.6 kB

Release files / intraoralphoto_classifier-0.1.1.tar.gz

Download URL intraoralphoto_classifier-0.1.1.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
136453dbbcf065e72df6d248fa4d673e40f03c12e0ea78e357c0321ec08896b5
BLAKE2b-256 checksum
How to use checksums
25be42b92a370b97740f2711a04b382988757c8bcf7eda183232bf51de64c7aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.11

Release files / intraoralphoto_classifier-0.1.1-py3-none-any.whl

Download URL intraoralphoto_classifier-0.1.1-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1427d9cd7d4fa6087d4d2b5605753513891131ad5113aa288a15230f7e06ce62
BLAKE2b-256 checksum
How to use checksums
46d596342e50d8fb68559f50e3329d6260a8d0b2d1f8fde98bdbec9dab476fab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.11

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page