acoustotreams.AcousticTMatrixC

class acoustotreams.AcousticTMatrixC(arr, ann=(), /, **kwargs)

Acoustic T-matrix in a scalar cylindrical-wave basis.

The acoustic T-matrix is a square matrix that maps incident (regular) fields acoustotreams.special.scw_rPsi() to corresponding scattered (singular) fields acoustotreams.special.scw_Psi(). The modes themselves are defined in basis. Moreover, the wavenumber k0 and, if not the air, the material material are specified.

Parameters:

• arr (float or complex or array_like) – T-matrix itself.

• k0 (float) – Angular wavenumber in the air.

• basis (ScalarCylindricalWaveBasis, optional) – Basis definition.

• material (AcousticMaterial, optional) – Background material. Defaults to air.

• lattice (Lattice, optional) – Lattice definition. If specified, the T-matrix is assumed to be placed on the defined lattice.

• kpar (list, optional) – Bloch wave vector for the effective T-Matrix.

Attributes

T	Transpose.
ann	Array annotations.
expand	Expansion matrix, see also acoustotreams.Expand.
expandlattice	Lattice expansion matrix, see also acoustotreams.ExpandLattice.
imag	Imaginary part of the array.
interaction
isglobal	Test if a T-matrix is global.
krhos	Radial part of the wave vector.
ks	Angular wavenumber in the background medium.
latticeinteraction
ndim	Number of array dimensions.
pamplitudeff	Far-field amplitude of pressure field evaluation matrix, see also acoustotreams.PAmplitudeFF.
permute	Permutation matrix, see also acoustotreams.Permute.
pfield	Pressure field evaluation matrix, see also acoustotreams.PField.
real	Real part of the array.
rotate	Rotation matrix, see also acoustotreams.Rotate.
shape	Array shape.
size	Array size.
translate	Translation matrix, see also acoustotreams.Translate.
vfield	Velocity field evaluation matrix, see also acoustotreams.VField.
xw_ext_avg	Rotation-averaged extinction cross width (m).
xw_sca_avg	Rotation-averaged scattering cross width (m).

Methods

__abs__()
__add__(other)
__and__(other)
__array__([dtype])	Convert to an numpy array.
__array_function__(func, types, args, kwargs)	Function calls on the array.
__array_ufunc__(ufunc, method, *inputs, **kwargs)	Implements ufunc API.
__divmod__(other)
__eq__(other)	Return self==value.
__floordiv__(other)
__ge__(other)	Return self>=value.
__getitem__(key)	Get an item from the AnnotatedArray.
__gt__(other)	Return self>value.
__invert__()
__le__(other)	Return self<=value.
__len__()
__lshift__(other)
__lt__(other)	Return self<value.
__matmul__(other)
__mod__(other)
__mul__(other)
__ne__(other)	Return self!=value.
__neg__()
__or__(other)	Return self|value.
__pos__()
__pow__(other)
__repr__()	String representation.
__rshift__(other)
__setitem__(key, value)	Set values.
__str__()	String of the array itself.
__sub__(other)
__truediv__(other)
__xor__(other)
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)	Acoustic T-Matrix of an infinite cylinder.
diagonal([offset, axis1, axis2])	Get the diagonal of the array.
flatten([order])	Flatten array to one dimension.
from_array(tm, basis, *[, eta])	One-dimensional 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.
sca(inc)	Expansion coefficients of the scattered field.
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)	Points on the grid where the expansion is valid.
xw(inc[, flux])	Scattering and extinction cross width (m).
__lt__(other)	Return self<value.
__str__()	String of the array itself.
__lshift__(other)
__array__([dtype])	Convert to an numpy array.
__pow__(other)
__pos__()
__mod__(other)
__ne__(other)	Return self!=value.
__neg__()
__mul__(other)
__rshift__(other)
__and__(other)
__array_ufunc__(ufunc, method, *inputs, **kwargs)	Implements ufunc API.
__repr__()	String representation.
__le__(other)	Return self<=value.
__matmul__(other)
__setitem__(key, value)	Set values.
__xor__(other)
__len__()
__ge__(other)	Return self>=value.
__abs__()
__array_function__(func, types, args, kwargs)	Function calls on the array.
__divmod__(other)
__truediv__(other)
__sub__(other)
__or__(other)	Return self|value.
__add__(other)
__eq__(other)	Return self==value.
__invert__()
__gt__(other)	Return self>value.
__floordiv__(other)