CUDALink allows the Wolfram Language to use the CUDA parallel computing architecture on Graphical Processing Units (GPUs). It contains functions that use CUDA-enabled GPUs to boost performance in a number of areas, such as linear algebra, financial simulation, and image processing. CUDALink also integrates CUDA with existing Wolfram Language development tools, allowing a high degree of automation and control.
This section summarizes the functionality.
Wolfram Language Functions
This describes the Wolfram Language functions provided by CUDALink.
CUDAInformation gives user information on the hardware. To use, first load the CUDALink application.
This gets information on the CUDA devices on the system.
Similar to other Wolfram Language Q functions, CUDAQ will not return an error on failure. Running CUDAInformation will give an error describing why CUDA failed.
If CUDALink fails, it will return one of the following errors.
CUDALink is not supported on the system; only "Linux", "Linux-x86-64", "Windows", "Windows-x86-64", "MacOSX-x86", and "MacOSX-x86-64" are supported
based on the video card name, the video card is not supported by CUDALink
an NVIDIA driver library was not found, and CUDALink was not able to determine the NVIDIA driver library path
an NVIDIA driver was not found in the NVIDIA library path
an NVIDIA driver was found, but the version information cannot be determined
an NVIDIA driver was found, but the version is unsupported
an NVIDIA driver was found, but the version directory cannot be determined
loading the CUDA runtime libraries failed
loading the CUDALink library failed
CUDALink libraries were loaded, but initialization failed
CUDALink was unable to find a device that is CUDA compatible
CUDALink detection failure error codes.
There are three main reasons for getting False from CUDAQ:
Unsupported operating system — CUDA is not supported on SUN's Solaris or versions of Apple's OS X earlier than 10.6.3.
Unsupported hardware — CUDA only works on CUDA-capable graphics cards.
Incompatible graphics driver — a recent NVIDIA driver is needed for CUDA to operate properly.
CUDALink requires a compatible operating system, hardware, and driver software. This section describes what these are and how to confirm them.
CUDALink is supported on Linux, Linux-x86-64, Windows, Windows-x86-64, Mac OS X-x86, and Mac OS X-x86-64. Mac OS X users need at least Mac OS X 10.6.3.
On Linux, CUDALink requires the system to be run in a runlevel that will load the video drivers. Usually this is default level 5, but on some servers the administrator may need to configure it manually.
CUDALink is supported on all hardware that has CUDA support. If you are not sure of the name of your graphics card, you can see the section on Graphics Card Information.
Users with ATI or Intel graphics processors will not be able to use CUDA, but might be able to use OpenCL using OpenCLLink.
Graphics Card Information
Detailed information on your graphics can be found in the "Devices" section of SystemInformation, as shown below.
This gives information on the graphics card installed on the system.
If you have trouble finding this, then checking the graphics card is done by either checking the system documentation or going to one of the following:
Device Manager on Windows
System Information on Mac OS X
Invoking lspci on Linux
Checking the NVIDIA Driver
CUDALink has a driver version detection mechanism that is accessible using CUDADriverVersion.
An alternative to this driver detection method is operating-system specific. The following details how to get the driver version on Windows, Linux, and Mac OS X.
If the NVIDIA driver is installed, then the NVIDIA control panel should be in the system's control panel and will give you information. The NVIDIA control panel can be accessed by clicking Start ▶ Control Panel.
Inside the control panel you will see the NVIDIA control panel.
Clicking on that will open windows that allow you to edit the hardware setup.
Clicking System Information in the bottom-left corner will give you the following window.
This tells you the driver version, which is 257.21 on this machine.
If the NVIDIA driver is installed, then running nvidia-settings from the command line will give version information. The following screen capture shows the system running the 256.53 version of the NVIDIA driver, which can be seen in the "NVIDIA Driver Version" system information.
If X is not available, then the following command will tell you the driver version installed.
[abduld@abduldlx ~]$ ls /usr/lib/libnvidia-tls.so.* /usr/lib/libnvidia-tls.so.2 /usr/lib/libnvidia-tls.so.256.53.15
The above tells you a non-supported NVIDIA driver 256.53.15 is installed on abduldlx. Note that on some versions of Linux the drivers are installed in /usr/lib64 or in another nondefault location.
Mac OS X
To find the version information on OS X, open the Finder window and go into Applications.
Opening System Preferences will show a CUDA button if the CUDA driver is installed.
Clicking on the CUDA button will show both the CUDA driver and GPU driver versions.
CUDA driver version 6.0.0 or above is required by CUDALink.