Instructions to use irlvinicius/KaryoVisio with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- ultralytics
How to use irlvinicius/KaryoVisio with ultralytics:
from huggingface_hub import hf_hub_download from ultralytics import YOLO # pick the weights file from this repo's "Files and versions" tab weights = hf_hub_download("irlvinicius/KaryoVisio", "<weights>.pt") model = YOLO(weights) source = 'http://images.cocodataset.org/val2017/000000039769.jpg' model.predict(source=source, save=True) - Notebooks
- Google Colab
- Kaggle
KaryoVisio
This repository contains deep learning models developed for chromosome detection and classification as part of the KaryoVisio project.
Models
YOLO26m β Object Detection
Original Dataset
A YOLO26m model trained on the original chromosome image dataset, without specimen preprocessing.
- Model weights:
best.ptandbest.onnx.
Preprocessed Dataset
A YOLO26m model trained using the dataset after specimen preprocessing.
- Model checkpoints:
best.ptandlast.pt. - Training configuration, metrics, and evaluation visualizations are included.
Cross-Validation β yolo26m-cv
A YOLO26m model evaluated using 5-fold cross-validation on the chromosome image dataset.
Each fold contains model checkpoints, training configuration, evaluation metrics, plots, confusion matrices, and training/validation visualizations. Separate test evaluation artifacts are also available for each fold.
Cross-validation results
Mean performance across the five folds, reported as mean Β± standard deviation:
| Metric | Mean Β± Std. Dev. |
|---|---|
| Precision | 98.928% Β± 0.022% |
| Recall | 98.869% Β± 0.071% |
| F1-score | 98.898% Β± 0.029% |
| mAP@50 | 99.387% Β± 0.008% |
| mAP@50β95 | 87.789% Β± 0.384% |
The cv_summary.csv file contains the individual fold results and aggregated statistics.
ResNet50 β Chromosome Classification
A ResNet50 model trained to classify chromosomes into their respective classes, including groups labeled A, B, C, D, and others, as well as the X and Y chromosomes.
The model was evaluated using 5-fold cross-validation. Each fold contains its own model weights, configuration, training history, and test predictions.
Cross-validation results
Mean performance across the five folds, reported as mean Β± standard deviation:
| Metric | Mean Β± Std. Dev. |
|---|---|
| Accuracy | 98.540% Β± 0.027% |
| Macro Precision | 98.489% Β± 0.036% |
| Macro Recall | 98.424% Β± 0.067% |
| Macro F1-score | 98.455% Β± 0.051% |
| Macro AUC | 99.966% Β± 0.002% |
The cv_summary.csv file contains the aggregated cross-validation results. Each fold also includes checkpoints, training history, configuration, test labels, and predicted probabilities.
Dataset
The models were trained using the chromosome image dataset described in the following publication:
A large-scale dataset of chromosome images for machine learning applications
Read the dataset publication β Nature Scientific Data
Repository Structure
models/
βββ resnet50-paper-cv/
β βββ cv_summary.csv
β βββ fold0/
β βββ fold1/
β βββ fold2/
β βββ fold3/
β βββ fold4/
βββ yolo26m-cv/
β βββ cv_summary.csv
β βββ fold0/
β βββ fold0-test/
β βββ fold1/
β βββ fold1-test/
β βββ fold2/
β βββ fold2-test/
β βββ fold3/
β βββ fold3-test/
β βββ fold4/
β βββ fold4-test/
βββ yolo26m-original/
β βββ model/
β βββ best.pt
β βββ best.onnx
βββ yolo26m-preprocessed/
βββ model/
β βββ best.pt
β βββ last.pt
βββ training/
The cross-validation directories preserve fold-specific model checkpoints and experimental artifacts to support reproducibility and further analysis.
Purpose
This repository provides versioned storage for trained models and their associated experimental artifacts, supporting reproducibility and the evaluation of chromosome detection and classification approaches.
- Downloads last month
- 839