Newer
Older
.. algorithm::
.. summary::
.. alias::
.. properties::
Description
-----------
Changes the units in which the X values of a `workspace <http://www.mantidproject.org/Workspace>`__
are represented. The available units are those registered with the `Unit
Factory <http://www.mantidproject.org/Units>`__. If the Y data is 'dimensioned' (i.e. has been
divided by the bin width), then this will be correctly handled, but at
present nothing else is done to the Y data. If the sample-detector
distance cannot be calculated then the affected spectrum will be zeroed,
and a warning message will be output on the `logging <http://www.mantidproject.org/logging>`__
service.
If AlignBins is false or left at the default the output workspace may be
a `Ragged Workspace <http://www.mantidproject.org/Ragged_Workspace>`__. If it is set to true then the
data is automatically `rebinned <http://www.mantidproject.org/Rebin>`__ to a regular grid so that the
maximum and minimum X values will be maintained. It uses the same number
of bins as the input data, and divides them linearly equally between the
minimum and maximum values.
If converting to :math:`\Delta E` any bins which correspond to a
physically inaccessible will be removed, leading to an output workspace
than is smaller than the input one. If the geometry is indirect then the
value of EFixed will be taken, if available, from the instrument
definition file.
Restrictions on the input workspace
###################################
- Naturally, the X values must have a unit set, and that unit must be
known to the `Unit Factory <http://www.mantidproject.org/Units>`__.
- Only histograms, not point data, can be handled at present.
- The algorithm will also fail if the source-sample distance cannot be
calculated (i.e. the `instrument <http://www.mantidproject.org/instrument>`__ has not been
properly defined).
Available units
---------------
The units currently available to this algorithm are listed
`here <http://www.mantidproject.org/Units>`__, along with equations specifying exactly how the
conversions are done.
.. categories::