GPU CUDA and MEX Programming

Further accelerate your code using advanced GPU CUDA and MEX programming

Functions

Key Functions and Classes

`mexcuda`	Compile MEX functions or PTX files for GPU computation
`CUDAKernel`	Kernel executable on GPU
`feval`	Evaluate kernel on GPU
`setConstantMemory`	Set some constant memory on GPU

C Functions and Classes

`mxGPUArray`	Type for MATLAB gpuArray
`mxGPUCopyFromMxArray`	Copy mxArray to mxGPUArray
`mxGPUCopyGPUArray`	Duplicate (deep copy) mxGPUArray object
`mxGPUCopyImag`	Copy imaginary part of mxGPUArray
`mxGPUCopyReal`	Copy real part of mxGPUArray
`mxGPUCreateComplexGPUArray`	Create complex GPU array from two real gpuArrays
`mxGPUCreateFromMxArray`	Create read-only mxGPUArray object from input mxArray
`mxGPUCreateGPUArray`	Create mxGPUArray object, allocating memory on GPU
`mxGPUCreateMxArrayOnCPU`	Create mxArray for returning CPU data to MATLAB with data from GPU
`mxGPUCreateMxArrayOnGPU`	Create mxArray for returning GPU data to MATLAB
`mxGPUDestroyGPUArray`	Delete mxGPUArray object
`mxGPUGetClassID`	mxClassID associated with data on GPU
`mxGPUGetComplexity`	Complexity of data on GPU
`mxGPUGetData`	Raw pointer to underlying data
`mxGPUGetDataReadOnly`	Read-only raw pointer to underlying data
`mxGPUGetDimensions`	mxGPUArray dimensions
`mxGPUGetNumberOfDimensions`	Size of dimension array for mxGPUArray
`mxGPUGetNumberOfElements`	Number of elements on GPU for array
`mxGPUIsSame`	Determine if two mxGPUArrays refer to same GPU data
`mxGPUIsSparse`	Determine if mxGPUArray contains sparse GPU data
`mxGPUIsValidGPUData`	Determine if mxArray is pointer to valid GPU data
`mxGPUSetDimensions`	Modify number of dimensions and size of each dimension
`mxIsGPUArray`	Determine if mxArray contains GPU data
`mxInitGPU`	Initialize MATLAB GPU library on currently selected device

Topics

Run CUDA or PTX Code on GPU
This page explains how to create an executable kernel from a CUDA^® C++ source file (CU) file and run that kernel on a GPU in MATLAB^®.
Run MEX-Functions Containing CUDA Code
As with any MEX-files, those containing CUDA code have a single entry point, known as mexFunction.

Featured Examples

Accessing Advanced CUDA Features Using MEX

How advanced features of the GPU can be accessed using MEX files. It builds on the example Stencil Operations on a GPU. The previous example uses Conway's "Game of Life" to demonstrate how stencil operations can be performed using MATLAB® code that runs on a GPU. The present example demonstrates how you can further improve the performance of stencil operations using an advanced feature of the GPU: shared memory. You do this by writing your own CUDA code in a MEX file and calling the MEX file from MATLAB. You can find an introduction to the use of the GPU in MEX files in Run MEX-Functions Containing CUDA Code.

Open Live Script