{"id":16,"date":"2024-01-14T11:17:26","date_gmt":"2024-01-14T11:17:26","guid":{"rendered":"http:\/\/hweb-x-0-fe-03.fe.cpd.local\/elle\/?page_id=16"},"modified":"2024-04-26T14:06:05","modified_gmt":"2024-04-26T14:06:05","slug":"installation","status":"publish","type":"page","link":"https:\/\/www.ub.edu\/elle\/installation\/","title":{"rendered":"Installation"},"content":{"rendered":"

WINDOWS<\/strong><\/p>\n

There is an ELLE version for Windows, released in 2008 with the book Microdynamics Simulation<\/a> (Bons, Jessell, Koehn, eds.). This version runs under Windows XP, Windows Vista, Windows 7, Windows 8 and Windows 10 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:
\n<\/span><\/p>\n

1) Download the Elle Windows installer ElleWinSetup.exe<\/a> (18Mb)<\/span><\/p>\n

2) Double click on the file you have downloaded and follow the instructions<\/span><\/p><\/blockquote>\n

 <\/p>\n

LINUX (e.g. Ubuntu 18.04)<\/strong><\/p>\n

If you want to install the latest ELLE official release please follow these steps. This works well for Ubuntu 18.04 and other similar Debian-based Linux distributions.<\/p>\n

1. Open the terminal and type:<\/p>\n

sudo apt install gfortran gcc mesa-common-dev libgl1-mesa-dev libglu1-mesa-dev libgtk2.0-0 zlibc zlib1g make build-essential xorg-dev libmotif-common libmotif-dev xutils-dev libgtk2.0-dev cvs xutils libx11-dev libxt-dev libxpm-dev x11proto-xext-dev libxext-dev<\/code>
\nsudo apt-get install libgsl-dev libgsl23 libgslcblas0 libgsl-dbg<\/code><\/p>\n

2. Download wxWidgets. You have to download them from http:\/\/www.wxwidgets.org\/<\/a> (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:<\/p>\n

export CFLAGS=-std=c99 CXXFLAGS=-std=c++98 <\/code>
\n.\/configure --prefix=\/usr<\/code>
\nmake<\/code>
\nsudo make install<\/code><\/p>\n

3. Now clone the ELLE repository by typing:<\/p>\n

git clone https:\/\/git.code.sf.net\/p\/elle\/git elle-git<\/code><\/p>\n

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

5. Now open the terminal, cd to the Elle directory and type (this will install Elle with the graphics interface):<\/p>\n

.\/install.sh wx<\/code><\/p>\n

You will get lots of warnings, but hopefully no errors.<\/p>\n

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):<\/p>\n

export PATH=$PATH:\/home\/your_user\/elle\/elle\/binwx
\nexport LD_LIBRARY_PATH=\/lib:\/usr\/lib:\/usr\/local\/lib
\nELLEPATH=\/home\/your_user\/elle\/elle\/binwx
\nexport PATH LD_LIBRARY_PATH ELLEPATH<\/code><\/p>\n

7. Now log out and log in to your session again, and you should be able to run Elle.<\/p>\n

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:<\/p>\n

Open the terminal and type:<\/p>\n

sudo gedit \/usr\/share\/applications\/showelle.desktop<\/code><\/p>\n

Insert the following lines and change “\/home\/your_user\/elle\/” to the location of your Elle installation:<\/p>\n

[Desktop Entry]
\nType=Application
\nTerminal=false
\nStartupNotify=true
\nIcon=\/home\/your_user\/elle\/elle.ico
\nName=showelle
\nComment=Display Elle files
\nExec=\/home\/your_user\/elle\/elle\/binwx\/showelle -i %f
\nCategories=Graphics;Utility;<\/code><\/p>\n

Save the file, and type in the terminal:<\/p>\n

sudo gedit \/etc\/mime.types<\/code><\/p>\n

Insert the following line at end of text\/ block:<\/p>\n

text\/elle elle<\/code><\/p>\n

Save the file, and type in the terminal:<\/p>\n

sudo update-mime-database \/usr\/share\/mime<\/code>
\ngedit ~\/.config\/mimeapps.list<\/code><\/p>\n

if ~\/.config\/mimeapps.list is a new file, add<\/p>\n

[Added Associations]<\/code><\/p>\n

Add showelle.desktop to text\/plain:<\/p>\n

text\/plain=showelle.desktop;nautilus.desktop;<\/code><\/p>\n

Save it.<\/p>\n

The file ~\/.local\/share\/applications\/mimeapps.list is deprecated but some apps may still read\/write to it so create a link:<\/p>\n

ln -s ~\/.config\/mimeapps.list .local\/share\/applications\/mimeapps.list<\/code><\/p>\n

Now, from the file browser (e.g. Nautilus) right click on an .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.<\/p>\n

LINUX with a Singularity container (e.g. for Ubuntu 20.04)<\/strong><\/p>\n

There is an issue when using Elle in Ubuntu 20.04 or equivalent Linux versions. This is due to the new gcc version being more strict with the use of some old C code. We are working to fix the Elle code so that it can be used in the latest Linux versions, by converting all C code to C++. In the meantime we provide the following container so that Elle can be compiled and used on any Linux installation. For that we use the software Singularity. These are the installation instructions for running Elle with Singularity in Ubuntu 20.04:<\/p>\n

1. To install Singularity 3.6 in Ubuntu 20.04 you can open the terminal and write the following commands. First you need to install a series of packages:<\/p>\n

sudo apt-get update<\/code>
\nsudo apt-get install -y build-essential libssl-dev uuid-dev libgpgme11-dev squashfs-tools libseccomp-dev wget pkg-config git cryptsetup<\/code><\/p>\n

2. Install go:<\/p>\n

export VERSION=1.13 OS=linux ARCH=amd64<\/code>
\n(Replace the values as needed)<\/p>\n

wget https:\/\/dl.google.com\/go\/go$VERSION.$OS-$ARCH.tar.gz<\/code>
\nsudo tar -C \/usr\/local -xzvf go$VERSION.$OS-$ARCH.tar.gz<\/code>
\nrm go$VERSION.$OS-$ARCH.tar.gz<\/code><\/p>\n

3. Set the Environment variable PATH to point to Go:<\/p>\n

$ echo 'export PATH=\/usr\/local\/go\/bin:$PATH' >> ~\/.bashrc<\/code>
\nsource ~\/.bashrc<\/code><\/p>\n

4. Download Singularity:<\/p>\n

export VERSION=3.6.0<\/code>
\n(Replace the values as needed)<\/p>\n

wget https:\/\/github.com\/sylabs\/singularity\/releases\/download\/v${VERSION}\/singularity-${VERSION}.tar.gz<\/code>
\ntar -xzf singularity-${VERSION}.tar.gz<\/code>
\ncd singularity<\/code><\/p>\n

5. Compile Singularity:<\/p>\n

.\/mconfig<\/code>
\nmake -C builddir<\/code>
\nsudo make -C builddir install<\/code>
\nrm -r singularity<\/code><\/p>\n

6. Check whether Singularity is properly installed:<\/p>\n

singularity --version<\/code><\/p>\n

7. Download the Elle container using this link<\/a>, and save the file to a convenient folder, e.g. \/home\/username\/programs\/elle.<\/p>\n

8. Now there are different ways for using Elle with Singularity:<\/p>\n

8.1. Using a read-only container<\/strong><\/p>\n

We recommend to open a shell inside the elle.simg container. That way you have still full read-write access to your home-directory, but you can start the elle-binaries with the necessary parameters from the container. Simply run:<\/p>\n

singularity shell elle.simg<\/code><\/p>\n

You will find Elle now under \/programs\/elle. Also, the elle-path is in .bashrc, so you can start eg showelle from where-ever you are with a simple:<\/p>\n

showelle<\/code>
\non the command line.<\/p>\n

This is the easiest, but also the least flexible way to use Elle.<\/p>\n

8.2. Use the container file as a build environment and a runtime for your local code<\/strong><\/p>\n

An easy option, if you have trouble to compile the elle-code on your machine, is to download the development code from sourceforge somewhere into your home directory:<\/p>\n

git clone https:\/\/git.code.sf.net\/p\/elle\/git elle-git<\/code><\/p>\n

Put the singularity container into the elle directory (or somewhere else where you can easily find it), and then in a terminal type:<\/p>\n

singularity shell elle.simg<\/code><\/p>\n

Your terminal is now running inside the container. To install Elle, you can now do the usual:<\/p>\n

.\/install.sh wx<\/code>
\nand Elle will compile and install in your chosen directory.<\/p>\n

To run Elle or to start processes in the usual way you can simply start a shell inside the singularity container again. Just remember that you have to use your local elle-install, not the one bundled in the container. If you want to start a local latte process, for instance, you need to tell your terminal its exact location, otherwise it will start the one under \/programs\/elle inside the container:<\/p>\n

cd \/home\/you\/path\/to\/elle<\/code>
\nsingularity shell path\/to\/elle.simg<\/code>
\n.\/binwx\/elle_latte -i your_options<\/code><\/p>\n

#or:
\nprocesses\/latte\/elle_latte -i ...<\/code><\/p>\n

8.3. Using a writeable Elle singularity container<\/strong><\/p>\n

You can convert the downloaded container file to a writeable format (either to an ext3 container or a sandbox):<\/p>\n

You can convert elle.simg to a writable ext3 container called elle-develop.img:<\/p>\n

sudo singularity build --writable elle-develop.img elle.simg<\/code><\/p>\n

Similarly, to convert elle.simg to a writable directory (i.e., a sandbox):<\/p>\n

singularity build --sandbox elle-develop\/ elle.simg<\/code><\/p>\n

After you have converted the container file to a writable format you can edit and compile the files under \/programs\/elle. In order to do so you need to open a shell inside the image with the following parameters:<\/p>\n

sudo singularity shell --writable elle.simg<\/code>
\nNote the leading ‘sudo’ and the option ‘–writable’.<\/p>\n","protected":false},"excerpt":{"rendered":"

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, Windows 8 and Windows 10 or on a PC-equivalent via Parallels or VirtualBox on Mac). This version is fine for testing Elle and running examples. […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-16","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/pages\/16","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/comments?post=16"}],"version-history":[{"count":3,"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/pages\/16\/revisions"}],"predecessor-version":[{"id":104,"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/pages\/16\/revisions\/104"}],"wp:attachment":[{"href":"https:\/\/www.ub.edu\/elle\/wp-json\/wp\/v2\/media?parent=16"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}