\(\renewcommand\AA{\unicode{x212B}}\)
LoadEmptyInstrument v1¶
Summary¶
Loads an Instrument Definition File (IDF) into a workspace rather than a data file.
See Also¶
Properties¶
Name |
Direction |
Type |
Default |
Description |
|---|---|---|---|---|
Filename |
Input |
string |
Path to a file (full or relative) defining the instrument. The file could be an IDF or a NeXus Geometry file. Note, Filename or InstrumentName must be specified, but not both. Allowed extensions: [‘.xml’, ‘.hdf5’, ‘.nxs’, ‘.nxs.h5’] |
|
InstrumentName |
Input |
string |
Name of instrument. Can be used instead of Filename to specify an IDF |
|
OutputWorkspace |
Output |
Mandatory |
The name of the workspace in which to store the imported instrument |
|
DetectorValue |
Input |
number |
1 |
This value affects the colour of the detectors in the instrument display window (default 1) |
MonitorValue |
Input |
number |
2 |
This value affects the colour of the monitors in the instrument display window (default 2) |
MakeEventWorkspace |
Input |
boolean |
False |
Set to True to create an EventWorkspace (with no events) instead of a Workspace2D. |
Description¶
This algorithm is to enable you to inspect the instrument geometry without having to load a full data file.
This algorithm works with both Instrument Definition Files and NeXus format (hdf5) files.
Input files only provide the instrument geometry. The instrument is referred to as being empty because there is no real data associated with it. The algorithm provides some limited options to determine what fake data will be used.
Usage¶
Example - Loading an instrument IDF from an XML file
wsOut = LoadEmptyInstrument(Filename="INES_Definition.xml")
print("The workspace contains {} spectra".format(wsOut.getNumberHistograms()))
Output:
The workspace contains 146 spectra
Example - Loading an instrument from an NeXus file
ws = LoadEmptyInstrument(Filename="LOKI_Definition.hdf5")
print("The workspace contains {} spectra".format(ws.getNumberHistograms()))
print("Instrument is {}".format(ws.getInstrument().getName()))
Output:
The workspace contains 8000 spectra
Instrument is LOKI
Categories: AlgorithmIndex | DataHandling\Instrument
Source¶
C++ header: LoadEmptyInstrument.h
C++ source: LoadEmptyInstrument.cpp