Diogocabral Sherlock Save

The Sherlock Plagiarism Detector

Project README


A modification of sherlock plagiarism detector.

-r - Use directories and their contents recursively

-e - File extension (default is .c)

Sherlock was written by Rob Pike and Loki. More information below.

Author's website (http://rp-www.cs.usyd.edu.au/~scilect/sherlock/) was/is offline, so I got the content below from google cache.

The Sherlock Plagiarism Detector

What is Sherlock?

Sherlock is a program which finds similarities between textual documents. It uses digital signatures to find similar pieces of text. A digital signature is a number which is formed by turning several words in the input into a series of bits and joining those bits into a number.

Sherlock works on text files such as essays, computer source code files, and other assignments in digital form. It will even work with Tar files, but not compressed archives such as Gzipped or Zipped files (you'll have to unzip those files first).

How do I download it?

There are some files you can download here:

  • sherlock.c - source code for the Sherlock program, in Unix text file format.
  • makefile - a Unix makefile.

Click on those files and choose "Save As..." from the File menu, or right-click in your browser and choose "Save Link As..." from there.

How do I compile it?

If using Unix or Linux, just type "make". If using Windows, consult your compiler's documentation. You simply need to compile the sherlock.c source code file into an executable called sherlock (sherlock.exe for Windows users).

How do I use it?

Sherlock is a command-line program. That is, you run it from an xterm, terminal or DOS window. It isn't graphical, and has no graphical user interface. Sorry. Use it like this:

   ./sherlock -e .txt *

That will compare all the text files in the sub directories and produce a listing of the most similar files, together with a percentage similarity index.

To compare source files, you might use it like this:

   ./sherlock -e .java *

or for python

   ./sherlock -e .py *

Sherlock can analize any text type file

Actually, it's a good idea to redirect the output into a file, so you can examine it in detail. Otherwise it'll just flash past very quickly. To redirect the output into a file, you use the > symbol:

   ./sherlock -e .java * > results.csv

This creates a file called "results.csv" which contains the results and can open with Excel, LibreOffice or similar .

What options does the program support?

There are several command-line options to Sherlock:

  • -t threshold% This controls how similar files must be before they will be mentioned. Increase this to 50% or higher if you only want to see very similar files. The default is 20%
  • -z zerobits This controls the "granularity" of the comparison. The higher this number, the cruder the comparison but the faster it will proceed. The lower this number, the more exact the comparison, but it will be slower, and it may be harder to detect plagiarism because small changes will fool the program into thinking the files are different. The default is 4, but the number can range from 0 to 31.
  • -n number_of_words This controls how many words are used to form one digital signature. This also contributes to the granularity of the comparison. A higher number is slower while a lower number is less exact. The default is 3 words, which works fine in most cases.
  • -o outfile If using Windows it may be difficult to specify an output file on the command line. Use this option to specify the output file.

What does the output look like?

Sherlock performs an N2 comparison between all the files, so every file is compared with every other file.

The output lists the similarity indexes between each pair of files. This index is a percentage, where 0% means no similarity and 100% means there is a very high chance of a lot of similarity. 100% does not mean that the files are exactly the same, since the Sherlock program randomly throws away some data in order to perform a faster match.

The output of the program might look like this:


(The threshold is normally 20%, so the above output would not ordinarily be shown. The example used a threshold lowered to 0% in order to see all similarities. The numbers are fake, however, and just for illustrational purposes.)

In the example, the most similar files are index.html and sherlock.c with a rating of 10%. This means that approximately 10% of the material in those two files might be overlapping (i.e. appear in both files).


Rob Pike created the original version of this program. There were actually two programs, called sig and comp. The sig program generated the digital signatures and stored them in a file. The comp program would then be used to compare the signature files and report the similarities.

Loki combined the two programs into a single program, called Sherlock. This has some advantages and disadvantages.

The main advantage is that no intermediate files need be created. Intermediate files require disk space and a management strategy. For example, you need to decide what suffix the signature files will use (e.g. ".sig") and where they will be stored (with the data, in a parallel directory structure, or other place).

Sherlock avoids these issues but requires all files to be compared every time to want a comparison. For example, if you are looking for similarities in essays handed in by students, Sherlock may work well because you should have all the essays handed in before you begin the plagiarism detection.

On the other hand, Sherlock is not see well suited to detecting duplicate email messages, since email arrives continually, and you can never have a finished set of email to work on. Intermediate ".sig" files might reduce the time needed to compare a new email item to older items, since the signatures for old items will already be computed and stored. Sherlock would have to read and compute the signatures for all of those older files, every time you need a comparison, because it does not use ".sig" files.

Can I download sig and comp?

Yes, download them by saving the following files:

  • sig.c - Program to generate one signature file.
  • comp.c - Program to compare signature files.
  • Makefile - Makefile for sig and comp programs.
Open Source Agenda is not affiliated with "Diogocabral Sherlock" Project. README Source: diogocabral/sherlock
Open Issues
Last Commit
7 months ago

Open Source Agenda Badge

Open Source Agenda Rating