Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

jcampread

Read JCAMP-DX-formatted files

Syntax

JCAMPStruct = jcampread(File)

Input Arguments

File

Either of the following:

  • Character vector specifying a file name, a path and file name, or a URL pointing to a file. The referenced file is a JCAMP-DX-formatted file (ASCII text file). If you specify only a file name, that file must be on the MATLAB® search path or in the current folder.

  • MATLAB character array that contains the text of a JCAMP-DX-formatted file.

Output Arguments

JCAMPStructMATLAB structure containing information from a JCAMP-DX-formatted file.

Description

JCAMP-DX is a file format for infrared, NMR, and mass spectrometry data from the Joint Committee on Atomic and Molecular Physical Data (JCAMP). jcampread supports reading data from files saved with Versions 4.24, 5, or 6 of the JCAMP-DX format. For more details, see:

JCAMPStruct = jcampread(File) reads data from File, a JCAMP-DX-formatted file, and creates JCAMPStruct, a MATLAB structure containing the following fields.

Field
Title
DataType
DataClass (version 5.00 and above)
Origin
Owner
Blocks
Notes

The Blocks field of the structure is an array of structures corresponding to each set of data in the file. These structures have the following fields.

Field
XData
YData
ZData (if multiple blocks)
XUnits
YUnits
ZUnits (if multiple blocks)
Notes

Examples

  1. Open a Web browser to

  2. Download the testdata.zip file to your MATLAB Current Folder.

  3. Extract isas_ms1.dx, a JCAMP-DX-formatted file, from the testdata.zip file to your MATLAB Current Folder.

  4. Read the data from the JCAMP-DX-formatted file, isas_ms1.dx, into the MATLAB software

    jcampStruct = jcampread('isas_ms1.dx') 
    
    jcampStruct = 
    
            Title: '2-Chlorphenol'
         DataType: 'MASS SPECTRUM'
        DataClass: 'PEAKTABLE'
           Origin: 'H. Mayer, ISAS Dortmund'
            Owner: 'COPYRIGHT (C) 1993 by ISAS Dortmund, FRG'
           Blocks: [1x1 struct]
            Notes: {8x2 cell}
    
  5. Plot the mass spectrum.

    data = jcampStruct.Blocks(1); 
    stem(data.XData,data.YData, '.', 'MarkerEdgeColor','w');
    title(jcampStruct.Title); 
    xlabel(data.XUnits); 
    ylabel(data.YUnits);

Introduced before R2006a

Was this topic helpful?