school-timetable-manual/14-comprendere-i-punteggi.md

# 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 (0–100)

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](13-generazione-orario.md)).

> **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](15-revisione-orario.md#scheda-conflitti-conflicts)).

> **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](15-revisione-orario.md)) 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**.

> [Immagine: scheda Scores con grafico a barre delle categorie e grafico radar] —
> Didascalia: la scomposizione mostra quali obiettivi sono soddisfatti e quali no.

## 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](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi).

---

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

---

[← Precedente: Generazione dell'orario](13-generazione-orario.md) · [Indice](README.md) · [Successivo: Revisione e confronto →](15-revisione-orario.md)