Table of Contents
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 workspace indices 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. |
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. |
OutputWorkspace | Output | MatrixWorkspace | Mandatory | Output transmission workspace in wavelength. |
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:
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.
This is version 2 of the algorithm. For version 1, please see CreateTransmissionWorkspaceAuto-v1.
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" % (transWS.readY(0)[26])
print "%.4f" % (transWS.readY(0)[27])
print "%.4f" % (transWS.readY(0)[28])
print "%.4f" % (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" % (transWS.readY(0)[26])
print "%.3f" % (transWS.readY(0)[27])
print "%.3f" % (transWS.readY(0)[28])
print "%.3f" % (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" % (transWS.readY(0)[26])
print "%.4f" % (transWS.readY(0)[27])
print "%.4f" % (transWS.readY(0)[28])
print "%.4f" % (transWS.readY(0)[29])
Output:
0.0816
0.0841
0.0857
0.0862
Categories: Algorithms | Reflectometry\ISIS
C++ source: CreateTransmissionWorkspaceAuto2.cpp
C++ header: CreateTransmissionWorkspaceAuto2.h