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

CopyDataRange v1

../_images/ImageNotFound.png

Enable screenshots using DOCS_SCREENSHOTS in CMake

Summary

Replaces a range of data in the destination workspace with a specified continuous range of data from the input workspace

Properties

Name

Direction

Type

Default

Description

InputWorkspace

Input

MatrixWorkspace

Mandatory

The workspace containing a range of data to be used for the replacement.

DestWorkspace

Input

MatrixWorkspace

Mandatory

The workspace to have range of data replaced.

StartWorkspaceIndex

Input

number

0

The index denoting the start of the spectra range.

EndWorkspaceIndex

Input

number

Optional

The index denoting the end of the spectra range.

XMin

Input

number

Optional

An X value that is equal to the lowest point to copy (point data), or an X value that is within the first bin to copy (histogram data).

XMax

Input

number

Optional

An X value that is equal to the highest point to copy (point data), or an X value that is within the last bin to copy (histogram data).

InsertionYIndex

Input

number

0

The index denoting the histogram position for the start of the data replacement in the DestWorkspace.

InsertionXIndex

Input

number

0

The index denoting the x position for the start of the data replacement in the DestWorkspace.

OutputWorkspace

Output

MatrixWorkspace

Mandatory

The name to give the output workspace.

Description

This algorithm takes a continuous block of data from an input workspace and places this data into a destination workspace, replacing the data in the destination workspace at which the insertion is specified. The block of data to be used is specified by entering spectra indices and x indices within the input workspace into the algorithm. The insertion location is then specified by an InsertionYIndex and InsertionXIndex within the destination workspace.

Note that this algorithm will replace not only the Y values, but also the E values within the destination workspace. The original input workspace remains unchanged.

Usage

Example - Copy Data Range within one workspace over to another

# Create two workspaces
demo_ws1 = CreateWorkspace(DataX=[1,2,3], DataY=[1,2,3], DataE=[1,1,1], NSpec=1)
demo_ws2 = CreateWorkspace(DataX=[1,2,3], DataY=[4,5,6], DataE=[2,2,2], NSpec=1)

# Copy some of the data from the input workspace over to the destination workspace
output = CopyDataRange(InputWorkspace=demo_ws1, DestWorkspace=demo_ws2, StartWorkspaceIndex=0, EndWorkspaceIndex=0,
                       XMin=1, XMax=2, InsertionYIndex=0, InsertionXIndex=0)

# Display the output workpace data
print("Output x data: {0}".format(output.readX(0)))
print("Output y data: {0}".format(output.readY(0)))
print("Output e data: {0}".format(output.readE(0)))

Output:

Output x data: [ 1.  2.  3.]
Output y data: [ 1.  2.  6.]
Output e data: [ 1.  1.  2.]

Categories: AlgorithmIndex | Utility\Workspaces

Source

C++ header: CopyDataRange.h

C++ source: CopyDataRange.cpp