# Agilent B2983

Control the Agilent B2983 multimeter from Python with the `AgilentB2983` driver.

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

A class representing the Agilent/Keysight B2983A/B.

## Publishing through instro

instro publishes the commands you send to a AgilentB2983 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.agilent import AgilentB2983

from instro.pymeasure import PymeasureInstrument

with PymeasureInstrument(
    name="agilentb2983",
    instrument=AgilentB2983("<visa_resource>"),
    dataset_rid="<dataset rid>",
) as instrument:
    print(instrument.device.battery_cycles)
```

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

agilentb2983 = AgilentB2983("<visa_resource>")
recorder = attach(agilentb2983, "agilentb2983", [NominalCorePublisher(dataset_rid="<dataset rid>")])
print(agilentb2983.battery_cycles)
recorder.close()  # flush and close the publishers
```

For the full list of properties and methods, see the [pymeasure documentation for `AgilentB2983`](https://pymeasure.readthedocs.io/en/latest/api/instruments/agilent/agilentB298x.html#pymeasure.instruments.agilent.agilentB298x.AgilentB2983).
