Oxford Instruments MercuryiTC#

Control the Oxford Instruments MercuryiTC temperature controller from Python with the MercuryiTC driver.

Driver: pymeasure
Type: Temperature controllers and chambers
Manufacturer: Oxford Instruments

Represents the Oxford Instruments Mercury iTC (Intelligent Temperature Controller) and provides a high-level interface for interacting with the instrument.

Publishing through instro#

instro publishes the commands you send to a MercuryiTC and the values you read from it, through any publisher. It takes two forms, both described in the pymeasure guide. Install with uv add "instro[pymeasure]".

With a PymeasureInstrument#

PymeasureInstrument wraps the driver in an instro instrument, with tags and background polling. The instrument is created inside the with block, and .device is the pymeasure instrument.

from pymeasure.instruments.oxfordinstruments import MercuryiTC
from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="controller",
    instrument=MercuryiTC("GPIB::1"),
    dataset_rid="<dataset rid>",
) as controller:

    # Print the current measured temperature of the motherboard temperature sensor aka 'MB1.T1'
    print(controller.device.TS_MB.temperature)

    # Print the motherboard temperature sensor control-loop setpoint
    print(controller.device.TS['MB1.T1'].loop_T_setpoint)

    # Add new temperature sensor with UID 'DB6.T1'
    controller.device.add_temperature_sensor('DB6.T1')

    # Print the new sensor's temperature
    print(controller.device.TS['DBS.T1'].temperature)

With existing pymeasure code (attach())#

attach() adds publishing to pymeasure code you already have. The imports, the attach() call after the instrument is created, and recorder.close() are all that instro adds.

from pymeasure.instruments.oxfordinstruments import MercuryiTC
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

controller = MercuryiTC("GPIB::1")
recorder = attach(controller, "controller", [NominalCorePublisher(dataset_rid="<dataset rid>")])

# Print the current measured temperature of the motherboard temperature sensor aka 'MB1.T1'
print(controller.TS_MB.temperature)

# Print the motherboard temperature sensor control-loop setpoint
print(controller.TS['MB1.T1'].loop_T_setpoint)

# Add new temperature sensor with UID 'DB6.T1'
controller.add_temperature_sensor('DB6.T1')

# Print the new sensor's temperature
print(controller.TS['DBS.T1'].temperature)

recorder.close()  # flush and close the publishers

The examples are adapted from the pymeasure documentation for MercuryiTC, which lists every property and method.