معرفی شرکت ها
evasdk-5.0.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
SDK for the Automata Eva robotic arm
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | evasdk-5.0.1 |
| نام | evasdk |
| نسخه کتابخانه | 5.0.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Automata |
| ایمیل نویسنده | louis@automata.tech |
| آدرس صفحه اصلی | https://github.com/automata-tech/eva_python_sdk |
| آدرس اینترنتی | https://pypi.org/project/evasdk/ |
| مجوز | Apache License 2.0 |
# Eva Python SDK
[](https://badge.fury.io/py/evasdk)  [](https://codecov.io/gh/automata-tech/eva_python_sdk)
The Eva Python SDK provides convenient access to the Automata Eva API from applications written in Python 3. Documentation is available [here](https://eva-python-sdk.readthedocs.io/en/docs-development/).
__* This SDK is currently in beta__
- [Eva Python SDK](#eva-python-sdk)
- [Installation](#installation)
- [Pip](#pip)
- [Pipenv](#pipenv)
- [Detail Instructions](#detail-instructions)
- [Examples](#examples)
- [Eva](#eva)
- [evasdk.eva_http and evasdk.eva_ws](#evasdkeva_http-and-evasdkeva_ws)
- [Versioning](#versioning)
- [Logging](#logging)
- [Bugs and feature requests](#bugs-and-feature-requests)
- [Testing](#testing)
- [Documentation](#documentation)
- [License](#license)
## Installation
__Requires Python 3, not compatible with Python 2__
We support Python `3.6` and later.
### Pip
Make sure you have Python3 and pip installed, then run the following command:
```bash
$ pip install evasdk
# Or for a specific version, i.e the lastest compatible version 2.x.x:
$ pip install evasdk~=2.0.0
```
### Pipenv
Make sure you have Python3 and Pipenv installed, then run the following command:
```bash
$ pipenv install evasdk
# Or for a specific version, i.e the lastest compatible version 2.x.x:
$ pipenv install evasdk~=2.0.0
```
### Detail Instructions
If your not familiar with Python or for more detailed instructions please refer to our wiki:
- [Windows installation instructions](https://github.com/automata-tech/eva_python_sdk/wiki/Windows-Installation)
- [Mac installation instructions](https://github.com/automata-tech/eva_python_sdk/wiki/Mac-Installation)
## Examples
The following section provides some getting started example code, for more detailed examples please go to our [eva_examples repository](https://github.com/automata-tech/eva_examples).
### Eva
The Eva object allows you to directly control an Eva robot. It provides lots of useful helper function for interacting with the robot.
**Connecting**
```python
host = '<your_eva_IP_here>'
token = '<your_token_here>'
eva = Eva(host, token)
```
**GoTo movement**
```python
eva = Eva(host_ip, token)
with eva.lock():
eva.control_wait_for_ready()
eva.control_go_to([0, 0, 0, 0, 0, 0], mode='teach')
```
**Toolpath create and run**
```python
toolpath = {
"metadata": {
"version": 2,
"default_max_speed": 0.25,
"payload": 0,
"analog_modes": {
"i0": "voltage",
"i1": "voltage",
"o0": "voltage",
"o1": "voltage"
},
"next_label_id": 3
},
"waypoints": [{
"label_id": 1,
"joints": [0, 0.5235987755982988, -1.7453292519943295, 0, -1.9198621771937625, 0]
}, {
"label_id": 2,
"joints": [0.18392622441053394, 0.8259819316864014, -2.050006151199341, 0.1785774528980255, -1.6037521743774412, -0.549331545829773]
}],
"timeline": [{
"type": "home",
"waypoint_id": 0
}, {
"type": "trajectory",
"trajectory": "joint_space",
"waypoint_id": 1
}, {
"type": "trajectory",
"trajectory": "joint_space",
"waypoint_id": 0
}]
}
eva = Eva(host, token)
with eva.lock():
eva.control_wait_for_ready()
eva.toolpaths_use(toolpath)
eva.control_home()
eva.control_run(loop=1, mode='teach')
```
Please refer to the examples directory for more SDK usage examples.
### evasdk.eva_http and evasdk.eva_ws
These can be used to interact directly with the HTTP and Websocket APIs. Useful when you don't want the managed websocket connection provided by the evasdk.Eva object.
## Versioning
To determine which version of the SDK works with your Eva's software version number (found on the Choreograph config page), please reference the following table:
| SDK Version | Supported Eva Version |
| --------------- | --------------------- |
| 1.0.0 | 2.0.0 - 2.1.2 |
| 2.0.0 | 3.0.0 - 3.0.1 |
| 3.0.0 and later | 3.1.0 and later |
For more information on how to install a particular version of the SDK, please refer to the [Installation](#Installation) section. We use the [Semver](https://semver.org/) version numbering stratergy.
## Logging
The SDK uses Debug and Error level logging exclusively. Each Eva instance will log using the name `evasdk.Eva:<host_name_here>`. If you wish to enable the debug logging:
```python
logging.basicConfig(level=logging.DEBUG)
```
## Bugs and feature requests
Please raise any bugs or feature requests as a Github issues. We also gratefully accept pull requests for features and bug fixes.
## Testing
```bash
# to run all test files in tests directory:
$ pipenv run test
# or to run a single test file:
$ pipenv shell
$ pipenv run testd tests/<test-name>_test.py
# some test require testing against a real robot. Therefore you will be required to supply a ip and token via the `--ip` and `--token` arguments as well as pass the --runrobot flag to notify pytest that you wish to run the robot tests:
$ pipenv run test --runrobot --ip 172.16.16.2 --token abc-123-def-456
# Tests requiring the robot or long amounts of time will not run by default,
# these require flags to be enabled, a full list of flags is available with the help flag:
$ pipenv run test -h
```
## Documentation
Find the documentation [here](https://eva-python-sdk.readthedocs.io/en/docs-development/).
We are using [Sphinx](https://github.com/sphinx-doc/sphinx) to generate documentation, and the documentation is deployed with [Read The Docs](https://github.com/readthedocs/readthedocs.org).
We have added a few extensions to Sphinx
- **sphinx.ext.autodoc** to automatically generate package documentation based off of Python docstrings.
- **m2r2** to convert rST to MD, this is so we can include `README.md` to the online docs.
We have a *GitHub Action* in the `build.yaml` workflow that will do this automatically update the documentation and commit the documentation changes on pushing a branch to GitHub. For this we are using [EndBug/add-and-commit](https://github.com/EndBug/add-and-commit).
*Read The Docs* has [automation rules](https://docs.readthedocs.io/en/stable/automation-rules.html).
We have one set up that will automatically build documentation for any semver tagged version of the project.
We need to pass the force flag `-f` to overwrite `modules.rst`, as otherwise Sphinx will skip over searching the `evasdk` directory.
To generate a local version of the documentation:
```bash
cd docs
make html
```
Then open the file `docs/_build/html/index.html` in your browser.
## License
This code is free to use under the terms of the Apache 2 license. Please refer to LICENSE for more information.
نیازمندی
| مقدار | نام |
|---|---|
| - | requests |
| - | websocket-client |
| - | zeroconf |
| - | dataclasses |
| - | semver |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl evasdk-5.0.1:
pip install evasdk-5.0.1.whl
نصب پکیج tar.gz evasdk-5.0.1:
pip install evasdk-5.0.1.tar.gz