Homec4science
Diffusion iCAPs public (master) Browse

iCAPs/packages/spm12/spm_MH_reml.m
31022b3a13e6master

Last Change
Raw File

spm_MH_reml.m
View Options

function [F,P] = spm_MH_reml(YY,X,Q,N,hE);
% Estimation of covariance components from y*y' using sampling
% FORMAT [F,P] = spm_MH_reml(YY,X,Q,N,[hE]);
%
% YY - (m x m) sample covariance matrix Y*Y' {Y = (m x N) data matrix}
% X - (m x p) design matrix
% Q - {1 x q} covariance components
% N - number of samples
%
% hE - prior expectation: log-normal hyper-parameterisation (with hyperpriors)
%
% F - [-ve] free energy F = log evidence = p(Y|X,Q)
% P - smaple of hyperparameters from thier posterioir p(h|YY,X,Q)
%--------------------------------------------------------------------------
%
% This routiens using MCMC sampling (reverible Metropolis-Hastings)
%__________________________________________________________________________
% Copyright (C) 2008 Wellcome Trust Centre for Neuroimaging
% Karl Friston
% $Id: spm_MH_reml.m 5033 2012-11-02 20:59:54Z karl $
% assume a single sample if not specified
%--------------------------------------------------------------------------
try
N;
catch
N = 1;
end
% assume OPT = 0
%--------------------------------------------------------------------------
try
hE;
OPT = hE;
catch
OPT = 0;
end
% ortho-normalise X
%--------------------------------------------------------------------------
if isempty(X)
X = sparse(length(Q{1}),1);
else
X = orth(full(X));
end
% remove fixed effects
%--------------------------------------------------------------------------
n = length(Q{1});
m = length(Q);
h = zeros(m,1);
R = speye(n,n) - X*X';
YY = R*YY*R;
M.OPT = OPT;
M.Q = Q;
M.N = N;
% initialise and specify hyperpriors
%--------------------------------------------------------------------------
[C,h,Ph,Fr] = spm_reml(YY,X,Q,N,0,4,OPT);
if M.OPT
M.hE = h - 16;
M.hP = eye(m,m)/32;
else
M.hE = zeros(m,1);
M.hP = speye(m,m)/exp(32);
end
% sample
%--------------------------------------------------------------------------
[P,F] = spm_MH('spm_MH_reml_likelihood',h,YY,M);
c4science · Help