Difference between revisions of "Homospoil.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Normalise sequential blank lines)
(Update function See also links and function index membership)
 
(3 intermediate revisions by the same user not shown)
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
Line 16: Line 16:
 
               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==
Line 24: Line 29:
 
==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.
 +
 +
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==
 
==See also==
[[Kernel_functions#Coherence_order_selection|Coherence order selection]]
+
[[adelim.m]], [[coherence.m]], [[correlation.m]], [[dfpt.m]], [[human2opspec.m]], [[lin2lm.m]], [[lin2lmn.m]], [[lm2lin.m]], [[lmn2lin.m]], [[path_trace.m]], [[scomponents.m]], [[sinkhole.m]], [[sparse2csr.m]], [[sphten2zeeman.m]], [[stitch.m]], [[zte.m]], [[Kernel_functions]], [[Kernel_utilities]]
 
 
[[Kernel_utilities#State_space_indexing_and_manipulation|State space indexing and manipulation]]
 
  
 
''Version 2.8, authors: [[Ilya Kuprov]]''
 
''Version 2.8, authors: [[Ilya Kuprov]]''

Latest revision as of 19:37, 6 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

adelim.m, coherence.m, correlation.m, dfpt.m, human2opspec.m, lin2lm.m, lin2lmn.m, lm2lin.m, lmn2lin.m, path_trace.m, scomponents.m, sinkhole.m, sparse2csr.m, sphten2zeeman.m, stitch.m, zte.m, Kernel_functions, Kernel_utilities

Version 2.8, authors: Ilya Kuprov