• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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==========================================
7|Logo| Concept Distributed Edge List Graph
8==========================================
9
10.. contents::
11
12Description
13-----------
14
15A Distributed Edge List Graph is a graph whose vertices are
16distributed across multiple processes or address spaces. The
17``vertices`` and ``num_vertices`` functions retain the same
18signatures as in the `Edge List Graph`_ concept, but return only
19the local set (and size of the local set) of vertices.
20
21Notation
22--------
23
24G
25  A type that models the Distributed Edge List Graph concept.
26
27g
28  An object of type ``G``.
29
30Refinement of
31-------------
32
33  - `Graph`_
34
35Associated types
36----------------
37
38+----------------+---------------------------------------+---------------------------------+
39|Edge            |``graph_traits<G>::edge_descriptor``   |Must model the                   |
40|descriptor type |                                       |`Global Descriptor`_ concept.    |
41+----------------+---------------------------------------+---------------------------------+
42|Edge iterator   |``graph_traits<G>::edge_iterator``     |Iterates over edges stored       |
43|type            |                                       |locally. The value type must be  |
44|                |                                       |``edge_descriptor``.             |
45+----------------+---------------------------------------+---------------------------------+
46|Edges size      |``graph_traits<G>::edges_size_type``   |The unsigned integral type used  |
47|type            |                                       |to store the number of edges     |
48|                |                                       |in the local subgraph.           |
49+----------------+---------------------------------------+---------------------------------+
50
51Valid Expressions
52-----------------
53
54+----------------+---------------------+----------------------+-------------------------------------+
55|Name            |Expression           |Type                  |Semantics                            |
56+================+=====================+======================+=====================================+
57|Local edge set  |``edges(g)``         |``std::pair<``        |Returns an iterator range            |
58|                |                     |``edge_iterator,``    |providing access to the local        |
59|                |                     |``edge_iterator>``    |edges in the graph.                  |
60+----------------+---------------------+----------------------+-------------------------------------+
61|Number of local |``num_edges(g)``     |``edges_size_type``   |Returns the number of edges          |
62|edges.          |                     |                      |stored locally in the graph.         |
63+----------------+---------------------+----------------------+-------------------------------------+
64
65
66Models
67------
68
69  - `Distributed adjacency list`_
70
71-----------------------------------------------------------------------------
72
73Copyright (C) 2005 The Trustees of Indiana University.
74
75Authors: Douglas Gregor and Andrew Lumsdaine
76
77.. |Logo| image:: pbgl-logo.png
78            :align: middle
79            :alt: Parallel BGL
80            :target: http://www.osl.iu.edu/research/pbgl
81
82.. _Graph: http://www.boost.org/libs/graph/doc/Graph.html
83.. _Edge List Graph: http://www.boost.org/libs/graph/doc/EdgeListGraph.html
84.. _Distributed Graph: DistributedGraph.html
85.. _Global descriptor: GlobalDescriptor.html
86.. _Distributed adjacency list: distributed_adjacency_list.html
87