Uitleg bij het programma vierkamp Dennis Breuker, 31 mei 2013

Transcriptie

1 Uitleg bij het prgramma vierkamp Dennis Breuker, 31 mei 2013 Inhud 1 Inleiding Wat kan het prgramma wel Wat kan het prgramma niet Bugs Indelen van rnde <rndenummer> Ver aanwezigen in Maak de indeling met het zmerprgramma Print de gemaakte indeling Uitslagen inveren van rnde <rndenummer> Pas eventueel de indeling aan Ver de uitslagen in het zmerprgramma in Reken de uitslagen dr met het keizerprgramma Genereer rnde.html Inleiding Dit dcument beschrijft een aantal basispties van het prgramma vierkamp.exe. Dit prgramma is geschreven dr Dennis Breuker, mdat er geen indelingsprgramma bekend is dat vierkampen en zeskampen kan genereren. Het wrdt gebruikt vr de zmercmpetitie van Caïssa. De eerste versie van het prgramma is gemaakt p 14 juni In de lp der tijd is er steeds meer functinaliteit bij gebuwd. Omdat het prgramma it alleen gemaakt was vr Dennis Breuker is er niet veel aandacht besteed aan de interface (het is een eenvudig DOSprgramma) en aan de uitleg. Dit dcument prbeert wat meer uitleg te verschaffen vr anderen die het prgramma willen gebruiken. Maar het blijft aan te bevelen dat de scheidende wedstrijdleider intern de werking van het prgramma verdraagt aan de nieuwe wedstrijdleider intern. Een paar gezamenlijke sessies zijn ndig m het prgramma nder de knie te krijgen. 1 / 7

2 Het prgramma maakt gebruik van heks.dat. Dat is hetzelfde bestand waarvan het prgramma heks.exe (dat de winterindeling maakt) gebruikt maakt. Dat is bewust gedaan, zdat heks.exe wat taken van vierkamp.exe kan vernemen. Zie Wat kan het prgramma wel De aanwezigen inveren (ptie 1). Zie 2.1. Een indeling genereren (ptie 2). Dit de je pas als alle aanwezigen zijn geregistreerd. Zie 2.2. Uitslagen inveren (ptie 3). Dit de je pas als een rnde is gespeeld. Zie 3.2. Een nieuwe speler inveren (ptie 4). Zie 2.1. Verwijderen van inactieve spelers (ptie 5). Dat staat niet in dit dcument beschreven. Veranderen van parameters (ptie 6). Het prgramma gebruikt parameters die in het bestand vierkamp.ini staan. Deze bepaling nder andere he de indeling wrdt gemaakt. Zie 2.2. Stand tnen (ptie 7). Dat staat niet in dit dcument beschreven. Uitslagen van een gespeelde rnde tnen (ptie 8). Dat staat niet in dit dcument beschreven. HTML uitslagen van eerder gespeelde rnde maken (ptie 9). Zie 3.4. Het prgramma maakt gebruik van een ini bestand, vierkamp.ini. Daarin staan allerlei pties. Deze wrden niet in dit dcument besprken, maar dit bestand kan gewn met kladblk wrden gepend en bekeken wrden. De pties wrden daar krt in uitgelegd. 1.2 Wat kan het prgramma niet Een gemaakte indeling printen. Dat dient te gebeuren met Micrsft Wrd. Zie 2.3. Een gemaakte indeling aanpassen. Zie 3.1. Het drrekenen van de uitslagen en daarmee een nieuwe stand genereren. Hiervr is het prgramma heks.exe van Vincent Steemers ndig. Zie 3.3. Uitslagen wijzigen. Hiervr is het prgramma heks.exe van Vincent Steemers ndig. Dat staat niet in dit dcument beschreven. 1.3 Bugs Als er een bug in het prgramma is gevnden, meld deze dan aan Dennis Breuker Hij zal dan prberen deze snel te fixen en een nieuwe versie van het prgramma te maken. 1.4 Start Vr het begin van de eerste rnde dient een heks.dat aanwezig te zijn znder rnde-inf! Dus alleen een bestand met namen, knsb-nummers en el s. Per regel zijn dat de eerste 47 karakters. Dat is dus hetzelfde startbestand als waarmee je de wintercmpetitie start (met heks.exe). 2 / 7

3 2 Indelen van rnde <rndenummer> Deze paragraaf beschrijft het indelen van een rnde. Dit is wat er p het begin van een speelavnd dient te gebeuren. Het bestaat uit het inveren van aanwezigen ( 2.1), de indeling maken ( 2.2) en de indeling printen ( 2.3). 2.1 Ver aanwezigen in Start het zmerprgramma: dubbelklik p vierkamp.exe. Kies ptie 1 (ver aanwezigen in). LET OP: de eerder ingeverde aanwezigen vr deze rnde wrden bewaard (in de map aanwezig nder de naam aanwezig<rndenummer>.txt). Dit is z gemaakt vr wanneer het prgramma (f de cmputer) nverhpt uitvalt. Dan zijn de gemarkeerde aanwezigen niet verlren gegaan en kan je verder gaan waar je bent gebleven. Als je met een schne aanwezigenlijst wil beginnen, sluit dan vierkamp.exe af, verwijder het bestand waar de aanwezigen in staan (aanwezig/ aanwezig<rndenummer>.txt ) en start vierkamp.exe pnieuw. Typ (een deel van) de achternaam in. Het prgramma tnt een vr een de spelers die hieraan vlden, met steeds de ptie (j/n/q). Als de getnde speler niet de gewenste speler is, kies dan n (nee). De vlgende speler die aan de ingetypte achternaam vldet wrdt getnd. Als de getnde speler wel de gewenste speler is, kies dan j (ja). Als deze speler ng niet was aangemeld, dan wrdt deze autmatisch aangemeld. Als deze speler al was aangemeld, wrdt er gevraagd f deze afgemeld met wrden. Als de ingetypte naam niet de naam is die bedeld werd, kies dan q (quit). Er kan een nieuwe naam wrden ingeverd. Wanneer een nieuw persn met wrden ingeverd, de dan het vlgende: Stp met inveren van aanwezigen (typ quit). Kies ptie 4 (ver nieuwe speler in). Ver de naam in. Ver de (KNSB f geschatte) rating in. Afhankelijk van de instellingen in vierkamp.ini (autmatisch = 0 f autmatisch = 1) wrdt er nu ng gevraagd p welke plaats deze speler met kmen te staan. Indien dat wrdt gevraagd wrden er twee suggesties gedaan. Kies een van deze twee, f kies er zelf een. Indien niets wrdt gevraagd dan is de speler autmatisch p een plaats gezet. 3 / 7

4 De nieuwe speler is ingeverd. Maar hij is ng niet aangemeld. Ga dus weer terug naar ptie 1 (ver aanwezigen in), en ver nieuwe speler als aanwezig p. Als iemand wil meeden die maar twee rnden kan meespelen, deel hem dan gewn in. Dit betekent dan dat iemand in die grep maar twee partijen speelt. Het zij z. Het zmerprgramma kan hiermee rekening huden met het inveren van de uitslagen. Beide spelers krijgen dan het resultaat neven. Zie 3.2 vr meer infrmatie. Als alle aanwezige spelers zijn ingeverd, stp met inveren (typ quit). Alle aanwezigen zijn nu geregistreerd in het bestand aanwezig<rndenummer>.txt in de map aanwezig. Je kan dit bestand gewn in kladblk penen m te cntrleren f alle spelers zijn ingeverd. 2.2 Maak de indeling met het zmerprgramma Kies ptie 2 (genereer indeling van rnde <rndenummer>). Het prgramma prbeert nu in te delen. Afhankelijk van de instellingen in vierkamp.ini (autmatisch = 0 f autmatisch = 1) wrdt er allerlei inf p het scherm getnd. Het kan zijn dat het indelen te lang duurt. Dit kan gebeuren wanneer de indelingparameters te streng zijn gekzen (elverschil te laag, plaatsverschil te laag, etc.). Het indelen kan dan nderbrken wrden dr CTRL-C te tetsen. Het zmerprgramma wrdt dan afgebrken. Start het prgramma pnieuw p dr p vierkamp.exe te dubbelklikken. Verander één van de parameters vrdat je pnieuw gaat indelen (zie vlgende punt) Als het indelen niet gelukt is, f als het indelen te lang duurde, verander dan één van de parameters (herhaal dit net zlang ttdat het indelen wel lukt): Kies ptie 6 (verander parameters) Maak eventueel elverschil iets hger, maar dat is waarschijnlijk niet ndig. Maak aanwezigverschil iets hger dan het nu is. Prbeer pnieuw in te delen. Als het indelen wel gelukt is, dan staat de indeling in twee bestanden, beide in de map indeling. Het gaat m de bestanden indeling<rndenummer.txt> en indeling<rndenummer>.csv. Het txt bestand is ndig m in Wrd een mi geprinte indeling te genereren. Het csv bestand is nieuw sinds versie 1.18 van vierkamp.exe. De indeling is gereed. Stp het prgramma met ptie 0 (stppen) 2.3 Print de gemaakte indeling Start Micrsft Wrd 4 / 7

5 Kies File Open Onderin, bij files f type, kies vr Text files (*.txt) Navigeer naar de indeling directry Dubbelklik p bestand indeling<rndenummer>.txt Het bestand wrdt nu in Wrd gepend. Kies Tls Macr Macrs. Selecteer MaakAlleTabellen en klik p Run. Alle tabellen wrden nu in een mi frmaat gezet (dit duurt eventjes). Kies File Print. Sluit Wrd af (File Exit). 3 Uitslagen inveren van rnde <rndenummer> Deze paragraaf beschrijft he uitslagen ingeverd en verwerkt meten wrden. Dit is wat wrdt gedaan nadat een speelavnd is afgelpen en alle uitslagen zijn verzameld. Het bestaat uit het eventueel aanpassen van de indeling ( 3.1), het inveren van de uitslagen ( 3.2) en het drrekenen van de uitslagen m een nieuwe stand te maken ( 3.3). 3.1 Pas eventueel de indeling aan LET OP: Dit kan vanaf versie Het kan zijn dat de gespeelde rnde iets afwijkt van de gemaakte indeling. Bijvrbeeld mdat vergeten was m iemand in te delen, f mdat spelers ineens tch afhaakten. Dat met aan het prgramma kenbaar wrden gemaakt. Dat wrdt hiernder beschreven. Indien niets aan de indeling heft te wrden veranderd, sla dit dan ver en ga naar paragraaf 3.2. Het prgramma leest de indeling uit het bestand indeling<rndenummer>.csv dat in de map indeling staat. Dat bestand heeft een zeer eenvudige vrm. Zie hier een vrbeeld. 4 ; Rb Bdicker ; Gianantni Me ; Peter Dggers ; Gertjan vd Heven 4 ; Angel Spiler ; Rbert Kikkert ; Wim Nijenhuis ; Camil Guzman 5 ; Dennis Breuker ; Eric Cpplse ; Olaf Ephraim ;Tny Lith ; Maurice Aue Iedere regel is een vierkamp f zeskamp. Aan het begin van de regel staat altijd het aantal spelers in een grep. Dat is dus 3, 4, 5 f 6. Vervlgens staan er precies zveel namen als dat er spelers in de grep zijn, gescheiden dr puntkmma s (;). Als je de grepindeling wilt wijzigen kan je de namen en/f aantal spelers in een grep naar hartenlust veranderen. Dit kan met ieder prgramma. Je kan dit bestand bijvrbeeld penen 5 / 7

6 met kladblk. Vrdat je dit det met eerst het prgramma vierkamp.exe wrden afgeslten! Let p! Maak geen spelfut (dus k niet ineens twee spaties tussen vrnaam en achternaam), want dan wrdt een speler niet meer dr het prgramma herkend. De namen meten identiek zijn aan de namen in de stand. Zrg er k vr dat het aantal namen p een regel precies z grt is als getal aan het begin van de regel (het aantal spelers in een grep). Tt slt, zrg dat je geen namen dubbel pschrijft. Een speler kan niet in twee grepen tegelijk spelen. Als het bestand is aangepast, sla dit dan p nder dezelfde naam. Start vervlgens vierkamp.exe weer p. 3.2 Ver de uitslagen in het zmerprgramma in Start het zmerprgramma: dubbelklik p vierkamp.exe. Kies ptie 3 (verwerk uitslagen van gespeelde rnde). Let p! Het prgramma prbeert eerst in de map indeling het bestand indeling<rndenummer>.csv te penen. Indien dit niet bestaat, prbeert het prgramma het bestand indeling<rndenummer>.txt te penen. Indien dit k niet bestaat is de indeling niet bekend en kunnen de uitslagen niet wrden ingeverd. Ver uitslagen in. Per grep kan je de uitslagen net z vernemen als ze p papier zijn ingevuld, met 1 vr winst, = vr remise, 0 vr verlies, en v vr vrij. Dit laatste is ndig als iemand meedet (meestal een jeugdspeler), die alleen de eerste twee rnden speelt. Bij de derde rnde vul je dan dus v in vr de jeugdspeler en zijn tegenstander. Dit wrdt verwerkt als neven. De uitslagen ver je regel vr regel in. Dus eerst ver je de uitslagen van speler 1 in, van links naar rechts. Dan van speler 2, etc. Na aflp van het inveren van een grep wrdt het resultaat p het scherm afgedrukt en gevraagd f dit crrect is. Dan kan je ng cntrleren f het vereen kmt met het papier. Als je iets verkeerd hebt ingeverd (bijvrbeeld mdat iemand het papiertje niet ged heeft ingevuld), dan zal het prgramma zeggen dat een ingeverde uitslag niet klpt. Bijvrbeeld 1-2 is 1-0, maar 2-1 is niet 0-1. In dat geval dient de uitslag van de hele grep pnieuw te wrden ingevuld. Als de resultaten van alle grepen zijn ingevuld wrden ng drie extra vragen gesteld. Dit gaat ver spelers die 3x neven waren, 3x afwezig/match en 3x extern/sga rapid waren. Deze krijgen dan respectievelijk 3x neven, 3x afwezig, 3x extern. Dit is vaak in het begin van de zmercmpetitie ndig, als er ng een ratingmatch f match m het 6 / 7

7 clubkampienschap wrdt gespeeld. Idem vr SGA rapidavnden die samenvallen met nze eigen zmercmpetitie. Die spelers wrden dan gecmpenseerd. Kies ptie 0 (stppen) Let p! Nu zijn de uitslagen ingeverd, maar ng niet drgerekend! Er is dus ng geen nieuwe stand aanwezig. Het maken van een nieuwe stand staat in de vlgende paragraaf beschreven. 3.3 Reken de uitslagen dr met het keizerprgramma Start het keizerprgramma: dubbelklik p heks.exe. Kies ptie Administratie Drkeizeren, gevlgd dr Km p, rekenen met die hap! Kies ptie Overzichten HTML-Files. Kies ptie Quit Nu zijn de uitslagen echt drgerekend. Tevens is het bestand heks.htm in de map html aangemaakt. 3.4 Genereer rnde.html Als de uitslagen zijn ingeverd (zie 3.2) kan een html bestand wrden gegenereerd van de vierkampen. Kies hierte ptie 9 (genereer HTML uitslagen van een gespeelde rnde), en kies een rndenummer. Het prgramma prbeert de indeling in te lezen van het bestand indeling<rndenummer>.csv, f als dat niet bestaat van het bestand indeling<rndenummer>.txt. Indien dat k niet bestaat prbeert het prgramma de grepindeling zelf te ntdekken aan de hand van de uitslagen. Vervlgens wrdt een bestand rnde.html gemaakt in de map html. Let p! Het bestand rnde.html wrdt iedere keer wanneer het prgramma wrdt pgestart verwijderd. 7 / 7