1 /* -*- mode: C++; indent-tabs-mode: nil; -*-
3 * This file is a part of LEMON, a generic C++ optimization library.
5 * Copyright (C) 2003-2009
6 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
7 * (Egervary Research Group on Combinatorial Optimization, EGRES).
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.
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
22 #include <lemon/core.h>
23 #include <lemon/bits/graph_extender.h>
24 #include <lemon/dim2.h>
25 #include <lemon/assert.h>
29 ///\brief GridGraph class.
37 typedef GridGraphBase Graph;
49 void construct(int width, int height) {
50 _width = width; _height = height;
51 _node_num = width * height;
52 _edge_num = 2 * _node_num - width - height;
53 _edge_limit = _node_num - _width;
58 Node operator()(int i, int j) const {
59 LEMON_DEBUG(0 <= i && i < _width &&
60 0 <= j && j < _height, "Index out of range");
61 return Node(i + j * _width);
64 int col(Node n) const {
65 return n._id % _width;
68 int row(Node n) const {
69 return n._id / _width;
72 dim2::Point<int> pos(Node n) const {
73 return dim2::Point<int>(col(n), row(n));
84 typedef True NodeNumTag;
85 typedef True EdgeNumTag;
86 typedef True ArcNumTag;
88 int nodeNum() const { return _node_num; }
89 int edgeNum() const { return _edge_num; }
90 int arcNum() const { return 2 * _edge_num; }
92 Node u(Edge edge) const {
93 if (edge._id < _edge_limit) {
96 return (edge._id - _edge_limit) % (_width - 1) +
97 (edge._id - _edge_limit) / (_width - 1) * _width;
101 Node v(Edge edge) const {
102 if (edge._id < _edge_limit) {
103 return edge._id + _width;
105 return (edge._id - _edge_limit) % (_width - 1) +
106 (edge._id - _edge_limit) / (_width - 1) * _width + 1;
110 Node source(Arc arc) const {
111 return (arc._id & 1) == 1 ? u(arc) : v(arc);
114 Node target(Arc arc) const {
115 return (arc._id & 1) == 1 ? v(arc) : u(arc);
118 static int id(Node node) { return node._id; }
119 static int id(Edge edge) { return edge._id; }
120 static int id(Arc arc) { return arc._id; }
122 int maxNodeId() const { return _node_num - 1; }
123 int maxEdgeId() const { return _edge_num - 1; }
124 int maxArcId() const { return 2 * _edge_num - 1; }
126 static Node nodeFromId(int id) { return Node(id);}
127 static Edge edgeFromId(int id) { return Edge(id);}
128 static Arc arcFromId(int id) { return Arc(id);}
130 typedef True FindEdgeTag;
131 typedef True FindArcTag;
133 Edge findEdge(Node u, Node v, Edge prev = INVALID) const {
134 if (prev != INVALID) return INVALID;
136 if (v._id - u._id == _width)
138 if (v._id - u._id == 1 && u._id % _width < _width - 1) {
139 return Edge(u._id / _width * (_width - 1) +
140 u._id % _width + _edge_limit);
143 if (u._id - v._id == _width)
145 if (u._id - v._id == 1 && v._id % _width < _width - 1) {
146 return Edge(v._id / _width * (_width - 1) +
147 v._id % _width + _edge_limit);
153 Arc findArc(Node u, Node v, Arc prev = INVALID) const {
154 if (prev != INVALID) return INVALID;
156 if (v._id - u._id == _width)
157 return Arc((u._id << 1) | 1);
158 if (v._id - u._id == 1 && u._id % _width < _width - 1) {
159 return Arc(((u._id / _width * (_width - 1) +
160 u._id % _width + _edge_limit) << 1) | 1);
163 if (u._id - v._id == _width)
164 return Arc(v._id << 1);
165 if (u._id - v._id == 1 && v._id % _width < _width - 1) {
166 return Arc((v._id / _width * (_width - 1) +
167 v._id % _width + _edge_limit) << 1);
174 friend class GridGraphBase;
178 Node(int id) : _id(id) {}
181 Node (Invalid) : _id(-1) {}
182 bool operator==(const Node node) const {return _id == node._id;}
183 bool operator!=(const Node node) const {return _id != node._id;}
184 bool operator<(const Node node) const {return _id < node._id;}
188 friend class GridGraphBase;
194 Edge(int id) : _id(id) {}
198 Edge (Invalid) : _id(-1) {}
199 bool operator==(const Edge edge) const {return _id == edge._id;}
200 bool operator!=(const Edge edge) const {return _id != edge._id;}
201 bool operator<(const Edge edge) const {return _id < edge._id;}
205 friend class GridGraphBase;
210 Arc(int id) : _id(id) {}
214 Arc (Invalid) : _id(-1) {}
215 operator Edge() const { return _id != -1 ? Edge(_id >> 1) : INVALID; }
216 bool operator==(const Arc arc) const {return _id == arc._id;}
217 bool operator!=(const Arc arc) const {return _id != arc._id;}
218 bool operator<(const Arc arc) const {return _id < arc._id;}
221 static bool direction(Arc arc) {
222 return (arc._id & 1) == 1;
225 static Arc direct(Edge edge, bool dir) {
226 return Arc((edge._id << 1) | (dir ? 1 : 0));
229 void first(Node& node) const {
230 node._id = _node_num - 1;
233 static void next(Node& node) {
237 void first(Edge& edge) const {
238 edge._id = _edge_num - 1;
241 static void next(Edge& edge) {
245 void first(Arc& arc) const {
246 arc._id = 2 * _edge_num - 1;
249 static void next(Arc& arc) {
253 void firstOut(Arc& arc, const Node& node) const {
254 if (node._id % _width < _width - 1) {
255 arc._id = (_edge_limit + node._id % _width +
256 (node._id / _width) * (_width - 1)) << 1 | 1;
259 if (node._id < _node_num - _width) {
260 arc._id = node._id << 1 | 1;
263 if (node._id % _width > 0) {
264 arc._id = (_edge_limit + node._id % _width +
265 (node._id / _width) * (_width - 1) - 1) << 1;
268 if (node._id >= _width) {
269 arc._id = (node._id - _width) << 1;
275 void nextOut(Arc& arc) const {
276 int nid = arc._id >> 1;
277 if ((arc._id & 1) == 1) {
278 if (nid >= _edge_limit) {
279 nid = (nid - _edge_limit) % (_width - 1) +
280 (nid - _edge_limit) / (_width - 1) * _width;
281 if (nid < _node_num - _width) {
282 arc._id = nid << 1 | 1;
286 if (nid % _width > 0) {
287 arc._id = (_edge_limit + nid % _width +
288 (nid / _width) * (_width - 1) - 1) << 1;
292 arc._id = (nid - _width) << 1;
296 if (nid >= _edge_limit) {
297 nid = (nid - _edge_limit) % (_width - 1) +
298 (nid - _edge_limit) / (_width - 1) * _width + 1;
300 arc._id = (nid - _width) << 1;
308 void firstIn(Arc& arc, const Node& node) const {
309 if (node._id % _width < _width - 1) {
310 arc._id = (_edge_limit + node._id % _width +
311 (node._id / _width) * (_width - 1)) << 1;
314 if (node._id < _node_num - _width) {
315 arc._id = node._id << 1;
318 if (node._id % _width > 0) {
319 arc._id = (_edge_limit + node._id % _width +
320 (node._id / _width) * (_width - 1) - 1) << 1 | 1;
323 if (node._id >= _width) {
324 arc._id = (node._id - _width) << 1 | 1;
330 void nextIn(Arc& arc) const {
331 int nid = arc._id >> 1;
332 if ((arc._id & 1) == 0) {
333 if (nid >= _edge_limit) {
334 nid = (nid - _edge_limit) % (_width - 1) +
335 (nid - _edge_limit) / (_width - 1) * _width;
336 if (nid < _node_num - _width) {
341 if (nid % _width > 0) {
342 arc._id = (_edge_limit + nid % _width +
343 (nid / _width) * (_width - 1) - 1) << 1 | 1;
347 arc._id = (nid - _width) << 1 | 1;
351 if (nid >= _edge_limit) {
352 nid = (nid - _edge_limit) % (_width - 1) +
353 (nid - _edge_limit) / (_width - 1) * _width + 1;
355 arc._id = (nid - _width) << 1 | 1;
363 void firstInc(Edge& edge, bool& dir, const Node& node) const {
364 if (node._id % _width < _width - 1) {
365 edge._id = _edge_limit + node._id % _width +
366 (node._id / _width) * (_width - 1);
370 if (node._id < _node_num - _width) {
375 if (node._id % _width > 0) {
376 edge._id = _edge_limit + node._id % _width +
377 (node._id / _width) * (_width - 1) - 1;
381 if (node._id >= _width) {
382 edge._id = node._id - _width;
390 void nextInc(Edge& edge, bool& dir) const {
393 if (nid >= _edge_limit) {
394 nid = (nid - _edge_limit) % (_width - 1) +
395 (nid - _edge_limit) / (_width - 1) * _width;
396 if (nid < _node_num - _width) {
401 if (nid % _width > 0) {
402 edge._id = _edge_limit + nid % _width +
403 (nid / _width) * (_width - 1) - 1;
408 edge._id = nid - _width;
413 if (nid >= _edge_limit) {
414 nid = (nid - _edge_limit) % (_width - 1) +
415 (nid - _edge_limit) / (_width - 1) * _width + 1;
417 edge._id = nid - _width;
426 Arc right(Node n) const {
427 if (n._id % _width < _width - 1) {
428 return Arc(((_edge_limit + n._id % _width +
429 (n._id / _width) * (_width - 1)) << 1) | 1);
435 Arc left(Node n) const {
436 if (n._id % _width > 0) {
437 return Arc((_edge_limit + n._id % _width +
438 (n._id / _width) * (_width - 1) - 1) << 1);
444 Arc up(Node n) const {
445 if (n._id < _edge_limit) {
446 return Arc((n._id << 1) | 1);
452 Arc down(Node n) const {
453 if (n._id >= _width) {
454 return Arc((n._id - _width) << 1);
462 int _node_num, _edge_num;
467 typedef GraphExtender<GridGraphBase> ExtendedGridGraphBase;
471 /// \brief Grid graph class
473 /// GridGraph implements a special graph type. The nodes of the
474 /// graph can be indexed by two integer values \c (i,j) where \c i is
475 /// in the range <tt>[0..width()-1]</tt> and j is in the range
476 /// <tt>[0..height()-1]</tt>. Two nodes are connected in the graph if
477 /// the indices differ exactly on one position and the difference is
478 /// also exactly one. The nodes of the graph can be obtained by position
479 /// using the \c operator()() function and the indices of the nodes can
480 /// be obtained using \c pos(), \c col() and \c row() members. The outgoing
481 /// arcs can be retrieved with the \c right(), \c up(), \c left()
482 /// and \c down() functions, where the bottom-left corner is the
485 /// This class is completely static and it needs constant memory space.
486 /// Thus you can neither add nor delete nodes or edges, however
487 /// the structure can be resized using resize().
489 /// \image html grid_graph.png
490 /// \image latex grid_graph.eps "Grid graph" width=\textwidth
492 /// A short example about the basic usage:
494 /// GridGraph graph(rows, cols);
495 /// GridGraph::NodeMap<int> val(graph);
496 /// for (int i = 0; i < graph.width(); ++i) {
497 /// for (int j = 0; j < graph.height(); ++j) {
498 /// val[graph(i, j)] = i + j;
503 /// This type fully conforms to the \ref concepts::Graph "Graph concept".
504 /// Most of its member functions and nested classes are documented
505 /// only in the concept class.
507 /// This class provides constant time counting for nodes, edges and arcs.
508 class GridGraph : public ExtendedGridGraphBase {
509 typedef ExtendedGridGraphBase Parent;
513 /// \brief Map to get the indices of the nodes as \ref dim2::Point
514 /// "dim2::Point<int>".
516 /// Map to get the indices of the nodes as \ref dim2::Point
517 /// "dim2::Point<int>".
520 /// \brief The key type of the map
521 typedef GridGraph::Node Key;
522 /// \brief The value type of the map
523 typedef dim2::Point<int> Value;
525 /// \brief Constructor
526 IndexMap(const GridGraph& graph) : _graph(graph) {}
528 /// \brief The subscript operator
529 Value operator[](Key key) const {
530 return _graph.pos(key);
534 const GridGraph& _graph;
537 /// \brief Map to get the column of the nodes.
539 /// Map to get the column of the nodes.
542 /// \brief The key type of the map
543 typedef GridGraph::Node Key;
544 /// \brief The value type of the map
547 /// \brief Constructor
548 ColMap(const GridGraph& graph) : _graph(graph) {}
550 /// \brief The subscript operator
551 Value operator[](Key key) const {
552 return _graph.col(key);
556 const GridGraph& _graph;
559 /// \brief Map to get the row of the nodes.
561 /// Map to get the row of the nodes.
564 /// \brief The key type of the map
565 typedef GridGraph::Node Key;
566 /// \brief The value type of the map
569 /// \brief Constructor
570 RowMap(const GridGraph& graph) : _graph(graph) {}
572 /// \brief The subscript operator
573 Value operator[](Key key) const {
574 return _graph.row(key);
578 const GridGraph& _graph;
581 /// \brief Constructor
583 /// Construct a grid graph with the given size.
584 GridGraph(int width, int height) { construct(width, height); }
586 /// \brief Resizes the graph
588 /// This function resizes the graph. It fully destroys and
589 /// rebuilds the structure, therefore the maps of the graph will be
590 /// reallocated automatically and the previous values will be lost.
591 void resize(int width, int height) {
592 Parent::notifier(Arc()).clear();
593 Parent::notifier(Edge()).clear();
594 Parent::notifier(Node()).clear();
595 construct(width, height);
596 Parent::notifier(Node()).build();
597 Parent::notifier(Edge()).build();
598 Parent::notifier(Arc()).build();
601 /// \brief The node on the given position.
603 /// Gives back the node on the given position.
604 Node operator()(int i, int j) const {
605 return Parent::operator()(i, j);
608 /// \brief The column index of the node.
610 /// Gives back the column index of the node.
611 int col(Node n) const {
612 return Parent::col(n);
615 /// \brief The row index of the node.
617 /// Gives back the row index of the node.
618 int row(Node n) const {
619 return Parent::row(n);
622 /// \brief The position of the node.
624 /// Gives back the position of the node, ie. the <tt>(col,row)</tt> pair.
625 dim2::Point<int> pos(Node n) const {
626 return Parent::pos(n);
629 /// \brief The number of the columns.
631 /// Gives back the number of the columns.
633 return Parent::width();
636 /// \brief The number of the rows.
638 /// Gives back the number of the rows.
640 return Parent::height();
643 /// \brief The arc goes right from the node.
645 /// Gives back the arc goes right from the node. If there is not
646 /// outgoing arc then it gives back INVALID.
647 Arc right(Node n) const {
648 return Parent::right(n);
651 /// \brief The arc goes left from the node.
653 /// Gives back the arc goes left from the node. If there is not
654 /// outgoing arc then it gives back INVALID.
655 Arc left(Node n) const {
656 return Parent::left(n);
659 /// \brief The arc goes up from the node.
661 /// Gives back the arc goes up from the node. If there is not
662 /// outgoing arc then it gives back INVALID.
663 Arc up(Node n) const {
664 return Parent::up(n);
667 /// \brief The arc goes down from the node.
669 /// Gives back the arc goes down from the node. If there is not
670 /// outgoing arc then it gives back INVALID.
671 Arc down(Node n) const {
672 return Parent::down(n);
675 /// \brief Index map of the grid graph
677 /// Just returns an IndexMap for the grid graph.
678 IndexMap indexMap() const {
679 return IndexMap(*this);
682 /// \brief Row map of the grid graph
684 /// Just returns a RowMap for the grid graph.
685 RowMap rowMap() const {
686 return RowMap(*this);
689 /// \brief Column map of the grid graph
691 /// Just returns a ColMap for the grid graph.
692 ColMap colMap() const {
693 return ColMap(*this);