Difference between revisions of "Homospoil.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Sync syntax/arguments/outputs with current Spinach source)
Line 1: Line 1:
 
{{DISPLAYTITLE:homospoil.m}} __NOTOC__
 
{{DISPLAYTITLE:homospoil.m}} __NOTOC__
 +
 
Emulates a strong homospoil pulse - only zero-frequency states with respect to the carrier frequencies (chemical shifts are not considered) survive the process.
 
Emulates a strong homospoil pulse - only zero-frequency states with respect to the carrier frequencies (chemical shifts are not considered) survive the process.
  
 
==Syntax==
 
==Syntax==
  
    rho=homospoil(spin_system,rho,zqc_flag)
+
rho=homospoil(spin_system,rho,zqc_flag)
  
 
==Arguments==
 
==Arguments==
  
        rho - a state vector or a horizontal stack thereof
+
rho - a state vector or a horizontal stack thereof
+
 
     zqc_flag - a flag controlling the fate of zero-quantum  
+
     zqc_flag - a flag controlling the fate of zero-quantum
 
               coherences. If set to 'keep', causes ZQCs to
 
               coherences. If set to 'keep', causes ZQCs to
 
               survive the process, approximating experimen-
 
               survive the process, approximating experimen-
Line 16: Line 17:
 
               zero-quantum coherences - only the longitudi-
 
               zero-quantum coherences - only the longitudi-
 
               nal states survive the process.
 
               nal states survive the process.
 +
 +
              The flag is ignored in zeeman-hilb and zeeman-
 +
              liouv formalisms, where the effect is always
 +
              to destroy everything except the diagonal of
 +
              the density matrix.
  
 
==Outputs==
 
==Outputs==
  
        rho  - the state vector(s) with only the longitudi-
+
rho  - the state vector(s) with only the longitudi-
 
               nal or only the zero-quantum states kept
 
               nal or only the zero-quantum states kept
 +
 +
Note: this function is only available for sphten-liouv formalism; it
 +
      supports Fokker-Planck direct products.
 +
 +
Note: this is a purely mathematical filter that only mimics - in an
 +
      idealised way - the effect of a real homospoil pulse. Essenti-
 +
      ally, it searches the density matrix for any transverse state
 +
      populations and zeroes them out. If the flag is set, zero-qua-
 +
      ntum coherences are also erased.
 +
 +
ilya.kuprov@weizmann.ac.il
  
 
==Notes==
 
==Notes==
 +
 
This function is only available for sphten-liouv formalism; it supports Fokker-Planck direct products.
 
This function is only available for sphten-liouv formalism; it supports Fokker-Planck direct products.
  
 
==See also==
 
==See also==
 +
 
[[Kernel_functions#Coherence_order_selection|Coherence order selection]]
 
[[Kernel_functions#Coherence_order_selection|Coherence order selection]]
  

Revision as of 15:05, 5 April 2026


Emulates a strong homospoil pulse - only zero-frequency states with respect to the carrier frequencies (chemical shifts are not considered) survive the process.

Syntax

rho=homospoil(spin_system,rho,zqc_flag)

Arguments

rho - a state vector or a horizontal stack thereof

   zqc_flag - a flag controlling the fate of zero-quantum
              coherences. If set to 'keep', causes ZQCs to
              survive the process, approximating experimen-
              tal behaviour. If set to 'destroy', wipes the
              zero-quantum coherences - only the longitudi-
              nal states survive the process.
              The flag is ignored in zeeman-hilb and zeeman-
              liouv formalisms, where the effect is always
              to destroy everything except the diagonal of
              the density matrix.

Outputs

rho - the state vector(s) with only the longitudi-

              nal or only the zero-quantum states kept
Note: this function is only available for sphten-liouv formalism; it
      supports Fokker-Planck direct products.
Note: this is a purely mathematical filter that only mimics - in an
      idealised way - the effect of a real homospoil pulse. Essenti-
      ally, it searches the density matrix for any transverse state
      populations and zeroes them out. If the flag is set, zero-qua-
      ntum coherences are also erased.
ilya.kuprov@weizmann.ac.il

Notes

This function is only available for sphten-liouv formalism; it supports Fokker-Planck direct products.

See also

Coherence order selection

State space indexing and manipulation


Version 2.8, authors: Ilya Kuprov