波浪工具

波浪工具从麦克风输入设备获取信号，绘图并保存为数据 (.csv) 或导出为图像 (.png, .tif 等)。波浪有两个图形区域，代表输入的实时数据（在软件运行时开始），以及当点击“记录”按钮时开始的记录区域。所有保存的数据都与可见的记录区域相关。

记录区域有三个状态：红线表示记录，橙线表示暂停，绿线表示记录停止。当保存为新_wavy_data_yymmddHHMMSS.ext 时，波浪会自动为您的新数据命名。

请，如果您使用此软件，请引用我们：

你知道 Zenodo 吗？这是一个使用DOI引用软件的方法！

下载二进制文件

为了方便，我们现在可以提供Windows和Linux的二进制文件。二进制文件不小（200MB），但包含您所需的一切。您无需安装，只需下载并点击执行。

请，见发布页面： https://github.com/dpizetta/wavy/releases

使用波浪的第一步

下载波浪后，您可以提取可执行文件。我们建议您在桌面区域创建一个名为“波浪”的文件夹，将可执行文件和将要创建的配置文件放入其中，从桌面区域创建一个链接（图标）以访问它。要运行它，只需双击即可。

当您第一次运行它时，它将允许您选择放置未来数据文件的默认文件夹。我们建议您在文档或桌面区域创建一个新的文件夹“波浪数据”，以便于访问。此过程将创建一个与可执行文件一起保存的文件，称为“wavy.config”，以保留该信息和未来的配置。

程序控制非常简单。顶部图表显示来自输入设备的实时数据。然后我们可以通过点击“记录”按钮开始记录。

此外，如果您需要，可以使用“暂停”按钮暂停记录，然后再次点击“暂停”按钮继续记录。

最后，您可以通过点击“停止”按钮停止记录。现在，保存和导出的按钮将被启用。

通过点击“保存”按钮，您可以将记录区域的数据保存到CSV文件。此外，您还可以使用导出器导出图像文件。

关于保存记录数据的说明

如果您放大记录图表，保存的数据将只表示窗口中可见的数据。所以请确保您不会丢失数据。

图表上的一些其他功能

图表由PyQtGraph提供，如果您在图表上右键单击，您将看到一些很酷的功能，包括其他导出数据的选项。您还可以使用鼠标缩放和移动。

未找到输入设备

如果没有插入输入设备（或内部麦克风），程序将在此时显示消息并退出，我们需要在这方面进行改进。

问题和改进

如果您在此程序中发现任何问题，请通过GitHub提供的问题系统告诉我们。这是让我们保持警觉并为您提供关于开发信息的方式。提前感谢。

关于

Wavy是为了开发一个简单的软件来从麦克风通道获取数据、绘制和保存数据而开发的。主要用途是为圣卡洛斯物理研究所的物理实验室提供鲁查特德方法的数据采集软件。

作者

• 丹尼尔·科索·皮泽塔[https://github.com/dpizetta]
• 韦斯利·达菲塔[https://github.com/Wa59]

致谢

教授们

• 博士费尔南多·费尔南德斯·帕瓦
• 博士瓦莫尔·罗伯托·马斯塔拉罗

技术人员

• 安托内罗·法布里·佩特里利·费尔南多
• 克劳迪奥·博恩塞·布雷塔斯
• 贾伊·安东尼奥·德·卡斯特罗·费尔南多

依赖项

• Python 3.4+
• PyQt5或PySide2或PyQt4或PySide
• pyqtgraph
• numpy
• PyAudio（也包含PortAudio）

注意：安装所有这些内容的简单方法

• 安装Python 2.7（或包含numpy和其他更好库的Anaconda/Miniconda）
• 使用pip install pyqtgraph（自动安装PyQt4）
• 使用pip install numpy
• 使用pip install pyaudio

对于Windows用户，PyAudio需要更多东西，更好的方法是下载PyAudio网站上的.exe安装程序（包括PortAudio）并安装它。如果您使用Anaconda或Miniconda，用'conda'命令替换'pip'命令。

运行代码

要无安装运行wavy，使用

$ python run.py

安装

要安装它，请在主Wavy文件夹内执行以下操作

$ pip install .

作为开发者安装

要作为开发者安装，这意味着像库一样安装，但保持它在同一位置，并在有任何更改时提供自动更新。

$ pip install -e .