# compute_buckets

## nominal.experimental.compute.compute_buckets(client, expr, start, end, buckets=1000)

Compute a bucketed summary of the requested expression.

Parameters:
:   - **client** ([*NominalClient*](https://dev.nominal.io/python/ref/generated/nominal.core.NominalClient.md#nominal.core.NominalClient "nominal.core.client.NominalClient"))

      Nominal client to make requests with
    - **expr** ([*NumericExpr*](https://dev.nominal.io/python/ref/generated/nominal.experimental.compute.dsl.exprs.NumericExpr.md#nominal.experimental.compute.dsl.exprs.NumericExpr "nominal.experimental.compute.dsl.exprs.NumericExpr"))

      Expression to compute buckets for
    - **start** ([*int*](https://docs.python.org/3/builtins/functions.html#int "(in Python v3.15)"))

      Starting timestamp to summarize data from
    - **end** ([*int*](https://docs.python.org/3/builtins/functions.html#int "(in Python v3.15)"))

      Ending timestamp to summarize data until
    - **buckets** ([*int*](https://docs.python.org/3/builtins/functions.html#int "(in Python v3.15)"))

      Number of buckets to return

Returns:
:   Decimated data representing the provided numerical expression computed over the provided time range.

Return type:
:   [*Sequence*](https://docs.python.org/3/library/typing.html#typing.Sequence "(in Python v3.15)")[[*Bucket*](https://dev.nominal.io/python/ref/generated/nominal.experimental.compute.Bucket.md#nominal.experimental.compute.Bucket "nominal.experimental.compute._buckets.Bucket")]

> **Note**
>
> It is not a safe guarantee that the number of buckets returned is the same as
> the number requested.