treams.TMatrixC

class treams.TMatrixC(arr, ann=(), /, **kwargs)

T-matrix with a cylindrical basis.

The T-matrix is square relating incident (regular) fields treams.special.vcw_rA() (helical polarizations) or treams.special.vcw_rN() and treams.special.vcw_rM() (parity polarizations) to the corresponding scattered fields treams.special.vcw_A() or treams.special.vcw_N() and treams.special.vcw_M(). The modes themselves are defined in basis, the polarization type in poltype. Also, the wave number k0 and, if not vacuum, the material material are specified.

Parameters:

• arr (float or complex, array-like) – T-matrix itself.

• k0 (float) – Wave number in vacuum.

• basis (SphericalWaveBasis, optional) – Basis definition.

• material (Material, optional) – Embedding material, defaults to vacuum.

• poltype (str, optional) – Polarization type (Polarizations).

• lattice (Lattice, optional) – Lattice definition. If specified the T-Matrix is assumed to be periodically repeated in the defined lattice.

• kpar (list, optional) – Phase factor for the periodic T-Matrix.

__init__(arr, ann=(), /, **kwargs)

Initialization.

Methods

__init__(arr[, ann])	Initialization.
all([axis, dtype, out, keepdims, where])	Test if all elements (along an axis) are True.
any([axis, dtype, out, keepdims, where])	Test if any element (along an axis) is True.
astype(*args, **kwargs)	Return array as given type.
cluster(tmats, positions)	Block-diagonal T-matrix of multiple objects.
conj(*args, **kwargs)	Complex conjugate elementwise.
conjugate(*args, **kwargs)	Complex conjugate elementwise.
cumprod([axis, dtype, out])	Cumulative product of elements (along an axis).
cumsum([axis, dtype, out])	Cumulative sum of elements (along an axis).
cylinder(kzs, mmax, k0, radii, materials)	T-Matrix of a (multi-layered) cylinder.
diagonal([offset, axis1, axis2])	Get the diagonal of the array.
flatten([order])	Flatten array to one dimension.
from_array(tm, basis, *[, eta])	1d array of spherical T-matrices.
max([axis, out, keepdims, initial, where])	Maximum (along an axis).
min([axis, out, keepdims, initial, where])	Minimum (along an axis).
prod([axis, dtype, out, keepdims, initial, ...])	Product of elements (along an axis).
relax(*args[, mro])	Try creating AnnotatedArray subclasses if possible.
sum([axis, dtype, out, keepdims, initial, where])	Sum of elements (along an axis).
swapaxes(axis1, axis2)
trace([offset, axis1, axis2, dtype, out])	Trace of an array.
transpose([axes])	Transpose array dimensions.
valid_points(grid, radii)
xw(illu[, flux])	Scattering and extinction cross width.

Attributes

T	Transpose.
ann	Array annotations.
bfield	Attach an operator to an object as attribute.
changepoltype	Polarization change matrix, see also treams.operators.ChangePoltype.
dfield	Attach an operator to an object as attribute.
efield	Attach an operator to an object as attribute.
expand	Expansion matrix, see also treams.operators.Expand.
expandlattice	Lattice expansion matrix, see also treams.operators.ExpandLattice.
ffield	Field evaluation matrix, see also treams.operators.EField.
gfield	Attach an operator to an object as attribute.
hfield	Attach an operator to an object as attribute.
imag	Imaginary part of the array.
interaction
isglobal	Test if a T-matrix is global.
krhos	Radial part of the wave.
ks	Wave numbers (in medium).
latticeinteraction
ndim	Number of array dimensions.
permute	Permutation matrix, see also treams.operators.Permute.
real	Real part of the array.
rotate	Rotation matrix, see also treams.operators.Rotate.
shape	Array shape.
size	Array size.
translate	Translation matrix, see also treams.operators.Translate.
xw_ext_avg	Rotation and polarization averaged extinction cross width.
xw_sca_avg	Rotation and polarization averaged scattering cross width.