annotate louvain/main_community.cpp @ 5:7e55ef6f9a05 draft

Uploaded
author petrn
date Fri, 20 Dec 2019 12:45:18 +0000
parents f6ebec6e235e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
1 // File: main_community.cpp
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
2 // -- community detection, sample main file
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
3 //-----------------------------------------------------------------------------
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
4 // Community detection
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
5 // Based on the article "Fast unfolding of community hierarchies in large networks"
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
6 // Copyright (C) 2008 V. Blondel, J.-L. Guillaume, R. Lambiotte, E. Lefebvre
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
7 //
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
8 // This program must not be distributed without agreement of the above mentionned authors.
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
9 //-----------------------------------------------------------------------------
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
10 // Author : E. Lefebvre, adapted by J.-L. Guillaume
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
11 // Email : jean-loup.guillaume@lip6.fr
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
12 // Location : Paris, France
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
13 // Time : February 2008
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
14 //-----------------------------------------------------------------------------
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
15 // see readme.txt for more details
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
16
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
17 #include <stdlib.h>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
18 #include <math.h>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
19 #include <string>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
20 #include <iostream>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
21 #include <fstream>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
22 #include <sstream>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
23 #include <vector>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
24 #include <algorithm>
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
25
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
26 #include "graph_binary.h"
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
27 #include "community.h"
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
28
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
29 using namespace std;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
30
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
31 char *filename = NULL;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
32 char *filename_w = NULL;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
33 char *filename_part = NULL;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
34 int type = UNWEIGHTED;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
35 int nb_pass = 0;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
36 double precision = 0.000001;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
37 int display_level = -2;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
38 int k1 = 16;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
39 int seed = 123;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
40
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
41 bool verbose = false;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
42
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
43 void
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
44 usage(char *prog_name, const char *more) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
45 cerr << more;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
46 cerr << "usage: " << prog_name << " input_file [-w weight_file] [-p part_file] [-q epsilon] [-l display_level] [-v] [-h]" << endl << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
47 cerr << "input_file: file containing the graph to decompose in communities." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
48 cerr << "-w file\tread the graph as a weighted one (weights are set to 1 otherwise)." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
49 cerr << "-p file\tstart the computation with a given partition instead of the trivial partition." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
50 cerr << "\tfile must contain lines \"node community\"." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
51 cerr << "-q eps\ta given pass stops when the modularity is increased by less than epsilon." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
52 cerr << "-l k\tdisplays the graph of level k rather than the hierachical structure." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
53 cerr << "\tif k=-1 then displays the hierarchical structure rather than the graph at a given level." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
54 cerr << "-v\tverbose mode: gives computation time, information about the hierarchy and modularity." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
55 cerr << "-s\tseed for rundom number generator setting, integer(123 deafault)" << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
56 cerr << "-h\tshow this usage message." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
57 exit(0);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
58 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
59
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
60 void
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
61 parse_args(int argc, char **argv) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
62 if (argc<2)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
63 usage(argv[0], "Bad arguments number\n");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
64
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
65 for (int i = 1; i < argc; i++) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
66 if(argv[i][0] == '-') {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
67 switch(argv[i][1]) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
68 case 'w':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
69 type = WEIGHTED;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
70 filename_w = argv[i+1];
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
71 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
72 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
73 case 'p':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
74 filename_part = argv[i+1];
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
75 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
76 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
77 case 'q':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
78 precision = atof(argv[i+1]);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
79 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
80 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
81 case 'l':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
82 display_level = atoi(argv[i+1]);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
83 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
84 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
85 case 's':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
86 seed = atoi(argv[i+1]);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
87 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
88 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
89 case 'k':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
90 k1 = atoi(argv[i+1]);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
91 i++;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
92 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
93 case 'v':
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
94 verbose=true;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
95 break;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
96 default:
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
97 usage(argv[0], "Unknown option\n");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
98 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
99 } else {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
100 if (filename==NULL)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
101 filename = argv[i];
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
102 else
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
103 usage(argv[0], "More than one filename\n");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
104 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
105 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
106 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
107
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
108 void
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
109 display_time(const char *str) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
110 time_t rawtime;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
111 time ( &rawtime );
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
112 cerr << str << ": " << ctime (&rawtime);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
113 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
114
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
115 int
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
116 main(int argc, char **argv) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
117 parse_args(argc, argv);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
118 srand(seed);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
119 time_t time_begin, time_end;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
120 time(&time_begin);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
121 if (verbose)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
122 display_time("Begin");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
123
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
124 Community c(filename, filename_w, type, -1, precision);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
125 if (filename_part!=NULL)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
126 c.init_partition(filename_part);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
127 Graph g;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
128 bool improvement=true;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
129 double mod=c.modularity(), new_mod;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
130 int level=0;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
131
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
132 do {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
133 if (verbose) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
134 cerr << "level " << level << ":\n";
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
135 display_time(" start computation");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
136 cerr << " network size: "
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
137 << c.g.nb_nodes << " nodes, "
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
138 << c.g.nb_links << " links, "
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
139 << c.g.total_weight << " weight." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
140 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
141
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
142 improvement = c.one_level();
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
143 new_mod = c.modularity();
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
144 if (++level==display_level)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
145 g.display();
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
146 if (display_level==-1)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
147 c.display_partition();
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
148 g = c.partition2graph_binary();
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
149 c = Community(g, -1, precision);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
150
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
151 if (verbose)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
152 cerr << " modularity increased from " << mod << " to " << new_mod << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
153
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
154 mod=new_mod;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
155 if (verbose)
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
156 display_time(" end computation");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
157
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
158 if (filename_part!=NULL && level==1) // do at least one more computation if partition is provided
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
159 improvement=true;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
160 } while(improvement);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
161
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
162 time(&time_end);
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
163 if (verbose) {
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
164 display_time("End");
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
165 cerr << "Total duration: " << (time_end-time_begin) << " sec." << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
166 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
167 cerr << new_mod << endl;
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
168 }
f6ebec6e235e Uploaded
petrn
parents:
diff changeset
169