apple-accelerate 0.1.0

Safe Rust bindings for Apple's Accelerate framework on macOS using pure C FFI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# accelerate-rs

Safe Rust bindings for Apple's
[`Accelerate`](https://developer.apple.com/documentation/accelerate)
framework on macOS using pure C FFI.

The GitHub repository is `accelerate-rs`; the published crates.io package is
`apple-accelerate`.

## Install

```bash
cargo add apple-accelerate
```

## Quick start

```rust,no_run
use apple_accelerate::{add_f32, sgemm_row_major};

let added = add_f32(&[1.0, 2.0, 3.0], &[4.0, 5.0, 6.0]).expect("vector add");
assert_eq!(added, vec![5.0, 7.0, 9.0]);

let mut output = vec![0.0_f32; 4];
sgemm_row_major(
    2,
    2,
    3,
    1.0,
    &[1.0, 2.0, 3.0, 4.0, 5.0, 6.0],
    &[7.0, 8.0, 9.0, 10.0, 11.0, 12.0],
    0.0,
    &mut output,
)
.expect("sgemm");
assert_eq!(output, vec![58.0, 64.0, 139.0, 154.0]);
```

## v0.1 surface

- Safe `vDSP` helpers for FFT setup, vector arithmetic, dot product, reductions, and window generation
- Safe `CBLAS` helpers for `sdot`, row-major `sgemv`, and row-major `sgemm`
- Safe `vImage` helpers for ARGB8888 rotate / box-convolve / scale and Planar8 contrast stretch
- Thin unsafe BNNS filter wrapper for convolution / fully connected create-apply-destroy workflows
- Raw `ffi` module exposing the underlying C types and functions

## Smoke examples

```bash
cargo run --example 01_vdsp_fft
cargo run --example 02_blas_vimage
```