# MeasurementLink™ Support for Python
- [MeasurementLink™ Support for Python](#measurementlink--support-for-python)
- [Introduction](#introduction)
- [Dependencies](#dependencies)
- [Documentation](#documentation)
- [Examples](#examples)
- [Developing Measurements: Quick Start](#developing-measurements-quick-start)
- [Installation](#installation)
- [Developing a minimal python measurement](#developing-a-minimal-python-measurement)
- [Steps to run/debug the measurement service](#steps-to-rundebug-the-measurement-service)
- [Static Registration of Python Measurements](#static-registration-of-python-measurements)
- [Create a batch file that runs a python measurement](#create-a-batch-file-that-runs-a-python-measurement)
- [Create Executable for Python Scripts](#create-executable-for-python-scripts)
- [Appendix: Managing Measurement with Python](#appendix-managing-measurement-with-python)
- [Create and Manage Python Measurement using Poetry](#create-and-manage-python-measurement-using-poetry)
- [Create and Manage Python Measurement using `venv`](#create-and-manage-python-measurement-using-venv)
- [Create and Manage Python Measurement by directly installing `ni-measurementlink-service` as a system-level package](#create-and-manage-python-measurement-by-directly-installing-ni-measurementlink-service-as-a-system-level-package)
---
## Introduction
MeasurementLink Support for Python (`ni-measurementlink-service`) is a Python
framework that helps you create reusable measurement plug-ins using gRPC
services. Deploy your measurement plug-ins to perform interactive validation in
InstrumentStudio and automated testing in TestStand.
---
## Dependencies
- Python >= 3.8 [(3.9 recommended)](https://www.python.org/downloads/release/python-3913/)
- [grpcio >= 1.49.1, < 2.x](https://pypi.org/project/grpcio/1.49.1/)
- [protobuf >= 4.21, < 5.x](https://pypi.org/project/protobuf/4.21.0/)
- [pywin32 >= 303 (Only for Windows)](https://pypi.org/project/pywin32/303/)
---
## Documentation
- [MeasurementLink Manual](https://www.ni.com/docs/en-US/bundle/measurementlink)
- [API Reference](https://ni.github.io/measurementlink-python/)
---
## System Configuration
### Enable Win32 Long Paths
By default, Windows has a path length limit of 260 characters. NI recommends enabling support for long paths when developing and deploying Python measurement services.
There are three ways to do this:
- When installing Python using the Python for Windows installer, click `Disable path length limit` at the end of the installation.
- Set the `Enable Win32 long paths` group policy:
- Run `gpedit.msc`.
- Expand `Computer Configuration` » `Administrative Templates` » `All Settings`.
- Find `Enable Win32 long paths` in the list, double-click it, and set it to `Enabled`.
- In the Windows registry, set `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled` (type: `REG_DWORD`) to 1. For more details, see [Maximum Path Length Limitation](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation).
---
## Examples
The `examples` directory contains example measurements for MeasurementLink 2024 Q2 or later. If
you are using a previous version of MeasurementLink, download the appropriate examples:
- MeasurementLink 2023 Q1: [measurementlink-python-examples-1.0.1.zip](https://github.com/ni/measurementlink-python/releases/download/1.0.1/measurementlink-python-examples-1.0.1.zip)
- MeasurementLink 2023 Q2: [measurementlink-python-examples-1.0.1.zip](https://github.com/ni/measurementlink-python/releases/download/1.0.1/measurementlink-python-examples-1.0.1.zip)
- MeasurementLink 2023 Q3: [measurementlink-python-examples-1.1.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.1.0/measurementlink-python-examples-1.1.0.zip)
- MeasurementLink 2023 Q4: [measurementlink-python-examples-1.2.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.2.0/measurementlink-python-examples-1.2.0.zip)
- MeasurementLink 2024 Q1: [measurementlink-python-examples-1.3.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.3.0/measurementlink-python-examples-1.3.0.zip)
For more information on setting up and running the example measurements, see the included `README.md` file.
For best results, use the example measurements corresponding to the version of MeasurementLink
that you are using. Newer examples may demonstrate features that are not available in older
versions of MeasurementLink.
---
## Developing Measurements: Quick Start
This section provides instructions to develop custom measurement services in Python using MeasurementLink Support for Python.
### Installation
Make sure the system has the recommended Python version is installed. Install MeasurementLink Support for Python using [pip](https://pip.pypa.io/).
``` cmd
REM Activate the required virtual environment if any.
pip install ni-measurementlink-service
```
Check if you have installed the expected version of MeasurementLink Support for Python installed by running the below command:
```cmd
pip show ni-measurementlink-service
```
### Developing a minimal Python measurement
1. Install the `ni-measurementlink-generator` package.
``` cmd
REM Activate the required virtual environment if any.
pip install ni-measurementlink-generator
```
2. Run the `ni-measurementlink-generator` tool. Use command line arguments to specify the `display-name` and optionally the `version`, `measurement-type`, and `product-type`.
1. Running `ni-measurementlink-generator` without optional arguments:
`ni-measurementlink-generator SampleMeasurement`
'SampleMeasurement' is the display name of your measurement service. Without the optional arguments,
the other arguments are generated for you based on the display name.
2. Running `ni-measurementlink-generator` with optional arguments for `measurement-version`, `ui-file`,
`service-class`, and `description-url`:
`ni-measurementlink-generator SampleMeasurement --measurement-version 0.1.0.0 --ui-file MeasurementUI.measui --service-class SampleMeasurement_Python --description-url https://www.example.com/SampleMeasurement.html`
3. Running `ni-measurementlink-generator` with optional argument for `directory-out`
`ni-measurementlink-generator SampleMeasurement --directory-out <new_path_for_created_files>`
If no output directory is specified, the files will
be placed in a new folder under the current directory
named after the display name without spaces.
3. To customize the created measurement, provide metadata of the measurement's configuration (input parameters) and outputs (output parameters) in `measurement.py`.
1. Use the `configuration()` decorator to provide metadata about the configurations.**The order of the configuration decorator must match with the order of the parameters defined in the function signature.**
``` python
@foo_measurement_service.register_measurement
#Display Names can not contains backslash or front slash.
@foo_measurement_service.configuration("DisplayNameForInput1", DataType.String, "DefaultValueForInput1")
@foo_measurement_service.configuration("DisplayNameForInput2", DataType.String, "DefaultValueForInput2")
def measure(input_1, input_2):
''' A simple Measurement method'''
return ["foo", "bar"]
```
2. Use the `output()` decorator to provide metadata about the output.**The order of the output decorators from top to bottom must match the order of the values of the list returned by the function.**
``` python
@foo_measurement_service.register_measurement
@foo_measurement_service.configuration("DisplayNameForInput1", nims.DataType.String, "DefaultValueForInput1")
@foo_measurement_service.configuration("DisplayNameForInput2", nims.DataType.String, "DefaultValueForInput2")
@foo_measurement_service.output("DisplayNameForOutput1", nims.DataType.String)
@foo_measurement_service.output("DisplayNameForOutput2", nims.DataType.String)
def measure(input_1, input_2):
return ["foo", "bar"]
```
4. Run/Debug the created measurement by following the steps discussed in the section ["Steps to run/debug the measurement service".](#steps-to-rundebug-the-measurement-service)
---
## Steps to run/debug the measurement service
1. Start the discovery service if not already started.
2. (Optional) Activate related virtual environments. Measurement developers can skip this step if they are not using any [virtual environments](#create-and-manage-python-measurement-using-venv) or [poetry-based projects.](#create-and-manage-python-measurement-using-poetry)
```cmd
.venv\scripts\activate
```
- After successful activation, you can see the name of the environment, `(.venv)` is added to the command prompt.
- If you face an access issue when trying to activate, retry after allowing scripts to run as Administrator by executing the below command in Windows PowerShell:
```cmd
Set-ExecutionPolicy RemoteSigned
```
3. [Run](https://code.visualstudio.com/docs/python/python-tutorial#_run-hello-world)/[Debug](https://code.visualstudio.com/docs/python/debugging#_basic-debugging) the measurement Python file.
4. To stop the running measurement service, press `Enter` in the terminal to properly close the service.
5. (Optional) After the usage of measurement, deactivate the virtual environment. Measurement developers can skip this step if they are not using any [virtual environments](#create-and-manage-python-measurement-using-venv) or [poetry-based projects.](#create-and-manage-python-measurement-using-poetry)
```cmd
deactivate
```
---
## Static Registration of Python Measurements
The MeasurementLink discovery service provides a registry of other services, and can discover and activate other services on the system. These features allow the discovery service to distinguish, manage, and describe measurement services on the system.
To statically register a measurement service with the MeasurementLink discovery service, do the following:
1. Create a [startup batch file](#create-a-batch-file-that-runs-a-python-measurement) or [executable](#create-executable-for-python-scripts) for the measurement service.
2. Edit the measurement service's `.serviceconfig` file and set the `path` value to the filename of the startup batch file or executable.
3. Copy the measurement service's directory (including the `.serviceconfig` file and startup batch file) to a subdirectory of `C:\ProgramData\National Instruments\MeasurementLink\Services`.
> **Note**
> If you are using a virtual environment, do not copy the `.venv` subdirectory—the virtual environment must be re-created in the new location.
Once your measurement service is statically registered, the MeasurementLink discovery service makes it visible in supported NI applications.
### Create a batch file that runs a Python measurement
The batch file used for static registration is responsible for starting the Python Scripts.
Typical Batch File:
``` cmd
"<path_to_python_exe>" "<path_to_measurement_file>"
```
Examples to start the fictitious file named `foo_measurement.py`:
1. Using the Python system distribution
```cmd
python foo_measurement.py
```
2. Using the virtual environment
```cmd
REM Windows
.\.venv\Scripts\python.exe foo_measurement.py
REM Linux
.venv/bin/python foo_measurement.py
```
### Create Executable for Python Scripts
To create an executable from a measurement, you can use the [pyinstaller](https://www.pyinstaller.org/) tooling. If you are using a Poetry project, add `pyinstaller` to its `dev-dependencies`. When statically registering the service, install the EXE into a unique directory along with its .serviceconfig and UI files.
Typical PyInstaller command to build executable:
```cmd
pyinstaller --onefile --console --paths .venv\Lib\site-packages measurement.py
```
## Troubleshooting
### "File not found" or "No such file or directory" errors when copying or running a measurement service
If copying or running a measurement service produces "File not found" or "No such file or directory" errors, make sure to [enable Win32 long paths](#enable-win32-long-paths). If you are unable to enable Win32 long paths, consider deploying the measurement service to a directory with a shorter path.
## Appendix: Managing Measurement with Python
A measurement and its related files can be maintained in different ways in Python. The basic components of any Python measurement are:
1. Measurement Python module (`.py` file)
- This file contains all the details related to the measurement and also contains the logic for the measurement execution.
- This file is run to start the measurement as a service.
2. UI File
- UI file for the measurement. Types of supported UI files are:
- Measurement UI (`.measui`): created using the **MeasurementLink UI Editor** application.
- LabVIEW UI (`.vi`)
- The path of this file is configured by `ui_file_path` in `measurement_info` variable definition in measurement Python module (`.py`).
Python communities have different ways of managing Python projects and their dependencies. It is up to the measurement developer to decide how to maintain the project and dependencies. Measurement developers can choose from a few common approaches discussed below based on their requirements.
### Create and Manage Python Measurement using Poetry
1. Install `poetry` (one-time setup)
1. Make sure the system has the recommended Python version installed.
2. Install `poetry` using the installation steps given in <https://python-poetry.org/docs/#installation>.
2. Create a new Python project and add `ni-measurementlink-service` as a dependency to the project.
1. Open a command prompt, and change the working directory to the directory of your choice where you want to create the project.
``` cmd
cd <path_of_directory_of_your_choice>
```
2. Create a Poetry project using the `poetry new` command. Poetry will create boilerplate files and folders that are commonly needed for a Python project.
``` cmd
poetry new <name_of_the_project>
```
3. Add the `ni-measurementlink-service` package as a dependency using the [`poetry add`](https://python-poetry.org/docs/cli/#add) command.
``` cmd
cd <name_of_the_project>
poetry add ni-measurementlink-service
```
4. The virtual environment will be auto-created by poetry.
5. Create measurement modules as described in ["Developing a minimal Python measurement"](#developing-a-minimal-python-measurement)
- Any additional dependencies required by measurement can be added using [add command](https://python-poetry.org/docs/cli/#add).
``` cmd
poetry add <dependency_package_name>
```
For detailed info on managing projects using poetry [refer to the official documentation](https://python-poetry.org/docs/cli/).
### Create and Manage Python Measurement using `venv`
1. Make sure the system has the recommended Python version installed.
2. Open a command prompt, and change the working directory to the directory of your choice where you want to create a project.
``` cmd
cd <path_of_directory_of_your_choice>
```
3. Create a virtual environment.
``` cmd
REM This creates a virtual environment named .venv
python -m venv .venv
```
4. Activate the virtual environment. After successful activation
``` cmd
.venv\scripts\activate
REM Optionally upgrade the pip within the venv by executing the command
python -m pip install -U pip
```
5. Install the `ni-measurementlink-service` package into the virtual environment.
``` cmd
pip install ni-measurementlink-service
```
6. Create measurement modules as described in ["Developing a minimal Python measurement"](#developing-a-minimal-python-measurement)
- Any additional dependencies required by measurement can be added pip install.
``` cmd
pip install <dependency_package_name>
```
For detailed info on managing projects with a virtual environment, refer to the [official documentation](https://docs.python.org/3/tutorial/venv.html).
### Create and Manage Python Measurement by directly installing `ni-measurementlink-service` as a system-level package
Measurement developers can also install `ni-measurementlink-service` as a system package if necessary.
1. Install the `ni-measurementlink-service` package from the command prompt
``` cmd
pip install ni-measurementlink-service
```
2. Create measurement modules as described in ["Developing a minimal Python measurement"](#developing-a-minimal-python-measurement)
---
Raw data
{
"_id": null,
"home_page": "https://github.com/ni/measurementlink-python/",
"name": "ni_measurementlink_service",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "NI",
"author_email": "opensource@ni.com",
"download_url": "https://files.pythonhosted.org/packages/b7/78/6440841c6f2cd44735e1f23015bf86f376896452bc192f9176fe888341f0/ni_measurementlink_service-1.4.0.tar.gz",
"platform": null,
"description": "# MeasurementLink\u2122 Support for Python\n\n- [MeasurementLink\u2122 Support for Python](#measurementlink--support-for-python)\n - [Introduction](#introduction)\n - [Dependencies](#dependencies)\n - [Documentation](#documentation)\n - [Examples](#examples)\n - [Developing Measurements: Quick Start](#developing-measurements-quick-start)\n - [Installation](#installation)\n - [Developing a minimal python measurement](#developing-a-minimal-python-measurement)\n - [Steps to run/debug the measurement service](#steps-to-rundebug-the-measurement-service)\n - [Static Registration of Python Measurements](#static-registration-of-python-measurements)\n - [Create a batch file that runs a python measurement](#create-a-batch-file-that-runs-a-python-measurement)\n - [Create Executable for Python Scripts](#create-executable-for-python-scripts)\n - [Appendix: Managing Measurement with Python](#appendix-managing-measurement-with-python)\n - [Create and Manage Python Measurement using Poetry](#create-and-manage-python-measurement-using-poetry)\n - [Create and Manage Python Measurement using `venv`](#create-and-manage-python-measurement-using-venv)\n - [Create and Manage Python Measurement by directly installing `ni-measurementlink-service` as a system-level package](#create-and-manage-python-measurement-by-directly-installing-ni-measurementlink-service-as-a-system-level-package)\n\n---\n\n## Introduction\n\nMeasurementLink Support for Python (`ni-measurementlink-service`) is a Python\nframework that helps you create reusable measurement plug-ins using gRPC\nservices. Deploy your measurement plug-ins to perform interactive validation in\nInstrumentStudio and automated testing in TestStand.\n\n---\n\n## Dependencies\n\n- Python >= 3.8 [(3.9 recommended)](https://www.python.org/downloads/release/python-3913/)\n- [grpcio >= 1.49.1, < 2.x](https://pypi.org/project/grpcio/1.49.1/)\n- [protobuf >= 4.21, < 5.x](https://pypi.org/project/protobuf/4.21.0/)\n- [pywin32 >= 303 (Only for Windows)](https://pypi.org/project/pywin32/303/)\n\n---\n\n## Documentation\n\n- [MeasurementLink Manual](https://www.ni.com/docs/en-US/bundle/measurementlink)\n- [API Reference](https://ni.github.io/measurementlink-python/)\n\n---\n\n## System Configuration\n\n### Enable Win32 Long Paths\n\nBy default, Windows has a path length limit of 260 characters. NI recommends enabling support for long paths when developing and deploying Python measurement services. \n\nThere are three ways to do this:\n- When installing Python using the Python for Windows installer, click `Disable path length limit` at the end of the installation.\n- Set the `Enable Win32 long paths` group policy:\n - Run `gpedit.msc`.\n - Expand `Computer Configuration` \u00bb `Administrative Templates` \u00bb `All Settings`.\n - Find `Enable Win32 long paths` in the list, double-click it, and set it to `Enabled`.\n- In the Windows registry, set `HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\\LongPathsEnabled` (type: `REG_DWORD`) to 1. For more details, see [Maximum Path Length Limitation](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation).\n\n---\n\n## Examples\n\nThe `examples` directory contains example measurements for MeasurementLink 2024 Q2 or later. If\nyou are using a previous version of MeasurementLink, download the appropriate examples:\n\n- MeasurementLink 2023 Q1: [measurementlink-python-examples-1.0.1.zip](https://github.com/ni/measurementlink-python/releases/download/1.0.1/measurementlink-python-examples-1.0.1.zip)\n- MeasurementLink 2023 Q2: [measurementlink-python-examples-1.0.1.zip](https://github.com/ni/measurementlink-python/releases/download/1.0.1/measurementlink-python-examples-1.0.1.zip)\n- MeasurementLink 2023 Q3: [measurementlink-python-examples-1.1.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.1.0/measurementlink-python-examples-1.1.0.zip)\n- MeasurementLink 2023 Q4: [measurementlink-python-examples-1.2.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.2.0/measurementlink-python-examples-1.2.0.zip)\n- MeasurementLink 2024 Q1: [measurementlink-python-examples-1.3.0.zip](https://github.com/ni/measurementlink-python/releases/download/1.3.0/measurementlink-python-examples-1.3.0.zip)\n\nFor more information on setting up and running the example measurements, see the included `README.md` file.\n\nFor best results, use the example measurements corresponding to the version of MeasurementLink\nthat you are using. Newer examples may demonstrate features that are not available in older\nversions of MeasurementLink.\n\n---\n\n## Developing Measurements: Quick Start\n\nThis section provides instructions to develop custom measurement services in Python using MeasurementLink Support for Python.\n\n### Installation\n\nMake sure the system has the recommended Python version is installed. Install MeasurementLink Support for Python using [pip](https://pip.pypa.io/).\n\n``` cmd\nREM Activate the required virtual environment if any.\npip install ni-measurementlink-service\n```\n\nCheck if you have installed the expected version of MeasurementLink Support for Python installed by running the below command:\n\n```cmd\npip show ni-measurementlink-service\n```\n\n### Developing a minimal Python measurement\n\n1. Install the `ni-measurementlink-generator` package.\n\n``` cmd\nREM Activate the required virtual environment if any.\npip install ni-measurementlink-generator\n```\n\n2. Run the `ni-measurementlink-generator` tool. Use command line arguments to specify the `display-name` and optionally the `version`, `measurement-type`, and `product-type`.\n\n 1. Running `ni-measurementlink-generator` without optional arguments:\n\n `ni-measurementlink-generator SampleMeasurement`\n\n 'SampleMeasurement' is the display name of your measurement service. Without the optional arguments,\n the other arguments are generated for you based on the display name.\n\n 2. Running `ni-measurementlink-generator` with optional arguments for `measurement-version`, `ui-file`,\n `service-class`, and `description-url`:\n\n `ni-measurementlink-generator SampleMeasurement --measurement-version 0.1.0.0 --ui-file MeasurementUI.measui --service-class SampleMeasurement_Python --description-url https://www.example.com/SampleMeasurement.html`\n\n 3. Running `ni-measurementlink-generator` with optional argument for `directory-out`\n\n `ni-measurementlink-generator SampleMeasurement --directory-out <new_path_for_created_files>`\n\n If no output directory is specified, the files will\n be placed in a new folder under the current directory\n named after the display name without spaces.\n\n3. To customize the created measurement, provide metadata of the measurement's configuration (input parameters) and outputs (output parameters) in `measurement.py`.\n 1. Use the `configuration()` decorator to provide metadata about the configurations.**The order of the configuration decorator must match with the order of the parameters defined in the function signature.**\n\n ``` python\n @foo_measurement_service.register_measurement\n #Display Names can not contains backslash or front slash.\n @foo_measurement_service.configuration(\"DisplayNameForInput1\", DataType.String, \"DefaultValueForInput1\")\n @foo_measurement_service.configuration(\"DisplayNameForInput2\", DataType.String, \"DefaultValueForInput2\")\n def measure(input_1, input_2):\n ''' A simple Measurement method'''\n return [\"foo\", \"bar\"]\n ```\n\n 2. Use the `output()` decorator to provide metadata about the output.**The order of the output decorators from top to bottom must match the order of the values of the list returned by the function.**\n\n ``` python\n @foo_measurement_service.register_measurement\n @foo_measurement_service.configuration(\"DisplayNameForInput1\", nims.DataType.String, \"DefaultValueForInput1\")\n @foo_measurement_service.configuration(\"DisplayNameForInput2\", nims.DataType.String, \"DefaultValueForInput2\")\n @foo_measurement_service.output(\"DisplayNameForOutput1\", nims.DataType.String)\n @foo_measurement_service.output(\"DisplayNameForOutput2\", nims.DataType.String)\n def measure(input_1, input_2):\n return [\"foo\", \"bar\"]\n ```\n\n4. Run/Debug the created measurement by following the steps discussed in the section [\"Steps to run/debug the measurement service\".](#steps-to-rundebug-the-measurement-service)\n\n---\n\n## Steps to run/debug the measurement service\n\n1. Start the discovery service if not already started.\n\n2. (Optional) Activate related virtual environments. Measurement developers can skip this step if they are not using any [virtual environments](#create-and-manage-python-measurement-using-venv) or [poetry-based projects.](#create-and-manage-python-measurement-using-poetry)\n\n ```cmd\n .venv\\scripts\\activate\n ```\n\n - After successful activation, you can see the name of the environment, `(.venv)` is added to the command prompt.\n - If you face an access issue when trying to activate, retry after allowing scripts to run as Administrator by executing the below command in Windows PowerShell:\n\n ```cmd\n Set-ExecutionPolicy RemoteSigned \n ```\n\n3. [Run](https://code.visualstudio.com/docs/python/python-tutorial#_run-hello-world)/[Debug](https://code.visualstudio.com/docs/python/debugging#_basic-debugging) the measurement Python file.\n\n4. To stop the running measurement service, press `Enter` in the terminal to properly close the service.\n\n5. (Optional) After the usage of measurement, deactivate the virtual environment. Measurement developers can skip this step if they are not using any [virtual environments](#create-and-manage-python-measurement-using-venv) or [poetry-based projects.](#create-and-manage-python-measurement-using-poetry)\n\n ```cmd\n deactivate\n ```\n\n---\n\n## Static Registration of Python Measurements\n\nThe MeasurementLink discovery service provides a registry of other services, and can discover and activate other services on the system. These features allow the discovery service to distinguish, manage, and describe measurement services on the system.\n\nTo statically register a measurement service with the MeasurementLink discovery service, do the following:\n\n1. Create a [startup batch file](#create-a-batch-file-that-runs-a-python-measurement) or [executable](#create-executable-for-python-scripts) for the measurement service.\n\n2. Edit the measurement service's `.serviceconfig` file and set the `path` value to the filename of the startup batch file or executable.\n\n3. Copy the measurement service's directory (including the `.serviceconfig` file and startup batch file) to a subdirectory of `C:\\ProgramData\\National Instruments\\MeasurementLink\\Services`.\n> **Note**\n> If you are using a virtual environment, do not copy the `.venv` subdirectory—the virtual environment must be re-created in the new location.\n\nOnce your measurement service is statically registered, the MeasurementLink discovery service makes it visible in supported NI applications.\n\n### Create a batch file that runs a Python measurement\n\nThe batch file used for static registration is responsible for starting the Python Scripts.\n\nTypical Batch File:\n\n``` cmd\n\"<path_to_python_exe>\" \"<path_to_measurement_file>\"\n```\n\nExamples to start the fictitious file named `foo_measurement.py`:\n\n1. Using the Python system distribution\n\n ```cmd\n python foo_measurement.py\n ```\n\n2. Using the virtual environment\n\n ```cmd\n REM Windows\n .\\.venv\\Scripts\\python.exe foo_measurement.py\n\n REM Linux \n .venv/bin/python foo_measurement.py\n ```\n\n### Create Executable for Python Scripts\n\nTo create an executable from a measurement, you can use the [pyinstaller](https://www.pyinstaller.org/) tooling. If you are using a Poetry project, add `pyinstaller` to its `dev-dependencies`. When statically registering the service, install the EXE into a unique directory along with its .serviceconfig and UI files.\n\nTypical PyInstaller command to build executable:\n\n```cmd\npyinstaller --onefile --console --paths .venv\\Lib\\site-packages measurement.py\n```\n\n## Troubleshooting\n\n### \"File not found\" or \"No such file or directory\" errors when copying or running a measurement service\n\nIf copying or running a measurement service produces \"File not found\" or \"No such file or directory\" errors, make sure to [enable Win32 long paths](#enable-win32-long-paths). If you are unable to enable Win32 long paths, consider deploying the measurement service to a directory with a shorter path.\n\n## Appendix: Managing Measurement with Python\n\nA measurement and its related files can be maintained in different ways in Python. The basic components of any Python measurement are:\n\n1. Measurement Python module (`.py` file)\n - This file contains all the details related to the measurement and also contains the logic for the measurement execution.\n - This file is run to start the measurement as a service.\n\n2. UI File\n - UI file for the measurement. Types of supported UI files are:\n - Measurement UI (`.measui`): created using the **MeasurementLink UI Editor** application.\n - LabVIEW UI (`.vi`)\n - The path of this file is configured by `ui_file_path` in `measurement_info` variable definition in measurement Python module (`.py`).\n\nPython communities have different ways of managing Python projects and their dependencies. It is up to the measurement developer to decide how to maintain the project and dependencies. Measurement developers can choose from a few common approaches discussed below based on their requirements.\n\n### Create and Manage Python Measurement using Poetry\n\n1. Install `poetry` (one-time setup)\n\n 1. Make sure the system has the recommended Python version installed.\n\n 2. Install `poetry` using the installation steps given in <https://python-poetry.org/docs/#installation>.\n\n2. Create a new Python project and add `ni-measurementlink-service` as a dependency to the project.\n\n 1. Open a command prompt, and change the working directory to the directory of your choice where you want to create the project.\n\n ``` cmd\n cd <path_of_directory_of_your_choice>\n ```\n\n 2. Create a Poetry project using the `poetry new` command. Poetry will create boilerplate files and folders that are commonly needed for a Python project.\n\n ``` cmd\n poetry new <name_of_the_project>\n ```\n\n 3. Add the `ni-measurementlink-service` package as a dependency using the [`poetry add`](https://python-poetry.org/docs/cli/#add) command.\n\n ``` cmd\n cd <name_of_the_project>\n poetry add ni-measurementlink-service\n ```\n\n 4. The virtual environment will be auto-created by poetry.\n\n 5. Create measurement modules as described in [\"Developing a minimal Python measurement\"](#developing-a-minimal-python-measurement)\n - Any additional dependencies required by measurement can be added using [add command](https://python-poetry.org/docs/cli/#add).\n\n ``` cmd\n poetry add <dependency_package_name>\n ```\n\nFor detailed info on managing projects using poetry [refer to the official documentation](https://python-poetry.org/docs/cli/).\n\n### Create and Manage Python Measurement using `venv`\n\n1. Make sure the system has the recommended Python version installed.\n\n2. Open a command prompt, and change the working directory to the directory of your choice where you want to create a project.\n\n ``` cmd\n cd <path_of_directory_of_your_choice>\n ```\n\n3. Create a virtual environment.\n\n ``` cmd\n REM This creates a virtual environment named .venv\n python -m venv .venv\n ```\n\n4. Activate the virtual environment. After successful activation\n\n ``` cmd\n .venv\\scripts\\activate\n REM Optionally upgrade the pip within the venv by executing the command\n python -m pip install -U pip\n ```\n\n5. Install the `ni-measurementlink-service` package into the virtual environment.\n\n ``` cmd\n pip install ni-measurementlink-service\n ```\n\n6. Create measurement modules as described in [\"Developing a minimal Python measurement\"](#developing-a-minimal-python-measurement)\n - Any additional dependencies required by measurement can be added pip install.\n\n ``` cmd\n pip install <dependency_package_name>\n ```\n\nFor detailed info on managing projects with a virtual environment, refer to the [official documentation](https://docs.python.org/3/tutorial/venv.html).\n\n### Create and Manage Python Measurement by directly installing `ni-measurementlink-service` as a system-level package\n\nMeasurement developers can also install `ni-measurementlink-service` as a system package if necessary.\n\n1. Install the `ni-measurementlink-service` package from the command prompt\n\n ``` cmd\n pip install ni-measurementlink-service\n ```\n\n2. Create measurement modules as described in [\"Developing a minimal Python measurement\"](#developing-a-minimal-python-measurement)\n\n---\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MeasurementLink Support for Python",
"version": "1.4.0",
"project_urls": {
"Homepage": "https://github.com/ni/measurementlink-python/",
"Repository": "https://github.com/ni/measurementlink-python/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "366279ba4557b0caa9d745598d2846fd44989488729349efb5580147710360c9",
"md5": "03e93078b66411ba93188a807be993f8",
"sha256": "091f3f28770e6b1d96c7b0a951d5ba2f31959d1b4701011fb2c6ad857f38c33c"
},
"downloads": -1,
"filename": "ni_measurementlink_service-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "03e93078b66411ba93188a807be993f8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 146141,
"upload_time": "2024-03-22T19:14:28",
"upload_time_iso_8601": "2024-03-22T19:14:28.243338Z",
"url": "https://files.pythonhosted.org/packages/36/62/79ba4557b0caa9d745598d2846fd44989488729349efb5580147710360c9/ni_measurementlink_service-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b7786440841c6f2cd44735e1f23015bf86f376896452bc192f9176fe888341f0",
"md5": "8a6f3c4946588d08397ea89cfa3332bb",
"sha256": "c79f0c52389e0352ff0484f6becbe84535d5c92c3798e1dfd03ab01381ffcf43"
},
"downloads": -1,
"filename": "ni_measurementlink_service-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "8a6f3c4946588d08397ea89cfa3332bb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 103721,
"upload_time": "2024-03-22T19:17:00",
"upload_time_iso_8601": "2024-03-22T19:17:00.966433Z",
"url": "https://files.pythonhosted.org/packages/b7/78/6440841c6f2cd44735e1f23015bf86f376896452bc192f9176fe888341f0/ni_measurementlink_service-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-22 19:17:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ni",
"github_project": "measurementlink-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "ni_measurementlink_service"
}
JSON
