https://mooseframework.inl.gov
Loading...
Searching...
No Matches
ExponentialCovariance.C
Go to the documentation of this file.
1//* This file is part of the MOOSE framework
2//* https://mooseframework.inl.gov
3//*
4//* All rights reserved, see COPYRIGHT for full restrictions
5//* https://github.com/idaholab/moose/blob/master/COPYRIGHT
6//*
7//* Licensed under LGPL 2.1, please see LICENSE for details
8//* https://www.gnu.org/licenses/lgpl-2.1.html
9#ifdef MOOSE_LIBTORCH_ENABLED
10
12#include <cmath>
13
15
18{
20 params.addClassDescription("Exponential covariance function.");
21 params.addRequiredParam<std::vector<Real>>("length_factor",
22 "Length factors to use for Covariance Kernel");
23 params.addRequiredParam<Real>("signal_variance",
24 "Signal Variance ($\\sigma_f^2$) to use for kernel calculation.");
25 params.addParam<Real>(
26 "noise_variance", 0.0, "Noise Variance ($\\sigma_n^2$) to use for kernel calculation.");
27 params.addRequiredParam<Real>("gamma", "Gamma to use for Exponential Covariance Kernel");
28 return params;
29}
30
32 : CovarianceFunctionBase(parameters),
33 _length_factor(addVectorRealHyperParameter(
34 "length_factor", getParam<std::vector<Real>>("length_factor"), true)),
35 _sigma_f_squared(
36 addRealHyperParameter("signal_variance", getParam<Real>("signal_variance"), true)),
37 _sigma_n_squared(
38 addRealHyperParameter("noise_variance", getParam<Real>("noise_variance"), true)),
39 _gamma(addRealHyperParameter("gamma", getParam<Real>("gamma"), false))
40{
41}
42
43void
45 const torch::Tensor & x,
46 const torch::Tensor & xp,
47 const bool is_self_covariance) const
48{
49 if ((unsigned)x.sizes()[1] != _length_factor.numel())
50 mooseError("length_factor size does not match dimension of trainer input.");
51
53 K, x, xp, _length_factor, _sigma_f_squared, _sigma_n_squared, _gamma, is_self_covariance);
54}
55
56void
58 const torch::Tensor & x,
59 const torch::Tensor & xp,
60 const torch::Tensor & length_factor,
61 const torch::Tensor & sigma_f_squared,
62 const torch::Tensor & sigma_n_squared,
63 const torch::Tensor & gamma,
64 const bool is_self_covariance)
65{
66 mooseAssert(x.sizes()[1] == xp.sizes()[1],
67 "Number of parameters do not match in covariance kernel calculation");
68
69 const auto l_factor = length_factor.unsqueeze(0);
70 K = torch::cdist(torch::div(x, l_factor), torch::div(xp, l_factor), 2.0);
71 K = sigma_f_squared * torch::exp(-torch::pow(K, gamma));
72 if (is_self_covariance)
73 K.diagonal().add_(sigma_n_squared);
74}
75
76bool
78 const torch::Tensor & x,
79 const std::string & hyper_param_name,
80 unsigned int ind) const
81{
82 if (name().length() + 1 > hyper_param_name.length())
83 return false;
84
85 const std::string name_without_prefix = hyper_param_name.substr(name().length() + 1);
86
87 if (name_without_prefix == "noise_variance")
88 {
89 const auto options = x.options().dtype(at::kDouble);
91 x,
92 x,
94 torch::tensor(0.0, options),
95 torch::tensor(1.0, options),
96 _gamma,
97 true);
98 return true;
99 }
100
101 if (name_without_prefix == "signal_variance")
102 {
103 const auto options = x.options().dtype(at::kDouble);
105 x,
106 x,
108 torch::tensor(1.0, options),
109 torch::tensor(0.0, options),
110 _gamma,
111 false);
112 return true;
113 }
114
115 if (name_without_prefix == "length_factor")
116 {
118 return true;
119 }
120
121 return false;
122}
123
124void
126 const torch::Tensor & x,
127 const torch::Tensor & length_factor,
128 const torch::Tensor & sigma_f_squared,
129 const torch::Tensor & gamma,
130 const int ind)
131{
132 mooseAssert(ind < x.sizes()[1], "Incorrect length factor index");
133
134 const auto l_factor = length_factor.unsqueeze(0);
135 const auto scaled_distance = torch::cdist(torch::div(x, l_factor), torch::div(x, l_factor), 2.0);
136 const auto nonzero_distance = scaled_distance > 0;
137 const auto safe_scaled_distance =
138 torch::where(nonzero_distance, scaled_distance, torch::ones_like(scaled_distance));
139 const auto coordinate = x.select(1, ind);
140 const auto coordinate_distance_squared =
141 torch::pow(coordinate.unsqueeze(1) - coordinate.unsqueeze(0), 2);
142 const auto length_factor_ind = length_factor.select(0, ind);
143
144 const auto dK_dlength_factor = coordinate_distance_squared / torch::pow(length_factor_ind, 3) *
145 gamma * torch::pow(safe_scaled_distance, gamma - 2.0) *
146 sigma_f_squared *
147 torch::exp(-torch::pow(safe_scaled_distance, gamma));
148
149 K = torch::where(nonzero_distance, dK_dlength_factor, torch::zeros_like(dK_dlength_factor));
150}
151
152#endif
const std::vector< double > x
registerMooseObject("StochasticToolsApp", ExponentialCovariance)
Base class for covariance functions that are used in Gaussian Processes.
static InputParameters validParams()
const torch::Tensor & _sigma_f_squared
signal variance (\sigma_f^2)
ExponentialCovariance(const InputParameters &parameters)
static void computedKdlf(torch::Tensor &K, const torch::Tensor &x, const torch::Tensor &length_factor, const torch::Tensor &sigma_f_squared, const torch::Tensor &gamma, const int ind)
Computes dK/dlf for individual length factors.
static InputParameters validParams()
static void ExponentialFunction(torch::Tensor &K, const torch::Tensor &x, const torch::Tensor &xp, const torch::Tensor &length_factor, const torch::Tensor &sigma_f_squared, const torch::Tensor &sigma_n_squared, const torch::Tensor &gamma, const bool is_self_covariance)
const torch::Tensor & _sigma_n_squared
noise variance (\sigma_n^2)
const torch::Tensor & _length_factor
lengh factor (\ell) for the kernel, in vector form for multiple parameters
bool computedKdhyper(torch::Tensor &dKdhp, const torch::Tensor &x, const std::string &hyper_param_name, unsigned int ind) const override
Redirect dK/dhp for hyperparameter "hp".
const torch::Tensor & _gamma
gamma exponential factor for use in kernel
void computeCovarianceMatrix(torch::Tensor &K, const torch::Tensor &x, const torch::Tensor &xp, const bool is_self_covariance) const override
Generates the Covariance Matrix given two points in the parameter space.
void addRequiredParam(const std::string &name, const std::string &doc_string)
void addParam(const std::string &name, const std::initializer_list< typename T::value_type > &value, const std::string &doc_string)
void addClassDescription(const std::string &doc_string)
const std::string & name() const
void mooseError(Args &&... args) const