Math Module and Turtle Projects

By the end of this lesson you'll be able to:

• Use built-in functions abs() and round() for common number operations
• Import and use math.sqrt(), math.floor(), math.ceil(), math.sin(), math.cos(), and math.pi
• Convert between radians and degrees using math.radians() and math.degrees()
• Build two complete turtle projects: a sine wave drawing and a turtle race simulation

The math module gives Python superpowers for working with numbers — square roots, sine waves, logarithms, and more. In this chapter you'll use those superpowers to create two beautiful, interactive turtle projects.

Welcome to Chapter 18!

Did you know that the smooth curves you see in games and animations are drawn with sine and cosine? Today we'll learn the math tools that make that possible — and then draw our own wave! Let's code it together!

Built-in Number Functions

Python has two useful number functions built in — no import needed.

abs(x) returns the absolute value of a number: the distance from zero, always positive.

print(abs(-7))    # 7
print(abs(5))     # 5
print(abs(-3.14)) # 3.14

round(x) rounds a number to the nearest integer (or to a given number of decimal places).

print(round(3.7))      # 4
print(round(3.2))      # 3
print(round(3.14159, 2)) # 3.14

▶ Run ↻ Reset

The math Module

Import the module with import math. Then access functions using math.function_name().

Before we try them, here's a quick guide to the key functions:

Function	What it does	Example
math.sqrt(x)	Square root of x	math.sqrt(25) → 5.0
math.floor(x)	Round down to nearest integer	math.floor(3.9) → 3
math.ceil(x)	Round up to nearest integer	math.ceil(3.1) → 4
math.pi	The constant π (3.14159...)
math.sin(x)	Sine of x (x in radians)	math.sin(math.pi/2) → 1.0
math.cos(x)	Cosine of x (x in radians)	math.cos(0) → 1.0
math.radians(d)	Convert degrees to radians	math.radians(180) → π
math.degrees(r)	Convert radians to degrees	math.degrees(math.pi) → 180.0
math.log(x)	Natural logarithm of x	math.log(1) → 0.0
math.factorial(n)	n! (n factorial)	math.factorial(5) → 120

▶ Run ↻ Reset

Sine and Cosine — Radians vs Degrees

Python's math.sin() and math.cos() expect their input in radians, not degrees.

A radian is a different way of measuring angles. One full circle = 360° = 2π radians. A half circle = 180° = π radians.

To convert: use math.radians(degrees) to go from degrees → radians.

What Do You Think Will Happen?

math.sin(math.radians(90)) asks for the sine of 90 degrees. In trigonometry, sin(90°) = 1.0. Do you think Python will get the right answer? Make your guess — then run it!

▶ Run ↻ Reset

See It: One Angle, Two Languages

What Do You Think Will Happen?

The turtle speaks degrees, but math.sin() speaks radians. Before you drag the orange point below, predict: how many radians is half a turn (180°)? Drag the point there and check your answer!

Explore the Unit Circle MicroSim

Were you right? Half a turn is exactly π radians (about 3.14). Watch the little turtle at the center — its heading always matches the angle, and the blue and green bars show math.sin() and math.cos() for whatever angle you choose.

Project 1 — Sine Wave with Turtle

A sine wave is the smooth, repeating S-shaped wave you see in physics and music.

The idea: step across the screen from left to right. For each x position, calculate y = amplitude * sin(x * frequency). Move the turtle to (x, y). The result is a smooth wave.

Before running the code, note that: - amplitude controls how tall the wave is (the peak height in pixels) - frequency (really a scaling factor) controls how many cycles appear in the window - math.sin() always returns a value between -1.0 and 1.0, so we multiply by amplitude to scale it up

▶ Run ↻ Reset

Try changing amplitude to 150 for a taller wave or frequency to 0.1 for a faster wave.

See It: Play the Wave Like an Instrument

Editing numbers and re-running works, but sliders are faster for building intuition. In the explorer below, predict first: which slider makes the wave taller, and which packs more wiggles into the same space? Then drag each slider one at a time and watch the equation update.

Explore the Sine Wave Explorer MicroSim

Check show plain sin(x) to keep the original wave as a dotted reference — then slide the phase and watch your wave slide left past it. These are the exact amplitude and frequency variables from the turtle project above.

Project 2 — Turtle Race Simulation

Now let's combine random and a for loop to simulate a turtle race!

Three turtles start at the left and move right in random-length hops. The first to cross x = 150 wins.

Before the code: random.randint(1, 10) gives each turtle a random step size on each turn. We check after every move whether any turtle has crossed the finish line.

▶ Run ↻ Reset

Run it several times — the winner changes each time because the steps are random!

How the Loop Breaks

The for/else pattern here is a Python trick: the else clause on a for loop runs only if the loop completed without hitting a break. So if no turtle crossed the finish line in this round, we continue the while True loop. The moment a turtle wins, we break out of both loops.

Learning Check

Your Turn — Add a Fourth Racer

The turtle race has three racers. Add a fourth turtle named t4 with color "orange", starting at y = -80. Add "Orange" to the names list and t4 to the racers list. The race should now have four competitors!

▶ Run ↻ Reset

Experiments

Try these changes. Predict what will happen first, then run it to check!

1. Change amplitude in the sine wave to 40 and frequency to 0.1. You'll know it worked when the wave is shorter and faster.

2. Draw a cosine wave by replacing math.sin with math.cos. You'll know it worked when the wave starts at its peak instead of zero.

3. Draw two waves on the same canvas — one in blue, one in red, with different amplitudes. You'll know it worked when two overlapping waves appear.

4. Make the turtle race step range wider: randint(1, 20) instead of randint(1, 10). You'll know it worked when the race finishes faster but results are more unpredictable.

5. Print math.factorial(10) and math.log(math.e). You'll know it worked when you see 3628800 and approximately 1.0.

Math Wizard!

You've built a sine wave and a turtle race using real math — that's seriously impressive! From here we move into more advanced Python: booleans, collections, and error handling. You're ready for the next level! Let's keep coding!

Take the Chapter Review Quiz

See Annotated References