NEWS

---

nmathopencl 0.8.1

CRAN check fixes (OpenCL-enabled builders)

• OpenCL GPU testthat tests are skipped during CRAN R CMD check (skip_on_cran() via tests/testthat/helper-opencl.R) when the package is compiled with OpenCL (USE_OPENCL / nmathopencl_has_opencl() is TRUE).
• dbeta_opencl example: CPU fallback on CRAN no longer calls stats::dnbeta() (not exported from namespace:stats).
• NEWS.md: version section titles only (CRAN news parser).
• DESCRIPTION: 'opencltools' single-quoted in Description.

nmathopencl 0.8.0

Initial CRAN release

First public release of nmathopencl as a developer library for GPU-accelerated statistical computing in R.

• OpenCL-ported Mathlib — R internal nmath routines shipped as .cl sources under inst/cl/nmath/ (densities, distributions, quantiles, and random variates), plus supporting R_ext shims, for inclusion in custom OpenCL kernels.
• Packaged *_opencl API — exported R wrappers mirroring stats families (normal, gamma, binomial, Poisson, beta, and many others) that dispatch to GPU kernels when OpenCL is available at compile time and fall back to CPU otherwise.
• C-callable GPU API — inst/include/nmathopencl/nmathopencl_capi.h registers 133 *_opencl routines for R_GetCCallable / downstream C++ packages (LinkingTo: nmathopencl).
• Package-local OpenCL probes — nmathopencl_has_opencl(), nmathopencl_opencl_device_info(), nmathopencl_opencl_fp64_available(), and nmathopencl_opencl_reset_device_selection() for this package's compile-time build and fp64 device cache (distinct from opencltools).
• opencltools integration — kernel assembly via opencltools::load_kernel_*(..., package = "nmathopencl"); re-exported subset loaders and configure helpers (load_library_for_kernel, dependency tagging, use_opencl_configure, …).
• Worked GLM envelope example — Ex_EnvelopeEval and related Ex_* exports demonstrate building a custom kernel on top of the ported nmath library (pedagogical sandbox; see vignette Chapter 10).
• Developer documentation — vignette series (OpenCL setup, kernel authoring, linkage patterns, packaged API reference) and examples under inst/examples/.

Host and workstation diagnostics (opencltools::diagnose_glmbayes(), detect_environment_and_gpus(), PATH helpers, etc.) are provided by the opencltools dependency.

nmathopencl 0.2.0

diagnose_glmbayes() removed from exports

• Use opencltools::diagnose_glmbayes() for host/runtime diagnostic reports.

Package-specific OpenCL diagnostics renamed

• has_opencl() → nmathopencl_has_opencl(); opencl_device_info() → nmathopencl_opencl_device_info(); opencl_fp64_available() → nmathopencl_opencl_fp64_available(); opencl_reset_device_selection() → nmathopencl_opencl_reset_device_selection() (distinct from opencltools).

get_opencl_core_count() removed from exports

• No longer exported from nmathopencl; use opencltools::get_opencl_core_count(). C++ code in this package still calls opencltools_get_opencl_core_count() via openclPort::get_opencl_core_count() where needed (e.g. envelope sizing).

Package-specific fp64 device selection

• nmathopencl_opencl_fp64_available(), nmathopencl_opencl_reset_device_selection(), and the device cache used by nmathopencl_opencl_device_info() now use nmathopencl's local probe in opencl_device_selection.cpp (not opencltools/opencltools_capi.h). Kernel loading and core-count helpers still use the opencltools C API from kernel_loader.cpp. Results follow nmathopencl::nmathopencl_has_opencl() and this package's GPU runtime, not the opencltools build flag.

Kernel loaders (opencltools only)

• Removed exported load_kernel_source() and load_kernel_library() from nmathopencl; use opencltools::load_kernel_*(..., package = "nmathopencl"). load_library_for_kernel remains re-exported from opencltools.

C-callable API for downstream packages

• New inst/include/nmathopencl/nmathopencl_capi.h: R_GetCCallable wrappers for 133 GPU *_opencl routines (SEXP ABI), plus nmathopencl_api_version() and nmathopencl_has_opencl().
• New src/nmathopencl_ccallables.cpp: extern "C" implementations and register_nmathopencl_ccallables_cpp_export() (called from .onLoad).
• Regenerate with Rscript tools/generate_nmathopencl_capi.R after changing export_wrappers.cpp signatures.
• See inst/include/nmathopencl/README.md for Imports / LinkingTo usage.

CRAN DESCRIPTION

• Single-quote 'OpenCL' and 'Mathlib' in Title, Description, SystemRequirements, and Authors@R comments (incoming spell-check NOTE).

Citation and copyright metadata

• inst/CITATION and inst/COPYRIGHTS now describe nmathopencl (replacing leftover glmbayes text from the package split).
• ?nmathopencl-package: repository links and vignette pointers updated for this package (not glmbayes).
• inst/CITATION / inst/REFERENCES.bib: add Stone et al. (2010) for OpenCL; co-author remains Lan M. Nygren (not Lance).

Examples (inst/examples/Ex_*_opencl.R)

• Ported stats/Math *_opencl examples call OpenCL when CPU-only or NOT_CRAN=true; otherwise use stats:: during R CMD check on OpenCL builds (avoids repeated clBuildProgram during examples).

OpenCL C-callable bridge (opencltools)

• load_kernel_source(), load_kernel_library(), and C++ load_library_for_kernel() now delegate to opencltools C-callables (opencltools_load_kernel_*); redundant loader implementation removed from src/kernel_loader.cpp. Reading .cl text no longer requires nmathopencl_has_opencl() guards (aligned with opencltools).
• Kernel loaders delegate to the opencltools C API. Local fp64 device cache remains for kernel runners until opencl_bind_selected_fp64_device_or_throw migrates.
• use_opencl_configure() and port_to_opencl_configure() are thin re-exports from opencltools; configure templates live in opencltools/inst/configure-templates/.
• Tier 3 host/runtime diagnostics (detect_*, verify_opencl_runtime, gpu_names, add_to_path_*, etc.) are no longer re-exported from nmathopencl; use opencltools directly (including opencltools::diagnose_glmbayes()). nmathopencl keeps nmathopencl_has_opencl() and package-local device-selection helpers.

nmathopencl 0.1.0

Documentation and distribution

• DESCRIPTION: Title and Description now describe OpenCL-ported Mathlib (were previously pasted from another package template).
• README: R-universe dashboard link and install snippets; status badge for https://knygren.r-universe.dev.
• R-UNIVERSE.md: maintainer checklist for R-universe registration and automated builds (configure / OpenCL notes).
• Suggests: package glmbayes (>= 0.9.3) (CRAN) for vignettes and GPU examples that reference envelopes / GLM acceleration.