johko's picture
updated README
7557692
---
library_name: keras
tags:
- semi-supervised
- image classification
- domain adaption
datasets:
- MNIST
- SVHN
---
## Model description
This is an image classification model based on a [WideResNet-2-28](https://arxiv.org/abs/1605.07146v4), trained using the [AdaMatch](https://arxiv.org/abs/2106.04732) method by Berthelot et al.
The training was based on the example [Semi-supervision and domain adaptation with AdaMatch]('https://keras.io/examples/vision/adamatch/') on keras.io by [Sayak Paul](https://twitter.com/RisingSayak).
The main difference to the training in the keras.io example is that here I increased the number of Epochs to 30, for a better target dataset performance.
## Intended uses & limitations
AdaMatch attempts to combine *semi-supervised learning*, i.e. learning with a partially labelled dataset and *unsupersived domain adaption*, i.e. adapting a model to a different domain dataset without any labels.
So it actually performs **semi-supervised domain adaptation (SSDA)**.
The model is inteded to show that AdaMatch is able to carry out SSDA, with a accuracy on the target domain (SVHN) that is exceeding or competitive with other methods.
### Limitations
The model was trained on MNIST as source and SVHN as target dataset. Thus, the classification performance on MNIST is very good (98.46%), while the accuracy on SVHN is "only" at 26.51%. Compared to the training of the same architecture without AdaMatch, this still is about 17% better
## Training and evaluation data
### Training Data
The model was trained using the [MNIST](https://huggingface.co/datasets/mnist) (as source domain) and [SVHN cropped](http://ufldl.stanford.edu/housenumbers/) (as target domain) datasets. For training the images were used at a resolution of (32,32,3).
Augmented versions of the source and target data were created in two versions - weakly and strongly augmented, as written in the original paper.
### Training Procedure
This image from the original paper shows the workflow of AdaMatch:
![](https://i.imgur.com/1QsEm2M.png)
For more information, refer to the [paper](https://arxiv.org/abs/2106.04732) or the original example at [keras.io]('https://keras.io/examples/vision/adamatch/').
### Hyperparameters
The following hyperparameters were used during training:
- Epochs: 30
- Source Batch Size: 64
- Target Batch Size: 3 * 64
- Learning Rate: 0.03
- Weight Decay: 0.0005
- Network Depth: 28
- Network Width Multiplier = 2
## Evaluation
Accuracy on **source** test set: **98.46%**
Accuracy on **target** test set: **26.51%**