Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

Simulating Computer Systems

Workspace for rebuilding simulatingcomput00myro_1-1.pdf as editable LaTeX, plus Python queueing simulations. Text, mathematics, tables, and source listings are typeset rather than embedded as scanned pages. Figures are vector drawings or individual cropped figure assets, not complete page images.

Quick start

  • Load the Nix, devenv, and direnv environment:
    • direnv allow, then just setup
    • just dev opens the environment without direnv.
  • Build LaTeX (latexmk):
    • just build-latex
  • Build LaTeX (tectonic):
    • just build-tectonic

Both build commands produce build/simulating-computer-systems.pdf. The original scan is used for transcription and checking, not as a build input. See reconstruction status for coverage and remaining verification work.

Layout

  • docs/latex/: LaTeX project (entry: main.tex)
  • docs/latex/chapters/: Editable chapter files
  • docs/latex/listings/: Transcribed original C listings
  • docs/latex/figures/: Extracted images/figures
  • build/: Build output (ignored)
  • src/, tests/: Python simulations and tests

Extraction helpers

  • Text extraction (first 5 pages):
    • just extract-text
  • Image extraction:
    • just extract-images
  • OCR a single image:
    • just ocr docs/latex/figures/page-000.png page-000

Notes

  • If tectonic cannot find a package, use latexmk (TeX Live full) for maximum compatibility.
  • The dev shell includes poppler_utils (pdftotext/pdfimages) and tesseract for OCR.

Python development

just run starts the single-server queue simulation from scs.sim1. just check runs its tests and the installed CLI. just update refreshes the Nix and Python dependency locks.

The extraction and OCR recipes require the original PDF in the repository root as simulatingcomput00myro_1-1.pdf. That input is not included in this checkout.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages