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
|
% STK_SET_OPTIMIZABLE_PARAMETERS [STK internal]
%
% CALL: PARAM = stk_set_optimizable_parameters (PARAM, VALUE)
%
% sets to VALUE the 'optimizable_parameters' property of PARAM. The argument
% VALUE is expected to be a numerical vector of the appropriate length.
%
% NOTE:
%
% Numerical arrays are considered as a special kind of parameter object, for
% which the 'optimizable_parameters' property is taken to be PARAM(:).
%
% INTERNAL FUNCTION WARNING:
%
% This function is currently considered as internal. STK users that wish to
% experiment with parameter classes can already overload it, but should be
% aware that API-breaking changes are likely to happen in future releases.
%
% See also: stk_get_optimizable_parameters
% Copyright Notice
%
% Copyright (C) 2016-2018 CentraleSupelec
%
% Author: Julien Bect <julien.bect@centralesupelec.fr>
% Copying Permission Statement
%
% This file is part of
%
% STK: a Small (Matlab/Octave) Toolbox for Kriging
% (http://sourceforge.net/projects/kriging)
%
% STK is free software: you can redistribute it and/or modify it under
% the terms of the GNU General Public License as published by the Free
% Software Foundation, either version 3 of the License, or (at your
% option) any later version.
%
% STK is distributed in the hope that it will be useful, but WITHOUT
% ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
% or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
% License for more details.
%
% You should have received a copy of the GNU General Public License
% along with STK. If not, see <http://www.gnu.org/licenses/>.
function param = stk_set_optimizable_parameters (param, value)
% This function will catch all calls to stk_set_optimizable_parameters for which
% arg1 is not an object of a class that implements stk_set_optimizable_parameters.
if isstruct (param)
if isfield (param, 'K') && isfield (param, 'P')
% A very special case: parameter structure of a discrete covariance model
if ~ isempty (value)
stk_error (['Discrete covariance structures have no ' ...
'optimizable parameters.'], 'InvalidArgument');
end
else
% Assuming that param is a model structure:
param = stk_set_optimizable_model_parameters (param, value);
end
else
% If param is numeric, the following syntax preserves its size and type
param(:) = value;
% Note: if param is an object, what we just did is actually a call to
% subsasgn in disguise. This way of supporting parameter objects has been
% introduced in STK 2.0.0 as an "experimental" feature. It is now
% deprecated; overload stk_set_optimizable_parameters () instead.
end % if
end % function
|