Add online CUDA lookup and GPU/cuCollections benchmark scaffolding

examples/cpp-console-cuco-static-map-bench/CMakeLists.txt

@@ -0,0 +1,56 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(cpp-console-cuco-static-map-bench LANGUAGES CXX CUDA)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_CUDA_STANDARD 17)
+set(CMAKE_CUDA_STANDARD_REQUIRED ON)
+set(CMAKE_CUDA_EXTENSIONS OFF)
+
+set(
+    CUCO_ROOT
+    ""
+    CACHE PATH
+    "Path to a local cuCollections checkout."
+)
+
+find_package(CUDAToolkit REQUIRED)
+
+find_path(
+    CUCO_INCLUDE_DIR
+    NAMES cuco/static_map.cuh
+    HINTS ${CUCO_ROOT}
+    PATH_SUFFIXES include
+    REQUIRED
+)
+
+add_executable(cpp-console-cuco-static-map-bench
+    src/main.cu
+)
+
+target_include_directories(
+    cpp-console-cuco-static-map-bench
+    PRIVATE
+        "${CUCO_INCLUDE_DIR}"
+)
+
+target_link_libraries(
+    cpp-console-cuco-static-map-bench
+    PRIVATE
+        CUDA::cudart
+)
+
+target_compile_options(
+    cpp-console-cuco-static-map-bench
+    PRIVATE
+        $<$<COMPILE_LANGUAGE:CUDA>:--expt-extended-lambda>
+)
+
+if(APPLE OR UNIX)
+    set_property(
+        TARGET cpp-console-cuco-static-map-bench
+        PROPERTY BUILD_RPATH "$<TARGET_FILE_DIR:CUDA::cudart>"
+    )
+endif()

examples/cpp-console-cuco-static-map-bench/README.md

@@ -0,0 +1,44 @@
+# cpp-console-cuco-static-map-bench
+
+Standalone `cuCollections` baseline for the same raw `uint64_t` `.keys` domains
+used by the PerfectHash GPU experiments.
+
+This benchmark:
+
+1. loads a `.keys` file as `uint64_t` keys,
+2. builds a `cuco::static_map<uint64_t, uint32_t>` mapping `key -> ordinal`,
+3. runs `find_async()` over the same key stream,
+4. reports build and lookup timings, including normalized `ns/key`.
+
+This is the closest simple `cuCollections` baseline to the current PerfectHash
+GPU key-to-index lookup path.
+
+## Build
+
+```bash
+cmake -S examples/cpp-console-cuco-static-map-bench \
+      -B build/examples/cpp-console-cuco-static-map-bench \
+      -DCUCO_ROOT=/path/to/cucollections
+
+cmake --build build/examples/cpp-console-cuco-static-map-bench -j
+```
+
+## Run
+
+```bash
+./build/examples/cpp-console-cuco-static-map-bench/cpp-console-cuco-static-map-bench \
+  --keys-file /mnt/data/tpch/scale-10/perfecthash-keys/c_custkey_q03_ph-64.keys \
+  --load-factor 0.5
+```
+
+Optional arguments:
+
+- `--keys-file <path>`
+- `--max-keys <N>`
+- `--load-factor <f>`
+- `--device <ordinal>`
+- `--warmup <N>`
+- `--iterations <N>`
+- `--csv`
+- `--csv-header`
+- `--no-verify`