OpenCLLink Setup

This section is concerned with the way that OpenCLLink is set up and configured for your machine. It will also help to track down and correct problems.

Setup and Testing

OpenCLLink is designed to work automatically after the Wolfram System is installed with no special configuration. You can test this by using the OpenCLQ function.

This loads the OpenCLLink application.

In[1]:=
Click for copyable input

This checks if OpenCLLink is supported. If it returns True, as shown below, then OpenCLLink will work.

In[2]:=
Click for copyable input
Out[2]=

If OpenCLQ does not return True, then OpenCLLink will not work. However, you might be able to configure your machine to fix this.

There are five main reasons for getting False from OpenCLQ:

Mac OS X

Apple Mac OS X Snow Leopard (10.6) includes OpenCL support as part of the operating system. OS X versions earlier than Snow Leopard are not supported.

NVIDIA

In general, if CUDALink works then OpenCLLink should work. "CUDALink Setup" tells you how to test CUDALink and make it operational; this should be sufficient to resolve problems with OpenCLLink.

AMD/ATI

An OpenCL-capable video card (see next section) is required to use OpenCLLink. The AMD Catalyst driver is required as well. Some video cards have the AMD Catalyst Accelerated Parallel Processing (APP) driver; in those cases, the driver is sufficient. If the APP driver is not supported, then the ATI Stream SDK is required to use OpenCLLink.

The AMD Catalyst driver can be downloaded from the AMD/ATI Driver website while the ATI Stream SDK can be downloaded from the AMD/ATI Stream website.

Supported AMD/ATI Video Hardware

The following AMD/ATI video hardware is supported by OpenCLLink:

Environment

On Mac OS X, OpenCLQ checks if OS X 10.6 (Snow Leopard) is installed. It would fail if not detected, since previous versions are not supported. On NVIDIA hardware, OpenCLQ follows the same methods of detection as CUDAQ in CUDALink; refer to "CUDALink Setup" for more information.

ATISTREAMSDKROOT

This section will only be applicable for systems with AMD/ATI GPU or a CPU used along with the AMD/ATI Stream SDK.

On both Linux and Windows, the ATISTREAMSDKROOT environment variable is used to determine the path to the AMD/ATI Stream SDK. If not detected, then the following paths are checked:

"Windows""C:\\Program Files\\ATI Stream"
"Windows-x86-64""C:\\Program Files (x86)\\ATI Stream"
"Linux"$Failed
"Linux-x86-64"$Failed

Default path to the AMD/ATI Stream SDK in case ATISTREAMSDKROOT is not defined.

The variable can be checked in the Wolfram Language using the following.

In[1]:=
Click for copyable input
Out[1]=

After detection, the result is stored in GPUTools`Internal`$ATISTREAMSDKROOT.

Error Messages

The error messages returned by OpenCLInformation are the same as CUDAInformation; refer to CUDALink detection failure error codes.

Related Tutorials