feat: data & graphing science week + bar-graph/pictograph renderers - #93
Merged
Conversation
Adds a 5-day "Data Detectives" science week (grades 1-2, narrator Dot the Ladybug) with a heavy focus on making and interpreting graphs. Arc: observe & count -> record in a table -> pictograph -> bar graph -> run a full experiment and graph the results (Ramp Race, Paper Airplane Contest). To render real graphs, extends the shared HTML renderer with two new worksheet kinds used by the packet (and available to the API weekly-plan flow): - barGraphWorksheet: axed/titled plot with countable gridlines; blank mode (student colours bars from their data) and pre-filled mode (student reads the bars); optional interpretation questions. - pictographWorksheet: keyed picture graph with per-symbol scaling; blank (draw) and pre-filled (read) modes; optional questions. Includes renderer tests for both kinds and an embedded teacher guide with answer keys, misconceptions, and extensions. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
A 5-day "Data Detectives" science week for grades 1–2 with a heavy focus on making and interpreting graphs, narrated by Dot the Ladybug (a tiny "data detective").
Causal arc: observe & count → record data in a table → show data as a pictograph → show & read data as a bar graph → run a full experiment and graph the results.
Each day is hands-on: kids collect their own data (a counting hunt, a Ramp Race, a Paper Airplane Contest), graph it, and then read what the graph says (most / least / how many more / how many altogether).
Why a renderer change
None of the existing HTML worksheet kinds can draw a graph, and content fields are HTML-escaped — so a week about graphing couldn't show a graph to read or a grid to plot on. This PR adds two new kinds to the shared
worksheet_html_renderer.py(also usable by the API weekly-plan flow):barGraphWorksheet— axed, titled plot with countable gridlines. Blank mode = student colours bars from their data; pre-filled mode = student reads the bars. Optional interpretation questions.pictographWorksheet— keyed picture graph with per-symbol scaling (e.g. each 🐛 = 2). Blank (draw) and pre-filled (read) modes. Optional questions.Standards touched: CCSS.Math 1.MD.C.4 & 2.MD.D.10 (represent & interpret data); NGSS K–2 practices (analyzing/interpreting data, fair tests).
Files
src/worksheet_html_renderer.py— two new render fns + CSS + dispatch entries (additive; existing kinds untouched).tests/test_html_graph_worksheets.py— 6 tests (blank/pre-filled bar graph, scaled pictograph, dispatch registration, value clamping).scripts/generate_data_week_series.py— the week generator (student packet + embedded teacher guide). Output dir is gitignored; the script fully reproduces the week.Validation
venv/bin/python scripts/generate_data_week_series.py→ 15 pages, exit 0.🤖 Generated with Claude Code