Defined in tensorflow/contrib/data/python/ops/

See the guide: Dataset Input Pipeline > Transformations on existing datasets

A batching transformation that omits the final small batch (if present). (deprecated)

THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Use, drop_remainder=True).

Like, this transformation combines consecutive elements of this dataset into batches. However, if the batch size does not evenly divide the input dataset size, this transformation will drop the final smaller element.

The following example illustrates the difference between this transformation and Dataset.batch():

dataset =
batched = dataset.apply(
print(batched.output_shapes)  # ==> "(128,)" (the batch dimension is known)

By contrast, dataset.batch(128) would yield a two-element dataset with shapes (128,) and (72,), so the batch dimension would not be statically known.


  • batch_size: A tf.int64 scalar tf.Tensor, representing the number of consecutive elements of this dataset to combine in a single batch.


A Dataset transformation function, which can be passed to