CUDA 13.2 samples update (#432)

- Added Python samples for CUDA Python 1.0 release
- Renamed top-level `Samples` directory to `cpp` to accommodate Python samples.

Author: dhmnr

.pre-commit-config.yaml

@@ -104,3 +104,13 @@ repos:
             Common/.*
           )
         args: ["-fallback-style=none", "-style=file", "-i"]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      - id: ruff
+        name: ruff lint
+        args: [--fix]
+        files: ^python/.*\.py$
+      - id: ruff-format
+        name: ruff format
+        files: ^python/.*\.py$

CHANGELOG.md

@@ -1,5 +1,9 @@
 ## Changelog
 
+### CUDA 13.2 (update)
+* Added **CUDA Python samples** under `python/`. These scripts use [CUDA Python](https://nvidia.github.io/cuda-python/) (including `cuda.core`) and are organized like the C++ tree: `1_GettingStarted`, `2_CoreConcepts`, `3_FrameworkInterop`, and `4_DistributedComputing`, plus shared helpers in `python/Utilities`. Each sample includes a `README.md` and `requirements.txt`. They are **not** built by the root CMake project; install dependencies with `pip install -r requirements.txt` in the sample directory, then run the corresponding `.py` file as documented in that sample’s README.
+* Renamed top-level `Samples` directory to `cpp` to accommodate Python samples alongside existing C++ samples; updated path references in `CMakeLists.txt`, `README.md`, and `Common` headers accordingly.
+
 ### CUDA 13.2
 * Added the MSVC compile flag `-Xcompiler=/Zc:preprocessor` in CMakeLists.txt to comply with CUDA13.2 CCCL. Previously, using the traditional preprocessor triggered the warning “MSVC/cl.exe with traditional preprocessor is used…”, which now leads to a build error.
 

CMakeLists.txt

@@ -30,4 +30,4 @@ endif()
 # Include installation configuration before processing samples
 include(cmake/InstallSamples.cmake)
 
-add_subdirectory(Samples)
+add_subdirectory(cpp)

Common/helper_nvJPEG.hxx

@@ -400,9 +400,9 @@ int getInputDir(std::string &input_dir, const char *executable_path) {
     std::string pathname = "";
     const char *searchPath[] = {
         "./images",
-        "../../../../Samples/4_CUDA_Libraries/<executable_name>/images",
-        "../../../Samples/4_CUDA_Libraries/<executable_name>/images",
-        "../../Samples/4_CUDA_Libraries/<executable_name>/images"};
+        "../../../../cpp/4_CUDA_Libraries/<executable_name>/images",
+        "../../../cpp/4_CUDA_Libraries/<executable_name>/images",
+        "../../cpp/4_CUDA_Libraries/<executable_name>/images"};
 
     for (unsigned int i = 0; i < sizeof(searchPath) / sizeof(char *); ++i) {
       std::string pathname(searchPath[i]);

Common/helper_string.h

@@ -288,69 +288,69 @@ inline char *sdkFindFilePath(const char *filename,
       "./",                                           // same dir
       "./data/",                                      // same dir
 
-      "../../../../Samples/<executable_name>/",       // up 4 in tree
-      "../../../Samples/<executable_name>/",          // up 3 in tree
-      "../../Samples/<executable_name>/",             // up 2 in tree
+      "../../../../cpp/<executable_name>/",       // up 4 in tree
+      "../../../cpp/<executable_name>/",          // up 3 in tree
+      "../../cpp/<executable_name>/",             // up 2 in tree
 
-      "../../../../Samples/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/0_Introduction/<executable_name>/",  // up 4 in tree
-      "../../../Samples/0_Introduction/<executable_name>/",     // up 3 in tree
-      "../../Samples/0_Introduction/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/0_Introduction/<executable_name>/",  // up 4 in tree
+      "../../../cpp/0_Introduction/<executable_name>/",     // up 3 in tree
+      "../../cpp/0_Introduction/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/1_Utilities/<executable_name>/",  // up 4 in tree
-      "../../../Samples/1_Utilities/<executable_name>/",     // up 3 in tree
-      "../../Samples/1_Utilities/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/1_Utilities/<executable_name>/",  // up 4 in tree
+      "../../../cpp/1_Utilities/<executable_name>/",     // up 3 in tree
+      "../../cpp/1_Utilities/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/2_Concepts_and_Techniques/<executable_name>/",  // up 4 in tree
-      "../../../Samples/2_Concepts_and_Techniques/<executable_name>/",     // up 3 in tree
-      "../../Samples/2_Concepts_and_Techniques/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/2_Concepts_and_Techniques/<executable_name>/",  // up 4 in tree
+      "../../../cpp/2_Concepts_and_Techniques/<executable_name>/",     // up 3 in tree
+      "../../cpp/2_Concepts_and_Techniques/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/3_CUDA_Features/<executable_name>/",  // up 4 in tree
-      "../../../Samples/3_CUDA_Features/<executable_name>/",     // up 3 in tree
-      "../../Samples/3_CUDA_Features/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/3_CUDA_Features/<executable_name>/",  // up 4 in tree
+      "../../../cpp/3_CUDA_Features/<executable_name>/",     // up 3 in tree
+      "../../cpp/3_CUDA_Features/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/4_CUDA_Libraries/<executable_name>/",  // up 4 in tree
-      "../../../Samples/4_CUDA_Libraries/<executable_name>/",     // up 3 in tree
-      "../../Samples/4_CUDA_Libraries/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/4_CUDA_Libraries/<executable_name>/",  // up 4 in tree
+      "../../../cpp/4_CUDA_Libraries/<executable_name>/",     // up 3 in tree
+      "../../cpp/4_CUDA_Libraries/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/5_Domain_Specific/<executable_name>/",  // up 4 in tree
-      "../../../Samples/5_Domain_Specific/<executable_name>/",     // up 3 in tree
-      "../../Samples/5_Domain_Specific/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/5_Domain_Specific/<executable_name>/",  // up 4 in tree
+      "../../../cpp/5_Domain_Specific/<executable_name>/",     // up 3 in tree
+      "../../cpp/5_Domain_Specific/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/6_Performance/<executable_name>/",  // up 4 in tree
-      "../../../Samples/6_Performance/<executable_name>/",     // up 3 in tree
-      "../../Samples/6_Performance/<executable_name>/",        // up 2 in tree
+      "../../../../cpp/6_Performance/<executable_name>/",  // up 4 in tree
+      "../../../cpp/6_Performance/<executable_name>/",     // up 3 in tree
+      "../../cpp/6_Performance/<executable_name>/",        // up 2 in tree
 
-      "../../../../Samples/0_Introduction/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/0_Introduction/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/0_Introduction/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/0_Introduction/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/0_Introduction/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/0_Introduction/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/1_Utilities/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/1_Utilities/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/1_Utilities/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/1_Utilities/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/1_Utilities/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/1_Utilities/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/2_Concepts_and_Techniques/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/2_Concepts_and_Techniques/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/2_Concepts_and_Techniques/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/2_Concepts_and_Techniques/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/2_Concepts_and_Techniques/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/2_Concepts_and_Techniques/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/3_CUDA_Features/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/3_CUDA_Features/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/3_CUDA_Features/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/3_CUDA_Features/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/3_CUDA_Features/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/3_CUDA_Features/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/4_CUDA_Libraries/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/4_CUDA_Libraries/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/4_CUDA_Libraries/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/4_CUDA_Libraries/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/4_CUDA_Libraries/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/4_CUDA_Libraries/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/5_Domain_Specific/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/5_Domain_Specific/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/5_Domain_Specific/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/5_Domain_Specific/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/5_Domain_Specific/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/5_Domain_Specific/<executable_name>/data/",        // up 2 in tree
 
-      "../../../../Samples/6_Performance/<executable_name>/data/",  // up 4 in tree
-      "../../../Samples/6_Performance/<executable_name>/data/",     // up 3 in tree
-      "../../Samples/6_Performance/<executable_name>/data/",        // up 2 in tree
+      "../../../../cpp/6_Performance/<executable_name>/data/",  // up 4 in tree
+      "../../../cpp/6_Performance/<executable_name>/data/",     // up 3 in tree
+      "../../cpp/6_Performance/<executable_name>/data/",        // up 2 in tree
 
       "../../../../Common/data/",                     // up 4 in tree
       "../../../Common/data/",                        // up 3 in tree

README.md

@@ -159,12 +159,12 @@ $ make -j$(nproc) --ignore-errors # or --keep-going
 ```
 
 ```
-# In Samples/5_Domain_Specific/CMakeList.txt
+# In cpp/5_Domain_Specific/CMakeList.txt
 # add_subdirectory(simpleGL)
 # add_subdirectory(simpleVulkan)
 # add_subdirectory(simpleVulkanMMAP)
 
-# In Samples/8_Platform_Specific/Tegra/CMakeList.txt
+# In cpp/8_Platform_Specific/Tegra/CMakeList.txt
 # add_subdirectory(simpleGLES_EGLOutput)
 ```
 
@@ -195,6 +195,30 @@ To build samples with new CUDA Toolkit(CUDA 13.0 or later) and UMD(Version 580 o
 cmake -DCMAKE_PREFIX_PATH=/usr/local/cuda/lib64/stubs/ ..
 ```
 
+## CUDA Python samples
+
+The repository includes **Python** examples under the [`python/`](./python) directory. **These samples are cuda.core–focused:** they use [CUDA Python](https://nvidia.github.io/cuda-python/), with [`cuda.core`](https://nvidia.github.io/cuda-python/cuda-core/latest/) for devices, programs, launches, and memory, alongside NumPy, CuPy, or framework interop where each sample notes.
+
+**Layout (same themes as the C++ samples):**
+
+| Directory | Contents |
+|-----------|----------|
+| `python/1_GettingStarted/` | Introductory scripts (e.g. `vectorAdd`, `deviceQuery`, `systemInfo`, image blur with unified memory, NumPy vs CuPy). |
+| `python/2_CoreConcepts/` | Algorithms and techniques (e.g. reductions, histograms, FFT, stream overlap, `memoryResources`, `cudaGraphs`, `jitLtoLinking`, `tmaTensorMap`). |
+| `python/3_FrameworkInterop/` | Integration with PyTorch and TensorFlow. |
+| `python/4_DistributedComputing/` | Multi-GPU, peer-to-peer, and IPC patterns (`ipcMemoryPool`). |
+| `python/Utilities/` | Shared helpers imported by some samples. |
+
+**How to run:** The top-level CMake build does **not** compile these samples. For each sample, use a Python 3.10+ environment with a matching [CUDA Toolkit](https://developer.nvidia.com/cuda-downloads) (the samples target CUDA 13.x and document exact package pins in `requirements.txt`):
+
+```bash
+cd python/<category>/<sampleName>
+pip install -r requirements.txt
+python <sampleScript>.py
+```
+
+Use each sample’s `README.md` for prerequisites, CLI options, and expected output.
+
 ## Install Samples
 
 ### Installation Path Structure
@@ -272,7 +296,7 @@ the following command line arguments:
 
 | Switch     | Purpose                                                                                                        | Example                 |
 | ---------- | -------------------------------------------------------------------------------------------------------------- | ----------------------- |
-| --dir      | Specify the root directory to search for executables (recursively)                                             | --dir ./build/Samples   |
+| --dir      | Specify the root directory to search for executables (recursively)                                             | --dir ./build/cpp   |
 | --config   | JSON configuration file for executable arguments                                                               | --config test_args.json |
 | --output   | Output directory for test results (stdout saved to .txt files - directory will be created if it doesn't exist) | --output ./test         |
 | --args     | Global arguments to pass to all executables (not currently used)                                               | --args arg_1 arg_2 ...  |
@@ -397,7 +421,7 @@ make -j$(nproc)
 Now, return to the samples root directory and run the test script:
 ```bash
 cd ..
-python3 run_tests.py --output ./test --dir ./build/Samples --config test_args.json
+python3 run_tests.py --output ./test --dir ./build/cpp --config test_args.json
 ```
 
 If all applications run successfully, you will see something similar to this (the specific number of samples will depend on your build type
@@ -425,31 +449,31 @@ incorrectly on your system.
 
 ## Samples list
 
-### [0. Introduction](./Samples/0_Introduction/README.md)
+### [0. Introduction](./cpp/0_Introduction/README.md)
 Basic CUDA samples for beginners that illustrate key concepts with using CUDA and CUDA runtime APIs.
 
-### [1. Utilities](./Samples/1_Utilities/README.md)
+### [1. Utilities](./cpp/1_Utilities/README.md)
 Utility samples that demonstrate how to query device capabilities and measure GPU/CPU bandwidth.
 
-### [2. Concepts and Techniques](./Samples/2_Concepts_and_Techniques/README.md)
+### [2. Concepts and Techniques](./cpp/2_Concepts_and_Techniques/README.md)
 Samples that demonstrate CUDA related concepts and common problem solving techniques.
 
-### [3. CUDA Features](./Samples/3_CUDA_Features/README.md)
+### [3. CUDA Features](./cpp/3_CUDA_Features/README.md)
 Samples that demonstrate CUDA Features (Cooperative Groups, CUDA Dynamic Parallelism, CUDA Graphs etc).
 
-### [4. CUDA Libraries](./Samples/4_CUDA_Libraries/README.md)
+### [4. CUDA Libraries](./cpp/4_CUDA_Libraries/README.md)
 Samples that demonstrate how to use CUDA platform libraries (NPP, NVJPEG, NVGRAPH cuBLAS, cuFFT, cuSPARSE, cuSOLVER and cuRAND).
 
-### [5. Domain Specific](./Samples/5_Domain_Specific/README.md)
+### [5. Domain Specific](./cpp/5_Domain_Specific/README.md)
 Samples that are specific to domain (Graphics, Finance, Image Processing).
 
-### [6. Performance](./Samples/6_Performance/README.md)
+### [6. Performance](./cpp/6_Performance/README.md)
 Samples that demonstrate performance optimization.
 
-### [7. libNVVM](./Samples/7_libNVVM/README.md)
+### [7. libNVVM](./cpp/7_libNVVM/README.md)
 Samples that demonstrate the use of libNVVVM and NVVM IR.
 
-### [8. Platform Specific](./Samples/8_Platform_Specific/Tegra/README.md)
+### [8. Platform Specific](./cpp/8_Platform_Specific/Tegra/README.md)
 Samples that are specific to certain platforms (Tegra, cuDLA, NvMedia, NvSci, OpenGL ES).
 
 ## Dependencies
@@ -514,7 +538,7 @@ To set up GLFW on a Windows system, Download the pre-built binaries from [GLFW w
 
 #### OpenMP
 
-OpenMP is an API for multiprocessing programming. OpenMP can be installed using your Linux distribution's package manager system. It usually comes preinstalled with GCC. It can also be found at the [OpenMP website](http://openmp.org/). For compilers such as clang, `libomp.so` and other components for LLVM must be installed separated. You will also need to set additional flags in your CMake configuration files, such as: `-DOpenMP_CXX_FLAGS="-fopenmp=libomp" -DOpenMP_CXX_LIB_NAMES="omp" -DOpenMP_omp_LIBRARY="/path/to/libomp.so"`.
+OpenMP is an API for multiprocessing programming. OpenMP can be installed using your Linux distribution's package manager system. It usually comes preinstalled with GCC. It can also be found at the [OpenMP website](http://openmp.org/). For compilers such as clang, make sure OpenMP is enabled when building LLVM by including `openmp` in `LLVM_ENABLE_PROJECTS`. If you use clang (from an installed prefix or directly from an LLVM build tree) with OpenMP enabled, set CMAKE_CXX_COMPILER and CMAKE_CUDA_HOST_COMPILER to that clang++ and let CMake detect OpenMP; extra OpenMP_* CMake variables are usually not needed. When using clang++ directly from an LLVM build tree, you may need to copy the generated `omp.h` into the `include/` directory under the path reported by `clang++ --print-resource-dir` before building the samples. When using an installed clang with OpenMP, if you see libomp.so: cannot open shared object file at runtime, add the directory that contains libomp.so to LD_LIBRARY_PATH (or configure it via ld.so.conf.d) so the dynamic linker can locate the OpenMP runtime.
 
 #### Screen