Name | nexgraphpy JSON |
Version |
2.0.0
JSON |
| download |
home_page | None |
Summary | Python library for connecting with Nextech force gauges over USB Serial |
upload_time | 2025-07-10 04:39:35 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.10 |
license | None |
keywords |
force
gauge
nexgraph
nextech
torque
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
<h1 align="center">
<img src="https://python.nexgraphapp.com/assets/images/nexgraph-logo-wide.png">
</h1><br />
# Nexgraph Python
## Description:
NexGraph Python is a Python library implementation of the [NexGraph](https://nexgraphapp.com) software which works with Nextech brand DFT and DFS force gauges. It connects to the force gauge over USB serial and enables you to operate your device using Python. Download data from your devices, execute commands, and read data. Device Memory data can be output in CSV format or a bar chart.
## Requirements:
Tested on Python versions 3.10+
## Installation:
`pip install nexgraphpy`
## Examples:
### Import the library:
`from nexgraph import NexGraph`
### Create a new instance:
`DFT_DEVICE = NexGraph()`
### Find and connect to a Nextech force gauge over USB serial port:
```
if DFT_DEVICE.find():
if DFT_DEVICE.connect():
print(DFT_DEVICE.get_info())
DFT_DEVICE.disconnect()
DFT_DEVICE = None
else:
print("Unable to connect")
exit()
else:
print("No device found.")
exit()
```
### Connect to a Nextech force gauge directly:
```
# Initialize with device the path
DFT_DEVICE = NexGraph("COM3")
# Or set the device path after initializing
DFT_DEVICE.device_path = "COM3"
# Connect to device after setting the path
if DFT_DEVICE.connect():
...
```
### Basic device serial operations:
#### Returns boolean value
```
# Change device modes, peak and tracking
DFT_DEVICE.mode()
# Change the units on device
DFT_DEVICE.unit()
# Reset the current device value
DFT_DEVICE.reset()
# Zero (Tare) the value on device
DFT_DEVICE.zero()
```
#### Returns string value
##### Download data from device memory
```
# Get data with no formatting
DFT_DEVICE.download()
# Get data in CSV format
DFT_DEVICE.download("csv")
# Get data as bar chart
DFT_DEVICE.download("chart")
# ** Chart is saved in the script directory as "memory-data-yyyy-mm-dd-HH:MM:SS.png"
```
##### Read and print values from the device
```
# Print value
DFT_DEVICE.print_value()
# Peak compression value
DFT_DEVICE.peak_compression()
# Peak tension value
DFT_DEVICE.peak_tension()
# Different formatted values
DFT_DEVICE.long_output()
DFT_DEVICE.short_output()
DFT_DEVICE.mini_output()
```
### Output live data of 100 rows:
*Note:
The output rate is roughly 10 data points per second.
100 data points is approximately 10 seconds of testing.*
```
i = 0
while True:
print(DFT_DEVICE.long_output())
i += 1
if i >= 100:
break
```
## Documentation
[Nexgraph Python Docs](https://python.nexgraphapp.com/)
<https://python.nexgraphapp.com/>
## NexGraph Desktop Application
The latest version of the NexGraph desktop application with features such as live graphing, and pass/fail data highlighting is available now for Windows.
Get it from: <https://nexgraphapp.com>.
Raw data
{
"_id": null,
"home_page": null,
"name": "nexgraphpy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "force, gauge, nexgraph, nextech, torque",
"author": null,
"author_email": "Shawn Myratchapon <info@nexgraphapp.com>",
"download_url": "https://files.pythonhosted.org/packages/34/5b/5741925ef5f91fc1287fd023f1cfcda73ad2a49292089ed59d51e4a1d070/nexgraphpy-2.0.0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">\n<img src=\"https://python.nexgraphapp.com/assets/images/nexgraph-logo-wide.png\">\n</h1><br />\n\n# Nexgraph Python\n\n## Description:\nNexGraph Python is a Python library implementation of the [NexGraph](https://nexgraphapp.com) software which works with Nextech brand DFT and DFS force gauges. It connects to the force gauge over USB serial and enables you to operate your device using Python. Download data from your devices, execute commands, and read data. Device Memory data can be output in CSV format or a bar chart.\n\n## Requirements:\nTested on Python versions 3.10+\n\n## Installation:\n\n`pip install nexgraphpy`\n\n## Examples:\n\n### Import the library:\n\n`from nexgraph import NexGraph`\n\n### Create a new instance:\n\n`DFT_DEVICE = NexGraph()`\n\n### Find and connect to a Nextech force gauge over USB serial port:\n\n```\nif DFT_DEVICE.find():\n if DFT_DEVICE.connect():\n print(DFT_DEVICE.get_info())\n DFT_DEVICE.disconnect()\n DFT_DEVICE = None\n else:\n print(\"Unable to connect\")\n exit()\nelse:\n print(\"No device found.\")\n exit()\n```\n\n### Connect to a Nextech force gauge directly:\n\n```\n# Initialize with device the path\nDFT_DEVICE = NexGraph(\"COM3\")\n\n# Or set the device path after initializing\nDFT_DEVICE.device_path = \"COM3\"\n\n# Connect to device after setting the path\nif DFT_DEVICE.connect():\n ...\n```\n\n### Basic device serial operations:\n\n#### Returns boolean value\n```\n# Change device modes, peak and tracking\nDFT_DEVICE.mode()\n\n# Change the units on device\nDFT_DEVICE.unit()\n\n# Reset the current device value\nDFT_DEVICE.reset()\n\n# Zero (Tare) the value on device\nDFT_DEVICE.zero()\n```\n\n#### Returns string value\n\n##### Download data from device memory\n```\n# Get data with no formatting\nDFT_DEVICE.download()\n\n# Get data in CSV format\nDFT_DEVICE.download(\"csv\")\n\n# Get data as bar chart\nDFT_DEVICE.download(\"chart\")\n\n# ** Chart is saved in the script directory as \"memory-data-yyyy-mm-dd-HH:MM:SS.png\"\n```\n\n##### Read and print values from the device\n\n```\n# Print value\nDFT_DEVICE.print_value()\n\n# Peak compression value\nDFT_DEVICE.peak_compression()\n\n# Peak tension value\nDFT_DEVICE.peak_tension()\n\n# Different formatted values\nDFT_DEVICE.long_output()\nDFT_DEVICE.short_output()\nDFT_DEVICE.mini_output()\n```\n\n### Output live data of 100 rows:\n\n*Note: \nThe output rate is roughly 10 data points per second.\n100 data points is approximately 10 seconds of testing.*\n\n```\ni = 0\nwhile True:\n print(DFT_DEVICE.long_output())\n i += 1\n if i >= 100:\n break\n```\n## Documentation\n\n[Nexgraph Python Docs](https://python.nexgraphapp.com/)\n<https://python.nexgraphapp.com/>\n\n## NexGraph Desktop Application\nThe latest version of the NexGraph desktop application with features such as live graphing, and pass/fail data highlighting is available now for Windows.\nGet it from: <https://nexgraphapp.com>.",
"bugtrack_url": null,
"license": null,
"summary": "Python library for connecting with Nextech force gauges over USB Serial",
"version": "2.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/simply-shawn/nexgraphpy/issues",
"Changelog": "https://github.com/simply-shawn/nexgraphpy/blob/main/CHANGELOG.md",
"Documentation": "https://python.nexgraphapp.com/",
"Homepage": "https://github.com/simply-shawn/nexgraphpy",
"Source": "https://github.com/simply-shawn/nexgraphpy"
},
"split_keywords": [
"force",
" gauge",
" nexgraph",
" nextech",
" torque"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "306e08ba6b5bfba46f4172e0921304e96462e3bb255a4e59def270282b9344b8",
"md5": "2d1627c03d7841daeffbbc5f3d1f2384",
"sha256": "169f1480cb6193dcd84397dd7f5577c8eecaccd26df4cdd8f8a30009abd5a27a"
},
"downloads": -1,
"filename": "nexgraphpy-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d1627c03d7841daeffbbc5f3d1f2384",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 18117,
"upload_time": "2025-07-10T04:39:33",
"upload_time_iso_8601": "2025-07-10T04:39:33.972667Z",
"url": "https://files.pythonhosted.org/packages/30/6e/08ba6b5bfba46f4172e0921304e96462e3bb255a4e59def270282b9344b8/nexgraphpy-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "345b5741925ef5f91fc1287fd023f1cfcda73ad2a49292089ed59d51e4a1d070",
"md5": "1941b2f04588c52f3a874b082978e59c",
"sha256": "f42fb7afb74593323076526e3c907d4aaa711189bf1b4c018d6d40899bf10e23"
},
"downloads": -1,
"filename": "nexgraphpy-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "1941b2f04588c52f3a874b082978e59c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 21059,
"upload_time": "2025-07-10T04:39:35",
"upload_time_iso_8601": "2025-07-10T04:39:35.288126Z",
"url": "https://files.pythonhosted.org/packages/34/5b/5741925ef5f91fc1287fd023f1cfcda73ad2a49292089ed59d51e4a1d070/nexgraphpy-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-10 04:39:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "simply-shawn",
"github_project": "nexgraphpy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nexgraphpy"
}