#!/usr/bin/env python3
"""
Week 22: 3D Shapes
Phase 4: Geometry & Fractions
Standards: 2.G.A.1 (identify 3D shapes; faces, edges, vertices;
nets; real-world examples; compare 2D and 3D)
New Standard:
- Reduced drill (40% fewer problems)
- Estimation before counting ("Estimate First!" — guess faces/edges before counting)
- Multiple strategies (two ways to count/describe solids)
- Better word problems (reasoning, real-world scenarios)
- Open-ended challenges (Create Your Own solids/riddles)
- Number talks (reason about solids WITHOUT counting)
- Friday self-check with emoji reflection
- Fact fluency warmup daily
- Word problems every day
"""
import os
import glob
from weasyprint import HTML
from math_helpers import (
CSS, TEACHER_CSS,
page, page_multi, hdr, sec, b, bw, bl,
tg_page_multi, tg_sec, tg_note, tg_section_title,
shape_svg,
)
from activity_builders import (
build_challenge_box,
)
BASE = os.path.expanduser("~/Home_School/2nd_Grade/Math")
WEEK = os.path.join(BASE, "Week_22")
BLUE = "#4a90d9"
GREEN = "#5cb85c"
RED = "#d9534f"
ORANGE = "#f0ad4e"
PURPLE = "#9b59b6"
# ── Custom 3D shape SVGs (no 3D builders exist in activity_builders.py) ──
def cube_svg(color=BLUE, size=54):
return (f'')
def rect_prism_svg(color=GREEN, size=58):
return (f'')
def sphere_svg(color=RED, size=50):
return (f'')
def cone_svg(color=ORANGE, size=50):
return (f'')
def cylinder_svg(color=PURPLE, size=50):
return (f'')
def pyramid_svg(color=RED, size=52):
return (f'')
def cube_net_svg(color=BLUE, size=70):
"""Cross-shaped net of a cube."""
c, s = color, 16
cells = [(1, 0), (0, 1), (1, 1), (2, 1), (1, 2), (1, 3)]
rects = ''.join(
f'' for x, y in cells)
return f''
def cylinder_net_svg(color=PURPLE, size=70):
"""Net of a cylinder: rectangle + two circles."""
return (f'')
def pyramid_net_svg(color=RED, size=70):
"""Net of a square pyramid: square + 4 triangles."""
return (f'')
SOLIDS = {
"cube": cube_svg,
"rectangular prism": rect_prism_svg,
"sphere": sphere_svg,
"cone": cone_svg,
"cylinder": cylinder_svg,
"pyramid": pyramid_svg,
}
# ═══════════════════════════════════════════════════
# MONDAY — Meet the 3D Shapes
# ═══════════════════════════════════════════════════
def monday():
# 1: Fluency warmup — 2D review (bridge from Week 21)
s1 = '
'\
'
2-min Fluency Warm-up — Quick 2D review from last week!
'\
'
'
s1 += f'
Sides on a square: {b("3em")}
'
s1 += f'
Vertices on a triangle: {b("3em")}
'
s1 += f'
Sides on a hexagon: {b("3em")}
'
s1 += f'
A 5-sided polygon is a: {b("7em")}
'
s1 += '
'
# 2: New concept — 2D is flat, 3D is solid; meet the solids
s2 = '
2D shapes are flat — they live on paper. '\
'3D shapes are solid — you can hold them! Meet the six solids:
'\
'
'
for name in ["cube", "rectangular prism", "sphere", "cone", "cylinder", "pyramid"]:
s2 += f'
{SOLIDS[name](size=48)}'\
f'
{name.title()}
'
s2 += '
'
# 3: Name the solid (reduced from 8 to 5)
s3 = '
Write the name of each solid. Use the word bank: '\
'cube, sphere, cone, cylinder, pyramid.
'\
'
'
for name in ["cone", "cube", "sphere", "pyramid", "cylinder"]:
s3 += f'
{SOLIDS[name](size=46)}'\
f'
{b("7em")}
'
s3 += '
'
# 4: NEW — Number Talk
s4 = '
'\
'
Number Talk — Explain WITHOUT touching or counting.
'\
'
'
s4 += '
A sphere can roll but a cube cannot. What about their shapes '\
'makes this true?
'\
'
My thinking: ' + bw() + '
'
s4 += '
Is a circle the same as a sphere? Explain the difference '\
'between flat and solid.
'\
'
My thinking: ' + bw() + '
'
s4 += '
'
# 5: Word problem
s5 = '
'\
'
Read carefully. Think about what is happening.
'\
'
Theo is packing a box with blocks. He has 4 cubes, 3 cylinders, '\
'and 2 cones. How many solids that can ROLL does he have? '\
'(Hint: which of these solids have a curved surface?)
'\
'
My thinking: ' + bw() + '
'\
'
' + b("3em") + ' rolling solids
'
return page(22, "Monday", "Meet the 3D Shapes",
f'''{sec(1, "Warm-up: 2D Review", s1)}
{sec(2, "Flat vs. Solid: The Six Solids", s2)}
{sec(3, "Name That Solid", s3)}
{sec(4, "Number Talk: Roll or Not?", s4)}
{sec(5, "Word Problem", s5)}''')
# ═══════════════════════════════════════════════════
# TUESDAY — Faces, Edges & Vertices
# ═══════════════════════════════════════════════════
def tuesday():
# 1: Fluency warmup
s1 = '
'\
'
2-min Fluency Warm-up — Name that solid, fast!
'\
'
'
clues = [
"I look like a ball:",
"I look like a dice:",
"I look like a can:",
"I look like a party hat:",
]
for c in clues:
s1 += f'
{c} {b("6em")}
'
s1 += '
'
# 2: New words — faces, edges, vertices with guided example
s2 = '
Solids have three things we can count: '\
'• Faces — the flat sides '\
'• Edges — where two faces meet '\
'• Vertices — the pointy corners
'
s2 += f'
{cube_svg(BLUE, 64)}
'\
'
A cube has 6 faces, 12 edges, and '\
'8 vertices. Grab a dice or a block and touch each one as you count!
'
# 3: NEW — Estimate First!
s3 = '
'\
'
Estimate First! Before counting, GUESS how many faces each solid has. '\
'Then count with a real object if you can.
'\
'
'
for name in ["rectangular prism", "pyramid"]:
s3 += f'
{SOLIDS[name](size=50)}'\
f'
{name.title()}
'\
f'
My guess: {b("3em")} Actual: {b("3em")}
'
s3 += '
'
# 4: Count faces, edges, vertices (reduced from 6 to 4)
s4 = '
Fill in the table. Touch and count slowly — edges are the trickiest!
'
s4 += '
Solid
Picture
Faces
Edges
Vertices
'
rows = [
("Cube", "cube"),
("Rectangular Prism", "rectangular prism"),
("Pyramid", "pyramid"),
("Sphere", "sphere"),
]
for label, key in rows:
s4 += f'
{label}
{SOLIDS[key](size=36)}
'\
f'
{b("3em")}
{b("3em")}
{b("3em")}
'
s4 += '
'
# 5: Word problem
s5 = '
'\
'
Read carefully. Draw if it helps!
'\
'
Zara paints one sticker on every face of a cube. '\
'Stickers come in packs of 4. How many packs does she need to cover all the faces? '\
'Will she have any stickers left over?
'
# 3: Reason about nets — which faces? (two strategies)
s3 = '
'\
'
Show Two Different Ways — How can you tell the cross-shaped net folds into '\
'a cube and NOT a pyramid?
'\
'
Ideas: count the faces in the net; look at the SHAPE of each face.
'\
'
Way 1: ' + bl() + '
'\
'
Way 2: ' + bl() + '
'
# 4: Word problems (reduced from 3 to 2)
s4 = '
'\
'
Read carefully. Think about what is happening.
'\
'
'
s4 += '
A cereal box is a rectangular prism. Kim unfolds it flat to '\
'recycle it. How many rectangle faces will she see in the flattened box?
'\
'
My thinking: ' + bw() + '
'\
'
' + b("3em") + ' faces
'
s4 += '
A pyramid net has 1 square and 4 triangles. If Ben cuts out '\
'3 pyramid nets, how many triangles does he cut in all?
'\
'
My thinking: ' + bw() + '
'\
'
' + b("3em") + ' triangles
'
s4 += '
'
# 5: Challenge — Create your own
s5 = '
'\
'
Create Your Own Net
'\
'
Try to draw a net for a cube that is DIFFERENT from the cross shape above. '\
'(There are 11 different cube nets!) Remember: exactly 6 squares.
'\
''\
'
Bonus: cut it out and try folding it. Did it work? ' + bw() + '
'
return page(22, "Wednesday", "Nets: Unfolding Solids",
f'''{sec(1, "Warm-up: Face Facts", s1)}
{sec(2, "Match Nets to Solids", s2)}
{sec(3, "Show Two Different Ways", s3)}
{sec(4, "Word Problems", s4)}
{sec(5, "Challenge: Create Your Own Net", s5)}''')
# ═══════════════════════════════════════════════════
# THURSDAY — 3D Shapes in the Real World
# ═══════════════════════════════════════════════════
def thursday():
# 1: Fluency warmup
s1 = '
'\
'
2-min Fluency Warm-up — Solid math in your head.
'\
'
'
s1 += f'
Faces on 2 cubes: {b("3em")}
'
s1 += f'
Vertices on 2 pyramids: {b("3em")}
'
s1 += f'
Faces on a cube + a pyramid: {b("3em")}
'
s1 += f'
Edges on a cube − edges on a pyramid: {b("3em")}
'
s1 += '
'
# 2: Real-world matching (reduced from 8 to 5)
s2 = '
Solids are everywhere! Write which solid each object looks like.
'\
'
'
objects = [
"A basketball", "A soup can", "An ice cream cone",
"A tissue box", "The Great Pyramid in Egypt",
]
for obj in objects:
s2 += f'
{obj} = {b("8em")}
'
s2 += '
'
# 3: Compare 2D and 3D
s3 = '
2D and 3D shapes are related! The faces of solids are 2D shapes.
'\
'
'
pairs = [
("What 2D shape are the faces of a cube?", "square"),
("What 2D shape is the flat face of a cone?", "circle"),
("What 2D shapes make a pyramid's faces?", "square + triangles"),
("What 2D shape do you see at the ends of a cylinder?", "circle"),
]
for q, _ in pairs:
s3 += f'
{q}
{b("7em")}
'
s3 += '
'
# 4: NEW — Number Talk
s4 = '
'\
'
Number Talk — Explain WITHOUT counting.
'\
'
'
s4 += '
A cube and a rectangular prism have the same number of faces, '\
'edges, and vertices. Why do you think that is?
'\
'
My thinking: ' + bw() + '
'
s4 += '
Which would stack better in a cupboard: cans (cylinders) or '\
'balls (spheres)? Explain using faces and curves.
'\
'
My thinking: ' + bw() + '
'
s4 += '
'
# 5: Word problem + create your own
s5 = '
'\
'
Read carefully. Then create your own!
'\
'
A grocery store stacks 5 soup cans in a row. Each can has 2 circle '\
'faces (top and bottom). How many circle faces are in the whole row?
'\
'
My thinking: ' + bw() + '
'\
'
' + b("3em") + ' circle faces
'\
'
'\
'
Create Your Own — Go on a 3D shape hunt in your house! '\
'Find one real object for each solid and write it down.
'
return page(22, "Thursday", "3D Shapes in the Real World",
f'''{sec(1, "Warm-up: Solid Math", s1)}
{sec(2, "Real-World Solids", s2)}
{sec(3, "Compare 2D and 3D", s3)}
{sec(4, "Number Talk: Reason About Solids", s4)}
{sec(5, "Word Problem & Shape Hunt", s5)}''')
# ═══════════════════════════════════════════════════
# FRIDAY — Review & Self-Check
# ═══════════════════════════════════════════════════
def friday():
# 1: Fluency warmup
s1 = '
'\
'
2-min Fluency Warm-up — Go fast!
'\
'
'
s1 += f'
Faces on a cube: {b("3em")}
'
s1 += f'
A ball is shaped like a: {b("6em")}
'
s1 += f'
Edges on a cube: {b("3em")}
'
s1 += f'
Vertices on a pyramid: {b("3em")}
'
s1 += '
'
# 2: Estimate First! review
s2 = '
'\
'
Estimate First! A rectangular prism and a cube are glued together side by side. '\
'Guess how many faces you could touch on the outside, then talk it through with your teacher.
'\
'
My guess: ' + b("4em") + ' After discussing: ' + b("4em") + '
'
# 3: Mixed review table (reduced from 6 to 3)
s3 = '
Review: fill in the table. Use a real object if it helps!
'
s3 += '
Solid
Picture
Faces
Edges
Vertices
Real-world example
'
for label, key in [("Cube", "cube"), ("Pyramid", "pyramid"), ("Cylinder", "cylinder")]:
s3 += f'
{label}
{SOLIDS[key](size=34)}
'\
f'
{b("2.5em")}
{b("2.5em")}
{b("2.5em")}
{b("6em")}
'
s3 += '
'
s3 += '
Hint for the cylinder: count only the FLAT faces.
'
# 4: Word problem review
s4 = '
'\
'
Read carefully. Show your work.
'\
'
Milo builds a tower with 3 cubes stacked on top of each other. '\
'He wants to put a sticker on every face he can still SEE (the bottom of the tower and '\
'the hidden faces between cubes don\'t count). How many stickers does he need?
'\
'
Draw or write your thinking: ' + bw() + '
'\
'
' + b("3em") + ' stickers
'
# 5: Self-check with emoji reflection
s5 = '
'\
'
Self-Check: How do you feel about 3D shapes?
'\
'
'\
'
'\
'
Naming Solids
'\
'
😊 I got it! | 😐 Getting there | 😟 Need help
'\
'
'\
'
'\
'
Counting Faces, Edges & Vertices
'\
'
😊 I got it! | 😐 Getting there | 😟 Need help
'\
'
'\
'
'\
'
Matching Nets to Solids
'\
'
😊 I got it! | 😐 Getting there | 😟 Need help
'\
'
'\
'
'\
'
One thing I learned this week: ' + bl() + '
'\
'
One thing I want to practice more: ' + bl() + '
'\
'
My favorite solid and where I saw one in real life: ' + bl() + '
'\
'
'
return page(22, "Friday", "Week 22 Review & Self-Check",
f'''{sec(1, "Warm-up: Solid Facts", s1)}
{sec(2, "Estimate First!", s2)}
{sec(3, "Faces, Edges & Vertices Review", s3)}
{sec(4, "Word Problem", s4)}
{sec(5, "Self-Check & Reflection", s5)}''')
# ═══════════════════════════════════════════════════
# TEACHER GUIDE
# ═══════════════════════════════════════════════════
def teacher_guide():
return tg_page_multi(
"Week 22", "3D Shapes — Teacher Guide",
tg_section_title("Monday: Meet the 3D Shapes") +
tg_sec(1, "Warm-up 2D Review", ["4, 3, 6, pentagon"]) +
tg_sec(2, "The Six Solids", ["Vocabulary intro — no answers needed"]) +
tg_sec(3, "Name That Solid", ["cone, cube, sphere, pyramid, cylinder"]) +
tg_sec(4, "Number Talk", ["Sphere is curved all over; cube has flat faces that stop it", "Circle is flat (2D); sphere is solid (3D)"]) +
tg_sec(5, "Word Problem", ["Cylinders and cones roll: 3+2 = 5"]) +
tg_note("Page break"),
tg_section_title("Tuesday: Faces, Edges & Vertices") +
tg_sec(1, "Warm-up Riddles", ["sphere, cube, cylinder, cone"]) +
tg_sec(2, "New Words", ["Cube: 6 faces, 12 edges, 8 vertices"]) +
tg_sec(3, "Estimate First", ["Rect. prism: 6 faces; pyramid: 5 faces"]) +
tg_sec(4, "Count Table", ["Cube 6/12/8; Rect prism 6/12/8; Pyramid 5/8/5; Sphere 0/0/0"]) +
tg_sec(5, "Word Problem", ["6 faces ÷ 4 per pack → 2 packs, 2 stickers left over"]) +
tg_note("Page break"),
tg_section_title("Wednesday: Nets") +
tg_sec(1, "Warm-up", ["6, 8, 0, 1"]) +
tg_sec(2, "Match Nets", ["Cross net → cube; circles+rectangle → cylinder; square+4 triangles → pyramid"]) +
tg_sec(3, "Two Ways", ["6 faces, not 5; all faces are squares, not triangles"]) +
tg_sec(4, "Word Problems", ["6 rectangle faces", "4×3 = 12 triangles"]) +
tg_sec(5, "Create Own Net", ["Any valid 6-square arrangement; encourage cut-and-fold test"]) +
tg_note("Page break"),
tg_section_title("Thursday: Real World") +
tg_sec(1, "Warm-up Solid Math", ["12, 10, 11, 12−8=4"]) +
tg_sec(2, "Real-World", ["sphere, cylinder, cone, rectangular prism, pyramid"]) +
tg_sec(3, "2D and 3D", ["square, circle, square + triangles, circle"]) +
tg_sec(4, "Number Talk", ["Same structure — prism is a stretched cube", "Cans — flat circle faces stack; spheres roll away"]) +
tg_sec(5, "Word Problem & Hunt", ["5×2 = 10 circle faces; accept any correct household objects"]) +
tg_note("Page break"),
tg_section_title("Friday: Review & Self-Check") +
tg_sec(1, "Warm-up", ["6, sphere, 12, 5"]) +
tg_sec(2, "Estimate First", ["Discussion question — glued pair shows 10 outside faces"]) +
tg_sec(3, "Review Table", ["Cube 6/12/8; Pyramid 5/8/5; Cylinder 2 flat faces, 0 edges/vertices (2nd-grade convention); examples vary"]) +
tg_sec(4, "Word Problem", ["Tower of 3 cubes: 4 sides × 3 + 1 top = 13 stickers"]) +
tg_sec(5, "Self-Check", ["Accept student self-assessment and reflection"])
)
# ═══════════════════════════════════════════════════
# GENERATE
# ═══════════════════════════════════════════════════
if __name__ == "__main__":
os.makedirs(WEEK, exist_ok=True)
for f in glob.glob(os.path.join(WEEK, "*.pdf")):
os.remove(f)
for f in glob.glob(os.path.join(WEEK, "*.html")):
os.remove(f)
days = [
(monday, "Monday", "Meet the 3D Shapes"),
(tuesday, "Tuesday", "Faces, Edges & Vertices"),
(wednesday, "Wednesday", "Nets: Unfolding Solids"),
(thursday, "Thursday", "3D Shapes in the Real World"),
(friday, "Friday", "Week 22 Review & Self-Check"),
]
for lesson_func, day, title in days:
html = lesson_func()
fname = f"Week_22_{day}"
path = os.path.join(WEEK, f"{fname}.html")
with open(path, "w") as f:
f.write(html)
pdf_path = os.path.join(WEEK, f"{fname}.pdf")
HTML(filename=path).write_pdf(pdf_path)
print(f"Generated: {pdf_path}")
html = teacher_guide()
path = os.path.join(WEEK, "Week_22_Teacher_Guide.html")
with open(path, "w") as f:
f.write(html)
pdf_path = os.path.join(WEEK, "Week_22_Teacher_Guide.pdf")
HTML(filename=path).write_pdf(pdf_path)
print(f"Generated: {pdf_path}")
print("\nWeek 22 (new standard) complete!")