Adding `em` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add em

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

em = "0.3.0"

The em library will be automatically available globally.

Back to the crate overview.

Readme

Emu is a framework/compiler for GPU acceleration of Rust, GPU programming. It is a procedural macro that accept pure, safe Rust code as input, identifies portions to attempt to accelerate, and automatically writes in code to run portions on the GPU instead of the CPU.

features

ease of use
- download a library, not a whole new compiler
- work with cargo test, cargo doc, crates.io
- work with rustfmt, racer, rls
- switch between CPU and GPU with 1 line
safety guarantees
- no null pointer errors
- no type mismatch errors
- no syntax errors
more fun
- up to 80% less code
- up to 300x speedup
- as fast as single-GPU, single-threaded, idiomatic usage of OpenCL

an example

#[macro_use]
extern crate em;
use em::*;

#[gpu_use]
fn main() {
    let mut x = vec![0.0; 1000];
    gpu_do!(load(x)); // load data to the GPU

    // this code gets identified as accelerate-able
    // the compiler will insert calls to OpenCL to run this on the GPU
    gpu_do!(launch());
    for i in 0..1000 {
        x[i] = x[i] * 10;
    }

    gpu_do!(read(x)); // read data back from the GPU
    println!("{:?}", x);
}

usage

You can use Emu in your Rust projects by doing the following-

Add em = 0.3.0 to Cargo.toml
Confirm that an OpenCL library is installed for your platform

Learn how to get started with Emu by looking at the documentation.

Adding em library as a dependency

Adding `em` library as a dependency