Save the date! Google I/O returns May 18-20 Register now

Represents options for

Used in the notebooks

Used in the tutorials

A object can be, for instance, used to control which static optimizations to apply to the input pipeline graph or whether to use performance modeling to dynamically tune the parallelism of operations such as or

The options are set for the entire dataset and are carried over to datasets created through transformations.

The options can be set either by mutating the object returned by or by constructing an Options object and using the transformation, which returns a dataset with the options set.

dataset =
dataset.options().experimental_deterministic = False
dataset =
options =
options.experimental_deterministic = False
dataset = dataset.with_options(options)

experimental_deterministic Whether the outputs need to be produced in deterministic order. If None, defaults to True.
experimental_distribute The distribution strategy options associated with the dataset. See for more details.
experimental_external_state_policy This option can be used to override the default policy for how to handle external state when serializing a dataset or checkpointing its iterator. There are three settings available - IGNORE: in which we completely ignore any state; WARN: We warn the user that some state might be thrown away; FAIL: We fail if any state is being captured.
experimental_optimization The optimization options associated with the dataset. See for more details.
experimental_slack Whether to introduce 'slack' in the last prefetch of the input pipeline, if it exists. This may reduce CPU contention with accelerator host-side activity at the start of a step. The slack frequency is determined by the number of devices attached to this input pipeline. If None, defaults to False.
experimental_stats The statistics options associated with the dataset. See for more details.
experimental_threading The threading options associated with the dataset. See for more details.



View source

Merges itself with the given

If this object and the options to merge set an option differently, a warning is generated and this object's value is updated with the options object's value.

options a to merge with

New object which is the result of merging self with the input


View source

Return self==value.


View source

Return self!=value.