lemon/grid_graph.h
author Peter Kovacs <kpeter@inf.elte.hu>
Tue, 28 Oct 2008 18:33:51 +0100
changeset 355 956a29f30887
parent 348 052cecabcb71
child 372 75cf49ce5390
permissions -rw-r--r--
Improve the migration script and guide (#166)

- Safer replacement of 'graph' and 'edge'.
- Fix the erroneous renaming of [Gg]raphToEps.
- Fixes and improvements in the migration guide.
kpeter@346
     1
/* -*- mode: C++; indent-tabs-mode: nil; -*-
kpeter@346
     2
 *
kpeter@346
     3
 * This file is a part of LEMON, a generic C++ optimization library.
kpeter@346
     4
 *
kpeter@346
     5
 * Copyright (C) 2003-2008
kpeter@346
     6
 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
kpeter@346
     7
 * (Egervary Research Group on Combinatorial Optimization, EGRES).
kpeter@346
     8
 *
kpeter@346
     9
 * Permission to use, modify and distribute this software is granted
kpeter@346
    10
 * provided that this copyright notice appears in all copies. For
kpeter@346
    11
 * precise terms see the accompanying LICENSE file.
kpeter@346
    12
 *
kpeter@346
    13
 * This software is provided "AS IS" with no warranty of any kind,
kpeter@346
    14
 * express or implied, and with no claim as to its suitability for any
kpeter@346
    15
 * purpose.
kpeter@346
    16
 *
kpeter@346
    17
 */
kpeter@346
    18
kpeter@346
    19
#ifndef GRID_GRAPH_H
kpeter@346
    20
#define GRID_GRAPH_H
kpeter@346
    21
kpeter@346
    22
#include <lemon/core.h>
deba@347
    23
#include <lemon/bits/graph_extender.h>
deba@347
    24
#include <lemon/dim2.h>
kpeter@346
    25
#include <lemon/assert.h>
kpeter@346
    26
kpeter@346
    27
///\ingroup graphs
kpeter@346
    28
///\file
kpeter@346
    29
///\brief GridGraph class.
kpeter@346
    30
kpeter@346
    31
namespace lemon {
kpeter@346
    32
kpeter@346
    33
  class GridGraphBase {
kpeter@346
    34
kpeter@346
    35
  public:
kpeter@346
    36
kpeter@346
    37
    typedef GridGraphBase Graph;
kpeter@346
    38
kpeter@346
    39
    class Node;
deba@347
    40
    class Edge;
kpeter@346
    41
    class Arc;
kpeter@346
    42
kpeter@346
    43
  public:
kpeter@346
    44
kpeter@346
    45
    GridGraphBase() {}
kpeter@346
    46
kpeter@346
    47
  protected:
kpeter@346
    48
deba@347
    49
    void construct(int width, int height) {
deba@347
    50
       _width = width; _height = height;
deba@347
    51
      _node_num = width * height;
deba@347
    52
      _edge_num = 2 * _node_num - width - height;
deba@347
    53
      _edge_limit = _node_num - _width;
kpeter@346
    54
    }
kpeter@346
    55
kpeter@346
    56
  public:
kpeter@346
    57
kpeter@346
    58
    Node operator()(int i, int j) const {
deba@347
    59
      LEMON_DEBUG(0 <= i && i < _width &&
deba@347
    60
                  0 <= j  && j < _height, "Index out of range");
kpeter@346
    61
      return Node(i + j * _width);
kpeter@346
    62
    }
kpeter@346
    63
deba@347
    64
    int col(Node n) const {
deba@347
    65
      return n._id % _width;
kpeter@346
    66
    }
kpeter@346
    67
deba@347
    68
    int row(Node n) const {
deba@347
    69
      return n._id / _width;
deba@347
    70
    }
deba@347
    71
deba@347
    72
    dim2::Point<int> pos(Node n) const {
deba@347
    73
      return dim2::Point<int>(col(n), row(n));
kpeter@346
    74
    }
kpeter@346
    75
kpeter@346
    76
    int width() const {
kpeter@346
    77
      return _width;
kpeter@346
    78
    }
kpeter@346
    79
kpeter@346
    80
    int height() const {
kpeter@346
    81
      return _height;
kpeter@346
    82
    }
kpeter@346
    83
kpeter@346
    84
    typedef True NodeNumTag;
kpeter@346
    85
    typedef True ArcNumTag;
kpeter@346
    86
deba@347
    87
    int nodeNum() const { return _node_num; }
deba@347
    88
    int edgeNum() const { return _edge_num; }
deba@347
    89
    int arcNum() const { return 2 * _edge_num; }
kpeter@346
    90
deba@347
    91
    Node u(Edge edge) const {
deba@347
    92
      if (edge._id < _edge_limit) {
deba@347
    93
        return edge._id;
kpeter@346
    94
      } else {
deba@347
    95
        return (edge._id - _edge_limit) % (_width - 1) +
deba@347
    96
          (edge._id - _edge_limit) / (_width - 1) * _width;
kpeter@346
    97
      }
kpeter@346
    98
    }
kpeter@346
    99
deba@347
   100
    Node v(Edge edge) const {
deba@347
   101
      if (edge._id < _edge_limit) {
deba@347
   102
        return edge._id + _width;
kpeter@346
   103
      } else {
deba@347
   104
        return (edge._id - _edge_limit) % (_width - 1) +
deba@347
   105
          (edge._id - _edge_limit) / (_width - 1) * _width + 1;
kpeter@346
   106
      }
kpeter@346
   107
    }
kpeter@346
   108
deba@347
   109
    Node source(Arc arc) const {
deba@347
   110
      return (arc._id & 1) == 1 ? u(arc) : v(arc);
deba@347
   111
    }
deba@347
   112
deba@347
   113
    Node target(Arc arc) const {
deba@347
   114
      return (arc._id & 1) == 1 ? v(arc) : u(arc);
deba@347
   115
    }
deba@347
   116
deba@347
   117
    static int id(Node node) { return node._id; }
deba@347
   118
    static int id(Edge edge) { return edge._id; }
deba@347
   119
    static int id(Arc arc) { return arc._id; }
deba@347
   120
deba@347
   121
    int maxNodeId() const { return _node_num - 1; }
deba@347
   122
    int maxEdgeId() const { return _edge_num - 1; }
deba@347
   123
    int maxArcId() const { return 2 * _edge_num - 1; }
kpeter@346
   124
kpeter@346
   125
    static Node nodeFromId(int id) { return Node(id);}
deba@347
   126
    static Edge edgeFromId(int id) { return Edge(id);}
kpeter@346
   127
    static Arc arcFromId(int id) { return Arc(id);}
kpeter@346
   128
deba@347
   129
    typedef True FindEdgeTag;
deba@347
   130
deba@347
   131
    Edge findEdge(Node u, Node v, Edge prev = INVALID) const {
deba@347
   132
      if (prev != INVALID) return INVALID;
deba@347
   133
      if (v._id > u._id) {
deba@347
   134
        if (v._id - u._id == _width)
deba@347
   135
          return Edge(u._id);
deba@347
   136
        if (v._id - u._id == 1 && u._id % _width < _width - 1) {
deba@347
   137
          return Edge(u._id / _width * (_width - 1) +
deba@347
   138
                      u._id % _width + _edge_limit);
deba@347
   139
        }
deba@347
   140
      } else {
deba@347
   141
        if (u._id - v._id == _width)
deba@347
   142
          return Edge(v._id);
deba@347
   143
        if (u._id - v._id == 1 && v._id % _width < _width - 1) {
deba@347
   144
          return Edge(v._id / _width * (_width - 1) +
deba@347
   145
                      v._id % _width + _edge_limit);
deba@347
   146
        }
deba@347
   147
      }
deba@347
   148
      return INVALID;
deba@347
   149
    }
kpeter@346
   150
kpeter@346
   151
    Arc findArc(Node u, Node v, Arc prev = INVALID) const {
kpeter@346
   152
      if (prev != INVALID) return INVALID;
deba@347
   153
      if (v._id > u._id) {
deba@347
   154
        if (v._id - u._id == _width)
deba@347
   155
          return Arc((u._id << 1) | 1);
deba@347
   156
        if (v._id - u._id == 1 && u._id % _width < _width - 1) {
deba@347
   157
          return Arc(((u._id / _width * (_width - 1) +
deba@347
   158
                       u._id % _width + _edge_limit) << 1) | 1);
deba@347
   159
        }
deba@347
   160
      } else {
deba@347
   161
        if (u._id - v._id == _width)
deba@347
   162
          return Arc(v._id << 1);
deba@347
   163
        if (u._id - v._id == 1 && v._id % _width < _width - 1) {
deba@347
   164
          return Arc((v._id / _width * (_width - 1) +
deba@347
   165
                       v._id % _width + _edge_limit) << 1);
deba@347
   166
        }
kpeter@346
   167
      }
kpeter@346
   168
      return INVALID;
kpeter@346
   169
    }
kpeter@346
   170
kpeter@346
   171
    class Node {
kpeter@346
   172
      friend class GridGraphBase;
kpeter@346
   173
kpeter@346
   174
    protected:
deba@347
   175
      int _id;
deba@347
   176
      Node(int id) : _id(id) {}
kpeter@346
   177
    public:
kpeter@346
   178
      Node() {}
deba@347
   179
      Node (Invalid) : _id(-1) {}
deba@347
   180
      bool operator==(const Node node) const {return _id == node._id;}
deba@347
   181
      bool operator!=(const Node node) const {return _id != node._id;}
deba@347
   182
      bool operator<(const Node node) const {return _id < node._id;}
deba@347
   183
    };
deba@347
   184
deba@347
   185
    class Edge {
deba@347
   186
      friend class GridGraphBase;
kpeter@348
   187
      friend class Arc;
deba@347
   188
deba@347
   189
    protected:
deba@347
   190
      int _id;
deba@347
   191
deba@347
   192
      Edge(int id) : _id(id) {}
deba@347
   193
deba@347
   194
    public:
deba@347
   195
      Edge() {}
deba@347
   196
      Edge (Invalid) : _id(-1) {}
deba@347
   197
      bool operator==(const Edge edge) const {return _id == edge._id;}
deba@347
   198
      bool operator!=(const Edge edge) const {return _id != edge._id;}
deba@347
   199
      bool operator<(const Edge edge) const {return _id < edge._id;}
kpeter@346
   200
    };
kpeter@346
   201
kpeter@346
   202
    class Arc {
kpeter@346
   203
      friend class GridGraphBase;
kpeter@346
   204
kpeter@346
   205
    protected:
deba@347
   206
      int _id;
deba@347
   207
deba@347
   208
      Arc(int id) : _id(id) {}
deba@347
   209
kpeter@346
   210
    public:
kpeter@346
   211
      Arc() {}
deba@347
   212
      Arc (Invalid) : _id(-1) {}
deba@347
   213
      operator Edge() const { return _id != -1 ? Edge(_id >> 1) : INVALID; }
deba@347
   214
      bool operator==(const Arc arc) const {return _id == arc._id;}
deba@347
   215
      bool operator!=(const Arc arc) const {return _id != arc._id;}
deba@347
   216
      bool operator<(const Arc arc) const {return _id < arc._id;}
kpeter@346
   217
    };
kpeter@346
   218
deba@347
   219
    static bool direction(Arc arc) {
deba@347
   220
      return (arc._id & 1) == 1;
deba@347
   221
    }
deba@347
   222
deba@347
   223
    static Arc direct(Edge edge, bool dir) {
deba@347
   224
      return Arc((edge._id << 1) | (dir ? 1 : 0));
deba@347
   225
    }
deba@347
   226
kpeter@346
   227
    void first(Node& node) const {
deba@347
   228
      node._id = _node_num - 1;
kpeter@346
   229
    }
kpeter@346
   230
kpeter@346
   231
    static void next(Node& node) {
deba@347
   232
      --node._id;
deba@347
   233
    }
deba@347
   234
deba@347
   235
    void first(Edge& edge) const {
deba@347
   236
      edge._id = _edge_num - 1;
deba@347
   237
    }
deba@347
   238
deba@347
   239
    static void next(Edge& edge) {
deba@347
   240
      --edge._id;
kpeter@346
   241
    }
kpeter@346
   242
kpeter@346
   243
    void first(Arc& arc) const {
deba@347
   244
      arc._id = 2 * _edge_num - 1;
kpeter@346
   245
    }
kpeter@346
   246
kpeter@346
   247
    static void next(Arc& arc) {
deba@347
   248
      --arc._id;
kpeter@346
   249
    }
kpeter@346
   250
kpeter@346
   251
    void firstOut(Arc& arc, const Node& node) const {
deba@347
   252
      if (node._id % _width < _width - 1) {
deba@347
   253
        arc._id = (_edge_limit + node._id % _width +
deba@347
   254
                   (node._id / _width) * (_width - 1)) << 1 | 1;
deba@347
   255
        return;
deba@347
   256
      }
deba@347
   257
      if (node._id < _node_num - _width) {
deba@347
   258
        arc._id = node._id << 1 | 1;
deba@347
   259
        return;
deba@347
   260
      }
deba@347
   261
      if (node._id % _width > 0) {
deba@347
   262
        arc._id = (_edge_limit + node._id % _width +
deba@347
   263
                   (node._id / _width) * (_width - 1) - 1) << 1;
deba@347
   264
        return;
deba@347
   265
      }
deba@347
   266
      if (node._id >= _width) {
deba@347
   267
        arc._id = (node._id - _width) << 1;
deba@347
   268
        return;
deba@347
   269
      }
deba@347
   270
      arc._id = -1;
deba@347
   271
    }
deba@347
   272
deba@347
   273
    void nextOut(Arc& arc) const {
deba@347
   274
      int nid = arc._id >> 1;
deba@347
   275
      if ((arc._id & 1) == 1) {
deba@347
   276
        if (nid >= _edge_limit) {
deba@347
   277
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   278
            (nid - _edge_limit) / (_width - 1) * _width;
deba@347
   279
          if (nid < _node_num - _width) {
deba@347
   280
            arc._id = nid << 1 | 1;
deba@347
   281
            return;
deba@347
   282
          }
deba@347
   283
        }
deba@347
   284
        if (nid % _width > 0) {
deba@347
   285
          arc._id = (_edge_limit + nid % _width +
deba@347
   286
                     (nid / _width) * (_width - 1) - 1) << 1;
deba@347
   287
          return;
deba@347
   288
        }
deba@347
   289
        if (nid >= _width) {
deba@347
   290
          arc._id = (nid - _width) << 1;
deba@347
   291
          return;
deba@347
   292
        }
kpeter@346
   293
      } else {
deba@347
   294
        if (nid >= _edge_limit) {
deba@347
   295
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   296
            (nid - _edge_limit) / (_width - 1) * _width + 1;
deba@347
   297
          if (nid >= _width) {
deba@347
   298
            arc._id = (nid - _width) << 1;
deba@347
   299
            return;
deba@347
   300
          }
deba@347
   301
        }
deba@347
   302
      }
deba@347
   303
      arc._id = -1;
deba@347
   304
    }
deba@347
   305
deba@347
   306
    void firstIn(Arc& arc, const Node& node) const {
deba@347
   307
      if (node._id % _width < _width - 1) {
deba@347
   308
        arc._id = (_edge_limit + node._id % _width +
deba@347
   309
                   (node._id / _width) * (_width - 1)) << 1;
deba@347
   310
        return;
deba@347
   311
      }
deba@347
   312
      if (node._id < _node_num - _width) {
deba@347
   313
        arc._id = node._id << 1;
deba@347
   314
        return;
deba@347
   315
      }
deba@347
   316
      if (node._id % _width > 0) {
deba@347
   317
        arc._id = (_edge_limit + node._id % _width +
deba@347
   318
                   (node._id / _width) * (_width - 1) - 1) << 1 | 1;
deba@347
   319
        return;
deba@347
   320
      }
deba@347
   321
      if (node._id >= _width) {
deba@347
   322
        arc._id = (node._id - _width) << 1 | 1;
deba@347
   323
        return;
deba@347
   324
      }
deba@347
   325
      arc._id = -1;
deba@347
   326
    }
deba@347
   327
deba@347
   328
    void nextIn(Arc& arc) const {
deba@347
   329
      int nid = arc._id >> 1;
deba@347
   330
      if ((arc._id & 1) == 0) {
deba@347
   331
        if (nid >= _edge_limit) {
deba@347
   332
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   333
            (nid - _edge_limit) / (_width - 1) * _width;
deba@347
   334
          if (nid < _node_num - _width) {
deba@347
   335
            arc._id = nid << 1;
deba@347
   336
            return;
deba@347
   337
          }
deba@347
   338
        }
deba@347
   339
        if (nid % _width > 0) {
deba@347
   340
          arc._id = (_edge_limit + nid % _width +
deba@347
   341
                     (nid / _width) * (_width - 1) - 1) << 1 | 1;
deba@347
   342
          return;
deba@347
   343
        }
deba@347
   344
        if (nid >= _width) {
deba@347
   345
          arc._id = (nid - _width) << 1 | 1;
deba@347
   346
          return;
deba@347
   347
        }
deba@347
   348
      } else {
deba@347
   349
        if (nid >= _edge_limit) {
deba@347
   350
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   351
            (nid - _edge_limit) / (_width - 1) * _width + 1;
deba@347
   352
          if (nid >= _width) {
deba@347
   353
            arc._id = (nid - _width) << 1 | 1;
deba@347
   354
            return;
deba@347
   355
          }
deba@347
   356
        }
deba@347
   357
      }
deba@347
   358
      arc._id = -1;
deba@347
   359
    }
deba@347
   360
deba@347
   361
    void firstInc(Edge& edge, bool& dir, const Node& node) const {
deba@347
   362
      if (node._id % _width < _width - 1) {
deba@347
   363
        edge._id = _edge_limit + node._id % _width +
deba@347
   364
          (node._id / _width) * (_width - 1);
deba@347
   365
        dir = true;
deba@347
   366
        return;
deba@347
   367
      }
deba@347
   368
      if (node._id < _node_num - _width) {
deba@347
   369
        edge._id = node._id;
deba@347
   370
        dir = true;
deba@347
   371
        return;
deba@347
   372
      }
deba@347
   373
      if (node._id % _width > 0) {
deba@347
   374
        edge._id = _edge_limit + node._id % _width +
deba@347
   375
          (node._id / _width) * (_width - 1) - 1;
deba@347
   376
        dir = false;
deba@347
   377
        return;
deba@347
   378
      }
deba@347
   379
      if (node._id >= _width) {
deba@347
   380
        edge._id = node._id - _width;
deba@347
   381
        dir = false;
deba@347
   382
        return;
deba@347
   383
      }
deba@347
   384
      edge._id = -1;
deba@347
   385
      dir = true;
deba@347
   386
    }
deba@347
   387
deba@347
   388
    void nextInc(Edge& edge, bool& dir) const {
deba@347
   389
      int nid = edge._id;
deba@347
   390
      if (dir) {
deba@347
   391
        if (nid >= _edge_limit) {
deba@347
   392
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   393
            (nid - _edge_limit) / (_width - 1) * _width;
deba@347
   394
          if (nid < _node_num - _width) {
deba@347
   395
            edge._id = nid;
deba@347
   396
            return;
deba@347
   397
          }
deba@347
   398
        }
deba@347
   399
        if (nid % _width > 0) {
deba@347
   400
          edge._id = _edge_limit + nid % _width +
deba@347
   401
            (nid / _width) * (_width - 1) - 1;
deba@347
   402
          dir = false;
deba@347
   403
          return;
deba@347
   404
        }
deba@347
   405
        if (nid >= _width) {
deba@347
   406
          edge._id = nid - _width;
deba@347
   407
          dir = false;
deba@347
   408
          return;
deba@347
   409
        }
deba@347
   410
      } else {
deba@347
   411
        if (nid >= _edge_limit) {
deba@347
   412
          nid = (nid - _edge_limit) % (_width - 1) +
deba@347
   413
            (nid - _edge_limit) / (_width - 1) * _width + 1;
deba@347
   414
          if (nid >= _width) {
deba@347
   415
            edge._id = nid - _width;
deba@347
   416
            return;
deba@347
   417
          }
deba@347
   418
        }
deba@347
   419
      }
deba@347
   420
      edge._id = -1;
deba@347
   421
      dir = true;
deba@347
   422
    }
deba@347
   423
deba@347
   424
    Arc right(Node n) const {
deba@347
   425
      if (n._id % _width < _width - 1) {
deba@347
   426
        return Arc(((_edge_limit + n._id % _width +
deba@347
   427
                    (n._id / _width) * (_width - 1)) << 1) | 1);
deba@347
   428
      } else {
deba@347
   429
        return INVALID;
kpeter@346
   430
      }
kpeter@346
   431
    }
kpeter@346
   432
deba@347
   433
    Arc left(Node n) const {
deba@347
   434
      if (n._id % _width > 0) {
deba@347
   435
        return Arc((_edge_limit + n._id % _width +
deba@347
   436
                     (n._id / _width) * (_width - 1) - 1) << 1);
kpeter@346
   437
      } else {
deba@347
   438
        return INVALID;
kpeter@346
   439
      }
kpeter@346
   440
    }
kpeter@346
   441
deba@347
   442
    Arc up(Node n) const {
deba@347
   443
      if (n._id < _edge_limit) {
deba@347
   444
        return Arc((n._id << 1) | 1);
kpeter@346
   445
      } else {
deba@347
   446
        return INVALID;
kpeter@346
   447
      }
kpeter@346
   448
    }
kpeter@346
   449
deba@347
   450
    Arc down(Node n) const {
deba@347
   451
      if (n._id >= _width) {
deba@347
   452
        return Arc((n._id - _width) << 1);
kpeter@346
   453
      } else {
deba@347
   454
        return INVALID;
kpeter@346
   455
      }
kpeter@346
   456
    }
kpeter@346
   457
kpeter@346
   458
  private:
kpeter@346
   459
    int _width, _height;
deba@347
   460
    int _node_num, _edge_num;
deba@347
   461
    int _edge_limit;
kpeter@346
   462
  };
kpeter@346
   463
deba@347
   464
deba@347
   465
  typedef GraphExtender<GridGraphBase> ExtendedGridGraphBase;
kpeter@346
   466
kpeter@346
   467
  /// \ingroup graphs
kpeter@346
   468
  ///
kpeter@346
   469
  /// \brief Grid graph class
kpeter@346
   470
  ///
kpeter@346
   471
  /// This class implements a special graph type. The nodes of the
deba@347
   472
  /// graph can be indexed by two integer \c (i,j) value where \c i is
deba@347
   473
  /// in the \c [0..width()-1] range and j is in the \c
deba@347
   474
  /// [0..height()-1] range.  Two nodes are connected in the graph if
deba@347
   475
  /// the indexes differ exactly on one position and exactly one is
kpeter@348
   476
  /// the difference. The nodes of the graph can be indexed by position
kpeter@348
   477
  /// with the \c operator()() function. The positions of the nodes can be
deba@347
   478
  /// get with \c pos(), \c col() and \c row() members. The outgoing
deba@347
   479
  /// arcs can be retrieved with the \c right(), \c up(), \c left()
deba@347
   480
  /// and \c down() functions, where the bottom-left corner is the
deba@347
   481
  /// origin.
kpeter@346
   482
  ///
kpeter@346
   483
  /// \image html grid_graph.png
deba@350
   484
  /// \image latex grid_graph.eps "Grid graph" width=\textwidth
kpeter@346
   485
  ///
deba@347
   486
  /// A short example about the basic usage:
kpeter@346
   487
  ///\code
deba@347
   488
  /// GridGraph graph(rows, cols);
deba@347
   489
  /// GridGraph::NodeMap<int> val(graph);
deba@347
   490
  /// for (int i = 0; i < graph.width(); ++i) {
deba@347
   491
  ///   for (int j = 0; j < graph.height(); ++j) {
deba@347
   492
  ///     val[graph(i, j)] = i + j;
kpeter@346
   493
  ///   }
kpeter@346
   494
  /// }
kpeter@346
   495
  ///\endcode
kpeter@346
   496
  ///
kpeter@348
   497
  /// This graph type is fully conform to the \ref concepts::Graph
deba@347
   498
  /// "Graph" concept, and it also has an important extra feature
kpeter@348
   499
  /// that its maps are real \ref concepts::ReferenceMap
kpeter@348
   500
  /// "reference map"s.
kpeter@346
   501
  class GridGraph : public ExtendedGridGraphBase {
kpeter@346
   502
  public:
kpeter@346
   503
kpeter@346
   504
    typedef ExtendedGridGraphBase Parent;
kpeter@346
   505
kpeter@346
   506
    /// \brief Map to get the indices of the nodes as dim2::Point<int>.
kpeter@346
   507
    ///
kpeter@346
   508
    /// Map to get the indices of the nodes as dim2::Point<int>.
kpeter@346
   509
    class IndexMap {
kpeter@346
   510
    public:
deba@347
   511
      /// \brief The key type of the map
kpeter@346
   512
      typedef GridGraph::Node Key;
deba@347
   513
      /// \brief The value type of the map
kpeter@346
   514
      typedef dim2::Point<int> Value;
kpeter@346
   515
deba@347
   516
      /// \brief Constructor
deba@347
   517
      ///
kpeter@346
   518
      /// Constructor
kpeter@346
   519
      IndexMap(const GridGraph& graph) : _graph(graph) {}
kpeter@346
   520
deba@347
   521
      /// \brief The subscript operator
deba@347
   522
      ///
deba@347
   523
      /// The subscript operator.
deba@347
   524
      Value operator[](Key key) const {
deba@347
   525
        return _graph.pos(key);
deba@347
   526
      }
deba@347
   527
deba@347
   528
    private:
deba@347
   529
      const GridGraph& _graph;
deba@347
   530
    };
deba@347
   531
deba@347
   532
    /// \brief Map to get the column of the nodes.
deba@347
   533
    ///
deba@347
   534
    /// Map to get the column of the nodes.
deba@347
   535
    class ColMap {
deba@347
   536
    public:
deba@347
   537
      /// \brief The key type of the map
deba@347
   538
      typedef GridGraph::Node Key;
deba@347
   539
      /// \brief The value type of the map
deba@347
   540
      typedef int Value;
deba@347
   541
deba@347
   542
      /// \brief Constructor
deba@347
   543
      ///
deba@347
   544
      /// Constructor
deba@347
   545
      ColMap(const GridGraph& graph) : _graph(graph) {}
deba@347
   546
deba@347
   547
      /// \brief The subscript operator
deba@347
   548
      ///
deba@347
   549
      /// The subscript operator.
deba@347
   550
      Value operator[](Key key) const {
deba@347
   551
        return _graph.col(key);
kpeter@346
   552
      }
kpeter@346
   553
kpeter@346
   554
    private:
kpeter@346
   555
      const GridGraph& _graph;
kpeter@346
   556
    };
kpeter@346
   557
kpeter@346
   558
    /// \brief Map to get the row of the nodes.
kpeter@346
   559
    ///
kpeter@346
   560
    /// Map to get the row of the nodes.
kpeter@346
   561
    class RowMap {
kpeter@346
   562
    public:
deba@347
   563
      /// \brief The key type of the map
kpeter@346
   564
      typedef GridGraph::Node Key;
deba@347
   565
      /// \brief The value type of the map
kpeter@346
   566
      typedef int Value;
kpeter@346
   567
deba@347
   568
      /// \brief Constructor
deba@347
   569
      ///
kpeter@346
   570
      /// Constructor
kpeter@346
   571
      RowMap(const GridGraph& graph) : _graph(graph) {}
kpeter@346
   572
deba@347
   573
      /// \brief The subscript operator
deba@347
   574
      ///
deba@347
   575
      /// The subscript operator.
deba@347
   576
      Value operator[](Key key) const {
kpeter@346
   577
        return _graph.row(key);
kpeter@346
   578
      }
kpeter@346
   579
kpeter@346
   580
    private:
kpeter@346
   581
      const GridGraph& _graph;
kpeter@346
   582
    };
kpeter@346
   583
kpeter@346
   584
    /// \brief Constructor
kpeter@346
   585
    ///
deba@347
   586
    /// Construct a grid graph with given size.
kpeter@346
   587
    GridGraph(int width, int height) { construct(width, height); }
kpeter@346
   588
kpeter@346
   589
    /// \brief Resize the graph
kpeter@346
   590
    ///
deba@347
   591
    /// Resize the graph. The function will fully destroy and rebuild
deba@347
   592
    /// the graph.  This cause that the maps of the graph will
deba@347
   593
    /// reallocated automatically and the previous values will be
deba@347
   594
    /// lost.
kpeter@346
   595
    void resize(int width, int height) {
kpeter@346
   596
      Parent::notifier(Arc()).clear();
kpeter@346
   597
      Parent::notifier(Edge()).clear();
kpeter@346
   598
      Parent::notifier(Node()).clear();
kpeter@346
   599
      construct(width, height);
kpeter@346
   600
      Parent::notifier(Node()).build();
kpeter@346
   601
      Parent::notifier(Edge()).build();
kpeter@346
   602
      Parent::notifier(Arc()).build();
kpeter@346
   603
    }
kpeter@346
   604
kpeter@346
   605
    /// \brief The node on the given position.
kpeter@346
   606
    ///
kpeter@346
   607
    /// Gives back the node on the given position.
kpeter@346
   608
    Node operator()(int i, int j) const {
kpeter@346
   609
      return Parent::operator()(i, j);
kpeter@346
   610
    }
kpeter@346
   611
deba@347
   612
    /// \brief Gives back the column index of the node.
deba@347
   613
    ///
deba@347
   614
    /// Gives back the column index of the node.
deba@347
   615
    int col(Node n) const {
deba@347
   616
      return Parent::col(n);
deba@347
   617
    }
deba@347
   618
kpeter@346
   619
    /// \brief Gives back the row index of the node.
kpeter@346
   620
    ///
kpeter@346
   621
    /// Gives back the row index of the node.
kpeter@346
   622
    int row(Node n) const {
kpeter@346
   623
      return Parent::row(n);
kpeter@346
   624
    }
kpeter@346
   625
deba@347
   626
    /// \brief Gives back the position of the node.
kpeter@346
   627
    ///
deba@347
   628
    /// Gives back the position of the node, ie. the <tt>(col,row)</tt> pair.
deba@347
   629
    dim2::Point<int> pos(Node n) const {
deba@347
   630
      return Parent::pos(n);
kpeter@346
   631
    }
kpeter@346
   632
deba@347
   633
    /// \brief Gives back the number of the columns.
kpeter@346
   634
    ///
deba@347
   635
    /// Gives back the number of the columns.
kpeter@346
   636
    int width() const {
kpeter@346
   637
      return Parent::width();
kpeter@346
   638
    }
kpeter@346
   639
deba@347
   640
    /// \brief Gives back the number of the rows.
kpeter@346
   641
    ///
deba@347
   642
    /// Gives back the number of the rows.
kpeter@346
   643
    int height() const {
kpeter@346
   644
      return Parent::height();
kpeter@346
   645
    }
kpeter@346
   646
deba@347
   647
    /// \brief Gives back the arc goes right from the node.
deba@347
   648
    ///
deba@347
   649
    /// Gives back the arc goes right from the node. If there is not
deba@347
   650
    /// outgoing arc then it gives back INVALID.
deba@347
   651
    Arc right(Node n) const {
deba@347
   652
      return Parent::right(n);
deba@347
   653
    }
deba@347
   654
deba@347
   655
    /// \brief Gives back the arc goes left from the node.
deba@347
   656
    ///
deba@347
   657
    /// Gives back the arc goes left from the node. If there is not
deba@347
   658
    /// outgoing arc then it gives back INVALID.
deba@347
   659
    Arc left(Node n) const {
deba@347
   660
      return Parent::left(n);
deba@347
   661
    }
deba@347
   662
deba@347
   663
    /// \brief Gives back the arc goes up from the node.
deba@347
   664
    ///
deba@347
   665
    /// Gives back the arc goes up from the node. If there is not
deba@347
   666
    /// outgoing arc then it gives back INVALID.
deba@347
   667
    Arc up(Node n) const {
deba@347
   668
      return Parent::up(n);
deba@347
   669
    }
deba@347
   670
kpeter@346
   671
    /// \brief Gives back the arc goes down from the node.
kpeter@346
   672
    ///
kpeter@346
   673
    /// Gives back the arc goes down from the node. If there is not
deba@347
   674
    /// outgoing arc then it gives back INVALID.
kpeter@346
   675
    Arc down(Node n) const {
deba@347
   676
      return Parent::down(n);
kpeter@346
   677
    }
kpeter@346
   678
deba@347
   679
    /// \brief Index map of the grid graph
kpeter@346
   680
    ///
deba@347
   681
    /// Just returns an IndexMap for the grid graph.
deba@347
   682
    IndexMap indexMap() const {
deba@347
   683
      return IndexMap(*this);
kpeter@346
   684
    }
kpeter@346
   685
deba@347
   686
    /// \brief Row map of the grid graph
kpeter@346
   687
    ///
deba@347
   688
    /// Just returns a RowMap for the grid graph.
deba@347
   689
    RowMap rowMap() const {
deba@347
   690
      return RowMap(*this);
kpeter@346
   691
    }
kpeter@346
   692
deba@347
   693
    /// \brief Column map of the grid graph
kpeter@346
   694
    ///
deba@347
   695
    /// Just returns a ColMap for the grid graph.
deba@347
   696
    ColMap colMap() const {
deba@347
   697
      return ColMap(*this);
kpeter@346
   698
    }
kpeter@346
   699
deba@347
   700
  };
kpeter@346
   701
kpeter@346
   702
}
deba@347
   703
#endif