asteroid

---

小行星是一種基於Pytorch的音頻源分離工具包，可以在常見數據集上進行快速實驗。它帶有一個源代碼，該源代碼支持各種數據集和架構，以及一組複製一些重要論文的食譜。

您使用小行星還是想？

請，如果您找到了一個錯誤，請打開問題，如果解決問題，請打開拉動請求！新功能也是如此，告訴我們您想要什麼或幫助我們構建它！不要猶豫，加入Slack並在那裡提出問題 /建議新功能！小行星旨在成為一個基於社區的項目，因此請繼續前進並幫助我們！

內容

• 內容
• 安裝
• 教程
• 運行食譜
• 可用食譜
• 支持的數據集
• 預驗證的模型
• 貢獻
• 張板可視化
• 指導原則
• 引用小行星

安裝

（↑直至內容）要安裝小行星，克隆回購，然後使用conda，pip或python安裝它：

 # First clone and enter the repo
git clone https://github.com/asteroid-team/asteroid
cd asteroid

• 與pip

 # Install with pip in editable mode
pip install -e .
# Or, install with python in dev mode
# python setup.py develop

• 使用Conda（如果您還沒有Conda，請參閱此處。）

conda env create -f environment.yml
conda activate asteroid

• 小行星也在PYPI上，您可以使用

pip install asteroid

教程

（↑最重要的內容）這是筆記本的列表，其中顯示了小行星特徵的示例用法。

• 小行星開始
• 簡介和概述
• 過濾庫API
• 置換不變的培訓包裝紙PITLossWrapper
• 處理大型WAV文件

運行食譜

（↑最重要的內容）運行食譜需要其他包裝，在大多數情況下，我們建議運行：

 # from asteroid/
pip install -r requirements.txt

然後選擇要運行並運行的食譜！

 cd egs/wham/ConvTasNet
. ./run.sh

EGS/readme.md中的更多信息。

可用食譜

（↑最高內容）

• Convtasnet（Luo等）
• Tasnet（Luo等）
• 深度聚類（Hershey等人和Isik等人。）
• Chimera ++（Luo等人和Wang等人）
• DualPathrnn（Luo等人）
• 兩步學習（Tzinis等人）
• Sudormrfnet（Tzinis等人）
• dptnet（Chen等人）
• dccrnet（Hu等人）
• dcunet（Choi等人）
• Crossnet-open-unmix（Sawata等人）
• 多年模型dprnn（Zhu等人）
• open-unmix（降臨）（Stöter等人）
• 波普利特（Coming）（Zeghidour等人）

支持的數據集

（↑最高內容）

• WSJ0-2MIX / WSJ03MIX（Hershey等）
• WHAM（Wichern等）
• Whamr（Maciejewski等人）
• Librimix（Cosentino等）
• Microsoft DNS挑戰（Chandan等）
• SMS_WSJ（Drude等人）
• MUSDB18（Raffi等人）
• 大驚小怪（Wisdom等人）
• Avspeech（Ephrat等人）
• Kinect-WSJ（Sivasankaran等）

預驗證的模型

（↑最重要的內容）請參閱此處

貢獻

（↑最重要的是）我們一直在尋求擴大對源分離和語音增強研究的報導，以下是我們缺少的事情的列表。你想貢獻嗎？這是一個很好的起點！

• 波普特（Zeghidour and Grangier）
• furcanext（Shi等人）
• DeepCasa（劉和想要）
• Kadioglu等人的VCTK測試集。
• 中斷和級聯的坑（Yang等人）
• 一致性矛盾（Wisdom等人）
• 可抵抗的stoi和pesq。
• Tukuljac等人的參數化濾紙。
• 端到端的Misi（Wang等人）

不要忘記閱讀我們的貢獻指南。

您還可以打開問題或製作公關以添加我們在此列表中錯過的內容。

張板可視化

默認記錄器是所有配方中的張量。從食譜文件夾中，您可以運行以下內容以可視化所有運行的日誌。您還可以通過從數據集導演中運行類似命令來比較同一數據集上的不同系統。

 # Launch tensorboard (default port is 6006)
tensorboard --logdir exp/ --port tf_port

如果您遠程啟動張板，則應打開SSH隧道

 # Open port-forwarding connection. Add -Nf option not to open remote.
ssh -L local_port:localhost:tf_port user@ip

然後打開http://localhost:local_port/ 。如果兩個端口都是相同的，則可以單擊遙控器上給出的張板URL，這更實用。

指導原則

（↑最高內容）

• 模塊化。人們認為構建塊並設計為無縫插入在一起。 FilterBanks，編碼器，掩蔽器，解碼器和損失都是常見的構建塊，可以以靈活的方式組合來創建新系統。
• 可擴展性。使用新功能擴展小行星很簡單。非常容易地添加新的過濾庫，分離器體系結構，數據集甚至食譜。
• 可重複性。食譜提供了一種簡單的方法來通過單個腳本進行數據準備，系統設計，培訓和評估來重現結果。這是社區的重要工具！

引用小行星

（↑最重要的內容）如果您喜歡使用小行星，並且想引用我們，請使用以下方式：

 @inproceedings { Pariente2020Asteroid ,
    title = { Asteroid: the {PyTorch}-based audio source separation toolkit for researchers } ,
    author = { Manuel Pariente and Samuele Cornell and Joris Cosentino and Sunit Sivasankaran and
            Efthymios Tzinis and Jens Heitkaemper and Michel Olvera and Fabian-Robert Stöter and
            Mathieu Hu and Juan M. Martín-Doñas and David Ditter and Ariel Frank and Antoine Deleforge
            and Emmanuel Vincent } ,
    year = { 2020 } ,
    booktitle = { Proc. Interspeech } ,
}