home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / b / bridge / !AnalyData / !Analyser / !Help < prev    next >
Encoding:
Text File  |  1995-02-24  |  5.1 KB  |  135 lines
  1. This is a program to carry out some analysis of the scores obtained in
  2. a game of Duplicate Bridge.
  3.  
  4. Name    : !Analysis
  5. Version : 2.02
  6. Date    : 26th February 1994
  7. Author  : Matthew Wilcox
  8.  
  9. To run this program, simply double click on its icon to load it.  Set
  10. the number of boards played in the Options dialogue box (available
  11. from the icon bar menu).  Then drop a CSV file containing the Bridge
  12. game data in the correct format (described below) on the icon bar
  13. icon.  The program will then pop up a window displaying the scores
  14. obtained by each pair.  If a value of 5 or -5 is seen, this indicates
  15. that the contract was redoubled.  The proper values will be filled in
  16. eventually.  The raw file information may be saved from the menu and
  17. this produces an exact copy of the contents of this window.  The
  18. analysis save option saves a file in Impression DDF format and it is
  19. designed to be dropped into the !Template document provided with this
  20. program.  There is an Impression Style/Publisher version of this
  21. document supplied in this directory and an Impression II version in
  22. the 'Backup' directory.  The analysis provides the following
  23. information for each contract and each pair : Where they were sitting;
  24. what the contract was; who by; number of over or undertricks (€ means
  25. the contract was made with no overtricks); The deviation from the
  26. average and The IMPs calculated from this value.  
  27.  
  28.         The internal information
  29.  
  30. The program calculates the deviation of the score from the average of
  31. the two central values on each hand and these scores are then turned
  32. into IMPs on a scale.  This is the prescribed method for calculating
  33. IMPs (International Match Points) from scores.  
  34.  
  35.         The CSV file format
  36.  
  37. The files that I used were originally produced in Pipedream 4, so
  38. apologies for any strange blank slots appearing - these were to make
  39. the forms easy to fill in.  
  40.  
  41. Line 1 : ,,,"<string>"
  42.  
  43. This <string> must contain the word "home" or "away" followed by
  44. (anywhere after them in the string) "against " followed immediately by
  45. the name of the team that is being played against.
  46.  
  47. Line 2 : ,,,"<string>"
  48.  
  49. This <string> must contain the word "on ", followed immediately by the
  50. date on which the match was played.
  51.  
  52. Line 3 : ,,,"<names>",,,"<names>",,,"<names>",,,"<names>"
  53.  
  54. Each string <names> should contain the names of one of the four pairs. 
  55. It does not matter which order the pairs are listed in.
  56.  
  57. Line 4 : Is completely ignored.  It is for your purposes; ie to use
  58. for headings.
  59.  
  60. Lines 5 onwards :
  61. "<Vul>","<Num>","<Pos>","<Cont>","<By>","<Pos>","<Cont>","<By>","<Pos>","<Cont>","<By>","<Pos>","<Cont>","<By>"
  62.  
  63. <Vul> is the vulnerability.  This should be one of : 
  64. XX - No Vulnerability
  65. NS - North/South Vulnerable
  66. EW - East/West Vulnerable
  67. AL - All Vulnerable
  68.  
  69. <Num> is the contract number.  This is ignored by the program, so
  70. don’t enter the contracts in a funny order.
  71.  
  72. <Pos> is where the pair are sitting.  This should be either N(orth) or
  73. E(ast)
  74.  
  75. <Cont> is the contract that was bid.  This should be of the form
  76. 1NT+4*, so number of tricks bid, suit bid, overtricks, double(*) or
  77. redouble(**).  If everyone passes, this may be indicated in whichever
  78. way you prefer.  The crucial part is putting a dash in the next
  79. column.
  80.  
  81. <By> is who made the contract.  This may be N/S/E/W/- where - means
  82. all pass.
  83.  
  84. The last three columns are repeated four times as there are four pairs
  85. in a team.
  86.  
  87.         The Impression output file
  88.  
  89. This program is currently designed to produce output suitable for
  90. reading into Impression II/Junior.  There is a !Template document that
  91. was created in Impression II version 2.16 which contains a suitable
  92. set of styles and a grid that will tabulate the analysis data.  Please
  93. note that the analysis file contains the sum of the IMPs and not the
  94. IMPs of the sum.  
  95.  
  96.         The internal Data files
  97.  
  98. There are several files inside the Data directory.  The following
  99. information concerns each file
  100.  
  101. File    : Header
  102.  
  103. Description
  104.  
  105.         This text file is put at the top of the Analysis file. 
  106. Substitution is performed on any string placed inside % marks.  If you
  107. wish to put a % inside the output file, use %%.  If you want to have
  108. other strings than those at present substituted, add to the CASE
  109. structure in DEFPROCheadvar
  110.  
  111. File    : Bonuses
  112.  
  113. Description
  114.  
  115.         This file must be a CSV file.  It is a table of the scores
  116. which a pair would score if they successfully made a contract.  The
  117. headings are rather cryptic, but this is a very large table.  The
  118. first two letters are CD, HS or NT.  These translate as Minor suit,
  119. Major suit or No Trumps.  The third letter is either N(ot vulnerable)
  120. or V(ulnerable).  The fourth letter is N(ot doubled), D(oubled) or
  121. R(edoubled).  Please note that the program does not actually look at
  122. these headings, so don’t get clever and reorganise the columns!  The
  123. row headings are the number of tricks made followed by any overtricks. 
  124. Again, don’t swap any of the rows over.
  125.  
  126. NOTE    : This file is not complete as the values for redoubled
  127. contracts have not yet been filled in.
  128.  
  129. File    : Penalties
  130.  
  131. Description
  132.  
  133.         This file is similar to the Bonuses file but much smaller.  Do
  134. not reorganise these either.
  135.