Changeset 01dba26 in sasmodels for doc/guide/pd/polydispersity.rst


Ignore:
Timestamp:
Sep 12, 2018 5:17:58 PM (6 years ago)
Author:
Paul Kienzle <pkienzle@…>
Branches:
master
Children:
a5cb9bc
Parents:
55e82f0 (diff), 2c12061 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.
Message:

Merge branch 'master' into ticket-608-user-defined-weights

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/guide/pd/polydispersity.rst

    rf41027b r01dba26  
    88.. _polydispersityhelp: 
    99 
    10 Polydispersity Distributions 
    11 ---------------------------- 
    12  
    13 With some models in sasmodels we can calculate the average intensity for a 
    14 population of particles that exhibit size and/or orientational 
    15 polydispersity. The resultant intensity is normalized by the average 
    16 particle volume such that 
     10Polydispersity & Orientational Distributions 
     11-------------------------------------------- 
     12 
     13For some models we can calculate the average intensity for a population of  
     14particles that possess size and/or orientational (ie, angular) distributions.  
     15In SasView we call the former *polydispersity* but use the parameter *PD* to  
     16parameterise both. In other words, the meaning of *PD* in a model depends on  
     17the actual parameter it is being applied too. 
     18 
     19The resultant intensity is then normalized by the average particle volume such  
     20that 
    1721 
    1822.. math:: 
     
    2125 
    2226where $F$ is the scattering amplitude and $\langle\cdot\rangle$ denotes an  
    23 average over the size distribution $f(x; \bar x, \sigma)$, giving 
     27average over the distribution $f(x; \bar x, \sigma)$, giving 
    2428 
    2529.. math:: 
     
    3034Each distribution is characterized by a center value $\bar x$ or 
    3135$x_\text{med}$, a width parameter $\sigma$ (note this is *not necessarily* 
     36<<<<<<< HEAD 
    3237the standard deviation, so read the description carefully), the number of 
    3338sigmas $N_\sigma$ to include from the tails of the distribution, and the 
     
    4247However, the distribution width applied to *orientation* (ie, angle-describing) 
    4348parameters is just $\sigma = \mathrm{PD}$. 
     49======= 
     50the standard deviation, so read the description of the distribution carefully),  
     51the number of sigmas $N_\sigma$ to include from the tails of the distribution,  
     52and the number of points used to compute the average. The center of the  
     53distribution is set by the value of the model parameter. 
     54 
     55The distribution width applied to *volume* (ie, shape-describing) parameters  
     56is relative to the center value such that $\sigma = \mathrm{PD} \cdot \bar x$.  
     57However, the distribution width applied to *orientation* parameters is just  
     58$\sigma = \mathrm{PD}$. 
     59>>>>>>> master 
    4460 
    4561$N_\sigma$ determines how far into the tails to evaluate the distribution, 
     
    5167 
    5268Users should note that the averaging computation is very intensive. Applying 
    53 polydispersion to multiple parameters at the same time or increasing the 
    54 number of points in the distribution will require patience! However, the 
    55 calculations are generally more robust with more data points or more angles. 
     69polydispersion and/or orientational distributions to multiple parameters at  
     70the same time, or increasing the number of points in the distribution, will  
     71require patience! However, the calculations are generally more robust with  
     72more data points or more angles. 
    5673 
    5774The following distribution functions are provided: 
     
    6986 
    7087 
     88**Beware: when the Polydispersity & Orientational Distribution panel in SasView is** 
     89**first opened, the default distribution for all parameters is the Gaussian Distribution.** 
     90**This may not be suitable. See Suggested Applications below.** 
     91 
    7192.. note:: In 2009 IUPAC decided to introduce the new term 'dispersity' to replace  
    7293           the term 'polydispersity' (see `Pure Appl. Chem., (2009), 81(2),  
    7394           351-353 <http://media.iupac.org/publications/pac/2009/pdf/8102x0351.pdf>`_  
    74            in order to make the terminology describing distributions of properties  
    75            unambiguous. Throughout the SasView documentation we continue to use the  
    76            term polydispersity because one of the consequences of the IUPAC change is  
    77            that orientational polydispersity would not meet their new criteria (which  
    78            requires dispersity to be dimensionless). 
     95           in order to make the terminology describing distributions of chemical  
     96           properties unambiguous. However, these terms are unrelated to the  
     97           proportional size distributions and orientational distributions used in  
     98           SasView models. 
    7999 
    80100Suggested Applications 
    81101^^^^^^^^^^^^^^^^^^^^^^ 
    82102 
    83 If applying polydispersion to parameters describing particle sizes, use 
     103If applying polydispersion to parameters describing particle sizes, consider using 
    84104the Lognormal or Schulz distributions. 
    85105 
    86106If applying polydispersion to parameters describing interfacial thicknesses 
    87 or angular orientations, use the Gaussian or Boltzmann distributions. 
     107or angular orientations, consider using the Gaussian or Boltzmann distributions. 
    88108 
    89109If applying polydispersion to parameters describing angles, use the Uniform 
     
    422442^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
    423443 
    424 Many commercial Dynamic Light Scattering (DLS) instruments produce a size 
    425 polydispersity parameter, sometimes even given the symbol $p$\ ! This 
    426 parameter is defined as the relative standard deviation coefficient of 
    427 variation of the size distribution and is NOT the same as the polydispersity 
    428 parameters in the Lognormal and Schulz distributions above (though they all 
    429 related) except when the DLS polydispersity parameter is <0.13. 
    430  
    431 .. math:: 
    432  
    433     p_{DLS} = \sqrt(\nu / \bar x^2) 
    434  
    435 where $\nu$ is the variance of the distribution and $\bar x$ is the mean 
    436 value of $x$. 
     444Several measures of polydispersity abound in Dynamic Light Scattering (DLS) and  
     445it should not be assumed that any of the following can be simply equated with  
     446the polydispersity *PD* parameter used in SasView. 
     447 
     448The dimensionless **Polydispersity Index (PI)** is a measure of the width of the  
     449distribution of autocorrelation function decay rates (*not* the distribution of  
     450particle sizes itself, though the two are inversely related) and is defined by  
     451ISO 22412:2017 as 
     452 
     453.. math:: 
     454 
     455    PI = \mu_{2} / \bar \Gamma^2 
     456 
     457where $\mu_\text{2}$ is the second cumulant, and $\bar \Gamma^2$ is the  
     458intensity-weighted average value, of the distribution of decay rates. 
     459 
     460*If the distribution of decay rates is Gaussian* then 
     461 
     462.. math:: 
     463 
     464    PI = \sigma^2 / 2\bar \Gamma^2 
     465 
     466where $\sigma$ is the standard deviation, allowing a **Relative Polydispersity (RP)**  
     467to be defined as 
     468 
     469.. math:: 
     470 
     471    RP = \sigma / \bar \Gamma = \sqrt{2 \cdot PI} 
     472 
     473PI values smaller than 0.05 indicate a highly monodisperse system. Values  
     474greater than 0.7 indicate significant polydispersity. 
     475 
     476The **size polydispersity P-parameter** is defined as the relative standard  
     477deviation coefficient of variation   
     478 
     479.. math:: 
     480 
     481    P = \sqrt\nu / \bar R 
     482 
     483where $\nu$ is the variance of the distribution and $\bar R$ is the mean 
     484value of $R$. Here, the product $P \bar R$ is *equal* to the standard  
     485deviation of the Lognormal distribution. 
     486 
     487P values smaller than 0.13 indicate a monodisperse system. 
    437488 
    438489For more information see: 
    439 S King, C Washington & R Heenan, *Phys Chem Chem Phys*, (2005), 7, 143 
     490 
     491`ISO 22412:2017, International Standards Organisation (2017) <https://www.iso.org/standard/65410.html>`_. 
     492 
     493`Polydispersity: What does it mean for DLS and Chromatography <http://www.materials-talks.com/blog/2014/10/23/polydispersity-what-does-it-mean-for-dls-and-chromatography/>`_. 
     494 
     495`Dynamic Light Scattering: Common Terms Defined, Whitepaper WP111214. Malvern Instruments (2011) <http://www.biophysics.bioc.cam.ac.uk/wp-content/uploads/2011/02/DLS_Terms_defined_Malvern.pdf>`_. 
     496 
     497S King, C Washington & R Heenan, *Phys Chem Chem Phys*, (2005), 7, 143. 
     498 
     499T Allen, in *Particle Size Measurement*, 4th Edition, Chapman & Hall, London (1990). 
    440500 
    441501.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
     
    447507| 2018-03-20 Steve King 
    448508| 2018-04-04 Steve King 
     509| 2018-08-09 Steve King 
Note: See TracChangeset for help on using the changeset viewer.