O projektu
Písně ke mši je nástroj pro varhaníky a všechny, kdo hledají vhodné písně ke mši svaté. Zadáte datum, zvolíte formulář mše a aplikace navrhne písně z katolického Kancionálu, které tematicky odpovídají liturgickým textům daného dne.
Co aplikace zobrazuje?
- Čtení a antifony — texty z lekcionáře pro vybraný den.
- Direktář — doporučení z publikace Direktář pro varhaníky, pokud pro daný den existuje.
- Doporučené písně — seřazené podle toho, jak dobře odpovídají liturgickým textům. Proužky u každé písně ukazují míru shody s jednotlivými čteními.
Jak doporučování funguje?
Aplikace porovnává texty čtení s texty písní a pomocí AI algoritmů hledá tematickou podobnost. Písně z příslušné liturgické doby (adventní, vánoční, postní, velikonoční) dostávají mírný bonus. Čím více čtením píseň tematicky odpovídá, tím výše se v doporučeních umístí.
Doporučení jsou pouze orientační — aplikace hodnotí tematickou podobnost textu, ale neposoudí, zda je píseň pro daný den opravdu liturgicky vhodná. Nad výběrem je vždy třeba se zamyslet a případně jej konzultovat s knězem.
▶Technické detaily
Jak porovnávání funguje
Texty se převádějí na číselné vektory (embeddingy) pomocí AI modelu multilingual-e5-base. Podobnost textů se pak měří jako vzdálenost těchto vektorů.
Výpočet skóre
Skóre každé písně kombinuje dvě složky:
- Sémantická podobnost (85 %) — jak blízké je téma písně a čtení.
- Klíčová slova (15 %) — shoda konkrétních slov a výrazů pomocí algoritmu BM25 (k1 = 1,2, b = 0,75) s českým stemmerem.
Sezónní bonus
Písně z příslušné liturgické doby dostávají bonus 10 % ke skóre. V mezidobí se bonus aplikuje na písně z oddílů Obecné mešní, O Pánu Ježíši a Příležitostné.
Vyhodnocení
Váhy byly optimalizovány porovnáním s doporučeními z Direktáře pro varhaníky na sadě 33 liturgických dnů ze všech období a cyklů.
Zdroje dat
- Texty písní — kancional.cz
- Liturgická čtení — misal.liturgie.cz
- Direktář pro varhaníky — publikace Musica Sacra