e3x.so3.irreps.tensor_to_irreps

e3x.so3.irreps.tensor_to_irreps(x, degree, cartesian_order=True, normalization='racah')[source]

Converts a traceless symmetric tensor to irreducible representations.

This function does not check whether the input tensor is actually symmetric and traceless, because doing so is incompatible with jax.jit. Using a non-symmetric or traced tensor as input will lead to meaningless results. In case of doubt, the input should be checked manually with is_traceless_symmetric() prior to calling this function.

Parameters:
  • x (<class 'Float[Array, '...']'>) – The input traceless symmetric tensor.

  • degree (int) – The degree of the input tensor.

  • cartesian_order (bool, default: True) – If True, irreps are returned in Cartesian order.

  • normalization ({'4pi', 'orthonormal', 'racah', 'schmidt'}, default: 'racah') – Which normalization is used for the irreps.

Returns:

The corresponding irreducible representation. See spherical_harmonics for more information about the meaning of cartesian_order and normalization.

Raises:
  • ValueError – If degree is not positive or zero, the shape of x is

  • inconsistent with degree or normalization has an invalid value.