tf.image.random_crop
Stay organized with collections
Save and categorize content based on your preferences.
Randomly crops a tensor to a given size.
tf.image.random_crop(
value, size, seed=None, name=None
)
Used in the notebooks
Slices a shape size portion out of value at a uniformly chosen offset.
Requires value.shape >= size.
If a dimension should not be cropped, pass the full size of that dimension.
For example, RGB images can be cropped with
size = [crop_height, crop_width, 3].
Example usage:
image = [[1, 2, 3], [4, 5, 6]]
result = tf.image.random_crop(value=image, size=(1, 3))
result.shape.as_list()
[1, 3]
For producing deterministic results given a seed value, use
tf.image.stateless_random_crop. Unlike using the seed param with
tf.image.random_* ops, tf.image.stateless_random_* ops guarantee the same
results given the same seed independent of how many times the function is
called, and independent of global seed settings (e.g. tf.random.set_seed).
Args |
|---|
value
|
Input tensor to crop.
|
size
|
1-D tensor with size the rank of value.
|
seed
|
Python integer. Used to create a random seed. See
tf.random.set_seed
for behavior.
|
name
|
A name for this operation (optional).
|
Returns |
|---|
A cropped tensor of the same rank as value and shape size.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2024-04-26 UTC.
[null,null,["Last updated 2024-04-26 UTC."],[],[],null,["# tf.image.random_crop\n\n\u003cbr /\u003e\n\n|---------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/ops/random_crop_ops.py#L30-L82) |\n\nRandomly crops a tensor to a given size.\n\n#### View aliases\n\n\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n[`tf.compat.v1.image.random_crop`](https://www.tensorflow.org/api_docs/python/tf/image/random_crop), [`tf.compat.v1.random_crop`](https://www.tensorflow.org/api_docs/python/tf/image/random_crop)\n\n\u003cbr /\u003e\n\n tf.image.random_crop(\n value, size, seed=None, name=None\n )\n\n### Used in the notebooks\n\n| Used in the tutorials |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - [CycleGAN](https://www.tensorflow.org/tutorials/generative/cyclegan) - [pix2pix: Image-to-image translation with a conditional GAN](https://www.tensorflow.org/tutorials/generative/pix2pix) |\n\nSlices a shape `size` portion out of `value` at a uniformly chosen offset.\nRequires `value.shape \u003e= size`.\n\nIf a dimension should not be cropped, pass the full size of that dimension.\nFor example, RGB images can be cropped with\n`size = [crop_height, crop_width, 3]`.\n\n#### Example usage:\n\n image = [[1, 2, 3], [4, 5, 6]]\n result = tf.image.random_crop(value=image, size=(1, 3))\n result.shape.as_list()\n [1, 3]\n\nFor producing deterministic results given a `seed` value, use\n[`tf.image.stateless_random_crop`](../../tf/image/stateless_random_crop). Unlike using the `seed` param with\n`tf.image.random_*` ops, `tf.image.stateless_random_*` ops guarantee the same\nresults given the same seed independent of how many times the function is\ncalled, and independent of global seed settings (e.g. tf.random.set_seed).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------|------------------------------------------------------------------------------------------------------------------|\n| `value` | Input tensor to crop. |\n| `size` | 1-D tensor with size the rank of `value`. |\n| `seed` | Python integer. Used to create a random seed. See [`tf.random.set_seed`](../../tf/random/set_seed) for behavior. |\n| `name` | A name for this operation (optional). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A cropped tensor of the same rank as `value` and shape `size`. ||\n\n\u003cbr /\u003e"]]
View source on GitHub