tech.compute.tensor.math — techascent/tech.compute 3.1

Protocol to abstract implementations from the tensor library. Tensors do not appear in at this level; at this level we have buffers, streams, and index systems. This is intended to allow operations that fall well outside of the tensor definition to happen with clever use of the buffer and index strategy mechanisms. In essence, the point is to make the kernels as flexible as possible so to allow extremely unexpected operations to happen without requiring new kernel creation. In addition the tensor api should be able to stand on some subset of the possible combinations of operations available.

TensorMath clj protocol

Operations defined in general terms to enable the tensor math abstraction and to allow unexpected use cases outside of the tensor definition.

ternary-op-constant-constant! clj

(ternary-op-constant-constant! stream
                               dest
                               a
                               a-alpha
                               const-1
                               const-2
                               operation
                               arg-order)

Apply ternary elementwise operation to args + 2 constants. Argument order is specified by arg-order

binary-op-constant! clj

(binary-op-constant! stream dest x x-alpha scalar operation reverse-operands?)

Binary operation where dest is not involved in the computation. dest[idx] = alpha * x[idx] op scalar

unary-op! clj

(unary-op! stream dest x alpha op)

dest[idx] = op( x[idx] * alpha )

rand! clj

(rand! stream dest distribution)

Generate a pool of random numbers over this distribution. All elements of dest are assigned to randomly out of the pool.

unary-accum! clj

(unary-accum! strea dest alph op)

dest[idx] = op(alpha * dest[idx]

binary-accum-constant! clj

(binary-accum-constant! stream
                        dest
                        dst-alpha
                        scalar
                        operation
                        reverse-operands?)

Binary operation where dest is involved in the computation. dest[idx] = alpha * dest[idx] op scalar

ternary-op-constant! clj

(ternary-op-constant! stream
                      dest
                      a
                      a-alpha
                      b
                      b-alpha
                      constant
                      operation
                      arg-order)

Apply ternary elementwise operation to args and constant. Argument order is specified by arg-order.

gemm! clj

(gemm! stream
       c-buf
       c-colstride
       trans-a?
       trans-b?
       alpha
       a-buf
       a-row-count
       a-col-count
       a-colstride
       b-buf
       b-col-count
       b-colstride
       beta)

Generalized matrix multiply. In this case we don't pass in the index system because gemm is not implemented in any system with anything like indirect addressing or any other of the index system features aside from column stride. c = alpha * (trans-a? a) * (trans-b? b) + beta * c

unary-reduce! clj

(unary-reduce! stream output input-alpha input op)

Reduction on 1 operand.

binary-accum! clj

(binary-accum! stream
               dest
               dest-alpha
               y
               y-alpha
               operation
               reverse-operands?
               dest-reduction?)

Binary operation where dest is involved in the computation. dest[idx] = alpha * dest[idx] op y[idx] reverse-operands? Whether to reverse the operands. dest-reduction? If the tensor library detects that dest is only written to once ever then no CAS operation is required. Else a CAS operation is potentially required as the destination may be written to multiple times during the operation.

assign! clj

(assign! stream dest src)

Assign to dest values from src using the appropriate index strategy. Note that assignment alone should be marshalling if both src and dst are on the same device. So for the three types used in the library: [:float :double :int] all combinations of assignment independent of indexing strategy should be provided. This function will not be called if dest and src are on different devices, memcpy semantics are enforced for that case.

assign-constant! clj

(assign-constant! stream tensor value)

Assign a constant value to a buffer. using an index strategy.

binary-op! clj

(binary-op! stream dest x x-alpha y y-alpha operation)

Binary operation where dest is not involved in the computation. dest[idx] = alpha * x[idx] op y[idx]

ternary-op! clj

(ternary-op! stream dest x x-alpha y y-alpha z z-alpha operation)

Apply ternary elementwise operation to args