backup: 2026-07-25 14:39

thesis.org

@@ -7,7 +7,7 @@
 
 * thesis
 
-BGU MSc thesis on the ROLL method (Ranking via Optimized Label Learning). See [[id:d23011c5-d925-4f14-b05a-0a1f4bdbe860][impl]] for the implementation project this thesis documents.
+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
 
@@ -23,8 +23,23 @@ BGU MSc thesis on the ROLL method (Ranking via Optimized Label Learning). See [[
 - 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 for the Hebrew ToC
+- 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
 
@@ -32,6 +47,10 @@ BGU MSc thesis on the ROLL method (Ranking via Optimized Label Learning). See [[
 - 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
 
@@ -41,7 +60,13 @@ BGU MSc thesis on the ROLL method (Ranking via Optimized Label Learning). See [[
 
 ** Subnodes
 
-(none yet)
+- [[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