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