Doporučení písní z Kancionálu k aktuální liturgii

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žíšiPří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