# Yokogawa 7651

Control the Yokogawa 7651 power supply from Python with the `Yokogawa7651` driver.

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

Represents the Yokogawa 7651 Programmable DC Source and provides a high-level for interacting with the instrument.

## Publishing through instro

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

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

    yoko.device.apply_current()                # Sets up to source current
    yoko.device.source_current_range = 10e-3   # Sets the current range to 10 mA
    yoko.device.compliance_voltage = 10        # Sets the compliance voltage to 10 V
    yoko.device.source_current = 0             # Sets the source current to 0 mA

    yoko.device.enable_source()                # Enables the current output
    yoko.device.ramp_to_current(5e-3)          # Ramps the current to 5 mA

    yoko.device.shutdown()                     # Ramps the current to 0 mA and disables 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.yokogawa import Yokogawa7651
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

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

yoko.apply_current()                # Sets up to source current
yoko.source_current_range = 10e-3   # Sets the current range to 10 mA
yoko.compliance_voltage = 10        # Sets the compliance voltage to 10 V
yoko.source_current = 0             # Sets the source current to 0 mA

yoko.enable_source()                # Enables the current output
yoko.ramp_to_current(5e-3)          # Ramps the current to 5 mA

yoko.shutdown()                     # Ramps the current to 0 mA and disables output

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

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