Hoshen–Kopelman algorithm: Difference between revisions

Revision as of 05:03, 12 September 2016

Latest revision as of 04:02, 25 May 2025

(110 intermediate revisions by 40 users not shown)

Line 1:

{{short description|Algorithm for labeling clusters on a grid}}

{{Machine learning bar}}

The '''Hoshen–Kopelman algorithm''' is a simple and efficient [[algorithm]] for labeling [[Cluster analysis|clusters]] on a grid, where the grid is a regular [[Network theory|network]] of cells, with the cells being either occupied or unoccupied. This algorithm is based on a well-known [[Disjoint-set data structure|union-finding algorithm]].<ref>{{Cite web |title=Union-Find Algorithms |url=https://www.cs.princeton.edu/~rs/AlgsDS07/01UnionFind.pdf |url-status=usurped |archive-url=https://web.archive.org/web/20210530054627/https://www.cs.princeton.edu/~rs/AlgsDS07/01UnionFind.pdf |archive-date=2021-05-30 |website=Princeton Computer Science}}</ref> The algorithm was originally described by Joseph Hoshen and [[Raoul Kopelman]] in their 1976 paper "Percolation and Cluster Distribution. I. Cluster Multiple Labeling Technique and Critical Concentration Algorithm".<ref>{{cite journal|url=http://link.aps.org/doi/10.1103/PhysRevB.14.3438|title=Percolation and cluster distribution. I. Cluster multiple labeling technique and critical concentration algorithm|first1=J.|last1=Hoshen|first2=R.|last2=Kopelman|date=15 October 1976|journal=Phys. Rev. B|volume=14|issue=8|pages=3438–3445|via=APS|doi=10.1103/PhysRevB.14.3438|bibcode=1976PhRvB..14.3438H|url-access=subscription}}</ref>

== Percolation theory ==

{{multiple issues|

[[Percolation theory]] is the study of the behavior and [[statistics]] of [[cluster analysis|clusters]] on [[Lattice graph|lattices]]. Suppose we have a large square lattice where each cell can be occupied with the [[probability]] <code>p</code> and can be empty with the probability <code>1&nbsp;–&nbsp;''p''</code>. Each group of neighboring occupied cells forms a cluster. Neighbors are defined as cells having a common side but not those sharing only a corner i.e. we consider the [[Pixel connectivity|4-connected neighborhood]] that is top, bottom, left and right. Each occupied cell is independent of the status of its neighborhood. The number of clusters, the size of each cluster and their distribution are important topics in percolation theory.

{{Capitalization|date=September 2016}}

{{Inappropriate person|date=September 2016}}

{{Dead end|date=September 2016}}

{{Orphan|date=September 2016}}

{{Primary sources|date=September 2016}}

}}

The Hoshen-Kopelman Algorithm is simple and efficient algorithm for labeling [[Cluster_analysis | clusters]] on a grid, where grid is a regular network of cells, where each cell may be <strong>occupied</strong> or <strong>unoccupied</strong>. This algorithm is based on well-known union-finding algorithm. The algorithm was originally described in [http://journals.aps.org/prb/abstract/10.1103/PhysRevB.14.3438 Percolation and Cluster Distribution. I. Cluster Multiple Labeling Technique and Critical Concentration Algorithm] by J. Hoshen and R. Kopelman.

{| style="margin: auto;"

== Percolation Theory ==

|-

[[Percolation_theory|Percolation Theory]] is the study of the behavior and statistics of clusters on [[Lattice_graph | lattices]]. Suppose we have a large square lattice where each cell can be occupied with the [[Probability | probability]] <code>p</code> and empty with probability <code>1 – p</code>. Each group of neighboring occupied cells forms a cluster. Neighbors are defined as cells having a common side but not those sharing only a corner i.e. we consider 4x4 neighborhood. (top, bottom, left, right). Each occupied cell is occupied independently of the status of its neighborhood. The number of clusters, size of each cluster and their distribution are important topics in Percolation Theory.

| <gallery>

Occupied_Grids_P_%3D_0.24.png | {{center|'''Figure (a)'''}}

</gallery>||<gallery>

Occupied_Grids_P_%3D_0.64.png | {{center|'''Figure (b)'''}}

</gallery>|| Consider <code>5x5</code> grids in figures (a) and (b).<br /> In figure (a), the probability of occupancy is <code>p = 6/25 = 0.24</code>.<br /> In figure (b), the probability of occupancy is <code>p = 16/25 = 0.64</code>.

|}

== HoshenHoshen–Kopelman - Kopelman Algorithmalgorithm for cluster finding ==

In this algorithm, we scan through a grid looking for occupied cells and labeling them with cluster labels. The scanning process is called a [[raster scan]]. The algorithm begins with scanning the grid cell by cell and checkchecking ifwhether the cell is occupied, ifor not. If the cell is occupied, then this cellit must be labelledlabeled with a cluster label. This cluster label is decidedassigned based on the neighbors of thethat cell. which(For havethis beenwe previouslyare scannedgoing andto labelled,use and[[Union-find algorithm|Union-Find Algorithm]] which is explained in the next section.) ifIf the cell doesn’t have any occupied neighbors, then a new label is assigned to the cell.<ref name=":0" />

== Union-Findfind Algorithmalgorithm ==

This algorithm is used to represent disjoint sets. Calling the function <code>union(x,y)</code> places items <code>x</code> and <code>y</code> into the same set. A second function <code>find(x)</code> returns a representative member of the set to which <code>x</code> belongs. The representative member of the set containing <code>x</code> is the label we will apply to the cluster to which <code>x</code> belongs. A key to the efficiency of the [[Union-find algorithm|Union-Find Algorithm]] is that the <code>find</code> operation improves the underlying forest data structure that represents the sets, making future <code>find</code> queries more efficient.

The Union-Find Algorithm is a simple method for computing [[Equivalence_class | equivalence classes]]. Calling the function union(x,y) specifies that items x and y are members of the same equivalence class. Because equivalence relations are [[Transitive_relation | transitive]]; all items equivalent to x are equivalent to all items equivalent to y. Thus for any item x, there is a set of items which are all equivalent to x are; this set is the equivalence class of which x is a member. A second function find(x) returns a representative member of the equivalence class to which x belongs.

== Pseudo-CodePseudocode ==

So inDuring the [[raster scan]] of the grid in question, each timewhenever an occupied cell is encountered, aneighboring checkcells isare donescanned to seecheck whether this cell has any neighboring cellsof whothem have already been scanned. If so,we firstfind aalready scanned neighbors, the '''''<code>union'''''</code> operation is performed, to specify that these neighboring cells are in fact members of the same equivalence classset. Then a '''''the<code>find'''''</code> operation is performed to find a representative member of that equivalence classset with which to label the current cell. If,will onbe the other hand, the current cell has no neighbors, it is assigned a new, previously unused, labellabeled. The entire grid is processed in this way. The grid can be raster-scanned a second time, performing only '''''find''''' operations at each cell, to re-label the cells with their final assignment of a representative element.

<strong>Raster Scan and Labeling on the Grid</strong>

On the other hand, if the current cell has no neighbors, it is assigned a new, previously unused, label. The entire grid is processed in this way.

largest_label = 0;

for x in 0 to n_columns {

Following [[pseudocode]] is referred from [https://www.ocf.berkeley.edu/~fricke/ Tobin Fricke's] implementation of the same algorithm.<ref name=":0">{{cite web|url=https://www.ocf.berkeley.edu/~fricke/projects/hoshenkopelman/hoshenkopelman.html |title=The Hoshen-Kopelman Algorithm for cluster identification|first=Tobin |last=Fricke |website=ocf.berkeley.edu |date=2004-04-21 |access-date=2016-09-17}}</ref> On completion, the cluster labels may be found in <code>labels</code>. Not shown is the second raster scan of the grid needed to produce the example output. In that scan, the value at <code>label[x,y]</code> is replaced by <code>find(label[x,y])</code>.

for y in 0 to n_rows {

if occupied[x,y] then

'''Raster Scan and Labeling on the Grid'''

left = occupied[x-1,y];

largest_label = 0;

above = occupied[x,y-1];

label = zeros[n_columns, n_rows]

if (left == 0) and (above == 0) then /* Neither a label above nor to the left. */

labels = [0:n_columns*n_rows] /* Array containing integers from 0 to the size of the image. */

largest_label = largest_label + 1; /* Make a new, as-yet-unused cluster label. */

label[x,y] = largest_label;

for x in 0 to n_columns {

else if (left != 0) and (above == 0) then /* One neighbor, to the left. */

for y in 0 to n_rows {

label[x,y] = find(left);

else if (leftoccupied[x, == 0) and (above != 0)y] then /* One neighbor, above. */

left = label[x-1, y] = find(above);

else /*above Neighbors= BOTH to the left and above.label[x, */y-1];

if (left == 0) and union(left,above == 0); then /* LinkNeither thea left andlabel above clustersnor to the left. */

largest_label = largest_label + 1; /* Make a new, as-yet-unused cluster label. */

label[x,y] = find(left);

label[x, y] = largest_label;

}

else if (left != 0) and (above == 0) then /* One neighbor, to the left. */

}

label[x, y] = find(left);

<strong>Union</strong>

else if (left == 0) and (above != 0) then /* One neighbor, above. */

void union(int x, int y) {

labels label[find(x), y] = find(yabove);

else /* Neighbors BOTH to the left and above. */

}

union(left,above); /* Link the left and above clusters. */

<strong>Find</strong>

label[x, y] = find(left);

int find(int x) {

int y = x;}

}

while (labels[y] != y)

y = labels[y];

'''Union'''

while (labels[x] != x) {

void union(int x, int y) {

int z = labels[x];

labels[find(x)] = find(y);

}

x = z;

}

'''Find'''

return y;

int find(int x) {

}

int y = x;

while (labels[y] != y)

y = labels[y];

while (labels[x] != x) {

int z = labels[x];

labels[x] = y;

x = z;

}

return y;

}

== Example ==

Consider the following example. The dark cells in the grid in Figure (c) represent that they are occupied and the white ones are empty. So by running H–K algorithm on this input we would get the output as shown in Figure (d) with all the clusters labeled.

{{empty section|date=September 2016}}

The algorithm processes the input grid, cell by cell, as follows: Let's say that grid is a two-dimensional array.

* Starting from cell <code>grid[0][0]</code> i.e. the first cell. The cell is occupied and it doesn't have cells to the left or above so we will label this cell with a new label say <code>1</code>.

* <code>grid[0][1]</code> and <code>grid[0][2]</code> both are unoccupied so they are not labeled.

* <code>grid[0][3]</code> is occupied so check cell to the left which is unoccupied so we increment the current label value and assign the label to the cell as <code>2</code>.

* <code>grid[0][4]</code>, <code>grid[0][5]</code> and <code>grid[1][0]</code> are unoccupied so they are not labeled.

* <code>grid[1][1]</code> is occupied so check cell to the left and above, both the cells are unoccupied so assign a new label <code>3</code>.

* <code>grid[1][2]</code> is occupied so check cell to the left and above, only the cell to the left is occupied so assign the label of a cell on the left to this cell <code>3</code>.

* <code>grid[1][3]</code> is occupied so check cell to the left and above, both the cells are occupied, so merge the two clusters and assign the cluster label of the cell above to the cell on the left and to this cell i.e. <code>2</code>. (Merging using union algorithm will label all the cells with label <code>3</code> to <code>2</code>)

* <code>grid[1][4]</code> is occupied so check cell to the left and above, only the cell to the left is occupied so assign the label of a cell on the left to this cell <code>2</code>.

* <code>grid[1][5]</code> , <code>grid[2][0]</code> and <code>grid[2][1]</code> are unoccupied so they are not labeled.

* <code>grid[2][2]</code> is occupied so check cell to the left and above, only cell above is occupied so assign the label of the cell above to this cell <code>2</code>.

* <code>grid[2][3]</code> , <code>grid[2][4]</code> and <code>grid[2][5]</code> are unoccupied so they are not labeled.

* <code>grid[3][0]</code> is occupied so check cell above which is unoccupied so we increment the current label value and assign the label to the cell as <code>4</code>.

* <code>grid[3][1]</code> is occupied so check cell to the left and above, only the cell to the left is occupied so assign the label of the cell on the left to this cell <code>4</code>.

* <code>grid[3][2]</code> is unoccupied so it is not labeled.

* <code>grid[3][3]</code> is occupied so check cell to the left and above, both the cells are unoccupied so assign a new label <code>5</code>.

* <code>grid[3][4]</code> is occupied so check cell to the left and above, only the cell to the left is occupied so assign the label of the cell on the left to this cell <code>5</code>.

* <code>grid[3][5]</code> , <code>grid[4][0]</code> and <code>grid[4][1]</code> are unoccupied so they are not labeled.

* <code>grid[4][2]</code> is occupied so check cell to the left and above, both the cells are unoccupied so assign a new label <code>6</code>.

* <code>grid[4][3]</code> is occupied so check cell to the left and above, both, cell to the left and above are occupied so merge the two clusters and assign the cluster label of the cell above to the cell on the left and to this cell i.e. <code>5</code>. (Merging using union algorithm will label all the cells with label <code>6</code> to <code>5</code>).

* <code>grid[4][4]</code> is unoccupied so it is not labeled.

* <code>grid[4][5]</code> is occupied so check cell to the left and above, both the cells are unoccupied so assign a new label <code>7</code>.

* <code>grid[5][0]</code> , <code>grid[5][1]</code> , <code>grid[5][2]</code> and <code>grid[5][3]</code> are unoccupied so they are not labeled.

* <code>grid[5][4]</code> is occupied so check cell to the left and above, both the cells are unoccupied so assign a new label <code>8</code>.

* <code>grid[5][5]</code> is occupied so check cell to the left and above, both, cell to the left and above are occupied so merge the two clusters and assign the cluster label of the cell above to the cell on the left and to this cell i.e. <code>7</code>. (Merging using union algorithm will label all the cells with label <code>8</code> to <code>7</code>).

{| style="margin: auto;"

|-

| <gallery>

H-K algorithm Input.png | {{center|'''Figure (c)'''}}

</gallery>||<gallery>

H-K algorithm output.png | {{center|'''Figure (d)'''}}

</gallery>|| Consider <code>6x6</code> grids in figure (c) and (d).<br /> Figure (c) is the input to the Hoshen–Kopelman algorithm.<br /> Figure (b) is the output of the algorithm with all the clusters labeled.

|}

== Applications ==

* Determination of Nodal Domain Area and Nodal Line Lengths <ref>{{cite web|url=https://webhome.weizmann.ac.il/home/feamit/nodalweek/c_joas_nodalweek.pdf |title=Introduction to the Hoshen-Kopelman algorithm and its application to nodal ___domain statistics |author=Christian Joas |website=Webhome.weizmann.ac.il |access-date=2016-09-17}}</ref>

{{empty section|date=September 2016}}

* [[Connectivity (graph theory)|Nodal Connectivity Information]]

* Modeling of [[Electrical resistivity and conductivity|electrical conduction]]

== MoreSee Clustering Algorithmsalso ==

#* [[K-means_clusteringmeans clustering| K-means Clusteringclustering Algorithmalgorithm]]

#* [[Fuzzy_clusteringFuzzy clustering| Fuzzy Clusteringclustering Algorithmalgorithm]]

* Gaussian ([[Expectation–maximization algorithm|Expectation Maximization]]) clustering algorithm

# Gaussian(EM) Clustering Algorithm

* Clustering Methods <ref>{{Cite web|url=https://web.stanford.edu/class/cs345a/slides/12-clustering.pdf|title=Clustering}}</ref>

* C-means Clustering Algorithm <ref>{{Cite web|url=https://sites.google.com/site/dataclusteringalgorithms/fuzzy-c-means-clustering-algorithm|title=Fuzzy c-means clustering}}</ref>

* [[Connected-component labeling]]

== References ==

{{Reflist}}

<ref>http://journals.aps.org/prb/abstract/10.1103/PhysRevB.14.3438</ref>

{{DEFAULTSORT:Hoshen-Kopelman algorithm}}

{{Uncategorized|date=September 2016}}

[[Category:Cluster analysis algorithms]]