QPR-13703 update docs

Author: pcaspers

Docs/UserGuide/curve_configurations/yieldcurves.tex

@@ -194,7 +194,10 @@ \subsubsection*{Simple Segment}
 floating rates on the instruments underlying the quotes listed in the \lstinline!Quote! nodes during the bootstrap
 procedure. This is an optional node. If it is left blank or omitted, then the projection curve is assumed to equal the
 curve being bootstrapped i.e.\ the current CurveId. The \lstinline!PillarChoice! node determines the bootstrap pillars
-that are used (MaturityDate, LastRelevantDate, if not given 'LastRelevantDate' is the default value).
+that are used (MaturityDate, LastRelevantDate, NoPillar, StartDate, StartDateAndMaturityDate,
+StartDateAndLastRelevantDate; if not given 'LastRelevantDate' is the default
+value). The \lstinline!DuplicatePillarPolcicy! node determined how curve instruments within the same segment with
+identical pillar dates are handled (Keep Last, KeepFirst, KeepAll, ThrowError; if not given 'KeepLast' is used).
 
 The \lstinline!Priority! node determines the priority of the segment, this has to be a non-negative integer. A lower
 number means a higher priority (more ``important'') segment. If two adjacent segments overlap w.r.t. the pillar dates of
@@ -223,6 +226,7 @@ \subsubsection*{Simple Segment}
   </Quotes>
   <Conventions> </Conventions>
   <PillarChoice> </PillarChoice>
+  <DuplicatePillarPolicy> </DuplicatePillarPolicy>
   <Priority> </Priority>
   <MinDistance> </MinDistance>
   <ProjectionCurve> </ProjectionCurve>
@@ -261,11 +265,10 @@ \subsubsection*{Average OIS Segment}
 quote for an Average OIS instrument (a typical example in a USD Overnight Index Swap) consists of two quotes, a vanilla
 IRS quote and an OIS-LIBOR basis swap spread quote.  The IDs of these two quotes are stored in the
 \lstinline!CompositeQuote! node. The \lstinline!RateQuote! node holds the ID of the vanilla IRS quote and the
-\lstinline!SpreadQuote! node holds the ID of the OIS-LIBOR basis swap spread quote. The \lstinline!PillarChoice! node
-determines the bootstrap pillars that are used (MaturityDate, LastRelevantDate, if not given `LastRelevantDate' is the
-default value).
+\lstinline!SpreadQuote! node holds the ID of the OIS-LIBOR basis swap spread quote.
 
-For the \lstinline!Priority! and \lstinline!MinDistance! nodes see the explanation under ``Simple Segment''.
+For the \lstinline!PillarChoice!, \lstinline!DuplicatePillarPolicy!, \lstinline!Priority! and \lstinline!MinDistance!
+nodes see the explanation under ``Simple Segment''.
 
 \begin{listing}[H]
 %\hrule\medskip
@@ -279,6 +282,7 @@ \subsubsection*{Average OIS Segment}
   </Quotes>
   <Conventions> </Conventions>
   <PillarChoice> </PillarChoice>
+  <DuplicatePillarPolicy> </DuplicatePillarPolicy>
   <Priority> </Priority>
   <MinDistance> </MinDistance>
   <ProjectionCurve> </ProjectionCurve>
@@ -313,13 +317,13 @@ \subsubsection*{Tenor Basis Segment}
 node has the value \emph{Tenor Basis Two Swaps}. Again, the structure is similar to the simple segment in Listing
 \ref{lst:simple_segment} except that there are two projection curve nodes. There is a \lstinline!ProjectionCurveReceive!
 node for the index with the shorter tenor. This node holds the CurveId of a curve for projecting the floating rates on
-the receiving side. Similarly, there is a \lstinline!ProjectionCurvePay! node for the index of the pay side. The deprecated
-values are short for receive, and long for pay. These are optional nodes. If they are left blank or omitted, then the projection
-curve is assumed to equal the curve being bootstrapped i.e.\ the current CurveId. However, at least one of the nodes
-needs to be populated to allow the bootstrap to proceed. The \lstinline!PillarChoice! node determines the bootstrap pillars
-that are used (MaturityDate, LastRelevantDate, if not given `LastRelevantDate' is the default value).
+the receiving side. Similarly, there is a \lstinline!ProjectionCurvePay! node for the index of the pay side. The
+deprecated values are short for receive, and long for pay. These are optional nodes. If they are left blank or omitted,
+then the projection curve is assumed to equal the curve being bootstrapped i.e.\ the current CurveId. However, at least
+one of the nodes needs to be populated to allow the bootstrap to proceed.
 
-For the \lstinline!Priority! and \lstinline!MinDistance! nodes see the explanation under ``Simple Segment''.
+For the \lstinline!PillarChoice!, \lstinline!DuplicatePillarPolicy!, \lstinline!Priority! and \lstinline!MinDistance!
+nodes see the explanation under ``Simple Segment''.
 
 \begin{listing}[H]
 %\hrule\medskip
@@ -333,6 +337,7 @@ \subsubsection*{Tenor Basis Segment}
   </Quotes>
   <Conventions> </Conventions>
   <PillarChoice> </PillarChoice>
+  <DuplicatePillarPolicy> </DuplicatePillarPolicy>
   <Priority> </Priority>
   <MinDistance> </MinDistance>
   <ProjectionCurvePay> </ProjectionCurvePay>
@@ -350,8 +355,7 @@ \subsubsection*{Cross Currency Segment}
 for FX forward instruments. The \lstinline!DiscountCurve! node holds the CurveId of a curve used to discount cash flows
 in the other currency i.e.\ the currency in the currency pair that is not equal to the currency in Listing
 \ref{lst:top_level_yc}. The \lstinline!SpotRate! node holds the ID of a spot FX quote for the currency pair that is
-looked up in the {\tt market.txt} file. The \lstinline!PillarChoice! node determines the bootstrap pillars that are used
-(MaturityDate, LastRelevantDate, if not given `LastRelevantDate' is the default value).
+looked up in the {\tt market.txt} file.
 
 \begin{listing}[H]
 %\hrule\medskip
@@ -365,6 +369,7 @@ \subsubsection*{Cross Currency Segment}
   </Quotes>
   <Conventions> </Conventions>
   <PillarChoice> </PillarChoice>
+  <DuplicatePillarPolicy> </DuplicatePillarPolicy>
   <Priority> </Priority>
   <MinDistance> </MinDistance>
   <DiscountCurve> </DiscountCurve>
@@ -388,7 +393,8 @@ \subsubsection*{Cross Currency Segment}
 the other currency. If it is left blank or omitted, then it is assumed to equal the CurveId provided in the
 \lstinline!DiscountCurve! node in this segment.
 
-For the \lstinline!Priority! and \lstinline!MinDistance! nodes see the explanation under ``Simple Segment''.
+For the \lstinline!PillarChoice!, \lstinline!DuplicatePillarPolicy!, \lstinline!Priority! and \lstinline!MinDistance!
+nodes see the explanation under ``Simple Segment''.
 
 \begin{listing}[H]
 %\hrule\medskip
@@ -402,6 +408,7 @@ \subsubsection*{Cross Currency Segment}
   </Quotes>
   <Conventions> </Conventions>
   <PillarChoice> </PillarChoice>
+  <DuplicatePillarPolicy> </DuplicatePillarPolicy>
   <Priority> </Priority>
   <MinDistance> </MinDistance>
   <DiscountCurve> </DiscountCurve>

Docs/UserGuide/parameterisation/curveconfig.tex

@@ -1263,11 +1263,21 @@ \subsubsection{Bootstrap Configuration}
 \item \lstinline!DontThrowSteps! [Optional]:
 This node is used only if \lstinline!DontThrow! is \lstinline!true!. The meaning of this node is given in the description of the \lstinline!DontThrow! node. This node should hold a positive integer. If omitted, the default value is 10.
 
-\item \lstinline!Global! [Optional]: This nodes specifies whether the curve should use a global bootstrap over all
-  instruments of the curve (true) or iterative bootstrap (false, default value). If global bootstrap is used, only the
-  Accuracy field of the BootstrapConfig is relevant and specifies the accuracy of the global optimizer. If a cycle is
-  present in the dependency graph of the curves, all members of the cycle must use global bootstrap, in this case a
-  global optimization is run over all instrument of all members of the cycle simultaneously.
+\item \lstinline!Global! [Optional]: Defaults to false. This nodes specifies whether the curve should use a global
+  bootstrap over all instruments of the curve (true) or iterative bootstrap (false, default value). If global bootstrap
+  is used, only the fields Accuracy and SmoothnessLambda of the BootstrapConfig are relevant. Accurcy specifies the
+  accuracy of the global optimizer in this case.  Global bootstrap is required to build curves that form a cycle in the
+  dependency graph, in this case all members of the cycle must have Global set to true in their bootstrap configs. In
+  this case a global optimization is run over all instrument of all members of the cycle simultaneously. Global
+  bootstrap is also required if according to the PillarChoice configuration of each segment there are curve instrument
+  without or with more than one associated curve pillar date. Finally, global bootstrap can be preferable over iterative
+  bootstrap if the latter requires an outer convergence loop, i.e. if a pillar choice is not set to LastRelevatDate or
+  if the interpolation is non-local.
+
+\item \lstinline!SmoothnessLambda! [Optional]: Defaults to zero. Only applies if GLobal is set to true. If positive,
+  penalty components are included in the global optimization used to build a curve. For each adjacent pair of discrete
+  forward rates $F_i$, $F_{i+1}$ between curve interpolation pillars, the term $\lambda\cdot(F_{i+1} - F_i)$ is added to
+  the target function vector of which the MSE is optimized.
 
 \end{itemize}