Benchmarks complete

Roadmaps/sorts.md

@@ -0,0 +1,125 @@
+### Sorting an array of size (n) : 32
+n^2 for this array is : 1024.0<br>
+nlogn for this array is : 160.0
+
+| ARRAY NATURE | ALGORITHM | TIME ELAPSED (ns) | COMPARES | EXCHANGES |
+|--|--|--|--|--|
+| ALREADY SORTED | Selection Sort | 146007.0 | 496.0 | 31.0 |
+| ALREADY SORTED | Insertion Sort | 18685.0 | 31.0 | 0.0 |
+| ALREADY SORTED | Shell Sort | 10791.0 | 78.0 | 0.0 |
+| ALREADY SORTED | Merge Sort | 56837.0 | 160.0 | 0.0 |
+| ALREADY SORTED | Quick Sort | 44935.0 | 558.0 | 31.0 |
+| ALREADY SORTED | Three Way Quick Sort | 84400.0 | 357.0 | 195.0 |
+| ALREADY SORTED | Heap Sort | 35678.0 | 231.0 | 146.0 |
+| PARTIALLY SORTED | Selection Sort | 31420.0 | 496.0 | 31.0 |
+| PARTIALLY SORTED | Insertion Sort | 10620.0 | 100.0 | 70.0 |
+| PARTIALLY SORTED | Shell Sort | 12814.0 | 121.0 | 48.0 |
+| PARTIALLY SORTED | Merge Sort | 28103.0 | 160.0 | 0.0 |
+| PARTIALLY SORTED | Quick Sort | 17834.0 | 187.0 | 30.0 |
+| PARTIALLY SORTED | Three Way Quick Sort | 53461.0 | 240.0 | 145.0 |
+| PARTIALLY SORTED | Heap Sort | 10079.0 | 226.0 | 142.0 |
+| REVERSE SORTED | Selection Sort | 31490.0 | 496.0 | 31.0 |
+| REVERSE SORTED | Insertion Sort | 51979.0 | 496.0 | 496.0 |
+| REVERSE SORTED | Shell Sort | 19998.0 | 114.0 | 58.0 |
+| REVERSE SORTED | Merge Sort | 24306.0 | 160.0 | 0.0 |
+| REVERSE SORTED | Quick Sort | 38042.0 | 542.0 | 31.0 |
+| REVERSE SORTED | Three Way Quick Sort | 55355.0 | 496.0 | 496.0 |
+| REVERSE SORTED | Heap Sort | 8726.0 | 202.0 | 112.0 |
+| RANDOMLY ORDERED | Selection Sort | 38714.0 | 496.0 | 31.0 |
+| RANDOMLY ORDERED | Insertion Sort | 28294.0 | 282.0 | 255.0 |
+| RANDOMLY ORDERED | Shell Sort | 15409.0 | 152.0 | 89.0 |
+| RANDOMLY ORDERED | Merge Sort | 25057.0 | 160.0 | 0.0 |
+| RANDOMLY ORDERED | Quick Sort | 18345.0 | 228.0 | 37.0 |
+| RANDOMLY ORDERED | Three Way Quick Sort | 27702.0 | 229.0 | 157.0 |
+| RANDOMLY ORDERED | Heap Sort | 9458.0 | 218.0 | 133.0 |
+| FEW FREQUENTLY OCCURING | Selection Sort | 32061.0 | 496.0 | 31.0 |
+| FEW FREQUENTLY OCCURING | Insertion Sort | 21601.0 | 213.0 | 183.0 |
+| FEW FREQUENTLY OCCURING | Shell Sort | 11792.0 | 118.0 | 50.0 |
+| FEW FREQUENTLY OCCURING | Merge Sort | 26440.0 | 160.0 | 0.0 |
+| FEW FREQUENTLY OCCURING | Quick Sort | 17994.0 | 203.0 | 38.0 |
+| FEW FREQUENTLY OCCURING | Three Way Quick Sort | 17162.0 | 192.0 | 80.0 |
+| FEW FREQUENTLY OCCURING | Heap Sort | 9138.0 | 223.0 | 128.0 |
+
+### Sorting an array of size (n) : 512
+n^2 for this array is : 262144.0<br>
+nlogn for this array is : 4608.0
+
+| ARRAY NATURE | ALGORITHM | TIME ELAPSED (ns) | COMPARES | EXCHANGES |
+|--|--|--|--|--|
+| ALREADY SORTED | Selection Sort | 4850717.0 | 130816.0 | 511.0 |
+| ALREADY SORTED | Insertion Sort | 35989.0 | 511.0 | 0.0 |
+| ALREADY SORTED | Shell Sort | 158500.0 | 2529.0 | 0.0 |
+| ALREADY SORTED | Merge Sort | 449562.0 | 4608.0 | 0.0 |
+| ALREADY SORTED | Quick Sort | 3002463.0 | 131838.0 | 511.0 |
+| ALREADY SORTED | Three Way Quick Sort | 1673142.0 | 25227.0 | 13149.0 |
+| ALREADY SORTED | Heap Sort | 254052.0 | 7958.0 | 4464.0 |
+| PARTIALLY SORTED | Selection Sort | 1965597.0 | 130816.0 | 511.0 |
+| PARTIALLY SORTED | Insertion Sort | 2597005.0 | 29114.0 | 28607.0 |
+| PARTIALLY SORTED | Shell Sort | 425297.0 | 5355.0 | 2949.0 |
+| PARTIALLY SORTED | Merge Sort | 298236.0 | 4608.0 | 0.0 |
+| PARTIALLY SORTED | Quick Sort | 188748.0 | 6429.0 | 952.0 |
+| PARTIALLY SORTED | Three Way Quick Sort | 300219.0 | 9526.0 | 5537.0 |
+| PARTIALLY SORTED | Heap Sort | 221880.0 | 7689.0 | 4266.0 |
+| REVERSE SORTED | Selection Sort | 1964334.0 | 130816.0 | 511.0 |
+| REVERSE SORTED | Insertion Sort | 8566013.0 | 130816.0 | 130816.0 |
+| REVERSE SORTED | Shell Sort | 501150.0 | 4098.0 | 1790.0 |
+| REVERSE SORTED | Merge Sort | 133242.0 | 4608.0 | 0.0 |
+| REVERSE SORTED | Quick Sort | 2777496.0 | 131582.0 | 511.0 |
+| REVERSE SORTED | Three Way Quick Sort | 4018770.0 | 130816.0 | 130816.0 |
+| REVERSE SORTED | Heap Sort | 316731.0 | 7203.0 | 3772.0 |
+| RANDOMLY ORDERED | Selection Sort | 2139577.0 | 130816.0 | 511.0 |
+| RANDOMLY ORDERED | Insertion Sort | 1740760.0 | 66207.0 | 65704.0 |
+| RANDOMLY ORDERED | Shell Sort | 845052.0 | 5834.0 | 3503.0 |
+| RANDOMLY ORDERED | Merge Sort | 170153.0 | 4608.0 | 0.0 |
+| RANDOMLY ORDERED | Quick Sort | 137871.0 | 5685.0 | 1068.0 |
+| RANDOMLY ORDERED | Three Way Quick Sort | 266034.0 | 6785.0 | 4434.0 |
+| RANDOMLY ORDERED | Heap Sort | 304848.0 | 7658.0 | 4172.0 |
+| FEW FREQUENTLY OCCURING | Selection Sort | 5186584.0 | 130816.0 | 511.0 |
+| FEW FREQUENTLY OCCURING | Insertion Sort | 1422557.0 | 57576.0 | 57067.0 |
+| FEW FREQUENTLY OCCURING | Shell Sort | 432791.0 | 4097.0 | 1723.0 |
+| FEW FREQUENTLY OCCURING | Merge Sort | 154453.0 | 4608.0 | 0.0 |
+| FEW FREQUENTLY OCCURING | Quick Sort | 278238.0 | 15531.0 | 906.0 |
+| FEW FREQUENTLY OCCURING | Three Way Quick Sort | 63401.0 | 2489.0 | 969.0 |
+| FEW FREQUENTLY OCCURING | Heap Sort | 280381.0 | 7212.0 | 3819.0 |
+
+### Sorting an array of size (n) : 1024
+n^2 for this array is : 1048576.0<br>
+nlogn for this array is : 10240.0
+
+| ARRAY NATURE | ALGORITHM | TIME ELAPSED (ns) | COMPARES | EXCHANGES |
+|--|--|--|--|--|
+| ALREADY SORTED | Selection Sort | 7498749.0 | 523776.0 | 1023.0 |
+| ALREADY SORTED | Insertion Sort | 22482.0 | 1023.0 | 0.0 |
+| ALREADY SORTED | Shell Sort | 311771.0 | 5601.0 | 0.0 |
+| ALREADY SORTED | Merge Sort | 276915.0 | 10240.0 | 0.0 |
+| ALREADY SORTED | Quick Sort | 6711786.0 | 525822.0 | 1023.0 |
+| ALREADY SORTED | Three Way Quick Sort | 3649069.0 | 70999.0 | 36808.0 |
+| ALREADY SORTED | Heap Sort | 546827.0 | 18060.0 | 9968.0 |
+| PARTIALLY SORTED | Selection Sort | 5672566.0 | 523776.0 | 1023.0 |
+| PARTIALLY SORTED | Insertion Sort | 1121306.0 | 119251.0 | 118229.0 |
+| PARTIALLY SORTED | Shell Sort | 888765.0 | 12869.0 | 7515.0 |
+| PARTIALLY SORTED | Merge Sort | 998493.0 | 10240.0 | 0.0 |
+| PARTIALLY SORTED | Quick Sort | 220528.0 | 13342.0 | 2143.0 |
+| PARTIALLY SORTED | Three Way Quick Sort | 1015716.0 | 18425.0 | 10928.0 |
+| PARTIALLY SORTED | Heap Sort | 412432.0 | 17351.0 | 9501.0 |
+| REVERSE SORTED | Selection Sort | 5445486.0 | 523776.0 | 1023.0 |
+| REVERSE SORTED | Insertion Sort | 4216956.0 | 523776.0 | 523776.0 |
+| REVERSE SORTED | Shell Sort | 618302.0 | 9175.0 | 4430.0 |
+| REVERSE SORTED | Merge Sort | 923041.0 | 10240.0 | 0.0 |
+| REVERSE SORTED | Quick Sort | 7040860.0 | 525310.0 | 1023.0 |
+| REVERSE SORTED | Three Way Quick Sort | 3.3696654E7 | 523776.0 | 523776.0 |
+| REVERSE SORTED | Heap Sort | 374319.0 | 16407.0 | 8542.0 |
+| RANDOMLY ORDERED | Selection Sort | 538151.0 | 523776.0 | 1023.0 |
+| RANDOMLY ORDERED | Insertion Sort | 2208077.0 | 263988.0 | 262976.0 |
+| RANDOMLY ORDERED | Shell Sort | 985999.0 | 13931.0 | 8766.0 |
+| RANDOMLY ORDERED | Merge Sort | 1100978.0 | 10240.0 | 0.0 |
+| RANDOMLY ORDERED | Quick Sort | 244102.0 | 13790.0 | 2377.0 |
+| RANDOMLY ORDERED | Three Way Quick Sort | 911649.0 | 16118.0 | 10074.0 |
+| RANDOMLY ORDERED | Heap Sort | 414616.0 | 17306.0 | 9311.0 |
+| FEW FREQUENTLY OCCURING | Selection Sort | 536507.0 | 523776.0 | 1023.0 |
+| FEW FREQUENTLY OCCURING | Insertion Sort | 1991185.0 | 241533.0 | 240512.0 |
+| FEW FREQUENTLY OCCURING | Shell Sort | 561314.0 | 8621.0 | 3374.0 |
+| FEW FREQUENTLY OCCURING | Merge Sort | 990428.0 | 10240.0 | 0.0 |
+| FEW FREQUENTLY OCCURING | Quick Sort | 746566.0 | 59026.0 | 1844.0 |
+| FEW FREQUENTLY OCCURING | Three Way Quick Sort | 229926.0 | 4749.0 | 1894.0 |
+| FEW FREQUENTLY OCCURING | Heap Sort | 172988.0 | 16171.0 | 8449.0 |

clients/build.gradle

@@ -16,6 +16,7 @@ dependencies {
     implementation project(':module5')
     implementation project(':module6')
     implementation project(':module7')
+    implementation project(':module8')
     implementation project(':common')
     testImplementation project(':common')
 }

clients/src/main/java/com/hithomelabs/clients/Benchmarks/ArraySize.java

@@ -0,0 +1,30 @@
+package com.hithomelabs.clients.Benchmarks;
+
+public class ArraySize {
+
+    private final int size;
+    public ArraySize(int n){
+        size = n;
+    }
+
+    public int getSize() {
+        return size;
+    }
+
+    public double getNSquare(){
+        return Math.pow(size,2);
+    }
+
+    public double getNlogN(){
+        return size * Math.log(size)/ Math.log(2);
+    }
+
+    public double getLogN(){
+        return Math.log(size)/ Math.log(2);
+    }
+
+    @Override
+    public String toString() {
+        return "### Sorting an array of size (n) : " + getSize() + " \n" + "n^2 for this array is : " + getNSquare() + "<br> \n" + "nlogn for this array is : " + getNlogN() + "\n";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/BenchMark.java

@@ -0,0 +1,47 @@
+package com.hithomelabs.clients.Benchmarks;
+
+import com.hithomelabs.clients.Benchmarks.Sortables.*;
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import java.util.ArrayList;
+import java.util.List;
+
+public class BenchMark {
+
+    private ArraySize size;
+    private List<MeasurableSort<Apple>> algorithms;
+    private List<Sortable<Apple>> sortableCollections;
+    private static final String header = "| ARRAY NATURE | ALGORITHM | TIME ELAPSED (ns) | COMPARES | EXCHANGES |";
+    // * Helps get a table in markdown
+    private static final String markdownTableFormatter = "|--|--|--|--|--|";
+
+
+    BenchMark(int size, List<MeasurableSort<Apple>> algorithms) {
+        this.size = new ArraySize(size);
+        this.algorithms = algorithms;
+        sortableCollections = new ArrayList<Sortable<Apple>>();
+        sortableCollections.add(new AlreadySortedApples(size));
+        sortableCollections.add(new PartiallySortedApples(size, 1000));
+        sortableCollections.add(new ReverseSortedApples(size));
+        sortableCollections.add(new RandomlySizedApples(size, 1000));
+        sortableCollections.add(new FewFrequentlyOccuringApples(size));
+    }
+
+    public void run() {
+
+        System.out.println(size);
+        System.out.println(header);
+        System.out.println(markdownTableFormatter);
+        for(Sortable<Apple> array: sortableCollections){
+            new Bundle<Apple>(array, algorithms).run(Apple.COMPARE_BY_SIZE);
+        }
+        System.out.println();
+    }
+
+}
+
+
+
+
+
+

clients/src/main/java/com/hithomelabs/clients/Benchmarks/BenchMarkingClient.java

@@ -0,0 +1,41 @@
+package com.hithomelabs.clients.Benchmarks;
+
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module5.Insertion;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.Selection;
+import com.hithomelabs.princeton1.module5.Shell;
+import com.hithomelabs.princeton1.module6.Merge;
+import com.hithomelabs.princeton1.module7.Quick;
+import com.hithomelabs.princeton1.module7.ThreeWayQuick;
+import com.hithomelabs.princeton1.module8.HeapSort;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class BenchMarkingClient {
+
+    public static void main(String[] args) {
+        List<MeasurableSort<Apple>> algorithms = new ArrayList<MeasurableSort<Apple>>();
+
+        algorithms.add(new Selection<Apple>());
+        algorithms.add(new Insertion<Apple>());
+        algorithms.add(new Shell<Apple>());
+        algorithms.add(new Merge<Apple>());
+        algorithms.add(new Quick<Apple>());
+        algorithms.add(new ThreeWayQuick<Apple>());
+        algorithms.add(new HeapSort<Apple>());
+
+        BenchMark b1 = new BenchMark(32, algorithms);
+        BenchMark b2 = new BenchMark(512, algorithms);
+        BenchMark b3 = new BenchMark(1024, algorithms);
+        BenchMark b4 = new BenchMark(4096,algorithms);
+        //b1.run();
+        //b2.run();
+        //b3.run();
+        b4.run();
+
+    }
+
+
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Bundle.java

@@ -0,0 +1,38 @@
+package com.hithomelabs.clients.Benchmarks;
+
+
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
+
+import java.util.Comparator;
+import java.util.List;
+
+/*
+* * A sorting bundle, that bundles one array and passes a copy of that array for all algorithms to sort
+ */
+public class Bundle<E> {
+
+    private Sortable<E> array;
+    private List<MeasurableSort<E>> algorithms;
+    private Comparator<E> cmp;
+
+    Bundle(Sortable<E> array, List<MeasurableSort<E>> algorithms){
+        this.array = array;
+        this.algorithms = algorithms;
+    }
+
+    Bundle (Sortable<E> array, List<MeasurableSort<E>> algorithms, Comparator<E> cmp){
+        this(array, algorithms);
+        if (cmp != null) this.cmp = cmp;
+    }
+
+    public void run(Comparator<E> cmp){
+        for (MeasurableSort<E> sortingAlgorithm: algorithms){
+            SortingMetaData metaData = new SortingMetaData();
+            sortingAlgorithm.sort(array.getArray(), cmp, metaData);
+            System.out.println("| " + array.getOrdering() + " | " + sortingAlgorithm + " | " + metaData.timeElapsed() + " | "  + metaData.getCompares() + " | " + metaData.getExchanges() + " |" );
+        }
+    }
+
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortable.java

@@ -0,0 +1,8 @@
+package com.hithomelabs.clients.Benchmarks;
+
+public interface Sortable<E> {
+
+    public E[] getArray();
+
+    public String getOrdering();
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortables/AlreadySortedApples.java

@@ -0,0 +1,25 @@
+package com.hithomelabs.clients.Benchmarks.Sortables;
+
+import com.hithomelabs.clients.Benchmarks.Sortable;
+import com.hithomelabs.princeton1.common.Apple;
+
+public class AlreadySortedApples implements Sortable<Apple> {
+
+    Apple[] apples;
+
+    public AlreadySortedApples(int size){
+        apples = new Apple[size];
+        for (int i = 0; i < size; i++)
+            apples[i] = new Apple(i);
+    }
+
+    @Override
+    public Apple[] getArray() {
+        return apples.clone();
+    }
+
+    @Override
+    public String getOrdering() {
+        return "ALREADY SORTED";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortables/FewFrequentlyOccuringApples.java

@@ -0,0 +1,30 @@
+package com.hithomelabs.clients.Benchmarks.Sortables;
+
+import com.hithomelabs.clients.Benchmarks.Sortable;
+import com.hithomelabs.princeton1.common.Apple;
+
+import java.util.Random;
+
+public class FewFrequentlyOccuringApples implements Sortable<Apple> {
+
+    Apple[] apples;
+    Random random;
+    private static final int DEFAULT_SIZE_RANGE = 10;
+
+    public FewFrequentlyOccuringApples(int size){
+        random = new Random();
+        apples = new Apple[size];
+        for (int i = 0; i < size; i++)
+            apples[i] = new Apple(random.nextInt(DEFAULT_SIZE_RANGE));
+    }
+
+    @Override
+    public Apple[] getArray() {
+        return apples.clone();
+    }
+
+    @Override
+    public String getOrdering() {
+        return "FEW FREQUENTLY OCCURING";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortables/PartiallySortedApples.java

@@ -0,0 +1,34 @@
+package com.hithomelabs.clients.Benchmarks.Sortables;
+
+import com.hithomelabs.clients.Benchmarks.Sortable;
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module5.ComparableHelper;
+import com.hithomelabs.princeton1.module8.HeapSort;
+import java.util.Random;
+
+public class PartiallySortedApples implements Sortable<Apple>, ComparableHelper {
+
+    Apple[] apples;
+    Random random;
+
+    public PartiallySortedApples(int size, int sizeRange){
+        random = new Random();
+        apples = new Apple[size];
+        for (int i = 0; i < size; i++)
+            apples[i] = new Apple(random.nextInt(sizeRange));
+        HeapSort.heapify(apples);
+        int N = apples.length;
+        for (int i = 0; i < N/2; i++)
+            ComparableHelper.exch(apples, i, N-i-1);
+    }
+
+    @Override
+    public Apple[] getArray() {
+        return apples.clone();
+    }
+
+    @Override
+    public String getOrdering() {
+        return "PARTIALLY SORTED";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortables/RandomlySizedApples.java

@@ -0,0 +1,30 @@
+package com.hithomelabs.clients.Benchmarks.Sortables;
+
+import com.hithomelabs.clients.Benchmarks.Sortable;
+import com.hithomelabs.princeton1.common.Apple;
+
+import java.util.Random;
+
+public class RandomlySizedApples implements Sortable<Apple> {
+
+    Apple[] apples;
+    Random random;
+
+    public RandomlySizedApples(int size, int sizeRange){
+        random = new Random();
+        apples = new Apple[size];
+        for (int i = 0; i < size; i++)
+            apples[i] = new Apple(random.nextInt(sizeRange));
+    }
+
+
+    @Override
+    public Apple[] getArray() {
+        return apples.clone();
+    }
+
+    @Override
+    public String getOrdering() {
+        return "RANDOMLY ORDERED";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/Benchmarks/Sortables/ReverseSortedApples.java

@@ -0,0 +1,25 @@
+package com.hithomelabs.clients.Benchmarks.Sortables;
+
+import com.hithomelabs.clients.Benchmarks.Sortable;
+import com.hithomelabs.princeton1.common.Apple;
+
+public class ReverseSortedApples implements Sortable<Apple> {
+
+    Apple[] apples;
+
+    public ReverseSortedApples(int size){
+        apples = new Apple[size];
+        for (int i = 0; i < size; i++)
+            apples[i] = new Apple(size-i);
+    }
+
+    @Override
+    public Apple[] getArray() {
+        return apples.clone();
+    }
+
+    @Override
+    public String getOrdering() {
+        return "REVERSE SORTED";
+    }
+}

clients/src/main/java/com/hithomelabs/clients/module7/ThreeWayQuickSortClient.java

@@ -0,0 +1,23 @@
+package com.hithomelabs.clients.module7;
+
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module7.Quick;
+import com.hithomelabs.princeton1.module7.ThreeWayQuick;
+
+import java.util.Random;
+
+public class ThreeWayQuickSortClient {
+
+    public static void main(String[] args) {
+        int size = 100;
+        Apple[] apples = new Apple[size];
+        ThreeWayQuick<Apple> quick = new ThreeWayQuick<>();
+
+        for (int i = 0; i < apples.length; i++) {
+            apples[i] = new Apple(new Random().nextInt(10));
+        }
+        quick.sort(apples);
+        for (int i = 0; i < apples.length; i++)
+            System.out.println(apples[i]);
+    }
+}

clients/src/main/java/com/hithomelabs/clients/module8/HeapSortClient.java

@@ -0,0 +1,23 @@
+package com.hithomelabs.clients.module8;
+
+import com.hithomelabs.princeton1.common.Apple;
+import com.hithomelabs.princeton1.module8.HeapSort;
+
+import java.util.Random;
+
+public class HeapSortClient {
+
+    public static void main(String[] args) {
+        int size = 10;
+        Apple[] apples = new Apple[size];
+        HeapSort<Apple> heap = new HeapSort<Apple>();
+
+        for (int i = 0; i < apples.length; i++) {
+            apples[i] = new Apple(new Random().nextInt(10));
+        }
+        heap.sort(apples);
+        for (int i = 0; i < apples.length; i++)
+            System.out.println(apples[i]);
+    }
+
+}

common/src/main/java/com/hithomelabs/princeton1/common/Apple.java

@@ -1,9 +1,18 @@
 package com.hithomelabs.princeton1.common;
 
+import java.util.Comparator;
 import java.util.Objects;
 
 public class Apple implements Comparable<Apple> {
     private int size;
+    public static Comparator<Apple> COMPARE_BY_SIZE = new Comparator<Apple>() {
+        @Override
+        public int compare(Apple a1, Apple a2) {
+            if(a1.size < a2.size) return -1;
+            else if (a1.size == (a2.size)) return 0;
+            else return 1;
+        }
+    };
 
     public Apple(int size) {
         this.size = size;

module5/src/main/java/com/hithomelabs/princeton1/module5/AbstractCustomSorts.java

@@ -1,17 +0,0 @@
-package com.hithomelabs.princeton1.module5;
-
-public abstract class AbstractCustomSorts<E> {
-
-    public abstract void sort(E[] arr);
-
-    public void exch(E[] arr, int j, int i) {
-        E temp = arr[i];
-        arr[i] = arr[j];
-        arr[j] = temp;
-    }
-
-    public boolean less(Comparable<E> e1, E e2) {
-        return e1.compareTo(e2) < 0;
-    }
-
-}

module5/src/main/java/com/hithomelabs/princeton1/module5/ComparableHelper.java

@@ -0,0 +1,18 @@
+package com.hithomelabs.princeton1.module5;
+
+// * * Provides a set of helper functions less and exch for Comparable data types
+public interface ComparableHelper {
+
+    static <T> void exch(T[] arr, int j, int i) {
+        T temp = arr[i];
+        arr[i] = arr[j];
+        arr[j] = temp;
+    }
+
+    static <T> boolean less(T e1, T e2) {
+        return ((Comparable<T>)e1).compareTo(e2) < 0;
+    }
+
+    static <T> boolean equals(T e1, T e2) { return ((Comparable<T>)e1).compareTo(e2) == 0;}
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/ComparableSort.java

@@ -0,0 +1,7 @@
+package com.hithomelabs.princeton1.module5;
+
+public interface ComparableSort<E> {
+
+    void sort(E[] arr);
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/ComparatorHelper.java

@@ -0,0 +1,19 @@
+package com.hithomelabs.princeton1.module5;
+
+import java.util.Comparator;
+
+public interface ComparatorHelper extends ComparableHelper {
+
+    static <T> boolean less(T v, T w, Comparator<T> cmp) {
+        if (cmp == null) return ComparableHelper.less(v, w);
+        else
+            return cmp.compare(v, w) < 0;
+    }
+
+    static <T> boolean equals(T v, T w, Comparator<T> cmp) {
+        if (cmp == null) return ComparableHelper.equals(v, w);
+        else
+            return cmp.compare(v, w) == 0;
+    }
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/ComparatorSort.java

@@ -0,0 +1,9 @@
+package com.hithomelabs.princeton1.module5;
+
+import java.util.Comparator;
+
+public interface ComparatorSort<E> extends ComparableSort<E> {
+
+    public void sort(E[] arr, Comparator<E> cmp);
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/Insertion.java

@@ -1,23 +1,46 @@
 package com.hithomelabs.princeton1.module5;
 
-public class Insertion<E> extends AbstractCustomSorts<E> {
+import java.util.Comparator;
 
-    public void sort(E[] arr){
+public class Insertion<E> implements MeasurableSort<E>, MeasurableHelper{
+
+    public void sort(E[] arr) {
+        coreSortLogic(arr, null, null);
+
+    }
+
+    private void coreSortLogic(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
         if (arr == null) return;
-        else{
+        else {
             int N = arr.length;
             // * * swap arr[i] with each element greater to it's left
-            for (int i = 1; i < N; i++){
+            for (int i = 1; i < N; i++) {
                 int j = i;
-                while(j >= 1 && less((Comparable<E>)arr[j], arr[j-1])){
+                while (j >= 1 && MeasurableHelper.less(arr[j], arr[j - 1], cmp, metaData)) {
-                    exch(arr, j, j-1);
+                    MeasurableHelper.exch(arr, j, j - 1, metaData);
-                    j = j-1;
+                    j = j - 1;
+                }
             }
         }
     }
 
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if (metaData !=  null)
+            metaData.startTime();
+        coreSortLogic(arr, cmp, metaData);
+        if (metaData !=  null)
+            metaData.endTime();
     }
 
-
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        coreSortLogic(arr, cmp, null);
     }
 
+    @Override
+    public String toString() {
+        return "Insertion Sort";
+    }
+}
+

module5/src/main/java/com/hithomelabs/princeton1/module5/MeasurableHelper.java

@@ -0,0 +1,25 @@
+package com.hithomelabs.princeton1.module5;
+
+import java.util.Comparator;
+
+public interface MeasurableHelper extends ComparatorHelper{
+
+    static <T> boolean less(T v, T w, Comparator<T> cmp, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.incrementCompares();
+        return ComparatorHelper.less(v, w, cmp);
+    }
+
+    static <T> boolean equals(T v, T w, Comparator<T> cmp, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.incrementCompares();
+        return ComparatorHelper.equals(v, w, cmp);
+    }
+
+    static <T> void exch(T[] arr, int j, int i, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.incrementExchanges();
+        ComparableHelper.exch(arr, j, i);
+    }
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/MeasurableSort.java

@@ -0,0 +1,9 @@
+package com.hithomelabs.princeton1.module5;
+
+import java.util.Comparator;
+
+public interface MeasurableSort<E> extends ComparatorSort<E> {
+
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData);
+
+}

module5/src/main/java/com/hithomelabs/princeton1/module5/Selection.java

@@ -1,23 +1,47 @@
 package com.hithomelabs.princeton1.module5;
 
 
-public class Selection<E> extends AbstractCustomSorts<E>{
+import java.util.Comparator;
+
+public class Selection<E> implements MeasurableSort<E>, MeasurableHelper {
 
     /*
     * * Selection sort "selects" the smallest element and swaps it with arr[0] of the array
     * * Then proceeds to do the same swapping arr[i] with arr[i:arr.length-1]
     */
     public void sort(E[] arr){
+        coreSortLogic(arr, null, null);
+    }
+
+    private void coreSortLogic(E[] arr, Comparator<E> cmp, SortingMetaData metaData){
         if (arr ==  null) return;
         Comparable<E>[] arr1 = (Comparable<E>[]) arr;
         for(int i = 0; i < arr1.length - 1; i++){
             int minIndex = i;
             for(int j = i+1; j < arr.length; j ++){
-                if (less((Comparable<E>) arr[j], arr[minIndex])) minIndex = j;
+                if (MeasurableHelper.less(arr[j], arr[minIndex], cmp, metaData)) minIndex = j;
             }
-            exch(arr, i, minIndex);
+            MeasurableHelper.exch(arr, i, minIndex, metaData);
         }
     }
 
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.startTime();
+        coreSortLogic(arr, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+    }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        coreSortLogic(arr, cmp, null);
+    }
+
+    @Override
+    public String toString() {
+        return "Selection Sort";
+    }
 }
 

module5/src/main/java/com/hithomelabs/princeton1/module5/Shell.java

@@ -1,13 +1,9 @@
 package com.hithomelabs.princeton1.module5;
 
-public class Shell<E> extends AbstractCustomSorts<E> {
+import java.util.ArrayList;
+import java.util.Comparator;
 
-    // * * sample metadata class to compare no. of sorts and compares, shell sort vs insertion sort
+public class Shell<E> implements MeasurableSort<E>, MeasurableHelper {
-    private class MetaData{
-
-        int compares;
-        int swaps;
-    }
 
 /*
  * * We will be performing h sort
@@ -24,7 +20,10 @@ public class Shell<E> extends AbstractCustomSorts<E> {
  */
     @Override
     public void sort(E[] arr) {
-        MetaData metaData = new MetaData();
+        coreSortLogic(arr,null,null);
+    }
+
+    private void coreSortLogic(E[] arr, Comparator<E> cmp, SortingMetaData metaData){
         int N = arr.length;
         int h = 1;
         // * * Calculates the largest value of h greater than n
@@ -32,22 +31,18 @@ public class Shell<E> extends AbstractCustomSorts<E> {
             h = 3 * h + 1;
         }
         while (h >= 1) {
-            h = hsort(arr, h, metaData);
+            h = hsort(arr, h, cmp, metaData);
             h = h / 3;
         }
-        System.out.println("Array sorted (shell sort) with " + metaData.compares + " compares and " + metaData.swaps + " swaps");
     }
 
-    private int hsort(E[] arr, int h, MetaData metadata) {
+    private int hsort(E[] arr, int h, Comparator<E> cmp, SortingMetaData metaData) {
         int N  = arr.length;
         for(int i = h; i < N; i++){
             int j = i;
-            ++metadata.compares;
+            while(j >= h && MeasurableHelper.less(arr[j], arr[j-h], cmp, metaData)){
-            while(j >= h && less((Comparable<E>) arr[j], arr[j-h])){
+                MeasurableHelper.exch(arr, j, j-h, metaData);
-                ++metadata.swaps;
-                exch(arr, j, j-h);
                 j = j - h;
-                ++metadata.compares;
             }
         }
         return h;
@@ -57,10 +52,26 @@ public class Shell<E> extends AbstractCustomSorts<E> {
      * Will just be comparing the number of saps taken across both implementations
     */
     public void insertionSort(E[] arr){
-        MetaData metaData = new MetaData();
         int h = 1;
-        h = hsort(arr, h, metaData);
+        h = hsort(arr, h, null, null);
-        System.out.println("Array sorted (insertion sort) with " + metaData.compares + " compares and " + metaData.swaps + " swaps");
     }
 
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.startTime();
+        coreSortLogic(arr, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+    }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        coreSortLogic(arr, cmp, null);
+    }
+
+    @Override
+    public String toString() {
+        return "Shell Sort";
+    }
 }

module5/src/main/java/com/hithomelabs/princeton1/module5/SortingMetaData.java

@@ -0,0 +1,41 @@
+package com.hithomelabs.princeton1.module5;
+
+public class SortingMetaData {
+
+    private double tick;
+    private double tok;
+    private double exchanges;
+    private double compares;
+
+    public double timeElapsed(){
+        return tok - tick;
+    }
+
+    public void startTime(){
+        tick = System.nanoTime();
+    }
+
+    public void endTime(){
+        tok = System.nanoTime();
+    }
+
+    public void incrementCompares(){
+        ++compares;
+    }
+
+    public void incrementExchanges(){
+        ++exchanges;
+    }
+
+    public double getExchanges(){
+        return exchanges;
+    }
+    public double getCompares(){
+        return compares;
+    }
+
+    @Override
+    public String toString() {
+        return "Time elapsed: " + this.timeElapsed() + " nano-seconds \nCompares: "+this.compares+ "\nSwaps: "+this.exchanges;
+    }
+}

module5/src/test/java/com/hithomelabs/princeton1/module5/SortTest.java

@@ -11,7 +11,7 @@ import java.util.Random;
 class SortTest {
 
     private ArrayList<Apple> apples;
-    private AbstractCustomSorts<Apple> sortingAlgorithm;
+    private ComparableSort<Apple> sortingAlgorithm;
     private Random random;
 
     @BeforeEach
@@ -21,7 +21,7 @@ class SortTest {
         random = new Random();
     }
 
-    private void testSort(AbstractCustomSorts<Apple> sortingAlgorithm) {
+    private void testSort(ComparableSort<Apple> sortingAlgorithm) {
         for (int i = 0; i < 100; i++)
             apples.add(new Apple(random.nextInt(100)));
 

module6/src/main/java/com/hithomelabs/princeton1/module6/Merge.java

@@ -1,46 +1,79 @@
 package com.hithomelabs.princeton1.module6;
 
-import com.hithomelabs.princeton1.module5.AbstractCustomSorts;
+import com.hithomelabs.princeton1.module5.ComparableSort;
+import com.hithomelabs.princeton1.module5.MeasurableHelper;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
 
 import java.util.Arrays;
+import java.util.Comparator;
 
-public class Merge<E> extends AbstractCustomSorts<E> {
+public class Merge<E> implements MeasurableSort<E>, MeasurableHelper {
     @Override
     public void sort(E[] arr) {
+        coreSortLogic(arr, null, null);
+    }
 
+    private void coreSortLogic(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
         int N = arr.length;
         // * * aux is a helper array required for merge
         E[] aux = Arrays.copyOf(arr, N);
-        mergesort(arr, aux, 0, N-1);
+        mergesort(arr, aux, 0, N - 1, cmp, metaData);
-
     }
 
-    private void mergesort(E[] arr, E[] aux, int lo, int hi) {
+    private void mergesort(E[] arr, E[] aux, int lo, int hi, Comparator<E> cmp, SortingMetaData metaData) {
 
         if (hi <= lo) return;
-        int mid = lo + (hi - lo)/2;
+        int mid = lo + (hi - lo) / 2;
-        mergesort(arr, aux, lo, mid);
+        mergesort(arr, aux, lo, mid, cmp, metaData);
-        mergesort(arr, aux, mid+1, hi);
+        mergesort(arr, aux, mid + 1, hi, cmp, metaData);
-        merge(arr, aux, lo, mid, hi);
+        merge(arr, aux, lo, mid, hi, cmp, metaData);
 
     }
 
-    private void merge(E[] arr, E[] aux, int lo, int mid, int hi) {
+    private void merge(E[] arr, E[] aux, int lo, int mid, int hi, Comparator<E> cmp, SortingMetaData metaData) {
 
         // * * creating backup of original array
         for (int i = lo; i <= hi; i++)
             aux[i] = arr[i];
 
         int i = lo;
-        int j = mid+1;
+        int j = mid + 1;
-        for (int k = lo; k <= hi; k++){
+        for (int k = lo; k <= hi; k++) {
             // * If i has already reached mid, no need to compare we insert at pointer k
-            if(i > mid) arr[k] = aux[j++];
+            if (i > mid) {
-            else if(j > hi) arr[k] = aux[i++];
+                arr[k] = aux[j++];
-            else if(less((Comparable<E>) aux[i], aux[j])) arr[k] = aux[i++];
+                if (metaData != null)
+                    metaData.incrementCompares();
+            } else if (j > hi) {
+                arr[k] = aux[i++];
+                if (metaData != null)
+                    metaData.incrementCompares();
+            } else if (MeasurableHelper.less( aux[i], aux[j], cmp, metaData)) {
+                arr[k] = aux[i++];
+            }
             else arr[k] = aux[j++];
         }
     }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if (metaData != null)
+            metaData.startTime();
+        coreSortLogic(arr, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+    }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        coreSortLogic(arr, cmp, null);
+    }
+
+    @Override
+    public String toString() {
+        return "Merge Sort";
+    }
 }
 
 

module6/src/test/java/com/hithomelabs/princeton1/module6/MergeTest.java

@@ -1,6 +1,6 @@
 package com.hithomelabs.princeton1.module6;
 
-import com.hithomelabs.princeton1.module5.AbstractCustomSorts;
+import com.hithomelabs.princeton1.module5.ComparableSort;
 import com.hithomelabs.princeton1.common.Apple;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
@@ -14,7 +14,7 @@ import static org.junit.jupiter.api.Assertions.*;
 
 class MergeTest {
 
-    private AbstractCustomSorts<Apple> sortingAlgorithm;
+    private ComparableSort<Apple> sortingAlgorithm;
     private ArrayList<Apple> apples;
     private Random random;
 

module7/src/main/java/com/hithomelabs/princeton1/module7/Quick.java

@@ -1,13 +1,17 @@
 package com.hithomelabs.princeton1.module7;
 
-import com.hithomelabs.princeton1.module5.AbstractCustomSorts;
+import com.hithomelabs.princeton1.module5.MeasurableHelper;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
+
+import java.util.Comparator;
 
 
-public class Quick<E> extends AbstractCustomSorts<E> {
+    public class Quick<E> implements MeasurableSort<E>, MeasurableHelper {
     @Override
     public void sort(E[] arr) {
         int N = arr.length;
-        quickSort(arr, 0, N - 1);
+        quickSort(arr, 0, N - 1, null, null);
     }
 
     public void altSort(E[] arr) {
@@ -20,35 +24,56 @@ public class Quick<E> extends AbstractCustomSorts<E> {
         int i = lo + 1;
         int j = i;
         while(j <= hi){
-            if(less((Comparable<E>) arr[j], arr[lo])){
+            if(MeasurableHelper.less((Comparable<E>) arr[j], arr[lo], null, null)){
-                exch(arr, i, j);
+                MeasurableHelper.exch(arr, i, j, null);
                 i++;
             }
             j++;
         }
-        exch(arr, i-1, lo);
+        MeasurableHelper.exch(arr, i-1, lo,null);
         altQuickSort(arr, lo, i-2);
         altQuickSort(arr, i, hi);
     }
 
-    private void quickSort(E[] arr, int lo, int hi) {
+    private void quickSort(E[] arr, int lo, int hi, Comparator<E> cmp, SortingMetaData metaData) {
 
         if (lo >= hi) return;
         int i = lo;
         int j = hi+1;
         while(true){
-            while(less((Comparable<E>) arr[++i], arr[lo])){
+            while(MeasurableHelper.less( arr[++i], arr[lo], cmp, metaData)){
                 if(i == hi) break;
             }
-            while(!less((Comparable<E>) arr[--j], arr[lo])){
+            while(!MeasurableHelper.less(arr[--j], arr[lo], cmp, metaData)){
                 if (j == lo ) break;
             }
             if(j<=i) break;
-            exch(arr, i , j);
+            MeasurableHelper.exch(arr, i , j, metaData);
         }
-        exch(arr, j, lo);
+        MeasurableHelper.exch(arr, j, lo, metaData);
-        quickSort(arr, lo, j-1);
+        quickSort(arr, lo, j-1, cmp, metaData);
-        quickSort(arr, j+1, hi);
+        quickSort(arr, j+1, hi, cmp, metaData);
 
     }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        int N = arr.length;
+        quickSort(arr, 0, N - 1, cmp, null);
+    }
+
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if(metaData != null){
+            metaData.startTime();
+        }
+        int N = arr.length;
+        quickSort(arr, 0, N - 1, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+    }
+
+        @Override
+        public String toString() {
+            return "Quick Sort";
+        }
 }

module7/src/main/java/com/hithomelabs/princeton1/module7/ThreeWayQuick.java

@@ -0,0 +1,58 @@
+package com.hithomelabs.princeton1.module7;
+
+import com.hithomelabs.princeton1.module5.MeasurableHelper;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
+
+import java.util.Comparator;
+
+public class ThreeWayQuick<E> implements MeasurableSort<E>, MeasurableHelper {
+    @Override
+    public void sort(E[] arr) {
+        coreSortingLogic(arr, null, null);
+    }
+
+    private void coreSortingLogic(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        int N = arr.length;
+        threeWaySort(arr, 0, N - 1, cmp, metaData);
+    }
+
+    private void threeWaySort(E[] arr, int lo, int hi, Comparator<E> cmp, SortingMetaData metaData) {
+
+        if (hi <= lo)
+            return;
+        int k = hi;
+        int i = lo + 1;
+        int j = lo;
+
+        while (true) {
+            if (MeasurableHelper.less(arr[i], arr[j], cmp, metaData)) MeasurableHelper.exch(arr, i++, j++, metaData);
+            else if (MeasurableHelper.equals(arr[i],arr[j], cmp, metaData)) i++;
+            else MeasurableHelper.exch(arr, i, k--, metaData);
+            if (k < i) break;
+        }
+        threeWaySort(arr, lo, j - 1, cmp, metaData);
+        threeWaySort(arr, k + 1, hi, cmp, metaData);
+    }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        if(metaData != null){
+            metaData.startTime();
+        }
+        coreSortingLogic(arr, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+    }
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        coreSortingLogic(arr, cmp, null);
+    }
+
+    @Override
+    public String toString() {
+        return "Three Way Quick Sort";
+    }
+
+}

module7/src/test/java/com/hithomelabs/princeton1/module7/QuickTest.java

@@ -34,7 +34,7 @@ class QuickTest {
     }
 
     @Test
-    @DisplayName("testing Quick sort default implementation")
+    @DisplayName("testing Quick sort alternate implementation")
     public void testAltSort(){
 
         for(int i = 0; i < 100; i++)
@@ -46,6 +46,18 @@ class QuickTest {
         Assertions.assertArrayEquals(sorted, arr);
     }
 
+    @Test
+    @DisplayName("testing Comparator sort")
+    public void testComparatorSort(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(random.nextInt(1000)));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        quick.sort(arr, Apple.COMPARE_BY_SIZE);
+        apples.sort(Apple.COMPARE_BY_SIZE);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
 
     @AfterEach
     void tearDown() {

module7/src/test/java/com/hithomelabs/princeton1/module7/ThreeWayQuickTest.java

@@ -0,0 +1,54 @@
+package com.hithomelabs.princeton1.module7;
+
+import com.hithomelabs.princeton1.common.Apple;
+import org.junit.jupiter.api.*;
+
+import java.util.ArrayList;
+import java.util.Random;
+
+import static org.junit.jupiter.api.Assertions.*;
+class ThreeWayQuickTest {
+
+    private ThreeWayQuick<Apple> quick;
+    private ArrayList<Apple> apples;
+    private Random random;
+
+    @BeforeEach
+    void setUp() {
+        quick = new ThreeWayQuick<Apple>();
+        apples = new ArrayList<Apple>();
+        random = new Random();
+    }
+
+    @Test
+    @DisplayName("testing Quick sort default implementation")
+    public void testSort(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(random.nextInt(1000)));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        quick.sort(arr);
+        apples.sort(null);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
+    @Test
+    @DisplayName("testing Comparator sort")
+    public void testComparatorSort(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(random.nextInt(1000)));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        quick.sort(arr, Apple.COMPARE_BY_SIZE);
+        apples.sort(Apple.COMPARE_BY_SIZE);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
+
+    @AfterEach
+    void tearDown() {
+        quick = null;
+        apples = null;
+        random = null;
+    }
+}

module8/build.gradle

@@ -0,0 +1,21 @@
+plugins {
+    id 'java'
+}
+
+group = 'com.hithomelabs.princeton1.module8'
+version = 'unspecified'
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    testImplementation platform('org.junit:junit-bom:5.10.0')
+    testImplementation 'org.junit.jupiter:junit-jupiter'
+    implementation project(':module5')
+    testImplementation project(':common')
+}
+
+test {
+    useJUnitPlatform()
+}

module8/src/main/java/com/hithomelabs/princeton1/module8/Heap.java

@@ -0,0 +1,44 @@
+package com.hithomelabs.princeton1.module8;
+
+/*
+ * * Designing Heap as a wrapper class with static methods that perform sink and swim operations on underlying comparable[] array
+ * * Heap does not have any instance variables, instance variables shall be housed by, the implementation using heaps, like priority queues and heap sort
+ */
+
+
+import com.hithomelabs.princeton1.module5.MeasurableHelper;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
+
+import java.util.Comparator;
+
+public class Heap implements MeasurableHelper {
+
+    /*
+    * * Sink Node T with to it's appropriate place in a Heap of size N, if it's children exist and are greater
+    */
+    public static <T> void sink(T[] arr, int root, int N, Comparator<T> cmp, SortingMetaData metaData){
+        // *  Check if at least one child exists
+        while(2 * root <= N){
+            int j = 2 * root;
+        // *  Check if the right child exists and is larger than the left child, if yes swap right and left child
+            if(j+1 <= N){
+                if (MeasurableHelper.less(arr[j], arr[j+1], cmp, metaData)) j++;
+            }
+            if (!MeasurableHelper.less(arr[root], arr[j], cmp, metaData)) break;
+            MeasurableHelper.exch(arr, root, j, metaData);
+        // * The root node has now sunken low, call sink recursively with new node to check if it sinks further
+            root = j;
+        }
+    }
+
+    // * * Swim if element is not root, and parent is lesser than node
+    public static <T extends Comparable<T>> void swim(T[] arr, int node, int N, Comparator<T> cmp, SortingMetaData metaData){
+        while(node > 1){
+            if(! MeasurableHelper.less(arr[node/2],arr[node], cmp, metaData)) break;
+            MeasurableHelper.exch(arr, node, node/2, metaData);
+            node = node/2;
+        }
+    }
+
+
+}

module8/src/main/java/com/hithomelabs/princeton1/module8/HeapSort.java

@@ -0,0 +1,78 @@
+package com.hithomelabs.princeton1.module8;
+
+import com.hithomelabs.princeton1.module5.MeasurableHelper;
+import com.hithomelabs.princeton1.module5.MeasurableSort;
+import com.hithomelabs.princeton1.module5.SortingMetaData;
+
+import java.util.Comparator;
+
+
+public class HeapSort<E> implements MeasurableSort<E>, MeasurableHelper {
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp, SortingMetaData metaData) {
+        int N = arr.length;
+        E[] heapArr = (E[]) new Object[N+1];
+        // * * to simplify we copy original array from
+        System.arraycopy(arr, 0, heapArr, 1, N);
+        // * * An array of size N holds a heap of size N-1
+        if (metaData != null)
+            metaData.startTime();
+        coreSortingLogic(heapArr, N, cmp, metaData);
+        if (metaData != null)
+            metaData.endTime();
+        System.arraycopy(heapArr, 1, arr, 0, N);
+    }
+
+    public static <T> void heapify(T[] arr){
+        int N = arr.length;
+        T[] heapArr = (T[]) new Object[N+1];
+        // * * to simplify we copy original array from
+        System.arraycopy(arr, 0, heapArr, 1, N);
+        // * * An array of size N holds a heap of size N-1
+        for (int i = N/2; i >= 1; i--)
+            Heap.sink(heapArr, i, N, null, null);
+        System.arraycopy(heapArr, 1, arr, 0, N);
+    }
+
+    private void coreSortingLogic(E[] arr, int N, Comparator<E> cmp, SortingMetaData metaData) {
+        // * * Converting array to max-heap an array in place
+        for (int i = N/2; i >= 1; i--)
+            Heap.sink(arr, i, N, cmp, metaData);
+        // * * After converting to max-heap, in every iteration remove the max element of the heap
+        while(N > 1){
+            MeasurableHelper.exch(arr, 1, N--, metaData);
+            Heap.sink(arr, 1, N, cmp, metaData);
+        }
+    }
+
+
+    @Override
+    public void sort(E[] arr, Comparator<E> cmp) {
+        int N = arr.length;
+        E[] heapArr = (E[]) new Object[N+1];
+        // * * to simplify we copy original array from
+        System.arraycopy(arr, 0, heapArr, 1, N);
+
+        // * * An array of size N holds a heap of size N-1
+        coreSortingLogic(heapArr, N, cmp, null);
+        System.arraycopy(heapArr, 1, arr, 0, N);
+    }
+
+    @Override
+    public void sort(E[] arr) {
+        int N = arr.length;
+        E[] heapArr = (E[]) new Object[N+1];
+        // * * to simplify we copy original array from
+        System.arraycopy(arr, 0, heapArr, 1, N);
+
+        // * * An array of size N holds a heap of size N-1
+        coreSortingLogic(heapArr, N,null, null);
+        System.arraycopy(heapArr, 1, arr, 0, N);
+    }
+
+    @Override
+    public String toString() {
+        return "Heap Sort";
+    }
+}

module8/src/test/java/com/hithomelabs/princeton1/module8/HeapSortTest.java

@@ -0,0 +1,63 @@
+package com.hithomelabs.princeton1.module8;
+
+import com.hithomelabs.princeton1.common.Apple;
+import org.junit.jupiter.api.*;
+
+import java.util.ArrayList;
+import java.util.Random;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+class HeapSortTest {
+
+    private HeapSort<Apple> heap;
+    private ArrayList<Apple> apples;
+    private Random random;
+
+    @BeforeEach
+    void setUp() {
+        heap = new HeapSort<Apple>();
+        apples = new ArrayList<Apple>();
+        random = new Random();
+    }
+
+    @Test
+    @DisplayName("Sort a heap of a 100 random sized apples")
+    public void testSort(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(random.nextInt(1000)));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        heap.sort(arr);
+        apples.sort(null);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
+    @Test
+    @DisplayName("Sort a heap of a 100 random sized  with Comparator")
+    public void testComparatorSort(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(random.nextInt(1000)));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        heap.sort(arr, Apple.COMPARE_BY_SIZE);
+        apples.sort(Apple.COMPARE_BY_SIZE);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
+    @Test
+    @DisplayName("Sort 100 apples in descending order")
+    public void testSortBorder(){
+        for(int i = 0; i < 100; i++)
+            apples.add(new Apple(100 - i));
+        Apple[] arr = apples.toArray(new Apple[apples.size()]);
+        heap.sort(arr);
+        apples.sort(null);
+        Apple[] sorted =  apples.toArray(new Apple[apples.size()]);
+        Assertions.assertArrayEquals(sorted, arr);
+    }
+
+    @AfterEach
+    void tearDown() {
+    }
+}

settings.gradle

@@ -17,4 +17,5 @@ include 'module5'
 include 'module6'
 include 'common'
 include 'module7'
+include 'module8'