Clauset-Newman-Moore社区检测实施

时间:2013-12-07 15:57:45

标签: java c++ algorithm modularity

我正在尝试用Java实现上述社区检测算法,虽然我可以访问C ++代码和原始论文 - 但我根本无法使用它。我的主要问题是我不理解代码的目的 - 即算法如何工作。实际上,我的代码卡在mergeBestQ的无限循环中,列表heap似乎在每次迭代时变得越来越大(正如我对代码所期望的那样),但是topQ的值始终返回相同的值。

我正在测试它的图表相当大(300,000个节点,650,000个边缘)。我用于实现的原始代码来自SNAP库(https://github.com/snap-stanford/snap/blob/master/snap-core/cmty.cpp)。如果有人可以向我解释算法的直觉,那么最好将每个节点设置在它自己的社区中,然后记录每对节点的模块性值(无论是什么)。图,然后找到具有最高模块性的节点对并将它们移动到同一社区。此外,如果有人可以提供一些中级伪代码,那就太棒了。这是我到目前为止的实现,为了简洁起见,我试图将它保存在一个文件中,但是CommunityGraph和CommunityNode在其他地方(不应该是必需的)。图表维护所有节点的列表,每个节点维护其与其他节点的连接列表。在运行时,它永远不会超过行while(this.mergeBestQ()){}

更新 - 经过全面审核后,我的代码中发现了一些错误。代码现在非常快速地完成,但并未完全实现该算法,例如图中的300,000个节点,它表示大约有299,000个社区(即每个社区大约有1个节点)。我在下面列出了更新的代码。     /// Clauset-Newman-Moore社区检测方法。     ///每一步都会合并两个对全球模块化贡献最大正值的社区。     ///参见:在非常大的网络中寻找社区结构,A. Clauset,M.E.J。纽曼,C。摩尔,2004年     公共类CNMMCommunityMetric实现CommunityMetric {       私有静态类DoubleIntInt实现Comparable {         公共双重val1;         public int val2;         public int val3;         DoubleIntInt(double val1,int val2,int val3){           this.val1 = val1;           this.val2 = val2;           this.val3 = val3;         }

    @Override
    public int compareTo(DoubleIntInt o) {
      //int this_sum = this.val2 + this.val3;
      //int oth_sum = o.val2 + o.val3;
      if(this.equals(o)){
        return 0;
      }
      else if(val1 < o.val1 || (val1 == o.val1 && val2 < o.val2) || (val1 == o.val1 && val2 == o.val2 && val3 < o.val3)){
        return 1;
      }
      else{
        return -1;
      }
      //return this.val1 < o.val1 ? 1 : (this.val1 > o.val1 ? -1 : this_sum - oth_sum);
    }

    @Override
    public boolean equals(Object o){
      return this.val2 == ((DoubleIntInt)o).val2 && this.val3 == ((DoubleIntInt)o).val3;
    }

    @Override
    public int hashCode() {
      int hash = 3;
      hash = 79 * hash + this.val2;
      hash = 79 * hash + this.val3;
      return hash;
    }
  }

  private static class CommunityData {
    double DegFrac;
    TIntDoubleHashMap nodeToQ = new TIntDoubleHashMap();
    int maxQId;

    CommunityData(){
      maxQId = -1;
    }

    CommunityData(double nodeDegFrac, int outDeg){
      DegFrac = nodeDegFrac;
      maxQId = -1;
    }

    void addQ(int NId, double Q) { 
      nodeToQ.put(NId, Q);
      if (maxQId == -1 || nodeToQ.get(maxQId) < Q) { 
        maxQId = NId;
      } 
    }

    void updateMaxQ() { 
      maxQId=-1; 
      int[] nodeIDs = nodeToQ.keys();
      double maxQ = nodeToQ.get(maxQId);
      for(int i = 0; i < nodeIDs.length; i++){
        int id = nodeIDs[i];
        if(maxQId == -1 || maxQ < nodeToQ.get(id)){
          maxQId = id;
          maxQ = nodeToQ.get(maxQId);
        }
      } 
    }

    void delLink(int K) { 
      int NId=getMxQNId(); 
      nodeToQ.remove(K); 
      if (NId == K) { 
        updateMaxQ(); 
      }  
    }

    int getMxQNId() { 
      return maxQId;
    }

    double getMxQ() {
      return nodeToQ.get(maxQId); 
    }
  };
  private TIntObjectHashMap<CommunityData> communityData = new TIntObjectHashMap<CommunityData>();
  private TreeSet<DoubleIntInt> heap = new TreeSet<DoubleIntInt>();
  private HashMap<DoubleIntInt,DoubleIntInt> set = new HashMap<DoubleIntInt,DoubleIntInt>();
  private double Q = 0.0;
  private UnionFind uf = new UnionFind();
  @Override
  public double getCommunities(CommunityGraph graph) {
    init(graph);
    //CNMMCommunityMetric metric = new CNMMCommunityMetric();
    //metric.getCommunities(graph);
    // maximize modularity
    while (this.mergeBestQ(graph)) {
    }
    // reconstruct communities
    HashMap<Integer, ArrayList<Integer>> IdCmtyH = new HashMap<Integer, ArrayList<Integer>>();
    Iterator<CommunityNode> ns = graph.getNodes();
    int community = 0;
    TIntIntHashMap communities = new TIntIntHashMap();
    while(ns.hasNext()){
      CommunityNode n = ns.next();
      int r = uf.find(n);
      if(!communities.contains(r)){
        communities.put(r, community++);
      }
      n.setCommunity(communities.get(r));
    }
    System.exit(0);
    return this.Q;
  }

  private void init(Graph graph) {
    double M = 0.5/graph.getEdgesList().size();
    Iterator<Node> ns = graph.getNodes();
    while(ns.hasNext()){
      Node n = ns.next();
      uf.add(n);
      int edges = n.getEdgesList().size();
      if(edges == 0){
        continue;
      }
      CommunityData dat = new CommunityData(M * edges, edges);
      communityData.put(n.getId(), dat);
      Iterator<Edge> es = n.getConnections();
      while(es.hasNext()){
        Edge e = es.next();
        Node dest = e.getStart() == n ? e.getEnd() : e.getStart();
        double dstMod = 2 * M * (1.0 - edges * dest.getEdgesList().size() * M);//(1 / (2 * M)) - ((n.getEdgesList().size() * dest.getEdgesList().size()) / ((2 * M) * (2 * M)));// * (1.0 - edges * dest.getEdgesList().size() * M);
        dat.addQ(dest.getId(), dstMod);
      }
      Q += -1.0 * (edges*M) * (edges*M);
      if(n.getId() < dat.getMxQNId()){
        addToHeap(createEdge(dat.getMxQ(), n.getId(), dat.getMxQNId()));
      }
    }
  }
  void addToHeap(DoubleIntInt o){
    heap.add(o);
  }

  DoubleIntInt createEdge(double val1, int val2, int val3){
    DoubleIntInt n = new DoubleIntInt(val1, val2, val3);
    if(set.containsKey(n)){
      DoubleIntInt n1 = set.get(n);
      heap.remove(n1);
      if(n1.val1 < val1){
        n1.val1 = val1;
      }
      n = n1;
    }
    else{
      set.put(n, n);
    }
    return n;
  }
  void removeFromHeap(Collection<DoubleIntInt> col, DoubleIntInt o){
    //set.remove(o);
    col.remove(o);
  }
  DoubleIntInt findMxQEdge() {
    while (true) {
      if (heap.isEmpty()) {
        break; 
      }

      DoubleIntInt topQ = heap.first();
      removeFromHeap(heap, topQ);
      //heap.remove(topQ);
      if (!communityData.containsKey(topQ.val2) || ! communityData.containsKey(topQ.val3)) {
        continue; 
      }
      if (topQ.val1 != communityData.get(topQ.val2).getMxQ() && topQ.val1 != communityData.get(topQ.val3).getMxQ()) { 
        continue; 
      }
      return topQ;
    }
    return new DoubleIntInt(-1.0, -1, -1);
  }
  boolean mergeBestQ(Graph graph) {
    DoubleIntInt topQ = findMxQEdge();
    if (topQ.val1 <= 0.0) { 
      return false; 
    }
    // joint communities
    int i = topQ.val3;
    int j = topQ.val2;
    uf.union(i, j);

    Q += topQ.val1;
    CommunityData datJ = communityData.get(j);
    CommunityData datI = communityData.get(i);
    datI.delLink(j);
    datJ.delLink(i);

    int[] datJData = datJ.nodeToQ.keys();
    for(int _k = 0; _k < datJData.length; _k++){
      int k = datJData[_k];
      CommunityData datK = communityData.get(k);
      double newQ = datJ.nodeToQ.get(k);
      //if(datJ.nodeToQ.containsKey(i)){
      //  newQ = datJ.nodeToQ.get(i);
      //}
      if (datI.nodeToQ.containsKey(k)) { 
        newQ = newQ + datI.nodeToQ.get(k);
        datK.delLink(i);
      }     // K connected to I and J
      else { 
        newQ = newQ - 2 * datI.DegFrac * datK.DegFrac;
      }  // K connected to J not I
      datJ.addQ(k, newQ);
      datK.addQ(j, newQ);
      addToHeap(createEdge(newQ, Math.min(j, k), Math.max(j, k)));
    }

    int[] datIData = datI.nodeToQ.keys();
    for(int _k = 0; _k < datIData.length; _k++){
      int k = datIData[_k];
      if (!datJ.nodeToQ.containsKey(k)) { // K connected to I not J
        CommunityData datK = communityData.get(k);
        double newQ = datI.nodeToQ.get(k) - 2 * datJ.DegFrac * datK.DegFrac; 
        datJ.addQ(k, newQ);
        datK.delLink(i);
        datK.addQ(j, newQ);
        addToHeap(createEdge(newQ, Math.min(j, k), Math.max(j, k)));
      }
    } 
    datJ.DegFrac += datI.DegFrac; 
    if (datJ.nodeToQ.isEmpty()) { 
      communityData.remove(j); 
    } // isolated community (done)
    communityData.remove(i);
    return true;
  }
}

更新:当前列出的代码相当快,与“最快”解决方案相比,内存使用量减少了一半,而速度只有约5%。区别在于使用hashmap + treest与优先级队列,并确保任何时候只存在给定i,j对的单个对象。

1 个答案:

答案 0 :(得分:8)

所以here's原始论文,一个整洁的小&#39;六页,其中只有两页是关于设计和实现。这是一个悬崖:

  • 对于给定图形的分区,作者将分区的模块性Q定义为的边数之比每个社区到每个社区之间的边缘数量,减去您对完全随机分区的期望比率。
  • 所以它有效地&#34;这个分区在定义社区方面比完全随机分区好多少?&#34;
  • 鉴于某个分区的两个社区ij,他们会将deltaQ_ij定义为如果社区i和{{},则分区的模块性会发生多大变化1}}被合并了。因此,如果j,合并deltaQ_ij > 0i将改善分区的模块性。
  • 这导致了一个简单的贪婪算法:从它自己社区中的每个节点开始。为每对社区计算j。无论哪个社区deltaQ_ij拥有最大i, j,请将这两个社区合并。重复。
  • deltaQ_ij全部转为否定时,您将获得最大的模块化,但在论文中,作者让算法运行,直到只有一个社区离开。

这对理解算法非常重要。详细信息包括如何快速计算deltaQ_ij并有效存储信息。

编辑:数据结构时间!

首先,我认为您引用的实现方式与本文的方式不同。我不太确定如何,因为代码是不可穿透的,但它似乎使用union-find和hashsets代替作者的二进制树和多个堆。不是线索为什么他们以不同的方式做到这一点。你可能想给写这篇文章的人发电子邮件并询问。

无论如何, paper 中的算法需要格式为deltaQ_ij的几件事存储在:

  • 首先,它需要能够快速恢复deltaQ中的最大值。
  • 其次,它需要能够快速删除固定dQ的所有deltaQ_ikdeltaQ_ki
  • 第三,它需要能够快速更新所有ideltaQ_kj以获得固定deltaQ_jk

作者提出的解决方案如下:

  • 对于每个社区j,每个非零 i都存储在balanced binary tree中,由deltaQ_ik编制索引(因此元素可以是很容易找到,并且在堆中(因此可以轻松找到该社区的最大值)。
  • 然后,每个社区k堆中的最大deltaQ_ik存储在另一个堆中,以便轻松找到总体最大值。

当社区i与社区i合并时,二元树会发生一些事情:

  • 首先,j社区中的每个元素都会添加到i社区的二叉树中。如果已存在具有相同索引j的元素,则将旧值和新值相加。
  • 其次,我们更新所有剩余的&#34; old&#34; k社区二进制树中的值,以反映j社区的规模刚刚增加的事实。
  • 对于其他社区的二叉树j,我们会更新任何k
  • 最后,社区deltaQ_kj的树被丢弃。

同样地,堆上必须发生几件事情:

  • 首先,社区i的堆被丢弃。
  • 然后使用社区平衡二叉树中的元素从头开始重建社区i的堆。
  • 对于其他社区j的堆,条目k的位置会更新。
  • 最后,整个堆中的社区deltaQ_kj条目被丢弃(导致冒泡),社区i和每个社区j的条目都与k相关联或i已更新。

奇怪的是,当两个社区合并时,论文中没有关于从j社区的堆或树中删除deltaQ_ki值的参考。我认为这可以通过k的设置来处理,但我不能很好地理解算法。

编辑:尝试破译您链接的实现。他们的主要数据结构是

  • a_i = 0,一个联合查找结构,用于跟踪哪个节点在哪个社区中(文章中忽略了这些内容,但似乎是必要的,除非您想要通过以下方式重建社区成员资格合并或其他),
  • CmtyIdUF,用于跟踪哪个MxQHeap总体最大的堆。奇怪的是,当他们更新堆中deltaQ_ij的值时,他们不会要求堆重新堆积自己。这令人担忧。它是自动执行还是其他操作?
  • TFltIntIntTr,一个将社区ID CmtyQH映射到结构i的哈希映射,该结构保存了该社区TCmtyDat堆的内容。我认为。但奇怪的是,deltaQ_ik结构的UpdateMaxQ需要线性时间,无需任何堆。而且,只有在删除堆的元素时才会调用TCmtyDat方法。当堆中任何元素的值更新时,它也应该被调用。