From 7d656834fbb35df684079d7443bdbfbffcbfe6b5 Mon Sep 17 00:00:00 2001 From: moritsbw-cpu Date: Sun, 15 Nov 2026 03:36:27 +0000 Subject: [PATCH] Docs: pool, releases, NMF, Bauer, recalibration; model commands in the README Co-Authored-By: Claude Opus 5.5 --- README.md | 12 ++++++++++++ docs/MODELS.md | 8 ++++++++ 2 files changed, 20 insertions(+) diff --git a/README.md b/README.md index ce59098..c255ecb 100644 --- a/README.md +++ b/README.md @@ -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. + +## 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) +``` diff --git a/docs/MODELS.md b/docs/MODELS.md index b603f80..41708e4 100644 --- a/docs/MODELS.md +++ b/docs/MODELS.md @@ -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`. - **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. + +## 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.