Skip to content

Commit 95d5844

Browse files
leofangCopilotjuanjgalvez
authored
Update CUDA Python project list (NVIDIA#1339)
* update readme * Initial plan * Update documentation files following commit a1e0f91 Co-authored-by: leofang <5534781+leofang@users.noreply.github.com> * Update cuda.coop and cuda.compute URLs to correct paths Co-authored-by: leofang <5534781+leofang@users.noreply.github.com> * Update rst_epilog to use new package names cuda.coop and cuda.compute Co-authored-by: leofang <5534781+leofang@users.noreply.github.com> * only projects maintained in the NVIDIA/cuda-python repo should be listed here * fix numba-cuda hyperlink * Apply suggestions from code review Co-authored-by: Juan Galvez <jjgalvez@msn.com> * Apply suggestions from code review --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: leofang <5534781+leofang@users.noreply.github.com> Co-authored-by: Juan Galvez <jjgalvez@msn.com>
1 parent 233a98b commit 95d5844

4 files changed

Lines changed: 54 additions & 32 deletions

File tree

README.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,19 @@
22

33
CUDA Python is the home for accessing NVIDIA’s CUDA platform from Python. It consists of multiple components:
44

5-
* [cuda.core](https://nvidia.github.io/cuda-python/cuda-core/latest): Pythonic access to CUDA Runtime and other core functionalities
5+
* [cuda.core](https://nvidia.github.io/cuda-python/cuda-core/latest): Pythonic access to CUDA Runtime and other core functionality
66
* [cuda.bindings](https://nvidia.github.io/cuda-python/cuda-bindings/latest): Low-level Python bindings to CUDA C APIs
77
* [cuda.pathfinder](https://nvidia.github.io/cuda-python/cuda-pathfinder/latest): Utilities for locating CUDA components installed in the user's Python environment
8-
* [cuda.cccl.cooperative](https://nvidia.github.io/cccl/python/cooperative): A Python module providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
9-
* [cuda.cccl.parallel](https://nvidia.github.io/cccl/python/parallel): A Python module for easy access to CCCL's highly efficient and customizable parallel algorithms, like `sort`, `scan`, `reduce`, `transform`, etc. that are callable on the *host*
10-
* [numba.cuda](https://nvidia.github.io/numba-cuda/): Numba's target for CUDA GPU programming by directly compiling a restricted subset of Python code into CUDA kernels and device functions following the CUDA execution model.
11-
* [nvmath-python](https://docs.nvidia.com/cuda/nvmath-python/latest): Pythonic access to NVIDIA CPU & GPU Math Libraries, with both [*host*](https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#host-apis) and [*device* (nvmath.device)](https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#device-apis) APIs. It also provides low-level Python bindings to host C APIs ([nvmath.bindings](https://docs.nvidia.com/cuda/nvmath-python/latest/bindings/index.html)).
12-
13-
CUDA Python is currently undergoing an overhaul to improve existing and introduce new components. All of the previously available functionalities from the `cuda-python` package will continue to be available, please refer to the [cuda.bindings](https://nvidia.github.io/cuda-python/cuda-bindings/latest) documentation for installation guide and further detail.
8+
* [cuda.coop](https://nvidia.github.io/cccl/python/coop): A Python module providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
9+
* [cuda.compute](https://nvidia.github.io/cccl/python/compute): A Python module for easy access to CCCL's highly efficient and customizable parallel algorithms, like `sort`, `scan`, `reduce`, `transform`, etc. that are callable on the *host*
10+
* [numba.cuda](https://nvidia.github.io/numba-cuda/): A Python DSL that exposes CUDA **SIMT** programming model and compiles a restricted subset of Python code into CUDA kernels and device functions
11+
* [cuda.tile](https://docs.nvidia.com/cuda/cutile-python/): A new Python DSL that exposes CUDA **Tile** programming model and allows users to write NumPy-like code in CUDA kernels
12+
* [nvmath-python](https://docs.nvidia.com/cuda/nvmath-python/latest): Pythonic access to NVIDIA CPU & GPU Math Libraries, with [*host*](https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#host-apis), [*device*](https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#device-apis), and [*distributed*](https://docs.nvidia.com/cuda/nvmath-python/latest/distributed-apis/index.html) APIs. It also provides low-level Python bindings to host C APIs ([nvmath.bindings](https://docs.nvidia.com/cuda/nvmath-python/latest/bindings/index.html)).
13+
* [nvshmem4py](https://docs.nvidia.com/nvshmem/api/api/language_bindings/python/index.html): Pythonic interface to the NVSHMEM library, enabling Python applications to leverage NVSHMEM's high-performance PGAS (Partitioned Global Address Space) programming model for GPU-accelerated computing
14+
* [Nsight Python](https://docs.nvidia.com/nsight-python/index.html): Python kernel profiling interface that automates performance analysis across multiple kernel configurations using NVIDIA Nsight Tools
15+
* [CUPTI Python](https://docs.nvidia.com/cupti-python/): Python APIs for creation of profiling tools that target CUDA Python applications via the CUDA Profiling Tools Interface (CUPTI)
16+
17+
CUDA Python is currently undergoing an overhaul to improve existing and introduce new components. All of the previously available functionality from the `cuda-python` package will continue to be available, please refer to the [cuda.bindings](https://nvidia.github.io/cuda-python/cuda-bindings/latest) documentation for installation guide and further detail.
1418

1519
## cuda-python as a metapackage
1620

cuda_python/DESCRIPTION.rst

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,25 +7,29 @@ cuda-python: Metapackage collection of CUDA Python subpackages
77

88
CUDA Python is the home for accessing NVIDIA's CUDA platform from Python. It consists of multiple components:
99

10-
* `cuda.core <https://nvidia.github.io/cuda-python/cuda-core/latest>`_: Pythonic access to CUDA Runtime and other core functionalities
10+
* `cuda.core <https://nvidia.github.io/cuda-python/cuda-core/latest>`_: Pythonic access to CUDA Runtime and other core functionality
1111
* `cuda.bindings <https://nvidia.github.io/cuda-python/cuda-bindings/latest>`_: Low-level Python bindings to CUDA C APIs
12-
* `cuda.cooperative <https://nvidia.github.io/cccl/python/cooperative>`_: A Python package providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
13-
* `cuda.parallel <https://nvidia.github.io/cccl/python/parallel>`_: A Python package for easy access to CCCL's highly efficient and customizable parallel algorithms, like ``sort``, ``scan``, ``reduce``, ``transform``, etc, that are callable on the *host*
14-
* `numba.cuda <https://nvidia.github.io/numba-cuda/>`_: Numba's target for CUDA GPU programming by directly compiling a restricted subset of Python code into CUDA kernels and device functions following the CUDA execution model.
15-
16-
For access to NVIDIA CPU & GPU Math Libraries, please refer to `nvmath-python <https://docs.nvidia.com/cuda/nvmath-python/latest>`_.
17-
18-
CUDA Python is currently undergoing an overhaul to improve existing and bring up new components. All of the previously available functionalities from the ``cuda-python`` package will continue to be available, please refer to the `cuda.bindings <https://nvidia.github.io/cuda-python/cuda-bindings/latest>`_ documentation for installation guide and further detail.
12+
* `cuda.pathfinder <https://nvidia.github.io/cuda-python/cuda-pathfinder/latest>`_: Utilities for locating CUDA components installed in the user's Python environment
13+
* `cuda.coop <https://nvidia.github.io/cccl/python/coop>`_: A Python module providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
14+
* `cuda.compute <https://nvidia.github.io/cccl/python/compute>`_: A Python module for easy access to CCCL's highly efficient and customizable parallel algorithms, like ``sort``, ``scan``, ``reduce``, ``transform``, etc. that are callable on the *host*
15+
* `numba.cuda <https://nvidia.github.io/numba-cuda/>`_: A Python DSL that exposes CUDA **SIMT** programming model and compiles a restricted subset of Python code into CUDA kernels and device functions
16+
* `cuda.tile <https://docs.nvidia.com/cuda/cutile-python/>`_: A new Python DSL that exposes CUDA **Tile** programming model and allows users to write NumPy-like code in CUDA kernels
17+
* `nvmath-python <https://docs.nvidia.com/cuda/nvmath-python/latest>`_: Pythonic access to NVIDIA CPU & GPU Math Libraries, with `host <https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#host-apis>`_, `device <https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#device-apis>`_, and `distributed <https://docs.nvidia.com/cuda/nvmath-python/latest/distributed-apis/index.html>`_ APIs. It also provides low-level Python bindings to host C APIs (`nvmath.bindings <https://docs.nvidia.com/cuda/nvmath-python/latest/bindings/index.html>`_).
18+
* `nvshmem4py <https://docs.nvidia.com/nvshmem/api/api/language_bindings/python/index.html>`_: Pythonic interface to the NVSHMEM library, enabling Python applications to leverage NVSHMEM's high-performance PGAS (Partitioned Global Address Space) programming model for GPU-accelerated computing
19+
* `Nsight Python <https://docs.nvidia.com/nsight-python/index.html>`_: Python kernel profiling interface that automates performance analysis across multiple kernel configurations using NVIDIA Nsight Tools
20+
* `CUPTI Python <https://docs.nvidia.com/cupti-python/>`_: Python APIs for creation of profiling tools that target CUDA Python applications via the CUDA Profiling Tools Interface (CUPTI)
21+
22+
CUDA Python is currently undergoing an overhaul to improve existing and introduce new components. All of the previously available functionality from the ``cuda-python`` package will continue to be available, please refer to the `cuda.bindings <https://nvidia.github.io/cuda-python/cuda-bindings/latest>`_ documentation for installation guide and further detail.
1923

2024
cuda-python as a metapackage
2125
============================
2226

23-
``cuda-python`` is now a metapackage that contains a collection of subpackages. Each subpackage is versioned independently, allowing installation of each component as needed.
27+
``cuda-python`` is being restructured to become a metapackage that contains a collection of subpackages. Each subpackage is versioned independently, allowing installation of each component as needed.
2428

2529
Subpackage: cuda.core
2630
---------------------
2731

28-
The ``cuda.core`` package offers idiomatic, pythonic access to CUDA Runtime and other functionalities.
32+
The ``cuda.core`` package offers idiomatic, pythonic access to CUDA Runtime and other functionality.
2933

3034
The goals are to
3135

@@ -40,7 +44,7 @@ Subpackage: cuda.bindings
4044

4145
The ``cuda.bindings`` package is a standard set of low-level interfaces, providing full coverage of and access to the CUDA host APIs from Python.
4246

43-
The list of available interfaces are:
47+
The list of available interfaces is:
4448

4549
* CUDA Driver
4650
* CUDA Runtime

cuda_python/docs/source/conf.py

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,4 @@
8787
.. _cuda.core: {CUDA_PYTHON_DOMAIN}/cuda-core/latest
8888
.. _cuda.bindings: {CUDA_PYTHON_DOMAIN}/cuda-bindings/latest
8989
.. _cuda.pathfinder: {CUDA_PYTHON_DOMAIN}/cuda-pathfinder/latest
90-
.. _cuda.cccl.cooperative: https://nvidia.github.io/cccl/python/cooperative
91-
.. _cuda.cccl.parallel: https://nvidia.github.io/cccl/python/parallel
92-
.. _numba.cuda: https://nvidia.github.io/numba-cuda/
9390
"""

cuda_python/docs/source/index.rst

Lines changed: 28 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,20 +7,33 @@ CUDA Python
77
CUDA Python is the home for accessing NVIDIA's CUDA platform from Python. It consists of
88
multiple components:
99

10-
- `cuda.core`_: Pythonic access to CUDA runtime and other core functionalities
10+
- `cuda.core`_: Pythonic access to CUDA Runtime and other core functionality
1111
- `cuda.bindings`_: Low-level Python bindings to CUDA C APIs
1212
- `cuda.pathfinder`_: Utilities for locating CUDA components installed in the user's Python environment
13-
- `cuda.cccl.cooperative`_: A Python module providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
14-
- `cuda.cccl.parallel`_: A Python module for easy access to CCCL's highly efficient and customizable parallel algorithms, like ``sort``, ``scan``, ``reduce``, ``transform``, etc, that are callable on the *host*
15-
- `numba.cuda`_: Numba's target for CUDA GPU programming by directly compiling a restricted subset of Python code into CUDA kernels and device functions following the CUDA execution model.
16-
* `nvmath-python`_: Pythonic access to NVIDIA CPU & GPU Math Libraries, with both *host* and *device* (through `nvmath.device`_) APIs. It also provides low-level Python bindings to host C APIs (through `nvmath.bindings`_).
17-
13+
- `cuda.coop`_: A Python module providing CCCL's reusable block-wide and warp-wide *device* primitives for use within Numba CUDA kernels
14+
- `cuda.compute`_: A Python module for easy access to CCCL's highly efficient and customizable parallel algorithms, like ``sort``, ``scan``, ``reduce``, ``transform``, etc. that are callable on the *host*
15+
- `numba.cuda`_: A Python DSL that exposes CUDA **SIMT** programming model and compiles a restricted subset of Python code into CUDA kernels and device functions
16+
- `cuda.tile`_: A new Python DSL that exposes CUDA **Tile** programming model and allows users to write NumPy-like code in CUDA kernels
17+
- `nvmath-python`_: Pythonic access to NVIDIA CPU & GPU Math Libraries, with `host`_, `device`_, and `distributed`_ APIs. It also provides low-level Python bindings to host C APIs (`nvmath.bindings`_).
18+
- `nvshmem4py`_: Pythonic interface to the NVSHMEM library, enabling Python applications to leverage NVSHMEM's high-performance PGAS (Partitioned Global Address Space) programming model for GPU-accelerated computing
19+
- `Nsight Python`_: Python kernel profiling interface that automates performance analysis across multiple kernel configurations using NVIDIA Nsight Tools
20+
- `CUPTI Python`_: Python APIs for creation of profiling tools that target CUDA Python applications via the CUDA Profiling Tools Interface (CUPTI)
21+
22+
.. _cuda.coop: https://nvidia.github.io/cccl/python/coop
23+
.. _cuda.compute: https://nvidia.github.io/cccl/python/compute
24+
.. _numba.cuda: https://nvidia.github.io/numba-cuda/
25+
.. _cuda.tile: https://docs.nvidia.com/cuda/cutile-python/
1826
.. _nvmath-python: https://docs.nvidia.com/cuda/nvmath-python/latest
19-
.. _nvmath.device: https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#device-apis
27+
.. _host: https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#host-apis
28+
.. _device: https://docs.nvidia.com/cuda/nvmath-python/latest/overview.html#device-apis
29+
.. _distributed: https://docs.nvidia.com/cuda/nvmath-python/latest/distributed-apis/index.html
2030
.. _nvmath.bindings: https://docs.nvidia.com/cuda/nvmath-python/latest/bindings/index.html
31+
.. _nvshmem4py: https://docs.nvidia.com/nvshmem/api/api/language_bindings/python/index.html
32+
.. _Nsight Python: https://docs.nvidia.com/nsight-python/index.html
33+
.. _CUPTI Python: https://docs.nvidia.com/cupti-python/
2134

22-
CUDA Python is currently undergoing an overhaul to improve existing and bring up new components.
23-
All of the previously available functionalities from the ``cuda-python`` package will continue to
35+
CUDA Python is currently undergoing an overhaul to improve existing and introduce new components.
36+
All of the previously available functionality from the ``cuda-python`` package will continue to
2437
be available, please refer to the `cuda.bindings`_ documentation for installation guide and further detail.
2538

2639
..
@@ -35,7 +48,11 @@ be available, please refer to the `cuda.bindings`_ documentation for installatio
3548
cuda.core <https://nvidia.github.io/cuda-python/cuda-core/latest>
3649
cuda.bindings <https://nvidia.github.io/cuda-python/cuda-bindings/latest>
3750
cuda.pathfinder <https://nvidia.github.io/cuda-python/cuda-pathfinder/latest>
38-
cuda.cccl.cooperative <https://nvidia.github.io/cccl/python/cooperative>
39-
cuda.cccl.parallel <https://nvidia.github.io/cccl/python/parallel>
51+
cuda.coop <https://nvidia.github.io/cccl/python/coop>
52+
cuda.compute <https://nvidia.github.io/cccl/python/compute>
4053
numba.cuda <https://nvidia.github.io/numba-cuda/>
54+
cuda.tile <https://docs.nvidia.com/cuda/cutile-python/>
4155
nvmath-python <https://docs.nvidia.com/cuda/nvmath-python/>
56+
nvshmem4py <https://docs.nvidia.com/nvshmem/api/api/language_bindings/python/index.html>
57+
Nsight Python <https://docs.nvidia.com/nsight-python/index.html>
58+
CUPTI Python <https://docs.nvidia.com/cupti-python/>

0 commit comments

Comments
 (0)