Tournaments and bulk analysis

#Uploading many matches at once Pro

Bulk upload, beside Import on your matches page, takes a pile of match files, a folder or a .zip of them and analyses every match at one depth. It reads the same formats as Import (.mat, .ogxm, .xg, .bgf, .sgf), and opens the files in your browser: a .zip is never uploaded, and no match is saved until you press Analyse.

Before anything is sent, the dialog lists every file with its players, length and score. A file that matches one already in your matches, or another file in the same drop, is marked and left out unless you tick it. Then pick:

• the analysis depth every match is analysed at;
• whose games these are: if they are yours, the dialog asks which name in the files is you and suggests the one that appears most. If you did not play in them, choose I did not play in these, and the matches stay out of your own statistics;
• an optional event and year, written on every match;
• whether to be emailed when the last one is analysed.

Keep the page open while the files are sent. Each match starts analysing as soon as it arrives, so the first results land while the last files are still on their way.

#Following a bulk analysis

A bulk analysis has its own page, which the Bulk chip in the top bar opens while one is running. It shows every match with its state, the error rates once it is done, and an estimate of the time left. Bulk analysis runs at a lower priority than an analysis you start by hand, so a match you open and analyse meanwhile does not wait behind it. When the box is busy, the bulk analysis waits and the estimate says so.

Failed matches can be retried from that page with Retry failed, and Cancel the rest stops every match that has not started yet. When the last one is done you get one email for the whole upload, not one per match.

#Creating a tournament Pro

A tournament is a set of finished matches analysed at one setting, with standings, a cross-table, error rates per player and downloads. It is a results page, not a tournament manager: there are no pairings, no draws and no clocks. A match is in a tournament because you put it there.

Open Tournaments from your matches page and choose New tournament: a name, dates and place if you like, and the analysis setting, the engine and depth every match will be analysed at. That one setting is what makes the players' numbers comparable, so it is fixed for every match. Moving the whole tournament to another setting (Settings, Move to a new setting) re-analyses every match that does not have an analysis at the new one.

There are three ways to put matches in:

• Bulk upload with the tournament picked in the dialog: the matches are analysed at the tournament's setting, whatever depth the dialog shows.
• Add to tournament in the bar that appears when you select matches in your list, for matches you already have.
• When matches in your library are filed under the tournament's event, the Matches tab offers to add them. It never does so on its own.

A match you add keeps what you typed on it; the tournament fills in only the event details it is missing. A match can be in more than one tournament.

#Players and their spellings

Players are names in files, and files disagree: Smith, Pat, Pat Smith and PSmith may be one person. The Players tab lists each player with the spellings found for them, and points out names that look like the same person twice. Merge joins them; every match follows.

If you played in the tournament yourself, tick Me on your own row. Your matches then count in your own statistics, and everyone else's stay out of them.

#How the standings are worked out

Scores, games and gammons come from the games in each match. Error rates come from the analysis at the tournament's setting, and nothing else: a match that is still being analysed counts for results and not for error rates, and its row says so.

A player's XR is pooled over every decision they made in every analysed match, not the average of their match XRs, so a long match weighs more than a short one. The plain average is shown beside it as Avg, with the best and worst match. The number in brackets after an XR is how many matches stand behind it.

The ranking is chosen in Settings: first by match wins, match points, win percentage, XR or tournament points, then by tie-breaks in the order you put them (head-to-head among the tied players, match-point difference, XR, games difference, fewest matches played). Players still tied after every tie-break share a place, shown as 3=. The rule is printed under the standings in words. When the ranking uses XR, a player needs a minimum number of analysed matches to be ranked by it, so one excellent match does not win the event.

Tournament points score each match the way many clubs do: points for the win and points for the lower XR in that match, one each unless you change them. The XR points can go all to the player with the lower XR, or be shared in proportion to how far apart the two XRs are, with all of them going to the better player once the gap reaches a margin you set. You can also set a margin within which the XR points are split evenly, so 4.2 against 4.3 counts as a draw. XRs are compared as the page prints them, to two places. A match counts its win point at once and its XR points once both sides are analysed; until then the TP column marks the player with *.

The Charts tab draws every player's match XRs on one line, and XR against match wins: the chart that shows who played well and lost.

#Publishing the results

Settings, Sharing, has three levels:

Three switches decide what a shared page shows:

• Show error rates publicly (on by default) publishes every player's XR beside their name. Off, the page shows results, the cross-table and the highlights without any error rate.
• Matches viewable publicly lets anyone with the results page open every match and its analysis, read-only. Your notes on a match are never shown through a tournament.
• Allow downloads puts the standings and match lists on the page as CSV files, and the matches as .mat files when they are viewable.

A player who asks not to be named can be hidden: tick Hidden on their row in Players. They are shown as a numbered player everywhere the tournament is shared, their results stay in the standings and the cross-table, and the matches they played cannot be opened or downloaded from the shared page, since their name is in the files.

The shared page updates by itself while matches are being added and analysed. It shows Live while the event is running, and when it last refreshed.

#Embedding the standings

At a shared level, Sharing also gives an <iframe> snippet. Paste it into your club's website and the standings appear there, updating the same way. A visitor who clicks through gets the full results page.

#Mailing players their results Pro

You can give any player an email address, on their row in Players or by pasting name, email lines for the whole roster. The first time, you confirm that these players agreed to receive their results from HedgeHog. Addresses are visible to you only: never on a shared page or in a download.

When the event is over, Send results to players shows one player's email as they will see it and how many players it goes to. Each player gets one email with their finish, record, match points and XR, their best match, how the field did, and a link to their own results page, which works even while the tournament is private. Each player is mailed once: pressing again later mails only the players you have given an address since. While a match is still not analysed at the tournament's setting, you are asked before anything is sent. An address that bounced, or whose owner stopped tournament results email, is skipped. There is a daily limit on how many players are mailed, shown in the dialog; the rest go when you press again.

The Players tab shows how each row stands: no address, not mailed yet, mailed, or linked to the player's account. A player who linked themselves through their results link shows as such, with an Undo in case the link reached the wrong person.

#Your results from a tournament

When a director mails you your results, the link opens your own results page: your finish, record and XR in every match. To keep them, create a free account with the address the email came to, or sign in and press This is me. Your results then appear under My tournaments, where your matches open read-only with their analysis.

Tournament matches stay out of your own statistics until you import them. Import, or Import all, copies a match and its analysis into your own matches, from your side of the board, without analysing it again; that needs a Standard or Pro plan. The copy is yours from then on, whatever the director later does with theirs. Unlink takes an event off My tournaments and leaves anything you imported where it is.

The results email has a link to stop tournament results email to your address, and nothing else about your account changes. HedgeHog news is sent to that address only if you ask for it on your results page.

#Downloading the results

Settings, Export, downloads the standings, the match list, and one row per player per match as CSV files that open in a spreadsheet, plus every match as .mat files (or .ogxm with its analysis) in a .zip. The numbers in the CSV files are the same ones the page shows.