1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>FreeMat: INSTALL Installing FreeMat</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">FreeMat
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('introduction_install.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">INSTALL Installing FreeMat </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Section: <a class="el" href="sec_introduction.html">Introduction and Getting Started</a> </p>
<h1><a class="anchor" id="General"></a>
Instructions</h1>
<p>Here are the general instructions for installing FreeMat. First, follow the instructions listed below for the platform of interest. Then, run the </p>
<pre class="fragment">-->pathtool
</pre><p> which brings up the path setup tool. More documentation on the GUI elements (and how to use them) will be forthcoming. </p>
<h1><a class="anchor" id="Linux"></a>
Linux</h1>
<p>For Linux, FreeMat is now provided as a binary installation. To install it simply download the binary using your web browser, and then unpack it </p>
<pre class="fragment"> tar xvfz FreeMat-\<VERSION_NUMBER\>-Linux-Binary.tar.gz
</pre><p> You can then run FreeMat directly without any additional effort </p>
<pre class="fragment"> FreeMat-\<VERSION_NUMBER\>-Linux-Binary/Contents/bin/FreeMat
</pre><p> will start up FreeMat as an X application. If you want to run it as a command line application (to run from within an xterm), use the <code>nogui</code> flag </p>
<pre class="fragment"> FreeMat-\<VERSION_NUMBER\>-Linux-Binary/Contents/bin/FreeMat -nogui
</pre><p> If you do not want FreeMat to use X at all (no graphics at all), use the <code>noX</code> flag </p>
<pre class="fragment"> FreeMat-\<VERSION_NUMBER\>-Linux-Binary/Contents/bin/FreeMat -noX
</pre><p> For convenience, you may want to add FreeMat to your path. The exact mechanism for doing this depends on your shell. Assume that you have unpacked <code>FreeMat-<VERSION_NUMBER>-Linux-Binary.tar.gz</code> into the directory <code>/home/myname</code>. Then if you use <code>csh</code> or its derivatives (like <code>tcsh</code>) you should add the following line to your <code>.cshrc</code> file: </p>
<pre class="fragment"> set path=($path /home/myname/FreeMat-\<VERSION_NUMBER\>-Linux/Binary/Contents/bin)
</pre><p> If you use <code>bash</code>, then add the following line to your <code>.bash_profile</code> </p>
<pre class="fragment"> PATH=$PATH:/home/myname/FreeMat-\<VERSION_NUMBER\>-Linux/Binary/Contents/bin
</pre><p> If the prebuilt binary package does not work for your Linux distribution, you will need to build FreeMat from source (see the source section below). When you have FreeMat running, you can setup your path using the <code>pathtool</code>. Note that the <code>FREEMAT_PATH</code> is no longer used by FreeMat. You must use the <code>pathtool</code> to adjust the path. </p>
<h1><a class="anchor" id="Windows"></a>
Windows</h1>
<p>For Windows, FreeMat is installed via a binary installer program. To use it, simply download the setup program <code>FreeMat-<VERSION_NUMBER>-Setup.exe</code>, and double click it. Follow the instructions to do the installation, then setup your path using <code>pathtool</code>. </p>
<h1><a class="anchor" id="Mac"></a>
OS X</h1>
<p>For Mac OS X, FreeMat is distributed as an application bundle. To install it, simply download the compressed disk image file <code>FreeMat-<VERSION_NUMBER>.dmg</code>, double click to mount the disk image, and then copy the application <code>FreeMat-<VERSION_NUMBER></code> to some convenient place. To run FreeMat, simply double click on the application. Run <code>pathtool</code> to setup your FreeMat path. </p>
<h1><a class="anchor" id="Source"></a>
Code</h1>
<p>The source code build is a little more complicated than previous versions of FreeMat. Here are the current build instructions for all platforms. </p>
<ol>
<li>
Build and install Qt 4.3 or later - <code><a href="http://trolltech.com/developer/downloads/opensource">http://trolltech.com/developer/downloads/opensource</a></code> </li>
<li>
Install g77 or gfortran (use fink for Mac OS X, use <code>gcc-g77</code> package for MinGW) </li>
<li>
Download the source code <code>FreeMat-<VERSION_NUMBER>-src.tar.gz</code>. </li>
<li>
Unpack the source code: <code>tar xvfz FreeMat-<VERSION_NUMBER>-src.tar.gz</code>. </li>
<li>
For Windows, you will need to install MSYS as well as MINGW to build FreeMat. You will also need unzip to unpack the enclosed matio.zip archive. Alternately, you can cross-build the WIndows version of FreeMat under Linux (this is how I build it now). </li>
<li>
If you are extraordinarily lucky (or prepared), you can issue the usual ./configure, then the make and make install. This is not likely to work because of the somewhat esoteric dependencies of FreeMat. The configure step will probably fail and indicate what external dependencies are still needed. </li>
<li>
I assume that you are familiar with the process of installing dependencies if you are trying to build FreeMat from source. </li>
</ol>
<p>To build a binary distributable (app bundle on the Mac, setup installer on win32, and a binary distribution on Linux), you will need to run <code>make package</code> instead of <code>make install</code>. </p>
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="index.html">FreeMat Documentation</a></li><li class="navelem"><a class="el" href="sec_introduction.html">Introduction and Getting Started</a></li>
<li class="footer">Generated on Thu Jul 25 2013 17:17:38 for FreeMat by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>
</ul>
</div>
</body>
</html>
|
