# tf.image.central_crop

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.14.0/tensorflow/python/ops/image_ops_impl.py#L856-L1000) |

Crop the central region of the image(s).

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.image.central_crop`](https://www.tensorflow.org/api_docs/python/tf/image/central_crop)

<br />

    tf.image.central_crop(
        image, central_fraction
    )

Remove the outer parts of an image but retain the central region of the image
along each dimension. If we specify `central_fraction = 0.5`, this function
returns the region marked with "X" in the below diagram. The larger the value
of `central_fraction`, the larger the dimension of the region to be cropped
and retained.

     ---
    |        |
    |  XXXX  |
    |  XXXX  |
    |        |   where "X" is the central 50% of the image.
     ---

This function works on either a single image (`image` is a 3-D Tensor), or a
batch of images (`image` is a 4-D Tensor).

#### Usage Example:

    x = [[[1.0, 2.0, 3.0],
          [4.0, 5.0, 6.0],
          [7.0, 8.0, 9.0],
          [10.0, 11.0, 12.0]],
        [[13.0, 14.0, 15.0],
          [16.0, 17.0, 18.0],
          [19.0, 20.0, 21.0],
          [22.0, 23.0, 24.0]],
        [[25.0, 26.0, 27.0],
          [28.0, 29.0, 30.0],
          [31.0, 32.0, 33.0],
          [34.0, 35.0, 36.0]],
        [[37.0, 38.0, 39.0],
          [40.0, 41.0, 42.0],
          [43.0, 44.0, 45.0],
          [46.0, 47.0, 48.0]]]
    tf.image.central_crop(x, 0.5)
    <tf.Tensor: shape=(2, 2, 3), dtype=float32, numpy=
    array([[[16., 17., 18.],
            [19., 20., 21.]],
           [[28., 29., 30.],
            [31., 32., 33.]]], dtype=float32)>

<br />

<br />

<br />

| ## Args ||
|---|---|
| `image` | Either a 3-D float Tensor of shape \[height, width, depth\], or a 4-D Tensor of shape \[batch_size, height, width, depth\]. |
| `central_fraction` | float (0, 1\], fraction of size to crop |

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if central_crop_fraction is not within (0, 1\]. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| 3-D / 4-D float Tensor, as per the input. ||

<br />