DSBPlayerDTO Data Type

View model of a player and their DWZ evaluation result within a tournament.

The calculated values are given as numbers. Beside them the …DisplayString fields carry the very entry the Wertungsportal shows for the same value (SPS-34130): depending on the kind of player an entry may be empty, bracketed, combined with the coefficient index or the literal Erstdaten. Rendering those strings reproduces the evaluation display of the portal exactly.

Kinds of player

Told apart by member and eloPlayer:

  • Member – holds a DWZ. R0 and Rn are displayed as rating - index.
  • Elo player – rated by FIDE only. R0 is displayed as their Elo rating and K bracketed, since their games do not produce a DWZ. Rn stays empty unless they are a member, too.
  • Textual player – neither of the above. Their ratings are performance ratings, which per WO 3.4.3 are not a DWZ; the display marks them as such by bracketing them. They are therefore disclosed through the display strings only: ratingOld, indexOld, ratingNew, indexNew, birthyear and fideId are withheld from them.

Identity fields

  • playerUuid – UUID identifying this player's participation in the tournament. Can be used to retrieve the player's scoresheet.
  • nuLigaPersonId – nuLiga person ID. Can be used to retrieve the player's full tournament history.
  • firstname / lastname – Full name of the player.
  • birthyear – Year of birth. Withheld from textual players.
  • vkz – VKZ (Vereinskennzeichen) of the player's club.
  • memberNo – DSB member number.
  • clubName – Name of the player's club.
  • fideId – FIDE ID. Withheld from textual players, absent for players without one.
  • playerNo – Player's starting number within the tournament.
  • eloPlayer – Whether the player was an Elo player when entering the tournament.
  • member – Whether the player holds a DWZ as a member of the DSB.

DWZ evaluation fields

  • ratingOld / indexOld – R0: the DWZ and coefficient index the player entered the tournament with. Withheld from textual players.
  • ratingNew / indexNew – Rn: the DWZ and coefficient index the evaluation produced. Withheld from textual players.
  • factorK – DWZ K-factor: determines the weight of rating changes per game.
  • averageRatingCompetitors – Rc: average DWZ rating of all opponents faced.
  • wins – W: actual score achieved (1 = win, 0.5 = draw, 0 = loss).
  • numberOfGames – n: number of rated games played.
  • winsExpected – We: expected score based on rating differences against all opponents.
  • tournamentPerformance – Rh: DWZ performance rating for this tournament.

Display fields

The entries of the evaluation display, absent wherever the display leaves the column empty. Absent fields are omitted from the response rather than sent as null.

  • ratingOldDisplayString – R0 as displayed: 1400 - 10 for members, the Elo rating for Elo players, bracketed for textual players.
  • ratingNewDisplayString – Rn as displayed: 1420 - 11 for members, bracketed and without an index for textual players, Erstdaten for members who are still collecting their first rating, empty for Elo players who are not members. Erstdaten is reported where a player is the subject of an evaluation; where they appear as a participant of a game, the entry stays empty, just as the opponent column of the display leaves it empty.
  • factorKDisplayString – K as displayed, bracketed for Elo players.
  • winsExpectedDisplayString – We as displayed, with three decimals.
  • ratingDifference – Rn minus R0, the difference column of the display. Only defined for members whose evaluation produced a new DWZ.

Properties
name data type description
playerUuid string
nuLigaPersonId string
firstname string
lastname string
birthyear number
vkz string
memberNo number
clubName string
fideId number
playerNo number
eloPlayer boolean
member boolean
ratingOld number
indexOld number
ratingNew number
indexNew number
ratingOldDisplayString string
ratingNewDisplayString string
factorKDisplayString string
winsExpectedDisplayString string
ratingDifference number
factorK number
averageRatingCompetitors number
wins number
numberOfGames number
winsExpected number
tournamentPerformance number

Example

{
  "playerUuid" : "...",
  "nuLigaPersonId" : "...",
  "firstname" : "...",
  "lastname" : "...",
  "birthyear" : 12345,
  "vkz" : "...",
  "memberNo" : 12345,
  "clubName" : "...",
  "fideId" : 12345,
  "playerNo" : 12345,
  "eloPlayer" : true,
  "member" : true,
  "ratingOld" : 12345,
  "indexOld" : 12345,
  "ratingNew" : 12345,
  "indexNew" : 12345,
  "ratingOldDisplayString" : "...",
  "ratingNewDisplayString" : "...",
  "factorKDisplayString" : "...",
  "winsExpectedDisplayString" : "...",
  "ratingDifference" : 12345,
  "factorK" : 12345.0,
  "averageRatingCompetitors" : 12345,
  "wins" : 12345.0,
  "numberOfGames" : 12345,
  "winsExpected" : 12345.0,
  "tournamentPerformance" : 12345
}