Commit Graph

21 Commits

Author SHA1 Message Date
Vijay Janapa Reddi
c9d21b768b feat(binder): add render plots command for matplotlib figure gallery
Integrate figure rendering into the binder CLI so plots can be previewed
without a full Quarto build. Extracts Python code blocks with fig-* labels
from QMD files, renders them to PNG, and outputs a browsable gallery at
_output/plots/<chapter>/. Also fixes the package import chain so `binder`
works correctly as an installed entry point.

- Add book/cli/commands/render.py with RenderCommand class
- Wire into main.py with help table entry and command dispatch
- Add matplotlib>=3.7.0 to pyproject.toml dependencies
- Add book/quarto/_output/ to .gitignore
- Archive standalone render_figures.py to _archive/
2026-02-14 12:43:23 -05:00
Vijay Janapa Reddi
e3cc9f7af3 refactor: rename ml_ml_workflow files, consolidate CLI, and clean up scripts
Remove redundant ml_ prefix from ml_workflow chapter files and update all
Quarto config references. Consolidate custom scripts into native binder
subcommands and archive obsolete tooling.
2026-02-13 11:06:28 -05:00
Vijay Janapa Reddi
2390c3ab31 Refactor: consolidate Quarto config layers and content reorganization.
Unifies Quarto metadata into shared base/format/volume fragments while carrying through chapter path, asset, and tooling updates to keep the repository consistent and easier to maintain.
2026-02-12 15:38:55 -05:00
Vijay Janapa Reddi
f136f96fd8 Refactor: Rename library to and introduce Digital Twins
Renamed the core physics engine from  to  to better align with
the book's title and pedagogical goals.

New features:
- Introduced  and  classes in  and .
- Digital twins now carry their own attributes (bandwidth, FLOPS) and
  methods (ridge_point, memory_size).
- Global search and replace updated all 16 chapters to use .
- Maintained backward compatibility for legacy constants during migration.
2026-02-10 16:46:37 -05:00
Vijay Janapa Reddi
b43f8e887d Editorial pass across Vol 1 chapters and config
- Revise prose, index entries, and references across all 16 chapters
- Update quarto config (epub/html) for vol1 and vol2
- Add render_figures.py testing script
- Update inject_parts.lua filter and header-includes.tex
- Update notation, appendix_dam, and references.bib
- Remove vol1/vol2 foreword files
2026-02-08 17:18:42 -05:00
Vijay Janapa Reddi
4f9409380d updates 2026-02-08 14:01:59 -05:00
Vijay Janapa Reddi
3173b403d6 first pass 2026-02-08 11:11:44 -05:00
Vijay Janapa Reddi
51e720714d Add D·A·M Venn diagram and widen ML stack data bar connectors
- Widen gap between ML systems stack layers and data bar in both
  margin and full-size variants so connector lines are clearly visible
- Add D·A·M Intersection Landscape Venn diagram (SVG + PNG) to the
  D·A·M Taxonomy appendix with reference table and explanatory prose
- Add forward references to the Venn from Introduction and Part III
- Add learning objective for intersection mapping
- Chapter prose refinements across multiple chapters
2026-02-08 09:30:47 -05:00
Vijay Janapa Reddi
17ebb4f734 chore: remove testing logs from tracking 2026-02-02 06:51:35 -05:00
Vijay Janapa Reddi
baf420b0ce fix: resolve pre-commit hook issues and add figure accessibility
- Fix footnotes incorrectly breaking into definition text (appendix_machine, appendix_algorithm)
- Move forbidden footnotes out of callout divs (hw_acceleration, serving, training)
- Convert inline footnote info to inline text where appropriate
- Add fig-alt text to code-cell figures (dl_primer, hw_acceleration, serving, workflow)
- Add fig-cap and fig-alt to TikZ figures (distributed_training, introduction, edge_intelligence, networking, sustainable_ai)
- Fix hook ordering: Black formatter now runs before blank line collapse
- Move footnote definition outside TikZ div in frameworks.qmd
2026-02-02 06:49:30 -05:00
Vijay Janapa Reddi
a75e8b80e5 Update book chapters and clean up testing artifacts
- Update all vol1 and vol2 chapter content with formatting improvements
- Add pre-commit hooks for additional validation checks
- Remove obsolete testing artifacts (appendix_dam, appendix_data, dl_primer, glossary)
- Add new testing logs for vol2 chapters and appendix_assumptions/notation
- Add utility scripts for table rendering checks and prettification
- Remove deprecated hw_acceleration.rmarkdown file
2026-02-01 23:28:30 -05:00
Vijay Janapa Reddi
89df0affb4 Replace LaTeX symbols with Unicode near inline Python
Use Unicode symbols to prevent decimal point stripping:
- × instead of $\times$
- ≈ instead of $\approx$
- ≪ instead of $\ll$
- μ instead of $\mu$
- 10⁹, 10⁶ for powers

LaTeX parsing was interfering with inline Python output,
causing "5.9" to render as "59". Unicode symbols avoid this.

Verified via HTML render - all computed values correct.
2026-02-01 20:50:28 -05:00
Vijay Janapa Reddi
823e83fbfa Improves chapter build debugging and artifact handling
Refactors the build chapter script to handle variations in output file names, ensuring accurate success detection and artifact copying.

The changes involve using glob patterns to identify output files (PDF, EPUB, HTML, TeX) instead of relying on fixed names.
This addresses the issue where file names might differ, leading to false negatives during build verification.

Additionally, the commit enhances the artifact copying process by using glob to copy generated PDF and tex files (allowing different names).

Finally, it enhances the debugging process by allowing the use of the --only flag to bypass the normal exclusion list of chapters.
2026-02-01 19:31:27 -05:00
Vijay Janapa Reddi
88a48269a1 Remove temporary analysis files, preview plots, and build artifacts 2026-02-01 17:39:58 -05:00
Vijay Janapa Reddi
2b1490dcc8 Vol 1 chapter flow improvements, expanded references, and audit tooling
- Update chapter flow and narrative across conclusion, data_selection,
  dnn_architectures, model_compression, training, and 10+ other chapters
- Expand references.bib with additional ML systems and foundations entries
- Add new appendix content: assumptions, DAM framework, notation guide
- Update Quarto configs for PDF, HTML, and EPUB builds
- Add audit scripts for figures, tables, listings, and narrative analysis
- Add chapter flow analysis reports for systematic content review
- Include calc modules for hw_acceleration and appendix_algorithm
- Remove deprecated foreword.qmd and vol2 appendix_a.qmd
2026-02-01 17:39:17 -05:00
Vijay Janapa Reddi
f7a6142cef Update Vol 1 content and clean up build artifacts
Content updates:
- Fix cross-references across multiple chapters
- Update glossary entries and JSON files
- Revise about page and frontmatter
- Minor fixes to introduction, frameworks, serving, training chapters
- Update config files for epub, html, and pdf builds

Cleanup:
- Remove testing log artifacts (Machine-Learning-Systems.tex files)
2026-01-30 15:53:50 -05:00
Vijay Janapa Reddi
5774413e33 Update two-volume content, config, tooling, and rename data_efficiency to data_selection
- Update Quarto config for epub, html, and pdf Vol 1 builds
- Rename data_efficiency chapter to data_selection with updated content
- Edit chapters across Vol 1 and Vol 2 for clarity and consistency
- Add references, glossary updates, and new debug build script
- Update pre-commit config and part intro narratives
2026-01-30 07:20:45 -05:00
Vijay Janapa Reddi
43db5dcc85 feat: complete detailed review of Volume 1 chapters, confirming alignment with engineering standards 2026-01-28 13:42:06 -05:00
Vijay Janapa Reddi
844ca48d5a Add missing citations and enhance debug chapter build script
- Add 4 missing citations to vol1 references.bib:
  - brutlag2009speed: Google latency study
  - dosovitskiy2020image: Vision Transformer (ViT) paper
  - linden2006marissa: Marissa Mayer Web 2.0 latency findings
  - buolamwini2018: Gender Shades facial recognition bias study

- Update debug_chapter_builds.py:
  - Add -v/--verbose flag for detailed build output
  - Create chapter-specific log directories (logs/vol1/<chapter>/)
  - Save build artifacts (index.tex, index.log) for debugging
  - Fix artifact path to look in quarto/ for PDF builds
2026-01-27 08:08:30 -05:00
Vijay Janapa Reddi
853eb03ee8 style: apply consistent whitespace and formatting across codebase 2025-12-13 14:05:34 -05:00
Vijay Janapa Reddi
7b92e11193 Repository Restructuring: Prepare for TinyTorch Integration (#1068)
* Restructure: Move book content to book/ subdirectory

- Move quarto/ → book/quarto/
- Move cli/ → book/cli/
- Move docker/ → book/docker/
- Move socratiQ/ → book/socratiQ/
- Move tools/ → book/tools/
- Move scripts/ → book/scripts/
- Move config/ → book/config/
- Move docs/ → book/docs/
- Move binder → book/binder

Git history fully preserved for all moved files.

Part of repository restructuring to support MLSysBook + TinyTorch.

Pre-commit hooks bypassed for this commit as paths need updating.

* Update pre-commit hooks for book/ subdirectory

- Update all quarto/ paths to book/quarto/
- Update all tools/ paths to book/tools/
- Update config/linting to book/config/linting
- Update project structure checks

Pre-commit hooks will now work with new directory structure.

* Update .gitignore for book/ subdirectory structure

- Update quarto/ paths to book/quarto/
- Update assets/ paths to book/quarto/assets/
- Maintain all existing ignore patterns

* Update GitHub workflows for book/ subdirectory

- Update all quarto/ paths to book/quarto/
- Update cli/ paths to book/cli/
- Update tools/ paths to book/tools/
- Update docker/ paths to book/docker/
- Update config/ paths to book/config/
- Maintain all workflow functionality

* Update CLI config to support book/ subdirectory

- Check for book/quarto/ path first
- Fall back to quarto/ for backward compatibility
- Maintain full CLI functionality

* Create new root and book READMEs for dual structure

- Add comprehensive root README explaining both projects
- Create book-specific README with quick start guide
- Document repository structure and navigation
- Prepare for TinyTorch integration
2025-12-05 14:04:21 -08:00