Skip to content

xkoranate-CE 0.4.2

Latest

Choose a tag to compare

@github-actions github-actions released this 05 Nov 05:22
· 19 commits to main since this release
ba4c059

OOC

This release brings with it a litany of bug fixes, and three new features. The first is native inter-conference play. The second is auto-formatting of qualified/eliminated entrants (You no longer have to do the permutation maths yourself!), and the third is a new handy-dandy help menu and better documentation on how to use the app. You'll find that in the help section on the ribbon. -Mertagne

To download the program, scroll down to the Assets section at the bottom of this page and download the correct file for your operating system.

Downloads

These builds are unsigned/unnotarised, so your OS may warn on first launch (macOS Gatekeeper, Windows SmartScreen) - you'll need to explicitly allow the app to run.

  • macOS (Apple Silicon): xkoranate-0.4.2-macos-arm64.zip → unzip, then run xkoranate.app.
  • macOS (Intel): xkoranate-0.4.2-macos-x86_64.zip → unzip, then run xkoranate.app.
  • Windows: xkoranate-0.4.2-windows.zip → unzip, then run xkoranate\xkoranate.exe.
  • Linux: xkoranate-0.4.2-linux.tar.gz → extract, then run xkoranate/xkoranate.

xkoranate-CE 0.4.2

A feature and fix release on top of 0.4.1. Events, tables, signup lists and settings carry over untouched. Events saved before this release also work with the new qualification markers.


Inter-conference round robin

A new competition type for a league split into conferences. Each group is one conference. (#66, closes #24)

  • Two kinds of fixtures. Teams play a round robin inside their own conference (Legs in conference, default 2) and also meet every team in the other conferences (Legs v others, default 1). Set it to 0 to keep the conferences apart.
  • A fair, repeatable schedule. Cross-conference matchdays are spread evenly through the season, and the same teams always give the same schedule. Conferences can be different sizes; teams just sit out the odd matchday.
  • Tables per conference, plus an optional Overall table. Each conference's table counts all of its teams' games, including games against other conferences.
  • Separate points for cross-conference games through Win v others. Until you change it, it uses the same points as games inside a conference.
  • Headings use your group names, e.g. Pacific v Atlantic, and the setup step says "Conferences".

The schedule is ported from @blackmage37's prototype on #24, with three of its problems fixed: repeated fixtures with five or more conferences, a team playing twice on one matchday when conferences differ in size, and a shuffled order that changed every run. Partial cross play, rotating division matchups and division-record tiebreakers, as used by the NFL, are not in this release.

Qualification markers

A new Format qualifications box on the Scorinate step marks entrants who have mathematically qualified (Q) or been eliminated (E). (#68)

  • Three rules: Top X, Top X in each group, and Top X in each group + best N of the teams one place below the cut, compared across groups.
  • Works in round robin, inter-conference and mass-start heats. In league tables the marker gets its own column right after the points. In heats it's added to the end of each line.
  • A marker is never wrong. A tie on the table's first sort rule always counts against the team being judged, so a Q or E can show up a matchday later than you'd expect, but never too early.
  • Changing the rule updates every matchday straight away, with no re-roll. Markers are added when results are shown or exported, like the BBCode option, so your saved results stay plain.
  • Older events work too. League tables saved before this release get markers. Old heats events have no saved heat ranks, so in best-N mode their teams one place below the cut stay unmarked.

User manual

  • A rewritten user guide for organisers rather than developers. It covers installing the app (including getting past the Windows and Mac warnings), every step of event setup, importing signups and the mistakes to avoid, knockout brackets, posting with BBCode, the table generator, troubleshooting, and a glossary. (#62)
  • Two new walk-throughs: Your first event builds a football group stage, and Your first race sets up a women's 100 m final with a screenshot of each step. (#62, #67)
  • Help › xkoranate manual opens it. The shortcut is F1, or ⌘? on macOS. F1 in the table generator opens the table generator page. (#62)
  • The site's Light, Dark and True Dark colours match the app.

Fixes

Freezes

  • Shooting events froze on a tie they couldn't shoot off. The mixed-team 10 m air pistol, 10 m air rifle and trap events have no shoot-off data, so a tie at the cutoff or on the podium was re-shot forever. The tie now stands. (#64)
  • Rugby union—NSFS knockouts froze on a level shootout. The sport file had no kick probability, so no kick ever went in. It now uses 0.65, the same as the other rugby sports. Any sport whose shootout can't separate two sides now skips the shootout and settles the tie with a coin toss instead. The original C++ program froze here too. (#71)

Crashes

  • Field-event finals with fewer than 8 athletes crashed, because the top eight get extra attempts. (#72)
  • Decathlon, heptathlon and pentathlon points for a slow time crashed. Times past the formula's cut-off now score 0 points, as in the scoring tables. (#72)
  • A DNF in an event that shows decathlon points, or in a sport where higher scores win (Summer vigil fasting), crashed. (#72)
  • Sorting by "Win percentage (draws ignored)" crashed when a side's games so far were all draws. (#72)
  • "View match odds" for NSFS baseball crashed on a 0-100 field. (#72)
  • Boxing and taekwondo league tables crashed on a stoppage (KO, DSQ, RSC). A stoppage now counts as a 1-0 win for the winner. Before, it was credited to the loser. (#63)

Wrong results or lost data

  • Unsaved work was lost when a save didn't happen. Choosing Save at the unsaved-changes prompt and then cancelling Save As threw your changes away without warning. In the table generator, Save at that prompt acted like Discard. Both now keep your work. A save that fails to write shows an error and keeps the unsaved state. (#70)
  • Importing a signup file left Maximum skill at 1, so a field ranked 0-100 was scored on its raw ranks in every sport that rescales skill. An import now raises the maximum to the highest imported skill. (#72)
  • Taekwondo matches with negative scores dropped out of round-robin tables from the next matchday on. (#65)
  • A knockout's empty bracket leaked into the next event you opened and showed up as a stray heading in its results. (#61)
  • Golf course table: editing a cell pushed every later hole down one, and green edits were saved somewhere nothing reads. (#72)
  • Gaelic and Australian football extra time printed as ( (0) – (0)). (#72)
  • Archery and shooting showed the no-cutoff text when reopening an event that had a cutoff. (#72)
  • A failed participant import (unreadable file, or not UTF-8) stopped later participant edits from reaching the event. (#72)

Several of these bugs are probably in the C++ original too, so this release moves the port further from matching it exactly but corrects some stagnant issues that are present. We have tried to preserve backwards compatibility with existing tournament XMLs where possible.

Under the hood

  • About 1,900 fewer lines of code, with no change in behaviour. The ~25 sort-rule modules are now one table, and paradigms, competitions, file reading and writing, and the UI share common helpers. (#69)
  • A sweep tool, tools/sweep.py, scorinates every sport file under every competition type it offers and groups any failures. It found most of the fixes above.
  • 736 tests, up from 457 at 0.4.1, including a regression test for each fix above.

Full changelog: v0.4.1...v0.4.2