Skip to content

Missing Figure Files Causing LaTeX Compilation Failures #61

@nipunbatra

Description

@nipunbatra

Missing Figure Files Causing LaTeX Compilation Failures

Summary

Comprehensive audit revealed 84 missing figure files across 16 LaTeX files that will cause compilation failures. These need to be addressed to ensure slides and content can be properly built.

Critical Files Affected

🔴 High Priority (Multiple Missing Figures)

unsupervised/slides/unsupervised.tex - 10 missing figures

  • gt_iris.png
  • k_1.png
  • k_ex_6.png
  • k_ex_5.png
  • k_ex_4.png
  • k_ex_3.png
  • k_bad_1.png
  • k_bad_2.png
  • h_e_1.png
  • h_e_2.png

supervised/slides/svm-kernel.tex - 11 missing figures

  • pik1.png through pik11.png

supervised/slides/bias-variance.tex - 20 missing figures

  • dataset-1
  • example-1-depth-1-boundary
  • example-1-depth-1-decision-tree
  • example-1-nolimit-boundary
  • example-1-nolimit-decision-tree
  • dataset-2-train
  • dataset-2-test
  • example-2-depth-1-boundary
  • example-2-depth-1-decision-tree
  • example-2-nolimit-boundary
  • dataset-2-train-var
  • var_1
  • var_2
  • example-2-optimal-boundary
  • example-2-optimal-tree
  • acc-depth-plot
  • acc-depth-plot-underfit
  • acc-depth-plot-overfit
  • acc-depth-plot-properfit

advanced/slides/forecasting.tex - 10 missing figures

  • forecast
  • domain
  • properties
  • cyclic-seasonal
  • no-pattern
  • forecast-naive
  • timseries-cv1
  • timseries-cv2
  • stationary (appears twice)
  • acfstationary

optimization/slides/convexity.tex - 9 missing figures

  • fig1
  • y-x2
  • y-absx
  • y-ex
  • y-logx
  • y-x3_pos
  • y-x3_neg
  • y-x3
  • proof_notation_fig

🟡 Medium Priority (3-5 Missing Figures)

maths/slides/mvn.tex - 5 missing figures

  • fig1
  • fig2
  • fig3
  • cross-non-zero
  • cross-0

supervised/slides/ridge-regression.tex - 4 missing figures

  • ridge/ridge_1_16.pdf
  • ridge/ridge_100_16.pdf
  • ridge/ridge_100000_16.pdf
  • ../assets/ridge-regression/figures/temp.pdf

optimization/slides/subgradient.tex - 4 missing figures

  • subgradient_1.pdf
  • subgradient_2.pdf (appears twice)
  • subgradient_3.pdf

supervised/slides/ensemble.tex - 4 missing figures

  • ../figures/decision-trees/entropy.pdf
  • ../assets/ensemble/figures/feature-imp-\thetree.pdf (appears twice)
  • feature-importance.pdf

maths/slides/kkt-conditions.tex - 3 missing figures

  • img1
  • img2
  • img3

🟢 Low Priority (1-2 Missing Figures)

supervised/slides/lasso-regression.tex - 2 missing figures

  • Lasso/lasso_2.png
  • Lasso/lasso_3.png

basics/slides/shuffling.tex - 1 missing figure

  • img1

supervised/slides/logistic-regression.tex - 1 missing figure

  • ../assets/logistic-regression/figures/logistic-likelihood.pdf

supervised/slides/decision-trees.tex - 1 missing figure

  • ../assets/decision-trees/figures/dt-\i.pdf

optimization/slides/gradient-descent.tex - 1 missing figure

  • ../../maths/assets/mathematical-ml/figures/gradient-descent-\i.pdf

COMPILATION_ISSUES.md - 1 missing figure

  • filename.pdf (likely a placeholder/example)

Recommended Action Plan

Phase 1: Critical Fixes (Immediate)

  1. Create placeholder figures for the most critical files to enable compilation
  2. Identify source files - check if figures exist elsewhere in repository
  3. Update figure paths - verify if figures exist but paths are incorrect

Phase 2: Figure Generation (Within 1 week)

  1. Regenerate missing figures using existing code/notebooks
  2. Create new figures where originals are lost
  3. Standardize figure formats (prefer PDF for vector graphics, PNG for screenshots)

Phase 3: Path Verification (Within 2 weeks)

  1. Audit all \includegraphics paths for consistency
  2. Establish standard figure directory structure
  3. Update \graphicspath commands where needed

Technical Notes

  • Most missing figures appear to be:

    • Generated plots (bias-variance examples, optimization visualizations)
    • Diagram illustrations (SVM kernel examples, clustering results)
    • Example datasets (iris plots, decision boundaries)
  • Common file extensions expected:

    • .pdf for vector graphics and plots
    • .png for screenshots and complex visualizations
    • .eps for some legacy figures

Impact Assessment

Compilation Risk: HIGH - These missing figures will cause pdflatex to fail
Student Experience: MEDIUM - Missing visual aids reduce learning effectiveness
Maintenance: HIGH - Broken builds make content updates difficult

Related Issues

This issue should be addressed before:

  • Any major content updates
  • Publication of course materials
  • Setting up automated builds

Next Steps: Assign team members to specific files and begin with Phase 1 placeholder creation to restore compilation capability.

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions