Click here to Skip to main content
13,148,510 members (67,130 online)
Click here to Skip to main content
Add your own
alternative version

Stats

54.5K views
2.8K downloads
121 bookmarked
Posted 10 Aug 2016
MIT

How to Use Your GPU in .NET

, 12 Dec 2016
Rate this:
Please Sign up or sign in to vote.
Make programs 5x faster - the easy way. Now on every GPU!

Update 13.12.2016

  • Works on multiple GPUs and any other OpenCL device now. Please comment your result of the demo

Introduction

This project is going to show you that a modern Core I7 is probably the slowest piece of programmable hardware you have in your PC. Modern Quad Core CPUs have about 6 Gflops whereas modern GPUs have about 6Tflops of computational power.

This project can dynamically execute simple programs written in a C dialect (OpenCL C) on your GPU, CPU or both. They are compiled and executed at run time.

This is also going to show that GPU programming does not have to be hard. In fact, you only need a little bit of basic programming skills for this project.

If you want to skip the introduction and dive into using this, feel free to download the source code.

Do I Need This?

Your computer is a very powerful machine. By using only the CPU to execute tasks, you might waste about 90% of its potential.

If you have a piece of code which is concurrent and you want to speed it up, this is the right project for you. Ideally, all your data fits into some float or other numeric arrays.

Examples for a potential speed up would be:

  • Work on pictures or movies
  • Any work that can be done parallel
  • Do hard number crunching on your GPU
  • Save energy and time by using GPU and CPU in parallel
  • Use your GPU for any task and have your CPU free to do something else

Keep in mind that this project uses OpenCL. Unlike Cuda, it runs on any GPU (Amd, Nvidia, Intel) and also on the CPU. So any program you write can be used on any device. (Even phones)

Tested on NVIDA, AMD, and Intel.

These are the results for simple prime calculation:

As you can see, you really can speed up your program a LOT. Native C# is 5x slower than the best speed you can get on your PC. This is not even the best case scenario. The speedup factor can approach 500x in pure multiply add workloads. (GPUs really shine in this domain). If there are many ifs, the CPU can be better sometimes.
Most importantly, it is really easy to write a program for your GPU and CPU with this class.

OpenCL code always runs faster than C# on arrays and is really easy and quick to just use with this project.
(See example below) The overhead you have as a developer is literally zero. Just write a function and you are done. Dont think about computedevices, pinvoke, marshalling and other stuff.

How Do I Use It?

OpenCL programming can be a very time consuming task. This helper project will reduce your programming overhead so that you can concentrate on the core problem. It is written in C# but could be adapted to any .NET language and also C++.

Imagine you wanted to know all prime numbers from 2 to 10^8. Here is a simple implementation in C# (yes, I know there are much better algorithms to calculate primes).

static void IsPrimeNet(int[] message)
{
    Parallel.ForEach(message, (number, state, index) =>
    {
        int upperlimit = (int)Math.Sqrt(number);
        for(int i=2;i<=upperlimit;i++)
        {
            if (message[index]%i == 0)  //no lock needed. every index is independent
            {
                message[index] = 0;
                break;
            }
        }
    });
}

Now we take this code and translate it to OpenCL-C.
The following Kernel is declared as a string in a file, inline or in a resource file.

kernel void GetIfPrime(global int* message)
{
    int index = get_global_id(0);

    int upperl=(int)sqrt((float)message[index]);
    for(int i=2;i<=upperl;i++)
    {
        if(message[index]%i==0)
        {
            //printf("" %d / %d\n"",index,i );
            message[index]=0;
            return;
        }
    }
    //printf("" % d"",index);
}

OpenCL does wrap your kernel (piece of code to run) in a loop. For simple 1D Arrays, you can get the index by calling get_global_id(0); The upper index of your index is passed when you invoke the kernel.

For more information, check out this link.

Instead of int[], you write int* and so on. You can also pass every other primitive type (int, float...).
You have to pass arguments in the same order in which you declared them. You can also call printf inside your kernel to debug later. You can define as many methods as you like inside the kernel. You pick the entry point later by calling Invoke("Name Here").

OpenCL C is the same as C but you cannot use pointers and you also have some special data types.

For in depth information, check out this link.

Here is how you would use this project:

  1. Add the Nuget Package Cloo
  2. Add reference to OpenCLlib.dll.
    Download OpenCLLib.zip.
  3. Add using OpenCL
static void Main(string[] args)
{

    int[] Primes = Enumerable.Range(2, 1000000).ToArray();
    EasyCL cl = new EasyCL();
    cl.Accelerator = Accelerator.Gpu;        //You can also set the accelerator after loading the kernel
    cl.LoadKernel(IsPrime);                  //Load kernel string here, (Compiles in the background)
    cl.Invoke("GetIfPrime", Primes.Length, Primes); //Call Function By Name With Parameters
    //Primes now contains all Prime Numbers
}

static string IsPrime
{
    get
    {
        return @"
        kernel void GetIfPrime(global int* message)
        {
            int index = get_global_id(0);

            int upperl=(int)sqrt((float)message[index]);
            for(int i=2;i<=upperl;i++)
            {
                if(message[index]%i==0)
                {
                    //printf("" %d / %d\n"",index,i );
                    message[index]=0;
                    return;
                }
            }
            //printf("" % d"",index);
        }";
    }
}

With this, you can dynamically compile and invoke OpenCL kernels. You can also change your accelerator (CPU, GPU) after you have loaded the kernel.

If you want to use every bit of computational power of your PC, you can use the class MultiCL. This class works by splitting your work into N parts. Every part is pushed onto the GPU or CPU whenever possible. This way, you get the maximum performance from your PC. You also know how much work is already done which is not possible with EasyCL.

static void Main(string[] args)
{
    int[] Primes = Enumerable.Range(2, 1000000).ToArray();
    int N = 200;
    MultiCL cl = new MultiCL();
    cl.ProgressChangedEvent += Cl_ProgressChangedEvent1;
    cl.SetKernel(IsPrime, "GetIfPrime");
    cl.SetParameter(Primes);
    cl.Invoke(0, Primes.Length, N);
}

private static void Cl_ProgressChangedEvent1(object sender, double e)
{
    Console.WriteLine(e.ToString("0.00%"));
}

How Does It Work?

This work references the Nuget package Cloo. With Cloo, calls to OpenCL are possible from .NET.

It basically hides all the implementation details you need to know to use OpenCL and Cloo. To get more information about your kernel or device, use the class OpenCL.

There are 3 classes in this project:

  • EasyCL (Call Kernels very easily)
  • MultiCL (Call Kernels on all OpenCL devices at the same time for max speed)
  • OpenCL (Call Kernels and get some information about your device)

Internally, every call to Invoke calls the corresponding methods in the OpenCL API:

void Setargument(ComputeKernel kernel, int index, object arg)
{
    if (arg == null) throw new ArgumentException("Argument " + index + " is null");
    Type argtype = arg.GetType();

    if (argtype.IsArray)
    {
        Type elementtype = argtype.GetElementType();

        //ComputeBuffer<int> messageBuffer = new ComputeBuffer<int>(context,
        //ComputeMemoryFlags.ReadOnly | ComputeMemoryFlags.UseHostPointer, (int[])arg);

        ComputeMemory messageBuffer = (ComputeMemory)Activator.CreateInstance
                                      (typeof(ComputeBuffer<int>), new object[]
        {
            context,
            ComputeMemoryFlags.ReadWrite | ComputeMemoryFlags.UseHostPointer,
            arg
        });
        kernel.SetMemoryArgument(index, messageBuffer); // set the array
    }
    else
    {
        //kernel.SetValueArgument(index, (int)arg); // set the array size
        typeof(ComputeKernel).GetMethod("SetValueArgument").MakeGenericMethod(argtype).Invoke
                      (kernel, new object[] { index, arg });
    }
}

Every time you change the kernel or the accelerator, the program gets recompiled:
For a faster prototyping phase, this class also tells you why you cannot compile your kernel.

public void LoadKernel(string Kernel)
{
    this.kernel = Kernel;
    program = new ComputeProgram(context, Kernel);

    try
    {
        program.Build(null, null, null, IntPtr.Zero);   //compile
    }
    catch (BuildProgramFailureComputeException)
    {
        string message = program.GetBuildLog(platform.Devices[0]);
        throw new ArgumentException(message);
    }
}

It is very important to know that if your GPU driver crashes or kernels use 100% of your GPU for more than 3 seconds (on pre Win10 machines), the kernel will get aborted. You should dispose the EasyCL object after that.

//If windows Vista,7,8,8.1 you better be ready to catch:

EasyCL cl = new EasyCL();
cl.InvokeAborted += (sender,e)=> Cl_InvokeAborted(cl,e);

private void Cl_InvokeAborted(EasyCL sender, string e)
{
     //your logic here
}

For some reason, I don't know it is faster to invoke an empty kernel first and then all subsequent calls are faster. (OpenCL initialization maybe).

What is Missing?

You cannot choose if you want to use the host pointer or read write access to int[] passed to the kernel. I did not see any performance gain by setting an array to read only. This seems to be a legacy function.
This class is written for PCs. With Visual Studio/Xamarin, it should be easy to adapt it for phones. (Modern Smartphones with 8 Cores do rival most Laptops in performance.)

Make sure to have all the newest drivers installed.

        http://www.nvidia.com/Download/index.aspx?lang=en-us
        http://support.amd.com/en-us/download
        https://software.intel.com/en-us/articles/opencl-drivers#latest_CPU_runtime

How Can I Help?

If you see this article and want to help out, please download the demo program. I would be very interested in your results.

My Results:

(10.09.2016)

GeForce GTX 1060 6GB
        Single GFlops = 3167,97GFlops
        Double GFlops = 233,58GFlops
        Memory Bandwidth = 3,55GByte/s

Intel(R) Core(TM) i7-4790K CPU @ 4.00GHz
        Single GFlops = 201,32GFlops
        Double GFlops = 206,96GFlops
        Memory Bandwidth = 3,10GByte/s

(13.12.2016)

Intel(R) Core(TM) i7-4790K CPU @ 4.00GHz:
    6,63 Single GFlops
    7,33 Double GFlops

Ellesmere:
    5527,46 Single GFlops
    239,78 Double GFlops

The AMD driver also compiles to Intel but does seem to do not as well as fast as the "real" Intel OpenCL driver by a factor of 12.

Leave a comment if you have any questions and please paste your speed results in the comments below. (FYI: Ellesmere is the AMD RX480)

License

This article, along with any associated source code and files, is licensed under The MIT License

Share

About the Author

D. Infuehr
Student
Austria Austria
Currently i am 21 years old. I started making software when I was 13.
I use my spare time to make C# and C++ applications.

You may also be interested in...

Pro
Pro

Comments and Discussions

 
GeneralMy vote of 5 Pin
Robert_Dyball18-Sep-17 0:50
professionalRobert_Dyball18-Sep-17 0:50 
QuestionRetrieving images from camera using GPU Pin
vijsesh3-Jul-17 23:58
membervijsesh3-Jul-17 23:58 
QuestionPlease create a program that i can drag any .exe and execute it on cpu and gpu at the same time. Pin
Member 1328176827-Jun-17 14:39
memberMember 1328176827-Jun-17 14:39 
AnswerRe: Please create a program that i can drag any .exe and execute it on cpu and gpu at the same time. Pin
D. Infuehr18-Jul-17 1:24
memberD. Infuehr18-Jul-17 1:24 
QuestionWhat is that OpenCLLib.dll? Pin
Member 1321021214-Jun-17 4:30
memberMember 1321021214-Jun-17 4:30 
AnswerRe: What is that OpenCLLib.dll? Pin
D. Infuehr18-Jul-17 1:21
memberD. Infuehr18-Jul-17 1:21 
QuestionBandwidth calculation - out by a factor of 8? Pin
David Christensen23-Jan-17 23:42
memberDavid Christensen23-Jan-17 23:42 
AnswerRe: Bandwidth calculation - out by a factor of 8? Pin
D. Infuehr27-Jan-17 6:19
memberD. Infuehr27-Jan-17 6:19 
QuestionCrashes on VS2015 Pin
Borte12-Jan-17 9:06
memberBorte12-Jan-17 9:06 
QuestionInfected download page Pin
dr_thomas17-Dec-16 2:15
memberdr_thomas17-Dec-16 2:15 
AnswerRe: Infected download page Pin
D. Infuehr17-Dec-16 5:38
memberD. Infuehr17-Dec-16 5:38 
QuestionGTX 1070 Pin
jmorones14-Dec-16 10:50
memberjmorones14-Dec-16 10:50 
QuestionInteresting, but not really useful for the masses... Pin
rosdi12-Dec-16 17:50
memberrosdi12-Dec-16 17:50 
AnswerRe: Interesting, but not really useful for the masses... Pin
D. Infuehr12-Dec-16 22:10
memberD. Infuehr12-Dec-16 22:10 
AnswerRe: Interesting, but not really useful for the masses... Pin
Matthias Adloff13-Dec-16 7:24
professionalMatthias Adloff13-Dec-16 7:24 
QuestionThis is great! Pin
Rob Philpott9-Sep-16 0:34
memberRob Philpott9-Sep-16 0:34 
Questionusing OpenCL; is causing error Pin
cbc4518-Aug-16 16:35
membercbc4518-Aug-16 16:35 
AnswerRe: using OpenCL; is causing error Pin
D. Infuehr3-Oct-16 9:44
memberD. Infuehr3-Oct-16 9:44 
BugGPU Code not working Pin
filipxsikora15-Aug-16 10:01
memberfilipxsikora15-Aug-16 10:01 
GeneralRe: GPU Code not working Pin
D. Infuehr12-Dec-16 15:20
memberD. Infuehr12-Dec-16 15:20 
QuestionInteresting results Pin
filipxsikora12-Aug-16 20:16
memberfilipxsikora12-Aug-16 20:16 
AnswerRe: Interesting results Pin
D. Infuehr13-Aug-16 5:16
memberD. Infuehr13-Aug-16 5:16 
GeneralRe: Interesting results Pin
filipxsikora13-Aug-16 5:37
memberfilipxsikora13-Aug-16 5:37 
GeneralRe: Interesting results Pin
D. Infuehr13-Aug-16 6:30
memberD. Infuehr13-Aug-16 6:30 
QuestionCrash: Device not found exception Pin
Siarhiej Hurski12-Aug-16 12:20
memberSiarhiej Hurski12-Aug-16 12:20 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.170924.2 | Last Updated 12 Dec 2016
Article Copyright 2016 by D. Infuehr
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid