acoustotreams.AcousticSMatrices.illuminate

AcousticSMatrices.illuminate(illu, illu2=None, /, *, smat=None)[source]

Field coefficients above and below the S-matrix.

Given an insonification defined by the coefficients of each incoming mode, compute the coefficients of the outgoing modes above and below the S-matrix. If a second S-matrix is given, the field expansions in between are also computed.

Parameters:

  • illu (complex or array_like) – Insonification. If modetype is specified, the direction is chosen accordingly.

  • illu2 (complex or array_like, optional) – Second insonification. If used, the first argument is taken to be coming from below and this one to be coming from above.

  • smat (AcousticSMatrix, optional) – Second S-matrix for computing the field expansion between two S-matrices.

Returns:

tuple