-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathINSTALL
90 lines (57 loc) · 2.83 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
== Installation HOWTO
=== Prerequisites:
- <b>Ruby 1.9.x</b> from http://www.ruby-lang.org/ or http://rubyinstaller.org/
- <i>optional:</i> <b>Gnuplot</b> (for Gnuplot-exporter) from http://www.gnuplot.info/
- <i>optional:</i> <b>git</b> from http://git-scm.com (to build latest version from git repository)
- <i>optional:</i> gems (libraries) for development (install with "gem install <gem-name>" (as root)):
- shoulda and rake (Rakefile, Testsuite)
- flake, flog, roodi and rcov (code quality tools)
=== Download EvoSynth:
- download source package from http://github.com/yadler/EvoSynth/archives/master
- or checkout with:
git clone git://github.com/yadler/EvoSynth.git
=== Run Testcases
To make sure everything is running, run the following command inside the evosynth directory:
rake test
=== Get the required testdata to run the examples (copy into the "testdata" directory):
- http://mat.gsia.cmu.edu/COLOR/instances/myciel4.col (graph colouring)
- http://elib.zib.de/pub/mp-testdata/tsp/tsplib/tsp/bays29.tsp (TSP)
- more testdata:
- http://mat.gsia.cmu.edu/COLOR/instances.html
- http://elib.zib.de/pub/mp-testdata/tsp/tsplib/tsp/index.html
=== Run examples and benchmarks
- run all examples with
rake run_examples
or run single examples with:
ruby -Ilib examples/max_ones.rb
ruby -Ilib examples/partition.rb
...
- <b>Attention:</b> the exporter.rb example will only work if you've installed the gruff, gnuplot and rmagick gems!
- if you are interessted in the performance of the individual components of EvoSynth, run the benchmark task:
rake run_benchmarks
or run individual benchmarks with:
ruby -Ilib test/benchmark/decoder_benchmark.rb
ruby -Ilib test/benchmark/mutation_benchmark.rb
...
=== Setup Netbeans as IDE (http://netbeans.org)
- download and install netbeans
- install Ruby plugin (Tools -> Plugins -> Available Plugins ...)
- create new project:
1. File -> New Project -> Ruby -> "Ruby Application with Existing Sources"
2. choose a name (for example "nb_evosynth")
3. choose a directory, this should be outside of the evosynth directory to keep the git repository clean
4. choose Ruby platform: Ruby 1.9.x
5. set source folder with "Source Folders -> Add folder" -> choose evosynth directory
- right click on new created project "Properties -> Run" -> add "-Ilib" to Ruby options
- test if everything is working:
1. open a example (examples folder in "Source Files")
2. run it with Shift + F6 (you might have to confirm a dialog)
=== Debian 5.0 (lenny)
Because Debian is a bit special about ruby and rubygems here is what I did to get
it running on lenny:
- git is "git-core" ;-)
- install ruby1.9 ruby1.9dev and rubygems1.9 (with all their dependencies)
- gem install rake shoulda
=== Windows
In order to get Gnuplot working on windows, the "gnuplot" executeable should be
inside your PATH system-variable.