nexgraphpy 2.1.0

Python library for connecting with Nextech force gauges over USB Serial

Nexgraph Python

Description:

NexGraph Python is a Python library implementation of the NexGraph software which works with force gauges and torque testers manufactured by Nextech. It connects to a device over USB serial and enables you to operate the device using Python. Download data from your devices, execute commands, and read data. Device data can be output in raw and CSV format. A bar chart can also be generated. Compatible Devices:

• Nextech:
  • DFS Series
  • DFT
  • CTS
  • DTS
  • DTT
• Sauter:
  • FL Series
  • DA
  • DB

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:

Nextech Force Gauges:

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()

Other force gauges using lower baud rate:

if FL_DEVICE.find():
    if FL_DEVICE.connect("low"):
    ...

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 CSV and generate a chart
DFT_DEVICE.download("csv", True)

# ** Chart is saved in the script directory as "memory-data-yyyymmdd-HHMMSS.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

Find and connect to a Nextech torque tester over USB serial port:

if DTT_DEVICE.connect(False):
    # Output unformatted data:
    print(DTT_DEVICE.read_torque_data())
     # Output data as CSV format
    print(DTT_DEVICE.read_torque_data("csv"))
     # Output unformatted data and generate a chart
    print(DTT_DEVICE.read_torque_data("raw",True))
    ...

# ** Chart is saved in the script directory as "torque-data-yyyymmdd-HHMMSS.png"

Documentation

Nexgraph Python Docs 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.