| Bioinformatics Toolbox™ | ![]() |
A clustergram object contains hierarchical clustering analysis data that you can view in a heat map and dendrograms.
You create a clustergram object using the object constructor function clustergram. You can view a graphical representation of the clustergram object in a heat map and dendrograms using the view method.
Following are methods of a clustergram object:
| get (clustergram) | Retrieve information about clustergram object |
| plot (clustergram) | Render clustergram heat map and dendrograms for clustergram object |
| set (clustergram) | Set property of clustergram object |
| view (clustergram) | View clustergram heat map and dendrograms for clustergram object |
Properties of a Clustergram Object
| Property | Description |
|---|---|
| RowLabels | Vector of numbers or cell array of text strings to label the rows in the dendrogram and heat map. Default is a vector of values 1 through M, where M is the number of rows in Data, the matrix of data used by the clustergram function to create the clustergram object. |
| ColumnLabels | Vector of numbers or cell array of text strings to label the columns in the dendrogram and heat map. Default is a vector of values 1 through M, where M is the number of columns in Data, the matrix of data used by the clustergram function to create the clustergram object. |
| RowGroupNames | A cell array of text strings containing the names of the row groups exported to a clustergram object created using the Export Group to Workspace command in the Clustergram window. |
| RowNodeNames | A cell array of text strings containing the names of the row nodes exported to a clustergram object created using the Export Group to Workspace command in the Clustergram window. |
| ColumnGroupNames | A cell array of text strings containing the names of the column groups exported to a clustergram object created using the Export Group to Workspace command in the Clustergram window. |
| ColumnNodeNames | A cell array of text strings containing the names of the column nodes exported to a clustergram object created using the Export Group to Workspace command in the Clustergram window. |
| ExprValues | An M by N matrix of data, where M and N are the number of row nodes and of column nodes respectively, exported to a clustergram object created using the Export Group to Workspace command in the Clustergram window. If the matrix contains gene expression data, typically each row corresponds to a gene and each column corresponds to sample. |
| Standardize | Numeric value that specifies the dimension for standardizing the values in the data. The standardized values are transformed so that the mean is 0 and the standard deviation is 1 in the specified dimension. Choices are:
|
| Cluster | Numeric value that specifies the dimension for clustering the values in the data. Choices are:
|
| RowPdist | String that specifies the distance metric to pass to the pdist function (Statistics Toolbox™ software) to use to calculate the pairwise distances between rows. For information on choices, see the pdist function. Default is 'euclidean'. |
| ColumnPdist | String that specifies the distance metric to pass to the pdist function (Statistics Toolbox software) to use to calculate the pairwise distances between columns. For information on choices, see the pdist function. Default is 'euclidean'. |
| Linkage | String or two-element cell array of strings that specifies the linkage method to pass to the linkage function (Statistics Toolbox software) to use to create the hierarchical cluster tree for rows and columns. If a two-element cell array of strings, the first element is used for linkage between rows, and the second element is used for linkage between columns. For information on choices, see the linkage function. Default is 'average'. |
| Dendrogram | Scalar or two-element numeric vector or cell array of stringsthat specifies the 'colorthreshold' property to pass to the dendrogram function (Statistics Toolbox software) to create the dendrogram plot. If a two-element numeric vector or cell array, the first element is for the rows, and the second element is for the columns. For more information, see the dendrogram function. |
| OptimalLeafOrder | Property to enable or disable the optimal leaf ordering calculation, which determines the leaf order that maximizes the similarity between neighboring leaves. Choices are true (enable) or false (disable). Default depends on the size of Data, the matrix of data used to create the clustergram object. If the number of rows or columns in Data is greater than 1000, default is false; otherwise, default is true. |
| ColorMap | Either of the following:
Default is redgreencmap. |
| DisplayRange | Positive scalar that specifies the display range of standardized values. Default is 3, which means there is a color variation for values between -3 and 3, but values >3 will be the same color as 3, and values < -3 will be the same color as -3. For example, if you specify redgreencmap for the 'ColorMap' property, pure red represents values ≥ DisplayRangeValue, and pure green represents values ≤ –DisplayRangeValue. |
| SymmetricRange | Property to force the color scale of the heat map to be symmetric around zero. Choices are true (default) or false. |
| LogTrans | Controls the log2 transform of the data from natural scale. Choices are true or false (default). |
| Ratio | Either of the following:
It specifies the ratio of space that the row and column dendrograms occupy relative to the heat map. If RatioValue is a scalar, it is used as the ratio for both dendrograms. If RatioValue is a two-element vector, the first element is used for the ratio of the row dendrogram width to the heat map width, and the second element is used for the ratio of the column dendrogram height to the heat map height. The second element is ignored for one-dimensional clustergrams. Default is 1/5. |
| Impute | Any of the following:
|
| RowMarker | Optional structure array for annotating the groups (clusters) of rows determined by the clustergram function. Each structure in the array represents a group of rows and contains the following fields:
|
| ColumnMarker | Optional structure array for annotating groups (clusters) of columns determined by the clustergram function. Each structure in the array represents a group of columns and contains the following fields:
|
Determining Properties and Property Values of a Clustergram Object
You can display all properties and their current values of a clustergram object, CGobj, by using the following syntax:
get(CGobj)
You can return all properties and their current values of CGobj, a clustergram object, to CGstruct, a scalar structure in which each field name is a property of a clustergram object, and each field contains the value of that property, by using the following syntax:
CGstruct = get(CGobj)
You can return the value of a specific property of a clustergram object, CGobj, by using either of the following syntaxes:
PropertyValue = get(CGobj, 'PropertyName')
PropertyValue = CGobj.PropertyName
You can return the value of specific properties of a clustergram object, CGobj, by using the following syntax:
[Property1Value, Property2Value, ...] = get(CGobj, 'Property1Name', 'Property2Name', ...)
Determining Possible Values of Clustergram Object Properties
You can display possible values for all properties that have a fixed set of property values in a clustergram object, CGobj, by using the following syntax:
set(CGobj)
You can display possible values for a specific property that has a fixed set of property values in a clustergram object, CGobj, by using the following syntax:
set(CGobj, 'PropertyName')
Specifying Properties of a Clustergram Object
You can set a specific property of a clustergram object, CGobj, by using either of the following syntaxes:
set(CGobj, 'PropertyName', PropertyValue)
CGobj.PropertyName = PropertyValue
You can set multiple properties of a clustergram object, CGobj, by using the following syntax:
set(CGobj, 'PropertyName1', PropertyValue1, 'PropertyName2', PropertyValue2, ...)
Bioinformatics Toolbox™ function: clustergram (object constructor)
Bioinformatics Toolbox methods of a clustergram object: get, plot, set, view
![]() | biograph object | geneont object | ![]() |
| © 1984-2008- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |