# CUDA Functions
This feature is not supported on the Wolfram Cloud.

*CUDALink* is a built-in Wolfram Language package that provides a simple and powerful interface for using CUDA within the Wolfram Language's streamlined work flow.

*CUDALink* provides you with carefully tuned linear algebra, discrete Fourier transforms, and image processing algorithms. You can also write your own *CUDALink* modules with minimal effort. Using *CUDALink* from within the Wolfram Language gives you access to the Wolfram Language's features, including visualization, import/export, and programming capabilities.

In this section, the built-in *CUDALink* functions are discussed, and a handful of applications are also given.

## List Processing

*CUDALink* list processing functions are designed to mimic the existing Wolfram Language functions, and, while less general than the Wolfram Language's implementation, they do provide the most commonly used functions. *CUDALink* implements the following list processing functions.

CUDAMap | map a function to each element of an input list |

CUDAFold | given an initial value and a function , this returns |

CUDAFoldList | given an initial value and a function , this returns |

CUDASort | sort a given list |

CUDATotal | find the total value of a given list |

*CUDALink*'s list processing functions.

The above functions can be used as any Wolfram Language functions. To use the functions above, first load the *CUDALink* application.

In[1]:= |

Once loaded, the above functions can be used. This maps the function Cos to a random list.

In[2]:= |

Out[2]= |

Computation can be strung together. Here you can find the total of the above list using CUDAFold (called reduction in the GPU programming field).

In[3]:= |

Out[3]= |

### Applications

In many cases, the above list operators are pivotal to many algorithms. Here, a few are discussed.

#### Line of Sight

Given a height map, the line of sight problem finds all points on the height map visible from a single point. It does so by first transforming the height map to an angular map, and then performing a Max fold on the angular map. The results from the list can then be easily used to determine if a point is visible or not.

This generates a sample height map.

In[4]:= |

Out[4]= |

This computes the angular map. Here you use the first point in the height map as a reference angle.

In[5]:= |

Out[5]= |

The list is computed using CUDAFoldList.

In[6]:= |

Out[6]= |

An angular is marked as visible if .

In[7]:= |

Out[7]= |

This displays all points visible from the reference point.

In[8]:= |

Out[8]= |

#### Random Walk

Random walk is a common tool used in many applications, such as the analysis of Brownian motion in physics. This shows a random walk in one dimension using CUDAFoldList.

In[9]:= |

Out[9]= |

Choosing discrete random numbers, the walk can be performed on a lattice.

In[10]:= |

Out[10]= |

#### Histogram

Histograms are commonly used in many applications to place elements in bins. Here, you can use CUDASort to simplify the histogram calculation. This sorts the input image.

In[11]:= |

Once sorted, given a value to count the number of its occurrences, you need to scan the sorted list until its value changes. To find the first element, you have to count the number of elements until the element is not equal to the first.

In[12]:= |

Out[13]= |

This resulting histogram is plotted using ListLinePlot.

In[14]:= |

Out[14]= |

#### Dot Product

This finds the dot product of two vectors.

In[15]:= |

Out[15]= |

## Image Processing

The *CUDALink* Image Processing module can be classified into three categories. The first is convolution, which is optimized for CUDA. The second is morphology, which contains abilities such as erosion, dilation, opening, and closing. Finally, there are the binary operators. These are the image multiplication, division, subtraction, and addition operators. All operations work on either images or lists.

CUDAImageConvolve | convolve the kernel with the specified kernel |

CUDABoxFilter | convolve the kernel with the BoxMatrix kernel |

CUDAErosion | perform morphological erosion |

CUDADilation | perform morphological dilation |

CUDAOpening | perform morphological opening |

CUDAClosing | perform morphological closing |

CUDAClamp | clamp the values between a range |

CUDAColorNegate | invert the values of input |

CUDAImageAdd | add two inputs |

CUDAImageSubtract | subtract two inputs |

CUDAImageMultiply | multiply two inputs |

CUDAImageDivide | divide two inputs |

*CUDALink* Image Base Operations.

To use any of these functions (and if not already done), include the *CUDALink* application.

In[1]:= |

*CUDALink*'s image processing functions, like the Wolfram Language's, accept images as input. Here you can find the gradient of an input image.

In[2]:= |

Out[2]= |

Since the CUDA image processing functions behave like Wolfram Language functions, you can combine them with existing Wolfram Language functions. Here, you can apply CUDAImageMultiply to all combinations of a set of images.

In[3]:= |

Out[3]= |

The CUDA image processing functions work with the Wolfram Language's dynamic evaluators, such as Manipulate, Dynamic, and Animate. Here, you can use Animate to create an animation of how an image behaves as it is convolved with different GaussianMatrix radius sizes.

In[4]:= |

Out[4]= |

### Applications

#### Creating New Image Processing Operators

*CUDALink*'s image processing operators are building blocks to more complicated operators. Here, you can define the operator, which is similar to the Darker operator in the Wolfram Language.

In[5]:= |

The function can then be used.

In[6]:= |

Out[6]= |

#### Input Smoothing

Many algorithms require the input to be smoothed before processing. This defines a random input list.

In[7]:= |

This plots the results, showing the input to be very noisy.

In[8]:= |

Out[8]= |

You can use the fact that the image processing functions also operate on lists to smooth out the input list.

In[9]:= |

Out[9]= |

#### Geographical Data Processing

Since all image processing functions are also list processing functions, you can process any data that can be represented by a Wolfram Language list. In this example, you can use CUDAClamp to process geographic elevation data by clamping values in the elevation map.

This loads the data from the Wolfram servers.

In[10]:= |

This creates an interface that allows the user to vary the clamp parameters.

In[11]:= |

Out[11]= |

#### Acquired Image Processing

The following example requires a web camera. CurrentImage returns an error if no camera is detected.

In[12]:= |

Out[12]= |

This creates an interface where the user can process input images from the web camera in real time.

In[13]:= |

Out[13]= |

## Linear Algebra and Fourier Transforms

CUDADot | give product of vectors and matrices |

CUDATranspose | tranpose input matrix |

CUDAArgMaxList | give the index with maximum absolute element |

CUDAArgMinList | give the index with minimum absolute element |

CUDAFourier | find the Fourier transform |

CUDAInverseFourier | find the inverse Fourier transform |

Linear algebra and Fourier transform operations using CUDA.

If not done so already, import the *CUDALink* application.

In[1]:= |

This multiplies two integer matrices together.

In[2]:= |

Out[2]= |

This shows the result in MatrixForm.

In[3]:= |

Out[3]//MatrixForm= | |

### Applications

Linear algebra and Fourier analysis have many applications that are beyond the scope of this tutorial. Here are two simple examples of the kind of operations made possible by these *CUDALink* features.

#### Spectrum

This loads the two-dimensional dataset.

In[4]:= |

Find the logarithmic power spectrum.

In[5]:= |

Out[5]= |

#### Image Transformation

This transposes an input image.

In[6]:= |

Out[6]= |

## Examples

Along with these useful functions, *CUDALink* bundles many examples that showcase the capabilities of programming with *CUDALink*. The source of these examples is bundled with the Wolfram System.

CUDAFluidDynamics | compute and render a fluid dynamics simulation |

CUDAVolumetricRender | render volumetric data |

Example applications of *CUDALink*.

### Fluid Dynamics

This approximates the solution of the Navier–Stokes equations on a torus.

In[7]:= |

Out[7]= |

### Volumetric Render

In[8]:= |

This renders the data by ray tracing the voxels.

In[9]:= |

Out[9]= |