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

87 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 14. Comprendere i punteggi di qualità
Ogni versione di orario generata riceve dei **punteggi** che ne misurano la
qualità. Capirli vi permette di **confrontare** le versioni e di scegliere con
consapevolezza, invece di affidarvi 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 avete 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: guardate
> 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. Potete 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/dalla 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/una docente (per
> esempio non ha indicato un giorno libero), per lui/lei quella categoria vale come
> pienamente soddisfatta e non penalizza il punteggio.
## Dove leggete i punteggi
- **Nella lista delle versioni** ([Revisione](15-revisione-orario.md)) vedete il
**composito** di ciascuna versione, utile per un confronto immediato.
- **Nella scheda "Scores"** del dettaglio vedete la **scomposizione per categoria**
con grafici a barre e radar, e anche il **dettaglio per singolo docente**.
![Scheda Scores con grafici e scomposizione](img/review-report.png)
## Come usare i punteggi nella pratica
- **Confrontate due versioni** guardando prima il composito, poi le categorie: una
versione può avere composito più basso ma essere migliore proprio
sull'aspetto che a voi sta più a cuore.
- **Individuate il punto debole:** la categoria con il valore più basso vi dice cosa
migliorare. Se, ad esempio, "Orario compatto" è basso, aumentate il peso della
compattezza nel preset e rigenerate.
- **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 traducete le priorità
del vostro istituto in numeri. Rivedete [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)