CoolFace
Modelpublic

veyselozdemir/nnUNet-Breast-Cancer-Ultrasound

sourceHugging Facemitupdated 2y agoView on Hugging Face
1likes
Model Card

๐ŸŽ—๏ธ nnU-Net Model for Breast Ultrasound Segmentation

This repository contains a trained nnU-Net v2 model for breast ultrasound segmentation. The model was trained using a custom dataset following the nnU-Net v2 pipeline and is now available for inference and further fine-tuning. For more information about the dataset, visit the repository.

๐Ÿ“Œ Model Details

  • โ€”Framework: nnU-Net v2
  • โ€”Task: 2D Medical Image Segmentation
  • โ€”Dataset: Breast Ultrasound Dataset (Dataset ID: 101)
  • โ€”Training Folds: All folds
  • โ€”Training Epochs: 10 (nnUNetTrainer_10epochs)
  • โ€”Trainer Configuration: 2d
  • โ€”Checkpoints: checkpoint_final.pth

๐Ÿ“ Folder Structure

bash
nnUNet_results/
โ””โ”€โ”€ Dataset101_Breast/
    โ””โ”€โ”€ nnUNetTrainer_10epochs__nnUNetPlans__2d/
        โ”œโ”€โ”€ fold_all/
        โ”‚   โ””โ”€โ”€ checkpoint_final.pth  # Trained model weights
        โ”œโ”€โ”€ dataset.json  # Trained dataset metadata
        โ””โ”€โ”€ plans.json  # Preprocessing and training plans

๐Ÿš€ How to Use This Model

  1. 1.Ensure you have nnU-Net v2 installed and configured all the essentials to run the framework. For more information, see the documentation.
  2. 2.Add the nnUNet_results folder to the root of your project as it is.
  3. 3.Open the terminal, ensure that the directory is at the root of the project, and run the following inference command.
bash
   nnUNetv2_predict -i path/to/your/images \
                 -o path/to/your/output/folder \
                 -d 101 -c 2d -f all -tr nnUNetTrainer_10epochs

  โš ๏ธ If you run this on a Mac, add -device mps in the inference command to leverage the GPU.


๐Ÿ‘ฅ Contact

For questions or collaboration, reach out at:

  • โ€”Email: ozdemirsoftware.dev@gmail.com
  • โ€”GitHub: veysel-ozdemir