CreateTransmissionWorkspaceAuto v2

../_images/CreateTransmissionWorkspaceAuto-v2_dlg.png

CreateTransmissionWorkspaceAuto dialog.

Summary

Creates a transmission run workspace in Wavelength from input TOF workspaces.

Properties

Name Direction Type Default Description
FirstTransmissionRun Input MatrixWorkspace Mandatory Input workspace.
SecondTransmissionRun Input MatrixWorkspace   Second transmission run workspace in TOF.
AnalysisMode Input string PointDetectorAnalysis Analysis mode. This property is only used when ProcessingInstructions is not set. Allowed values: [‘PointDetectorAnalysis’, ‘MultiDetectorAnalysis’]
ProcessingInstructions Input string   Grouping pattern of spectrum numbers to yield only the detectors of interest. See GroupDetectors for syntax.
WavelengthMin Input number Optional Wavelength Min in angstroms
WavelengthMax Input number Optional Wavelength Max in angstroms
I0MonitorIndex Input number Optional I0 monitor workspace index
MonitorBackgroundWavelengthMin Input number Optional Wavelength minimum for monitor background subtraction in angstroms.
MonitorBackgroundWavelengthMax Input number Optional Wavelength maximum for monitor background subtraction in angstroms.
MonitorIntegrationWavelengthMin Input number Optional Wavelength minimum for integration in angstroms.
MonitorIntegrationWavelengthMax Input number Optional Wavelength maximum for integration in angstroms.
NormalizeByIntegratedMonitors Input boolean True Normalize by dividing by the integrated monitors.
Params Input dbl list   A comma separated list of first bin boundary, width, last bin boundary. These parameters are used for stitching together transmission runs. Values are in wavelength (angstroms). This input is only needed if a SecondTransmission run is provided.
StartOverlap Input number Optional Start wavelength for stitching transmission runs together. Only used if a second transmission run is provided.
EndOverlap Input number Optional End wavelength (angstroms) for stitching transmission runs together. Only used if a second transmission run is provided.
ScaleRHSWorkspace Input boolean True Scale the right-hand-side or left-hand-side workspace. Only used if a second transmission run is provided.
OutputWorkspace Output MatrixWorkspace Mandatory Output transmission workspace in wavelength.

Description

This algorithm is a facade over CreateTransmissionWorkspace v2. It pulls numeric parameters out of the instrument parameter file where possible. You can override any of these automatically applied defaults by providing your own values.

The first transmission run is the only mandatory property. If ProcessingInstructions is not set its value is inferred from other properties:

  • If AnalysisMode = PointDetectorAnalaysis and PointDetectorStart = PointDetectorStop then ProcessingInstructions is set to PointDetectorStart.
  • If AnalysisMode = PointDetectorAnalaysis and PointDetectorStart != PointDetectorStop then ProcessingInstructions is set to PointDetectorStart:PointDetectorStop.
  • If AnalysisMode = MultiDetectorAnalaysis then the spectrum range from MultiDetectorStart to the last spectrum in the input workspace is used.

When WavelengthMin and/or WavelengthMax are not provided, the algorithm will search for LambdaMin and LambdaMax in the parameter file. If monitor properties, I0MonitorIndex, MonitorBackgroundWavelengthMin, MonitorBackgroundWavelengthMax, MonitorIntegrationWavelengthMin and MonitorIntegrationWavelengthMax, are not set, the algorithm will search for I0MonitorIndex, MonitorBackgroundMin, MonitorBackgroundMax, MonitorIntegralMin and MonitorIntegralMax respectively.

Finally, if a second transmission run is given, the algorithm will run CreateTransmissionWorkspace v2 using StartOverlap, EndOverlap and Params if those have been set.

See CreateTransmissionWorkspace v2 for more information on the wrapped algorithm.

Previous Versions

This is version 2 of the algorithm. For version 1, please see CreateTransmissionWorkspaceAuto-v1.

Usage

Note

To run these usage examples please first download the usage data, and add these to your path. In MantidPlot this is done using Manage User Directories.

Example - Create a transmission run

# Create a transmission run with input properties read from the parameter file
trans = Load(Filename='INTER00013463.nxs')
transWS = CreateTransmissionWorkspaceAuto(FirstTransmissionRun=trans)

print("{:.4f}".format(transWS.readY(0)[26]))
print("{:.4f}".format(transWS.readY(0)[27]))
print("{:.4f}".format(transWS.readY(0)[28]))
print("{:.4f}".format(transWS.readY(0)[29]))

Output:

0.0827
0.0859
0.0861
0.0869

Example - Create a transmission run, overriding some default parameters

# Override the default values for MonitorBackgroundWavelengthMin and MonitorBackgroundWavelengthMax
trans = Load(Filename='INTER00013463.nxs')
transWS = CreateTransmissionWorkspaceAuto(FirstTransmissionRun=trans, MonitorBackgroundWavelengthMin=0.0, MonitorBackgroundWavelengthMax=1.0)

print("{:.3f}".format(transWS.readY(0)[26]))
print("{:.3f}".format(transWS.readY(0)[27]))
print("{:.3f}".format(transWS.readY(0)[28]))
print("{:.3f}".format(transWS.readY(0)[29]))

Output:

0.083
0.086
0.086
0.087

Example - Create a transmission run from two runs

trans1 = Load(Filename='INTER00013463.nxs')
trans2 = Load(Filename='INTER00013464.nxs')
transWS = CreateTransmissionWorkspaceAuto(FirstTransmissionRun=trans1, SecondTransmissionRun=trans2, Params=[1.5,0.02,17], StartOverlap=10.0, EndOverlap=12.0)

print("{:.4f}".format(transWS.readY(0)[26]))
print("{:.4f}".format(transWS.readY(0)[27]))
print("{:.4f}".format(transWS.readY(0)[28]))
print("{:.4f}".format(transWS.readY(0)[29]))

Output:

0.0816
0.0841
0.0857
0.0862

Categories: AlgorithmIndex | Reflectometry\ISIS

Source

C++ source: CreateTransmissionWorkspaceAuto2.cpp (last modified: 2019-07-17)

C++ header: CreateTransmissionWorkspaceAuto2.h (last modified: 2018-10-05)