similarity-learning 0.0.1

A fastai based framework for similarity learning

similarity-learning

Docs

See https://irad-zehavi.github.io/similarity-learning/

Install

pip install similarity_learning

How to use

As an nbdev library, similarity_learning supports import * (without importing unwanted symbols):

from similarity_learning.all import *

Now we can train a pair-matcher. First let’s construct dataloaders of pairs:

from fastai.vision.all import *

from fastai_datasets.all import *

pairs = Pairs(Imagenette(160), .1)
dls = pairs.dls(after_item=Resize(128),
                after_batch=Normalize.from_stats(*imagenet_stats))

<div>
  <progress value='196' class='' max='196' style='width:300px; height:20px; vertical-align: middle;'></progress>
  100.00% [196/196 00:00&lt;00:00]
</div>

To get quick results, we can use the body of a pretrained model as a backbone for our Siamese neural network:

classifier = resnet34(weights=ResNet34_Weights.DEFAULT)
siamese = ThresholdSiamese(create_body(model=classifier, cut=-1)).to(dls.device)
siamese.fit_threshold(dls.train)

<div>
  <progress value='14' class='' max='14' style='width:300px; height:20px; vertical-align: middle;'></progress>
  100.00% [14/14 00:04&lt;00:00]
</div>


(0.9800000190734863, 0.8493303656578064)

Let’s see how good it is:

learn = Learner(dls, siamese, metrics=accuracy)
learn.validate()

(#2) [0.5396265387535095,0.8622449040412903]

learn.show_results()

Not bad, but we can do better with finetuning:

learn.fit(5, 1e-4)
learn.validate()

(#2) [0.29371750354766846,0.9285714030265808]

learn.show_results()

We can also consider the distribution of feature-space distances compared to the decision threshold:

siamese.plot_distance_histogram(dls.valid)

<div>
  <progress value='7' class='' max='7' style='width:300px; height:20px; vertical-align: middle;'></progress>
  100.00% [7/7 00:01&lt;00:00]
</div>

See the rest of the docs for more examples, including more visualizations, comparison of loss functions, and facial recognition.