00001
00002 EO README FILE
00003
00004 =======================================================================
00005 check latest news at http:
00006 =======================================================================
00007
00008 Welcome to EO, the Evolving Objects library.
00009
00010 The latest news about EO can be found on the sourceforge repository at
00011 http:
00012
00013 In case of any problem, please e-mail us at
00014 eodev-help@lists.sourceforge.net, eodev@egroups.com
00015
00016 To get started, take a look at the tutorial, starting with
00017 ./tutorial/html/eoTutorial.html
00018
00019 The easiest way to start programming a new genome with all EO
00020 evolution engines handy is to create a new standalone EO project from
00021 the tutorial/Templates/ directory. Read Lesson 5 of the tutorial for
00022 an introduction;)
00023
00024
00025 ==================================================================
00026 BUILDING EO
00027 ==================================================================
00028 The basic installation procedure goes the following:
00029
00030 Go to your build-directory and run
00031 $(SRCDIR)/configure
00032 make
00033 make check
00034 make install
00035 where $(SRCDIR) is the top-level source directory of EO, i.e. where
00036 the sources where unpacked.
00037
00038 Run "$(SRCDIR)/configure --help" for possible options. You can specify
00039 to not build example applications, the tutorial, or to build the
00040 ParadisEO tutorial. You may also change the installation directory
00041 that way.
00042
00043 Now you should probably go to the tutorial and start learning about EO
00044 features and programming.
00045
00046
00047 In case of problems, you can read the INSTALL file - but remember this
00048 is a standard installation file from GNU and that it contains nothing
00049 specific about EO.
00050
00051
00052 ===================================================================
00053 DIRECTORY STRUCTURE
00054 ===================================================================
00055 After unpacking the archive file, you should end up with the following
00056 structure:
00057
00058 .../ the MAIN EO dir, created when unpacking
00059 |
00060 +-- src SOURCE dir. Contains most EO .h files
00061 | |
00062 | +- utils general utilities (e.g. RNG-related source files)
00063 | |
00064 | +- ga bistring-genotypes source files
00065 | |
00066 | +- es real-valued-genotypes source files
00067 | |
00068 | +- gp Genetic Programming source files
00069 | |
00070 | +- obsolete files from old versions - for upward compatibility
00071 |
00072 |
00073 |
00074 +-- tutorial TUTORIAL dir (indeed :-)
00075 | |
00076 | +- html all html files - start by browsing index.html
00077 | |
00078 | +- LessonX for X=1, 2, 3, ... : example of increasing complexity
00079 |
00080 |
00081 |
00082 +-- doc DOCUMENTATION dir (generated by Doxygen)
00083 | |
00084 | +- html HTML files - start at index.html (see also tutorial)
00085 | |
00086 | +- latex latex files - use to generate Poatscript doc.
00087 | |
00088 | +- man Unix man format documentation
00089 |
00090 |
00091 +-- test TEST files - for debugging purposes only
00092 |
00093 |
00094 +-- app APPLICATIONS - one dir per separate application
00095 | |
00096 | +- gprop GA/backpropagation for neural nets
00097 | |
00098 | +- mastermind the wellknown MasterMind game
00099 |
00100 |
00101 +-- win WINDOWS dir: project files for MS/VC5+
00102
00103
00104
00105 ===================================================================
00106 NOTES
00107 ===================================================================
00108 If you extracted a fresh snapshot from the cvs-repository, remember
00109 to run
00110 ./autogen.sh
00111 in the source-directory before building the libraries.