Installation

WINDOWS

There is an ELLE version for Windows, released in 2008 with the book Microdynamics Simulation (Bons, Jessell, Koehn, eds.). This version runs under Windows XP, Windows Vista, Windows 7 and Windows 8 or on a PC-equivalent via Parallels or VirtualBox on Mac). This version is fine for testing Elle and running examples. But for the real Elle use it is much better to run the Linux version. To install Elle for Windows:

1) Download the Elle Windows installer ElleWinSetup.exe (18Mb)

2) Double click on the file you have downloaded and follow the instructions

 

LINUX

If you want to install the latest ELLE official release please follow these steps. This works well for Ubuntu 16.04 and other similar Debian-based Linux distributions

1. Open the terminal and type:

sudo apt-get install gfortran gcc mesa-common-dev libgl1-mesa-dev libglu1-mesa-dev libgtk2.0-0 zlibc zlib1g make build-essential xorg-dev libmotif4 libmotif-dev xutils-dev libgtk2.0-dev cvs xutils libx11-dev libXt-dev libxpm-dev x11proto-print-dev x11proto-xext-dev libxext-dev

sudo apt-get install libgsl2 libgsl-dev

2. Download wxWidgets. You have to download them from http://www.wxwidgets.org/ (do not install it from the repositories!). It is important that you download the previous stable release (2.8.12) and NOT the latest one (3.x). Once downloaded, decompress the file, cd into the directory and type:
./configure
make
sudo make install
sudo ldconfig

3. Now download Elle from:

https://sourceforge.net/projects/elle/

(or the development version which is not guaranteed to build:  cvs -z3 -d:pserver:anonymous@elle.cvs.sourceforge.net:/cvsroot/elle co -P elle )

4. Move the downloaded Elle directory where you want to have it (e.g.: /usr/local/elle, /home/user/elle, etc.)

5. Now open the terminal, cd to the Elle directory and type (this will install Elle with the graphics interface):
./install.sh wx

You will get lots of warnings, but hopefully no errors.

6. Open the file .bashrc from your home directory (e.g. /home/your_user/.bashrc) and add these lines at the bottom (replace the route with the directory where you installed Elle):

export PATH=$PATH:/home/your_user/elle/elle/binwx
export LD_LIBRARY_PATH=/lib:/usr/lib:/usr/local/lib
ELLEPATH=/home/your_user/elle/elle/binwx
export PATH LD_LIBRARY_PATH ELLEPATH

7. Now log out and log in to your session again, and you should be able to run Elle.

8. OPTIONAL: If you want to be able to visualise Elle files with showelle by just right-clicking on a .elle file, please do the following:

Open the terminal and type:
sudo gedit /usr/share/applications/showelle.desktop

Insert the following lines and change “/home/your_user/elle/” to the location of your Elle installation:
[Desktop Entry]
Type=Application
Terminal=false
StartupNotify=true
Icon=/home/your_user/elle/elle.ico
Name=showelle
Comment=Display Elle files
Exec=/home/your_user/elle/elle/binwx/showelle -i %f
Categories=Graphics;Utility;

Save the file, and type in the terminal:
> sudo gedit /etc/mime.types

Insert the following line at end of text/ block:
text/elle elle

Save the file, and type in the terminal:
> sudo update-mime-database /usr/share/mime
> gedit ~/.config/mimeapps.list

if ~/.config/mimeapps.list is a new file, add
[Added Associations]

Add showelle.desktop to text/plain:
text/plain=showelle.desktop;nautilus.desktop;

Save it.

The file ~/.local/share/applications/mimeapps.list is deprecated but some apps may still read/write to it so create a link
ln -s ~/.config/mimeapps.list .local/share/applications/mimeapps.list

Now, from the file browser (e.g. Nautilus) right click on a .elle file and you should have the option of opening with showelle. You can “lock to launcher” and click on the elle icon to run showelle or change the icon and keep the elle icon for the experiment-launcher.