# Proterial ROD4

Control the Proterial ROD4 pressure or vacuum instrument from Python with the `ROD4` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Pressure and vacuum](https://dev.nominal.io/instro/instruments/type/pressure.md)  
**Manufacturer:** [Proterial](https://dev.nominal.io/instro/instruments/manufacturer/proterial.md)

Represents the Proterial ROD-4(A) operator for mass flow controllers and provides a high-level interface for interacting with the instrument.

## Publishing through instro

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

with PymeasureInstrument(
    name="rod4",
    instrument=ROD4("ASRL1::INSTR"),
    dataset_rid="<dataset rid>",
) as rod4:

    print(rod4.device.version)             # Print version and series number
    rod4.device.ch_1.mfc_range = 500       # Sets Channel 1 MFC range to 500 sccm
    rod4.device.ch_2.valve_mode = 'flow'   # Sets Channel 2 MFC to flow control
    rod4.device.ch_3.setpoint = 50         # Sets Channel 3 MFC to flow at 50% of full range
    print(rod4.device.ch_4.actual_flow)    # Prints Channel 4 actual MFC flow in %
```

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

rod4 = ROD4("ASRL1::INSTR")
recorder = attach(rod4, "rod4", [NominalCorePublisher(dataset_rid="<dataset rid>")])

print(rod4.version)             # Print version and series number
rod4.ch_1.mfc_range = 500       # Sets Channel 1 MFC range to 500 sccm
rod4.ch_2.valve_mode = 'flow'   # Sets Channel 2 MFC to flow control
rod4.ch_3.setpoint = 50         # Sets Channel 3 MFC to flow at 50% of full range
print(rod4.ch_4.actual_flow)    # Prints Channel 4 actual MFC flow in %

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

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