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

LoadEventAndCompress v1

Summary

Load an event workspace by chunks and compress

See Also

LoadEventNexus, CompressEvents

Properties

Name

Direction

Type

Default

Description

Filename

Input

string

Mandatory

The name of the Event NeXus file to read, including its full or relative path. The file name is typically of the form INST_####_event.nxs (N.B. case sensitive if running on Linux). Allowed extensions: [‘.nxs.h5’, ‘.nxs’, ‘_event.nxs’]

OutputWorkspace

Output

Workspace

Mandatory

The name of the output EventWorkspace or WorkspaceGroup in which to load the EventNexus file.

MaxChunkSize

Input

number

Optional

Get chunking strategy for chunks with this number of Gbytes. File will not be loaded if this option is set.

CompressTOFTolerance

Input

number

0.01

CompressBinningMode

Input

string

Default

Optional. Binning behavior can be specified in the usual way through sign of binwidth and other properties (‘Default’); or can be set to one of the allowed binning modes. This will override all other specification or default behavior. Allowed values: [‘Default’, ‘Linear’, ‘Logarithmic’]

FilterByTofMin

Input

number

Optional

Optional: To exclude events that do not fall within a range of times-of-flight. This is the minimum accepted value in microseconds. Keep blank to load all events.

FilterByTofMax

Input

number

Optional

Optional: To exclude events that do not fall within a range of times-of-flight. This is the maximum accepted value in microseconds. Keep blank to load all events.

FilterByTimeStart

Input

number

Optional

Optional: To only include events after the provided start time, in seconds (relative to the start of the run).

FilterByTimeStop

Input

number

Optional

Optional: To only include events before the provided stop time, in seconds (relative to the start of the run).

NXentryName

Input

string

Optional: Name of the NXentry to load if it’s not the default.

LoadMonitors

Input

boolean

False

Load the monitors from the file (optional, default False).

MonitorsLoadOnly

Input

string

If multiple repesentations exist, which one to load. Default is to load the one that is present. Allowed values: [‘’, ‘Events’, ‘Histogram’]

FilterMonByTofMin

Input

number

Optional

Optional: To exclude events from monitors that do not fall within a range of times-of-flight. This is the minimum accepted value in microseconds.

FilterMonByTofMax

Input

number

Optional

Optional: To exclude events from monitors that do not fall within a range of times-of-flight. This is the maximum accepted value in microseconds.

FilterMonByTimeStart

Input

number

Optional

Optional: To only include events from monitors after the provided start time, in seconds (relative to the start of the run).

FilterMonByTimeStop

Input

number

Optional

Optional: To only include events from monitors before the provided stop time, in seconds (relative to the start of the run).

FilterBadPulses

Input

number

95

Description

This is a workflow algorithm that loads an event nexus file in chunks and compresses the resulting chunks before summing them. It uses the algorithms:

  1. DetermineChunking v1

  2. LoadEventNexus v1

  3. FilterBadPulses v1

  4. CompressEvents v1

  5. Plus v1 to accumulate

Workflow

../_images/LoadEventAndCompress-v1_wkflw.svg

Usage

Example - LoadEventAndCompress

The files needed for this example are not present in our standard usage data download due to their size. They can however be downloaded using these links: PG3_9830_event.nxs.

PG3_9830_event = LoadEventAndCompress(Filename='PG3_9830_event.nxs',
                                      MaxChunkSize=1.)

Categories: AlgorithmIndex | Workflow\DataHandling

Source

C++ header: LoadEventAndCompress.h

C++ source: LoadEventAndCompress.cpp