Caissa Tools

Nederlands English

Als je geĆÆnteresseerd bent in een versie in je eigen taal dan kan je me altijd een e-mail sturen. Ik zend je dan een bestand met teksten die je moet vertalen. Ik voeg die dan toe samen met een woord van dank.


Caissa Tools is een verzameling van tools die zorgen voor de omzetting van schaak gegevens van het ene formaat naar het andere. Op dit moment zijn er 7 tools:

  1. Converteer PGN partijen naar DGT ChessTheatre invoer.
  2. Bereken de ELO van spelers in een PGN bestand of bestanden.
  3. Converteer PGN partijen in 2 HTML pagina's.
  4. Converteer PGN partijen in JSON formaat.
  5. Converteer PGN partijen in LaTeX formaat.
  6. Maak een PGN bestand voor een toernooi met alle partijen.
  7. Maak statistieken van alle partijen in een PGN bestand.
  8. Vertaal de PGN van alle partijen in het PGN bestand of die van de parameter.
+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Caissa Tools
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : marco.development@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

  ChessTheatre      Zet een bestand met PGN partijen om naar invoer voor
                    ChessTheatre.
  ELOBerekenaar     Berekend de ELO rating van de spelers in het PGN bestand.
  PgnToHtml         Zet een PGN bestand met partijen uit een toernooi om in 2
                    HTML bestanden. Een bestand met de stand en de andere met
                    de uitslagen matrix.
  PgnToJson         Zet een PGN bestand met partijen uit een toernooi om in een
                    JSON bestand.
  PgnToLatex        Zet een PGN bestand met partijen uit een toernooi om in een
                    .tex bestand.
  StartPgn          Maakt een PGN bestand aan met alle partijen die tussen de
                    opgegeven spelers gespeeld (moeten) worden.
  SpelerStatistiek  Maakt een statistiek van alle partijen van de opgegeven
                    speler.
  VertaalPgn        Vertaal de stuk-codes van een PGN partij van een taal naar
                    een andere taal.

Je kan het Nederlands forceren door de parameter -Duser.language=nl voor -jar te zetten.


top ChessTheatre

Omschrijving

Op windows is er geen probleem om je schaakpartijen te publiceren met DGT ChessTheatre. Op Linux is er niets beschikbaar. Gelukkig is DGT heel open over dit product. In deze versie zit een mogelijkheid om je partijen met DGT ChessTheatre te publiceren.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | ChessTheatre
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar ChessTheatre [OPTIE...] --bestand=<PGN bestand>

  --bestand      Het bestand met de partijen in PGN formaat.
  --charsetin    De characterset van <bestand> als deze niet [cp] is.
  --charsetuit   De characterset van de uitvoer als deze niet [cp] moet
                 zijn.
  --maxBestanden Maximum aantal bestanden voor de partijen. Default waarde is
                 50.
  --minPartijen  Minimum aantal partijen per bestand. Default waarde is totaal
                 aantal partijen gedeeld door maxBestanden.
  --uitvoerdir   Directory waar de uitvoer bestanden moeten staan.
  --zip          Naam (met eventuele directory) van de zip file. Deze zip file
                 wordt niet door dit programma gemaakt.

Enkel de parameter bestand is verplicht.

Je vindt nu de XML files in dezelfde directory als waar <bestand> staat of in de directory die je hebt meegegeven met de uitvoerdir parameter. Als je heel weinig partijen hebt dan is de default aantal van 50 XML files misschien een beetje veel. Je kunt deze waarde verminderen of minPartijen op een waarde zetten zodat je minder XML bestanden krijgt.


top ELO Berekenaar

Omschrijving

Om de sterkte van een speler weer te geven gebruikt men de ELO rating. Met deze tool kan je de rating van spelers berekenen met behulp van een PGN bestand van een toernooi. De spelers met hun ELO worden opgeslagen in een CSV bestand (spelerBestand) die later weer als invoer gebruikt kan worden zodat de ELO ratings verder aangepast wordt. Elke nieuwe ELO rating kan worden opgeslagen in het geschiedenisBestand bestand. Zo kan je de evolutie van de ratings zien.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | ELO Berekenaar
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar ELOBerekenaar [OPTIE...] \
    --spelerBestand=<CSV bestand> --toernooiBestand=<PGN bestand>

  --charsetin           De characterset van <bestand> als deze niet [cp] is.
  --charsetuit          De characterset van de uitvoer als deze niet [cp]
                        moet zijn.
  --geschiedenisBestand Het bestand (met .csv extensie) met de evolutie van de
                        ratings.
  --invoerdir           Directory waar het invoer bestand moet staan.
  --spelerBestand       Een CSV bestand (met .csv extensie) met de recentste
                        rating van de spelers. Dit bestand wordt bijgewerkt of
                        aangemaakt.
  --startDatum          De datum vanaf wanneer de partijen meetellen
                        (yyyy.mm.dd).
  --startELO            De start ELO punten voor unrated spelers. De default
                        waarde is 1.600.
  --toernooiBestand     Het bestand met de partijen uit een toernooi in PGN
                        formaat.
  --uitvoerdir          Directory waar de uitvoer bestanden moeten staan.

De parameters spelerBestand en toernooiBestand zijn verplicht.

De parameters spelerBestand en geschiedenisBestand zonder directory.

top PGN to HTML

Omschrijving

Als wedstrijdleider pas ik iedere week de site aan met de gespeelde partijen. Het maken van de matrix was iedere week weer een monnikenwerk om ervoor te zorgen dat de uitslag in de juiste kolom kwam te staan. Regelmatig waren er fouten. Om het werk te vergemakkelijken en de fouten te minimaliseren besloot ik om een tool te maken die een PGN file als invoer te gebruiken om de stand en matrix pagina te genereren. De functie was enkel te gebruiken voor mijn website. Om het 'algemener' te maken genereert tool nu een bestand met enkel de tabel met de stand en een bestand met enkel de tabel van de matrix. Deze bestanden kunnen dan met SiteManager in de juiste pagina's ge-include worden.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten. De layout voor de 2 pagina's staat in 2 properties files in de resource 'directory' van de jar. Zo kan je de layout veranderen zonder de source te veranderen.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to HTML
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToHtml [OPTIE...] --bestand=<PGN bestand>

  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van <bestand> als deze niet [cp] is.
  --charsetuit De characterset van de uitvoer als deze niet [cp] moet zijn.
  --enkel      Enkelrondig <J|n>. Een andere waarde geeft een tweekamp matrix.
  --halve      Lijst met spelers (gescheiden door een ;) die enkel eerste helft
               meespelen. Enkel nodig bij enkel=N.
  --uitvoerdir Directory waar de uitvoer bestanden moeten staan.

Enkel de parameter bestand is verplicht.

Je vindt nu de HTML files in dezelfde directory als waar <bestand> staat of in de directory die je hebt meegegeven met de uitvoerdir parameter.


top PGN to JSON

Omschrijving

Met de hulp van mede schaker Nico heb ik een Javascript gemaakt om ChessTheatre te vervangen (Het maakt gebruikt Flashplayer dat niet langer overal ondersteund wordt). Omdat Javascript beter werkt met JSON dan met PGN heb ik deze tool geschreven.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to JSON
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToJson [OPTIE...] --bestand=<PGN bestand>

  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van  als deze niet UTF-8 is.
  --charsetuit De characterset van de uitvoer als deze niet UTF-8 moet zijn.
  --invoerdir  Directory waar het invoer bestand moet staan.
  --json       Het bestand met de partijen in JSON formaat.
  --pgnviewer  Informatie voor de PGNViewer toevoegen .
  --uitvoerdir Directory waar de uitvoer bestanden moeten staan.

Enkel de parameter bestand is verplicht.

Je vindt nu het JSON bestand in dezelfde directory als waar <bestand> staat of in de directory die je hebt meegegeven met de uitvoerdir parameter.


top PGN to LaTeX

Omschrijving

Als schaker en wedstrijdleider was ik al een tijdje op zoek om mijn partijen in een PDF bestand te zetten met een diagram van de eindstand. Ik gebruik SCID als database en daarin zit een optie om partijen te exporteren naar LaTeX formaat. Ik heb dit bestand verwerkt met MiKTeX. Helaas stond mij de manier om een einddiagram te maken niet aan. Je moest dit in SCID zelf aangeven. Ik wilde dit niet. Na wat zoeken op het internet vond ik SKAK. Dit is een package voor LaTeX die het mogelijk maakt om een diagram te maken wanneer je dat wilt zonder dit in SCID te definiƫren. Omdat ik geen conversieprogramma kon vinden die mij beviel heb ik er zelf een gemaakt. De eerste versie bestond uit 2 classes (PgnToLatex en PGN). De uitvoer was een TEX file met enkel de partijen.

Omdat ik het alleen maar gebruikte om de partijen van 1 competitie te converteren kwam ik op het idee om er een matrix aan toe te voegen met de eindstand erin verwerkt.

Gebruik

Voer de executable JAR uit met de benodigde parameters. De keywords worden gebruikt om in de header van het PDF bestand te zetten. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to LaTeX
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToLatex [OPTIE...] --bestand=<PGN bestand>

  --auteur     De auteur of club die de partijen publiceert.
  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van <bestand> als deze niet [cp] is.
  --charsetuit De characterset van de uitvoer als deze niet [cp] moet zijn.
  --datum      De datum waarop de partijen zijn gespeeld.
  --enkel      Enkelrondig <J|n>. Een andere waarde geeft een tweekamp matrix.
  --halve      Lijst met spelers (gescheiden door een ;) die enkel eerste helft
               meespelen. Enkel nodig bij enkel=N.
  --keywords   Lijst van keywords (gescheiden door een ;).
  --logo       Logo op de titel pagina.
  --matrix     Uitslagen matrix <J|n>.
  --template   Een template voor het uitvoer TEX bestand.
  --titel      De titel van het document.

Enkel de parameter bestand is verplicht.

Je vindt nu een TEX file in dezelfde directory als waar <bestand> staat.


top Start PGN

Omschrijving

Niets is zo tijdrovend om een database te maken van een toernooi. Met deze tool maak je een PGN bestand aan met hierin alle partijen tussen alle spoelers. De uitslag is onbeslist. Op deze manier moet je enkel de uitslagen invoeren.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Start PGN
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar StartPgn --bestand=<PGN bestand>
    --date=<datum> --event=<event> --site=<site> \
    --spelers=<speler1>[;<speler2>...] \
    [--uitvoerdir=<uitvoer-directory>]

  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van <bestand> als deze niet [cp] is.
  --charsetuit De characterset van de uitvoer als deze niet [cp] moet zijn.
  --date       Datum van het toernooi.
  --event      Naam van het toernooi.
  --site       Plaats waar het toernooi gespeeld wordt.
  --spelers    Lijst met spelers (gescheiden door een ;).
  --uitvoerdir Directory waar de uitvoer bestanden moeten staan.

Alle parameters (behalve uitvoerdir) zijn verplicht.

Je vindt nu de PGN file in de directory waar je het commando uitvoert of in de directory die je hebt meegegeven met de uitvoerdir parameter.


top Statistieken

Omschrijving

Je hebt al je partijen in een PGN bestand staan en je wilt wel eens weten tegen wie je de beste resultaten hebt gehaald of in welk jaar je het beste speelde. Met deze tool maak je allerlei statistieken gebaseerd op de TAGs.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Speler Statistieken
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar SpelerStatistiek [OPTIE...] \
    --bestand=<PGN bestand> --speler=<Naam van de speler>

  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van <bestand> als deze niet [cp] is.
  --charsetuit De characterset van de uitvoer als deze niet [cp] moet zijn.
  --logo       Logo op de titel pagina.
  --speler     De speler voor de statistieken.
  --tag        De PGN tag waarop de statistieken gebaseerd zijn. Zonder deze
               parameter zijn het de tegenstanders. Bij de tag "date" wordt het
               het jaar.

De parameters bestand en speler zijn verplicht.

Je vindt nu een TEX file in dezelfde directory als waar <bestand> staat.


top Vertaal PGN

Omschrijving

Soms krijg e een PGN bestand met stuk codes in een andere taal dan die van je schaakdatabase. In plaats van enkel zoek-en-vervang acties kan je ook deze tool gebruiken om het werk te doen.

Gebruik

Voer de executable JAR uit met de benodigde parameters. Pas op met spaties. Als een waarde van een parameter een spatie bevat moet je de hele waarde van die parameter tussen dubbele quotes zetten.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Vertaal PGN
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar VertaalPgn [OPTIE...]

  --bestand    Het bestand met de partijen in PGN formaat.
  --charsetin  De characterset van <bestand> als deze niet [cp] is.
  --charsetuit De characterset van de uitvoer als deze niet [cp] moet zijn.
  --naartaal   De taal van de uitvoer als die anders is dan: [taal].
  --pgn        De zetten die vertaald moeten worden. Plaats ze tussen ".
  --vantaal    De taal van de invoer als die anders is dan: [taal].

De invoer kan of een PGN <bestand> zijn of een invoer als parameter <pgn>. In
geval van een bestand wordt er een bestand aangemaakt met de <naartaal>
(voorafgegaan van een _) aan het eind van de bestandsnaam.

De talen die je kan gebruiken zijn CZ, DA, DE, EN, ES, ET, FI, FR, HU, IS, IT, NL, NO, PL, PT, RO, SV, and UTF8.


Versie Datum Wijziging
1.2.0 2017/12/28 Een PGN bestand kan nu worden omgezet naar een JSON bestand.
1.1.2 2014/12/31 Het CSV bestand met de spelers en hun ELO punten werd niet juist weggeschreven na een aanpassing van hun ELO. De naam werd niet juist omsloten door dubbele quotes..
1.1.1 2014/10/09 De gamedataX.xml bestanden, behalve de laatste, werden niet gesloten. Hierdoor kreeg je bestanden van 8192 of 0 bytes.
1.1.0 2014/09/30 Enkele bugs verwijderd.
De layout van de index.html en matrix.html staan in 2 properties files in de resource 'directory' van de jar. Zo kan je de layout veranderen zonder de sources te veranderen.
1.0.0 2013/11/22 Enkele bugs verwijderd.
Eerste meertalige versie. Beschikbaar in Nederlands en Engels.
Er is nu ook een tool VertaalPgn om de stuk codes van een taal naar een ander taal te vertalen.
De PgnToLatex kan nu ook een matrix genereren voor een match.
0.5.0 2012/04/21 Enkele bugs verwijderd.
Er is nu ook de tool ELOBerekenaar aanwezig die aan de hand van een pgn bestand de ELO ratings van de spelers bepaald.
De tool PDF to Latex zorgt er nu ook voor dat de titel, auteur en keywords van de PDF header worden ingevuld. Ook is het papierformaat nu A4.
0.4.1 2011/05/08 ChessTheatre werkte niet correct. PGN met TAB karakter werkt nu correct en ook een 'Round' tag met meerdere niveaus werkt nu ook goed.
PgnToHtml maakt nu enkel de tabellen aan in HTML. Deze moeten nu ge-include worden in de 'echte' HTML pagina. Kijk voor het includen misschien naar SiteManager.
0.4.0 2011/04/17 Op windows is er geen probleem om je schaakpartijen te publiceren met DGT ChessTheatre. Op Linux is er niets beschikbaar. Gelukkig is DGT heel open over dit product. In deze versie zit een mogelijkheid om je partijen met DGT ChessTheatre te publiceren.
0.3.1 2010/12/04 Na mijn overstap van Windows naar Linux kwam ik in de problemen met de accenten op de letters. Windows is ISO-8859-1 en Linux UTF-8. Hierdoor komt ook meteen de tool voor de Speler Statistiek beschikbaar.

Downloads