\(\renewcommand\AA{\unicode{x212B}}\)
CreateChunkingFromInstrument v1¶
Summary¶
Creates chunking at a level of the instrument or instrument components.
Properties¶
Name |
Direction |
Type |
Default |
Description |
|---|---|---|---|---|
Filename |
Input |
string |
The name of the event nexus file to read, including its full or relative path. Allowed extensions: [‘_event.nxs’, ‘.nxs.h5’, ‘.nxs’] |
|
InputWorkspace |
Input |
Optional: An input workspace with the instrument we want to use. |
||
InstrumentName |
Input |
string |
Optional: Name of the instrument to base the ChunkingWorkpace on which to base the GroupingWorkspace. |
|
InstrumentFilename |
Input |
string |
Optional: Path to the instrument definition file on which to base the ChunkingWorkpace. Allowed extensions: [‘.xml’] |
|
ChunkNames |
Input |
string |
Optional: A string of the instrument component names to use as separate groups. Use / or , to separate multiple groups. If empty, then an empty GroupingWorkspace will be created. |
|
ChunkBy |
Input |
string |
Only used if GroupNames is empty: All detectors as one group, Groups (East,West for SNAP), Columns for SNAP, detector banks. Allowed values: [‘’, ‘All’, ‘Group’, ‘Column’, ‘bank’] |
|
MaxRecursionDepth |
Input |
number |
5 |
Number of levels to search into the instrument (default=5) |
MaxBankNumber |
Input |
number |
300 |
Maximum bank number to search for in the instrument |
OutputWorkspace |
Output |
Mandatory |
An output workspace describing the cunking. |
Description¶
Workflow algorithm to determine chunking strategy for event nexus file. This will break up the instrument into logical components according to the instrument hierarchy.
This algorithm does assume that there are components in the geometry named “bank#” and returns a table workspace of those names. Trying this on an instrument without components named that will generate an exception. Also, requesting “ChunkBy=All” will return an empty table workspace.
Usage¶
Example: Powgen
pg3 = LoadEmptyInstrument(Filename="POWGEN_Definition_2015-08-01.xml")
ws = CreateChunkingFromInstrument(InputWorkspace=pg3, ChunkBy="Group")
print("Created {} Chunks".format(ws.rowCount()))
Output:
Created 4 Chunks
Example: Snap
ws = CreateChunkingFromInstrument(InstrumentName="snap", ChunkNames="East,West", MaxBankNumber=64)
print("Created {} Chunks".format(ws.rowCount()))
Output:
Created 2 Chunks
Categories: AlgorithmIndex | Workflow\DataHandling
Source¶
C++ header: CreateChunkingFromInstrument.h
C++ source: CreateChunkingFromInstrument.cpp