root/doc/html/install.html @ 302

Revision 302, 6.1 kB (checked in by smidl, 16 years ago)

Install manual ticket #17

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3<title>mixpp: How to install BDM</title>
4<link href="tabs.css" rel="stylesheet" type="text/css">
5<link href="doxygen.css" rel="stylesheet" type="text/css">
6</head><body>
7<!-- Generated by Doxygen 1.5.8 -->
8<script type="text/javascript">
9<!--
10function changeDisplayState (e){
11  var num=this.id.replace(/[^[0-9]/g,'');
12  var button=this.firstChild;
13  var sectionDiv=document.getElementById('dynsection'+num);
14  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
15    sectionDiv.style.display='block';
16    button.src='open.gif';
17  }else{
18    sectionDiv.style.display='none';
19    button.src='closed.gif';
20  }
21}
22function initDynSections(){
23  var divs=document.getElementsByTagName('div');
24  var sectionCounter=1;
25  for(var i=0;i<divs.length-1;i++){
26    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
27      var header=divs[i];
28      var section=divs[i+1];
29      var button=header.firstChild;
30      if (button!='IMG'){
31        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
32        button=document.createElement('img');
33        divs[i].insertBefore(button,divs[i].firstChild);
34      }
35      header.style.cursor='pointer';
36      header.onclick=changeDisplayState;
37      header.id='dynheader'+sectionCounter;
38      button.src='closed.gif';
39      section.id='dynsection'+sectionCounter;
40      section.style.display='none';
41      section.style.marginLeft='14px';
42      sectionCounter++;
43    }
44  }
45}
46window.onload = initDynSections;
47-->
48</script>
49<div class="navigation" id="top">
50  <div class="tabs">
51    <ul>
52      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
53      <li class="current"><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
54      <li><a href="modules.html"><span>Modules</span></a></li>
55      <li><a href="annotated.html"><span>Classes</span></a></li>
56      <li><a href="files.html"><span>Files</span></a></li>
57    </ul>
58  </div>
59</div>
60<div class="contents">
61<h1><a class="anchor" name="install">How to install BDM </a></h1>BDM is written as a multiplatform library, which was tested on Linux, Windows and Mac OSX. However, installation on each platform is specific.<p>
62BDM comes in two basic versions: <ul>
63<li><b>binary</b> with precompiled executables and matlab mex files that can be configured by external text files </li>
64<li><b>source</b> <b>code</b> that can be compiled into any required form. Distribution of the binary form is not currently available. It is planned in latter stages of development.</li>
65</ul>
66<h2><a class="anchor" name="src">
67Source code</a></h2>
68is available from svn repository: <a href="http://mys.utia.cas.cz:1800/svn/mixpp">http://mys.utia.cas.cz:1800/svn/mixpp</a><p>
69For download use an appropriate SVN client <a href="http://subversion.tigris.org/links.html#clients">http://subversion.tigris.org/links.html#clients</a><h3><a class="anchor" name="pre">
70Prerequisities</a></h3>
71You need to have the following tools available on your system: <ul>
72<li>working C++ compiler, e.g. gcc on Linux, or Visual Studio on windows </li>
73<li>CMake, a cross-platform build system, <a href="http://www.cmake.org">http://www.cmake.org</a> </li>
74<li>ITPP library, <a href="http://itpp.sourceforge.net/">http://itpp.sourceforge.net/</a> which is a part of all major linux distributions, for its installation on Windows, see Section Windows.</li>
75</ul>
76<h2><a class="anchor" name="lin">
77Linux</a></h2>
78All prerequisities are available as binary packages for most distribution. E.g. for debian-based distributions, use <div class="fragment"><pre class="fragment">apt-<span class="keyword">get</span> install g++ cmake libitpp-dev
79</pre></div><p>
80Compile the BDM library and its applications using <div class="fragment"><pre class="fragment">$ cd directory/with/bdm/sources
81$ cmake .
82$ make
83</pre></div><h2><a class="anchor" name="win">
84Windows</a></h2>
85The following approach was tested on Visual Studio 9, so we recommend to download and install it. <a href="http://www.microsoft.com/express/vc/">http://www.microsoft.com/express/vc/</a><p>
86Make sure you have cmake installed.<p>
87Expert users are advised to download and compile their ITPP version following a guide on : <a href="http://itpp.sourceforge.net/current/installation.html">http://itpp.sourceforge.net/current/installation.html</a><p>
88For convenience of the beginners, DLLS of the ACML and lib+include files for ITPP and ACML are provided at: <a href="http://staff.utia.cas.cz/smidl/Public/mixpp_win32lib.zip">http://staff.utia.cas.cz/smidl/Public/mixpp_win32lib.zip</a> If you want to use them copy the content of the zip file to win32\ directory and make sure to set your PATH environment variable: <div class="fragment"><pre class="fragment"> Path = %PATH%; &lt;bdm_dir&gt;\win32\dll
89</pre></div> Otherwise you will not be able to run any programs.<p>
90Compilation of BDM:<p>
91When everything is set-up, make a copy of win32/run_cmake.bat, edit it to reflect your environment (i.e. change paths to cmake and your C++ target environment) and run it.<p>
92It should generate build files for your compiler in the main BDM directory<h2><a class="anchor" name="mac">
93Mac OS X</a></h2>
94All prerequisities for Mac OS X are avaliable except for ITPP, make sure you have them installed.<p>
95However, its compilation is straightforward.<p>
961. Download the latest stable release from <a href="http://itpp.sourceforge.net">http://itpp.sourceforge.net</a> 2. Compile it using script mac/itpp_compile.sh<p>
97The default cmake configuration is looking for itpp in directory mac/itpp, make sure you have symlinks to this directory.<p>
98If itpp compilation is successfull, you can run Cmake. Fill in the paths to your BDM directory, run Configure followed by Create. Configuration files for your favourite build environment should be created in the BDM directory. </div>
99<hr size="1"><address style="text-align: right;"><small>Generated on Thu Mar 19 16:25:43 2009 for mixpp by&nbsp;
100<a href="http://www.doxygen.org/index.html">
101<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
102</body>
103</html>
Note: See TracBrowser for help on using the browser.