docs(paper): keep floats near their references

Tables and figures used to drift pages away from the prose that cites
them: every table was a double-column table*[t], which stock LaTeX can
only place at the top of a LATER page, and the default float limits
pushed them further still.

- fix_longtables.py: tables narrow enough for one column (Table 2 fold
  economics, Table 6 whole-core area) become single-column table[!t]
  floats, which can sit on the page where they are cited; the wide six
  stay table*, now [!t].
- ieee/preamble.tex: dblfloatfix lets double-column floats appear at the
  top of the SAME page as their source; float fractions/counters relaxed
  (topfraction .9, dbltopnumber 4, ...) so a results page may carry
  several tables.

Outcome (visually audited page by page): Table 1, Table 2 and Fig. 1
share the page with §4; Tables 5-6 sit on the §6 page and Table 7 beside
the comparison discussion; Fig. 2 tops the §8 Discussion page; every
float is on its reference page or the one after. 10 pages, zero LaTeX
errors, zero missing glyphs, no overfull >30pt.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: grandchildrice

docs/paper/ieee/fix_longtables.py

@@ -34,10 +34,23 @@ def take(tok, s):
     cap = ''
     if caption:
         cap = "\\caption{%s}\n" % ' '.join(caption.split())
-    return ("\\begin{table*}[t]\n\\centering\\footnotesize\n%s"
+    global tblno
+    tblno += 1
+    if tblno in SINGLE_COL:
+        # narrow enough for one 3.5in column: a single-column float can sit
+        # on the same page as (or right after) its reference
+        return ("\\begin{table}[!t]\n\\centering\\scriptsize\n%s"
+                "\\begin{tabular}{%s}\n%s\n\\end{tabular}\n\\end{table}"
+                % (cap, colspec, inner))
+    return ("\\begin{table*}[!t]\n\\centering\\footnotesize\n%s"
             "\\begin{tabular}{%s}\n%s\n\\end{tabular}\n\\end{table*}"
             % (cap, colspec, inner))
 
+# tables (in order of appearance) whose natural width fits one column;
+# the rest must span both columns
+SINGLE_COL = {2, 6}
+tblno = 0
+
 pat = re.compile(
     r'(?:\\textbf\{Table\s+[0-9]+\.\s+(?P<cap>[^{}]*?)\}\s*\n\s*\n)?'
     r'(?P<tbl>\\begin\{longtable\}.*?\\end\{longtable\})', re.S)

docs/paper/ieee/preamble.tex

@@ -34,3 +34,14 @@
 % prose references say "Table 1"; keep captions arabic (IEEEtran defaults to
 % Roman numerals)
 \renewcommand\thetable{\arabic{table}}
+% keep floats near their references: allow double-column floats on the SAME
+% page as their source (stock LaTeX defers them to the next page), and relax
+% the float limits so a results page may carry several tables
+\usepackage{dblfloatfix}
+\renewcommand{\topfraction}{0.9}
+\renewcommand{\dbltopfraction}{0.9}
+\renewcommand{\textfraction}{0.05}
+\renewcommand{\floatpagefraction}{0.8}
+\setcounter{topnumber}{3}
+\setcounter{dbltopnumber}{4}
+\setcounter{totalnumber}{5}