Difference between revisions of "Path trace.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Sync syntax/arguments/outputs with current Spinach source)
(Update function See also links and function index membership)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:path_trace.m}} __NOTOC__
 
{{DISPLAYTITLE:path_trace.m}} __NOTOC__
−
 
 
Liouvillian path tracing. Treats the user-supplied Liouvillian  as the adjacency matrix of a graph, computes the weakly connected subgraphs of that graph and returns a cell array of projectors into independently evolving populated subspaces.
 
Liouvillian path tracing. Treats the user-supplied Liouvillian  as the adjacency matrix of a graph, computes the weakly connected subgraphs of that graph and returns a cell array of projectors into independently evolving populated subspaces.
  
 
==Syntax==
 
==Syntax==
  
−
projectors=path_trace(spin_system,L,rho)
 
  
−
==Arguments==
+
    projectors=path_trace(spin_system,L,rho)
  
−
L  -  Liouvillian matrix  
+
==Parameters==
 +
 
 +
    L  -  Liouvillian matrix  
 
   
 
   
 
     rho -  the initial state (source state screening)
 
     rho -  the initial state (source state screening)
Line 17: Line 17:
 
==Outputs==
 
==Outputs==
  
−
projectors - a cell array of projectors into independently
+
  projectors - a cell array of projectors into independently
 
                 evolving populated subspaces. The projectors  
 
                 evolving populated subspaces. The projectors  
 
                 are to be used as follows:
 
                 are to be used as follows:
Line 25: Line 25:
  
 
==Notes==
 
==Notes==
−
 
 
Further information on how this function works is available in our papers on this subject:
 
Further information on how this function works is available in our papers on this subject:
  
Line 34: Line 33:
  
 
==See also==
 
==See also==
−
 
+
[[reduce.m]], [[zte.m]], [[symmetry.m]], [[krylov.m]], [[adelim.m]], [[coherence.m]], [[correlation.m]], [[dfpt.m]], [[homospoil.m]], [[human2opspec.m]], [[lin2lm.m]], [[lin2lmn.m]], [[lm2lin.m]], [[lmn2lin.m]], [[scomponents.m]], [[sinkhole.m]], [[sparse2csr.m]], [[sphten2zeeman.m]], [[stitch.m]], [[Kernel_utilities]]
−
[[reduce.m]], [[zte.m]], [[symmetry.m]], [[krylov.m]]
 
−
 
 
  
 
''Version 2.5, authors: [[Ilya Kuprov]], [[Matthew Krzystyniak]]''
 
''Version 2.5, authors: [[Ilya Kuprov]], [[Matthew Krzystyniak]]''

Latest revision as of 19:39, 6 June 2026

Liouvillian path tracing. Treats the user-supplied Liouvillian as the adjacency matrix of a graph, computes the weakly connected subgraphs of that graph and returns a cell array of projectors into independently evolving populated subspaces.

Syntax

    projectors=path_trace(spin_system,L,rho)

Parameters

    L   -  Liouvillian matrix 

    rho -  the initial state (source state screening)
           or the detection state (destination state
           screening)

Outputs

  projectors - a cell array of projectors into independently
               evolving populated subspaces. The projectors 
               are to be used as follows:

                  L_reduced=P'*L*P;    (for matrices)
                  rho_reduced=P'*rho;  (for state vectors)

Notes

Further information on how this function works is available in our papers on this subject:

            http://dx.doi.org/10.1063/1.3398146
            http://dx.doi.org/10.1016/j.jmr.2011.03.010

A significant number of independently evolving or dropped subspaces is often an indication of an overlooked symmetry or a conservation law – it is a good idea to examine the dropped subspaces and try finding out why they are not being populated. The efficiency of the path tracing procedure depends on the choice of the basis set. For the spherical tensor basis sets used in Spinach, there are usually at least two (in some EPR examples), and sometimes over a hundred (in large HSQC examples) independent subspaces, depending on the calculation type and spin interactions present.

See also

reduce.m, zte.m, symmetry.m, krylov.m, adelim.m, coherence.m, correlation.m, dfpt.m, homospoil.m, human2opspec.m, lin2lm.m, lin2lmn.m, lm2lin.m, lmn2lin.m, scomponents.m, sinkhole.m, sparse2csr.m, sphten2zeeman.m, stitch.m, Kernel_utilities

Version 2.5, authors: Ilya Kuprov, Matthew Krzystyniak