<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/feature_column/feature_column_v2.py#L817-L914) |

Represents real valued or numerical features. (deprecated)

> [!WARNING]
> **Warning:** tf.feature_column is not recommended for new code. Instead, feature preprocessing can be done directly using either [Keras preprocessing
> layers](https://www.tensorflow.org/guide/migrate/migrating_feature_columns) or through the one-stop utility [`tf.keras.utils.FeatureSpace`](https://www.tensorflow.org/api_docs/python/tf/keras/utils/FeatureSpace) built on top of them. See the [migration guide](https://tensorflow.org/guide/migrate) for details.

#### View aliases


**Compat aliases for migration**

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

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

<br />

    tf.feature_column.numeric_column(
        key,
        shape=(1,),
        default_value=None,
        dtype=https://www.tensorflow.org/api_docs/python/tf/dtypes#float32,
        normalizer_fn=None
    )

### Used in the notebooks

| Used in the guide | Used in the tutorials |
|---|---|
| - [Migrate \`tf.feature_column\`s to Keras preprocessing layers](https://www.tensorflow.org/guide/migrate/migrating_feature_columns) - [Estimators](https://www.tensorflow.org/guide/estimator) - [Migration examples: Canned Estimators](https://www.tensorflow.org/guide/migrate/canned_estimators) - [Migrate checkpoint saving](https://www.tensorflow.org/guide/migrate/checkpoint_saver) - [Migrate evaluation](https://www.tensorflow.org/guide/migrate/evaluator) | - [Classify structured data with feature columns](https://www.tensorflow.org/tutorials/structured_data/feature_columns) - [Build a linear model with Estimators](https://www.tensorflow.org/tutorials/estimator/linear) - [Premade Estimators](https://www.tensorflow.org/tutorials/estimator/premade) - [Getting started](https://www.tensorflow.org/decision_forests/tutorials/beginner_colab) - [End to end example for BigQuery TensorFlow reader](https://www.tensorflow.org/io/tutorials/bigquery) |

> [!WARNING]
> **Deprecated:** THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Use Keras preprocessing layers instead, either directly or via the [`tf.keras.utils.FeatureSpace`](https://www.tensorflow.org/api_docs/python/tf/keras/utils/FeatureSpace) utility. Each of `tf.feature_column.*` has a functional equivalent in `tf.keras.layers` for feature preprocessing when training a Keras model.

#### Example:

Assume we have data with two features `a` and `b`.

    data = {'a': [15, 9, 17, 19, 21, 18, 25, 30],
       'b': [5.0, 6.4, 10.5, 13.6, 15.7, 19.9, 20.3 , 0.0]}

Let us represent the features `a` and `b` as numerical features.

    a = tf.feature_column.numeric_column('a')
    b = tf.feature_column.numeric_column('b')

Feature column describe a set of transformations to the inputs.

For example, to "bucketize" feature `a`, wrap the `a` column in a
[`feature_column.bucketized_column`](https://www.tensorflow.org/api_docs/python/tf/feature_column/bucketized_column).
Providing `5` bucket boundaries, the bucketized_column api
will bucket this feature in total of `6` buckets.

    a_buckets = tf.feature_column.bucketized_column(a,
       boundaries=[10, 15, 20, 25, 30])

Create a `DenseFeatures` layer which will apply the transformations
described by the set of [`tf.feature_column`](https://www.tensorflow.org/api_docs/python/tf/feature_column) objects:

    feature_layer = tf.keras.layers.DenseFeatures([a_buckets, b])
    print(feature_layer(data))
    tf.Tensor(
    [[ 0.   0.   1.   0.   0.   0.   5. ]
     [ 1.   0.   0.   0.   0.   0.   6.4]
     [ 0.   0.   1.   0.   0.   0.  10.5]
     [ 0.   0.   1.   0.   0.   0.  13.6]
     [ 0.   0.   0.   1.   0.   0.  15.7]
     [ 0.   0.   1.   0.   0.   0.  19.9]
     [ 0.   0.   0.   0.   1.   0.  20.3]
     [ 0.   0.   0.   0.   0.   1.   0. ]], shape=(8, 7), dtype=float32)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `key` | A unique string identifying the input feature. It is used as the column name and the dictionary key for feature parsing configs, feature `Tensor` objects, and feature columns. |
| `shape` | An iterable of integers specifies the shape of the `Tensor`. An integer can be given which means a single dimension `Tensor` with given width. The `Tensor` representing the column will have the shape of \[batch_size\] + `shape`. |
| `default_value` | A single value compatible with `dtype` or an iterable of values compatible with `dtype` which the column takes on during `tf.Example` parsing if data is missing. A default value of `None` will cause [`tf.io.parse_example`](https://www.tensorflow.org/api_docs/python/tf/io/parse_example) to fail if an example does not contain this column. If a single value is provided, the same value will be applied as the default value for every item. If an iterable of values is provided, the shape of the `default_value` should be equal to the given `shape`. |
| `dtype` | defines the type of values. Default value is [`tf.float32`](https://www.tensorflow.org/api_docs/python/tf#float32). Must be a non-quantized, real integer or floating point type. |
| `normalizer_fn` | If not `None`, a function that can be used to normalize the value of the tensor after `default_value` is applied for parsing. Normalizer function takes the input `Tensor` as its argument, and returns the output `Tensor`. (e.g. lambda x: (x - 3.0) / 4.2). Please note that even though the most common use case of this function is normalization, it can be used for any kind of Tensorflow transformations. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `NumericColumn`. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `TypeError` | if any dimension in shape is not an int |
| `ValueError` | if any dimension in shape is not a positive integer |
| `TypeError` | if `default_value` is an iterable but not compatible with `shape` |
| `TypeError` | if `default_value` is not compatible with `dtype`. |
| `ValueError` | if `dtype` is not convertible to [`tf.float32`](https://www.tensorflow.org/api_docs/python/tf#float32). |

<br />