Back to Top page.

Running EGG system

To execute EGG system, you can enter

<egg-program-name> -f <config-file>

where <egg-program-name> is the name of EGG execution file, and <config-file> is the name of EGG configuration file. If you omit -f <config-file>, a file named "egg.conf" will be used.

Configuration file

The configuration file contains keyword-value pairs separated by spaces.

[TAGNAME1]      VALUE1
[TAGNAME2]      VALUE2
...

Lines starting with "%" and empty lines are interpreted as comments.

You can define the following options:

INPUT_FILE
The INPUT_FILE tag is used to specify the file which describes the target functionality.
The default is "target.dat".

WORK_DIR
The WORK_DIR tag is used to specify the (relative or absolute) path into which the generated files will be written.
The default is "./".

MAX_GENERATIONS
The MAX_GENERATIONS tag is used to specify the maximum number of generations.
The default is 100.

POPULATION_SIZE
The POPULATION_SIZE tag is used to specify the number of individuals in a Population.
The default is 100.

CROSSOVER_RATE
CROSSOVER_RATE tag is used to specify the crossover rate.
The default is 0.7.

MUTATION_RATE
The MUTATION_RATE tag is used to specify the mutation rate.
The default is 0.1.

SUBGRAPH_SIZE
The SUBGRAPH_SIZE tag is used to specify the maximum number of SubGraphs per Graph.
The default is 25.

MAX_NODE_SIZE
The MAX_NODE_SIZE tag is used to specify the maximum number of Nodes per SubGraph.
The default is 25.

GENERATE_POP_LOG
If the GENERATE_POP_LOG tag is set to YES, the EGG system will generate the log files of the Population data in each generation.
The default is YES.

GENERATE_TIME_LOG
If the GENERATE_TIME_LOG tag is set to YES, the EGG system will generate the log files of the execution time of each generation.
The default is YES.

GENERATE_FITNESS_LOG
If the GENERATE_FITNESS_LOG tag is set to YES, the EGG system will generate the log files of the fitness values of each generation.
The default is YES.

GENERATE_BEST_LOG
If the GENERATE_BEST_LOG tag is set to YES, the EGG system will generate the log files of the best Graph data.
If both the GENERATE_BEST_LOG tag and the GENERATE_DOT tag are set to YES, the EGG system will also generate the log files in DOT file format.
The default is YES.

GENERATE_DOT
If the GENERATE_DOT tag is set to YES, the EGG system will generate the log files in DOT file format.<
The default is NO.
The data files in DOT file format can be used as the source files of "GraphViz".
GraphViz is a product of AT&T Research. It provides a collection of tools for manipulating Graph structures and generating Graph layouts.
For more information, see http://www.research.att.com/sw/tools/graphviz/ .

GENERATE_SAVE
If the GENERATE_SAVE tag is set to YES, the EGG system will save the data of the Population in the last generation. These files are used when the EGG system runs with the -l option.
The default is YES.

GENERATE_EACH_GENERATION
If the GENERATE_EACH_GENERATION tag is set to YES, the EGG system will generate the log files of all the Graph data on each generation.
If both the GENERATE_EACH_GENERATION tag and the GENERATE_DOT tag are set to YES, the EGG system will also generate the log files in DOT file format.
The default is NO.

Command line options

The following options are available:

-f FILE, --file=FILE
Use FILE as the configuration file.

-g GENERATIONS, --gen=GENERATIONS
Use GENERATIONS as the maximum number of generations.

-l, --load
Load resume files.
-s SEED, --seed=SEED
Use SEED as the seed of random number generator.

-h, --help
Print help message and exit.

-V, --version
Print the program version number and exit.