Skip to content

fpga 🔗

FPGA operations.

FpgaMixin 🔗

Mixin providing the FPGA operations for a Session.

This mixin is intended to be used in combination with BaseSession and should not be instantiated on its own.

Intended usage

class Session(BaseSession, FPGAMixin): ...

fpga_arraycopy 🔗

fpga_arraycopy(a: list[int]) -> list[int]

Performs the matrix copying operation.

Wraps the vaccel_fpga_arraycopy() C operation.

Parameters:

Name Type Description Default

a 🔗

 list[int]

The matrix A to be copied.

 required

Returns:

Type Description
list[int]

A copy of the matrix A.

Raises:

Type Description
FFIError

If the C operation fails.
Source code in vaccel/ops/fpga.py 
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
def fpga_arraycopy(self, a: list[int]) -> list[int]:
    """Performs the matrix copying operation.

    Wraps the `vaccel_fpga_arraycopy()` C operation.

    Args:
        a: The matrix A to be copied.

    Returns:
        A copy of the matrix A.

    Raises:
        FFIError: If the C operation fails.
    """
    c_a = CList(a)
    c_out_a = CList([0] * len(a))

    ret = lib.vaccel_fpga_arraycopy(
        self._c_ptr_or_raise, c_a._c_ptr, c_out_a._c_ptr, len(c_a)
    )
    if ret != 0:
        raise FFIError(ret, "FPGA array copy failed")

    return [int(item) for item in c_out_a.value]

fpga_mmult 🔗

fpga_mmult(a: list[float], b: list[float]) -> list[float]

Performs the matrix multiplication operation.

Wraps the vaccel_fpga_mmult() C operation.

Parameters:

Name Type Description Default

a 🔗

 list[float]

A matrix A.

 required

b 🔗

 list[float]

A matrix B.

 required

Returns:

Type Description
list[float]

The multiplication result of matrices A and B.

Raises:

Type Description
FFIError

If the C operation fails.
Source code in vaccel/ops/fpga.py 
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
def fpga_mmult(self, a: list[float], b: list[float]) -> list[float]:
    """Performs the matrix multiplication operation.

    Wraps the `vaccel_fpga_mmult()` C operation.

    Args:
        a: A matrix A.
        b: A matrix B.

    Returns:
        The multiplication result of matrices A and B.

    Raises:
        FFIError: If the C operation fails.
    """
    c_a = CList(a)
    c_b = CList(b)
    c_c = CList([float(0)] * len(a))

    ret = lib.vaccel_fpga_mmult(
        self._c_ptr_or_raise, c_a._c_ptr, c_b._c_ptr, c_c._c_ptr, len(c_a)
    )
    if ret != 0:
        raise FFIError(ret, "FPGA matrix multiplication failed")

    return [float(item) for item in c_c.value]

fpga_parallel 🔗

fpga_parallel(a: list[float], b: list[float]) -> (list[float], list[float])

Performs the parallel matrix addition and multiplication operation.

Wraps the vaccel_fpga_parallel() C operation.

Parameters:

Name Type Description Default

a 🔗

 list[float]

A matrix A.

 required

b 🔗

 list[float]

A matrix B.

 required

Returns:

Type Description
(list[float], list[float])

A tuple containing: - The result of the addition of matrices A and B. - The result of the multiplication of matrices A and B.

Raises:

Type Description
FFIError

If the C operation fails.
Source code in vaccel/ops/fpga.py 
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
def fpga_parallel(
    self, a: list[float], b: list[float]
) -> (list[float], list[float]):
    """Performs the parallel matrix addition and multiplication operation.

    Wraps the `vaccel_fpga_parallel()` C operation.

    Args:
        a: A matrix A.
        b: A matrix B.

    Returns:
        A tuple containing:
            - The result of the addition of matrices A and B.
            - The result of the multiplication of matrices A and B.

    Raises:
        FFIError: If the C operation fails.
    """
    c_a = CList(a)
    c_b = CList(b)
    c_add_output = CList([float(0)] * len(a))
    c_mult_output = CList([float(0)] * len(a))

    ret = lib.vaccel_fpga_parallel(
        self._c_ptr_or_raise,
        c_a._c_ptr,
        c_b._c_ptr,
        c_add_output._c_ptr,
        c_mult_output._c_ptr,
        len(c_a),
    )
    if ret != 0:
        raise FFIError(
            ret, "FPGA parallel matrix addition and multiplication failed"
        )

    return (
        [float(item) for item in c_add_output.value],
        [float(item) for item in c_mult_output.value],
    )

fpga_vadd 🔗

fpga_vadd(a: list[float], b: list[float]) -> list[float]

Performs the matrix addition operation.

Wraps the vaccel_fpga_vadd() C operation.

Parameters:

Name Type Description Default

a 🔗

 list[float]

A matrix A.

 required

b 🔗

 list[float]

A matrix B.

 required

Returns:

Type Description
list[float]

The addition result of matrices A and B.

Raises:

Type Description
FFIError

If the C operation fails.
Source code in vaccel/ops/fpga.py 
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
def fpga_vadd(self, a: list[float], b: list[float]) -> list[float]:
    """Performs the matrix addition operation.

    Wraps the `vaccel_fpga_vadd()` C operation.

    Args:
        a: A matrix A.
        b: A matrix B.

    Returns:
        The addition result of matrices A and B.

    Raises:
        FFIError: If the C operation fails.
    """
    c_a = CList(a)
    c_b = CList(b)
    c_c = CList([float(0)] * len(a))

    ret = lib.vaccel_fpga_vadd(
        self._c_ptr_or_raise,
        c_a._c_ptr,
        c_b._c_ptr,
        c_c._c_ptr,
        len(c_a),
        len(c_b),
    )
    if ret != 0:
        raise FFIError(ret, "FPGA vector addition failed")

    return [float(item) for item in c_c.value]