Files
school-timetable-manual/14-comprendere-i-punteggi.md
T
2026-07-16 00:40:05 +02:00

4.3 KiB
Raw Blame History

14. Comprendere i punteggi di qualità

Ogni versione di orario generata riceve dei punteggi che ne misurano la qualità. Capirli ti permette di confrontare le versioni e di scegliere con consapevolezza, invece di affidarti all'impressione. Questo capitolo spiega cosa significano, senza formule complicate.

Le due domande a cui rispondono i punteggi

  1. L'orario è valido? → lo dicono i vincoli rigidi.
  2. Quanto è buono? → lo dice il punteggio composito e la sua scomposizione per categoria.

Il punteggio composito (0100)

Il punteggio composito riassume la qualità complessiva in un unico numero da 0 a 100: più è alto, migliore è l'orario. È una media pesata dei singoli obiettivi di qualità, dove i "pesi" sono quelli che hai scelto nel preset di generazione (cap. 13).

La regola più importante. Se un orario viola anche un solo vincolo rigido, il suo punteggio composito è forzato a 0, indipendentemente da quanto sia buono sul resto. Un composito pari a 0 è quindi un campanello d'allarme: guarda subito la scheda dei conflitti (cap. 15).

Il composito è assoluto. Ogni versione è valutata per conto proprio, non "in classifica" rispetto alle altre. Puoi quindi confrontare direttamente i compositi di due versioni: 82 è meglio di 75.

Le categorie di qualità

Il composito nasce dalla combinazione di più categorie, ciascuna delle quali misura un aspetto dell'orario con un valore da 0 a 1 (spesso mostrato come percentuale): 1 = pienamente soddisfatta, 0 = del tutto disattesa.

Categoria Cosa misura
Slot preferiti Quanti degli orari preferiti dai docenti sono stati effettivamente usati.
Slot da evitare Quanto si è riusciti a non usare gli orari che i docenti volevano evitare.
Preferenza mattino Quanta parte delle lezioni cade al mattino, per chi lo preferisce.
Orario compatto Quanto le lezioni di ogni docente sono consecutive, senza "buchi".
Tempo di viaggio Quanto sono contenuti gli spostamenti tra plessi.
Giorno libero Se il giorno libero preferito dal docente è stato rispettato.
Distribuzione delle classi Quanto le ore di una stessa classe sono distribuite su più giorni (invece di ammassarsi).
Tragitto casa-scuola Quanto è contenuto il tragitto da casa alle sedi.

Categorie non applicabili. Se una categoria non riguarda un docente (per esempio non ha indicato un giorno libero), per lui quella categoria vale come pienamente soddisfatta e non penalizza il punteggio.

Dove leggi i punteggi

  • Nella lista delle versioni (Revisione) vedi il composito di ciascuna versione, utile per un confronto immediato.
  • Nella scheda "Scores" del dettaglio vedi la scomposizione per categoria con grafici a barre e radar, e anche il dettaglio per singolo docente.

Come usare i punteggi nella pratica

  • Confronta due versioni guardando prima il composito, poi le categorie: una versione può avere composito più basso ma essere migliore proprio sull'aspetto che a te sta più a cuore.
  • Individua il punto debole: la categoria con il valore più basso ti dice cosa migliorare. Se, ad esempio, "Orario compatto" è basso, aumenta il peso della compattezza nel preset e rigenera.
  • Non inseguire il 100. Gli obiettivi sono spesso in conflitto tra loro (ridurre i buchi può aumentare gli spostamenti, e viceversa): un buon orario è un compromesso equilibrato, non un punteggio perfetto ovunque.

Legame con i pesi della generazione

I pesi scelti in fase di generazione decidono quanto ciascuna categoria incide sul composito. Alzare il peso di una categoria spinge il motore a curarla di più, tipicamente a scapito di altre. È il meccanismo con cui traduci le priorità del tuo istituto in numeri. Rivedi Generazione — pesi.


Vediamo ora la pagina in cui tutti questi dati si consultano e si confrontano: la Revisione.


← Precedente: Generazione dell'orario · Indice · Successivo: Revisione e confronto →