You are on page 1of 7

special report

JCAMP-DX for NMR *

ANTONY N. DAVIESt and PETER LAMPEN


ISAS, Institut fiir Spektrochemie und angewandte Spektroskopie, Postfach 10 13 52, 44139 Dortmund, Germany

Following the development and puЬlication of the JCAMP-DX protocol 2. SCOPE


4.24 and its successful implementation in the field of infrared spectros­
copy, data exchange without Ioss of information, between systems of This standard was accepted and given free for puЬli­
different origin and internal format, has become а reality. The benefits cation at the JCAMP executive meeting in Chicago on
of this system-independent data transfer standard have been recognized 5 March 1991. The protocol follows the general lines laid
Ьу workers in other areas who have expressed а wish for an equivalent, down in the JCAMP 4.241 protocol and adheres to the
compatiЬie standard in their own fields. This publication details а pro­ design criteria stated therein. It has been expanded to
tocol for the exchange of Nuclear Magnetic Resonance (NMR) spectral include new features availaЬle under Generic JCAMP­
data without any Ioss of information and in format that is compatiЬle
а
DX Version 5.0.2•3 The protocol is meant for puЬlic use.
with all storage media and computer systems. The protocol detailed
The specifications are placed in the puЬlic domain and
below is designed for spectral data transfer, and its use for NMR imaging
data transfer has not as yet been investigated.
right to сору for scientific purposes is hereby granted.
Index Headings: Computer applications; NMR.

3. FILE STRUCTURES AND DEFINIТIONS

1. INTRODUCТION File structures and definitions are as defined in sec­


tions 3 and 4 of the JCAMP-DX 4.24 protocol.l The
Following discussions in the U.S.A. and Europe it was Generic JCAMP-DX Version 5.0 allows the use of а new
agreed that the Nuclear Magnetic Resonance (NMR) NTUPLE data structure. Under JCAMP-DX Version
JCAMP-DX standard would Ье prepared for implemen­ 5.0, the file content is divided into two main sections,
tation under the fledgling Generic JCAMP-DX Version the CORE and the NOTES, each section containing the
5.0 format rather than the JCAMP-DX 4.24 compatiЬle general GLOBAL information common to all JCAMP­
form originally envisaged. The commitment of three DX files and the NMR DAТАТУРЕ SPECIFIC infor­
leading NMR spectrometer manufacturers at the Sixth mation, which is defined in this puЬlication. The data­
INUM Conference in Italy 1990 to implement the stan­ type-specific labels differ from the global labels in that
dard when finished also provided extra impetus to the they are written "##.labelname=" rather than "##la­
development. Small changes have been made to the drafts belname=."
circulated to overcome difficulties observed during initial
implementation of the earlier versions. The proЬlems
associated with the storage of multidimensional data sets 4. DATA REPRESENTAТION
have not yet been fully classified or overcome, so this
Data compression presents а new proЬlem for NMR
proposal does not define any special storage format for spectral coding. For NMR spectra, simple data sets con­
multi-dimensional NMR experiments outside what is al­ tain only real values and can Ье coded as in infrared
rэady possiЬle within the Generic JCAMP-DX Version spectroscopy, since the imaginary values are not of in­
5.0 "NTUPLE" format. This puЬlication freezes the
terest. When an NMR free-induced decay (FID) is to Ье
development of the simple data model for NMR and will
transferred, there are more factors which are required to
Ье expanded toward multi-dimensional data sets at а
enaЬle successful conversion. Phasing and mode of data
later date. acquisition should now Ье included. FIDs will Ье handled
differently depending on whether they originate from а
spectrometer with а single detector and analog-to-dig­
Received 14 January 1993.
ital converter (ADC) or with twin detectors and а single
* Contributing Persons: Antony N. Davies (Coordinator), ISAS Dort­
mund, F.R.G.; Charles Thibault, Bruker, U.S.A.; Robert S. Mc­
ADC. The processing is different again for an FID ob­
Donald, Burnt Hills, U.S.A.; Thomas Юimpchen, University of Mar­ tained Ьу normal quad detection.
burg, F.R.G.; Heinrich Hillig, ISAS Dortmund, F.R.G.; Reinhard While we will not go into the benefits of the various
Neudert, BASF, F.R.G.; Dan Iverson, Varian, U.S.A.; Ben Hendriks, methods it is clear that, before an FID from one of these
Solvay Duphar, The Netherlands; Doug Meinhart JEOL, U.S.A.;
Howard M�ck, Bran Luebbe, U.S.A.; Peter Lampen and Jorg Lam­
acquisition methods can Ье converted into the internal
bert, ISAS Dortmund, F.R.G. storage format of а computer designed to handle data
t Author to whom correspondence should Ье sent. from one of the other methods, а significant amount of

Volume 47, Number 8, 1993 0003-7028/93/4708·1093$2.00/0 APPLIED SPECTROSCOPY 1093


© 1993 Society for Applied Spectroscopy
coпversioп must take place. То flag the пecessary coп­ iпclude the values NMR FID, NMR SPECTRUM, NMR
versioп, the datatype-specific LDR ##.ACQUISITION РЕАК TABLE, or NMR РЕАК ASSIGNMENTS апd
MODE=, with the priority REQUIRED for FIDs, will has the priority REQUIRED.
Ье used. (5.1.3) ##DATA CLASS= (STRING) coпtaiпs XY­
(4.1) TA:ВULAR DATA. If а simple ���·/IR spectrum D.A.TJ.л:a., XYPOI��TS, РЕ.А.К T.A.BLE, .A.SSIG��l\...1:E�JTS,
is to Ье coded апd traпsferred, theп the ##XYDA­ or NTUPLES. The label is priority WARN апd should
TА= (Х++(У..У)) format suffices. However, for more Ье iпcluded. This label defiпes the type of tabular data
effective use of the DIFDUP priпciple (see Ref. 1, Sectioп withiп the data Ьlock апd is поt to Ье used for liпk Ьlocks.
5.10) the real апd imagiпary data sets of the FID or (5.1.4) Two labels, ##ORIGIN= and ##OWNER=,
spectrum shouid Ье coded iпdepeпdeпtly. This separate have the priority WARN апd shouid Ье iпciuded. Soft­
codiпg requires the use of two iпdepeпdeпt, cross-ref­ ware developers should eпsure that а JCAMP-DX file
erenced Ьlocks or the NTUPLE format. cannot Ье created with these fields left Ьlank.
(4.1.1) VARIABLE LIST. The forms of tabular data (5.2) CORE VARIABLE HEADER INFORMA­
represeпted iп JCAMP-DX 4.24 coпtiпue to Ье valid ТION.
here, but iп additioп several others are preseпted. То (5.2.1) ##BLOCKS=, and ##BLOCк_____jD= (STRING)
differeпtiate betweeп real апd imagiпary data lists, the are used as suggested iп the JCAMP-DX 4.24 protocol
formats (Х + + (R..R)) for real values and (Х + + (I. .l)) (3.2)1 with the extensions defined in the JCA:МP-CS pro­
for imagiпary values are adopted where .. coпtiпues to tocol (5.13)4 to provide iпter-Ьlock refereпciпg. Wheп,
iпdicate iпdefiпite repeat uпtil the liпe is filled апd ++ for example, XYDATA апd а РЕАК TABLE are to Ье
.
iпdicates that Х is iпcremeпted Ьу (LASTX-FIRSTX)/ stored, these must Ье writteп as а compouпd file1 (see
(NPOINTS-1). Other miner chaпges are detailed iп the also sectioп 5.4 below). The use of compouпd data files
text where reievaпt. is, of course, optioпai, but wheп more thaп опе Ьlock per
(4.2) DATA COMPRESSION. The AFFN, PACKED, file is stored the ##BLOCKS= LDR has the priority
SQUEEZED, and DIFFERE��CE formats are allowed as REQUIRED. .LA� unique positive integer should Ье given
defiпed iп the JCAMP-DX 4.24 puЬlicatioп (5.2-5.6).1 to each Ьlock iпside the compouпd JCAMP-DX file.
The DIFFERENCE format is recommeпded to miпimize Liпkiпg of the Ьlocks сап theп Ье achieved with the use
file storage requiremeпts. of ##CROSS REFERENCE= (see example 4).
(4.3) X-SEQUENCE AND Y-VALUE CHECKING. (5.2.2) ##.OBSERVE FREQUENCY= (AFFN). Ob­
X-sequeпce апd У-value checkiпg is to Ье carried out as server frequeпcy iп MHz. Priority REQUIRED.
specified iп JCAMP-DX Versioп 4.24 (5.8). (5.2.3) ##.OBSERVE NUCLEUS= (STRING). Ob­
(4.4) DUPLICATE SUPPRESSION. Duplicate sup­ served пucleus writteп as described iп JCAMP-DX 4.24
pressioп сап Ье carried out as detailed iп the JCAMP­ sectioп (7.2.4)1 (i.e., л13С). This LDR has the priority
DX 4.24 protocol (5.9). REQUIRED.
(5.2.4) ##.SOLVENT REFERENCE= (AFFN). Sol­
veпt lock sigпal iп ppm. Priority REQUIRED if а solveпt
lock sigпal was used iпstead of TMS.
5. THE CORE
(5.2.5) ##.DELAY= (RD, ID). Pre-acquisitioп delays
This sectioп describes the data labels for the JCAMP­ for the real values (RD) апd the imagiпary values (ID)
DX NMR core data. The Core coпsists of four parts. The iп !J-S. This agreemeпt allows for the storage of simulta­
first part, called the "Fixed Header Iпformatioп," coп­ пeously recorded real апd imagiпary data FIDs where
taiпs geпeric label data records (LDRs), which are re­ the two delays will Ье ideпtical, or alterпatiпg recorded
quired for all JCAMP-DX files апd which appear at the real апd imagiпary FIDs where the two delays will Ье
begiппiпg of each file iп а giveп order. The "VariaЬle differeпt. This LDR has the priority REQUIRED iп
Header Iпformatioп" coпtaiпs records which are data­ ##DATATYPE= NMR FID but priority OPTIONAL
type specific (iп this case NMR-specific) or which are for ##DATATYPE= NMR SPECTRUM, NMR
used опlу iп special types of JCAMP-DX files (e.g., com­ РЕАК TABLE, апd NMR РЕАК ASSIGNMENTS.
pouпd files). Whether а particular LDR is required or (5.2.6) ##.ACQUISIТION MODE= (STRING). This
поt depeпds оп the applicatioп. The third sectioп, "Core LDR has the priority REQUIRED for ##DATATYPE=
Data," coпtaiпs the spectral parameters for the fourth NMR FID but опlу OPTIONAL for NMR SPECTRUM,
sectioп, the "Data ТаЬlе." The type of data iп the data NMR РЕАК TABLE, апd NMR РЕАК ASSIGN­
taЬle determiпes the parameters which must appear iп MENTS. It сап take the value SIMULТANEOUS for
the core data. Опlу опе data taЬle may appear per data oЬtaiпed from true quadrature detectioп usiпg two
JCAMP-DX Ьlock (а Ьlock beiпg а part of the JCAMP­ detectors апd two ADCs, SINGLE for Time Proportioпal
DX file startiпg with ##TITLE= апd eпdiпg with Phase Iпcremeпt detectioп with а siпgle detector апd
##END=). ADC, апd the value SEQUENTIAL wheп data are ob­
(5.1) CORE FIXED HEADER INFORMATION. taiпed from two detectors with the use of опlу а siпgle
(5.1.1) ##ТITLE=, and ##JCAMP-DX=, are defiпed ADC.
as iп the DX 4.24 protocol (6.1)1 апd have the priority (5.3) CORE DATA.
REQUIRED. ##JCAMP-DX= has the value 5.00. The (5.3.1) ##XUNIТS= (STRING). For NMR data the
##JCAMP-DX=5.00 LDR should Ье followed Ьу а $$ followiпg abscissa uпits сап Ье specified: SECONDS for
commeпt оп the same liпe ideпtifyiпg the software pro­ FIDs апd HZ for spectra. Priority REQUIRED. Hz апd
duciпg the data file. РРМ are allowed for РЕАК ТABLES апd РЕАК AS­
(5.1.2) ##DATA ТУРЕ= (STRING) is expaпded to SIGNMENTS.

1094 Volume 47, Number 8, 1993


(5.3.2) ##YUNIТS= (STRING). Should Ье ARВI­ (5.4.2) ##XYPOINTS= (AFFN). Contains а taЬle of
TRARY UNITS. Priority REQUIRED. ХУ pairs and is for use with data which are not at equal
(5.3.3) ##FIRSTX=, ##LASTX= (AFFN). Are as de­ abscissa increments. This LDR is followed Ьу а variaЬle
fined in the JCAMP-DX 4.24 protocol (6.2.3)1 with pri­ list, i.e., (ХУ..ХУ), (XR ..XR), or (XI..XI). Х and У are
ority REQUIRED for XYDATA. separated Ьу commas; pairs are separated Ьу semicolons
(5.3.4) ##МАХХ=, ##MINX=, ##МАХУ=, or Ьlanks. This LDR must not Ье used for peak taЬles.
##MINY= (AFFN). Specifications are as defined in the Priority OPTIONAL.
JCAMP-DX 4.24 protocol (6.2.4)1 with priority OP­ (5.4.3) ##РЕАК TABLE= (STRING). Contains а ta­
TIONAL. Ьle of peaks. For abscissa against intensity, the variaЬle
(5.3.5) ##XFACTOR=, ##YFACTOR= (AFFN). list (ХУ..ХУ) should Ье used. For peak position, inten­
These labels remain as previously defined in the JCAMP­ sity, and width, the variaЬle list would Ье (XYW..XYW).
DX 4.24 protocol (6.2.5)1 and have the priority RE­ The function used to calculate the peak width must Ье
QUIRED for XYDATA. detailed in а $$ comment line immediately following the
(5.3.6) ##NPOINTS= (AFFN). Gives the number of ##РЕАК TABLE= line. For peak position, intensity,
components of ##XYDATA=, ##XYPOINTS=, and multiplicity, the variaЬle list would Ье (ХУМ ..ХУМ)
##РЕАК TABLE=, or ##РЕАК ASSIGNMENTS= where М stands for multiplicity (being S, D, Т, Q for
and has the priority REQUIRED. This label is not re­ singlets, douЬlets, triplets, or quadruplets, М for mul­
quired for the NTUPLE form where the ##VAR__DIM= tiple, and U for unassigned). List separators are commas,
label for the X-variaЬle is sufficient. and group separators are semicolons or new lines.
(5.3.7) ##FIRSTY= (AFFN). Actual Y-value corre­ А weak point in release 4.24 of JCAMP-DX was the
sponding to ##FIRSTX. ##FIRSTY= should equal inter-Ьlock linking. The use of ##BLOCK _ID= and
##YFACTOR= times the first Y-value in ##XYDA­ ##CROSS REFERENCE= in Version 5.0 now links
TA=. Priority WARN for XYDATA. Ьlocks of different information types. For the following
(5.4) CORE DATА ТABLE. This section deals with section and (6.2.14) such а link to а JCAMP-CS4 struc­
the different methods of storing the NMR data. The ture file is assumed, and the atom numbering of the CS
major changes from JCAMP-DX Version 4.24 are the file is carried over into the NMR Ьlock.
inclusion of the NTUPLE form, which is intended for (5.4.4) ##РЕАК ASSIGNMENTS= (STRING). List
multiple data sets and will Ье dealt with separately. N.B.: of peak assignments for components or functional groups
Only one of the following LDRs can Ье used in each Ьlock. in the forms ##РЕАК ASSIGNMENTS= (ХУА),
То store а spectrum using ##XYDATA= and also the (XYWА), (ХУМА), (XYMWА). Each entry is surround­
peaktaЬle using ##РЕАК ASSIGNMENTS=, for ex­ ed Ьу parentheses and starts а new line. У, W (peak
ample, would require two Ьlocks. width), and М (multiplicity) values are optional. The
(5.4.1) ##XYDATA= (AFFN or ASDF). Contains а symbol А stands for а string detailing the assignment
taЬle of ordinates at equal intervals specified Ьу param­ and must Ье enclosed Ьу angle brackets. If the peak width
eters defined in section 5.3. The label is followed Ьу а value is included, then the function used to calculate the
variaЬle list, (Х + + (У..У)), (Х + + R ..R)), or (Х + + (1. .1)). peak width must Ье detailed in а $$ comment on the
Priority OPTIONAL. line(s) below ##PEAK ASSIGNMENTS=. Priority OP­
(5.4.1.1) RECOMMENDED ORDINATE SCALING. TIONAL. N.B.: ##РЕАК ASSIGNMENTS= is the pre­
The recommended ordinate scaling between -32768 and ferred method of transmitting peak information when
32767 from Version 4.24 remains in force. There are cur­ the assignments are known.
rently few applications in NMR spectroscopy where this
dynamic range would Ье insufficient to code all the rel­
6. ТНЕ NOTES
evant information. Gratuitous use of larger ordinate scal­
ings normally provides only accurate transfer of noise! This section describes the data labels used for notes
If this range is exceeded, the values of ##МАХУ and in JCAMP-DX NMR. The inclusion of notes in a JCAMP­
##MINY must Ье given. DX file provides the opportunity for program designers
(5.4.1.2) ABSCISSA SPACING. This should Ье the to include relevant background information pertaining
abscissa of the internal data file. Any manipulation to to the spectrum. The choice of labels broadly depends
another form should Ье carried out Ьу the data system on the application.
requiring the different internal format. The JCAMP-DX (6.1) GLOBAL NOTES. The following parameters are
file should remain an exact representation of the original desiraЬle for clarity but must not Ье used for the con­
data, allowing conversion back into the original data sys­ version of the spectral data. They are used only to pro­
tem without any loss of information. vide information during visual inspection of the file.
(5.4.1.3) ABSCISSA ORDER. There are no require­ All sample and miscellaneous information notes de­
ments for а particular abscissa ordering, so decoding soft­ tailed in JCAMP-DX Version 4.24 (7.2 and 7.1) are ac­
ware must Ье аЬlе to соре with both ascending and de­ ceptaЬle. Structures should Ье included in JCAMP-CS
scending X-values. format rather than Wiswesser or Beilstein Lawson No.
(5.4.1.4) SPECTRUM SIZE. There are no restrictions Special note should Ье made of ##CONCENTRA­
on spectral size. Decoding software must therefore Ье TIONS=, since this LDR must Ье used to carry solvent
сараЬlе of reducing spectral resolution or extracting rel­ information and the inclusion of any standard in the
evant spectral regions if the size of the spectrum in the sample.
JCAMP-DX file exceeds the internal limits of the re­ The equipment information notes detailed in JCAMP­
ceiving system. DX Version 4.24 ##SPECTROMETER/DATA SYS-

APPLIED SPECTROSCOPY 1095


ТЕМ= (STRING), and ##INSTRUMENTAL PA­ (6.2.5) ##.ZERO FILL= (AFFN). Number of complex
RAMETERS= (STRING) are acceptaЬle and are zero filling points used. Priority OPTIONAL.
regarded as desiraЬle here. All the sampling information (6.2.6) ##.АVERAGES= (AFFN). Number of tran­
notes designated in 4.24 can Ье used in NMR except for sients averaged. Priority OPTIONAL.
the label ##PATHLENGTH=. (6.2.7) ##.DIGIТISER RES= (AFFN). Digitizer res­
(6.1.1) ##SAMPLING PROCEDURE= (ТЕХТ). This olution in Ьits. Priority OPTIONAL.
label can Ье used for coding the multifarious NMR pulse (6.2.8) ##.SPINNING RATE= (AFFN). Sample spin­
sequences, pulse delays, pre-acquisition delays, pulse an­ ning rate in Hz. Priority OPTIONAL.
gles, sample spin rates, etc. То define individual key­ (6.2.9) ##.PHASE О= (AFFN). Zero-order phase cor­
words would Ье pointless since the current in-vogue pulse rection in degrees. Priority OPTIONAL.
sequences will probaЬly Ье soon surpassed Ьу others and (6.2.10) ##.PHASE 1= (AFFN). First-order phase cor­
require that the protocol Ье updated for every new se­ rection in degrees per Hz relative to the maximum X-val­
quence, which is impractical. Decoupling information can ue. Priority OPTIONAL. If а pivot point other than the
also Ье included here. maximum X-value was used, then the phase correction
(6.1.2) ##DATA PROCESSING= (ТЕХТ). Informa­ figure should Ье recalculated for а pivot point at maxi­
tion on the data handling should Ье included here if mum X.
relevant-line broadening, window functions, filters, (6.2.11) ##.MIN INTENSIТY= (AFFN). Only for use
etc.-but only when the information is significant to the with peaktaЬles, used to represent the minimum inten­
spectrum. It is normally to Ье assumed that the spec­ sity used for peak picking. Priority OPTIONAL.
troscopist making the measurements was competent (6.2.12) ##.МАХ INTENSITY= (AFFN). Only for use
enough to set day-to-day parameters correctly for his or with peaktaЬles, used to represent the maximum inten­
her instrument and they would therefore not Ье included sity used for peak picking. Priority OPTIONAL.
in а transfer file. (6.2.13) ##.OBSERVE 90= (AFFN). 90 degree ob-
The various comment formats and the label LDRs server pulse time in J.LS. This LDR has the priority OP­
from JCAMP-DX Version 4.24 (7.5)1 are all valid in this TIONAL.
protocol. The following spectral parameters are also rec­ (6.2.14) ##.COUPLING CONSTANTS= (AFFN).
ommended. These LDRs appear as а list similar in format to
(6.1.3) ##RESOLUTION= (STRING). Nominal res­ ##РЕАК TABLE= but require the JCAMP-CS struc­
olution for the X-axis. Priority OPTIONAL. ture file to also Ье included and accessiЬle. For hetero­
(6.1.4) ##DELTAX= (AFFN). Nominal spacing be­ atoms ##.COUPLING CONSTANTS= should Ье fol­
tween X-values in Hz for spectra or seconds for FIDs lowed Ьу the variahle list J(A,B) where J is the coupling
depending on ##XUNITS= often referred to as the constant in Hz, А the atom number, and В the hetero­
sweepwidth. Priority OPTIONAL. The actual spacing atom number from the JCAMP-CS connection taЬle. For
must always Ье calculated with the formula proton coupling hydrogen В must Ье explicitly coded in
(LASTX-FIRSTX)/(NPOINTS-1). the CS file. Priority OPTIONAL.
(6.2) DATA ТУРЕ SPECIFIC NOTES. (6.2.15) ##.RELAXAТION TIMES= (AFFN). List of
(6.2.1) ##.FIELD= (AFFN). The magnetic field relaxation times with the variaЬle list (XYR) where Х
strength in Tesla should Ье included with the use of this and У are the abscissa and intensity values and R the
label. Priority OPTIONAL. relaxation time in seconds. Priority OPTIONAL.
(6.2.2) ##.DECOUPLER= (STRING). ТаЬlе of de­
coupler frequencies in the form ##.DECOUPLER=
7. COMPLEX DATA STORAGE
(F,90), where frequencies (F) are given in MHz and de­
coupler 90° pulses (90) in J.LS. Priority OPTIONAL. The new NTUPLE format is designed for multi-di­
(6.2.3) ##.FILTER WIDTH= (AFFN,TEXT). Filter mensional techniques with data sets of more than two
width in Hz followed Ьу а description of the filter al­ variaЬles (Ьу GC-IR, ХУ and time, for instance). ln the
gorithm. Priority OPTIONAL. NMR JCAMP-DX, the format can Ье used to solve the
(6.2.4) ##.ACQUISIТION ТIМЕ= (AFFN). Required proЬlem of the mixed real/imaginary FID data sets. The
for calculations involving resolution. Value given in sec­ best method of explaining the new format is with e�i­
onds. Priority OPTIONAL. ample 1.

Example 1.

##TITLE= ETHYLBENZENE/CDCL3
##JCAMP-DX= 5.00 $$ ISAS JCAMP-DX NMR program (draft version)
##DATA ТУРЕ= NMR FID
##DATA CLASS= NTUPLES
##ORIGIN= Dr.J.Lambert, ISAS Dortmund, FRG
##OWNER= Copyright (С) 1992 Ьу ISAS Dortmund, FRG
##.OBSERVE FREQUENCY= 100.4
##.OBSERVE NUCLEUS= А13С
##.DELAY= (22.5, 22.5)
##.ACQUISITION MODE= SIMULTANEOUS

1096 Volume 47, Number 8, 1993


##SPECTROMETER/DATA SYSTEM= JEOL GX 400
##NTUPLES= NMR FID
##VAILNAME= TIME, FID/REAL, FID/IMAG, PAGE NUMBER
##SYMBOL= Х, R, I, N
##VAR_TYPE= INDEPENDENT, DEPENDENT, DEPENDENT, PAGE
##VAILFORM= AFFN, ASDF, ASDF, AFFN
##VAILDIM= 16384, 16384, 16384, 2
##UNITS= SECONDS, ARBITRARY UNITS, ARBITRARY UNITS,
Г\ Г\
##FIRST= v.v, 2980, 6216, 1
##LAST= 0.682, -60242, -6064, 2
##MIN= 0.0, -170402, -165286, 1
##МАХ= 0.682, 149235, 161918, 2
##FACTOR= 0.4162852Е-04, 0.5200415Е+О1, 0.5044282Е+О1, 1
##PAGE= N=l
##DATA TABLE= (X++(R..R)), XYDATA $$ Real data points
OE73J0801K743n991j1702J2907o922p342r868p9141924J3049K1127R280J0543p471j2800

16376D9680380k283j1121078j2640L506p325
16383а1584 $$ checkpoint
##PAGE= N=2
##DATA TABLE= (X++(I .. I)), XYDATA <!!<!! 1maginary ааш poш"Ls
OA232J9544101901994j8571p88K0538J355J6653J718N398o027N305L183j909J1943k4401

16380h871o791o021Q439
16383а202 $$ checkpoint
##END NTUPLES= NMR FID
##END=

Both the real and imaginary data sets can Ье coded


been solved, and the necessary adaptions written into
within one Ьlock. When the data sets are of variaЬle
the protocol before development was frozen for puЬli­
length, ##NPOINTS= must follow the ##PAGE= la­
cation.
bel, and ##VAR_DIM= provides the maximum length
А standard which is independent of spectrometer man­
to Ье expected. The data-type-specific labels required
ufacturer and software сотраnу will also Ье of great
for FIDs would Ье placed above this data array section
value to those responsiЬle for installing and maintaining
of the file, as with the conventional JCAMP-DX file. The
spectroscopic data archives. The danger of not being аЬlе
NTUPLE format advantage lies in the simplified data
to read old electronic data onto new systems will Ье
coding offered.
negated.
Test files. А disk containing test data files in various
formats is availaЬle on request from the authors. Further
ACKNOWLEDGMENTS
examples of the file formats produced are given in the
appendix. The authors would like to thank the German Bundesminister fiir
Forschung und Technologie (BMFT) for financial support and en­
couragement, and the Ministerium fiir Wissenschaft und Forschung
8. CONCLUSIONS des Landes Nordrhein-Westfalen, Germany.

The benefits of the use of standard data transfer for­


mats is no longer in dispute. In а recent puЬlication5 the 1. R. S. McDonald and Р. А. Wilks, Appl. Spectrosc. 42, 151 (1988).
2. R. S. McDonald, private communication, "Generic JCAMP-DX
CoЬlentz Society detailed how JCAMP-DX files should
Memorandum No. 2" Sept. 4th 1990, Robert S. McDonald, JCAMP­
Ье used in future high-quality infrared spectral collec­ DX subcommittee, 9 Woodside Drive, Burnt Hills, New Уork 12027,
tions. They listed the information required to Ье trans­ U.S.A.
mitted with the spectra and the JCAMP-DX keywords 3. Generic JCAMP-DX, Version 5.0, Draft 1.0 February 28, 1991, R.
under which this information should Ье stored. S. McDonald, JCAMP-DX subcommittee, 9 Woodside Drive, Burnt
Hills, New York 12027, U.S.A. (Distributed at PITTCON-91)
We have recently received and corrected test files from 4. J. Gasteiger, В. М. Р. Hendriks, Р. Hoever, С. Jochum, and Н.
the instrument manufacturers who have been working Somberg, Appl. Spectrosc. 45, 4 (1991).
on implementing the draft version of this document. The 5. К. S. Kalasinsky, Р. R. Griffiths, D. F. Gurka, S. R. Lowry, and М.
proЬlems that arose during these implementations have Boruta, Appl. Spectrosc. 44, 211 (1990).

APPLIED SPECTROSCOPY 1097


APPENDIX

Example 2: А Test Spectrum.

##TITLE= ETHYLBENZENE/CDCL3
##JCAMP-DX= 5.00 $$ ISAS NMR JCAMP-DX program (draft version)
##DATA ТУРЕ= NMR SPECTRUM
##DATA CLASS= XYDATA
##ORIGIN= Dr.J.Lambert, ISAS Dortmund, FRG
##OWNER= Copyright (С) 1992 Ьу ISAS Dortmund, FRG
##.OBSERVE FREQUENCY= 100.4000
##.OBSERVE NUCLEUS= '13С
##SPECTROMETER/DATA SYSTEM= JEOL GX 400
##RESOLUTION= 1.470000
##DELTAX= -1.467283
##XUNITS= HZ
##YUNITS= ARBITRARY UNITS
##XFACTOR= 1.467283
##YFACTOR= 29670.15003
##FIRSTX= 24038.50
##LASTX= О.ОООООООЕ + ОО
##МАХУ= 972201806
##MINY= -27593240
##NPOINTS= 16384
##FIRSTY= 2254931
##XYDATA= (Х + + (У..У))
16383G6k53o5J88M13k12k70J95KOOk1301q3k25J80k9j20MQ6j16n7J70J57NL8q9N1MOk95
16356a63J98K3J59m73m8J80J10M1k28k55J83J45r2K59R5k82p8j9L50j12QM7j82K30117

59b10POJ9r2j02K9N5QOJ105k6mOJ75R9J31L34j51kj2111K12J81r3145L76k32o9rOK06103
30Ь44k49L53J02Q7QK8j24k16J86k02J79J87m3K21k34k20L17j32J25N8117J61Nj86J26R4
4GOJ71J43k15j18
ОЕ1 $$ checkpoint
##END=

Example 3: An Example Peak Assignment.

##TITLE= Test Run 1001


##JCAMP-DX= 5.00
##DATA ТУРЕ= NMR РЕАК ASSIGNMENTS
##DATA CLASS= ASSIGNMENTS
##ORIGIN= Dr.J.Lambert, ISAS Dortmund, FRG
##OWNER= Copyright (С) 1992 Ьу ISAS Dortmund, FRG
##.OBSERVE FREQUENCY= 100.4
##.OBSERVE NUCLEUS= '13С
##SPECTROMETER/DATA SYSTEM= JEOL GX 400
##RESOLUTION= 1.470000
##XUNITS= РРМ
##YUNITS= ARBITRARY UNITS
##NPOINTS= 22
##РЕАК ASSIGNMENTS= (ХУА)
(152.54, 1, (15))
(125.21, 1, (7))
(135.87, 1, (3))

##.COUPLING CONSTANTS= J(A,B)


8.500(5,18)
11.000(5,16)
165.300(3,19)
5.200(3,17)

##END=

1098 Volume 47, Number 8, 1993


Example 4: А Mask for а Compound File Consisting of Multiple DAТА BLOCKS with Structure Data and NMR
Peak Assignments.

All labeled data records (LDRs) not marked as OPTIONAL are REQUIRED
The text in ' ' must Ье replaced Ьу actual values.

##TITLE= 'title of the whole COMPOUND file'


##JCAMP-DX= 4.24 $$ 'Program, Version No.'
##DATA ТУРЕ= LINK
##BLOCKS= 'n' $$ n is the number of the DATA BLOCKS
##ORIGIN= 'name of the contributor, organization, address, telephone'
##OWNER= COPYRIGHT (С) 'year' Ьу 'name' $$ or PUBLIC DOMAIN

##TITLE= 'title of the first DATА BLOCK with structure data'


##JCAMP-CS= 3.7
##BLOCILID= 1
##ORIGIN= 'name of the contributor, organization, address, telephone'
##OWNER= COPYRIGHT (С) 'year' Ьу 'name' $$ or PUBLIC DOMAIN
##CROSS REFERENCE= NMR РЕАК ASSIGNMENTS:BLOCILID=2
$$ structure info see Reference 4.
##END= $$ end of the first DATA BLOCK

##TITLE= 'title of the second DATA BLOCK with peak assignments'


##JCAMP-DX= 5.00
##DATA ТУРЕ= NMR РЕАК ASSIGNMENTS
##DATA CLASS= ASSIGNMENTS
##BLOCK_ID= 2
##ORIGIN= 'name of the contributor, organization, address, telephone'
##OWNER= COPYRIGHT (С) 'year' Ьу 'name' $$ or PUBLIC DOMAIN
##.OBSERVE FREQUENCY= 'frequency in MHz'
##.OBSERVE NUCLEUS= '-1Н, '13С etc.'
##.SOLVENT REFERENCE= 'solvent lock signal in ppm' $$ see 5.2.3/5.2.4
##DATE= 'YY/MM/DD' $$ OPTIONAL
##TIME= 'HH:MM:SS' $$ OPTIONAL
##SOURCE REFERENCE= 'your spectrum identification' $$ OPTIONAL
##CROSS REFERENCE= STRUCTURE:BLOCILID=1
$$ other associated Ьlock Ids
$$ e.g. INFRARED SPECTRUM:BLOCILID='m'
##SAMPLE DESCRIPTION= 'sample information' $$ OPTIONAL
$$ e.g. SOLVENT='solvent'
##NAMES= 'sample names' $$ OPTIONAL
##SPECTROMETER/DATA SYSTEM= 'spectrometer' $$ OPTIONAL
##TEMPERATURE= 'temperature in degrees С' $$ OPTIONAL
##XUNITS= 'HZ or РРМ'
# #YUNITS= ARВITRARY UNITS
##NPOINTS= 'number of the peak assignments'
##РЕАК ASSIGNMENTS= (ХУМА) $$ VARIABLE
('x-value 1', 'y-value 1', 'multiplicity 1', ('assignment 1'))
('x-value 2', 'y-value 2', 'multiplicity 2', ('assignment 2'))

##.COUPLING CONSTANTS= J(A,B) $$ OPTIONAL


'coupling constant 1' ('atom number 1', 'hetero-atom number 1')
'coupling constant 2' ('atom number 2', 'hetero-atom number 2')

##.RELAXATION TIMES= (XYR) $$ OPTIONAL


'x-value 1', 'y-value 1', 'relaxation time 1 in s'
'x-value 2', 'y-value 2', 'relaxation time 2 in s'

##END= $$ end of this DATA BLOCK

$$ further structure and peak assignment Ьlocks

##END= $$ end of the last DATA BLOCK


##END= $$ end of the COMPOUND JCAMP-DX FILE

APPLIED SPECTROSCOPY 1099

You might also like