1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
//------------------------------------------------------------------------------
// LAGr_BreadthFirstSearch: breadth-first search dispatch
//------------------------------------------------------------------------------
// LAGraph, (c) 2019-2022 by The LAGraph Contributors, All Rights Reserved.
// SPDX-License-Identifier: BSD-2-Clause
//
// For additional details (including references to third party source code and
// other files) see the LICENSE file or contact permission@sei.cmu.edu. See
// Contributors.txt for a full list of contributors. Created, in part, with
// funding and support from the U.S. Government (see Acknowledgments.txt file).
// DM22-0790
// Contributed by Scott McMillan, SEI Carnegie Mellon University
//------------------------------------------------------------------------------
// Breadth-first-search via push/pull method if using SuiteSparse:GraphBLAS
// and its GxB extensions, or a push-only method otherwise. The former is
// much faster.
// This is an Advanced algorithm. SuiteSparse can use a push/pull method if
// G->AT and G->out_degree are provided. G->AT is not required if G is
// undirected. The vanilla method is always push-only.
#include "LG_alg_internal.h"
int LAGr_BreadthFirstSearch_Extended
(
// output:
GrB_Vector *level,
GrB_Vector *parent,
// input:
const LAGraph_Graph G,
GrB_Index src,
int64_t max_level, // < 0: no limit; otherwise, stop at this level
int64_t dest, // < 0: no destination; otherwise, stop if dest
// node is reached
bool many_expected, // if true, the result is expected to include a fair
// portion of the graph. If false, the result (parent
// and level) is expected to be very sparse.
char *msg
)
{
#if LAGRAPH_SUITESPARSE
return LG_BreadthFirstSearch_SSGrB_Extended
(level, parent, G, src, max_level, dest, many_expected, msg) ;
#else
return LG_BreadthFirstSearch_vanilla_Extended
(level, parent, G, src, max_level, dest, msg) ;
#endif
}