Awesome

multilabel-MXNet

This is the implement of the multilabel image classificaton in MXNet. Multilabel means each image belong to 1 or more than 1 labels and it is different from multi task.

This implement doesn't need recompile MXNet and is very convenient for you to use. Firstly, I assume that you can use MXNet normally. Then, do as follows:

Data

If you are doing a single label image classification, your .lst file may like this(take 4 classes as example):

ID	label	image_name
5247	0.000000	image1.jpg
33986	1.000000	image2.jpg
39829	2.000000	image3.jpg
15647	3.000000	image4.jpg
10369	1.000000	image5.jpg
22408	3.000000	image6.jpg
2598	2.000000	image7.jpg

For multilabel image classification, you should create .lst file like multilabel-MXNet/data_example/train_data.lst (take 4 classes as example)

In this implement, we only use .lst and raw image as the input instead of .rec file.

Train

run_train.sh is the train script for you to start fine-tune quickly. You should open this script and change the path of train_multilabel.py, .lst file, imagefile and model-prefix after you clone the project.

Then run:

sh run_train.sh

More details

--num-classes 8 in run_train.sh means the maximum number of label is 8 classes. For example, iamge1 has label 1,5; image2 has label 1,2,3; image3 has label 1. You can change the number for your data.
In the train_multilabel.py, I use net = mx.symbol.sigmoid(data=net, name='sig') and net = mx.symbol.Custom(data=net,name='softmax', op_type='CrossEntropyLoss') instead of mx.symbol.softmaxOutput to deal with multilabel problem. sigmoid layer take the output of full connection as input and translate it into (0,1), which means the probability. CrossEntropy layer take the probability (0,1) as input and calculate the loss.