BDM Use - Installation

BDM comes in two basic versions:

• binary with precompiled executables and matlab mex files that can be configured by external text files
• source code that can be compiled into any required form.

Binaries for BDMtoolbox

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:

  >> addpath <toolbox_dir>/mex;
  >> addpath <toolbox_dir>/mexw32
  >> addpath <toolbox_dir>/mex_classes
  

  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:

  >> addpath <toolbox_dir>/mex;
  >> addpath <toolbox_dir>/mex/Debug;
  >> addpath <toolbox_dir>/mex_classes
  

  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:

   >> cd tutorial/userguide;
  >> pdfds_example
  

• 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

Source code

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 directoory will be refered to as <bdm_dir>.

Prerequisities

• working C++ compiler, e.g. gcc on Linux, or Visual Studio on windows
• CMake, a cross-platform build system, http://www.cmake.org
• working Lapack and BLAS libraries

Linux

apt-get install g++ cmake liblapack libblas-dev

Compile the BDM library and its applications using

$ cd <bdm_dir>/library/
$ cmake .
$ make

Windows

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:

 Path = %PATH%; <bdm_dir>\library\system\win32\dll

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:

• When everything is set-up, make a copy of library\system\win32\run_cmake.bat, edit it to reflect your environment (i.e. change paths to cmake and your C++ target environment) and run it.

• Alternatively, you can run CMake GUI and specify address to your <bdm_dir>

• It should generate build files for your compiler in the main BDM directory

For more comfortable work with Subversion, we recommend to install also AnkhSVN - a Visual Studio plug-in that perfectly integrates Subversion into the GUI, see http://ankhsvn.open.collab.net/

Mac OS X

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. Configuration files for your favourite build environment should be created in the BDM directory.

Generated on 2 Dec 2013 for mixpp by  1.4.7