epoc32/include/stdapis/boost/graph/astar_search.hpp
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
permissions -rw-r--r--
Final list of Symbian^2 public API header files
williamr@2
     1
williamr@2
     2
williamr@2
     3
//
williamr@2
     4
//=======================================================================
williamr@2
     5
// Copyright (c) 2004 Kristopher Beevers
williamr@2
     6
//
williamr@2
     7
// Distributed under the Boost Software License, Version 1.0. (See
williamr@2
     8
// accompanying file LICENSE_1_0.txt or copy at
williamr@2
     9
// http://www.boost.org/LICENSE_1_0.txt)
williamr@2
    10
//=======================================================================
williamr@2
    11
//
williamr@2
    12
williamr@2
    13
#ifndef BOOST_GRAPH_ASTAR_SEARCH_HPP
williamr@2
    14
#define BOOST_GRAPH_ASTAR_SEARCH_HPP
williamr@2
    15
williamr@2
    16
williamr@2
    17
#include <functional>
williamr@2
    18
#include <boost/limits.hpp>
williamr@2
    19
#include <boost/graph/named_function_params.hpp>
williamr@2
    20
#include <boost/pending/mutable_queue.hpp>
williamr@2
    21
#include <boost/graph/relax.hpp>
williamr@2
    22
#include <boost/pending/indirect_cmp.hpp>
williamr@2
    23
#include <boost/graph/exception.hpp>
williamr@2
    24
#include <boost/graph/breadth_first_search.hpp>
williamr@2
    25
williamr@2
    26
williamr@2
    27
namespace boost {
williamr@2
    28
williamr@2
    29
  
williamr@2
    30
  template <class Heuristic, class Graph>
williamr@2
    31
  struct AStarHeuristicConcept {
williamr@2
    32
    void constraints()
williamr@2
    33
    {
williamr@2
    34
      function_requires< CopyConstructibleConcept<Heuristic> >();
williamr@2
    35
      h(u);
williamr@2
    36
    }
williamr@2
    37
    Heuristic h;
williamr@2
    38
    typename graph_traits<Graph>::vertex_descriptor u;
williamr@2
    39
  };
williamr@2
    40
  
williamr@2
    41
  
williamr@2
    42
  template <class Graph, class CostType>
williamr@2
    43
  class astar_heuristic : public std::unary_function<
williamr@2
    44
    typename graph_traits<Graph>::vertex_descriptor, CostType>
williamr@2
    45
  {
williamr@2
    46
  public:
williamr@2
    47
    typedef typename graph_traits<Graph>::vertex_descriptor Vertex;
williamr@2
    48
    astar_heuristic() {}
williamr@2
    49
    CostType operator()(Vertex u) { return static_cast<CostType>(0); }
williamr@2
    50
  };
williamr@2
    51
  
williamr@2
    52
williamr@2
    53
  
williamr@2
    54
  template <class Visitor, class Graph>
williamr@2
    55
  struct AStarVisitorConcept {
williamr@2
    56
    void constraints()
williamr@2
    57
    {
williamr@2
    58
      function_requires< CopyConstructibleConcept<Visitor> >();
williamr@2
    59
      vis.initialize_vertex(u, g);
williamr@2
    60
      vis.discover_vertex(u, g);
williamr@2
    61
      vis.examine_vertex(u, g);
williamr@2
    62
      vis.examine_edge(e, g);
williamr@2
    63
      vis.edge_relaxed(e, g);
williamr@2
    64
      vis.edge_not_relaxed(e, g);
williamr@2
    65
      vis.black_target(e, g);
williamr@2
    66
      vis.finish_vertex(u, g);
williamr@2
    67
    }
williamr@2
    68
    Visitor vis;
williamr@2
    69
    Graph g;
williamr@2
    70
    typename graph_traits<Graph>::vertex_descriptor u;
williamr@2
    71
    typename graph_traits<Graph>::edge_descriptor e;
williamr@2
    72
  };
williamr@2
    73
  
williamr@2
    74
  
williamr@2
    75
  template <class Visitors = null_visitor>
williamr@2
    76
  class astar_visitor : public bfs_visitor<Visitors> {
williamr@2
    77
  public:
williamr@2
    78
    astar_visitor() {}
williamr@2
    79
    astar_visitor(Visitors vis)
williamr@2
    80
      : bfs_visitor<Visitors>(vis) {}
williamr@2
    81
  
williamr@2
    82
    template <class Edge, class Graph>
williamr@2
    83
    void edge_relaxed(Edge e, Graph& g) {
williamr@2
    84
      invoke_visitors(this->m_vis, e, g, on_edge_relaxed());
williamr@2
    85
    }
williamr@2
    86
    template <class Edge, class Graph>
williamr@2
    87
    void edge_not_relaxed(Edge e, Graph& g) {
williamr@2
    88
      invoke_visitors(this->m_vis, e, g, on_edge_not_relaxed());      
williamr@2
    89
    }
williamr@2
    90
  private:
williamr@2
    91
    template <class Edge, class Graph>
williamr@2
    92
    void tree_edge(Edge e, Graph& g) {}
williamr@2
    93
    template <class Edge, class Graph>
williamr@2
    94
    void non_tree_edge(Edge e, Graph& g) {}
williamr@2
    95
  };
williamr@2
    96
  template <class Visitors>
williamr@2
    97
  astar_visitor<Visitors>
williamr@2
    98
  make_astar_visitor(Visitors vis) {
williamr@2
    99
    return astar_visitor<Visitors>(vis);
williamr@2
   100
  }
williamr@2
   101
  typedef astar_visitor<> default_astar_visitor;
williamr@2
   102
  
williamr@2
   103
williamr@2
   104
  namespace detail {
williamr@2
   105
    
williamr@2
   106
    template <class AStarHeuristic, class UniformCostVisitor,
williamr@2
   107
              class UpdatableQueue, class PredecessorMap,
williamr@2
   108
              class CostMap, class DistanceMap, class WeightMap,
williamr@2
   109
              class ColorMap, class BinaryFunction,
williamr@2
   110
              class BinaryPredicate>
williamr@2
   111
    struct astar_bfs_visitor
williamr@2
   112
    {
williamr@2
   113
      
williamr@2
   114
      typedef typename property_traits<CostMap>::value_type C;
williamr@2
   115
      typedef typename property_traits<ColorMap>::value_type ColorValue;
williamr@2
   116
      typedef color_traits<ColorValue> Color;
williamr@2
   117
      typedef typename property_traits<DistanceMap>::value_type distance_type;
williamr@2
   118
      
williamr@2
   119
      astar_bfs_visitor(AStarHeuristic h, UniformCostVisitor vis,
williamr@2
   120
                        UpdatableQueue& Q, PredecessorMap p,
williamr@2
   121
                        CostMap c, DistanceMap d, WeightMap w,
williamr@2
   122
                        ColorMap col, BinaryFunction combine,
williamr@2
   123
                        BinaryPredicate compare, C zero)
williamr@2
   124
        : m_h(h), m_vis(vis), m_Q(Q), m_predecessor(p), m_cost(c),
williamr@2
   125
          m_distance(d), m_weight(w), m_color(col),
williamr@2
   126
          m_combine(combine), m_compare(compare), m_zero(zero) {}
williamr@2
   127
      
williamr@2
   128
      
williamr@2
   129
      template <class Vertex, class Graph>
williamr@2
   130
      void initialize_vertex(Vertex u, Graph& g) {
williamr@2
   131
        m_vis.initialize_vertex(u, g);
williamr@2
   132
      }
williamr@2
   133
      template <class Vertex, class Graph>
williamr@2
   134
      void discover_vertex(Vertex u, Graph& g) {
williamr@2
   135
        m_vis.discover_vertex(u, g);
williamr@2
   136
      }
williamr@2
   137
      template <class Vertex, class Graph>
williamr@2
   138
      void examine_vertex(Vertex u, Graph& g) {
williamr@2
   139
        m_vis.examine_vertex(u, g);
williamr@2
   140
      }
williamr@2
   141
      template <class Vertex, class Graph>
williamr@2
   142
      void finish_vertex(Vertex u, Graph& g) {
williamr@2
   143
        m_vis.finish_vertex(u, g);
williamr@2
   144
      }
williamr@2
   145
      template <class Edge, class Graph>
williamr@2
   146
      void examine_edge(Edge e, Graph& g) { 
williamr@2
   147
        if (m_compare(get(m_weight, e), m_zero))
williamr@2
   148
          throw negative_edge();
williamr@2
   149
        m_vis.examine_edge(e, g);
williamr@2
   150
      }
williamr@2
   151
      template <class Edge, class Graph>
williamr@2
   152
      void non_tree_edge(Edge, Graph&) {}
williamr@2
   153
      
williamr@2
   154
      
williamr@2
   155
      
williamr@2
   156
      template <class Edge, class Graph>
williamr@2
   157
      void tree_edge(Edge e, Graph& g) {
williamr@2
   158
        m_decreased = relax(e, g, m_weight, m_predecessor, m_distance,
williamr@2
   159
                            m_combine, m_compare);
williamr@2
   160
williamr@2
   161
        if(m_decreased) {
williamr@2
   162
          m_vis.edge_relaxed(e, g);
williamr@2
   163
          put(m_cost, target(e, g),
williamr@2
   164
              m_combine(get(m_distance, target(e, g)),
williamr@2
   165
                        m_h(target(e, g))));
williamr@2
   166
        } else
williamr@2
   167
          m_vis.edge_not_relaxed(e, g);
williamr@2
   168
      }
williamr@2
   169
      
williamr@2
   170
      
williamr@2
   171
      template <class Edge, class Graph>
williamr@2
   172
      void gray_target(Edge e, Graph& g) {
williamr@2
   173
        distance_type old_distance = get(m_distance, target(e, g));
williamr@2
   174
williamr@2
   175
        m_decreased = relax(e, g, m_weight, m_predecessor, m_distance,
williamr@2
   176
                            m_combine, m_compare);
williamr@2
   177
williamr@2
   178
        /* On x86 Linux with optimization, we sometimes get into a
williamr@2
   179
           horrible case where m_decreased is true but the distance hasn't
williamr@2
   180
           actually changed. This occurs when the comparison inside
williamr@2
   181
           relax() occurs with the 80-bit precision of the x87 floating
williamr@2
   182
           point unit, but the difference is lost when the resulting
williamr@2
   183
           values are written back to lower-precision memory (e.g., a
williamr@2
   184
           double). With the eager Dijkstra's implementation, this results
williamr@2
   185
           in looping. */
williamr@2
   186
        if(m_decreased && old_distance != get(m_distance, target(e, g))) {
williamr@2
   187
          put(m_cost, target(e, g),
williamr@2
   188
              m_combine(get(m_distance, target(e, g)),
williamr@2
   189
                        m_h(target(e, g))));
williamr@2
   190
          m_Q.update(target(e, g));
williamr@2
   191
          m_vis.edge_relaxed(e, g);
williamr@2
   192
        } else
williamr@2
   193
          m_vis.edge_not_relaxed(e, g);
williamr@2
   194
      }
williamr@2
   195
      
williamr@2
   196
      
williamr@2
   197
      template <class Edge, class Graph>
williamr@2
   198
      void black_target(Edge e, Graph& g) {
williamr@2
   199
        distance_type old_distance = get(m_distance, target(e, g));
williamr@2
   200
williamr@2
   201
        m_decreased = relax(e, g, m_weight, m_predecessor, m_distance,
williamr@2
   202
                            m_combine, m_compare);
williamr@2
   203
williamr@2
   204
        /* See comment in gray_target */
williamr@2
   205
        if(m_decreased && old_distance != get(m_distance, target(e, g))) {
williamr@2
   206
          m_vis.edge_relaxed(e, g);
williamr@2
   207
          put(m_cost, target(e, g),
williamr@2
   208
              m_combine(get(m_distance, target(e, g)),
williamr@2
   209
                        m_h(target(e, g))));
williamr@2
   210
          m_Q.push(target(e, g));
williamr@2
   211
          put(m_color, target(e, g), Color::gray());
williamr@2
   212
          m_vis.black_target(e, g);
williamr@2
   213
        } else
williamr@2
   214
          m_vis.edge_not_relaxed(e, g);
williamr@2
   215
      }
williamr@2
   216
      
williamr@2
   217
      
williamr@2
   218
      
williamr@2
   219
      AStarHeuristic m_h;
williamr@2
   220
      UniformCostVisitor m_vis;
williamr@2
   221
      UpdatableQueue& m_Q;
williamr@2
   222
      PredecessorMap m_predecessor;
williamr@2
   223
      CostMap m_cost;
williamr@2
   224
      DistanceMap m_distance;
williamr@2
   225
      WeightMap m_weight;
williamr@2
   226
      ColorMap m_color;
williamr@2
   227
      BinaryFunction m_combine;
williamr@2
   228
      BinaryPredicate m_compare;
williamr@2
   229
      bool m_decreased;
williamr@2
   230
      C m_zero;
williamr@2
   231
      
williamr@2
   232
    };
williamr@2
   233
    
williamr@2
   234
  } // namespace detail
williamr@2
   235
williamr@2
   236
  
williamr@2
   237
  
williamr@2
   238
  template <typename VertexListGraph, typename AStarHeuristic,
williamr@2
   239
            typename AStarVisitor, typename PredecessorMap,
williamr@2
   240
            typename CostMap, typename DistanceMap,
williamr@2
   241
            typename WeightMap, typename ColorMap,
williamr@2
   242
            typename VertexIndexMap,
williamr@2
   243
            typename CompareFunction, typename CombineFunction,
williamr@2
   244
            typename CostInf, typename CostZero>
williamr@2
   245
  inline void
williamr@2
   246
  astar_search_no_init
williamr@2
   247
    (VertexListGraph &g,
williamr@2
   248
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   249
     AStarHeuristic h, AStarVisitor vis,
williamr@2
   250
     PredecessorMap predecessor, CostMap cost,
williamr@2
   251
     DistanceMap distance, WeightMap weight,
williamr@2
   252
     ColorMap color, VertexIndexMap index_map,
williamr@2
   253
     CompareFunction compare, CombineFunction combine,
williamr@2
   254
     CostInf inf, CostZero zero)
williamr@2
   255
  {
williamr@2
   256
    typedef indirect_cmp<CostMap, CompareFunction> IndirectCmp;
williamr@2
   257
    IndirectCmp icmp(cost, compare);
williamr@2
   258
  
williamr@2
   259
    typedef typename graph_traits<VertexListGraph>::vertex_descriptor
williamr@2
   260
      Vertex;
williamr@2
   261
    typedef mutable_queue<Vertex, std::vector<Vertex>,
williamr@2
   262
        IndirectCmp, VertexIndexMap>
williamr@2
   263
      MutableQueue;
williamr@2
   264
    MutableQueue Q(num_vertices(g), icmp, index_map);
williamr@2
   265
  
williamr@2
   266
    detail::astar_bfs_visitor<AStarHeuristic, AStarVisitor,
williamr@2
   267
        MutableQueue, PredecessorMap, CostMap, DistanceMap,
williamr@2
   268
        WeightMap, ColorMap, CombineFunction, CompareFunction>
williamr@2
   269
      bfs_vis(h, vis, Q, predecessor, cost, distance, weight,
williamr@2
   270
              color, combine, compare, zero);
williamr@2
   271
  
williamr@2
   272
    breadth_first_visit(g, s, Q, bfs_vis, color);
williamr@2
   273
  }
williamr@2
   274
  
williamr@2
   275
  
williamr@2
   276
  // Non-named parameter interface
williamr@2
   277
  template <typename VertexListGraph, typename AStarHeuristic,
williamr@2
   278
            typename AStarVisitor, typename PredecessorMap,
williamr@2
   279
            typename CostMap, typename DistanceMap,
williamr@2
   280
            typename WeightMap, typename VertexIndexMap,
williamr@2
   281
            typename ColorMap,
williamr@2
   282
            typename CompareFunction, typename CombineFunction,
williamr@2
   283
            typename CostInf, typename CostZero>
williamr@2
   284
  inline void
williamr@2
   285
  astar_search
williamr@2
   286
    (VertexListGraph &g,
williamr@2
   287
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   288
     AStarHeuristic h, AStarVisitor vis,
williamr@2
   289
     PredecessorMap predecessor, CostMap cost,
williamr@2
   290
     DistanceMap distance, WeightMap weight,
williamr@2
   291
     VertexIndexMap index_map, ColorMap color,
williamr@2
   292
     CompareFunction compare, CombineFunction combine,
williamr@2
   293
     CostInf inf, CostZero zero)
williamr@2
   294
  {
williamr@2
   295
    
williamr@2
   296
    typedef typename property_traits<ColorMap>::value_type ColorValue;
williamr@2
   297
    typedef color_traits<ColorValue> Color;
williamr@2
   298
    typename graph_traits<VertexListGraph>::vertex_iterator ui, ui_end;
williamr@2
   299
    for (tie(ui, ui_end) = vertices(g); ui != ui_end; ++ui) {
williamr@2
   300
      put(color, *ui, Color::white());
williamr@2
   301
      put(distance, *ui, inf);
williamr@2
   302
      put(cost, *ui, inf);
williamr@2
   303
      put(predecessor, *ui, *ui);
williamr@2
   304
      vis.initialize_vertex(*ui, g);
williamr@2
   305
    }
williamr@2
   306
    put(distance, s, zero);
williamr@2
   307
    put(cost, s, h(s));
williamr@2
   308
    
williamr@2
   309
    astar_search_no_init
williamr@2
   310
      (g, s, h, vis, predecessor, cost, distance, weight,
williamr@2
   311
       color, index_map, compare, combine, inf, zero);
williamr@2
   312
    
williamr@2
   313
  }
williamr@2
   314
  
williamr@2
   315
  
williamr@2
   316
  
williamr@2
   317
  namespace detail {
williamr@2
   318
    template <class VertexListGraph, class AStarHeuristic,
williamr@2
   319
              class CostMap, class DistanceMap, class WeightMap,
williamr@2
   320
              class IndexMap, class ColorMap, class Params>
williamr@2
   321
    inline void
williamr@2
   322
    astar_dispatch2
williamr@2
   323
      (VertexListGraph& g,
williamr@2
   324
       typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   325
       AStarHeuristic h, CostMap cost, DistanceMap distance,
williamr@2
   326
       WeightMap weight, IndexMap index_map, ColorMap color,
williamr@2
   327
       const Params& params)
williamr@2
   328
    {
williamr@2
   329
      dummy_property_map p_map;
williamr@2
   330
      typedef typename property_traits<CostMap>::value_type C;
williamr@2
   331
      astar_search
williamr@2
   332
        (g, s, h,
williamr@2
   333
         choose_param(get_param(params, graph_visitor),
williamr@2
   334
                      make_astar_visitor(null_visitor())),
williamr@2
   335
         choose_param(get_param(params, vertex_predecessor), p_map),
williamr@2
   336
         cost, distance, weight, index_map, color,
williamr@2
   337
         choose_param(get_param(params, distance_compare_t()),
williamr@2
   338
                      std::less<C>()),
williamr@2
   339
         choose_param(get_param(params, distance_combine_t()),
williamr@2
   340
                      closed_plus<C>()),
williamr@2
   341
         choose_param(get_param(params, distance_inf_t()),
williamr@2
   342
                      std::numeric_limits<C>::max BOOST_PREVENT_MACRO_SUBSTITUTION ()),
williamr@2
   343
         choose_param(get_param(params, distance_zero_t()),
williamr@2
   344
                      C()));
williamr@2
   345
    }
williamr@2
   346
  
williamr@2
   347
    template <class VertexListGraph, class AStarHeuristic,
williamr@2
   348
              class CostMap, class DistanceMap, class WeightMap,
williamr@2
   349
              class IndexMap, class ColorMap, class Params>
williamr@2
   350
    inline void
williamr@2
   351
    astar_dispatch1
williamr@2
   352
      (VertexListGraph& g,
williamr@2
   353
       typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   354
       AStarHeuristic h, CostMap cost, DistanceMap distance,
williamr@2
   355
       WeightMap weight, IndexMap index_map, ColorMap color,
williamr@2
   356
       const Params& params)
williamr@2
   357
    {
williamr@2
   358
      typedef typename property_traits<WeightMap>::value_type D;
williamr@2
   359
      typename std::vector<D>::size_type
williamr@2
   360
        n = is_default_param(distance) ? num_vertices(g) : 1;
williamr@2
   361
      std::vector<D> distance_map(n);
williamr@2
   362
      n = is_default_param(cost) ? num_vertices(g) : 1;
williamr@2
   363
      std::vector<D> cost_map(n);
williamr@2
   364
      std::vector<default_color_type> color_map(num_vertices(g));
williamr@2
   365
      default_color_type c = white_color;
williamr@2
   366
  
williamr@2
   367
      detail::astar_dispatch2
williamr@2
   368
        (g, s, h,
williamr@2
   369
         choose_param(cost, make_iterator_property_map
williamr@2
   370
                      (cost_map.begin(), index_map,
williamr@2
   371
                       cost_map[0])),
williamr@2
   372
         choose_param(distance, make_iterator_property_map
williamr@2
   373
                      (distance_map.begin(), index_map, 
williamr@2
   374
                       distance_map[0])),
williamr@2
   375
         weight, index_map,
williamr@2
   376
         choose_param(color, make_iterator_property_map
williamr@2
   377
                      (color_map.begin(), index_map, c)),
williamr@2
   378
         params);
williamr@2
   379
    }
williamr@2
   380
  } // namespace detail
williamr@2
   381
  
williamr@2
   382
  
williamr@2
   383
  // Named parameter interface
williamr@2
   384
  template <typename VertexListGraph,
williamr@2
   385
            typename AStarHeuristic,
williamr@2
   386
            typename P, typename T, typename R>
williamr@2
   387
  void
williamr@2
   388
  astar_search
williamr@2
   389
    (VertexListGraph &g,
williamr@2
   390
     typename graph_traits<VertexListGraph>::vertex_descriptor s,
williamr@2
   391
     AStarHeuristic h, const bgl_named_params<P, T, R>& params)
williamr@2
   392
  {
williamr@2
   393
    
williamr@2
   394
    detail::astar_dispatch1
williamr@2
   395
      (g, s, h,
williamr@2
   396
       get_param(params, vertex_rank),
williamr@2
   397
       get_param(params, vertex_distance),
williamr@2
   398
       choose_const_pmap(get_param(params, edge_weight), g, edge_weight),
williamr@2
   399
       choose_const_pmap(get_param(params, vertex_index), g, vertex_index),
williamr@2
   400
       get_param(params, vertex_color),
williamr@2
   401
       params);
williamr@2
   402
    
williamr@2
   403
  }
williamr@2
   404
  
williamr@2
   405
} // namespace boost
williamr@2
   406
williamr@2
   407
#endif // BOOST_GRAPH_ASTAR_SEARCH_HPP