Coverage Report

Created: 2025-08-05 06:45

/src/quantlib/ql/pricingengines/swaption/fdhullwhiteswaptionengine.cpp
Line
Count
Source (jump to first uncovered line)
1
/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2
3
/*
4
 Copyright (C) 2011 Klaus Spanderen
5
6
 This file is part of QuantLib, a free-software/open-source library
7
 for financial quantitative analysts and developers - http://quantlib.org/
8
9
 QuantLib is free software: you can redistribute it and/or modify it
10
 under the terms of the QuantLib license.  You should have received a
11
 copy of the license along with this program; if not, please email
12
 <quantlib-dev@lists.sf.net>. The license is also available online at
13
 <http://quantlib.org/license.shtml>.
14
15
 This program is distributed in the hope that it will be useful, but WITHOUT
16
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17
 FOR A PARTICULAR PURPOSE.  See the license for more details.
18
*/
19
20
#include <ql/exercise.hpp>
21
#include <ql/indexes/iborindex.hpp>
22
#include <ql/processes/ornsteinuhlenbeckprocess.hpp>
23
#include <ql/pricingengines/swaption/fdhullwhiteswaptionengine.hpp>
24
#include <ql/methods/finitedifferences/solvers/fdmsolverdesc.hpp>
25
#include <ql/methods/finitedifferences/meshers/fdmmeshercomposite.hpp>
26
#include <ql/methods/finitedifferences/operators/fdmlinearoplayout.hpp>
27
#include <ql/methods/finitedifferences/meshers/fdmsimpleprocess1dmesher.hpp>
28
#include <ql/methods/finitedifferences/solvers/fdmhullwhitesolver.hpp>
29
#include <ql/methods/finitedifferences/utilities/fdmaffinemodelswapinnervalue.hpp>
30
#include <ql/methods/finitedifferences/stepconditions/fdmstepconditioncomposite.hpp>
31
32
namespace QuantLib {
33
34
    FdHullWhiteSwaptionEngine::FdHullWhiteSwaptionEngine(
35
        const ext::shared_ptr<HullWhite>& model,
36
        Size tGrid, Size xGrid, 
37
        Size dampingSteps, Real invEps,
38
        const FdmSchemeDesc& schemeDesc)
39
0
    : GenericModelEngine<HullWhite, 
40
0
                         Swaption::arguments, Swaption::results>(model),
41
0
      tGrid_(tGrid),
42
0
      xGrid_(xGrid),
43
0
      dampingSteps_(dampingSteps),
44
0
      invEps_(invEps),
45
0
      schemeDesc_(schemeDesc) {
46
0
    }
47
48
0
    void FdHullWhiteSwaptionEngine::calculate() const {
49
0
        QL_REQUIRE(!model_.empty(), "no model specified");
50
51
        // 1. Term structure
52
0
        const Handle<YieldTermStructure> ts = model_->termStructure();
53
54
        // 2. Mesher
55
0
        const DayCounter dc = ts->dayCounter();
56
0
        const Date referenceDate = ts->referenceDate();
57
0
        const Time maturity = dc.yearFraction(referenceDate,
58
0
                                              arguments_.exercise->lastDate());
59
60
0
        auto process = ext::make_shared<OrnsteinUhlenbeckProcess>(model_->a(), model_->sigma());
61
0
        auto shortRateMesher = ext::make_shared<FdmSimpleProcess1dMesher>(xGrid_, process, maturity, 1, invEps_);
62
0
        auto mesher = ext::make_shared<FdmMesherComposite>(shortRateMesher);
63
64
        // 3. Inner Value Calculator
65
0
        const std::vector<Date>& exerciseDates = arguments_.exercise->dates();
66
0
        std::map<Time, Date> t2d;
67
68
0
        for (auto exerciseDate : exerciseDates) {
69
0
            const Time t = dc.yearFraction(referenceDate, exerciseDate);
70
0
            QL_REQUIRE(t >= 0, "exercise dates must not contain past date");
71
72
0
            t2d[t] = exerciseDate;
73
0
        }
74
75
0
        const Handle<YieldTermStructure> disTs = model_->termStructure();
76
0
        const Handle<YieldTermStructure> fwdTs
77
0
            = arguments_.swap->iborIndex()->forwardingTermStructure();
78
79
0
        QL_REQUIRE(fwdTs->dayCounter() == disTs->dayCounter(),
80
0
                   "day counter of forward and discount curve must match");
81
0
        QL_REQUIRE(fwdTs->referenceDate() == disTs->referenceDate(),
82
0
                   "reference date of forward and discount curve must match");
83
84
0
        auto fwdModel = ext::make_shared<HullWhite>(fwdTs, model_->a(), model_->sigma());
85
0
        auto calculator = ext::make_shared<FdmAffineModelSwapInnerValue<HullWhite>>(
86
0
                 model_.currentLink(), fwdModel,
87
0
                 arguments_.swap, t2d, mesher, 0);
88
89
        // 4. Step conditions
90
0
        auto conditions =
91
0
             FdmStepConditionComposite::vanillaComposite(
92
0
                 DividendSchedule(), arguments_.exercise,
93
0
                 mesher, calculator, referenceDate, dc);
94
95
        // 5. Boundary conditions
96
0
        const FdmBoundaryConditionSet boundaries;
97
98
        // 6. Solver
99
0
        FdmSolverDesc solverDesc = { mesher, boundaries, conditions,
100
0
                                     calculator, maturity,
101
0
                                     tGrid_, dampingSteps_ };
102
103
0
        FdmHullWhiteSolver solver(model_, solverDesc, schemeDesc_);
104
105
0
        results_.value = solver.valueAt(0.0);
106
0
    }
107
}