Difference between revisions of "Overtone pa.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "Overtone soft pulse-acquire experiment. Syntax: spectrum=overtone_pa(spin_system,parameters,H,R,K) where H is the hamiltonian commutation superoperator, R is the ...")
 
Line 1: Line 1:
Overtone soft pulse-acquire experiment. Syntax:
+
Overtone soft pulse-acquire experiment with frequency-domain acquisition.
  
          spectrum=overtone_pa(spin_system,parameters,H,R,K)
+
==Syntax==
  
where H is the hamiltonian commutation superoperator, R is the relaxation
+
    spectrum=overtone_a(spin_system,parameters,H,R,K)
superoperator and K is the chemical kinetics superoperator. The following
 
parameters are required:
 
  
    parameters.sweep          vector with two elements giving
+
==Description==
                              the spectrum frequency extents
+
The function performes frequency-domain acquisition at the overtone frequency. Because time-domain overtone spectroscopy is difficult (see http://dx.doi.org/10.1039/C4CP03994G for details), this mode of acquisition is preferable in practice. Simulations [[assume.m|assumptions]] should be set to 'qnmr'.
                              in Hz around the overtone frequency
 
  
    parameters.npoints        number of points in the spectrum
+
==Arguments==
  
    parameters.rho0           initial state
+
    parameters.sweep        -  vector with two elements giving the spectrum frequency extents
 +
                                in Hz around the overtone frequency
 +
 +
    parameters.npoints      -  number of points in the spectrum
 +
 +
    parameters.rho0         -  initial state
 +
 +
    parameters.coil        -  detection state
 +
 +
    H                      -  Hamiltonian commutation superoperator
 +
 +
    R                      -  unthermalised relaxation superoperator
 +
 +
    K                      -  chemical kinetics superoperator
 +
 +
    parameters.Lx          -  X Zeeman operator on the quadrupolar nucleus
 +
 +
    parameters.rf_frq      -  pulse frequency offset from the overtone frequency on the quadrupolar nucleus, Hz
 +
 +
    parameters.rf_pwr      -  pulse power on the quadrupolar nucleus, Hz
 +
 +
    parameters.rf_dur      -  pulse duration, seconds
  
    parameters.coil            detection state
+
    parameters.method      -  'average' uses the average Hamiltonian theory, 'fplanck' uses Fokker-Planck formalism
 +
                                for the calculation of the pulse evolution.
  
    parameters.Lx
+
==Returns==
    parameters.Ly              X and Y Zeeman operators on the
+
The function returns the populations of the detection state at the frequencies specified.
                              quadrupolar nucleus
 
  
    parameters.rf_frq          pulse frequency offset from
+
==Examples==
                              the overtone frequency on the
+
The following 15N overtone spectrum is produced by examples/nmr_overtone/mas_valine_1.m example file:
                              quadrupolar nucleus, Hz
 
  
    parameters.rf_pwr          pulse power on the quadrupolar
+
[[File:ot_example_2.png]]
                              nucleus, Hz
 
  
    parameters.rf_dur          pulse duration, seconds
+
==Notes==
 +
# Relaxation must be present in the system dynamics, or the matrix inverse-times-vector operation performed by the frequency domain detection module would fail to converge. The relaxation superoperator should ''not'' be thermalised.
  
    parameters.method          'average' uses the average Hamil-
+
# Relaxation theory is not applied during the pulse.
                              tonian theory, 'fplanck' uses
 
                              Fokker-Planck formalism
 
  
Relaxation must be present in the system dynamics, or the matrix
+
# Average Hamiltonian and Fokker-Plankc pulses produce signals in different phases. We are trying to figure out why, but it look non-trivial. The average Hamiltonian theory option is faster.
inversion operation below would fail to converge. The relaxation
+
 
matrix should *not* be thermalized.
+
# Irrespectively of the pulse algorithm option selection, the magic angle spinning is always handled with the Fokker-Planck formalism.
 +
 
 +
==See also==
 +
[[overtone_cp.m]], [[overtone_dante.m]], [[overtone_hmqc.m]], [[overtone_a.m]], [[slowpass.m]]
 +
 
 +
 
 +
''Revision 3284, authors: [[Ilya Kuprov]]''

Revision as of 17:06, 16 August 2016

Overtone soft pulse-acquire experiment with frequency-domain acquisition.

Syntax

    spectrum=overtone_a(spin_system,parameters,H,R,K)

Description

The function performes frequency-domain acquisition at the overtone frequency. Because time-domain overtone spectroscopy is difficult (see http://dx.doi.org/10.1039/C4CP03994G for details), this mode of acquisition is preferable in practice. Simulations assumptions should be set to 'qnmr'.

Arguments

    parameters.sweep        -  vector with two elements giving the spectrum frequency extents
                               in Hz around the overtone frequency

    parameters.npoints      -  number of points in the spectrum

    parameters.rho0         -  initial state

    parameters.coil         -  detection state

    H                       -  Hamiltonian commutation superoperator

    R                       -  unthermalised relaxation superoperator 

    K                       -  chemical kinetics superoperator

    parameters.Lx           -  X Zeeman operator on the quadrupolar nucleus

    parameters.rf_frq       -  pulse frequency offset from the overtone frequency on the quadrupolar nucleus, Hz

    parameters.rf_pwr       -  pulse power on the quadrupolar nucleus, Hz

    parameters.rf_dur       -  pulse duration, seconds
    parameters.method       -  'average' uses the average Hamiltonian theory, 'fplanck' uses Fokker-Planck formalism
                               for the calculation of the pulse evolution.

Returns

The function returns the populations of the detection state at the frequencies specified.

Examples

The following 15N overtone spectrum is produced by examples/nmr_overtone/mas_valine_1.m example file:

Ot example 2.png

Notes

  1. Relaxation must be present in the system dynamics, or the matrix inverse-times-vector operation performed by the frequency domain detection module would fail to converge. The relaxation superoperator should not be thermalised.
  1. Relaxation theory is not applied during the pulse.
  1. Average Hamiltonian and Fokker-Plankc pulses produce signals in different phases. We are trying to figure out why, but it look non-trivial. The average Hamiltonian theory option is faster.
  1. Irrespectively of the pulse algorithm option selection, the magic angle spinning is always handled with the Fokker-Planck formalism.

See also

overtone_cp.m, overtone_dante.m, overtone_hmqc.m, overtone_a.m, slowpass.m


Revision 3284, authors: Ilya Kuprov