Initial commit: clean slate as of 2025-09-16

Author: Amir-Ivry

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,17 @@
+## Describe the bug / feature request
+
+**Environment:**
+- Python: 
+- OS: 
+- GPU/CPU:
+- PyTorch: 
+
+**Steps to Reproduce / Desired Behavior:**
+1. 
+2. 
+3. 
+
+**Logs / Screenshots:**
+```
+<paste here>
+```

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Summary
+Describe the change.
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] Lint passes (`ruff`, `black`)
+- [ ] Docs updated (if needed)

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt --index-url https://download.pytorch.org/whl/cpu
+          pip install -r dev-requirements.txt
+      - name: Lint
+        run: |
+          ruff check .
+          black --check .
+      - name: Tests
+        run: |
+          pytest -q

.gitignore

@@ -0,0 +1,26 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+
+# Results and artifacts
+results/
+
+# Audio files (large assets)
+*.wav
+
+# OS / IDE files
+.vscode/
+.DS_Store
+Thumbs.db
+.idea/
+
+# GitHub specific
+.github/
+
+# Testing
+tests/

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.0.1 — 2025-09-12
+- Fix single-GPU embedding to return CPU tensors (prevents GPU OOM and .numpy() errors).
+- Add GPU→CPU fallback in diffusion maps when CUDA OOM occurs.
+- Add robust import and fallback for `scipy.optimize.linear_sum_assignment`.
+- Clamp audio after loudness normalization and silence benign pyloudnorm warnings.
+- Introduce experiment logger writing to `experiment.log`.
+- Add GitHub repo auxiliary files and CI.

CITATION.cff

@@ -0,0 +1,25 @@
+cff-version: 1.2.0
+title: "MAPSS: Manifold-based Assessment of Perceptual Source Separation"
+message: "If you use this software, please cite it as below."
+authors:
+  - family-names: "Ivry"
+    given-names: "Amir"
+  - family-names: "Cornell"
+    given-names: "Samuele"
+  - family-names: "Watanabe"
+    given-names: "Shinji"
+version: "1.0.0" 
+date-released: "2025-09-11"  
+identifiers:
+  - type: "arxiv"
+    value: "2509.09212v1"
+  - type: "doi"
+    value: "10.48550/arXiv.2509.09212"
+keywords:
+  - "source separation"
+  - "perceptual metric"
+  - "audio signal processing"
+  - "self-supervised learning"
+  - "manifold learning"
+homepage: "https://arxiv.org/abs/2509.09212v1"
+license: "CC-BY-4.0" 

CODE_OF_CONDUCT.md

@@ -0,0 +1,5 @@
+# Code of Conduct
+
+We are committed to a welcoming and inclusive community. Be respectful,
+assume good intent, and collaborate constructively. Harassment or
+discrimination is not tolerated.

CONTRIBUTING.md

@@ -0,0 +1 @@
+

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.