# tff.federated_secure_sum

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/federated/blob/v0.87.0 Version 2.0, January 2004 Licensed under the Apache License, Version 2.0 (the) |

Computes a sum at [`tff.SERVER`](https://www.tensorflow.org/federated/api_docs/python/tff#SERVER) of a `value` placed on the [`tff.CLIENTS`](https://www.tensorflow.org/federated/api_docs/python/tff#CLIENTS).

    tff.federated_secure_sum(
        value, max_input
    )

This function computes a sum such that it should not be possible for the
server to learn any clients individual value. The specific algorithm and
mechanism used to compute the secure sum may vary depending on the target
runtime environment the computation is compiled for or executed on. See
<https://research.google/pubs/pub47246/> for more information.

Not all executors support [`tff.federated_secure_sum()`](https://www.tensorflow.org/federated/api_docs/python/tff/federated_secure_sum); consult the
documentation for the specific executor or executor stack you plan on using
for the specific of how it's handled by that executor.

The `max_input` argument is the maximum value (inclusive) that may appear in
`value`. *Lower values may allow for improved communication efficiency.*
Attempting to return a `value` higher than `max_input` is invalid, and will
result in a failure at the given client.

#### Example:

    value = tff.federated_value(1, tff.CLIENTS)
    result = tff.federated_secure_sum(value, 1)

    value = tff.federated_value((1, 2), tff.CLIENTS)
    result = tff.federated_secure_sum(value, (1, 2))

> [!NOTE]
> **Note:** To sum non-integer values or to sum integers with fewer constraints and weaker privacy properties, consider using `federated_sum`.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `value` | An integer or nested structure of integers placed at [`tff.CLIENTS`](https://www.tensorflow.org/federated/api_docs/python/tff#CLIENTS), in the range `[0, max_input]`. |
| `max_input` | A Python integer or nested structure of integers matching the structure of `value`. If integer `max_value` is used with a nested `value`, the same integer is used for each tensor in `value`. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A representation of the sum of the member constituents of `value` placed on the [`tff.SERVER`](https://www.tensorflow.org/federated/api_docs/python/tff#SERVER). ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `TypeError` | If the argument is not a federated TFF value placed at [`tff.CLIENTS`](https://www.tensorflow.org/federated/api_docs/python/tff#CLIENTS). |

<br />