added practices to version control

git-svn-id: svn://scm.gforge.inria.fr/svnroot/paradiseo@1002 331e1502-861f-0410-8da2-ba01fb791d7f

utilities/trunk/practices/paradiseo_practices_0208/lesson2/CMakeLists.txt

@@ -0,0 +1,41 @@
+
+
+######################################################################################
+### 1) Include the sources
+######################################################################################
+
+INCLUDE_DIRECTORIES(${EO_SRC_DIR}/src)
+INCLUDE_DIRECTORIES(${EO_SRC_DIR}/src/utils)
+INCLUDE_DIRECTORIES(${MO_SRC_DIR}/src)
+INCLUDE_DIRECTORIES(${CMAKE_SOURCE_DIR}/tsp/src)
+######################################################################################
+
+
+######################################################################################
+### 2) Specify where CMake can find the libraries
+######################################################################################
+
+LINK_DIRECTORIES(${EO_BIN_DIR}/lib ${CMAKE_BINARY_DIR}/tsp/src)
+
+######################################################################################
+
+
+######################################################################################
+### 3) Define your target(s): just an executable here
+######################################################################################
+
+ADD_EXECUTABLE(hill_climbing hill_climbing.cpp) 
+
+ADD_DEPENDENCIES(hill_climbing tsp)
+######################################################################################
+
+
+######################################################################################
+### 4) Link the librairies for your target(s)
+######################################################################################
+
+TARGET_LINK_LIBRARIES(hill_climbing tsp eo eoutils) 
+
+######################################################################################
+
+

utilities/trunk/practices/paradiseo_practices_0208/lesson2/hill_climbing.cpp

@@ -0,0 +1,67 @@
+// -*- mode: c++; c-indent-level: 4; c++-member-init-indent: 8; comment-column: 35; -*-
+
+// "hill_climbing.cpp"
+
+// (c) OPAC Team, LIFL, 2003-2006
+
+/* LICENCE TEXT
+   
+   Contact: paradiseo-help@lists.gforge.inria.fr
+*/
+
+#include <mo.h>
+
+#include <graph.h>
+#include <route.h>
+#include <route_eval.h>
+#include <route_init.h>
+
+#include <two_opt.h>
+#include <two_opt_init.h>
+#include <two_opt_next.h>
+#include <two_opt_incr_eval.h>
+
+int
+main (int __argc, char * __argv []) 
+{
+  if (__argc != 2) {
+    
+    std :: cerr << "Usage : ./hill_climbing [instance]" << std :: endl ;
+    return 1 ;
+  }
+
+  srand (1000) ;
+
+  Graph :: load (__argv [1]) ; // Instance
+
+  Route route ; // Solution
+  
+  RouteInit init ; // Sol. Random Init.
+  init (route) ;
+
+  RouteEval full_eval ; // Full. Eval.
+  full_eval (route) ;
+  
+  std :: cout << "[From] " << route << std :: endl ;
+
+  /* Tools for an efficient (? :-))
+     local search ! */
+  
+  TwoOptInit two_opt_init ; // Init.
+   
+  TwoOptNext two_opt_next ; // Explorer.
+  
+  TwoOptIncrEval two_opt_incr_eval ; // Eff. eval.
+  
+  //moFirstImprSelect <TwoOpt> two_opt_select ;
+  moBestImprSelect <TwoOpt> two_opt_select ;
+  //moRandImprSelect <TwoOpt> two_opt_select ;
+
+  moHC <TwoOpt> hill_climbing (two_opt_init, two_opt_next, two_opt_incr_eval, two_opt_select, full_eval) ;
+  hill_climbing (route) ;
+
+  std :: cout << "[To] " << route << std :: endl ;
+
+  return 0 ;
+}
+

utilities/trunk/practices/paradiseo_practices_0208/lesson2/lesson2.tex

@@ -0,0 +1,90 @@
+\documentclass[a4paper]{article}
+
+\usepackage[english]{babel}
+\usepackage{epsf}
+\usepackage{amssymb}
+\usepackage{here}
+\usepackage{comment}
+\usepackage{graphicx}
+
+\topmargin -2.5cm
+\textheight 25,5cm
+\textwidth 16cm
+\oddsidemargin 0cm
+\evensidemargin 0cm
+
+
+\begin{document}
+
+\textbf{ParadisEO Practices}  {\copyright Franck Seynhaeve,
+Jean-Charles Boisson, Thomas Legrand} \Large{\textbf{\\\\
+Lesson 2: Implement a Hill-Climbing using ParadisEO}}
+
+\normalsize
+
+\vspace{-0,3cm}
+
+\section{Example}
+
+    The archive {\tt paradiseo\_practices\_0208.tgz} installed
+    on your computer contains a Hill-Climbing implemented using ParadisEO-MO~
+    (see {\tt hill\_climbing} in the {\bf build/lesson2} directory).
+
+    \medskip
+    To run it, please go in {\bf build/lesson2} and start the program {\tt hill\_climbing} by giving
+    one of the TSP instances located in {\bf tsp/benchs}.
+
+
+    \medskip
+    When entering {\tt ./hill\_climbing ../../tsp/benchs/berlin52.tsp}, you should end up with the
+    following outputs:
+
+    \smallskip
+    \noindent
+    \texttt{>> Loading [../tsp/benchs/berlin52.tsp]}\\
+    \texttt{[From] -29414  52 1 20 40 48 9 27 13 22 5 28 24 29 21 26 44 38 33 37 45 31 42 18 12 3 14}\\
+    \texttt{36 30 6 51 32 17 11 0 34 4 10 4350 16 2 23 35 19 46 49 39 25 15 41 8 7 47}\\
+    \texttt{[To] -8724  52 1 6 41 29 22 19 49 15 28 46 13 51 12 25 26 27 11 10 50 32 42 9 8 7 40 18}\\
+    \texttt{44 2 16 20 30 17 21 0 31 48 35 3438 39 37 36 33 43 45 24 3 5 4 14 23
+    47} \\
+
+    The printed-out results show for the initial best solution and the final one~:
+    \\ \hspace*{1cm}-the length of the route
+    \\ \hspace*{1cm}-the number of cities
+    \\ \hspace*{1cm}-the route itself (notice that the city index starts from 0).
+
+
+\section{Tabu search}
+
+    Study the {\tt hill\_climbing.cpp} file located in the {\bf lesson2} directory
+    using~:
+    \begin{itemize}
+       \item[$\bullet$] the ParadisEO-MO API documentation available at~:
+
+       \hspace{1cm}http$\,:$//paradiseo.gforge.inria.fr/addon/paradiseo-mo/doc/index.html
+       \item[$\bullet$] the source files located in the {\bf tsp/src/} directory
+    \end{itemize}
+
+\section{Customize the Hill CLimbing}
+
+   Make a backup (copy) of the cpp file {\tt tabuhill\_climbing.cpp}. You can now modify the
+   original {\tt hill\_climbing.cpp} and use the existing makefiles to compile it.
+
+     Edit and modify the {\tt hill\_climbing.cpp} file~:
+    \begin{itemize}
+       \item[$\bullet$] Try to tune a few parameters (random seed
+       and the move selector) and observe the changes on the final
+       solution.
+
+    \end{itemize}
+
+    \smallskip
+    To compile {\tt hill\_climbing.cpp}, you should use the
+    command {\tt make} from {\bf build/lesson2}.
+
+    \medskip
+    Finally, test your modifications on several TSP instances ({\tt berlin52},
+    {\tt eil101} ...) and compare the results you get.
+
+
+\end{document}