lemon/list_graph.h
author alpar
Tue, 11 Jul 2006 13:51:52 +0000
changeset 2123 85c6f5e82108
parent 2117 96efb4fa0736
child 2128 509846825ddf
permissions -rw-r--r--
Minor doc improvements
alpar@948
     1
/* -*- C++ -*-
alpar@948
     2
 *
alpar@1956
     3
 * This file is a part of LEMON, a generic C++ optimization library
alpar@1956
     4
 *
alpar@1956
     5
 * Copyright (C) 2003-2006
alpar@1956
     6
 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
alpar@1359
     7
 * (Egervary Research Group on Combinatorial Optimization, EGRES).
alpar@948
     8
 *
alpar@948
     9
 * Permission to use, modify and distribute this software is granted
alpar@948
    10
 * provided that this copyright notice appears in all copies. For
alpar@948
    11
 * precise terms see the accompanying LICENSE file.
alpar@948
    12
 *
alpar@948
    13
 * This software is provided "AS IS" with no warranty of any kind,
alpar@948
    14
 * express or implied, and with no claim as to its suitability for any
alpar@948
    15
 * purpose.
alpar@948
    16
 *
alpar@948
    17
 */
alpar@395
    18
alpar@921
    19
#ifndef LEMON_LIST_GRAPH_H
alpar@921
    20
#define LEMON_LIST_GRAPH_H
alpar@395
    21
alpar@948
    22
///\ingroup graphs
alpar@948
    23
///\file
deba@2116
    24
///\brief ListGraph, ListUGraph classes.
alpar@948
    25
deba@2116
    26
#include <lemon/bits/base_extender.h>
deba@1791
    27
#include <lemon/bits/graph_extender.h>
deba@782
    28
deba@2116
    29
#include <lemon/error.h>
deba@2116
    30
deba@1979
    31
#include <vector>
alpar@1011
    32
#include <list>
deba@782
    33
alpar@921
    34
namespace lemon {
alpar@395
    35
klao@946
    36
  class ListGraphBase {
alpar@406
    37
alpar@949
    38
  protected:
klao@946
    39
    struct NodeT {
deba@1470
    40
      int first_in, first_out;
alpar@397
    41
      int prev, next;
alpar@395
    42
    };
klao@946
    43
 
klao@946
    44
    struct EdgeT {
alpar@986
    45
      int target, source;
alpar@397
    46
      int prev_in, prev_out;
alpar@397
    47
      int next_in, next_out;
alpar@395
    48
    };
alpar@395
    49
alpar@395
    50
    std::vector<NodeT> nodes;
klao@946
    51
alpar@397
    52
    int first_node;
klao@946
    53
alpar@397
    54
    int first_free_node;
klao@946
    55
alpar@395
    56
    std::vector<EdgeT> edges;
klao@946
    57
alpar@397
    58
    int first_free_edge;
alpar@395
    59
    
deba@782
    60
  public:
alpar@395
    61
    
klao@946
    62
    typedef ListGraphBase Graph;
alpar@397
    63
    
klao@946
    64
    class Node {
marci@975
    65
      friend class ListGraphBase;
klao@946
    66
    protected:
alpar@395
    67
klao@946
    68
      int id;
deba@2031
    69
      explicit Node(int pid) { id = pid;}
alpar@395
    70
klao@946
    71
    public:
klao@946
    72
      Node() {}
klao@946
    73
      Node (Invalid) { id = -1; }
klao@946
    74
      bool operator==(const Node& node) const {return id == node.id;}
klao@946
    75
      bool operator!=(const Node& node) const {return id != node.id;}
klao@946
    76
      bool operator<(const Node& node) const {return id < node.id;}
klao@946
    77
    };
deba@782
    78
klao@946
    79
    class Edge {
marci@975
    80
      friend class ListGraphBase;
klao@946
    81
    protected:
deba@782
    82
klao@946
    83
      int id;
deba@2031
    84
      explicit Edge(int pid) { id = pid;}
alpar@395
    85
klao@946
    86
    public:
klao@946
    87
      Edge() {}
klao@946
    88
      Edge (Invalid) { id = -1; }
klao@946
    89
      bool operator==(const Edge& edge) const {return id == edge.id;}
klao@946
    90
      bool operator!=(const Edge& edge) const {return id != edge.id;}
klao@946
    91
      bool operator<(const Edge& edge) const {return id < edge.id;}
klao@946
    92
    };
klao@946
    93
klao@946
    94
klao@946
    95
klao@946
    96
    ListGraphBase()
deba@782
    97
      : nodes(), first_node(-1),
deba@782
    98
	first_free_node(-1), edges(), first_free_edge(-1) {}
deba@782
    99
alpar@395
   100
    
alpar@813
   101
    /// Maximum node ID.
alpar@813
   102
    
alpar@813
   103
    /// Maximum node ID.
alpar@813
   104
    ///\sa id(Node)
deba@1791
   105
    int maxNodeId() const { return nodes.size()-1; } 
klao@946
   106
alpar@813
   107
    /// Maximum edge ID.
alpar@813
   108
    
alpar@813
   109
    /// Maximum edge ID.
alpar@813
   110
    ///\sa id(Edge)
deba@1791
   111
    int maxEdgeId() const { return edges.size()-1; }
alpar@395
   112
deba@2031
   113
    Node source(Edge e) const { return Node(edges[e.id].source); }
deba@2031
   114
    Node target(Edge e) const { return Node(edges[e.id].target); }
alpar@395
   115
alpar@395
   116
klao@946
   117
    void first(Node& node) const { 
klao@946
   118
      node.id = first_node;
klao@946
   119
    }
klao@946
   120
klao@946
   121
    void next(Node& node) const {
klao@946
   122
      node.id = nodes[node.id].next;
klao@946
   123
    }
klao@946
   124
klao@946
   125
klao@946
   126
    void first(Edge& e) const { 
klao@946
   127
      int n;
klao@946
   128
      for(n = first_node; 
klao@946
   129
	  n!=-1 && nodes[n].first_in == -1; 
klao@946
   130
	  n = nodes[n].next);
klao@946
   131
      e.id = (n == -1) ? -1 : nodes[n].first_in;
klao@946
   132
    }
klao@946
   133
klao@946
   134
    void next(Edge& edge) const {
klao@946
   135
      if (edges[edge.id].next_in != -1) {
klao@946
   136
	edge.id = edges[edge.id].next_in;
klao@946
   137
      } else {
klao@946
   138
	int n;
alpar@986
   139
	for(n = nodes[edges[edge.id].target].next;
klao@946
   140
	  n!=-1 && nodes[n].first_in == -1; 
klao@946
   141
	  n = nodes[n].next);
klao@946
   142
	edge.id = (n == -1) ? -1 : nodes[n].first_in;
klao@946
   143
      }      
klao@946
   144
    }
klao@946
   145
klao@946
   146
    void firstOut(Edge &e, const Node& v) const {
klao@946
   147
      e.id = nodes[v.id].first_out;
klao@946
   148
    }
klao@946
   149
    void nextOut(Edge &e) const {
klao@946
   150
      e.id=edges[e.id].next_out;
klao@946
   151
    }
klao@946
   152
klao@946
   153
    void firstIn(Edge &e, const Node& v) const {
klao@946
   154
      e.id = nodes[v.id].first_in;
klao@946
   155
    }
klao@946
   156
    void nextIn(Edge &e) const {
klao@946
   157
      e.id=edges[e.id].next_in;
klao@946
   158
    }
klao@946
   159
alpar@813
   160
    
klao@946
   161
    static int id(Node v) { return v.id; }
klao@946
   162
    static int id(Edge e) { return e.id; }
alpar@395
   163
deba@1791
   164
    static Node nodeFromId(int id) { return Node(id);}
deba@1791
   165
    static Edge edgeFromId(int id) { return Edge(id);}
deba@1106
   166
alpar@397
   167
    /// Adds a new node to the graph.
alpar@397
   168
alpar@2123
   169
    /// Adds a new node to the graph.
alpar@2123
   170
    ///
alpar@813
   171
    /// \warning It adds the new node to the front of the list.
alpar@397
   172
    /// (i.e. the lastly added node becomes the first.)
klao@946
   173
    Node addNode() {     
alpar@397
   174
      int n;
alpar@397
   175
      
klao@946
   176
      if(first_free_node==-1) {
klao@946
   177
	n = nodes.size();
klao@946
   178
	nodes.push_back(NodeT());
klao@946
   179
      } else {
alpar@397
   180
	n = first_free_node;
alpar@397
   181
	first_free_node = nodes[n].next;
alpar@397
   182
      }
alpar@397
   183
      
alpar@397
   184
      nodes[n].next = first_node;
alpar@397
   185
      if(first_node != -1) nodes[first_node].prev = n;
alpar@397
   186
      first_node = n;
alpar@397
   187
      nodes[n].prev = -1;
alpar@397
   188
      
alpar@397
   189
      nodes[n].first_in = nodes[n].first_out = -1;
alpar@397
   190
      
klao@946
   191
      return Node(n);
alpar@395
   192
    }
alpar@395
   193
    
alpar@395
   194
    Edge addEdge(Node u, Node v) {
klao@946
   195
      int n;      
klao@946
   196
klao@946
   197
      if (first_free_edge == -1) {
klao@946
   198
	n = edges.size();
klao@946
   199
	edges.push_back(EdgeT());
klao@946
   200
      } else {
alpar@397
   201
	n = first_free_edge;
alpar@397
   202
	first_free_edge = edges[n].next_in;
alpar@397
   203
      }
alpar@397
   204
      
alpar@986
   205
      edges[n].source = u.id; 
alpar@986
   206
      edges[n].target = v.id;
alpar@395
   207
klao@946
   208
      edges[n].next_out = nodes[u.id].first_out;
klao@946
   209
      if(nodes[u.id].first_out != -1) {
klao@946
   210
	edges[nodes[u.id].first_out].prev_out = n;
klao@946
   211
      }
klao@946
   212
      
klao@946
   213
      edges[n].next_in = nodes[v.id].first_in;
klao@946
   214
      if(nodes[v.id].first_in != -1) {
klao@946
   215
	edges[nodes[v.id].first_in].prev_in = n;
klao@946
   216
      }
klao@946
   217
      
alpar@397
   218
      edges[n].prev_in = edges[n].prev_out = -1;
alpar@397
   219
	
klao@946
   220
      nodes[u.id].first_out = nodes[v.id].first_in = n;
alpar@397
   221
klao@946
   222
      return Edge(n);
alpar@395
   223
    }
alpar@774
   224
    
klao@946
   225
    void erase(const Node& node) {
klao@946
   226
      int n = node.id;
klao@946
   227
      
klao@946
   228
      if(nodes[n].next != -1) {
klao@946
   229
	nodes[nodes[n].next].prev = nodes[n].prev;
klao@946
   230
      }
klao@946
   231
      
klao@946
   232
      if(nodes[n].prev != -1) {
klao@946
   233
	nodes[nodes[n].prev].next = nodes[n].next;
klao@946
   234
      } else {
klao@946
   235
	first_node = nodes[n].next;
klao@946
   236
      }
klao@946
   237
      
klao@946
   238
      nodes[n].next = first_free_node;
klao@946
   239
      first_free_node = n;
alpar@395
   240
alpar@774
   241
    }
alpar@774
   242
    
klao@946
   243
    void erase(const Edge& edge) {
klao@946
   244
      int n = edge.id;
alpar@397
   245
      
klao@946
   246
      if(edges[n].next_in!=-1) {
alpar@397
   247
	edges[edges[n].next_in].prev_in = edges[n].prev_in;
klao@946
   248
      }
klao@946
   249
klao@946
   250
      if(edges[n].prev_in!=-1) {
alpar@397
   251
	edges[edges[n].prev_in].next_in = edges[n].next_in;
klao@946
   252
      } else {
alpar@986
   253
	nodes[edges[n].target].first_in = edges[n].next_in;
klao@946
   254
      }
klao@946
   255
alpar@397
   256
      
klao@946
   257
      if(edges[n].next_out!=-1) {
alpar@397
   258
	edges[edges[n].next_out].prev_out = edges[n].prev_out;
klao@946
   259
      } 
klao@946
   260
klao@946
   261
      if(edges[n].prev_out!=-1) {
alpar@397
   262
	edges[edges[n].prev_out].next_out = edges[n].next_out;
klao@946
   263
      } else {
alpar@986
   264
	nodes[edges[n].source].first_out = edges[n].next_out;
klao@946
   265
      }
alpar@397
   266
      
alpar@397
   267
      edges[n].next_in = first_free_edge;
alpar@695
   268
      first_free_edge = n;      
alpar@397
   269
alpar@397
   270
    }
alpar@397
   271
alpar@397
   272
    void clear() {
deba@782
   273
      edges.clear();
deba@782
   274
      nodes.clear();
klao@946
   275
      first_node = first_free_node = first_free_edge = -1;
deba@937
   276
    }
deba@937
   277
alpar@949
   278
  protected:
deba@2111
   279
    void changeTarget(Edge e, Node n) 
alpar@949
   280
    {
alpar@949
   281
      if(edges[e.id].next_in != -1)
alpar@949
   282
	edges[edges[e.id].next_in].prev_in = edges[e.id].prev_in;
alpar@949
   283
      if(edges[e.id].prev_in != -1)
alpar@949
   284
	edges[edges[e.id].prev_in].next_in = edges[e.id].next_in;
alpar@986
   285
      else nodes[edges[e.id].target].first_in = edges[e.id].next_in;
deba@1702
   286
      if (nodes[n.id].first_in != -1) {
deba@1702
   287
	edges[nodes[n.id].first_in].prev_in = e.id;
deba@1702
   288
      }
alpar@986
   289
      edges[e.id].target = n.id;
alpar@949
   290
      edges[e.id].prev_in = -1;
alpar@949
   291
      edges[e.id].next_in = nodes[n.id].first_in;
alpar@949
   292
      nodes[n.id].first_in = e.id;
alpar@949
   293
    }
deba@2111
   294
    void changeSource(Edge e, Node n) 
alpar@949
   295
    {
alpar@949
   296
      if(edges[e.id].next_out != -1)
alpar@949
   297
	edges[edges[e.id].next_out].prev_out = edges[e.id].prev_out;
alpar@949
   298
      if(edges[e.id].prev_out != -1)
alpar@949
   299
	edges[edges[e.id].prev_out].next_out = edges[e.id].next_out;
alpar@986
   300
      else nodes[edges[e.id].source].first_out = edges[e.id].next_out;
deba@1702
   301
      if (nodes[n.id].first_out != -1) {
deba@1702
   302
	edges[nodes[n.id].first_out].prev_out = e.id;
deba@1702
   303
      }
alpar@986
   304
      edges[e.id].source = n.id;
alpar@949
   305
      edges[e.id].prev_out = -1;
alpar@949
   306
      edges[e.id].next_out = nodes[n.id].first_out;
alpar@949
   307
      nodes[n.id].first_out = e.id;
alpar@949
   308
    }
alpar@949
   309
alpar@919
   310
  };
deba@909
   311
deba@1979
   312
  typedef GraphExtender<ListGraphBase> ExtendedListGraphBase;
alpar@400
   313
deba@2116
   314
  /// \addtogroup graphs
deba@2116
   315
  /// @{
alpar@400
   316
alpar@948
   317
  ///A list graph class.
alpar@400
   318
alpar@2117
   319
  ///This is a simple and fast graph implementation.
alpar@948
   320
  ///
alpar@2117
   321
  ///It conforms to the \ref concept::Graph "Graph concept" and it
deba@2111
   322
  ///also provides several additional useful extra functionalities.
deba@2111
   323
  ///The most of the member functions and nested classes are
deba@2111
   324
  ///documented only in the concept class.
deba@2111
   325
  ///\sa concept::Graph.
deba@782
   326
deba@1999
   327
  class ListGraph : public ExtendedListGraphBase {
alpar@948
   328
  public:
deba@1999
   329
deba@1999
   330
    typedef ExtendedListGraphBase Parent;
deba@1999
   331
deba@2111
   332
    ///Add a new node to the graph.
deba@2111
   333
    
deba@2111
   334
    /// \return the new node.
deba@2111
   335
    ///
deba@2111
   336
    Node addNode() { return Parent::addNode(); }
deba@2111
   337
deba@2111
   338
    ///Add a new edge to the graph.
deba@2111
   339
    
deba@2111
   340
    ///Add a new edge to the graph with source node \c s
deba@2111
   341
    ///and target node \c t.
deba@2111
   342
    ///\return the new edge.
deba@2111
   343
    Edge addEdge(const Node& s, const Node& t) { 
deba@2111
   344
      return Parent::addEdge(s, t); 
deba@2111
   345
    }
deba@2111
   346
alpar@1546
   347
    /// Changes the target of \c e to \c n
alpar@948
   348
alpar@1546
   349
    /// Changes the target of \c e to \c n
alpar@948
   350
    ///
deba@2114
   351
    ///\note The <tt>Edge</tt>s and <tt>OutEdgeIt</tt>s referencing
deba@2114
   352
    ///the changed edge remain valid. However <tt>InEdgeIt</tt>s are
deba@2114
   353
    ///invalidated.
alpar@2123
   354
    ///\warning This functionality cannot be used together with the Snapshot
alpar@2123
   355
    ///feature.
deba@1718
   356
    void changeTarget(Edge e, Node n) { 
deba@2111
   357
      Parent::changeTarget(e,n); 
deba@1718
   358
    }
alpar@1546
   359
    /// Changes the source of \c e to \c n
alpar@948
   360
alpar@1546
   361
    /// Changes the source of \c e to \c n
alpar@948
   362
    ///
deba@2114
   363
    ///\note The <tt>Edge</tt>s and <tt>InEdgeIt</tt>s referencing
deba@2114
   364
    ///the changed edge remain valid. However <tt>OutEdgeIt</tt>s are
deba@2114
   365
    ///invalidated.
alpar@2123
   366
    ///\warning This functionality cannot be used together with the Snapshot
alpar@2123
   367
    ///feature.
deba@1718
   368
    void changeSource(Edge e, Node n) { 
deba@2111
   369
      Parent::changeSource(e,n);
deba@1718
   370
    }
alpar@949
   371
alpar@1010
   372
    /// Invert the direction of an edge.
alpar@1010
   373
deba@2114
   374
    ///\note The <tt>Edge</tt>s referencing the changed edge remain
deba@2114
   375
    ///valid. However <tt>OutEdgeIt</tt>s and <tt>InEdgeIt</tt>s are
deba@2114
   376
    ///invalidated.
alpar@2123
   377
    ///\warning This functionality cannot be used together with the Snapshot
alpar@2123
   378
    ///feature.
alpar@1010
   379
    void reverseEdge(Edge e) {
alpar@1010
   380
      Node t=target(e);
deba@2111
   381
      changeTarget(e,source(e));
deba@2111
   382
      changeSource(e,t);
alpar@1010
   383
    }
alpar@1010
   384
deba@2111
   385
    /// \brief Using this it is possible to avoid the superfluous memory
deba@2111
   386
    /// allocation.
alpar@1010
   387
deba@2107
   388
    ///Using this it is possible to avoid the superfluous memory
deba@2107
   389
    ///allocation: if you know that the graph you want to build will
alpar@2123
   390
    ///contain at least 10 million nodes then it is worth reserving
deba@2107
   391
    ///space for this amount before starting to build the graph.
deba@2107
   392
    void reserveNode(int n) { nodes.reserve(n); };
deba@2107
   393
deba@2111
   394
    /// \brief Using this it is possible to avoid the superfluous memory
deba@2111
   395
    /// allocation.
deba@2107
   396
deba@2107
   397
    ///Using this it is possible to avoid the superfluous memory
deba@2107
   398
    ///allocation: see the \ref reserveNode function.
alpar@949
   399
    void reserveEdge(int n) { edges.reserve(n); };
alpar@1010
   400
deba@2107
   401
alpar@1010
   402
    ///Contract two nodes.
alpar@1010
   403
alpar@1010
   404
    ///This function contracts two nodes.
alpar@1010
   405
    ///
alpar@1010
   406
    ///Node \p b will be removed but instead of deleting
athos@2102
   407
    ///incident edges, they will be joined to \p a.
alpar@1010
   408
    ///The last parameter \p r controls whether to remove loops. \c true
alpar@1010
   409
    ///means that loops will be removed.
alpar@1010
   410
    ///
alpar@1010
   411
    ///\note The <tt>Edge</tt>s
alpar@1281
   412
    ///referencing a moved edge remain
athos@2102
   413
    ///valid. However <tt>InEdge</tt>s and <tt>OutEdge</tt>s
alpar@1010
   414
    ///may be invalidated.
alpar@2123
   415
    ///\warning This functionality cannot be used together with the Snapshot
alpar@2123
   416
    ///feature.
deba@1718
   417
    void contract(Node a, Node b, bool r = true) 
alpar@1010
   418
    {
alpar@1010
   419
      for(OutEdgeIt e(*this,b);e!=INVALID;) {
alpar@1010
   420
	OutEdgeIt f=e;
alpar@1010
   421
	++f;
alpar@1010
   422
	if(r && target(e)==a) erase(e);
alpar@1546
   423
	else changeSource(e,a);
alpar@1010
   424
	e=f;
alpar@1010
   425
      }
alpar@1010
   426
      for(InEdgeIt e(*this,b);e!=INVALID;) {
alpar@1010
   427
	InEdgeIt f=e;
alpar@1010
   428
	++f;
alpar@1010
   429
	if(r && source(e)==a) erase(e);
alpar@1546
   430
	else changeTarget(e,a);
alpar@1010
   431
	e=f;
alpar@1010
   432
      }
alpar@1010
   433
      erase(b);
alpar@1010
   434
    }
alpar@1011
   435
alpar@1281
   436
    ///Split a node.
alpar@1011
   437
alpar@1284
   438
    ///This function splits a node. First a new node is added to the graph,
alpar@1284
   439
    ///then the source of each outgoing edge of \c n is moved to this new node.
alpar@1281
   440
    ///If \c connect is \c true (this is the default value), then a new edge
alpar@1281
   441
    ///from \c n to the newly created node is also added.
alpar@1281
   442
    ///\return The newly created node.
alpar@1281
   443
    ///
alpar@1281
   444
    ///\note The <tt>Edge</tt>s
alpar@1281
   445
    ///referencing a moved edge remain
athos@2102
   446
    ///valid. However <tt>InEdge</tt>s and <tt>OutEdge</tt>s
alpar@1281
   447
    ///may be invalidated.
alpar@1770
   448
    ///\warning This functionality cannot be used together with the Snapshot
alpar@1284
   449
    ///feature.
alpar@1281
   450
    ///\todo It could be implemented in a bit faster way.
deba@2114
   451
    Node split(Node n, bool connect = true) {
alpar@1281
   452
      Node b = addNode();
alpar@1281
   453
      for(OutEdgeIt e(*this,n);e!=INVALID;) {
alpar@1281
   454
 	OutEdgeIt f=e;
alpar@1281
   455
	++f;
alpar@1546
   456
	changeSource(e,b);
alpar@1281
   457
	e=f;
alpar@1281
   458
      }
deba@2114
   459
      if (connect) addEdge(n,b);
alpar@1281
   460
      return b;
alpar@1281
   461
    }
alpar@1281
   462
      
alpar@1812
   463
    ///Split an edge.
alpar@1812
   464
athos@2102
   465
    ///This function splits an edge. First a new node \c b is added to
athos@2102
   466
    ///the graph, then the original edge is re-targeted to \c
athos@2102
   467
    ///b. Finally an edge from \c b to the original target is added.
athos@2102
   468
    ///\return The newly created node.  
athos@2102
   469
    ///\warning This functionality
athos@2102
   470
    ///cannot be used together with the Snapshot feature.
deba@2114
   471
    Node split(Edge e) {
alpar@1812
   472
      Node b = addNode();
alpar@1812
   473
      addEdge(b,target(e));
alpar@1812
   474
      changeTarget(e,b);
alpar@1812
   475
      return b;
alpar@1812
   476
    }
alpar@1812
   477
      
deba@2114
   478
    /// \brief Class to make a snapshot of the graph and restore
deba@2114
   479
    /// to it later.
alpar@1011
   480
    ///
deba@2114
   481
    /// Class to make a snapshot of the graph and to restore it
deba@2114
   482
    /// later.
alpar@1011
   483
    ///
deba@2114
   484
    /// The newly added nodes and edges can be removed using the
deba@2114
   485
    /// restore() function.
deba@2114
   486
    ///
deba@2114
   487
    /// \warning Edge and node deletions cannot be restored.
deba@2114
   488
    class Snapshot {
deba@1774
   489
    public:
deba@1774
   490
      
deba@1774
   491
      class UnsupportedOperation : public LogicError {
deba@1774
   492
      public:
deba@1774
   493
	virtual const char* exceptionName() const {
deba@1774
   494
	  return "lemon::ListGraph::Snapshot::UnsupportedOperation";
deba@1774
   495
	}
deba@1774
   496
      };
deba@1774
   497
            
deba@1774
   498
deba@1999
   499
    protected:
deba@2114
   500
deba@2114
   501
      typedef Parent::NodeNotifier NodeNotifier;
deba@2114
   502
deba@2114
   503
      class NodeObserverProxy : public NodeNotifier::ObserverBase {
deba@2114
   504
      public:
deba@2114
   505
deba@2114
   506
        NodeObserverProxy(Snapshot& _snapshot)
deba@2114
   507
          : snapshot(_snapshot) {}
deba@2114
   508
deba@2114
   509
        using NodeNotifier::ObserverBase::attach;
deba@2114
   510
        using NodeNotifier::ObserverBase::detach;
deba@2114
   511
        using NodeNotifier::ObserverBase::attached;
deba@2114
   512
        
deba@2114
   513
      protected:
deba@2114
   514
        
deba@2114
   515
        virtual void add(const Node& node) {
deba@2114
   516
          snapshot.addNode(node);
deba@2114
   517
        }
deba@2114
   518
        virtual void add(const std::vector<Node>& nodes) {
deba@2114
   519
          for (int i = nodes.size() - 1; i >= 0; ++i) {
deba@2114
   520
            snapshot.addNode(nodes[i]);
deba@2114
   521
          }
deba@2114
   522
        }
deba@2114
   523
        virtual void erase(const Node& node) {
deba@2114
   524
          snapshot.eraseNode(node);
deba@2114
   525
        }
deba@2114
   526
        virtual void erase(const std::vector<Node>& nodes) {
deba@2114
   527
          for (int i = 0; i < (int)nodes.size(); ++i) {
deba@2114
   528
            if (!snapshot.eraseNode(nodes[i])) break;
deba@2114
   529
          }
deba@2114
   530
        }
deba@2114
   531
        virtual void build() {
deba@2114
   532
          NodeNotifier* notifier = getNotifier();
deba@2114
   533
          Node node;
deba@2114
   534
          std::vector<Node> nodes;
deba@2114
   535
          for (notifier->first(node); node != INVALID; notifier->next(node)) {
deba@2114
   536
            nodes.push_back(node);
deba@2114
   537
          }
deba@2114
   538
          for (int i = nodes.size() - 1; i >= 0; --i) {
deba@2114
   539
            snapshot.addNode(nodes[i]);
deba@2114
   540
          }
deba@2114
   541
        }
deba@2114
   542
        virtual void clear() {
deba@2114
   543
          NodeNotifier* notifier = getNotifier();
deba@2114
   544
          Node node;
deba@2114
   545
          for (notifier->first(node); node != INVALID; notifier->next(node)) {
deba@2114
   546
            if (!snapshot.eraseNode(node)) break;
deba@2114
   547
          }
deba@2114
   548
        }
deba@2114
   549
deba@2114
   550
        Snapshot& snapshot;
deba@2114
   551
      };
deba@2114
   552
deba@2114
   553
      class EdgeObserverProxy : public EdgeNotifier::ObserverBase {
deba@2114
   554
      public:
deba@2114
   555
deba@2114
   556
        EdgeObserverProxy(Snapshot& _snapshot)
deba@2114
   557
          : snapshot(_snapshot) {}
deba@2114
   558
deba@2114
   559
        using EdgeNotifier::ObserverBase::attach;
deba@2114
   560
        using EdgeNotifier::ObserverBase::detach;
deba@2114
   561
        using EdgeNotifier::ObserverBase::attached;
deba@2114
   562
        
deba@2114
   563
      protected:
deba@2114
   564
deba@2114
   565
        virtual void add(const Edge& edge) {
deba@2114
   566
          snapshot.addEdge(edge);
deba@2114
   567
        }
deba@2114
   568
        virtual void add(const std::vector<Edge>& edges) {
deba@2114
   569
          for (int i = edges.size() - 1; i >= 0; ++i) {
deba@2114
   570
            snapshot.addEdge(edges[i]);
deba@2114
   571
          }
deba@2114
   572
        }
deba@2114
   573
        virtual void erase(const Edge& edge) {
deba@2114
   574
          snapshot.eraseEdge(edge);
deba@2114
   575
        }
deba@2114
   576
        virtual void erase(const std::vector<Edge>& edges) {
deba@2114
   577
          for (int i = 0; i < (int)edges.size(); ++i) {
deba@2114
   578
            if (!snapshot.eraseEdge(edges[i])) break;
deba@2114
   579
          }
deba@2114
   580
        }
deba@2114
   581
        virtual void build() {
deba@2114
   582
          EdgeNotifier* notifier = getNotifier();
deba@2114
   583
          Edge edge;
deba@2114
   584
          std::vector<Edge> edges;
deba@2114
   585
          for (notifier->first(edge); edge != INVALID; notifier->next(edge)) {
deba@2114
   586
            edges.push_back(edge);
deba@2114
   587
          }
deba@2114
   588
          for (int i = edges.size() - 1; i >= 0; --i) {
deba@2114
   589
            snapshot.addEdge(edges[i]);
deba@2114
   590
          }
deba@2114
   591
        }
deba@2114
   592
        virtual void clear() {
deba@2114
   593
          EdgeNotifier* notifier = getNotifier();
deba@2114
   594
          Edge edge;
deba@2114
   595
          for (notifier->first(edge); edge != INVALID; notifier->next(edge)) {
deba@2114
   596
            if (!snapshot.eraseEdge(edge)) break;
deba@2114
   597
          }
deba@2114
   598
        }
deba@2114
   599
deba@2114
   600
        Snapshot& snapshot;
deba@2114
   601
      };
alpar@1011
   602
      
deba@2114
   603
      ListGraph *graph;
deba@2114
   604
deba@2114
   605
      NodeObserverProxy node_observer_proxy;
deba@2114
   606
      EdgeObserverProxy edge_observer_proxy;
deba@2114
   607
alpar@1011
   608
      std::list<Node> added_nodes;
alpar@1011
   609
      std::list<Edge> added_edges;
deba@2114
   610
deba@2114
   611
deba@2114
   612
      void addNode(const Node& node) {
deba@2114
   613
        added_nodes.push_front(node);        
alpar@1011
   614
      }
deba@2114
   615
      bool eraseNode(const Node& node) {
deba@2114
   616
        std::list<Node>::iterator it = 
deba@2114
   617
          std::find(added_nodes.begin(), added_nodes.end(), node);
deba@2114
   618
        if (it == added_nodes.end()) {
deba@2114
   619
          clear();
deba@2114
   620
          return false;
deba@2114
   621
        } else {
deba@2114
   622
          added_nodes.erase(it);
deba@2114
   623
          return true;
deba@2114
   624
        }
alpar@1011
   625
      }
alpar@1011
   626
deba@2114
   627
      void addEdge(const Edge& edge) {
deba@2114
   628
        added_edges.push_front(edge);        
deba@2114
   629
      }
deba@2114
   630
      bool eraseEdge(const Edge& edge) {
deba@2114
   631
        std::list<Edge>::iterator it = 
deba@2114
   632
          std::find(added_edges.begin(), added_edges.end(), edge);
deba@2114
   633
        if (it == added_edges.end()) {
deba@2114
   634
          clear();
deba@2114
   635
          return false;
deba@2114
   636
        } else {
deba@2114
   637
          added_edges.erase(it);
deba@2114
   638
          return true;
deba@2114
   639
        }        
deba@2114
   640
      }
alpar@1457
   641
deba@2114
   642
      void attach(ListGraph &_graph) {
deba@2114
   643
	graph = &_graph;
deba@2114
   644
	node_observer_proxy.attach(graph->getNotifier(Node()));
deba@2114
   645
        edge_observer_proxy.attach(graph->getNotifier(Edge()));
alpar@1011
   646
      }
alpar@1011
   647
            
deba@2114
   648
      void detach() {
deba@2114
   649
	node_observer_proxy.detach();
deba@2114
   650
	edge_observer_proxy.detach();
deba@2114
   651
      }
deba@2114
   652
deba@2114
   653
      void clear() {
deba@2114
   654
        detach();
deba@2114
   655
        added_nodes.clear();
deba@2114
   656
        added_edges.clear();        
alpar@1011
   657
      }
deba@1774
   658
alpar@1011
   659
    public:
deba@2114
   660
deba@2114
   661
      /// \brief Default constructur.
deba@2114
   662
      ///
deba@2114
   663
      /// Default constructor.
deba@2114
   664
      /// To actually make a snapshot you must call save().
deba@2114
   665
      Snapshot() 
deba@2114
   666
        : graph(0), node_observer_proxy(*this), 
deba@2114
   667
          edge_observer_proxy(*this) {}
alpar@1011
   668
      
deba@2114
   669
      /// \brief Constructor that immediately makes a snapshot.
deba@2114
   670
      ///      
deba@2114
   671
      /// This constructor immediately makes a snapshot of the graph.
deba@2114
   672
      /// \param _graph The graph we make a snapshot of.
deba@2114
   673
      Snapshot(ListGraph &_graph) 
deba@2114
   674
        : node_observer_proxy(*this), 
deba@2114
   675
          edge_observer_proxy(*this) {
deba@2114
   676
	attach(_graph);
alpar@1011
   677
      }
alpar@1011
   678
      
deba@2114
   679
      /// \brief Make a snapshot.
alpar@1011
   680
      ///
deba@2114
   681
      /// Make a snapshot of the graph.
deba@2114
   682
      ///
deba@2114
   683
      /// This function can be called more than once. In case of a repeated
deba@2114
   684
      /// call, the previous snapshot gets lost.
deba@2114
   685
      /// \param _graph The graph we make the snapshot of.
deba@2114
   686
      void save(ListGraph &_graph) {
deba@2114
   687
        clear();
deba@2114
   688
        attach(_graph);
alpar@1011
   689
      }
alpar@1011
   690
      
deba@2114
   691
      /// \brief Undo the changes until the last snapshot.
deba@2114
   692
      // 
alpar@2123
   693
      /// Undo the changes until the last snapshot created by save().
alpar@1011
   694
      void restore() {
deba@2114
   695
	detach();
alpar@1011
   696
	while(!added_edges.empty()) {
deba@2114
   697
	  graph->erase(added_edges.front());
alpar@1011
   698
	  added_edges.pop_front();
alpar@1011
   699
	}
alpar@1011
   700
 	while(!added_nodes.empty()) {
deba@2114
   701
	  graph->erase(added_nodes.front());
alpar@1011
   702
	  added_nodes.pop_front();
alpar@1011
   703
	}
alpar@1011
   704
      }
deba@2114
   705
deba@2114
   706
      /// \brief Gives back true when the snapshot is valid.
deba@2114
   707
      ///
deba@2114
   708
      /// Gives back true when the snapshot is valid.
deba@2114
   709
      bool valid() const {
deba@2114
   710
        return node_observer_proxy.attached();
deba@2114
   711
      }
alpar@1011
   712
    };
alpar@1011
   713
    
alpar@949
   714
  };
klao@1034
   715
deba@2116
   716
  ///@}
deba@2116
   717
deba@2116
   718
  /**************** Undirected List Graph ****************/
deba@2116
   719
deba@2116
   720
  typedef UGraphExtender<UndirGraphExtender<ListGraphBase> > 
deba@2116
   721
  ExtendedListUGraphBase;
deba@2116
   722
deba@2116
   723
  /// \addtogroup graphs
deba@2116
   724
  /// @{
deba@2116
   725
deba@2116
   726
  ///An undirected list graph class.
deba@2116
   727
alpar@2117
   728
  ///This is a simple and fast undirected graph implementation.
deba@2116
   729
  ///
deba@2116
   730
  ///It conforms to the
alpar@2117
   731
  ///\ref concept::UGraph "UGraph concept".
deba@2116
   732
  ///
deba@2116
   733
  ///\sa concept::UGraph.
deba@2116
   734
  ///
deba@2116
   735
  ///\todo Snapshot, reverseEdge(), changeTarget(), changeSource(), contract()
deba@2116
   736
  ///haven't been implemented yet.
deba@2116
   737
  ///
deba@2116
   738
  class ListUGraph : public ExtendedListUGraphBase {
deba@2116
   739
  public:
deba@2116
   740
    typedef ExtendedListUGraphBase Parent;
deba@2116
   741
    /// \brief Add a new node to the graph.
deba@2116
   742
    ///
deba@2116
   743
    /// \return the new node.
deba@2116
   744
    ///
deba@2116
   745
    Node addNode() { return Parent::addNode(); }
deba@2116
   746
deba@2116
   747
    /// \brief Add a new edge to the graph.
deba@2116
   748
    ///
deba@2116
   749
    /// Add a new edge to the graph with source node \c s
deba@2116
   750
    /// and target node \c t.
deba@2116
   751
    /// \return the new undirected edge.
deba@2116
   752
    UEdge addEdge(const Node& s, const Node& t) { 
deba@2116
   753
      return Parent::addEdge(s, t); 
deba@2116
   754
    }
deba@2116
   755
    /// \brief Changes the target of \c e to \c n
deba@2116
   756
    ///
deba@2116
   757
    /// Changes the target of \c e to \c n
deba@2116
   758
    ///
deba@2116
   759
    /// \note The <tt>Edge</tt>'s and <tt>OutEdge</tt>'s
deba@2116
   760
    /// referencing the changed edge remain
deba@2116
   761
    /// valid. However <tt>InEdge</tt>'s are invalidated.
deba@2116
   762
    void changeTarget(UEdge e, Node n) { 
deba@2116
   763
      Parent::changeTarget(e,n); 
deba@2116
   764
    }
deba@2116
   765
    /// Changes the source of \c e to \c n
deba@2116
   766
    ///
deba@2116
   767
    /// Changes the source of \c e to \c n
deba@2116
   768
    ///
deba@2116
   769
    ///\note The <tt>Edge</tt>'s and <tt>InEdge</tt>'s
deba@2116
   770
    ///referencing the changed edge remain
deba@2116
   771
    ///valid. However <tt>OutEdge</tt>'s are invalidated.
deba@2116
   772
    void changeSource(UEdge e, Node n) { 
deba@2116
   773
      Parent::changeSource(e,n); 
deba@2116
   774
    }
deba@2116
   775
    /// \brief Contract two nodes.
deba@2116
   776
    ///
deba@2116
   777
    /// This function contracts two nodes.
deba@2116
   778
    ///
deba@2116
   779
    /// Node \p b will be removed but instead of deleting
deba@2116
   780
    /// its neighboring edges, they will be joined to \p a.
deba@2116
   781
    /// The last parameter \p r controls whether to remove loops. \c true
deba@2116
   782
    /// means that loops will be removed.
deba@2116
   783
    ///
deba@2116
   784
    /// \note The <tt>Edge</tt>s
deba@2116
   785
    /// referencing a moved edge remain
deba@2116
   786
    /// valid.
deba@2116
   787
    void contract(Node a, Node b, bool r = true) {
deba@2116
   788
      for(IncEdgeIt e(*this, b); e!=INVALID;) {
deba@2116
   789
	IncEdgeIt f = e; ++f;
deba@2116
   790
	if (r && runningNode(e) == a) {
deba@2116
   791
	  erase(e);
deba@2116
   792
	} else if (source(e) == b) {
deba@2116
   793
	  changeSource(e, a);
deba@2116
   794
	} else {
deba@2116
   795
	  changeTarget(e, a);
deba@2116
   796
	}
deba@2116
   797
	e = f;
deba@2116
   798
      }
deba@2116
   799
      erase(b);
deba@2116
   800
    }
deba@2116
   801
  };
deba@2116
   802
deba@2116
   803
deba@2116
   804
  class ListBpUGraphBase {
deba@2116
   805
  public:
deba@2116
   806
deba@2116
   807
    class NodeSetError : public LogicError {
deba@2116
   808
      virtual const char* exceptionName() const { 
deba@2116
   809
	return "lemon::ListBpUGraph::NodeSetError";
deba@2116
   810
      }
deba@2116
   811
    };
deba@2116
   812
deba@2116
   813
  protected:
deba@2116
   814
deba@2116
   815
    struct NodeT {
deba@2116
   816
      int first_edge, prev, next;
deba@2116
   817
    };
deba@2116
   818
deba@2116
   819
    struct UEdgeT {
deba@2116
   820
      int aNode, prev_out, next_out;
deba@2116
   821
      int bNode, prev_in, next_in;
deba@2116
   822
    };
deba@2116
   823
deba@2116
   824
    std::vector<NodeT> aNodes;
deba@2116
   825
    std::vector<NodeT> bNodes;
deba@2116
   826
deba@2116
   827
    std::vector<UEdgeT> edges;
deba@2116
   828
deba@2116
   829
    int first_anode;
deba@2116
   830
    int first_free_anode;
deba@2116
   831
deba@2116
   832
    int first_bnode;
deba@2116
   833
    int first_free_bnode;
deba@2116
   834
deba@2116
   835
    int first_free_edge;
deba@2116
   836
deba@2116
   837
  public:
deba@2116
   838
  
deba@2116
   839
    class Node {
deba@2116
   840
      friend class ListBpUGraphBase;
deba@2116
   841
    protected:
deba@2116
   842
      int id;
deba@2116
   843
deba@2116
   844
      explicit Node(int _id) : id(_id) {}
deba@2116
   845
    public:
deba@2116
   846
      Node() {}
deba@2116
   847
      Node(Invalid) { id = -1; }
deba@2116
   848
      bool operator==(const Node i) const {return id==i.id;}
deba@2116
   849
      bool operator!=(const Node i) const {return id!=i.id;}
deba@2116
   850
      bool operator<(const Node i) const {return id<i.id;}
deba@2116
   851
    };
deba@2116
   852
deba@2116
   853
    class UEdge {
deba@2116
   854
      friend class ListBpUGraphBase;
deba@2116
   855
    protected:
deba@2116
   856
      int id;
deba@2116
   857
deba@2116
   858
      explicit UEdge(int _id) { id = _id;}
deba@2116
   859
    public:
deba@2116
   860
      UEdge() {}
deba@2116
   861
      UEdge (Invalid) { id = -1; }
deba@2116
   862
      bool operator==(const UEdge i) const {return id==i.id;}
deba@2116
   863
      bool operator!=(const UEdge i) const {return id!=i.id;}
deba@2116
   864
      bool operator<(const UEdge i) const {return id<i.id;}
deba@2116
   865
    };
deba@2116
   866
deba@2116
   867
    ListBpUGraphBase()
deba@2116
   868
      : first_anode(-1), first_free_anode(-1),
deba@2116
   869
        first_bnode(-1), first_free_bnode(-1),
deba@2116
   870
        first_free_edge(-1) {}
deba@2116
   871
deba@2116
   872
    void firstANode(Node& node) const {
deba@2116
   873
      node.id = first_anode != -1 ? (first_anode << 1) : -1;
deba@2116
   874
    }
deba@2116
   875
    void nextANode(Node& node) const {
deba@2116
   876
      node.id = aNodes[node.id >> 1].next;
deba@2116
   877
    }
deba@2116
   878
deba@2116
   879
    void firstBNode(Node& node) const {
deba@2116
   880
      node.id = first_bnode != -1 ? (first_bnode << 1) + 1 : -1;
deba@2116
   881
    }
deba@2116
   882
    void nextBNode(Node& node) const {
deba@2116
   883
      node.id = bNodes[node.id >> 1].next;
deba@2116
   884
    }
deba@2116
   885
deba@2116
   886
    void first(Node& node) const {
deba@2116
   887
      if (first_anode != -1) {
deba@2116
   888
        node.id = (first_anode << 1);
deba@2116
   889
      } else if (first_bnode != -1) {
deba@2116
   890
        node.id = (first_bnode << 1) + 1;
deba@2116
   891
      } else {
deba@2116
   892
        node.id = -1;
deba@2116
   893
      }
deba@2116
   894
    }
deba@2116
   895
    void next(Node& node) const {
deba@2116
   896
      if (aNode(node)) {
deba@2116
   897
        node.id = aNodes[node.id >> 1].next;
deba@2116
   898
        if (node.id == -1) {
deba@2116
   899
          if (first_bnode != -1) {
deba@2116
   900
            node.id = (first_bnode << 1) + 1;
deba@2116
   901
          }
deba@2116
   902
        }
deba@2116
   903
      } else {
deba@2116
   904
        node.id = bNodes[node.id >> 1].next;
deba@2116
   905
      }
deba@2116
   906
    }
deba@2116
   907
  
deba@2116
   908
    void first(UEdge& edge) const {
deba@2116
   909
      int aNodeId = first_anode;
deba@2116
   910
      while (aNodeId != -1 && aNodes[aNodeId].first_edge == -1) {
deba@2116
   911
        aNodeId = aNodes[aNodeId].next != -1 ? 
deba@2116
   912
          aNodes[aNodeId].next >> 1 : -1;
deba@2116
   913
      }
deba@2116
   914
      if (aNodeId != -1) {
deba@2116
   915
        edge.id = aNodes[aNodeId].first_edge;
deba@2116
   916
      } else {
deba@2116
   917
        edge.id = -1;
deba@2116
   918
      }
deba@2116
   919
    }
deba@2116
   920
    void next(UEdge& edge) const {
deba@2116
   921
      int aNodeId = edges[edge.id].aNode >> 1;
deba@2116
   922
      edge.id = edges[edge.id].next_out;
deba@2116
   923
      if (edge.id == -1) {
deba@2116
   924
        aNodeId = aNodes[aNodeId].next != -1 ? 
deba@2116
   925
          aNodes[aNodeId].next >> 1 : -1;
deba@2116
   926
        while (aNodeId != -1 && aNodes[aNodeId].first_edge == -1) {
deba@2116
   927
          aNodeId = aNodes[aNodeId].next != -1 ? 
deba@2116
   928
          aNodes[aNodeId].next >> 1 : -1;
deba@2116
   929
        }
deba@2116
   930
        if (aNodeId != -1) {
deba@2116
   931
          edge.id = aNodes[aNodeId].first_edge;
deba@2116
   932
        } else {
deba@2116
   933
          edge.id = -1;
deba@2116
   934
        }
deba@2116
   935
      }
deba@2116
   936
    }
deba@2116
   937
deba@2116
   938
    void firstFromANode(UEdge& edge, const Node& node) const {
deba@2116
   939
      LEMON_ASSERT((node.id & 1) == 0, NodeSetError());
deba@2116
   940
      edge.id = aNodes[node.id >> 1].first_edge;
deba@2116
   941
    }
deba@2116
   942
    void nextFromANode(UEdge& edge) const {
deba@2116
   943
      edge.id = edges[edge.id].next_out;
deba@2116
   944
    }
deba@2116
   945
deba@2116
   946
    void firstFromBNode(UEdge& edge, const Node& node) const {
deba@2116
   947
      LEMON_ASSERT((node.id & 1) == 1, NodeSetError());
deba@2116
   948
      edge.id = bNodes[node.id >> 1].first_edge;
deba@2116
   949
    }
deba@2116
   950
    void nextFromBNode(UEdge& edge) const {
deba@2116
   951
      edge.id = edges[edge.id].next_in;
deba@2116
   952
    }
deba@2116
   953
deba@2116
   954
    static int id(const Node& node) {
deba@2116
   955
      return node.id;
deba@2116
   956
    }
deba@2116
   957
    static Node nodeFromId(int id) {
deba@2116
   958
      return Node(id);
deba@2116
   959
    }
deba@2116
   960
    int maxNodeId() const {
deba@2116
   961
      return aNodes.size() > bNodes.size() ?
deba@2116
   962
	aNodes.size() * 2 - 2 : bNodes.size() * 2 - 1;
deba@2116
   963
    }
deba@2116
   964
  
deba@2116
   965
    static int id(const UEdge& edge) {
deba@2116
   966
      return edge.id;
deba@2116
   967
    }
deba@2116
   968
    static UEdge uEdgeFromId(int id) {
deba@2116
   969
      return UEdge(id);
deba@2116
   970
    }
deba@2116
   971
    int maxUEdgeId() const {
deba@2116
   972
      return edges.size();
deba@2116
   973
    }
deba@2116
   974
  
deba@2116
   975
    static int aNodeId(const Node& node) {
deba@2116
   976
      return node.id >> 1;
deba@2116
   977
    }
deba@2116
   978
    static Node fromANodeId(int id) {
deba@2116
   979
      return Node(id << 1);
deba@2116
   980
    }
deba@2116
   981
    int maxANodeId() const {
deba@2116
   982
      return aNodes.size();
deba@2116
   983
    }
deba@2116
   984
deba@2116
   985
    static int bNodeId(const Node& node) {
deba@2116
   986
      return node.id >> 1;
deba@2116
   987
    }
deba@2116
   988
    static Node fromBNodeId(int id) {
deba@2116
   989
      return Node((id << 1) + 1);
deba@2116
   990
    }
deba@2116
   991
    int maxBNodeId() const {
deba@2116
   992
      return bNodes.size();
deba@2116
   993
    }
deba@2116
   994
deba@2116
   995
    Node aNode(const UEdge& edge) const {
deba@2116
   996
      return Node(edges[edge.id].aNode);
deba@2116
   997
    }
deba@2116
   998
    Node bNode(const UEdge& edge) const {
deba@2116
   999
      return Node(edges[edge.id].bNode);
deba@2116
  1000
    }
deba@2116
  1001
deba@2116
  1002
    static bool aNode(const Node& node) {
deba@2116
  1003
      return (node.id & 1) == 0;
deba@2116
  1004
    }
deba@2116
  1005
deba@2116
  1006
    static bool bNode(const Node& node) {
deba@2116
  1007
      return (node.id & 1) == 1;
deba@2116
  1008
    }
deba@2116
  1009
deba@2116
  1010
    Node addANode() {
deba@2116
  1011
      int aNodeId;
deba@2116
  1012
      if (first_free_anode == -1) {
deba@2116
  1013
        aNodeId = aNodes.size();
deba@2116
  1014
        aNodes.push_back(NodeT());
deba@2116
  1015
      } else {
deba@2116
  1016
        aNodeId = first_free_anode;
deba@2116
  1017
        first_free_anode = aNodes[first_free_anode].next;
deba@2116
  1018
      }
deba@2116
  1019
      if (first_anode != -1) {
deba@2116
  1020
        aNodes[aNodeId].next = first_anode << 1;
deba@2116
  1021
        aNodes[first_anode].prev = aNodeId << 1;
deba@2116
  1022
      } else {
deba@2116
  1023
        aNodes[aNodeId].next = -1;
deba@2116
  1024
      }
deba@2116
  1025
      aNodes[aNodeId].prev = -1;
deba@2116
  1026
      first_anode = aNodeId;
deba@2116
  1027
      aNodes[aNodeId].first_edge = -1;
deba@2116
  1028
      return Node(aNodeId << 1);
deba@2116
  1029
    }
deba@2116
  1030
deba@2116
  1031
    Node addBNode() {
deba@2116
  1032
      int bNodeId;
deba@2116
  1033
      if (first_free_bnode == -1) {
deba@2116
  1034
        bNodeId = bNodes.size();
deba@2116
  1035
        bNodes.push_back(NodeT());
deba@2116
  1036
      } else {
deba@2116
  1037
        bNodeId = first_free_bnode;
deba@2116
  1038
        first_free_bnode = bNodes[first_free_bnode].next;
deba@2116
  1039
      }
deba@2116
  1040
      if (first_bnode != -1) {
deba@2116
  1041
        bNodes[bNodeId].next = (first_bnode << 1) + 1;
deba@2116
  1042
        bNodes[first_bnode].prev = (bNodeId << 1) + 1;
deba@2116
  1043
      } else {
deba@2116
  1044
        bNodes[bNodeId].next = -1;
deba@2116
  1045
      }
deba@2116
  1046
      first_bnode = bNodeId;
deba@2116
  1047
      bNodes[bNodeId].first_edge = -1;
deba@2116
  1048
      return Node((bNodeId << 1) + 1);
deba@2116
  1049
    }
deba@2116
  1050
deba@2116
  1051
    UEdge addEdge(const Node& source, const Node& target) {
deba@2116
  1052
      LEMON_ASSERT(((source.id ^ target.id) & 1) == 1, NodeSetError());
deba@2116
  1053
      int edgeId;
deba@2116
  1054
      if (first_free_edge != -1) {
deba@2116
  1055
        edgeId = first_free_edge;
deba@2116
  1056
        first_free_edge = edges[edgeId].next_out;
deba@2116
  1057
      } else {
deba@2116
  1058
        edgeId = edges.size();
deba@2116
  1059
        edges.push_back(UEdgeT());
deba@2116
  1060
      }
deba@2116
  1061
      if ((source.id & 1) == 0) {
deba@2116
  1062
	edges[edgeId].aNode = source.id;
deba@2116
  1063
	edges[edgeId].bNode = target.id;
deba@2116
  1064
      } else {
deba@2116
  1065
	edges[edgeId].aNode = target.id;
deba@2116
  1066
	edges[edgeId].bNode = source.id;
deba@2116
  1067
      }
deba@2116
  1068
      edges[edgeId].next_out = aNodes[edges[edgeId].aNode >> 1].first_edge;
deba@2116
  1069
      edges[edgeId].prev_out = -1;
deba@2116
  1070
      if (aNodes[edges[edgeId].aNode >> 1].first_edge != -1) {
deba@2116
  1071
        edges[aNodes[edges[edgeId].aNode >> 1].first_edge].prev_out = edgeId;
deba@2116
  1072
      }
deba@2116
  1073
      aNodes[edges[edgeId].aNode >> 1].first_edge = edgeId;
deba@2116
  1074
      edges[edgeId].next_in = bNodes[edges[edgeId].bNode >> 1].first_edge;
deba@2116
  1075
      edges[edgeId].prev_in = -1;
deba@2116
  1076
      if (bNodes[edges[edgeId].bNode >> 1].first_edge != -1) {
deba@2116
  1077
        edges[bNodes[edges[edgeId].bNode >> 1].first_edge].prev_in = edgeId;
deba@2116
  1078
      }
deba@2116
  1079
      bNodes[edges[edgeId].bNode >> 1].first_edge = edgeId;
deba@2116
  1080
      return UEdge(edgeId);
deba@2116
  1081
    }
deba@2116
  1082
deba@2116
  1083
    void erase(const Node& node) {
deba@2116
  1084
      if (aNode(node)) {
deba@2116
  1085
        int aNodeId = node.id >> 1;
deba@2116
  1086
        if (aNodes[aNodeId].prev != -1) {
deba@2116
  1087
          aNodes[aNodes[aNodeId].prev >> 1].next = aNodes[aNodeId].next;
deba@2116
  1088
        } else {
deba@2116
  1089
          first_anode = aNodes[aNodeId].next >> 1;
deba@2116
  1090
        }
deba@2116
  1091
        if (aNodes[aNodeId].next != -1) {
deba@2116
  1092
          aNodes[aNodes[aNodeId].next >> 1].prev = aNodes[aNodeId].prev;
deba@2116
  1093
        }
deba@2116
  1094
        aNodes[aNodeId].next = first_free_anode;
deba@2116
  1095
        first_free_anode = aNodeId;
deba@2116
  1096
      } else {
deba@2116
  1097
        int bNodeId = node.id >> 1;
deba@2116
  1098
        if (bNodes[bNodeId].prev != -1) {
deba@2116
  1099
          bNodes[bNodes[bNodeId].prev >> 1].next = bNodes[bNodeId].next;
deba@2116
  1100
        } else {
deba@2116
  1101
          first_bnode = bNodes[bNodeId].next >> 1;
deba@2116
  1102
        }
deba@2116
  1103
        if (bNodes[bNodeId].next != -1) {
deba@2116
  1104
          bNodes[bNodes[bNodeId].next >> 1].prev = bNodes[bNodeId].prev;
deba@2116
  1105
        }
deba@2116
  1106
        bNodes[bNodeId].next = first_free_bnode;
deba@2116
  1107
        first_free_bnode = bNodeId;
deba@2116
  1108
      }
deba@2116
  1109
    }
deba@2116
  1110
deba@2116
  1111
    void erase(const UEdge& edge) {
deba@2116
  1112
deba@2116
  1113
      if (edges[edge.id].prev_out != -1) {
deba@2116
  1114
        edges[edges[edge.id].prev_out].next_out = edges[edge.id].next_out;
deba@2116
  1115
      } else {
deba@2116
  1116
        aNodes[edges[edge.id].aNode >> 1].first_edge = edges[edge.id].next_out;
deba@2116
  1117
      }
deba@2116
  1118
      if (edges[edge.id].next_out != -1) {
deba@2116
  1119
        edges[edges[edge.id].next_out].prev_out = edges[edge.id].prev_out;
deba@2116
  1120
      }
deba@2116
  1121
deba@2116
  1122
      if (edges[edge.id].prev_in != -1) {
deba@2116
  1123
        edges[edges[edge.id].prev_in].next_in = edges[edge.id].next_in;
deba@2116
  1124
      } else {
deba@2116
  1125
        bNodes[edges[edge.id].bNode >> 1].first_edge = edges[edge.id].next_in;
deba@2116
  1126
      }
deba@2116
  1127
      if (edges[edge.id].next_in != -1) {
deba@2116
  1128
        edges[edges[edge.id].next_in].prev_in = edges[edge.id].prev_in;
deba@2116
  1129
      }
deba@2116
  1130
deba@2116
  1131
      edges[edge.id].next_out = first_free_edge;
deba@2116
  1132
      first_free_edge = edge.id;
deba@2116
  1133
    }
deba@2116
  1134
deba@2116
  1135
    void clear() {
deba@2116
  1136
      aNodes.clear();
deba@2116
  1137
      bNodes.clear();
deba@2116
  1138
      edges.clear();
deba@2116
  1139
      first_anode = -1;
deba@2116
  1140
      first_free_anode = -1;
deba@2116
  1141
      first_bnode = -1;
deba@2116
  1142
      first_free_bnode = -1;
deba@2116
  1143
      first_free_edge = -1;
deba@2116
  1144
    }
deba@2116
  1145
deba@2116
  1146
  };
deba@2116
  1147
deba@2116
  1148
deba@2116
  1149
  typedef BpUGraphExtender< ListBpUGraphBase > ExtendedListBpUGraphBase;
deba@2116
  1150
deba@2116
  1151
  /// \ingroup graphs
deba@2116
  1152
  ///
deba@2116
  1153
  /// \brief A smart bipartite undirected graph class.
deba@2116
  1154
  ///
deba@2116
  1155
  /// This is a bipartite undirected graph implementation.
alpar@2117
  1156
  /// It is conforms to the \ref concept::BpUGraph "BpUGraph concept".
deba@2116
  1157
  /// \sa concept::BpUGraph.
deba@2116
  1158
  ///
deba@2116
  1159
  class ListBpUGraph : public ExtendedListBpUGraphBase {};
deba@2116
  1160
deba@2116
  1161
  
deba@2116
  1162
  /// @}  
alpar@948
  1163
} //namespace lemon
klao@946
  1164
  
alpar@400
  1165
klao@946
  1166
#endif