注意

此库版本是基于我 (@ksunden) 对 picosdk 仓库的个人github分支构建的。我通过ISC许可证的条款进行分发。我无意修改实际库，只修改打包（例如使用setuptools，更改版本号进行发布）。如果PicoTech的代表与我联系，我将乐意将PyPI命名空间的所有权转让给公司。

picosdk-python-wrappers

欢迎使用PicoSDK for Python。它允许您在您的Python程序中控制PicoScope设备。

入门

要使用此代码，您需要安装PicoSDK C库。

Microsoft Windows

请访问我们的下载页面下载32位或64位的PicoSDK C库。请注意将您的python的“位数”与PicoSDK相匹配。

Linux

按照我们Linux软件和示波器/数据记录器驱动程序页面上的说明安装您产品所需的相关驱动程序包。

macOS

macOS用户应安装PicoScope Beta for macOS，然后可能发现这个论坛帖子在安装C库方面很有帮助。

安装python驱动绑定

提供了一个distutils安装程序。在您已经安装了PicoSDK驱动程序包（见上文）后，可以使用以下方式使用Python安装程序：

python setup.py install

在macOS和Linux上，您可能需要使用sudo与该命令一起使用，以便将它们安装到系统文件夹中；或者，如果只想为当前用户安装，可以使用：

python setup.py install --user

在python中，用于导入的库称为picosdk。

兼容性

此代码编写为与python 2.7和python 3（任何版本）兼容。

如果您发现兼容性问题，请提出一个问题，列出您能找到的所有版本（python、numpy、picosdk提交哈希等）以及您的错误消息。

C接口

您可以通过它们的原始C名称直接访问C驱动函数（ctypes调用），并按照程序员指南进行操作。例如，在psX000[a]Examples/之类的文件夹中提供了示例。

程序员指南

您可以从我们的文档页面下载提供相关PicoScope或PicoLog驱动程序API函数描述的程序员指南。

Python接口

我们正在添加Pythonic包装器来包装C函数。如果我们还没有到达您的功能，或者您的设备被列为不受支持的型号之一，请通过问题告诉我们您正在等待。

不受支持的型号

以下驱动程序和设备尚不支持

• plcm3 - PicoLog CM3电流数据记录器
• ps3000 - PicoScope 3204、3205、3206、3223、3224、3423和3423
• usbpt104 - PT-104白金电阻数据记录器

依赖项

除了依赖于C库之外，Pythonic包装器还使用一些Python库，如numpy。许多示例脚本还使用了matplotlib绘图库。您可以使用以下方式使用pip安装这些依赖项：

pip install -r requirements.txt
pip install -r requirements-for-examples.txt

驱动程序无关示例

anyScopeExamples文件夹包含了一些纯Python示例，它们与C风格示例做相同的事情，但以驱动程序通用的方式。

Python类

库

picosdk.library.Library包含每个驱动程序类的基类。它将Python类型转换为C类型，并再次转换，以及进行一些单位转换以消除nano、micro和milli风格的 prefixes。它还处理PicoScope驱动程序版本之间的编程API差异。

设备

picosdk.device.Device包含表示具有有效句柄的PicoScope的具体类。它缓存有关设备状态的一些信息，例如当前选择的通道电压范围。

它是基于Library类的公共接口实现的，几乎完全处理Python类型。主要例外是它处理numpy数组 - 它（知道电压范围）负责将驱动程序用于振幅的原始ADC计数值转换为物理单位。

测试此代码

检查您的设备使用哪个设备驱动程序，并检查test/test_helpers.py顶部的常量以启用连接设备测试的相关驱动程序。（大多数测试使用此）。

要检查您的设备使用哪个驱动程序，您可以使用picosdk.discover。

from picosdk.discover import find_all_units

scopes = find_all_units()

for scope in scopes:
    print(scope.info)
    scope.close()

然后，您应该配置test/test_helpers.py的连接设备列表，以便它可以运行我们在您的设备上的所有测试。

要运行单元测试，您需要安装nose（例如 pip install nose）。然后，在存储库的根目录下运行nosetests。

获取支持

请访问我们的支持页面直接联系我们，或访问我们的测试和测量论坛提问。

版权和许可

有关许可条款，请参阅LICENSE.md。

PicoScope、PicoLog和PicoSDK是Pico Technology Ltd的注册商标。

Windows是微软公司的注册商标。

macOS是苹果公司的注册商标。

Linux在美国和其他国家是林纳斯·托瓦兹的注册商标。

版权© 2018-2019 Pico Technology Ltd. 保留所有权利。