source: orange/INSTALL.txt @ 11409:522c2053fe38

Revision 11409:522c2053fe38, 2.8 KB checked in by astaric, 13 months ago (diff)

Removed clang workaround as it is no longer needed.

RevLine 
[10998]1== Building From Source ==
2
3=== Prerequisites ===
4
51. C++ tool-chain. Supported compilers are gcc (g++) for Linux and Mac OS X and Microsoft Visual
[11409]6C++ on Windows (MinGW is not supported at this time). Clang also works for MAC OS.
[10998]7[[BR]]
8
9* On Windows install the free [http://www.microsoft.com/express Visual Studio Express]
10* On Linux use the distribution package management tools
11* On Mac OSX install the [http://developer.apple.com/xcode XCode developer tools]
12
13You will also need python and numpy development header files. They are included in python
14and numpy installation on Windows and Mac OSX, but are in separate packages on Linux,
15for instance 'python-dev' and python-numpy-dev' on Debian derived distributions.
16
17=== Obtaining source ===
18
19Either:
20
21* Download the latest nightly packed sources archive and unpack it.
22
23* Clone the Mercurial repository:
24
25    hg clone https://bitbucket.org/biolab/orange
26
27== Build and Install==
28
29=== With setup.py (suggested) ===
30
31The easiest way to build Orange from source is to use the setup.py in the root
32Orange directory (requires administrative privileges). Just run:
33
34python setup.py build
35python setup.py install
36
37Alternatively, you could install Orange into the user specific site-packages
38(see http://docs.python.org/install/index.html#how-installation-works).
39You will need to add the install dir to PYTHONSITEPACKAGES environment variable
40(because Python needs to process Orange's .pth file)
41
42To install in development mode (http://packages.python.org/distribute/setuptools.html#development-mode)
43run the following command instead of "python setup.py install":
44
45    python setup.py develop
46
47=== Using make ===
48
49This is only useful to developers of the C++ part (this can only build the extensions
50in-place and does not support an install command).
51
52First change the working directory to the 'source' sub-directory then run make:
53
54cd source
55make
56
57this will build the orange core extensions in the root directory (i.e. the one you started in).
58Useful environment variables:
59
60 * PYTHON - names the python executable for which Orange is being build.
61 * CXXFLAGS - flags to pass to C++ compiler
62 * CFLAGS - flags to pass to C compiler
63 * LDFLAGS - flags to pass to the linker
64 * EXCLUDE_ORANGEQT - if set to any value will cause orangeqt to not be build
65
66See source/orangeqt/README.txt for building orangeqt alone.
67
68== Linking to external libraries  ==
69
70The Orange source includes some third party libraries that are statically linked
71into Orange by default:
72
73 * BLAS (a subset)
74 * LIBSVM (v3.2 - v3.* is required)
75 * LIBLINEAR (v1.8)
76 * QHull
77
78To customize the build process to link to the corresponding external library instead, try.
79
80* For the setup.py method modify the setup-site.cfg file.
81
82* For make, pass the library names on the command line or through environment variables (listed
83in source/Makefile). Example:
84
85make BLAS_LIB=atlas
86
Note: See TracBrowser for help on using the repository browser.