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

CreateTransmissionWorkspaceAuto v2

../_images/ImageNotFound.png

Enable screenshots using DOCS_SCREENSHOTS in CMake

Summary

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

See Also

CreateTransmissionWorkspace

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 Mantid 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++ header: CreateTransmissionWorkspaceAuto2.h

C++ source: CreateTransmissionWorkspaceAuto2.cpp