MVAPACK Master Script: Difference between revisions

From Powers Wiki
(Created page with "category:MVAPACK Page under development.")
 
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[category:MVAPACK]]
[[category:MVAPACK]]
Page under development.
=A good start=
This page represents a good script to get started in MVAPACK/Octave. Copy the script below, or [http://bionmr.unl.edu/files/misc/mediawikidownloads/NMRMasterProcessing.m download this one], and save as a .m file in your favorite simple text editor.
 
 
==The Script==
 
<br /><nowiki>#Get Files</nowiki>
<br /><nowiki>display('Using typical unix filename syntax (i.e. ./* or ../your/file/is/here/* or ???). This will only use directories.')</nowiki>
<br /><nowiki>filepath = input('What is the path to your data? ',"s");</nowiki>
<br /><nowiki>F.fileglob = glob(filepath);  %% Number of ? is the number of digits of the file name</nowiki>
<br /><nowiki></nowiki>
<br />''<nowiki>%% We only use directories here</nowiki>''
<br /><nowiki>count = 1;</nowiki>
<br /><nowiki>sizeoffileglob = numel(F.fileglob);</nowiki>
<br /><nowiki>currentdir = pwd;</nowiki>
<br /><nowiki>for i = [1:sizeoffileglob]</nowiki>
<br /><nowiki>  if isfolder(F.fileglob{i})</nowiki>
<br /><nowiki>    cd(F.fileglob{i});</nowiki>
<br /><nowiki>    if (stat('ser') || stat('fid'))</nowiki>
<br /><nowiki>      continue;</nowiki>
<br /><nowiki>    end</nowiki>
<br /><nowiki>    cd(currentdir);</nowiki>
<br /><nowiki>    F.dirs{count++} = F.fileglob{i};</nowiki>
<br /><nowiki>  end</nowiki>
<br /><nowiki>end</nowiki>
<br /><nowiki>checkforexistence = exist('F.dirs')</nowiki>
<br /><nowiki>if checkforexistence</nowiki>
<br /><nowiki>  error('There is no NMR data here, seems you have the wrong filepath.')</nowiki>
<br /><nowiki>end</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>#Extract Data</nowiki>
<br />''<nowiki>%% This could be loadnmr or loaddmx - default should be loadnmr</nowiki>''
<br /><nowiki>display('With "@loadnmr" and "@loaddmx" as your choices. Refer to the manual for these functions.');</nowiki>
<br /><nowiki>loadingfunc = input('Which would you like to use? ', "s");</nowiki>
<br /><nowiki>if loadingfunc ~= '@loadnmr' || loadingfunc ~= '@loaddmx'</nowiki>
<br /><nowiki>  error('A loading function was not chosen correctly');</nowiki>
<br /><nowiki>end</nowiki>
<br /><nowiki>[F.data, F.parms, F.t] = feval(loadingfunc, F.dirs); %% Assumes F.dirs were all run with similar parameters</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>#Apodization, Zerofill and Fourier Transform</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>apodizing = input('Would you like to apodize?(y,n) ', "s")</nowiki>
<br /><nowiki>if apodizing == 'y' || apodizing == 'Y'</nowiki>
<br /><nowiki>  display('With "@expwindow", "@gausswindow", and "@sinewindow" being the options.(Refer to the manual)')</nowiki>
<br /><nowiki>  functionhandleofapodization = input('Which function would you like to use? ',"s"); %% User choice on function handle</nowiki>
<br /><nowiki>  F.data = apodize(F.data,F.parms,functionhandleofapodization);</nowiki>
<br /><nowiki>end</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>zerofilling = input('Would you like to zerofill?(y,n) ', "s");</nowiki>
<br /><nowiki>if zerofilling == 'y' || zerofilling == 'Y'</nowiki>
<br /><nowiki>  numberofzerofills = input('How many zerofills would you like? '); %% User choice on number</nowiki>
<br /><nowiki>  F.data = zerofill(F.data,F.parms,numberofzerofills);</nowiki>
<br /><nowiki>end</nowiki>
<br /><nowiki>[S.data, S.ppm] = nmrft(F.data, F.parms);%% finally do something</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>#Phase and extract real</nowiki>
<br />''<nowiki>%% phase correction method objective can be decided</nowiki>''
<br /><nowiki>display('Automatic phasing will be performed, you can choose an objective function. Your options are "@simplex_minimum", "@simplex_entropy", "@simplex_whiten", or "@simplex_integral". (Refer to manual)')</nowiki>
<br /><nowiki>phaseobjective = input('Which objective do you choose? ', "s");</nowiki>
<br /><nowiki>[S.data, S.phc0, S.phc1] = autophase(S.data, F.parms, phaseobjective);</nowiki>
<br /><nowiki>[S.data, S.phc0, S.phc1] = autophase(S.data, F.parms, phaseobjective);</nowiki>
<br /><nowiki>X.data = realnmr(S.data, F.parms); %% extract numerical data</nowiki>
<br /><nowiki>X.ppm = S.ppm;</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>#Alignment and Referencing</nowiki>
<br />''<nowiki>%% an if could be used to decide if icosshift or cosshift here**</nowiki>''
<br /><nowiki>display('With "@coshift" and "@icoshift" as your options.')</nowiki>
<br /><nowiki>alignmentoption = input('Which alignment method would you like to use? ',"s");</nowiki>
<br /><nowiki>X.data = feval(alignmentoption, X.data, X.ppm);</nowiki>
<br /><nowiki>X.data = feval(alignmentoption, X.data, X.ppm);</nowiki>
<br /><nowiki>X.data = feval(alignmentoption, X.data, X.ppm);</nowiki>
<br /><nowiki>plot(X.ppm, X.data);</nowiki>
<br /><nowiki></nowiki>
<br />''<nowiki>%% an automatic referencing method could be used instead of this (no automatic method currently available)</nowiki>''
<br /><nowiki>adjust_zero = 1</nowiki>
<br /><nowiki>zero_adjustment = 0</nowiki>
<br /><nowiki>  while adjust_zero</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>  X.ppm = refadj(X.ppm, zero_adjustment, 0.0);</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>  plot(X.ppm, X.data);</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>  adjust_input = input('Do you need to zero?(y/n)  ',"s");</nowiki>
<br /><nowiki>  if adjust_input == "Y" || adjust_input == "y"</nowiki>
<br /><nowiki>          adjust_zero = 1;</nowiki>
<br /><nowiki>        zero_adjustment = input('How much Adjustment?  ');</nowiki>
<br /><nowiki>    else</nowiki>
<br /><nowiki>          adjust_zero = 0;</nowiki>
<br /><nowiki>    end</nowiki>
<br /><nowiki>  end</nowiki>
<br /><nowiki></nowiki>
<br />''<nowiki>%% this can be selected as the manual removal method - otherwise ROI methods could be used?**</nowiki>''
<br /><nowiki>  remove_var = 1;</nowiki>
<br /><nowiki>  while remove_var</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>  remove_input = input('Do you need to remove data?(y/n)  ',"s");</nowiki>
<br /><nowiki>  if remove_input == "Y" || remove_input == "y"</nowiki>
<br /><nowiki>          remove_var = 1;</nowiki>
<br /><nowiki>        kmin_input = input('What is the minumum of the range?  ');</nowiki>
<br /><nowiki>            kmax_input = input('What is the maximum of the range?  ');</nowiki>
<br /><nowiki>            idxmin = findnearest(X.ppm, kmax_input);</nowiki>
<br /><nowiki>            idxmax = findnearest(X.ppm, kmax_input);</nowiki>
<br /><nowiki>            X.rmvar = [idxmax:idxmin];</nowiki>
<br /><nowiki>            [X.data, X.ppm] = rmvar(X.data, X.ppm, X.rmvar);</nowiki>
<br /><nowiki>            plot(X.ppm, X.data);</nowiki>
<br /><nowiki>    else</nowiki>
<br /><nowiki>          remove_var = 0;</nowiki>
<br /><nowiki>    end</nowiki>
<br /><nowiki>  end</nowiki>
<br /><nowiki></nowiki>
<br />''<nowiki>%% binning can be done a number of ways we default to adaptive binning***</nowiki>''
<br /><nowiki>display('There are multiple ways of binning, this walkthrough uses binadapt.')</nowiki>
<br /><nowiki>[X.bindata, X.binppm] = binadapt(X.data, X.ppm, F.parms);</nowiki>
<br />''<nowiki>%% normalization has multiple options these need to be considered ***</nowiki>''
<br /><nowiki>X.bindata = histmatch(X.bindata);</nowiki>
<br /><nowiki></nowiki>
<br /><nowiki>display('To this point, the important data is extracted and binned as "X.bindata" and can be analyzed');</nowiki>
<br /><nowiki></nowiki>

Latest revision as of 20:47, 23 March 2022

A good start

This page represents a good script to get started in MVAPACK/Octave. Copy the script below, or download this one, and save as a .m file in your favorite simple text editor.


The Script


#Get Files
display('Using typical unix filename syntax (i.e. ./* or ../your/file/is/here/* or ???). This will only use directories.')
filepath = input('What is the path to your data? ',"s");
F.fileglob = glob(filepath);  %% Number of ? is the number of digits of the file name

%% We only use directories here
count = 1;
sizeoffileglob = numel(F.fileglob);
currentdir = pwd;
for i = [1:sizeoffileglob]
if isfolder(F.fileglob{i})
cd(F.fileglob{i});
if (stat('ser') || stat('fid'))
continue;
end
cd(currentdir);
F.dirs{count++} = F.fileglob{i};
end
end
checkforexistence = exist('F.dirs')
if checkforexistence
error('There is no NMR data here, seems you have the wrong filepath.')
end


#Extract Data
%% This could be loadnmr or loaddmx - default should be loadnmr
display('With "@loadnmr" and "@loaddmx" as your choices. Refer to the manual for these functions.');
loadingfunc = input('Which would you like to use? ', "s");
if loadingfunc ~= '@loadnmr' || loadingfunc ~= '@loaddmx'
error('A loading function was not chosen correctly');
end
[F.data, F.parms, F.t] = feval(loadingfunc, F.dirs); %% Assumes F.dirs were all run with similar parameters

#Apodization, Zerofill and Fourier Transform

apodizing = input('Would you like to apodize?(y,n) ', "s")
if apodizing == 'y' || apodizing == 'Y'
display('With "@expwindow", "@gausswindow", and "@sinewindow" being the options.(Refer to the manual)')
functionhandleofapodization = input('Which function would you like to use? ',"s"); %% User choice on function handle
F.data = apodize(F.data,F.parms,functionhandleofapodization);
end

zerofilling = input('Would you like to zerofill?(y,n) ', "s");
if zerofilling == 'y' || zerofilling == 'Y'
numberofzerofills = input('How many zerofills would you like? '); %% User choice on number
F.data = zerofill(F.data,F.parms,numberofzerofills);
end
[S.data, S.ppm] = nmrft(F.data, F.parms);%% finally do something

#Phase and extract real
%% phase correction method objective can be decided
display('Automatic phasing will be performed, you can choose an objective function. Your options are "@simplex_minimum", "@simplex_entropy", "@simplex_whiten", or "@simplex_integral". (Refer to manual)')
phaseobjective = input('Which objective do you choose? ', "s");
[S.data, S.phc0, S.phc1] = autophase(S.data, F.parms, phaseobjective);
[S.data, S.phc0, S.phc1] = autophase(S.data, F.parms, phaseobjective);
X.data = realnmr(S.data, F.parms); %% extract numerical data
X.ppm = S.ppm;

#Alignment and Referencing
%% an if could be used to decide if icosshift or cosshift here**
display('With "@coshift" and "@icoshift" as your options.')
alignmentoption = input('Which alignment method would you like to use? ',"s");
X.data = feval(alignmentoption, X.data, X.ppm);
X.data = feval(alignmentoption, X.data, X.ppm);
X.data = feval(alignmentoption, X.data, X.ppm);
plot(X.ppm, X.data);

%% an automatic referencing method could be used instead of this (no automatic method currently available)
adjust_zero = 1
zero_adjustment = 0
while adjust_zero

X.ppm = refadj(X.ppm, zero_adjustment, 0.0);

plot(X.ppm, X.data);

adjust_input = input('Do you need to zero?(y/n) ',"s");
if adjust_input == "Y" || adjust_input == "y"
adjust_zero = 1;
zero_adjustment = input('How much Adjustment? ');
else
adjust_zero = 0;
end
end

%% this can be selected as the manual removal method - otherwise ROI methods could be used?**
remove_var = 1;
while remove_var

remove_input = input('Do you need to remove data?(y/n) ',"s");
if remove_input == "Y" || remove_input == "y"
remove_var = 1;
kmin_input = input('What is the minumum of the range? ');
kmax_input = input('What is the maximum of the range? ');
idxmin = findnearest(X.ppm, kmax_input);
idxmax = findnearest(X.ppm, kmax_input);
X.rmvar = [idxmax:idxmin];
[X.data, X.ppm] = rmvar(X.data, X.ppm, X.rmvar);
plot(X.ppm, X.data);
else
remove_var = 0;
end
end

%% binning can be done a number of ways we default to adaptive binning***
display('There are multiple ways of binning, this walkthrough uses binadapt.')
[X.bindata, X.binppm] = binadapt(X.data, X.ppm, F.parms);
%% normalization has multiple options these need to be considered ***
X.bindata = histmatch(X.bindata);

display('To this point, the important data is extracted and binned as "X.bindata" and can be analyzed');