Algorithms & data structures project

Algorithms and data structures are fundamental to efficient code and good software design. Creating and designing excellent algorithms is required for being an exemplary programmer. This repository's goal is to demonstrate how to correctly implement common data structures and algorithms in the simplest and most elegant ways.

🎬 Many of the algorithms and data structures in this repo have companion video explanations on the William Fiset YouTube channel — so if the code alone doesn't click, grab some popcorn and watch the videos!

Running an algorithm implementation

To compile and run any of the algorithms here, you need at least JDK version 8 and Bazel

Running with Bazel (recommended)

This project uses Bazel as its build system. Install Bazel by following the official installation guide.

Run a single algorithm like this:

bashCopy
bazel run //src/main/java/com/williamfiset/algorithms/<subpackage>:<ClassName>

For instance:

bashCopy
bazel run //src/main/java/com/williamfiset/algorithms/search:BinarySearch

Run all tests:

bashCopy
bazel test //src/test/...

Run tests for a specific package:

bashCopy
bazel test //src/test/java/com/williamfiset/algorithms/sorting:all

Compiling and running with only a JDK

If you don't want to use Bazel, you can compile and run with just the JDK:

Create a classes folder

bashCopy
cd Algorithms
mkdir classes

Compile the algorithm

bashCopy
javac -sourcepath src/main/java -d classes src/main/java/<relative-path-to-java-source-file>

Run the algorithm

bashCopy
java -cp classes <class-fully-qualified-name>

Example

bashCopy
$ javac -d classes -sourcepath src/main/java src/main/java/com/williamfiset/algorithms/search/BinarySearch.java
$ java -cp classes com.williamfiset.algorithms.search.BinarySearch

Data Structures

• :movie_camera: Balanced Trees
  • AVL Tree (recursive)
  • Red Black Tree (recursive)
• :movie_camera: Binary Search Tree
• Splay Tree
• :movie_camera: Dynamic Array
  • Dynamic array (integer only, fast)
• :movie_camera: Fenwick Tree
  • Fenwick Tree (range query, point updates)
  • Fenwick Tree (range update, point query)
• Fibonacci Heap
• :movie_camera: Hashtable
  • Hashtable (double hashing)
  • Hashtable (linear probing)
  • Hashtable (quadratic probing)
  • Hashtable (separate chaining)
• :movie_camera: Linked List
• :movie_camera: Priority Queue
  • Min Binary Heap
  • Min Indexed Binary Heap (sorted key-value pairs, similar to hash-table)
  • Min D-Heap
  • :movie_camera: Min Indexed D-Heap (sorted key-value pairs, similar to hash-table)
• :movie_camera: Queue
  • Queue (integer only, fixed size, fast)
  • Queue (linked list, generic)
• Segment Tree
  • Segment tree (array based, compact)
  • Segment tree (pointer implementation)
• :movie_camera: Sparse Table
• :movie_camera: Stack
  • Stack (integer only, fixed size, fast)
  • Stack (linked list, generic)
  • Stack (array, generic)
• :movie_camera: Suffix Array
  • Suffix Array (O(n²logn) construction)
  • Suffix Array (O(nlog²(n)) construction)
  • Suffix Array (O(nlog(n)) construction)
• Trie
• :movie_camera: Union Find

Dynamic Programming

Dynamic Programming Classics

• Coin change problem - O(nW)
• Edit distance (iterative) - O(nm)
• Edit distance (recursive) - O(nm)
• :movie_camera: Knapsack 0/1 - O(nW)
• Knapsack unbounded (0/∞) - O(nW)
• Maximum contiguous subarray - O(n)
• Longest Common Subsequence (LCS) - O(nm)
• Longest Increasing Subsequence (LIS) - O(n²)
• Longest Palindrome Subsequence (LPS) - O(n²)
• :movie_camera: Traveling Salesman Problem (dynamic programming, iterative) - O(n²2ⁿ)
• Traveling Salesman Problem (dynamic programming, recursive) - O(n²2ⁿ)
• Minimum Weight Perfect Matching (iterative, complete graph) - O(n²2ⁿ)

Dynamic Programming Problem Examples

Adhoc

• :movie_camera: Magic Cows
• :movie_camera: Narrow Art Gallery

Tiling problems

• :movie_camera: Tiling Dominoes
• :movie_camera: Tiling Dominoes and Trominoes
• :movie_camera: Mountain Scenes

Geometry

• Angle between 2D vectors - O(1)
• Circle-circle intersection point(s) - O(1)
• Circle-line intersection point(s) - O(1)
• Circle-line segment intersection point(s) - O(1)
• Circle-point tangent line(s) - O(1)
• Closest pair of points (line sweeping algorithm) - O(nlog(n))
• Collinear points test (are three 2D points on the same line) - O(1)
• Convex hull (Graham Scan algorithm) - O(nlog(n))
• Convex hull (Monotone chain algorithm) - O(nlog(n))
• Convex polygon area - O(n)
• Convex polygon contains points - O(log(n))
• Triangle area algorithms - O(1)
• Line segment-circle intersection point(s) - O(1)
• Line segment-line segment intersection - O(1)

<details> <summary>More geometry algorithms</summary>

• Angle between 3D vectors - O(1)
• Convex polygon cut - O(n)
• Coplanar points test (are four 3D points on the same plane) - O(1)
• Line class (handy infinite line class) - O(1)
• Line-circle intersection point(s) - O(1)
• Line segment to general form (ax + by = c) - O(1)
• Longitude-Latitude geographic distance - O(1)
• Point is inside triangle check - O(1)
• Point rotation about point - O(1)
• [UNTESTED] Circle-circle intersection area - O(1)
• [UNTESTED] Circular segment area - O(1)

</details>

Graph theory

Tree algorithms

• :movie_camera: Rooting an undirected tree - O(V+E)
• :movie_camera: Identifying isomorphic trees - O(V*log(V))
• :movie_camera: Tree center(s) - O(V+E)
• Tree diameter - O(V+E)
• :movie_camera: Lowest Common Ancestor (LCA, Euler tour) - O(1) queries, O(nlogn) preprocessing

Network flow

• Bipartite graph verification (adjacency list) - O(V+E)
• :movie_camera: Max flow & Min cut (Ford-Fulkerson with DFS, adjacency list) - O(fE)
• Max flow & Min cut (Ford-Fulkerson with DFS, adjacency matrix) - O(fV²)
• :movie_camera: Max flow & Min cut (Edmonds-Karp, adjacency list) - O(VE²)
• :movie_camera: Max flow & Min cut (Capacity scaling, adjacency list) - O(E²log₂(U))
• :movie_camera: Max flow & Min cut (Dinic's, adjacency list) - O(EV²) or O(E√V) for bipartite graphs
• Maximum Cardinality Bipartite Matching (augmenting path algorithm, adjacency list) - O(VE)
• Min Cost Max Flow (Bellman-Ford, adjacency list) - O(E²V²)
• Min Cost Max Flow (Johnson's algorithm, adjacency list) - O(E²Vlog(V))

Main graph theory algorithms

• Articulation points/cut vertices (adjacency list) - O(V+E)
• Bellman-Ford (edge list, negative cycles, fast & optimized) - O(VE)
• :movie_camera: Bellman-Ford (adjacency list, negative cycles) - O(VE)
• :movie_camera: Breadth first search (adjacency list) - O(V+E)
• Bridges/cut edges (adjacency list) - O(V+E)
• Boruvkas (adjacency list, min spanning tree algorithm) - O(Elog(V))
• Find connected components (adjacency list, union find) - O(V+E)
• Find connected components (adjacency list, DFS) - O(V+E)
• :movie_camera: Depth first search (adjacency list, recursive) - O(V+E)
• :movie_camera: Dijkstra's shortest path (adjacency list, lazy implementation) - O(Elog(V))
• :movie_camera: Dijkstra's shortest path (adjacency list, eager implementation + D-ary heap) - O(Elog_E/V(V))
• :movie_camera: Eulerian Path (directed edges) - O(E+V)
• :movie_camera: Floyd Warshall algorithm (adjacency matrix, negative cycle check) - O(V³)
• :movie_camera: Kahn's algorithm (topological sort, adjacency list) - O(E+V)
• Kruskal's min spanning tree algorithm (edge list, union find) - O(Elog(E))
• Kosaraju's strongly connected components algorithm (adjacency list) - O(V+E)
• :movie_camera: Prim's min spanning tree algorithm (lazy version, adjacency list) - O(Elog(E))
• :movie_camera: Prim's min spanning tree algorithm (eager version, adjacency list) - O(Elog(V))
• Steiner tree (minimum spanning tree generalization) - O(V³ + V² · 2^T + V · 3^T)
• :movie_camera: Tarjan's strongly connected components algorithm (adjacency list) - O(V+E)
• :movie_camera: Topological sort (acyclic graph, adjacency list) - O(V+E)
• :movie_camera: Traveling Salesman Problem (dynamic programming, iterative) - O(n²2ⁿ)
• Traveling Salesman Problem (dynamic programming, recursive) - O(n²2ⁿ)

Linear algebra

• Freivald's algorithm (matrix multiplication verification) - O(kn²)
• Gaussian elimination (solve system of linear equations) - O(cr²)
• Gaussian elimination (modular version, prime finite field) - O(cr²)
• Linear recurrence solver (finds nth term in a recurrence relation) - O(m³log(n))
• Matrix determinant (Laplace/cofactor expansion) - O((n+2)!)
• Matrix inverse - O(n³)
• Matrix multiplication - O(n³)
• Matrix power - O(n³log(p))
• Square matrix rotation - O(n²)

Mathematics

• Chinese remainder theorem
• Prime number sieve (sieve of Eratosthenes) - O(nlog(log(n)))
• Prime number sieve (sieve of Eratosthenes, compressed) - O(nlog(log(n)))
• Totient function (phi function, relatively prime number count) - O(√n)
• Extended euclidean algorithm - ~O(log(a + b))
• Greatest Common Divisor (GCD) - ~O(log(a + b))
• Fast Fourier transform (quick polynomial multiplication) - O(nlog(n))
• Fast Fourier transform (quick polynomial multiplication, complex numbers) - O(nlog(n))
• Primality check - O(√n)
• Least Common Multiple (LCM) - ~O(log(a + b))
• Modular inverse - ~O(log(a + b))
• Modular exponentiation - O(log(n))
• Prime factorization (pollard rho) - O(n^1/4)
• Relatively prime check (coprimality check) - ~O(log(a + b))

Other

• Bit manipulations - O(1)
• List permutations - O(n!)
• :movie_camera: Power set (set of all subsets) - O(n · 2ⁿ)
• Set combinations - O(n choose r)
• Set combinations with repetition - O((n+r-1) choose r)
• Sliding Window Minimum/Maximum - O(1)
• Square Root Decomposition - O(1) point updates, O(√n) range queries
• Unique set combinations - O(n choose r)

Search algorithms

• Binary search (real numbers) - O(log(n))
• Interpolation search (discrete numbers) - O(n) or O(log(log(n))) with uniform input
• Ternary search (real numbers) - O(log(n))
• Ternary search (discrete numbers) - O(log(n))

Sorting algorithms

• Bubble sort - O(n²)
• Bucket sort - Θ(n + k)
• Counting sort - O(n + k)
• Heapsort - O(nlog(n))
• Insertion sort - O(n²)
• :movie_camera: Mergesort - O(nlog(n))
• Quicksort (in-place, Hoare partitioning) - Θ(nlog(n))
• Quicksort3 (Dutch National Flag algorithm) - Θ(nlog(n))
• Selection sort - O(n²)
• Tim sort - O(nlog(n))
• Radix sort - O(n*w)

String algorithms

• Booth's algorithm (finds lexicographically smallest string rotation) - O(n)
• Knuth-Morris-Pratt algorithm (finds pattern matches in text) - O(n+m)
• Longest Common Prefix (LCP) array - O(nlog(n)) bounded by SA construction, otherwise O(n)
• :movie_camera: Longest Common Substring (LCS) - O(nlog(n)) bounded by SA construction, otherwise O(n)
• :movie_camera: Longest Repeated Substring (LRS) - O(nlog(n))
• Manacher's algorithm (finds all palindromes in text) - O(n)
• Rabin-Karp algorithm (finds pattern match positions in text) - O(n+m)
• Substring verification with suffix array - O(nlog(n)) SA construction and O(mlog(n)) per query

License

This repository is released under the MIT license. In short, this means you are free to use this software in any personal, open-source or commercial projects. Attribution is optional but appreciated.

Sponsor

Consider sponsoring to support my creation of educational content: