michiguel/Ordo

Changes

• improve speed and output with -i switch is used.

Changes from v1.2

• Optimize group processing (adopted from ordoprep).
• Optimize calculation post-convergence (diversity, etc.)
• Switch --timelog added. It outputs time stamps at each step of the calculation
• This version fixes bugs from v1.2.2 (release deleted)

Changes

• Long option switches implemented
• When a name from exclude/include file do not match the names from the input PGN file/s, issue a warning and continue
• --no-warnings was implemented to silence the above mentioned warnings.

New help

usage: ordo [-OPTION]

 -h, --help               print this help and exit
 -H, --show-switches      print switch information and exit
 -v, --version            print version number and exit
 -L, --license            print license information  and exit
 -q, --quiet              quiet mode (no progress updates on screen)
     --silent             same as --quiet
 -Q, --terse              same as --quiet, but shows simulation counter
 -a, --average=NUM        set rating for the pool average
 -A, --anchor=<player>    anchor: rating given by '-a' is fixed for <player>
 -V, --pool-relative      errors relative to pool average, not to the anchor
 -m, --multi-anchors=FILE multiple anchors: file contains rows of 
                          "AnchorName",AnchorRating
 -y, --loose-anchors=FILE loose anchors: file contains rows of 
                          "Player",Rating,Uncertainty
 -r, --relations=FILE     relations: rows of 
                          "PlayerA","PlayerB",delta_rating,uncertainty
 -R, --remove-older       no output of older 'related' versions (given by -r)
 -w, --white=NUM          white advantage value (default=0.0)
 -u, --white-error=NUM    white advantage uncertainty value (default=0.0)
 -W, --white-auto         white advantage will be automatically adjusted
 -d, --draw=NUM           draw rate value % (default=50.0)
 -k, --draw-error=NUM     draw rate uncertainty value % (default=0.0 %)
 -D, --draw-auto          draw rate value will be automatically adjusted
 -z, --scale=NUM          set rating for winning expectancy of 76% (default=202)
 -T, --table              display winning expectancy table
 -p, --pgn=FILE           input file, PGN format
 -P, --pgn-list=FILE      multiple input: file with a list of PGN files
 -o, --output=FILE        output file, text format
 -c, --csv=FILE           output file, comma separated value format
 -E, --elostat            output files in elostat format (rating.dat, 
                          programs.dat & general.dat)
 -j, --head2head=FILE     output file with head to head information
 -g, --groups=FILE        outputs group connection info (no rating output)
 -G, --force              force program to run ignoring isolated-groups warning
 -s, --simulations=NUM    perform NUM simulations to calculate errors
 -e, --error-matrix=FILE  save an error matrix (use of -s required)
 -C, --cfs-matrix=FILE    save a matrix (comma separated value .csv) with 
                          confidence for superiority (-s was used)
 -J, --cfs-show           output an extra column with confidence for superiority
                          (relative to the player in the next row)
 -F, --confidence=NUM     confidence to estimate error margins (default=95.0)
 -X, --ignore-draws       do not take into account draws in the calculation
 -t, --threshold=NUM      threshold of games for a participant to be included
 -N, --decimals=<a,b>     a=rating decimals, b=score decimals (optional)
 -M, --ML                 force maximum-likelihood estimation to obtain ratings
 -n, --cpus=NUM           number of processors used in simulations
 -U, --columns=<a,..,z>   info in output (default columns are "0,1,2,3,4,5")
 -Y, --synonyms=FILE      name synonyms (comma separated value format). Each 
                          line: main,syn1,syn2 or "main","syn1","syn2"
     --aliases=FILE       same as --synonyms FILE
 -i, --include=FILE       include only games of participants present in FILE
 -x, --exclude=FILE       names in FILE will not have their games included
     --no-warnings        supress warnings of names from -x or -i that do not 
                          match names in input file
 -b, --column-format=FILE format column output, each line being 
                          <column>,<width>,"Header"

Changes from 1.1.6

• switch -N includes two parameters. For instance, -N 2 will output ratings with two decimals. If an extra parameter is provided separated by comma, it will control the number of decimals for the score percentage. For example, the default is actually -N 0,1 or -N "0,1". If a second parameter is not provided, the default is used.

Changes

Column width is adjusted automatically if the user provides a low number. This is based on the widest item in the column

Changes from 1.1.0

A switch was added to simplify multiple input files control column format in the output

• -P <file> text file containing a list of PGN file names (multiple input)

The number of input files is now limited by the system memory.

Changes from 1.0.9.8

A switch was added to control column format in the output

• -b <file> format column output, each line being <column>,<width>,"Header"

This switch controls the width of each column in the output and the header of each column.
This <file> consists of a text in which each line has <column>,<width>,"HeaderName".
For instance, if you want to have the item 4 (games total, see manual.pdf), to be 5 characters wide and be named "Points", you will have to include a line like this:

4,8,"Points"

Changes from 1.0.9.5

Two switches added to select games from the input file/s

• -i <file> include only games of participants present in <file>
• -x <file> names in <file> will not have their games included

In certain situations, the user may want to include/discard in the calculation only a subset of the games present in the input file/s. Switches -i <file> and -x <file> are used for this purpose. Switch -i includes only the games of participants listed in <file>. In this file, each participant name has to be in different lines. Also, each of those names may or may not be surrounded by quotes. Both are accepted. For this reason, if a .csv file is provided as a list of participants, only the first column is read. In addition, -x could be use to exclude games of participants listed in <file>.

• In the output, the column that contains the score (%) was removed of the symbol %.