NeuralAmpModeler-rs 3.0.2

An opinionated, high-performance Neural Amp Modeler (NAM) client and core implementation in Rust for Linux/PipeWire and CLAP plugins.
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

// SPDX-License-Identifier: Apache-2.0
// Copyright (c) 2026 Fábio Henrique de Lima Silva (fhl.bsb@gmail.com) All rights reserved.

//! Optimized HardTanh activation kernels.

use crate::activation_simd_avx2;
use crate::activation_simd_avx512;
use core::arch::x86_64::*;

/// Applies HardTanh (`clamp(x, -1.0, 1.0)`) to a slice using AVX2.
///
/// # Safety
/// Requires AVX2 support.
#[target_feature(enable = "avx2")]
pub unsafe fn hard_tanh_slice_avx2(data: &mut [f32]) {
    let neg_one = _mm256_set1_ps(-1.0_f32);
    let pos_one = _mm256_set1_ps(1.0_f32);
    let mut i = 0;
    let len = data.len();
    unsafe {
        activation_simd_avx2!(
            i,
            len,
            {
                let x1 = _mm256_loadu_ps(data.as_ptr().add(i));
                let x2 = _mm256_loadu_ps(data.as_ptr().add(i + 8));
                _mm256_storeu_ps(
                    data.as_mut_ptr().add(i),
                    _mm256_min_ps(pos_one, _mm256_max_ps(neg_one, x1)),
                );
                _mm256_storeu_ps(
                    data.as_mut_ptr().add(i + 8),
                    _mm256_min_ps(pos_one, _mm256_max_ps(neg_one, x2)),
                );
            },
            {
                let x = _mm256_loadu_ps(data.as_ptr().add(i));
                _mm256_storeu_ps(
                    data.as_mut_ptr().add(i),
                    _mm256_min_ps(pos_one, _mm256_max_ps(neg_one, x)),
                );
            }
        );
    }
    for x in data.iter_mut().skip(i) {
        *x = x.clamp(-1.0, 1.0);
    }
}

/// Applies HardTanh (`clamp(x, -1.0, 1.0)`) to a slice using AVX-512.
///
/// # Safety
/// Requires AVX-512F and AVX-512VL support.
#[target_feature(enable = "avx512f,avx512vl")]
pub unsafe fn hard_tanh_slice_avx512(data: &mut [f32]) {
    let neg_one = _mm512_set1_ps(-1.0_f32);
    let pos_one = _mm512_set1_ps(1.0_f32);
    let mut i = 0;
    let len = data.len();
    unsafe {
        activation_simd_avx512!(i, len, {
            let x = _mm512_loadu_ps(data.as_ptr().add(i));
            _mm512_storeu_ps(
                data.as_mut_ptr().add(i),
                _mm512_min_ps(pos_one, _mm512_max_ps(neg_one, x)),
            );
        });
    }
    for x in data.iter_mut().skip(i) {
        *x = x.clamp(-1.0, 1.0);
    }
}

/// Scalar HardTanh: `clamp(x, -1.0, 1.0)`.
#[inline(always)]
pub fn hard_tanh(x: f32) -> f32 {
    x.clamp(-1.0, 1.0)
}