CreateTransmissionWorkspace v1

../_images/CreateTransmissionWorkspace-v1_dlg.png

CreateTransmissionWorkspace dialog.

Summary

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

Properties

Name Direction Type Default Description
FirstTransmissionRun Input MatrixWorkspace Mandatory First transmission run, or the low wavelength transmision run if SecondTransmissionRun is also provided.
SecondTransmissionRun Input MatrixWorkspace   Second, high wavelength transmission run. Optional. Causes the InputWorkspace to be treated as the low wavelength transmission run.
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
EndOverlap Input number Optional End wavelength (angstroms) for stitching transmission runs together
I0MonitorIndex Input number Mandatory I0 monitor workspace index
ProcessingInstructions Input string Mandatory Grouping pattern on workspace indexes to yield only the detectors of interest. See GroupDetectors for details.
WavelengthMin Input number Mandatory Wavelength minimum in angstroms
WavelengthMax Input number Mandatory Wavelength maximum in angstroms
WavelengthStep Input number 0.05 Wavelength rebinning step in angstroms. Defaults to 0.05. Used for rebinning intermediate workspaces converted into wavelength.
MonitorBackgroundWavelengthMin Input number Mandatory Wavelength minimum for monitor background in angstroms.
MonitorBackgroundWavelengthMax Input number Mandatory Wavelength maximum for monitor background in angstroms.
MonitorIntegrationWavelengthMin Input number Mandatory Wavelength minimum for integration in angstroms.
MonitorIntegrationWavelengthMax Input number Mandatory Wavelength maximum for integration in angstroms.
OutputWorkspace Output MatrixWorkspace Mandatory Output Workspace IvsQ.

Description

Creates a transmission run workspace given one or two TOF workspaces, and the original run workspace. If two workspaces are provided, then the first workspace is considered a low wavelength transmission run, and the second workspace is considered a high wavelength transmission run.

The two transmission run workspaces are converted to IvQ workspaces and then stitched together using Stitch1D v3. Both input workspaces must have x-units of TOF.

A single output workspace is generated with x-units of Wavelength in angstroms.

In most cases you will want to use CreateTransmissionWorkspaceAuto v1, which is a facade over this algorithm that correctly configures the input properties for you.

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

trans = Load(Filename='INTER00013463.nxs')
transWS = CreateTransmissionWorkspace(
  FirstTransmissionRun = trans,
  I0MonitorIndex = 2,
  ProcessingInstructions = '3,4',
  WavelengthMin = 1,
  WavelengthMax = 17,
  MonitorBackgroundWavelengthMin = 15,
  MonitorBackgroundWavelengthMax = 17,
  MonitorIntegrationWavelengthMin = 4,
  MonitorIntegrationWavelengthMax = 10)

print "The first four transWS Y values are:"
for i in range (4):
    print "%.4f" % transWS.readY(0)[i]

Output:

The first four transWS Y values are:
0.0223
0.0602
0.1020
0.1207

Example - Create a transmission run from two runs

trans1 = Load(Filename='INTER00013463.nxs')
trans2 = Load(Filename='INTER00013464.nxs')
transWS = CreateTransmissionWorkspace(
  FirstTransmissionRun = trans1,
  SecondTransmissionRun = trans2,
  Params = [1.5,0.02,17],
  StartOverlap = 10.0,
  EndOverlap = 12.0,
  I0MonitorIndex = 2,
  ProcessingInstructions = '3,4',
  WavelengthMin = 1,
  WavelengthMax = 17,
  MonitorBackgroundWavelengthMin = 15,
  MonitorBackgroundWavelengthMax = 17,
  MonitorIntegrationWavelengthMin = 4,
  MonitorIntegrationWavelengthMax = 10)

print "The first four transWS Y values are:"
for i in range (4):
    print "%.4f" % transWS.readY(0)[i]

Output:

The first four transWS Y values are:
0.0567
0.0575
0.0577
0.0580

Categories: Algorithms | Reflectometry