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

LoadAndMerge v1

../_images/LoadAndMerge-v1_dlg.png

LoadAndMerge dialog.

Summary

Loads and merges multiple runs. Similar to Load, but uses MergeRuns instead of Plus for summing.

Properties

Name Direction Type Default Description
Filename Input list of str lists Mandatory List of input files
LoaderName InOut string Load The name of the specific loader. Generic Load by default.
LoaderVersion InOut number -1 The version of the specific loader
LoaderOptions Input Dictionary null Options for the specific loader
MergeRunsOptions Input Dictionary null Options for merging the metadata
OutputWorkspace Output Workspace Mandatory Output workspace or workspace group.
OutputBehaviour Input string Group Whether to group the workspaces to a workspace group or to concatenate them to a single workspace. Allowed values: [‘Group’, ‘Concatenate’]
SampleLogAsXAxis Input string   Sample log to be put as x-axis when concatenating; will use linear indices if left blank.

Description

This algorithm loads multiple runs conforming the rules in MultipleFileProperty. When listing is requested, the output is a WorkspaceGroup, containing items for each run. When summing is requested, it is performed pair-wise in-situ with MergeRuns. By doing this, the metadata (SampleLogs) are also merged governed by the rules specified in the Instrument Parameter File (IPF) as explained in MergeRuns. This rules can be overridden by the MergeRunsOptions input. Specific loader can be given by the LoaderName and LoaderVersion. If left as defaults, the algorithm will automatically find out the corresponding specific loader, deducing from the first run in the list. It will set the name and the version of the suitable loader found as output properties in LoaderName and LoaderVersion. The input runs must be loadable by the same specific loader, the files can not be mixed. If the Output is hidden, i.e. the name starts with __, all the workspaces (intermediate and final) produced by this algorithm will also be hidden, but stored in the AnalysisDataService in any case.

Usage

Note

To run these usage examples please first download the usage data, and add these to your path. In Mantid this is done using Manage User Directories.

out = LoadAndMerge(Filename='170257+170258,170300+170302')
print('out is a WorkspaceGroup, containing {0} workspaces'.format(out.getNumberOfEntries()))
print('the first item is the merged output of the runs 170257 and 170258 with the name {0}'.format(out.getItem(0).getName()))
print('the second item is the merged output of the runs 170300 and 170302 with the name {0}'.format(out.getItem(1).getName()))

Output

out is a WorkspaceGroup, containing 2 workspaces
the first item is the merged output of the runs 170257 and 170258 with the name 170257_170258
the second item is the merged output of the runs 170300 and 170302 with the name 170300_170302