:PROPERTIES:
:ID: 6294e2be-6189-4473-b363-a1dd9a75ff9b
:END:

#+title: thesis
#+filetags: :project: :knowledge:

* thesis

BGU MSc thesis on the ROLL method (Rate Optimized Likelihood Loss). See [[id:d23011c5-d925-4f14-b05a-0a1f4bdbe860][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= | 4–6 pp |
| 2 | Background / Related Work | =content/related_work/related_work.tex= | 15–20 pp |
| 3 | Method | =content/method/method.tex= | ~30 pp |
| 4 | Experiments | =content/experiments/experiments.tex= | 15–20 pp |
| 5–6 | Discussion + Conclusion | =content/discussion_and_conclusions/= | 8–12 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

- [[id:c4a0d60f-49d3-4185-8c5b-f8a5a10a2ccc][thesis/introduction]] — Ch. 1 guidelines: structure, length, what to include
- [[id:cd785954-008e-4b64-957d-25d1dbeac127][thesis/related-work]] — Ch. 2 section structure, placement markers, label conventions
- [[id:0543ac39-af9b-40fd-9973-e60576a20695][thesis/method]] — Ch. 3 section status table, derivation gotchas
- [[id:59f84838-71a9-4aab-a494-8e6bea2080fb][thesis/experiments]] — Ch. 4 guidelines: datasets, baselines, metrics
- [[id:9b50caf2-d259-4848-b7f5-22a9288e8ba2][thesis/discussion]] — Ch. 5–6 guidelines: failure modes, future work
- [[id:151159e8-1105-4a84-af9c-72d31c5e0660][thesis/todos]] — project TODOs

* todo

** TODO Basic structure - take it into account
** TODO Import and make sense of all references
** TODO Continue to auto-summarize references continuously