File: clmresidue.azm

package info (click to toggle)
mcl 1%3A14-137%2Bds-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 8,364 kB
  • sloc: ansic: 53,217; sh: 4,448; perl: 3,967; makefile: 422
file content (92 lines) | stat: -rw-r--r-- 2,414 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
\import{mcx.zmm}

\begin{pud::man}{

   {name}{clm residue}
   {html_title}{The clm residue manual}
   {author}{Stijn van Dongen}
   {section}{1}
   {synstyle}{long}
   {defstyle}{long}

   \man_share
}

\${html}{\"pud::man::maketoc"}

\sec{name}{NAME}
\NAME{clm_residue}{extend clustering of subgraph to clustering of graph.}

\disclaim_clm{residue}

\sec{synopsis}{SYNOPSIS}
\par{
   \clm{residue}
   \synreqopt{-icl}{fname}{input clustering}
   \synreqopt{-imx}{fname}{input graph}
   \synoptopt{-rpm}{fname}{residue projection matrix}
   \synoptopt{-o}{fname}{output clustering file}
   }

\sec{description}{DESCRIPTION}

\par{
   The cluster file presumably contains a clustering of a subgraph of the
   graph\~\v{G} contained by the matrix file, implying that the row domain of
   that clustering is a subset of the node domain of the graph. \clm{residue} will
   compute a simple upwards projection of that clustering, resulting in a
   clustering of\~\v{G}. 
   }

\sec{options}{OPTIONS}

\begin{itemize}{\mcx_itemopts}

\item{\defopt{-imx}{fname}{input graph}}
\item{\defopt{-icl}{fname}{input clustering}}

\item{\defopt{-rpm}{fname}{residue projection matrix}}
\car{
   The name for the file in which the residue projection matrix is stored.
   It contains for each node and for each cluster in the input clustering
   the combined weight of the (edges to the) neighbours of that node
   in that cluster.
   }

\car{
   The default output file name is \v{out.rpm}.
   }

\item{\defopt{-o}{fname}{output clustering file}}
\car{
   The name for the file in which the majority vote projection clustering
   is stored. Aka the majority vote projection clustering storage file name.
   }

\par{
   This embodies a very crude approach to distributing the missing nodes in the
   input clustering onto that same cluster.  For each node, the cluster is
   taken for which the residue projection is the largest (see above). The
   residue (i.e. the set of missing nodes) is initially viewed as a cluster;
   the set of nodes for which the projection is largest for the residue itself
   will form a new cluster, if it is not empty.
   }

\par{
   By default output is sent to STDOUT.
   }

\end{itemize}

\sec{author}{AUTHOR}
\par{
   Stijn van Dongen.
   }

\sec{seealso}{SEE ALSO}
\par{
   \mysib{mclfamily} for an overview of all the documentation
   and the utilities in the mcl family.
   }

\end{pud::man}