quantsupport 0.1.7

Rust quantitative finance library for derivatives pricing, yield-curve bootstrapping, AAD risk, Monte Carlo exposure, and XVA.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use serde::{Deserialize, Serialize};

use crate::{indices::marketindex::MarketIndex, volatility::volatilityindexing::Strike};

/// Specifies which market data object to calibrate against.
#[derive(Clone, Debug, Serialize, Deserialize)]
pub enum CalibrationSource {
    /// Calibrate to caplet vols from a 2-D volatility surface.
    Surface {
        /// Market index identifying the surface to read from.
        market_index: MarketIndex,
    },
    /// Calibrate to swaption vols from a 3-D volatility cube.
    Cube {
        /// Market index identifying the cube to read from.
        market_index: MarketIndex,
    },
}

/// Configuration for model calibration (e.g. Hull-White to caplet/swaption vols).
///
/// Quote identifiers follow the same convention as
/// [`CurveConfiguration`](crate::rates::bootstrapping::curveconfiguration::CurveConfiguration):
/// each string is resolved against a [`QuoteSelector`](crate::quotes::quoteselector::QuoteSelector)
/// to obtain the market quote and instrument details.
///
/// # Strike / moneyness resolution
///
/// Market strikes are generally not known when the configuration is written,
/// so `quote_ids` can simply list **all available market quotes** (multiple
/// strikes per expiry). When a [`strike`](Self::strike) specification is
/// provided, the system resolves the calibration basket itself:
///
/// * quotes are collapsed to one calibration instrument per (expiry, tenor)
///   pillar, and
/// * each instrument's strike is replaced by the specification —
///   [`Strike::Atm`], [`Strike::Relative`] (e.g. ATM + 2%), or
///   [`Strike::Absolute`] — which curve-aware models (Hull-White, LGM)
///   resolve against the forward rate at each pillar before sampling the
///   surface/cube.
///
/// Without a `strike`, each quote's own strike is used verbatim (one
/// calibration instrument per quote id).
#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct ModelCalibrationConfiguration {
    /// Which vol surface or cube to calibrate against.
    source: CalibrationSource,
    /// Quote identifiers for the calibration instruments (caplets, swaptions, or both).
    quote_ids: Vec<String>,
    /// Optional strike/moneyness override applied to every calibration
    /// instrument (deduplicating expiry pillars).
    #[serde(default)]
    strike: Option<Strike>,
    /// Mean-reversion speed.
    alpha: f64,
}

impl ModelCalibrationConfiguration {
    /// Creates a new calibration configuration.
    #[must_use]
    pub const fn new(source: CalibrationSource, quote_ids: Vec<String>, alpha: f64) -> Self {
        Self {
            source,
            quote_ids,
            strike: None,
            alpha,
        }
    }

    /// Sets the strike/moneyness override.
    #[must_use]
    pub const fn with_strike(mut self, strike: Strike) -> Self {
        self.strike = Some(strike);
        self
    }

    /// Returns the calibration source.
    #[must_use]
    pub const fn source(&self) -> &CalibrationSource {
        &self.source
    }

    /// Returns the calibration quote identifiers.
    #[must_use]
    pub fn quote_ids(&self) -> &[String] {
        &self.quote_ids
    }

    /// Returns the strike/moneyness override, if any.
    #[must_use]
    pub const fn strike(&self) -> Option<Strike> {
        self.strike
    }

    /// Returns the mean-reversion speed.
    #[must_use]
    pub const fn alpha(&self) -> f64 {
        self.alpha
    }
}