Difference between revisions of "Zfs sampling.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Update function See also links and function index membership)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Gadolinium ZFS probability distribution function for DOTA-type ligand complexes in cryogenic water-methanol glasses.
+
{{DISPLAYTITLE:zfs_sampling.m}} __NOTOC__
 +
Gadolinium ZFS probability distribution function for DOTA-type ligand complexes in cryogenic water-methanol glasses. This function returns Gauss-Legendre quadrature sampling points and weights for the ZFS parameter distribution described in http://dx.doi.org/10.1007/BF03166762 (see Figure 5). This function is necessary in the simulation of solid state EPR experiments involving gadolinium ions because there is always a distribution of zero-field splitting parameters that must be integrated over.
  
 
==Syntax==
 
==Syntax==
Line 5: Line 6:
 
     [D,E,W]=zfs_sampling(npoints_d,npoints_e,tol)
 
     [D,E,W]=zfs_sampling(npoints_d,npoints_e,tol)
  
−
==Description==
+
==Parameters==
−
This function returns Gauss-Legendre quadrature sampling points and weights for the ZFS parameter distribution described in http://dx.doi.org/10.1007/BF03166762 (see Figure 5). This function is necessary in the simulation of solid state EPR experimens involving gadolinium ions because there is always a distribution of zero-field splitting parameters that must be integrated over.
 
  
−
==Arguments==
+
      npoints_d - number of Gauss-Legendre quadrature
 +
                  points in D
 +
 +
      npoints_e - number of Gauss-Legendre quadrature
 +
                  points in E
 +
 +
      tol      - tolerance for integration weights
 +
                  below which grid points are dropped
  
−
    npoints_d - number of Gauss-Legendre quadrature points in D
+
==Outputs==
  
−
    npoints_e - number of Gauss-Legendre quadrature points in D
+
       D - a vector of D values at each integration
−
 
+
          grid point
−
    tol       - tolerance for integration weights below which the sampling points are dropped
+
−
 
+
      E - a vector of E values at each integration
−
==Returns==
+
          grid point
−
 
+
−
    D - a vector of D/D1 values for each sampling point (see Figure 5 in the paper)
+
      W - a vector of weights for each integration
−
 
+
          grid point
−
    E - a vector of E/D values for each sampling point (see Figure 5 in the paper)
 
−
 
 
−
    W - Gauss-Legendre quadrature weight for each point
 
−
 
 
−
==Examples==
 
−
See the gadolinium DEER simulation examples in the example set.
 
  
 
==Notes==
 
==Notes==
−
# Distribution parameters are different between ligands. Modify the function as appropriate for your case.
+
The function also creates a figure with the distributions it has used for D and E parameters.
  
 
==See also==
 
==See also==
−
[[deer_3p_hard_deer.m]], [[deer_3p_soft_deer.m]], [[deer_4p_hard_deer.m]], [[deer_4p_soft_deer.m]]
+
[[arclength.m]], [[gaussleg.m]], [[get_hull.m]], [[grid_fibon.m]], [[grid_igloo.m]], [[grid_kron.m]], [[grid_plot.m]], [[grid_polar.m]], [[grid_test.m]], [[grid_trian.m]], [[one_vcell_solidangle.m]], [[repulsion.m]], [[shrewd.m]], [[sphtarea.m]], [[sphtrsubd.m]], [[vcell_solidangle.m]], [[voitlander.m]], [[voronoisphere.m]], [[Kernel_utilities]], [[Appendix I: powder grids]]
−
 
 
  
−
''Revision 3284, authors: [[Ilya Kuprov]], [[Nurit Manukovsky]]''
+
''Version 2.6, authors: [[Ilya Kuprov]], [[Nurit Manukovsky]]''

Latest revision as of 19:43, 6 June 2026

Gadolinium ZFS probability distribution function for DOTA-type ligand complexes in cryogenic water-methanol glasses. This function returns Gauss-Legendre quadrature sampling points and weights for the ZFS parameter distribution described in http://dx.doi.org/10.1007/BF03166762 (see Figure 5). This function is necessary in the simulation of solid state EPR experiments involving gadolinium ions because there is always a distribution of zero-field splitting parameters that must be integrated over.

Syntax

    [D,E,W]=zfs_sampling(npoints_d,npoints_e,tol)

Parameters

     npoints_d - number of Gauss-Legendre quadrature
                 points in D

     npoints_e - number of Gauss-Legendre quadrature 
                 points in E

     tol       - tolerance for integration weights 
                 below which grid points are dropped

Outputs

     D - a vector of D values at each integration
         grid point

     E - a vector of E values at each integration
         grid point

     W - a vector of weights for each integration
         grid point

Notes

The function also creates a figure with the distributions it has used for D and E parameters.

See also

arclength.m, gaussleg.m, get_hull.m, grid_fibon.m, grid_igloo.m, grid_kron.m, grid_plot.m, grid_polar.m, grid_test.m, grid_trian.m, one_vcell_solidangle.m, repulsion.m, shrewd.m, sphtarea.m, sphtrsubd.m, vcell_solidangle.m, voitlander.m, voronoisphere.m, Kernel_utilities, Appendix I: powder grids

Version 2.6, authors: Ilya Kuprov, Nurit Manukovsky