# Keithley 6517B

Control the Keithley 6517B multimeter from Python with the `Keithley6517B` driver.

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

Represents the Keithley 6517B ElectroMeter and provides a high-level interface for interacting with the instrument.

## Publishing through instro

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

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

    keithley.device.apply_voltage()              # Sets up to source current
    keithley.device.source_voltage_range = 200   # Sets the source voltage
                                          # range to 200 V
    keithley.device.source_voltage = 20          # Sets the source voltage to 20 V
    keithley.device.enable_source()              # Enables the source output

    keithley.device.measure_resistance()         # Sets up to measure resistance

    keithley.device.ramp_to_voltage(50)          # Ramps the voltage to 50 V
    print(keithley.device.resistance)            # Prints the resistance in Ohms

    keithley.device.shutdown()                   # Ramps the voltage to 0 V
                                          # 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.keithley import Keithley6517B
from instro.lib import NominalCorePublisher
from instro.pymeasure import attach

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

keithley.apply_voltage()              # Sets up to source current
keithley.source_voltage_range = 200   # Sets the source voltage
                                      # range to 200 V
keithley.source_voltage = 20          # Sets the source voltage to 20 V
keithley.enable_source()              # Enables the source output

keithley.measure_resistance()         # Sets up to measure resistance

keithley.ramp_to_voltage(50)          # Ramps the voltage to 50 V
print(keithley.resistance)            # Prints the resistance in Ohms

keithley.shutdown()                   # Ramps the voltage to 0 V
                                      # and disables output

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

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