<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/models/blob/v2.20.0/official/vision/configs/retinanet.py#L70-L88) |

Input config for training.

Inherits From: [`DataConfig`](https://www.tensorflow.org/api_docs/python/tfm/core/config_definitions/DataConfig), [`Config`](https://www.tensorflow.org/api_docs/python/tfm/hyperparams/Config), [`ParamsDict`](https://www.tensorflow.org/api_docs/python/tfm/hyperparams/ParamsDict)

    tfm.vision.configs.retinanet.DataConfig(
        default_params: dataclasses.InitVar[Optional[Mapping[str, Any]]] = None,
        restrictions: dataclasses.InitVar[Optional[List[str]]] = None,
        input_path: Union[Sequence[str], str, https://www.tensorflow.org/api_docs/python/tfm/hyperparams/Config] = '',
        tfds_name: Union[str, https://www.tensorflow.org/api_docs/python/tfm/hyperparams/Config] = '',
        tfds_split: str = '',
        global_batch_size: int = 0,
        is_training: bool = False,
        drop_remainder: bool = True,
        shuffle_buffer_size: int = 10000,
        cache: bool = False,
        cycle_length: Optional[int] = None,
        block_length: int = 1,
        ram_budget: Optional[int] = None,
        deterministic: Optional[bool] = None,
        sharding: bool = True,
        enable_tf_data_service: bool = False,
        tf_data_service_address: Optional[str] = None,
        tf_data_service_job_name: Optional[str] = None,
        tfds_data_dir: str = '',
        tfds_as_supervised: bool = False,
        tfds_skip_decoding_feature: str = '',
        enable_shared_tf_data_service_between_parallel_trainers: bool = False,
        apply_tf_data_service_before_batching: bool = False,
        trainer_id: Optional[str] = None,
        seed: Optional[int] = None,
        prefetch_buffer_size: Optional[int] = None,
        autotune_algorithm: Optional[str] = None,
        weights: Optional[https://www.tensorflow.org/api_docs/python/tfm/hyperparams/Config] = None,
        dtype: str = 'bfloat16',
        decoder: https://www.tensorflow.org/api_docs/python/tfm/vision/configs/common/DataDecoder = dataclasses.field(default_factory=common.DataDecoder),
        parser: https://www.tensorflow.org/api_docs/python/tfm/vision/configs/retinanet/Parser = dataclasses.field(default_factory=Parser),
        file_type: str = 'tfrecord'
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `default_params` | a Python dict or another ParamsDict object including the default parameters to initialize. |
| `restrictions` | a list of strings, which define a list of restrictions to ensure the consistency of different parameters internally. Each restriction string is defined as a binary relation with a set of operators, including {'==', '!=', '\<', '\<=', '\>', '\>='}. |

<br />

<br />

<br />

<br />

| ## Attributes ||
|---|---|
| `weights` | Sampling weights for each corresponding input_path. If used, then input_path must be a config with matching keys. |
| `BUILDER` | <br /> <br /> |
| `default_params` | Dataclass field |
| `restrictions` | Dataclass field |
| `input_path` | Dataclass field |
| `tfds_name` | Dataclass field |
| `tfds_split` | Dataclass field |
| `global_batch_size` | Dataclass field |
| `is_training` | Dataclass field |
| `drop_remainder` | Dataclass field |
| `shuffle_buffer_size` | Dataclass field |
| `cache` | Dataclass field |
| `cycle_length` | Dataclass field |
| `block_length` | Dataclass field |
| `ram_budget` | Dataclass field |
| `deterministic` | Dataclass field |
| `sharding` | Dataclass field |
| `enable_tf_data_service` | Dataclass field |
| `tf_data_service_address` | Dataclass field |
| `tf_data_service_job_name` | Dataclass field |
| `tfds_data_dir` | Dataclass field |
| `tfds_as_supervised` | Dataclass field |
| `tfds_skip_decoding_feature` | Dataclass field |
| `enable_shared_tf_data_service_between_parallel_trainers` | Dataclass field |
| `apply_tf_data_service_before_batching` | Dataclass field |
| `trainer_id` | Dataclass field |
| `seed` | Dataclass field |
| `prefetch_buffer_size` | Dataclass field |
| `autotune_algorithm` | Dataclass field |
| `dtype` | Dataclass field |
| `decoder` | Dataclass field |
| `parser` | Dataclass field |
| `file_type` | Dataclass field |

<br />

## Methods

### `as_dict`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/base_config.py#L315-L324)

    as_dict()

Returns a dict representation of params_dict.ParamsDict.

For the nested params_dict.ParamsDict, a nested dict will be returned.

### `from_args`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/base_config.py#L349-L358)

    @classmethod
    from_args(
        *args, **kwargs
    )

Builds a config from the given list of arguments.

### `from_json`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/base_config.py#L344-L347)

    @classmethod
    from_json(
        file_path: str
    )

Wrapper for `from_yaml`.

### `from_yaml`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/base_config.py#L335-L342)

    @classmethod
    from_yaml(
        file_path: str
    )

### `get`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/params_dict.py#L142-L144)

    get(
        key, value=None
    )

Accesses through built-in dictionary get method.

### `lock`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/params_dict.py#L204-L206)

    lock()

Makes the ParamsDict immutable.

### `override`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/params_dict.py#L165-L181)

    override(
        override_params, is_strict=True
    )

Override the ParamsDict with a set of given params.

<br />

<br />

<br />

| Args ||
|---|---|
| `override_params` | a dict or a ParamsDict specifying the parameters to be overridden. |
| `is_strict` | a boolean specifying whether override is strict or not. If True, keys in `override_params` must be present in the ParamsDict. If False, keys in `override_params` can be different from what is currently defined in the ParamsDict. In this case, the ParamsDict will be extended to include the new keys. |

<br />

### `replace`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/base_config.py#L326-L333)

    replace(
        **kwargs
    )

Overrides/returns a unlocked copy with the current config unchanged.

### `validate`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/params_dict.py#L222-L329)

    validate()

Validate the parameters consistency based on the restrictions.

This method validates the internal consistency using the pre-defined list of
restrictions. A restriction is defined as a string which specifies a binary
operation. The supported binary operations are {'==', '!=', '\<', '\<=', '\>',
'\>='}. Note that the meaning of these operators are consistent with the
underlying Python immplementation. Users should make sure the define
restrictions on their type make sense.

For example, for a ParamsDict like the following

    a:
      a1: 1
      a2: 2
    b:
      bb:
        bb1: 10
        bb2: 20
      ccc:
        a1: 1
        a3: 3

one can define two restrictions like this
\['a.a1 == b.ccc.a1', 'a.a2 \<= b.bb.bb2'\]

<br />

<br />

| What it enforces are ||
|---|---|
| <br /> - a.a1 = 1 == b.ccc.a1 = 1 - a.a2 = 2 \<= b.bb.bb2 = 20 ||

<br />

<br />

<br />

<br />

| Raises ||
|---|---|
| `KeyError` | if any of the following happens (1) any of parameters in any of restrictions is not defined in ParamsDict, (2) any inconsistency violating the restriction is found. |
| `ValueError` | if the restriction defined in the string is not supported. |

<br />

### `__contains__`

[View source](https://github.com/tensorflow/models/blob/v2.20.0/official/modeling/hyperparams/params_dict.py#L138-L140)

    __contains__(
        key
    )

Implements the membership test operator.

### `__eq__`

    __eq__(
        other
    )

Return self==value.

<br />

<br />

<br />

| ## Class Variables ||
|---|---|
| IMMUTABLE_TYPES | `(<class 'str'>, <class 'int'>, <class 'float'>, <class 'bool'>, <class 'NoneType'>)` |
| RESERVED_ATTR | `['_locked', '_restrictions']` |
| SEQUENCE_TYPES | `(<class 'list'>, <class 'tuple'>)` |
| apply_tf_data_service_before_batching | `False` |
| autotune_algorithm | `None` |
| block_length | `1` |
| cache | `False` |
| cycle_length | `None` |
| default_params | `None` |
| deterministic | `None` |
| drop_remainder | `True` |
| dtype | `'bfloat16'` |
| enable_shared_tf_data_service_between_parallel_trainers | `False` |
| enable_tf_data_service | `False` |
| file_type | `'tfrecord'` |
| global_batch_size | `0` |
| input_path | `''` |
| is_training | `False` |
| prefetch_buffer_size | `None` |
| ram_budget | `None` |
| restrictions | `None` |
| seed | `None` |
| sharding | `True` |
| shuffle_buffer_size | `10000` |
| tf_data_service_address | `None` |
| tf_data_service_job_name | `None` |
| tfds_as_supervised | `False` |
| tfds_data_dir | `''` |
| tfds_name | `''` |
| tfds_skip_decoding_feature | `''` |
| tfds_split | `''` |
| trainer_id | `None` |
| weights | `None` |

<br />