mv_prob_homo

Contents

mv_prob_homo#

class brainpy.math.jitconn.mv_prob_homo(vector, weight, conn_prob, seed=None, *, shape, transpose=False, outdim_parallel=True)[source]#

Perform the \(y=M@v\) operation, where \(M\) is just-in-time randomly generated with a scalar weight at each position.

This operator support jit(), vmap(), grad() and pmap() etc. transformations on CPU and GPU devices.

Warning

This API may change in the future.

In this operation, \(M\) is the random matrix with a connection probability conn_prob, and at each connection the value is the same scalar weight.

When transpose=True, we perform an operation of \(y=M^T@v\).

Note

Note that the just-in-time generated \(M\) (transpose=False) is different from the generated \(M^T\) (transpose=True).

If you pursue the same \(M\) and \(M^T\) when performing the just-in-time matrix generation, you should set outdim_parallel=True, with the sacrifice of the speed compared with outdim_parallel=False.

Parameters:
  • vector (Array, ndarray) – The vector.

  • weight (float) – The value of the random matrix.

  • conn_prob (float) – The connection probability.

  • shape (tuple of int) – The matrix shape.

  • seed (int) – The random number generation seed.

  • transpose (bool) – Transpose the random matrix or not.

  • outdim_parallel (bool) – Perform the parallel random generations along the out dimension or not. It can be used to set the just-in-time generated :math:M^T: is the same as the just-in-time generated \(M\) when transpose=True.

Returns:

out – The output of \(y = M @ v\).

Return type:

Array, ndarray