picolo en NBB-R

Onder NBB-R wordt verstaan: "Het NBB-Rekenprogramma (versie 2.8.xx of ouder) of Bridge-It"
Voor recentere versies van het NBB-Rekenprogramma zijn deze opties helaas niet bruikbaar.

INHOUD

OPTIES
Een competitiezitting opzetten
Een paar toevoegen tijdens een competitieronde
Verstekwaarden
Datastructuren
Klik hier voor de homepage .

OPTIES

Het menu-item NBB-R van picolo bevat de volgende opties.

Synchroniseer picolo met NBB-R.
Hierbij worden, voor alle zittingen van een competitieronde, de gegevens van NBB-R vergeleken met die van picolo. Algemeen gaan we er van uit dat NBB-R de juiste gegevens heeft. De gegevens van picolo worden daarop aangepast, maar alleen als de zitting al gespeeld is. Is de zitting nog niet gespeeld dan worden inconsistenties wel gesignaleerd en het programma vraagt welke actie ondernomen moet worden.
Toepassingen:
- Het is een goed idee om deze functie als algemene controle routinematig aan te roepen, bijvoorbeeld bij het opzetten van een nieuwe zitting.
- Veranderingen in de indeling die op het laatste moment zijn aangebracht in NBB-R worden door deze functie ook doorgevoerd in picolo.
- Als onderdeel van "Competitie ophalen", zie verderop, wanneer het parenbestand gewijzigd is.
- Als onderdeel van "Competitie ophalen", zie verderop, bij ingebruikname van picolo, om alle gegevens van de lopende competitieronde op te halen.
- Bij de "Optimaliseer" opties (zie onder) wordt de gebruiker eerst gevraagd of hij deze "synchronisatie" wil uitvoeren.
Deze optie combineert voor alle lijnen van een gehele competitieronde tegelijk de functies Test en vergelijk zittingen en Haal NBB-R zitting naar picolo.
Optimaliseer NBBR-zitting
Allereerst wordt de gebruiker gevraagd of hij wil synchroniseren. Zo ja dan wordt eerst de synchronisatie procedure doorlopen. Zo nee dan gaat picolo meteen tot de volgende actie over:
Een zitting wordt opgehaald van NBB-R, de indeling geoptimaliseerd in picolo, en het resultaat weer teruggezet in NBB-R.

Zoals we uit dit screenshot zien wordt de NBB-R zitting geidentificeerd aan de hand van session-ID, Ronde R, Zitting Z, Datum en Competitienaam en, in een afzonderlijke lijst, door de Lijnletter.
Bij aanklikken van de knop "OK +" wordt de geselecteerde lijnletter genegeerd en worden alle lijnen van de gekozen zitting geoptimaliseerd.
Optimaliseer NBBR-zitting + paren Vasthouden
Analoog aan Optimaliseer NBBR-zitting (zie boven), maar nu krijgt de gebruiker tevens gelegenheid om aan te geven dat een of meer paren een vast paarnummer krijgen.
Voor details zie prentenboek
Vervolgens wordt weer de indeling geoptimaliseerd in picolo, en het resultaat weer teruggezet in NBB-R.
NBBPad.
Met deze optie wordt de locatie ingesteld waar picolo de gegevens van NBB-R moet zoeken. Dit gebeurt aan de hand van de locatie van de database Index.dat. Het NBBpad kan worden opgeslagen in picolo.ini. Als u niet daarvoor kiest blijft het NBBpad alleen voor de huidige picolorun geldig. Deze optie wordt ook uitgevoerd als bij een van de andere opdrachten uit het menu NBB-R het NBBpad onbekend is.
Het is mogelijk om meerdere locaties voor de NBB-R databestanden vast te leggen in picolo.ini. Dit is van belang als u dezelfde picolo-bestanden (bijvoorbeeld aanwezig op een memorystick) wilt gebruiken op verschillende computers. Op de verschillende computers bevinden de NBB-R data zich mogelijk op andere locaties. U geeft dan gewoon twee of meer regels "Pad" op in picolo.ini. Daarbij kunt u ook nog met een korte tekst aangeven om welke computer het gaat. Voorbeeld:
```
Pad  Thuis   0  C:\Users\win\AppData\Local\Bridge-It\Data
Pad  Club    0  C:\Users\HartenHeer\Bridge-It\Data
```
Bij de optie NBBPad krijgt u een menu voorgeschoteld waarin u uit deze lijst kunt kiezen, danwel door middel van "Bladeren" een andere directory kunt selecteren. Na het bladeren wordt gevraagd of de keuze moet worden vastgelegd in picolo.ini. Bovenstaande regels hoeft u dus niet zelf in te typen! U kunt daarbij nog kiezen tussen opslaan als standaard locatie of als extra locatie.
De standaardlocatie d.w.z. degene die automatisch gekozen wordt bij het starten van picolo is de eerst voorkomende Pad-regel in picolo.ini. Meer over het bepalen van het NBBpad, zie hier
Alle Schema's ophalen.
Alle schema's uit de NBB-R database Schema.dat worden overgebracht naar picolo.
Er wordt tevens een file NBBschemas.log aangemaakt met een overzicht van alle schema's, met
- P= aantal paren,
- R= aantal ronden,
- T = aantal tafels,
- Sp= aantal spelgroepen,
- Qf= kwaliteitsfactor
- de paren die een vaste tafel hebben, en
- het "schemasysteem" in NBB-R.
Parenfiles ophalen uit NBB-R.
Construeert picolo-parenfiles aan de hand van de gegevens van een "Competitieronde" van NBB-R, voor alle lijnen van die competitieronde.
Opties:
- De aantallen rusttafels meenemen. Als deze optie is aangevinkt worden tevens de aantallen keren aanwezig meegenomen.
  Voor het gelijkmatig over alle deelnemende paren verdelen van de rusttafels is het nodig deze optie aan te vinken. Dit vereist wel dat alle gegevens van de voorgaande Competitieronde beschikbaar zijn in picolo.
  Deze optie heeft geen effect in de eerste competitieronde, immers de parenfile bevat alleen gegevens van voorgaande competitieronden.
  zie ook de beschrijving van de parenfile
- Het registreren van de nieuwe competitieronde in picolo.ini.
Als er al een file bestaat met dezelfde naam als de op te halen parenfile verschijnt er een keuze-menu met 3 opties:
1. de file compleet verversen
2. de file verversen met uitzondering van de kolommen Rust en Aanwezig
3. de file helemaal niet wijzigen.
De tweede optie kan handig zijn als u zelf handmatig wijzigingen in de kolommen Rust en Aanw hebt aangebracht en vervolgens tussentijds de parenfiles ophaalt, bijvoorbeeld na een wijziging in het parenbestand.
Een competitieronde ophalen uit NBB-R.
Dit is niet meer en niet minder dan de combinatie van twee boven besproken acties:
- De parenfile ophalen van een competitieronde
- Synchroniseren, met name alle reeds gespeelde zittingen van die competitieronde ophalen.
Bij het in gebruik nemen van picolo tijdens een lopende competitie is het nodig de gegevens van de voorgaande en huidige competitieronden op te halen uit het NBB-Rekenprogramma of Bridge-It. Dit kan gedaan worden door achtereenvolgens voor alle competitieronden, vanaf de eerste, de opdracht "Competitieronde ophalen" uit te voeren, zie ook hier
Met deze opdracht kan men ook de gegevens van picolo aanpassen als het parenbestand in NBB-R is gewijzigd.
Uitvoer NBBR-Indeling.
Deze functie haalt de indeling van alle lijnen van een zitting op uit NBB-R, en stuurt dit overzicht door naar de editor. Daar kan het bijvoorbeeld geprint kan worden, door middel van het print-commando van de editor, eventueel na het verfraaien van de layout.
Als alternatief voor de opdracht "Bestand -> Uitvoer Indelingen" heeft dit onder andere als voordeel dat incidenteel samenspelende paren (combiparen, paar met invaller) in de juiste samenstelling worden weergegeven.
Voordeel boven het NBB-R commando "Spelerslijst afdrukken" is dat de gegevens nu ook als bestand ( Indeling/Indelingen.txt ) beschikbaar zijn en naar wens bewerkt kunnen worden.
NBB-R scores.
Haalt scores op van een competitiezitting in NBB-R en presenteert deze in een vorm als volgt
```
Spel A2(NZ)          Score
      NZ       OW       NZ    %NZ                        %OW
  5K x C              +750    100 Johan - Joop             0 Marcel - Ruud
             5S C     -450     75 Rob - George            25 Marianne - Henk
             4S+3     -510     50 Hilly - Frans           50 Ina - Peter
  5H x-3              -800     25 Maria - Gea             75 Tonny - Dirk
           5S x+2     -850      0 Herman - Tanco         100 Maria - Gerard
```
De uitvoer is naar tekstfiles, waarvan de naam begint met "scorekaart". Er is keuze uit 3 varianten:
- txt: platte tekst
- html: tekst voorzien van HTML opmaakcodes.
- csv: voor gebruik in spreadsheets. De velden zijn gescheiden door ';' en tussenkopjes ontbreken.
Topintegraal en combitafel worden ondersteund, maar let wel: alleen competitiezittingen, geen open zittingen.
De paarnamen worden gepresenteerd als voornamen. De percentages zijn afgeleid van de MP scores uit de NBB-R database, met één uitzondering. Als een spel is ingevoerd als niet gespeeld, d.w.z. de score is 'NG', krijgen beide paren 50%. De database geeft daar nullen. Wat het wel moet zijn hangt af van de wedstrijdleider en de reglementen.
NBB-R Competitiestand.
Haalt de stand van een competitieronde op uit NBB-R en presenteert deze in een vorm vergelijkbaar met de wijze waarop NBB-R dit doet. De uitvoer is naar tekstfiles, waarvan de naam begint met "stand_". Er is keuze uit 3 varianten:
- txt: platte tekst
- html: tekst voorzien van HTML opmaakcodes.
- csv: voor gebruik in spreadsheets. De velden zijn gescheiden door ';'.
Of u de HTML variant gebruikt als alternatief voor die van NBB-R is een kwestie van smaak. De csv variant is zeker handiger dan die van NBB-R als u de gegevens in een spreadsheet wilt gaan behandelen.
Let op: voor het goed functioneren van deze faciliteit moet ook in NBB-R de gekozen competitieronde geselecteerd zijn, en de competitiestand berekend. Gebruik daartoe in NBB-R functietoets F2.
NBB-R Leden.
Met deze optie kan men informatie uit de ledenbestanden van NBB-R ophalen.
Er zijn twee mogelijkheden:
1. Haal een volledig ledenbestand op, bijvoorbeeld het bestand "Gasten"
2. Zoek in alle ledenbestanden naar een gegeven naam.
Selecteer een ledenbestand (bovenste vak) of typ een naam in (onderste vak) en klik OK. Optie 1 wordt gekozen als dit onderste vak leeg is, optie 2 als het vak een naam bevat. Deze naam kan een voornaam of achternaam (zonder eventuele tussenvoegsels) zijn, en moet exact overeenkomen met de voornaam of achternaam in het ledenbestand.
In beide gevallen worden een overzicht vertoond van spelers, met achternaam, voornaam en NBB-nummer (indien bekend). De tweede optie is handig om te controleren of een speler reeds is ingevoerd, of zijn bondsnummer bekend is, en of hij in meerdere bestanden voorkomt.
Door dubbelklikken op een naam in dit overzicht krijgt men detailinformatie over de speler.
Test en vergelijk zittingen.
Deze functie controleert of de zittinggegevens van picolo en NBB-R onderling kloppen. Inconsistenties worden gemeld.
Zie ook: Synchroniseer picolo met NBB-R
Parenbestanden vergelijken.
De parenbestanden van picolo en NBB-R worden hierbij naast elkaar afgebeeld. Controle of de namen kloppen moet u hierbij zelf doen :-)
De paar-ID's worden vertoond zowel voor NBB-R als picolo.
Haal NBBR-zitting naar picolo.
Door de invoering van de opties "Synchroniseer picolo met NBB-R" en "optimaliseer NBBR-zitting ... " is deze optie goeddeels overbodig geworden
Hierdoor wordt een zitting van NBB-R overgebracht naar picolo en geopend. Alle normale picolobewerkingen, zoals wijziging van de indeling en zitting opslaan zijn daarna mogelijk.
Deze functie is nuttig als er op het laatste moment wijzigingen in de indeling hebben plaatsgevonden die u in de gauwigheid alleen in NBB-R heeft aangebracht. Als u daarna deze functie gebruikt is het zeker dat de gegevens van NBB-R en picolo met elkaar kloppen. De functie "Synchroniseer picolo met NBB-R" doet (onder andere) hetzelfde.
Een andere toepassing is bij het opzetten van een zitting. U zet eerst de zitting op in NBB-R, compleet met alle details, maar met een willekeurige indeling. Vervolgens haalt u de zitting naar picolo en voert daar de optimalisatie van de indeling uit. De resultaten kunnen dan weer worden teruggezet naar NBB-R. Een en ander is geautomatiseerd in "optimaliseer NBBR-zitting ... "
Bij aanklikken van de knop "OK +" wordt de geselecteerde lijnletter genegeerd en worden alle lijnen van de gekozen zitting behandeld.
Haal NBB-R zitting op en toon rusttafels.
Haal een zitting op en toon een overzicht van de rusttafels die ieder van de paren van de betreffende lijn gehad hebben, na afloop van de opgehaalde zitting.
De opgehaalde zitting wordt niet opgeslagen in picolo (verschil met bovenstaande).
Bij aanklikken van de knop "OK +" wordt de geselecteerde lijnletter genegeerd en worden alle lijnen van de gekozen zitting behandeld.
Zie ook de optie Toon Rusttafels in Menu-item LIJN en ZITTING, en voor printeruitvoer de optie Print Matrices in Menu-item Bestand
Beschikbare Schema's in NBB-R.
Deze optie geeft een overzicht van de schema's die in NBB-R beschikbaar zijn en voldoen aan selectiecriteria. Mogelijke selectiecriteria zijn daarbij: aantal paren, aantal ronden, schemasysteem.
De gegevens die per schema getoond worden zijn dezelfde als bij Alle Schema's ophalen
Als er een zitting open is in picolo, is het mogelijk een schema direct te gebruiken. Selecteer met de muis het gewenste schema en klik "Kies dit schema".
Breng herindeling van picolo naar NBB-R
Door de invoering van de opties "optimaliseer NBBR-zitting ... " is deze optie goeddeels overbodig geworden
Deze faciliteit is bedoeld om zittinggegevens die vanuit NBB-R naar picolo zijn overgebracht, en vervolgens geoptimaliseerd, weer in gewijzigde vorm terug te zetten. Hierbij is een vereiste dat hooguit de indelingsvolgorde van de paren en/of het schema verschilt, en de zittingen verder identiek zijn. Ook mag de zitting niet gespeeld zijn.
Bij deze stap wordt in feite de indeling, die picolo op dat moment in het geheugen heeft, overgebracht.
Alleen wanneer ook het schema gewijzigd wordt, is het nodig deze optie te gebruiken. Zo niet dan zijn de opties "optimaliseer NBBR-zitting ... " handiger.

Een competitiezitting opzetten

Klik hier voor een stapsgewijze beschrijving van het opzetten van een zitting

Een paar toevoegen tijdens een competitieronde

In NBB-R is het mogelijk een nieuw paar toe te voegen tijdens een lopende competitieronde. Als u hiervan gebruik maakt is het daarna nodig om picolo en NBB-R weer te synchroniseren. Gebruik daartoe de opdracht "Competitieronde ophalen", die de gewijzigde parenfile, en vervolgens alle reeds gespeelde zittingen van de lopende competitieronde, opnieuw ophaalt.

De opdracht "voeg een paar toe" van picolo is een alternatief dat alleen bestemd is voor gebruikers die niet met NBB-R werken, maar opmerking 2 daarbij is ook nu van toepassing!

Verstekwaarden

Bij de opdrachten van deze groep is het zo dat bij de eerste aanroep als verstekwaarde geldt: de meest recente zitting en daarvan lijn A. Als dit niet de zitting is die u wilt bewerken dan een andere selecteren: Klik op het blauwe vakje enzovoorts. Analoog voor de Lijnletter.

Bij volgende aanroepen wordt de verstekwaarde automatisch verhoogd, totdat de laatste lijn van de laatste zitting bereikt is. Bovendien zijn sommige opdrachten zo ingericht dat u in een lus terecht komt: na afloop wordt de opdracht vanzelf opnieuw aangeroepen. (U kunt hier altijd uit komen door "Annuleren" of STOP aan te klikken). Dit maakt het eenvoudig om door een hele competitie heen te fietsen. U hoeft daarbij na de eerste aanroep uitsluitend nog op de "Return" toets te drukken, en automatisch wordt steeds de volgende zitting opgeroepen.

Datastructuren

De NBB-R faciliteiten van picolo veronderstellen bepaalde datastructuren. Het handigste is om deze structuren te laten genereren door de boven beschreven opdrachten Alle Schema's ophalen en Parenfiles ophalen uit NBB-R. Lees meer hierover op deze pagina.

Iedere competitieronde krijgt in de Picolomap een eigen directory waarvan de naam door het programma wordt vastgesteld aan de hand van de naam die de competitie in NBB-R heeft, aangevuld met een aanduiding van de ronde.
Voorbeeld: Clubcompetitie2007-2008_Ronde5
De parenfiles voor alle lijnen komen in deze directory, met namen als parenA.txt, parenB.txt, enzovoorts.
Voor iedere lijn is er een subdirectory met namen als A, B, enzovoorts. Hierin komen de files z1.pro, z2.pro ...
De kolom ident van de parenfile wordt gebruikt voor de CompetitiePaarID van het scoreprogramma (NBB-R of Bridge-It). Deze ID is uniek voor een paar gedurende een Competitie, maar let op: een zelfde paar zal in verschillende competities een verschillende CompetitiePaarID hebben.
Bij het ophalen van een zitting uit NBB-R zoekt picolo het schema op (in de directory Schema/NBB) aan de hand van schemaID en naam van het schema in NBB-R. Als u wedstrijdleider van een aantal clubs bent en verschillende copieën van NBB-R op uw systeem hebt, is het mogelijk dat hetzelfde schema een verschillende schemaID heeft in de verschillende implementaties. Vermijd dit soort conflicten door voor iedere club een aparte Picolomap te hanteren.