gitwtfhub

wtf is proof_docsimilarity?

zeeshanlakhani/proof_docsimilarity — explained in plain English

Analysis updated 2026-08-15 · repo last pushed 2011-03-09

1Objective-CAudience · researcherComplexity · 1/5DormantSetup · moderate

TL;DR

A proof-of-concept tool that measures how similar two pieces of text are by turning words into numbers and comparing them with basic linear algebra. Built as an NYU math class assignment.

Mindmap

mindmap
  root((repo))
    What it does
      Compares two texts
      Returns similarity score
      Ignores stop words
    Tech stack
      MATLAB
      Objective-C
    Use cases
      Learn text similarity
      Study vector space math
      Class assignment reference
    Audience
      Students
      Math learners
    Limitations
      Academic exercise only
      Messy code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Learn how document similarity works by running the code with two text passages and seeing the resulting score.

REASON 2

Study the math behind converting text into vector representations and comparing them.

REASON 3

Use the included PDF as a reference for understanding the linear algebra concepts behind text comparison.

What's in the stack?

MATLABObjective-C

How it stacks up

zeeshanlakhani/proof_docsimilarityaonez/macreflowerburningtyger/gmail-notifr
Stars111
LanguageObjective-CObjective-CObjective-C
Last pushed2011-03-092016-11-272013-01-22
MaintenanceDormantDormantDormant
Setup difficultymoderatemoderatemoderate
Complexity1/52/52/5
Audienceresearchergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires MATLAB to run the similarity function, which may not be readily available to all users.

No license information is provided, so default copyright restrictions apply and you should contact the author before reusing this code.

Wtf does this do

This project is a proof-of-concept tool that figures out how similar two pieces of text are to each other. It was built as a class assignment for a math course at NYU, and it lets you feed it two documents or text passages to get back a measure of how closely they relate. Under the hood, it works by turning text into numbers and then comparing those numbers using basic linear algebra. The approach ignores "stop words", common words like "the" or "and" that don't carry much meaning, and focuses on the more significant words in each document. By converting the remaining words into a mathematical representation, the tool can calculate how much the two documents overlap in content. The main use case is academic: someone learning about document similarity models, vector spaces, or the math behind text comparison. You would run it in MATLAB by calling a function with two text inputs, and it returns a similarity score. The README notes that a PDF with more detail about the problem is included in the repository. It's worth noting that this is a straightforward academic exercise rather than a production-ready library. The author even apologizes in advance for potentially messy code, so it's best treated as a learning reference rather than something to build on directly.

Yoink these prompts

Prompt 1
I have two text passages and want to measure how similar they are using basic linear algebra. Walk me through how to turn each document into a vector, remove stop words, and compute a similarity score step by step.
Prompt 2
Explain how ignoring common words like 'the' and 'and' affects a document similarity calculation, and show me a simple example comparing two short texts without those words.
Prompt 3
Help me understand the vector space model for text comparison: how do you convert words into numbers and then calculate how much two documents overlap in content?

Frequently asked questions

wtf is proof_docsimilarity?

A proof-of-concept tool that measures how similar two pieces of text are by turning words into numbers and comparing them with basic linear algebra. Built as an NYU math class assignment.

What language is proof_docsimilarity written in?

Mainly Objective-C. The stack also includes MATLAB, Objective-C.

Is proof_docsimilarity actively maintained?

Dormant — no commits in 2+ years (last push 2011-03-09).

What license does proof_docsimilarity use?

No license information is provided, so default copyright restrictions apply and you should contact the author before reusing this code.

How hard is proof_docsimilarity to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is proof_docsimilarity for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.