Paul Scherrer Institut, CH-5232 Villigen PSI, Switzerland

Home       Members       Registration       Results       Statistics


Supported Bridge Tournament Types

                                                                                                         Pairs with
                                        #                                                                No Sit-out
   #      #             #     #    #   Brd                                                First   Last   or Pairs who
Players Pairs Type    Tables Rnds Brds Sets Score-sheet      Score-Template              Sit-out Sit-out  are Fixed
======= ===== ====    ====== ==== ==== ==== ===========      ==============              ======= =======  ===========
   8      4   Howell     2     6   12   6   how-04p.py    ../cgibin/private/slips/how-04p.py                  1
   8      4   Howell     2     6   18   6   how-04p.py    ../cgibin/private/slips/how-04p.py                  1
*  8      4   Howell     2     6   24   6   how-04p.py    ../cgibin/private/slips/how-04p.py                  1
   8      4   Howell     2     6   30   6   how-04p.py    ../cgibin/private/slips/how-04p.py                  1

* 10      5   How-SO     2     5   20  10   How-05p-20b.tex  how-05p-20b.res                   1    5         -
  10      5   How-SO     2     5   24  10   How-05p-24b.tex  how-05p-24b.res                   1    5         -
  10      5   How-SO     2     5   26  10   how-05p-26b.tex  how-05p-26b.res                   1    5         -
  10      5   How-SO     2     5   30  10   how-05p-30b.tex  how-05p-30b.res                   1    5         -

  12      6   Howell     3     5   10  10   how-06p-10b.tex  how-06p-10b.res                                  6
  12      6   Howell     3     5   20  10   how-06p-20b.tex  how-06p-20b.res                                  6
* 12      6   Howell     3     5   24  10   How-06p-24b.tex  how-06p-24b.res                                  6
  12      6   Howell     3     5   26  10   how-06p-26b.tex  how-06p-26b.res                                  6
  12      6   Howell     3     5   30  10   how-06p-30b.tex  how-06p-30b.res                                  6

* 14      7   How-SO     3     7   21   7   How-07p-21b.tex  how-07p-21b.res <---------+-->    1    7         -
  14      7  HowMov-SO   3     7   21   7   HMS-07p-21b.tex  hms-07p-21b.res <---------+-->    7    5         7
  14      7   How-SO     3     7   28   7   How-07p-28b.tex  how-07p-28b.res <---------+-->    1    7         -
  14      7  HowMov-SO   3     7   28   7   HMS-07p-28b.tex  hms-07p-28b.res <---------+-->    7    5         7
                                                                                       |
  16      8   Howell     4     7   21   7   how-08p-21b.tex  how-08p-21b.res           |                      8
* 16      8   Howell     4     7   28   7   How-08p-28b.tex  how-08p-28b.res           |                      8
                                                                                       |
  18      9 3/4-How-SO   4     8   24   8   h34-09p-24b.tex  h34-09p-24b.res           |       1    8         9
  18      9   How-SO     4     9   18   9   how-09p-18b.tex  how-09p-18b.res           |       1    9         -
* 18      9   How-SO     4     9   27   9   How-09p-27b.tex  how-09p-27b.res <---------|-+-->  1    9         -
  18      9  HowMov-SO   5     9   27   9   HMS-09p-27b.tex  hms-09p-27b.res <---------|-+-->  9    2         9
                                                                                       | |
  20     10 3/4-Howell   5     8   24   8   h34-10p-24b.tex  h34-10p-24b.res <-+       | |                 9,10
* 20     10   Howell     5     9   27   9   How-10p-27b.tex  how-10p-27b.res   |       | |                   10
  20     10  DblHesMit   5     7   21   7   dhm-10p-21b.tex  dhm-10p-21b.res   |       | |                1,2,3
  20     10   Mitchell   5     5   25   5   mit-10p-25b.tex  mit-10p-25b.res   |       | |            1,2,3,4,5
                                                                               |       | |
* 22     11 DblHesMit-SO 5     8   24   8   Dhm-11p-24b.tex  dhm-11p-24b.res   |   +-> | |     9   10     1,2,3
  22     11  3/4-How-SO  5     9   27   9   h34-11p-27b.tex  h34-11p-27b.res   |   |   | |     1    9     10,11
                                                                               |   |   | |
* 24     12  DblHesMit   6     8   24   8   dhm-12p-24b.tex  dhm-12p-24b.res   |   |   | |              1,2,3,4
  24     12   Howell     6    11   22  11   how-12p-22b.tex  how-12p-22b.res   |   |   | |                   12
  24     12  3/4-Howell  6     9   27   9   h34-12p-27b.tex  h34-12p-27b.res   |   |   | |             10,11,12
                                                                               |   |   | |
* 26     13  HesMit-SO   6     8   24   8   hmi-13p-24b.tex  hmi-13p-24b.res   |   | +-|-----> 7    8 1,2,3,4,5
  26     13   How-SO     6    13   26  13   how-13p-26b.tex  how-13p-26b.res   |   | | | |     1   13         -
                                                                               |   | | | |
* 28     14   Hes-Mit    7     8   24   8   hmi-14p-24b.tex  hmi-14p-24b.res   |   | | | |          1,2,3,4,5,6
  28     14   Howell     7    13   26  13   how-14p-26b.tex  how-14p-26b.res   |   | | | |                   14
  28     14  Mitchell    7     7   21   7   mit-14p-21b.tex  mit-14p-21b.res   |   | | | |        1,2,3,4,5,6,7
                                                                               |   | | | |
*  8     --  Individual  2     7   21   7   ind-08p-21b.tex  ind-08p-21b.res   |   | | | |
* 12     --  Individual  3    11   22  11   ind-12p-22b.tex  ind-12p-22b.res   |   | | | |
* 16     --  Individual  4    12   24  12   ind-16p-24b.tex  ind-16p-24b.res   |   | | | |
* 20     --  Individual  5     6   20   6   ind-20p-20b.tex  ind-20p-20b.?.res | <-|-|-|-|-+
                                                                               |   | | | | |
* 24     --  Individual  6    12   24  12   ind-24p-24b.tex  ind-24p-24b.res   |   | | | | |
* 25     --  Individual  6    12   24  12   ind-24p-24b.tex  ind-25p-24b.res   | <-|-|-|-|-|-+
* 26     --  Individual  6    12   24  12   ind-24p-24b.tex  ind-26p-24b.res   | <-|-|-|-|-|-+
                                                                               |   | | | | | |
* 28     --  Individual  7     7   21   7   ind-28p-21b.tex  ind-28p-21b.res   |   | | | | | |
* 29     --  Individual  7     7   21   7   ind-28p-21b.tex  ind-29p-21b.res <-|-+ | | | | | |
* 30     --  Individual  7     7   21   7   ind-28p-21b.tex  ind-30p-21b.res <-|-+ | | | | | |
                                                                               | | | | | | | |
* 32     --  Individual  8     8   24   8   ind-32p-24b.tex  ind-32p-24b.res   | | | | | | | |
                                                                               | | | | | | | |
^                                                                              | | | | | | | |
|                                                            board sharing ----+ | | | | | | |
+-------- * = recommended                                                        | | | | | | |
          ? = under test                       Use ind-28p-21b.tex score sheet --+ | | | | | |
                                               Use ind-24p-24b.tex score sheet ----|-|-|-|-|-+
                                                                                   | | | | |
         Note: these pair numbers are as used on the "Score Sheet Generation"   ---+ | | | |
           webpage, i.e. in the range 1, 2, .., 11. The numbers on the score         | | | |
           slips are 1, 2, 3, 5, 6, ... 12, where Pair 4 is the "Phantom Pair".      | | | |
                                                                                     | | | |
         Note: these pair numbers are as used on the "Score Sheet Generation"   -----+ | | |
           webpage, i.e. the range 1, 2, .., 13. The numbers on the score slips        | | |
           are 2, 3, ... 14, where Pair 1 is the "Phantom Pair".                       | | |
                                                                                       | | |
         Note: these 7-Pair/21-Board and 7-Pair/28-Board Howell movements are ---------+ | |
           essentially the same. The difference is that the HMS versions have            | |
           a stationary pair. The pair numbers are as used on the "Score Sheet           | |
           Generation" webpage, i.e. in the range 1, 2, .., 7. The numbers on            | |
           the slips are 2, 3, 4, ... 8. Pair 1 is the "Phantom Pair".                   | |
                                                                                         | |
         Note: these 9 Pair, 27 Board Howell movements are essentially the --------------+ |
           same. The difference is that the second one allows one pair to be               |
           stationary. The pair numbers are as used on the "Score Sheet                    |
           Generation" webpage, i.e. in the range 1, 2, .., 9. The numbers on              |
           the slips are 2, 3, 5, 6, ... 10, where Pair 1 is the "Phantom Pair".           |
                                                                                           |
         Note: The "Individual-20-Player" movement is somewhat special. There is  ---------+
           one template file, ind-20p-20b.A.res for the first 5 rounds with 15 boards, and
           and a second one,  ind-20p-20b.B.res for the last round with 5 boards.
           BE CAREFUL: The last 5 board numbers are 17-21, NOT 16-20!
           ==========

            -SO        ==> with Sit-Out
            Howell     ==> Full Howell
            How        ==> Full Howell
            HowMov     ==> Full Howell with Moving Sit-out Pair
            3/4-Howell ==> 75%  Howell
            3/4-How    ==> 75%  Howell
            Mitchell   ==> Full Mitchell
            Hes-Mit    ==> Hesitation Mitchell
            DblHesMit  ==> Double Hesitation Mitchell
   [README    Revision: 1.50       Date: 2018/12/12 15:09:20]

Tournament Preparation

Tournament preparation is most conveniently done using the Club's Web interface
as described in the following section. Should the Web be inaccessible, an
alternative method is described in the section Tournament Preparation by Hand.

Tournament preparation consists of:

  a) printing travellers, a.k.a. score sheets, for each board to be played, and

  b) generating a Results Template File, referred to simply as a Template File
     in the following, into which the scores will be entered for calculation of
     the tournament result using the bcs software.

Tournament Preparation using the Internet

The following notes describe how to print the travellers for a tournament
and how to obtain the correcponding template file via the Club's Web
interface.

Note: Tournament preparation is restricted to certain "authorised"
       members of the Club. The Generate Score Sheet button
       described below will only be visible to these members.

One starts at the Club's registration page:

    https://clubs.web.psi.ch/bridge/cgibin/public/bridge_reg_status.py

which is similar to this:

Score Sheet 1

Click on the "Register" button of the tournament of interest, log-in
if necessary, and click on the"Generate Score Sheet" button. A new page
similar to the following should appear:

Score Sheet 2

in which any last un-paired player will have been excluded, and remaining un-paired
players will have been paired randomly. By setting pair numbers in the "Set Pair
Number" drop-down menus, and clicking the "Randomise and/or Reorder" button,
the pairs can be assigned pair numbers as desired. For example, it is convenient if
the tournament director is given the number of a stationary pair. The tournament type should
also be selected in the "Select a Tournament Type" drop-down menu.

On clicking the "Generate" button, a template file and a pdf file for printing
out the travellers are generated. A new page is displayed as shown:

Score Sheet 3

The template file and travellers pdf file can be downloaded by right-clicking on the
corresponding links. Note that the template file has a name of the form:

           mm-dd-xxxxxxx.res

where mm and dd are the month and day of the tournament. It is important
to keep this prefix if the results are later to be published on the Club's Web page.
Be careful when downloading the template file that the name remains as shown. It should
not, for example, have an extra suffix such as ".txt" added to it. This may happen,
especially if downloading to a Macintosh computer.

Tournament Preparation by Hand

Should the Club's Web Pages not be accessible for any reason, it is still
possible, although considerably more complicated and error-prone, to prepare
travellers and template file on the PSI llc "Large Linux Cluster". The following
presents the steps involved. The description refers to a 7 pair, 28 board Howell
tournament but any of the other tournament types can be processed similarly.

a) One needs a so-called AFS account so that one can log-in to the llc.psi.ch
   linux cluster.

b) Log-in on llc.psi.ch and ensure that you are running with the bash shell. If
   you are unsure, you can check by issuing the command:

     > echo $SHELL

   the response should be:

     /bin/bash

   If there is no response, you are probably using the csh or tcsh shell.
   You could confirm this by issuing the command:

     > echo $shell

   for which the response should be:

     /bin/tcsh

  If necessary, change to using the bash shell by issuing the command:

     > bash --login

c) Set up the BCS environment by issuing the commands:

     > alias BCS="source /afs/psi.ch/project/clubs/webhosting/bridge/bin/Linux/bcs-init.sh"
     > BCS

   If you are going to be calculating the results regularly, you may want to
   add the "alias" command to your $HOME/.bash_profile startup script. In
   future you will then only have to issue the "BCS" command to set up the
   BCS environment.

d) Obtain a results template file for the tournament which you want
   to score. The results templates are found in the directory:

        $BCS_BASE/sheets/

   For example, the template file for a 7 pair Howell tournament with
   28 boards is:

        $BCS_BASE/sheets/how-07p-28b.res

   See the file $BCS_BASE/cgibin/private/slips/README, listed at the top of
   this Web page, for a complete list of the available template files.

   Make a copy of the template file to your current directory and make it
   editable, e.g.

     > i=ind-16p-24b.res
     > cp $BCS_BASE/sheets/$i ./mm-dd-$i
     > chmod 666 ./mm-dd-$i

   Note: The copied template file is given a prefix mm-dd-, where
         mm and dd are the two-digit month and day of the tournament. This
         convention is important if the results are later to be published on the Club's Web page.

   The template file copy can then be prepared using your favourite text editor. It
   is required to set:
                      - the tournament date and time;
                      - the "keys" identifying the pair members.
  +---------+
  | WARNING |  Be extremely careful to get the correct date. If the date
  +---------+  is more than 12 months in the past, the result calculation
               program will refuse to process the data.
  +---------+
  | WARNING |  Be extremely careful not to disturb any of the preset data
  +---------+  in the template file. These define the order in which the
               various boards are played by the various players.

e) Generating the travellers is somewhat more tiresome, so tiresome in fact, that I am
   suspending this documentation for the time being ... the obsolete notes below
   will have to suffice in the meantime.

How to Calculate the Scores

a) It is assumed that one has already prepared a results template file as described
   above. One will also need an account on the PSI llc.psi.ch computer. One should
   login there and set up the BCS environment as described above.

   The results template file can be edited using one's favourite text editor.
   There should be only 1 result on each line of the file. Here are some
   examples of valid results:

      - -          = all PASS
      - *          = NOT played
      3s n -2      = 3 spades by North, who made 7 tricks.
      3hx e =      = 3 hearts doubled by East, who made 9 tricks.
      3dxx s 2     = 3 diamonds redoubled by South, who made 11 tricks.
      2c w -1      = 2 clubs by West, who made 7 tricks.
      3nt e =      = 3 No Trump by East, who made 9 tricks.

b) Issue the command:

     > bcs-do-results.sh <NameOfTemplateFile>

   to process the results file. If all the results are syntactically correct,
   the results will be displayed together with some suggested commands for
   getting a print-out of the results.

   If there is a syntax error and you are lucky, the program should display
   an indication of what the error is. If you are less lucky, the command:

     > (export BCS_SCOREF=bcs.scoref; bcs score last)

   may help. Finding the location of the error can, occasionally, be difficult.
   It pays, in the long run, to be very careful not to make typing mistakes!

c) In order to compare the displayed results with the scores on the score
   slips, you may find the following command useful:

     > bcs-list <NameOfTemplateFile>

d) To get the results displayed on the Web, send this results template file to
   Vjeran, Danek, John or David. They will use a script called:

        bcs-publish

   to put the results on the Web. Should none of these people be available, the
   command to use is:

        bcs-publish <NameOfTemplateFile> in $BCS_BASE

   Be careful to forget neither the "in" nor the "$".

#-------------------------------------------------- End of $RCSfile: NOTES,v $
   [NOTES     Revision: 1.42       Date: 2018/12/12 15:09:19]

How to prepare Score Sheets (or Travellers)

The following notes are obsolete, but are retained for historical interest.
They describe how score sheets (also known as travellers) used
to be prepared for a tournament. Today, those club members with the
appropriate privilege are able to prepare travellers via the
Club's Registration Web-page.

In the table of supported movements, there is a column of file names
headed "Score-sheet". These files are located in directory:

   $BCS_BASE/cgibin/private/slips

If the file is a so-called python script (its name is of the form ???.py),
simply execute the file to get help on how to use it.

If the file is a LaTex file (its name is of the form ???.tex), it
must be processed using the latex utility. First of all, one must
generate an include file called "Players.tex". An example is:

  \nc{\mydate}{{\tiny 14-Jul-2014}}
  \nc{\Title}{A Title}
  %
  \nc{\playerA}{\makebox[16mm]{Irene     }}     % CI  Pair 1
  \nc{\playerB}{\makebox[16mm]{Mona      }}     % CM 
     .
     .
     .
  \nc{\playerM}{\makebox[16mm]{Bozena    }}     % KB  Pair 7
  \nc{\playerN}{\makebox[16mm]{Vladimir  }}     % KV 

Then the travellers can be generated via a command of the form:

    pdflatex $BCS_BASE/cgibin/private/slips/How-07p-28b

The travellers will be in the file How-07p-28b.pdf.
Remember that this file should be printed double-sided on
A4 paper.

This page is maintained by David and Vjeran

bridge_gen_sheets.py     last modified on   Wed Dec 12 16:09:36 2018


PSI Home Page