src/hugo/full_graph.h
author deba
Fri, 03 Sep 2004 15:11:17 +0000
changeset 798 6d1abeb62dd3
parent 782 df2e45e09652
child 813 65144c52969c
permissions -rw-r--r--
(none)
marci@606
     1
// -*- c++ -*-
alpar@591
     2
alpar@591
     3
#ifndef HUGO_FULL_GRAPH_H
alpar@591
     4
#define HUGO_FULL_GRAPH_H
alpar@591
     5
alpar@591
     6
///\ingroup graphs
alpar@591
     7
///\file
alpar@591
     8
///\brief FullGraph and SymFullGraph classes.
alpar@591
     9
alpar@591
    10
#include <vector>
deba@782
    11
#include <climits>
alpar@591
    12
alpar@591
    13
#include <hugo/invalid.h>
alpar@591
    14
deba@782
    15
#include <hugo/map_registry.h>
deba@798
    16
#include <hugo/default_map_factory.h>
deba@782
    17
alpar@591
    18
namespace hugo {
alpar@591
    19
alpar@591
    20
/// \addtogroup graphs
alpar@591
    21
/// @{
alpar@591
    22
alpar@591
    23
  ///A full graph class.
alpar@591
    24
alpar@591
    25
  ///This is a simple and fast directed full graph implementation.
marci@606
    26
  ///It is completely static, so you can neither add nor delete either
alpar@591
    27
  ///edges or nodes.
alpar@591
    28
  ///Otherwise it conforms to the graph interface documented under
alpar@591
    29
  ///the description of \ref GraphSkeleton.
alpar@591
    30
  ///\sa \ref GraphSkeleton.
alpar@752
    31
  ///\todo What about loops?
alpar@752
    32
  ///\todo Don't we need SymEdgeMap?
alpar@591
    33
  ///
alpar@591
    34
  ///\author Alpar Juttner
alpar@591
    35
  class FullGraph {
alpar@591
    36
    int NodeNum;
alpar@591
    37
    int EdgeNum;
alpar@591
    38
  public:
deba@782
    39
deba@782
    40
    typedef FullGraph Graph;
alpar@591
    41
alpar@591
    42
    class Node;
alpar@591
    43
    class Edge;
deba@782
    44
alpar@591
    45
    class NodeIt;
alpar@591
    46
    class EdgeIt;
alpar@591
    47
    class OutEdgeIt;
alpar@591
    48
    class InEdgeIt;
alpar@591
    49
    
deba@782
    50
    CREATE_MAP_REGISTRIES;
deba@798
    51
    CREATE_MAPS(DefaultMapFactory);
alpar@591
    52
    
alpar@591
    53
  public:
alpar@591
    54
alpar@591
    55
    ///Creates a full graph with \c n nodes.
alpar@591
    56
    FullGraph(int n) : NodeNum(n), EdgeNum(NodeNum*NodeNum) { }
alpar@591
    57
    ///
alpar@591
    58
    FullGraph(const FullGraph &_g)
alpar@591
    59
      : NodeNum(_g.nodeNum()), EdgeNum(NodeNum*NodeNum) { }
alpar@591
    60
    
alpar@591
    61
    int nodeNum() const { return NodeNum; }  //FIXME: What is this?
alpar@591
    62
    int edgeNum() const { return EdgeNum; }  //FIXME: What is this?
alpar@591
    63
alpar@591
    64
    int maxNodeId() const { return NodeNum; }  //FIXME: What is this?
alpar@591
    65
    int maxEdgeId() const { return EdgeNum; }  //FIXME: What is this?
alpar@591
    66
alpar@591
    67
    Node tail(Edge e) const { return e.n%NodeNum; }
alpar@591
    68
    Node head(Edge e) const { return e.n/NodeNum; }
alpar@591
    69
alpar@591
    70
    NodeIt& first(NodeIt& v) const {
alpar@591
    71
      v=NodeIt(*this); return v; }
alpar@591
    72
    EdgeIt& first(EdgeIt& e) const { 
alpar@591
    73
      e=EdgeIt(*this); return e; }
alpar@591
    74
    OutEdgeIt& first(OutEdgeIt& e, const Node v) const { 
alpar@591
    75
      e=OutEdgeIt(*this,v); return e; }
alpar@591
    76
    InEdgeIt& first(InEdgeIt& e, const Node v) const { 
alpar@591
    77
      e=InEdgeIt(*this,v); return e; }
alpar@591
    78
alpar@713
    79
    static int id(Node v) { return v.n; }
alpar@713
    80
    static int id(Edge e) { return e.n; }
alpar@591
    81
alpar@774
    82
    /// Finds an edge between two nodes.
alpar@774
    83
    
alpar@774
    84
    /// Finds an edge from node \c u to node \c v.
alpar@774
    85
    ///
alpar@774
    86
    /// If \c prev is \ref INVALID (this is the default value), then
alpar@774
    87
    /// It finds the first edge from \c u to \c v. Otherwise it looks for
alpar@774
    88
    /// the next edge from \c u to \c v after \c prev.
alpar@774
    89
    /// \return The found edge or INVALID if there is no such an edge.
alpar@774
    90
    Edge findEdge(Node u,Node v, Edge prev = INVALID) 
alpar@774
    91
    {
deba@782
    92
      return prev.n == -1 ? Edge(*this, u.n, v.n) : INVALID;
alpar@774
    93
    }
alpar@774
    94
    
alpar@774
    95
      
alpar@591
    96
    class Node {
alpar@591
    97
      friend class FullGraph;
alpar@591
    98
      template <typename T> friend class NodeMap;
alpar@591
    99
alpar@591
   100
      friend class Edge;
alpar@591
   101
      friend class OutEdgeIt;
alpar@591
   102
      friend class InEdgeIt;
alpar@591
   103
      friend class SymEdge;
alpar@591
   104
alpar@591
   105
    protected:
alpar@591
   106
      int n;
alpar@722
   107
      friend int FullGraph::id(Node v); 
alpar@591
   108
      Node(int nn) {n=nn;}
alpar@591
   109
    public:
alpar@591
   110
      Node() {}
alpar@591
   111
      Node (Invalid) { n=-1; }
alpar@591
   112
      bool operator==(const Node i) const {return n==i.n;}
alpar@591
   113
      bool operator!=(const Node i) const {return n!=i.n;}
alpar@591
   114
      bool operator<(const Node i) const {return n<i.n;}
alpar@591
   115
    };
alpar@591
   116
    
alpar@591
   117
    class NodeIt : public Node {
alpar@774
   118
      const FullGraph *G;
alpar@591
   119
      friend class FullGraph;
alpar@591
   120
    public:
alpar@591
   121
      NodeIt() : Node() { }
alpar@774
   122
      NodeIt(const FullGraph& _G,Node n) : Node(n), G(&_G) { }
alpar@591
   123
      NodeIt(Invalid i) : Node(i) { }
alpar@774
   124
      NodeIt(const FullGraph& _G) : Node(_G.NodeNum?0:-1), G(&_G) { }
alpar@591
   125
      ///\todo Undocumented conversion Node -\> NodeIt.
alpar@774
   126
      NodeIt& operator++() { n=(n+2)%(G->NodeNum+1)-1;return *this; }
alpar@591
   127
    };
alpar@591
   128
alpar@591
   129
    class Edge {
alpar@591
   130
      friend class FullGraph;
alpar@591
   131
      template <typename T> friend class EdgeMap;
alpar@591
   132
      
alpar@591
   133
      friend class Node;
alpar@591
   134
      friend class NodeIt;
alpar@591
   135
    protected:
alpar@591
   136
      int n; //NodeNum*head+tail;
alpar@722
   137
      friend int FullGraph::id(Edge e);
alpar@591
   138
alpar@774
   139
      Edge(int nn) : n(nn) {}
alpar@774
   140
      Edge(const FullGraph &G, int tail, int head) : n(G.NodeNum*head+tail) {}
alpar@591
   141
    public:
alpar@591
   142
      Edge() { }
alpar@591
   143
      Edge (Invalid) { n=-1; }
alpar@591
   144
      bool operator==(const Edge i) const {return n==i.n;}
alpar@591
   145
      bool operator!=(const Edge i) const {return n!=i.n;}
alpar@591
   146
      bool operator<(const Edge i) const {return n<i.n;}
alpar@591
   147
      ///\bug This is a workaround until somebody tells me how to
alpar@591
   148
      ///make class \c SymFullGraph::SymEdgeMap friend of Edge
alpar@591
   149
      int &idref() {return n;}
alpar@591
   150
      const int &idref() const {return n;}
alpar@591
   151
    };
alpar@591
   152
    
alpar@591
   153
    class EdgeIt : public Edge {
alpar@591
   154
      friend class FullGraph;
alpar@591
   155
    public:
alpar@774
   156
      EdgeIt(const FullGraph& _G) : Edge(_G.EdgeNum-1) { }
alpar@774
   157
      EdgeIt(const FullGraph&, Edge e) : Edge(e) { }
alpar@591
   158
      EdgeIt (Invalid i) : Edge(i) { }
alpar@591
   159
      EdgeIt() : Edge() { }
alpar@774
   160
      EdgeIt& operator++() { --n; return *this; }
alpar@774
   161
alpar@591
   162
      ///\bug This is a workaround until somebody tells me how to
alpar@591
   163
      ///make class \c SymFullGraph::SymEdgeMap friend of Edge
alpar@591
   164
      int &idref() {return n;}
alpar@591
   165
    };
alpar@591
   166
    
alpar@591
   167
    class OutEdgeIt : public Edge {
alpar@774
   168
      const FullGraph *G;
alpar@591
   169
      friend class FullGraph;
alpar@591
   170
    public: 
alpar@591
   171
      OutEdgeIt() : Edge() { }
alpar@774
   172
      OutEdgeIt(const FullGraph& _G, Edge e) : Edge(e), G(&_G) { }
alpar@591
   173
      OutEdgeIt (Invalid i) : Edge(i) { }
alpar@591
   174
alpar@774
   175
      OutEdgeIt(const FullGraph& _G,const Node v) : Edge(v.n), G(&_G) {}
alpar@774
   176
      
alpar@774
   177
      OutEdgeIt& operator++()
alpar@774
   178
      { n+=G->NodeNum; if(n>=G->EdgeNum) n=-1; return *this; }
alpar@774
   179
alpar@591
   180
    };
alpar@591
   181
    
alpar@591
   182
    class InEdgeIt : public Edge {
alpar@774
   183
      const FullGraph *G;
alpar@591
   184
      friend class FullGraph;
alpar@591
   185
    public: 
alpar@591
   186
      InEdgeIt() : Edge() { }
alpar@774
   187
      InEdgeIt(const FullGraph& _G, Edge e) : Edge(e), G(&_G) { }
alpar@591
   188
      InEdgeIt (Invalid i) : Edge(i) { }
alpar@774
   189
      InEdgeIt(const FullGraph& _G,Node v) : Edge(v.n*_G.NodeNum), G(&_G) {}
alpar@774
   190
      InEdgeIt& operator++()
alpar@774
   191
      { if(!((++n)%G->NodeNum)) n=-1; return *this; }
alpar@591
   192
    };
alpar@591
   193
alpar@591
   194
  };
alpar@591
   195
alpar@591
   196
  /// @}  
alpar@591
   197
alpar@591
   198
} //namespace hugo
alpar@591
   199
alpar@591
   200
alpar@591
   201
alpar@591
   202
alpar@591
   203
#endif //HUGO_FULL_GRAPH_H