WUT_Computer_Science/NotProgramming/ENUME/projectC/sections/14-rk4-m.tex
Krzysztof kuhy Rudnicki ffa5dad02a Split 19 over-cap LaTeX reports, proving each PDF is unchanged
The 250-line cap applies to prose too, and the reports were the worst
offenders -- ENUME's projectA.tex alone was 1,876 lines. Each is now a
preamble plus one \input{} per section, which is how a long LaTeX document is
normally organised; not one byte of prose was rewritten.

"The PDF is unchanged" is checked by a script rather than by eye, because
hashing the PDF cannot work: pdflatex stamps a /CreationDate and an /ID into
every build, so two runs of the SAME source already differ. tex_fingerprint.sh
compares what a reader sees instead -- page count plus a hash of the extracted
text -- and it is stable across rebuilds of untouched sources, which is the
property that makes it usable as a gate.

It earned its keep immediately. Both ECOTE reports quote an example LaTeX
document inside an lstlisting block, so \end{document} appears in the middle
of the file; splitting on the FIRST one stranded everything after it. Same
page count, different text, caught automatically. EOPSY lab3 exposed a second
bug: a \section{} title that runs onto the next line.

Result: 19 .tex over the cap -> 1. The survivor,
ELAC/.../03-building-nfa-...tex, is 418 lines of consecutive tikz figures
with no subsection to split on and needs a hand-placed boundary.

Verified: 29 splits across two passes (section, then subsection for the
pieces still over), every one reporting `unchanged` from
scripts/tex_fingerprint.sh --check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0172dj34FDpao6wsix8ZuCzE
2026-08-28 19:47:12 +02:00

75 lines
2.2 KiB
TeX

\section{RK4.m}
\subsection{RK4}
\begin{simplechar}
\begin{lstlisting}
function [x, derivativesTable] = RK4(equations, initialValues, interval, stepSize, maxSteps)
x = initialValues;
derivativesTable = buildDerivatiesTable(x, equations);
% Calculate stepCount
stepCount = ceil((interval(2) - interval(1)) / stepSize);
if nargin == 5
stepCount = min(stepCount, maxSteps - 1);
end % IF we include max steps in our function input
% (nargin is number of arguments in input)
% then choose smaller number between maxSteps and stepCount and choose
% it for stepCount
[x, derivativesTable] = rk4Loop(x, stepCount, stepSize, equations, derivativesTable);
% append arguments to output
x = [interval(1):stepSize:(stepCount * stepSize); x];
end
\end{lstlisting}
\end{simplechar}
\subsection{buildDerivatiesTable}
\begin{simplechar}
\begin{lstlisting}
function derivativesTable = buildDerivatiesTable(x, equations)
derivativesTable = zeros(size(x));
for eqnum = 1:size(equations, 1)
derivativesTable(eqnum, 1) = equations{eqnum}(x(:, 1));
end
end
\end{lstlisting}
\end{simplechar}
\subsection{rk4Loop}
\begin{simplechar}
\begin{lstlisting}
function [x, derivativesTable] = rk4Loop(x, stepCount, stepSize, equations, derivativesTable)
for step = 1 : stepCount
[x, derivativesTable] = rk4stepLoop(x, step, equations, stepSize, derivativesTable);
end
end
\end{lstlisting}
\end{simplechar}
\subsection{rk4stepLoop}
\begin{simplechar}
\begin{lstlisting}
function [x, derivativesTable] = rk4stepLoop(x, step, equations, stepSize, derivativesTable)
stepValue = x(:, step);
[x, derivativesTable] = equationsLoop(x, equations, stepValue, stepSize, step, derivativesTable);
end
\end{lstlisting}
\end{simplechar}
\subsection{equationsLoop}
\begin{simplechar}
\begin{lstlisting}
function [x, derivativesTable] = equationsLoop(x, equations, stepValue, stepSize, step, derivativesTable)
for equationNumber = 1 : 2
Phi = RK4Phi(equations{equationNumber}, stepValue, stepSize);
x(equationNumber, step + 1) = x(equationNumber, step) + stepSize * Phi;
derivativesTable(equationNumber, step + 1) = equations{equationNumber}(x(:, step + 1));
end
end
\end{lstlisting}
\end{simplechar}