Repository navigation

49 add union find data structure - #62

Open

c-m-elliott wants to merge 194 commits into

mainfrom

49-add-union-find-data-structure

Commits on May 25, 2026
- Add first draft for potential MutableUnionFind interface
  Colleen
  committed
  63a45e6
Commits on Jun 7, 2026
- Rename MutableUnionFind interface to simply UnionFind
  Colleen
  committed
  137ad6e
- Update methods specified in interface UnionFind
  Colleen
  committed
  a6820bf
- Merge branch 'main' into 49-add-union-find-data-structure
  Colleen
  committed
  42aa243
- Add class MutableUnionFind including empty method bodies and constructor implementation
  Colleen
  committed
  cb5d31d
- Implement getAllSubsets in MutableUnionFind
  Colleen
  committed
  27a7728
- Implement addElementToNewSet in MutableUnionFind and capture current concerns and notes in a comment
  Colleen
  committed
  7d0afc7
- Rename MutableUnionFind to UnsortedUnionFind and alter uses of HashSet for subsets to HashMap
  Colleen
  committed
  33e3326
Commits on Jun 8, 2026
- Implement find as HashMap version in UnsortedUnionFind; contains type mismatches that will be sorted out later on if I decide to stick with HashMaps
  Colleen
  committed
  b301753
- Declare type for whole classes and add rough implementation of union by size in UnsortedUnionFind
  Colleen
  committed
  4c52fc0
Commits on Jun 9, 2026
- Continue implementing several methods in UnsortedUnionFind and add new private method contains(T e)
  Colleen
  committed
  5baa93d
- Add addNewSet(Set<T> input) to UnsortedUnionFind; might end up replacing addSetOfSets
  Colleen
  committed
  24e376b
- Add notes for further work to UnsortedUnionFind
  Colleen
  committed
  00d285d
- Add new class SortedUnionFind; still missing all method bodies
  Colleen
  committed
  6e04f27
- Change all uses of put() to putIfAbsent() in UnsortedUnionFind to ensure maps fulfil set requirement
  Colleen
  committed
  a7959db
Commits on Jun 11, 2026
- Remove superfluous methods from interface UnionFind
  Colleen
  committed
  831ec68
- Implement large portion of methods in SortedUnionFind
  Colleen
  committed
  cb0ca0e
- Rename SortedUnionFind to SortedTreeSetUnionFind
  Colleen
  committed
  b2902e2
- Add new interface SortedUnionFind
  Colleen
  committed
  fdcd004
- Add contains() to UnionFind
  Colleen
  committed
  eaadc94
- Change SortedTreeSetUnionFind to implement SortedUnionFind instead of UnionFind
  Colleen
  committed
  b12540f
- Adapt UnsortedUnionFind to interface alterations
  Colleen
  committed
  d9b5dc3
- Delete UnsortedUnionFind as currently not planning on using it
  Colleen
  committed
  41ae904
- Implement find() in SortedTreeSetUnionFind and refactor mergeExistingSets a little
  Colleen
  committed
  188b203
Commits on Jun 12, 2026
- Revert back to direct constructor call instead of getEmptyInstanceOf() as static method problematic due to variable type
  Colleen
  committed
  88f484d
- Make SortedTreeSetUnionFind's constructor public
  Colleen
  committed
  b432119
Commits on Jun 17, 2026
- Fix compilation errors due to forbidden types etc. in SortedTreeSetUnionFind; adapt interfaces accordingly
  Colleen
  committed
  94f1d26
- Add SortedUnionFindTest with setup and first few tests; needs further work though
  Colleen
  committed
  97b7bd3
- Add test to assure union keeps correct canonical element after union by size in SortedUnionFindTest
  Colleen
  committed
  2bafeee
- Make test name more specific in SortedUnionFindTest
  Colleen
  committed
  3e1f07a
- Add test that covers mergeExistingSets() in SortedUnionFindTest
  Colleen
  committed
  9504ebb
- A couple small style fixes
  Colleen
  committed
  15e7096
Commits on Jun 18, 2026
- Change variable declarations from classes to interfaces where needed in SortedTreeSetUnionFind
  Colleen
  committed
  f4c5213
- Change variable declarations from classes to interfaces where needed in SortedTreeSetUnionFind
  Colleen
  committed
  0ee0893
- Add missing edge case in union() in SortedTreeSetUnionFind
  Colleen
  committed
  71b0f16
Commits on Jun 19, 2026
- Fix bug in addToExistingSet() in SortedTreeSetUnionFind
  Colleen
  committed
  d07c875
- Add testUnion_InsertingDuplicateElementFails() in SortedUnionFindTest
  Colleen
  committed
  0a8f5ec
- Remove testUnion_InsertingDuplicateElementFails() in SortedUnionFindTest for now as it does not meet codestyle requirements and a quick fix is not available at the moment
  Colleen
  committed
  469685f
- Add testUnion_ConstantCanonicalElementDuringNonlinearInsertion() in SortedUnionFindTest to ensure the canonical elements of subsets do not change at times they shouldn't (during union by size)
  Colleen
  committed
  3e42ae7
- Switch usage of Set to Map to facilitate tracking each subset's canonical element in UnionFind and SortedUnionFind
  Colleen
  committed
  f765a9c
- Implement changes to interface (exchange Set for Map) in SortedTreeSetUnionFind
  Colleen
  committed
  6221788
- Remove resolved TODO notes in SortedTreeSetUnionFind
  Colleen
  committed
  7a17558
Commits on Jun 23, 2026
- Add documentation to UnionFind
  Colleen
  committed
  a3ce540
- Add documentation to SortedUnionFind
  Colleen
  committed
  493a220
- Add documentation to SortedTreeSetUnionFind
  Colleen
  committed
  7370d47
- Declare type T to be of Comparable in SortedUnionFind and SortedTreeSetUnionFind
  Colleen
  committed
  61437f3
- Add AbstractImmutableUnionFind
  Colleen
  committed
  352907c
- Add AbstractImmutableSortedUnionFind
  Colleen
  committed
  92088a1
- Add fix to stop SortedTreeSetUnionFind from failing "test nulls"; not entirely sure what I did though so someone qualified will need to look it over
  Colleen
  committed
  d2234c8
Commits on Jun 25, 2026
- Remove find() from deprecated methods; shouldn't have ended up there in the first place
  Colleen
  committed
  fca3102
- Add interface PersistentSortedUnionFind
  Colleen
  committed
  4dd0356
- Add interface PersistentUnionFind
  Colleen
  committed
  f7ebd96
- Add documentation to PersistentUnionFind and PersistentSortedUnionFind
  Colleen
  committed
  89e3a79
Commits on Jun 26, 2026
- Check input values are not null in SortedTreeSetUnionFind
  Colleen
  committed
  f452274
- Refactor union() to not through unnecessary exceptions in SortedTreeSetUnionFind
  Colleen
  committed
  a0dacef
- Refactor union() to not through unnecessary exceptions in SortedTreeSetUnionFind
  Colleen
  committed
  56133be
Commits on Jul 3, 2026
- Merge branch 'main' into 49-add-union-find-data-structure
  Colleen
  committed
  2f01c62
Commits on Jul 5, 2026
- Add beginnings of additional tests in SortedUnionFindTest; not done yet but needing to save progress
  Colleen
  committed
  efc2bcb
Commits on Jul 7, 2026
- Remove previously commited nested classes from SortedUnionFindTest as they are not helpful
  Colleen
  committed
  9f939ba
- Add testUnion_Strings() to SortedUnionFindTest
  Colleen
  committed
  2f4969d
- Correct test syntax and add more variety to test cases in testUnion_Strings() in SortedUnionFindTest
  Colleen
  committed
  0782511
- Correct test syntax in SortedUnionFindTest
  Colleen
  committed
  37770d5
Commits on Jul 9, 2026
- Make result comparison more straightforward in SortedUnionFindTest
  Colleen
  committed
  9334994
- Attempt to fix (but not yet succeed) subset removal bug in SortedTreeSetUnionFind
  Colleen
  committed
  ea44c05
- Mark new bug discovery in SortedUnionFindTest
  Colleen
  committed
  ee6fb37
Commits on Jul 10, 2026
- Fix bug in SortedUnionFindTest (was comparing Integer to String)
  Colleen
  committed
  9c86ef7
- Fix union bug in SortedTreeSetUnionFind
  Colleen
  committed
  9b27c60
- Add separate test class for benchmarking UnionFind called UnionFindSimpleBenchmarkTest;
  Colleen
  committed
  5917c15
- Reduce method calls in UnionFindSimpleBenchmarkTest
  Colleen
  committed
  d67006e
- Fix UnionFindSimpleBenchmarkTest that it finishes within a reasonable amount of time; only for small values though;
  Colleen
  committed
  69f5fa6
- Replace recursion with iterative approach in UnionFindSimpleBenchmarkTest; the maths still needs sorting out though
  Colleen
  committed
  1898af1
Commits on Jul 14, 2026
- Correct calculations in UnionFindSimpleBenchmarkTest
  Colleen
  committed
  52571a8
- Increase magnitudes slightly in UnionFindSimpleBenchmarkTest
  Colleen
  committed
  5d6cca6
Commits on Jul 16, 2026
- Move all UnionFind classes to new subpackage union_find
  Colleen
  committed
  2dab552
- Rename variable as previous name was misleading
  Colleen
  committed
  43b4aaa
- Ignore benchmark test as it is not intended as part of the regular UnionFind test suite due to time and memory constraints
  Colleen
  committed
  61278c7
- Add AbstractGenericUnionFind as basis for further union-find implementations
  Colleen
  committed
  919356e
- Ignore whole benchmark test class instead of just test method
  Colleen
  committed
  6bee232
- Move AbstractGenericUnionFind to union_find package
  Colleen
  committed
  9f69580
- Fic bug causing build to fail (incorrect warning suppression)
  Colleen
  committed
  af996d2
- Add package-info.java to union_find package
  Colleen
  committed
  344cd5f
- Make SortedTreeSetUnionFind extend AbstractGenericUnionFind
  Colleen
  committed
  761acec
Commits on Jul 17, 2026
- Correct package info
  Colleen
  committed
  e9e53d7
- Rework how AbstractGenericUnionFind gets correct types from subclasses
  Colleen
  committed
  eb1c8b8
- Remove superfluous super() call in SortedTreeSetUnionFind constructor
  Colleen
  committed
  599310b
Commits on Jul 21, 2026
- format-source
  Colleen
  committed
  4de8043
Commits on Jul 22, 2026
- Refactor AbstractGenericUnionFind to remove unnecessary code
  Colleen
  committed
  220ec5c
Commits on Jul 23, 2026
- Use sorted data structure for mapOfSets (previously only for subsets) in SortedUnionFind
  Colleen
  committed
  1834c73
- Refactor AbstractGenericUnionFind to simplify awkward code
  Colleen
  committed
  3a54e64
- Refactor AbstractGenericUnionFind to simplify awkward code
  Colleen
  committed
  a180bcc
- UnionFindSimpleBenchmarkTest: make test parameterized and add 2 TODOs and commented out debug output (designed together with c-m-elliott in a meeting)
  baierd
  committed
  b9efedc
- Add class TreeNode for parent-pointer tree
  Colleen
  committed
  056f4e1
- Add static creation methods in TreeNode; make parent null in root nodes for now
  Colleen
  committed
  a93864c
- Add simple ParentPointerTree class that uses TreeNode
  Colleen
  committed
  47a8e3f
- Code format and tiny fixes
  Colleen
  committed
  ebb1322
- Add skeleton of ParentPointerTreeUnionFind
  Colleen
  committed
  9b9be09
Commits on Jul 24, 2026
- Implement most methods of ParentPointerTreeUnionFind and add required helper methods to ParentPointerTree
  Colleen
  committed
  87a1fb1
- Implement missing methods in ParentPointerTreeUnionFind and add required helper methods to ParentPointerTree;
  Colleen
  committed
  2a7248f
- Avoid null value in TreeNode and bug fix
  Colleen
  committed
  5dfd680
- Make TreeNode a final class
  Colleen
  committed
  aedbd22
- Add mapping of each value to its node in ParentPointerTree and adapt methods where necessary
  Colleen
  committed
  54b57a8
- Fix build
  Colleen
  committed
  e3d08a9
- Start on improving partition generation in benchmark test
  Colleen
  committed
  a1cd3b9
Commits on Jul 28, 2026
- Implement partition generation in a more scalable way in UnionFindSimpleBenchmarkTest
  Colleen
  committed
  d816adb
- Make refaster happy
  Colleen
  committed
  53c3737
Commits on Aug 12, 2026
- Move union-find tests to subpackage
  Colleen
  committed
  d72cd52
- Write union-find tests for ParentPointerTreeUnionFind
  Colleen
  committed
  3b1644a
- Fix bugs in ParentPointerTreeUnionFind uncovered by tests
  Colleen
  committed
  4341fb0
Commits on Aug 13, 2026
- Add ParentPointerTreeSortedUnionFind
  Colleen
  committed
  166ca86
- Add test class testing only sortedness for ParentPointerTreeSortedUnionFind
  Colleen
  committed
  4f9b6ab
- Rename ParentPointerTreeSortedUnionFind to SortedParentPointerTreeUnionFind
  Colleen
  committed
  b9c6473
- Fix code format
  Colleen
  committed
  c9d7379
- Fix bug in ParentPointerTree causing tree to not be binary
  Colleen
  committed
  fe3ad12
- Add documentation to ParentPointerTreeUnionFind
  Colleen
  committed
  f0320e4
- Add documentation to SortedParentPointerTreeUnionFind
  Colleen
  committed
  8a8f25c
Commits on Aug 14, 2026
- Remove manual size tracking in ParentPointerTree as ArrayList already tracks size actively
  Colleen
  committed
  452c919
- Introduce AbstractTreeNode class
  Colleen
  committed
  face617
- Rename TreeNode to NonRootNode which now extends AbstractTreeNode and functions accordingly
  Colleen
  committed
  8f9a3cb
- Add RootNode which extends AbstractTreeNode and functions accordingly
  Colleen
  committed
  f2ef0f0
- Privatise variables in AbstractTreeNode
  Colleen
  committed
  9293ac0
- Add method for increasing rank in RootNode
  Colleen
  committed
  3fdb15d
- Adapt ParentPointerTreeUnionFind to use new node types and not need the class ParentPointerTree anymore
  Colleen
  committed
  82c9e3c
- Adapt SortedParentPointerTreeUnionFind to use new node types and not need the class ParentPointerTree anymore
  Colleen
  committed
  23793c0
- Fix type parameter in ParentPointerTreeUnionFindSortednessTest
  Colleen
  committed
  be98782
- Delete ParentPointerTree.java
  Colleen
  committed
  4aebe06
- Update existing documentation
  Colleen
  committed
  c9da608
- Code format fixes
  Colleen
  committed
  352a2b6
- Add documentation to new classes
  Colleen
  committed
  f3f3764
- Code format fix
  Colleen
  committed
  842e5c0
- Add union by rank to ParentPointerTreeUnionFind and option to select which union is to be performed via a constructor parameter
  Colleen
  committed
  cba998f
- Update documentation to include union by rank
  Colleen
  committed
  84f91e9
- Update tests to cover both union by size and union by rank
  Colleen
  committed
  06c1648
Commits on Aug 15, 2026
- Add path compression to ParentPointerTreeUnionFind
  Colleen
  committed
  27e702e
- Add implementation of ImmutableParentPointerTreeUnionFind
  Colleen
  committed
  a58eaee
- Increase compatibility between sorted and unsorted union-find versions
  Colleen
  committed
  1f6f4cc
- Add SortedUnionFind interface to SortedParentPointerTreeUnionFind
  Colleen
  committed
  4206ed7
- Change abstract immutable classes to interfaces due to compatibility issues
  Colleen
  committed
  0d464c4
- Change abstract immutable classes to interfaces due to compatibility issues
  Colleen
  committed
  aa3e1f4
- Change abstract immutable classes to interfaces due to compatibility issues
  Colleen
  committed
  57a0fe7
- Add ImmutableSortedParentPointerTreeUnionFind
  Colleen
  committed
  0c9ba04
- Code format fix
  Colleen
  committed
  fee7bf6
- Revert immutable interfaces back to abstract classes due to other compatibility issues
  Colleen
  committed
  f97d033
- Make maps in ImmutableParentPointerTreeUnionFind and ImmutableSortedParentPointerTreeUnionFind immutable
  Colleen
  committed
  0c0d850
- Code format fix
  Colleen
  committed
  90d3479
Commits on Aug 16, 2026
- Logic fix in ParentPointerTreeUnionFind
  Colleen
  committed
  8300628
- Logic fixes in ParentPointerTreeUnionFind and SortedParentPointerTreeUnionFind
  Colleen
  committed
  afec034
- Add PersistentSortedParentPointerTreeUnionFind
  Colleen
  committed
  307b5b0
- Code format fixes
  Colleen
  committed
  f9aa19b
- Code format fixes
  Colleen
  committed
  3bd8648
- Code format fixes
  Colleen
  committed
  c403afd
Commits on Aug 17, 2026
- Refactor method parameter names
  Colleen
  committed
  c835aca
- Add new documentation and refactor existing documentation
  Colleen
  committed
  2f50963
- Code style fixes
  Colleen
  committed
  cc17a11
- Bug fix
  Colleen
  committed
  4800d6c
- Add test class for immutable (unsorted and sorted) parent pointer tree union-finds (does not test sortedness; that will be in a separate test class)
  Colleen
  committed
  d640822
- Add test class for testing sortedness of ImmutableSortedParentPointerTreeUnionFind
  Colleen
  committed
  9a45b3e
- Code format fix
  Colleen
  committed
  7949ab9
- Add PersistentParentPointerTreeUnionFind
  Colleen
  committed
  8b62779
- Add documentation to PersistentParentPointerTreeUnionFind
  Colleen
  committed
  4af6da2
- Add tests for unsorted and sorted parent pointer tree union-finds (sortedness will be tested separately)
  Colleen
  committed
  716a90a
- Code format fixes
  Colleen
  committed
  06a31f3
- Add sortedness tests for PersistentSortedParentPointerTreeUnionFind
  Colleen
  committed
  81b99c8
- Make PersistentParentPointerTreeUnionFind a final class
  Colleen
  committed
  33fb798
- Small bug fixes
  Colleen
  committed
  225cc24
Commits on Aug 18, 2026
- Add add() and addAll() for adding either one or more sets at a time to ParentPointerTreeUnionFind
  Colleen
  committed
  fc834a6
- Add add() and addAll() to builder of ImmutableParentPointerTreeUnionFind
  Colleen
  committed
  8795910
- Add add() and addAll() to builder of ImmutableSortedParentPointerTreeUnionFind
  Colleen
  committed
  a3f499a
- Add AbstractImmutableParentPointerTreeBuilder to avoid code duplication
  Colleen
  committed
  85fdfbb
Commits on Aug 19, 2026
- Add immutable annotations where necessary
  Colleen
  committed
  4ee5fcf
- Add immutable tree nodes
  Colleen
  committed
  36d5aaa
Commits on Aug 20, 2026
- Revert "Add immutable tree nodes"
  Colleen
  committed
  aa10c26
- Suppress immutability warnings where mutable data structures used strictly internally
  Colleen
  committed
  21deda2
- Add private method findNode to ParentPointerTreeUnionFind to simplify union methods slightly
  Colleen
  committed
  3ec0c88
Commits on Sep 2, 2026
- Add benchmarking package and a first benchmarking test
  Colleen
  committed
  cd7c1cd
Commits on Sep 4, 2026
- Add benchmarking test to run on algs4 input
  Colleen
  committed
  6ce45fb
- Add jars for benchmark tests
  Colleen
  committed
  d888c6b
Commits on Sep 7, 2026
- Fix bug in Algs4 test
  Colleen
  committed
  2fb0dfa
- Changes from creating jar
  Colleen
  committed
  9933544
- Changes from creating jar
  Colleen
  committed
  d3455a8
- Modify jar creation to produce clear names and separate manifests
  Colleen
  committed
  07e9a8b
- Add further benchmark test
  Colleen
  committed
  687fa8e
- Add further benchmark test
  Colleen
  committed
  988ee79
- Typo fix
  Colleen
  committed
  a01f37a
- Prevent modifications to immutable Union-Finds after build() has been called
  Colleen
  committed
  12c03eb
- Extend benchmarks to include naive Union-Find implementation
  Colleen
  committed
  1803638
Commits on Sep 8, 2026
- Add set of sets implementation for evaluating UnionFind against something naive
  baierd
  committed
  b75ffbd
- Remove .MF files
  Colleen
  committed
  8eb0aa4
- Remove more files from artifacts that shouldn't be in git
  Colleen
  committed
  5e4f0f9
- Include new naive union-find in benchmark classes
  Colleen
  committed
  22e98d7
- Don't use null as return value for SetOfSetsUnionFind.java
  baierd
  committed
  d2ac186
- Fix refaster for SetOfSetsUnionFind.java
  baierd
  committed
  e5c717e
- Fix refaster 2 for SetOfSetsUnionFind
  baierd
  committed
  44db575
Commits on Sep 9, 2026
- Fix bug in FindNewToOldSingleSetBenchmark
  Colleen
  committed
  537f4ec
- Fix bug in FindNewToOldSingleSetBenchmark
  Colleen
  committed
  0b0643f

Commits

Commits on May 25, 2026

Commits on Jun 7, 2026

Commits on Jun 8, 2026

Commits on Jun 9, 2026

Commits on Jun 11, 2026

Commits on Jun 12, 2026

Commits on Jun 17, 2026

Commits on Jun 18, 2026

Commits on Jun 19, 2026

Commits on Jun 23, 2026

Commits on Jun 25, 2026

Commits on Jun 26, 2026

Commits on Jul 3, 2026

Commits on Jul 5, 2026

Commits on Jul 7, 2026

Commits on Jul 9, 2026

Commits on Jul 10, 2026

Commits on Jul 14, 2026

Commits on Jul 16, 2026

Commits on Jul 17, 2026

Commits on Jul 21, 2026

Commits on Jul 22, 2026

Commits on Jul 23, 2026

Commits on Jul 24, 2026

Commits on Jul 28, 2026

Commits on Aug 12, 2026

Commits on Aug 13, 2026

Commits on Aug 14, 2026