thebeat：Python中的科学节奏

thebeat是一个Python包，用于处理行为和认知科学中的时间序列和节奏。它提供了创建刺激、可视化和分析时间数据的函数。

作为音乐和计时研究中的接受方法集合，thebeat在创建实验或分析数据时将节省您的时间。

thebeat是一个开源的、持续的和协作项目，易于与现有的Python生态系统以及您自己的脚本集成。该包专门设计为对熟练和初学者程序员都有用。

文档

该包的文档可在https://thebeat.readthedocs.io找到。文档包含所有包功能的详细描述以及大量（可复制）示例。

安装

thebeat可通过PyPI获取，并可以使用以下命令安装

pip install thebeat

请注意，如果您想使用 thebeat 的绘图功能，您必须使用以下方法进行安装：

pip install 'thebeat[music_notation]'

这将安装 thebeat 以及可选依赖项 abjad 和 Lilypond。

thebeat 在 Linux、macOS 和 Windows 上进行了积极测试。我们旨在为所有 支持的 Python 版本（3.8 及以上版本）提供支持。

通过 Binder 直接尝试

如果您首先想尝试 thebeat，或者您希望在例如教育环境中使用它，您可以点击此链接 尝试在 Binder 环境中使用 thebeat。

入门指南

下面的代码演示了如何在实验中创建一个简单的试验

from thebeat import Sequence, SoundStimulus, SoundSequence

seq = Sequence.generate_isochronous(n_events=10, ioi=500)
sound = SoundStimulus.generate(freq=440, duration_ms=50, onramp_ms=10, offramp_ms=10)
trial = SoundSequence(sound, seq)

trial.play()  # play sound over loudspeakers
trial.plot_waveform()  # plot as sound waveform
trial.plot_sequence()  # plot as an event plot
trial.write_wav('example_trial.wav')  # save file to disk

公开讨论

创建 thebeat 的一个原因是在节奏和时序研究中缺乏一套标准/公认的通用方法。因此，thebeat 的一个重要优点在于就包含的方法展开讨论。例如，计算相位差异和整数比率的方有所不同，我们设想人们会有不同的看法。尽可能的情况下，我们在包文档中包含了参考文献。但我们鼓励任何有意见的人公开质疑 thebeat 提供的方法。

您有两个地方可以发表评论或提出问题

• 您可以通过点击此 GitHub 页面顶部的 'Issues' 标签来开始一个线程。请注意，这个地方主要是用来质疑方法或报告错误的。
• 您也可以访问我们的 Gitter 聊天室。这可能是在关于 thebeat 如何工作的问题上寻求答案的最佳地点。

许可协议

thebeat 在 GPL-3 许可协议下发行。您可以在商业和非商业用途中自由分发或修改代码。有关更多信息，请参阅 此处。

合作者

该软件包由荷兰奈梅亨马克斯·普朗克心理语言学研究所的比较声学组开发。

合作者包括：Jelle van der Werff、Andrea Ravignani 和 Yannick Jadoul。