Difference between revisions of "Dist range.m"

From Spinach Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
 
{{DISPLAYTITLE:dist_range.m}} __NOTOC__
 
{{DISPLAYTITLE:dist_range.m}} __NOTOC__
−
Distance range estimation for uniform DEER sampling grids, assuming free electron magnetogyric ratios. The minimum distance is estimated from the Nyquist-Shannon condition on the largest frequency the grid can sample. The maximum distance is obtained from the smallest frequency for which the half-period condition is used.
+
Returns the mathematical bounds for the distance range covered by a DEER trace with the specified number of points and duration, assuming uniform time step.
  
 
==Syntax==
 
==Syntax==
  
−
     [rmin,rmax]=dist_range(np,tmax,mode)
+
     [rmin,rmax]=dist_range(np,tmax)
  
 
==Arguments==
 
==Arguments==
Line 13: Line 13:
 
             grid if the first point is zero
 
             grid if the first point is zero
 
   
 
   
−
    mode  -  'unsafe' returns distance ranges correspon-
 
−
            ding to the Nyquist-Shannon sampling of the
 
−
            DEER signal. This is exact but problematic:
 
−
            for edge frequencies, both background esti-
 
−
            mation and distance extraction is not reli-
 
−
            able; 'safe' (default) gives distance rang-
 
−
            es corresponding to twice the Nyquist-Shan-
 
−
            non sampling, a safe practical choice
 
−
 
 
==Outputs==
 
==Outputs==
  
Line 31: Line 22:
  
 
==Examples==
 
==Examples==
−
Strict Nyquist estimate for a 2 microsecond DEER trace containing 512 points:
+
For a 2 microsecond DEER trace containing 512 points:
  
−
   >> [rmin,rmax]=dist_range(512,2e-6,'unsafe')
+
   >> [rmin,rmax]=dist_range(512,2e-6)
 
   
 
   
−
   rmin = 7.4082
+
   rmin = 9.3398
 
   
 
   
 
   rmax = 59.2655
 
   rmax = 59.2655

Revision as of 20:00, 29 November 2020

Returns the mathematical bounds for the distance range covered by a DEER trace with the specified number of points and duration, assuming uniform time step.

Syntax

    [rmin,rmax]=dist_range(np,tmax)

Arguments

     np  -  number of points in the time grid

   tmax  -  the time (seconds) of the last point in the
            grid if the first point is zero

Outputs

   rmin  -  minimum distance supported by the
            grid, Angstrom 

   rmax  -  maximum distance supported by the 
            grid, Angstrom

Examples

For a 2 microsecond DEER trace containing 512 points: 

 >> [rmin,rmax]=dist_range(512,2e-6)

 rmin = 9.3398

 rmax = 59.2655

See also

Neural network module

DEER/PELDOR experiments


Version 2.5, authors: Jake Keeley, Ilya Kuprov

Retrieved from "https://spindynamics.org/wiki/index.php?title=Dist_range.m&oldid=4410"