[ec392464] | 1 | .. resolution_calculator_help.rst |
---|
| 2 | |
---|
| 3 | .. This is a port of the original SasView html help file to ReSTructured text |
---|
| 4 | .. by S King, ISIS, during SasView CodeCamp-III in Feb 2015. |
---|
| 5 | |
---|
[a9dc4eb] | 6 | Q Resolution Estimator Tool |
---|
| 7 | =========================== |
---|
[ec392464] | 8 | |
---|
| 9 | Description |
---|
| 10 | ----------- |
---|
| 11 | |
---|
[3aa3351] | 12 | This tool approximately estimates the resolution of $Q$ from SAS instrumental |
---|
[5ed76f8] | 13 | parameter values assuming that the detector is flat and normal to the |
---|
[bc9a0e1] | 14 | incident beam. |
---|
[ec392464] | 15 | |
---|
| 16 | .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ |
---|
| 17 | |
---|
[a9dc4eb] | 18 | Using the tool |
---|
| 19 | -------------- |
---|
[ec392464] | 20 | |
---|
[3aa3351] | 21 | 1) Select *Q Resolution Estimator* from the *Tool* menu on the SasView toolbar. |
---|
[bc9a0e1] | 22 | |
---|
[3aa3351] | 23 | 2) Select the source and source type (Monochromatic or TOF). |
---|
[ec392464] | 24 | |
---|
[5ed76f8] | 25 | *NOTE! The computational difference between the sources is only the |
---|
[bc9a0e1] | 26 | gravitational contribution due to the mass of the particles.* |
---|
[ec392464] | 27 | |
---|
[5ed76f8] | 28 | 3) Change the default values of the instrumental parameters as required. Be |
---|
[bc9a0e1] | 29 | careful to note that distances are specified in cm! |
---|
[ec392464] | 30 | |
---|
[5ed76f8] | 31 | 4) Enter values for the source wavelength(s), $\lambda$, and its spread (= $\text{FWHM}/\lambda$). |
---|
| 32 | |
---|
| 33 | For monochromatic sources, the inputs are just one value. For TOF sources, |
---|
| 34 | the minimum and maximum values should be separated by a '-' to specify a |
---|
[bc9a0e1] | 35 | range. |
---|
[5ed76f8] | 36 | |
---|
[3aa3351] | 37 | Optionally, the wavelength (BUT NOT the wavelength spread) can be extended |
---|
[5ed76f8] | 38 | by adding '; nn' where the 'nn' specifies the number of the bins for the |
---|
| 39 | numerical integration. The default value is nn = 10. The same number of bins |
---|
[bc9a0e1] | 40 | will be used for the corresponding wavelength spread. |
---|
[ec392464] | 41 | |
---|
[5ed76f8] | 42 | 5) For TOF, the default wavelength spectrum is flat. A custom spectral |
---|
| 43 | distribution file (2-column text: wavelength (|Ang|\) vs Intensity) can also |
---|
[bc9a0e1] | 44 | be loaded by selecting *Add new* in the combo box. |
---|
[ec392464] | 45 | |
---|
[5ed76f8] | 46 | 6) When ready, click the *Compute* button. Depending on the computation the |
---|
[bc9a0e1] | 47 | calculation time will vary. |
---|
[ec392464] | 48 | |
---|
[5ed76f8] | 49 | 7) 1D and 2D $dQ$ values will be displayed at the bottom of the panel, and a 2D |
---|
| 50 | resolution weight distribution (a 2D elliptical Gaussian function) will also |
---|
[3aa3351] | 51 | be displayed in the plot panel. |
---|
[5ed76f8] | 52 | |
---|
| 53 | TOF only: green lines indicate the limits of the maximum $Q$ range accessible |
---|
[bc9a0e1] | 54 | for the longest wavelength due to the size of the detector. |
---|
[ec392464] | 55 | |
---|
[3aa3351] | 56 | Note that the effect from the beam block/stop is ignored. So, in the small $Q$ |
---|
[5ed76f8] | 57 | region near the beam block/stop |
---|
| 58 | |
---|
| 59 | [i.e., $Q < (2 \pi \cdot \text{beam block diameter}) / (\text{sample-to-detector distance} \cdot \lambda_\text{min})$] |
---|
[ec392464] | 60 | |
---|
[bc9a0e1] | 61 | the variance is slightly under estimated. |
---|
| 62 | |
---|
[5ed76f8] | 63 | 8) A summary of the calculation is written to the SasView *Console* at the |
---|
[3aa3351] | 64 | bottom of the main SasView window, below the plot. |
---|
| 65 | |
---|
| 66 | .. figure:: resolution_tutor.png |
---|
| 67 | |
---|
| 68 | .. |
---|
| 69 | |
---|
| 70 | 1) Define the source. Select *Photon* for X-ray. This selection only affects |
---|
| 71 | the gravitational contribution of the resolution |
---|
| 72 | 2) Select between *Monochromatic* or *TOF* |
---|
| 73 | 3) For *TOF*, there is the option |
---|
| 74 | of loading a custom spectral distribution using *Add New* in the combo |
---|
| 75 | box |
---|
| 76 | 4) *Wavelength* and *wavelength spread*: one value for *Monochromatic*, |
---|
| 77 | minimum and maximum of range for *TOF* |
---|
| 78 | 5) For *Source* and *Sample Size Aperture*, one value for a circular |
---|
| 79 | aperture (diameter) and two values separated by a comma (,) for a |
---|
| 80 | rectangular slit (side lengths) |
---|
| 81 | 6) One value for one ($Qx$, $Qy$) location or more values separated by a |
---|
| 82 | comma (,) for more locations. *Note: the $Qx$, $Qy$ input boxes should |
---|
| 83 | have the same number of values.* |
---|
| 84 | 7) Click on *Compute* button to start the calculation |
---|
| 85 | 8) *Sigma_x* and *Sigma_y* are the components of the 2D $dQ$ at the last |
---|
| 86 | ($Qx$, $Qy$) point of inputs |
---|
| 87 | 9) *Sigma_lamd* is the 2D $dQ_{\lambda}$ at the last point of inputs. |
---|
| 88 | *Note: $dQ_{\lambda}$ has only the Qr directional component* |
---|
| 89 | 10) *(1D Sigma)* is the 1D $dQ$ at the last ($Qx$, $Qy$) point of inputs |
---|
| 90 | 11) Plot of the result. For *TOF*, a green rectangle marks the limits of |
---|
| 91 | maximum $Q$ range accessible for the longest wavelength due to the |
---|
| 92 | size of the detector. |
---|
[ec392464] | 93 | |
---|
| 94 | .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ |
---|
| 95 | |
---|
| 96 | Theory |
---|
| 97 | ------ |
---|
| 98 | |
---|
| 99 | The scattering wave transfer vector is by definition |
---|
| 100 | |
---|
[6aad2e8] | 101 | .. image:: q.png |
---|
[ec392464] | 102 | |
---|
[5ed76f8] | 103 | In the small-angle limit, the variance of $Q$ is to a first-order |
---|
[bc9a0e1] | 104 | approximation |
---|
[ec392464] | 105 | |
---|
[6aad2e8] | 106 | .. image:: sigma_q.png |
---|
[ec392464] | 107 | |
---|
[bc9a0e1] | 108 | The geometric and gravitational contributions can then be summarised as |
---|
[ec392464] | 109 | |
---|
[6aad2e8] | 110 | .. image:: sigma_table.png |
---|
[ec392464] | 111 | |
---|
[5ed76f8] | 112 | Finally, a Gaussian function is used to describe the 2D weighting distribution |
---|
| 113 | of the uncertainty in $Q$. |
---|
[ec392464] | 114 | |
---|
| 115 | .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ |
---|
| 116 | |
---|
| 117 | References |
---|
| 118 | ---------- |
---|
| 119 | |
---|
[5ed76f8] | 120 | D.F.R. Mildner and J.M. Carpenter |
---|
[bc9a0e1] | 121 | *J. Appl. Cryst.* 17 (1984) 249-256 |
---|
| 122 | |
---|
[5ed76f8] | 123 | D.F.R. Mildner, J.M. Carpenter and D.L. Worcester |
---|
[bc9a0e1] | 124 | *J. Appl. Cryst.* 19 (1986) 311-319 |
---|
| 125 | |
---|
| 126 | .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ |
---|
| 127 | |
---|
[a9dc4eb] | 128 | .. note:: This help document was last changed by Steve King, 01May2015 |
---|