adding C/C++ API docs

.gitignore

@@ -84,8 +84,10 @@ datasets/*
 # Jupyter Notebooks
 .ipynb_checkpoints
 
-## Doxygen
+## Doxygen and Docs
 cpp/doxygen/html
+docs/cugraph/lib*
+docs/cugraph/api/*
 
 # created by Dask tests
 python/dask-worker-space

build.sh

@@ -18,6 +18,8 @@ ARGS=$*
 # script, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
+RAPIDS_VERSION=23.12
+
 # Valid args to this script (all possible targets and options) - only one per line
 VALIDARGS="
    clean
@@ -412,8 +414,28 @@ if hasArg docs || hasArg all; then
               ${CMAKE_GENERATOR_OPTION} \
               ${CMAKE_VERBOSE_OPTION}
     fi
+
+    for PROJECT in libcugraphops libwholegraph; do
+        XML_DIR="${REPODIR}/docs/cugraph/${PROJECT}"
+        rm -rf "${XML_DIR}"
+        mkdir -p "${XML_DIR}"
+        export XML_DIR_${PROJECT^^}="$XML_DIR"
+
+        echo "downloading xml for ${PROJECT} into ${XML_DIR}. Environment variable XML_DIR_${PROJECT^^} is set to ${XML_DIR}"
+        curl -O "https://d1664dvumjb44w.cloudfront.net/${PROJECT}/xml_tar/${RAPIDS_VERSION}/xml.tar.gz"
+        tar -xzf xml.tar.gz -C "${XML_DIR}"
+        rm "./xml.tar.gz"
+    done
+
     cd ${LIBCUGRAPH_BUILD_DIR}
     cmake --build "${LIBCUGRAPH_BUILD_DIR}" -j${PARALLEL_LEVEL} --target docs_cugraph ${VERBOSE_FLAG}
+
+    echo "making libcugraph doc dir"
+    rm -rf ${REPODIR}/docs/cugraph/libcugraph
+    mkdir -p ${REPODIR}/docs/cugraph/libcugraph
+
+    export XML_DIR_LIBCUGRAPH="${REPODIR}/cpp/doxygen/xml"
+
     cd ${REPODIR}/docs/cugraph
     make html
 fi

ci/build_docs.sh

@@ -29,7 +29,9 @@ rapids-mamba-retry install \
   cugraph-pyg \
   cugraph-service-server \
   cugraph-service-client \
-  libcugraph_etl
+  libcugraph_etl \
+  pylibcugraphops \
+  pylibwholegraph
 
 # This command installs `cugraph-dgl` without its dependencies
 # since this package can currently only run in `11.6` CTK environments
@@ -50,8 +52,7 @@ done
 rapids-logger "Build CPP docs"
 pushd cpp/doxygen
 doxygen Doxyfile
-mkdir -p "${RAPIDS_DOCS_DIR}/libcugraph/html"
-mv html/* "${RAPIDS_DOCS_DIR}/libcugraph/html"
+export XML_DIR_LIBCUGRAPH="$(pwd)/xml"
 popd
 
 rapids-logger "Build Python docs"

ci/release/update-version.sh

@@ -54,6 +54,10 @@ sed_runner "s/set(cugraph_version .*)/set(cugraph_version ${NEXT_FULL_TAG})/g" p
 sed_runner 's/version = .*/version = '"'${NEXT_SHORT_TAG}'"'/g' docs/cugraph/source/conf.py
 sed_runner 's/release = .*/release = '"'${NEXT_FULL_TAG}'"'/g' docs/cugraph/source/conf.py
 
+
+# build.sh script
+sed_runner 's/RAPIDS_VERSION=.*/RAPIDS_VERSION='${NEXT_SHORT_TAG}'/g' build.sh
+
 # Centralized version file update
 # NOTE: Any script that runs in CI will need to use gha-tool `rapids-generate-version`
 # and echo it to `VERSION` file to get an alpha spec of the current version

cpp/include/cugraph_c/centrality_algorithms.h

@@ -23,8 +23,6 @@
 #include <cugraph_c/resource_handle.h>
 
 /** @defgroup centrality Centrality algorithms
- *  @ingroup c_api
- *  @{
  */
 
 #ifdef __cplusplus
@@ -39,7 +37,8 @@ typedef struct {
 } cugraph_centrality_result_t;
 
 /**
- * @brief     Get the vertex ids from the centrality result
+ * @ingroup centrality
+ * @brief   Get the vertex ids from the centrality result
  *
  * @param [in]   result   The result from a centrality algorithm
  * @return type erased array of vertex ids
@@ -48,7 +47,8 @@ cugraph_type_erased_device_array_view_t* cugraph_centrality_result_get_vertices(
   cugraph_centrality_result_t* result);
 
 /**
- * @brief     Get the centrality values from a centrality algorithm result
+ * @ingroup centrality
+ * @brief   Get the centrality values from a centrality algorithm result
  *
  * @param [in]   result   The result from a centrality algorithm
  * @return type erased array view of centrality values
@@ -57,6 +57,7 @@ cugraph_type_erased_device_array_view_t* cugraph_centrality_result_get_values(
   cugraph_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the number of iterations executed from the algorithm metadata
  *
  * @param [in]   result   The result from a centrality algorithm
@@ -65,6 +66,7 @@ cugraph_type_erased_device_array_view_t* cugraph_centrality_result_get_values(
 size_t cugraph_centrality_result_get_num_iterations(cugraph_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Returns true if the centrality algorithm converged
  *
  * @param [in]   result   The result from a centrality algorithm
@@ -73,6 +75,7 @@ size_t cugraph_centrality_result_get_num_iterations(cugraph_centrality_result_t*
 bool_t cugraph_centrality_result_converged(cugraph_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Free centrality result
  *
  * @param [in]   result   The result from a centrality algorithm
@@ -409,6 +412,7 @@ typedef struct {
 } cugraph_edge_centrality_result_t;
 
 /**
+ * @ingroup centrality
  * @brief     Get the src vertex ids from an edge centrality result
  *
  * @param [in]   result   The result from an edge centrality algorithm
@@ -418,6 +422,7 @@ cugraph_type_erased_device_array_view_t* cugraph_edge_centrality_result_get_src_
   cugraph_edge_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the dst vertex ids from an edge centrality result
  *
  * @param [in]   result   The result from an edge centrality algorithm
@@ -427,6 +432,7 @@ cugraph_type_erased_device_array_view_t* cugraph_edge_centrality_result_get_dst_
   cugraph_edge_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the edge ids from an edge centrality result
  *
  * @param [in]   result   The result from an edge centrality algorithm
@@ -436,6 +442,7 @@ cugraph_type_erased_device_array_view_t* cugraph_edge_centrality_result_get_edge
   cugraph_edge_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the centrality values from an edge centrality algorithm result
  *
  * @param [in]   result   The result from an edge centrality algorithm
@@ -445,6 +452,7 @@ cugraph_type_erased_device_array_view_t* cugraph_edge_centrality_result_get_valu
   cugraph_edge_centrality_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Free centrality result
  *
  * @param [in]   result   The result from a centrality algorithm
@@ -491,6 +499,7 @@ typedef struct {
 } cugraph_hits_result_t;
 
 /**
+ * @ingroup centrality
  * @brief     Get the vertex ids from the hits result
  *
  * @param [in]   result   The result from hits
@@ -500,6 +509,7 @@ cugraph_type_erased_device_array_view_t* cugraph_hits_result_get_vertices(
   cugraph_hits_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the hubs values from the hits result
  *
  * @param [in]   result   The result from hits
@@ -509,6 +519,7 @@ cugraph_type_erased_device_array_view_t* cugraph_hits_result_get_hubs(
   cugraph_hits_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Get the authorities values from the hits result
  *
  * @param [in]   result   The result from hits
@@ -518,6 +529,7 @@ cugraph_type_erased_device_array_view_t* cugraph_hits_result_get_authorities(
   cugraph_hits_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief   Get the score differences between the last two iterations
  *
  * @param [in]   result   The result from hits
@@ -526,6 +538,7 @@ cugraph_type_erased_device_array_view_t* cugraph_hits_result_get_authorities(
 double cugraph_hits_result_get_hub_score_differences(cugraph_hits_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief   Get the actual number of iterations
  *
  * @param [in]   result   The result from hits
@@ -534,6 +547,7 @@ double cugraph_hits_result_get_hub_score_differences(cugraph_hits_result_t* resu
 size_t cugraph_hits_result_get_number_of_iterations(cugraph_hits_result_t* result);
 
 /**
+ * @ingroup centrality
  * @brief     Free hits result
  *
  * @param [in]   result   The result from hits
@@ -585,7 +599,3 @@ cugraph_error_code_t cugraph_hits(
 #ifdef __cplusplus
 }
 #endif
-
-/**
- *  @}
- */

cpp/include/cugraph_c/community_algorithms.h

@@ -23,7 +23,6 @@
 #include <cugraph_c/resource_handle.h>
 
 /** @defgroup community Community algorithms
- *  @ingroup c_api
  *  @{
  */
 

cpp/include/cugraph_c/core_algorithms.h

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,9 @@
 #include <cugraph_c/graph.h>
 #include <cugraph_c/resource_handle.h>
 
+/** @defgroup core Core algorithms
+ */
+
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -40,6 +43,7 @@ typedef struct {
 } cugraph_k_core_result_t;
 
 /**
+ * @ingroup core
  * @brief       Create a core_number result (in case it was previously extracted)
  *
  * @param [in]  handle       Handle for accessing resources
@@ -58,6 +62,7 @@ cugraph_error_code_t cugraph_core_result_create(
   cugraph_error_t** error);
 
 /**
+ * @ingroup core
  * @brief       Get the vertex ids from the core result
  *
  * @param [in]     result   The result from core number
@@ -67,6 +72,7 @@ cugraph_type_erased_device_array_view_t* cugraph_core_result_get_vertices(
   cugraph_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief       Get the core numbers from the core result
  *
  * @param [in]    result    The result from core number
@@ -76,13 +82,15 @@ cugraph_type_erased_device_array_view_t* cugraph_core_result_get_core_numbers(
   cugraph_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief     Free core result
  *
  * @param [in]    result    The result from core number
  */
 void cugraph_core_result_free(cugraph_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief       Get the src vertex ids from the k-core result
  *
  * @param [in]     result   The result from k-core
@@ -92,6 +100,7 @@ cugraph_type_erased_device_array_view_t* cugraph_k_core_result_get_src_vertices(
   cugraph_k_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief       Get the dst vertex ids from the k-core result
  *
  * @param [in]     result   The result from k-core
@@ -101,6 +110,7 @@ cugraph_type_erased_device_array_view_t* cugraph_k_core_result_get_dst_vertices(
   cugraph_k_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief       Get the weights from the k-core result
  *
  * Returns NULL if the graph is unweighted
@@ -112,13 +122,15 @@ cugraph_type_erased_device_array_view_t* cugraph_k_core_result_get_weights(
   cugraph_k_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief     Free k-core result
  *
  * @param [in]    result    The result from k-core
  */
 void cugraph_k_core_result_free(cugraph_k_core_result_t* result);
 
 /**
+ * @ingroup core
  * @brief     Enumeration for computing core number
  */
 typedef enum {

cpp/include/cugraph_c/labeling_algorithms.h

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,8 +25,6 @@ extern "C" {
 #endif
 
 /** @defgroup labeling Labeling algorithms
- *  @ingroup c_api
- *  @{
  */
 
 /**
@@ -37,6 +35,7 @@ typedef struct {
 } cugraph_labeling_result_t;
 
 /**
+ * @ingroup labeling
  * @brief     Get the vertex ids from the labeling result
  *
  * @param [in]   result   The result from a labeling algorithm
@@ -46,6 +45,7 @@ cugraph_type_erased_device_array_view_t* cugraph_labeling_result_get_vertices(
   cugraph_labeling_result_t* result);
 
 /**
+ * @ingroup labeling
  * @brief     Get the label values from the labeling result
  *
  * @param [in]   result   The result from a labeling algorithm
@@ -55,6 +55,7 @@ cugraph_type_erased_device_array_view_t* cugraph_labeling_result_get_labels(
   cugraph_labeling_result_t* result);
 
 /**
+ * @ingroup labeling
  * @brief     Free labeling result
  *
  * @param [in]   result   The result from a labeling algorithm
@@ -104,7 +105,3 @@ cugraph_error_code_t cugraph_strongly_connected_components(const cugraph_resourc
 #ifdef __cplusplus
 }
 #endif
-
-/**
- *  @}
- */

cpp/include/cugraph_c/sampling_algorithms.h

@@ -21,8 +21,7 @@
 #include <cugraph_c/random.h>
 #include <cugraph_c/resource_handle.h>
 
-/** @defgroup sampling Sampling algorithms
- *  @ingroup c_api
+/** @defgroup samplingC Sampling algorithms
  *  @{
  */