% McMahon per i tornei italiani
% Francesco Potortì 10k
% 2024-2025 $Revision: 1.9 $

# Introduzione {.unnumbered}

Se stai leggendo perché sei principiante, sappi che per fare gli accoppiamenti ci sono due regole fondamentali che per te sono la parte più importante di questo documento.  Una è la regola di accoppiamento, che è la frase in grassetto nella sezione [Accoppiamenti](#accoppiamenti).  L'altra è la regola di pescaggio, eccezione principale alla regola di accoppiamento, che è la frase in grassetto nella sezione [Eccezioni alla regola di accoppiamento](#eccezioni-alla-regola-di-accoppiamento-il-pescaggio).

Questo documento contiene due sezioni: la prima sono i miei appunti tratti dal Corso da gestore di Torneo di Carlo Metta 4d, integrati con qualche osservazione frutto di discussioni con Metta.

La seconda sono mie note varie che potrebbero essere utili a chi impara l'argomento (perlomeno a me sarebbero state utili) e contengono qualche nota di approfondimento per chi vuole capire di più.


# Appunti dal Corso da gestore di Torneo di Carlo Metta 4d

Ho scritto questi appunti partendo dalle tre lezioni ([1](https://youtu.be/kUlV-jRGuSU "Video on youtube FIGG channel"), [2](https://youtu.be/t5SLTz75pOM "Video on youtube FIGG channel"), [3](https://youtu.be/_r-XAURjI7o "Video on youtube FIGG channel")) del corso tenuto e registrato da Carlo Metta 4d su come usare il [programma MacMahon](https://www.cgerlach.de/go/macmahon.html) per gestire un torneo italiano.  Gli appunti non sono esaustivi e non sostituiscono il corso, ma contengono le informazioni per me meno ovvie.

Il corso ha un'impostazione molto pratica: spesso le ragioni delle scelte di base non sono spiegate, e le alternative possibili non sono menzionate o solo accennate.  Sono invece spiegate in dettaglio quando chi gestisce un torneo si può trovare davanti a una scelta e deve quindi conoscere i criteri da applicare.

Il corso è indirizzato a gestori di tornei italiani, si assume una top bar di 8 giocatori e un numero di giocatori da 20 a 50.  Fuori da questi limiti è bene che il gestore approfondisca la teoria per conto proprio e abbia pratica.  Un modo di impratichirsi, suggerito da Metta nel corso, è di scaricare da EGD un passato Campionato Italiano e riprodurlo sul programma MacMahon, sforzandosi di comprendere le scelte di accoppiamento fatte e, nel caso di chiedere aiuto a un arbitro esperto.  Il [CI 2016](https://europeangodatabase.eu/EGD/Tournament_Card.php?&key=T161001S) è un buon esempio per cominciare.


## Impostazioni globali

Sotto `Torneo / Modifica impostazioni` appare una finestra con 8 schede.  Le sottosezioni successive indicano per queste schede quali sono le pimpostazioni più comuni per un torneo italiano.

Invece di indicarle una per una da zero, si possono importare da un torneo precedente con il comando `Torneo / Importa le impostazioni da un altro torneo`.  Un esempio di torneo da cui copiare impostazioni corrette è il torneo di primavera di Pisa 2025 (tappa Figg) di cui scaricare e importare il [file MacMahon](torneo-pisa-primavera-2025.xml).

### Impostazioni principali

- Nome del torneo: appare nelle tabelle e nell'esportazione dati per EGD
- Numero di turni: nei tornei italiani su due giorni, tipicamente 5
- Dimensione del goban: 19x19
- Permetti jigo: no
- Usa il rating: sì
- Determina il grado in base al rating: no
- Il rating determina il punteggio iniziale: sì
- Barra MacMahon superiore: vedi [Top bar](#top-bar)
- Barra McMahon inferiore: vedi [Accoppiamenti in bottom bar](#accoppiamenti-in-bottom-bar))
- Bye: no
- Arrotonda in basso al più vicino punteggio pieno: sì
- tranne se il ½ punto deriva da un jigo: sì

### Altre schede

[TODO: impostazioni delle altre schede]


## Gor e grado

Gli accoppiamenti si fanno in base al gor (rating).  Il grado dichiarato dal giocatore viene ignorato e impostato a quello corrispondente al gor, a meno che un giocatore [non sia ancora presente su EGD o chieda una promozione](#nuovi-giocatori-e-promozioni).


## Graduatoria

La graduatoria del torneo è basata sul valore di MMS, che in MacMahon 3.9 è chiamato Score.  A parità di MMS i criteri usati per lo spareggio sono, nell'ordine, Sos e Sosos.

[TODO: espandere su cosa sono Sos e Sosos e quali sono altri criteri di spareggio]

[TODO: spiegare cosa sono i gruppi del McMahon e sono implementati nel programma MacMahon]

[TODO: chiarire che McMahon è il criterio, mentre MacMahon è il programma]


## Top bar

La top bar serve perché i giocatori candidati ai primi posti devono partire nello stesso gruppo, quindi devono partire a pari punti.  Si imposta un limite (la barra superiore) in gradi (per esempio da 3 kyu) e i giocatori sopra la barra partono tutti con lo stesso punteggio.  Analogamente è possibile,ma non necessario, impostare una bottom bar, una barra inferiore (tipicamente da 18 kyu) sotto la quale i giocatori partono tutti con lo stesso punteggio (ma vedi sotto [Accoppiamenti in bottom bar](#accoppiamenti-in-bottom-bar)).

[TODO: distinguere meglio il concetto di barra (limite fra gruppi) dal concetto di gruppi, per esempio evitando di chiamare "top bar" il gruppo sopra la tob bar]

Nei tornei italiani da 5 turni, a meno di non  sapere bene quel che si sta facendo, si fa una top bar da 8 giocatori.  Top bar da 12 giocatori con 5 turni è sconsigliabile, da 16 molto sconsigliabile: in entrambi i casi si rischia di non poter assegnare la vittoria del torneo.

Se il primo gruppo sotto la barra è distante un punto di MMS, tutto a posto.  Se è distante più di uno, si allarga la top bar di MacMahon fino a includerne alcuni altri (idealmente 4, in seconda scelta 2), che nella scheda walllist di MacMahon saranno tutti marcati in giallo.  Sempre dalla scheda walllist si marcano i primi 8 come super top bar, che diventeranno rossi.  In questo caso, quella che qui continuiamo a chiamare top bar per MacMahon si chiama super top bar.

Oltre a impostare il grado della barra, si imposta lo stesso grado come limite per l'handicap, in modo che chi gioca in top bar giochi senza handicap.  Se per includere 8 giocatori la distinzione di grado non è sufficiente, si può impostare la barra usando il gor, con l'apposita scelta nelle impostazioni.

Se ci sono giocatori a pari gor a cavallo della barra, per ottenere una top bar di 8 giocatori si può forzare una graduatoria fra di loro cambiando il loro gor.  Nel caso italiano, l'opzione di usare il gor è attivata, e MacMahon usa il gor solo per ordinare i giocatori e assegnar loro un MMS iniziale.  Quindi il gor si può impostare arbitrariamente per ogni giocatore, purché si resti nello stesso intervallo di grado.

Per esempio, al torneo di primavera di Pisa 2025 ([file MacMahon](torneo-pisa-primavera-2025.xml)) c'erano due giocatori a gor 1800, e sette giocatori sopra 1800.  Quindi la barra fu impostata a 1802 e uno di essi (scelto dall'arbitro) fu forzato a gor 1802 entrando così in top bar.

McMahon definisce i gruppi come fasce di gor distanti multipli di 100 dalla barra, quindi se la barra non è un multiplo di 100 giocatori di grado diverso si possono trovare nello stesso gruppo, e giocatori dello stesso grado in gruppi diversi.


### Ingressi e uscite dalla top bar durante il torneo

In generale, aggiungere o togliere un giocatore dalla top bar è un problema [TODO: spiegare perché e i criteri usati per ovviare].

Se un giocatore che non gioca tutti i turni ha un gor prossimo alla barra, lo si può forzare fuori dalla top bar.  È quel che successe al torneo di primavera di Pisa 2025 ([file MacMahon](torneo-pisa-primavera-2025.xml)), dove un giocatore con gor 1843 si presentò al secondo turno per giocare due sole partite.  Essendo la barra a 1802, bastò forzare il suo gor a 1801 e tenerlo così fuori dalla top bar.


## Accoppiamenti

All'interno di un gruppo l'accoppiamento si può fare in diversi modi.  Supponendo che il numero di giocatori sia pari, allora le due regole di accoppiamento più comuni sono:

- spezza e ripiega (split and fold)
- spezza e scorri (split and slide)

Il primo è quello trattato nel corso per arbitri di Carlo Metta, il secondo è trattato nella [sezione Spezza e scorri](#spezza-e-scorri) come variazione del primo.  Nel seguito assumiamo lo spezza e ripiega come **regola di accoppiamento**.  Spezza e ripiega significa che, ad esempio in un gruppo di 8 giocatori, gli accoppiamenti saranno 1-8, 2-7, 3-6, 4-5.  La regola di accoppiamento si applica a partire dal giocatore più in alto, che va accoppiato con l'ultimo.  Tolti il primo e l'ultimo (1 e 8 nell'esempio), si continua così, perché il primo è il 2 e l'ultimo è il 7 e così via.  Quindi la regola di accoppiamento è: **il primo giocatore libero di un gruppo si accoppia con l'ultimo libero dello stesso gruppo**.

Una volta assunta una regola di accoppiamento, è necessario gestire le eccezioni, cioè i casi in cui non è possibile o non è desiderabile seguirla, e che nei tornei italiani sono implementate forzando gli accoppiamenti su MacMahon.

### Accoppiamenti in top bar

Se ci sono 8 giocatori in top bar, nel secondo turno si formano due gruppi da 4 giocatori.  Quello dei vincitori **va accoppiato per gor**.  Quello dei perdenti, unito ai vincitori del gruppo successivo, va anch'esso accoppiato per gor.  Per questa ragione è bene che nel gruppo sotto la top bar ci sia un multiplo di 4 giocatori.  [TODO: c'è modo in generale di fare un gruppo multiplo di 4 giocatori sotto la top bar o è solo una speranza?]

Bisogna attivare la visualizzazione del rating (gor) nella scheda walllist del MacMahon, almeno durante gli accoppiamenti del primo e secondo turno, perché MacMahon elenca i giocatori nello stesso gruppo McMahon in ordine alfabetico, ignorando il gor, quindi l'ordine va pensato guardando il gor visualizzato.

**Dal terzo turno in poi non si usa più il gor**, ma la classifica standard (Mms, Sos, ecc.).  Quindi dal quarto turno in poi la top bar non serve più, e le marcature gialla e rossa indicati dal MacMahon per i giocatori in top bar vanno ignorati, se non come promemoria che per quei giocatori non va usato l'accoppiamento automatico.

Nel Campionato Italiano i giocatori in top bar sono tenuti a giocare tutti i turni,  Nelle tappe minori in cui non c'è abbondanza di giocatori, se ci sono giocatori che non giocano tutti i turni e sono abbastanza forti da stare per forza in top bar, si può cercare di evitare che giochino con i possibili vincitori del torneo.


### Colori in top bar

Solo al primo turno si impostano manualmente i colori, in maniera che i primi quattro giocatori abbiano colori sfalsati: 1 e 3 nero, 2 e 4 bianco (o  viceversa).


### Eccezioni alla regola di accoppiamento: il pescaggio

Le eccezioni sono necessarie quando non si possono o non si vogliono fare accoppiamenti con la regola di accoppiamento, per via di uno dei casi discussi in questa sottosezione.  Questo avviene tipicamente in tutti i tornei a partire dal quarto turno, e in molti anche prima.  Un'eccezione si implementa forzando gli accoppiamenti.

Quando è necessario applicare un'eccezione, si adotta questa **regola di pescaggio** per creare l'accoppiamento forzato:

 1. il primo della coppia è il primo da accoppiare del gruppo
 2. il secondo è l'ultimo del gruppo successivo (cioè viene pescato da sopra)

Quindi la regola di pescaggio è **il primo giocatore libero di un gruppo si accoppia coll'ultimo libero del gruppo successivo**.

Esistono altre regole di pescaggio, ma qualunque sia la regola adottata, pescare sotto **penalizza** il pescatore e il pescato, che vanno entrambi marcati come penalizzati.  I giocatori vanno marcati come penalizzati ricordandoselo a memoria, o annotando i loro nomi a parte, non c'è una funzione per farlo nel programma MacMahon.

#### Numero dispari di giocatori in un gruppo

Si applica la regola di pescaggio, dopodiché il primo gruppo avrà un numero pari di giocatori e si applica la regola di accoppiamento.


### Accoppiamento vietato o indesiderabile

Un accoppiamento effettuato secondo la regola di pescaggio può essere forzato diversamente per diversi motivi, eccone una lista in ordine di importanza approssimatamente decrescente:

- hanno già giocato insieme (motivo insanabile)
- hanno chiesto di non giocare insieme (motivo forte)
- pescaggio sotto che ha come conseguenza altri pescaggi sotto nel gruppo
- pescaggio con il pescato o il pescatore o entrambi già marcati come penalizzati

Inoltre, un accoppiamento può soddisfare i criteri strutturali, ma essere indesiderabile per vari motivi di opportunità, qui una lista di nuovo dal più al meno importante:

- accoppiamento che non soddisfa gli scopi del torneo (vedi seguito)
- uno ha perso (vinto) le prime 3 e va a perdere (vincere) di nuovo
- sono familiari, o stranieri connazionali
- sono dello stesso club, o bambino con adulto

Per evitare un accoppiamento vietato o indesiderabile fra un primo e un secondo giocatore, si cerca un secondo alternativo nel gruppo del primo, il più vicino possibile al secondo giocatore escluso.  Se impossibile o indesiderabile, si cerca nel gruppo successivo, partendo dal basso, e se necessario si va al gruppo ancora successivo.


### Accoppiamenti per decisione arbitrale

L'arbitro è libero di ignorare tutti i criteri sopra e decidere un accoppiamento specifico, generalmente per soddisfare un scopo preciso.  In questo caso l'arbitro deve essere pronto a giustificare la proprio scelta davanti ai giocatori, agli interessati e alla Commissione Tecnica Figg. Gli scopi del torneo che giustificano un accoppiamento diverso da quelli base possono essere qualunque.  Il più comune riguarda l'ottenere una classifica affidabile per i primi posti, che sono quelli coinvolti nell'assegnazione dei punti tappa dei tornei tappa Figg.  Un altro scopo possibile riguarda il Campionato Italiano, dove è bene che giochino fra loro i candidati ai primi tre o quattro posti, per evitare se possibile che siano necessari spareggi per la designazione dei finalisti.

[TODO: esempio quinto turno del torneo di primavera di Pisa 2025 ([file MacMahon](torneo-pisa-primavera<-2025.xml)]]


# Appunti di arbitraggio

Questi sono miei appunti ispirati da mie letture e da discussioni con arbitri esperti come Carlo Metta 4d e Roberto Foschi 1d, tenendo conto che questi appunti  non sono intesi per riflettere le loro opinioni.  Si tratta delle opinioni che mi sono fatto personalmente da ignorante appassionato dell'argomento.


## Criteri dell'accoppiamento McMahon

I tornei McMahon sono eseguiti secondo un criterio descritto ad esempio [sulla wikipedia](https://en.wikipedia.org/wiki/McMahon_system_tournament) e sulla [Sensei library](https://senseis.xmp.net/?McMahonPairing), e in pratica organizzati usando il [programma MacMahon](https://www.cgerlach.de/go/macmahon.html).

Le [regole EGF per i tornei](https://www.eurogofed.org/egf/toursysrules.htm) sono una lettura raccomandata per approfondire.  Un esempio di regole ben definite per un torneo italiano sono le [Regole per il campionato Italiano 2024](https://figg.org/il-go/tornei/127-tornei-italiani/1192-regole-per-il-campionato-italiano-2024).


### Spezza e scorri

La regola di accoppiamento più popolare è spezza e ripiega, che è quella trattata nel capitolo [Appunti dal Corso da gestore di Torneo di Carlo Metta 4d](#appunti-dal-corso-da-gestore-di-torneo-di-carlo-metta-4d).  Questa regola è quella storicamente adottata nella gran parte dei tornei italiani.

Un'altra regola di accoppiamento popolare è spezza e scorri.  Spezza e scorri significa che, ad esempio in un gruppo di 8 giocatori, gli accoppiamenti saranno 1-5, 2-6, 3-7, 4-8.

Quando si usa spezza e ripiega come regola di accoppiamento, è naturale usare la regola di pescaggio trattata nel capitolo detto, cioè _il primo giocatore libero di un gruppo si accoppia coll'ultimo libero del gruppo successivo_.  Quando invece si usa spezza e scorri come regola di accoppiamento, ha senso usare questa regola di pescaggio:

 1. il primo della coppia (quello che pesca sotto) è quello al centro del gruppo
 2. il secondo è quello al centro del gruppo successivo (quello che viene pescato da sopra)

Quindi la regola di pescaggio diventa _il giocatore libero di mezzo di un gruppo si accoppia col giocatore libero di mezzo del gruppo successivo_.

Un esempio di applicazione della regola di accoppiamento spezza e scorri e della regola di pescaggio nel mezzo è il torneo di primavera di Pisa 2026 ([file MacMahon](torneo-pisa-primavera-2026.xml))

[TODO: fare un riassunto degli altri criteri McMahon principali]


## Nuovi giocatori e promozioni

Un giocatore di prima iscrizione, cioè che non ha un grado su EGD, viene iscritto al torneo con un grado giudicato in qualche modo dall'arbitro, per esempio chiedendo il grado su piattaforme online, o chiedendo ad altri giocatori conosciuti che ci abbiano giocato di recente.  Un'errata valutazione distorce i risultati del torneo: se il  giocatore è sottovalutato, i suoi avversari si troveranno penalizzati in maniera diretta; se è sopravvalutato, i suoi avversari si troveranno avvantaggiati, e indirettamente i loro avversari si troveranno penalizzati di conseguenza.

Quando un giocatore chiede una promozione, cioè di essere iscritto a un grado maggiore di quello corrispondente al suo gor su EGD, l'arbitro giudica con criterio analogo a quello usato per una prima iscrizione.  Analogamente quando l'arbitro viene a sapere che il grado di un giocatore su EGD è sottovalutato, anche se il giocatore non richiede una promozione.

Secondo Metta il controllo che il giocatore sia in effetti prossimo al livello di prima iscrizione o di promozione, secondo la tradizionale prassi FIGG, può essere lasco per promozioni fino a 6k.  Per promozioni a un grado fra 5k e 1k deve essere stretto, tenendo conto solo di tornei precedenti e partite dal vivo con giocatori ben conosciuti, mentre non si fanno promozioni a gradi superiori a 1k.

La promozione si effettua in fase di registrazione del giocatore, prima che giochi la sua prima partita del torneo.

È possibile promuovere solo se si salta di almeno due gradi oltre il massimo grado dichiarato nella storia del giocatore su EGD, come indicato dal testo relativo su EGD:

> If a rank professed by the player had improved significantly (at least by 2 grades for amateur players or by 1 professional grade) with respect to the highest previously professed rank, the rating of the player is reset.

Si possono fare promozioni, ma non retrocessioni.


### Promozione su MacMahon

Ci sono due cose su cui istruire il MacMahon: come fare gli accoppiamenti (e quindi impostare il gor giusto) e come spiegare a EGD che si tratta di una promozione (e quindi impostare il grado dichiarato giusto).

Esempio: al torneo di primavera di Pisa 2025 ([file MacMahon](torneo-pisa-primavera<-2025.xml)) [un giocatore](https://www.europeangodatabase.eu/EGD/Player_Card.php?key=20401458) fu promosso da 5k a 3k.  Per ottenere questo risultato, nella scheda del giocatore su MacMahon furono forzate due impostazioni: gor a 1800 e grado dichiarato a 3k.


## Accoppiamenti in bottom bar

Purtroppo se la top bar è impostata con il gor, il MacMahon 3.9 impedisce di impostare una bottom bar.  Non so se è intenzionale o è un baco.

Se tutti i giocatori in top bar sono di grado più alto di tutti i giocatori fuori dalla top bar, allora non è un problema, e si può impostare la top bar col grado [TODO: verificare che questo sia vero].  Se invece ci sono giocatori di pari grado sia dentro che fuori della top bar, allora è necessario impostare la top bar col gor, e McMahon 3.9 non lascia definire la bottom bar.  Ovviare non è banale ma si può, con questa procedura che va ripetuta ad ogni turno [TODO: verificare la procedura suggerita]:

 1. si imposta la top bar con il gor
 2. si forzano gli accoppiamenti di chi sta sopra la top bar
 3. si imposta la top bar con il grado
 4. si attiva la bottom bar
 5. si fa il resto degli accoppiamenti
 6. si reimposta la top bar con il gor

In alternativa si fanno a mano non solo gli accoppiamenti della top bar, ma anche gli altri, tenendo conto manualmente della bottom bar, o alla peggio si rinuncia alla bottom bar.


## Risultati

I risultati finali si visualizzano nella Walllist, curando di attivare l'opzione `Turno / Considera il turno in corso`.

### Caricare i risultati su European Go Database (EGD)

Prima di caricarli su EGD bisogna (nelle impostazioni di Mcmahon)

 1. dare un nome adeguato al torneo
 2. verificare che i giocatori abbiano un club corretto
 3. verificare il [grado dichiarato dei giocatori promossi](#promozione-su-macmahon)).

Poi da `Torneo / Esporta per lo European Go Database` esportare il torneo nel [formato apposito per EGD](torneo-pisa-primavera-2025.egd.txt).  Il file va quindi caricato nella [sezione amministrativa di EGD](https://europeangodatabase.eu/EGD/EGD_2_0/welcome.php).

[TODO: spiegare i dati da caricare e i controlli da fare su Egd durante il caricamento, in particolare per le promozioni e per handicap reduction 9]
