cluster(1)

cluster1

Find clusters in a graph and augment the graph with this information.

Usage

cluster [-v?] [-Ck] [-ck] [-o outfile] [files]

Overview

cluster takes as input a graph in DOT format, finds node clusters and augments the graph with this information. The clusters are specified by the "cluster" attribute attached to nodes; cluster values are non-negative integers. cluster attempts to maximize the modularity of the clustering. If the edge attribute "weight" is defined, this will be used in computing the clustering.

Options

The following options are supported:

-Ck

specifies a targeted number of clusters that should be generated. The specified number k is only a suggestion and may not be realisable. If k == 0, the default, the number of clusters that approximately optimizes the modularity is returned.

-ck

specifies clustering method. If k == 0, the default, modularity clustering will be used. If k == 1 modularity quality will be used.

-ooutfile

Specifies that output should go into the file outfile. By default, stdout is used.

-v

Verbose mode.

-?

Prints the usage and exits.

Examples

Applying cluster to the following graph,

   graph {
       1--2 [weight=10.]
       2--3 [weight=1]
       3--4 [weight=10.]
       4--5 [weight=10]
       5--6 [weight=10]
       3--6 [weight=0.1]
       4--6 [weight=10.]
      }

gives

   graph {
         node [cluster="-1"];
         1 [cluster=1];
         2 [cluster=1];
         3 [cluster=2];
         4 [cluster=2];
         5 [cluster=2];
         6 [cluster=2];
         1 -- 2 [weight="10."];
         2 -- 3 [weight=1];
         3 -- 4 [weight="10."];
         4 -- 5 [weight=10];
         5 -- 6 [weight=10];
         3 -- 6 [weight="0.1"];
         4 -- 6 [weight="10."];
   }

Releases

7 releases since Debian 8 (Jessie); the text changed 2 times.

  1. 8–9
  2. 10–13
  3. Arch

-? since Arch Linux 2026-11-01.

Author

Yifan Hu <[email protected]>

From graphviz 16.1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.