COIN-OR::LEMON - Graph Library

source: lemon-1.2/lemon/bits/edge_set_extender.h @ 942:2b6bffe0e7e8

Last change on this file since 942:2b6bffe0e7e8 was 942:2b6bffe0e7e8, checked in by Alpar Juttner <alpar@…>, 8 years ago

Merge

File size: 13.7 KB
RevLine 
[877]1/* -*- mode: C++; indent-tabs-mode: nil; -*-
[468]2 *
[877]3 * This file is a part of LEMON, a generic C++ optimization library.
[468]4 *
[877]5 * Copyright (C) 2003-2010
[468]6 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
7 * (Egervary Research Group on Combinatorial Optimization, EGRES).
8 *
9 * Permission to use, modify and distribute this software is granted
10 * provided that this copyright notice appears in all copies. For
11 * precise terms see the accompanying LICENSE file.
12 *
13 * This software is provided "AS IS" with no warranty of any kind,
14 * express or implied, and with no claim as to its suitability for any
15 * purpose.
16 *
17 */
18
19#ifndef LEMON_BITS_EDGE_SET_EXTENDER_H
20#define LEMON_BITS_EDGE_SET_EXTENDER_H
21
[519]22#include <lemon/core.h>
[468]23#include <lemon/error.h>
24#include <lemon/bits/default_map.h>
[519]25#include <lemon/bits/map_extender.h>
[468]26
[559]27//\ingroup digraphbits
28//\file
29//\brief Extenders for the arc set types
[468]30namespace lemon {
31
[559]32  // \ingroup digraphbits
33  //
34  // \brief Extender for the ArcSets
[468]35  template <typename Base>
36  class ArcSetExtender : public Base {
[617]37    typedef Base Parent;
38
[468]39  public:
40
41    typedef ArcSetExtender Digraph;
42
43    // Base extensions
44
45    typedef typename Parent::Node Node;
46    typedef typename Parent::Arc Arc;
47
48    int maxId(Node) const {
49      return Parent::maxNodeId();
50    }
51
52    int maxId(Arc) const {
53      return Parent::maxArcId();
54    }
55
56    Node fromId(int id, Node) const {
57      return Parent::nodeFromId(id);
58    }
59
60    Arc fromId(int id, Arc) const {
61      return Parent::arcFromId(id);
62    }
63
64    Node oppositeNode(const Node &n, const Arc &e) const {
65      if (n == Parent::source(e))
[877]66        return Parent::target(e);
[468]67      else if(n==Parent::target(e))
[877]68        return Parent::source(e);
[468]69      else
[877]70        return INVALID;
[468]71    }
72
73
74    // Alteration notifier extensions
75
[559]76    // The arc observer registry.
[468]77    typedef AlterationNotifier<ArcSetExtender, Arc> ArcNotifier;
78
79  protected:
80
81    mutable ArcNotifier arc_notifier;
82
83  public:
84
85    using Parent::notifier;
86
[559]87    // Gives back the arc alteration notifier.
[468]88    ArcNotifier& notifier(Arc) const {
89      return arc_notifier;
90    }
91
92    // Iterable extensions
93
[877]94    class NodeIt : public Node {
[468]95      const Digraph* digraph;
96    public:
97
98      NodeIt() {}
99
100      NodeIt(Invalid i) : Node(i) { }
101
102      explicit NodeIt(const Digraph& _graph) : digraph(&_graph) {
[877]103        _graph.first(static_cast<Node&>(*this));
[468]104      }
105
[877]106      NodeIt(const Digraph& _graph, const Node& node)
107        : Node(node), digraph(&_graph) {}
[468]108
[877]109      NodeIt& operator++() {
110        digraph->next(*this);
111        return *this;
[468]112      }
113
114    };
115
116
[877]117    class ArcIt : public Arc {
[468]118      const Digraph* digraph;
119    public:
120
121      ArcIt() { }
122
123      ArcIt(Invalid i) : Arc(i) { }
124
125      explicit ArcIt(const Digraph& _graph) : digraph(&_graph) {
[877]126        _graph.first(static_cast<Arc&>(*this));
[468]127      }
128
[877]129      ArcIt(const Digraph& _graph, const Arc& e) :
130        Arc(e), digraph(&_graph) { }
[468]131
[877]132      ArcIt& operator++() {
133        digraph->next(*this);
134        return *this;
[468]135      }
136
137    };
138
139
[877]140    class OutArcIt : public Arc {
[468]141      const Digraph* digraph;
142    public:
143
144      OutArcIt() { }
145
146      OutArcIt(Invalid i) : Arc(i) { }
147
[877]148      OutArcIt(const Digraph& _graph, const Node& node)
149        : digraph(&_graph) {
150        _graph.firstOut(*this, node);
[468]151      }
152
[877]153      OutArcIt(const Digraph& _graph, const Arc& arc)
154        : Arc(arc), digraph(&_graph) {}
[468]155
[877]156      OutArcIt& operator++() {
157        digraph->nextOut(*this);
158        return *this;
[468]159      }
160
161    };
162
163
[877]164    class InArcIt : public Arc {
[468]165      const Digraph* digraph;
166    public:
167
168      InArcIt() { }
169
170      InArcIt(Invalid i) : Arc(i) { }
171
[877]172      InArcIt(const Digraph& _graph, const Node& node)
173        : digraph(&_graph) {
174        _graph.firstIn(*this, node);
[468]175      }
176
[877]177      InArcIt(const Digraph& _graph, const Arc& arc) :
178        Arc(arc), digraph(&_graph) {}
[468]179
[877]180      InArcIt& operator++() {
181        digraph->nextIn(*this);
182        return *this;
[468]183      }
184
185    };
186
[559]187    // \brief Base node of the iterator
188    //
189    // Returns the base node (ie. the source in this case) of the iterator
[468]190    Node baseNode(const OutArcIt &e) const {
191      return Parent::source(static_cast<const Arc&>(e));
192    }
[559]193    // \brief Running node of the iterator
194    //
195    // Returns the running node (ie. the target in this case) of the
196    // iterator
[468]197    Node runningNode(const OutArcIt &e) const {
198      return Parent::target(static_cast<const Arc&>(e));
199    }
200
[559]201    // \brief Base node of the iterator
202    //
203    // Returns the base node (ie. the target in this case) of the iterator
[468]204    Node baseNode(const InArcIt &e) const {
205      return Parent::target(static_cast<const Arc&>(e));
206    }
[559]207    // \brief Running node of the iterator
208    //
209    // Returns the running node (ie. the source in this case) of the
210    // iterator
[468]211    Node runningNode(const InArcIt &e) const {
212      return Parent::source(static_cast<const Arc&>(e));
213    }
214
215    using Parent::first;
216
217    // Mappable extension
[877]218
[468]219    template <typename _Value>
[877]220    class ArcMap
[468]221      : public MapExtender<DefaultMap<Digraph, Arc, _Value> > {
222      typedef MapExtender<DefaultMap<Digraph, Arc, _Value> > Parent;
223
[617]224    public:
[877]225      explicit ArcMap(const Digraph& _g)
226        : Parent(_g) {}
227      ArcMap(const Digraph& _g, const _Value& _v)
228        : Parent(_g, _v) {}
[468]229
230      ArcMap& operator=(const ArcMap& cmap) {
[877]231        return operator=<ArcMap>(cmap);
[468]232      }
233
234      template <typename CMap>
235      ArcMap& operator=(const CMap& cmap) {
236        Parent::operator=(cmap);
[877]237        return *this;
[468]238      }
239
240    };
241
242
243    // Alteration extension
244
245    Arc addArc(const Node& from, const Node& to) {
246      Arc arc = Parent::addArc(from, to);
247      notifier(Arc()).add(arc);
248      return arc;
249    }
[877]250
[468]251    void clear() {
252      notifier(Arc()).clear();
253      Parent::clear();
254    }
255
256    void erase(const Arc& arc) {
257      notifier(Arc()).erase(arc);
258      Parent::erase(arc);
259    }
260
261    ArcSetExtender() {
262      arc_notifier.setContainer(*this);
263    }
264
265    ~ArcSetExtender() {
266      arc_notifier.clear();
267    }
268
269  };
270
271
[559]272  // \ingroup digraphbits
273  //
274  // \brief Extender for the EdgeSets
[468]275  template <typename Base>
276  class EdgeSetExtender : public Base {
[617]277    typedef Base Parent;
[468]278
279  public:
280
[617]281    typedef EdgeSetExtender Graph;
[468]282
[886]283    typedef True UndirectedTag;
284
[468]285    typedef typename Parent::Node Node;
286    typedef typename Parent::Arc Arc;
287    typedef typename Parent::Edge Edge;
288
289    int maxId(Node) const {
290      return Parent::maxNodeId();
291    }
292
293    int maxId(Arc) const {
294      return Parent::maxArcId();
295    }
296
297    int maxId(Edge) const {
298      return Parent::maxEdgeId();
299    }
300
301    Node fromId(int id, Node) const {
302      return Parent::nodeFromId(id);
303    }
304
305    Arc fromId(int id, Arc) const {
306      return Parent::arcFromId(id);
307    }
308
309    Edge fromId(int id, Edge) const {
310      return Parent::edgeFromId(id);
311    }
312
313    Node oppositeNode(const Node &n, const Edge &e) const {
314      if( n == Parent::u(e))
[877]315        return Parent::v(e);
[468]316      else if( n == Parent::v(e))
[877]317        return Parent::u(e);
[468]318      else
[877]319        return INVALID;
[468]320    }
321
322    Arc oppositeArc(const Arc &e) const {
323      return Parent::direct(e, !Parent::direction(e));
324    }
325
326    using Parent::direct;
327    Arc direct(const Edge &e, const Node &s) const {
328      return Parent::direct(e, Parent::u(e) == s);
329    }
330
331    typedef AlterationNotifier<EdgeSetExtender, Arc> ArcNotifier;
332    typedef AlterationNotifier<EdgeSetExtender, Edge> EdgeNotifier;
333
334
335  protected:
336
337    mutable ArcNotifier arc_notifier;
338    mutable EdgeNotifier edge_notifier;
339
340  public:
341
342    using Parent::notifier;
[877]343
[468]344    ArcNotifier& notifier(Arc) const {
345      return arc_notifier;
346    }
347
348    EdgeNotifier& notifier(Edge) const {
349      return edge_notifier;
350    }
351
352
[877]353    class NodeIt : public Node {
[617]354      const Graph* graph;
[468]355    public:
356
357      NodeIt() {}
358
359      NodeIt(Invalid i) : Node(i) { }
360
[617]361      explicit NodeIt(const Graph& _graph) : graph(&_graph) {
[877]362        _graph.first(static_cast<Node&>(*this));
[468]363      }
364
[877]365      NodeIt(const Graph& _graph, const Node& node)
366        : Node(node), graph(&_graph) {}
[468]367
[877]368      NodeIt& operator++() {
369        graph->next(*this);
370        return *this;
[468]371      }
372
373    };
374
375
[877]376    class ArcIt : public Arc {
[617]377      const Graph* graph;
[468]378    public:
379
380      ArcIt() { }
381
382      ArcIt(Invalid i) : Arc(i) { }
383
[617]384      explicit ArcIt(const Graph& _graph) : graph(&_graph) {
[877]385        _graph.first(static_cast<Arc&>(*this));
[468]386      }
387
[877]388      ArcIt(const Graph& _graph, const Arc& e) :
389        Arc(e), graph(&_graph) { }
[468]390
[877]391      ArcIt& operator++() {
392        graph->next(*this);
393        return *this;
[468]394      }
395
396    };
397
398
[877]399    class OutArcIt : public Arc {
[617]400      const Graph* graph;
[468]401    public:
402
403      OutArcIt() { }
404
405      OutArcIt(Invalid i) : Arc(i) { }
406
[877]407      OutArcIt(const Graph& _graph, const Node& node)
408        : graph(&_graph) {
409        _graph.firstOut(*this, node);
[468]410      }
411
[877]412      OutArcIt(const Graph& _graph, const Arc& arc)
413        : Arc(arc), graph(&_graph) {}
[468]414
[877]415      OutArcIt& operator++() {
416        graph->nextOut(*this);
417        return *this;
[468]418      }
419
420    };
421
422
[877]423    class InArcIt : public Arc {
[617]424      const Graph* graph;
[468]425    public:
426
427      InArcIt() { }
428
429      InArcIt(Invalid i) : Arc(i) { }
430
[877]431      InArcIt(const Graph& _graph, const Node& node)
432        : graph(&_graph) {
433        _graph.firstIn(*this, node);
[468]434      }
435
[877]436      InArcIt(const Graph& _graph, const Arc& arc) :
437        Arc(arc), graph(&_graph) {}
[468]438
[877]439      InArcIt& operator++() {
440        graph->nextIn(*this);
441        return *this;
[468]442      }
443
444    };
445
446
[877]447    class EdgeIt : public Parent::Edge {
[617]448      const Graph* graph;
[468]449    public:
450
451      EdgeIt() { }
452
453      EdgeIt(Invalid i) : Edge(i) { }
454
[617]455      explicit EdgeIt(const Graph& _graph) : graph(&_graph) {
[877]456        _graph.first(static_cast<Edge&>(*this));
[468]457      }
458
[877]459      EdgeIt(const Graph& _graph, const Edge& e) :
460        Edge(e), graph(&_graph) { }
[468]461
[877]462      EdgeIt& operator++() {
463        graph->next(*this);
464        return *this;
[468]465      }
466
467    };
468
469    class IncEdgeIt : public Parent::Edge {
470      friend class EdgeSetExtender;
[617]471      const Graph* graph;
[468]472      bool direction;
473    public:
474
475      IncEdgeIt() { }
476
477      IncEdgeIt(Invalid i) : Edge(i), direction(false) { }
478
[617]479      IncEdgeIt(const Graph& _graph, const Node &n) : graph(&_graph) {
[877]480        _graph.firstInc(*this, direction, n);
[468]481      }
482
[617]483      IncEdgeIt(const Graph& _graph, const Edge &ue, const Node &n)
[877]484        : graph(&_graph), Edge(ue) {
485        direction = (_graph.source(ue) == n);
[468]486      }
487
488      IncEdgeIt& operator++() {
[877]489        graph->nextInc(*this, direction);
490        return *this;
[468]491      }
492    };
493
[559]494    // \brief Base node of the iterator
495    //
496    // Returns the base node (ie. the source in this case) of the iterator
[468]497    Node baseNode(const OutArcIt &e) const {
498      return Parent::source(static_cast<const Arc&>(e));
499    }
[559]500    // \brief Running node of the iterator
501    //
502    // Returns the running node (ie. the target in this case) of the
503    // iterator
[468]504    Node runningNode(const OutArcIt &e) const {
505      return Parent::target(static_cast<const Arc&>(e));
506    }
507
[559]508    // \brief Base node of the iterator
509    //
510    // Returns the base node (ie. the target in this case) of the iterator
[468]511    Node baseNode(const InArcIt &e) const {
512      return Parent::target(static_cast<const Arc&>(e));
513    }
[559]514    // \brief Running node of the iterator
515    //
516    // Returns the running node (ie. the source in this case) of the
517    // iterator
[468]518    Node runningNode(const InArcIt &e) const {
519      return Parent::source(static_cast<const Arc&>(e));
520    }
521
[559]522    // Base node of the iterator
523    //
524    // Returns the base node of the iterator
[468]525    Node baseNode(const IncEdgeIt &e) const {
526      return e.direction ? u(e) : v(e);
527    }
[559]528    // Running node of the iterator
529    //
530    // Returns the running node of the iterator
[468]531    Node runningNode(const IncEdgeIt &e) const {
532      return e.direction ? v(e) : u(e);
533    }
534
535
536    template <typename _Value>
[877]537    class ArcMap
[617]538      : public MapExtender<DefaultMap<Graph, Arc, _Value> > {
539      typedef MapExtender<DefaultMap<Graph, Arc, _Value> > Parent;
540
[468]541    public:
[877]542      explicit ArcMap(const Graph& _g)
543        : Parent(_g) {}
544      ArcMap(const Graph& _g, const _Value& _v)
545        : Parent(_g, _v) {}
[468]546
547      ArcMap& operator=(const ArcMap& cmap) {
[877]548        return operator=<ArcMap>(cmap);
[468]549      }
550
551      template <typename CMap>
552      ArcMap& operator=(const CMap& cmap) {
553        Parent::operator=(cmap);
[877]554        return *this;
[468]555      }
556
557    };
558
559
560    template <typename _Value>
[877]561    class EdgeMap
[617]562      : public MapExtender<DefaultMap<Graph, Edge, _Value> > {
563      typedef MapExtender<DefaultMap<Graph, Edge, _Value> > Parent;
564
[468]565    public:
[877]566      explicit EdgeMap(const Graph& _g)
567        : Parent(_g) {}
[468]568
[877]569      EdgeMap(const Graph& _g, const _Value& _v)
570        : Parent(_g, _v) {}
[468]571
572      EdgeMap& operator=(const EdgeMap& cmap) {
[877]573        return operator=<EdgeMap>(cmap);
[468]574      }
575
576      template <typename CMap>
577      EdgeMap& operator=(const CMap& cmap) {
578        Parent::operator=(cmap);
[877]579        return *this;
[468]580      }
581
582    };
583
584
585    // Alteration extension
586
587    Edge addEdge(const Node& from, const Node& to) {
588      Edge edge = Parent::addEdge(from, to);
589      notifier(Edge()).add(edge);
590      std::vector<Arc> arcs;
591      arcs.push_back(Parent::direct(edge, true));
592      arcs.push_back(Parent::direct(edge, false));
593      notifier(Arc()).add(arcs);
594      return edge;
595    }
[877]596
[468]597    void clear() {
598      notifier(Arc()).clear();
599      notifier(Edge()).clear();
600      Parent::clear();
601    }
602
603    void erase(const Edge& edge) {
604      std::vector<Arc> arcs;
605      arcs.push_back(Parent::direct(edge, true));
606      arcs.push_back(Parent::direct(edge, false));
607      notifier(Arc()).erase(arcs);
608      notifier(Edge()).erase(edge);
609      Parent::erase(edge);
610    }
611
612
613    EdgeSetExtender() {
614      arc_notifier.setContainer(*this);
615      edge_notifier.setContainer(*this);
616    }
617
618    ~EdgeSetExtender() {
619      edge_notifier.clear();
620      arc_notifier.clear();
621    }
[877]622
[468]623  };
624
625}
626
627#endif
Note: See TracBrowser for help on using the repository browser.