labjack-ljm : LJM library Python wrapper for LabJack T4, T7 and T8 12/01/2023 support@labjack.com

The Python wrapper package, modules and examples for the cross-platform LJM library, which supports the LabJack T4, T7 and T8.

Installation Requirements:

• Windows, Mac OS X / macOS, or Linux
• LJM library: https://labjack.com/support/software/installers/ljm
• Python 2.6, 2.7 and 3.x.

Installation:

After fulfilling the requirements, open a terminal/console and use pip to install labjack-ljm for the first time:

python -m pip install labjack-ljm

To upgrade to a newer version use:

python -m pip install labjack-ljm --upgrade

On Linux and macOS, you can also install with pip like so:

pip install labjack-ljm

Alternatively, download the labjack-ljm distribution source, unzip the contents and go to its unzipped directory. To install, run the the following command (run with sudo on Linux and macOS):

$ python setup.py install

If using Conda, we suggest creating a skeleton package from our PyPi package, then install with Conda: conda skeleton pypi labjack-ljm conda-build labjack-ljm

Distribution Name Change:

The previous distribution name was LJMPython in versions v1.19 and older. Starting with version 1.20 and the releases on PyPi, the distribution name is labjack-ljm. The namespace, package and interface remain the same.

Installation Troubleshooting:

• If you have multiple versions of Python installed, make sure you install for the Python version you will be using. For example, on Linux if both Python 2.7 and 3.5 are installed, you can install to Python 3.5 with:

  $ python3.5 -m pip labjack-ljm install

• On Windows, if you have Python installed and installation of labjack-ljm fails with an error of, or similar to:

  'python' is not recognized as an internal or external command, operable program or batch file.

  The Python executable path may not have been added to the Windows user or system path. One way to add Python to the path is to run the Python Windows installer and in the "Customize Python" window click the "Add python.exe to Path" option towards the bottom and select "Will be installed on local hard drive". Afterwards, open a new terminal/console and retry labjack-ljm installation.

• If you have LJMPython version 1.19 or older installed, and are updating to labjack-ljm v1.20 or newer, using pip for installation is recommended.

  If using setup.py for installation, afterwards check the labjack.ljm version number.

  from labjack import ljm print(ljm.version)

  If it is not the version you installed and still reports a previous version, go to your Python site-packeges directory. If you see a labjack_ljm--py.egg file ( is labjack-ljm version and is the Python version), delete the labjack directory. The egg file contains the labjack folder files zipped, and the labjack folder and its files are conflicting.

Examples:

Example code can be found in the Examples directory.

Documentation:

LJM Python documentation can be found in the docstrings of the source code. The source code files are located in the labjack/ljm directory.

Alternatively, after installation in Python you can use the help function on a module for documentation. For example:

$ python
>>> from labjack import ljm
>>> help(ljm.ljm)

LJM library documentation can be found here:

https://labjack.com/support/software/api/ljm

T4, T7 and T8 documentation can be found here:

https://labjack.com/support/datasheets/t-series

License:

All LJM Python modules and examples are licensed under MIT X11. The license can be found in the LICENSE.TXT file.