5 · Data Preprocessing & Feature Engineering · Categorical Preprocessing

One-hot encoding

One-hot encoding changes how raw variables are represented for analysis or modelling. The transformation should preserve the information needed by the task while making assumptions explicit and reproducible.

Reference lessonPython exampleVisual explanation
Intuition first

What this concept means in practice

One-hot encoding changes how raw variables are represented for analysis or modelling. The transformation should preserve the information needed by the task while making assumptions explicit and reproducible.

The practical value of One-hot encoding comes from understanding both the transformation and the boundary around it: what information is allowed to enter, what assumption is being made, and how you know the result is still valid after the transformation.

A beginner-friendly way to reason about it is to start with a tiny case where the correct result can be checked independently. Once the mechanism is clear, scale the exact same reasoning to larger tables, pipelines or models.

PurposeUse when the estimator or analytical method benefits from a different numerical representation.
MechanismFit transformation parameters on training data, apply exactly the learned transformation to validation/test/new data, and preserve the fitted transformer with the model.
EvidenceInspect intermediate and final output; compare with an independent expectation.
Main cautionFitting transformations before the split leaks information and can inflate validation performance.
Mechanism

Trace the operation from input to decision

Fit transformation parameters on training data, apply exactly the learned transformation to validation/test/new data, and preserve the fitted transformer with the model.

1Input→
2Apply rule→
3Inspect state→
4Validate→
5Use result
Key rule
fit on training data → transform training and unseen data with the fitted object
Visual explanation

Make the structure visible

The interactive view uses a concept-specific plot when the topic maps naturally to one; otherwise it uses a workflow view instead of leaving a broken placeholder.

Loading visual…
Practical example

Where you would use it

Standardise continuous variables for a distance-based model while one-hot encoding nominal categories in the same pipeline.

Use when
Use when the estimator or analytical method benefits from a different numerical representation.
Pitfall

What can make the result misleading

Watch out
Fitting transformations before the split leaks information and can inflate validation performance.

A useful diagnostic question is: Could the same code still run successfully if the analytical assumption were wrong? If yes, add an explicit validation check rather than relying on execution success.

Implementation

Miniature Python example

Keep the example small enough that you can inspect each stage manually.

Python
# Purpose: demonstrate One-hot encoding with a small, inspectable example.
# Follow the comments and printed stages to connect each operation with its result.
# Import the library or helper used in this example.
# Step 1 — Import the module so its functions/classes are available to the rest of this example.
import pandas as pd
# Import the library or helper used in this example.
# Step 2 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from sklearn.preprocessing import OneHotEncoder

# Create a small labelled dataset that is easy to inspect by eye.
# Step 3 — Construct `X` as a tabular object with named columns for inspectable analysis.
X = pd.DataFrame({"city":["Melbourne","Sydney","Brisbane","Melbourne","Perth","Sydney"],"plan":["Basic","Pro","Basic","Pro","Basic","Pro"]})
# Print this intermediate result so you can verify the workflow step by step.
# Step 4 — Display the current value explicitly so the result/state can be inspected during execution.
print("STEP 1 · Categories:", {c:X[c].unique().tolist() for c in X})
# Store this intermediate value with a descriptive name for the next step.
# Step 5 — Compute the right-hand expression and store its result in `enc` for the next step.
enc = OneHotEncoder(handle_unknown="ignore", sparse_output=False)
# Learn the transformation from this data and apply it in one step.
# Step 6 — Fit the transformation on the training input and immediately transform that same input.
Xt = enc.fit_transform(X)
# Print this intermediate result so you can verify the workflow step by step.
# Step 7 — Display the current value explicitly so the result/state can be inspected during execution.
print("STEP 2 · Feature names:", enc.get_feature_names_out().tolist())
# Print this intermediate result so you can verify the workflow step by step.
# Step 8 — Display the current value explicitly so the result/state can be inspected during execution.
print("STEP 3 · Encoded shape:", Xt.shape)
# Print this intermediate result so you can verify the workflow step by step.
# Step 9 — Display the current value explicitly so the result/state can be inspected during execution.
print(Xt[:3].astype(int))
Expected / illustrative output
STEP 1 · Categories: {'city': ['Melbourne', 'Sydney', 'Brisbane', 'Perth'], 'plan': ['Basic', 'Pro']}
STEP 2 · Feature names: ['city_Brisbane', 'city_Melbourne', 'city_Perth', 'city_Sydney', 'plan_Basic', 'plan_Pro']
STEP 3 · Encoded shape: (6, 6)
[[0 1 0 0 1 0]
 [0 0 0 1 0 1]
 [1 0 0 0 1 0]]
Implementation checklist

Before you move on

  • Can you state what data or object enters the operation?
  • Can you explain what changes and what must remain invariant?
  • Have you checked the result on a tiny case you can verify independently?
  • Have you considered the main failure mode described above?
  • Can the operation be reproduced from code/formulas and documented assumptions?