\documentclass[11pt,a4paper]{report}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{lmodern,microtype}
\usepackage[margin=26mm,marginparwidth=18mm,marginparsep=4mm]{geometry}
\usepackage{amsmath,amssymb,siunitx,booktabs,longtable,array}
\usepackage{tikz}
\usetikzlibrary{positioning,arrows.meta}
\usepackage{xcolor,xurl}
\usepackage{hyperref}
\usepackage[nameinlink,noabbrev]{cleveref}
\input{macros}
\hypersetup{hypertexnames=false,colorlinks=true,linkcolor=blue!50!black,urlcolor=blue!50!black,citecolor=blue!50!black}
\setlength{\emergencystretch}{3em}
\title{ECOSYS model reference\\\large Scientific equations and source-code map}
\author{Reference for the Python engine}
\date{Source snapshot: \texttt{\commit}}
\begin{document}
\hypersetup{pageanchor=false}
\maketitle
\hypersetup{pageanchor=true}\pagenumbering{roman}
\begin{abstract}
The Python ECOSYS package implements the ECOSYS methodology for assessing
the radiological consequences of radionuclide releases, based on ECOSYS-87
by Müller and Pröhl (1993) and subsequent extensions. Given time-integrated
air concentrations, wet deposition and rainfall, the model calculates
radionuclide transfer through soil, vegetation, animal feed and human food
chains. Seasonal growth, harvest, storage and biological retention determine
the evolution of activity concentrations. Human exposure is assessed through
ingestion, inhalation and external irradiation, accounting for age-dependent
diets, dose coefficients and environmental residence patterns. Dated releases
can be combined to estimate time-dependent concentrations, individual doses
and collective population dose. This reference presents the governing
equations, physical assumptions, parameter sources and numerical methods,
together with verification tests and comparisons with reference calculations.
A source-code map connects the scientific formulation to its implementation.
\end{abstract}
\noindent\textbf{How to read this document.} For physics, follow Parts I--III,
using Appendix A for symbols. For code, begin with Part IV and the
implementation subsections in Part II; all \codefn{path:line-range} links
refer to the source snapshot named above. Red numbered margin annotations
lead to the verification notes at the end.
Historical implementation details and the reference-run divergence inventory
are in Appendix~\ref{app:vba}. All source links target the \texttt{\commit}
release tag.
\tableofcontents
\clearpage\pagenumbering{arabic}
\part{The model}
\input{ch01-introduction}
\input{ch02-model-overview}
\input{ch03-conventions}
\part{Pathway equations}
\input{ch04-deposition}
\input{ch05-soil-resuspension}
\input{ch06-plants}
\input{ch07-hay-feed}
\input{ch08-animals}
\input{ch09-processing-foods}
\input{ch10-doses}
\part{Numerics and validation}
\input{ch11-numerical-methods}
\input{ch12-verification-validation}
\part{The code}
\input{ch13-architecture}
\input{ch14-code-walkthrough}
\appendix
\input{appA-notation}
\input{appB-parameter-map}
\input{appC-decision-index}
\input{appD-vba-glossary}
\bibliographystyle{plain}
\bibliography{references}
\listofneedschecks
\end{document}