\(\renewcommand\AA{\unicode{x212B}}\)
CropWorkspace v1¶
Summary¶
Extracts a ‘block’ from a workspace and places it in a new workspace.
See Also¶
CropWorkspaceRagged, CropToComponent, RemoveBins, ExtractSingleSpectrum, ExtractSpectra
Properties¶
Name |
Direction |
Type |
Default |
Description |
|---|---|---|---|---|
InputWorkspace |
Input |
Mandatory |
The input workspace |
|
OutputWorkspace |
Output |
Mandatory |
Name of the output workspace |
|
XMin |
Input |
number |
Optional |
An X value that is within the first (lowest X value) bin that will be retained (default: workspace min) |
XMax |
Input |
number |
Optional |
An X value that is in the highest X value bin to be retained (default: max X) |
StartWorkspaceIndex |
Input |
number |
0 |
The index number of the first entry in the Workspace that will be loaded (default: first entry in the Workspace) |
EndWorkspaceIndex |
Input |
number |
Optional |
The index number of the last entry in the Workspace to be loaded (default: last entry in the Workspace) |
Description¶
Extracts a ‘block’ from a workspace and places it in a new workspace (or, to look at it another way, lops bins or spectra off a workspace).
CropWorkspace works on workspaces with common X arrays/bin boundaries or on so-called ragged workspace. If the input workspace has common bin boundaries/X values then cropping in X will lead to an output workspace with fewer bins than the input one. If the boundaries are not common then the output workspace will have the same number of bins as the input one, but with data values outside the X range given set to zero.
If an X value given for XMin/XMax does not match a bin boundary (within a small tolerance to account for rounding errors), then the closest bin boundary on the left will be used. Note that if none of the optional properties are given, then the output workspace will be a copy of the input one. If XMin==XMax the single bin that X falls into will be extracted.
Usage¶
Example - Crop a 5-bin workspace
# Create a workspace with 1 spectrum with five bins of width 10
ws = CreateSampleWorkspace(WorkspaceType="Histogram", NumBanks=1, BankPixelWidth=1, BinWidth=10, Xmax=50)
# Run algorithm removing first and last bins
OutputWorkspace = CropWorkspace(InputWorkspace=ws,XMin=10.0,XMax=40.0)
# Show workspaces
print("TOF Before CropWorkspace {}".format(ws.readX(0)))
print("TOF After CropWorkspace {}".format(OutputWorkspace.readX(0)))
Output:
TOF Before CropWorkspace [ 0. 10. 20. 30. 40. 50.]
TOF After CropWorkspace [ 10. 20. 30. 40.]
Categories: AlgorithmIndex | Transforms\Splitting
Source¶
C++ header: CropWorkspace.h
C++ source: CropWorkspace.cpp