| 1 |
# |
| 2 |
# $Id: README,v 4.0 2003/04/28 14:44:13 hut66au Exp $ |
| 3 |
# |
| 4 |
# Readme file for imview binary distributions |
| 5 |
# |
| 6 |
# Hugues Talbot 16 Mar 2001 |
| 7 |
|
| 8 |
Introduction: |
| 9 |
------------- |
| 10 |
|
| 11 |
Imview is an image viewing package intended for image analysis, i.e: |
| 12 |
getting numbers (measurements) out of images. It is designed to |
| 13 |
interface easily to image analysis packages such as Khoros or |
| 14 |
Z-IMAGE (http://www.cmis.csiro.au/IAP/zimage.htm), to perform |
| 15 |
as an external viewer. |
| 16 |
|
| 17 |
It has facilities for histogram-based segmentation, comparing |
| 18 |
images before and after a series of filtering, etc. |
| 19 |
|
| 20 |
It can also perform adequately as a general-purpose image display |
| 21 |
application, but this is not the emphasis. |
| 22 |
|
| 23 |
Imview is free software distributed under the GNU public licence. |
| 24 |
|
| 25 |
Roadmap: |
| 26 |
------- |
| 27 |
|
| 28 |
Documentation: |
| 29 |
------------- |
| 30 |
|
| 31 |
The PDF documentation for imview is included in this |
| 32 |
distribution as a separate package. Be sure to install |
| 33 |
it as well (see below). |
| 34 |
|
| 35 |
Downloading the software: |
| 36 |
------------------------ |
| 37 |
|
| 38 |
You downloaded a binary distribution of Imview. I encourage |
| 39 |
you to also download the source code and compile it for yourself, |
| 40 |
especially if you find some problems with this software of if |
| 41 |
you can think of any enhancement you can make to it. |
| 42 |
|
| 43 |
Imview is distributed under the terms of the GNU Public License (GPL) |
| 44 |
which guarantees you a number of freedoms. You are welcome to |
| 45 |
use and share this software with friends and colleagues without |
| 46 |
restriction, you can look at and modify the code to your heart's |
| 47 |
content. You can keep your modifications for yourself but if you |
| 48 |
want to distribute your modified software, you must do so under |
| 49 |
the same License (in particular you must make the changes to the |
| 50 |
code available). Read the provided copy of the GPL for yourself. |
| 51 |
|
| 52 |
The source code is available from |
| 53 |
|
| 54 |
http://www.sourceforge.net/projects/imview |
| 55 |
|
| 56 |
Thank you for your interest! |
| 57 |
|
| 58 |
Installing the software: |
| 59 |
----------------------- |
| 60 |
|
| 61 |
Installing imview is now easier than ever! a `setup' GUI utility |
| 62 |
is now provided. Follow these steps: |
| 63 |
|
| 64 |
1) Untar the distribution in a temporary location |
| 65 |
|
| 66 |
% cd ~/tmp/ |
| 67 |
% tar zxvf <distribution> |
| 68 |
|
| 69 |
or |
| 70 |
|
| 71 |
% gunzip -c <distribution> | tar xvf - |
| 72 |
|
| 73 |
|
| 74 |
2) Run the setup utility |
| 75 |
|
| 76 |
% ./setup |
| 77 |
|
| 78 |
follow the steps of the installation. Imview can be installed |
| 79 |
anywhere, just make sure you have the relevant permissions to |
| 80 |
write in the destination directory. Make sure that imview is |
| 81 |
then in your PATH. I.e: if you install imview in |
| 82 |
|
| 83 |
/home/joe/software |
| 84 |
|
| 85 |
then imview will be available from /home/joe/software/bin |
| 86 |
Make sure that this directory is in your PATH. |
| 87 |
|
| 88 |
Typically imview will be installed in /usr/local. To do so |
| 89 |
you generally need root privileges, and you need to run setup |
| 90 |
as root. |
| 91 |
|
| 92 |
3) If you also installed the documentation, it will be available |
| 93 |
under <installation directory>/share/Imview/doc, i.e: in the |
| 94 |
above example /home/joe/software/share/Imview/doc/imview.pdf |
| 95 |
|
| 96 |
4) That's it. Please report any problems. |
| 97 |
|
| 98 |
|
| 99 |
Removing the software: |
| 100 |
--------------------- |
| 101 |
|
| 102 |
To remove the software, you can use the `imview.remove' script |
| 103 |
provided in the distribution, and answer all the questions. |
| 104 |
|
| 105 |
|
| 106 |
mailto: [email protected] |
| 107 |
|
| 108 |
# |
| 109 |
# End of $Id: README,v 4.0 2003/04/28 14:44:13 hut66au Exp $ |
| 110 |
# |