[API] Extension of the prebuilt-API to load kernels from JAR files

[jjfumero]

Description

Extension of the prebuilt API to be able to load prebuilt kernels stored in JAR files.

Example:

TaskGraph taskGraph = new TaskGraph("sample")
   .transferToDevice(DataTransferMode.EVERY_EXECUTION, param1, param2, ... )
         .prebuiltTask("t1", // task name
                        "myKernel", // kernel name
                        MyKlass.class,    // Accessible klass in the CLASSAPATH that can access the ptx file.
			"kernelFile.ptx",  // File that contains the kernel to run
			accessorParameters)  
                .transferToHost(DataTransferMode.EVERY_EXECUTION, output);

This API access is required by GAIA for the project AERO.

Problem description

n/ a.

Backend/s tested

Mark the backends affected by this PR.

• OpenCL
• PTX
• SPIRV

OS tested

Mark the OS where this PR is tested.

• Linux
• OSx
• Windows

Did you check on FPGAs?

If it is applicable, check your changes on FPGAs.

• Yes
• No

How to test the new patch?

tornado-test -V uk.ac.manchester.tornado.unittests.prebuilt.PrebuiltTest#testPrebuiltWithJar

This has been tested in the GAIA repo with the following commnad:

tornado --threadInfo -cp target/gaia-1.0-SNAPSHOT.jar gaia.MethodLeastSquareTornado 13

[mairooni]

LGTM

[stratika]

@jjfumero is it possible to add a small test case that uses this API extension?

[jjfumero]

Yes, I think it is possible. I will take a look

[stratika]

This should have been withKlass, right?

[stratika]

and this getKlass?

[jjfumero]

In Java, there is a method called getClass, so to avoid miss-understanding about the functionality of each, I named it ClassJar

[stratika]

I am not sure about the classJar and getClassJAR, withKlassJAR names. To my understanding you pass the name of the class file (e.g. MyKlass.class) and not the jar, right? it is assumed that the jar must be in the class file.

Is this correct?

[jjfumero]

We pass any class that appears in the JAR file that we want to load

[jjfumero]

Test provided:

tornado-test -V uk.ac.manchester.tornado.unittests.prebuilt.PrebuiltTest#testPrebuiltWithJar

Works for OpenCL and PTX. I am checking for SPIR-V.

[jjfumero]

I reverted this PR to draft again. Since this is very specific to the AERO project, we might only added it in the AERO GitHub space.