Skip to content

structural-explainability/se-mapping-education-math-g8

Repository files navigation

se-mapping-education-math-g8

Docs Site Repo Python 3.15+ License

CI Validate Docs Links

Structural Explainability Mapping: Education Math Grade 8

Grade 8 mathematics pilot mappings for linear equations and statistics.

Mapping example repositories include minimal ctx declarations sufficient for self-contained validation and traceability. Full source registries, dashboards, analytics, and public participation systems belong in downstream organizations.

This repository illustrates multiple alignment types:

  • NAEP / CCSS are grade-aligned
  • Finland / Norway are band-aligned
  • PISA is age-aligned
  • Singapore is track + year (mapped approximately to grade)

Coverage Matrix

See coverage matrix

This matrix is a draft structural coverage artifact. It shows declared mapping relations between source systems (CTX) and normalized targets (NOR). It does not evaluate curriculum quality, instructional effectiveness, or student performance.

Observed characteristics:

  • NAEP is broad/aggregated: mostly overlaps
  • Singapore is explicit for mean/median and data display
  • CCSS contributes compare/displays and systems
  • Finland / Norway are band-based and mostly overlaps
  • Linear inequality appears only through NAEP so far

Owns

  • Grade 8 mathematics pilot mappings
  • NOR units for the pilot scope
  • coverage matrix artifacts

Includes

NOR scope

  • linear equations
  • systems of linear equations
  • statistics and probability

Source contexts

  • NAEP Grade 8 mathematics
  • CCSS Grade 8 mathematics
  • selected international systems (Finland, Norway, PISA, Singapore)

Derived outputs

  • coverage matrix
  • validation reports
  • mapping examples

Does Not Include

  • complete K-12 mathematics coverage
  • full source registries
  • dashboards or public interfaces
  • student outcome analysis
  • policy interpretation or recommendations

Command Reference

Show command reference

In a machine terminal

After you get a copy of this repo in your own GitHub account, open a machine terminal in Repos or where you want the project:

# Replace username with YOUR GitHub username.
git clone https://github.com/username/se-mapping-education-math-g8

cd se-mapping-education-math-g8
code .

In a VS Code terminal

uv self update
uv python pin 3.15
uv sync --extra dev --extra docs --upgrade

uvx pre-commit install

git add -A
uvx pre-commit run --all-files
# repeat if changes were made
git add -A
uvx pre-commit run --all-files

# run
uv run python -m se_mapping_education_math_g8 sort
uv run python -m se_mapping_education_math_g8 validate
uv run python -m se_mapping_education_math_g8 matrix
uv run python -m se_mapping_education_math_g8 verify-regimes

# do chores
npx markdownlint-cli "**/*.md" --fix
uv run python -m ruff format .
uv run python -m ruff check . --fix
uv run python -m pyright
uv run python -m pytest
uv run python -m zensical build

# save progress
git add -A
git commit -m "update"
git push -u origin main

Citation

CITATION.cff

License

LICENSE

Manifest

SE_MANIFEST.toml

Contributors

Languages