PlanarColoring
Declared in lemon/planarity.h, in the group Planar Embedding and Drawing; the same class on the Doxygen site.
-
template< typename Graph >
class PlanarColoring Coloring planar graphs.
The graph coloring problem is the coloring of the graph nodes so that there are no adjacent nodes with the same color. The planar graphs can always be colored with four colors, which is proved by Appel and Haken. Their proofs provide a quadratic time algorithm for four coloring, but it could not be used to implement an efficient algorithm. The five and six coloring can be made in linear time, but in this class, the five coloring has quadratic worst case time complexity. The two coloring (if possible) is solvable with a graph search algorithm and it is implemented in bipartitePartitions() function in LEMON. To decide whether a planar graph is three colorable is NP-complete.
This class contains member functions for calculate colorings with five and six colors. The six coloring algorithm is a simple greedy coloring on the backward minimum outgoing order of nodes. This order can be computed by selecting the node with least outgoing arcs to unprocessed nodes in each phase. This order guarantees that when a node is chosen for coloring it has at most five already colored adjacents. The five coloring algorithm use the same method, but if the greedy approach fails to color with five colors, i.e. the node has five already different colored neighbours, it swaps the colors in one of the connected two colored sets with the Kempe recoloring method.
Public Types
-
typedef ComposeMap< Palette , IndexMap > ColorMap
The map type for storing colors.
Public Functions
-
inline PlanarColoring( const Graph & graph )
Constructor.
- Pre:
The graph must be simple, i.e. it should not contain parallel or loop arcs.
-
inline const IndexMap & colorIndexMap() const
Return the node map of color indices.
This function returns a const reference to the node map of color indices, rather than a copy of it. The values are in the range
[0..4] or[0..5] according to the coloring method.
-
inline ColorMap colorMap() const
Return the node map of colors.
This function returns the node map of colors. The values are among five or six distinct colors.
-
inline int colorIndex( const Node & node ) const
Return the color index of the node.
This function returns the color index of the given node. The value is in the range
[0..4] or[0..5] according to the coloring method.
-
inline Color color( const Node & node ) const
Return the color of the node.
This function returns the color of the given node. The value is among five or six distinct colors.
-
inline bool runSixColoring()
Calculate a coloring with at most six colors.
This function calculates a coloring with at most six colors. The time complexity of this variant is linear in the size of the graph.
Note
This function can return
trueif the graph is not planar, but it can be colored with at most six colors.- Returns:
trueif the algorithm could color the graph with six colors. If the algorithm fails, then the graph is not planar.
-
template< typename EmbeddingMap >
inline void runFiveColoring( - const EmbeddingMap & embedding
Calculate a coloring with at most five colors.
This function calculates a coloring with at most five colors. The worst case time complexity of this variant is quadratic in the size of the graph.
- Parameters:
embedding – This map should contain a valid combinatorical embedding, i.e. a valid cyclic order of the arcs. It can be computed using PlanarEmbedding.
-
inline bool runFiveColoring()
Calculate a coloring with at most five colors.
This function calculates a coloring with at most five colors. The worst case time complexity of this variant is quadratic in the size of the graph.
- Returns:
trueif the graph is planar.
-
typedef ComposeMap< Palette , IndexMap > ColorMap