Kernel Execution Input
To assign analysis inputs for an OpenCL kernel, follow the steps below:
- Select the desirable kernel from the session kernels list in the
Code Builder Session Explorer or from the Select
Kernel combo box in the Code Builder Analyze
toolbar.
- Open the OpenCL Kernel Analysis Input window from:
Windows > Show view > Other...
and then Intel Code Builder for OpenCL API > OpenCL
Kernel Analysis Input or by clicking the OpenCL Kernel
Analysis Input button
in the Code
Builder Analyze toolbar.
- Assign a variable for each kernel argument in the Kernel
Arguments table by clicking the Click to
assign button under the Assigned Variable column.
You can assign one-dimensional variables (such as
integer
,
float
, char
, half
, and so on)
on-the-fly by typing single values into the table. See Variable
Management for more information.
- You can assign a reference for each output variable (buffers or
images) that you want to verify. If you specify a validation reference,
after the kernel execution each one of the output variables will be
compared with its assigned reference in order to validate the correctness
of the kernel executions.
- Set the number of iterations, global size and local sizes per workload
dimension in the Workgroup size definitions group
box.
You can use the local size(s) text boxes for several different test
configurations:
- Set single size value for a single test.
- Add several comma-separated sizes for multiple tests.
- Set 0 to utilize the default framework-assigned local size.
- Check the Auto box to enable the Kernel Builder
to iterate on all sizes that are smaller than global size and device
maximum local size.
Also consider the following:
- Each option is available for each dimension.
- To analyze the kernel in its designed conditions, set a single
value.
- To find the local size that provides higher performance results,
click Auto or set a list of comma-separated values.
- To improve the analysis accuracy, run each global and local work
size combination several times by increasing the Iterations
value. Several iterations minimize the impact of other system processes
or tasks on the kernel execution time.
- Use the Device Information dialog to compare device
properties and choose the appropriate device for the kernel.
Creating a New Analysis Configuration
Follow these steps to create a new configuration for an existing built
session:
- In the OpenCL Kernel Analysis Input view, you
need to assign variables for each kernel argument that is listed.
- Enter a valid name to enable the New Configuration
button. Click the button to duplicate the current configuration. You
can edit the new configuration to create multiple analysis configurations.