MeanMedianImputer

API Reference

class feature_engine.imputation.MeanMedianImputer(imputation_method='median', variables=None)[source]

The MeanMedianImputer() replaces missing data by the mean or median value of the variable. It works only with numerical variables.

You can pass a list of variables to be imputed. Alternatively, the MeanMedianImputer() will automatically select all variables of type numeric in the training set.

The imputer:

  • first calculates the mean / median values of the variables (fit).

  • Then replaces the missing data with the estimated mean / median (transform).

Parameters
imputation_method: str, default=median

Desired method of imputation. Can take ‘mean’ or ‘median’.

variables: list, default=None

The list of variables to be imputed. If None, the imputer will select all variables of type numeric.

Attributes

imputer_dict_:

Dictionary with the mean or median values per variable.

variables_:

The group of variables that will be transformed.

n_features_in_:

The number of features in the train set used in fit.

Methods

fit:

Learn the mean or median values.

transform:

Impute missing data.

fit_transform:

Fit to the data, then transform it.

fit(X, y=None)[source]

Learn the mean or median values.

Parameters
X: pandas dataframe of shape = [n_samples, n_features]

The training dataset.

y: pandas series or None, default=None

y is not needed in this imputation. You can pass None or y.

Returns
self
Raises
TypeError
  • If the input is not a Pandas DataFrame

  • If any of the user provided variables are not numerical

ValueError

If there are no numerical variables in the df or the df is empty

transform(X)[source]

Replace missing data with the learned parameters.

Parameters
X: pandas dataframe of shape = [n_samples, n_features]

The data to be transformed.

Returns
X: pandas dataframe of shape = [n_samples, n_features]

The dataframe without missing values in the selected variables.

rtype

DataFrame ..

Raises
TypeError

If the input is not a Pandas DataFrame

ValueError

If the dataframe has different number of features than the df used in fit()

Example

The MeanMedianImputer() replaces missing data with the mean or median of the variable. It works only with numerical variables. You can pass a list of variables to impute, or the imputer will automatically select all numerical variables in the train set.

import numpy as np
import pandas as pd
import matplotlib.pyplot as plt
from sklearn.model_selection import train_test_split

from feature_engine.imputation import MeanMedianImputer

# Load dataset
data = pd.read_csv('houseprice.csv')

# Separate into train and test sets
X_train, X_test, y_train, y_test = train_test_split(
data.drop(['Id', 'SalePrice'], axis=1), data['SalePrice'], test_size=0.3, random_state=0)

# set up the imputer
median_imputer = MeanMedianImputer(imputation_method='median', variables=['LotFrontage', 'MasVnrArea'])

# fit the imputer
median_imputer.fit(X_train)

# transform the data
train_t= median_imputer.transform(X_train)
test_t= median_imputer.transform(X_test)

fig = plt.figure()
ax = fig.add_subplot(111)
X_train['LotFrontage'].plot(kind='kde', ax=ax)
train_t['LotFrontage'].plot(kind='kde', ax=ax, color='red')
lines, labels = ax.get_legend_handles_labels()
ax.legend(lines, labels, loc='best')
../_images/medianimputation.png