From f9ea88a6232e4234bb4e84167074f4770c5e5453 Mon Sep 17 00:00:00 2001
From: Timo Koch <timokoch@uio.no>
Date: Wed, 25 Sep 2024 11:20:02 +0200
Subject: [PATCH] [leastsquares][doc] Add reference

---
 doc/doxygen/dumux.bib           | 12 ++++++++++++
 dumux/nonlinear/leastsquares.hh |  1 +
 2 files changed, 13 insertions(+)

diff --git a/doc/doxygen/dumux.bib b/doc/doxygen/dumux.bib
index 987c42191e..38e4463199 100644
--- a/doc/doxygen/dumux.bib
+++ b/doc/doxygen/dumux.bib
@@ -2114,3 +2114,15 @@ author = {F. Fichot and F. Duval and N. Trégourès and C. Béchaud and M. Quint
   year = {1940},
   pages = {529–558}
 }
+
+@book{NocedalWright2006,
+  title     = {{Numerical Optimization}},
+  author    = {Nocedal, Jorge and Wright, Stephen},
+  ISBN = {9780387303031},
+  DOI = {10.1007/978-0-387-40065-5},
+  publisher = {Springer},
+  series    = {Springer Series in Operations Research and Financial Engineering},
+  edition   = {2},
+  year      = {2006},
+  address   = {New York, NY}
+}
diff --git a/dumux/nonlinear/leastsquares.hh b/dumux/nonlinear/leastsquares.hh
index 42e1def5dd..af5fdccc59 100644
--- a/dumux/nonlinear/leastsquares.hh
+++ b/dumux/nonlinear/leastsquares.hh
@@ -406,6 +406,7 @@ namespace Dumux::Optimization {
 /*!
  * \ingroup Nonlinear
  * \brief Creates a nonlinear least squares solver with \f$n\f$ model parameters and \f$m\f$ observations
+ * For a detailed description of the mathematical background see \cite NocedalWright2006
  * \param f The residual functional to minimize the norm of (\f$ f: \mathbb{R}^n \mapsto \mathbb{R}^m \f$)
  * \param x0 Initial guess for the parameters (vector of size \f$n\f$)
  * \param size The number of observations (\f$m\f$)
-- 
GitLab