mirror of
https://github.com/boostorg/graph.git
synced 2026-02-12 12:12:11 +00:00
183 lines
5.6 KiB
HTML
183 lines
5.6 KiB
HTML
<HTML>
|
|
<!--
|
|
-- Copyright (c) Jeremy Siek 2000
|
|
--
|
|
-- Permission to use, copy, modify, distribute and sell this software
|
|
-- and its documentation for any purpose is hereby granted without fee,
|
|
-- provided that the above copyright notice appears in all copies and
|
|
-- that both that copyright notice and this permission notice appear
|
|
-- in supporting documentation. Silicon Graphics makes no
|
|
-- representations about the suitability of this software for any
|
|
-- purpose. It is provided "as is" without express or implied warranty.
|
|
-->
|
|
<Head>
|
|
<Title>Boost Graph Library: Cuthill-Mckee Ordering</Title>
|
|
<BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"
|
|
ALINK="#ff0000">
|
|
<IMG SRC="../../../c++boost.gif"
|
|
ALT="C++ Boost" width="277" height="86">
|
|
|
|
<BR Clear>
|
|
|
|
<H1><A NAME="sec:bfs">
|
|
<TT>cuthill_mckee_ordering</TT>
|
|
</H1>
|
|
|
|
|
|
<P>
|
|
<DIV ALIGN="LEFT">
|
|
<TABLE CELLPADDING=3 border>
|
|
<TR><TH ALIGN="LEFT"><B>Graphs:</B></TH>
|
|
<TD ALIGN="LEFT">undirected</TD>
|
|
</TR>
|
|
<TR><TH ALIGN="LEFT"><B>Properties:</B></TH>
|
|
<TD ALIGN="LEFT">color, degree</TD>
|
|
</TR>
|
|
<TR><TH ALIGN="LEFT"><B>Complexity:</B></TH>
|
|
<TD ALIGN="LEFT">time: <i>O(log(m)|E|)</i> where <i>m = max { degree(v) | v in V }</i> </TD>
|
|
</TR>
|
|
</TABLE>
|
|
</DIV>
|
|
|
|
|
|
<pre>
|
|
(1)
|
|
template <class IncidenceGraph, class OutputIterator,
|
|
class ColorMap, class DegreeMap>
|
|
void
|
|
cuthill_mckee_ordering(IncidenceGraph& g,
|
|
typename graph_traits<Graph>::vertex_descriptor s,
|
|
OutputIterator inverse_permutation,
|
|
ColorMap color, DegreeMap degree)
|
|
|
|
(2)
|
|
template <class VertexListGraph, class OutputIterator,
|
|
class ColorMap, class DegreeMap>
|
|
void
|
|
cuthill_mckee_ordering(VertexListGraph& G, OutputIterator inverse_permutation,
|
|
ColorMap color, DegreeMap degree)
|
|
</pre>
|
|
|
|
The goal of the Cuthill-Mckee (and reverse Cuthill-Mckee) ordering
|
|
algorithm[<A
|
|
HREF="bibliography.html#george81:__sparse_pos_def">14</A>, <A
|
|
HREF="bibliography.html#cuthill69:reducing_bandwith">43</A>, <a
|
|
href="bibliography.html#liu75:rcm">44</a>, <a
|
|
href="bibliography.html#george71:fem">45</a> ] is to reduce the <a
|
|
href="./bandwidth.html">bandwidth</a> of a graph by reordering the
|
|
indices assigned to each vertex. The Cuthill-Mckee ordering algorithm
|
|
works by a local minimization of the i-th bandwidths. The vertices are
|
|
basically assigned a breadth-first search order, except that at each
|
|
step, the adjacent vertices are placed in the queue in order of
|
|
increasing degree.
|
|
|
|
<p>
|
|
Version 1 of the algorithm lets the user choose the ``starting
|
|
vertex'' whereas version 2 finds a good starting vertex using the
|
|
pseudo-peripheral pair heuristic. The choice of the ``starting
|
|
vertex'' can have a significant effect on the quality of the ordering.
|
|
|
|
<p>
|
|
The output of the algorithm are the vertices in the new ordering.
|
|
Depending on what kind of output iterator you use, you can get either
|
|
the Cuthill-Mckee ordering or the reverse Cuthill-McKee ordering. For
|
|
example, if you store the output into a vector using the vector's
|
|
reverse iterator, then you get the reverse Cuthill-McKee ordering.
|
|
|
|
<pre>
|
|
std::vector<vertex_descriptor> inv_perm(num_vertices(G));
|
|
cuthill_mckee_ordering(G, inv_perm.rbegin());
|
|
</pre>
|
|
|
|
<p>
|
|
Either way, storing the output into a vector gives you the
|
|
permutation from the new ordering to the old ordering.
|
|
|
|
<pre>
|
|
inv_perm[new_index[u]] == old_index[u]
|
|
</pre>
|
|
|
|
<p>
|
|
Often times, it is the opposite permutation that you want, the
|
|
permutation from the old index to the new index. This can easily be
|
|
computed in the following way.
|
|
|
|
<pre>
|
|
for (size_type i = 0; i != inv_perm.size(); ++i)
|
|
perm[inv_perm[i]] = i;
|
|
</pre>
|
|
|
|
|
|
|
|
<h3>Parameters</h3>
|
|
|
|
For version 1:
|
|
|
|
<ul>
|
|
|
|
<li> <tt>IncidenceGraph& g</tt> (IN) <br>
|
|
An undirected graph. The graph's type must be a model of <a
|
|
href="./IncidenceGraph.html">IncidenceGraph</a>.
|
|
|
|
<li> <tt>vertex_descriptor s</tt>  (IN) <br>
|
|
The starting vertex.
|
|
|
|
<li> <tt>OutputIterator inverse_permutation</tt>  (OUT) <br>
|
|
The new vertex ordering. The vertices are written to the <a
|
|
href="http://www.sgi.com/tech/stl/OutputIterator.html">output
|
|
iterator</a> in their new order.
|
|
|
|
<li> <tt>ColorMap color_map</tt>  (WORK) <br>
|
|
Used internally to keep track of the progress of the algorithm
|
|
(to avoid visiting the same vertex twice).
|
|
|
|
<li> <tt>DegreeMap degree_map</tt>  (IN) <br>
|
|
This must map vertices to their degree.
|
|
|
|
</ul>
|
|
|
|
|
|
For version 2:
|
|
|
|
<ul>
|
|
|
|
<li> <tt>VertexListGraph& g</tt> (IN) <br>
|
|
An undirected graph. The graph's type must be a model of <a
|
|
href="./VertexListGraph.html">VertexListGraph</a>.
|
|
|
|
<li> <tt><a href="http://www.sgi.com/tech/stl/OutputIterator.html">
|
|
OutputIterator</a> inverse_permutation</tt>  (OUT) <br>
|
|
The new vertex ordering. The vertices are written to the
|
|
output iterator in their new order.
|
|
|
|
<li> <tt>ColorMap color_map</tt>  (WORK) <br>
|
|
Used internally to keep track of the progress of the algorithm
|
|
(to avoid visiting the same vertex twice).
|
|
|
|
<li> <tt>DegreeMap degree_map</tt>  (IN) <br>
|
|
This must map vertices to their degree.
|
|
|
|
</ul>
|
|
|
|
|
|
<h3>Example</h3>
|
|
|
|
See <a
|
|
href="../example/cuthill_mckee_ordering.cpp"><tt>example/cuthill_mckee_ordering.cpp</tt></a>.
|
|
|
|
<h3>See Also</h3>
|
|
|
|
<a href="./bandwidth.html">bandwidth</tt></a>,
|
|
and <tt>degree_property_map</tt> in <tt>boost/graph/properties.hpp</tt>.
|
|
|
|
<br>
|
|
<HR>
|
|
<TABLE>
|
|
<TR valign=top>
|
|
<TD nowrap>Copyright © 2000</TD><TD>
|
|
<A HREF="../../../people/jeremy_siek.htm">Jeremy Siek</A>, Univ.of Notre Dame (<A HREF="mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</A>)
|
|
</TD></TR></TABLE>
|
|
|
|
</BODY>
|
|
</HTML>
|