\(\renewcommand\AA{\unicode{x212B}}\)

BASISPowderDiffraction v1

../_images/ImageNotFound.png

Enable screenshots using DOCS_SCREENSHOTS in CMake

Summary

Diffraction pattern for powder samples

See Also

BASISReduction, BASISCrystalDiffraction

Properties

Name

Direction

Type

Default

Description

RunNumbers

Input

string

Sample run numbers

DoFluxNormalization

Input

boolean

True

Do we normalize data by incoming flux?

FluxNormalizationType

Input

string

Monitor

Flux Normalization Type. Allowed values: [‘Monitor’, ‘Proton Charge’, ‘Duration’]

MomentumTransferBins

Input

dbl list

0.1,0.0025,2.5

Momentum transfer binning scheme

OutputWorkspace

Output

Workspace

Mandatory

Output reduced workspace

MaskFile

Input

string

/SNS/BSS/shared/autoreduce/new_masks_08_12_2015/BASIS_Mask_default_diff.xml

See documentation for latest mask files. Allowed extensions: [‘.xml’]

BackgroundRuns

Input

string

Background run numbers

BackgroundScale

Input

number

1

The background will be scaled by this number before being subtracted.

OutputBackground

Output

Workspace

Reduced workspace for background runs

VanadiumRuns

Input

string

Vanadium run numbers

RemoveTemporaryWorkspaces

Input

boolean

True

Remove temporary workspaces and files

Description

Run numbers: All run numbers provided will be reduced together as an aggregate sample. Example: 2144-2147,2156 will reduce runs from (and including) 2144 up to (and including) 2147, plus 2156.

Flux Normalization Type: Normalize the number of counts by either: (1) counts recorded in the monitor, (2) total proton charge, or (3) run duration. This flux normalization is separately applied to the aggregate sample, aggregate vanadium, and aggregated background.

Mask file: The default file (BASIS_Mask_default_diff.xml) masks all inelastic detectors as well as the tips of the diffraction tubes. The file is in directory /SNS/BSS/shared/autoreduce/new_masks_08_12_2015.

OutputWorkspace: a one-histogram MatrixWorkspace is produced containing the intensities versus momentum transfer Q. In addition, a workspace of same name plus suffix _angle is produced. The latter workspace contains intensities versus scattering angle. If background runs are provided, these workspaces contain the intensities of the sample minus those of the background.

BackgroundRuns: one or more run numbers to describe the background. Background runs are reduced together.

BackgroundScale: background intensities are rescaled by this number when subtracting background from sample.

OutputBackground: if populated, a one-histogram MatrixWorkspace is produced containing the background intensities versus momentum transfer Q. In addition, a workspace of same name plus suffix _angle is produced. The latter workspace contains intensities versus scattering angle. Rescaling of the background intensities is not applied when producing these workspaces.

VanadiumRuns: a set of runs to be reduced jointly provide an incoherent and isotropic scattering to determine instrument efficiency per detector. If no vanadium is provided, all detectors are assumed to have the same efficiency. The vanadium intensity is integrated in each detector and used to normalize both the sample and the background intensities.

Usage

Determine powder diffraction pattern:

from mantid.simpleapi import BASISPowderDiffraction
BASISPowderDiffraction(RunNumbers='74799',
                       OutputWorkspace='powder',
                       BackgroundRuns='75527',
                       OutputBackground='background'
                       VanadiumRuns='64642')
../_images/BASISPowderDiffraction.png

The color image shows the nine diffraction detectors with a Bragg peak spilling intensity on the edges of two tubes at a scattering angle of 60 degrees.

Developer’s Corner

Adding the Previous Pulse

because of the legacy hardware used at BASIS (ROC2 instead of ROC5), the diffraction detectors frame is forced to coincide with the inelastic detectors frame, introducing a shift in the minimal TOF.

In the figures below, we have represented the TOF and wavelength dependence of the intensities for the monitors (black), sample from the current pulse (red), and sample from the previous pulse (green)

111 Reflection:

../_images/BASISPowderDiffraction_2.png

311 Reflection:

../_images/BASISPowderDiffraction_2.png

The figures show that the “slow” neutrons from the previous pulse should be accounted as the fast neutrons for the current pulse.

The solution is to: (1) pile together events from the previous and current pulses; (2) discard events with under-represented wavelegths. We use the monitor counts for the last step.

Categories: AlgorithmIndex | Diffraction\Reduction

Source

Python: BASISPowderDiffraction.py