A bool Tensor. This tensor controls whether the input is
added to the queue or not. If it is a scalar and evaluates True, then
tensors are all added to the queue. If it is a vector and enqueue_many
is True, then each example is added to the queue only if the
corresponding value in keep_input is True. This tensor essentially
acts as a filtering mechanism.
batch_size
The new batch size pulled from the queue.
num_threads
The number of threads enqueuing tensors. The batching will
be nondeterministic if num_threads > 1.
capacity
An integer. The maximum number of elements in the queue.
enqueue_many
Whether each tensor in tensors is a single example.
shapes
(Optional) The shapes for each example. Defaults to the
inferred shapes for tensors.
dynamic_pad
Boolean. Allow variable dimensions in input shapes.
The given dimensions are padded upon dequeue so that tensors within a
batch have the same shapes.
allow_smaller_final_batch
(Optional) Boolean. If True, allow the final
batch to be smaller if there are insufficient items left in the queue.
shared_name
(Optional). If set, this queue will be shared under the given
name across multiple sessions.
name
(Optional) A name for the operations.
Returns
A list or dictionary of tensors with the same types as tensors.
Raises
ValueError
If the shapes are not specified, and cannot be
inferred from the elements of tensors.
[null,null,["Last updated 2024-04-26 UTC."],[],[],null,["# tf.compat.v1.train.maybe_batch\n\n\u003cbr /\u003e\n\n|--------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/training/input.py#L1027-L1081) |\n\nConditionally creates batches of tensors based on `keep_input`. (deprecated) \n\n tf.compat.v1.train.maybe_batch(\n tensors,\n keep_input,\n batch_size,\n num_threads=1,\n capacity=32,\n enqueue_many=False,\n shapes=None,\n dynamic_pad=False,\n allow_smaller_final_batch=False,\n shared_name=None,\n name=None\n )\n\n| **Deprecated:** THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Queue-based input pipelines have been replaced by [`tf.data`](../../../../tf/data). Use `tf.data.Dataset.filter(...).batch(batch_size)` (or `padded_batch(...)` if `dynamic_pad=True`).\n\nSee docstring in `batch` for more details.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|-----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `tensors` | The list or dictionary of tensors to enqueue. |\n| `keep_input` | A `bool` Tensor. This tensor controls whether the input is added to the queue or not. If it is a scalar and evaluates `True`, then `tensors` are all added to the queue. If it is a vector and `enqueue_many` is `True`, then each example is added to the queue only if the corresponding value in `keep_input` is `True`. This tensor essentially acts as a filtering mechanism. |\n| `batch_size` | The new batch size pulled from the queue. |\n| `num_threads` | The number of threads enqueuing `tensors`. The batching will be nondeterministic if `num_threads \u003e 1`. |\n| `capacity` | An integer. The maximum number of elements in the queue. |\n| `enqueue_many` | Whether each tensor in `tensors` is a single example. |\n| `shapes` | (Optional) The shapes for each example. Defaults to the inferred shapes for `tensors`. |\n| `dynamic_pad` | Boolean. Allow variable dimensions in input shapes. The given dimensions are padded upon dequeue so that tensors within a batch have the same shapes. |\n| `allow_smaller_final_batch` | (Optional) Boolean. If `True`, allow the final batch to be smaller if there are insufficient items left in the queue. |\n| `shared_name` | (Optional). If set, this queue will be shared under the given name across multiple sessions. |\n| `name` | (Optional) A name for the operations. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A list or dictionary of tensors with the same types as `tensors`. ||\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Raises ------ ||\n|--------------|-------------------------------------------------------------------------------------------|\n| `ValueError` | If the `shapes` are not specified, and cannot be inferred from the elements of `tensors`. |\n\n\u003cbr /\u003e"]]
View source on GitHub