epoc32/include/stdapis/boost/graph/dijkstra_shortest_paths.hpp
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@2
     1
//=======================================================================
williamr@2
     2
// Copyright 1997, 1998, 1999, 2000 University of Notre Dame.
williamr@2
     3
// Authors: Andrew Lumsdaine, Lie-Quan Lee, Jeremy G. Siek
williamr@2
     4
//
williamr@2
     5
// Distributed under the Boost Software License, Version 1.0. (See
williamr@2
     6
// accompanying file LICENSE_1_0.txt or copy at
williamr@2
     7
// http://www.boost.org/LICENSE_1_0.txt)
williamr@2
     8
//=======================================================================
williamr@2
     9
#ifndef BOOST_GRAPH_DIJKSTRA_HPP
williamr@2
    10
#define BOOST_GRAPH_DIJKSTRA_HPP
williamr@2
    11
williamr@2
    12
#include <functional>
williamr@2
    13
#include <boost/limits.hpp>
williamr@2
    14
#include <boost/graph/named_function_params.hpp>
williamr@2
    15
#include <boost/graph/breadth_first_search.hpp>
williamr@2
    16
#include <boost/graph/relax.hpp>
williamr@2
    17
#include <boost/pending/indirect_cmp.hpp>
williamr@2
    18
#include <boost/graph/exception.hpp>
williamr@2
    19
#include <boost/pending/relaxed_heap.hpp>
williamr@2
    20
williamr@2
    21
#ifdef BOOST_GRAPH_DIJKSTRA_TESTING
williamr@2
    22
#  include <boost/pending/mutable_queue.hpp>
williamr@2
    23
#endif // BOOST_GRAPH_DIJKSTRA_TESTING
williamr@2
    24
williamr@2
    25
namespace boost {
williamr@2
    26
williamr@2
    27
#ifdef BOOST_GRAPH_DIJKSTRA_TESTING
williamr@2
    28
  static bool dijkstra_relaxed_heap = true;
williamr@2
    29
#endif
williamr@2
    30
williamr@2
    31
  template <class Visitor, class Graph>
williamr@2
    32
  struct DijkstraVisitorConcept {
williamr@2
    33
    void constraints() {
williamr@2
    34
      function_requires< CopyConstructibleConcept<Visitor> >();
williamr@2
    35
      vis.initialize_vertex(u, g);
williamr@2
    36
      vis.discover_vertex(u, g);
williamr@2
    37
      vis.examine_vertex(u, g);
williamr@2
    38
      vis.examine_edge(e, g);
williamr@2
    39
      vis.edge_relaxed(e, g);
williamr@2
    40
      vis.edge_not_relaxed(e, g);
williamr@2
    41
      vis.finish_vertex(u, g);
williamr@2
    42
    }
williamr@2
    43
    Visitor vis;
williamr@2
    44
    Graph g;
williamr@2
    45
    typename graph_traits<Graph>::vertex_descriptor u;
williamr@2
    46
    typename graph_traits<Graph>::edge_descriptor e;
williamr@2
    47
  };
williamr@2
    48
williamr@2
    49
  template <class Visitors = null_visitor>
williamr@2
    50
  class dijkstra_visitor : public bfs_visitor<Visitors> {
williamr@2
    51
  public:
williamr@2
    52
    dijkstra_visitor() { }
williamr@2
    53
    dijkstra_visitor(Visitors vis)
williamr@2
    54
      : bfs_visitor<Visitors>(vis) { }
williamr@2
    55
williamr@2
    56
    template <class Edge, class Graph>
williamr@2
    57
    void edge_relaxed(Edge e, Graph& g) {
williamr@2
    58
      invoke_visitors(this->m_vis, e, g, on_edge_relaxed());
williamr@2
    59
    }
williamr@2
    60
    template <class Edge, class Graph>
williamr@2
    61
    void edge_not_relaxed(Edge e, Graph& g) {
williamr@2
    62
      invoke_visitors(this->m_vis, e, g, on_edge_not_relaxed());
williamr@2
    63
    }
williamr@2
    64
  private:
williamr@2
    65
    template <class Edge, class Graph>
williamr@2
    66
    void tree_edge(Edge u, Graph& g) { }
williamr@2
    67
  };
williamr@2
    68
  template <class Visitors>
williamr@2
    69
  dijkstra_visitor<Visitors>
williamr@2
    70
  make_dijkstra_visitor(Visitors vis) {
williamr@2
    71
    return dijkstra_visitor<Visitors>(vis);
williamr@2
    72
  }
williamr@2
    73
  typedef dijkstra_visitor<> default_dijkstra_visitor;
williamr@2
    74
williamr@2
    75
  namespace detail {
williamr@2
    76
williamr@2
    77
    template <class UniformCostVisitor, class UpdatableQueue,
williamr@2
    78
      class WeightMap, class PredecessorMap, class DistanceMap,
williamr@2
    79
      class BinaryFunction, class BinaryPredicate>
williamr@2
    80
    struct dijkstra_bfs_visitor
williamr@2
    81
    {
williamr@2
    82
      typedef typename property_traits<DistanceMap>::value_type D;
williamr@2
    83
williamr@2
    84
      dijkstra_bfs_visitor(UniformCostVisitor vis, UpdatableQueue& Q,
williamr@2
    85
                           WeightMap w, PredecessorMap p, DistanceMap d,
williamr@2
    86
                           BinaryFunction combine, BinaryPredicate compare,
williamr@2
    87
                           D zero)
williamr@2
    88
        : m_vis(vis), m_Q(Q), m_weight(w), m_predecessor(p), m_distance(d),
williamr@2
    89
          m_combine(combine), m_compare(compare), m_zero(zero)  { }
williamr@2
    90
williamr@2
    91
      template <class Edge, class Graph>
williamr@2
    92
      void tree_edge(Edge e, Graph& g) {
williamr@2
    93
        m_decreased = relax(e, g, m_weight, m_predecessor, m_distance,
williamr@2
    94
                            m_combine, m_compare);
williamr@2
    95
        if (m_decreased)
williamr@2
    96
          m_vis.edge_relaxed(e, g);
williamr@2
    97
        else
williamr@2
    98
          m_vis.edge_not_relaxed(e, g);
williamr@2
    99
      }
williamr@2
   100
      template <class Edge, class Graph>
williamr@2
   101
      void gray_target(Edge e, Graph& g) {
williamr@2
   102
        m_decreased = relax(e, g, m_weight, m_predecessor, m_distance,
williamr@2
   103
                            m_combine, m_compare);
williamr@2
   104
        if (m_decreased) {
williamr@2
   105
          m_Q.update(target(e, g));
williamr@2
   106
          m_vis.edge_relaxed(e, g);
williamr@2
   107
        } else
williamr@2
   108
          m_vis.edge_not_relaxed(e, g);
williamr@2
   109
      }
williamr@2
   110
williamr@2
   111
      template <class Vertex, class Graph>
williamr@2
   112
      void initialize_vertex(Vertex u, Graph& g) { }
williamr@2
   113
      template <class Edge, class Graph>
williamr@2
   114
      void non_tree_edge(Edge, Graph&) { }
williamr@2
   115
      template <class Vertex, class Graph>
williamr@2
   116
      void discover_vertex(Vertex u, Graph& g) { m_vis.discover_vertex(u, g); }
williamr@2
   117
      template <class Vertex, class Graph>
williamr@2
   118
      void examine_vertex(Vertex u, Graph& g) { m_vis.examine_vertex(u, g); }
williamr@2
   119
      template <class Edge, class Graph>
williamr@2
   120
      void examine_edge(Edge e, Graph& g) {
williamr@2
   121
        if (m_compare(get(m_weight, e), m_zero))
williamr@2
   122
          throw negative_edge();
williamr@2
   123
        m_vis.examine_edge(e, g);
williamr@2
   124
      }
williamr@2
   125
      template <class Edge, class Graph>
williamr@2
   126
      void black_target(Edge, Graph&) { }
williamr@2
   127
      template <class Vertex, class Graph>
williamr@2
   128
      void finish_vertex(Vertex u, Graph& g) { m_vis.finish_vertex(u, g); }
williamr@2
   129
williamr@2
   130
      UniformCostVisitor m_vis;
williamr@2
   131
      UpdatableQueue& m_Q;
williamr@2
   132
      WeightMap m_weight;
williamr@2
   133
      PredecessorMap m_predecessor;
williamr@2
   134
      DistanceMap m_distance;
williamr@2
   135
      BinaryFunction m_combine;
williamr@2
   136
      BinaryPredicate m_compare;
williamr@2
   137
      bool m_decreased;
williamr@2
   138
      D m_zero;
williamr@2
   139
    };
williamr@2
   140
williamr@2
   141
  } // namespace detail
williamr@2
   142
williamr@2
   143
  // Call breadth first search with default color map.
williamr@2
   144
  template <class VertexListGraph, class DijkstraVisitor,
williamr@2
   145
            class PredecessorMap, class DistanceMap,
williamr@2
   146
            class WeightMap, class IndexMap, class Compare, class Combine,
williamr@2
   147
            class DistZero>
williamr@2
   148
  inline void
williamr@2
   149
  dijkstra_shortest_paths_no_init
williamr@2
   150
    (const VertexListGraph& g,
williamr@2
   151
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   152
     PredecessorMap predecessor, DistanceMap distance, WeightMap weight,
williamr@2
   153
     IndexMap index_map,
williamr@2
   154
     Compare compare, Combine combine, DistZero zero,
williamr@2
   155
     DijkstraVisitor vis)
williamr@2
   156
  {
williamr@2
   157
    std::vector<default_color_type> color(num_vertices(g));
williamr@2
   158
    default_color_type c = white_color;
williamr@2
   159
    dijkstra_shortest_paths_no_init( g, s, predecessor, distance, weight,
williamr@2
   160
      index_map, compare, combine, zero, vis,
williamr@2
   161
        make_iterator_property_map(&color[0], index_map, c));
williamr@2
   162
  }
williamr@2
   163
williamr@2
   164
  // Call breadth first search
williamr@2
   165
  template <class VertexListGraph, class DijkstraVisitor,
williamr@2
   166
            class PredecessorMap, class DistanceMap,
williamr@2
   167
            class WeightMap, class IndexMap, class Compare, class Combine,
williamr@2
   168
            class DistZero, class ColorMap>
williamr@2
   169
  inline void
williamr@2
   170
  dijkstra_shortest_paths_no_init
williamr@2
   171
    (const VertexListGraph& g,
williamr@2
   172
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   173
     PredecessorMap predecessor, DistanceMap distance, WeightMap weight,
williamr@2
   174
     IndexMap index_map,
williamr@2
   175
     Compare compare, Combine combine, DistZero zero,
williamr@2
   176
     DijkstraVisitor vis, ColorMap color)
williamr@2
   177
  {
williamr@2
   178
    typedef indirect_cmp<DistanceMap, Compare> IndirectCmp;
williamr@2
   179
    IndirectCmp icmp(distance, compare);
williamr@2
   180
williamr@2
   181
    typedef typename graph_traits<VertexListGraph>::vertex_descriptor Vertex;
williamr@2
   182
williamr@2
   183
#ifdef BOOST_GRAPH_DIJKSTRA_TESTING
williamr@2
   184
    if (!dijkstra_relaxed_heap) {
williamr@2
   185
      typedef mutable_queue<Vertex, std::vector<Vertex>, IndirectCmp, IndexMap>
williamr@2
   186
        MutableQueue;
williamr@2
   187
williamr@2
   188
      MutableQueue Q(num_vertices(g), icmp, index_map);
williamr@2
   189
williamr@2
   190
      detail::dijkstra_bfs_visitor<DijkstraVisitor, MutableQueue, WeightMap,
williamr@2
   191
        PredecessorMap, DistanceMap, Combine, Compare>
williamr@2
   192
      bfs_vis(vis, Q, weight, predecessor, distance, combine, compare, zero);
williamr@2
   193
williamr@2
   194
      breadth_first_visit(g, s, Q, bfs_vis, color);
williamr@2
   195
      return;
williamr@2
   196
    }
williamr@2
   197
#endif // BOOST_GRAPH_DIJKSTRA_TESTING
williamr@2
   198
williamr@2
   199
    typedef relaxed_heap<Vertex, IndirectCmp, IndexMap> MutableQueue;
williamr@2
   200
williamr@2
   201
    MutableQueue Q(num_vertices(g), icmp, index_map);
williamr@2
   202
williamr@2
   203
    detail::dijkstra_bfs_visitor<DijkstraVisitor, MutableQueue, WeightMap,
williamr@2
   204
      PredecessorMap, DistanceMap, Combine, Compare>
williamr@2
   205
        bfs_vis(vis, Q, weight, predecessor, distance, combine, compare, zero);
williamr@2
   206
williamr@2
   207
    breadth_first_visit(g, s, Q, bfs_vis, color);
williamr@2
   208
  }
williamr@2
   209
williamr@2
   210
  // Initialize distances and call breadth first search with default color map
williamr@2
   211
  template <class VertexListGraph, class DijkstraVisitor,
williamr@2
   212
            class PredecessorMap, class DistanceMap,
williamr@2
   213
            class WeightMap, class IndexMap, class Compare, class Combine,
williamr@2
   214
            class DistInf, class DistZero>
williamr@2
   215
  inline void
williamr@2
   216
  dijkstra_shortest_paths
williamr@2
   217
    (const VertexListGraph& g,
williamr@2
   218
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   219
     PredecessorMap predecessor, DistanceMap distance, WeightMap weight,
williamr@2
   220
     IndexMap index_map,
williamr@2
   221
     Compare compare, Combine combine, DistInf inf, DistZero zero,
williamr@2
   222
     DijkstraVisitor vis)
williamr@2
   223
  {
williamr@2
   224
    std::vector<default_color_type> color(num_vertices(g));
williamr@2
   225
    default_color_type c = white_color;
williamr@2
   226
    dijkstra_shortest_paths(g, s, predecessor, distance, weight, index_map,
williamr@2
   227
                            compare, combine, inf, zero, vis,
williamr@2
   228
                            make_iterator_property_map(&color[0], index_map,
williamr@2
   229
                                                       c));
williamr@2
   230
  }
williamr@2
   231
williamr@2
   232
  // Initialize distances and call breadth first search
williamr@2
   233
  template <class VertexListGraph, class DijkstraVisitor,
williamr@2
   234
            class PredecessorMap, class DistanceMap,
williamr@2
   235
            class WeightMap, class IndexMap, class Compare, class Combine,
williamr@2
   236
            class DistInf, class DistZero, class ColorMap>
williamr@2
   237
  inline void
williamr@2
   238
  dijkstra_shortest_paths
williamr@2
   239
    (const VertexListGraph& g,
williamr@2
   240
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   241
     PredecessorMap predecessor, DistanceMap distance, WeightMap weight,
williamr@2
   242
     IndexMap index_map,
williamr@2
   243
     Compare compare, Combine combine, DistInf inf, DistZero zero,
williamr@2
   244
     DijkstraVisitor vis, ColorMap color)
williamr@2
   245
  {
williamr@2
   246
    typedef typename property_traits<ColorMap>::value_type ColorValue;
williamr@2
   247
    typedef color_traits<ColorValue> Color;
williamr@2
   248
    typename graph_traits<VertexListGraph>::vertex_iterator ui, ui_end;
williamr@2
   249
    for (tie(ui, ui_end) = vertices(g); ui != ui_end; ++ui) {
williamr@2
   250
      vis.initialize_vertex(*ui, g);
williamr@2
   251
      put(distance, *ui, inf);
williamr@2
   252
      put(predecessor, *ui, *ui);
williamr@2
   253
      put(color, *ui, Color::white());
williamr@2
   254
    }
williamr@2
   255
    put(distance, s, zero);
williamr@2
   256
williamr@2
   257
    dijkstra_shortest_paths_no_init(g, s, predecessor, distance, weight,
williamr@2
   258
                            index_map, compare, combine, zero, vis, color);
williamr@2
   259
  }
williamr@2
   260
williamr@2
   261
  namespace detail {
williamr@2
   262
williamr@2
   263
    // Handle defaults for PredecessorMap and
williamr@2
   264
    // Distance Compare, Combine, Inf and Zero
williamr@2
   265
    template <class VertexListGraph, class DistanceMap, class WeightMap,
williamr@2
   266
              class IndexMap, class Params, class ColorMap>
williamr@2
   267
    inline void
williamr@2
   268
    dijkstra_dispatch2
williamr@2
   269
      (const VertexListGraph& g,
williamr@2
   270
       typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   271
       DistanceMap distance, WeightMap weight, IndexMap index_map,
williamr@2
   272
       const Params& params, ColorMap color)
williamr@2
   273
    {
williamr@2
   274
      // Default for predecessor map
williamr@2
   275
      dummy_property_map p_map;
williamr@2
   276
williamr@2
   277
      typedef typename property_traits<DistanceMap>::value_type D;
williamr@2
   278
      dijkstra_shortest_paths
williamr@2
   279
        (g, s,
williamr@2
   280
         choose_param(get_param(params, vertex_predecessor), p_map),
williamr@2
   281
         distance, weight, index_map,
williamr@2
   282
         choose_param(get_param(params, distance_compare_t()),
williamr@2
   283
                      std::less<D>()),
williamr@2
   284
         choose_param(get_param(params, distance_combine_t()),
williamr@2
   285
                      closed_plus<D>()),
williamr@2
   286
         choose_param(get_param(params, distance_inf_t()),
williamr@2
   287
                      (std::numeric_limits<D>::max)()),
williamr@2
   288
         choose_param(get_param(params, distance_zero_t()),
williamr@2
   289
                      D()),
williamr@2
   290
         choose_param(get_param(params, graph_visitor),
williamr@2
   291
                      make_dijkstra_visitor(null_visitor())),
williamr@2
   292
         color);
williamr@2
   293
    }
williamr@2
   294
williamr@2
   295
    template <class VertexListGraph, class DistanceMap, class WeightMap,
williamr@2
   296
              class IndexMap, class Params, class ColorMap>
williamr@2
   297
    inline void
williamr@2
   298
    dijkstra_dispatch1
williamr@2
   299
      (const VertexListGraph& g,
williamr@2
   300
       typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   301
       DistanceMap distance, WeightMap weight, IndexMap index_map,
williamr@2
   302
       const Params& params, ColorMap color)
williamr@2
   303
    {
williamr@2
   304
      // Default for distance map
williamr@2
   305
      typedef typename property_traits<WeightMap>::value_type D;
williamr@2
   306
      typename std::vector<D>::size_type
williamr@2
   307
        n = is_default_param(distance) ? num_vertices(g) : 1;
williamr@2
   308
      std::vector<D> distance_map(n);
williamr@2
   309
williamr@2
   310
      // Default for color map
williamr@2
   311
      typename std::vector<default_color_type>::size_type
williamr@2
   312
        m = is_default_param(color) ? num_vertices(g) : 1;
williamr@2
   313
      std::vector<default_color_type> color_map(m);
williamr@2
   314
williamr@2
   315
      detail::dijkstra_dispatch2
williamr@2
   316
        (g, s, choose_param(distance, make_iterator_property_map
williamr@2
   317
                            (distance_map.begin(), index_map,
williamr@2
   318
                             distance_map[0])),
williamr@2
   319
         weight, index_map, params,
williamr@2
   320
         choose_param(color, make_iterator_property_map
williamr@2
   321
                      (color_map.begin(), index_map,
williamr@2
   322
                       color_map[0])));
williamr@2
   323
    }
williamr@2
   324
  } // namespace detail
williamr@2
   325
williamr@2
   326
  // Named Parameter Variant
williamr@2
   327
  template <class VertexListGraph, class Param, class Tag, class Rest>
williamr@2
   328
  inline void
williamr@2
   329
  dijkstra_shortest_paths
williamr@2
   330
    (const VertexListGraph& g,
williamr@2
   331
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   332
     const bgl_named_params<Param,Tag,Rest>& params)
williamr@2
   333
  {
williamr@2
   334
    // Default for edge weight and vertex index map is to ask for them
williamr@2
   335
    // from the graph.  Default for the visitor is null_visitor.
williamr@2
   336
    detail::dijkstra_dispatch1
williamr@2
   337
      (g, s,
williamr@2
   338
       get_param(params, vertex_distance),
williamr@2
   339
       choose_const_pmap(get_param(params, edge_weight), g, edge_weight),
williamr@2
   340
       choose_const_pmap(get_param(params, vertex_index), g, vertex_index),
williamr@2
   341
       params,
williamr@2
   342
       get_param(params, vertex_color));
williamr@2
   343
  }
williamr@2
   344
williamr@2
   345
} // namespace boost
williamr@2
   346
williamr@2
   347
#endif // BOOST_GRAPH_DIJKSTRA_HPP