Metadata-Version: 2.1
Name: labbench
Version: 0.20
Summary: scripting tools for streamlined laboratory automation
Home-page: https://github.com/usnistgov/labbench
Author: Dan Kuester, Shane Allman, Paul Blanchard, Yao Ma
Author-email: daniel.kuester@nist.gov
License: NIST
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: pandas (>=0.20)
Requires-Dist: pyserial (>=3.0)
Requires-Dist: pyvisa (>=1.8)
Requires-Dist: coloredlogs (>=7.0)
Requires-Dist: future
Requires-Dist: numpy (>=1.0)
Requires-Dist: scipy (>=0.9)
Requires-Dist: sortedcontainers (>=1.4)
Requires-Dist: psutil (>=5.0)
Requires-Dist: sqlalchemy
Requires-Dist: GitPython (>=2.0)
Requires-Dist: pyarrow
Requires-Dist: traitlets (>=4)
Provides-Extra: html
Requires-Dist: sphinx (>=1.6) ; extra == 'html'
Requires-Dist: recommonmark ; extra == 'html'
Provides-Extra: notebook
Requires-Dist: notebook ; extra == 'notebook'
Requires-Dist: ipywidgets ; extra == 'notebook'

The `labbench` module provides tools for instrument automation and data management in scripted lab experiments.

A device driver implemented with labbench is a light wrapper around another instrument control library.
This means another library (like pyvisa, pyserial, libtelnet, or even a C or .NET DLL) provides low-level routines. The labbench
abstraction provides several benefits:

* automatic acquisition logging into an SQLite database,
* automatically-generated jupyter notebook monitoring widgets,
* interact with settings and data on remote devices with native python data types (instead of strings),
* python exceptions on invalid device state settings (instead of silent failure),
* drivers provide consistent style and API conventions for easy scripting (hello, tab completion!),
* ensure devices disconnect properly when acquisition completes (even on exceptions), and
* conversion of vector or tabular data to [pandas](pandas.pydata.org) Series or DataFrame objects for rapid exploration of data.

Together, these features help to minimize the amount of "copy-and-paste" code that can make your lab automation scripts error-prone and difficult to maintain.
The python code that results can be clear, concise, reusable and maintainable, and
provide consistent formatting for stored data.
The result helps researchers to meet NIST's
[open data](https://www.nist.gov/open) obligations, even for complicated, large,
and heterogeneous datasets.


