Open Source
Tutorials
Code
Downloads
Meta
Documentation
Citation
Testing

Feature-engine is a Python library with multiple transformers to engineer and select features for use in machine learning models. Feature-engine's transformers follow Scikit-learn's functionality with fit() and transform() methods to learn the transforming parameters from the data and then transform it.

Feature-engine is made possible with the support of:

• Feature Engineering for Machine Learning, Online Course

• Feature Selection for Machine Learning, Online Course

• Feature Engineering for Time Series Forecasting, Online Course

• Forecasting with Machine Learning, Online Course

• Python Feature Engineering Cookbook

• Feature Selection in Machine Learning Book

• Feature-engine: A new open-source Python package for feature engineering

• Practical Code Implementations of Feature Engineering for Machine Learning with Python

• Documentation

We want to share Feature-engine with more people. It'd help us loads if you tell us how you discovered us.

Then we'd know what we are doing right and which channels to use to share the love.

Please share your story by answering 1 quick question at this link . 😃

• Missing Data Imputation
• Categorical Encoding
• Discretisation
• Outlier Capping or Removal
• Variable Transformation
• Variable Creation
• Variable Selection
• Datetime Features
• Text Features
• Time Series
• Preprocessing
• Scaling
• Scikit-learn Wrappers

• MeanMedianImputer
• ArbitraryImputer
• RandomSampleImputer
• EndTailImputer
• CategoricalImputer
• MissingIndicator
• DropMissingData

• OneHotEncoder
• OrdinalEncoder
• CountEncoder
• MeanEncoder
• WoEEncoder
• RareLabelEncoder
• DecisionTreeEncoder
• StringSimilarityEncoder

• EqualFrequencyDiscretiser
• EqualWidthDiscretiser
• GeometricWidthDiscretiser
• DecisionTreeDiscretiser
• ArbitraryDiscreriser

• Winsoriser
• ArbitraryOutlierCapper
• OutlierTrimmer

• LogTransformer
• ReciprocalTransformer
• ArcsinTransformer
• PowerTransformer
• BoxCoxTransformer
• YeoJohnsonTransformer
• ArcSinhTransformer

• MeanNormalisationScaler

• MathFeatures
• RelativeFeatures
• CyclicalFeatures
• DecisionTreeFeatures
• GeoDistanceFeatures

• DropFeatures
• DropConstantFeatures
• DropDuplicateFeatures
• DropCorrelatedFeatures
• SmartCorrelationSelection
• ShuffleFeaturesSelector
• SelectBySingleFeaturePerformance
• SelectByTargetEncoding
• RecursiveFeatureElimination
• RecursiveFeatureAddition
• DropHighPSIFeatures
• SelectByInformationValue
• ProbeFeatureSelection
• MRMR

• DatetimeFeatures
• DatetimeSubtraction
• DatetimeOrdinal

• TextFeatures

• LagFeatures
• WindowFeatures
• ExpandingWindowFeatures

• Pipeline
• make_pipeline

• MatchCategories
• MatchVariables

• SklearnWrapper

From PyPI using pip:

pip install feature_engine

From Anaconda:

conda install -c conda-forge feature_engine

Or simply clone it:

git clone https://github.com/feature-engine/feature_engine.git

>>> import pandas as pd
>>> from feature_engine.encoding import RareLabelEncoder

>>> data = {'var_A': ['A'] * 10 + ['B'] * 10 + ['C'] * 2 + ['D'] * 1}
>>> data = pd.DataFrame(data)
>>> data['var_A'].value_counts()

Out[1]:
A    10
B    10
C     2
D     1
Name: var_A, dtype: int64

>>> rare_encoder = RareLabelEncoder(tol=0.10, n_categories=3)
>>> data_encoded = rare_encoder.fit_transform(data)
>>> data_encoded['var_A'].value_counts()

Out[2]:
A       10
B       10
Rare     3
Name: var_A, dtype: int64

Find more examples in our Jupyter Notebook Gallery or in the documentation.

Details about how to contribute can be found in the Contribute Page

Briefly:

• Fork the repo
• Clone your fork into your local computer:

git clone https://github.com/<YOURUSERNAME>/feature_engine.git

• navigate into the repo folder

cd feature_engine

• Install Feature-engine as a developer:

pip install -e .

• Optional: Create and activate a virtual environment with any tool of choice
• Install Feature-engine developer dependencies:

pip install -e ".[tests]"

• Create a feature branch with a meaningful name for your feature:

git checkout -b myfeaturebranch

• Develop your feature, tests and documentation
• Make sure the tests pass
• Make a PR

Thank you!!

Feature-engine documentation is built using Sphinx and is hosted on Read the Docs.

To build the documentation make sure you have the dependencies installed: from the root directory:

pip install -r docs/requirements.txt

Now you can build the docs using:

sphinx-build -b html docs build

The content of this repository is licensed under a BSD 3-Clause license.