| Name | opentrons JSON |
| Version |
8.1.0
JSON |
| download |
| home_page | None |
| Summary | The Opentrons API is a simple framework designed to make writing automated biology lab protocols easy. |
| upload_time | 2024-10-10 14:53:26 |
| maintainer | Opentrons |
| docs_url | None |
| author | Opentrons |
| requires_python | >=3.10 |
| license | Apache 2.0 |
| keywords |
robots
protocols
synbio
pcr
automation
lab
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
.. _Full API Documentation: http://docs.opentrons.com
The Opentrons API is a simple framework designed to make it easy to write automated biology lab protocols for Opentrons robots.
This package can be used to simulate protocols on your computer without connecting to a robot. Please refer to our `Full API Documentation`_ for detailed instructions on how to write and simulate your first protocol.
This package is now for use with the Opentrons Flex and Opentrons OT-2 only. For the software needed to run an Opentrons OT-One, please see versions_.
.. _simulating:
Simulating Protocols
--------------------
To simulate a protocol using this package, you can use the console script ``opentrons_simulate``, which is installed when this package is installed from pip. For detailed information on how to run the script, run ``opentrons_simulate --help``. In general, however, simulating a protocol is as simple as running ``opentrons_simulate.exe C:\path\to\protocol`` on Windows or ``opentrons_simulate /path/to/protocol`` on OSX or Linux.
The simulation script can also be invoked through python with ``python -m opentrons.simulate /path/to/protocol``.
This also provides an entrypoint to use the Opentrons simulation package from other Python contexts such as an interactive prompt or Jupyter. To simulate a protocol in python, open a file containing a protocol and pass it to ``opentrons.simulate.simulate``:
.. code-block:: python
import opentrons.simulate
protocol_file = open('/path/to/protocol.py')
opentrons.simulate.simulate(protocol_file)
The function will either run and return or raise an exception if there is a problem with the protocol.
.. _configuration:
Configuration
-------------
The module has a lot of configuration, some of which is only relevant when running on an actual robot, but some of which could be useful during simulation. When the module is first imported, it will try and write configuration files in ``~/.opentrons/config.json`` (``C:\Users\%USERNAME%\.opentrons\config.json`` on Windows). This contains mostly paths to other configuration files and directories, most of which will be in that folder. The location can be changed by setting the environment variable ``OT_API_CONFIG_DIR`` to another path. Inividual settings in the config file can be overridden by setting environment variables named like ``OT_API_${UPPERCASED_VAR_NAME}`` (for instance, to override the ``serial_log_file`` config element you could set the environment variable ``OT_API_SERIAL_LOG_FILE`` to a different path).
.. _versions:
Note On Versions
----------------
This API is for locally simulating protocols for the Flex or OT-2 without connecting to a robot. It no longer controls an OT-One.
`Version 2.5.2 <https://pypi.org/project/opentrons/2.5.2/>`_ was the final release of this API for the OT-One. If you want to download this API to use the OT-One, you should download it with
.. code-block:: shell
pip install opentrons==2.5.2
For APIs between 2.5.2 and 3.7.0, there is no PyPI package available. Those APIs should be installed by cloning this repo and following the instructions in `the Development Setup section of CONTRIBUTING.md <https://github.com/Opentrons/opentrons/blob/edge/CONTRIBUTING.md#development-setup>`_ and `the API readme <https://github.com/Opentrons/opentrons/blob/edge/api/README.rst>`_.
Raw data
{
"_id": null,
"home_page": null,
"name": "opentrons",
"maintainer": "Opentrons",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "engineering@opentrons.com",
"keywords": "robots, protocols, synbio, pcr, automation, lab",
"author": "Opentrons",
"author_email": "engineering@opentrons.com",
"download_url": "https://files.pythonhosted.org/packages/bd/4d/f21ecbc646b21dd8d2ce369691b5c3caa78d21c12e620f033974bd272df2/opentrons-8.1.0.tar.gz",
"platform": null,
"description": ".. _Full API Documentation: http://docs.opentrons.com\n\nThe Opentrons API is a simple framework designed to make it easy to write automated biology lab protocols for Opentrons robots.\n\nThis package can be used to simulate protocols on your computer without connecting to a robot. Please refer to our `Full API Documentation`_ for detailed instructions on how to write and simulate your first protocol.\n\nThis package is now for use with the Opentrons Flex and Opentrons OT-2 only. For the software needed to run an Opentrons OT-One, please see versions_.\n\n.. _simulating:\n\nSimulating Protocols\n--------------------\n\nTo simulate a protocol using this package, you can use the console script ``opentrons_simulate``, which is installed when this package is installed from pip. For detailed information on how to run the script, run ``opentrons_simulate --help``. In general, however, simulating a protocol is as simple as running ``opentrons_simulate.exe C:\\path\\to\\protocol`` on Windows or ``opentrons_simulate /path/to/protocol`` on OSX or Linux.\n\nThe simulation script can also be invoked through python with ``python -m opentrons.simulate /path/to/protocol``.\n\nThis also provides an entrypoint to use the Opentrons simulation package from other Python contexts such as an interactive prompt or Jupyter. To simulate a protocol in python, open a file containing a protocol and pass it to ``opentrons.simulate.simulate``:\n\n.. code-block:: python\n\n import opentrons.simulate\n protocol_file = open('/path/to/protocol.py')\n opentrons.simulate.simulate(protocol_file)\n\n\nThe function will either run and return or raise an exception if there is a problem with the protocol.\n\n\n.. _configuration:\n\nConfiguration\n-------------\n\nThe module has a lot of configuration, some of which is only relevant when running on an actual robot, but some of which could be useful during simulation. When the module is first imported, it will try and write configuration files in ``~/.opentrons/config.json`` (``C:\\Users\\%USERNAME%\\.opentrons\\config.json`` on Windows). This contains mostly paths to other configuration files and directories, most of which will be in that folder. The location can be changed by setting the environment variable ``OT_API_CONFIG_DIR`` to another path. Inividual settings in the config file can be overridden by setting environment variables named like ``OT_API_${UPPERCASED_VAR_NAME}`` (for instance, to override the ``serial_log_file`` config element you could set the environment variable ``OT_API_SERIAL_LOG_FILE`` to a different path).\n\n\n.. _versions:\n\nNote On Versions\n----------------\n\nThis API is for locally simulating protocols for the Flex or OT-2 without connecting to a robot. It no longer controls an OT-One.\n\n`Version 2.5.2 <https://pypi.org/project/opentrons/2.5.2/>`_ was the final release of this API for the OT-One. If you want to download this API to use the OT-One, you should download it with\n\n.. code-block:: shell\n\n pip install opentrons==2.5.2\n\nFor APIs between 2.5.2 and 3.7.0, there is no PyPI package available. Those APIs should be installed by cloning this repo and following the instructions in `the Development Setup section of CONTRIBUTING.md <https://github.com/Opentrons/opentrons/blob/edge/CONTRIBUTING.md#development-setup>`_ and `the API readme <https://github.com/Opentrons/opentrons/blob/edge/api/README.rst>`_.\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "The Opentrons API is a simple framework designed to make writing automated biology lab protocols easy.",
"version": "8.1.0",
"project_urls": {
"Documentation": "https://docs.opentrons.com",
"Source Code On Github": "https://github.com/Opentrons/opentrons/tree/edge/api",
"opentrons.com": "https://www.opentrons.com"
},
"split_keywords": [
"robots",
" protocols",
" synbio",
" pcr",
" automation",
" lab"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "24c44128249c58cc9aa3232f69ed7de7759ced202168ab95ad05360195f25fdf",
"md5": "ab5596b200e26f6f4c106c1e1c513093",
"sha256": "6053c997a90a06d70919c5c89bc337402da36f9a519d00428f8b1b62d4ca1e72"
},
"downloads": -1,
"filename": "opentrons-8.1.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "ab5596b200e26f6f4c106c1e1c513093",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.10",
"size": 1512112,
"upload_time": "2024-10-10T14:53:25",
"upload_time_iso_8601": "2024-10-10T14:53:25.189924Z",
"url": "https://files.pythonhosted.org/packages/24/c4/4128249c58cc9aa3232f69ed7de7759ced202168ab95ad05360195f25fdf/opentrons-8.1.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bd4df21ecbc646b21dd8d2ce369691b5c3caa78d21c12e620f033974bd272df2",
"md5": "fd0bc6dae5cce38961630ec3b843a516",
"sha256": "5c90b0a21d4ec3fe075f571baf20a7ec6ae18716876f86f65418cd4fb6a83872"
},
"downloads": -1,
"filename": "opentrons-8.1.0.tar.gz",
"has_sig": false,
"md5_digest": "fd0bc6dae5cce38961630ec3b843a516",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1280120,
"upload_time": "2024-10-10T14:53:26",
"upload_time_iso_8601": "2024-10-10T14:53:26.823076Z",
"url": "https://files.pythonhosted.org/packages/bd/4d/f21ecbc646b21dd8d2ce369691b5c3caa78d21c12e620f033974bd272df2/opentrons-8.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 14:53:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Opentrons",
"github_project": "opentrons",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "opentrons"
}
