Difference between revisions of "Dist range.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Update function See also links and function index membership)
 
(5 intermediate revisions by the same user not shown)
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(dt,tmax,expt)
  
−
==Arguments==
+
==Parameters==
  
−
       np -  number of points in the time grid
+
       dt -  interval duration of the uniform time grid
 
   
 
   
 
     tmax  -  the time (seconds) of the last point in the
 
     tmax  -  the time (seconds) of the last point in the
 
             grid if the first point is zero
 
             grid if the first point is zero
 
   
 
   
−
     mode -  'unsafe' returns distance ranges correspon-
+
     expt -  'ridme' or 'deer'
−
            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 24:
  
 
==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(4e-9,2e-6,'deer')
 
   
 
   
−
   rmin = 7.4082
+
   rmin = 9.4078
 
   
 
   
 
   rmax = 59.2655
 
   rmax = 59.2655
  
 
==See also==
 
==See also==
−
[[Neural network module]]
+
[[deer_lib_gen.m]], [[deernet.m]], [[elexsys2deernet.m]], [[process_using.m]], [[train_one_net.m]], [[Neural network module]], [[Built-in_experiments]]
  
−
[[Built-in_experiments#DEER.2FPELDOR_experiments|DEER/PELDOR experiments]]
+
''Version 2.8, authors: [[Jake Keeley]], [[Ilya Kuprov]]''
−
 
 
−
 
 
−
''Version 2.5, authors: [[Jake Keeley]], [[Ilya Kuprov]]''
 

Latest revision as of 19:36, 6 June 2026

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(dt,tmax,expt)

Parameters

     dt  -  interval duration of the uniform time grid

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

   expt  -  'ridme' or 'deer'

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(4e-9,2e-6,'deer')

 rmin = 9.4078

 rmax = 59.2655

See also

deer_lib_gen.m, deernet.m, elexsys2deernet.m, process_using.m, train_one_net.m, Neural network module, Built-in_experiments

Version 2.8, authors: Jake Keeley, Ilya Kuprov

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