nmr-correlation

This package provides methods to build correlation data from NMR spectra. The NMR dataset has to be already processed and given in a certain format (see below).

Mainly, this is done by a grouping of signals with same nuclei between 1D and 2D or 2D and 2D NMR spectra. Each group is then represented by one correlation.

If a molecular formula is given, then missing correlations will be added as placeholder to complete the list.

Another feature is to determine the number of attached protons by using information from DEPT 90/135 or multiplicity-edited HSQC.

Input

Spectra

• array of 1D, 2D, DEPT 90/135 spectra, e.g. obtained by nmr-parser
• each spectrum has to be processed, e.g. via nmr-processing
• declared type for spectra is

type Spectra = Array<Spectrum1D | Spectrum2D>;

• further type definitions are available in src/types

Options

• tolerances (must be given for each occurring atom type in spectra)
• molecular formula (optional)

Values

• optional, previously built correlations
• useful to not override the following information if it is set to true in edited property:
  • hybridization, equivalence, protonsCount

Output

State

• for each atom type with at least one correlation
• current number of correlations
• some error information according to a given molecular formula

Values

An array of correlations with following content:

• link (array)
  • signal, axis (1D/2D signal and current axis which links to signals in another spectra)
  • match (indices of correlations with signal shift matches)
  • pseudo (whether this link is artificial)
  • some further meta information
• attachment (contains indices of each attached correlation/atom)
• protonsCount (array of possible numbers of attached protons)
• equivalence (number of equivalences, default is 1)
• hybridization (not set, except a CH3 group was detected)
• pseudo (whether this is a placeholder, e.g. if molecular formula is given)
• some further meta information, e.g. the group representing signal

Installation

$ npm i nmr-correlation

Usage

import { fromJCAMP } from 'nmr-parser';
import { buildCorrelationData } from 'nmr-correlation';

// parse spectra (symbolic example)
const data1H = fromJCAMP('1h.dx');
const data13C = fromJCAMP('13C.dx');
const dataHSQC = fromJCAMP('hsqc.dx');
const dataHMBC = fromJCAMP('hmbc.dx');
const dataCOSY = fromJCAMP('cosy.dx');
const dataDEPT90 = fromJCAMP('dept90.dx');
const dataDEPT135 = fromJCAMP('dept135.dx');

// process data (ranges/zones picking)
// ...
// put all the information together into specified format
// ...

// combine spectra into one array
const spectra = [
  data1H,
  data13C,
  dataHSQC,
  dataHMBC,
  dataCOSY,
  dataDEPT90,
  dataDEPT135,
];
// create options
const options = {
  tolerance: {
    C: 0.25,
    H: 0.02,
  },
  mf: 'C11H14N2O', // molecular formula
};
// build correlation data
const correlationData = buildCorrelationData(spectra, options);

License

MIT