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

LoadRKH v1

../_images/LoadRKH-v1_dlg.png

LoadRKH dialog.

Summary

Load a file written in the RKH format

Properties

Name Direction Type Default Description
Filename Input string Mandatory Name of the RKH file to load. Allowed extensions: [‘.txt’, ‘.q’, ‘.dat’]
OutputWorkspace Output MatrixWorkspace Mandatory The name to use for the output workspace
FirstColumnValue Input string Wavelength Only used for 1D files, the units of the first column in the RKH file (default Wavelength). Allowed values: [‘AtomicDistance’, ‘Degrees’, ‘DeltaE’, ‘DeltaE_inFrequency’, ‘DeltaE_inWavenumber’, ‘dSpacing’, ‘dSpacingPerpendicular’, ‘Empty’, ‘Energy’, ‘Energy_inWavenumber’, ‘Label’, ‘Momentum’, ‘MomentumTransfer’, ‘Phi’, ‘QSquared’, ‘SpinEchoLength’, ‘SpinEchoTime’, ‘Temperature’, ‘Time’, ‘TOF’, ‘Wavelength’, ‘SpectrumNumber’]

Description

Loads the given file in the RKH text format, which can be a file with three columns of numbers. If the FirstColumnValue is a recognised Mantid unit the workspace is created with just one spectrum. Alteratively if FirstColumnValue is set to ‘SpectrumNumber’ then the workspace can have many spectra with the spectrum Numbers equal to the first column in the file.

Usage

Example - Save/Load “Roundtrip”

import os
import numpy

# Create dummy workspace.
dataX = [1,2,3,4,5]
dataY = [8,4,9,7]
dataE = [2,1,1,3]
out_ws = CreateWorkspace(dataX, dataY, dataE, UnitX="MomentumTransfer")

file_path = os.path.join(config["defaultsave.directory"], "example.out")

# Do a "roundtrip" of the data.
SaveRKH(out_ws, file_path)
in_ws = LoadRKH(file_path)

print("Contents of the file  = {}".format(in_ws.readY(0)))

Output:

Contents of the file  = [ 8.  4.  9.  7.]

Categories: AlgorithmIndex | DataHandling\Text | SANS\DataHandling

Source

C++ header: LoadRKH.h

C++ source: LoadRKH.cpp