IridiaWiki - User contributions [en]

Getting started for Demiurge

2022-09-29T14:50:49Z

Dgarzonr: /* Install AutoMoDe and related software */

This page will list all the necessary steps you should take before starting to work on the Demiurge project.

== Set up your working environment ==

* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.

* Set up your workstation (see [[Workstation_configuration|this page]] for more details)
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories
* Get yourself added to the Demiurge Whatsapp group
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list

== Install AutoMoDe and related software ==

* Install argos3
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])
*#* You can do so by running the following command in your terminal:
*#* <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>
*# Download and install argos
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"
*#* Get the repository:
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository
*#*# <code>cd argos3</code>
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment
*#* '''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.
*#* Prepare the build of argos3
*#*# <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
*#*# <code>mkdir build && cd build</code>
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release -DARGOS_INSTALL_LDSOCONF=OFF -DARGOS_DOCUMENTATION=OFF ../src</code>
*#*# <code>make</code>
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF
*#*# <code>make install</code>
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/include/argos3/plugins/robots/e-puck</code>
*#*# <code>rm -rf $ARGOS_INSTALL_PATH/argos3-dist/lib/argos3/lib*epuck*.so</code>
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)
*#*# <code>export ARGOS_INSTALL_PATH=$HOME</code> (or whatever you chose in the earlier step)
*#*# <code>export PKG_CONFIG_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/pkgconfig</code>
*#*# <code>export ARGOS_PLUGIN_PATH=$ARGOS_INSTALL_PATH/argos3-dist/lib/argos3</code>
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code>
*#*# <code>export PATH=$ARGOS_INSTALL_PATH/argos3-dist/bin/:$PATH</code>
*# Download and install the e-puck plugin
*#* Get the repository
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code>
*#*# <code>cd argos3-epuck</code>
*#*# <code>git checkout v48</code>
*#* '''If you are on the cluster:'''
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code>
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL
*#* Prepare the build of the epuck-plugin
*#*# <code>mkdir build && cd build</code>
*#*# <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ../src</code>
*#*# <code>make</code>
*#*# <code>make install</code>
** 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.

* Install AutoMoDe
*# Download and install the loopfunctions
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code>
*## <code>cd AutoMoDe-loopfunctions</code>
*## <code>git checkout dev</code>
*## <code>mkdir build && cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install the e-puck DAO
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code>
*## <code>cd AutoMoDe-DAO</code>
*## <code>mkdir build && cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=$ARGOS_INSTALL_PATH/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install AutoMoDe
*## <code>git clone git@github.com:demiurge-project/ARGoS3-AutoMoDe.git AutoMoDe</code>
*## <code>cd AutoMoDe</code>
*## <code>mkdir build && cd build</code>
*## <code>cmake ..</code>
*## <code>make</code>
* 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.

* In order to install irace on the cluster, follow these steps:
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]
*# Upload the .tar.gz file to your home directory in the cluster
*# Install the R package locally
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code>
*# 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)
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code>
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code>
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code>
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code>

* In order to install EvoStick
*# ''Coming soon''



== Running robot experiments in the arena ==

* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]

== Writing your paper ==

* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.

== Important paper to read ==

* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]

== Useful pages to bookmark ==

* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published
* https://github.com/demiurge-project: The github page for all of our repositories

== People working on the project ==

* '''TODO'''

== Resources depending on your area of expertise ==

* '''TODO'''

== Development guidelines (git rules) ==

* See [[Demiurge_Development_Guidelines | this page ]] for information how the Development guidelines for using the git repositories.

== Proj H402 (Master 1 project) ==
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]].
Please keep the following things in mind:
* Students should be added as "Developer" to the repository. There should be no need to add them to the group.
* 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.

Ground Sensors

2020-02-27T10:21:01Z

Dgarzonr:

'''Ground sensor'''

I found at least two ways of using the ground sensors on the e-pucks. This is the one that works best:

int ground_tmp[6];
int ground[3];
/* retrieve the values from the sensor */
e_i2cp_init();
e_i2cp_enable();
e_i2cp_read(0xC0, 0);
i = 0;
for(j = 0; j < 6; j++) {
if (j % 2 == 0) ground_tmp[j] = e_i2cp_read(0xC0, j + 1);
else ground_tmp[j] = e_i2cp_read(0xC0, j - 1);
}
e_i2cp_disable();

/* getting the actual values */
ground[0] = ((unsigned int)(ground_tmp[0] & 0xff)) +((unsigned int) ground_tmp[1] << 8) - ground_sensor_zero[0];
ground[1] = ((unsigned int)(ground_tmp[2] & 0xff)) +((unsigned int) ground_tmp[3] << 8) - ground_sensor_zero[1];
ground[2] = ((unsigned int)(ground_tmp[4] & 0xff)) +((unsigned int) ground_tmp[5] << 8) - ground_sensor_zero[2];

This is the function I use to calibrate the sensors (on black paper):

void GroundSensorCalibrate() {
int i, j;
char tmp[50];
long sensor_tmp[6] = {0};
long sensor[3] = {0};
long delay;

btcomSendString("calibration ground:\n");
for (i=0; i<16; i++) {
// read the values
e_i2cp_init();
e_i2cp_enable();
e_i2cp_read(0xC0, 0);
for(j = 0; j < 6; j++) {
if (j % 2 == 0) sensor_tmp[j] = e_i2cp_read(0xC0, j + 1);
else sensor_tmp[j] = e_i2cp_read(0xC0, j - 1);
}
e_i2cp_disable();

// store the values
sensor[0] += ((unsigned int)(sensor_tmp[0] & 0xff)) +((unsigned int) sensor_tmp[1] << 8);
sensor[1] += ((unsigned int)(sensor_tmp[2] & 0xff)) +((unsigned int) sensor_tmp[3] << 8);
sensor[2] += ((unsigned int)(sensor_tmp[4] & 0xff)) +((unsigned int) sensor_tmp[5] << 8);

// pause
for (delay = 0; delay < 100000; delay++){
__asm__("nop");
}
}
for (i=0; i<3; i++) { ground_sensor_zero[i]=(sensor[i]>>4);
sprintf(tmp,"%d\t%d",i, ground_sensor_zero[i]);
btcomSendString(tmp);
btcomSendString("\n");
}

for (delay = 0; delay < 100000; delay++){
__asm__("nop");
}
}

'''How to fix I2C error on ground sensors'''

It's possible to use contemporaneously both the e-puck extension for gumstix overo and the ground sensor; in this case the camera and the ground sensor will share the same I2C bus and like the camera, also the ground sensor will not be anymore reachable from the e-puck side, but only from the overo side.

The I2C bus is configured to work at 400 KHz in the system running on the gumstix overo, thus we need to change the bus speed to 100 KHz in order to communicate with the ground sensor module; the simplest way is to set a kernel parameter in u-boot:

enter u-boot by pressing any key at boot start

type the following command to init the I2C bus 3 to 100 KHz:
setenv i2cspeed 3,100
type the following command to pass an additional parameter to the kernel that is the i2c_bus=${i2cspeed}:
setenv mmcargs setenv bootargs console=${console} i2c_bus=${i2cspeed} ${optargs} mpurate=${mpurate} vram=${vram} omapfb.mode=dvi:${dvimode} omapdss.def_disp=${defaultdisplay} root=${mmcroot} rootfstype=${mmcrootfstype}
type the following command to save the environment changes
saveenv
type the folloeing command to start booting
boot

Pay attention that all the peripherals connected to the bus will now work at 100 KHz, thus also the e-puck camera and the LSM330 (accelerometer + gyroscope) present with e-puck HwRev 1.3.
If you want to set back the bus speed to 400 KHz you need to follow steps 2-4, by setting the i2cspeed u-boot environment variable with setenv i2cspeed 3,400.
Communicating with the ground sensor is as easy as open a device and reading from it; a source code example can be found in the following link http://projects.gctronic.com/Gumstix/groundsensor.c. You will find this application example in the /home/root/demos/gumstix-common directory; start it by executing ./i2c_groundsensors and the sensors values will be displayed in the terminal.
Make sure that you have installed the last system update otherwise you'll encounter some problems.
You can find more information about the I2C and gumstix in the following links:

https://wiki.gumstix.com/index.php/Category:How_to_-_i2c

2019-07-10T17:45:19Z

Dgarzonr: /* Set up your working environment */

This page will list all the necessary steps you should take before starting to work on the Demiurge project.

== Set up your working environment ==

* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.

* Set up your workstation (see [[Workstation_configuration|this page]] for more details)
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories

* Get yourself added to the Demiurge Whatsapp group
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list
* Install argos
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''
*#* <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>
*# Download and install argos
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"
*#* Get the repository:
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?
*#*# <code>cd argos3</code>
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment
*#* '''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.
*#* Prepare the build of argos3
*#*# <code>mkdir build</code>
*#*# <code>cd build</code>
*#*# <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]/)
*#*# <code>make</code>
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF
*#*# <code>make install</code>
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/include/argos3/plugins/robots/e-puck</code>
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/lib/argos3/lib*epuck*.so</code>
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code>
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code>
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code>
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code>
*# Download and install the e-puck plugin
*#* Get the repository
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code>
*#*# <code>cd argos3-epuck</code>
*#*# <code>git checkout v48</code>
*#* '''If you are on the cluster:'''
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code>
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL
*#* Prepare the build of the epuck-plugin
*#*# <code>mkdir build</code>
*#*# <code>cd build</code>
*#*# <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]/)
*#*# <code>make</code>
*#*# <code>make install</code>
** 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.
* Install AutoMoDe
*# Download and install the loopfunctions
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code>
*## <code>cd AutoMoDe-loopfunctions</code>
*## <code>git checkout simulation</code>
*## <code>mkdir build</code>
*## <code>cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install the e-puck DAO
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code>
*## <code>cd AutoMoDe-DAO</code>
*## <code>mkdir build && cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install AutoMoDe
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code>
*## <code>cd AutoMoDe</code>
*## <code>mkdir build</code>
*## <code>cd build</code>
*## <code>cmake ..</code>
*## <code>make</code>
* 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.
* In order to install irace on the cluster, follow these steps:
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]
*# Upload the .tar.gz file to your home directory in the cluster
*# Install the R package locally
*#* <code>mkdir ~/R/x86_64-redhat-linux-gnu-library/3.5/</code> (At the moment it is not possible to put it anywhere else)
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/3.5/ irace_2.2.tar.gz</code>
*# 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)
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/3.5</code>
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code>
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code>
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code>
* In order to install EvoStick
*# ''Coming soon''
* In order to install NEAT
*# ''Coming soon''


== Running robot experiments in the arena ==

* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]

== Writing your paper ==

* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.

== Important paper to read ==

* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]

== Useful pages to bookmark ==

* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published
* https://github.com/demiurge-project: The github page for all of our repositories

== People working on the project ==

* '''TODO'''

== Resources depending on your area of expertise ==

* '''TODO'''

Getting started for Demiurge

2019-07-10T13:20:02Z

Dgarzonr: /* Set up your working environment */

This page will list all the necessary steps you should take before starting to work on the Demiurge project.

== Set up your working environment ==

* Activate all resources as described [[What_you_need_to_begin_to_work_in_IRIDIA | on this page]], if you not have done so already.

* Set up your workstation (see [[Workstation_configuration|this page]] for more details)
* Send your [https://www.github.com github] account name to the Demiurge repository administrator (at the moment Ken)
** He will add you to the [https://github.com/demiurge-project demiurge-project organization] so that you can see the private development repositories

* Get yourself added to the Demiurge Whatsapp group
* Give your e-mail address to Mauro, he will add you to the Demiurge mailing list
* Install argos
*# Install all prerequisites (specified at the [https://github.com/ilpincy/argos3 github page])
*#* You can do so by running the following command in your terminal: '''TODO: Check again this is the right list of prerequisites'''
*#* <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>
*# Download and install argos
*#* Be aware that we are currently not using the most recent version but instead the release "3.0.0-beta48"
*#* Get the repository:
*#*# <code>git clone git@github.com:ilpincy/argos3.git argos3</code>, clones the repository '''TODO:''' Setting up ssh keys?
*#*# <code>cd argos3</code>
*#*# <code>git checkout 3.0.0-beta48</code>, checks out the version that we are using at the moment
*#* '''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.
*#* Prepare the build of argos3
*#*# <code>mkdir build</code>
*#*# <code>cd build</code>
*#*# <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]/)
*#*# <code>make</code>
*#*# <code>make doc</code>, if you have forgotten the -DARGOS_DOCUMENTATION=OFF
*#*# <code>make install</code>
*#* Before you can install our epuck-plugin, you have to remove the default plugin first. In argos3-dist run the following commdands
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/include/argos3/plugins/robots/e-puck</code>
*#*# <code>rm -rf [INSTALL_LOCATION]/argos3-dist/lib/argos3/lib*epuck*.so</code>
*#* Add the following lines to your .bashrc (or create a separate file and source it from your .bashrc)
*#*# <code>export PKG_CONFIG_PATH=[INSTALL_LOCATION]/argos3-dist/lib/pkgconfig</code>
*#*# <code>export ARGOS_PLUGIN_PATH=[INSTALL_LOCATION]/argos3-dist/lib/argos3</code>
*#*# <code>export LD_LIBRARY_PATH=$ARGOS_PLUGIN_PATH:$LD_LIBRARY_PATH</code>
*#*# <code>export PATH=[INSTALL_LOCATION]/argos3-dist/bin/:$PATH</code>
*# Download and install the e-puck plugin
*#* Get the repository
*#*# <code>git clone git@github.com:demiurge-project/argos3-epuck.git argos3-epuck</code>
*#*# <code>cd argos3-epuck</code>
*#*# <code>git checkout v48</code>
*#* '''If you are on the cluster:'''
*#*# Open src/plugins/robots/e-puck/CMakeLists.txt and comment the line with <code>include(VisionTools.cmake)</code>
*#*# Open src/cmake/ARGoSBuildChecks.cmake and remove the checks for Lua and Qt/OpenGL
*#* Prepare the build of the epuck-plugin
*#*# <code>mkdir build</code>
*#*# <code>cd build</code>
*#*# <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]/)
*#*# <code>make</code>
*#*# <code>make install</code>
** 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.
* Install AutoMoDe
*# Download and install the loopfunctions
*## <code>git clone git@github.com:demiurge-project/experiments-loop-functions.git AutoMoDe-loopfunctions</code>
*## <code>cd AutoMoDe-loopfunctions</code>
*## <code>git checkout simulation</code>
*## <code>mkdir build</code>
*## <code>cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install the e-puck DAO
*## <code>git clone git@github.com:demiurge-project/demiurge-epuck-dao.git AutoMoDe-DAO</code>
*## <code>cd AutoMoDe-DAO</code>
*## <code>mkdir build && cd build</code>
*## <code>cmake -DCMAKE_INSTALL_PREFIX=[INSTALL_LOCATION]/argos3-dist -DCMAKE_BUILD_TYPE=Release ..</code>
*## <code>make</code>
*## <code>make install</code>
*# Download and install AutoMoDe
*## <code>git clone git@github.com:demiurge-project/AutoMoDe-private.git AutoMoDe</code>
*## <code>cd AutoMoDe</code>
*## <code>mkdir build</code>
*## <code>cd build</code>
*## <code>cmake ..</code>
*## <code>make</code>
* 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.
* In order to install irace on the cluster, follow these steps:
*# Download the [https://nextcloud.ananas.space/s/WhQ2yqhmqoaBRdC irace package]
*# Upload the .tar.gz file to your home directory in the cluster
*# Install the R package locally
*#* Run the following command: <code>R CMD INSTALL -l ~/R/x86_64-redhat-linux-gnu-library/2.15/ irace_2.2.tar.gz</code>
*#* 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
*#* 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.
*# 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)
*#* <code>export R_LIBS_USER=~/R/x86_64-redhat-linux-gnu-library/2.15</code>
*#* <code>export IRACE_HOME=${R_LIBS_USER}/irace</code>
*#* <code>export PATH=${IRACE_HOME}/bin/:${PATH}</code>
*#* <code>export R_LIBS=${R_LIBS_USER}:${R_LIBS}</code>
* In order to install EvoStick
*# ''Coming soon''
* In order to install NEAT
*# ''Coming soon''


== Running robot experiments in the arena ==

* A detailed description on running experiments in the Arena can be found [[AutoMoDe_Arena_Experiments | here]]

== Writing your paper ==

* See [[Demiurge_Writing_Papers | this page]] for information on how to write your paper.

== Important paper to read ==

* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2014si.pdf AutoMoDe Vanilla]
* [http://iridia.ulb.ac.be/~mbiro/paperi/FraBraBru-etal2015si.pdf AutoMoDe Chocolate]
* [http://iridia.ulb.ac.be/IridiaTrSeries/link/IridiaTr2016-004.pdf Irace User Guide]

== Useful pages to bookmark ==

* http://iridia.ulb.ac.be/IridiaTrSeries/: Here all Technical reports will be published
* https://github.com/demiurge-project: The github page for all of our repositories

== People working on the project ==

* '''TODO'''

== Resources depending on your area of expertise ==

* '''TODO'''