Labels, scales and annotations 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.
Labels, scales and annotations 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 Labels, scales and annotations 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.
Fit transformation parameters on training data, apply exactly the learned transformation to validation/test/new data, and preserve the fitted transformer with the model.
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.
Standardise continuous variables for a distance-based model while one-hot encoding nominal categories in the same pipeline.
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.
Keep the example small enough that you can inspect each stage manually.
# Purpose: demonstrate Labels, scales and annotations 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
# Create a small labelled dataset that is easy to inspect by eye.
# Step 2 — Construct `df` as a tabular object with named columns for inspectable analysis.
df = pd.DataFrame({
"group": ["A","A","B","B","C","C","A","B","C","A","B","C"],
"value": [12,15,14,18,17,21,19,20,24,22,23,27],
"quality": [0.72,0.75,0.70,0.78,0.76,0.82,0.80,0.81,0.86,0.83,0.84,0.88]
})
# Print this intermediate result so you can verify the workflow step by step.
# Step 3 — Display the current value explicitly so the result/state can be inspected during execution.
print("STEP 1 · Miniature data shape:", df.shape)
# 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 · Columns:", df.columns.tolist())
# Store this intermediate value with a descriptive name for the next step.
# Step 5 — Split rows into groups so the following aggregation/transformation can be computed per group.
summary = df.groupby("group").agg(rows=("value","size"), mean_value=("value","mean"), mean_quality=("quality","mean"))
# Print this intermediate result so you can verify the workflow step by step.
# Step 6 — Display the current value explicitly so the result/state can be inspected during execution.
print("STEP 2 · Group summary:\n", summary.round(3).to_string())
# 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 3 · Overall mean value:", round(df["value"].mean(), 2))
# 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 · Lesson focus: Labels, scales and annotations")STEP 1 · Miniature data shape: (12, 3)
STEP 1 · Columns: ['group', 'value', 'quality']
STEP 2 · Group summary:
rows mean_value mean_quality
group
A 4 17.00 0.775
B 4 18.75 0.782
C 4 22.25 0.830
STEP 3 · Overall mean value: 19.33
STEP 3 · Lesson focus: Labels, scales and annotations