-
Notifications
You must be signed in to change notification settings - Fork 17
/
loadings.m
135 lines (116 loc) · 4.45 KB
/
loadings.m
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
function fig_h =loadings(model,opt,tit,label,classes,blur)
% Compute and plot loadings.
%
% fig_h =loadings(model) % minimum call
% fig_h =loadings(model,opt,tit,label,classes,blur) % complete call
%
% INPUTS:
%
% model (structure): structure with model parameters.
% lvs: [1xA] Latent Variables considered (e.g. lvs = 1:2 selects the
% first two LVs).
% loads: [MxA] model parameters.
% scores: [NxA] data scores.
%
% opt: (str) options for data plotting: binary code of the form 'ab' for:
% a:
% 0: scatter plot of pairs of LVs
% 1: bar plot of each single LV
% b:
% 0: plot for categorical classes (consistent with a legend)
% 1: plot for numerical classes (consistent with a colorbar)
%
% By deafult, opt = '00'. If less than 2 digits are specified, the least
% significant digit is set to 0, i.e. opt = 1 means a=1, b=0.
%
% tit: (str) title for the plots. Empty by default;
%
% label: [Mx1] name of the variables (numbers are used by default)
%
% classes: [Mx1] groups for different visualization (a single group
% by default)
%
% blur: [1x1] avoid blur when adding labels. The higher, the more labels
% are printer (the higher blur). Inf shows all the labels (1 by default)
%
%
% OUTPUTS:
%
% fig_h: set of figure handles
%
%
% EXAMPLE OF USE: Random data
%
% X = simuleMV(20,10,8);
% [~,~,model] = pca_pp(X,1:2);
%
% P = loadings(model);
%
%
% coded by: Jose Camacho Paez (josecamacho@ugr.es)
% last modification: 19/May/2023
%
% Copyright (C) 2023 University of Granada, Granada
%
% This program 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.
%
% This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
%% Parameters checking
% Set default values
routine=dbstack;
assert (nargin >= 1, 'Error in the number of arguments. Type ''help %s'' for more info.', routine(1).name);
N = size(model.scores, 1);
M = size(model.loads, 1);
if nargin < 2 || isempty(opt), opt = 0; end;
% Convert int arrays to str
if isnumeric(opt), opt=num2str(opt); end
% Complete opt
while length(opt)<2, opt = strcat(opt,'0'); end
if opt(2) == '0', opt(2) = '1'; else, opt(2) = '0'; end
if nargin < 3, tit = ''; end
if nargin < 4 || isempty(label), label = 1:M; end
if nargin < 5 || isempty(classes), classes = ones(M,1); end
if nargin < 6 || isempty(blur), blur = 1; end;
% Convert row arrays to column arrays
if size(label,1) == 1, label = label'; end;
if size(classes,1) == 1, classes = classes'; end;
% Validate dimensions of input data
assert (ischar(opt) && length(opt)==2, 'Dimension Error: 2nd argument must be a string or num of 2 bits. Type ''help %s'' for more info.', routine(1).name);
assert (isequal(size(label), [M 1]), 'Dimension Error: 4th argument must be M-by-1. Type ''help %s'' for more info.', routine(1).name);
assert (isequal(size(classes), [M 1]), 'Dimension Error: 5th argument must be M-by-1. Type ''help %s'' for more info.', routine(1).name);
if ~isempty(blur), assert (isequal(size(blur), [1 1]), 'Dimension Error: 6th argument must be 1-by-1. Type ''help %s'' for more info.', routine(1).name); end;
% Validate values of input data
assert (isempty(find(opt~='0' & opt~='1')), 'Value Error: 2nd argument must contain binary values. Type ''help %s'' for more info.', routine(1).name);
%% Main code
P = model.loads;
%% Show results
if ~isfield(model,'type') || strcmp(model.type,'PCA')
dim = 'PC';
elseif strcmp(model.type,'PLS')
dim = 'LV'
else
dim = 'PC';
end
fig_h = [];
if length(model.lvs) == 1 || opt(1) == '1'
for i=1:length(model.lvs)
fig_h = [fig_h plot_vec(P(:,i), label, classes, {'',sprintf('Loadings %s %d',dim,model.lvs(i))})];
title(tit);
end
else
for i=1:length(model.lvs)-1
for j=i+1:length(model.lvs)
fig_h = [fig_h plot_scatter([P(:,i),P(:,j)], label, classes, {sprintf('Loadings %s %d',dim,model.lvs(i)),sprintf('Loadings %s %d',dim,model.lvs(j))}',[],opt(2),[],[],blur)];
title(tit);
end
end
end