# tfc.distributions.estimate_tails

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/compression/blob/v2.14.1/tensorflow_compression/python/distributions/helpers.py#L29-L101) |

Estimates approximate tail quantiles.

#### View aliases


**Main aliases**

[`tfc.estimate_tails`](https://www.tensorflow.org/api_docs/python/tfc/distributions/estimate_tails)

<br />

    tfc.distributions.estimate_tails(
        func, target, shape, dtype
    )

This runs a simple Adam iteration to determine tail quantiles. The
objective is to find an `x` such that:

    func(x) == target

For instance, if `func` is a CDF and the target is a quantile value, this
would find the approximate location of that quantile. Note that `func` is
assumed to be monotonic. When each tail estimate has passed the optimal value
of `x`, the algorithm does 100 additional iterations and then stops.

This operation is vectorized. The tensor shape of `x` is given by `shape`, and
`target` must have a shape that is broadcastable to the output of `func(x)`.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `func` | A callable that computes cumulative distribution function, survival function, or similar. |
| `target` | The desired target value. |
| `shape` | The shape of the [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) representing `x`. |
| `dtype` | The `tf.dtypes.Dtype` of the computation (and the return value). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) representing the solution (`x`). ||

<br />