1
2Refocus
3
4This is the ASCII version of the installation instructions, that was
5automatically generated from the DocBook source. The doc.html and doc.pdf
6versions of these instructions in the doc directory are more readable.
7     _________________________________________________________________
8
9Installation
10
11Requirements
12
13For installing refocus you need the following:
14
15     * The Gimp, of course. This plug-in should work with versions > 1.2.
16     * Gtk+-2 plus pkg-config.
17     * Optional: ATLAS, see Using ATLAS
18
19   Installation should be simple. Untar the distribution. If you want to
20   use ATLAS install it in lib-atlas (see Using ATLAS).
21
22   Then run ./configure in the top-level directory.
23
24   Then run make install-bin if you want to install the plug-in under
25   your home directory or make install-admin-bin if you want to install
26   the plug-in under your Gimp's system directory.
27
28   If you have gtk-doc installed you can build the system documentation
29   in the gtk-doc directory. In this case you must invoke configure with
30   the --enable-gtk-doc option. When you make it for the first time make
31   will fail with the message No rule to make target `tmpl/*.sgml'.
32   Running make again will fix this problem.
33     _________________________________________________________________
34
35Using ATLAS
36
37What is ATLAS
38
39ATLAS (see http://math-atlas.sourceforge.net) is a system for generating
40high-performance mathematical libraries. It generates a library that is
41specifically tuned to your processor and compiler. refocus needs some
42routines for solving a linear system of equations. By default refocus uses
43an unoptimized version from the CLAPACK distribution (see
44http://www.netlib.org/clapack).
45     _________________________________________________________________
46
47How to use ATLAS
48
49     * Make ATLAS generate its libraries. For instructions see the ATLAS
50       documentation. Depending on your system, this may take a long
51       time. During the installation you have to select a name to
52       identify your configuration. In the following examples we will use
53       Linux_PII as the chosen name.
54     * Go to the subdirectory lib/Linux_PII and run make.
55
56cd lib/Linux_PII
57make
58
59       This will generate a gzipped tar file that contains the generated
60       libraries and include files.
61     * Copy the gzipped tar file to the refocus directory and unpack it.
62
63cp ~/ATLAS/lib/atlas3.4.1_Linux_PII.tgz ~/refocus
64cd ~/refocus
65zcat atlas3.4.1_Linux_PII.tgz |tar xvf -
66mv Linux_PII lib-atlas
67
68     * If you have already run configure , you must delete the file
69       config.cache.
70     * Then run configure. If everything is OK you should see a message
71       like using atlas in lib-atlas/lib.
72     * Now run make.
73