run() method (and every method that can be called directly or indirectly from the run() method)
- * can be converted into OpenCL.* Below is an example Kernel that calculates the square of a set of input values. @@ -154,12 +141,12 @@ to national security controls as identified on the Commerce Control List (curren * A different approach to creating kernels that avoids extending Kernel is to write an anonymous inner class: *
*
*- * + ** final int[] values = new int[1024]; * // fill the values array * final int[] squares = new int[values.length]; * final Range range = Range.create(values.length); - * + *
* Kernel kernel = new Kernel(){ * public void run() { * int gid = getGlobalID(); @@ -170,559 +157,568 @@ to national security controls as identified on the Commerce Control List (curren * for (int i=0; i< values.length; i++){ * System.out.printf("%4d %4d %8d\n", i, values[i], squares[i]); * } - * + *
*
* - * @author gfrost AMD Javalabs + * @author gfrost AMD Javalabs * @version Alpha, 21/09/2010 */ public abstract class Kernel implements Cloneable { - private static Logger logger = Logger.getLogger(Config.getLoggerName()); - - /** - * We can use this Annotation to 'tag' intended local buffers. - * - * So we can either annotate the buffer - *
- * @Local int[] buffer = new int[1024];
- *
- * int[] buffer_$local$ = new int[1024];
- *
- * @Constant int[] buffer = new int[1024];
- *
- * int[] buffer_$constant$ = new int[1024];
- *
- * @PrivateMemorySpace(99) int[] buffer = new int[99];
- *
- * int[] buffer_$private$99 = new int[99];
- * Note that any code which must be runnable in {@link EXECUTION_MODE#JTP} will fail to work correctly if it uses such an
- * array, as the array will be shared by all threads. The solution is to create a {@link NoCL} method called at the start of {@link #run()} which sets
- * the field to an array returned from a static ThreadLocal
MedianKernel7x7 in the samples for an example.
- *
- * @see #PRIVATE_SUFFIX
- */
- @Retention(RetentionPolicy.RUNTIME)
- @Target({ElementType.FIELD})
- public @interface PrivateMemorySpace {
- /** Size of the array used as __private buffer. */
- int value();
- }
-
- /**
- * Annotation which can be applied to either a getter (with usual java bean naming convention relative to an instance field), or to any method
- * with void return type, which prevents both the method body and any calls to the method being emitted in the generated OpenCL. (In the case of a getter, the
- * underlying field is used in place of the NoCL getter method.) This allows for code specialization within a java/JTP execution path, for example to
- * allow logging/breakpointing when debugging, or to apply ThreadLocal processing (see {@link PrivateMemorySpace}) in java to simulate OpenCL __private
- * memory.
- */
- @Retention(RetentionPolicy.RUNTIME)
- @Target({ElementType.METHOD, ElementType.FIELD})
- public @interface NoCL {
- // empty
- }
-
- /**
- * We can use this suffix to 'tag' intended local buffers.
- *
- *
- * So either name the buffer
- *
- * int[] buffer_$local$ = new int[1024];
- *
- * @Local int[] buffer = new int[1024];
- *
- * int[] buffer_$constant$ = new int[1024];
- *
- * @Constant int[] buffer = new int[1024];
- * So either name the buffer - *
- * int[] buffer_$private$32 = new int[32];
- *
- * @PrivateMemorySpace(32) int[] buffer = new int[32];
- * - * The execution mode ENUM enumerates the possible modes of executing a kernel. - * One can request a mode of execution using the values below, and query a kernel after it first executes to - * determine how it executed. - * - *
- * Aparapi supports 5 execution modes. Default is GPU. - *
| Enum value | Execution |
|---|---|
GPU | Execute using OpenCL on first available GPU device |
ACC | Execute using OpenCL on first available Accelerator device |
CPU | Execute using OpenCL on first available CPU device |
JTP | Execute using a Java Thread Pool (one thread spawned per available core) |
SEQ | Execute using a single loop. This is useful for debugging but will be less - * performant than the other modes |
- * To request that a kernel is executed in a specific mode, call Kernel.setExecutionMode(EXECUTION_MODE) before the
- * kernel first executes.
- *
- *
- *- * int[] values = new int[1024]; - * // fill values array - * SquareKernel kernel = new SquareKernel(values); - * kernel.setExecutionMode(Kernel.EXECUTION_MODE.JTP); - * kernel.execute(values.length); - *
-<<<<<<< HEAD:src/main/java/com/codegen/Kernel.java
- * Alternatively, the property com.codegen.executionMode can be set to one of JTP,GPU,ACC,CPU,SEQ
- * when an application is launched.
- *