Use the processor-in-the-loop (PIL) execution to check the numerical behavior of the CUDA® code that you generate from MATLAB® functions. A PIL simulation, which requires target connectivity, compiles generated source code, and then downloads and runs object code on NVIDIA® GPU platforms. The results of the PIL simulation are transferred to MATLAB to verify the numerical equivalence of the simulation and the code generation results.
The PIL verification process is a crucial part of the design cycle to check that the behavior of the generated code matches the design. PIL verification requires an Embedded Coder® license.
When using PIL execution, make sure that the
Benchmarking option in
GPU Coder™ settings is
false. Executing PIL with benchmarking results
in compilation errors.
NVIDIA DRIVE or Jetson embedded platform.
Ethernet crossover cable to connect the target board and host PC (if the target board cannot be connected to a local network).
NVIDIA CUDA toolkit installed on the board.
Environment variables on the target for the compilers and libraries. For information on the supported versions of the compilers and libraries and their setup, see Install and Setup Prerequisites for NVIDIA Boards.
GPU Coder for CUDA code generation. For help on getting started with GPU Coder, see Get Started with GPU Coder.
NVIDIA CUDA toolkit on the host.
Environment variables on the host for the compilers and libraries. For information on the supported versions of the compilers and libraries, see Third-Party Hardware. For setting up the environment variables, see Environment Variables.
You do not have to be familiar with the algorithm in the example to complete the tutorial.
The Mandelbrot set is the region in the complex plane consisting of the values z0 for which the trajectories defined by
remain bounded at k→∞. The overall geometry of the Mandelbrot set is shown in the figure. This view does not have the resolution to show the richly detailed structure of the fringe just outside the boundary of the set. At increasing magnifications, the Mandelbrot set exhibits an elaborate boundary that reveals progressively finer recursive detail.
Create a MATLAB script called
mandelbrot_count.m with the following lines
of code. This code is a baseline vectorized MATLAB implementation of the Mandelbrot
function count = mandelbrot_count(maxIterations, xGrid, yGrid) %#codegen % mandelbrot computation z0 = xGrid + 1i*yGrid; count = ones(size(z0)); % Add Kernelfun pragma to trigger kernel creation coder.gpu.kernelfun; z = z0; for n = 0:maxIterations z = z.*z + z0; inside = abs(z)<=2; count = count + inside; end count = log(count);
For this tutorial, pick a set of limits that specify a highly zoomed part of the
Mandelbrot set in the valley between the main cardioid and the p/q bulb
to its left. A 1000x1000 grid of real parts (x) and imaginary parts
(y) is created between these two limits. The Mandelbrot algorithm is
then iterated at each grid location. An iteration number of 500 is enough to render the
image in full resolution. Create a MATLAB script called
mandelbrot_test.m with the following lines
of code. It also calls the
mandelbrot_count function and plots the
resulting Mandelbrot set.
maxIterations = 500; gridSize = 1000; xlim = [-0.748766713922161, -0.748766707771757]; ylim = [ 0.123640844894862, 0.123640851045266]; x = linspace( xlim(1), xlim(2), gridSize ); y = linspace( ylim(1), ylim(2), gridSize ); [xGrid,yGrid] = meshgrid( x, y ); count = mandelbrot_count(maxIterations, xGrid, yGrid); figure(1) imagesc( x, y, count ); colormap([jet();flipud( jet() );0 0 0]); axis off title('Mandelbrot set');
To open the GPU Coder app, on the MATLAB toolstrip, in the Apps tab, under Code
Generation, click the GPU Coder app icon. You can also open the app by typing
the MATLAB Command Window.
The app opens the Select source files page. Select
mandelbrot_count.m as the entry-point function. Click
In the Define Input Types window, enter
mandelbrot_count(500,zeros(1000),zeros(1000)) and click
Autodefine Input Types, then click
You can initiate the Check for Run-Time Issues process or click Next to go to the Generate Code step.
Set the Build type to
and the Hardware Board to
Under the Hardware panel, enter the device address, user name, password, and build folder for the board.
Close the Settings window and click
Generate. The software generates CUDA code for the
mandelbrot_count entry point
Click Verify Code.
In the command field, specify the test file that calls the original MATLAB functions. For example,
To start the PIL execution, click Run Generated Code.
The GPU Coder app:
Generates a standalone library, for example,
Generates PIL interface code, for example,
Runs the test file, replacing calls to the MATLAB function with calls to the generated code in the library.
Displays messages from the PIL execution in the Test Output tab.
On a Microsoft® Windows® system, the Windows Firewall can potentially block a PIL execution. Change the Windows Firewall settings to allow access.
Verify that the results from the PIL execution match the results from the original MATLAB functions.
To terminate the PIL execution process, click Stop PIL Verification. Alternatively, on the Test Output tab, click the link that follows To terminate execution.