Python（Windows）
本章介绍如何在Windows系统中获取并运行Mech-Eye API的Python例程。
例程简介
目前提供了如下例程：
-
trigger_with_software_and_fixed_rate：通过软触发 + 固定频率的方式触发数据采集，然后获取并保存采集的数据。
-
trigger_with_external_device_and_fixed_rate：通过外部触发 + 固定频率的方式触发数据采集，然后获取并保存采集的数据。
-
trigger_with_software_and_encoder：通过软触发 + 编码器的方式触发数据采集，然后获取并保存采集的数据。
-
trigger_with_external_device_and_encoder：通过外部触发 + 编码器的方式触发数据采集，然后获取并保存采集的数据。
-
trigger_multiple_profilers_simultaneously：异步触发多台轮廓测量仪进行采集，然后获取并保存采集的数据。
-
blind_spot_filtering：识别并去除死角造成的错误数据，然后获取过滤后的轮廓线数据。
-
noise_removal：去除深度数据中的噪点，然后获取过滤后的轮廓线数据。
-
profile_alignment：校正轮廓线中沿X轴和Z轴方向的振动（即对齐轮廓线），然后校正后的轮廓线数据。
-
render_depth_map：获取并保存使用jet配色方案渲染的深度图。
-
transform_point_cloud：获取并保存自定义坐标系下的点云。
-
manage_user_sets：管理参数组，如获取所有参数组的名称、新增参数组、切换参数组和保存参数设置至参数组。
-
print_profiler_status：获取并打印轮廓测量仪型号、序列号、固件版本、温度等信息。
-
register_profiler_event：定义并注册检测轮廓测量仪事件的回调函数。
-
use_virtual_device：获取虚拟设备中储存的轮廓线数据，并生成和保存强度图和深度图。
| 关于触发轮廓测量仪进行数据采集的不同方式，请参考触发数据采集的方式。 |
使用前提
使用Mech-Eye API的Python例程，需先满足以下使用前提：
-
确保安装的Python为64位，且版本在3.7至3.11之间。
如安装Python时未勾选Add Python to PATH，请将以下两个路径添加至Path环境变量中：
-
xxx/AppData/Local/Programs/Python/Python3x/
-
xxx/AppData/Local/Programs/Python/Python3x/Scripts/
-
-
获取例程。
-
安装必需软件。
-
（可选）安装例程依赖的软件库。
获取例程
Python例程包含在Mech-Eye SDK的安装路径中，也可从GitHub克隆获取。安装路径中的例程为Mech-Eye SDK发布时的版本，GitHub上的例程可能包含最新修改。
-
安装路径中的例程位于xxx/Mech-Eye SDK-2.4.0/API/samples/python/profiler路径下；
-
通过GitHub克隆获取的例程位于xxx/mecheye_python_samples/profiler路径下。
安装必需软件
使用Mech-Eye API的Python例程，必须安装Mech-Eye SDK及Python Mech-Eye API。
安装最新版本的Mech-Eye SDK
请根据Mech-Eye SDK安装指南安装或升级Mech-Eye SDK。
（可选）安装依赖的软件库
部分例程中的功能依赖OpenCV。如需使用下方列出的例程，则必须安装OpenCV（推荐最新版本）。
-
blind_spot_filtering
-
noise_removal
-
profile_alignment
-
render_depth_map
-
trigger_with_software_and_fixed_rate
-
trigger_with_external_device_and_fixed_rate
-
trigger_with_software_and_encoder
-
trigger_with_external_device_and_encoder
-
trigger_multiple_profilers_simultaneously
-
use_virtual_device
请执行以下命令安装最新版本的OpenCV：
pip install opencv-python