Alesia Software - Kortgivningsprogrammel

1. Indledning

Kortgivningsprogrammellet fra Alesia Software har følgende formål:

• at fremstille edb-givne kortfordelinger på almindeligt tilgængeligt edb-maskinel (PC'er).
• at sikre at de givne kort er selvdokumenterende, så man altid med et øjekast kan bekræfte at de fordelinger man har i hånden er hvad de bør være.
• at sikre at forskellige brugere ikke kan komme til at generere de samme hænder.
• at skaffe kortfordelingerne til veje på flere uafhængige formater, herunder
  • pakket på en side, til udlevering til spillerne efter turneringen,
  • med en fordeling pr. side, til brug for offentliggørelse af regnskaber ved barometerturneringer,
  • i stort format, til brug ved rama-fremvisning,
  • på maskinlæsbar form, til brug som styredata til en kortduplikeringsmaskine,
  • på det internationale standardformat Portable Bridge Notation,
  • som optællinger, til statistisk brug,
  • med engelske eller danske betegnelser for kortene.

Hvis du har fået installeret programmellet, men ikke har kørt med det før, bør du læse afsnit 2 og 3 nedenfor, og skimme afsnit 4.

Hvis du først skal installere programmellet, finder du en vejledning i afsnit 5.

Sørg først for at omgivelserne er klar, fx:

• Hvis du vil bruge printer skal den være tændt og have papir i.
• Hvis du bruger spooler (programmet PRINT under DOS, eller et netværksprintprogram), skal du have startet spooleren (med en PRINT-ordre, eller måske med en netværksordre såsom CAPTURE eller SPOOL).
• Sørg for at maskinens dato og klokkeslæt er stillet nogenlunde rigtigt, dels af hensyn til dine udskrifter, dels for at styre maskinens lodtrækning bedst muligt. Brug evt. DOS-ordrerne DATE og TIME .

Stil dig i det "directory" hvor du har (eller vil have) dine turneringsspecifikationer. Eksempel (hvor vi har TUspecer i KORT på C-disken):

      C:

      CD \KORT

Start programmet (det hedder KG):

      KG

Herefter kan man klare sig ved at vælge i menuerne, svare på spørgsmål, og rette i TUspecerne.

Hvert sæt fordelinger som skal gives er beskrevet ved hjælp af en turneringsspecifikation. Den typiske arbejdsform er at give nye kort efter følgende opskrift:

• hent en gammel turneringsspecifikation frem fra en disk,
• giv den et nyt navn,
• ret lidt i indholdet
• giv kort ud fra den nye.

Den TUspec man arbejder på vises øverst på skærmen, som man kan se på billedet nedenfor.

+------------------------ Turneringskode: 90100642 ------------------------+    
|Turnering, runde, etc.: 3. division vest, 2. runde                        |    
|            Spilledato: 6.-7. oktober 1990                                |    
|       Sektionsbogstav: Y                                                 |    
|            Antal spil: 40                                                |    
|                                                                          |    
|                                                                          |    
|                                                                          |    
+--------------------------------------------------------------------------+    

TUspecens navn, som kaldes turneringskoden, er på 8 tegn. Hver ny TUspec skal have sit eget navn; hermed sikrer man at to forskellige TUspecer aldrig giver anledning til samme fordelinger. Den viste TUspec hedder 90100642; det skal forstås som følger:

901006	er spilledatoen.
4	er en kode for 3. division vest.
2	er et løbenummer for dette sæt fordelinger.

På de to næste linjer følger de tekster som kommer til at udgøre overskrifterne på alle de udskrifter af fordelingerne, som man siden måtte bede om.

Sektionsbogstavet (her Y) står sammen med spilnummeret på udskriften.

Antal spil er sat til 40. Herved bliver der givet fra spil Y1 til spil Y40.

Nedenfor kan man se en side fra en udskrift (lavet som Barometer (AKQ)) baseret på denne turneringsspecifikation.

          3. division vest, 2. runde 6.-7. oktober 1990                    
                                                                           
                    +-------------------------------------+                
                    |  Y 9         S 4                    |                
                    |  N/EW        H AJT62                |                
                    |              D AKJ73                |                
                    |              C 42                   |                
                    |    S AK983  ---N---   S QJT2        |                
                    |    H 3      W     E   H 75          |                
                    |    D T82    W     E   D Q64         |                
                    |    C AK83   ---S---   C T765        |                
                    |              S 765                  |                
                    |              H KQ984                |                
                    |              D 95                   |                
                    |              C QJ9                  |                
                    +-------------------------------------+                
                                                                           
          (90100642 5C73 tir 1990-09-25 15:33) (00925A) Alesia Software    
                                                                           

På udskriften kan man aflæse turneringskoden (90100642) og en særlig lodtrækningskode (5C73). Hvis to sæt udskrifter har samme koder, er fremstillet under samme licens og er baseret på samme forblanding, vil der også være tale om samme fordelinger. Men hvis bare en af delene ændres, vil der også fremkomme andre fordelinger.

Det indgår som en del af sikringen mod at forskellige brugere af programmet giver samme kort, at kortene bliver forblandet helt tilfældigt inden hænderne bliver genereret. Denne forblanding svarer til at et spil kort bliver blandet fysisk, men sker ved at styre blandingen ud fra den tid der går mellem tastetrykkene, mens brugeren taster en tilfældig tekst ind. Herved er det muligt at få alle rækkefølger af 52 kort frem; det teoretiske udsagn er at alle permutationer er lige sandsynlige. Det tidspunkt ( tir 1990-09-25 15:33 ) der fremgår af udskriften, fortæller hvornår kortene blev forblandet.

Den sidste mystiske kode på udskriften fortæller hvilken version af kortgivningsprogrammet og hvilket licensnummer der blev brugt(00925A).

Lodtrækningskoden (5C73) tildeles tilfældigt blandt over 57000 muligheder af kortgivningsprogrammet. Den fremgår ikke af skærmbillederne, men kan aflæses på udskrifterne.

• Tasten F1 er en hjælpetast. Den giver ofte en meningsfyldt forklaring på en valgmulighed.

• Tasten Esc kan bruges til at komme ud af en situation hvor man er kørt fast; den virker som "slut", "færdig", eller "fortryd", alt efter hvad man er i gang med.

• Tasten Enter bruges til at vælge i en menu.

• Piltasterne kan bruges til at flytte rundt i menuer og mens man retter i turneringsspecifikationerne.

• Man bør benytte en striks tildeling af turneringskoder. Alesia Software anbefaler følgende stil:

90100613

Fordelinger til brug den 6. oktober 1990, løbenummer 13 (brugt til 1. division, 3. runde). Man kan lave mange næsten ens TUspecer til brug denne dag ud fra en skabelon, som man så passende kan kalde 901006FF.
• Til kortgiving hvor man ikke kender formålet, kan man fx bruge stilen

E0100622

som står for det 22. sæt genereret den 6. oktober år 1990 (eller 2000, eller 2010); så vil der være 10 år mellem den lille risiko for at lave et sæt der er set før. (Se også afsnit 7 om Batchkørsler nedenfor).

• Alesia Software kan ikke overkomme at følge med udviklingen i printere og printerformater. Derfor har visse brugere udviklet efterbehandlingsprogrammer, som håndterer moderne printertyper. Hvis du har lyst til at gøre ligeså, skal du læse afsnit 7 nedenfor om Batchkørsler. Men du skal være omhyggelig med at beholde overskrifterne i den endelige udskrift, for det hjælper til at forebygge at kortene bliver brugt i en anden turnering end det var tilsigtet. Og hvis du også bevarer koderne på udskriften, har du mulighed for at bevise over for tvivlere at du ikke har "forbedret" fordelingerne for at gøre dem mere interessante (se afsnit 9). En sådan "forbedring" er helt forkastelig og i modstrid med bridgelovenes §6.

• Udskrifterne afleveres i filer med følgende efternavne:

• Udskrifterne kan blive sendt til udskrift efterhånden som de laves. Når kørslen er forbi bliver filerne som regel slettet automatisk, så der ikke ligger fordelinger og flyder på disken.

• Filer af typerne .BRI, .DUP, .PBN og .BAR bliver dog normalt ikke slettet; dem må man tage vare på bagefter.

• Normalt vil man efterlade turneringsspecifikationerne (.TSP) på disken eller evt. på en diskette i en låst skuffe.

• Hver bruger har et licensnummer, som bruges til at styre kortgivningen på en sådan måde at forskellige licensnumre giver forskellige hænder. Licensnummeret er dokumenteret over for programmet i en fil som hedder alesia.kgl. Hvis der ikke ligger en gyldig alesia.kgl sammen med programmerne, kan der ikke gives nogen kort. Danmarks Bridgeforbund har sin egen licens, og det er ikke muligt for brugere med en anden licens at genskabe fordelingssekvenser genereret af Danmarks Bridgeforbund.

• Alesia Software tillader fri distribution af kortgivningsprogrammet. Alesia Software påtager sig intet ansvar for fejl, følger og skuffelser som måtte opstå ved brug af programmet. Seriøse brugere bør værne om deres licensfil, for hvis andre bruger programmellet med samme licensfil så kan de også generere nøjagtig samme fordelinger; derved opstår der en lille risiko at de samme kort optræder i to forskellige turneringer, nemlig hvis en anden bruger har brugt samme licens, samme turneringskode, samme lodtrækningskode, og samme forblanding af kortene.

• Enhver har mulighed for at bruge kortgivningsprogrammet under licens 43, som er offentlig tilgængelig. Det er stadig særdeles usandsynligt at to forskellige brugere under licens 43 kommer til at generere de samme fordelinger. Seriøse brugere, fx distrikter under DBF, kan opnå egen licens efter godkendelse af Danmarks Bridgeforbund.

• Der er foretaget omfattende statistiske analyser af at de kort der gives opfører sig statistisk korrekt. Disse analyser er kørt på den version som Danmarks Bridgeforbund bruger. Der er foretaget stikprøvevise analyser på andre licensnumre; disse analyser har ikke vist nogen afvigelse fra korrekt statistisk opførsel.

  Siden februar 1998 har det desuden været muligt for interesserede at hente en programpakke, der gør det let at gentage og udbygge de statistiske analyser på eget anlæg.

• Fordi programmellet er beregnet til at køre under MS-DOS kan der nu og da være problemer med at få æ, ø, og å til at se rigtige ud, når man kører MS-DOS under windows. Dette problem løses bedst ved at skaffe en offentligt tilgængeligt konverteringsprogram, fx via Internet. Et sådant program kan indarbejdes i KG-PRINT.BAT, jf. afsnit 6 nedenfor.

Kortgivningsprogrammellet er beregnet til at køre under MS-DOS. Det kan også fungere i yngre operativsystemer som understøtter MS-DOS, fx diverse MS Windows-udgaver.

Programmet består af en række filer med .EXE, .BAT, .KGC, og .HLP. Hertil kommer licensfilen alesia.kgl. Disse filer skal samles i ét directory. Det kan godt være et directory man i forvejen bruger til programmer som skal kunne køres. Det kan også være et nyt, oprettet til formålet; i så fald anbefales navnet KG. I PC'ens AUTOEXEC.BAT skal KG så med i PATH-kommandoen. Kopieringen af filerne sker ved brug af installationsfilen KG-STALL på installationsdisken.

Vi tager to eksempler.

Først installerer vi på et netværk hvor programmer ligger på Z:\PUBLIC, og installationsdisketten skal læses fra drev A:.

• Sæt installationsdisketten i diskettedrevet
• Tast A:
• Tast KG-STALL Z:\PUBLIC
  

Når denne installation er gået godt kan man straks gå i gang.

Det andet eksempel bruger directory C:\KG og læser disketten i drev B:

• Tilføj C:\KG til den gældende PATH-kommando (bedst ved at rette i AUTOEXEC.BAT).
• Tast C:
• Tast CD \
• Tast MKDIR KG
• Sæt installationsdisketten i diskettedrevet.
• Tast B:
• Tast KG-STALL C:\KG
  

Brugere som kører deres programmer fra overordnede menuer skal tilpasse deres menuer, så man stiller sig i et directory med TUspecer og kalder KG uden parametre.

Installationsdisketten indeholder også et directory KGU, hvori man kan finde visse udvidelsesbatchfiler. Disse skal eksplicit kopieres til det directory hvor TUspecerne som de skal bruges på, også findes. Læs nærmere i afsnit 7 om disse filer.

Hvis kortgivningsprogrammet hentes via Internet, skal filen alesia.zip pakkes ud samme sted som man ville installere den efter ovenstående procedure.

To af kortgivningsfunktionerne er lavet vha. MS-DOS-batchfiler. Det drejer sig om udskriften, der bruger en fil som hedder

KG-PRINT.BAT

KG-RYDOP.BAT

Erfaringen viser at brugerne har haft lyst til følgende tilpasninger:

1. Tilføjelser af printerstyrekoder til udskriftfilerne i KG-PRINT, således at printeren kan finde ud af æ, ø, å, Æ, Ø og Å, og så printeren bruger passende tegnsæt, linjeafstand, osv.
2. Tilføjelse af besværgelser i KG-PRINT, som tillader udskrift over et lokalnet.
3. Ændringer i KG-RYDOP, så endnu flere filer bliver slettet.

(Dette afsnit retter sig mod læsere som behersker MS-DOS-batchfiler, og som har fået blod på tanden; andre kan roligt springe det over).

Efterbehandlingen af de kort man har givet sker som regel ved at vælge menuindgange som Barometer (AKQ), der starter et program leveret af Alesia Software. Men der er også mulighed for at lave egne efterbehandlingsprogrammer. Sådanne efterbehandlingsprogrammer laves som MS-DOS-batchfiler, som vist nedenfor.

Først et enkelt eksempel:

  ::10 (AKQ+EKD)                                                
  ::  Udskriver 10 spil pr side både på dansk og på engelsk.    
  ::                                                            
  ::                                                            
  ::                                                            
  ::                                                            
  echo off                                                      
  rem    Der udskrives både en engelsk og en dansk udskrift med 
  rem    10 spil pr. side.                                      
  rem    ---------------------------------------                
  rem    Alesia Software 1990-10-03                             
                                                                
  ud10-EKD %1                                                   
  command /c kg-print %1 d10                                    
                                                                
  ud10-AKQ %1                                                   
  command /c kg-print %1 e10                                    

Denne batchfil slår to fluer med et smæk: Den skriver både en dansk og en engelsk version ud med kun én ordre. Batchfilen hedder KGU-JENS.BAT og ligger i samme directory som de turneringsspecifikationer der skal bearbejdes. Den illustrerer følgende grundregler for udvidelsesbatchfiler:

1. Filen skal hedde KGU-xxxx.BAT, hvor xxxx vælges frit.
2. Filen skal ligge i samme directory som de TUspecer der bearbejdes.
3. De første få linjer i filen skal begynde med to koloner (::).
4. Første linje i filen er den tekst som dukker op i menuen for efterbehandling.
5. De resterende linjer med to koloner er den hjælpetekst som bliver vist ved tryk på F1. Der skal være et mellemrum (blanktegn) mellem kolonerne og hjælpetekstlinjerne.

Et andet eksempel, som kan studeres direkte ud fra den leverede batchfil, er

som bruges af DBF's forlag til at lave 16 sæt fordelinger ad gangen.

Yderligere ideer til udvidelser omfatter statistikkørsler som dækker mere end ét sæt, og automatisk flytning af .BRI, .BAR , .DUP eller .PBN-filer til et andet directory eller til diskette.

De tegn som benyttes ved udskrifter af fordelingerne er somme tider ikke velegnede til den printer som udskriften skal foretages på. Derfor findes filerne AKQ.KGC og EKD.KGC, der styrer de dele af udskrifterne som har mest med bridge at gøre.

  -                  
  NS                 
  EW                 
  All                
  NESW               
  SHDC               
  AKQJT98765432      
  -+|                
                     

Eksemplet ovenfor er AKQ.KGC, som styrer AKQ-programmerne. De 8 linjer i filen har følgende betydning:

1-4	De fire zonestillinger.
5	Verdenshjørnerne.
6	De fire kortfarver.
7	De 13 kort i hver farve.
8	De tre tegn som bruges til at tegne rammer.

Ved at ændre i denne fil (fx. med EDIT, eller med et bedre tekstværktøj), kan du skræddersy udskrifterne i nogen grad. Fx kan du udskifte kortfarverne med rigtige symboler (hvis du bruger en printer der har tegn til det), fjerne rammerne rundt om fordelingerne, og indføre betegnelser svarende til andre sprog end dansk og engelsk.

Hvis filen ikke findes, eller er fejlbehæftet, vil der typisk forekomme store X'er i udskriften i stedet for de forventede tegn.

Normalt er det jo ikke meningen at man skal give de samme kort mere end én gang, og det kan derfor forekomme underligt at der er mulighed for at genskabe de samme fordelinger som man har givet ved en tidligere lejlighed. Det er normalt heller ikke nødvendigt at bruge denne mulighed, men en sjælden gang kan det forekomme at man modtager en klage over at de kort der er givet til en turnering er "forbedret" efter at de er givet tilfældigt. Netop i disse tilfælde er det en fordel at man kan give de gamle kort på ny og vise klageren resultatet.

Fordelingerne er fuldstændig bestemt af fem parametre:

1. Turneringskoden
2. Lodtrækningskode
3. Licensnummeret
4. Forblandingen af kortene
5. Versionen af programmet

Turneringskoden er man jo uden videre selv herre over; den kan man blot gentage.

Lodtrækningskoden vil normalt blive bestemt tilfældigt af programmet, men ved at vælge funktionen Genskab gamle kort kan man opnå selv at styre lodtrækningskoden. Bortset fra dette særlige tilfælde, bør man undlade at styre lodtrækningskoden.

Man sikrer at licensnummeret og versionen af programmet er uændret ved at køre genskabelsen af gamle kort på den samme installation som kørte den oprindelige kortgivning. I øvrigt vil kun de færreste versionsskift i programmet betyde at der bliver givet kort på en anden måde end hidtil.

Forblandingen af kortene kan man ændre lige så ofte som man vil, men hvis blot man styrer sine turneringskoder omhyggeligt, er det ikke strengt nødvendigt at forblande kortene på ny. Hvis man har ændret sin forblanding og ønsker at genskabe en forblanding fra tidligere, skal man have styr på detaljerne i lagringen af forblandingen:

• Den aktuelle forblanding lagres i klar tekst i filen alesia.s52.
• Alle forblandinger genereret gennem tiden lagres i filen log.s52.
• For at retablere en gammel forblanding skal de relevante linjer udtrækkes af filen log.s52 og lagres som filen alesia.s52.
• Begge disse filer lagres sammen med turneringsspecifikationerne. Man kan rydde op ved nu og da at slette log.s52, men så afskærer man sig samtidig fra at genskabe gamle fordelinger.

Kan alle mulige fordelinger forekomme?

Ja. Da alle mulige forblandinger kan forekomme, kan alle mulige fordelinger også forekomme.

Kan man regne ud hvad spil 2 bliver, når man kender spil 1?

I praksis kan det ikke lade sig gøre. Det hænger sammen med det uoverskueligt store antal sekvenser (et tal med 53 cifre) som kan genereres med netop den fordeling af spil 1.

Nu er det lidt svært at forestille sig at nogen spiller vil forsøge at snyde i bridge ved at forudsige hvilke kort han kommer til at spille; men kortleverandøren kan sikre sig fuldstændigt mod sådanne "kodebrydere", så det end ikke er teoretisk muligt for en spiller at forudse hvilke kort han får i en senere sektion. Det gøres ved at forblande kortene før hvert enkelt sæt bliver givet.

Disse betragtninger har kun teoretisk interesse. I praksis kan man sagtens genbruge en forblanding lige så længe man vil, uden at der er nogen egentlig risiko forbundet med det.

Kan man være sikker på at ingen har "forbedret" på fordelingerne?

Programmet kan jo ikke garantere at der ikke er nogen der bagefter ændrer ved de kort der er givet. Men det er muligt at genskabe de tidligere kort, så kortleverandøren har mulighed for at forsvare sig hvis nogen skulle fremkomme med en anklage. Det handler afsnit 9 ovenfor om.

Giver edb-givne kort skævere fordelinger?

Nej, der er ingen statistisk målelig forskel mellem edb-givne kort og håndgivne kort. Denne konklusion er baseret på en opsamling af data fra over 500 hænder fra Bridgeklubben HCØ, hvor kortene blev givet med håndkraft på sædvanlig vis af spillerne i begyndelsen af hver bridgeaften. Edb-givne kort er godt nok temmelig skæve nu og da; men det er håndgivne kort altså også!

Kan man gå ud fra at kortene opfører sig rigtigt tilfældigt?

Ja, kortene er ikke til at skelne (statistisk) fra rigtigt tilfældige kort. Selve forblandingen er ægte tilfældig; og i øvrigt er kortfordelingerne genereret på en måde der bevarer tilfældighedsegenskaberne.

Kan man være sikker på at en anden ikke giver de samme kort?

Hvis man har sin egen licens kan man være 100% sikker på at en anden kortleverandør ikke giver de samme fordelinger. Hvis man bruger den offentlige licens, eller af andre grunde deler licens med en anden kortleverandør, er man stadig i praksis sikret: Kun hvis den anden leverandør forblander kortene på samme måde, bruger samme turneringskode, og får fat i den samme af de godt 57000 mulige lodtrækningskoder, vil der blive givet samme kort. Men antallet af måder at forblande kortene på er så uoverskueligt stort et tal (67 cifre), at det i sig selv udgør rigelig sikkerhed mod at en anden giver de samme kort.

Hvorfor hører man historier om at de samme kort er spillet i to forskellige turneringer?

Der er typisk sket det at en kortleverandør ved en fejltagelse har genbrugt nogle fordelinger som han havde givet tidligere. Det er normalt ikke pga. dovenskab, for det tager kun få sekunder at give et sæt fordelinger til en sektion. Kortleverandøren beskytter sig selv mod den slags fejltagelser ved omhyggeligt at vælge turneringskoder og omhyggeligt at beskrive formålet med hvert enkelt sæt der gives. Det handler afsnit 3 og dele af afsnit 4 om.

Jeg fik en 10-farve. Er det ikke en fejl i programmet?

Nej. Programmet giver ikke flere 10-farver end det skal. Men nogen skal jo have én nu og da.

Kan uærlige spillere ikke gætte hvilke kort de skal spille i en distriktsturnering?

Nej. Distriktsturneringer (og højere rangerede turneringer) bruger fordelinger der er givet under en licens der ikke er offentlig tilgængelig. Man kan ikke lave de samme kort med den offentlige version. Og selv de få personer der har adgang til den relevante licens, har ikke mulighed for at gætte hvordan kortene vil være forblandet, eller hvilken lodtrækningskode der bliver brugt til en konkret turnering.