https://github.com/jonfryd/imageclustering

Content-Based Image File Renaming Tool
https://github.com/jonfryd/imageclustering

clustering computer-vision image-processing ml unsupervised-learning

Last synced: about 1 year ago
JSON representation

Content-Based Image File Renaming Tool

• Host: GitHub
• URL: https://github.com/jonfryd/imageclustering
• Owner: jonfryd
• License: mit
• Created: 2019-08-18T15:08:40.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-10-13T15:24:54.000Z (over 5 years ago)
• Last Synced: 2025-02-05T17:30:28.342Z (over 1 year ago)
• Topics: clustering, computer-vision, image-processing, ml, unsupervised-learning
• Language: Java
• Size: 5.58 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Java 5](https://img.shields.io/badge/Java-5-blue.svg)](http://www.oracle.com/technetwork/java/javase)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

# ImageClustering: Content-Based Image File Renaming Tool

This is a hobby project I did back in 2008-2009 based on Java Advanced Imaging API.

Its purpose is to take a directory of image files with any name and bring order to chaos

based on pattern recognition of the actual contents. The pipeline starts with image feature extraction techniques (DCT perceptual hash,

texture histograms, edge histograms, etc.), then calculate dissimilarity between those features and finally perform

classification using a fast implementation of a self-organizing map for clustering based on [research done at Inria](http://somlib.gforge.inria.fr/).

The code comes with a couple of nifty features such as multi-threaded processing and distributing work over the network

to different nodes. Also, it has a crude Swing UI:



Radius is a hyper-parameter that controls the size of each cluster. The default value is fine for the most part.

# Example

Here are 9 images named in sequence (```image1.jpg```, ```image2.jpg```, ..., ```image9.jpg```):



Obviously they can be grouped into four clusters of 2, 2, 2 and 3 images, respectively. After processing the directory

the files are renamed as follows:



... Voila!

# Building

Clone the repository and execute Maven from the root directory:

    $ git clone https://github.com/jonfryd/ImageClustering

    $ cd ImageClustering/

    $ mvn clean

    $ mvn install

# Usage

After building, run e.g. the UI as:

    $ ./runImageClustering.sh

This is for Linux or Mac OS X. For Windows run .bat-file:

    $ runImageClustering.bat

When the UI is launched, select the directory, enter the expected number of clusters and press 'Process'.

Images are then analyzed and renamed with a `C###_`-prefix denoting the cluster each image belongs to.

Happy renaming.

# Author

This application created by Jon Frydensbjerg - email: jonf@elixlogic.com