{
    "info": {
        "author": "Lucas J. Koerner",
        "author_email": "koerner.lucas@stthomas.edu",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3"
        ],
        "description": "[![Build Status](https://travis-ci.com/lucask07/instrbuilder.svg?branch=master)](https://travis-ci.com/lucask07/instrbuilder)\n[![DOI](https://zenodo.org/badge/135353504.svg)](https://zenodo.org/badge/latestdoi/135353504)\n\n*instrbuilder* is an open-source Python package for control of electrical instruments. This package eases the development of high-level \"drivers\" to interface with oscilloscopes, power supplies, function generators, multimeters, or any instrument that uses ASCII textual string communication (such as SCPI). *instrbuilder* is particularly suited for prototying and automating experiments in research laboratory setups within an IPython terminal. Our goals are to accelerate the development of automated data collection and improve the reproducibility of laboratory experiments.\n\n## Documentation \n\nhttps://lucask07.github.io/instrbuilder/build/html/\n\n### Installation Steps\n\n1. Install a VISA driver (National Instruments provides free downloads). The PyVISA documentation page is an excellent resource to locate a VISA driver for your system: \n\n* [NI-VISA downloads](https://pyvisa.readthedocs.io/en/stable/getting_nivisa.html#getting-nivisa): links to downloads separated by OS.\n* [PyVISA backends](https://pyvisa.readthedocs.io/en/stable/getting.html#backend): an explanation of what is needed.\n\n2. Install *instrbuilder* using pip.\n\n```console\nusername$ python -m pip instrbuilder \n```\n\n### Getting Started \n\n1. Command lists for Keysight oscilloscopes, function generator, DMM; Rigol DC Power Supply (*commands.csv*) are included in the package at: [instrbuilder/instruments/](https://github.com/lucask07/instrbuilder/tree/master/instrbuilder/instruments).\n\nLocate the instrument command files using the following python commands:\n\n```python\nimport instrbuilder\ninit_file_loc = instrbuilder.__file__\ninstrument_cmds = init_file_loc.replace('__init__.py', 'instruments/')\nprint('Instrument commmands (csv files) are at: {}'.format(instrument_cmds))\n```\nNote that you can move the command csv files (and probably should). The location of these needs to be specified in the YAML configuration file.\n\n2. A YAML file is used to track your specific system configurations and instrument addresses (e.g. USB0::0x0957::0x0407::MY44060286::INSTR). Create your system YAML file using the steps below. This will be generated at *~/.instrbuilder/* (where *~* indicates your home directory). See the [example YAML](https://github.com/lucask07/instrbuilder/blob/master/instrbuilder/example_yaml/config.yaml) on GitHub.\n\n3. Try an example in the source code at [instrbuilder/examples/](https://github.com/lucask07/instrbuilder/tree/master/instrbuilder/examples). A Keysight and Rigol Oscilloscope is demonstrated in: [oscilloscope.py](https://github.com/lucask07/instrbuilder/blob/master/instrbuilder/examples/oscilloscope.py).\n\nLocate the example directory using the following python commands:\n\n```python\nimport instrbuilder\ninit_file_loc = instrbuilder.__file__\nexamples = init_file_loc.replace('__init__.py', 'examples/')\nprint('Examples are at: {}'.format(examples))\n```\n\n### Create Your YAML\n\n1. Initialize a YAML (specify the first parameter, the other 3 should always be default):\n\n```python \nfrom instrbuilder import instrument_opening\ninstrument_opening.init_yaml(csv_dir = 'where/your/commands_csv/files/are')\n```\n2. To **add instruments** to the YAML function use the script found in [instrbuilder/examples/add_instruments_to_config.py](https://github.com/lucask07/instrbuilder/blob/master/instrbuilder/examples/add_instruments_to_config.py). This will prompt the user for information. Note that it may be helpful to have only one instrument connected/powered at a time so that there is no ambiguity:\n\n3. An example YAML is available here [on GitHub](https://github.com/lucask07/instrbuilder/blob/master/instrbuilder/example_yaml/config.yaml).\n\n### Extra Installation Steps if Using the Bluesky Suite from NSLS-II\n1. If using the Bluesky suite uninstall ophyd and re-install from a git fork:\n\n```console\nusername$ python -m pip uninstall ophyd \nusername$ python -m pip install git+https://github.com/lucask07/ophyd@master#egg=ophyd\n```\n\nTo check if the correct *ophyd* fork was installed try:\n\n```python\nfrom ophyd.ee_instruments import generate_ophyd_obj\n```\nThis warning: \n\n```\nError:  <class 'ImportError'>\nIC (integrated circuit imports failed)\nThe aardvark.so or dll must be in the cwd or an importable path\nContinuing anyways, since many may not use this portion...\n```\nis **OK**. A module import error is not.\n\nA basic Bluesky demo is at [instrbuilder/bluesky_demo/fg_oscilloscope_basics.py](https://github.com/lucask07/instrbuilder/blob/master/instrbuilder/bluesky_demo/fg_oscilloscope_basics.py)\n\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://lucask07.github.io/instrbuilder/build/html/",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "instrbuilder",
        "package_url": "https://pypi.org/project/instrbuilder/",
        "platform": "",
        "project_url": "https://pypi.org/project/instrbuilder/",
        "project_urls": {
            "Homepage": "https://lucask07.github.io/instrbuilder/build/html/"
        },
        "release_url": "https://pypi.org/project/instrbuilder/0.1.9/",
        "requires_dist": [
            "tabulate",
            "scipy",
            "pandas",
            "setuptools",
            "numpy",
            "PyVISA",
            "oyaml",
            "sphinx-rtd-theme",
            "databroker",
            "colorama",
            "matplotlib",
            "bluesky",
            "pyserial",
            "wrapt",
            "PyYAML",
            "pytest"
        ],
        "requires_python": "",
        "summary": "electrical instrument control",
        "version": "0.1.9"
    },
    "last_serial": 5144978,
    "releases": {
        "0.0.12": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "600259dd9a732dcc7fa822be45b714a1",
                    "sha256": "6d6c899e90988798f9e31ecf8d9d7ae3934ebf0b713a7f882116ec64a5a7d334"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.0.12-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "600259dd9a732dcc7fa822be45b714a1",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 81371,
                "upload_time": "2019-01-04T18:13:33",
                "url": "https://files.pythonhosted.org/packages/bb/8c/fad7df4f4f4e723c356ca37d70686bd1a5bc2adb2677a418828844059dff/instrbuilder-0.0.12-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "311bc678ed7ab4e52056996f1afc1dc9",
                    "sha256": "d53a06cb98c6342ceaafe1d2e86a0753117fe862f52a07e0ab20ff5c79ea8c82"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.0.12.tar.gz",
                "has_sig": false,
                "md5_digest": "311bc678ed7ab4e52056996f1afc1dc9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 93470,
                "upload_time": "2019-01-04T18:13:35",
                "url": "https://files.pythonhosted.org/packages/0d/75/c3fcac9cabdd99f5c66261e2fa7e3c3452369fee9f72df57cb4f0b2c467f/instrbuilder-0.0.12.tar.gz"
            }
        ],
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "799ba735ec3e9984f45cd9a719caff0d",
                    "sha256": "f05be7a5766eac44c76b2b38cd5edace7e4f3ec121ab4ad1ab1d515273daed77"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "799ba735ec3e9984f45cd9a719caff0d",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 82155,
                "upload_time": "2019-01-06T04:12:53",
                "url": "https://files.pythonhosted.org/packages/f3/29/bae1be2d92dae1f9ae22d5d94536a556f5348dfdd09e39b314abff22abf3/instrbuilder-0.1.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "60134fe4d842424e23a65db26b071065",
                    "sha256": "e93521424f44dc92aed3cbd39c185066be781f273cb3c15f0b45336e2cca86f6"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "60134fe4d842424e23a65db26b071065",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 95183,
                "upload_time": "2019-01-06T04:12:54",
                "url": "https://files.pythonhosted.org/packages/0a/22/00298eac32b2a0ea099afda95d288a797897691a28c7dd40cfeb595cfa00/instrbuilder-0.1.0.tar.gz"
            }
        ],
        "0.1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e2097acd4808d62bca94c22532639131",
                    "sha256": "2c9a9aaa80a41512264de44e3f9c68dde34f56e18be5c2f68376451a346512ef"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e2097acd4808d62bca94c22532639131",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 111462,
                "upload_time": "2019-01-18T17:35:00",
                "url": "https://files.pythonhosted.org/packages/80/fc/778cc724798bfc8b1c0d76c1be7b90149f32a08632142749262f1abc2ef2/instrbuilder-0.1.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "3504a3604be15c6e25a8a203083ae477",
                    "sha256": "ec085c267e9e2dbaf7888a45e49bdcc55f7076b4f8b08ec718fa84eb7ebae8bc"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.5.tar.gz",
                "has_sig": false,
                "md5_digest": "3504a3604be15c6e25a8a203083ae477",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 108903,
                "upload_time": "2019-01-18T17:35:01",
                "url": "https://files.pythonhosted.org/packages/88/0d/2ff1d319d545d5bb9579fc4242d4459aea078c2967bd2f94d1aef2b66a83/instrbuilder-0.1.5.tar.gz"
            }
        ],
        "0.1.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ac1e3c127a40169fb31d2523e6bc77ca",
                    "sha256": "e907eea4c0301c4c287177702cdb03f481a1ad54f25ab6ee37c7272f5f87cad8"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.6-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ac1e3c127a40169fb31d2523e6bc77ca",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 115939,
                "upload_time": "2019-01-27T22:37:29",
                "url": "https://files.pythonhosted.org/packages/5c/06/f7f3cf6471ba7ef50305667b0fbb6fcf5403e93844e71b30511fcc8fc42a/instrbuilder-0.1.6-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "f4d0b967b3f50abfc15dc7aa9d7ed30b",
                    "sha256": "d55e447abc4aa0bc58ab03acc8c9e3123ef40e46ae117eb1a8ee8f13dab4f7d6"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.6.tar.gz",
                "has_sig": false,
                "md5_digest": "f4d0b967b3f50abfc15dc7aa9d7ed30b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 112647,
                "upload_time": "2019-01-27T22:37:31",
                "url": "https://files.pythonhosted.org/packages/95/3a/864de87d513a8b1cbb26bd1a566f5a379b22d10deaf838364beece9ec40f/instrbuilder-0.1.6.tar.gz"
            }
        ],
        "0.1.7": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "827d47f856bbbbd176c2a52a5853b914",
                    "sha256": "12c8a29070fd3521db3d5891a4d0002cbe855fd1e51b68558a1f77bd239e7f58"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.7-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "827d47f856bbbbd176c2a52a5853b914",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 116022,
                "upload_time": "2019-02-07T02:53:45",
                "url": "https://files.pythonhosted.org/packages/3b/11/861cd49efd637f45b6ab9a44207e3eb6c39e522a408eeac2db33570353a9/instrbuilder-0.1.7-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "e815127eb3d012883c94f9f6e87d29d3",
                    "sha256": "4fb9c053745c558f767c7817fa63ca2d3f33bbe165372d9651fc424ad8fd7a2f"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.7.tar.gz",
                "has_sig": false,
                "md5_digest": "e815127eb3d012883c94f9f6e87d29d3",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 112765,
                "upload_time": "2019-02-07T02:53:47",
                "url": "https://files.pythonhosted.org/packages/a0/06/28137be4c6fd24e69255904f585eecf6a7c9a499d4656b5bb5abc5fcc945/instrbuilder-0.1.7.tar.gz"
            }
        ],
        "0.1.8": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "96804a0238c5b08bd2ee5e7c8c4d385c",
                    "sha256": "92c70a788a142e08fc68563e04e6ccc2710cbabdfe4083cc14b194d273ae15ca"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.8-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "96804a0238c5b08bd2ee5e7c8c4d385c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 120083,
                "upload_time": "2019-03-07T20:48:32",
                "url": "https://files.pythonhosted.org/packages/d3/b0/417dc2fd6693f71ce17e04627af74d054f0c85c1422faa0107e9d2c8a0af/instrbuilder-0.1.8-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "0c70ab4fadea818a5c885381a0bca900",
                    "sha256": "1677b4ee05a215d3d85f692ce3b103cda370ecb1a126dd507782c120d427ebdb"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.8.tar.gz",
                "has_sig": false,
                "md5_digest": "0c70ab4fadea818a5c885381a0bca900",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 115047,
                "upload_time": "2019-03-07T20:48:34",
                "url": "https://files.pythonhosted.org/packages/13/32/1717f076572c66cdef2899d066cee1aa7d14d8a309da40d7df124eeafbfe/instrbuilder-0.1.8.tar.gz"
            }
        ],
        "0.1.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ba7fa2267189fe6e69709a41b63180e8",
                    "sha256": "655091fd6a4f769ca7fe037313c87b969db3ddac4a1bbaab9c1a9bfe8c862de6"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.9-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ba7fa2267189fe6e69709a41b63180e8",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 120055,
                "upload_time": "2019-04-15T14:10:31",
                "url": "https://files.pythonhosted.org/packages/4f/aa/a00281d655db2da3daf50a34032e7d932ffb39140ab4def133e904e4bc00/instrbuilder-0.1.9-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "87bfbad0a56d758ad76d26e62f8696ee",
                    "sha256": "6b3f24b8ab830945fd96c8d1451abf58df99a52da3e4c24b84e5e912dc7b3193"
                },
                "downloads": -1,
                "filename": "instrbuilder-0.1.9.tar.gz",
                "has_sig": false,
                "md5_digest": "87bfbad0a56d758ad76d26e62f8696ee",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 115371,
                "upload_time": "2019-04-15T14:10:32",
                "url": "https://files.pythonhosted.org/packages/fa/ab/231d4ac353230ef926d4f7c97272438e24f878512b23be6d1f8350847905/instrbuilder-0.1.9.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "ba7fa2267189fe6e69709a41b63180e8",
                "sha256": "655091fd6a4f769ca7fe037313c87b969db3ddac4a1bbaab9c1a9bfe8c862de6"
            },
            "downloads": -1,
            "filename": "instrbuilder-0.1.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ba7fa2267189fe6e69709a41b63180e8",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 120055,
            "upload_time": "2019-04-15T14:10:31",
            "url": "https://files.pythonhosted.org/packages/4f/aa/a00281d655db2da3daf50a34032e7d932ffb39140ab4def133e904e4bc00/instrbuilder-0.1.9-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "87bfbad0a56d758ad76d26e62f8696ee",
                "sha256": "6b3f24b8ab830945fd96c8d1451abf58df99a52da3e4c24b84e5e912dc7b3193"
            },
            "downloads": -1,
            "filename": "instrbuilder-0.1.9.tar.gz",
            "has_sig": false,
            "md5_digest": "87bfbad0a56d758ad76d26e62f8696ee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 115371,
            "upload_time": "2019-04-15T14:10:32",
            "url": "https://files.pythonhosted.org/packages/fa/ab/231d4ac353230ef926d4f7c97272438e24f878512b23be6d1f8350847905/instrbuilder-0.1.9.tar.gz"
        }
    ]
}