# Agilent 4156

Control the Agilent 4156 multimeter from Python with the `Agilent4156` 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)

Represents the Agilent 4155/4156 Semiconductor Parameter Analyzer and provides a high-level interface for taking current-voltage (I-V) measurements.

## Publishing through instro

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

# explicitly define r/w terminations; set sufficiently large timeout or None.
with PymeasureInstrument(
    name="smu",
    instrument=Agilent4156('GPIB0::25', read_termination='\n', write_termination='\n', timeout=None),
    dataset_rid="<dataset rid>",
) as smu:

    # reset the instrument
    smu.device.reset()

    # define configuration file for instrument and load config
    smu.device.configure("configuration_file.json")

    # save data variables, some or all of which are defined in the json config file.
    smu.device.save(['VC', 'IC', 'VB', 'IB'])

    # take measurements
    status = smu.device.measure()

    # measured data is a pandas dataframe and can be exported to csv.
    data = smu.device.get_data(path='./t1.csv')
```

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

# explicitly define r/w terminations; set sufficiently large timeout or None.
smu = Agilent4156("GPIB0::25", read_termination = '\n', write_termination = '\n',
                  timeout=None)
recorder = attach(smu, "smu", [NominalCorePublisher(dataset_rid="<dataset rid>")])

# reset the instrument
smu.reset()

# define configuration file for instrument and load config
smu.configure("configuration_file.json")

# save data variables, some or all of which are defined in the json config file.
smu.save(['VC', 'IC', 'VB', 'IB'])

# take measurements
status = smu.measure()

# measured data is a pandas dataframe and can be exported to csv.
data = smu.get_data(path='./t1.csv')

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

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