libcugraph-cu12 25.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: libcugraph-cu12
|
|
3
|
+
Version: 25.2.0
|
|
4
|
+
Summary: cuGraph - RAPIDS GPU Graph Analytics (C++)
|
|
5
|
+
Author: NVIDIA Corporation
|
|
6
|
+
License: Apache 2.0
|
|
7
|
+
Classifier: Intended Audience :: Developers
|
|
8
|
+
Classifier: Topic :: Database
|
|
9
|
+
Classifier: Topic :: Scientific/Engineering
|
|
10
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
11
|
+
Classifier: Programming Language :: C++
|
|
12
|
+
Classifier: Environment :: GPU :: NVIDIA CUDA
|
|
13
|
+
Project-URL: Homepage, https://github.com/rapidsai/cugraph
|
|
14
|
+
Requires-Python: >=3.10
|
|
15
|
+
Requires-Dist: libraft-cu12==25.2.*
|
|
16
|
+
Description-Content-Type: text/markdown
|
|
17
|
+
|
|
18
|
+
# ** NOTICE ** the cuGraph repository has been refactored to make it more efficient to build, maintain and use.
|
|
19
|
+
|
|
20
|
+
Libraries supporting GNNs are now located in the [cugraph-gnn repository](https://github.com/rapidsai/cugraph-gnn)
|
|
21
|
+
|
|
22
|
+
* [pylibwholegraph](https://github.com/rapidsai/cugraph-gnn/tree/branch-25.02/python/) - the [Wholegraph](https://docs.rapids.ai/api/cugraph/nightly/wholegraph/) library for client memory management supporting both cuGraph-DGL and cuGraph-PyG for even greater scalability
|
|
23
|
+
* [cugraph_dgl](https://github.com/rapidsai/cugraph-gnn/blob/main/readme_pages/cugraph_dgl.md) enables the ability to use cugraph Property Graphs with Deep Graph Library (DGL)
|
|
24
|
+
* [cugraph_pyg](https://github.com/rapidsai/cugraph-gnn/blob/main/readme_pages/cugraph_pyg.md) enables the ability to use cugraph Property Graphs with PyTorch Geometric (PyG).
|
|
25
|
+
|
|
26
|
+
[RAPIDS nx-cugraph](https://rapids.ai/nx-cugraph/) is now located in the [nx-cugraph repository](https://github.com/rapidsai/nx-cugraph) containing a backend to NetworkX for running supported algorithms with GPU acceleration.
|
|
27
|
+
|
|
28
|
+
The [cugraph-docs repository](https://github.com/rapidsai/cugraph-docs) contains code to generate cuGraph documentation.
|
|
29
|
+
|
|
30
|
+
#
|
|
31
|
+
|
|
32
|
+
<h1 align="center"; style="font-style: italic";>
|
|
33
|
+
<br>
|
|
34
|
+
<img src="img/cugraph_logo_2.png" alt="cuGraph" width="500">
|
|
35
|
+
</h1>
|
|
36
|
+
|
|
37
|
+
<div align="center">
|
|
38
|
+
|
|
39
|
+
<a href="https://github.com/rapidsai/cugraph/blob/main/LICENSE">
|
|
40
|
+
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
|
|
41
|
+
<img alt="GitHub tag (latest by date)" src="https://img.shields.io/github/v/tag/rapidsai/cugraph">
|
|
42
|
+
|
|
43
|
+
<a href="https://github.com/rapidsai/cugraph/stargazers">
|
|
44
|
+
<img src="https://img.shields.io/github/stars/rapidsai/cugraph"></a>
|
|
45
|
+
<img alt="Conda" src="https://img.shields.io/conda/dn/rapidsai/cugraph">
|
|
46
|
+
<img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/rapidsai/cugraph">
|
|
47
|
+
|
|
48
|
+
<img alt="Conda" src="https://img.shields.io/conda/pn/rapidsai/cugraph" />
|
|
49
|
+
|
|
50
|
+
<a href="https://rapids.ai/"><img src="img/rapids_logo.png" alt="RAPIDS" width="125"></a>
|
|
51
|
+
|
|
52
|
+
</div>
|
|
53
|
+
|
|
54
|
+
<br>
|
|
55
|
+
|
|
56
|
+
[RAPIDS](https://rapids.ai) cuGraph is a repo that represents a collection of packages focused on GPU-accelerated graph analytics including support for property graphs and remote (graph as a service) operations. cuGraph supports the creation and manipulation of graphs followed by the execution of scalable fast graph algorithms.
|
|
57
|
+
|
|
58
|
+
<div align="center">
|
|
59
|
+
|
|
60
|
+
[Getting cuGraph](https://docs.rapids.ai/api/cugraph/nightly/) *
|
|
61
|
+
[Graph Algorithms](https://docs.rapids.ai/api/cugraph/nightly/graph_support/algorithms/) *
|
|
62
|
+
[Graph Service](./readme_pages/cugraph_service.md) *
|
|
63
|
+
[Property Graph](./readme_pages/property_graph.md) *
|
|
64
|
+
|
|
65
|
+
</div>
|
|
66
|
+
|
|
67
|
+
-----
|
|
68
|
+
|
|
69
|
+
## Table of contents
|
|
70
|
+
- Installation
|
|
71
|
+
- [Getting cuGraph Packages](https://docs.rapids.ai/api/cugraph/stable/installation/getting_cugraph/)
|
|
72
|
+
- [Building from Source](https://docs.rapids.ai/api/cugraph/stable/installation/source_build/)
|
|
73
|
+
- [Contributing to cuGraph](https://docs.rapids.ai/contributing/)
|
|
74
|
+
- General
|
|
75
|
+
- [Latest News](https://docs.rapids.ai/api/cugraph/nightly/)
|
|
76
|
+
- [Current list of algorithms](https://docs.rapids.ai/api/cugraph/stable/graph_support/algorithms/)
|
|
77
|
+
- [Blogs and Presentation](https://docs.rapids.ai/api/cugraph/nightly/tutorials/cugraph_blogs/)
|
|
78
|
+
- Packages
|
|
79
|
+
- [cuGraph Python](./readme_pages/cugraph_python.md)
|
|
80
|
+
- [Property Graph](./readme_pages/property_graph.md)
|
|
81
|
+
- [External Data Types](./readme_pages/data_types.md)
|
|
82
|
+
- [pylibcugraph](./readme_pages/pylibcugraph.md)
|
|
83
|
+
- [libcugraph (C/C++/CUDA)](./readme_pages/libcugraph.md)
|
|
84
|
+
- [nx-cugraph](https://rapids.ai/nx-cugraph/)
|
|
85
|
+
- [cugraph-service](./readme_pages/cugraph_service.md)
|
|
86
|
+
- API Docs
|
|
87
|
+
- Python
|
|
88
|
+
- [Python Nightly](https://docs.rapids.ai/api/cugraph/nightly/api_docs/cugraph/)
|
|
89
|
+
- [Python Stable](https://docs.rapids.ai/api/cugraph/stable/api_docs/cugraph/)
|
|
90
|
+
- C
|
|
91
|
+
- [C Nightly](https://docs.rapids.ai/api/cugraph/nightly/api_docs/cugraph_c/)
|
|
92
|
+
- [C Stable](https://docs.rapids.ai/api/cugraph/stable/api_docs/cugraph_c/)
|
|
93
|
+
- C++
|
|
94
|
+
- [C++ Nightly](https://docs.rapids.ai/api/cugraph/nightly/api_docs/cugraph_cpp/)
|
|
95
|
+
- (Will be available when 25.02 is released)[C++ Stable](https://docs.rapids.ai/api/cugraph/stable/api_docs/cugraph_cpp/)
|
|
96
|
+
- References
|
|
97
|
+
- [RAPIDS](https://rapids.ai/)
|
|
98
|
+
- [ARROW](https://arrow.apache.org/)
|
|
99
|
+
- [DASK](https://www.dask.org/)
|
|
100
|
+
|
|
101
|
+
<br><br>
|
|
102
|
+
|
|
103
|
+
-----
|
|
104
|
+
|
|
105
|
+
<img src="img/Stack2.png" alt="Stack" width="800">
|
|
106
|
+
|
|
107
|
+
[RAPIDS](https://rapids.ai) cuGraph is a collection of GPU-accelerated graph algorithms and services. At the Python layer, cuGraph operates on [GPU DataFrames](https://github.com/rapidsai/cudf), thereby allowing for seamless passing of data between ETL tasks in [cuDF](https://github.com/rapidsai/cudf) and machine learning tasks in [cuML](https://github.com/rapidsai/cuml). Data scientists familiar with Python will quickly pick up how cuGraph integrates with the Pandas-like API of cuDF. Likewise, users familiar with NetworkX will quickly recognize the NetworkX-like API provided in cuGraph, with the goal to allow existing code to be ported with minimal effort into RAPIDS. To simplify integration, cuGraph also supports data found in [Pandas DataFrame](https://pandas.pydata.org/), [NetworkX Graph Objects](https://networkx.org/) and several other formats.
|
|
108
|
+
|
|
109
|
+
While the high-level cugraph python API provides an easy-to-use and familiar interface for data scientists that's consistent with other RAPIDS libraries in their workflow, some use cases require access to lower-level graph theory concepts. For these users, we provide an additional Python API called pylibcugraph, intended for applications that require a tighter integration with cuGraph at the Python layer with fewer dependencies. Users familiar with C/C++/CUDA and graph structures can access libcugraph and libcugraph_c for low level integration outside of python.
|
|
110
|
+
|
|
111
|
+
**NOTE:** For the latest stable [README.md](https://github.com/rapidsai/cugraph/blob/main/README.md) ensure you are on the latest branch.
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
As an example, the following Python snippet loads graph data and computes PageRank:
|
|
116
|
+
|
|
117
|
+
```python
|
|
118
|
+
import cudf
|
|
119
|
+
import cugraph
|
|
120
|
+
|
|
121
|
+
# read data into a cuDF DataFrame using read_csv
|
|
122
|
+
gdf = cudf.read_csv("graph_data.csv", names=["src", "dst"], dtype=["int32", "int32"])
|
|
123
|
+
|
|
124
|
+
# We now have data as edge pairs
|
|
125
|
+
# create a Graph using the source (src) and destination (dst) vertex pairs
|
|
126
|
+
G = cugraph.Graph()
|
|
127
|
+
G.from_cudf_edgelist(gdf, source='src', destination='dst')
|
|
128
|
+
|
|
129
|
+
# Let's now get the PageRank score of each vertex by calling cugraph.pagerank
|
|
130
|
+
df_page = cugraph.pagerank(G)
|
|
131
|
+
|
|
132
|
+
# Let's look at the top 10 PageRank Score
|
|
133
|
+
df_page.sort_values('pagerank', ascending=False).head(10)
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
</br>
|
|
138
|
+
|
|
139
|
+
[Why cuGraph does not support Method Cascading](https://docs.rapids.ai/api/cugraph/nightly/basics/cugraph_cascading.html)
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
------
|
|
144
|
+
# Projects that use cuGraph
|
|
145
|
+
|
|
146
|
+
(alphabetical order)
|
|
147
|
+
* ArangoDB - a free and open-source native multi-model database system - https://www.arangodb.com/
|
|
148
|
+
* CuPy - "NumPy/SciPy-compatible Array Library for GPU-accelerated Computing with Python" - https://cupy.dev/
|
|
149
|
+
* Memgraph - In-memory Graph database - https://memgraph.com/
|
|
150
|
+
* NetworkX (via [nx-cugraph](https://rapids.ai/nx-cugraph/) backend) - an extremely popular, free and open-source package for the creation, manipulation, and study of the structure, dynamics, and functions of complex networks - https://networkx.org/
|
|
151
|
+
* PyGraphistry - free and open-source GPU graph ETL, AI, and visualization, including native RAPIDS & cuGraph support - http://github.com/graphistry/pygraphistry
|
|
152
|
+
* ScanPy - a scalable toolkit for analyzing single-cell gene expression data - https://scanpy.readthedocs.io/en/stable/
|
|
153
|
+
|
|
154
|
+
(please post an issue if you have a project to add to this list)
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
------
|
|
159
|
+
<br>
|
|
160
|
+
|
|
161
|
+
## <div align="center"><img src="img/rapids_logo.png" width="265px"/></div> Open GPU Data Science <a name="rapids"></a>
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
The RAPIDS suite of open source software libraries aims to enable execution of end-to-end data science and analytics pipelines entirely on GPUs. It relies on NVIDIA® CUDA® primitives for low-level compute optimization but exposing that GPU parallelism and high-bandwidth memory speed through user-friendly Python interfaces.
|
|
165
|
+
|
|
166
|
+
<p align="center"><img src="img/rapids_arrow.png" width="50%"/></p>
|
|
167
|
+
|
|
168
|
+
For more project details, see [rapids.ai](https://rapids.ai/).
|
|
169
|
+
|
|
170
|
+
<br><br>
|
|
171
|
+
### Apache Arrow on GPU <a name="arrow"></a>
|
|
172
|
+
|
|
173
|
+
The GPU version of [Apache Arrow](https://arrow.apache.org/) is a common API that enables efficient interchange of tabular data between processes running on the GPU. End-to-end computation on the GPU avoids unnecessary copying and converting of data off the GPU, reducing compute time and cost for high-performance analytics common in artificial intelligence workloads. As the name implies, cuDF uses the Apache Arrow columnar data format on the GPU. Currently, a subset of the features in Apache Arrow are supported.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2
|
|
3
|
+
|
|
4
|
+
[build-system]
|
|
5
|
+
requires = ["wheel-stub"]
|
|
6
|
+
build-backend = "wheel_stub.buildapi"
|
|
7
|
+
|
|
8
|
+
[tool.wheel_stub]
|
|
9
|
+
index_url = "https://pypi.nvidia.com/"
|
|
10
|
+
include_cuda_debuginfo = true
|