Installation of the mat2dcorr toolbox and Mat2dcorr - A Matlab Toolbox for 2D-COS: Difference between pages

From 2D-COS Wiki
(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
__FORCETOC__
__FORCETOC__
To download go to [http://www.peter-lasch.de/2dcorr/ http://www.peter-lasch.de/2dcorr/]
mat2dcorr - a free toolbox for performing two-dimensionsonal correlation (2D-COS) analysis with [https://www.mathworks.com Matlab].<br>


== Required files / Software / OS ==
== Introduction ==


[[File:index-of-2dcorr.jpg|500px|thumb|Mat2Dcorr: index of http://www.peter-lasch.de/2dcorr]]
[[File:2D-COS.jpg|450px|thumb|Mat2Dcorr: Screenshot of the 2D control window (left) and the window '2D correlation
analysis ... ' (right)]]


'''Program Files''' of the mat2Dcorr toolbox:
Two-dimensional correlation spectroscopy (2D-COS), sometimes referred to as two-dimensional correlation analysis, has become an invaluable analytical tool for spectroscopic characterization in various fields of application, including protein science, pharmaceutics, biomedical applications, and polymer or nanomaterial research, since its early introduction in 1989. The technique of 2D-COS analysis was originally developed to study dynamic processes in which a spectroscopic probe is used to monitor the effect of an external perturbation on a given system. The system responds to the perturbation by characteristic changes that are monitored spectroscopically, e.g. by continuous acquisition of a spectral time series. The main purpose of 2D-COS investigations is to explore correlations that may exist between perturbation-induced spectral responses. In some situations, the 2D-COS analysis technique is useful not only to detect and visualize such correlations, but also to decipher the sequence of these spectral changes. Sources of perturbation can include changes in temperature, pH, pressure, concentration, or spatial coordinates when examining spatially heterogeneous samples. The 2D correlation concept has proven to be extremely useful in a wide variety of molecular spectroscopy applications based on IR, NIR, Raman, NMR, fluorescence and UV-visible spectroscopy.
<ol>
<li> mat2dcorr.m</li>
<li> updcorrplt.m</li>
<li> resiz2dfig.m</li>
<li> readme.txt</li>
</ol>


'''Software''':
An introduction into the history, mathematics and basic principles of 2D-COS can be found here: https://en.wikipedia.org/wiki/Two-dimensional_correlation_analysis
<ol start="5">
<li> [https://www.mathworks.com Matlab] R2014a or newer</li>
</ol>


'''Operating Systems''':
== Getting Started ==
<ul>
* [[Computer_Specification|Specification of computer configuration]]
<li> Windows 10</li>
* [[Screenshot_of_mat2dcorr|Screenshot of the mat2dcorr gui]]
<li> LINUX (Debian Stretch/Buster/Bullseye)</li>
* <span style="color:red"> Downloading mat2dcorr</span> - [[How_to_obtain_the_mat2dcorr_toolbox|How to obtain the mat2dcorr toolbox?]]
</ul>
* [[Installation_of_the_mat2dcorr_toolbox|Installation of the mat2dcorr toolbox]]
* [[Disclaimer_and_License_Conditions |Disclaimer and license conditions]]
* [[mat2dcorr_-_Relevant Publications|Acknowledgement, relevant publications]]
* [[Frequently_Asked_Questions_(FAQ)|Frequently asked questions (FAQ)]]


== Extra files (spectral data files) ==
== Data Import & File Formats  ==


<ol start="5">
* [[Matlab_Imaging_Format|Import data in the imaging format (Matlab)]]
<li> linescandata.mat - example data file in the trace (2D) data format, see also [[Matlab_Trace_Format| Matlab trace data format]] </li>
* [[Matlab_Trace_Format|Import data in the trace format (Matlab)]]
<li> linescandata.xlsx - example data file in the trace (2D) data format (MS Excel)
* [[Format_of_a_2D-COS_Result_File|Format of a 2D-COS result file (Matlab)]]
</li>
<li> IR-cerebellum-100x100.mat - example data file in the hyperspectral imaging (HSI) data format (FT-IR spectra from hamster cerebellum), see also [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> IR-cerebellum-50x50.mat - example data (50 x 50 spectra, interpolated), [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> MALDI-cerebellum-100x100.mat - example data file (100 x 100 spectra) in the HSI data format (MALDI-TOF mass spectra from hamster cerebellum), [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> MALDI-cerebellum-50x50.mat - example data file (50 x 50 spectra, interpolated), [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> Raman-cerebellum-100x100.mat - example data file (100 x 100 spectra) in the HSI data format (MALDI-TOF mass spectra from hamster cerebellum), [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> Raman-cerebellum-50x50.mat - example data file (50 x 50 spectra, interpolated), [[Matlab_Imaging_Format| Matlab imaging data format ]]</li>
<li> fftsyncro.mat - result file of 2D correlation analysis by the mat2dcorr toolbox using the FFT 2D-COS option, for details of the result file format refer also to the section [[Format_of_a_2D-COS_Result_File|format of a 2D-COS result file (Matlab)]]</li>
<li> statssyncro.mat - result file of 2D correlation analysis by the mat2dcorr toolbox using the statistical 2D-COS option, for details of the result file format refer also to the section [[Format_of_a_2D-COS_Result_File|format of a 2D-COS result file (Matlab)]]</li>
</ol>


== Installation ==
== Options of the mat2dcorr Toolbox ==


* Download files 1.-4. + some test data (see above) and and copy them into one single directory, for example into a directory ''mat2dcos''.
* [[Options_of_the_2D-COS_Main_Figure| Options of the 2D-COS main figure]]
* Add then this directory to Matlab's search path. For this start Matlab and type<br>
* [[Options_of_the_2D-COS_Control_Window| Options of the 2D-COS control window]]


    >> addpath('Mat2DcorrPath')
== Related Publications and Web Links ==


at the Matlab command prompt, where ''Mat2DcorrPath'' denotes the full path where the the toolbox resides (i.e. ''mat2dcos'').<br>
[[File:GraphAbstr.gif|500px|thumb|Mat2Dcorr: Illustration of Heterspectral 2D-COS (FTIR vs. Raman)]]
Example of Mat2DcorrPath: ''C:\Users\Tim\Documents\Matlab\mat2dcos''


* To start mat2Dcorr type<br>
* [https://en.wikipedia.org/wiki/Two-dimensional_correlation_analysis Two-dimensional correlation analysis] (Wikipedia)


    >> mat2dcorr
* I. Noda. [https://doi.org/10.1366/0003702904087398 Two-Dimensional Infrared (2D IR) Spectroscopy: Theory and Applications], 1990 Appl. Spectrosc. 44(4): 550-561


at the Matlab prompt.<br>
* I. Noda. [https://doi.org/10.1366/0003702934067694 Generalized Two- Dimensional Correlation Method Applicable to Infrared, Raman, and other Types of Spectroscopy], 1993 Appl. Spectrosc. 47(9): 1329-1336


This will open two different windows:  
* I. Noda. [https://doi.org/10.1366/0003702001950472 Determination of Two-Dimensional Correlation Spectra Using the Hilbert Transform], 2000 Appl. Spectrosc. 54(7): 994-999
# A window entitled '2D correlation analysis ... ' which shows the 2D correlation spectrum and mean spectra obtained from the x- and y-spectral data
# The 2D-COS control window, the user dialog box, see screenshot below


[[File:2D-COS.jpg|800px|thumb|Mat2Dcorr: screenshot of the 2D control window (left) and the window '2D correlation
* P. Lasch & I. Noda. [https://doi.org/10.1021/acs.analchem.7b00332 Two-Dimensional Correlation Spectroscopy for Multimodal Analysis of FT-IR, Raman, and MALDI-TOF MS Hyperspectral Images with Hamster Brain Tissue]. Anal. Chem. 2017, 89, 9, 5008–5016
analysis ... ' (right)]]
 
* P. Lasch & I. Noda. [https://doi.org/10.1177/0003702818819880 Two-Dimensional Correlation Spectroscopy (2D-COS) for Analysis of Spatially Resolved Vibrational Spectra]. 2019 Appl. Spectrosc. 73(4): 359-379
 
<br> &nbsp; <br>
 
Mar 18, 2023: more details of the mat2dcorr Matlab toolbox will follow soon

Revision as of 16:38, 2 April 2023

mat2dcorr - a free toolbox for performing two-dimensionsonal correlation (2D-COS) analysis with Matlab.

Introduction

Mat2Dcorr: Screenshot of the 2D control window (left) and the window '2D correlation analysis ... ' (right)

Two-dimensional correlation spectroscopy (2D-COS), sometimes referred to as two-dimensional correlation analysis, has become an invaluable analytical tool for spectroscopic characterization in various fields of application, including protein science, pharmaceutics, biomedical applications, and polymer or nanomaterial research, since its early introduction in 1989. The technique of 2D-COS analysis was originally developed to study dynamic processes in which a spectroscopic probe is used to monitor the effect of an external perturbation on a given system. The system responds to the perturbation by characteristic changes that are monitored spectroscopically, e.g. by continuous acquisition of a spectral time series. The main purpose of 2D-COS investigations is to explore correlations that may exist between perturbation-induced spectral responses. In some situations, the 2D-COS analysis technique is useful not only to detect and visualize such correlations, but also to decipher the sequence of these spectral changes. Sources of perturbation can include changes in temperature, pH, pressure, concentration, or spatial coordinates when examining spatially heterogeneous samples. The 2D correlation concept has proven to be extremely useful in a wide variety of molecular spectroscopy applications based on IR, NIR, Raman, NMR, fluorescence and UV-visible spectroscopy.

An introduction into the history, mathematics and basic principles of 2D-COS can be found here: https://en.wikipedia.org/wiki/Two-dimensional_correlation_analysis

Getting Started

Data Import & File Formats

Options of the mat2dcorr Toolbox

Related Publications and Web Links

Mat2Dcorr: Illustration of Heterspectral 2D-COS (FTIR vs. Raman)


 

Mar 18, 2023: more details of the mat2dcorr Matlab toolbox will follow soon