Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Nov 19, 2015
Nov 19, 2015
Nov 19, 2015
Nov 19, 2015
Nov 19, 2015
Dec 4, 2016
Nov 19, 2015

Deep Embedded Clustering

This package implements the algorithm described in paper "Unsupervised Deep Embedding for Clustering Analysis". It depends on opencv, numpy, scipy and Caffe.

This implementation is intended for reproducing the results in the paper. If you only want to try the algorithm and find caffe too difficault to install, there is an easier to use experimental implementation in MXNet:, but note that results can be different from the paper. MXNet is a flexible deep learning library with fewer dependencies. You are welcome to try it. Installation guide can be found here: Once you install MXNet, simple go into directory examples/dec and run python


To run, please first build our custom version of Caffe included in this package following the official guide:

Then download the data set you want to experiment on. We provide scripts for downloading the datasets used in the paper. For example you can download MNIST by cd mnist; ./ Once download completes, run cd dec; python to prepare data for Caffe.

After data is ready, run python DB to run experiment on with DB. DB can be one of mnist, stl, reutersidf10k, reutersidf. We provide pretrained autoencoder weights with this package. You can use dec/ to train your own autoencoder. Please read source for usage info.


A Dockerfile has been provided to create a sterile development environment easily. To build the environment, run docker build --rm -t dec . and then docker run --rm -it dec bash to shell into the running container. Alternatively, nvidia-docker can be used to enable GPU capability.