# agnes.object

##### Agglomerative Nesting (AGNES) Object

The objects of class `"agnes"`

represent an agglomerative hierarchical clustering of a dataset.

- Keywords
- cluster

##### Value

A legitimate `agnes`

object is a list with the following components:

a vector giving a permutation of the original observations to allow for plotting, in the sense that the branches of a clustering tree will not cross.

a vector similar to `order`

, but containing observation labels
instead of observation numbers. This component is only available if
the original observations were labelled.

a vector with the distances between merging clusters at the successive stages.

the agglomerative coefficient, measuring the clustering structure of the dataset.

For each observation i, denote by m(i) its dissimilarity to the
first cluster it is merged with, divided by the dissimilarity of the
merger in the final step of the algorithm. The `ac`

is the
average of all 1 - m(i). It can also be seen as the average width
(or the percentage filled) of the banner plot. Because `ac`

grows with the number of observations, this measure should not
be used to compare datasets of very different sizes.

an (n-1) by 2 matrix, where n is the number of observations. Row i
of `merge`

describes the merging of clusters at step i of the
clustering. If a number j in the row is negative, then the single
observation |j| is merged at this stage. If j is positive, then the
merger is with the cluster formed at stage j of the algorithm.

an object of class `"dissimilarity"`

(see
`dissimilarity.object`

), representing the total
dissimilarity matrix of the dataset.

a matrix containing the original or standardized measurements, depending
on the `stand`

option of the function `agnes`

. If a
dissimilarity matrix was given as input structure, then this
component is not available.

##### GENERATION

This class of objects is returned from `agnes`

.

##### METHODS

The `"agnes"`

class has methods for the following generic functions:
`print`

, `summary`

, `plot`

, and
`as.dendrogram`

.

In addition, `cutree(x, *)`

can be used to “cut”
the dendrogram in order to produce cluster assignments.

##### INHERITANCE

The class `"agnes"`

inherits from `"twins"`

.
Therefore, the generic functions `pltree`

and
`as.hclust`

are available for `agnes`

objects.
After applying `as.hclust()`

, all *its* methods are
available, of course.

##### See Also

##### Examples

```
# NOT RUN {
data(agriculture)
ag.ag <- agnes(agriculture)
class(ag.ag)
pltree(ag.ag) # the dendrogram
## cut the dendrogram -> get cluster assignments:
(ck3 <- cutree(ag.ag, k = 3))
(ch6 <- cutree(as.hclust(ag.ag), h = 6))
stopifnot(identical(unname(ch6), ck3))
# }
```

*Documentation reproduced from package cluster, version 2.0.7-1, License: GPL (>= 2)*