# Oxford Instruments MercuryiTC

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

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Temperature controllers and chambers](https://dev.nominal.io/instro/instruments/type/temperature.md)  
**Manufacturer:** [Oxford Instruments](https://dev.nominal.io/instro/instruments/manufacturer/oxford-instruments.md)

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](https://dev.nominal.io/instro/library/publishers.md). It takes two forms, both described in the [pymeasure guide](https://dev.nominal.io/instro/library/pymeasure.md). Install with `uv add "instro[pymeasure]"`.

### With a PymeasureInstrument

[`PymeasureInstrument`](https://dev.nominal.io/instro/library/pymeasure.md#write-new-instro-code) 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.

```python
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()`](https://dev.nominal.io/instro/library/pymeasure.md#publish-from-existing-code) 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.

```python
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`](https://pymeasure.readthedocs.io/en/latest/api/instruments/oxfordinstruments/mercuryitc.html#pymeasure.instruments.oxfordinstruments.mercuryitc.MercuryiTC), which lists every property and method.
