Labels, title, and legend in MATLAB - Deep Dive

Overview - Labels, title, and legend

What is it?

Labels, title, and legend are text elements added to graphs to explain what the data and axes represent. Labels describe the x-axis and y-axis, the title gives the overall name of the graph, and the legend explains the meaning of different lines or markers. These elements help anyone looking at the graph understand the story the data tells without confusion.

Why it matters

Without labels, titles, and legends, graphs become confusing and hard to interpret. People might guess wrong about what the data means or miss important details. Clear text elements make graphs accessible and trustworthy, which is crucial when sharing results or making decisions based on data.

Where it fits

Before learning labels, titles, and legends, you should know how to create basic plots in MATLAB. After mastering these, you can learn advanced graph customization like annotations, multiple axes, and interactive plots.

Mental Model

Core Idea

Labels, titles, and legends are the signposts on a graph that guide the viewer to understand what each part means.

Think of it like...

Imagine a map without street names, a title, or a key. You see lines and shapes but have no idea what they represent. Labels, titles, and legends are like street signs, the map title, and the legend that explain the map clearly.

┌─────────────────────────────┐
│           Title             │
├─────────────────────────────┤
│                             │
│  Y-axis Label               │
│  ↑                          │
│  │      Plot lines           │
│  │      ● ● ●               │
│  │      ─ ─ ─               │
│  │                          │
│  └─────────────────────────→│
│           X-axis Label       │
│                             │
│ Legend: ● Data1  ─ Data2     │
└─────────────────────────────┘

Build-Up - 7 Steps

1

Foundation

Basic plot creation in MATLAB

Concept: Learn how to create a simple plot using MATLAB's plot function.

Use the plot function to draw a line graph. For example, x = 1:5; y = [2 4 6 8 10]; plot(x,y); This draws points connected by lines.

Result

A simple line graph appears showing points at (1,2), (2,4), (3,6), (4,8), and (5,10).

Understanding how to create a basic plot is essential before adding descriptive text elements.

2

Foundation

Adding axis labels

Concept: Learn to add text labels to the x-axis and y-axis to describe what they represent.

Use xlabel('X-axis label') and ylabel('Y-axis label') after plotting. For example, xlabel('Time (seconds)'); ylabel('Speed (m/s)');

Result

The graph now shows 'Time (seconds)' below the x-axis and 'Speed (m/s)' beside the y-axis.

Labels clarify what each axis measures, preventing confusion about the data's meaning.

3

Intermediate

Adding a title to the plot

Concept: Learn to add a main title that summarizes the graph's purpose.

Use the title function: title('Speed over Time'); This places a descriptive title above the graph.

Result

The graph displays 'Speed over Time' centered above the plot area.

A title gives viewers immediate context about what the graph shows.

4

Intermediate

Creating multiple data series

🤔Before reading on: do you think MATLAB automatically adds legends when plotting multiple lines? Commit to your answer.

Concept: Plotting multiple lines on the same graph to compare data sets.

Define multiple y data sets and plot them together: x = 1:5; y1 = [2 4 6 8 10]; y2 = [1 3 5 7 9]; plot(x,y1,x,y2);

Result

Two lines appear on the graph, but no legend is shown yet.

Knowing that multiple lines can be plotted together sets the stage for using legends to distinguish them.

5

Intermediate

Adding a legend to explain lines

🤔Before reading on: do you think the legend text must match variable names exactly? Commit to your answer.

Concept: Use the legend function to label each data series for clarity.

After plotting multiple lines, add legend('Data1','Data2'); This creates a box explaining which line is which.

Result

A legend box appears, showing 'Data1' and 'Data2' with matching line styles.

Legends prevent confusion by clearly linking visual elements to their meaning.

6

Advanced

Customizing labels, title, and legend

🤔Before reading on: do you think you can change font size and color of labels and legends in MATLAB? Commit to your answer.

Concept: Learn to customize text appearance for better readability and style.

Use properties like xlabel('X-axis','FontSize',14,'Color','red'); title('My Plot','FontWeight','bold'); legend('Data1','FontSize',12,'Location','northwest');

Result

Labels and title appear in specified font sizes and colors; legend moves to the northwest corner.

Customizing text improves the graph's visual appeal and helps highlight important information.

7

Expert

Dynamic labels and legends in scripts

🤔Before reading on: do you think you can create labels and legends that update automatically based on data? Commit to your answer.

Concept: Use variables and functions to generate labels and legends dynamically in MATLAB scripts.

Example: n = 5; plot(1:n, rand(1,n)); xlabel(sprintf('Time (0 to %d seconds)', n)); legend(sprintf('Random data with %d points', n));

Result

The labels and legend text reflect the variable n, updating automatically if n changes.

Dynamic text makes scripts flexible and reusable for different data without manual edits.

Under the Hood

MATLAB stores plot elements as graphics objects with properties. When you call xlabel, ylabel, title, or legend, MATLAB creates text objects linked to the axes. These objects have properties like string (text), font size, color, and position. The rendering engine draws these text objects on the figure canvas, updating them when properties change or the figure resizes.

Why designed this way?

Separating text elements as objects allows flexible customization and easy updates without redrawing the entire plot. This object-based design supports complex figures with multiple layers and interactive features. Early MATLAB versions had simpler static text, but modern design improves usability and extensibility.

┌─────────────┐
│  Figure     │
│ ┌─────────┐ │
│ │ Axes    │ │
│ │ ┌─────┐ │ │
│ │ │Plot │ │ │
│ │ └─────┘ │ │
│ │ ┌─────┐ │ │
│ │ │Text │ │ │
│ │ │(xlabel)││ │
│ │ └─────┘ │ │
│ │ ┌─────┐ │ │
│ │ │Text │ │ │
│ │ │(title) ││ │
│ │ └─────┘ │ │
│ │ ┌─────┐ │ │
│ │ │Legend│ │ │
│ │ └─────┘ │ │
│ └─────────┘ │
└─────────────┘

Myth Busters - 4 Common Misconceptions

Quick: Does MATLAB automatically add a legend when you plot multiple lines? Commit to yes or no.

Common Belief: MATLAB automatically creates a legend when multiple lines are plotted.

Reality: MATLAB does not add a legend automatically; you must call the legend function explicitly.

Why it matters: Without calling legend, viewers cannot distinguish multiple data series, leading to misinterpretation.

Quick: Can you use any string as a label or legend text without restrictions? Commit to yes or no.

Common Belief: Labels and legends accept any string, including variables or expressions directly.

Reality: Labels and legends require strings; to use variables or expressions, you must convert them to strings explicitly (e.g., using sprintf).

Why it matters: Failing to convert variables to strings causes errors or incorrect labels, confusing users.

Quick: Does changing the plot data automatically update existing labels and legends? Commit to yes or no.

Common Belief: Labels and legends update automatically when the plot data changes.

Reality: Labels and legends remain static unless you explicitly update their text properties.

Why it matters: Assuming automatic updates can cause outdated or misleading text on graphs.

Quick: Is it best practice to use very long or complex text in legends? Commit to yes or no.

Common Belief: Long, detailed legend text is always better for clarity.

Reality: Overly long legend text clutters the graph and reduces readability; concise, clear labels are preferred.

Why it matters: Cluttered legends distract viewers and obscure the data story.

Expert Zone

1

MATLAB's legend function can accept handles to specific plot objects, allowing precise control over which lines appear in the legend.

2

Text objects for labels and titles support LaTeX formatting for mathematical expressions, enabling professional-quality scientific graphs.

3

Legend location can be set to 'auto' or fixed positions, but in complex plots, manual positioning is often needed to avoid overlapping with data.

When NOT to use

For highly interactive or web-based visualizations, MATLAB's static labels and legends may be insufficient. Alternatives like Plotly or D3.js provide dynamic, interactive legends and annotations.

Production Patterns

In professional MATLAB scripts, labels, titles, and legends are often generated dynamically using variables and loops to handle multiple datasets. Consistent styling is applied via centralized functions or templates to maintain branding and readability.

Connections

Data Visualization Principles

Builds-on

Understanding labels, titles, and legends is a practical application of core visualization principles like clarity, context, and storytelling.

User Interface Design

Similar pattern

Labels and legends in graphs function like UI labels and tooltips, guiding users to understand controls and information.

Cartography (Map Making)

Analogous concept

Just as maps use legends and titles to explain symbols and regions, graphs use labels and legends to explain data, showing how communication principles cross domains.

Common Pitfalls

#1 Forgetting to add labels and legends, resulting in unclear graphs.

Wrong approach:

x = 1:5; y = [2 4 6 8 10]; plot(x,y);

Correct approach:

x = 1:5; y = [2 4 6 8 10]; plot(x,y); xlabel('Time (s)'); ylabel('Speed (m/s)'); title('Speed over Time'); legend('Speed Data');

Root cause:

Assuming the plot is self-explanatory without descriptive text.

#2 Using variable names directly in legend without converting to strings.

Wrong approach:

legend(Data1, Data2);

Correct approach:

legend('Data1', 'Data2');

Root cause:

Misunderstanding that legend requires string inputs, not variable names.

#3 Adding too many legend entries for minor plot elements, cluttering the graph.

Wrong approach:

legend('Line1','Line2','Line3','Line4','Line5');

Correct approach:

legend('Main Data1','Main Data2');

Root cause:

Not prioritizing which data series need explanation, leading to visual overload.

Key Takeaways

Labels, titles, and legends are essential for making graphs understandable and meaningful.

MATLAB requires explicit commands to add and customize these text elements; they are not automatic.

Clear, concise text improves communication and prevents misinterpretation of data.

Advanced use includes dynamic text generation and styling for professional-quality visuals.

Understanding the internal object model helps customize and troubleshoot graph text effectively.