Skip to content

gitter-badger/duometer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Duometer - near-duplicate detection tool

Duometer allows to efficiently identify near-duplicate pairs of documents in large collections of texts. It is written in Scala and implements a MinHash algorithm.

For example, to extract text from all files in ~/text-files and identify those that have similar content, run:

./duometer -i ~/text-files -o text-files.duplicates

For more information about how to use duometer see this tutorial.

Features

  • Efficiently finds pairs of documents that contain similar text.
  • Automatically extracts text from files in a huge number of different formats (including HTML, PDF, Microsoft Office document formats and the OpenDocument format)
  • Works well with very large collections of documents.
  • Makes use of multiple CPU cores.
  • The default settings should work well in most cases but you can customize the duplicate detection for your purposes ( run ./duometer --help for a full set of options).

Installation

All platforms

The only prerequisite is a Java runtime.

  1. Download the current version of the tool here.
  2. Extract the archive and go to ./bin.
  3. Run ./duometer (on Linux and Mac) or duometer.bat (on Windows).

Debian (Ubuntu)

Download a package and run:

sudo dpkg -i duometer_0.1.3_all.deb

duometer is now installed and should be available as a shell command.

Building

Duometer uses sbt-native-packager. You can build the tool from source by running the dist command in sbt to create a .zip archive that can be run on any machine with Java installed.

Debian binary package can be created by executing debian:packageBin.

MinHash algorithm

For background information about the algoritm see a relevant chapter in Manning and Schütze (2008) or read the original Broder (1997) paper.

Supported file formats

Duometer uses Apache Tika to extract text from a huge number of different file types. For the full list of supported formats see here.

Contribute

Authors

The tool was developed at Center for Reading Research, Ghent University by Paweł Mandera.

License

The project is licensed under the Apache License 2.0.

References

Broder, A. Z. (1997). On the resemblance and containment of documents. In Compression and Complexity of Sequences 1997. Proceedings (pp. 21–29). IEEE.

Manning, C. D., Raghavan, P., & Schütze, H. (2008). Introduction to information retrieval. New York: Cambridge University Press.

About

Near-duplicate detection tool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Scala 100.0%