Nchr2, for revision number please look at "rev" file in the current directory.

To compile you need to have the following libraries installed on your system:

libgd2 
libboost_python
libpython2.6
libboost_iostreams-mt
libboost_serialization

This version can be compiled with previous libpython (tested with 2.3 and 2.5)
versions but you have to manually change the library name in config.mk and
include directories.

Compilation of release target:

make release

Compilation of benchmark program (to check your system performance):

make bench

Bench target does not require any additional libraries and can be compiled in
case of problems with release.

To conduct a simulation you need a system with a good performance. Performance
can be checked using bench.out application in the following way:

./gen/bench/bench.out

Results show you how many generations per second your system is able to compute
for given PB in the leftmost column (distance for partner lookup and children
placent, Panm. stands for panmictic and means no resticted distances) and
different sizes of the lattice in the topmost row.

Typical results for Intel Core 2:

PB        128     256     512
Panm.   147.97   25.96    5.65
2       116.76   22.11    4.85
4       79.73    16.79    3.76

From this matrix you can read that this machine can compute as many as 22.11
generations per second for lookup and placement distances equal to 2 and the
size of lattice of 256x256. Intel Core i7 can perform twice as fast on average.

You will find examples of input files in directory examples. To run an example
you need to issue a following command:

./gen/release/Nchr2 ./examples/example1.in

You shoud run those in separate directories because Nchr2 writes output files
in the curent directory.

You will find more information about the available options by typing

help(Lattice)
help(Population)

in the interactive program session (program started without an input file). More
information will be available on the program site: http://www.wojek.net/ in
the near future.

You can use this program with wide variety of queing systems. Sample scripts to
start task in torque or any PBS-compatible system are in scripts directory.

In order to get the OpenOffice/LibreOffice spreadsheets in the ODS file format.
Nchr2 will need zip utility to be available in the $PATH.


This software can be used for any academic and non commercial use. Any part of
this program can be copied with the note about the author.
