FilterEvents-v1.rst 1.99 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
.. algorithm::

.. summary::

.. alias::

.. properties::

Description
-----------

This algorithm filters events from an
Nick Draper's avatar
Nick Draper committed
13
14
:ref:`EventWorkspace <EventWorkspace>` to one or multiple
:ref:`EventWorkspaces <EventWorkspace>` according to an input
Nick Draper's avatar
Nick Draper committed
15
16
`SplittersWorkspace <http://www.mantidproject.org/SplittersWorkspace>`_ containing a series of
splitters (i.e., `SplittingIntervals <http://www.mantidproject.org/SplittingInterval>`_).
17
18

Output
19
######
20
21
22
23
24
25

The output will be one or multiple workspaces according to the number of
index in splitters. The output workspace name is the combination of
parameter OutputWorkspaceBaseName and the index in splitter.

Calibration File
26
################
27
28
29
30
31
32
33
34
35
36
37
38
39

The calibration, or say correction, from the detector to sample must be
consider in fast log. Thus a calibration file is required. The math is

``TOF_calibrated = TOF_raw * correction(detector ID).``

The calibration is in column data format.

A reasonable approximation of the correction is

``correction(detector_ID) = L1/(L1+L2(detector_ID))``

Unfiltered Events
40
#################
41
42
43
44
45
46
47
48

Some events are not inside any splitters. They are put to a workspace
name ended with '\_unfiltered'.

If input property 'OutputWorkspaceIndexedFrom1' is set to True, then
this workspace shall not be outputed.

Difference from FilterByLogValue
49
################################
50
51
52
53
54
55
56
57
58
59
60
61
62
63

In FilterByLogValue(), EventList.splitByTime() is used.

In FilterEvents(), if FilterByPulse is selected true,
EventList.SplitByTime is called; otherwise, EventList.SplitByFullTime()
is called instead.

The difference between splitByTime and splitByFullTime is that
splitByTime filters events by pulse time, and splitByFullTime considers
both pulse time and TOF.

Therefore, FilterByLogValue is not suitable for fast log filtering.

Comparing with other event filtering algorithms
64
###############################################
65

Savici, Andrei T's avatar
Savici, Andrei T committed
66
Wiki page `EventFiltering <http://www.mantidproject.org/EventFiltering>`__ has a detailed
67
68
69
introduction on event filtering in MantidPlot.

.. categories::