summaryrefslogtreecommitdiff
path: root/inst/lm/stk_lm_polynomial.m
blob: 21dd37e84098c47f9f0d8bcfb27ded29ee7ec267 (plain)
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
% STK_LM_POLYNOMIAL creates a polynomial linear model object
%
% CALL: LM = STK_LM_POLYNOMIAL (D)
%
%    creates a polynomial linear model object LM of degree D.

% Copyright Notice
%
%    Copyright (C) 2016-2018 CentraleSupelec
%    Copyright (C) 2012-2014 SUPELEC
%
%    Author:  Julien Bect  <julien.bect@centralesupelec.fr>

% Copying Permission Statement
%
%    This file is part of
%
%            STK: a Small (Matlab/Octave) Toolbox for Kriging
%               (https://github.com/stk-kriging/stk/)
%
%    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 lm = stk_lm_polynomial (order)

% nargin check neded here.  See https://sourceforge.net/p/kriging/tickets/52.
if nargin < 1
    stk_error ('Not enough input arguments.', 'NotEnoughInputArgs');
end

switch order
    
    case -1, % 'simple' kriging
        lm = stk_lm_null ();
        
    case 0, % 'ordinary' kriging
        lm = stk_lm_constant ();
        
    case 1, % affine trend
        lm = stk_lm_affine ();
        
    case 2, % quadratic trend
        lm = stk_lm_quadratic ();
        
    case 3, % cubic trend
        lm = stk_lm_cubic ();
        
    otherwise, % syntax error
        stk_error ('order should be in {-1, 0, 1, 2, 3}', 'InvalidArgument');
end

end % function


%!error lm = stk_lm_polynomial ();

%!test
%! lm = stk_lm_polynomial (-1);
%! assert (isa (lm, 'stk_lm_null'));

%!test
%! lm = stk_lm_polynomial (0);
%! assert (isa (lm, 'stk_lm_constant'));

%!test
%! lm = stk_lm_polynomial (1);
%! assert (isa (lm, 'stk_lm_affine'));

%!test
%! lm = stk_lm_polynomial (2);
%! assert (isa (lm, 'stk_lm_quadratic'));

%!test
%! lm = stk_lm_polynomial (3);
%! assert (isa (lm, 'stk_lm_cubic'));