tactigon-gear


Nametactigon-gear JSON
Version 5.1.0 PyPI version JSON
download
home_pagehttps://www.thetactigon.com
SummaryTactigon Gear to connect to Tactigon Skin wereable platform
upload_time2024-09-25 08:51:44
maintainerNext Industries s.r.l.
docs_urlNone
authorNone
requires_python>=3.8.0
licenseMIT
keywords tactigon wereable gestures controller human interface
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Tactigon Gear

![The tactigon team](https://avatars.githubusercontent.com/u/63020285?s=200&v=4)

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.

![Tactigon Gear architecture definition](https://www.thetactigon.com/wp/wp-content/uploads/2023/11/Architecture_Tactigon_Gear.png "Tactigon Gear architecture definition")  

## 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/3c/63/ccabd3447bf856d9893e95bc6bf67c1ffcd8c9f9b793efefbc0879026175/tactigon_gear-5.1.0.tar.gz",
    "platform": null,
    "description": "# Tactigon Gear\r\n\r\n![The tactigon team](https://avatars.githubusercontent.com/u/63020285?s=200&v=4)\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.1.0",
    "project_urls": {
        "Homepage": "https://www.thetactigon.com"
    },
    "split_keywords": [
        "tactigon",
        " wereable",
        " gestures controller",
        " human interface"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3c63ccabd3447bf856d9893e95bc6bf67c1ffcd8c9f9b793efefbc0879026175",
                "md5": "2ee762c8df4e36a6ee772dabdd4653c4",
                "sha256": "a0e4b75242158418ee7412acb37b88cf549615dd8ca0ef989659f974599a6af3"
            },
            "downloads": -1,
            "filename": "tactigon_gear-5.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2ee762c8df4e36a6ee772dabdd4653c4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8.0",
            "size": 372579,
            "upload_time": "2024-09-25T08:51:44",
            "upload_time_iso_8601": "2024-09-25T08:51:44.244783Z",
            "url": "https://files.pythonhosted.org/packages/3c/63/ccabd3447bf856d9893e95bc6bf67c1ffcd8c9f9b793efefbc0879026175/tactigon_gear-5.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-25 08:51:44",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "tactigon-gear"
}
        
Elapsed time: 0.86864s