# Tactigon Gear
This package enables the wearable device Tactigon Skin to connect to your python project using Bluetooth Low Energy.
## Architecture
Tactigon Gear environment has the following architecture:
Server is located on the cloud and it is manteined by Next Industries s.r.l.
Server has a web interface where you can handle your profile and your data (models and gestures)
Provided Tactigon Gear SDK is the implementation of Tactigon Gear environment client side
Tactigon Gear SDK is used for collecting new raw data, send the data to server,
ask server to train a model using the raw data, and download the model from server.
Finally use the model for testing real-time gesture recognition.
## Prerequisites
In order to use the Tactigon Gear SDK the following prerequisites needs to be observed:
* Python version: following versions has been used and tested. It is STRONGLY recommended to use these ones depending on platform.
* Win10: 3.8.7
* Linux: 3.8.5
* Mac osx: 3.8.10
* Raspberry: 3.7.3
## Installing
Install and update using pip:
`pip install tactigon-gear`
## A Simple Example
```python
import time
from tactigon_gear import TSkin, TSkinConfig, Hand, OneFingerGesture
def main():
TSKIN_MAC = "change-me"
tskin_cfg = TSkinConfig(TSKIN_MAC, Hand.RIGHT) # Hand.LEFT if the TSkin is wear on left hand.
tskin = TSkin(tskin_cfg)
tskin.start()
i = 0
while True:
if not tskin.connected:
print("Connecting..")
time.sleep(0.5)
continue
if i > 5:
break
a = tskin.angle
t = tskin.touch
acc = tskin.acceleration
gyro = tskin.gyro
print(a, t, acc, gyro)
if t and t.one_finger == OneFingerGesture.TAP_AND_HOLD:
i += 1
else:
i = 0
time.sleep(0.02)
tskin.terminate()
if __name__ == "__main__":
main()
```
## Licensing
In order to perform new training and download them you need to register on following web side:
`https://www.thetactigon.com/ai/web/`
Once registration is done you can go to Profile section and click on `Json File` button to download file user_data.json
The use of this file is described later in this doc.
## Links
- [Documentation](https://github.com/TactigonTeam/Tactigon-SDK/wiki)
- [Blog](https://www.thetactigon.com/blog/)
- [Quickstart](https://www.thetactigon.com/tactigon-skin-quick-start-guide/)
- [SDK](https://github.com/TactigonTeam/Tactigon-SDK)
Raw data
{
"_id": null,
"home_page": "https://www.thetactigon.com",
"name": "tactigon-gear",
"maintainer": "Next Industries s.r.l.",
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": "info@thetactigon.com",
"keywords": "tactigon, wereable, gestures controller, human interface",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/16/34/2be1a15e1527301b783c2d34c41e7a2b6912685750f3412b41fb814264b5/tactigon_gear-5.0.4.post1.tar.gz",
"platform": null,
"description": "# Tactigon Gear\r\n\r\n\r\n\r\nThis package enables the wearable device Tactigon Skin to connect to your python project using Bluetooth Low Energy.\r\n\r\n## Architecture\r\n\r\nTactigon Gear environment has the following architecture:\r\n\r\nServer is located on the cloud and it is manteined by Next Industries s.r.l.\r\nServer has a web interface where you can handle your profile and your data (models and gestures)\r\n\r\nProvided Tactigon Gear SDK is the implementation of Tactigon Gear environment client side\r\n\r\nTactigon Gear SDK is used for collecting new raw data, send the data to server,\r\nask server to train a model using the raw data, and download the model from server. \r\nFinally use the model for testing real-time gesture recognition.\r\n\r\n![Tactigon Gear architecture definition](https://www.thetactigon.com/wp/wp-content/uploads/2023/11/Architecture_Tactigon_Gear.png \"Tactigon Gear architecture definition\") \r\n\r\n## Prerequisites\r\nIn order to use the Tactigon Gear SDK the following prerequisites needs to be observed:\r\n\r\n* Python version: following versions has been used and tested. It is STRONGLY recommended to use these ones depending on platform.\r\n * Win10: 3.8.7\r\n * Linux: 3.8.5\r\n * Mac osx: 3.8.10\r\n * Raspberry: 3.7.3\r\n\r\n## Installing\r\n\r\nInstall and update using pip:\r\n\r\n`pip install tactigon-gear`\r\n\r\n## A Simple Example\r\n\r\n```python\r\n\r\nimport time\r\nfrom tactigon_gear import TSkin, TSkinConfig, Hand, OneFingerGesture\r\n\r\ndef main():\r\n TSKIN_MAC = \"change-me\"\r\n tskin_cfg = TSkinConfig(TSKIN_MAC, Hand.RIGHT) # Hand.LEFT if the TSkin is wear on left hand.\r\n\r\n tskin = TSkin(tskin_cfg)\r\n tskin.start()\r\n\r\n i = 0\r\n\r\n while True:\r\n if not tskin.connected:\r\n print(\"Connecting..\")\r\n time.sleep(0.5)\r\n continue\r\n\r\n if i > 5:\r\n break\r\n\r\n a = tskin.angle\r\n t = tskin.touch\r\n acc = tskin.acceleration\r\n gyro = tskin.gyro\r\n\r\n print(a, t, acc, gyro)\r\n\r\n if t and t.one_finger == OneFingerGesture.TAP_AND_HOLD:\r\n i += 1\r\n else:\r\n i = 0\r\n\r\n time.sleep(0.02)\r\n\r\n tskin.terminate()\r\n\r\n \r\nif __name__ == \"__main__\":\r\n main()\r\n```\r\n\r\n## Licensing\r\n\r\nIn order to perform new training and download them you need to register on following web side:\r\n`https://www.thetactigon.com/ai/web/`\r\nOnce registration is done you can go to Profile section and click on `Json File` button to download file user_data.json\r\nThe use of this file is described later in this doc.\r\n\r\n## Links\r\n- [Documentation](https://github.com/TactigonTeam/Tactigon-SDK/wiki)\r\n- [Blog](https://www.thetactigon.com/blog/)\r\n- [Quickstart](https://www.thetactigon.com/tactigon-skin-quick-start-guide/)\r\n- [SDK](https://github.com/TactigonTeam/Tactigon-SDK)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tactigon Gear to connect to Tactigon Skin wereable platform",
"version": "5.0.4.post1",
"project_urls": {
"Homepage": "https://www.thetactigon.com"
},
"split_keywords": [
"tactigon",
" wereable",
" gestures controller",
" human interface"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "16342be1a15e1527301b783c2d34c41e7a2b6912685750f3412b41fb814264b5",
"md5": "290ce5cdc393f28b6d87e8bc485d28db",
"sha256": "d08e59ea2fe0955e37a26f42a1236fa6e01bebf85a7b2e41c86bb7be1eafd90b"
},
"downloads": -1,
"filename": "tactigon_gear-5.0.4.post1.tar.gz",
"has_sig": false,
"md5_digest": "290ce5cdc393f28b6d87e8bc485d28db",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 374124,
"upload_time": "2024-04-16T08:44:48",
"upload_time_iso_8601": "2024-04-16T08:44:48.822868Z",
"url": "https://files.pythonhosted.org/packages/16/34/2be1a15e1527301b783c2d34c41e7a2b6912685750f3412b41fb814264b5/tactigon_gear-5.0.4.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-16 08:44:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tactigon-gear"
}
JSON