ECOSTAT 0.3  (32-bit version) Copyright Rob Weir, 1995-1996
CompuServe: 71165,2722
Internet: rweir@cybercom.net

ECOSTAT is a WIN32 program, so you must be running Windows 95 or NT to use it!
It also requires MSVCRT40.DLL, so be sure to download that also!

This program is free for personal use.
=======================================================================
New in version 0.3 (32-bit version)

ECOSTAT has been rewritten to take advantage of the extra memory and 
32-bit file access in Windows 95 and Windows NT.  Expect it to run around
3400 games/sec.

I've also added these features:

a) Average game length for each opening.
b) Player mode, which gives stats from the perspective of a given player.

=======================================================================
New in version 0.3

1) Added three additional statistics:

a) Opening score, which is %wins + 1/2 %draws
b) Number of rated games in this opening
c) Opening Performance Rating

The Opening Performance Rating is the % score plus or minus what would
be expected from Elo's rating formula.
=======================================================================
New in version 0.2

1) Changed memory strategy to allow program to work within DOS's 16-bit
constaints.  The program now processes the ChessBase files in smaller
chunks, allowing large files to be processed without using a DOS
extender.  Speed is still fine, around 1600 games/sec

2) Wildcard procesing to allow many ChessBase files to be processed at
once.

3) Added table showing breakdown by year.

=======================================================================
Files you now have:

ECOSTAT.TXT   the file you are reading
ECOSTAT.EXE   the ecostat program
SAMPLE.ECO    sample ouput for a sample of almost 500,000 games
KASP.ECO      sample analysis of Kasparov's games

The program ECOSTAT calculates statistics from games in a ChessBase
file.  The table shows a breakdown of games by ECO opening code, giving
(left to right) the ECO code, the number of games in that code, the
percentage of games in that code,  the win/loss/draw percentages, the
number of rated games, performance, and average game length.  

For example, the line for ECO C02 (French Advance Variation) might look like this:

ECO  Count     %     Win    Lose   Draw   Score  Rated Perf  Len
==================================================================
.
.
.
C02   4898    1.05%  39.2%  36.3%  24.6%  51.4%  622   3.5%  37.75
.
.


Which means:

ECO C02 is represented by 4,898 games, which accounts for 1.05% of all 
games surveyed.  White won 39.2% of the time, lost 36.3% of the time and
drew 24.6%.  The overall score for the opening is 51.4%, so White scored
on average .514 points on each game (assuming a draw is worth .5 points.)
622 games had Elo ratings for the players.  Based on these rated games, 
White score 3.5% more than expected.  The average game length was 37.75 moves.

In order for these ECO codes to be tallied, the ChessBase file must
first be categorized by ChessBase's ECO utility (comes with ChessBase
4.0) (or by my CBECO tool) in order to be assigned ECO codes.

=======================================================================

Ecostat is easy to run.  You just pass in the name of a ChessBase file
as an argument and let it run.

For example, if you have a ChessBase file of World Championship games
called WCH.CBI and WCH.CBF, you run ecostat like this:

ECOSTAT WCH.CBF

or if you want to redirect the output to a text file

ECOSTAT WCH.CBF >WCH.ECO


Also, you can run ecostat on many CBF files at once using DOS wildcards,
such as:

ECOSTAT C:\CB4\DATA\*.CBF >BIG.ECO

The file SAMPLE.ECO shows the results when run on several files totaling
almost 500,000 games!

You can also show the statistics from the perspective of a given player.  Normally
ECOSTAT counts everything from White's perspective. If you give a player name, ECOSTAT
will score only games by theat player, and will additionally score from their perspective, 
i.e. a win as black is plus.  To use this player mode, use  command line like this:

ECOSTAT -player=Kasparov c:\CB4\DATA\*.CBF >kasp.eco

An example KASP.ECO file is included.

=======================================================================