Difference between revisions of "Homospoil.m"

From Spinach Documentation Wiki
Jump to: navigation, search
m (Normalise preformatted blank lines in function documentation blocks)
m (Rename Arguments section heading to Parameters)
Line 6: Line 6:
 
     rho=homospoil(spin_system,rho,zqc_flag)
 
     rho=homospoil(spin_system,rho,zqc_flag)
  
==Arguments==
+
==Parameters==
  
 
         rho - a state vector or a horizontal stack thereof
 
         rho - a state vector or a horizontal stack thereof

Revision as of 18:49, 5 June 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)

Parameters

        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

Notes

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

This is a purely mathematical filter that only mimics, in an idealised way, the effect of a real homospoil pulse. It searches the density matrix for transverse state populations and zeroes them out; if the flag is set to 'destroy', zero-quantum coherences are also erased.

See also

Coherence order selection

State space indexing and manipulation

Version 2.8, authors: Ilya Kuprov