/*!
\page install BDM Toolbox - Installation

\section in_bin Binaries for BDMtoolbox
Binaries for the matlab BDMtoolbox are available only for windows (win32) platform, compiled against matlab 7.1 for compatibility.

Installation:
 - svn checkout http://mys.utia.cas.cz:1800/svn/mixpp/applications/bdmtoolbox/ into your local directory of your choice (this will be denoted \<toolbox_dir\>)
 - or download a prepared zip file from http://staff.utia.cas.cz/smidl/Public/bdmtoolbox_win32.zip and extract it to any directory (will be denoted \<toolbox_dir\>)
 - open matlab and type:
\code 
>> addpath <toolbox_dir>/mex; 
>> addpath <toolbox_dir>/mexw32
>> addpath <toolbox_dir>/mex_classes
\endcode
for downloaded win32 version of the toolbox. When compiling from sources, the mex files may be located in Debug of Release directories. Check where 
	the latest compiled files are and add apropriate path. E.g. for Windown and Mac:
\code 
>> addpath <toolbox_dir>/mex; 
>> addpath <toolbox_dir>/mex/Debug; 
>> addpath <toolbox_dir>/mex_classes
\endcode
For linux, the default build dir is \<toolbox_dir\>/mex, hence only me and mex_classes need to be in the path.
 - the toolbox is ready to be used, test it e.g. by: 
\code >> cd tutorial/userguide; 
>> pdfds_example \endcode
 - if no error is given, the toolbox is installed correctly
 - proceed to tutorial at http://mys.utia.cas.cz:1800/trac/bdm/doxygen/pages.html to learn how to use it

\section src Source code

is available from svn repository:
http://mys.utia.cas.cz:1800/svn/mixpp using guest/guest as login/password.

For download use an appropriate SVN client http://subversion.tigris.org/links.html#clients

Download the source files to any directory of your choise, this directory will be refered to as \<bdm_dir\>.

\subsection pre Prerequisities

You need to have the following tools available on your system:
 - working C++ compiler, e.g. gcc on Linux, or Visual Studio on windows
 - CMake, a cross-platform build system, http://www.cmake.org
 
\section lin Linux

All prerequisities are available as binary packages for most distribution. E.g. for debian-based distributions, use
\code
apt-get install g++ cmake 
\endcode

Compile the BDM library and its applications using 
\code
$ cd <bdm_dir>/library/
$ cmake .
$ make
$ cd <bdm_dir>/applications/bdmtoolbox/
$ cmake .
$ make
\endcode


\section win Windows

The following approach was tested on the Microsoft Visual Studio 9. 

Make sure you have cmake installed.

We are including latest stable code from IT++ which requires a implementation of BLAS and LAPACK routines. 
The most convenient library is ACML which can be downloaded from AMD.

For convenience of the beginners, DLLS of the ACML and lib+include files for ITPP and ACML are
provided at: http://staff.utia.cas.cz/smidl/Public/mixpp_win32lib.zip
If you want to use them copy the content of the zip file to \<bdm_dir\>/library/system/win32/ directory and
make sure to set your PATH environment variable:
\code
 Path = %PATH%; <bdm_dir>\library\system\win32\dll
\endcode

Be sure to set system variable globally, i.e., through the dialog box "System Properties", 
tab "Advanced" and button "Environment Variables". Otherwise you will not be able to run 
any programs.


Compilation of BDM for the first time:

 -# Run CMake GUI and specify address to your \<bdm_dir\>/library, press "Configure" and then "Generate"
 -# It should generate build files for your compiler in the main BDM  directory, open then in Visual Studio and press Build
 -# Run CMake GUI and specify address to your \<bdm_dir\>/applications/bdmtoolbox/, press "Configure" and then "Generate"
 -# It should generate build files for your compiler in the application/bdmtoolbox directory, open then in Visual Studio and press Build
 
Once the CMake files are created, there is no need to run it again. Th Visual Studio will call cmake itself.

\section mac Mac OS X

All prerequisities for Mac OS X are avaliable, make sure you have them installed.

Right now, Cmake configuration is hard-coded for one testing machine. Look for the paths in SetBDMEnv.cmake and correct them.
Open CMake GUI, click Configure followed by Create.

Compilation is the same as for Windows, with Visual Studio replaced by XCode

*/
