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