source: sasview/src/sas/sasgui/perspectives/corfunc/media/corfunc_help.rst @ 245ae18

Last change on this file since 245ae18 was 338d6ff, checked in by lewis, 5 years ago

Update screenshots in docs to reflect UI changes

  • Property mode set to 100644
File size: 6.0 KB

Correlation Function Analysis


This performs a correlation function analysis of one-dimensional SANS data, or generates a model-independent volume fraction profile from a one-dimensional SANS pattern of an adsorbed layer.

The correlation function analysis is performed in 3 stages:

  • Extrapolation of the scattering curve to Q = 0 and Q = ∞
  • Fourier/Hilbert Transform of the extrapolated data to give the correlation function/volume fraction profile
  • Interpretation of the 1D correlation function based on an ideal lamellar morphology


To Q = 0

The data are extrapolated to Q = 0 by fitting a Guinier model to the data points in the lower Q range. The equation used is:

I(Q) = eA + Bq2

The Guinier model assumes that the small angle scattering arises from particles and that parameter B is related to the radius of gyration of those particles. This has dubious applicability to polymer systems. However, the correlation function is affected by the Guinier back-extrapolation to the greatest extent at large values of R and so the back-extrapolation only has a small effect on the analysis.

To Q = ∞

The data are extrapolated to Q = by fitting a Porod model to the data points in the upper Q range.

The equation used is:

I(Q) = Bg + KQ − 4e − Q2σ2

Where Bg is the Bonart thermal background, K is the Porod constant, and σ > 0 describes the electron (or neutron scattering length) density profile at the interface between crystalline and amorphous regions (see figure 1).


Figure 1 The value of σ is a measure of the electron density profile at the interface between crystalline and amorphous regions.


The extrapolated data set consists of the Guinier back-extrapolation up to the highest Q value of the lower Q range, the original scattering data up to the highest value in the upper Q range, and the Porod tail-fit beyond this. The joins between the original data and the Guinier/Porod fits are smoothed using the algorithm below, to avoid the formation of ripples in the transformed data.

Functions f(xi) and g(xi) where xi ∈ {x1, x2, ..., xn} , are smoothed over the range [a, b] to produce y(xi) , by the following equations:

y(xi) = hig(xi) + (1 − hi)f(xi)


hi = (1)/(1 + ((xi − b)2)/((xi − a)2))



If Fourier is selected for the transform type, the analysis will perform a discrete cosine transform on the extrapolated data in order to calculate the correlation function. The following algorithm is applied:

Γ(xk) = 2N − 1n = 0xncos(π)/(N)n + (1)/(2)k for k = 0, 1, …, N − 1, N


If Hilbert is selected for the transform type, the analysis will perform a Hilbert transform on the extrapolated data in order to calculate the Volume Fraction Profile.


Once the correlation function has been calculated by transforming the extrapolated data, it may be interpreted by clicking the "Compute Parameters" button. The correlation function is interpreted in terms of an ideal lamellar morphology, and structural parameters are obtained as shown in Figure 2 below. It should be noted that a small beam size is assumed; no de-smearing is performed.


Figure 2 Interpretation of the correlation function.

The structural parameters obtained are:

  • Long Period  = Lp
  • Average Hard Block Thickness  = Lc
  • Average Core Thickness  = D0
  • Average Interface Thickness  = Dtr
  • Polydispersity  = Γmin ⁄ Γmax
  • Local Crystallinity  = Lc ⁄ Lp


Upon sending data for correlation function analysis, it will be plotted, along with a red bar indicating the lower Q range (used for back-extrapolation), and 2 purple bars indicating the upper qrange (used for forward-extrapolation) [figure 3]. These bars may be moved my clicking and dragging, or by entering the appropriate value in the Q range input boxes.


Figure 3 A plot of some data showing the Q range bars

Once the Q ranges have been set, click the "Calculate" button next to the background input field to calculate the Bonart thermal background level. Alternatively, enter your own value into the field. Click the "Extrapolate" button to extrapolate the data and plot the extrapolation in the same figure as the original data. The values of the parameters used for the Guinier and Porod models will also be shown in the "Extrapolation Parameters" section [figure 4]


Figure 4 A plot showing the extrapolated data and the original data

Then, select which type of transform you would like to perform, using the radio buttons:

  • Fourier Perform a Fourier Transform to calculate the correlation function of the extrapolated data
  • Hilbert Perform a Hilbert Transform to calculate the volume fraction profile of the extrapolated data

Clicking the transform button will then perform the selected transform and plot it in a new figure. If a Fourier Transform was performed, the "Compute Parameters" button can also be clicked to calculate values for the output parameters [figure 5]


Figure 5 The Fourier Transform (correlation function) of the extrapolated data, and the parameters extracted from it.

Note: See TracBrowser for help on using the repository browser.