Source Distribution

The OpenAlea projects are released as a source tarball that can be downloaded from our file repository. It it also available from the Subversion repositories but you only want this if you are a developer.

Getting the sources

Create yourself a directory to work in

mkdir openalea
cd openalea

Now you can choose to download the code from the release tarballs, or from SVN (branches, tags, trunk…).

tarballs

Click to display ⇲

Click to hide ⇱

Openalea-1.2.0.tar.gz
vplants-1.2.0.tar.gz
Alinea_1_0.tar.gz

Windows instructions

Use your favourite browser and compressing utility to download and uncompress the files from the links above.

Commands to download and uncompress tarballs for Unixes

wget https://gforge.inria.fr/frs/download.php/34176/openalea-1.2.0.tar.gz --no-check-certificate
wget https://gforge.inria.fr/frs/download.php/34177/vplants-1.2.0.tar.gz --no-check-certificate
wget https://gforge.inria.fr/frs/download.php/32483/alinea_1_0.tar.gz --no-check-certificate
tar xzvf openalea-1.2.0.tar.gz
tar xzvf vplants-1.2.0.tar.gz
tar xzvf alinea_1_0.tar.gz

Subversion of the release (requires some gforge authentication)

Click to display ⇲

Click to hide ⇱

The code is hosted on the INRIA's Forge.

OpenAlea (1)

svn checkout svn://scm.gforge.inria.fr/svn/openalea/tags/openalea_0_9_0 openalea_0_9

VPlants (2)

svn checkout svn://scm.gforge.inria.fr/svn/vplants/vplants/tags/vplants_0_9_0 vplants_0_9

Alinea (2)

svn checkout svn://scm.gforge.inria.fr/svn/openaleapkg/tags/alinea_0_9_0 openaleapkg_0_9

(1) Openalea is public and you are granted anonymous read-only access. To be able to commit changes, see (2).
(2) Private Subversion or commit rights : You need to register and be granted access by the administrators to gain access to private projects or to be able to commit to public repositories.

Getting the sources of the trunk (bleeding edge - also requires some gforge authentication)

Click to display ⇲

Click to hide ⇱

The code is hosted on the INRIA's Forge.

OpenAlea (1)

svn checkout svn://scm.gforge.inria.fr/svn/openalea/trunk openalea

VPlants (2)

svn checkout svn+ssh://mylogin@scm.gforge.inria.fr/svnroot/vplants/vplants/trunk vplants

Alinea (2)

svn checkout svn+ssh://mylogin@scm.gforge.inria.fr/svnroot/openaleapkg/trunk openaleapkg

OR

svn checkout --username mylogin https://scm.gforge.inria.fr/svn/openaleapkg/trunk openaleapkg

(1) Openalea is public and you are granted anonymous read-only access. To be able to commit changes, see (2).
(2) Private Subversion or commit rights : You need to register and be granted access by the administrators to gain access to private projects or to be able to commit to public repositories.

Installing the dependencies

Windows

Click to display ⇲

Click to hide ⇱

Dependencies of Openalea for Windows are distributed as eggs.

installing all dependencies

First install Python 2.7 system-wide. We consider it is installed to c:\Python27
Install Setuptools

cd c:\python27\scripts
easy_install -f http://openalea.gforge.inria.fr/pi openalea.deploy

Install runtime-deps:

alea_install pywin32
alea_install qt4
alea_install numpy
alea_install scipy
alea_install matplotlib
alea_install gnuplot
alea_install pyqglviewer
alea_install pyopengl
alea_install boost

Install compilation-deps:

alea_install mingw
alea_install scons
alea_install qt4-dev
alea_install bisonflex
alea_install qhull

(original document)

If you're interested in building the dependencies, read Foreword : Everything is egg.

Linux

Click to display ⇲

Click to hide ⇱

ubuntu
debian

Fedora:

Fedora 19 or Fedora 20:

Installing all dependencies

sudo yum install python-matplotlib CGAL-devel boost-math PyQt4 python-nose freeglut-devel freeglut boost-python scons gnuplot ann-devel python-fpconst bison-devel qscintilla-python SOAPpy subversion gcc-gfortran qhull-devel numpy flex python-setuptools boost-devel PyOpenGL PyQt4-devel flex-static scipy readline-devel gcc-c++ python-imaging python-networkx bison sip-devel R ipython python-matplotlib-qt4 rpy python-pandas

Fedora 17:

Installing all dependencies

sudo yum install python-matplotlib CGAL-devel boost-math PyQt4 python-nose freeglut-devel freeglut boost-python scons gnuplot ann-devel python-fpconst bison-devel qscintilla-python SOAPpy subversion gcc-gfortran qhull-devel numpy flex python-setuptools boost-devel PyOpenGL PyQt4-devel flex-static scipy readline-devel gcc-c++ python-imaging python-networkx bison sip-devel R

For older version of Fedora: Fedora older

Slackware

MacOs X

See Install dependencies on a Mac OS X

Building the sources

The sources can be compiled and installed system wide or only for the user. You can also consider developing in virtual python environments using virtualenv (in this case, all the following commands will operate in the virtual environment).

Two modes of installation are described below : “install” and “develop”. The “install” mode allows to install everything from build directory. The “develop” mode allows to edit the original source code, and relaunch the application without having to reinstall it.

In the following examples, the multisetup.py script calls openalea.deploy-based setup.py scripts. The options that can be passed to multisetup.py are the same as those available for distutils or setuptools plus some new ones added by openalea.deploy.

You can use setup.cfg and options.py to specify custom parameters to pass to multisetup.py or setup.py script. In each package which compilation depends on the system, there are options_XXX.py files. For example, in vplants.PlanGL, there are options_linux.py, options_macosx.py, options_windows.py, etc. Just copy the options_XXX.py the most appropriate to your system and rename it to options.py. If the default parameters does not work, and no options_XXX.py suits to your system, feel free to add your own options.py in the same directory as setup.py or multisetup.py.

Click to hide ⇱

cd openalea
python multisetup.py install --user
alea_config --install-dyn-lib=%USERPROFILE%\.local\lib
cd ..\vplants
python multisetup.py install --user
cd ..\alinea
python multisetup.py install --user

"develop" mode

Click to display ⇲

Click to hide ⇱

cd openalea
python multisetup.py develop --user
alea_config --install-dyn-lib=%USERPROFILE%\.local\lib
cd ..\vplants
python multisetup.py develop --user
cd ..\alinea
python multisetup.py develop --user

Building and installing system wide

Click to display ⇲

Click to hide ⇱

cd openalea
[sudo] python multisetup.py install
cd ..\vplants
[sudo] python multisetup.py install
cd ..\alinea
[sudo] python multisetup.py install

Click to hide ⇱

The –user option under Linux doesn't usually work out-of-the box. First you need to create the directories used by the option.

cd ~/.local
mkdir lib bin include  
cd lib
mkdir python2.7 python2.7/site-packages

"install" mode

Click to display ⇲

Click to hide ⇱

cd openalea
python multisetup.py install --user
alea_config --install-dyn-lib=${HOME}/.local/lib
cd ../vplants
cp options_linux.py options.py
python multisetup.py install --user
cd ../alinea
python multisetup.py install --user

"develop" mode

Click to display ⇲

Click to hide ⇱

cd openalea
python multisetup.py develop --user
alea_config --install-dyn-lib=${HOME}/.local/lib
cd ../vplants
cp options_linux.py options.py
python multisetup.py develop --user
cd ../alinea
python multisetup.py develop --user

Building and installing system wide

Click to display ⇲

Click to hide ⇱

cd openalea
[sudo] python multisetup.py install
cd ../vplants
cp options_linux.py options.py
[sudo] python multisetup.py install
cd ../alinea
[sudo] python multisetup.py install

Click to hide ⇱

First you need to create the directories used by the option.

mkdir -p ~/Library/Python/2.7/lib/python2.7/site-packages
cd ~/Library/Python/2.7
mkdir bin include

Edit the file ~/.pydistutils.cfg

[install]
prefix = ~/Library/Python/2.7

Then edit your ~/.profile file:

source ~/.openalea.sh
 
export DYLD_FALLBACK_LIBRARY_PATH=$HOME/Library/Python/2.7/lib:$DYLD_FALLBACK_LIBRARY_PATH
export PATH=$HOME/Library/Python/2.7/bin:$PATH
export PYTHONPATH=$HOME/Library/Python/2.7/lib/python2.7/site-packages:$PYTHONPATH

Rename the options file according to your package manager (Homebrew and Macports).

cd vplants
 
# for Macports users
cp options_macports.py options.py
 
# for Homebrew users
cp options_brew.py options.py

"install" mode

Click to display ⇲

Click to hide ⇱

cd openalea
python multisetup.py install --user
alea_config --install-dyn-lib=${HOME}/Library/Python/2.7/lib
cd ../vplants
python multisetup.py install --user
cd ../alinea
python multisetup.py install --user

"develop" mode

Click to display ⇲

Click to hide ⇱

cd openalea
python multisetup.py develop
alea_config --install-dyn-lib=${HOME}/Library/Python/2.7/lib
cd ../vplants
python multisetup.py develop
cd ../alinea
python multisetup.py develop

Building and installing system wide

Click to display ⇲

Click to hide ⇱

cd openalea
[sudo] python multisetup.py install
cd ../vplants
[sudo] python multisetup.py install
cd ../alinea
[sudo] python multisetup.py install

Latest News

Source Distribution

Getting the sources

tarballs

Subversion of the release (requires some gforge authentication)

Getting the sources of the trunk (bleeding edge - also requires some gforge authentication)

Installing the dependencies

Windows

Linux

MacOs X

Building the sources

Windows

Preliminaries

Building and installing for the user (recommended)

"install" mode

"develop" mode

Building and installing system wide

Linux

Building and installing for the user (recommended)

Preliminaries

"install" mode

"develop" mode

Building and installing system wide

MacOS X

Building and installing for the user (recommended)

Preliminaries

"install" mode

"develop" mode

Building and installing system wide