arrayfire-rust 0,1

Rust wrapper for ArrayFire

2 years after

Arrayfire Rust Bindings Join the chat at https://gitter.im/arrayfire/arrayfire-rust

Linux Windows OSX
Build Status Build Status Build Status

ArrayFire is a high performance library for parallel computing with an easy-to-use API. It enables users to write scientific computing code that is portable across CUDA, OpenCL and CPU devices. This project provides Rust bindings for the ArrayFire library. The wrapper is currently compliant with ArrayFire 3.4 API. If you find any bugs, please report them here.

Documentation

You can find the most recent updated documentation here.

Supported platforms

  • Linux and OSX: The bindings have been tested with Rust 1.x.
  • Windows: Rust 1.5 (MSVC ABI) is the first version that works with our bindings and ArrayFire library(built using MSVC compiler).

We recommend using Rust 1.5 and higher.

Rust 1.8 stabilized the traits for compound assignment operations. These are automatically enabled based on the rust version you are using.

Use from Crates.io

To use the rust bindings for ArrayFire from crates.io, the following requirements are to be met first.

  1. Download and install ArrayFire binaries based on your operating system.
  2. Set the evironment variable AF_PATH to point to ArrayFire installation root folder.
  3. Make sure you add the path to library files to your path environment variables.
    • On Linux & OSX: do export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$AF_PATH/lib
    • On Windows: Add %AF_PATH%\lib to your PATH environment variable.
  4. Add arrayfire = "3.4.0" to the dependencies section of your project's Cargo.toml file.

Once step (4) is over, you should be able to use ArrayFire in your Rust project. If you find any bugs, please report them here.

Build from Source

Edit build.conf to modify the build flags. The structure is a simple JSON blob. Currently Rust does not allow key:value pairs to be passed from the CLI. To use an existing ArrayFire installation modify the first three JSON values. You can install ArrayFire using one of the following two ways.

To build arrayfire submodule available in the rust wrapper, you have to do the following.

git submodule update --init --recursive
cargo build

This is recommended way to build Rust wrapper since the submodule points to the most compatible version of ArrayFire the Rust wrapper has been tested with. You can find the ArrayFire dependencies below.

Example

let num_rows: u64 = 5;
let num_cols: u64 = 3;
let dims = Dim4::new(&[num_rows, num_cols, 1, 1]);
let a = randu::<f32>(dims);
af_print!("Create a 5-by-3 matrix of random floats on the GPU", a);

Sample output

~/p/arrayfire_rust> cargo run --example helloworld
...
     running 1 test
ArrayFire v3.4.0 (CUDA, 64-bit Linux, build 10d9716)
Platform: CUDA Toolkit 7.5, Driver: 361.42
[0] GeForce GT 650M, 2048 MB, CUDA Compute 3.0

Create a 5-by-3 matrix of random floats on the GPU
[5 3 1 1]
    0.7402     0.4464     0.7762
    0.9210     0.6673     0.2948
    0.0390     0.1099     0.7140
    0.9690     0.4702     0.3585
    0.9251     0.5132     0.6814
...

Acknowledgements

The ArrayFire library is written by developers at ArrayFire LLC with contributions from several individuals.

The developers at ArrayFire LLC have received partial financial support from several grants and institutions. Those that wish to receive public acknowledgement are listed below:

Grants

This material is based upon work supported by the DARPA SBIR Program Office under Contract Numbers W31P4Q-14-C-0012 and W31P4Q-15-C-0008. Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the DARPA SBIR Program Office.

Related Repositories

awesome-rust

awesome-rust

A curated list of Rust code and resources. ...

awesome-rust

awesome-rust

A curated list of Rust code and resources. ...

arrayfire

arrayfire

ArrayFire: a general purpose GPU library. ...

collenchyma

collenchyma

Extendable HPC-Framework for CUDA, OpenCL and common CPU ...

hal

hal

Rust based Cross-GPU Machine Learning ...


Top Contributors

9prady9 jramapuram pavanky tedsta umar456 serprex mmetcalfe

Releases

-   v3.4.0 zip tar
-   v3.3.1 zip tar
-   v3.3.0 zip tar
-   v3.2.0 zip tar