treams.SMatrices.illuminate

SMatrices.illuminate(illu, illu2=None, /, *, smat=None)

Field coefficients above and below the S-matrix.

Given an illumination defined by the coefficients of each incoming mode calculate the coefficients for the outgoing field above and below the S-matrix. If a second SMatrix is given, the field expansions in between are also calculated.

Parameters:

• illu (array-like) – Illumination, if modetype is specified, the direction will be chosen accordingly.

• illu2 (array-like, optional) – Second illumination. If used, the first argument is taken to be coming from below and this one to be coming from above.

• smat (SMatrix, optional) – Second S-matrix for the calculation of the field expansion between two S-matrices.

Returns:

tuple