Building
From Emergent
- Getting the source
- Installing from packages
- Building from packages (recommended!)
- OSX
- Fedora
- Ubuntu
- Ubuntu (64 bit)
- Gentoo (unsupported)
This page contains general requirements and instructions for building and installing Emergent from package prerequisites (easy, recommended) and source prerequisites (takes forever). Our package follows GNU standards and the procedure on different platforms is essentially the same. We have documented this process for each platform we support. If you find that something here does not work, please send us a note. If you are interested in documenting support for an additional platform, feel free to start a new page and send us any patches. It is our goal to support Emergent on any platform supported by its prerequisites (Qt, Coin3D, etc.) and for which there is academic or commercial demand. Emergent is designed to work well on all 3 major platforms, but Linux and Mac are "first among equals" and are the supported platforms of choice. The cluster features in Emergent are only currently available in the Linux build.
Supported Platforms
If you are building from source, Emergent is known to compile on a variety of systems. However, we are typically only able to test our binary packages on the latest version of the operating system available. If you get Emergent working on a previous version, please document it on the installation wiki article for that OS.
32-bit Platforms
- Linux: Any should work, but it has been tested on Fedora Core 4 and later, Kubuntu (and Ubuntu) Edgy or Fiesty
- Mac OS: 10.4 ("Tiger") and later
- Unix: Emergent should be installable on most Unix platforms
- Microsoft Windows: 2000 (untested), XP, Server 2003, Vista
- NOTE: At this time, only the (non-free) commercial or academic version of Qt 4 is supported on Windows -- we are currently not supporting building Emergent on Windows by people outside our development team
64-bit Platforms **experimental**
- Linux: built and tested on Kubuntu (Ubuntu 2.6.22-14)
General Prerequisites
| Package | Min Version | Web Link File Link | Description |
|---|---|---|---|
| OpenGL | (platform dependent) | OpenGL | Low-level 3d graphics toolkit (hardware accelerated); this is usually provided by the graphics card driver, or the OS. |
| Qt4 (open source edition) | Qt-4.2.3 or Qt-4.3.1 | http://www.trolltech.com/ | Main GUI Toolkit |
| sndfile | 1.0.17 | http://www.mega-nerd.com/libsndfile/ | sound reading library (except mp3); is also used by simage (below) |
| Coin3D | 2.4.6 | http://www.coin3d.org/ | Open Inventor providing higher-level 3d toolkit |
| SoQt | 1.4.1 | http://www.coin3d.org/ | Qt interface to Coin3d |
| simage | 1.6.1 | http://www.coin3d.org/ | library for loading textures (and doing media i/o) |
| GSL | 1.9 | http://www.gnu.org/software/gsl/ | Gnu Scientific Library: for matrix math and other math functions |
| ODE | 0.8 or 0.7 | http://ode.org/ | Open Dynamics Engine: for virtual environment simulations |
You will also need Subversion.
