COIN-OR::LEMON - Graph Library

Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • lemon/grid_graph.h

    r834 r664  
    471471  /// \brief Grid graph class
    472472  ///
    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
     473  /// This class implements a special graph type. The nodes of the
     474  /// graph can be indexed by two integer \c (i,j) value where \c i is
     475  /// in the \c [0..width()-1] range and j is in the \c
     476  /// [0..height()-1] range. Two nodes are connected in the graph if
     477  /// the indexes differ exactly on one position and exactly one is
     478  /// the difference. The nodes of the graph can be indexed by position
     479  /// with the \c operator()() function. The positions of the nodes can be
     480  /// get with \c pos(), \c col() and \c row() members. The outgoing
    481481  /// arcs can be retrieved with the \c right(), \c up(), \c left()
    482482  /// and \c down() functions, where the bottom-left corner is the
    483483  /// origin.
    484   ///
    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().
    488484  ///
    489485  /// \image html grid_graph.png
     
    501497  ///\endcode
    502498  ///
    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.
    506   ///
    507   /// This class provides constant time counting for nodes, edges and arcs.
     499  /// This graph type fully conforms to the \ref concepts::Graph
     500  /// "Graph concept".
    508501  class GridGraph : public ExtendedGridGraphBase {
    509502    typedef ExtendedGridGraphBase Parent;
     
    511504  public:
    512505
    513     /// \brief Map to get the indices of the nodes as \ref dim2::Point
    514     /// "dim2::Point<int>".
    515     ///
    516     /// Map to get the indices of the nodes as \ref dim2::Point
    517     /// "dim2::Point<int>".
     506    /// \brief Map to get the indices of the nodes as dim2::Point<int>.
     507    ///
     508    /// Map to get the indices of the nodes as dim2::Point<int>.
    518509    class IndexMap {
    519510    public:
     
    524515
    525516      /// \brief Constructor
     517      ///
     518      /// Constructor
    526519      IndexMap(const GridGraph& graph) : _graph(graph) {}
    527520
    528521      /// \brief The subscript operator
     522      ///
     523      /// The subscript operator.
    529524      Value operator[](Key key) const {
    530525        return _graph.pos(key);
     
    546541
    547542      /// \brief Constructor
     543      ///
     544      /// Constructor
    548545      ColMap(const GridGraph& graph) : _graph(graph) {}
    549546
    550547      /// \brief The subscript operator
     548      ///
     549      /// The subscript operator.
    551550      Value operator[](Key key) const {
    552551        return _graph.col(key);
     
    568567
    569568      /// \brief Constructor
     569      ///
     570      /// Constructor
    570571      RowMap(const GridGraph& graph) : _graph(graph) {}
    571572
    572573      /// \brief The subscript operator
     574      ///
     575      /// The subscript operator.
    573576      Value operator[](Key key) const {
    574577        return _graph.row(key);
     
    581584    /// \brief Constructor
    582585    ///
    583     /// Construct a grid graph with the given size.
     586    /// Construct a grid graph with given size.
    584587    GridGraph(int width, int height) { construct(width, height); }
    585588
    586     /// \brief Resizes the graph
    587     ///
    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.
     589    /// \brief Resize the graph
     590    ///
     591    /// Resize the graph. The function will fully destroy and rebuild
     592    /// the graph.  This cause that the maps of the graph will
     593    /// reallocated automatically and the previous values will be
     594    /// lost.
    591595    void resize(int width, int height) {
    592596      Parent::notifier(Arc()).clear();
     
    606610    }
    607611
    608     /// \brief The column index of the node.
     612    /// \brief Gives back the column index of the node.
    609613    ///
    610614    /// Gives back the column index of the node.
     
    613617    }
    614618
    615     /// \brief The row index of the node.
     619    /// \brief Gives back the row index of the node.
    616620    ///
    617621    /// Gives back the row index of the node.
     
    620624    }
    621625
    622     /// \brief The position of the node.
     626    /// \brief Gives back the position of the node.
    623627    ///
    624628    /// Gives back the position of the node, ie. the <tt>(col,row)</tt> pair.
     
    627631    }
    628632
    629     /// \brief The number of the columns.
     633    /// \brief Gives back the number of the columns.
    630634    ///
    631635    /// Gives back the number of the columns.
     
    634638    }
    635639
    636     /// \brief The number of the rows.
     640    /// \brief Gives back the number of the rows.
    637641    ///
    638642    /// Gives back the number of the rows.
     
    641645    }
    642646
    643     /// \brief The arc goes right from the node.
     647    /// \brief Gives back the arc goes right from the node.
    644648    ///
    645649    /// Gives back the arc goes right from the node. If there is not
     
    649653    }
    650654
    651     /// \brief The arc goes left from the node.
     655    /// \brief Gives back the arc goes left from the node.
    652656    ///
    653657    /// Gives back the arc goes left from the node. If there is not
     
    657661    }
    658662
    659     /// \brief The arc goes up from the node.
     663    /// \brief Gives back the arc goes up from the node.
    660664    ///
    661665    /// Gives back the arc goes up from the node. If there is not
     
    665669    }
    666670
    667     /// \brief The arc goes down from the node.
     671    /// \brief Gives back the arc goes down from the node.
    668672    ///
    669673    /// Gives back the arc goes down from the node. If there is not
Note: See TracChangeset for help on using the changeset viewer.