Difference between revisions of "Coherence.m"

From Spinach Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
−
Coherence selection function - keeps only the specified coherence orders in the state vector. Syntax:
+
{{DISPLAYTITLE:function.m}}
 +
Coherence order selection function - keeps only the specified orders of coherence in the state vector. This function is useful as a replacement for gradients and phase cycles because coherence order filtering can be accomplished analytically, by just picking out the required coherence orders and zeroing everything else.
 +
 
 +
==Syntax==
  
 
     rho=coherence(spin_system,rho,spec)
 
     rho=coherence(spin_system,rho,spec)
  
−
Arguments:
+
==Arguments==
 +
 
 +
    rho    -  a state vector or a horizontal stack thereof
 +
 +
    spec  -  a cell array containing the specification of
 +
              which coherences to keep on which spins. For
 +
              example
 +
                        {{'13C',[1 -1]},{'1H',-1}}
 +
 +
              keeps the states that have coherence order
 +
 +
                      ((1 OR -1 on 13C) AND (-1 on 1H))
  
−
    rho  -  a state vector or a bookshelf stack of state vectors
+
==Outputs==
  
−
    spec - a cell array containing the specification of
+
  rho    - the state vector with the undesired orders of
−
             which coherences to keep on which spins
+
             spin correlations zeroed out
  
−
Examples of coherence specification:
+
==Examples==
  
 
     rho=coherence(spin_system,rho,{{'13C',[1 -1]},{'1H',-1}})
 
     rho=coherence(spin_system,rho,{{'13C',[1 -1]},{'1H',-1}})
  
−
this command keeps all states that simultaneously have coherence order 1 or -1 in the 13C subspace, and coherence order -1 in the 1H subspace.
+
keeps all states that simultaneously have coherence order 1 or -1 in the 13C subspace, and coherence order -1 in the 1H subspace.
  
 
     rho=coherence(spin_system,rho,{{3,0},{5,-1}})
 
     rho=coherence(spin_system,rho,{{3,0},{5,-1}})
  
−
this command keeps all states that simultaneously have coherence order 0 on spin number 3, and coherence order -1 on spin number 5.
+
keeps all states that simultaneously have coherence order 0 on spin number 3, and coherence order -1 on spin number 5.
 +
 
 +
==Notes==
 +
Because projection quantum number information is required, this function only works with ''sphten-liouv'' [[Basis set specification|formalism]]. It supports Fokker-Planck direct products.
 +
 
 +
==See also==
 +
Links to related functions.
  
−
This function is useful as a replacement for gradients and phase cycles because coherence order filtering can be accomplished analytically, by just picking out the required coherence orders and zeroing everything else. Because projection quantum number information is required, this function only works with ''sphten-liouv'' [[Basis set specification|formalism]].
 
  
−
''Revision 3142, authors: [[Ilya Kuprov]], [[Luke Edwards]]''
+
''Version 2.2, authors: [[Ilya Kuprov]], [[Luke Edwards]]''

Revision as of 14:18, 28 August 2018

Coherence order selection function - keeps only the specified orders of coherence in the state vector. This function is useful as a replacement for gradients and phase cycles because coherence order filtering can be accomplished analytically, by just picking out the required coherence orders and zeroing everything else.

Syntax

    rho=coherence(spin_system,rho,spec)

Arguments

    rho    -  a state vector or a horizontal stack thereof

    spec   -  a cell array containing the specification of
              which coherences to keep on which spins. For
              example
                        {{'13C',[1 -1]},{'1H',-1}} 

              keeps the states that have coherence order 

                     ((1 OR -1 on 13C) AND (-1 on 1H))

Outputs

  rho     - the state vector with the undesired orders of
            spin correlations zeroed out

Examples

    rho=coherence(spin_system,rho,{{'13C',[1 -1]},{'1H',-1}})

keeps all states that simultaneously have coherence order 1 or -1 in the 13C subspace, and coherence order -1 in the 1H subspace.

    rho=coherence(spin_system,rho,{{3,0},{5,-1}})

keeps all states that simultaneously have coherence order 0 on spin number 3, and coherence order -1 on spin number 5.

Notes

Because projection quantum number information is required, this function only works with sphten-liouv formalism. It supports Fokker-Planck direct products.

See also

Links to related functions.


Version 2.2, authors: Ilya Kuprov, Luke Edwards