# tfg.math.spherical_harmonics.evaluate_spherical_harmonics

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/graphics/blob/master/tensorflow_graphics/math/spherical_harmonics.py#L238-L314) |

Evaluates a point sample of a Spherical Harmonic basis function.

    tfg.math.spherical_harmonics.evaluate_spherical_harmonics(
        degree_l: TensorLike,
        order_m: TensorLike,
        theta: TensorLike,
        phi: TensorLike,
        name: str = 'spherical_harmonics_evaluate_spherical_harmonics'
    ) -> TensorLike

<br />

<br />

<br />

| ## Note ||
|---|---|
| This function is implementating the algorithm and variable names described p. 12 of 'Spherical Harmonic Lighting: The Gritty Details. ||

<br />

<br />

<br />

<br />

| ## Note ||
|---|---|
| In the following, A1 to An are optional batch dimensions. ||

<br />

<br />

<br />

<br />

| ## Args ||
|---|---|
| `degree_l` | An integer tensor of shape `[A1, ..., An, C]`, where the last dimension represents the band of the spherical harmonics. Note that `degree_l` must be non-negative. |
| `order_m` | An integer tensor of shape `[A1, ..., An, C]`, where the last dimension represents the index of the spherical harmonics in the band `degree_l`. Note that `order_m` must satisfy `0 <= order_m <= l`. |
| `theta` | A tensor of shape `[A1, ..., An, 1]`. This variable stores the polar angle of the sameple. Values of theta must be in \[0, pi\]. |
| `phi` | A tensor of shape `[A1, ..., An, 1]`. This variable stores the azimuthal angle of the sameple. Values of phi must be in \[0, 2pi\]. |
| `name` | A name for this op. Defaults to "spherical_harmonics_evaluate_spherical_harmonics". |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A tensor of shape `[A1, ..., An, C]` containing the evaluation of each basis of the spherical harmonics. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if the shape of `theta` or `phi` is not supported. |
| `InvalidArgumentError` | if at least an element of `l`, `m`, `theta` or `phi` is outside the expected range. |

<br />