# HP 34401A

Control the HP 34401A multimeter from Python with the `HP34401A` driver.

**Driver:** [pymeasure](https://pymeasure.readthedocs.io)  
**Type:** [Multimeters and source meters](https://dev.nominal.io/instro/instruments/type/dmm.md)  
**Manufacturer:** [HP](https://dev.nominal.io/instro/instruments/manufacturer/hp.md)

Represents the HP / Agilent / Keysight 34401A Multimeter and provides a high-level interface for interacting with the instrument.

## Publishing through instro

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

with PymeasureInstrument(
    name="dmm",
    instrument=HP34401A("GPIB::1"),
    dataset_rid="<dataset rid>",
) as dmm:
    dmm.device.function_ = "DCV"
    print(dmm.device.reading)  # -> Single float reading

    dmm.device.nplc = 0.02
    dmm.device.autozero_enabled = False
    dmm.device.trigger_count = 100
    dmm.device.trigger_delay = "MIN"
    print(dmm.device.reading)  # -> Array of 100 very fast readings
```

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

dmm = HP34401A("GPIB::1")
recorder = attach(dmm, "dmm", [NominalCorePublisher(dataset_rid="<dataset rid>")])
dmm.function_ = "DCV"
print(dmm.reading)  # -> Single float reading

dmm.nplc = 0.02
dmm.autozero_enabled = False
dmm.trigger_count = 100
dmm.trigger_delay = "MIN"
print(dmm.reading)  # -> Array of 100 very fast readings

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

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