Dates on x-axis in Matplotlib - Step-by-Step Execution

Concept Flow - Dates on x-axis

Import matplotlib and datetime

↓

Create date list and values

↓

Plot dates on x-axis

↓

Format x-axis for dates

↓

Show plot with readable dates

This flow shows how to import libraries, prepare date data, plot it, format the x-axis for dates, and display the plot.

Execution Sample

Matplotlib

import matplotlib.pyplot as plt
from datetime import datetime

dates = [datetime(2024,6,1), datetime(2024,6,2), datetime(2024,6,3)]
values = [10, 20, 15]

plt.plot(dates, values)
plt.gcf().autofmt_xdate()
plt.show()

This code plots values against dates and formats the x-axis to show dates clearly.

Execution Table

Step	Action	Variable/Function	Result/Effect
1	Import matplotlib.pyplot as plt	plt	matplotlib plotting functions ready
2	Import datetime from datetime	datetime	datetime class ready for date objects
3	Create list 'dates' with datetime objects	dates	[2024-06-01, 2024-06-02, 2024-06-03]
4	Create list 'values' with numbers	values	[10, 20, 15]
5	Call plt.plot(dates, values)	plt.plot	Line plot created with dates on x-axis
6	Call plt.gcf().autofmt_xdate()	autofmt_xdate	X-axis date labels rotated and formatted
7	Call plt.show()	plt.show	Plot window displayed with dates on x-axis

💡 Plot displayed and program ends

Variable Tracker

Variable	Start	After Step 3	After Step 4	Final
dates	undefined	[2024-06-01, 2024-06-02, 2024-06-03]	[2024-06-01, 2024-06-02, 2024-06-03]	[2024-06-01, 2024-06-02, 2024-06-03]
values	undefined	undefined	[10, 20, 15]	[10, 20, 15]

Key Moments - 2 Insights

Why do we need to use datetime objects for dates on the x-axis?

Matplotlib needs datetime objects to understand and format dates properly on the x-axis, as shown in step 3 and 5 of the execution_table.

What does plt.gcf().autofmt_xdate() do?

It automatically rotates and formats the date labels on the x-axis to prevent overlap and improve readability, as seen in step 6.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'dates' after step 3?

A undefined

B [10, 20, 15]

C [2024-06-01, 2024-06-02, 2024-06-03]

D ['2024-06-01', '2024-06-02', '2024-06-03']

💡 Hint

Check the 'dates' row in variable_tracker after step 3.

At which step are the date labels rotated for better readability?

A Step 5

B Step 6

C Step 4

D Step 7

💡 Hint

Look at the action involving plt.gcf().autofmt_xdate() in execution_table.

If we replace datetime objects with strings in 'dates', what will happen?

A Plot will error or show incorrect x-axis labels

B Plot will show dates correctly formatted

C Values will not plot at all

D Plot will ignore x-axis

💡 Hint

Refer to key_moments about why datetime objects are needed.

Concept Snapshot

Dates on x-axis in matplotlib:
- Use datetime objects for x-axis dates
- Plot with plt.plot(dates, values)
- Call plt.gcf().autofmt_xdate() to format date labels
- Show plot with plt.show()
- This ensures readable, well-formatted date labels

Full Transcript

This visual execution shows how to plot data with dates on the x-axis using matplotlib. First, we import matplotlib.pyplot and datetime. Then, we create a list of datetime objects representing dates and a list of values. We plot these using plt.plot. To make the date labels readable, we call plt.gcf().autofmt_xdate() which rotates and formats the dates on the x-axis. Finally, plt.show() displays the plot window. Using datetime objects is important because matplotlib understands and formats these properly. The execution table traces each step, showing variable states and actions. Key moments clarify common confusions about datetime usage and label formatting. The quiz tests understanding of variable states and function effects.

Practice

1. What is the main reason to use datetime objects on the x-axis in matplotlib plots?

easy

A. To display dates properly and allow date-specific formatting

B. To speed up the plotting process

C. To change the color of the plot lines

D. To add grid lines automatically

Solution

1. Step 1: Understand the role of datetime objects

   Datetime objects represent dates and times in Python, allowing matplotlib to recognize and format them correctly on the x-axis.

2. Step 2: Identify the benefit for plotting

   Using datetime objects enables proper date formatting, such as showing months, days, or years, and helps in handling date ticks automatically.

3. Final Answer:

   To display dates properly and allow date-specific formatting -> Option A

4. Quick Check:

   Datetime objects = Proper date display [OK]

Hint: Use datetime objects to get correct date formatting on x-axis [OK]

Common Mistakes:

• Using strings instead of datetime objects for dates
• Expecting automatic color changes from datetime
• Confusing grid lines with date formatting

2. Which of the following is the correct way to import the module used for date formatting in matplotlib?

easy

A. import matplotlib.date as mdate

B. import matplotlib.dates as mdates

C. import matplotlib.datetime as mdates

D. import matplotlib.dateformatter as mdates

Solution

1. Step 1: Recall the correct module name

   The correct module for date formatting in matplotlib is called dates, not date or datetime.

2. Step 2: Match the import alias

   Common practice is to import it as mdates for convenience.

3. Final Answer:

   import matplotlib.dates as mdates -> Option B

4. Quick Check:

   matplotlib.dates = mdates [OK]

Hint: Remember: 'dates' plural, alias 'mdates' [OK]

Common Mistakes:

• Using singular 'date' instead of 'dates'
• Confusing datetime module with matplotlib.dates
• Using wrong alias causing import errors

3. What will the following code output?

import matplotlib.pyplot as plt
import matplotlib.dates as mdates
from datetime import datetime

dates = [datetime(2024, 1, 1), datetime(2024, 1, 2), datetime(2024, 1, 3)]
values = [10, 20, 15]

plt.plot(dates, values)
plt.gcf().autofmt_xdate()
plt.show()

medium

A. A line plot with dates on x-axis formatted and rotated for readability

B. A line plot with numeric x-axis values instead of dates

C. An error because dates are not converted to strings

D. A scatter plot with dates on y-axis

Solution

1. Step 1: Understand the plot function with datetime

   The plt.plot function accepts datetime objects on the x-axis and plots the corresponding values.

2. Step 2: Effect of autofmt_xdate()

   This function rotates and formats the date labels on the x-axis to prevent overlap and improve readability.

3. Final Answer:

   A line plot with dates on x-axis formatted and rotated for readability -> Option A

4. Quick Check:

   autofmt_xdate() rotates date labels [OK]

Hint: Use autofmt_xdate() to rotate date labels automatically [OK]

Common Mistakes:

• Expecting string conversion of dates automatically
• Confusing plot type with scatter
• Ignoring the effect of autofmt_xdate()

4. Identify the error in this code snippet that tries to plot dates on the x-axis:

import matplotlib.pyplot as plt
from datetime import datetime

dates = ['2024-01-01', '2024-01-02', '2024-01-03']
values = [5, 10, 15]

plt.plot(dates, values)
plt.show()

medium

A. plt.plot cannot plot lists

B. Values list length does not match dates list length

C. Missing import for matplotlib.dates module

D. Dates are strings, not datetime objects, causing incorrect x-axis formatting

Solution

1. Step 1: Check the type of dates list

   The dates are given as strings, which matplotlib does not automatically convert to dates for axis formatting.

2. Step 2: Understand the impact on plotting

   Using strings causes matplotlib to treat them as categorical labels, not dates, so date formatting and scaling won't work properly.

3. Final Answer:

   Dates are strings, not datetime objects, causing incorrect x-axis formatting -> Option D

4. Quick Check:

   Use datetime objects, not strings for dates [OK]

Hint: Convert date strings to datetime objects before plotting [OK]

Common Mistakes:

• Using strings directly for dates
• Assuming matplotlib auto-converts strings to dates
• Ignoring the need for datetime conversion

5. You want to plot daily sales data for January 2024 with dates on the x-axis. You have a list of date strings and sales numbers. Which code snippet correctly converts the dates and formats the x-axis for clear display?

dates = ['2024-01-01', '2024-01-02', '2024-01-03']
sales = [100, 150, 120]

hard

A. from datetime import datetime
plt.plot([datetime(d) for d in dates], sales)
plt.show()

B. import matplotlib.pyplot as plt
plt.plot(dates, sales)
plt.xticks(rotation=45)
plt.show()

C. from datetime import datetime
import matplotlib.pyplot as plt
import matplotlib.dates as mdates

converted_dates = [datetime.strptime(d, '%Y-%m-%d') for d in dates]
plt.plot(converted_dates, sales)
plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%b %d'))
plt.gcf().autofmt_xdate()
plt.show()

D. import matplotlib.dates as mdates
plt.plot(dates, sales)
plt.gca().xaxis.set_major_locator(mdates.DayLocator())
plt.show()

Solution

1. Step 1: Convert date strings to datetime objects

   Use datetime.strptime with the correct format to convert each string to a datetime object.

2. Step 2: Format x-axis dates and rotate labels

   Use mdates.DateFormatter to set a readable date format and autofmt_xdate() to rotate labels for clarity.

3. Final Answer:

   The code snippet that correctly converts dates and formats x-axis -> Option C

4. Quick Check:

   Convert dates + format + rotate labels = from datetime import datetime import matplotlib.pyplot as plt import matplotlib.dates as mdates converted_dates = [datetime.strptime(d, '%Y-%m-%d') for d in dates] plt.plot(converted_dates, sales) plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%b %d')) plt.gcf().autofmt_xdate() plt.show() [OK]

Hint: Convert strings with strptime, format with DateFormatter, rotate labels [OK]

Common Mistakes:

• Plotting strings without conversion
• Using datetime(d) instead of strptime
• Forgetting to rotate date labels