NEWS

OpenCL 0.2-11

Do not issue kernel compiler warning if the build log string consists solely of whitespaces. (#21)

OpenCL 0.2-10 (2023-12-22)

Adjust header declaration for ocl_get_device_info_entry.
Windows: for single-arch R fall back to $OCL/lib/OpenCL.lib if present.

OpenCL 0.2-9 (2023-11-30)

Clean up superfluous class comparisons.

OpenCL 0.2-8

Change the name of the package dynamic object to R_OpenCL to avoid name conflict on Windows. (#6, #20, thanks to Aaron Puchert)

OpenCL 0.2-7

Windows: accept OCLLIB instead of OCL64LIB for single-arch R. Update INSTALL documentation to be more specific about the defaults and installation (#17).
added (non-exported) .oclDeviceInfoEntry() for diagnostics which allows the retrieval of any device information entries.
added support for dynamic __local memory buffers as arguments to kernel via the clLocal() function -- see documentation for details. (#18)

OpenCL 0.2-6

Update oclRun() example to explicitly cast in order to avoid ambiguity errors in built-ins on macOS.

OpenCL 0.2-5

Use correct error()/warning() for build logs in compiled programs. Output from the OpenCL compilation is now included in the error/warning. (#13)
Use more verbose, textual representation of OpenCL errors.

OpenCL 0.2-4

Added full support for subsetting and subassignment for clBuffers. Note that only contiguous operations (e.g. x[5:8] = 0) can be performed natively, any other index will result in the entire buffer being emerged and the operation done in R (CPU).
Added mode= parameter to as.clBuffer() to ensure specific type of the buffer. This is ofen required when passing buffers to kernel since the kernel code must match teh buffer type.
Improved oclRun() example to explicitly use numeric buffer for reasons explained above. Previously, passing integer input would result in integer buffer which does not match the kernel code. (#10)

OpenCL 0.2-3

added buffer memory tracking and automatic garbage collection triggers. See oclMemLimits() help for details. (#8)

OpenCL 0.2-2 (2021-07-24)

added native symbol registration
fix issue with R API in R-devel

OpenCL 0.2-1 (2020-03-09)

OpenCL context and command queue can be persisted, allowing to keep data between calls. The context also remembers whether to default to single- or double-precision for numeric vectors.
Data can stay on the OpenCL device (GPU) between kernel calls. This is extremely valuable when working with discrete GPUs connected over a relatively slow PCIe connection.
A single-precision data type is no longer required. The conversion takes place when transferring the data to the OpenCL device. On the R side, data remains in numeric vectors.
Kernels are executed asynchronously and possibly out-of-order, if the OpenCL implementation allows it. Synchronization need not to be done manually and happens without the user knowing: OpenCL events corresponding to a kernel execution are attached to the output buffer. Following kernel executions having the buffer as input then wait for the event, hence for the preceding kernel execution to finish. Likewise, reads from buffers wait on the attached event as well.
OpenCL device information is amended by maximum frequency. Also the list of extensions is broken down to make it easier searchable.
By default, we choose GPU devices. CPU devices usually don't make a lot of sense. Also, if there are multiple GPU devices available - think of a notebook with integrated and discrete GPU - we try to choose the faster device.
There are now several tests covering most of the functionality.
Windows configuration has been simplified. On Windows, you have to set the OCL environemnt variable to the root of the OpenCL SDK. By default the CPPFLAGS and LIBS will be constrcuted from that location depending on whether 32-bit or 64-bit binaries are produced by appending lib/x64/OpenCL.lib or lib/x86/OpenCL.lib respecitvely. Includes are assumed to be in the includes directory. All of the above can be overridden by setting OCLINC to the necessary pre-processor flags and OCL32LIB or OCL64LIB for 32-bit and 64-bit linker flags. (Note that OCL must still be set even if you override all flags)

OpenCL 0.1-4

devices with very long extensions strings could cause error on retrieval. Fixed with larger static buffer. (Thanks to Valerio Aimale again)
Improve error reporting by always including the OpenCL error code

OpenCL 0.1-3 (2012-05-26)

fix a bug causing device enumeration to use the default device for device count regradless of the specified type. This affects only systems with more than one type of device. (Thanks to Valerio Aimale for reporting)
added dim argument to oclRun() which allows multidimensional indexing (up to 3d) in the kernel. The dimensions can be obtained in the kernel via get_global_size() and the index values with get_global_id(). Note that using index vectors instead of multidimensional indexing may perform better depending on the device. The default is to use single dimension (dim=size) which is the same as previous versions of OpenCL.
add precision="best" in oclSimpleKernel which switches automatically to double-precision if supported by the device
kernels objects are now less cryptic - they implement print(), names() and $ methods for access to their attributes.

OpenCL 0.1-2 (2012-03-08)

add the support for asynchronous calls, i.e., execution parallel to the CPU or multiple parallel GPU operations. This is done by using x <- oclRun(..., wait=FALSE) to dispatch the kernel and then oclResult(x) to collect the results later.
minor cleanup

OpenCL 0.1-1 (2011-08-10)

improve memory management and clean up on error in oclRun()
use CL_MEM_USE_HOST_PTR instead of clEnqueueWriteBuffer() for better performance on large input vectors
add support for native single precision representation (see ?clFloat and native.result argument in oclRun())
added INSTALL file with links to common OpenCL implementations

OpenCL 0.1-0 (2011-08-08)

first public release includes support for single and double precision computations as well as simple kernels (one output vector, arbitrary input)