AbzumsAI Assignments

I use this repo for course assignment PDFs, LaTeX sources, and a few notebook based tasks.

Files

• Root PDF files are the shared assignment handouts.
• Assignment*/HW.tex files are the main LaTeX sources.
• Assignment*/Solution.tex files build worked answer PDFs when present.
• Assignment*/questions keeps question text split by problem.
• Assignment*/answers keeps answer hints or solution material when available.
• Root notebook files are used for programming assignments that need code cells.
• Assignment14.ipynb and Assignment15.ipynb are the root notebook handouts.
• Assignment14 and Assignment15 have checked notebook based solutions.
• Assignment15.ipynb needs AVALAI_API_KEY. It also accepts AVALAI_BASE_URL when a class setup uses a different endpoint.
• NumpyProblem and PandasProblem are rebuilt editable versions of PDF only assignments.
• MachineLearningHomework has the final project handout, dataset, data dictionary, and a checked starter analysis.

Build A LaTeX Assignment

From the repo root, move into the assignment folder and run latexmk:

cd Assignment1
latexmk -pdfxe -interaction=nonstopmode -halt-on-error HW.tex

If you only need a temporary check, build into a local folder:

latexmk -pdfxe -interaction=nonstopmode -halt-on-error -outdir=build HW.tex

Generated build files should stay out of commits unless a root PDF needs to be updated.

To build a solution source from the repo root:

powershell -ExecutionPolicy Bypass -File .\scripts\build-solution.ps1 -Name Assignment1

To check notebook handouts and notebook solution files:

python scripts\check-assignment-notebooks.py
python scripts\check-notebook-solutions.py