ConvertToEventWorkspace dialog.
Table of Contents
Converts a Workspace2D from histograms to events in an EventWorkspace by converting each bin to an equivalent weighted event.
| Name | Direction | Type | Default | Description |
|---|---|---|---|---|
| InputWorkspace | Input | Workspace2D | Mandatory | An input Workspace2D. |
| GenerateZeros | Input | boolean | False | Generate an event even for empty bins Warning! This may use significantly more memory. |
| GenerateMultipleEvents | Input | boolean | False | Generate a number of evenly spread events in each bin. See the help for details. Warning! This may use significantly more memory. |
| MaxEventsPerBin | Input | number | 10 | If GenerateMultipleEvents is true, specifies a maximum number of events to generate in a single bin. Use a value that matches your instrument’s TOF resolution. Default 10. |
| OutputWorkspace | Output | EventWorkspace | Mandatory | Name of the output EventWorkspace. |
This algorithm takes a Workspace2D with any binning or units as its input. An event is created for each bin of each histogram, except if the bin count is 0.0 (unless GenerateZeros is true). Infinity and NAN (not-a-number) values are always skipped.
Each event is created with an X position (typically time-of-flight) equal to the center of the bin. The weight and error of the event are taken from the histogram value.
If the GenerateMultipleEvents option is set, then instead of a single event per bin, a certain number of events evenly distributed along the X bin are generated. The number of events generated in each bin is calculated by N = (Y/E)^2. However, it is limited to a max of MaxEventsPerBin and a minimum of 1 event per bin.
Note that using GenerateZeros or GenerateMultipleEvents may use a lot of memory!
Categories: AlgorithmIndex | Events
C++ source: ConvertToEventWorkspace.cpp (last modified: 2019-07-17)
C++ header: ConvertToEventWorkspace.h (last modified: 2018-10-05)