Temperature
This module can be used to connect to temperature controllers in order to make temperature variations. It can also be used to only read temperatures, e.g. with the Sweep mode "None".
User interface
The module has two tabs:
- Setup: driver, port, Sweep mode, Sweep value, options, test buttons, and the reach settings.
- Sweep values: a SweepEditor and a SweepBox to define the setpoints.
Fields that are not supported by the selected driver are disabled. The field "Channel" is only shown if the driver supports several channels.
Sweep mode
The Sweep mode defines what is set with the sweep values. The options are defined by the driver, e.g. "None", "Temperature", or "Output in %". If the Sweep mode contains "Temperature", the sweep values are used as temperature setpoints and the fields "Rate", "Accuracy range" and "Hold accuracy range" are shown.
Temperature unit
If the driver supports it, different temperature units can be selected, e.g. "K", "°C" or "°F". The labels of the fields "Rate", "Idle temperature" and of the test buttons show the selected unit.
Sensor
Select the sensor or sensor input that should be used.
Rate in unit/min
You can set the ramp rate (temperature change per minute) or the setpoint rate, depending on the implementation of the driver. The label shows the selected temperature unit, e.g. "Rate in K/min". The field is only shown if the Sweep mode contains "Temperature". Leave it empty to keep the value currently set at the instrument.
Heater range
Some temperature controllers have different heater ranges like Low, Medium, or High that adjust the power of the controller. The feature was introduced for Lake Shore 33x temperature controllers.
Output, max. in % and Output, min. in %
You can set the maximum and the minimum output in % if the driver supports it. Leave the fields empty to keep the values currently set at the instrument.
Test
The module has a test section to set and read temperature values. The labels of the buttons "Set T in ..." and "Get T in ..." automatically change with the selected temperature unit. They can be used to quickly check the connection to the instrument or set a new temperature:
- Set T in ...: sends the temperature entered in the field next to the button as setpoint. The module does not wait until the temperature is reached.
- Get T in ...: reads the temperature and shows it in the field next to the button.
- Zero power: switches off the heating or cooling power of the temperature controller.
Measure Temperature
Some temperature controllers have a rather slow communication and in this case some drivers allow the user to choose whether the temperature is read back at each measurement point. If the temperature fluctuates or is not stable, measuring the temperature at each point is recommended.
Zero power afterwards
This function switches off the power of the temperature controller after the run. If not checked, the temperature controller will stay at the last set temperature which sometimes might be beneficial if you like to continue a next measurement at this temperature without waiting to reach this temperature again.
Idle temperature
Optional temperature that is set at the end of the run, when the temperature controller is unconfigured. The label shows the selected temperature unit, e.g. "Idle temperature in K". Leave it empty to keep the last setpoint. The field is only available if the driver supports it.
Reach
The reach-functionality is important if you like to perform temperature variations. For example, before you can take a current-voltage characteristic, you need to wait for the temperature controller to reach a temperature. You could do this in the sequencer by adding a branch that checks whether temperature is reached. More convenient is to use the reach-functionality of the Temperature module itself. Just check the box "Reach Temperature" (checked by default) and choose an "Accuracy range" (default 0.2) and a "Hold accuracy range in s" (default 120). The module will then retrieve temperature values from the instrument until the temperature has stayed in the accuracy range for the given hold time. If the temperature leaves the accuracy range, the hold timer is zeroed and starts again, once the accuracy range is entered again.
The module only waits after a new setpoint has been applied. If the setpoint does not change, e.g. while other modules of the branch are varied, the measurement continues immediately.
During the reach process, there is no update of the plot widget as the reach process is not part of the measurement. It is a process that stops the run for the time of reaching the temperature. However, you can see in the status bar of the SweepMe! main window a message like "approaching to ... K" or "... s to hold at ... K".
If the driver has its own reach function, it is used for any Sweep mode, and the fields "Accuracy range" and "Hold accuracy range in s" are not used by the module. Otherwise, the module built-in reach with "Accuracy range" and "Hold accuracy range in s" is used. It requires a Sweep mode that contains "Temperature" and a driver that can measure the temperature. If "Reach Temperature" is checked but the driver supports neither, the run is stopped with an error message.
In case you like to make a measurement while the Temperature module makes a ramp, the reach functionality should not be used. Instead a single setpoint should be used and during the ramp the modules Loop and Delay in the sequencer should take care to regularly read values from other instruments. To stop the looping, one can use the Pro module Condition to for example to stop the process when the setpoint has been reached or to continue with the next setpoint temperature ramp.
Driver programming
Mandatory GUI parameters
The driver must provide at least the following GUI parameters:
| TemperatureUnit | A list of strings of the temperature units supported by the driver. |
| SweepMode | List of supported Modes. Required, if the instrument supports setting a temperature (not used as a logger). "None" means that no value is applied, "Temperature" means the sweep value is used as the set temperature and the internal reach logic of the temperature module can be used. The module checks whether the Sweep mode contains "Temperature" (not case-sensitive). |
Optional GUI parameters
| Channel | A list of strings with the channels. The field "Channel" is only shown if the driver returns this key. |
| Sensor | A list of strings with the sensors or sensor inputs. |
| Rate | A string with the default rate. The value is the rate per minute in the selected temperature unit. An empty string means that the rate of the instrument is not changed. |
| HeaterRange | A list of strings with the heater ranges. |
| OutputMax | A string with the maximum output in %. An empty string means that the value is not changed. |
| OutputMin | A string with the minimum output in %. An empty string means that the value is not changed. |
| MeasureT | A boolean whether the temperature is measured at each measurement point. |
| ZeroPowerAfterSweep | A boolean whether the heating or cooling power is switched off at the end of the run. Can be used to keep the device turned on after a measurement is finished. |
| IdleTemperature | A string with the temperature that is set at the end of the run, typically in unconfigure. An empty string means that no idle temperature is set. |
return variables
The first variable should always be Temperature in order to allow the module to roll out further functionalities. For example, the field next to the button "Get T in ..." shows the first return value. The module itself does not add any return variables.
reach functionality
To support the reach functionality, the driver either needs its own reach() function or a function called "measure_temperature" that returns the temperature value as float in the selected temperature unit. The module built-in reach compares the value returned by "measure_temperature" with the setpoint every 0.5 s.
test buttons
The test buttons like "Set T in ...", "Get T in ...", or "Zero power" do not need any special function. They automatically work by calling the semantic standard functions of the driver:
- "Set T in ..." passes the Sweep mode "Temperature" to the driver and calls the functions up to apply().
- "Get T in ..." passes the Sweep mode "None" and MeasureT = True and runs a single measurement point.
- "Zero power" passes ZeroPowerAfterSweep = True and calls the functions to end a run, e.g. poweroff() and unconfigure().