Skip to content

MJAHMADEE/Conditional_DCGAN

Repository files navigation

Conditional Deep Convolutional Generative Adversarial Network (Conditional DCGAN)

Python PyTorch License

This project implements a Conditional DCGAN using PyTorch to generate synthetic images conditioned on class labels. The implementation is tested on the BreastMNIST dataset, part of the MedMNIST collection.

Features 🌟

  • Uses Conditional GAN architecture to generate images conditioned on class labels.
  • Efficient training with GPU acceleration.
  • Integration with MedMNIST for medical image synthesis.
  • Visualization of generated images and training loss metrics.
  • Customizable training parameters and model architecture.

Setup and Installation 🛠️

  1. Clone the repository from GitHub.
  2. Navigate to the project directory.
  3. Install the required dependencies listed in the requirements.txt file.

Dataset 📁

The project uses the BreastMNIST dataset, which is a subset of the MedMNIST collection. This dataset comprises mammography images labeled as normal or abnormal.

Training the Model 🚀

Execute the training script to start the training process. The script trains both the generator and discriminator, displaying the loss for each epoch and saving model checkpoints.

Generating Images 🧪

After training, use the generator model to synthesize new images conditioned on specific class labels. This demonstrates the model's ability to generate diverse and realistic images based on the learned data distribution.

Results and Evaluation 📊

The generated images can be evaluated qualitatively by visual inspection and compared with real images to assess the generative model's performance.

License 📜

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements 🙌

  • Thanks to the creators of the MedMNIST dataset for providing the medical images used in training and testing the model.

For more information and to contribute, please refer to the official repository.

Releases

No releases published

Packages

No packages published

Languages