DistributedVertexListGraph.rst 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. .. Copyright (C) 2004-2008 The Trustees of Indiana University.
  2. Use, modification and distribution is subject to the Boost Software
  3. License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  4. http://www.boost.org/LICENSE_1_0.txt)
  5. ============================================
  6. |Logo| Concept Distributed Vertex List Graph
  7. ============================================
  8. .. contents::
  9. Description
  10. -----------
  11. A Distributed Vertex List Graph is a graph whose vertices are
  12. distributed across multiple processes or address spaces. The
  13. ``vertices`` and ``num_vertices`` functions retain the same
  14. signatures as in the `Vertex List Graph`_ concept, but return only
  15. the local set (and size of the local set) of vertices.
  16. Notation
  17. --------
  18. G
  19. A type that models the Distributed Vertex List Graph concept.
  20. g
  21. An object of type ``G``.
  22. Refinement of
  23. -------------
  24. - `Graph`_
  25. Associated types
  26. ----------------
  27. +----------------+---------------------------------------+---------------------------------+
  28. |Vertex |``graph_traits<G>::vertex_descriptor`` |Must model the |
  29. |descriptor type | |`Global Descriptor`_ concept. |
  30. +----------------+---------------------------------------+---------------------------------+
  31. |Vertex iterator |``graph_traits<G>::vertex_iterator`` |Iterates over vertices stored |
  32. |type | |locally. The value type must be |
  33. | | |``vertex_descriptor``. |
  34. +----------------+---------------------------------------+---------------------------------+
  35. |Vertices size |``graph_traits<G>::vertices_size_type``|The unsigned integral type used |
  36. |type | |to store the number of vertices |
  37. | | |in the local subgraph. |
  38. +----------------+---------------------------------------+---------------------------------+
  39. Valid Expressions
  40. -----------------
  41. +----------------+---------------------+----------------------+-------------------------------------+
  42. |Name |Expression |Type |Semantics |
  43. +================+=====================+======================+=====================================+
  44. |Local vertex set|``vertices(g)`` |``std::pair<`` |Returns an iterator range |
  45. | | |``vertex_iterator,`` |providing access to the local |
  46. | | |``vertex_iterator>`` |vertices in the graph. |
  47. +----------------+---------------------+----------------------+-------------------------------------+
  48. |Number of local |``num_vertices(g)`` |``vertices_size_type``|Returns the number of vertices |
  49. |vertices. | | |stored locally in the graph. |
  50. +----------------+---------------------+----------------------+-------------------------------------+
  51. Models
  52. ------
  53. - `Distributed adjacency list`_
  54. -----------------------------------------------------------------------------
  55. Copyright (C) 2005 The Trustees of Indiana University.
  56. Authors: Douglas Gregor and Andrew Lumsdaine
  57. .. |Logo| image:: pbgl-logo.png
  58. :align: middle
  59. :alt: Parallel BGL
  60. :target: http://www.osl.iu.edu/research/pbgl
  61. .. _Graph: http://www.boost.org/libs/graph/doc/Graph.html
  62. .. _Vertex List Graph: http://www.boost.org/libs/graph/doc/VertexListGraph.html
  63. .. _Distributed Graph: DistributedGraph.html
  64. .. _Global descriptor: GlobalDescriptor.html
  65. .. _Distributed adjacency list: distributed_adjacency_list.html