Remarks

Currently due to the problems with TraitsUI Mac version is not supported. We are working on this...

Installation

Software demonstration

It is recommended to try the software to check if it fits the needs prior the real installation. For this purpose STSE is included in the SBOS linux distribution. Please, follow the link to download the live cd distribution (it can be tested without installing), and watch video tutorials to see the basic functionality of the software:

Installation procedure

Currently Mac/Linux(Ubuntu)/Windows are supported. Unfortunately, the installation procedure differs for these platforms. STSE package is plain python code for the moment, however it depends on many external libraries. This is the reason of the diversification of the installation process.

In principle the STSE requires Python environment with:

  1. set A: Traits UI, Mayavi, VTK, networkx
  2. set B: openalea with plantgl
  3. set C: qhull, svn binaries

Preparing sets A, B and C

Linux (Ubuntu)

set A: Issue the following commands:

sudo apt-get install python-networkx
sudo apt-get install mayavi2

set B: Please install openalea according to the description on this page. The easiest and fastest solution is to use the precompiled binaries for your platform (if they are available).

set C: Issue the following commands:

sudo apt-get install qhull-bin
sudo apt-get install subversion

Now please go to Installing STSE section.

Mac OS X 10.10 (currently broken due to traitsUI)

set A: Please install EPD. It provides python and all required python libraries used in STSE.

set B: Please install openalea according to the description on this page. The easiest and fastest solution is to use the precompiled binaries for your platform (if they are available).

set C: Please install qhull using compiled binaries or macports. Open terminal and check if qhull command is accessible. To access svn please choose your favourite svn client (eg. versions).

Now please go to Installing STSE section.

Windows (tested on XP)

set A: Please install EPD. It provides python and all required python libraries used in STSE.

set B: Please install openalea according to the description on this page. The easiest and fastest solution is to use the precompiled binaries for your platform (if they are available). It is also important to install vplants, so the plantgl will be accessible.

set C: Please install qhull using compiled binaries. Add the qhull to the environment variable PATH (please check here how to modify environment variables on windows). Open terminal and check if qhull command is accessible. To access svn please choose your favourite svn client (eg. tortoise).

Now please go to Installing STSE section.

Installing STSE

This project's Sourceforge subversion repository can be checked out through SVN with the following instruction set:

svn checkout svn://svn.code.sf.net/p/stse/code/trunk stse

After checking out please enter the trunk and issue the following command (Windows users: please skip the sudo and issue only python setup.py develop):

sudo python setup.py develop

On Windows do not use sudo:

python setup.py develop

This command installs the package in the openalea namespace.

Then please set the variable STSE_DIR to point to the STSE directory (e.g. here I assume that STSE was installed in /home/user/src/STSE):

export STSE_DIR=/home/user/src/STSE/trunk
export PATH=$STSE_DIR/bin:$PATH

(On Windows: Then please set the variable STSE_DIR to point to the STSE directory (e.g. here I assume that STSE was installed in c:\home\user\src\STSE\trunk):

set STSE_DIR=c:\home\user\src\STSE\trunk
set PATH=%STSE_DIR%\bin;%PATH%

)

It is also suggested to modify your .bash_profile to automatically set this variable each time you login. Now you are ready to test the STSE package:

cd src/stse/examples
ipython -wthread

and inside of the ipython interpreter:

run 09_05_01_wt_tutorial_01.py

In case of problems

For detailed instructions please join the Sourceforge mailing list:

stse-main@lists.sourceforge.net