README

Explanation of directory content
================================

README       - this file
Makefile     - to create release archives
src          - shogun source code
doc          - documentation (to be built using doxygen)
examples     - example files for all interfaces
applications - applications of shogun
testsuite    - the shogun test suite

The following table depicts the status of each interface available in shogun:

+==================+===========================================================+
|    interface     |     status                                                |
+==================+===========================================================+
|python_modular    | mature (no known problems)                                |
|octave_modular    | mature (no known problems)                                |
|java_modular      | beta quality - not all examples are ported and working    |
|lua_modular       | alpha work in progress quality - some examples work       |
|ruby_modular      | pre-alpha work in progress quality - proof-of-concept only|
|csharp_modular    | pre-alpha work in progress quality - proof-of-concept only|
|r_modular         | pre-alpha quality (swig does not properly handle reference|
|                  | counting and thus only for the brave:                     |
|                  | --disable-reference-counting to get it to work, but beware|
|                  | that it will leak memory; disabled by default.)           |
+------------------+-----------------------------------------------------------+
|octave_static     | mature (no known problems)                                |
|matlab_static     | mature (no known problems)                                |
|python_static     | mature (no known problems)                                |
|r_static          | mature (no known problems)                                |
|libshogun_static  | mature (no known problems)                                |
|cmdline_static    | stable but some data types incomplete                     |
|                  |                                                           |
|elwms_static      | this is the eierlegendewollmilchsau interface, a chimera  |
|                  | that in one file interfaces with python,octave,r,matlab   |
|                  | and provides the run_python command to run code in python |
|                  | using the in octave,r,matlab available variables, etc)    |
+==================+===========================================================+

Visit src/README and http://www.shogun-toolbox.org/doc/en/current for further information.