Files
roam/thesis.org
T
2026-07-25 14:39:02 +03:00

4.2 KiB
Raw Blame History

thesis

thesis

BGU MSc thesis on the ROLL method (Rate Optimized Likelihood Loss). See impl for the implementation project this thesis documents.

Architecture

  • main.tex — root document; defines all title/author/supervisor commands, includes all chapters
  • Main_pages/ — cover_page, title_page, abstract, acknowledgements, abstract_heb, cover_heb
  • content/<chapter>/ — one folder per chapter with its own .tex file
  • content/images/ — shared image path (set via \graphicspath)
  • bibliography/thesis.bib — references
  • bibliography/unsrtnat_adjusted_for_bgu_thesis.bst — custom BGU bibliography style (do not edit)

Conventions

  • Thesis metadata (title, author, supervisor, month, year) defined as commands at top of main.tex
  • Hebrew title/author/supervisor have he suffix commands (\thesistitlehe, etc.)
  • Both English and Hebrew ToC, abstract, and cover pages are required by BGU
  • Chapters added via \input{content/<chapter>/<chapter>} with a matching \addtocontents{tocheb} line
  • Build engine: pdflatex (uses \usepackage[utf8x]{inputenc}, not xelatex)
  • Math notation: data points are bold (\mathbf{x}_i); batches are \mathcal{B}_0 / \mathcal{B}_1
  • KDE background (general technique) in Ch. 2 (sec:kde-background); Ch. 3 back-references it; Ch. 2 ends with forward pointer to sec:roll-kde
  • sec:imbalanced-tpr-fpr and sec:neyman-pearson live in Ch. 2; Ch. 3 sec:problem-formulation \Cref's them — do not rename

Chapter Structure

See subnodes for per-chapter guidelines and section details.

Ch. Title File Target
1 Introduction content/introduction/introduction.tex 46 pp
2 Background / Related Work content/related_work/related_work.tex 1520 pp
3 Method content/method/method.tex ~30 pp
4 Experiments content/experiments/experiments.tex 1520 pp
56 Discussion + Conclusion content/discussion_and_conclusions/ 812 pp

Gotchas

  • Template uses utf8x inputenc, which requires the ucs nix/texlive package
  • Hebrew rendering via babel-hebrew (pdflatex approach, not fontspec/xelatex)
  • Example images in content/related_work/images/ are from the template — safe to delete
  • flake.nix uses rec on the derivation so buildInputs is in scope for PATH export
  • nix develop devShell includes python3+sympy — use it to verify math claims, never check mentally
  • KDE backward pass uses inverse-function-theorem approach deliberately (user must explain it verbally)
  • Correct gradient of threshold w.r.t. negative-class score: σ'(τ−x_i) / Σ_j σ'(τ−x_j) — sympy-verified
  • (NIX BUILD) New .tex files must be git add'ed before nix build. Nix flakes use git to enumerate source files; untracked files are invisible to the build. Symptom: silent LaTeX failure — TOC, LoF, and LoT all appear empty in the output PDF. Fix: git add <new-file>, then rebuild.

Key Files

  • flake.nix — Nix build; nix build produces result/main.pdf; nix develop for dev shell
  • flake.lock — pinned to nixpkgs-unstable as of 2026-06-16
  • main.tex — fill in \thesistitle, \thesisauthorname, \thesissupervisername, \thesismonth, \thesisyear

Subnodes

todo

TODO Basic structure - take it into account

TODO Import and make sense of all references

TODO Continue to auto-summarize references continuously