# Oxford Instruments PS120_10

Control the Oxford Instruments PS120_10 power supply from Python with the `PS120_10` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Power supplies](https://dev.nominal.io/instro/instruments/type/psu.md)  
**Manufacturer:** [Oxford Instruments](https://dev.nominal.io/instro/instruments/manufacturer/oxford-instruments.md)

Represents the Oxford Superconducting Magnet Power Supply PS 120-10.

## Publishing through instro

instro publishes the commands you send to a PS120_10 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 PS120_10
from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="ps",
    instrument=PS120_10("GPIB::25"),
    dataset_rid="<dataset rid>",
) as ps:

    ps.device.enable_control()         # Enables the power supply and remote control

    ps.device.train_magnet([           # Train the magnet after it has been cooled-down
        (11.8, 1.0),
        (13.9, 0.4),
        (14.9, 0.2),
        (16.0, 0.1),
    ])

    ps.device.set_field(12)            # Bring the magnet to 12 T. The switch heater will
                                # be turned off when the field is reached and the
                                # current is ramped back to 0 (i.e. persistent mode).

    print(self.field)           # Print the current field (whether in persistent or
                                # non-persistent mode)

    ps.device.set_field(0)             # Bring the magnet to 0 T. The persistent mode will be
                                # turned off first (i.e. current back to set-point and
                                # switch-heater on); afterwards the switch-heater will
                                # again be turned off.

    ps.device.disable_control()        # Disables the control of the supply, turns off the
                                # switch-heater and clamps the output.
```

### 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 PS120_10
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

ps = PS120_10("GPIB::25")   # Default channel for the IPS
recorder = attach(ps, "ps", [NominalCorePublisher(dataset_rid="<dataset rid>")])

ps.enable_control()         # Enables the power supply and remote control

ps.train_magnet([           # Train the magnet after it has been cooled-down
    (11.8, 1.0),
    (13.9, 0.4),
    (14.9, 0.2),
    (16.0, 0.1),
])

ps.set_field(12)            # Bring the magnet to 12 T. The switch heater will
                            # be turned off when the field is reached and the
                            # current is ramped back to 0 (i.e. persistent mode).

print(self.field)           # Print the current field (whether in persistent or
                            # non-persistent mode)

ps.set_field(0)             # Bring the magnet to 0 T. The persistent mode will be
                            # turned off first (i.e. current back to set-point and
                            # switch-heater on); afterwards the switch-heater will
                            # again be turned off.

ps.disable_control()        # Disables the control of the supply, turns off the
                            # switch-heater and clamps the output.

recorder.close()  # flush and close the publishers
```

The examples are adapted from the [pymeasure documentation for `PS120_10`](https://pymeasure.readthedocs.io/en/latest/api/instruments/oxfordinstruments/ps120_10.html#pymeasure.instruments.oxfordinstruments.ps120_10.PS120_10), which lists every property and method.
