https://iridia.ulb.ac.be/w/api.php?action=feedcontributions&user=JonasKuckling&feedformat=atomIridiaWiki - User contributions [en]2024-03-29T00:37:10ZUser contributionsMediaWiki 1.35.4https://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8220Getting started for Demiurge2021-11-08T14:35:31Z<p>JonasKuckling: /* Install AutoMoDe and related software */</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
<br />
== Install AutoMoDe and related software ==<br />
<br />
* Install argos3<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal:<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository <br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code>, if you want to install argos3 into $HOME/argos3-dist (recommended on the cluster), otherwise choose the location to your liking<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code> (or whatever you chose in the earlier step)<br />
*#*# <code>export PKG_CONFIG_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=$ARGOS_INSTALL_PATH/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout dev</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code><br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''<br />
<br />
== Development guidelines (git rules) ==<br />
<br />
* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.<br />
<br />
== Proj H402 (Master 1 project) ==<br />
We have an organization (in terms of GitLab group) on [https://gitlab.com/ GitLab] where we can host the git repositories for the students of [[PROJ-H-402_-_Computing_Project:_Rules | PROJ-H-402]].<br />
Please keep the following things in mind:<br />
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.<br />
* When a student is finished with the project, please let them prepare a release. This allows us to identify the contribution of each individual student, even if two or more students work on the same repository or another student takes up the development.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8219Getting started for Demiurge2021-11-08T14:28:14Z<p>JonasKuckling: /* Install AutoMoDe and related software */ Updated AutoMoDe instructions</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
<br />
== Install AutoMoDe and related software ==<br />
<br />
* Install argos3<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal:<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository <br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code>, if you want to install argos3 into $HOME/argos3-dist (recommended on the cluster), otherwise choose the location to your liking<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code> (or whatever you chose in the earlier step)<br />
*#*# <code>export PKG_CONFIG_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=$ARGOS_INSTALL_PATH/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code><br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''<br />
<br />
== Development guidelines (git rules) ==<br />
<br />
* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.<br />
<br />
== Proj H402 (Master 1 project) ==<br />
We have an organization (in terms of GitLab group) on [https://gitlab.com/ GitLab] where we can host the git repositories for the students of [[PROJ-H-402_-_Computing_Project:_Rules | PROJ-H-402]].<br />
Please keep the following things in mind:<br />
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.<br />
* When a student is finished with the project, please let them prepare a release. This allows us to identify the contribution of each individual student, even if two or more students work on the same repository or another student takes up the development.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8218Getting started for Demiurge2021-11-08T14:25:39Z<p>JonasKuckling: /* Install AutoMoDe */ Updated description for argos3 and argos3-epuck</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
<br />
== Install AutoMoDe and related software ==<br />
<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal:<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository <br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code>, if you want to install argos3 into $HOME/argos3-dist (recommended on the cluster), otherwise choose the location to your liking<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code> (or whatever you chose in the earlier step)<br />
*#*# <code>export PKG_CONFIG_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=$ARGOS_INSTALL_PATH/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build && cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code><br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code><br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
* In order to install NEAT<br />
*# ''Coming soon''<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''<br />
<br />
== Development guidelines (git rules) ==<br />
<br />
* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.<br />
<br />
== Proj H402 (Master 1 project) ==<br />
We have an organization (in terms of GitLab group) on [https://gitlab.com/ GitLab] where we can host the git repositories for the students of [[PROJ-H-402_-_Computing_Project:_Rules | PROJ-H-402]].<br />
Please keep the following things in mind:<br />
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.<br />
* When a student is finished with the project, please let them prepare a release. This allows us to identify the contribution of each individual student, even if two or more students work on the same repository or another student takes up the development.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8217Getting started for Demiurge2021-11-08T14:19:11Z<p>JonasKuckling: /* Set up your working environment */ Added new section heading as test</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
<br />
== Install AutoMoDe ==<br />
<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code><br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
* In order to install NEAT<br />
*# ''Coming soon''<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''<br />
<br />
== Development guidelines (git rules) ==<br />
<br />
* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.<br />
<br />
== Proj H402 (Master 1 project) ==<br />
We have an organization (in terms of GitLab group) on [https://gitlab.com/ GitLab] where we can host the git repositories for the students of [[PROJ-H-402_-_Computing_Project:_Rules | PROJ-H-402]].<br />
Please keep the following things in mind:<br />
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.<br />
* When a student is finished with the project, please let them prepare a release. This allows us to identify the contribution of each individual student, even if two or more students work on the same repository or another student takes up the development.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8169Getting started for Demiurge2019-10-17T16:22:13Z<p>JonasKuckling: Added rules for Proj H402</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code><br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
* In order to install NEAT<br />
*# ''Coming soon''<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''<br />
<br />
== Development guidelines (git rules) ==<br />
<br />
* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.<br />
<br />
== Proj H402 (Master 1 project) ==<br />
We have an organization (in terms of GitLab group) on [https://gitlab.com/ GitLab] where we can host the git repositories for the students of [[PROJ-H-402_-_Computing_Project:_Rules | PROJ-H-402]].<br />
Please keep the following things in mind:<br />
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.<br />
* When a student is finished with the project, please let them prepare a release. This allows us to identify the contribution of each individual student, even if two or more students work on the same repository or another student takes up the development.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Development_Guidelines&diff=8167Demiurge Development Guidelines2019-09-19T15:02:32Z<p>JonasKuckling: Added slightly extended instructions</p>
<hr />
<div>== General rules ==<br />
# Don't talk about the git club<br />
# Useful commit messages are required, (at least on master branches, or when merging to it)<br />
# Never commit directly to the master branch<br />
# Bug fixes should be done in the dev branch<br />
# New developments should be done in your own branch (branching from the dev branch)<br />
# When development is finished and your code is stable merge your branch into the dev branch<br />
# Make sure your commit history is clean before merge into the dev branch (git rebase -i is your friend)<br />
# After merging, delete any useless branch<br />
# The master branch will be updated regularly based on the dev branch<br />
<br />
== Branching structure ==<br />
<br />
* The ''master'' branch of each repository should be considered to be "release ready", meaning that at every point in time it should compile without error, be well-documented and as bug-free as possible.<br />
* The ''dev'' branch will be used to share common resources and bug fixes between us (internally). It should be kept as stable as possible (and once you are sure it is working correctly might be merged into the master branch).<br />
* If you start developing a new feature (a new loop-function, new reference model, new features for the colored arena, etc.) you should branch of the ''dev'' branch. Whenever there are bug fixes (or other important commits on ''dev'') you should merge the ''dev'' branch into your own branch (you should do this regularly as this will help you also in the future when you need to merge your branch back into the ''dev'' branch).<br />
* Once your development is finished and you want to share your code with the rest of us (or a publication is approaching), merge your feature into ''dev''. If you do this timely than the others can use your code for their experiments (and you don't need to solve merge conflict six months after you last touched the code). Before you do the merge, we would ask you to run a rebase (<code>git rebase -i [COMMIT_HASH]</code> to clean your commit history. Experience shows that many commits are not as nice as they can be (committing the same file in several subsequent commits, "helpful" commit messages like done, non-compiling commits to save your work at the end of the day).<br />
* If the code in ''dev'' is stable enough, we will merge it into the ''master'' branch. From there you can create a "tag" or "release" in git which you can then reference from your paper.<br />
<br />
=== Special case: AutoMoDe ===<br />
<br />
The core project of AutoMoDe is a special case. Since we are doing many mutually exclusive changes to the controller and grammar we cannot merge our changes together. Instead we will keep a private repository in which we will develop.<br />
The ''master'' branch of this repository is similar to the ''dev'' branch of the other repositories. General bug fixes will be made here and you should update your own branches when changes are made in the ''master''.<br />
For your own AutoMoDe version, you branch of ''master'' and develop your code. Once it is ready for publication, you will create a branch from ''master'' branch in the '''public''' AutoMoDe repository (give it a name related to your publication if possible). Copy your code from the private repository to the public one and commit it (in a single commit). This way also this code should be available for all researchers. Please still make sure that it is well documented, compiles without errors and is bug free (as much as possible).<br />
<br />
== Useful links ==<br />
https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History<br />
<br />
https://git-scm.com/docs/git-merge</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8125Getting started for Demiurge2019-03-14T16:01:45Z<p>JonasKuckling: </p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
* In order to install EvoStick<br />
*# ''Coming soon''<br />
* In order to install NEAT<br />
*# ''Coming soon''<br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8101Getting started for Demiurge2018-12-13T15:39:01Z<p>JonasKuckling: /* Set up your working environment */ Added repositories</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe<br />
*# Download and install the loopfunctions<br />
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code><br />
*## <code>cd AutoMoDe-loopfunctions</code><br />
*## <code>git checkout simulation</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO<br />
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code><br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code><br />
*## <code>cd AutoMoDe</code><br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8100Getting started for Demiurge2018-10-10T13:27:01Z<p>JonasKuckling: Added short DAO summary (untested)</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
*# Download and install the loopfunctions<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO '''TODO'''<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd AutoMoDe-DAO</code><br />
*## <code>mkdir build && cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install AutoMoDe<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8098Getting started for Demiurge2018-10-05T10:25:30Z<p>JonasKuckling: Added prerequisites for Argos</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''<br />
*#* <code>sudo apt-get install libfreeimage-dev libfreeimageplus-dev qt5-default freeglut3-dev libxi-dev libxmu-dev liblua5.2-dev lua5.2 doxygen graphviz graphviz-dev asciidoc</code><br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
*# Download and install the loopfunctions<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO '''TODO'''<br />
*# Download and install AutoMoDe<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8092Getting started for Demiurge2018-09-20T15:57:42Z<p>JonasKuckling: Added basic instructions for AutoMoDe installation</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
*# Download and install the loopfunctions<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code><br />
*## <code>make</code><br />
*## <code>make install</code><br />
*# Download and install the e-puck DAO '''TODO'''<br />
*# Download and install AutoMoDe<br />
*## <code>git clone</code> '''TODO'''<br />
*## <code>cd </code> '''TODO'''<br />
*## <code>mkdir build</code><br />
*## <code>cd build</code><br />
*## <code>cmake ..</code><br />
*## <code>make</code><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8091Getting started for Demiurge2018-09-20T15:49:11Z<p>JonasKuckling: Removed a couple of TODO lines</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
<!-- ** '''TODO''' What is most important of these steps? --><br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
<!-- ** Development rules for the github repositories: '''TODO''' --><br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8090Getting started for Demiurge2018-09-20T15:46:08Z<p>JonasKuckling: Added description on how to remove default plugin</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands<br />
*#*# <code>rm -rf include/argos3/plugins/robots/e-puck</code><br />
*#*# <code>rm -rf lib/argos3/lib*epuck*.so</code><br />
<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8061Getting started for Demiurge2018-08-28T16:24:00Z<p>JonasKuckling: Fix for irace</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8060Getting started for Demiurge2018-07-18T10:47:23Z<p>JonasKuckling: /* Set up your working environment */ Fixed typo</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8059Getting started for Demiurge2018-07-17T11:54:43Z<p>JonasKuckling: Bashrc now follows convention as above</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGIS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8058Getting started for Demiurge2018-07-17T11:53:24Z<p>JonasKuckling: Fixed .bashrc description</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/lib/argos3</code><br />
*#*# <code>export LD_LIBRARY_PATH=$ARGIS_PLUGIN_PATH:$LD_LIBRARY_PATH</code><br />
*#*# <code>export PATH=[INSTALL_LOCATION]/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8057Getting started for Demiurge2018-07-10T10:33:03Z<p>JonasKuckling: /* Set up your working environment */</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=/home/jkuckling/argos3-dist/lib/argos3</code><br />
*#*# <code>export PATH=/home/jkuckling/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make install</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8056Getting started for Demiurge2018-07-10T10:32:45Z<p>JonasKuckling: /* Set up your working environment */</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)<br />
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/lib/pkgconfig</code><br />
*#*# <code>export ARGOS_PLUGIN_PATH=/home/jkuckling/argos3-dist/lib/argos3</code><br />
*#*# <code>export PATH=/home/jkuckling/argos3-dist/bin/:$PATH</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8055Getting started for Demiurge2018-07-10T10:30:35Z<p>JonasKuckling: /* Set up your working environment */</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* '''TODO:''' Setup paths for argos3 in .bashrc<br />
export PKG_CONFIG_PATH=/home/jkuckling/argos3-dist/lib/pkgconfig<br />
export ARGOS_PLUGIN_PATH=/home/jkuckling/argos3-dist/lib/argos3<br />
export PATH=/home/jkuckling/argos3-dist/bin/:$PATH<br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8054Getting started for Demiurge2018-07-10T10:27:46Z<p>JonasKuckling: </p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*#* '''TODO''' Remove the default e-puck plugin<br />
*#* '''TODO:''' Setup paths for argos3 in .bashrc<br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:'''<br />
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL<br />
*#* Prepare the build of the epuck-plugin<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the same place as for argos3 (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8053Getting started for Demiurge2018-07-10T10:11:00Z<p>JonasKuckling: More description for the e-puck plugin</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* Get the repository:<br />
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?<br />
*#*# <code>cd argos3</code><br />
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code>make</code><br />
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF<br />
*#*# <code>make install</code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
*#* Get the repository<br />
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code><br />
*#*# <code>cd argos3-epuck</code><br />
*#*# <code>git checkout v48</code><br />
*#* '''If you are on the cluster:''' Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code><br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8052Getting started for Demiurge2018-07-10T09:51:21Z<p>JonasKuckling: Added information about number of occurences of wrong cmake version</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* First get the repository by running <code>git clone git@github.com:ilpincy/argos3.git argos3</code><br />
*#* Then checkout the correct version by running <code>git checkout 3.0.0-beta48</code> in the argos3 folder<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file. There are two occurences that need to be replaced.<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code></code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8051Getting started for Demiurge2018-07-10T09:44:44Z<p>JonasKuckling: Added some instructions for argos3 (manual installation)</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*#* First get the repository by running <code>git clone git@github.com:ilpincy/argos3.git argos3</code><br />
*#* Then checkout the correct version by running <code>git checkout 3.0.0-beta48</code> in the argos3 folder<br />
*#* '''If you are on the cluster:''' Change the CMake-version from 2.8.12 to 2.8.8 in the src/CMakeLists.txt file<br />
*#* Prepare the build of argos3<br />
*#*# <code>mkdir build</code><br />
*#*# <code>cd build</code><br />
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>, where the [INSTALL_LOCATION] is the place where you will place all compiled projects (on the cluster /home/[USER_NAME]/)<br />
*#*# <code></code><br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8050Getting started for Demiurge2018-07-10T09:19:37Z<p>JonasKuckling: /* Set up your working environment */</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*#* If you are installing on the new rack, replace the 2.15 in the path by 3.5. This is because we have an updated version of R.<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8049Getting started for Demiurge2018-07-10T07:41:57Z<p>JonasKuckling: /* Set up your working environment */ Fixed name of package</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8048Demiurge Writing Papers2018-07-03T13:53:44Z<p>JonasKuckling: Added text about Texlive</p>
<hr />
<div>== LaTex ==<br />
<br />
In order to reduce any difference in the layout of generated LaTex documents, we should all use the same LaTex Distribution (TexLive).<br />
<br />
In Ubuntu you can install it simply with <code>apt install texlive-full</code><br />
<br />
For Windows there is a downloadable installer from the [https://www.tug.org/texlive/acquire-netinstall.html Texuser Group]. You might need to uninstall any previous LaTex-Distribution (such as MikTex).<br />
<br />
The full installation of Texlive takes some time, please be patient.<br />
<br />
== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together. All labels in the bibliography have to follow the [[Conventions_for_Bibtex_labels | labeling conventions]].<br />
<br />
If you notice any errors in the file, please do one of the following solutions:<br />
* If it is a small change (e.g. typo, incorrect use of special characters, wrong year of publication): <br />
** If you like (and know what to do), just fix the error, commit it and push it to the repository.<br />
** If you don't want to fix it (or don't know how to) you can still try the other solution.<br />
* If the first case didn't apply to this error:<br />
** Create an issue on github<br />
** Assign whoever created and/or last modified the entry<br />
** Describe what you think the error is (maybe it was done with a reason)<br />
** Wait for them to resolve the issue<br />
<br />
=== Contents of an entry for @InProceedings ===<br />
* authors<br />
* title<br />
* editor<br />
* book title<br />
* pages<br />
* address<br />
* series and volume (if applicable)</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8044Demiurge Writing Papers2018-04-25T12:03:24Z<p>JonasKuckling: Added contents of @InProceedings</p>
<hr />
<div>== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together. All labels in the bibliography have to follow the [[Conventions_for_Bibtex_labels | labeling conventions]].<br />
<br />
If you notice any errors in the file, please do one of the following solutions:<br />
* If it is a small change (e.g. typo, incorrect use of special characters, wrong year of publication): <br />
** If you like (and know what to do), just fix the error, commit it and push it to the repository.<br />
** If you don't want to fix it (or don't know how to) you can still try the other solution.<br />
* If the first case didn't apply to this error:<br />
** Create an issue on github<br />
** Assign whoever created and/or last modified the entry<br />
** Describe what you think the error is (maybe it was done with a reason)<br />
** Wait for them to resolve the issue<br />
<br />
=== Contents of an entry for @InProceedings ===<br />
* authors<br />
* title<br />
* editor<br />
* book title<br />
* pages<br />
* address<br />
* series and volume (if applicable)</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8038AutoMoDe Arena Experiments2018-04-10T09:02:16Z<p>JonasKuckling: /* Preparing the robots */ Added instructions to upload files</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
In order to run ARGoS and AutoMoDe on the e-pucks, you need to crosscompile all necessary libraries.<br />
# Download the cross-compiler that Ken build ('''TODO:''' Link) and extract it on your computer<br />
# Open the TargetEPuck.cmake file and change each occurence of <code>/usr/local/angstrom/arm</code> with the path to the crosscompiler. '''TODO:''' Verify that this is the correct path.<br />
#* Instead of changing every .cmake file on your system, you can also setup only one TargetEPuck.cmake file and reference it from all of your projects.<br />
# Add to folders to the root level of your project: build and build_epuck<br />
#* Do we need to compile first before cross-compiling?<br />
# In the folder build_epuck run the usual cmake command for that project in your terminal but add the following parameter to cmake <code>-DCMAKE_TOOLCHAIN_FILE=path/to/your/TargetEPuck.cmake</code><br />
# Once cmake completed without any errors, run make and get your executable or library.<br />
# Sometimes you need to install the so created executable or library to the cross-compiler for future linking. Running <code>sudo make install</code> will do so, but also has the side effect of changing the include path <code>lib.d</code>. '''Question:''' Does this only happen for sudo make install or also for just make install?<br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
One way of uploading all the files can be done by:<br />
# Open a terminal in the <code>build_epuck</code> folder for the tracking system, and all of your controllers.<br />
# Then run <code>python3 /path/to/makeupload.py -j /path/to/epucks.json -c <name of the controller in your epucks.json file></code><br />
# Open a terminal in where you generated the experiment files (that is RobotFiles and PCFiles)<br />
# Then run <code>python3 /path/to/massupload.py -j /path/to/epucks.json -c <name of the controller in your epucks.json file></code><br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8037Demiurge Writing Papers2018-03-30T13:22:12Z<p>JonasKuckling: Added short instructions on how to deal with errors.</p>
<hr />
<div>== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together. All labels in the bibliography have to follow the [[Conventions_for_Bibtex_labels | labeling conventions]].<br />
<br />
If you notice any errors in the file, please do one of the following solutions:<br />
* If it is a small change (e.g. typo, incorrect use of special characters, wrong year of publication): <br />
** If you like (and know what to do), just fix the error, commit it and push it to the repository.<br />
** If you don't want to fix it (or don't know how to) you can still try the other solution.<br />
* If the first case didn't apply to this error:<br />
** Create an issue on github<br />
** Assign whoever created and/or last modified the entry<br />
** Describe what you think the error is (maybe it was done with a reason)<br />
** Wait for them to resolve the issue</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8036Demiurge Writing Papers2018-03-30T13:04:38Z<p>JonasKuckling: Added link to labeling conventions</p>
<hr />
<div>== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together. All labels in the bibliography have to follow the [[Conventions_for_Bibtex_labels | labeling conventions]].</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8035Demiurge Writing Papers2018-03-30T11:09:22Z<p>JonasKuckling: Protected "Demiurge Writing Papers" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite) [read=autoconfirmed] (indefinite))</p>
<hr />
<div>== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Demiurge_Writing_Papers&diff=8034Demiurge Writing Papers2018-03-30T11:06:16Z<p>JonasKuckling: Created page with link to github repository</p>
<hr />
<div>== The bibliography ==<br />
<br />
We have a [https://github.com/demiurge-project/bibtex_references private repository] on github, where all references should be put together.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8033Getting started for Demiurge2018-03-30T11:02:20Z<p>JonasKuckling: Added link to paper writing page</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Writing your paper ==<br />
<br />
* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8032AutoMoDe Arena Experiments2018-03-29T12:18:50Z<p>JonasKuckling: Added compilation instructions</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
In order to run ARGoS and AutoMoDe on the e-pucks, you need to crosscompile all necessary libraries.<br />
# Download the cross-compiler that Ken build ('''TODO:''' Link) and extract it on your computer<br />
# Open the TargetEPuck.cmake file and change each occurence of <code>/usr/local/angstrom/arm</code> with the path to the crosscompiler. '''TODO:''' Verify that this is the correct path.<br />
#* Instead of changing every .cmake file on your system, you can also setup only one TargetEPuck.cmake file and reference it from all of your projects.<br />
# Add to folders to the root level of your project: build and build_epuck<br />
#* Do we need to compile first before cross-compiling?<br />
# In the folder build_epuck run the usual cmake command for that project in your terminal but add the following parameter to cmake <code>-DCMAKE_TOOLCHAIN_FILE=path/to/your/TargetEPuck.cmake</code><br />
# Once cmake completed without any errors, run make and get your executable or library.<br />
# Sometimes you need to install the so created executable or library to the cross-compiler for future linking. Running <code>sudo make install</code> will do so, but also has the side effect of changing the include path <code>lib.d</code>. '''Question:''' Does this only happen for sudo make install or also for just make install?<br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8031AutoMoDe Arena Experiments2018-03-29T12:17:56Z<p>JonasKuckling: </p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
In order to run ARGoS and AutoMoDe on the e-pucks, you need to crosscompile all necessary libraries.<br />
# Download the cross-compiler that Ken build ('''TODO:''' Link) and extract it on your computer<br />
# Open the TargetEPuck.cmake file and change each occurence of <code>/usr/local/angstrom/arm</code> with the path to the crosscompiler. '''TODO:''' Verify that this is the correct path.<br />
#* Instead of changing every .cmake file on your system, you can also setup only one TargetEPuck.cmake file and reference it from all of your projects.<br />
# Add to folders to the root level of your project: build and build_epuck<br />
#* Do we need to compile first before cross-compiling?<br />
# In the folder build_epuck run the usual cmake command for that project in your terminal but add the following parameter to cmake <code>-DCMAKE_TOOLCHAIN_FILE=path/to/your/TargetEPuck.cmake</code><br />
# Once cmake completed without any errors, run make and get your executable or library.<br />
# Sometimes you need to install the so created executable or library to the cross-compiler for future linking. Running <code>sudo make install</code> will do so, but also has the side effect of changing the include path <code>lib.d</code>.<br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8030AutoMoDe Arena Experiments2018-03-29T10:44:57Z<p>JonasKuckling: </p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
In order to run ARGoS and AutoMoDe on the e-pucks, you need to crosscompile all necessary libraries.<br />
# Download the cross-compiler that Ken build ('''TODO:''' Link) and extract it on your computer<br />
# Open the TargetEPuck.cmake file and change each occurence of <code>/usr/local/angstrom/arm</code> with the path to the crosscompiler. '''TODO:''' Verify that this is the correct path.<br />
#* Instead of changing every .cmake file on your system, you can also setup only one TargetEPuck.cmake file and reference it from all of your projects.<br />
# Add to folders to the root level of your project: build and build_epuck<br />
#* Do we need to compile first before cross-compiling?<br />
# In the folder build_epuck run the usual cmake command for that project in your terminal but add the following parameter to cmake <code>-DCMAKE_TOOLCHAIN_FILE=path/to/your/TargetEPuck.cmake</code><br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8029AutoMoDe Arena Experiments2018-03-29T10:44:27Z<p>JonasKuckling: Added first stepst to cross compile</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
In order to run ARGoS and AutoMoDe on the e-pucks, you need to crosscompile all necessary libraries.<br />
# Download the cross-compiler that Ken build ('''TODO:''' Link) and extract it on your computer<br />
# Open the TargetEPuck.cmake file and change each occurence of <code>/usr/local/angstrom/arm</code> with the path to the crosscompiler. '''TODO:''' Verify that this is the correct path.<br />
#* Instead of changing every .cmake file on your system, you can also setup only one TargetEPuck.cmake file and reference it from all of your projects.<br />
# Add to folders to the root level of your project: build and build_epuck<br />
#* Do we need to compile first before cross-compiling?<br />
# In the folder build_epuck run the usual cmake command for that project in your terminal but add the following parameter to cmake <code>-DCMAKE_TOOLCHAIN_FILE=<path/to/your/TargetEPuck.cmake></code><br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8028AutoMoDe Arena Experiments2018-03-29T08:16:19Z<p>JonasKuckling: Moved checklist to top</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments. The next sections will describe the necessary parts in more detail.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8027AutoMoDe Arena Experiments2018-03-29T07:49:50Z<p>JonasKuckling: Added some more titles</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
=== Compiling libraries and executables ===<br />
<br />
=== Generating mission files ===<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Trouble shooting ==<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8026Getting started for Demiurge2018-03-29T07:47:39Z<p>JonasKuckling: Made sentence for reference to arena page</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8025AutoMoDe Arena Experiments2018-03-27T20:22:33Z<p>JonasKuckling: Added text to running experiments.</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and make sure that the tags on the top are pointing to the front of the e-puck.<br />
'''TODO:''' Explain how to connect to all e-pucks simultaneously.<br />
<br />
== Running the experiments ==<br />
<br />
Once the robots are setup, connect to the tracking system (via ssh?). In the folder <code>arena_tracking_system</code> you should find a couple of scripts that you can execute in order to use the tracking system. Execute <code>./server conf/resources.xml cond/track_from_stream.xml</code> to start the tracking process. If you only want to verify that your setup is working, run <code>./arena-viewer conf/resources.xml cond/track_from_stream.xml</code>. Once the server is started, run <code>./startPathPla.sh \<ID\></code> where the ID is the one that the ExpGen.py file created for you.<br />
<br />
Start the script ??? on the e-pucks and then press "Play" in the argos window on the arena computer. Once all robots approximately reached there position, stop and exit argos.<br />
<br />
Run argos with the mission file and the seed (as given by the experiment configuration returned by ExpGen.py) and execute ./startE.sh <ID> on the e-pucks. Press Play in Argos and wait until the experiment is finished. Then exit write down the score and exit Argos.<br />
<br />
== Cleaning up again ==<br />
<br />
== Checklist ==<br />
<br />
In the future you will find a checklist for download here that you can follow if you want to run your experiments.</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8024AutoMoDe Arena Experiments2018-03-27T20:10:11Z<p>JonasKuckling: Added preparing the robots section</p>
<hr />
<div>This page is in a very early stage. If you have any questions about the contents of this page, ask Ken or Jonas.<br />
<br />
== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
You will need an account on the arena computer (?) and for the Iridia Tracking System. Ask Ken (?) if he can help you set them up.<br />
<br />
== Generating the files ==<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other. Once you have placed the batteries, toggle the bottom switch first to see, if the battery was placed succesfully. Sometimes it doesn't connect properly and than the LED in the e-puck will not light up, when the switch is toggled. If the bottom battery sits well, toggle the switch for the top battery.<br />
<br />
Uploading scripts to the e-pucks can be done by either one of two scripts that Ken provided: makeupload.py or massupload.py. The main difference between the two scripts is that makeupload.py will make the AutoMoDe executable and upload it to the specified e-pucks, while massupload will simply copy folders and files from the arena computer to the e-pucks. '''TODO:''' Explain more about how these scripts work and the epucks.json file that they use.<br />
<br />
Once all the necessary scripts are uploaded to the e-pucks, place them in the arena and you can start to run your experiment.<br />
<br />
== Running the experiments ==<br />
<br />
<br />
<br />
== Cleaning up again ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8023Getting started for Demiurge2018-03-27T20:01:51Z<p>JonasKuckling: Protected "Getting started for Demiurge" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite) [read=autoconfirmed] (indefinite))</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8022AutoMoDe Arena Experiments2018-03-27T20:00:56Z<p>JonasKuckling: Protected "AutoMoDe Arena Experiments" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite) [read=autoconfirmed] (indefinite))</p>
<hr />
<div>== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
== Generating the files ==<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other.<br />
<br />
== Running the experiments ==<br />
<br />
== Cleaning up again ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8021AutoMoDe Arena Experiments2018-03-27T20:00:24Z<p>JonasKuckling: Added a little bit of text</p>
<hr />
<div>== Getting started ==<br />
<br />
Ken has already prepared a number of helpful scripts that can help when running experiments in the arena. They are available on his github account.<br />
<br />
== Generating the files ==<br />
<br />
The script <code>ExpGen.py</code> generates most of the files that you will need to run your experiments. It takes a couple of arguments (a short summary can be obtained by the -h option). ('''TODO: Explain the arguments a little bit more''')<br />
* An .xml file that contains the template for the mission .xml (or .argos) file.<br />
* Another .xml file that contains the template for the initial positioning with the Iridia Tracking System.<br />
* The number of experiments that are run.<br />
* The file that contains the random seeds for the experiments.<br />
* The output file where the seeds, ids, and mission files are listed. The output file will be formatted in Markdown, if you want to have a visual representation, than you will need to convert the file (for example to html or pdf).<br />
<br />
The script will load your controllers (you may need to adjust the script to your needs), create a random order for your experiments and copy your controllers and seeds into the corresponding templates. It will also create two scripts called <code>startE.sh</code> and <code>startPathPla.sh</code>. The <code>startE.sh</code> script is intended to be uploaded to the E-Pucks where it will start a single run of the experiment. The other script (<code>startPathPla.sh</code>) is executed on the computer in the lab, where it will start Argos for the positioning of the robots in the arena.<br />
<br />
== Preparing the robots ==<br />
<br />
Before using the robots you need to put in the batteries from the charging port. It is recommended that you put the batteries into the box labelled "charged" so that you always know which batteries are for your use. Put the batteries without the cable in the bottom slot of the e-puck and the battery with the cables in the top slot of the e-puck. When connecting the cable, make sure that it is twisted inward so that the robots do not get caught on each other.<br />
<br />
== Running the experiments ==<br />
<br />
== Cleaning up again ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=AutoMoDe_Arena_Experiments&diff=8020AutoMoDe Arena Experiments2018-03-27T19:05:04Z<p>JonasKuckling: Add outline</p>
<hr />
<div>== Getting started ==<br />
<br />
== Generating the files ==<br />
<br />
== Preparing the robots ==<br />
<br />
== Running the experiments ==<br />
<br />
== Cleaning up again ==</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8019Getting started for Demiurge2018-03-27T19:02:37Z<p>JonasKuckling: Added link to new page</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86_64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Running robot experiments in the arena ==<br />
<br />
* [[AutoMoDe_Arena_Experiments | here]]<br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8014Getting started for Demiurge2018-03-09T13:43:17Z<p>JonasKuckling: Added two links</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86-64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86-64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your [https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29#Startup_scripts .bashrc file] with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86-64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKucklinghttps://iridia.ulb.ac.be/w/index.php?title=Getting_started_for_Demiurge&diff=8013Getting started for Demiurge2018-03-09T13:35:09Z<p>JonasKuckling: Added lines for .bashrc file</p>
<hr />
<div>This page will list all the necessary steps you should take before starting to work on the Demiurge project.<br />
<br />
== Set up your working environment ==<br />
<br />
* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.<br />
** '''TODO''' What is most important of these steps?<br />
* Set up your workstation (see [[Workstation_configuration|this page]] for more details)<br />
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)<br />
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories<br />
** Development rules for the github repositories: '''TODO'''<br />
* Get yourself added to the Demiurge Whatsapp group<br />
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list<br />
* Install argos ('''TODO''' Instructions)<br />
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])<br />
*#* You can do so by running the following command in your terminal: '''TODO'''<br />
*# Download and install argos<br />
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"<br />
*# Download and install the e-puck plugin '''TODO'''<br />
** If you don't want to install everything by hand [http://iridia.ulb.ac.be/~afranzin/files/scripts/bundle_argos3_epuck.sh this script] might be useful. However you need all prerequisites installed before running the script.<br />
* Install AutoMoDe ('''TODO''' Instructions)<br />
<!--** Problems that I have encountered: Lua.h couldn't be found (solution move lua headers from /usr/include/lua5.x/ to /usr/include/)--><br />
* If you have to work on the cluster you should follow [http://majorana.ulb.ac.be/wordpress/how-to-install-argos3-on-majorana/ these instructions] to install Argos. AutoMoDe can be installed as on your local computer.<br />
* In order to install irace on the cluster, follow these steps:<br />
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]<br />
*# Upload the .tar.gz file to your home directory in the cluster<br />
*# Install the R package locally<br />
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86-64-redhat-linux-gnu-library/2.15/ irace-2.2.tar.gz</code><br />
*#* Please note that the irace package must be located in ~/R/x86-64-redhat-linux-gnu-library/2.15/irace to be correctly located by R. At the moment it is not possible to put it anywhere else<br />
*# Add irace to IRACE_HOME, PATH and R_LIBS path (for example in your .bashrc file with the following commands)<br />
*#* <code>export R_LIBS_USER=~/R/x86-64-redhat-linux-gnu-library/2.15/</code><br />
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace/</code><br />
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code><br />
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code><br />
<!--** Installing new software in the cluster is not always easy. Therefore many modules are not up-to-date and you have to stick to the versions that are used by the cluster. Check before writing your software that you have approximately the same versions as on the cluster or you might encounter some surprises when running your experiments.--><br />
<br />
== Important paper to read ==<br />
<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]<br />
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]<br />
<br />
== Useful pages to bookmark ==<br />
<br />
* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published<br />
* https://github.com/demiurge-project: The github page for all of our repositories<br />
<br />
== People working on the project ==<br />
<br />
* '''TODO'''<br />
<br />
== Resources depending on your area of expertise ==<br />
<br />
* '''TODO'''</div>JonasKuckling