| Name | tellox JSON |
| Version |
0.2.7
JSON |
| download |
| home_page | |
| Summary | The easy way to control a DJI Tello drone. |
| upload_time | 2023-09-20 13:10:28 |
| maintainer | |
| docs_url | None |
| author | Charles Dawson |
| requires_python | >=3.9,<3.13 |
| license | MIT |
| keywords |
tello
drone
dji
robotics
control
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Tello-X 🚁
> The easy way to control a DJI Tello drone from Python.
[](https://github.com/dawsonc/tello-x/releases/)
[](#license)
[](https://badge.fury.io/py/tellox)
## Features
- Easily pilot the Tello drone by sending commands and reading sensor data.
- Built-in support for [AprilTag](https://github.com/pupil-labs/apriltags) detection.
- Built-in data logging
## Installation
We recommen installing `tellox` in a virtual environment:
```
# Create a virtual environment for your project
cd path/to/your/project
python -m venv venv
# Activate the virtual environment (you'll need to do this whenever you start a new shell)
source venv/bin/activate # or just `venv/Scripts/activate` in Windows PowerShell
# Install this library
pip install tellox
```
That's it! Connect to your Tello over WiFi and try some of the [examples](https://github.com/dawsonc/tello-x/tree/master/scripts).
For a minimal example:
```
import time
import tellox as tx
pilot = tx.Pilot()
pilot.takeoff()
pilot.land()
```
## A note on coordinate frames
The Tello's body frame is defined North-East-Down (a standard for aircraft), so `x` points forward (out of the camera), `y` points to the right of the drone, and `z` points down.
The camera frame is defined with `z` pointing out of the camera and `x` pointing to the right of the drone. If you use `pilot.detect_tags` to get the relative pose of AprilTags in the drone's view, then the returned translation `pose_t` and rotation `pose_R` are defined *relative to the camera frame*. To convert the tag position to the drone body frame, use `pilot.convert_to_drone_frame`.
## License
Released under the [MIT License](/LICENSE) by [Charles Dawson](https://github.com/dawsonc).
## Contributing
If you find a bug or would like to contribute a feature, that's awesome! Please file an [issue](https://github.com/dawsonc/tello-x/issues) and open a [pull request](https://github.com/dawsonc/tello-x/pulls). More details on contribution can be found in the [`CONTRIBUTING.md`](https://github.com/dawsonc/tello-x/blob/master/CONTRIBUTING.md) file.
Raw data
{
"_id": null,
"home_page": "",
"name": "tellox",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<3.13",
"maintainer_email": "",
"keywords": "tello,drone,dji,robotics,control",
"author": "Charles Dawson",
"author_email": "charles.dwsn@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b4/65/a0ea9486938d2ab48705e31ccc36cd2ce12ca5055d5836e7f0c6d7abce1b/tellox-0.2.7.tar.gz",
"platform": null,
"description": "# Tello-X \ud83d\ude81\n> The easy way to control a DJI Tello drone from Python.\n\n[](https://github.com/dawsonc/tello-x/releases/)\n[](#license)\n[](https://badge.fury.io/py/tellox)\n\n## Features\n\n- Easily pilot the Tello drone by sending commands and reading sensor data.\n- Built-in support for [AprilTag](https://github.com/pupil-labs/apriltags) detection.\n- Built-in data logging\n\n## Installation\n\nWe recommen installing `tellox` in a virtual environment:\n```\n# Create a virtual environment for your project\ncd path/to/your/project\npython -m venv venv\n\n# Activate the virtual environment (you'll need to do this whenever you start a new shell)\nsource venv/bin/activate # or just `venv/Scripts/activate` in Windows PowerShell\n\n# Install this library\npip install tellox\n```\n\nThat's it! Connect to your Tello over WiFi and try some of the [examples](https://github.com/dawsonc/tello-x/tree/master/scripts).\n\nFor a minimal example:\n```\nimport time\nimport tellox as tx\n\npilot = tx.Pilot()\npilot.takeoff()\npilot.land()\n```\n\n## A note on coordinate frames\n\nThe Tello's body frame is defined North-East-Down (a standard for aircraft), so `x` points forward (out of the camera), `y` points to the right of the drone, and `z` points down.\nThe camera frame is defined with `z` pointing out of the camera and `x` pointing to the right of the drone. If you use `pilot.detect_tags` to get the relative pose of AprilTags in the drone's view, then the returned translation `pose_t` and rotation `pose_R` are defined *relative to the camera frame*. To convert the tag position to the drone body frame, use `pilot.convert_to_drone_frame`.\n\n## License\n\nReleased under the [MIT License](/LICENSE) by [Charles Dawson](https://github.com/dawsonc).\n\n## Contributing\n\nIf you find a bug or would like to contribute a feature, that's awesome! Please file an [issue](https://github.com/dawsonc/tello-x/issues) and open a [pull request](https://github.com/dawsonc/tello-x/pulls). More details on contribution can be found in the [`CONTRIBUTING.md`](https://github.com/dawsonc/tello-x/blob/master/CONTRIBUTING.md) file.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The easy way to control a DJI Tello drone.",
"version": "0.2.7",
"project_urls": null,
"split_keywords": [
"tello",
"drone",
"dji",
"robotics",
"control"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "470d0549e5655834d5eda9aae132dd81a02ed80db634892845ac76720519d572",
"md5": "d3bdd738ffe22a62648875d68ed5e897",
"sha256": "22e3334cd1bf320a8d6c8289bbe1e714f489697977720fa46d43f3f43a80a414"
},
"downloads": -1,
"filename": "tellox-0.2.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d3bdd738ffe22a62648875d68ed5e897",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<3.13",
"size": 8037,
"upload_time": "2023-09-20T13:10:26",
"upload_time_iso_8601": "2023-09-20T13:10:26.958855Z",
"url": "https://files.pythonhosted.org/packages/47/0d/0549e5655834d5eda9aae132dd81a02ed80db634892845ac76720519d572/tellox-0.2.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b465a0ea9486938d2ab48705e31ccc36cd2ce12ca5055d5836e7f0c6d7abce1b",
"md5": "4cd4d2f4fb13860506cd40bcacbb4060",
"sha256": "dc0af10dad26ada282f2b8d945d087fc3fd8ff5970de993b0d8a7121660db56d"
},
"downloads": -1,
"filename": "tellox-0.2.7.tar.gz",
"has_sig": false,
"md5_digest": "4cd4d2f4fb13860506cd40bcacbb4060",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<3.13",
"size": 7327,
"upload_time": "2023-09-20T13:10:28",
"upload_time_iso_8601": "2023-09-20T13:10:28.173383Z",
"url": "https://files.pythonhosted.org/packages/b4/65/a0ea9486938d2ab48705e31ccc36cd2ce12ca5055d5836e7f0c6d7abce1b/tellox-0.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-20 13:10:28",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tellox"
}
