HierarchicalClusteringOptions Class

Spotfire 14.3 API Reference
Holds options for the clustering algorithm.
Inheritance Hierarchy

SystemObject
  Spotfire.Dxp.Data.Computations.ClusteringHierarchicalClusteringOptions

Namespace:  Spotfire.Dxp.Data.Computations.Clustering
Assembly:  Spotfire.Dxp.Data (in Spotfire.Dxp.Data.dll) Version: 65.0.19510.3242 (65.0.19510.3242)
Syntax

C#
public sealed class HierarchicalClusteringOptions

The HierarchicalClusteringOptions type exposes the following members.

Constructors

  NameDescription
Public methodHierarchicalClusteringOptions(Int32, Int32) Obsolete.
Constructs a ClusteringOptions object with given limit on maximum threads allowed and a hint on maximum physical memory that should be used.
Public methodHierarchicalClusteringOptions(Int32, Int32, Boolean)
Constructs a ClusteringOptions object with given limit on maximum threads allowed and a hint on maximum physical memory that should be used and if a subprocess should be used for the computation.
Top
Properties

  NameDescription
Public propertyMaximumThreadCount
An upper limit on the number of threads the clustering algorithm will use.

By default the algorithm will use the same number of threads that there are cores in the computer. With this parameter it is possible to lower the number of threads used.

Public propertyPhysicalMemoryLimitHintMegabytes
This is a hint to the clustering algorithm how much physical memory it can use. For large problems different internal algorithms will be selected depending on this value. The fastest algorithm is in most cases based on storing the entire distance matrix.

The distance matrix for hierarchical clustering is growing qudratically in the number of elements in the input. Thus for large input data all of the distance matrix will not fit in memory. Given 500 MBytes the algorithm can store the distance matrix up to around 15000 input elements. For larger input, HierarchicalClustering is using caching and recalculation algorithms based on the distance measure and clustering method. These can be slower, but are much faster than a full distance matrix algorithm that is swapping.

Raising the value too high compared to the physical memory in the computer will lead to out of memory exit and/or swapping on large problems. 500 MBytes is a good value on a 2 GByte computer.

Public propertyUseSubProcess
If true a subprocess will be used for the clusterng computation.
Top
Methods

  NameDescription
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Fields

  NameDescription
Public fieldStatic memberDefault
Default options, giving a clustering option that does not limit the number of threads, and 500 MBytes hit for the native clustering code. The native code will run in a separate process.
Top
Version Information

Supported in: 14.3, 14.2, 14.1, 14.0, 12.5, 12.4, 12.3, 12.2, 12.1, 12.0, 11.8
See Also

Reference