# tff.framework.Selection

<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) |

A selection by name or index from a struct-typed value in TFF's language.

Inherits From: [`ComputationBuildingBlock`](https://www.tensorflow.org/federated/api_docs/python/tff/framework/ComputationBuildingBlock), [`TypedObject`](https://www.tensorflow.org/federated/api_docs/python/tff/TypedObject)

    tff.framework.Selection(
        source: https://www.tensorflow.org/federated/api_docs/python/tff/framework/ComputationBuildingBlock,
        name: Optional[str] = None,
        index: Optional[int] = None
    )

The concise syntax for selections is `foo.bar` (selecting a named `bar` from
the value of expression `foo`), and `foo[n]` (selecting element at index `n`
from the value of `foo`).

<br />

<br />

<br />

| ## Args ||
|---|---|
| `source` | The source value to select from (an instance of ComputationBuildingBlock). |
| `name` | A string name of the element to be selected. |
| `index` | A numeric index of the element to be selected. |

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `TypeError` | if arguments are of the wrong types. |
| `ValueError` | if the name is empty or index is negative, or the name/index is not compatible with the type signature of the source, or neither or both are defined (not None). |

<br />

<br />

<br />

<br />

| ## Attributes ||
|---|---|
| `index` | <br /> <br /> |
| `name` | <br /> <br /> |
| `proto` | Returns a serialized form of this object as a pb.Computation instance. |
| `source` | <br /> <br /> |
| `type_signature` | Returns the TFF type of this object (an instance of [`tff.Type`](https://www.tensorflow.org/federated/api_docs/python/tff/types/Type)). |

<br />

## Methods

### `as_index`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    as_index() -> int

### `children`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    children() -> Iterator[https://www.tensorflow.org/federated/api_docs/python/tff/framework/ComputationBuildingBlock]

Returns an iterator yielding immediate child building blocks.

### `compact_representation`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    compact_representation()

Returns the compact string representation of this building block.

### `formatted_representation`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    formatted_representation()

Returns the formatted string representation of this building block.

### `from_proto`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    @classmethod
    from_proto(
        computation_proto: pb.Computation
    ) -> 'Selection'

Returns an instance of a derived class based on 'computation_proto'.

<br />

<br />

<br />

| Args ||
|---|---|
| `computation_proto` | An instance of pb.Computation. |

<br />

<br />

<br />

<br />

| Returns ||
|---|---|
| An instance of a class that implements 'ComputationBuildingBlock' and that contains the deserialized logic from in 'computation_proto'. ||

<br />

<br />

<br />

<br />

| Raises ||
|---|---|
| `NotImplementedError` | if computation_proto contains a kind of computation for which deserialization has not been implemented yet. |
| `ValueError` | if deserialization failed due to the argument being invalid. |

<br />

### `structural_representation`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    structural_representation()

Returns the structural string representation of this building block.

### `__eq__`

[View source](https://github.com/tensorflow/federated/blob/v0.87.0
Version 2.0, January 2004
Licensed under the Apache License, Version 2.0 (the)

    __eq__(
        other: object
    ) -> bool

Return self==value.