root/library/doc/html/install.html @ 614

Revision 614, 6.7 kB (checked in by smidl, 15 years ago)

doc

Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5<title>mixpp: How to install BDM</title>
6<link href="tabs.css" rel="stylesheet" type="text/css"/>
7<link href="doxygen.css" rel="stylesheet" type="text/css"/>
8</head>
9<body>
10<!-- Generated by Doxygen 1.6.1 -->
11<script type="text/javascript">
12<!--
13function changeDisplayState (e){
14  var num=this.id.replace(/[^[0-9]/g,'');
15  var button=this.firstChild;
16  var sectionDiv=document.getElementById('dynsection'+num);
17  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
18    sectionDiv.style.display='block';
19    button.src='open.gif';
20  }else{
21    sectionDiv.style.display='none';
22    button.src='closed.gif';
23  }
24}
25function initDynSections(){
26  var divs=document.getElementsByTagName('div');
27  var sectionCounter=1;
28  for(var i=0;i<divs.length-1;i++){
29    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
30      var header=divs[i];
31      var section=divs[i+1];
32      var button=header.firstChild;
33      if (button!='IMG'){
34        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
35        button=document.createElement('img');
36        divs[i].insertBefore(button,divs[i].firstChild);
37      }
38      header.style.cursor='pointer';
39      header.onclick=changeDisplayState;
40      header.id='dynheader'+sectionCounter;
41      button.src='closed.gif';
42      section.id='dynsection'+sectionCounter;
43      section.style.display='none';
44      section.style.marginLeft='14px';
45      sectionCounter++;
46    }
47  }
48}
49window.onload = initDynSections;
50-->
51</script>
52<div class="navigation" id="top">
53  <div class="tabs">
54    <ul>
55      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
56      <li class="current"><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
57      <li><a href="annotated.html"><span>Classes</span></a></li>
58      <li><a href="files.html"><span>Files</span></a></li>
59    </ul>
60  </div>
61</div>
62<div class="contents">
63
64
65<h1><a class="anchor" id="install">How to install BDM </a></h1><p>BDM is written as a multiplatform library, which was tested on Linux, Windows and Mac OSX. However, installation on each platform is specific.</p>
66<p>BDM comes in two basic versions: </p>
67<ul>
68<li><b>binary</b> with precompiled executables and matlab mex files that can be configured by external text files </li>
69<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>
70</ul>
71<h2><a class="anchor" id="src">
72Source code</a></h2>
73<p>is available from svn repository: <a href="http://mys.utia.cas.cz:1800/svn/mixpp">http://mys.utia.cas.cz:1800/svn/mixpp</a> using guest/guest as login/password.</p>
74<p>For download use an appropriate SVN client <a href="http://subversion.tigris.org/links.html#clients">http://subversion.tigris.org/links.html#clients</a></p>
75<p>Download the source files to any directory of your choise, this directoory will be refered to as &lt;bdm_dir&gt;.</p>
76<h3><a class="anchor" id="pre">
77Prerequisities</a></h3>
78<p>You need to have the following tools available on your system: </p>
79<ul>
80<li>working C++ compiler, e.g. gcc on Linux, or Visual Studio on windows </li>
81<li>CMake, a cross-platform build system, <a href="http://www.cmake.org">http://www.cmake.org</a> </li>
82<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>
83</ul>
84<h2><a class="anchor" id="lin">
85Linux</a></h2>
86<p>All prerequisities are available as binary packages for most distribution. E.g. for debian-based distributions, use </p>
87<div class="fragment"><pre class="fragment">apt-<span class="keyword">get</span> install g++ cmake libitpp-dev
88</pre></div><dl class="note"><dt><b>Note:</b></dt><dd>If you want to use mex files, you need to build IT++ from sources using the classi configure;make;make install. The necessary flags for configure for mex compilation are in file linux/configure_itpp.</dd></dl>
89<p>Compile the BDM library and its applications using </p>
90<div class="fragment"><pre class="fragment">$ cd &lt;bdm_dir&gt;/library/
91$ cmake .
92$ make
93</pre></div><h2><a class="anchor" id="win">
94Windows</a></h2>
95<p>The 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>
96<p>Make sure you have cmake installed.</p>
97<p>Expert 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>
98<p>For 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 &lt;bdm_dir&gt;/library/system/win32/ directory and make sure to set your PATH environment variable: </p>
99<div class="fragment"><pre class="fragment"> Path = %PATH%; &lt;bdm_dir&gt;\library\system\win32\dll
100</pre></div><p> Otherwise you will not be able to run any programs.</p>
101<p>Compilation of BDM:</p>
102<p>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.</p>
103<p>It should generate build files for your compiler in the main BDM directory</p>
104<h2><a class="anchor" id="mac">
105Mac OS X</a></h2>
106<p>All prerequisities for Mac OS X are avaliable except for ITPP, make sure you have them installed.</p>
107<p>However, its compilation is straightforward.</p>
108<p>1. Download the latest stable release from <a href="http://itpp.sourceforge.net">http://itpp.sourceforge.net</a> 2. Compile it using script system/mac/itpp_compile.sh</p>
109<p>The default cmake configuration is looking for itpp in directory mac/itpp, make sure you have symlinks to this directory.</p>
110<p>If 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. </p>
111</div>
112<hr size="1"/><address style="text-align: right;"><small>Generated on Sun Sep 13 22:40:40 2009 for mixpp by&nbsp;
113<a href="http://www.doxygen.org/index.html">
114<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
115</body>
116</html>
Note: See TracBrowser for help on using the browser.