Version 2 (modified by matija, 3 years ago) (diff)

Second unfinished draft.

This page is a work in progress and should be finished in an hour or two.

Setting up Development Environment

The Bioinformatics Laboratory, which leads and hosts Orange development, employs a wide variety of researchers of developers. Each and every one of us has his/her own preference regarding the development environment. It is our intention on this page to present some of configurations we use that seem to work well.

At the moment, unfortunately, only one configuration is described: Eclipse under Linux, specifically Ubuntu.

Ubuntu & Eclipse

This procedure has been written for and tested on Ubuntu 11.04, but should also work for newer and older (down to 10.04) releases.

Package Installation

You need to install the following packages:

  • eclipse will be your IDE, and one of its plugins we will install needs libsvn-java to work,
  • make, g++, python-dev, python-numpy, python-matplotlib and python-imaging are needed to build and use the Orange scripting environment, and
  • python-qwt5-qt4 is needed in order for the Orange Canvas (GUI) to work.

This is the command to install all those packages in one shot:

sudo apt-get install eclipse libsvn-java make g++ python-dev python-numpy python-matplotlib python-imaging python-qwt5-qt4

Next, you need to run Eclipse and install the needed plugins: CDT (C/C++ Development Tooling), PyDev (Python IDE for Eclipse) and Subclipse (for Subversion repository support). Choose Help->Install New Software... and add the following Update Sites:

Choose –All Available Sites– for the "Work with" option and install the following choices: Subclipse, PyDev and CDT Main Features.

Obtaining the Code

Switch to the SVN Repository Exploring perspective and add the following repository location: Then browse into the trunk directory (or elsewhere, if you know what you're doing) and checkout source, orange and, optionally, testing (in this order). Use the "Check out as a project configured using the New Project Wizard" option for all projects and configure projects as follows.

For source, select C/C++->C++ Project. Select Makefile project->Empty Project->Linux GCC for Project type and Toolchain. Later in this guide it will be assumed you used the directory name (ie. source) for project name.

To accelerate the compilation process on a multi-processor or multi-core machine, you may instruct Eclipse to use parallel build (-j switch to the make): go to project properties for source project and under C/C++ Build->Behaviour check "Use parallel build". Manually enter a desired parallel jobs count; do NOT use "optimal jobs number": Eclipse likes to run all possible compilations at once and you'll probably run out of RAM.

For both orange and testing, select Pydev->Pydev Project. Later in this guide it will be assumed you used the directory name for project name (ie. orange and testing). Uncheck the "Create default 'src' folder" checkbox. Configure the interpreter if Eclipse requests so; you may use the Auto Config button with default settings. Select source as a referenced project of orange, and orange of testing.

Enabling Running and Debugging