Docs: pool, releases, NMF, Bauer, recalibration; model commands in the README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 03:36:27 +00:00
co-authored by Claude Opus 5.5
parent a9fd04e113
commit 7d656834fb
2 changed files with 20 additions and 0 deletions
+12
View File
@@ -55,3 +55,15 @@ cp deploy/traefik-airplay.yaml /data/coolify/proxy/dynamic/airplay.yaml # Cool
``` ```
After `cargo build --release`, run `systemctl restart airplay-web`. The daily collection runs `airplay model rank` afterwards, so the site refreshes by itself. After `cargo build --release`, run `systemctl restart airplay-web`. The daily collection runs `airplay model rank` afterwards, so the site refreshes by itself.
## Models
```
airplay rotations [--wayback] [--reparse] DR rotation-list PDFs -> rotation_lists
airplay model calibrate [--out FILE] rotation thresholds from the lists
airplay model adds [--h 0,4] backtest of the new-add model -> docs/BACKTEST-ADDS.md
airplay model backtest [--h 1,4,8] backtest of weekly plays / in rotation -> docs/BACKTEST.md
airplay model ifpi 20-year IFPI test bed -> docs/IFPI.md
airplay model nmf [--out FILE] New Music Friday Denmark vs DR adds
airplay model rank forecasts for the site (forecasts table)
```
+8
View File
@@ -89,3 +89,11 @@ airplay model rank [--h 4] [--max-h 12] [--top 50] the ranking for h = 1..12 -
- **Rotation lists** (`airplay rotations [--wayback] [--reparse]`, src/rotations.rs). Parses DR's PDF from glyph positions, with category headers, columns and the P3 summary page; decoration (rotated text) is dropped. Each page's channel comes from where its artists are played. Old lists came from the Wayback Machine's copies of DR's rotation page, giving **29 weekly lists from May 2023 to Nov 2026** in `rotation_lists`. - **Rotation lists** (`airplay rotations [--wayback] [--reparse]`, src/rotations.rs). Parses DR's PDF from glyph positions, with category headers, columns and the P3 summary page; decoration (rotated text) is dropped. Each page's channel comes from where its artists are played. Old lists came from the Wayback Machine's copies of DR's rotation page, giving **29 weekly lists from May 2023 to Nov 2026** in `rotation_lists`.
- **Thresholds from the lists** (`airplay model calibrate`, docs/CALIBRATION.md). The six lists inside the DR window put "in rotation" at P3 23, P4 13–15, P5 10, P6 16 and P8 7 plays a week, about three times the old play-distribution guess. Every model now uses these. - **Thresholds from the lists** (`airplay model calibrate`, docs/CALIBRATION.md). The six lists inside the DR window put "in rotation" at P3 23, P4 13–15, P5 10, P6 16 and P8 7 plays a week, about three times the old play-distribution guess. Every model now uses these.
- **IFPI test bed** (`airplay model ifpi`, docs/IFPI.md): routes and lead–lag per chart period, and a 2010–2026 walk-forward test of Track Top-40 entry → Airplay Top-20 within 8 weeks. - **IFPI test bed** (`airplay model ifpi`, docs/IFPI.md): routes and lead–lag per chart period, and a 2010–2026 walk-forward test of Track Top-40 entry → Airplay Top-20 within 8 weeks.
## Update 15 Nov 2026 (later): wider pool, release dates, NMF, Bauer, recalibration
- **Artist pool.** The panel no longer holds only artists DR played in one week. DR artist ids now also come from stored artist pages: artists credited on tracks DR has played, and groups an artist belongs to. Band members alone are left out. That's about 8,000 artists, with sources in `dr_artist_sources`. Every artist's page is refreshed weekly, oldest first (daily cap 1,500).
- **Release dates.** `deezer_releases` holds every DR artist's Deezer discography (singles, EPs, albums) via `deezer_artists`. The add model gains release recency, releases in the past year, and "releases in the window". The ranking reports P(add | releases in the window), and the blend with P(release) from the artist's two-year release rate (`p_release`). The site has a switch for the two, and a release toggle in the what-if.
- **Recalibration.** The add model's probabilities get a Platt map fitted honestly: an inner model trained on windows closed before the last 6 origins predicts those origins.
- **NMF.** SuperFridayChart artist pages give every NMF placement per artist since 2022 (`nmf_artist_tracks`), including songs DR never played. Track pages give the countries, fetched for placements inside the modelling window first. Before a track page is read, NMF Denmark is recognised by its follower count. `airplay model nmf` compares DR adds after releases on NMF Denmark, on NMF elsewhere and not on NMF, raw and with controls.
- **Bauer.** The site shows each artist's plays per Bauer station over the last 7 days, with songs. Bauer has no lists or history, so Bauer adds join the model once the daily logs cover a few weeks.