|
| 1 | + |
| 2 | +Refocus |
| 3 | + |
| 4 | +This is the ASCII version of the installation instructions, that was |
| 5 | +automatically generated from the DocBook source. The doc.html and doc.pdf |
| 6 | +versions of these instructions in the doc directory are more readable. |
| 7 | + _________________________________________________________________ |
| 8 | + |
| 9 | +Installation |
| 10 | + |
| 11 | +Requirements |
| 12 | + |
| 13 | +For 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 | + |
| 35 | +Using ATLAS |
| 36 | + |
| 37 | +What is ATLAS |
| 38 | + |
| 39 | +ATLAS (see http://math-atlas.sourceforge.net) is a system for generating |
| 40 | +high-performance mathematical libraries. It generates a library that is |
| 41 | +specifically tuned to your processor and compiler. refocus needs some |
| 42 | +routines for solving a linear system of equations. By default refocus uses |
| 43 | +an unoptimized version from the CLAPACK distribution (see |
| 44 | +http://www.netlib.org/clapack). |
| 45 | + _________________________________________________________________ |
| 46 | + |
| 47 | +How 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 | + |
| 56 | +cd lib/Linux_PII |
| 57 | +make |
| 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 | + |
| 63 | +cp ~/ATLAS/lib/atlas3.4.1_Linux_PII.tgz ~/refocus |
| 64 | +cd ~/refocus |
| 65 | +zcat atlas3.4.1_Linux_PII.tgz |tar xvf - |
| 66 | +mv 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. |
0 commit comments