ClearInstrumentParameters dialog.
Table of Contents
| Name | Direction | Type | Default | Description |
|---|---|---|---|---|
| Workspace | InOut | MatrixWorkspace | Mandatory | Workspace whose instrument parameters are to be cleared. |
This algorithm clears all the parameters associated with a workspace’s instrument.
Parameters are used by Mantid to tweak an instrument’s values without having to change the instrument definition file itself.
ws = CreateSampleWorkspace()
#Set a string parameter on the whole instrument
SetInstrumentParameter(ws,ParameterName="TestParam",Value="Hello")
#Set a Number parameter just for bank 1
SetInstrumentParameter(ws,ParameterName="NumberParam",Value="3", ComponentName="bank1",ParameterType="Number")
#Set a different value on bank 2
SetInstrumentParameter(ws,ParameterName="NumberParam",Value="3.5", ComponentName="bank2",ParameterType="Number")
instrument = ws.getInstrument()
bank1 = instrument.getComponentByName("bank1")
bank2 = instrument.getComponentByName("bank2")
#Check the parameters are set correctly
print("Instrument: " + instrument.getStringParameter("TestParam")[0])
print("Bank1: " + bank1.getStringParameter("TestParam")[0])
print("Bank2: " + bank2.getStringParameter("TestParam")[0])
#Clear all the instrument's parameters
print("Clearing all parameters")
ClearInstrumentParameters(ws)
#Check the parameters have been cleared correctly
#Obtain instrument and banks again, to make sure they contain the updated parameters
instrument = ws.getInstrument()
bank1 = instrument.getComponentByName("bank1")
bank2 = instrument.getComponentByName("bank2")
if len(instrument.getStringParameter("TestParam")) == 0:
print("Instrument was cleared successfully.")
if len(bank1.getStringParameter("TestParam")) == 0:
print("Bank1 was cleared successfully.")
if len(bank2.getStringParameter("TestParam")) == 0:
print("Bank2 was cleared successfully.")
Instrument: Hello
Bank1: Hello
Bank2: Hello
Clearing all parameters
Instrument was cleared successfully.
Bank1 was cleared successfully.
Bank2 was cleared successfully.
Categories: AlgorithmIndex | DataHandling\Instrument
C++ source: ClearInstrumentParameters.cpp (last modified: 2019-06-04)
C++ header: ClearInstrumentParameters.h (last modified: 2018-10-05)